From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1LmUOF-0000r6-6M for garchives@archives.gentoo.org; Wed, 25 Mar 2009 14:47:35 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id AED5DE06D0; Wed, 25 Mar 2009 14:47:34 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 636CDE06D0 for ; Wed, 25 Mar 2009 14:47:34 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id BB96264FA0 for ; Wed, 25 Mar 2009 14:47:33 +0000 (UTC) X-Virus-Scanned: amavisd-new at gentoo.org X-Spam-Score: -2.339 X-Spam-Level: X-Spam-Status: No, score=-2.339 required=5.5 tests=[AWL=0.260, BAYES_00=-2.599] Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5OmLvCR7ldQD for ; Wed, 25 Mar 2009 14:47:27 +0000 (UTC) Received: from cicero1.cybercity.dk (cicero1.cybercity.dk [212.242.40.4]) by smtp.gentoo.org (Postfix) with ESMTP id 11F9C64F54 for ; Wed, 25 Mar 2009 14:47:23 +0000 (UTC) Received: from shuttle.zlin.dk (port78.ds1-abs.adsl.cybercity.dk [212.242.227.17]) by cicero1.cybercity.dk (Postfix) with ESMTP id 9BBA1427C89; Wed, 25 Mar 2009 15:47:21 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by shuttle.zlin.dk (Postfix) with ESMTP id 3DF97104060; Wed, 25 Mar 2009 14:47:21 +0000 (UTC) Received: from shuttle.zlin.dk ([127.0.0.1]) by localhost (shuttle.zlin.dk [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 47JL480XLM72; Wed, 25 Mar 2009 14:47:21 +0000 (UTC) Received: by shuttle.zlin.dk (Postfix, from userid 1000) id 1BCBA104073; Wed, 25 Mar 2009 14:47:21 +0000 (UTC) From: =?utf-8?q?Bo=20=C3=98rsted=20Andresen?= To: gentoo-pms@lists.gentoo.org Cc: =?utf-8?q?Bo=20=C3=98rsted=20Andresen?= Subject: [gentoo-pms] [PATCH 1/4] Specify file modes for all installation commands. Date: Wed, 25 Mar 2009 15:47:18 +0100 Message-Id: <1237992441-20341-1-git-send-email-bo.andresen@zlin.dk> X-Mailer: git-send-email 1.6.1.2 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Package Manager Specification discussions X-BeenThere: gentoo-pms@gentoo.org X-BeenThere: gentoo-pms@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Archives-Salt: c2b5f97a-5ca8-46b3-9fd7-f9137a5485d5 X-Archives-Hash: 884325f4e34f65034058800401172f9e From: Bo =C3=98rsted Andresen --- 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{DE= STTREE} defaults to \t{/usr}. Gives the files mode \t{0755} and ownership \t{root:root}. =20 -\item[doconfd] Installs the given files into /etc/conf.d/. +\item[doconfd] Installs the given files into /etc/conf.d/, by default wi= th file mode + \t{0644}. This can be overridden by setting \t{INSOPTIONS} with the = \t{insopts} function. =20 \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. =20 -\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{do= cinto} 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 directo= ry + \t{/usr/share/doc/\$\{PF\}/}. =20 -\item[doexe] Installs the given files into the directory specified by th= e 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 th= e 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, be= haviour is undefined. =20 \IFKDEBUILDELSE { @@ -213,16 +216,20 @@ are as follows: }{ } =20 -\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}. =20 -\item[doinitd] Installs an initscript into \t{/etc/init.d}. +\item[doinitd] Installs an initscript into \t{/etc/init.d}, by default w= ith file mode \t{0755}. + This can be overridden by setting \t{EXEOPTIONS} with the \t{exeopts= } function. =20 -\item[doins] Takes any number of files as arguments and installs them in= to \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 in= to \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. =20 \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 t= he 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 a= re installed into the same + directory as relative links to their original target. =20 \item[dolib.so] As for dolib. Installs the file with mode \t{0755}. =20 @@ -251,15 +258,15 @@ are as follows: \end{algorithm} =20 \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/sha= re/man/man1/foo.1}. - In EAPIs listed in table~\ref{tab:doman-table} as supporting languag= e codes, a man page with - name of the form\t{foo.lang.1} shall go to \t{/usr/share/man/lang/ma= n1/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{.*} su= ffix, and appending - \t{/LC\_MESSAGES}. + upon its apparent section suffix (e.g. \t{foo.1} goes to \t{/usr/sha= re/man/man1/foo.1} with file + mode \t{0644}. In EAPIs listed in table~\ref{tab:doman-table} as sup= porting language codes, a + man page with name of the form\t{foo.lang.1} shall go to \t{/usr/sha= re/man/lang/man1/foo.1}, + where \t{lang} refers to a pair of lower-case ASCII letters optional= ly 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 app= ropriate subdirectory of + \t{DESTTREE/share/locale}, generated by taking the basename of the f= ile, removing the \t{.*} + suffix, and appending \t{/LC\_MESSAGES}. =20 \item[dosbin] As \t{dobin}, but installs to \t{DESTTREE/sbin}. =20 --=20 1.6.2.1