Le jeudi 12 septembre 2013 16:22:52 Matteo Cypriani a écrit :
> Hi,
> 
> Le vendredi 10 juin 2011 14:09:06 Mattias Ellert a écrit :
> > Package: doxygen
> > Version: 1.7.4-2
> > Severity: normal
> > 
> > The brief description is misplaced in he man page output using version
> > 1.7.4.
> 
> It works for me in version 1.8.4-1 (sid), so I think this bug should be
> closed. Wheezy's version 1.8.1.2-2 is still affected though.

Hmm, actually I am wrong. It only partially works in 1.8.4-1. It was quite 
“fun” to figure out this: in a multi-file project it works only for the 
*first* man page generated (which is not necessarily the same as the order in 
which the input files are specified).


In my previous message I tested with a simple header file containing only the 
following:

/**
 * @file testname.h
 * @brief Test Doxygen NAME generation
 */


And with a small Doxyfile containing:

DOXYFILE_ENCODING      = UTF-8
PROJECT_NAME           = "Test Project"
PROJECT_BRIEF          = "Brief description of Test Project"
REPEAT_BRIEF           = NO
FULL_PATH_NAMES        = NO
MULTILINE_CPP_IS_BRIEF = YES
OPTIMIZE_OUTPUT_FOR_C  = YES
INLINE_SIMPLE_STRUCTS  = YES
EXTRACT_LOCAL_CLASSES  = NO
HIDE_UNDOC_MEMBERS     = YES
HIDE_UNDOC_CLASSES     = YES
SHOW_INCLUDE_FILES     = NO
QUIET                  = NO
INPUT                  = $(DOXYGEN_INPUT)
GENERATE_HTML          = NO
GENERATE_LATEX         = NO
GENERATE_MAN           = YES


I run doxygen with the following command:

DOXYGEN_INPUT=testname.h doxygen Doxyfile


Then man -l man/man3/testname.h.3 shows a correct result. But let's add 
another file:

/**
 * @file testname2.h
 * @brief Test Doxygen NAME generation, second file
 */


And run doxygen with:

DOXYGEN_INPUT='testname.h testname2.h' doxygen Doxyfile


The generated testname.h.3 is the same, but testname2.h.3 has the bug. Of 
course if you rename testname.h to tesname3.h (and change the @file directive 
in it), testname2.h.3 will be correct and testname3.h.3 will be wrong.

Hope this helps,

  Matteo

Attachment: signature.asc
Description: This is a digitally signed message part.

Reply via email to