From: "Michał Górny" <mgorny@gentoo.org>
To: gentoo-pms@lists.gentoo.org
Cc: "Michał Górny" <mgorny@gentoo.org>
Subject: [gentoo-pms] [PATCH v2 5/6] *into, *opts: Clarify the number of arguments
Date: Tue, 1 May 2018 18:59:21 +0200 [thread overview]
Message-ID: <20180501165922.22032-5-mgorny@gentoo.org> (raw)
In-Reply-To: <20180501165922.22032-1-mgorny@gentoo.org>
Clarify the number of arguments taken by *into and *opts. The former
always takes a single argument, so clarify that calling it without
arguments is invalid. The latter may take 0+ arguments (with 0
resetting the list), so clarify that the correct way is to pass multiple
arguments rather than a single quoted argument.
---
pkg-mgr-commands.tex | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 058be89..6397a4b 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -714,12 +714,11 @@ has returned.
\begin{description}
-\item[into] Sets the value of \t{DESTTREE} for future invocations
- of the above utilities. Creates the directory under \t{\$\{ED\}}
- in offset-prefix aware EAPIs or under \t{\$\{D\}} in offset-prefix
- agnostic EAPIs, using \t{install -d} with no additional options,
- if it does not already exist. Failure behaviour is EAPI dependent
- as per section~\ref{sec:failure-behaviour}.
+\item[into] Takes exactly one argument, and sets the value of \t{DESTTREE} for future invocations of
+ the above utilities to it. Creates the directory under \t{\$\{ED\}} in offset-prefix aware
+ EAPIs or under \t{\$\{D\}} in offset-prefix agnostic EAPIs, using \t{install -d} with no
+ additional options, if it does not already exist. Failure behaviour is EAPI dependent as per
+ section~\ref{sec:failure-behaviour}.
\item[insinto] As \t{into}, for \t{INSDESTTREE}.
@@ -727,7 +726,9 @@ has returned.
\item[docinto] As \t{into}, for install subdirectory of \t{dodoc} et al.
-\item[insopts] Sets the options passed by \t{doins} et al.\ to the \t{install} command.
+\item[insopts] Takes zero or more arguments, and sets the options passed by \t{doins} et al.
+ to the \t{install} command to them. When called with no arguments, resets the option list
+ to empty.
\item[diropts] As \t{insopts}, for \t{dodir} et al.
--
2.17.0
next prev parent reply other threads:[~2018-05-01 17:01 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-05-01 16:59 [gentoo-pms] [PATCH v2 1/6] nonfatal: Reword argument handling to be cleaner Michał Górny
2018-05-01 16:59 ` [gentoo-pms] [PATCH v2 2/6] best_version: Explicitly specify the output format Michał Górny
2018-05-01 16:59 ` [gentoo-pms] [PATCH v2 3/6] Account for 'Build commands' being run in src_test Michał Górny
2018-05-01 16:59 ` [gentoo-pms] [PATCH v2 4/6] *into, *opts: Reword to use 'as ...' wording from 'do*' Michał Górny
2018-05-01 16:59 ` Michał Górny [this message]
2018-05-04 9:15 ` [gentoo-pms] [PATCH v2 5/6] *into, *opts: Clarify the number of arguments Ulrich Mueller
2018-05-01 16:59 ` [gentoo-pms] [PATCH v2 6/6] *into, *opts: Remove redundant offset-prefix sentence from heading Michał Górny
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180501165922.22032-5-mgorny@gentoo.org \
--to=mgorny@gentoo.org \
--cc=gentoo-pms@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox