[gentoo-pms] [PATCH 1/4] Specify file modes for all installation commands.

[gentoo-pms] [PATCH 1/4] Specify file modes for all installation commands.

[Bo Ørsted Andresen]

From: Bo Ørsted Andresen <zlin@exherbo.org>

---
 pkg-mgr-commands.tex |   49 ++++++++++++++++++++++++++++---------------------
 1 files changed, 28 insertions(+), 21 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 0065cdd..dea108e 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -168,17 +168,20 @@ has returned.
 \item[dobin] Installs the given files into \t{DESTTREE/bin}, where \t{DESTTREE} defaults to
     \t{/usr}. Gives the files mode \t{0755} and ownership \t{root:root}.
 
-\item[doconfd] Installs the given files into /etc/conf.d/.
+\item[doconfd] Installs the given files into /etc/conf.d/, by default with file mode
+    \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the \t{insopts} function.
 
 \item[dodir] Creates the given directories, by default with file mode \t{0755}. This can be overridden
     by setting \t{DIROPTIONS} with the \t{diropts} function.
 
-\item[dodoc] Installs the given files into a subdirectory under \t{/usr/share/doc/\$\{PF\}/}. The
-    subdirectory is set by the most recent call to \t{docinto}. If \t{docinto} has not
-    yet been called, instead installs to the directory \t{/usr/share/doc/\$\{PF\}/}.
+\item[dodoc] Installs the given files into a subdirectory under \t{/usr/share/doc/\$\{PF\}/} with
+    file mode \t{0644}. The subdirectory is set by the most recent call to \t{docinto}. If
+    \t{docinto} has not yet been called, instead installs to the directory
+    \t{/usr/share/doc/\$\{PF\}/}.
 
-\item[doexe] Installs the given files into the directory specified by the most recent
-    \t{exeinto} call. If \t{exeinto} has not yet been called, behaviour is undefined.
+\item[doexe] Installs the given files into the directory specified by the most recent \t{exeinto}
+    call, by default with file mode \t{0755}. This can be overridden by setting \t{EXEOPTIONS} with
+    the \t{exeopts} function. If \t{exeinto} has not yet been called, behaviour is undefined.
 
 \IFKDEBUILDELSE
 {
@@ -213,16 +216,20 @@ are as follows:
 }{
 }
 
-\item[doinfo] Installs a GNU Info file into the \t{/usr/share/info} area.
+\item[doinfo] Installs a GNU Info file into the \t{/usr/share/info} area with file mode \t{0644}.
 
-\item[doinitd] Installs an initscript into \t{/etc/init.d}.
+\item[doinitd] Installs an initscript into \t{/etc/init.d}, by default with file mode \t{0755}.
+    This can be overridden by setting \t{EXEOPTIONS} with the \t{exeopts} function.
 
-\item[doins] Takes any number of files as arguments and installs them into \t{INSDESTTREE}\@. If
-    the first argument is \t{-r}, then operates recursively, descending into any directories given.
+\item[doins] Takes any number of files as arguments and installs them into \t{INSDESTTREE}\@, by
+    default with file mode \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the
+    \t{insopts} function. If the first argument is \t{-r}, then operates recursively, descending
+    into any directories given.
 
 \item[dolib] For each argument, installs it into the appropriate library directory as determined by
-    Algorithm~\ref{alg:ebuild-libdir}. Any symlinks are installed into the same directory as relative
-    links to their original target.
+    Algorithm~\ref{alg:ebuild-libdir}, by default with file mode \t{0644}. This can be overridden by
+    setting \t{LIBOPTIONS} with the \t{libopts} function. Any symlinks are installed into the same
+    directory as relative links to their original target.
 
 \item[dolib.so] As for dolib. Installs the file with mode \t{0755}.
 
@@ -251,15 +258,15 @@ are as follows:
 \end{algorithm}
 
 \item[doman] Installs a man page into the appropriate subdirectory of \t{/usr/share/man} depending
