[Patch:Doc] Example for -exec-arguments

[Patch:Doc] Example for -exec-arguments

[Marc Khouzam]

Hi,

Adding example to the doc for -exec-arguments

Ok?

Also, the doc mentions -exec-show-arguments, but the actual
implementation in GDB is missing.  Should this be written in the doc?

2008-06-05  Marc Khouzam  <marc.khouzam@ericsson.com>

	* gdb.texinfo (GDB/MI Program Context): Added example
	to -exec-arguments



Index: gdb/doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.499
diff -u -r1.499 gdb.texinfo
--- gdb/doc/gdb.texinfo 4 Jun 2008 23:24:19 -0000       1.499
+++ gdb/doc/gdb.texinfo 5 Jun 2008 18:54:33 -0000
@@ -19008,8 +19008,12 @@
 
 @subsubheading Example
 
-@c FIXME!
-Don't have one around.
+@smallexample
+(gdb)
+-exec-arguments -v word
+^done
+(gdb)
+@end smallexample
 
 
 @subheading The @code{-exec-show-arguments} Command

 
Marc

Re: [Patch:Doc] Example for -exec-arguments

[Eli Zaretskii]

> Date: Thu, 5 Jun 2008 14:59:13 -0400
> From: "Marc Khouzam" <marc.khouzam@ericsson.com>
> 
> Adding example to the doc for -exec-arguments
> 
> Ok?

Yes, thanks.

> Also, the doc mentions -exec-show-arguments, but the actual
> implementation in GDB is missing.  Should this be written in the doc?

Yes, I think so.

Re: [Patch:Doc] Example for -exec-arguments

[Nick Roberts]

 > > Adding example to the doc for -exec-arguments
 > > 
 > > Ok?
 > 
 > Yes, thanks.

-exec-arguments is just "set args" really.  The number of such commands that
could be created are almost limitless.  Note that this one provides no output
for the MI front end to parse and the CLI command could easily be used.  I
wonder if they are really needed and whether we should remove them (or at least
the ones which are unimplemented).

 > > Also, the doc mentions -exec-show-arguments, but the actual
 > > implementation in GDB is missing.  Should this be written in the doc?
 > 
 > Yes, I think so.

That's what is written in the docs:

   Example
   .......
 
   Example(s) formatted for readability.  Some of the described commands
   have not been implemented yet and these are labeled N.A. (not
   available).


-- 
Nick                                           http://www.inet.net.nz/~nickrob

RE: [Patch:Doc] Example for -exec-arguments

[Marc Khouzam]

> -exec-arguments is just "set args" really.  The number of 
> such commands that
> could be created are almost limitless.  Note that this one 
> provides no output
> for the MI front end to parse and the CLI command could 
> easily be used.  I
> wonder if they are really needed and whether we should remove 
> them (or at least
> the ones which are unimplemented).

Now that you point this out, I realize we can use "-gdb-set args" right now.
Not only that, but -gdb-show args does works while -exec-show-arguments
does not.

I prefer to use -gdb-set since I can.

>  > > Also, the doc mentions -exec-show-arguments, but the actual
>  > > implementation in GDB is missing.  Should this be 
> written in the doc?
>  > 
>  > Yes, I think so.
> 
> That's what is written in the docs:
> 
>    Example
>    .......
>  
>    Example(s) formatted for readability.  Some of the 
> described commands
>    have not been implemented yet and these are labeled N.A. (not
>    available).

You are right.  I had seen the N.A. and thought that just the example was not
available, not the whole command.

Marc