On Sat, Jun 8, 2013 at 12:42 PM, Tyler Romeo <tylerro...@gmail.com> wrote:

> Doxygen will automatically realize that a file comment is a file comment.
>

You'd think so, but this appears to not be the case:

<ori-l> http://noc.wikimedia.org/~olivneh/doxygen_testcases.tar.gz has four
php files
<ori-l> i'm guessing 1, 2 & 3 produce identical output, no idea about 4
<ori-l> (the hypothesis is that a comment block doesn't need '@file' if
it's freestanding and at the top of the file it's describing)
<TimStarling> only case 1 and 3 are in the file list, case 2 and 4 are
missing
<TimStarling> this is with default configuration with doxygen 1.7.6.1
_______________________________________________
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Reply via email to