Package: doxygen
Version: 1.7.1-1
Severity: minor
Doxygen gives this warning:
/home/edwin/pppp/x.c:4: warning: return type of member foo::a is not documented
But 'a' is a field of a struct, and it is documented. It is not a method, so it
doesn't have a return value...
Small testcase:
$ cat >x.c <<EOF
/** @file this file */
/** This is foo structure */
struct foo {
int a;/**< this is member a */
}
EOF
$ doxygen -g
Edit Doxyfile, and set WARN_NO_PARAMDOC to YES
$ doxygen
Searching for include files...
Searching for example files...
Searching for images...
Searching for dot files...
Searching for files to exclude
Searching for files to process...
Searching for files in directory /home/edwin/pppp
Reading and parsing tag files
Preprocessing /home/edwin/pppp/x.c...
Parsing file /home/edwin/pppp/x.c...
Building group list...
Building directory list...
Building namespace list...
Building file list...
/home/edwin/pppp/x.c:1: warning: the name `this' supplied as the second
argument in the \file statement is not an input file
Building class list...
Associating documentation with classes...
Computing nesting relations for classes...
Building example list...
Searching for enumerations...
Searching for documented typedefs...
Searching for members imported via using declarations...
Searching for included using directives...
Searching for documented variables...
Building member list...
Searching for friends...
Searching for documented defines...
Computing class inheritance relations...
Computing class usage relations...
Flushing cached template relations that have become invalid...
Creating members for template instances...
Computing class relations...
Add enum values to enums...
Searching for member function documentation...
Building page list...
Search for main page...
Computing page relations...
Determining the scope of groups...
Sorting lists...
Freeing entry tree
Determining which enums are documented
Computing member relations...
Building full member lists recursively...
Adding members to member groups.
Computing member references...
Inheriting documentation...
Generating disk names...
Adding source references...
Adding xrefitems...
Sorting member lists...
Counting data structures...
Resolving user defined references...
Finding anchors and sections in the documentation...
Combining using relations...
Adding members to index pages...
Generating style sheet...
Generating index page...
Generating page index...
Generating example documentation...
Generating file sources...
Generating file documentation...
Generating page documentation...
Generating group documentation...
Generating group index...
Generating class documentation...
Generating annotated compound index...
Generating alphabetical compound index...
Generating hierarchical class index...
Generating member index...
Generating docs for compound foo...
/home/edwin/pppp/x.c:4: warning: return type of member foo::a is not documented
Generating namespace index...
Generating namespace member index...
Generating graph info page...
Generating file index...
Generating example index...
Generating file member index...
finalizing index lists...
finished...
-- System Information:
Debian Release: squeeze/sid
APT prefers unstable
APT policy: (990, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.35.2-phenom (SMP w/6 CPU cores; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages doxygen depends on:
ii libc6 2.11.2-2 Embedded GNU C Library: Shared lib
ii libgcc1 1:4.5.1-1 GCC support library
ii libstdc++6 4.5.1-1 The GNU Standard C++ Library v3
Versions of packages doxygen recommends:
ii texlive-extra-utils 2009-9 TeX Live: TeX auxiliary programs
Versions of packages doxygen suggests:
ii doxygen-doc 1.7.1-1 Documentation for doxygen
ii doxygen-gui 1.7.1-1 GUI configuration tool for doxygen
ii graphviz 2.26.3-5 rich set of graph drawing tools
-- no debconf information
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
