omy - 2013-04-22

I am new to doxygen.

I try to create a 'Users Manual' using Doxygen, in a similar style to Doxygen's own user manual.
I have two problems.

1. The old manual used 'group' commands, i.e., \defgroup, \ingroup, \addtogroup

2. Doxygen's own manual is created using 'page' commands, \page, \section, \subsection, etc.

3. What we want is a nicer looking PDF output, that places chapters and sections properly.

4. So, we thought changing the 'group' commands to 'page' commands would help.

5. But, the first problem is, on the mainpage, I define links to the other pages. It does not work.

6. I keep the '\defgroup' on the main page, so that the linking works. Because I don't really know what the problem is.

7. But, the latex output is totally screwed up. Sections are not properly placed at all.

I am clearly doing something wrong.

The structure is as follows: 

/*! \mainpage documentation Documentation of X software
some text bla bla bla
\ref usersmanual Users Manual
*/
<!-- /*! \defgroup usersmanual Users Manual */ -->

Then on the usersmanual.doc, 

/*! \page usersmanual  Users Manual
\addindex
\tableofcontents
bla bla bla

And this does not work.
On the main page, I turn \defgroup on, and on the users manual, I use \addtogroup, instead of \page.
Then it works.

The Latex Output is completely screwed up. It shows 'developers manual' as a section under the Users Manual chapter, and Developers Manual is another page (or group).

Where do I go wrong here?