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

[Daniel Campbell]

On 06/07/2016 04:59 PM, Austin English wrote:
>
> 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.
>
>
Agreed. We can already add on to other arrays or lists, why should DOCS
be any different?
-- 
Daniel Campbell - Gentoo Developer
OpenPGP Key: 0x1EA055D6 @ hkp://keys.gnupg.net
fpr: AE03 9064 AE00 053C 270C  1DE4 6F7A 9091 1EA0 55D6