|
|
Boost-Commit : |
From: Lawrence_at_[hidden]
Date: 2007-10-22 22:55:25
Author: crowl
Date: 2007-10-22 22:55:25 EDT (Mon, 22 Oct 2007)
New Revision: 40314
URL: http://svn.boost.org/trac/boost/changeset/40314
Log:
Put blockquote tags on separate lines.
Text files modified:
sandbox/committee/LWG/thread_library.html | 293 ++++++++++++++++++++++++++-------------
1 files changed, 195 insertions(+), 98 deletions(-)
Modified: sandbox/committee/LWG/thread_library.html
==============================================================================
--- sandbox/committee/LWG/thread_library.html (original)
+++ sandbox/committee/LWG/thread_library.html 2007-10-22 22:55:25 EDT (Mon, 22 Oct 2007)
@@ -215,7 +215,8 @@
<b><thread> synopsis</b>
</p>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
class thread;
@@ -245,7 +246,8 @@
void call_once(once_flag& flag, Callable func, Args&&... args);
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<h4>Class thread</h4>
@@ -256,7 +258,8 @@
completion of a thread, and to perform other operations to manage and query the state of the thread.
</p>
-<blockquote><pre>class thread
+<blockquote>
+<pre>class thread
{
public:
// <i>types:</i>
@@ -283,7 +286,8 @@
// <i>static members:</i>
static unsigned hardware_concurrency();
};
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
Class <code>thread</code> and class <code>thread::id</code> shall be standard-layout
@@ -318,7 +322,8 @@
[<i>Note:</i> Relational operators allows <code>thread::id</code> objects to be used as keys in associative containers.<i> --end note</i>]
</p>
-<blockquote><pre>id();
+<blockquote>
+<pre>id();
</pre>
<blockquote>
@@ -333,7 +338,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>bool operator==(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
+<blockquote>
+<pre>bool operator==(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
</pre>
<blockquote>
@@ -348,7 +354,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>bool operator!=(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
+<blockquote>
+<pre>bool operator!=(const thread::id& <i>x</i>, const thread::id& <i>y</i>);
</pre>
<blockquote>
@@ -412,7 +419,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>template<class charT, class traits>
+<blockquote>
+<pre>template<class charT, class traits>
basic_ostream<charT, traits>&
operator<< (basic_ostream<charT, traits>&& out, const thread::id& id);
</pre>
@@ -440,7 +448,8 @@
<p>
<i>Postconditions:</i>
</p>
-<blockquote><pre>get_id() == thread::id()
+<blockquote>
+<pre>get_id() == thread::id()
&& joinable() == false
</pre>
<p>
@@ -453,7 +462,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>template <class F, class ...Args> explicit thread(F f, Args&&... args);
+<blockquote>
+<pre>template <class F, class ...Args> explicit thread(F f, Args&&... args);
</pre>
<blockquote>
@@ -474,7 +484,8 @@
<p>
<i>Postconditions:</i>
</p>
-<blockquote><pre>get_id() != thread::id()
+<blockquote>
+<pre>get_id() != thread::id()
&& joinable() == true
</pre>
<p><code>*this</code> represents the newly started thread.</p>
@@ -485,7 +496,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>thread(thread&& <i>x</i>);
+<blockquote>
+<pre>thread(thread&& <i>x</i>);
</pre>
<blockquote>
@@ -506,7 +518,8 @@
</blockquote>
<h5><code>thread</code> destructor</h5>
-<blockquote><pre>~thread();
+<blockquote>
+<pre>~thread();
</pre>
<blockquote>
@@ -521,7 +534,8 @@
</blockquote>
<h5><code>thread</code> assignment</h5>
-<blockquote><pre>thread& operator=(thread&& <i>x</i>);
+<blockquote>
+<pre>thread& operator=(thread&& <i>x</i>);
</pre>
<blockquote>
@@ -545,7 +559,8 @@
</blockquote>
<h5><code>thread</code> members</h5>
-<blockquote><pre>void swap(thread&& <i>x</i>);
+<blockquote>
+<pre>void swap(thread&& <i>x</i>);
</pre>
<blockquote>
@@ -558,7 +573,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>bool joinable() const;
+<blockquote>
+<pre>bool joinable() const;
</pre>
<blockquote>
@@ -571,7 +587,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>void join();
+<blockquote>
+<pre>void join();
</pre>
<blockquote>
@@ -598,7 +615,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>void detach();
+<blockquote>
+<pre>void detach();
</pre>
<blockquote>
@@ -622,7 +640,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>id get_id() const;
+<blockquote>
+<pre>id get_id() const;
</pre>
<blockquote>
@@ -638,7 +657,8 @@
</blockquote>
<h5><code>thread</code> static members</h5>
-<blockquote><pre>unsigned hardware_concurrency();
+<blockquote>
+<pre>unsigned hardware_concurrency();
</pre>
<blockquote>
@@ -671,7 +691,8 @@
<h4>Namespace <code>this_thread</code></h4>
-<blockquote><pre>namespace this_thread
+<blockquote>
+<pre>namespace this_thread
{
thread::id get_id();
@@ -680,9 +701,11 @@
void sleep(const Duration& rel_t);
} // this_thread
-</pre></blockquote>
+</pre>
+</blockquote>
-<blockquote><pre>thread::id this_thread::get_id();
+<blockquote>
+<pre>thread::id this_thread::get_id();
</pre>
<blockquote>
@@ -696,7 +719,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>void yield();
+<blockquote>
+<pre>void yield();
</pre>
<blockquote>
@@ -708,7 +732,8 @@
</blockquote>
</blockquote>
-<blockquote><pre>template <class Duration>
+<blockquote>
+<pre>template <class Duration>
void sleep(const Duration& rel_t);
</pre>
@@ -755,7 +780,7 @@
void call_once(once_flag& flag, Callable func, Args&&... args);
</pre>
- <blockquote>
+<blockquote>
<p><i>Requires:</i> If <code>func</code> is an lvalue, Callable
is
@@ -785,7 +810,8 @@
</p>
<p>[<i>Examples:</i></p>
-<blockquote><pre>std::once_flag flag;
+<blockquote>
+<pre>std::once_flag flag;
void init();
@@ -804,7 +830,8 @@
static std::once_flag flag2;
std::call_once(flag2,initializer());
}
-</pre></blockquote>
+</pre>
+</blockquote>
<p><i>-- end example]</i></p>
</blockquote>
@@ -816,7 +843,8 @@
<b><mutex> synopsis</b>
</p>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
struct mutex;
struct recursive_mutex;
@@ -844,7 +872,8 @@
template <class L1, class L2, class ...L3> void lock(L1&, L2&, L3&...);
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<h3>Mutex concepts</h3>
@@ -947,7 +976,8 @@
<h4>Class mutex</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
struct mutex
{
@@ -967,7 +997,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
The class <code>mutex</code> provides a non-recursive mutex type which satisfies all of the Mutex requirements.
@@ -976,7 +1007,8 @@
<h4>Class recursive_mutex</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
struct recursive_mutex
{
@@ -996,7 +1028,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
The class <code>recursive_mutex</code> provides a recursive mutex type which satisfies all of the Mutex requirements.
@@ -1050,7 +1083,8 @@
<h4>Class timed_mutex</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
struct timed_mutex
{
@@ -1072,7 +1106,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
The class <code>timed_mutex</code> provides a non-recursive mutex type that satisfies all of the Timed Mutex requirements.
@@ -1081,7 +1116,8 @@
<h4>Class recursive_timed_mutex</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
struct recursive_timed_mutex
{
@@ -1103,7 +1139,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
The class <code>recursive_timed_mutex</code> provides a recursive mutex type that satisfies all of the Timed Mutex requirements.
@@ -1124,14 +1161,16 @@
constructor.
</p>
-<blockquote><pre>struct defer_lock_t {};
+<blockquote>
+<pre>struct defer_lock_t {};
struct try_to_lock_t {};
struct adopt_lock_t {};
extern const defer_lock_t defer_lock;
extern const try_to_lock_t try_to_lock;
extern const adopt_lock_t adopt_lock;
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
An exception class <code>lock_error</code> derives from <code>exception</code> and is used to indicate
@@ -1139,17 +1178,20 @@
that the lock does not own.
</p>
-<blockquote><pre>class lock_error
+<blockquote>
+<pre>class lock_error
: public std::exception
{
public:
virtual const char* what() const throw();
};
-</pre></blockquote>
+</pre>
+</blockquote>
<h4>Class lock_guard</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
template <class Mutex>
class lock_guard
@@ -1166,7 +1208,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<code>lock_guard</code> is used to control the ownership of a mutex within a single scope.
@@ -1221,7 +1264,8 @@
<h4>Class unique_lock</h4>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
template <class Mutex>
class unique_lock
@@ -1264,7 +1308,8 @@
template <class Mutex> void swap(unique_lock<Mutex>& x, unique_lock<Mutex>&& y);
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<code>unique_lock</code> is used to control the ownership of a mutex within one or more scopes.
@@ -1283,9 +1328,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == 0
+<blockquote>
+<pre>mutex() == 0
owns_lock() == false
-</pre></blockquote>
+</pre>
+</blockquote>
</blockquote>
</blockquote>
@@ -1304,9 +1351,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == &m
+<blockquote>
+<pre>mutex() == &m
owns_lock() == true
-</pre></blockquote>
+</pre>
+</blockquote>
</blockquote>
</blockquote>
@@ -1326,9 +1375,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == &m
+<blockquote>
+<pre>mutex() == &m
owns_lock() == false
-</pre></blockquote>
+</pre>
+</blockquote>
</blockquote>
</blockquote>
@@ -1348,9 +1399,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == &m
+<blockquote>
+<pre>mutex() == &m
owns_lock() == <i>The result of the call to</i> <i>m</i>.try_lock()
-</pre></blockquote>
+</pre>
+</blockquote>
</blockquote>
</blockquote>
@@ -1369,9 +1422,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == &m
+<blockquote>
+<pre>mutex() == &m
owns_lock() == true
-</pre></blockquote>
+</pre>
+</blockquote>
</blockquote>
</blockquote>
@@ -1399,11 +1454,13 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == <i>The value of</i> u.mutex() <i>prior to the construction</i>.
+<blockquote>
+<pre>mutex() == <i>The value of</i> u.mutex() <i>prior to the construction</i>.
owns_lock() == <i>The value of</i> u.owns_lock() <i>prior to the construction</i>.
u.mutex() == 0
u.owns_lock() == false
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Throws:</i> Nothing.
</p>
@@ -1421,11 +1478,13 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == <i>The value of</i> u.mutex() <i>prior to the construction</i>.
+<blockquote>
+<pre>mutex() == <i>The value of</i> u.mutex() <i>prior to the construction</i>.
owns_lock() == <i>The value of</i> u.owns_lock() <i>prior to the construction</i>.
u.mutex() == 0
u.owns_lock() == false
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Throws:</i> Nothing.
</p>
@@ -1572,9 +1631,11 @@
<p>
<i>Postcondition:</i>
</p>
-<blockquote><pre>mutex() == 0
+<blockquote>
+<pre>mutex() == 0
owns_lock() == false
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Throws:</i> Nothing.
</p>
@@ -1607,9 +1668,11 @@
corresponding to the Mutex concept, except that <code>try_lock</code> is allowed to throw an
exception. <i>[Note:</i> The <code>unique_lock</code> class template meets these requirements
when suitable instantiated. <i>--end note]</i></p>
-<blockquote><pre>bool try_lock();
+<blockquote>
+<pre>bool try_lock();
void unlock();
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Effects:</i> The functions attempts to lock all arguments without blocking by calling <code>try_lock()</code>
on each of them. If any argument can not be locked, then all arguments which have already been locked will
@@ -1633,10 +1696,12 @@
corresponding to the Mutex concept, except that <code>try_lock</code> is allowed to
throw an exception <i>[Note:</i> The <code>unique_lock</code> class template meets these requirements
when suitable instantiated. <i>--end note]</i></p>
-<blockquote><pre>void lock();
+<blockquote>
+<pre>void lock();
bool try_lock();
void unlock();
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Effects:</i> All arguments are locked with an algorithm that avoids deadlock.
If an exception is thrown by a call to <code>lock()</code> or <code>try_lock()</code>, there are no effects.
@@ -1648,13 +1713,15 @@
<p><b><condition_variable> synopsis</b></p>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
class condition_variable;
class condition_variable_any;
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<h4>Class condition_variable</h4>
@@ -1664,7 +1731,8 @@
thread that some condition is met, or a UTC[(?)] time is reached.
</p>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
class condition_variable
{
@@ -1690,7 +1758,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<blockquote>
<pre>condition_variable();
@@ -1852,13 +1921,15 @@
<p>
<i>Effects:</i> As if:
</p>
-<blockquote><pre>while (!pred())
+<blockquote>
+<pre>while (!pred())
{
if (!timed_wait(lock, abs_time))
return pred();
}
return true;
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Returns:</i> <code>pred()</code>.
</p>
@@ -1889,7 +1960,8 @@
meet this requirement.
</p>
-<blockquote><pre>namespace std {
+<blockquote>
+<pre>namespace std {
class condition_variable_any
{
@@ -1916,7 +1988,8 @@
};
} // std
-</pre></blockquote>
+</pre>
+</blockquote>
<blockquote>
<pre>condition_variable_any();
@@ -2078,13 +2151,15 @@
<p>
<i>Effects:</i> As if:
</p>
-<blockquote><pre>while (!pred())
+<blockquote>
+<pre>while (!pred())
{
if (!timed_wait(lock, abs_time))
return pred();
}
return true;
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
<i>Returns:</i> <code>pred()</code>.
</p>
@@ -2118,7 +2193,8 @@
<h3 class="title"><a name="n2411_07_0271___proposal_for_date_time_types_in_c__0x_to_support_threading_apis_v2.proposed_text.header__date_time__synopsis"></a>Header <date_time> Synopsis</h3>
-<blockquote><pre>namespace std
+<blockquote>
+<pre>namespace std
{
//duration types
@@ -2136,7 +2212,8 @@
system_time get_system_time();
} //std
-</pre></blockquote>
+</pre>
+</blockquote>
<h3 class="title"><a name="n2411_07_0271___proposal_for_date_time_types_in_c__0x_to_support_threading_apis_v2.proposed_text.class_utc_time"></a>class system_time</h3>
@@ -2152,7 +2229,8 @@
</p>
-<blockquote><pre>class system_time
+<blockquote>
+<pre>class system_time
{
public:
@@ -2193,7 +2271,8 @@
system_time& operator-=(const Duration& td)
};
-</pre></blockquote>
+</pre>
+</blockquote>
<blockquote class="note">
<p>
@@ -2201,7 +2280,8 @@
<p>
292 years represents the number of nanoseconds that can be represented
in a signed 64 bit integer.
-</p></blockquote>
+</p>
+</blockquote>
<pre class="programlisting"><span class="identifier">system_time</span><span class="special">();</span></pre><p>
<i>Effects:</i> Constructs a system_time
@@ -2336,8 +2416,10 @@
</p>
-<blockquote><pre> system_time get_system_time();
-</pre></blockquote>
+<blockquote>
+<pre> system_time get_system_time();
+</pre>
+</blockquote>
<blockquote class="note">
@@ -2347,7 +2429,8 @@
resolution from calls to the clock. The Boost Date-Time Library has a class that portably implements the proposed
interface, but it uses different C-level interfaces depending on the operating
system.</i>
- </p></blockquote>
+ </p>
+</blockquote>
<h3 class="title"><a name="n2411_07_0271___proposal_for_date_time_types_in_c__0x_to_support_threading_apis_v2.proposed_text.common_duration_functions"></a>Common Duration Functions</h3>
@@ -2365,7 +2448,8 @@
</p>
-<blockquote><pre>class Duration {
+<blockquote>
+<pre>class Duration {
//comparison operators
template<typename RhsDuration>
@@ -2411,7 +2495,8 @@
tick_type get_count() const
}
-</pre></blockquote>
+</pre>
+</blockquote>
<p>
</p><pre class="programlisting"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> <span class="identifier">RhsDuration</span><span class="special">></span>
<span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="keyword">const</span> <span class="identifier">RhsDuration</span><span class="special">&</span> <span class="identifier">rhs</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
@@ -2540,7 +2625,8 @@
Objects of class <code>nanoseconds</code> can be used to represent a count of nanoseconds.
</p>
-<blockquote><pre>class nanoseconds
+<blockquote>
+<pre>class nanoseconds
{
public:
@@ -2557,7 +2643,8 @@
//+ common functions
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">nanoseconds</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
</pre><p>
@@ -2594,7 +2681,8 @@
Objects of class <code>microseconds</code> can be used to represent a count of microseconds.
</p>
-<blockquote><pre>class microseconds
+<blockquote>
+<pre>class microseconds
{
public:
@@ -2615,7 +2703,8 @@
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">microseconds</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
</pre><p>
@@ -2659,7 +2748,8 @@
Objects of class <code>milliseconds</code> can be used to represent a count of milliseconds.
</p>
-<blockquote><pre>class milliseconds
+<blockquote>
+<pre>class milliseconds
{
public:
milliseconds(long long=0);
@@ -2678,7 +2768,8 @@
//+ common functions
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">milliseconds</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
</pre><p>
@@ -2725,7 +2816,8 @@
Objects of class <code>seconds</code> can be used to represent a count of seconds.
</p>
-<blockquote><pre>class seconds
+<blockquote>
+<pre>class seconds
{
public:
seconds(long long s=0);
@@ -2746,7 +2838,8 @@
//+ common functions
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">seconds</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
</pre><p>
@@ -2799,7 +2892,8 @@
Objects of class <code>minutes</code> can be used to represent a count of minutes.
</p>
-<blockquote><pre>class minutes
+<blockquote>
+<pre>class minutes
{
public:
minutes(long long s=0);
@@ -2821,7 +2915,8 @@
//+ common functions
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">minutes</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
</pre><p>
<i>Effects:</i> Construct<span class="underline">s</span> a<span class="underline">n object with a</span> count of minutes - default is
@@ -2876,7 +2971,8 @@
Objects of class <code>hours</code> can be used to represent a count of hours.
</p>
-<blockquote><pre>class hours
+<blockquote>
+<pre>class hours
{
public:
hours(long long s=0);
@@ -2899,7 +2995,8 @@
//+ common functions
};
-</pre></blockquote>
+</pre>
+</blockquote>
<pre class="programlisting"><span class="identifier">hours</span><span class="special">(</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">=</span><span class="number">0</span><span class="special">);</span>
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