Agar: r9080 - trunk/core
Author: vedge
Date: 2012-01-14 02:39:08 -0500 (Sat, 14 Jan 2012)
New Revision: 9080
Modified:
trunk/core/AG_Threads.3
Log:
rewrite confusing example
Modified: trunk/core/AG_Threads.3
===================================================================
--- trunk/core/AG_Threads.3 2012-01-14 07:30:03 UTC (rev 9079)
+++ trunk/core/AG_Threads.3 2012-01-14 07:39:08 UTC (rev 9080)
@@ -39,8 +39,7 @@
multithreading.
Agar API calls, unless otherwise documented, then become safe to invoke from
arbitrary threads within an application.
-Internally this is achieved using many locking devices (e.g., mutexes),
-acquired and released in a fine-grained fashion.
+Internally this is achieved using fined-grained locking devices.
.Pp
The Agar object system (see
.Xr AG_Object 3 )
@@ -54,37 +53,21 @@
When multithreading is used, the return values of functions (except for error
codes), should only be considered safe to use for as long as the related
Agar objects are locked.
-Internally, the Agar functions will always acquire and release the necessary
-locks, but the calling function must be necessarily careful to avoid race
-conditions when a return value is used.
(Continue reading)