https://bugs.llvm.org/show_bug.cgi?id=38905

            Bug ID: 38905
           Summary: -Wdocumentation generates error with @see @ref
           Product: clang
           Version: 3.9
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P
         Component: C++
          Assignee: unassignedclangb...@nondot.org
          Reporter: r...@r2air.com
                CC: dgre...@apple.com, llvm-bugs@lists.llvm.org

clang++ generates an error on a valid doxygen block that uses the @see tag.

Steps to reproduce:

$ cat docbug.cc 

/**
 * @see @ref FOO
 */
int function() {
  return 0;
}

$ clang++ -Werror -Wdocumentation -c docbug.cc -o docbug.o

Actual result:

docbug.cc:3:8: warning: empty paragraph passed to '@see' command
[-Wdocumentation]
 * @see @ref FOO

Expected result:

<no error>

Doxygen (tested versions 1.8.11 and 1.8.13) interpret this as valid markup.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
_______________________________________________
llvm-bugs mailing list
llvm-bugs@lists.llvm.org
http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-bugs

Reply via email to