Duncan Gibson wrote:
>> For the new doxygen docs, I currently don't know how to generate a
>> printable (pdf) version, although I know that there are doxygen options
>> (GENERATE_LATEX and USE_PDFLATEX). I tried them once, but didn't succeed
>> with my cygwin LaTeX version :-(
> 
> In principle it's just a question of setting the Doxyfile options:
> 
> GENERATE_LATEX         = YES
> PDF_HYPERLINKS         = YES
> USE_PDFLATEX           = YES
> 
> running doxygen, and then running 'make' in the latex directory
> that doxygen creates.

Yes, something like this, I thought too.

> However, I've just tried it, and I get an awful lot of LaTeX errors.
> It still generates a 151 page refman.pdf, but it's clearly incomplete.
> The chapters seem to be out of order, many of the links don't work,
> there are no images, and there is no class reference.

No images was to be expected. The tags we used so far are for html 
images only, as far as I read the doxygen documentation. We would need 
to add doxygen commands for LaTeX images as well.

> It could be that there's something missing from my environment, or
> that I have to tweak some other setting, but we probably would still
> need to do a lot of other tidying up before we can get this to work.

I think that we must find a way to get this working soon, because we 
will need a usable structure in the pdf docs. Maybe we need other 
structuring commands in the doxygen sources (.H and .cxx files).

> Pity! It would have been a neat solution.

As Fabien wrote: this _should_ be the solution, but we must find out how 
to get it working. Fabien has done a lot of good work with the module 
pages, adding the necessary \relates, \addtogroup and more commands. We 
need to know how this will show up in the pdf file, before we add more 
work that would maybe not work as expected. E.g. why are the module 
pages not sorted in a useful (alphabetical?) order? How can we sort them 
in a way we *like*?

Albrecht
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to