This is the mail archive of the gdb-patches@sourceware.cygnus.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]

Re: [PATCH]: add set/show debug, move gdb debugging flags into it


Fernando Nasser <fnasser@redhat.com> writes:

> First I agree with Eli that these commands must be documented.

I don't agree, but i'm perfectly willing to go with the consensus.

> 
> However, I don't think it is a must in Daniel's patch.  He is already
> fixing a big problem that is the horrible naming/organization of this
> commands.  As soon as I can get the deprecating patch in I am willing to
> check Daniel's patch so we get rid of those abnormalities. 


> 
> The documentation problem may not be restricted to the debug command but
> also to other maintenance class commands.  They have been considered to
> be restricted to wizards that read source code instead of manuals and so
> they have not been documented in the user's manual.
> 
This is why i don't think they should be documented.
Even if you knew what they did, the output wouldn't be useful unless
you went digging through the source code, or were familiar with the
source.

> It is a question of policy and, most importantly, willing of people to
> put some time into it (Someone(tm) will have to put some time to do
> it.)   

Hey, i'm Someone(tm).

> 
> Daniel could volunteer to write the debug ones, it would be nice, I just
> don't want to conditionalize his patch on that.  

I'll happily write the documentation for the debug ones, i just have
no idea what it should read like.
I mean, what do you want me to say about, fer instance, targetdebug?

All i can think of is "Controls printing of target_ops functions and
their arguments, as they get called".


> Eli could document some
> other ones.  I am not the maintainer of the manual but I guess it will
> be welcome.

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