Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-24 Thread Daniel Drake
Mart Raudsepp wrote: gtk+ documentation rebuilding can take as much as 30 to 60 minutes with the doc USE flag for example. The benefit is cross references to glib, pango and cairo documentation - upstream can not do that as they do not know where the other docs will be found on disk. Though I sho

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Mart Raudsepp
On L, 2007-06-23 at 15:57 +0100, Ciaran McCreesh wrote: > On Sat, 23 Jun 2007 17:45:02 +0300 > Petteri Räty <[EMAIL PROTECTED]> wrote: > > > The doc use flag is used where there is a reason to make > > > documentation optional rather than mandatory. Examples of such > > > reasons include increased

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Ciaran McCreesh
On Sat, 23 Jun 2007 17:45:02 +0300 Petteri Räty <[EMAIL PROTECTED]> wrote: > > The doc use flag is used where there is a reason to make > > documentation optional rather than mandatory. Examples of such > > reasons include increased dependencies (e.g. Doxygen, which pulls > > in a fair bit), increa

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Petteri Räty
Ciaran McCreesh kirjoitti: > On Sat, 23 Jun 2007 17:11:16 +0300 > Petteri Räty <[EMAIL PROTECTED]> wrote: >> 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. > > The doc use flag is used where the

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Ciaran McCreesh
On Sat, 23 Jun 2007 17:11:16 +0300 Petteri Räty <[EMAIL PROTECTED]> wrote: > 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. The doc use flag is used where there is a reason to make documentation o

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Petteri Räty
Marius Mauch kirjoitti: > On Sat, 23 Jun 2007 17:11:16 +0300 > Petteri Räty <[EMAIL PROTECTED]> wrote: > >> 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

Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Marius Mauch
On Sat, 23 Jun 2007 17:11:16 +0300 Petteri Räty <[EMAIL PROTECTED]> wrote: > 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

[gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

2007-06-23 Thread Petteri Räty
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