[cfe-commits] [PATCH] Documentation diagnostics: warn on duplicate commands

[Dmitri Gribenko]

Hello,

Doxygen manual claims that multiple \brief or \returns commands will
be merged together, but actual behavior is different (second \brief
command becomes a part of a discussion, second \returns becomes a
"Returns: blah" paragraph on its own).  Anyway, it seems to be a bad
idea to use multiple \brief or \returns commands in a single command.

Attached is a patch that implements this diagnostic.

Please review -- I want to know if we want this.

Dmitri

-- 
main(i,j){for(i=2;;i++){for(j=2;j<i;j++){if(!(i%j)){j=0;break;}}if
(j){printf("%d\n",i);}}} /*Dmitri Gribenko <gribozavr at gmail.com>*/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: warn-duplicate-command-v1.patch
Type: application/octet-stream
Size: 16608 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20120803/df6e462d/attachment.obj>