commit: 40c4cf6ec4cda1a05c4bf3a4a6e9ece4ca74f803 Author: Michael Orlitzky <mjo <AT> gentoo <DOT> org> AuthorDate: Fri Jan 12 22:56:53 2018 +0000 Commit: Zac Medico <zmedico <AT> gentoo <DOT> 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<path> [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<binary> [list of more binaries] Installs a \fIbinary\fR or a list of binaries into \fIDESTTREE\fR/bin.