[LLVMbugs] [Bug 19068] New: -Wdocumentation-unknown-command requires -Wdocumentation

bugzilla-daemon at llvm.org bugzilla-daemon at llvm.org
Thu Mar 6 08:37:44 PST 2014


            Bug ID: 19068
           Summary: -Wdocumentation-unknown-command requires
           Product: clang
           Version: trunk
          Hardware: PC
                OS: All
            Status: NEW
          Keywords: quality-of-implementation
          Severity: normal
          Priority: P
         Component: C++
          Assignee: unassignedclangbugs at nondot.org
          Reporter: jonathan.sauer at gmx.de
                CC: dgregor at apple.com, llvmbugs at cs.uiuc.edu
    Classification: Unclassified

Take the following program where an unknown Doxygen command is used:

 * \unknown unknowns
int main() {}

Compiling with clang r201876 and only -Wdocumentation-unknown-command results
in no warning at all. It is necessary to compile with both
-Wdocumentation-unknown-command -Wdocumentation to get the expected warning:

% ~/LLVM/build/Release+Asserts/bin/clang++ -Wdocumentation-unknown-command
-Wdocumentation clang.cpp
clang.cpp:2:4: warning: unknown command tag name
 * \unknown     Unknown.
1 warning generated.

While it can be expected that users who use -Wdocumentation-unknown-command
will also use -Wdocumentation, this behavior is still surprising.

You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20140306/5150c5b0/attachment.html>

More information about the llvm-bugs mailing list