bug-hurd
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Doxygening Mach and Hurd


From: Michael Casadevall
Subject: Doxygening Mach and Hurd
Date: Fri, 13 Jul 2007 16:18:36 -0400 (EDT)



---------- Forwarded message ----------
Date: Fri, 13 Jul 2007 16:07:23 -0400 (EDT)
From: Michael Casadevall <mcasadevall@gmail.com>
To: bugs-hurd@gnu.org
Subject: Doxygening Mach and Hurd

During my time correcting the entropy patch to meet the requirements to be accepted, I noticved the coding style would make it extremely easy to doxyify the codebase.

For those of you unfamilar with Doxygen, its similar
to Javadoc and other solutions that use markup in the code
base to generate documentation. I believe one of the bigger
problems with mach, and especially getting new developers is
that mach itself is fairly undocumented, especially its internals
(the only real documentation of IPC I know if is Thomas' guide).
I think it would be in the projects best interests if we start
doxyifing the codebase (which is fairly easy to do; I learned
how to use use doxygen in about five minutes the first time
I ever used it).

Any thoughts and comments on doxygening the codebase?
Michael




reply via email to

[Prev in Thread] Current Thread [Next in Thread]