tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mark Thomas <>
Subject Re: [PROPOSAL] Remove SVN keywords from JavaDoc
Date Tue, 07 Jul 2009 09:10:25 GMT
Konstantin Kolinko wrote:
> As was written early in this my thread:
> (
> there are problems with Subversion $Date$ keyword:
> 1. It uses localized names for the month and the day of the week
> 2. It writes those localized strings using UTF-8, while our sources
> are ISO-8859-1
> 3. The time that is printed is in local timezone
> There are two possible solutions (besides ignoring the issue):
> a) Use $Id:$ keyword instead
> b) Remove the keyword
> For the java sources, I propose the simpler one of the above:
> I propose to remove *all* SVN keywords from our *.java sources, where they are
> used in JavaDoc comments.
> That includes the following four keywords: Author Date Id Revision
> As it is a documentation change, I won't propose a patch, but go C-T-R.
> What are your opinions?
> If there are any objections to such a change, please write so.

I'm happy getting rid of all of them. The only times I have used them
there have been equally quick, equally effective ways of finding out the
information I was after (usually Tomcat version).


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message