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
signature.asc
Description: This is a digitally signed message part.