[Doxygen-users] Understanding how Doxygen Documentation is generated.

[Bob S. <do...@bo...>]

I'm trying to use doxygen to generate general documentation, in the same way 
that is appears it is used to generate the doxygen documentation itself, but 
I'm having some problems understanding how this documentation is generated.

In particular I have the following questions.

1. How is the doxygen manual divided into 3 parts. For example Part I starts 
with the following heading

Part I
User Manual

Greping the doc directory in the doxygen source shows that the only place 
this text occurs is in doxygen_manual.tex (A latex file I believe). I've 
found nothing in the doxygen documentation about using latex files as part of 
the source for doxygen. So is this file generated by doxygen? If it is 
generated by doxygen then where is the source that it used to get the "Part I 
User Manual" text?

2. While trying to regenerate the doxygen documentation from the doc 
directory, if I type make pdf in the ../latex directory I get the following 
latex error. Do I need a particular version of Latex.

[59]
Underfull \vbox (badness 10000) has occurred while \output is active [60]
Underfull \hbox (badness 10000) in paragraph at lines 167--167

) [61] (config.tex

! LaTeX Error: Environment multicols undefined.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H <return>  for immediate help.
 ...

l.25 \begin{multicols}
                      {2}
?

The make pdf command does work if I type it before doing the doxygen Doxyfile 
command in the doc directory.


3. How do you generate different chapters. In my documentation each /page 
ends up being a different section in one big chapter.


Thanks

Bob Stafford