Re: [Patch docs 0/5] Update some of md.texi

2015-01-06 Thread Joseph Myers
On Tue, 6 Jan 2015, James Greenhalgh wrote: > > and "Update text." is thoroughly unhelpful as a ChangeLog entry to > > explain the intent of the changes. > > Well, indeed, but ChangeLog entries have always been a > thoroughly unhelpful "what changed" rather than "why did it > change". (grep ": U

Re: Re: [Patch docs 0/5] Update some of md.texi

2015-01-06 Thread Sandra Loosemore
On Tue, 6 Jan 2015, James Greenhalgh wrote: On Tue, Jan 06, 2015 at 02:56:58PM +, Joseph Myers wrote: On Tue, 6 Jan 2015, James Greenhalgh wrote: I was aiming to: * Remove outdated details of the compiler. * Remove long or obscure words that, while accurate, only served to obfusc

Re: [Patch docs 0/5] Update some of md.texi

2015-01-06 Thread James Greenhalgh
On Tue, Jan 06, 2015 at 02:56:58PM +, Joseph Myers wrote: > On Tue, 6 Jan 2015, James Greenhalgh wrote: > > > I was aiming to: > > > > * Remove outdated details of the compiler. > > * Remove long or obscure words that, while accurate, only served to > > obfuscate a simple idea. > >

Re: [Patch docs 0/5] Update some of md.texi

2015-01-06 Thread Joseph Myers
On Tue, 6 Jan 2015, James Greenhalgh wrote: > I was aiming to: > > * Remove outdated details of the compiler. > * Remove long or obscure words that, while accurate, only served to > obfuscate a simple idea. > * Refer to similar things in a consistent fashion - in particular > trying