Re: [gentoo-dev] Default DOCS for einstalldocs and HACKING file

[Michał Górny]

On Tue, 7 Jun 2016 18:59:42 -0500
Austin English <wizardedit@g.o> wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA256
>
> On 06/07/2016 06:19 PM, M. J. Everitt wrote:
> > On 07/06/16 23:50, NP-Hardass wrote:
> >> From what I've seen, HACKING is a fairly common doc in FOSS projects.
> >> It doesn't seem to have been included in the default DOCS for
> >> einstalldocs in EAPI6.  While going through the MATE packages, I noticed
> >> that we have quite a few packages that include HACKING in DOCS, so I
> >> cannot delete the DOCS array and take advantage of the automagic doc
> >> detection feature of einstalldocs.
> >>
> >> Does anyone know why we omitted this file from the default DOCS?  A
> >> quick grep of the main repo shows ~370 ebuilds with HACKING listed.   Is
> >> this file no longer considered worthy of being included by default in
> >> our installed docs?  If so, looking for advice on whether it is worth
> >> keeping or dropping that file from my packages?
> >>
> > I made the suggestion a while back in IRC that it would be nice if there
> > was a way to append to the DOCS array in an ebuild, rather than have to
> > override it, and remember the standard list every time, or just lose the
> > extra file(s). Unfortunately I was laughed out of the channel. So,
> > whilst it would probably be something for another EAPI change .. what do
> > readers think of the idea of an EXTRA_DOCS variable or similar method
> > for doing this, for exactly this reason/purpose??
> >
> > MJE
>
> Some way to append docfiles would be very welcome IMO.

src_install() {
  default
  dodoc HACKING
}

You're welcome.

-- 
Best regards,
Michał Górny
<http://dev.gentoo.org/~mgorny/>