[Doxygen-develop] New LaTeX behavior in 1.3-rc1

[Paco H. <do...@fi...>]

I thought I'd post this in the developer list and get feedback.

In 1.3-rc1, I noticed the following changes from 1.2.18.  They're undesirable
from my point of view because I have a huge source base that is documented (5000
pages of PDF) via doxygen, and this significantly changes how the output looks.

1. It used to be the case that you could use \section and \subsection commands
inside the \mainpage.  You can still do this in 1.3-rc1, but in the LaTeX
output, they all get turned into subsection commands.  I used to have Chapter 1,
and then section 1.1 Overview, and section 1.2.2 Device drivers, etc.  Now,
everything is 1.0.1, 1.0.2, 1.0.3, etc.  Regardless of whether I use \page,
\section, or \subsection, they all end up at the same level on the \mainpage. 
In the "related pages" documents, everything behaves as expected.

2. As for the related pages, it used to be possible to have more than one \page
command within a comment block.  I.e. this used to be legit:

/*!
\page foo Glossary
\section sterms Software Terms
..
\page ascii ASCII Character Set
blah blah blah
*/

This doesn't work.  The second \page gets ignored.  The "\page" gets absorbed so
it isn't in the output, but it doesn't create a new section in the related pages.

The workaround is to close and reopen the comment block:
/*!
\page foo Glossary
..
*/
/*!
\page ascii ASCII Character set
..
*/

I'd like to have the old functionality back, if possible.

On an unrelated note, if any of you ever try to create PDF from doxygen on the
scale I'm talking about, you'll hit some serious limits in how many hyperlinks
pdflatex can grok in a single document.  I have solved this problem using the
teTeX distribution and a customized texmf.cnf.  I'd be happy to share this with
anyone who has the same problems.

Regards,
Paco
-- 
pa...@pa...
http://paco.to/