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 7D4C1138330 for ; Sat, 13 Jan 2018 10:11:55 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id BB3D4E0922; Sat, 13 Jan 2018 10:11:54 +0000 (UTC) Received: from smtp.gentoo.org (smtp.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 9EEFCE0922 for ; Sat, 13 Jan 2018 10:11:54 +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 63EE6335C4D for ; Sat, 13 Jan 2018 10:11:53 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id E206C1A6 for ; Sat, 13 Jan 2018 10:11:51 +0000 (UTC) From: "Zac Medico" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Zac Medico" Message-ID: <1515838197.40c4cf6ec4cda1a05c4bf3a4a6e9ece4ca74f803.zmedico@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/ebuild.5 X-VCS-Directories: man/ X-VCS-Committer: zmedico X-VCS-Committer-Name: Zac Medico X-VCS-Revision: 40c4cf6ec4cda1a05c4bf3a4a6e9ece4ca74f803 X-VCS-Branch: master Date: Sat, 13 Jan 2018 10:11:51 +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: a3cb91b8-41cd-4070-816f-ccd9c6dbca35 X-Archives-Hash: 60bfcb2162ed1131759c553c115cacd7 commit: 40c4cf6ec4cda1a05c4bf3a4a6e9ece4ca74f803 Author: Michael Orlitzky gentoo org> AuthorDate: Fri Jan 12 22:56:53 2018 +0000 Commit: Zac Medico gentoo org> CommitDate: Sat Jan 13 10:09:57 2018 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=40c4cf6e man/ebuild.5: document the rationale for using keepdir over dodir. man/ebuild.5 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/man/ebuild.5 b/man/ebuild.5 index 28e9582d1..270e47fe8 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -1285,8 +1285,9 @@ Sets the root (\fIDESTTREE\fR) for other functions like \fBdobin\fR, The default root is /usr. .TP .B keepdir\fR \fI [more paths] -Tells portage to leave directories behind even if they're empty. Functions -the same as \fBdodir\fR. +Similar to \fBdodir\fR, but used to create directories that would otherwise +be empty. The treatment of completely\-empty directories is undefined by +PMS, and using \fBkeepdir\fR ensures that they are tracked. .TP .B dobin\fR \fI [list of more binaries] Installs a \fIbinary\fR or a list of binaries into \fIDESTTREE\fR/bin.