Gentoo Archives: gentoo-portage-dev

From: Mike Gilbert <floppym@g.o>
To: gentoo-portage-dev@l.g.o
Subject: Re: [gentoo-portage-dev] [PATCH 1/2] man/ebuild.5: document that dodir is for nonempty directories.
Date: Fri, 12 Jan 2018 20:29:51
Message-Id: CAJ0EP40oT7XKLN42W9kJNNGw=VmdqLpZ=3RfdNE5NC_zf5vFEw@mail.gmail.com
In Reply to: [gentoo-portage-dev] [PATCH 1/2] man/ebuild.5: document that dodir is for nonempty directories. by Michael Orlitzky
1 On Fri, Jan 12, 2018 at 12:57 PM, Michael Orlitzky <mjo@g.o> wrote:
2 > ---
3 > man/ebuild.5 | 5 +++--
4 > 1 file changed, 3 insertions(+), 2 deletions(-)
5 >
6 > diff --git a/man/ebuild.5 b/man/ebuild.5
7 > index 42a0599fe..9dd969b03 100644
8 > --- a/man/ebuild.5
9 > +++ b/man/ebuild.5
10 > @@ -1267,11 +1267,12 @@ that this expression does \fBNOT\fR use the offset prefix.
11 > runs sed on ${ED}/usr/bin/some\-script
12 > .TP
13 > .B dodir\fR \fI<path> [more paths]
14 > -Creates directories inside of ${ED}.
15 > +Creates (nonempty) directories inside of ${ED}.
16
17 To me, this implies that the directory will be nonempty after calling dodir.
18
19 > .br
20 > .BR 'dodir\ /usr/lib/apache'
21 > creates ${ED}/usr/lib/apache. Note that the do* functions will run
22 > -\fBdodir\fR for you.
23 > +\fBdodir\fR for you. Empty directories must be created with \fBkeepdir\fR
24 > +instead.
25
26 Maybe rephrase this. For example:
27
28 To install a directory without any files, use keepdir instead.