This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: Status of 'blacklist' patch?
> Date: Tue, 25 Oct 2011 17:26:44 -0700
> From: Stan Shebs <stan_shebs@mentor.com>
>
> > There's a cost to a comment like this; it's not useful to most
> > readers, but they have to parse it anyway. (What the heck does "skip
> > function file" mean?)
>
> Another purpose for having niggling details in the manual is that in the
> absence of a formal specification, the manual is our promise to users of
> what they should expect to work, and how it will work. So users find
> themselves referring to the manual when they try something that seems
> obvious, and are surprised that it doesn't work as expected.
I know _I_ always consult the manual (not only for GDB), because I
never remember enough details, especially subtle and obscure ones.
Anyway, if Justin is opposed to adding this comment, I can always do
it myself later.