[flame] NEWS file is useless

2009-11-25 Thread Wolfgang Sourdeau
Hi everyone, This morning, I have inadvertently updated gnustep-base on my Debian machine, which remained at version 1.19 since april this year To my surprise, I have found at least two unannounced changes: - the property list format is now serialized directly in XML, which is somehow use

Re: [flame] NEWS file is useless

2009-11-25 Thread Riccardo Mottola
Hi, This morning, I have inadvertently updated gnustep-base on my Debian machine, which remained at version 1.19 since april this year To my surprise, I have found at least two unannounced changes: - the property list format is now serialized directly in XML, which is somehow useful

Re: [flame] NEWS file is useless

2009-11-25 Thread Richard Frith-Macdonald
On 25 Nov 2009, at 20:21, Wolfgang Sourdeau wrote: > Hi everyone, > > > This morning, I have inadvertently updated gnustep-base on my Debian machine, > which remained at version 1.19 since april this year > To my surprise, I have found at least two unannounced changes: > - the property lis

Re: [flame] NEWS file is useless

2009-11-25 Thread Richard Frith-Macdonald
On 25 Nov 2009, at 22:39, Richard Frith-Macdonald wrote: > > On 25 Nov 2009, at 20:21, Wolfgang Sourdeau wrote: > >> Hi everyone, >> >> >> This morning, I have inadvertently updated gnustep-base on my Debian >> machine, which remained at version 1.19 since april this year >> To my surpri

Re: [flame] NEWS file is useless

2009-11-25 Thread Riccardo Mottola
Hi, Hi everyone, This morning, I have inadvertently updated gnustep-base on my Debian machine, which remained at version 1.19 since april this year To my surprise, I have found at least two unannounced changes: - the property list format is now serialized directly in XML, which is someh

Re: [flame] NEWS file is useless

2009-11-25 Thread David Chisnall
On 25 Nov 2009, at 22:39, Richard Frith-Macdonald wrote: There are actually three levels of change information ... NEWS ... just the headlines ReleaseNotes ... some more detail ChangeLog ... everything Maybe you are right and we shouldn't bother with NEWS? I'd be interested to know what oth

Re: [flame] NEWS file is useless

2009-11-25 Thread Nicola Pero
I'd be in favour of ditching NEWS and ChangeLog. ChangeLog has less information, in a less useful format, than the svn logs and is a hold-over from CVS not storing repository-wide change information sensibly. With svn log, you can get a log of change messages at any granularity that you li

Re: [flame] NEWS file is useless

2009-11-25 Thread David Chisnall
On 26 Nov 2009, at 00:50, Nicola Pero wrote: I'd be in favour of ditching NEWS and ChangeLog. ChangeLog has less information, in a less useful format, than the svn logs and is a hold-over from CVS not storing repository-wide change information sensibly. With svn log, you can get a log of

Re: [flame] NEWS file is useless

2009-11-25 Thread hansfbaier
I still haven't seen a convincing argument for it.  Any of the information that people write in the ChangeLog file they could also write in the commit log.  It is impossible to make a commit without writing a log message, it is easy to make a commit without editing the ChangeLog (you could add

Re: [flame] NEWS file is useless

2009-11-25 Thread Richard Frith-Macdonald
On 25 Nov 2009, at 23:23, Riccardo Mottola wrote: > Hi, >> >>> Hi everyone, >>> >>> >>> This morning, I have inadvertently updated gnustep-base on my Debian >>> machine, which remained at version 1.19 since april this year >>> To my surprise, I have found at least two unannounced changes

Re: [flame] NEWS file is useless

2009-11-26 Thread Richard Frith-Macdonald
On 26 Nov 2009, at 01:10, David Chisnall wrote: > On 26 Nov 2009, at 00:50, Nicola Pero wrote: > >>> I'd be in favour of ditching NEWS and ChangeLog. >>> >>> ChangeLog has less information, in a less useful format, than the svn logs >>> and is a hold-over from CVS not storing repository-wide c

Re: [flame] NEWS file is useless

