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

["M. J. Everitt" <m.j.everitt@iee.org>]

[-- Attachment #1: Type: text/plain, Size: 1278 bytes --]

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


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 901 bytes --]