|
|
Boost-Commit : |
From: Lawrence_at_[hidden]
Date: 2007-10-24 16:53:27
Author: crowl
Date: 2007-10-24 16:53:27 EDT (Wed, 24 Oct 2007)
New Revision: 40436
URL: http://svn.boost.org/trac/boost/changeset/40436
Log:
Normalize requirements specification indentation by removing blockquote
in the first part of the document. Correct some requirements lists.
Text files modified:
sandbox/committee/LWG/thread_library.html | 147 +--------------------------------------
1 files changed, 5 insertions(+), 142 deletions(-)
Modified: sandbox/committee/LWG/thread_library.html
==============================================================================
--- sandbox/committee/LWG/thread_library.html (original)
+++ sandbox/committee/LWG/thread_library.html 2007-10-24 16:53:27 EDT (Wed, 24 Oct 2007)
@@ -352,7 +352,6 @@
—<i>end note</i>]
</p>
-<blockquote>
<pre><code>
id();
</code></pre>
@@ -373,9 +372,7 @@
Represents the non-joinable identity.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator==(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
</code></pre>
@@ -393,9 +390,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator!=(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
</code></pre>
@@ -411,9 +406,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator<(const thread::id& x, const thread::id& y);
</code></pre>
@@ -429,9 +422,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator<=(const thread::id& x, const thread::id& y);
</code></pre>
@@ -447,9 +438,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator>(const thread::id& x, const thread::id& y);
</code></pre>
@@ -465,9 +454,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool operator>=(const thread::id& x, const thread::id& y);
</code></pre>
@@ -483,9 +470,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template<class charT, class traits>
basic_ostream<charT, traits>&
@@ -504,11 +489,9 @@
<code>out</code>.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> constructors</h5>
-<blockquote>
<pre><code>
thread();
</code></pre>
@@ -540,9 +523,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class F, class ...Args> explicit thread(F f, Args&&... args);
</code></pre>
@@ -583,9 +564,7 @@
<code>system_error</code> if unable to start the new thread.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
thread(thread&& <i>x</i>);
</code></pre>
@@ -610,11 +589,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> destructor</h5>
-<blockquote>
<pre><code>
~thread();
</code></pre>
@@ -631,11 +608,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> assignment</h5>
-<blockquote>
<pre><code>
thread& operator=(thread&& <i>x</i>);
</code></pre>
@@ -663,11 +638,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> members</h5>
-<blockquote>
<pre><code>
void swap(thread&& <i>x</i>);
</code></pre>
@@ -683,9 +656,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool joinable() const;
</code></pre>
@@ -701,9 +672,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void join();
</code></pre>
@@ -736,9 +705,7 @@
possible error conditions are implementation defined.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void detach();
</code></pre>
@@ -769,9 +736,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
id get_id() const;
</code></pre>
@@ -789,11 +754,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> static members</h5>
-<blockquote>
<pre><code>
unsigned hardware_concurrency();
</code></pre>
@@ -815,11 +778,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h5><code>thread</code> specialized algorithms</h5>
-<blockquote>
<pre><code>
void swap(thread& x, thread& y);
void swap(thread&& x, thread& y);
@@ -832,7 +793,6 @@
<code>x.swap(y)</code>.
</dd>
</dl>
-</blockquote>
@@ -852,7 +812,6 @@
</code></pre>
</blockquote>
-<blockquote>
<pre><code>
thread::id this_thread::get_id();
</code></pre>
@@ -870,9 +829,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void yield();
</code></pre>
@@ -888,9 +845,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Duration>
void sleep(const Duration& rel_t);
@@ -912,11 +867,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h4><code>struct once_flag</code></h4>
-<blockquote>
<p>
Objects of class <code>once_flag</code> are opaque data structures that allow
<code>call_once</code> to initialize data without causing a data race or
@@ -941,12 +894,10 @@
argument that no function has been called.
</dd>
</dl>
-</blockquote>
<h4><code>non-member function call_once</code></h4>
-<blockquote>
<pre><code>
template<class Callable, class Args...>
void call_once(once_flag& flag, Callable func, Args&&... args);
@@ -1025,7 +976,6 @@
</p>
</dd>
</dl>
-</blockquote>
<h3><a name="MutexsLocksWording">Mutexs and locks</a></h3>
@@ -1087,7 +1037,6 @@
nor movable. A mutex type shall have the following member functions:
</p>
-<blockquote>
<pre><code>
void lock();
</code></pre>
@@ -1116,9 +1065,7 @@
This is an acquire operation.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool try_lock();
</code></pre>
@@ -1162,9 +1109,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void unlock();
</code></pre>
@@ -1192,7 +1137,6 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h4>Class mutex</h4>
@@ -1265,7 +1209,6 @@
and to provide the member function <code>timed_lock</code>.
</p>
-<blockquote>
<pre><code>
template <class Duration>
bool timed_lock(const Duration& rel_time);
@@ -1312,7 +1255,6 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h4>Class timed_mutex</h4>
@@ -1459,7 +1401,6 @@
or transferred away from the <code>lock_guard</code>.
</p>
-<blockquote>
<pre><code>
explicit lock_guard(mutex_type& m);
</code></pre>
@@ -1478,9 +1419,7 @@
<b>[Crowl: An acquire specification is not necessary because of m.lock().]</b>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
lock_guard(mutex_type& m, adopt_lock_t);
</code></pre>
@@ -1498,9 +1437,7 @@
Stores a reference to <code><i>m</i></code> and performs no other operation on it.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
~lock_guard();
</code></pre>
@@ -1516,7 +1453,6 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h4>Class unique_lock</h4>
@@ -1575,7 +1511,6 @@
<code>unique_lock</code> is not copyable but is movable.
</p>
-<blockquote>
<pre><code>
unique_lock();
</code></pre>
@@ -1595,9 +1530,7 @@
</code></pre>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
explicit unique_lock(mutex_type& m);
</code></pre>
@@ -1623,9 +1556,7 @@
</code></pre>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
unique_lock(mutex_type& m, defer_lock_t);
</code></pre>
@@ -1652,9 +1583,7 @@
</code></pre>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
unique_lock(mutex_type& m, try_to_lock_t);
</code></pre>
@@ -1681,9 +1610,7 @@
</code></pre>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
unique_lock(mutex_type& m, adopt_lock_t);
</code></pre>
@@ -1709,9 +1636,7 @@
</code></pre>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
~unique_lock();
</code></pre>
@@ -1728,9 +1653,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
unique_lock(unique_lock&& u);
</code></pre>
@@ -1756,9 +1679,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
unique_lock& operator=(unique_lock&& u);
</code></pre>
@@ -1797,9 +1718,7 @@
</p>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void lock();
</code></pre>
@@ -1820,9 +1739,7 @@
<code>lock_error</code>, if on entry <code>owns_lock()</code> is <code>true</code>.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool try_lock();
</code></pre>
@@ -1848,9 +1765,7 @@
<code>lock_error</code>, if on entry <code>owns_lock()</code> is <code>true</code>.<code> </code>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Duration>
bool timed_lock(const Duration& rel_t);
@@ -1879,9 +1794,7 @@
<code>lock_error</code>, if on entry <code>owns_lock()</code> is <code>true</code>.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void unlock();
</code></pre>
@@ -1902,9 +1815,7 @@
<code>lock_error</code>, if on entry <code>owns_lock()</code> is <code>false</code>.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool owns_lock() const;
</code></pre>
@@ -1920,9 +1831,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
operator <var>unspecified-bool-type</var> () const;
</code></pre>
@@ -1938,9 +1847,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
mutex_type* mutex() const;
</code></pre>
@@ -1956,9 +1863,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void swap(unique_lock&& u);
</code></pre>
@@ -1974,9 +1879,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
mutex_type* release();
</code></pre>
@@ -2000,9 +1903,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Mutex> void swap(unique_lock<Mutex>& x, unique_lock<Mutex>& y);
template <class Mutex> void swap(unique_lock<Mutex>&& x, unique_lock<Mutex>& y);
@@ -2020,11 +1921,9 @@
Nothing.
</dd>
</dl>
-</blockquote>
<h3>Generic Locking Algorithms</h3>
-<blockquote>
<pre><code>
template <class L1, class L2, class ...L3> int try_lock(L1&, L2&, L3&...);
</code></pre>
@@ -2065,9 +1964,7 @@
which argument failed to lock.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class L1, class L2, class ...L3> void lock(L1&, L2&, L3&...);
</code></pre>
@@ -2100,7 +1997,6 @@
If an exception is thrown by a call to <code>lock()</code> or <code>try_lock()</code>, there are no effects.
</dd>
</dl>
-</blockquote>
<h3><a name="ConditionVariablesWording">Condition variables</a></h3>
@@ -2158,7 +2054,6 @@
</code></pre>
</blockquote>
-<blockquote>
<pre><code>
condition_variable();
</code></pre>
@@ -2169,9 +2064,7 @@
Constructs an object of class <code>condition_variable</code>.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
~condition_variable();
</code></pre>
@@ -2187,9 +2080,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void notify_one();
</code></pre>
@@ -2217,9 +2108,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void notify_all();
</code></pre>
@@ -2240,9 +2129,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void wait(unique_lock<mutex>& lock);
</code></pre>
@@ -2300,9 +2187,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Predicate>
void wait(unique_lock<mutex>& lock, Predicate pred);
@@ -2322,9 +2207,7 @@
</p>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool timed_wait(unique_lock<mutex>& lock, const system_time& abs_time);
</code></pre>
@@ -2384,9 +2267,7 @@
Too much about other operations here.]</b>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Predicate>
bool timed_wait(unique_lock<mutex>& lock, const system_time& abs_time, Predicate pred);
@@ -2426,7 +2307,6 @@
</p>
</dd>
</dl>
-</blockquote>
<p>
<code>condition_variable</code> shall be a standard-layout class (chapter 9 [class]).
@@ -2478,7 +2358,6 @@
</code></pre>
</blockquote>
-<blockquote>
<pre><code>
condition_variable_any();
</code></pre>
@@ -2489,9 +2368,7 @@
Constructs an object of class <code>condition_variable_any</code>.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
~condition_variable_any();
</code></pre>
@@ -2507,9 +2384,7 @@
Nothing.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void notify_one();
</code></pre>
@@ -2530,9 +2405,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void notify_all();
</code></pre>
@@ -2552,9 +2425,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
void wait(Lock& lock);
</code></pre>
@@ -2599,9 +2470,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class Predicate>
void wait(lock_type& lock, Predicate pred);
@@ -2621,9 +2490,7 @@
</p>
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
bool timed_wait(Lock& lock, const system_time& abs_time);
</code></pre>
@@ -2680,9 +2547,7 @@
races or deadlocks.
</dd>
</dl>
-</blockquote>
-<blockquote>
<pre><code>
template <class _Predicate>
bool timed_wait(Lock& lock, const system_time& abs_time, Predicate pred);
@@ -2722,7 +2587,6 @@
</p>
</dd>
</dl>
-</blockquote>
<hr>
@@ -3396,15 +3260,14 @@
<dl>
<dt>Returns:</dt>
<dd>
-<p>
A duration value equal to this-rhs_duration.
-</p>
+</dd>
-<p>
- <em>Remarks: This will fail to compiler if the
+<dt>Remarks:</dt>
+<dd>
+This will fail to compile if the
RhsDuration is
- of higher resolution.</em>
-</p>
+ of higher resolution.
</dd>
<dt>Throws:</dt>
Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk