[Doxygen-users] "free-style" man pages

[Patrick O. <Pat...@pa...>]

Hi!

I noticed that creation of documentation defined via \page
was disabled for man output, probably because it wasn't
really useful.

I have made some changes that make it possible to use \page,
\section and \subsection to create a reasonable man page, e.g.
for commands:

- added support for sections and subsections in man pages
  and enabled output of \pages as man
- extended the usage of MAN_EXTENSION: now it also defines
  which section is used in the man path and the .TH line
- actually distinguish between \section and \subsection
  when writing \pages

The last thing puzzled me a bit: in doxygen.cpp:generatePageDocs()
all sections were printed, but without telling the output
generator whether they were sections or subsections (last
argument of start/endSection). I have changed that and it works
fine in html (using H2/H3) and man (.SH/.SS). 

Patches attached - I hope they are useful.

BTW, who is using the man output and for what purposes?
I just want to know if these changes might break anything
currently in use already.

Bye, Patrick
-- 
// pallas  GmbH  ............  Patrick Ohly  .............
   Hermuelheimer Str. 10       Software-Engineer
   D-50321 Bruehl, Germany     po...@pa...
   fax +49-(0)2232-1896-29     phone  +49-(0)2232-1896-30 
   http://www.pallas.com 
..........................................................