Subject: Re: commit - doxygen comments, new layout - please look
From: Sam TH (sam@uchicago.edu)
Date: Fri Jan 26 2001 - 17:12:56 CST
On Sat, Jan 27, 2001 at 12:03:38AM +0100, Jesper Skov wrote:
> >>>>> "Martin" == Martin Sevior <msevior@mccubbin.ph.unimelb.edu.au> writes:
>
> >> - to get an overview of what that module does - as a quick API
> >> reference - to change them ;-)
>
> Martin> This is absolutely how I use the headers too.
>
> Me too, as I pointed out. I just bent to the wills of John and Sam :)
Well, that's where I would want the comments too - as part of the API
reference. Maybe we are thinking of different kinds of comments. I
have been thinking of these as comments that users of the function
would want. Are other people thinking of them as comments about the
implementation of the functions?
>
> So unless more people weigh in on their side of the argument, I guess
> I should be reversing the change... John/Sam - what do you think of
> Paul's arguments?
One question: why can't I see any of the comments in
http://www.abisource.com/doxygen/class_fp_Column.html
?
sam th
sam@uchicago.edu
http://www.abisource.com/~sam/
GnuPG Key:
http://www.abisource.com/~sam/key
This archive was generated by hypermail 2b25 : Fri Jan 26 2001 - 17:13:50 CST