This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH] init-if-undefined command
- From: Joel Brobecker <brobecker at adacore dot com>
- To: Jim Blandy <jimb at red-bean dot com>
- Cc: gdb-patches at sources dot redhat dot com
- Date: Wed, 16 Nov 2005 16:10:49 -0800
- Subject: Re: [PATCH] init-if-undefined command
- References: <437B3E56.3080306@st.com> <ud5l075bf.fsf@gnu.org> <20051116194956.GV1635@adacore.com> <8f2776cb0511161507j33208ae1k1e0753b72b992c73@mail.gmail.com> <20051116233326.GZ1635@adacore.com> <8f2776cb0511161602wb469964xdd904aab0d70d2a6@mail.gmail.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