[Doxygen-develop] Comment beginning with "// Author" suppresses doc generation

[dougkramer <dou...@gm...>]

[cross-posted to doxygen-users]

Has anyone else seen this?  Should I submit a bug? 

PROBLEM: 
When I run doxygen on Objective-C source code with the following code block,
no documentation is generated for that method -- no signature, parameters or
doc comment. 

CAUSE: 
I tracked the problem down to this: 
A comment line that starts with the string "// Author" prevents entire
documentation for that method from being generated 

SOLUTION: 
Add a word before "Author", such as "// The authorization has finished" 

------------------------------------------------------------- 
// A protocol implemented by the client. 
@protocol MyClassDelegate 

// Authorization is finished 
- (void)finishedWithAuth:(OAuth2Authentication *)auth; 

@end 
-------------------------------------------------------------- 

$ doxygen --version 
1.7.6.1 



--
View this message in context: http://doxygen.10944.n7.nabble.com/Comment-beginning-with-Author-suppresses-doc-generation-tp5669.html
Sent from the Doxygen - Development mailing list archive at Nabble.com.