From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.54) id 1Eqi7x-0005ZP-3E for garchives@archives.gentoo.org; Mon, 26 Dec 2005 02:30:21 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jBQ2Ta08017416; Mon, 26 Dec 2005 02:29:36 GMT Received: from rwcrmhc12.comcast.net (rwcrmhc14.comcast.net [216.148.227.154]) by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id jBQ2RkRK001177 for ; Mon, 26 Dec 2005 02:27:46 GMT Received: from [192.168.0.106] (c-67-181-55-15.hsd1.ca.comcast.net[67.181.55.15]) by comcast.net (rwcrmhc14) with ESMTP id <20051226022744014008h941e>; Mon, 26 Dec 2005 02:27:44 +0000 From: Chris White Organization: Gentoo Linux To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] making dodoc and dohtml die when they fail and stricter is on Date: Mon, 26 Dec 2005 11:28:27 +0900 User-Agent: KMail/1.8.3 References: <43AF2BF5.4060905@gentoo.org> <200512260226.55175@enterprise.flameeyes.is-a-geek.org> In-Reply-To: <200512260226.55175@enterprise.flameeyes.is-a-geek.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; boundary="nextPart5965615.9Gkpc4jLog"; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-Transfer-Encoding: 7bit Message-Id: <200512261128.32112.chriswhite@gentoo.org> X-Archives-Salt: b5ad642e-2b2c-4702-a04d-3d69e37ded5c X-Archives-Hash: 5265a06ae820e1951d939fc5eaaa6377 --nextPart5965615.9Gkpc4jLog Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On Monday 26 December 2005 10:26, Diego 'Flameeyes' Petten=C3=B2 wrote: > I wouldn't like this. > The reason is, they are also used in eclasses that might be generic; while > for example kde eclass checks for the presence of files before dodoc-ing > them, I would rather see it ignore the actually presence or less of the > files, and just dodoc the one that exists, without failing if some does n= ot > exists. I'm not sure if we're on the same page as far as the target audience of thi= s=20 change. The target audience is developers/those with strict in their=20 features. The whole reason it's done is to be a bit more "strict" (hence t= he=20 =46EATURE phrasing) on general QA. For users that don't need this level of= =20 strict checking, they simply disable the feature. Generalized assumptions = of=20 code finding files simply isn't clean. Checks should be done to verify fil= es=20 before attempting to install, that's just the way it should be out of gener= al=20 practice. > One can be reasonably safe that it will find AUTHORS ChangeLog README NEWS > and TODO files in generic packages, if they follow GNUs style for example, > but sometimes they can be missing. Yes, but while GNU style is indeed the more popular of build sytems, others= =20 still do exist, and will continue to exist. I've always found dodoc should= =20 be checked anyways, and if we're assuming the documentation consists of the= =20 formentioned items, then we're also having the situation of missing other=20 important documentation as well. This all should be checked the first time= a=20 package is imported/version bumped for consistancy. > I'd rather not see the change. Chris White --nextPart5965615.9Gkpc4jLog Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (GNU/Linux) iD8DBQBDr1VQFdQwWVoAgN4RAvFSAJ9Y69KIIBgytfFFihH1ywUKBJALbwCgqy9n 3uXv8+QPT4jyfTsr0UE/8dA= =xAWr -----END PGP SIGNATURE----- --nextPart5965615.9Gkpc4jLog-- -- gentoo-dev@gentoo.org mailing list