"maint set remote-async" is removed from sources, but is still described in texinfo?

[Pedro Alves]

Eli, I think you missed this one, and it almost fell got off my
radar as well.  Could you take a look, please?

On Wednesday 04 February 2009 22:53:49, Pedro Alves wrote:
> On Wednesday 04 February 2009 05:28:17, Masaki Muranaka wrote:
> > Hello,
> > 
> > The CVS head of gdb has no support "maint set remote-async".
> > (removed by Perdo and Vladimir / 2008-08-19)
> > But there is a description about it in gdb/doc/gdb.texinfo.
> > 
> 
> > Will "maint set remote-async" revive?
> > Or should the discription in gdb.texinfo be deleted?
> 
> This command has been replaced by "set target-async" command.
> 
> Since these are no longer a maintenance command, we get to move
> the description of the command somewhere else.  I think it should
> it in the "Background Execution" section.  There's already mention
> of the command there, but I think we should move it up a bit, so
> the user doesn't get suprised when he tries out the background
> commands, and they don't work.
> 
> Eli, does this look OK?

-- 
Pedro Alves

	* gdb.texinfo (Background Execution): Better describe the set
	target-async command.
	(Maintenance Commands): Delete description of the `maint set/show
	linux-async' and `maint set/show remote-async' commands.
	
---
 gdb/doc/gdb.texinfo |   45 ++++++++++++++++++---------------------------
 1 file changed, 18 insertions(+), 27 deletions(-)

Index: src/gdb/doc/gdb.texinfo
===================================================================
--- src.orig/gdb/doc/gdb.texinfo	2009-02-04 22:29:00.000000000 +0000
+++ src/gdb/doc/gdb.texinfo	2009-02-04 22:47:03.000000000 +0000
@@ -4662,6 +4662,24 @@ the program to report that some thread h
 another command.  In background execution, @value{GDBN} immediately gives
 a command prompt so that you can issue other commands while your program runs.
 
+You need to explicitly enable asynchronous mode before you can use
+background execution commands.  You can use these commands to
+manipulate the asynchronous mode setting:
+
+@table @code
+@kindex set target-async
+@item set target-async on
+Enable asynchronous mode.
+@item set target-async off
+Disable asynchronous mode.
+@kindex show target-async
+@item show target-async
+Show the current target-async setting.
+@end table
+
+If the target doesn't support async mode, @value{GDBN} issues an error
+message if you attempt to use the background execution commands.
+
 To specify background execution, add a @code{&} to the command.  For example,
 the background form of the @code{continue} command is @code{continue&}, or
 just @code{c&}.  The execution commands that accept background execution
@@ -4727,11 +4745,6 @@ only the current thread.  To stop the wh
 use @code{interrupt -a}.
 @end table
 
-You may need to explicitly enable async mode before you can use background
-execution commands, with the @code{set target-async 1} command.  If the
-target doesn't support async mode, @value{GDBN} issues an error message
-if you attempt to use the background execution commands.
-
 @node Thread-Specific Breakpoints
 @subsection Thread-Specific Breakpoints
 
@@ -25033,28 +25046,6 @@ data in a @file{gmon.out} file, be sure 
 Configuring with @samp{--enable-profiling} arranges for @value{GDBN} to be
 compiled with the @samp{-pg} compiler option.
 
-@kindex maint set linux-async
-@kindex maint show linux-async
-@cindex asynchronous support
-@item maint set linux-async
-@itemx maint show linux-async
-Control the GNU/Linux native asynchronous support 
-(@pxref{Background Execution}) of @value{GDBN}.
-
-GNU/Linux native asynchronous support will be disabled until you use
-the @samp{maint set linux-async} command to enable it.
-
-@kindex maint set remote-async
-@kindex maint show remote-async
-@cindex asynchronous support
-@item maint set remote-async
-@itemx maint show remote-async
-Control the remote asynchronous support 
-(@pxref{Background Execution}) of @value{GDBN}.
-
-Remote asynchronous support will be disabled until you use
-the @samp{maint set remote-async} command to enable it.
-
 @kindex maint show-debug-regs
 @cindex x86 hardware debug registers
 @item maint show-debug-regs