[Rpm-maint] --without-apidocs, patch

[Panu Matilainen]

On Tue, 11 Dec 2007, Ralf Corsepius wrote:

>
> On Tue, 2007-12-11 at 11:05 +0200, Panu Matilainen wrote:
>> On Tue, 11 Dec 2007, Pixel wrote:
>>
>>> IMO --without-apidocs should allow to not build apidocs. Currently
>>> HEAD builds librpm doc even if --without-apidocs is given
>>
>> No objections as such but...
>
> Well, .. objection!
>
> 1. librpm.doxy generated docs are supposed to be shipped pre-built
>
> 2. it should be --enable/disable-*docs, not --with/without.
>
>> So your patch just disables the librpm (actual API
>> documentation as it only covers public headers) doc from building at
>> all, you'll need to add a bit of logic to configure.ac too for the
>> desired effect.
> I disagree on this patch, because we are shipping pre-built librpm-docs
> as part of the tarballs. I.e. unless you build from hg, you should not
> be required to have doxygen installed when building rpm from a "make
> dist" generated tarball.

Yes, pre-built librpm docs in tarballs are nice - I suppose Pixel's 
annoyance is that it still takes some extra time to build those docs when 
hacking on stuff from hg...

One possibility would be to move the librpm doc generation to "make dist" 
time.

 	- Panu -