On 9/16/2012 9:20 PM, Jason Edgecombe wrote: > I have a basic doxygen config. I've moved some of the specifications to > their own module. > > I've pushed three patches to gerrit: > http://gerrit.openafs.org/8128 > http://gerrit.openafs.org/8129 > http://gerrit.openafs.org/8130
Thanks for taking the time to get this far. There is much more than will need to be done before Doxygen generated documentation is useful. There is very little meaningful organization in the output. http://docs.openafs.org/doxygen-test/index.html I believe that we need to organize the data into libraries, executables, and other modules. Very few of the existing source directories contain Doxygen comments. Some like the Network Identity Manager Provider are fully documented. Others are partial. But most have nothing. I think we should start by filtering only directories for which there known is valid Doxygen commenting. Jeffrey Altman
signature.asc
Description: OpenPGP digital signature
