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

[Stan Shebs <shebs at apple dot com>]

Michael Snyder wrote:
> 
> Fernando Nasser wrote:
> 
> > 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.
> 
> I always consider it questionable whether maintenance commands
> SHOULD be documented in the user's guide.  If they should,
> perhaps it should be in a separate section clearly identified
> as being for the maintenance and debugging of the debugger.

I've been in favor of including them, just because users sometimes have need
of those commands.  remotedebug is perhaps the best-known example; while
nominally for maintenance on the standard protocol, it's become a staple
for embedded developers, since bugs in the application can trash the stub,
and remotedebug will help you see what is happening.

You're right that maint commands should generally be documented in their
own section, so they're only found by the truly desperate users... :-)

It's on my list, but at a low priority.

Stan