tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Costin Manolache" <cos...@gmail.com>
Subject Re: tomcat trunk - changelog
Date Thu, 09 Oct 2008 17:11:58 GMT
On Thu, Oct 9, 2008 at 9:18 AM, Filip Hanik - Dev Lists
<devlists@hanik.com>wrote:

> Costin Manolache wrote:
>
>> I never understood the use of the manual changelog - as opposed to svn log
>> and good  commit messages.
>> Could we just use that ?
>>
> that would be nice if we then could generate the 'changelog' to ship with
> the release.
> for an admin that is about to upgrade, it's much nicer to have the
> changelog to see what bugs got fixed, what changes were implemented, then
> have to scan the SVN repository.
> the changelog. the changelog is widely used by admins during upgrade
> scenarios


Just include the bug number and links in the commit message. Whatever you
put in the CHANGES you can put in the commit log as well.
I don't know if SVN supports templates - most likely it does.

The formatting seems ok - it's not very different from the manual file - and
shouldn't be very hard to write a script to change the
layout.

I've seen projects that generate the 'changelog' using automated tools,
based on the source control system. The extra benefit
is that better commit messages would make it easier to understand the
changes when browsing the svn.

Example:

 jsvn log  -l 5
------------------------------------------------------------------------
r699128 | markt | 2008-09-25 16:20:48 -0700 (Thu, 25 Sep 2008) | 1 line

Partial fix for 45878. If we are happy with this approach for the spec JARs,
extend it to the remaining Tomcat JARs.
------------------------------------------------------------------------
r699126 | markt | 2008-09-25 16:00:57 -0700 (Thu, 25 Sep 2008) | 1 line

Update default year
------------------------------------------------------------------------
r698925 | markt | 2008-09-25 04:07:44 -0700 (Thu, 25 Sep 2008) | 1 line

Add NOTICE file to uninstall section.
------------------------------------------------------------------------
r698892 | jfclere | 2008-09-25 02:29:23 -0700 (Thu, 25 Sep 2008) | 2 lines

Use lastest tc-native version.

------------------------------------------------------------------------
r698629 | markt | 2008-09-24 09:21:25 -0700 (Wed, 24 Sep 2008) | 2 lines

Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=45879
Move the NOTICE file to the install dir
------------------------------------------------------------------------


Costin



>
> best
> Filip
>
>  Costin
>>
>> On Wed, Oct 8, 2008 at 4:24 PM, Filip Hanik - Dev Lists
>> <devlists@hanik.com>wrote:
>>
>>
>>
>>> I'd like for us to start using the changelog for trunk, we're losing a
>>> lot
>>> of changes being documented, not everything gets ported to 6.0 etc
>>> do you guys have any thoughts on this?
>>>
>>> Filip
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
>>> For additional commands, e-mail: dev-help@tomcat.apache.org
>>>
>>>
>>>
>>>
>>
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
> For additional commands, e-mail: dev-help@tomcat.apache.org
>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message