[OpenAFS-devel] Doxygen

[Jeffrey Altman]

This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
--------------enig4579F69FF5F227786CCC2328
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

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.
>=20
> 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




--------------enig4579F69FF5F227786CCC2328
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (MingW32)

iQEcBAEBAgAGBQJQV1wIAAoJENxm1CNJffh4hegH/12YteeBGxSklM9rOujDlnjC
P/xfGv7sezWoypng8VaRZWFBB65SnIzpus1Z1ssUd+bZxoSjWIpJFDoW/GNWb0hQ
YF7vaDEdOz4BpBQIPLoyC09z84WA/wM0FrSYAPGgSvZ9QyNdBZ66CHOsvDaCTwFs
nvuKShExceLYkXF4L9KsK2jfF7zC1OAzSlRQtwUgsnqT6XrYK2pdHNXHjSpocgAu
+JEs7or2ssqLIBhptpQ2Ejg44kaZIYWaCTNG6pxLeDhzefWTlztH7jWqBPzbtrtW
QYVdJBS4DUEVazCJcBwwvwwIw39j7l4Cub+swF2DX2DHJn3nYgyPsst3HmARL5U=
=7ACj
-----END PGP SIGNATURE-----

--------------enig4579F69FF5F227786CCC2328--