Update Ada tasks documentation

Message ID 20221115171300.1715254-1-tromey@adacore.com
State Committed
Commit 3971740e4bba92209ab002d44ec3b20a36736ff0
Headers
Series Update Ada tasks documentation |

Commit Message

Tom Tromey Nov. 15, 2022, 5:13 p.m. UTC
  My co-worker Kévin noticed that the Ada tasks documentation is
slightly out of date -- it does not document all the states that can
be reported by ada-tasks.c.

This patch adds the missing states to the appropriate node, and
updates one state to reflect a change made some time ago.
---
 gdb/doc/gdb.texinfo | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)
  

Comments

Eli Zaretskii Nov. 15, 2022, 6:04 p.m. UTC | #1
> Cc: Tom Tromey <tromey@adacore.com>
> Date: Tue, 15 Nov 2022 10:13:00 -0700
> From: Tom Tromey via Gdb-patches <gdb-patches@sourceware.org>
> 
> My co-worker Kévin noticed that the Ada tasks documentation is
> slightly out of date -- it does not document all the states that can
> be reported by ada-tasks.c.
> 
> This patch adds the missing states to the appropriate node, and
> updates one state to reflect a change made some time ago.

Thanks, this is OK, assuming the Ada parts are correct.
  

Patch

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index ea66f4ee42d..0b708b9f801 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -18858,7 +18858,7 @@  terminated themselves.
 @item Child Activation Wait
 The task is waiting for created tasks to complete activation.
 
-@item Accept Statement
+@item Accept or Select Term
 The task is waiting on an accept or selective wait statement.
 
 @item Waiting on entry call
@@ -18881,8 +18881,20 @@  waiting on a terminate Phase.
 The task is sleeping waiting for tasks on terminate alternatives to
 finish terminating.
 
+@item Asynchronous Hold
+The task has been held by @code{Ada.Asynchronous_Task_Control.Hold_Task}.
+
+@item Activating
+The task has been created and is being made runnable.
+
+@item Selective Wait
+The task is waiting in a selective wait statement.
+
 @item Accepting RV with @var{taskno}
 The task is accepting a rendez-vous with the task @var{taskno}.
+
+@item Waiting on RV with @var{taskno}
+The task is waiting for a rendez-vous with the task @var{taskno}.
 @end table
 
 @item Name