Re: [libmicrohttpd] Changes in docs

[Christian Grothoff]

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.

Happy hacking!

Christian