This is the mail archive of the gdb-patches@sources.redhat.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [patch/rfc] Add meaningful section titles to PROBLEMS


> From: David Carlton <carlton@kealia.com>
> Date: Fri, 19 Mar 2004 09:43:48 -0800
> 
> > As for some of the others, I think they would be better served as
> > notes in the documentation (i.e., gdb.texinfo).
> 
> That's a good point - if we want to make users aware of certain
> well-known bugs, then gdb.texinfo is a much more visible place than
> PROBLEMS.

I disagree: we should certainly NOT document our bugs in the manual.

> (Nobody will see PROBLEMS other than possibly the specific
> individual, if any, who is installing that version of GDB by hand.)
> GCC has a section of known bugs in its manual; we should follow suit.

Why not follow suit of Emacs (which does have PROBLEMS, but not a
section about known bugs in the manual).

Note that PROBLEMS might mention problems that are actually bugs in
other related software, not necessarily in GDB per se.  Are we going
to document them in the manual as well?  I don't think so.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]