Re: [PATCH] init-if-undefined command

[Joel Brobecker <brobecker@adacore.com>]

[re-adding gdb-patches, as it looks like it was removed by accident]

On Wed, Nov 16, 2005 at 04:02:15PM -0800, Jim Blandy wrote:
> On 11/16/05, Joel Brobecker <brobecker@adacore.com> wrote:
> > > If you knew everything about the previous release, you're supposed to
> > > be able to know everything about the new release just by reading NEWS.
> > >  You're not even supposed to have to read the manual.  Or at least
> > > those were Stallman's rules for Emacs NEWS.  I thought it was kind of
> > > a waste; why not point people to the manual?
> >
> > With the manual, it's not obvious what has been introduced in a release.
> > New commands, in my opinion, deserve a bit of publicity from the NEWS
> > files. The NEWS file, however, doesn't replace the manual, it's just
> > a note to inform readers that a cool new command has been introduced
> > and whose description is available in the manual.
> 
> What I meant was, Stallman wanted each new feature fully documented in
> NEWS; I felt it should be sufficient to summarize the new feature in
> NEWS, and refer the user to the manual for the details.

I agree.

-- 
Joel