[LLVMbugs] [Bug 16092] New: False positive warning from -Wdocumentation-unknown-command

[bugzilla-daemon at llvm.org]

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

            Bug ID: 16092
           Summary: False positive warning from
                    -Wdocumentation-unknown-command
           Product: new-bugs
           Version: trunk
          Hardware: Macintosh
                OS: MacOS X
            Status: NEW
          Severity: normal
          Priority: P
         Component: new bugs
          Assignee: unassignedbugs at nondot.org
          Reporter: sean at rogue-research.com
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified

clang's -Wdocumentation-unknown-command is giving what seems to be a false
positive warning.

Consider the example from the doxygen website itself:

http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdrelates

---------------------
/*! 
 * A String class.
 */ 

class String
{
  friend int strcmp(const String &,const String &);
};

/*! 
 * Compares two strings.
 */

int strcmp(const String &s1,const String &s2)
{
}

/*! \relates String
 * A string debug function.
 */
void stringDebug()
{
}
---------------------


then:

$ clang -Weverything -fsyntax-only ~/Desktop/test.cxx

/Users/sean/Desktop/test.cxx:19:5: warning: unknown command tag name
[-Wdocumentation-unknown-command]
/*! \relates String
    ^

Strangely, no warnings are generated if I use "-Wdocumentation-unknown-command"
or "-Wdocumentation" in place of -Weverything...

This is all with:

clang version 3.4 (182384)
Target: x86_64-apple-darwin12.4.0
Thread model: posix

ie trunk from just now.

-- 
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/20130521/f65518b0/attachment.html>