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

["Bo Ørsted Andresen" <bo.andresen@zlin.dk>]

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