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

[bugzilla-daemon at llvm.org]

http://llvm.org/bugs/show_bug.cgi?id=19068

            Bug ID: 19068
           Summary: -Wdocumentation-unknown-command requires
                    -Wdocumentation
           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
[-Wdocumentation-unknown-command]
 * \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>