On 5 April 2011 22:39, Konstantin Kolinko <knst.kolinko@gmail.com> wrote:
> 2011/4/6 Emmanuel Bourg <ebourg@apache.org>:
>> Le 05/04/2011 22:43, sebb a écrit :
>>
>>> Please don't use $Date$, because it makes checking releases much harder.
>>
>> Could you elaborate on this sebb ? I saw your other message regarding the
>> timezone but I don't really understand the issue it creates when you are
>> checking a release.
>
> Regarding my experience in the Apache Tomcat project,
> there are several issues with $Date$. Timezone is one of them.
>
> [1] http://marc.info/?l=tomcat-dev&m=124692524324646&w=2
>
> In Apache Tomcat the discussion ended with me replacing all $Date$
> with $Id$, because I felt that there was no consensus in removing this
> info.
>
> My experience in the 1.5+ years since that change is the following:
>
> 1) I do not remember seeing anyone using $$ keywords in the new java
> files. While we sometimes forget to set svn:eol-style property for the
> new files, the svn:keywords is not in the default autoprops
> configuration and thus will have to be set explicitly.
>
> 2) There were several occasions when a line with $Id$ tag was broken
> by autoformatting.
>
> If the file name is long, the "@version $Id $" line can be more that
> 80 characters and formatting the source code wrapped the second $ to
> the next line, breaking the keyword.
Broken autoformatter ...
> 3) During this time there was no occasion when this $Id$ information
> in the source files were useful for me. Essentially it says how old
> is this file, but files do change often and a change set usually
> spawns several files.
I agree, if you have access to a file in SVN then the $Id$ or
$Revision$ generally serves little purpose, because SVN can provide
the information, but it can be invaluable in tracing where a file has
originated when the file is not in SVN.
> I think $Id$ tags are useful in textual documents like README, because
> it is good to review those from time to time and update stale
> information.
And again here, if the file is unpacked in a source tree which is not
part of SVN, the $Id$ can be very useful in determining the source of
the file.
> Best regards,
> Konstantin Kolinko
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
|