8 Jan
2012
8 Jan
'12
8:36 p.m.
2012/1/6 Jon Cruz <jon@...18...>:
The point is the use of "@file" is required by Doxygen, but only for globals and file statics. If we do not use such items, then we don't have a requirement to use "@file" in the file.
Please read the documentation snippet I cited again. If you do not document the file, even with an empty comment, Doxygen will not extract anything out of it, unless you use the option EXTRACT_ALL. We currently use this option, but we shouldn't.
Also, class-focus does not mean that files should be undocumented. There will be files regardless of your focus. A file is not a global variable.
Regards, Krzysztof