Re: FYI: minsyms documentation

Stan Shebs
2011-12-22T21:18:13Z

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