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


Subject: Re: commit - doxygen comments, new layout - please look
From: Mike Nordell (tamlin@algonet.se)
Date: Sat Jan 27 2001 - 14:56:59 CST


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.

My $0.02.

/Mike - please don't cc



This archive was generated by hypermail 2b25 : Sat Jan 27 2001 - 14:58:56 CST