1 |
>>>>> On Tue, 1 May 2018, Michał Górny wrote: |
2 |
|
3 |
> Clarify the number of arguments taken by *into and *opts. The former |
4 |
> always takes a single argument, so clarify that calling it without |
5 |
> arguments is invalid. The latter may take 0+ arguments (with 0 |
6 |
> resetting the list), so clarify that the correct way is to pass multiple |
7 |
> arguments rather than a single quoted argument. |
8 |
> --- |
9 |
> pkg-mgr-commands.tex | 9 ++++++--- |
10 |
> 1 file changed, 6 insertions(+), 3 deletions(-) |
11 |
|
12 |
> diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex |
13 |
> index 6bb06ca..ad64ad1 100644 |
14 |
> --- a/pkg-mgr-commands.tex |
15 |
> +++ b/pkg-mgr-commands.tex |
16 |
> @@ -715,8 +715,9 @@ has returned. |
17 |
|
18 |
> \begin{description} |
19 |
|
20 |
> -\item[into] Sets the value of \t{DESTTREE} for future invocations |
21 |
> - of the above utilities. Creates the directory under \t{\$\{ED\}} |
22 |
> +\item[into] Takes exactly one argument, and sets the value of \t{DESTTREE} |
23 |
> + for future invocations of the above utilities to it. |
24 |
> + Creates the directory under \t{\$\{ED\}} |
25 |
|
26 |
Please rewrap to 100 characters. |
27 |
|
28 |
> in offset-prefix aware EAPIs or under \t{\$\{D\}} in offset-prefix |
29 |
> agnostic EAPIs, using \t{install -d} with no additional options, |
30 |
> if it does not already exist. Failure behaviour is EAPI dependent |
31 |
> @@ -728,7 +729,9 @@ has returned. |
32 |
|
33 |
> \item[docinto] As \t{into}, for install subdirectory of \t{dodoc} et al. |
34 |
|
35 |
> -\item[insopts] Sets the options passed by \t{doins} et al.\ to the \t{install} command. |
36 |
> +\item[insopts] Takes zero or more arguments, and sets the options passed by \t{doins} et al. |
37 |
> + to the \t{install} command to them. When called with no arguments, resets the option list |
38 |
> + to empty. |
39 |
|
40 |
> \item[diropts] As \t{insopts}, for \t{dodir} et al. |
41 |
|
42 |
> -- |
43 |
> 2.17.0 |