From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from [69.77.167.62] (helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-dev+bounces-33060-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1KnIfK-0007KU-TO
	for garchives@archives.gentoo.org; Tue, 07 Oct 2008 19:56:19 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 5B655E0309;
	Tue,  7 Oct 2008 19:56:17 +0000 (UTC)
Received: from smtp-out.neti.ee (smtp-out.neti.ee [194.126.126.37])
	by pigeon.gentoo.org (Postfix) with ESMTP id 11A63E0309
	for <gentoo-dev@lists.gentoo.org>; Tue,  7 Oct 2008 19:56:17 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by MXR-13.estpak.ee (Postfix) with ESMTP id 91B48278CA
	for <gentoo-dev@lists.gentoo.org>; Tue,  7 Oct 2008 22:56:13 +0300 (EEST)
X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com
Received: from smtp-out.neti.ee ([127.0.0.1])
	by localhost (MXR-1.estpak.ee [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id Mi3KU-XUNYaj for <gentoo-dev@lists.gentoo.org>;
	Tue,  7 Oct 2008 22:56:13 +0300 (EEST)
Received: from Relayhost1.neti.ee (Relayhost1 [88.196.174.141])
	by MXR-13.estpak.ee (Postfix) with ESMTP id 0E25F2780E
	for <gentoo-dev@lists.gentoo.org>; Tue,  7 Oct 2008 22:56:13 +0300 (EEST)
Subject: Re: [gentoo-dev] Changing doc use flag on gtk-doc packages to
	gtk-doc-rebuild or something else
From: Mart Raudsepp <leio@gentoo.org>
To: gentoo-dev@lists.gentoo.org
In-Reply-To: <48E95FEE.5050806@gentoo.org>
References: <48E8BB83.1010100@gentoo.org> <48E8C140.2050209@gentoo.org>
	 <48E8EADD.1060504@gentoo.org>  <48E908D0.40209@gentoo.org>
	 <1223249070.3203.8.camel@localhost>  <48E95FEE.5050806@gentoo.org>
Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-AKBXjsBkJiyPzL53ewy1"
Date: Tue, 07 Oct 2008 22:56:04 +0300
Message-Id: <1223409364.17233.8.camel@localhost>
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
Mime-Version: 1.0
X-Mailer: Evolution 2.22.0 
X-Archives-Salt: a5362666-206a-4ae8-9acd-78d7b1ed449b
X-Archives-Hash: f052911449b1db2271984746dfe730dd


--=-AKBXjsBkJiyPzL53ewy1
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On E, 2008-10-06 at 03:46 +0300, Petteri R=E4ty wrote:
> With USE=3D"doc" the GNOME packages behave like what you expect but it's
> the USE=3D"-doc" case that's in question here. With USE=3D"-doc" you don'=
t
> get any use flags installed normally and if it's in the tarball and is
> always installed then there is no doc in IUSE either. Global use flags
> should behave about the same for both on and off cases.

So you propose we would always install the documentation, but have a new
global USE flag (remember, we are talking about over a hundred of
packages here - everything that inherits gnome2.eclass) with a yet to be
determined name to control the re-generation?

However, with the advancements of the gtk-doc system, there _might_ not
be any more benefits in rebuilding the documentation, so I've had the
intention to check that out and perhaps propose removing the doc USE
flag completely and never regenerate it if it's true that it has no
point. But checking this has been quite a low priority, and given that
we need to get GNOME-2.24 out there for the users, it remains so during
this month, at least for me.

I would propose that we (the GNOME team) investigates the benefits (or
lack thereof these days) of the regeneration in the first part of
November, and if we don't, you get to remind us and we take care of it
as the hurry with a new major GNOME version, that users are awaiting
(including squashing all bugs needed before stabilization), will be over
then.

Taking the renaming of the USE flag approach as a start would also mean
touching many GNOME packages (build-depends on gtk-doc if eautoreconf is
involved), and I'd rather not risk that at the moment. It would also
heavily disrupts the moving of the new version ebuilds from overlay to
portage tree.


--=20
Mart Raudsepp
Gentoo Developer
Mail: leio@gentoo.org
Weblog: http://planet.gentoo.org/developers/leio

--=-AKBXjsBkJiyPzL53ewy1
Content-Type: application/pgp-signature; name=signature.asc
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.8 (GNU/Linux)

iEYEABECAAYFAkjrvtQACgkQkeYb6olFHJcauQCbBy0/Q1s9fYh8w0zgrAbKD4Mc
RuUAoIdu+RioeyiQF0xqLUc7kCBEh1C7
=w2dE
-----END PGP SIGNATURE-----

--=-AKBXjsBkJiyPzL53ewy1--