I tend to use this syntax:

    @version $Revision$, $Date$

I don't use $Id$ because it's a bit long and verbose, but I don't mind if someone else uses it.

Git proponents will probably argue to remove this tag because it interferes with the checksumming.


Emmanuel Bourg



Le 05/04/2011 10:16, Simone Tripodi a écrit :
Hi all guys,
after the @author tag, I'm here to ask to clarify *to me* how @version
shall be used in Commons :)
I saw various usage across components:

- In [digester] we just use $Id$ on top of the license header;
- In [pool] we often used @version $Id$ in the class javadoc;
- In [discovery] we mixed usage of @version $Id$, @version $Revision$
and @version $Revision$ $Date$

Which one fits better for our components?
I'd say that @version $Id$ is the most complete, but let's reason
about it together :P

Since I'm taking care of [discovery], I'd like to fix once for all
these minor issues :)
Many thanks in advance, have a nice day!
Simo

http://people.apache.org/~simonetripodi/
http://www.99soft.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org

Reply via email to