commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: [ognl] SVN $ID and @author
Date Sat, 15 Oct 2011 12:07:24 GMT
For me author tags and IDs in javadoc are helpful when looking at the
code from a source zip.

Gary

On Oct 15, 2011, at 5:42, sebb <sebbaz@gmail.com> wrote:

> On 15 October 2011 10:26, Christian Grobmeier <grobmeier@gmail.com> wrote:
>>> Can be useful, if one comes across a source file in isolation from SVN.
>>
>> What exactly can this person then do with a revision number, my
>> committer name and the date i have last commited if he does not know
>> about svn revisions, who else does commit and when last commit was?
>>
>>> For example, in source archives.
>>
>> With what would I compare this number when I get it from a source archive?
>
> It can then readily be compared with current SVN to see what has
> changed; much easier than finding the SVN tag for the archive (which
> requires knowledge of ASF procedures).
>
>>> Also as comments in generated HTML files..
>>
>> If I want to compare if the generated HTML file like javdoc is
>> actually in sync with my sourcfile? Who really does this, when mvn
>> javadoc:javadoc is so easy?
>
> Not for comparison; it gives some idea when the file was last updated.
>
> Also, it's not just javadoc.
>
>>>> If we keep it, we need to move it on class level docs.
>>>
>>> Or at least below the AL header.
>>
>> please build and look at checkstyle-header.txt from target/ folder. To
>> my understanding it can't be inside the header it must be an extra
>> block. Guess, a third comment block would conflict with checkstyle too
>> (not tried)
>
> Placement is a separate issue.
>
>> Cheers
>> Christian
>>
>>
>>>
>>>> OK, let the rumble begin... your opinions gents!
>>>>
>>>> CHeers
>>>> Christian
>>>>
>>>> --
>>>> http://www.grobmeier.de
>>>>
>>>> ---------------------------------------------------------------------
>>>> 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
>>>
>>>
>>
>>
>>
>> --
>> http://www.grobmeier.de
>>
>> ---------------------------------------------------------------------
>> 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
>

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


Mime
View raw message