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.