On Thu, Oct 9, 2008 at 9:18 AM, Filip Hanik - Dev Lists <[EMAIL PROTECTED]>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 >> <[EMAIL PROTECTED]>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: [EMAIL PROTECTED] >>> For additional commands, e-mail: [EMAIL PROTECTED] >>> >>> >>> >>> >> >> >> > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > >
