Gentoo Archives: gentoo-dev

From: "Petteri Räty" <betelgeuse@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it
Date: Sat, 23 Jun 2007 14:48:16
Message-Id: 467D31EE.4030109@gentoo.org
In Reply to: Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it by Ciaran McCreesh
1 Ciaran McCreesh kirjoitti:
2 > On Sat, 23 Jun 2007 17:11:16 +0300
3 > Petteri Räty <betelgeuse@g.o> wrote:
4 >> My opinion is to make it clear that the doc use flag always controls
5 >> whether or not to install documentation and make it clear in the
6 >> devmanual.
7 >
8 > The doc use flag is used where there is a reason to make documentation
9 > optional rather than mandatory. Examples of such reasons include
10 > increased dependencies (e.g. Doxygen, which pulls in a fair bit),
11 > increased build time (e.g. Doxygen, which can be frickin' slow) or
12 > substantially increased disk usage. If there's no substantial cost to
13 > documentation, it should always be installed.
14 >
15
16 Yep but we should for example document what constitues increased disk
17 usage. How about "several megabytes or tens of files"?
18
19 Regards,
20 Petteri

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies

Subject Author
Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it Ciaran McCreesh <ciaranm@×××××××.org>