2009-11-26 Thread Nicola Pero
ChangeLog has less information, in a less useful format, than the svn logs and is a hold-over from CVS not storing repository-wide change information sensibly. With svn log, you can get a log of change messages at any granularity that you like. I agree there is an overlap, but there are

Re: [flame] NEWS file is useless

2009-11-26 Thread Nicola Pero
It would be good to consider exactly how much (if any) information we want to present in NEWS/ReleaseNotes ... my preference would be for minimal information there, and a pointer to a generated ChangeLog for details. This would require a policy that svn log entries should be suitable f

Re: [flame] NEWS file is useless

2009-11-26 Thread Nicola Pero
So I guess the solution to that would be instead to require ChangeLog entries to be committed to svn log. By the way, presumably we'd still include the author of the change in the subversion commit message ? Ie, we write a full ChangeLog entry including the author at the beginning ? The r

Re: [flame] NEWS file is useless

2009-11-26 Thread Richard Frith-Macdonald
On 26 Nov 2009, at 11:03, Nicola Pero wrote: > >> It would be good to consider exactly how much (if any) information we want >> to present in NEWS/ReleaseNotes ... my preference would be for minimal >> information there, and a pointer to a generated ChangeLog for details. >> This would requir

Re: [flame] NEWS file is useless

2009-11-26 Thread Richard Frith-Macdonald
On 26 Nov 2009, at 11:08, Nicola Pero wrote: >> So I guess the solution to that would be instead to require ChangeLog >> entries to be committed to svn log. > > By the way, presumably we'd still include the author of the change in the > subversion commit message ? > Ie, we write a full ChangeL

Re: [flame] NEWS file is useless

2009-11-26 Thread David Chisnall
On 26 Nov 2009, at 11:08, Nicola Pero wrote: By the way, presumably we'd still include the author of the change in the subversion commit message ? Ie, we write a full ChangeLog entry including the author at the beginning ? Yes. If you look in the LLVM svn log, for example, you will see a f

Re: [flame] NEWS file is useless

2009-11-26 Thread Gregory Casamento
It's not a strict requirement. On Wednesday, November 25, 2009, wrote: > > > > I still haven't seen a convincing argument for it.  Any of the information > that people write in the ChangeLog file they could also write in the commit > log.  It is impossible to make a commit without writing a log

Re: [flame] NEWS file is useless

2009-11-26 Thread Derek Fawcus
On Thu, Nov 26, 2009, Nicola Pero wrote: > I also occasionally work on gnustep-make offline, and the subversion > logs are not available offline, while ChangeLogs are. Dare I say it, but the obvious answer to that is a DVCS, of which hg and git spring to mind. On Thu, Nov 26, 2009 at 11:08:01AM

Re: [flame] NEWS file is useless

2009-11-26 Thread Riccardo Mottola
David Chisnall wrote: On 25 Nov 2009, at 22:39, Richard Frith-Macdonald wrote: There are actually three levels of change information ... NEWS ... just the headlines ReleaseNotes ... some more detail ChangeLog ... everything Maybe you are right and we shouldn't bother with NEWS? I'd be inter

Re: [flame] NEWS file is useless

2009-11-26 Thread Riccardo Mottola
Hi, I agree with Nicola here ... it's very, very far from being a waste of space ... people do need to be able to see the changes made to the code. So your suggestion of having a script make a ChangeLog automatically from the svn logs makes a *lot* of sense. WasteOfSpace? I think that is

Re: [flame] NEWS file is useless

2009-11-26 Thread Nicolas Roard
On Thu, Nov 26, 2009 at 10:15 PM, Riccardo Mottola wrote: > David Chisnall wrote: >> >> On 25 Nov 2009, at 22:39, Richard Frith-Macdonald wrote: >> >>> There are actually three levels of change information ... >>> NEWS  ... just the headlines >>> ReleaseNotes ... some more detail >>> ChangeLog ...

Re: [flame] NEWS file is useless

