From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 3E73D1381F3 for ; Tue, 10 Sep 2013 21:02:50 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 05BF9E09FF; Tue, 10 Sep 2013 21:02:47 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 7A925E09FF for ; Tue, 10 Sep 2013 21:02:46 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 5B63E33BE40 for ; Tue, 10 Sep 2013 21:02:45 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 0FAB6E5459 for ; Tue, 10 Sep 2013 21:02:44 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1377762662.8ed75a9fb02c757759132e8bfbdea6cbab09bd98.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: pkg-mgr-commands.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: 8ed75a9fb02c757759132e8bfbdea6cbab09bd98 X-VCS-Branch: master Date: Tue, 10 Sep 2013 21:02:44 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: a90ad642-28f1-493a-a889-b0bec0f56ef9 X-Archives-Hash: a7f4a7ce7917b844de8b317161e29af5 commit: 8ed75a9fb02c757759132e8bfbdea6cbab09bd98 Author: Ulrich Müller gentoo org> AuthorDate: Tue Aug 20 12:40:41 2013 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Thu Aug 29 07:51:02 2013 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=8ed75a9f Installation commands must be called with at least one parameter. Also adjust the wording for doinfo, doman, and domo, in order to clarify that multiple file name parameters are allowed. --- pkg-mgr-commands.tex | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index bafa748..acf71ac 100644 --- a/pkg-mgr-commands.tex +++ b/pkg-mgr-commands.tex @@ -249,8 +249,9 @@ install} target cannot be used or does not install all needed files. Except wher all filenames created or modified are relative to the staging directory including the offset-prefix \t{ED} in offset-prefix aware EAPIs, or just the staging directory \t{D} in offset-prefix agnostic EAPIs. Existing destination files are overwritten. These commands must all be external programs and -not bash functions or aliases---that is, they must be callable from \t{xargs}. Ebuilds must not run -any of these commands once the current phase function has returned. +not bash functions or aliases---that is, they must be callable from \t{xargs}. Calling any of these +commands without a filename parameter is an error. Ebuilds must not run any of these commands once +the current phase function has returned. \begin{description} \item[dobin] Installs the given files into \t{DESTTREE/bin}, where @@ -320,14 +321,14 @@ can be extended or reduced (see below). The options that can be passed to \t{doh It is undefined whether a failure shall occur if \t{-r} is not specified and a directory is encountered. Ebuilds must not rely upon any particular behaviour. -\item[doinfo] Installs a GNU Info file into the \t{/usr/share/info} area with file mode \t{0644}. - Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. +\item[doinfo] Installs the given GNU Info files into the \t{/usr/share/info} area with file mode + \t{0644}. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. \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. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. -\item[doins] \featurelabel{doins} Takes any number of files as arguments and installs them into +\item[doins] \featurelabel{doins} Takes one or more 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. For EAPIs listed in @@ -367,9 +368,9 @@ can be extended or reduced (see below). The options that can be passed to \t{doh \end{algorithmic} \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}) with - file mode \t{0644}. +\item[doman] Installs the given man pages 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}) with file mode \t{0644}. \featurelabel{doman-langs} In EAPIs listed in table~\ref{tab:doman-table} as supporting language detection by filename, a man page with name of the form \t{foo.}\i{lang}\t{.1} shall @@ -383,10 +384,10 @@ can be extended or reduced (see below). The options that can be passed to \t{doh the empty string. In EAPIs specified by table~\ref{tab:doman-table}, the \t{-i18n} option takes precedence over the language code in the filename. -\item[domo] Installs a \t{.mo} file with file mode \t{0644} into the appropriate subdirectory of - \t{DESTTREE\slash share\slash locale}, generated by taking the basename of the file, removing - the \t{.*} suffix, and appending \t{/LC\_MESSAGES}. The name of the installed files is the - package name with \t{.mo} appended. Failure behaviour is EAPI dependent as per +\item[domo] Installs the given \t{.mo} files with file mode \t{0644} into the appropriate + subdirectory of \t{DESTTREE\slash share\slash locale}, generated by taking the basename of the + file, removing the \t{.*} suffix, and appending \t{/LC\_MESSAGES}. The name of the installed + files is the package name with \t{.mo} appended. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. \item[dosbin] As \t{dobin}, but installs to \t{DESTTREE/sbin}.