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

2018-01-13 Thread 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 [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 [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



signature.asc
Description: OpenPGP digital signature


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

2018-01-12 Thread Michael Orlitzky
---
 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 [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 [list of more binaries]
 Installs a \fIbinary\fR or a list of binaries into \fIDESTTREE\fR/bin.
-- 
2.13.6