2007-09-12 Robert Dewar <dewar@adacore.com>

	* g-thread.ads: Document use of "with GNAT.Threads" to ensure loading
	the tasking version of the Ada run time when foreign threads are
	present and there are no explicit Ada tasks or tasking constructs.

	* gnat_rm.texi: Clarify documentation of GNAT.Threads.



git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@128428 138bc75d-0d04-0410-961f-82ee72b054a4

1 files changed, 13 insertions, 4 deletions

diff --git a/gcc/ada/g-thread.ads b/gcc/ada/g-thread.ads
index df2c67613f7..b5825f39f1f 100644
--- a/gcc/ada/g-thread.ads
+++ b/gcc/ada/g-thread.ads
@@ -31,10 +31,19 @@
 --                                                                          --
 ------------------------------------------------------------------------------
 
---  This package provides facilities for creation of foreign threads for
---  use as Ada tasks. In order to execute general Ada code, the run-time
---  system must know about all tasks. This package allows foreign code,
---  e.g. a C program, to create a thread that the Ada run-time knows about.
+--  This package provides facilities for creation or registration of foreign
+--  threads for use as Ada tasks. In order to execute general Ada code, the
+--  run-time system must know about all tasks. This package allows foreign
+--  code, e.g. a C program, to create a thread that the Ada run-time knows
+--  about, or to register the current thread.
+
+--  For some implementations of GNAT Pro, the registration of foreign threads
+--  is automatic. However, in such implementations, if the Ada program has no
+--  tasks at all and no tasking constructs other than delay, then by default
+--  the non-tasking version of the Ada run-time will be loaded. If foreign
+--  threads are present, it is important to ensure that the tasking version
+--  of the Ada run time is loaded. This may be achieved by adding "with
+--  GNAT.Threads" to any unit in the partition.
 
 with System;
 with Ada.Task_Identification;