Re: commit - doxygen comments, new layout - please look


Subject: Re: commit - doxygen comments, new layout - please look
From: Sam TH (sam@uchicago.edu)
Date: Sat Jan 27 2001 - 15:09:05 CST


On Sat, Jan 27, 2001 at 09:56:59PM +0100, Mike Nordell wrote:
> If the discussion is still open I'd like to add some comments (no pun
> intended).
>
> I think having all the comments in header files is bad, for numerous
> reasons. LORD (Locality Of Reference Documentation) says this won't get
> updated to reflect the function, greater compile times (since headers
> usually gets included by many other files - both src and headers) and it
> IMHO pollutes the "browseability" of a class declaration. Just to name a few
> reasons to not put this in the header files.

Well, since people feel strongly about this, I have taken my objection
off the table, and I think John did too. So this issue should be
considered settled, and comments go in .cpp files. Ok?
           
        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 : Sat Jan 27 2001 - 15:09:51 CST