I would personally prefer to see the @version tag remain holding this info. Its where it is in most other projects, its near the top of the file and fairly non-intrusive. If you don't want it in the javadoc simply exclude it - in ant version="false" on javadoc task.
Stephen ----- Original Message ----- From: "Simon Kitching" <[EMAIL PROTECTED]> > Ok, here's a solution I hope will satisfy everyone. Can people please > give their opinion on this? > > There seemed to be general agreement that having this info as @version > in the javadoc is not useful, but having it somewhere in the text for > developers to refer to is. > > So I propose that the following is added as the *last* line of every > digester .java file: > > // version: $Id$ > > This makes it really easy to find, without being intrusive for people > studying the code. And "tail -n 1 *.java" will dump the version info for > every file in the local dir, which seems useful. [and it will be really > easy to automate the process to add the version info :-]. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
