This is the mail archive of the gdb@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: What's an annex? stratum?


> Date: Mon, 25 Jun 2007 15:19:32 -0400
> From: Paul Koning <pkoning@equallogic.com>
> Cc: eager@eagercon.com,     stanshebs@earthlink.net,     gdb@sources.redhat.com
> 
>  Jim> I'm even a little skeptical about the value of internals
>  Jim> documentation at all.  It seems to me that explanations like
>  Jim> that belong in the code, where people are more likely to see
>  Jim> them, keep them up to date, and delete them when appropriate.
> 
> That's really unfortunate.  Comments in code are useful but they are
> no substitute for properly written internals documentation.

110% agreement.

But then I'm the guy responsible for the GDB documentation.


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