gdb/doc/python.texi: Fix reference to "Progspaces In Python".

[deliverable/binutils-gdb.git] / gdb / doc / annotate.texinfo

diff --git a/gdb/doc/annotate.texinfo b/gdb/doc/annotate.texinfo
index 86b90cc74e726e5796722fdeabf3921e07317fa1..b2defadf3214a08d5a50300e24fca8e8f464e559 100644 (file)
--- a/gdb/doc/annotate.texinfo
+++ b/gdb/doc/annotate.texinfo
@@ -4,7 +4,7 @@
 
 @c This is a dir.info fragment to support semi-automated addition of
 @c manuals to an info tree.
 
 @c This is a dir.info fragment to support semi-automated addition of
 @c manuals to an info tree.

-@dircategory Programming & development tools.
+@dircategory Software development

 @direntry
 * Annotate: (annotate).                 The obsolete annotation interface.
 @end direntry
 @direntry
 * Annotate: (annotate).                 The obsolete annotation interface.
 @end direntry


@@ -20,25 +20,28 @@
 @set DATE July 2003
 
 @c NOTE: cagney/2003-07-28:
 @set DATE July 2003
 
 @c NOTE: cagney/2003-07-28:

-@c Don't make this migration doccument an appendix of GDB's user guide.
+@c Don't make this migration document an appendix of GDB's user guide.

 @c By keeping this separate, the size of the user guide is contained. If
 @c the user guide to get much bigger it would need to switch to a larger,
 @c more expensive, form factor and would drive up the manuals publication
 @c cost.  Having a smaller cheaper manual helps the GNU Press with its sales.
 
 @c By keeping this separate, the size of the user guide is contained. If
 @c the user guide to get much bigger it would need to switch to a larger,
 @c more expensive, form factor and would drive up the manuals publication
 @c cost.  Having a smaller cheaper manual helps the GNU Press with its sales.
 

-@ifinfo
-This file documents @value{GDBN}'s obsolete annotations.
-
-Copyright 1994, 1995, 2000, 2001, 2003 Free Software Foundation, Inc.
+@copying
+Copyright @copyright{} 1994-2014 Free Software Foundation, Inc.

 
 Permission is granted to copy, distribute and/or modify this document
 
 Permission is granted to copy, distribute and/or modify this document

-under the terms of the GNU Free Documentation License, Version 1.1 or
+under the terms of the GNU Free Documentation License, Version 1.3 or

 any later version published by the Free Software Foundation; with no
 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
 Texts.  A copy of the license is included in the section entitled ``GNU
 Free Documentation License''.
 any later version published by the Free Software Foundation; with no
 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
 Texts.  A copy of the license is included in the section entitled ``GNU
 Free Documentation License''.

+@end copying

 
 

-@end ifinfo
+@ifnottex
+This file documents @value{GDBN}'s obsolete annotations.
+
+@insertcopying
+@end ifnottex

 
 @titlepage
 @title @value{GDBN}'s Obsolete Annotations
 
 @titlepage
 @title @value{GDBN}'s Obsolete Annotations


@@ -47,18 +50,10 @@ Free Documentation License''.
 @author Free Software Foundation
 @page
 @vskip 0pt plus 1filll
 @author Free Software Foundation
 @page
 @vskip 0pt plus 1filll

-Copyright @copyright{} 1994, 1995, 2000, 2001, 2003 Free Software
-Foundation, Inc.
-
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with no
-Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
-Texts.  A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
+@insertcopying

 @end titlepage
 
 @end titlepage
 

-@ifinfo
+@ifnottex

 @node Top
 @top GDB Annotations
 
 @node Top
 @top GDB Annotations
 


@@ -68,7 +63,7 @@ implemented in older @value{GDBN} versions.
 @ignore
 This is Edition @value{EDITION}, @value{DATE}.
 @end ignore
 @ignore
 This is Edition @value{EDITION}, @value{DATE}.
 @end ignore

-@end ifinfo
+@end ifnottex

 
 @menu
 * Annotations Overview::  What annotations are; the general syntax.
 
 @menu
 * Annotations Overview::  What annotations are; the general syntax.


@@ -85,6 +80,7 @@ This is Edition @value{EDITION}, @value{DATE}.
 * Annotations for Running::
                         Whether the program is running, how it stopped, etc.
 * Source Annotations::  Annotations describing source code.
 * Annotations for Running::
                         Whether the program is running, how it stopped, etc.
 * Source Annotations::  Annotations describing source code.

+* Multi-threaded Apps:: An annotation that reports multi-threadedness.

 
 * GNU Free Documentation License::
 @end menu
 
 * GNU Free Documentation License::
 @end menu


@@ -161,7 +157,7 @@ assume that specific @value{GDBN} commands provide specific information.
 Any change to @value{GDBN}'s @sc{cli} output modifies or removes that
 information and, consequently, likely breaks the client.
 
 Any change to @value{GDBN}'s @sc{cli} output modifies or removes that
 information and, consequently, likely breaks the client.
 

-Since the @sc{gdb/mi} output is independant of the @sc{cli}, it does not
+Since the @sc{gdb/mi} output is independent of the @sc{cli}, it does not

 have this problem.
 
 @section Scalability
 have this problem.
 
 @section Scalability


@@ -200,8 +196,8 @@ The annotation mechanism was implemented by interspersing @sc{cli} print
 statements with various annotations.  As a consequence, any @sc{cli}
 output change can alter the annotation output.
 
 statements with various annotations.  As a consequence, any @sc{cli}
 output change can alter the annotation output.
 

-Since the @sc{gdb/mi} output is independant of the @sc{cli}, and the
-@sc{gdb/mi} is increasingly implemented independant of the @sc{cli}
+Since the @sc{gdb/mi} output is independent of the @sc{cli}, and the
+@sc{gdb/mi} is increasingly implemented independent of the @sc{cli}

 code, its long term maintenance is much easier.
 
 @node Migrating to GDB/MI
 code, its long term maintenance is much easier.
 
 @node Migrating to GDB/MI


@@ -820,9 +816,31 @@ source which is being displayed.  @var{addr} is in the form @samp{0x}
 followed by one or more lowercase hex digits (note that this does not
 depend on the language).
 
 followed by one or more lowercase hex digits (note that this does not
 depend on the language).
 

-@raisesections
+@node Multi-threaded Apps
+@chapter Multi-threaded Applications
+@cindex annotations for multi-threaded apps
+
+The following annotations report thread related changes of state.
+
+@table @code
+@findex new-thread@r{, annotation}
+@item ^Z^Znew-thread
+
+This annotation is issued once for each thread that is created apart from
+the main thread, which is not reported.
+
+@findex thread-changed@r{, annotation}
+@item ^Z^Zthread-changed
+
+The selected thread has changed.  This may occur at the request of the
+user with the @code{thread} command, or as a result of execution,
+e.g., another thread hits a breakpoint.
+
+@end table
+
+@node GNU Free Documentation License
+@appendix GNU Free Documentation License

 @include fdl.texi
 @include fdl.texi

-@lowersections

 
 @ignore
 @node Index
 
 @ignore
 @node Index