Re: [libmicrohttpd] Changes in docs

[Václav Pavlín]

Christian Grothoff píše v Út 10. 09. 2013 v 16:26 +0200:
> On 09/10/2013 04:02 PM, Václav Pavlín wrote:
> > Hi,
> > 
> > I maintain libmicrohttpd in Fedora and I ran into problems when updating
> > package to the latest two version (0.9.29, 0.9.30). 
> > 
> > What've been changed is that file doc/Doxyfile is missing and instead
> > there is folder doxygen containing Makefiles and libmicrohttpd.doxy.
> > 
> > I think the problem is that command make in doc/doxygen only prints
> > 
> > Generate documentation:
> >     make full - full documentation with dependency graphs (slow)
> >     make fast - fast mode without dependency graphs
> > 
> > and does not really build anything. 
> 
> That's intended.
> 
> > Do you have any suggestions how to solve this? Should it be explicitly
> > called make full/fast in mentioned folder? If so, should it be full or
> > fast? Or would it be viable for you to actually build the documentation
> > on "make" call?
> 
> Well, as 'doxygen' may not be installed for all users and many might
> not need it (and the output can be rather large), I decided against that.
> I'm also not sure if you'd even _want_ to package the doxgyen docs in Fedora.
> You do have the info manual and the info tutorial and the man page,
> which should be more than sufficient for most users.
> 
> So my assumption was that most distributions would NOT package the
> doxygen documentation (it is also NOT installed in the prefix, btw),
> and that users that did want it would grab the full source and create
> the HTML themselves.

Yes, that makes sense, thanks!

> 
> Happy hacking!
> 
> Christian
> 
>