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

[Mike Gilbert]

On Fri, Jan 12, 2018 at 12:57 PM, Michael Orlitzky <mjo@g.o> wrote:
> ---
>  man/ebuild.5 | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/man/ebuild.5 b/man/ebuild.5
> index 9dd969b03..5e2fdbcf5 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.

This change looks ok to me.