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


Eli Zaretskii wrote:
> 
> > Are you saying i should write docs for the commands?
> 
> Yes.  Or at least Someone(tm) should.
> 
> I consider the lack of any documentation for the commands you replaced
> to be part of the same bug that you were fixing.
> 
> Even a simple one-liner that mentions the command's existence, with a
> @cindex entry to make it easy to find, is infinitely better than no
> documentation at all, because the latter doesn't leave the user any
> reasonable way of finding out that the commands exist.

Well, well,

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

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.

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.)   

Daniel could volunteer to write the debug ones, it would be nice, I just
don't want to conditionalize his patch on that.  Eli could document some
other ones.  I am not the maintainer of the manual but I guess it will
be welcome.



-- 
Fernando Nasser
Red Hat, Inc. - Toronto                 E-Mail:  fnasser@redhat.com
2323 Yonge Street, Suite #300           Tel:  416-482-2661 ext. 311
Toronto, Ontario   M4P 2C9              Fax:  416-482-6299

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