Darren J Moffat wrote: > Peter Memishian wrote: [snip] > > > Just say 'no' to "$Log$." It looks attractive, but it's a crime for > > > anything other than toy projects. > > > > Emphatically agreed. > > Me too. For me this is equivalent to graffiti (or tagging as I believe > it is called today by law enforcement people, or "street art" by those > that attempt to justify it). > > I'm all for comments in code to say why things are they way they are but > the "who did what when and why" belongs in the SCM system not in the > source code.
I was not thinking about a detailed log or some "grafitti" - I was thinking about a short documentation about the major "turning points" and design decisions in the code (which should IMO part of any good code to have all these bits documented in the source). And somewhere on my wishlist are the emails of the authors to have a contact person who could be asked about some design decisions (the SCM history lacks all these details and even the bug numbers are more or less useless right now since most of the bug database comments are not readable for OpenSolaris users). ---- Bye, Roland -- __ . . __ (o.\ \/ /.o) [EMAIL PROTECTED] \__\/\/__/ MPEG specialist, C&&JAVA&&Sun&&Unix programmer /O /==\ O\ TEL +49 641 7950090 (;O/ \/ \O;) _______________________________________________ opensolaris-code mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/opensolaris-code
