Gentoo Archives: gentoo-dev

From: Austin English <wizardedit@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Default DOCS for einstalldocs and HACKING file
Date: Wed, 08 Jun 2016 00:00:25
Message-Id: 57575FEE.70205@gentoo.org
In Reply to: Re: [gentoo-dev] Default DOCS for einstalldocs and HACKING file by "M. J. Everitt"
1 -----BEGIN PGP SIGNED MESSAGE-----
2 Hash: SHA256
3
4 On 06/07/2016 06:19 PM, M. J. Everitt wrote:
5 > On 07/06/16 23:50, NP-Hardass wrote:
6 >> From what I've seen, HACKING is a fairly common doc in FOSS projects.
7 >> It doesn't seem to have been included in the default DOCS for
8 >> einstalldocs in EAPI6. While going through the MATE packages, I noticed
9 >> that we have quite a few packages that include HACKING in DOCS, so I
10 >> cannot delete the DOCS array and take advantage of the automagic doc
11 >> detection feature of einstalldocs.
12 >>
13 >> Does anyone know why we omitted this file from the default DOCS? A
14 >> quick grep of the main repo shows ~370 ebuilds with HACKING listed. Is
15 >> this file no longer considered worthy of being included by default in
16 >> our installed docs? If so, looking for advice on whether it is worth
17 >> keeping or dropping that file from my packages?
18 >>
19 > I made the suggestion a while back in IRC that it would be nice if there
20 > was a way to append to the DOCS array in an ebuild, rather than have to
21 > override it, and remember the standard list every time, or just lose the
22 > extra file(s). Unfortunately I was laughed out of the channel. So,
23 > whilst it would probably be something for another EAPI change .. what do
24 > readers think of the idea of an EXTRA_DOCS variable or similar method
25 > for doing this, for exactly this reason/purpose??
26 >
27 > MJE
28
29 Some way to append docfiles would be very welcome IMO.
30 -----BEGIN PGP SIGNATURE-----
31 Version: GnuPG v2
32
33 iQIcBAEBCAAGBQJXV1/uAAoJEACzKVe5S/PhQuAP/0OZxgfG5tD9IrBV+8VulPr7
34 TbVq+XITJ3iNwHIvVtZdW65Us+RGJ+oVSET8EroWhUxMV5udjVsphKQ6kXiV6Uc9
35 IehRKTBeXnwzzhke853xBvV0WLGxQECj3zqpDfHUpaODeR5IB7zvw3qAnhzzaHYQ
36 QPKuvHm1l1rRIqeHqXY/6kd8DJrCXY1YsF7P1FwYZznmUUGGC1+bYt70rY1OJ6qG
37 P/SM/fe8C1BTtXQpFDacE6f76fs5AT9MaC9a3/fr6UAiYlKz7bL7l+kzTjHpwuf/
38 yQGlL9Xc2Cp3zUoXp3zN0Zf+jhxsPvL/4LVv/BPY4IvNFBGCBzBD7Lqv1ootDlZM
39 HNBcdZV7opz5T8/nCTN35iA1KHgvTxsWwF/vFjtSbaxF4lnhw3OQSFPz6iILQFnj
40 Xo/7rjw4y4HFBe5BzYujjvl2dDeXfJpEAr9KaOj4yuUpLB1RBLZ2+/uhkcwl5Tp7
41 pTKG9yKjKOze43fwXITtD8ALCmR3Jn9haMyku9NLiRDr8hKKvSTDC3xeAHeEMMuN
42 RG9yDrqhfp/rtU3WKCo6hnJ300YJxRm12ltbSqXJEdaVdv2vLoIKJUfaGmGhAHaz
43 dHtOHjolLI8jjhRsv4bgSYXbQOSJzU/gy2ZsJsHgGibRiRLloe6z8he9RrjaImZB
44 N+y8gnQjT8GObWtDmiXn
45 =gTUn
46 -----END PGP SIGNATURE-----

Replies