$_ and info breakpoint [PATCH: doco]
Nick Roberts
nickrob@snap.net.nz
Wed Jul 11 22:56:00 GMT 2007
> > This shouldn't affect existing use and we can put a caveat in the
> > documentaion in the manual:
> >
> > The convenience variable `$_' and the default
> > examining-address for the `x' command are set to the address of
> > the last breakpoint listed unless the command is prefixed with
> > 'server ' (see Command History).
>
> I have no warlord M-DEL patch, but I just wanted to point out that
> 'server' should be documented more clearly than it is.
How about this? (adapted fron the "Server Prefix" node in annotate.texinfo)
--
Nick http://www.inet.net.nz/~nickrob
2007-07-12 Nick Roberts <nickrob@snap.net.nz>
* gdb.texinfo (Server Prefix): New node. Adapt from existing node
in annotate.texinfo.
(Command History): Link to new node.
*** gdb.texinfo 04 Jul 2007 17:37:49 +1200 1.420
--- gdb.texinfo 12 Jul 2007 10:50:38 +1200
*************** package, to provide the history facility
*** 15436,15442 ****
Interactively}, for the detailed description of the History library.
To issue a command to @value{GDBN} without affecting certain aspects of
! the state which is seen by users, prefix it with @samp{server }. This
means that this command will not affect the command history, nor will it
affect @value{GDBN}'s notion of which command to repeat if @key{RET} is
pressed on a line by itself.
--- 15436,15443 ----
Interactively}, for the detailed description of the History library.
To issue a command to @value{GDBN} without affecting certain aspects of
! the state which is seen by users, prefix it with @samp{server }
! (@pxref{Server Prefix}). This
means that this command will not affect the command history, nor will it
affect @value{GDBN}'s notion of which command to repeat if @key{RET} is
pressed on a line by itself.
*************** This is Edition @value{EDITION}, @value{
*** 21241,21246 ****
--- 21242,21248 ----
@menu
* Annotations Overview:: What annotations are; the general syntax.
+ * Server Prefix:: Issuing a command without affecting user state.
* Prompting:: Annotations marking @value{GDBN}'s need for input.
* Errors:: Annotations for error messages.
* Invalidation:: Some annotations describe things now invalid.
*************** Here @samp{quit} is input to @value{GDBN
*** 21319,21324 ****
--- 21321,21340 ----
denotes a @samp{control-z} character) are annotations; the rest is
output from @value{GDBN}.
+ @node Server Prefix
+ @section The Server Prefix
+ @cindex server prefix for annotations
+
+ If you prefix a command with @samp{server } then it will not affect
+ the command history, nor will it affect @value{GDBN}'s notion of which
+ command to repeat if @key{RET} is pressed on a line by itself. This
+ means that commands can be run behind a user's back by a front-end in
+ a transparent manner.
+
+ The server prefix does not affect the recording of values into the value
+ history; to print a value without recording it into the value history,
+ use the @code{output} command instead of the @code{print} command.
+
@node Prompting
@section Annotation for @value{GDBN} Input
More information about the Gdb-patches
mailing list