Gentoo Logo
Gentoo Spaceship

Installation:
Gentoo Handbook
Installation Docs

Documentation:
Home
Listing
About Gentoo
Philosophy
Social Contract

Resources:
Bug Tracker
Developer List
Discussion Forums
Gentoo BitTorrents
Gentoo Linux Enhancement Proposals
IRC Channels
Mailing Lists
Mirrors
Name and Logo Guidelines
Online Package Database
Security Announcements
Staffing Needs
Supporting Vendors
View our CVS

Graphics:
Logos and themes
Icons
ScreenShots

Miscellaneous Resources:
Gentoo Linux Store
Gentoo-hosted projects
IBM dW/Intel article archive




List Archive: gentoo-dev
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-dev@g.o
From: Thomas Sachau <tommy@g.o>
Subject: Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
Date: Sun, 05 Oct 2008 20:34:56 +0200
Rémi Cardona schrieb:
> Thomas Sachau a écrit :
>> Why not do both (rebuild and install) with the doc useflag and none of
>> both, if it is not set? Imho
>> the doc flag is for control of installation for (additional) docs, the
>> way it is used for gtk-doc is
>> surely confusing.
>>
> 
> Building gtk-doc documentation pulls in a lot of deps. Installing it
> requires only some disk-space. For a full Gnome system, I only have 96M
> of docs.
> 
> As for rebuilding docs, one of the advantage is to correctly crosslink
> docs for tools such as dev-util/devhelp.
> 
> If anyone is _that_ short on diskspace, we'll gladly take patches :)
> 
> Cheers
> 
> Rémi
> 
> 

Did i say something about disk space? I say, you are using the doc use flag in a way that is not
expected. The global use flag says, it installs additional documentation. But your doc use flag does
not install anything additional, but instead rebuilds those docs. There is nothing wrong with
rebuilding them on use=doc, but imho you should also only install those docs with use=doc.

The patch could be as simple as adding >use doc || rm -rf "${D}"usr/share/gtk-doc< at the end of
src_install()-function in gnome2.eclass, that should be simple enough to apply without a patch. :)

Btw: e.g. x11-libs/gtk+ has no doc use flag, does not rebuild those docs, but does also install
those docs as reported in bug 239524.

-- 
Thomas Sachau

Gentoo Linux Developer
use doc || rm -rf "${D}usr/share/gtk-doc

Attachment:
signature.asc (OpenPGP digital signature)
Replies:
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
-- Mart Raudsepp
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
-- Gilles Dartiguelongue
References:
Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
-- Petteri Räty
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
-- Thomas Sachau
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
-- Rémi Cardona
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
Next by thread:
Re: Changing doc use flag on gtk-doc packages to gtk-doc-rebuild or something else
Previous by date:
Re: Default src_install for EAPI-2 or following EAPI
Next by date:
Re: [gentoo-commits] gentoo-x86 commit in dev-lang/python: ChangeLog python-2.6.ebuild python-2.5.2-r6.ebuild


Updated Jun 17, 2009

Donate to support our development efforts.

Gentoo Centric Hosting: vr.org

VR Hosted

Tek Alchemy

Tek Alchemy

SevenL.net

SevenL.net

php|architect

php|architect

Copyright 2001-2007 Gentoo Foundation, Inc. Questions, Comments? Email www@gentoo.org.