From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id D11EF13829C for ; Wed, 8 Jun 2016 06:39:26 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B7752142BE; Wed, 8 Jun 2016 06:39:22 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id B90CD142B7 for ; Wed, 8 Jun 2016 06:39:21 +0000 (UTC) Received: from pomiot (d202-252.icpnet.pl [109.173.202.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 6ED54340BD7; Wed, 8 Jun 2016 06:39:19 +0000 (UTC) Date: Wed, 8 Jun 2016 08:39:14 +0200 From: =?UTF-8?B?TWljaGHFgiBHw7Nybnk=?= To: Austin English Cc: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Default DOCS for einstalldocs and HACKING file Message-ID: <20160608083914.0f8ee7e1.mgorny@gentoo.org> In-Reply-To: <57575FEE.70205@gentoo.org> References: <57574F9D.9040008@gentoo.org> <57575693.5040803@iee.org> <57575FEE.70205@gentoo.org> Organization: Gentoo X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.30; x86_64-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; boundary="Sig_/nIBHlZx772W1GcIuKbB_08J"; protocol="application/pgp-signature" X-Archives-Salt: 8049f7a9-b108-4055-bc7d-11d7f8090444 X-Archives-Hash: bcc7df3648430a7438b83a789c955411 --Sig_/nIBHlZx772W1GcIuKbB_08J Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Tue, 7 Jun 2016 18:59:42 -0500 Austin English wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA256 >=20 > On 06/07/2016 06:19 PM, M. J. Everitt wrote: > > On 07/06/16 23:50, NP-Hardass wrote: =20 > >> 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 notic= ed > >> 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? > >> =20 > > 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 =20 >=20 > Some way to append docfiles would be very welcome IMO. src_install() { default dodoc HACKING } You're welcome. --=20 Best regards, Micha=C5=82 G=C3=B3rny --Sig_/nIBHlZx772W1GcIuKbB_08J Content-Type: application/pgp-signature Content-Description: OpenPGP digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQJ8BAEBCgBmBQJXV72SXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQ2REJCMDdDQzRGMERBRDA2RUEwQUZFNDFC MDdBMUFFQUVGQjQ0NjRFAAoJELB6GurvtEZOOLAQAKac6ljKgWYcxhwPtia119GM 1N+jZaxXv6DxshzqUZBDGRxgE4s3UbZgnOsW7uqJXFrjEXAiJvtWWZI4zfpwv8uK mC4n2i2GrMsr20G/tFtMec/iCNvoXPS0T9h2V08QLUB/csdMQ9Gp/w0LAC6vnHGS Yx0qJRkkSq66dzcR76zOFkGsNEM0S/VpKLJyy0Z6Yk2nJEvKipeXt+KN45dgcIz/ WvLCOUB4kC4vDwC3L/U6HN85fIHaH1DNZVYlPv1pnN3OTNeTcvxuZvaIpKk1LaNs +z8YdcheILCZdGP7u6MbwxDqso7rYsjTyfM9yMQAWU/SnXvsmgEGh5VrFu41zbHP dLgWdfsXQq1wz8/e7A2X/ibWnL9EucWsFLCzxyhAOskbDrj9iL2LqAL7svb/SGrN QHIS84IlSaA7W+jMFQu2fL9HoU44w7EYZU/3SjKFaDXe10AS/bcBEhCNPTPUWRZt CsTyu1g6F/4YWdscVrqb5oJO40hTGL2tbppLae8DgHAHl/SKYh914BABCgmQyYmw mL/YBe7QfuZ7M6BHQB3cjyimc1uFAh4Y7b46Lkk8f2uJLvYyvM2Exe9Fl8gPYis4 beRi0dkKma4B3cDkXRLsUW+bwjv2sxYu3AUOavqjl342ZVOwtvhl4jJg/kzr5PwM slDnoDhv9TmTCfN3DVtS =VByK -----END PGP SIGNATURE----- --Sig_/nIBHlZx772W1GcIuKbB_08J--