Re: Doxygening Mach and Hurd

2007-07-16 Thread Carl Fredrik Hammar
Michael Casadevall <[EMAIL PROTECTED]> writes: > 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. It

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: 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

Re: Doxygening Mach and Hurd

2007-07-14 Thread Carl Fredrik Hammar
Hello! Michael Casadevall <[EMAIL PROTECTED]> writes: > 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

Re: Doxygening Mach and Hurd

2007-07-14 Thread Marcus Brinkmann
At Fri, 13 Jul 2007 16:18:36 -0400 (EDT), Michael Casadevall <[EMAIL PROTECTED]> wrote: > 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. In my experience, in-source markup

Re: Doxygening Mach and Hurd

2007-07-13 Thread Michael Casadevall
ECTED]> wrote: -- Forwarded message -- Date: Fri, 13 Jul 2007 16:07:23 -0400 (EDT) From: Michael Casadevall <[EMAIL PROTECTED]> To: [EMAIL PROTECTED] Subject: Doxygening Mach and Hurd During my time correcting the entropy patch to meet the requirements to be accepted, I noticved the c

Re: Doxygening Mach and Hurd

2007-07-13 Thread Sam Douglas
devall <[EMAIL PROTECTED]> To: [EMAIL PROTECTED] 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, it

Doxygening Mach and Hurd

2007-07-13 Thread Michael Casadevall
-- Forwarded message -- Date: Fri, 13 Jul 2007 16:07:23 -0400 (EDT) From: Michael Casadevall <[EMAIL PROTECTED]> To: [EMAIL PROTECTED] Subject: Doxygening Mach and Hurd During my time correcting the entropy patch to meet the requirements to be accepted, I noticved the