X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fdoc%2Fannotate.texinfo;h=b2defadf3214a08d5a50300e24fca8e8f464e559;hb=1e47491b33aac7447697c3cdeff0bbdbba5d58a0;hp=86b90cc74e726e5796722fdeabf3921e07317fa1;hpb=2154891a106b9d8fdb33bbe5984f8f30c8b4035c;p=deliverable%2Fbinutils-gdb.git

diff --git a/gdb/doc/annotate.texinfo b/gdb/doc/annotate.texinfo
index 86b90cc74e..b2defadf32 100644
--- 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.
-@dircategory Programming & development tools.
+@dircategory Software development
 @direntry
 * Annotate: (annotate).                 The obsolete annotation interface.
 @end direntry
@@ -20,25 +20,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.
 
-@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
-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''.
+@end copying
 
-@end ifinfo
+@ifnottex
+This file documents @value{GDBN}'s obsolete annotations.
+
+@insertcopying
+@end ifnottex
 
 @titlepage
 @title @value{GDBN}'s Obsolete Annotations
@@ -47,18 +50,10 @@ Free Documentation License''.
 @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
 
-@ifinfo
+@ifnottex
 @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
-@end ifinfo
+@end ifnottex
 
 @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.
+* Multi-threaded Apps:: An annotation that reports multi-threadedness.
 
 * 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.
 
-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
@@ -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.
 
-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
@@ -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).
 
-@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
-@lowersections
 
 @ignore
 @node Index