GENERATE_MAN / doxygen 1.7.1 (Origin: bugzilla #641188)

[doxygen]

status RESOLVED severity normal in component general for ---
Reported in version 1.7.1 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

• doxyfile.in (ID 179863)
• gdcmdump.man (ID 179864)

On 2011-02-01 21:15:22 +0000, Mathieu Malaterre wrote:

I am trying to understand what changed in my setup doxygen 1.7.1 and
man-db 2.5.7. I used to be able to generate man page using the
GENERATE_MAN option. However today I noticed the output looks odd:

For instance the following:

...
\page gdcmdump dumps a DICOM file, it will display the structure and
values contained in the specified DICOM file.

\section synopsis SYNOPSIS

\verbatim
gdcmdump [options] dcm_file
gdcmdump [options] dcm_directory
\endverbatim
...

leads to:

.TH "gdcmdump" 1 "Tue Feb 1 2011" "Version 2.1.0" "GDCM" " -- nroff --
.ad l
.nh
.SH NAME
gdcmdump - .TH "gdcmdump" 1 "Tue Feb 1 2011" "Version 2.1.0" "GDCM"
" -- nroff --
.ad l
.nh
.SH NAME
gdcmdump - .SH "SYNOPSIS"
.PP
.PP
.nf

gdcmdump [options] dcm_file
gdcmdump [options] dcm_directory
.fi
.PP

which is displayed as:

NAME
gdcmdump - .TH "gdcmdump" 1 "Tue Feb 1 2011" "Version 2.1.0" "GDCM"

NAME
gdcmdump - .SH "SYNOPSIS"

  gdcmdump [options] dcm_file
  gdcmdump [options] dcm_directory

On 2011-02-02 07:49:39 +0000, Mathieu Malaterre wrote:

Created attachment 179863
doxyfile

On 2011-02-02 07:50:01 +0000, Mathieu Malaterre wrote:

Created attachment 179864
doxygen documentation for the man page

On 2011-02-02 20:01:31 +0000, albert wrote:

In the discussion in the Doxygen-users group I already wrote that the difference was introduced between versions 1.6.3 and 1.7.3, a difference on the code shows that a lot has been changed in respect to start/end handling of parts and that some new parts were introduced. The function endTitleHead prints the double values, in index.cpp called from endTitle and in pagedef.cpp from write Documentation, with comment to write it only to Man pages !!. Maybe the later is now redundant ?

On 2011-02-06 11:14:10 +0000, Dimitri van Heesch wrote:

This is indeed no longer correct. Should be fixed in the next subversion update.

On 2011-03-28 14:19:14 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.4. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.