-    upon its apparent section suffix (e.g. \t{foo.1} goes to \t{/usr/share/man/man1/foo.1}.
-    In EAPIs listed in table~\ref{tab:doman-table} as supporting language codes, a man page with
-    name of the form\t{foo.lang.1} shall go to \t{/usr/share/man/lang/man1/foo.1}, where \t{lang}
-    refers to a pair of lower-case ASCII letters optionally followed by an underscore and a pair
-    of upper-case ASCII letters.
-
-\item[domo] Installs a \t{.mo} file into the appropriate subdirectory of \t{DESTTREE/share/locale},
-    generated by taking the basename of the file, removing the \t{.*} suffix, and appending
-    \t{/LC\_MESSAGES}.
+    upon its apparent section suffix (e.g. \t{foo.1} goes to \t{/usr/share/man/man1/foo.1} with file
+    mode \t{0644}. In EAPIs listed in table~\ref{tab:doman-table} as supporting language codes, a
+    man page with name of the form\t{foo.lang.1} shall go to \t{/usr/share/man/lang/man1/foo.1},
+    where \t{lang} refers to a pair of lower-case ASCII letters optionally followed by an underscore
+    and a pair of upper-case ASCII letters.
+
+\item[domo] Installs a \t{.mo} file with file mode \t{0644} into the appropriate subdirectory of
+    \t{DESTTREE/share/locale}, generated by taking the basename of the file, removing the \t{.*}
+    suffix, and appending \t{/LC\_MESSAGES}.
 
 \item[dosbin] As \t{dobin}, but installs to \t{DESTTREE/sbin}.
 
-- 
1.6.2.1

[gentoo-pms] [PATCH 2/4] Minor wording/formatting fixes.

[Bo Ørsted Andresen]

From: Bo Ørsted Andresen <zlin@exherbo.org>

---
 pkg-mgr-commands.tex |   22 +++++++++++-----------
 1 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index dea108e..ac24055 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -168,7 +168,7 @@ has returned.
 \item[dobin] Installs the given files into \t{DESTTREE/bin}, where \t{DESTTREE} defaults to
     \t{/usr}. Gives the files mode \t{0755} and ownership \t{root:root}.
 
-\item[doconfd] Installs the given files into /etc/conf.d/, by default with file mode
+\item[doconfd] Installs the given config files into \t{/etc/conf.d/}, by default with file mode
     \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the \t{insopts} function.
 
 \item[dodir] Creates the given directories, by default with file mode \t{0755}. This can be overridden
@@ -193,18 +193,18 @@ has returned.
 }
 
 \item[dohtml] Installs the given HTML files into a subdirectory under \t{/usr/share/doc/\$PF/}.
-The subdirectory is \t{html} by default, but this can be changed by the \t{DOCDESTTREE}
-variable. Files to be installed automatically are determined by extension and the default
-extensions are \t{css}, \t{gif}, \t{htm}, \t{html}, \t{jpeg}, \t{jpg}, \t{js} and \t{png}. These default
-extensions can be extended or reduced (see below). The options that can be passed to \t{dohtml}
-are as follows:
+The subdirectory is \t{html} by default, but this can be overridden by setting the \t{DOCDESTTREE}
+variable with the \t{docinto} function. Files to be installed automatically are determined by
+extension and the default extensions are \t{css}, \t{gif}, \t{htm}, \t{html}, \t{jpeg}, \t{jpg},
+\t{js} and \t{png}. These default extensions can be extended or reduced (see below). The options
+that can be passed to \t{dohtml} are as follows:
     \begin{description}
     \item{\t{-r}} --- enables recursion into directories.
     \item{\t{-V}} --- enables verbosity.
     \item{\t{-A}} --- adds file type extensions to the default list.
     \item{\t{-a}} --- sets file type extensions to only those specified.
     \item{\t{-f}} --- list of files that are able to be installed.
-    \item{\t{-x}} --- list of directories that files will not be installed from(only used in
+    \item{\t{-x}} --- list of directories that files will not be installed from (only used in
     conjunction with \t{-r}).
     \item{\t{-p}} --- sets a document prefix for installed files.
     \end{description}
@@ -218,8 +218,8 @@ are as follows:
 
 \item[doinfo] Installs a GNU Info file into the \t{/usr/share/info} area with file mode \t{0644}.
 
-\item[doinitd] Installs an initscript into \t{/etc/init.d}, by default with file mode \t{0755}.
-    This can be overridden by setting \t{EXEOPTIONS} with the \t{exeopts} function.
+\item[doinitd] Installs the given initscript files into \t{/etc/init.d}, by default with file mode
+    \t{0755}. This can be overridden by setting \t{EXEOPTIONS} with the \t{exeopts} function.
 
 \item[doins] Takes any number of files as arguments and installs them into \t{INSDESTTREE}\@, by
     default with file mode \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the
@@ -231,9 +231,9 @@ are as follows:
     setting \t{LIBOPTIONS} with the \t{libopts} function. Any symlinks are installed into the same
     directory as relative links to their original target.
 
-\item[dolib.so] As for dolib. Installs the file with mode \t{0755}.
+\item[dolib.so] As for dolib except each file is installed with mode \t{0755}.
 
-\item[dolib.a] As for dolib. Installs the file with mode \t{0644}.
+\item[dolib.a] As for dolib except each file is installed with mode \t{0644}.
 
 \begin{algorithm}
 \caption{Determining the library directory} \label{alg:ebuild-libdir}
-- 
1.6.2.1

[gentoo-pms] [PATCH 3/4] domo renames files during install.

[Bo Ørsted Andresen]

From: Bo Ørsted Andresen <zlin@exherbo.org>

---
 pkg-mgr-commands.tex |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index ac24055..5ee43c8 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -266,7 +266,8 @@ that can be passed to \t{dohtml} are as follows:
 
 \item[domo] Installs a \t{.mo} file with file mode \t{0644} into the appropriate subdirectory of
     \t{DESTTREE/share/locale}, generated by taking the basename of the file, removing the \t{.*}
-    suffix, and appending \t{/LC\_MESSAGES}.
+    suffix, and appending \t{/LC\_MESSAGES}. The name of the installed files is the package name
+    with \t{.mo} appended.
 
 \item[dosbin] As \t{dobin}, but installs to \t{DESTTREE/sbin}.
 
-- 
1.6.2.1

[gentoo-pms] [PATCH 4/4] Add missing installation commands.

[Bo Ørsted Andresen]

From: Bo Ørsted Andresen <zlin@exherbo.org>

---
 pkg-mgr-commands.tex |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 5ee43c8..19f5c5c 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -179,6 +179,9 @@ has returned.
     \t{docinto} has not yet been called, instead installs to the directory
     \t{/usr/share/doc/\$\{PF\}/}.
 
+\item[doenvd] Installs the given environment files into \t{/etc/env.d/}, by default with file mode
+    \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the \t{insopts} function.
+
 \item[doexe] Installs the given files into the directory specified by the most recent \t{exeinto}
     call, by default with file mode \t{0755}. This can be overridden by setting \t{EXEOPTIONS} with
     the \t{exeopts} function. If \t{exeinto} has not yet been called, behaviour is undefined.
@@ -300,6 +303,10 @@ that can be passed to \t{dohtml} are as follows:
 
 \item[newins] As above, for \t{doins}.
 
+\item[newlib.a] As above, for \t{dolib.a}.
+
+\item[newlib.so] As above, for \t{dolib.so}.
+
 \item[newman] As above, for \t{doman}.
 
 \item[newsbin] As above, for \t{dosbin}.
-- 
1.6.2.1

Re: [gentoo-pms] [PATCH 1/4] Specify file modes for all installation commands.

[David Leverton]

2009/3/25 Bo Ørsted Andresen <bo.andresen@zlin.dk>:
> -\item[doins] Takes any number of files as arguments and installs them into \t{INSDESTTREE}\@. If
> -    the first argument is \t{-r}, then operates recursively, descending into any directories given.
> +\item[doins] Takes any number of files as arguments and installs them into \t{INSDESTTREE}\@, by
> +    default with file mode \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the
> +    \t{insopts} function. If the first argument is \t{-r}, then operates recursively, descending
> +    into any directories given.

Lose the \@ here, it's to force end-of-sentence spacing when the
previous word looks like an acronym.

Re: [gentoo-pms] [PATCH 1/4] Specify file modes for all installation commands.

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 306 bytes --]

On Wed, 25 Mar 2009 15:47:18 +0100
Bo Ørsted Andresen <bo.andresen@zlin.dk> wrote:
>  pkg-mgr-commands.tex |   49
> ++++++++++++++++++++++++++++--------------------- 1 files changed, 28
> insertions(+), 21 deletions(-)

Applied all four with dleverton's formatting fix, ta.

-- 
Ciaran McCreesh

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 197 bytes --]