From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-627095-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
by finch.gentoo.org (Postfix) with ESMTP id 3E73D1381F3
for <garchives@archives.gentoo.org>; 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 <gentoo-commits@lists.gentoo.org>; 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 <gentoo-commits@lists.gentoo.org>; 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 <gentoo-commits@lists.gentoo.org>; Tue, 10 Sep 2013 21:02:44 +0000 (UTC)
From: "Ulrich Mueller" <ulm@gentoo.org>
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" <ulm@gentoo.org>
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: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
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 <ulm <AT> gentoo <DOT> org>
AuthorDate: Tue Aug 20 12:40:41 2013 +0000
Commit: Ulrich Mueller <ulm <AT> gentoo <DOT> 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}.