[PATCH] GDB command-line switches and annotations docs

[Elena Zannoni]

Eli Zaretskii writes:
 > 
 > >  > 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?
 > 

Ok with me for contents, but I am not the docs maintainer.

Elena

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