2009-11-26 Thread Riccardo Mottola
Hi, By the way, presumably we'd still include the author of the change in the subversion commit message ? Ie, we write a full ChangeLog entry including the author at the beginning ? The reason is that when we receive patches, the committer is often *not* the author of the patch, only the revi

Re: [flame] NEWS file is useless

2009-11-26 Thread David Chisnall
On 26 Nov 2009, at 22:15, Riccardo Mottola wrote: Not only in a ChangeLog I can write more than in a commit and I can group files and comment on sigle pieces of them, but it is an easy file I can check. Are you using a different svn to me? When I do a commit, it pops up $EDITOR (vim in

Re: [flame] NEWS file is useless

2009-11-27 Thread Nicola Pero
Also, A ChangeLog is easy to search. When something breaks I grep in the changelog. Old habits. Why is: cat ChangeLog | grep easier than: svn log | grep Because using a ChangeLog doesn't require internet access, and it is *much* faster. :-) And for people who get a source tarball, they

Re: [flame] NEWS file is useless

2009-12-05 Thread Fred Kiefer
I know that I am rather late to jump into this discussion, but I was away for a few weeks and only read through it now. I strongly agree with Nicola's points here. I don't just write but also read the ChangeLog a lot. Before every substantial change I try to find the ChangeLog entry for the origin

XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Wolfgang Lux
Richard Frith-Macdonald wrote: I think directly ~/GNUstep/Defaults/.GNUstepDefaults ? That's XML for me now and it wasn't. Oh, that's a hidden file for private use by the base library ... kind of surprising that anyone would notice, and certainly not something which should appear in news/r

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Richard Frith-Macdonald
On 26 Nov 2009, at 17:35, Wolfgang Lux wrote: > Richard Frith-Macdonald wrote: > >>> I think directly ~/GNUstep/Defaults/.GNUstepDefaults ? >>> That's XML for me now and it wasn't. >> >> Oh, that's a hidden file for private use by the base library ... kind of >> surprising that anyone would no

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread David Chisnall
On 27 Nov 2009, at 08:39, Richard Frith-Macdonald wrote: The question is, do we want to write illegal XML in property lists? At the moment the code can write legal XML or illegal (OSX compatible) XML depending on the OSX compatibility defaults setting. If we assume that 'XML' property lis

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Lars Sonchocky-Helldorf
Am 27.11.2009 um 09:39 schrieb Richard Frith-Macdonald: On 26 Nov 2009, at 17:35, Wolfgang Lux wrote: Richard Frith-Macdonald wrote: I think directly ~/GNUstep/Defaults/.GNUstepDefaults ? That's XML for me now and it wasn't. Oh, that's a hidden file for private use by the base library ..

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Richard Frith-Macdonald
On 27 Nov 2009, at 18:28, Lars Sonchocky-Helldorf wrote: > > Am 27.11.2009 um 09:39 schrieb Richard Frith-Macdonald: > >> >> On 26 Nov 2009, at 17:35, Wolfgang Lux wrote: >> >>> Richard Frith-Macdonald wrote: >>> > I think directly ~/GNUstep/Defaults/.GNUstepDefaults ? > That's XML f

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Lars Sonchocky-Helldorf
Am 27.11.2009 um 20:36 schrieb Richard Frith-Macdonald: On 27 Nov 2009, at 18:28, Lars Sonchocky-Helldorf wrote: Am 27.11.2009 um 09:39 schrieb Richard Frith-Macdonald: On 26 Nov 2009, at 17:35, Wolfgang Lux wrote: Richard Frith-Macdonald wrote: I think directly ~/GNUstep/Defaults/.G

Re: XML GNUstep defaults (was: [flame] NEWS file is useless)

2009-11-27 Thread Richard Frith-Macdonald
On 27 Nov 2009, at 20:05, Lars Sonchocky-Helldorf wrote: > > Maybe we should file a bug with OS X on that by explaining them that they're > writing invalid XML 1.0. I did that some years ago. Possibly they fixed it. > A fix would be simple for Apple, I think there's nothing to stop them from