Hi,

Discussing coding style is sooo much easier than
actually coding...

3 spaces (and no TABs!!!) is fine with me.


As for the revision history within the source file:

Using the CVS $Log$ tag is not a good idea: It was
shortly discussed about half a year ago, and the
idea was abandoned. Often we would get _very_ long
revision histories, with lots of "blanket" comments.

However, a revision history like the one you suggest
might be a good idea, as long as it only contains
substantial changes or bug fixes that apply to the
source file.

But I don't think is is a good idea to place it in
a javadoc comment: There is no need for a revision
history in the javadocs. And to avoid that the revision
history looks ugly in the generated docs, html must
be added that makes the revision history look ugly
in the source.

Maybe it would be better the have the revison history
in the preample, like:
/*
 * JBoss, the OpenSource EJB server
 *
 * Distributable under LGPL license.
 * See terms of license at gnu.org.
 *
 * Revisions:
 *
 * 20000619 sparre: New place for revision history.
 */


Best Regards,

Ole Husgaard


marc fleury wrote:
> 
> |Ok, but 2 spaces do not read well on a 1600x1200 21" screen with a
> |12pt font. 3 spaces is the minimum readable size for this configuration.
> 
> ok 3 then, :)
> 
> marcf
> 
> _______________________________________________
> Jboss-development mailing list
> [EMAIL PROTECTED]
> http://lists.sourceforge.net/lists/listinfo/jboss-development

_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to