# Gentoo Archives: gentoo-pms

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