$_ 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