From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id CF9DD1382C5 for ; Fri, 4 May 2018 07:26:15 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B57D8E0971; Fri, 4 May 2018 07:26:13 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 90ABBE0971 for ; Fri, 4 May 2018 07:26:13 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id E5A92335C74 for ; Fri, 4 May 2018 07:26:11 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 7CCC93E for ; Fri, 4 May 2018 07:26:10 +0000 (UTC) From: "Ulrich Müller" 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 Müller" Message-ID: <1525416831.2955b2dfaa5599677bf33e56c7619ccc557ebfff.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 Müller X-VCS-Revision: 2955b2dfaa5599677bf33e56c7619ccc557ebfff X-VCS-Branch: master Date: Fri, 4 May 2018 07:26:10 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 82a5e359-d92e-4c41-b65e-f6162c4c9c61 X-Archives-Hash: 018828f670d791338231a3ec9ee5d906 commit: 2955b2dfaa5599677bf33e56c7619ccc557ebfff Author: Michał Górny gentoo org> AuthorDate: Tue May 1 16:59:21 2018 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Fri May 4 06:53:51 2018 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=2955b2df *into, *opts: Clarify the number of arguments 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..07b8d9f 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.