Re: [PATCH] GDB command-line switches and annotations docs

[Eli Zaretskii <eliz at delorie dot com>]

>  > If it would help, I could add a note telling that the event loop is
>  > still not fully asynchronous, with a FIXME comment that the note
>  > should be removed when the target side is done.  Okay?
> 
> Perfect, thanks!

I attach below the changes which address the above, and also what Stan
said about moving the Annotations chapter before the appendices.
These changes are to be applied _on top_ of those I sent in the
previous message.

Is it okay to commit this and the previous patch?

--- gdb/doc/gdb.t~1	Fri Mar 10 16:39:30 2000
+++ gdb/doc/gdb.texi	Tue Mar 14 22:34:26 2000
@@ -146,6 +146,7 @@
 * Controlling GDB::             Controlling @value{GDBN}
 * Sequences::                   Canned sequences of commands
 * Emacs::                       Using @value{GDBN} under @sc{gnu} Emacs
+* Annotations::                 @value{GDBN}'s annotations interface.
 
 * GDB Bugs::                    Reporting bugs in @value{GDBN}
 * Formatting Documentation::    How to format and print @value{GDBN} documentation
@@ -153,7 +154,6 @@
 * Command Line Editing::        Command Line Editing
 * Using History Interactively:: Using History Interactively
 * Installing GDB::              Installing GDB
-* Annotations::                 @value{GDBN}'s annotations interface.
 * Index::                       Index
 @end menu
 
@@ -945,6 +945,11 @@
 MS-DOS/MS-Windows supports this mode of operation, but the event loop is
 suspended when the debuggee runs.}, so you don't need to wait for
 control to return to @value{GDBN} before you type the next command.
+(@emph{Note:} as of version 5.0, the target side of the asynchronous
+operation is not yet in place, so @samp{-async} does not work fully
+yet.)
+@c FIXME: when the target side of the event loop is done, the above NOTE
+@c should be removed.
 
 When the standard input is connected to a terminal device, @value{GDBN}
 uses the asynchronous event loop by default, unless disabled by the
@@ -11970,6 +11975,8 @@
 each value is printed in its own window.
 @end ignore
 
+@include annotate.texi
+
 @node GDB Bugs
 @chapter Reporting Bugs in @value{GDBN}
 @cindex bugs in @value{GDBN}
@@ -12592,8 +12599,6 @@
 
 There are many other options available as well, but they are generally
 needed for special purposes only.
-
-@include annotate.texi
  
 @node Index
 @unnumbered Index