Re: Stepping off breakpoints in non-stop debugging mode (resubmit)

[Eli Zaretskii <eliz@gnu.org>]

> From: Pedro Alves <pedro@codesourcery.com>
> Date: Fri, 25 Apr 2008 20:18:31 +0100
> 
> +  add_setshow_boolean_cmd ("can-use-displaced-stepping", class_maintenance,
> +			    &can_use_displaced_stepping, _("\
> +Set debugger's willingness to use displaced stepping to step \n\
> +over breakpoints."), _("\
> +Show debugger's willingness to use displaced stepping to step \n\
> +over breakpoints."), _("\

These two sentences must not take more than one line, I think.  That's
because some of the help commands, like apropos, only show one line,
so in this case they will show an incomplete sentence.

> +@kindex maint set can-use-displaced-stepping
> +@kindex maint show can-use-displaced-stepping
> +@cindex displaced stepping support
> +@item maint set can-use-displaced-stepping
> +@itemx maint show can-use-displaced-stepping
> +Control whether or not @value{GDBN} will do displaced stepping if the
> +target supports it.  The default is on.  @dfn{Displaced stepping} is a

It is better to have @dfn at the first usage of the term, but that's a
minor nit.

> +way to single-step over breakpoints without removing them from the
> +inferior, by executing an out-of-line copy of the instruction that was
> +originally at the breakpoint location.  It is also known as
> +out-of-line single-stepping.

If "out-of-line single-stepping" is a term known to people, it would
be good to have an index entry here for that term.

Otherwise, the doco bits are fine with me.

Thanks.