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.62) (envelope-from ) id 1I26Ni-0002yc-Ba for garchives@archives.gentoo.org; Sat, 23 Jun 2007 14:14:30 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l5NEDV9T005365; Sat, 23 Jun 2007 14:13:31 GMT Received: from smtp-3.tky.hut.fi (smtp03.tky.fi [82.130.63.73]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l5NEBdga003073 for ; Sat, 23 Jun 2007 14:11:39 GMT Received: from [82.130.46.229] ([82.130.46.229]) by smtp-3.tky.hut.fi (SMSSMTP 4.1.9.35) with SMTP id M2007062317113717321 for ; Sat, 23 Jun 2007 17:11:37 +0300 Message-ID: <467D2A04.6080504@gentoo.org> Date: Sat, 23 Jun 2007 17:11:16 +0300 From: =?UTF-8?B?UGV0dGVyaSBSw6R0eQ==?= User-Agent: Thunderbird 2.0.0.4 (X11/20070620) 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 To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it X-Enigmail-Version: 0.95.1 OpenPGP: url=http://users.tkk.fi/~praty/public.asc Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enig3EA302598566F4E1ED81E472" X-Archives-Salt: 2141859b-37bd-4569-9a8f-62fb005683d5 X-Archives-Hash: 63f19a2286e0046416b91f7a042e5e02 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig3EA302598566F4E1ED81E472 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable For example the gnome people use the doc use flag to control whether gtk-doc gets rebuild using cross references: 16:51 <@leio> as far as I'm concerned the doc USE flag means rebuilding documentation to get cross-referencing in docs working 16:51 <@leio> also the lack of doc USE flag does not mean to not install documentation 16:52 <@leio> it means to not take a long time to build documentation, and we are not doing it if doc USE flag is not present This leads to having tons of gtk-doc installed: betelgeuse@pena ~ $ du -sh /usr/share/gtk-doc/html/ 51M /usr/share/gtk-doc/html/ In for example Java we use it to control Javadoc installation. Javadoc generation rarely takes much time and needs no extra dependencies but having Javadocs for everything would consume a lot of space. My opinion is to make it clear that the doc use flag always controls whether or not to install documentation and make it clear in the devmanual. For what gnome does, they can then add for example a gtk-doc use flag to control the building of the cross references and have the doc use flag control the installation of the bundled documentation. betelgeuse@pena ~ $ euse -i doc global use flags (searching: doc) ************************************************************ [- ] doc - Adds extra documentation (API, Javadoc, etc) INSTALL_MASK is of course a solution to not installing gtk-doc at all but it doesn't give me the ability to install it only for individual packages. What do others think? Regards, Petteri --------------enig3EA302598566F4E1ED81E472 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.4 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFGfSoGcxLzpIGCsLQRAo1bAJ4/m8j+GRzxMt+ig4+spb5THU7QVACeLZ3e nOsXs+hyEuRcho3WaGRJBaU= =eipj -----END PGP SIGNATURE----- --------------enig3EA302598566F4E1ED81E472-- -- gentoo-dev@gentoo.org mailing list