This is the mail archive of the gdb-patches@sourceware.org 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: FYI: minsyms documentation


On 12/22/11 12:49 PM, Eli Zaretskii wrote:
From: Tom Tromey<tromey@redhat.com>
Cc: gdb-patches@sourceware.org
Date: Thu, 22 Dec 2011 13:13:19 -0700

My working assumption is that gdbint.texinfo is barely maintained at
all.
Only because none of the active developers want to document GDB
internals in a Texinfo manual.  Therefore, the sad state of
gdbint.texinfo is a testament of what the majority of GDB maintainers
think it should look like.


Perhaps that means we should rethink whether we need gdbint.texinfo at all. If everybody is able to madly hack away at the code without ever consulting the internals manual, then what purpose is it serving exactly? Are newbies learning by reading the manual, or reading the code? If the latter, then gdbint.texinfo content might get more attention if it was redistributed into 1-2 page blocks at the tops of relevant source files.


Stan


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