[En-Nut-Discussion] Changelog for releases

[Harald Kipp]

Hi Ole,

I know, that you are busy and I do not expect a soon reply.

On 30.07.2012 16:14, Ole Reinhardt wrote:
> Sorry, as always, I missed to do the checkin :) _Now_ you'll find it in
> trunk/NEWS

Actually I expected something, which gives a brief overview about new features and important changes. So I created

http://ethernut.svn.sourceforge.net/viewvc/ethernut/trunk/NEWS?revision=4307

Now we have from

http://ethernut.svn.sourceforge.net/viewvc/ethernut/trunk/NEWS?revision=4396

===== SNIP ======

- r4192: ksk_lpc1788_sk SDRAM: Fixed I/O pin configuration of SDRAM lines

- r4193: CM3 LPC177x_8x EMC: correctly and automatically calculate bit shifting
of sdram mode register adresses for different sdram sizes and memory
mapping modes

- r4196: CM3 LPC177x_8x GPIO: Fixed GPIO pin config / port config
Port P0-7 .. P0-9 pins (W-Mode pins) are a little bit special and need
bit 7 always be set for normal operation
Fixed bug in mask handling of GPIO Port Config
 	
- r4197: AT91 TWI: Fix RTC hangup on AT91SAM9XE CPU.

===== SNAP ======
 	
Calling "svn log -r4192:4197" would give

===== SNIP ======

------------------------------------------------------------------------
r4192 | olereinhardt | 2012-06-01 16:40:14 +0200 (Fr, 01 Jun 2012) | 2 lines

Fixed I/O pin configuration of SDRAM lines

------------------------------------------------------------------------
r4193 | olereinhardt | 2012-06-01 16:41:19 +0200 (Fr, 01 Jun 2012) | 3 lines

correctly and automatically calculate bit shifting of sdram mode register
adresses for different sdram sizes and memory mapping modes

------------------------------------------------------------------------
r4194 | u_bonnes | 2012-06-05 21:10:33 +0200 (Di, 05 Jun 2012) | 2 lines

Remove stm32 timer file superceeded by dev/hwtimer_stm32.h

------------------------------------------------------------------------
r4195 | haraldkipp | 2012-06-06 11:44:07 +0200 (Mi, 06 Jun 2012) | 2 lines

Move hardware specific nutpiper application from directory app to hwtest.

------------------------------------------------------------------------
r4196 | olereinhardt | 2012-06-06 16:39:55 +0200 (Mi, 06 Jun 2012) | 7 lines

Fixed GPIO pin config / port config

Port P0-7 .. P0-9 pins (W-Mode pins) are a little bit special and need
bit 7 always be set for normal operation

Fixed bug in mask handling of GPIO Port Config

------------------------------------------------------------------------
r4197 | haraldkipp | 2012-06-07 14:17:35 +0200 (Do, 07 Jun 2012) | 2 lines

Fix RTC hangup on AT91SAM9XE CPU.

------------------------------------------------------------------------

===== SNAP ======

This is almost the same, isn't it?

Let's go into details: The typical user will move from 4.10 to 5.0, but 4.10 is not mentioned in NEWS. Instead the user will be informed, that

- r4197: AT91 TWI: Fix RTC hangup on AT91SAM9XE CPU.

But it had been fixed in 4.10 at r4234. Isn't that more confusing than helpful? At least I cannot see the difference to svn log.

Don't get me wrong. I see the problem for users, who want to have a quick overview. I just do not see much benefit in copying the log into an extra file, may be fixing a few typos and sorting them into the 3 categories.

May be I haven't fully understood, what you expect from NEWS.

Regards,

Harald