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

[Austin English <wizardedit@gentoo.org>]

-----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.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQIcBAEBCAAGBQJXV1/uAAoJEACzKVe5S/PhQuAP/0OZxgfG5tD9IrBV+8VulPr7
TbVq+XITJ3iNwHIvVtZdW65Us+RGJ+oVSET8EroWhUxMV5udjVsphKQ6kXiV6Uc9
IehRKTBeXnwzzhke853xBvV0WLGxQECj3zqpDfHUpaODeR5IB7zvw3qAnhzzaHYQ
QPKuvHm1l1rRIqeHqXY/6kd8DJrCXY1YsF7P1FwYZznmUUGGC1+bYt70rY1OJ6qG
P/SM/fe8C1BTtXQpFDacE6f76fs5AT9MaC9a3/fr6UAiYlKz7bL7l+kzTjHpwuf/
yQGlL9Xc2Cp3zUoXp3zN0Zf+jhxsPvL/4LVv/BPY4IvNFBGCBzBD7Lqv1ootDlZM
HNBcdZV7opz5T8/nCTN35iA1KHgvTxsWwF/vFjtSbaxF4lnhw3OQSFPz6iILQFnj
Xo/7rjw4y4HFBe5BzYujjvl2dDeXfJpEAr9KaOj4yuUpLB1RBLZ2+/uhkcwl5Tp7
pTKG9yKjKOze43fwXITtD8ALCmR3Jn9haMyku9NLiRDr8hKKvSTDC3xeAHeEMMuN
RG9yDrqhfp/rtU3WKCo6hnJ300YJxRm12ltbSqXJEdaVdv2vLoIKJUfaGmGhAHaz
dHtOHjolLI8jjhRsv4bgSYXbQOSJzU/gy2ZsJsHgGibRiRLloe6z8he9RrjaImZB
N+y8gnQjT8GObWtDmiXn
=gTUn
-----END PGP SIGNATURE-----