[Boost-commit] svn:boost r41796 - sandbox/committee/branches/date_time

From: bdawes_at_[hidden]
Date: 2007-12-06 12:44:45

Author: bemandawes
Date: 2007-12-06 12:44:44 EST (Thu, 06 Dec 2007)
New Revision: 41796
URL: http://svn.boost.org/trac/boost/changeset/41796

Log:
All Chapter 31 changes applied except system_time changes. Those are next.
Text files modified: 
   sandbox/committee/branches/date_time/thread_library.html |    58 +++++++++++++++++---------------------- 
   1 files changed, 26 insertions(+), 32 deletions(-)

Modified: sandbox/committee/branches/date_time/thread_library.html
==============================================================================
--- sandbox/committee/branches/date_time/thread_library.html	(original)
+++ sandbox/committee/branches/date_time/thread_library.html	2007-12-06 12:44:44 EST (Thu, 06 Dec 2007)
@@ -5,7 +5,7 @@
 
 
 <meta http-equiv="content-type" content="text/html; charset=US-ASCII">
-<title>Multi-threading Library for Standard C++ (Revision 1)</title>
+<title>Thread Library Working Draft</title>
 
 <style type="text/css">
         h1	{ text-align: center; }
@@ -3443,9 +3443,8 @@
 <dfn>resolution</dfn> which is their smallest representable time duration.
 Time points
 have an <dfn>epoch</dfn> or start of a given time scale.
-For time_t the epoch is
-1970-01-01 00:00:00.
-</p>
+<i>[Example: </i>For std::time_t the epoch is
[phone]:00:00. <i>--end example]</i></p>
 
 <p>
 Throughout this clause, the names of template parameters are used to express
@@ -3500,6 +3499,13 @@
 or <code>RhsDuration</code> has the finest resolution. If their 
 resolutions are the same, <i><code>FRDuration</code> </i>is <code>LhsDuration</code>.</p>
 
+<p>Unless otherwise specified, no function in this clause shall throw 
+exceptions. <i>[Note: </i>Such blanket prohibition of exceptions is unusual in 
+the standard library, but without the prohibition time-related code becomes 
+littered with excessive try-catch blocks. These functions are also unusual in 
+that they encompass virtually no cases where errors can be detected and 
+reported.&nbsp; <i>--end note.]</i></p>
+
 <h3><a name="time.duration.requirements">31.1 Duration requirements 
 [time.duration.requirements]</a></h3>
 <p>This subclause describes requirements on duration types used to instantiate 
@@ -3596,8 +3602,6 @@
     == d.tick_count()</code><sub>at-entry</sub><code>*c</code></td>
   </tr>
 </table>
-<p>Unless otherwise specified, no duration type functions shall throw 
-exceptions.</p>
 
 
 <h3><a name="time.nanoseconds">32.2 Class nanoseconds [time.nanoseconds]</a></h3>
@@ -4253,16 +4257,8 @@
     &mdash;<i>end note</i>]
   </p>
 
-  <p>
-    Unless otherwise specified, no
-    <code>system_time</code> member functions shall throw
-    exceptions.
-  </p>
-
-  <pre>    <code>
-      system_time();
-    </code>
-  </pre>
+  <pre>   <code>
+      system_time();   </code>  </pre>
 
   <blockquote>
     <dl>
@@ -4276,9 +4272,7 @@
   </blockquote>
 
   <pre>    <code>
-      system_time(time_t secs, nanoseconds ns);
-    </code>
-  </pre>
+      system_time(time_t secs, nanoseconds ns);</code>  </pre>
 
   <blockquote>
     <dl>
@@ -4299,9 +4293,7 @@
   </blockquote>
 
   <pre>    <code>
-      time_t seconds_since_epoch() const;
-    </code>
-  </pre>
+      time_t seconds_since_epoch() const;</code>  </pre>
 
   <blockquote>
     <dl>
@@ -4314,8 +4306,7 @@
   </blockquote>
 
   <pre>    <code>
-      nanoseconds nanoseconds_since_epoch() const;
-    </code></pre>
+      nanoseconds nanoseconds_since_epoch() const; </code></pre>
 
 <blockquote>
 <dl>
@@ -4565,15 +4556,18 @@
 
 <dt>Returns:</dt>
 <dd>
-The system time as provided by the operating system.<i> [Note:</i> Provides access to the system clock at a
-resolution up to nanoseconds.
-The actual resolution may vary from platform to platform.<i> --end note]</i></dd>
-
-<dt>Throws:</dt>
+The system time as provided by the operating system.</dd>
+<dd>
+&nbsp;</dd>
 <dd>
-<code>system_error</code>
-([syserr.syserr]) if unable to return the specified value. The conditions for 
-which this might occur are implementation defined.</dd>
+<i>&nbsp;[Note:</i> Provides access to the system clock at a
+resolution as fine as nanoseconds.
+The actual resolution may vary.<i> --end note]</i></dd>
+<blockquote>
+  <dt>[Note: <span style="font-style: normal">No error reporting is provided. 
+  Hosted implementations ([intro.compliance]) presumably utilize system clock 
+  API's that never report errors. </span>--end note.] </dt>
+</blockquote>
 
 </dl>
 </blockquote>