| 1 |
commit: 2955b2dfaa5599677bf33e56c7619ccc557ebfff |
| 2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Tue May 1 16:59:21 2018 +0000 |
| 4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Fri May 4 06:53:51 2018 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=2955b2df |
| 7 |
|
| 8 |
*into, *opts: Clarify the number of arguments |
| 9 |
|
| 10 |
Clarify the number of arguments taken by *into and *opts. The former |
| 11 |
always takes a single argument, so clarify that calling it without |
| 12 |
arguments is invalid. The latter may take 0+ arguments (with 0 |
| 13 |
resetting the list), so clarify that the correct way is to pass multiple |
| 14 |
arguments rather than a single quoted argument. |
| 15 |
|
| 16 |
pkg-mgr-commands.tex | 15 ++++++++------- |
| 17 |
1 file changed, 8 insertions(+), 7 deletions(-) |
| 18 |
|
| 19 |
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex |
| 20 |
index 058be89..07b8d9f 100644 |
| 21 |
--- a/pkg-mgr-commands.tex |
| 22 |
+++ b/pkg-mgr-commands.tex |
| 23 |
@@ -714,12 +714,11 @@ has returned. |
| 24 |
|
| 25 |
\begin{description} |
| 26 |
|
| 27 |
-\item[into] Sets the value of \t{DESTTREE} for future invocations |
| 28 |
- of the above utilities. Creates the directory under \t{\$\{ED\}} |
| 29 |
- in offset-prefix aware EAPIs or under \t{\$\{D\}} in offset-prefix |
| 30 |
- agnostic EAPIs, using \t{install -d} with no additional options, |
| 31 |
- if it does not already exist. Failure behaviour is EAPI dependent |
| 32 |
- as per section~\ref{sec:failure-behaviour}. |
| 33 |
+\item[into] Takes exactly one argument, and sets the value of \t{DESTTREE} for future invocations |
| 34 |
+ of the above utilities to it. Creates the directory under \t{\$\{ED\}} in offset-prefix aware |
| 35 |
+ EAPIs or under \t{\$\{D\}} in offset-prefix agnostic EAPIs, using \t{install -d} with no |
| 36 |
+ additional options, if it does not already exist. Failure behaviour is EAPI dependent as per |
| 37 |
+ section~\ref{sec:failure-behaviour}. |
| 38 |
|
| 39 |
\item[insinto] As \t{into}, for \t{INSDESTTREE}. |
| 40 |
|
| 41 |
@@ -727,7 +726,9 @@ has returned. |
| 42 |
|
| 43 |
\item[docinto] As \t{into}, for install subdirectory of \t{dodoc} et al. |
| 44 |
|
| 45 |
-\item[insopts] Sets the options passed by \t{doins} et al.\ to the \t{install} command. |
| 46 |
+\item[insopts] Takes zero or more arguments, and sets the options passed by \t{doins} et al.\ |
| 47 |
+ to the \t{install} command to them. When called with no arguments, resets the option list |
| 48 |
+ to empty. |
| 49 |
|
| 50 |
\item[diropts] As \t{insopts}, for \t{dodir} et al. |
Archives