Re: [gentoo-portage-dev] [PATCH v2 2/2] man/ebuild.5: document the rationale for using keepdir over dodir.

[Zac Medico]

On 01/12/2018 02:56 PM, Michael Orlitzky wrote:
> ---
>  man/ebuild.5 | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/man/ebuild.5 b/man/ebuild.5
> index 28e9582d1..8784a14ee 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 the
> +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.
>

Merged in 40c4cf6ec4cda1a05c4bf3a4a6e9ece4ca74f803, with backslash
escaped hyphen and without 'the' before PMS (for consistency with other
references to PMS). Thanks!
-- 
Thanks,
Zac