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 A82CA138334 for ; Mon, 7 Oct 2019 12:55:58 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A6554E0829; Mon, 7 Oct 2019 12:55:56 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (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 7E674E0829 for ; Mon, 7 Oct 2019 12:55:56 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 68E7D34B9F4 for ; Mon, 7 Oct 2019 12:55:55 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id BAC877FF for ; Mon, 7 Oct 2019 12:55:52 +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: <1569923228.3c8af0420f4dc0cfabd8dd1fad0d74d2837b414a.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: 3c8af0420f4dc0cfabd8dd1fad0d74d2837b414a X-VCS-Branch: master Date: Mon, 7 Oct 2019 12:55:52 +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-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 7861851d-c920-46ff-8d22-57327e3f0002 X-Archives-Hash: ed8f5f1fa8a55c9688565e2efdb4f0bd commit: 3c8af0420f4dc0cfabd8dd1fad0d74d2837b414a Author: Ulrich Müller gentoo org> AuthorDate: Tue Oct 1 09:47:08 2019 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Tue Oct 1 09:47:08 2019 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=3c8af042 doins, dodoc: Clarify how directories are created. With the -r option, it was unspecified what the mode of any created directories is. Clarify that doins -r will create them as if dodir was called (i.e., respect diropts), and that dodoc -r will create them as if plain install -d was used. For doins, this agrees with package manager implementations. For dodoc, this agrees with historic Paludis behaviour. Portage behaviour has changed in the past, when dodoc was changed from a standalone helper to reusing parts of doins. Usage in the Gentoo repository indicates that no ebuilds call diropts specifically for installing of documentation. However, for several ebuilds dodoc -r is affected by diropts called previously for another directory, which looks like an unwanted side effect. Signed-off-by: Ulrich Müller gentoo.org> pkg-mgr-commands.tex | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index 9aacc70..00ae3a7 100644 --- a/pkg-mgr-commands.tex +++ b/pkg-mgr-commands.tex @@ -448,7 +448,8 @@ the current phase function has returned. directory \t{/usr/share/doc/\$\{PF\}/}. For EAPIs listed in table~\ref{tab:dodoc-table} as supporting \t{-r}, if the first argument is \t{-r}, any subsequent arguments that are directories are installed recursively to the appropriate location; in any other case, it is - an error for a directory to be specified. Failure behaviour is EAPI dependent as per + an error for a directory to be specified. Any directories that don't already exist are created + using \t{install -d} with no additional options. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. \item[doenvd] Installs the given environment files into \t{/etc/env.d/}, by default with file mode @@ -509,10 +510,10 @@ the current phase function has returned. \item[doins] \featurelabel{doins} Takes one or more files as arguments and installs them into \t{INSDESTTREE}, by default with file mode \t{0644}, or with the \t{install} options set by the most recent \t{insopts} call. If the first argument is \t{-r}, then operates recursively, - descending into any directories given. For EAPIs listed in table~\ref{tab:doins-table}, - \t{doins} must install symlinks as symlinks; for other EAPIs, behaviour is undefined if any - symlink is encountered. Failure behaviour is EAPI dependent as per - section~\ref{sec:failure-behaviour}. + descending into any directories given. Any directories are created as if \t{dodir} was called. + For EAPIs listed in table~\ref{tab:doins-table}, \t{doins} must install symlinks as symlinks; + for other EAPIs, behaviour is undefined if any symlink is encountered. Failure behaviour is + EAPI dependent as per section~\ref{sec:failure-behaviour}. \item[dolib.a] For each argument, installs it into the appropriate library subdirectory under \t{DESTTREE}, as determined by algorithm~\ref{alg:ebuild-libdir}. Files are installed with file