[Boost-commit] svn:boost r41925 - sandbox/committee/LWG

From: jeff_at_[hidden]
Date: 2007-12-09 12:07:55

Author: az_sw_dude
Date: 2007-12-09 12:07:54 EST (Sun, 09 Dec 2007)
New Revision: 41925
URL: http://svn.boost.org/trac/boost/changeset/41925

Log:
commit changes after jeffs full review and discussion
Text files modified: 
   sandbox/committee/LWG/thread_library.html |    49 +++++++++++++++++++++------------------ 
   1 files changed, 26 insertions(+), 23 deletions(-)

Modified: sandbox/committee/LWG/thread_library.html
==============================================================================
--- sandbox/committee/LWG/thread_library.html	(original)
+++ sandbox/committee/LWG/thread_library.html	2007-12-09 12:07:54 EST (Sun, 09 Dec 2007)
@@ -71,7 +71,7 @@
 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.1.1 Template Parameter Names [thread.tmplparmname]
 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.1.2 Exceptions [thread.exception]
 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.1.3 Native Handles [thread.native]
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.1.4 Duration Timeout [thread.duration]
+<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.1.4 Timing Specifications [thread.timing_specifications]
 <br>&nbsp;&nbsp;&nbsp;&nbsp;30.2 Threads [thread.threads]
 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.2.1 Class thread [thread.threads.class]
 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30.2.1.1 Class thread::id [thread.threads.id]
@@ -414,16 +414,17 @@
 </p>
 
 
-<h4><a name="thread.duration">30.1.4 Duration Timeout [thread.duration]</a></h4>
+<h4><a name="thread.timing_specifications">30.1.4 Timing Specifications [thread.timing_specifications]</a></h4>
 
 <p>
-Several functions described in this clause take an argument specifying
-a timeout.
-[<i>Note:</i>
-Reasonable use cases exist for both duration and
-absolute time based timeouts, so overloads for both are provided unless
-contraindicated.
-&mdash;<i>end note</i>]
+Several functions described in this clause take an argument to specify a
+timeout.  These timeouts are specified as either a Duration or a Time Point type as specified in [time].
+</p>
+
+<p>
+The resolution of timing provided by an implementation depends on
+both operating system and hardware.  The finest resolution provided by
+an implementation is called the native resolution.
 </p>
 
 
@@ -1188,6 +1189,8 @@
 <dt>Effects:</dt>
 <dd>
 The current thread blocks for at least the amount of time specified.
+If the resolution of <code>Duration</code> is finer than the native
+resolution, the time is rounded up to the nearest native resolution.
 </dd>
 
 <dt>Synchronization:</dt>
@@ -1219,10 +1222,10 @@
 <pre><code>
 namespace std {
 
-struct mutex;
-struct recursive_mutex;
-struct timed_mutex;
-struct recursive_timed_mutex;
+class mutex;
+class recursive_mutex;
+class timed_mutex;
+class recursive_timed_mutex;
 
 struct defer_lock_t;
 struct try_to_lock_t;
@@ -1435,7 +1438,7 @@
 <pre><code>
 namespace std {
 
-struct mutex
+class mutex
 {
 public:
     mutex();
@@ -1483,7 +1486,7 @@
 <pre><code>
 namespace std {
 
-struct recursive_mutex
+class recursive_mutex
 {
 public:
     recursive_mutex();
@@ -1662,7 +1665,7 @@
 <pre><code>
 namespace std {
 
-struct timed_mutex
+class timed_mutex
 {
 public:
     timed_mutex();
@@ -1698,7 +1701,7 @@
 <pre><code>
 namespace std {
 
-struct recursive_timed_mutex
+class recursive_timed_mutex
 {
 public:
     recursive_timed_mutex();
@@ -3068,7 +3071,7 @@
 
 <dt>Returns:</dt>
 <dd>
-<code>false</code> if the call is returning because the time period specified by
+<code>false</code> if the call is returning because the time duration specified by
 <code>rel_time</code> has elapsed, <code>true</code> otherwise.
 </dd>
 
@@ -3434,7 +3437,7 @@
 
 <dt>Returns:</dt>
 <dd>
-<code>false</code> if the call is returning because the time period specified by
+<code>false</code> if the call is returning because the time duration specified by
 <code>rel_time</code> has elapsed, <code>true</code> otherwise.
 </dd>
 
@@ -3647,8 +3650,8 @@
 </p>
 
 <p>
-Objects of duration types provide relative time values and comparison and
-arithmetic operations on those values.
+Objects of duration types provide time length values. Duration types
+provide comparison and arithmetic operations on those values.
 </p>
 
 <p>
@@ -4353,7 +4356,7 @@
 Coordinated Universal Time, known as UTC, time.
 <code>system_time</code>
 shall provide an epoch time of 1970-01-01 00:00:00.000000000
-and a maximum time value of at least epoch time &plusmn; 292 years.
+and a maximum time value of at least epoch time + 292 years.
 [<i>Note:</i>
 292 years represents the number of nanoseconds
 that can be represented in a signed 64 bit integer.
@@ -4413,7 +4416,7 @@
 <dt>Effects:</dt>
 <dd>
 Constructs a <code>system_time</code>
-object representing the epoch time point 1970-01-01 00:00:00.000000000
+object representing the epoch time.
 </dd>
 </dl>
 </blockquote>