Re: Doxygening Mach and Hurd

2007-07-15 Thread Michael Casadevall
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I don't believe the documentation should even list all the functions though. For instance, say you were working on the entropy driver, which doesn't have a public API; the only source of documentation would be the comments left behind. Its bette

Re: Yet another updated entropy patch

2007-07-15 Thread Marcus Brinkmann
At Fri, 13 Jul 2007 22:50:00 -0400, Michael Casadevall <[EMAIL PROTECTED]> wrote: > > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > (this is a response to both emails about said patch) > > Marcus: I don't think I've ever been nitpicked that badly in my > life. Congratulations! I guess

Re: Doxygening Mach and Hurd

2007-07-15 Thread Constantine Kousoulos
GNU Mach would greatly benefit from doxygen if we used it (quoting the official site) "to extract the code structure from undocumented source files. This is very useful to quickly find your way in large source distributions. You can also visualize the relations between the various elements by mean