|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r63467 - in sandbox/chrono/libs/chrono/doc: . html html/boost_chrono html/boost_chrono/appendices html/boost_chrono/overview html/boost_chrono/reference html/boost_chrono/users_guide
From: vicente.botet_at_[hidden]
Date: 2010-07-02 14:36:01
Author: viboes
Date: 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
New Revision: 63467
URL: http://svn.boost.org/trac/boost/changeset/63467
Log:
Update doc
Text files modified:
sandbox/chrono/libs/chrono/doc/chrono.qbk | 278 +++++++++++++++++++--------------------
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/acknowledgements.html | 8
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/faq.html | 12
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/history.html | 222 +++++++++++++++++++------------
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/perf.html | 4
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/rationale.html | 8
sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/todo.html | 4
sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview.html | 40 ++++-
sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview/motivation.html | 101 +++++++------
sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference.html | 2
sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/cpp0x.html | 200 +++++++++++++++++-----------
sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/other_clocks.html | 2
sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/reporters.html | 4
sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/stopwatches.html | 27 ++-
sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/getting_started.html | 16 +-
sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/tutorial.html | 11
sandbox/chrono/libs/chrono/doc/html/index.html | 4
17 files changed, 536 insertions(+), 407 deletions(-)
Modified: sandbox/chrono/libs/chrono/doc/chrono.qbk
==============================================================================
--- sandbox/chrono/libs/chrono/doc/chrono.qbk (original)
+++ sandbox/chrono/libs/chrono/doc/chrono.qbk 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -26,62 +26,40 @@
[/==================]
[def __Boost_Chrono__ [*Boost.Chrono]]
+
+[def __ratio__ [link boost_chrono.reference.cpp0x.ratio_hpp.ratio `ratio`]]
+
+[/==================]
+[template common_type_link[link_text] [link boost_chrono.reference.cpp0x.common_type_hpp.common_type [link_text]]]
+[def __common_type__ [common_type_link `common_type`]]
+
[/==================]
[template clock_concept_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.clock [link_text]]]
-[/template clock_concept_link[link_text] [link_text]]
[def __clock_concept__ [clock_concept_link `Clock` concept]]
[def __clock_concept_type__ [clock_concept_link `Clock`]]
[def __clock_req__ [clock_concept_link `Clock` requirements]]
[def __Clock__ [clock_concept_link `Clock`]]
-[/==================]
-[template stopwatch_concept_link[link_text] [link boost_chrono.reference.stopwatches.stopwatch_req [link_text]]]
-[/template stopwatch_concept_link[link_text] [link_text]]
-[def __stopwatch_concept__ [stopwatch_concept_link `Stopwatch` concept]]
-[def __stopwatch_concept_type__ [stopwatch_concept_link `Stopwatch`]]
-[def __stopwatch_req__ [stopwatch_concept_link `Stopwatch` requirements]]
-[def __Stopwatch__ [stopwatch_concept_link `Stopwatch`]]
-
-[/==================]
-[template formatter_concept_link[link_text] [link boost_chrono.reference.formatters.formatter_req [link_text]]]
-[/template formatter_concept_link[link_text] [link_text]]
-[def __formatter_concept__ [formatter_concept_link `Formatter` concept]]
-[def __formatter_concept_type__ [formatter_concept_link `Formatter`]]
-[def __formatter_req__ [formatter_concept_link `Formatter` requirements]]
-[def __Formatter__ [formatter_concept_link `Formatter`]]
-
-[/==================]
[template duration_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration [link_text]]]
-[/template duration_link[link_text] [link_text]]
[def __duration__ [duration_link `duration`]]
[def __duration_s__ [duration_link `duration`s]]
[/==================]
-[template common_type_link[link_text] [link boost_chrono.reference.cpp0x.common_type_hpp.common_type [link_text]]]
-[/template common_type_link[link_text] [link_text]]
-[def __common_type__ [common_type_link `common_type`]]
-
-
-[/==================]
[template time_point_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_point [link_text]]]
-[/template time_point_link[link_text] [link_text]]
[def __time_point__ [time_point_link `time_point`]]
[def __time_point_s__ [time_point_link `time_point`s]]
[/==================]
[template system_clock_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.system_clock [link_text]]]
-[/template system_clock_link[link_text] [link_text]]
[def __system_clock__ [system_clock_link `system_clock`]]
[/==================]
[template monotonic_clock_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.monotonic_clock [link_text]]]
-[/template monotonic_clock_link[link_text] [link_text]]
[def __monotonic_clock__ [monotonic_clock_link `monotonic_clock`]]
[/==================]
[template high_resolution_clock_link[link_text] [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.high_resolution_clock [link_text]]]
-[/template high_resolution_clock_link[link_text] [link_text]]
[def __high_resolution_clock__ [high_resolution_clock_link `high_resolution_clock`]]
[/==================]
@@ -99,15 +77,30 @@
[template seconds_link[link_text] [link_text]]
[def __seconds__ [seconds_link `seconds`]]
+[/==================]
+[def __treat_as_floating_point__ [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point `treat_as_floating_point`]]
+[def __duration_values__ [link boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values `duration_values`]]
+
+
+[/==================]
+[template stopwatch_concept_link[link_text] [link boost_chrono.reference.stopwatches.stopwatch_req [link_text]]]
+[def __stopwatch_concept__ [stopwatch_concept_link `Stopwatch` concept]]
+[def __stopwatch_concept_type__ [stopwatch_concept_link `Stopwatch`]]
+[def __stopwatch_req__ [stopwatch_concept_link `Stopwatch` requirements]]
+[def __Stopwatch__ [stopwatch_concept_link `Stopwatch`]]
+
+[/==================]
+[template formatter_concept_link[link_text] [link boost_chrono.reference.reporters.formatter_req [link_text]]]
+[def __formatter_concept__ [formatter_concept_link `Formatter` concept]]
+[def __formatter_concept_type__ [formatter_concept_link `Formatter`]]
+[def __formatter_req__ [formatter_concept_link `Formatter` requirements]]
+[def __Formatter__ [formatter_concept_link `Formatter`]]
+
+[def __stopwatch__ [link boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch `stopwatch`]]
+
-[/
-[section Preface]
-[:[".]]
-[:[*['-- ]]]
-[endsect]
-/]
[warning Chrono is not part of the Boost libraries.]
@@ -115,6 +108,9 @@
[section Overview]
[/===============]
+[:["What is time, then? If nobody asks me, I know; if I have to explain it to someone who has asked me, I do not know.]]
+[:[*['-- Augustine ]]]
+
[/==================]
[heading Description]
[/==================]
@@ -128,14 +124,14 @@
Additionally, a minimal amount of general purpose infrastructure is provided which will support both the interface and implementation of the /clocks/, __time_point_s__ and __duration_s__ proposed herein. It is expected that these general purpose facilities will also find utility in far ranging user applications as well.
* __common_type__ is a facility which is useful in specifying the type of the result of functions and operators which take a variety of types (e.g. "mixed mode" complex arithmetic).
-* ratio is a facility which is useful in specifying compile time rational constants. Compile time rational arithmetic is supported with protection against overflow and divide by zero. Such a facility is very handy when needing to efficiently represent 1/3 of a nanosecond, or specifying an inch in terms of meters (for example 254/10000 meters - which ratio will reduce to 127/5000 meters).
+* __ratio__ is a facility which is useful in specifying compile time rational constants. Compile time rational arithmetic is supported with protection against overflow and divide by zero. Such a facility is very handy when needing to efficiently represent 1/3 of a nanosecond, or specifying an inch in terms of meters (for example 254/10000 meters - which __ratio__ will reduce to 127/5000 meters).
Knowing how long a program takes to execute is useful in both test and production environments. On top of the standard facilities __Boost_Chrono__ includes:
* a Stopwatch middle layer: providing operations to start, stop, suspend or resume a __Stopwatch__ to measure the elapsed time.
* __Stopwatch__ concept
* Scoped helper classes allowing to pairwise start/stop operations, suspend/resume and resume/suspend a __Stopwatch__.
- * `stopwatch`, model of __Stopwatch__ capturing elapsed __Clock__ times.
+ * __stopwatch__, model of __Stopwatch__ capturing elapsed __Clock__ times.
* `stopwatch_accumulator`, model of __Stopwatch__ capturing cummulated elapsed Clock times.
* a Stopclocks higher layer: provide a complete stopclock reporting package that can be invoked in a single line of code.
@@ -201,7 +197,7 @@
In addition to the clocks provided by the standard proposal, __Boost_Chrono__ provides specific process clocks and a thread clock.
-See [@http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2661.htm [*N2661 - A Foundation to Sleep On]] which is very informative and provides motivation for key design decisions for __common_type__, `ratio` and `chrono`. This documentation contains a lot of extracts from this document.
+See [@http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2661.htm [*N2661 - A Foundation to Sleep On]] which is very informative and provides motivation for key design decisions for __common_type__, __ratio__ and `chrono`. This documentation contains a lot of extracts from this document.
[section Common type]
@@ -237,9 +233,9 @@
[section Ratio]
-`ratio` is a general purpose utility inspired by Walter Brown allowing one to easily and safely compute rational values at compile time. The `ratio` class catches all errors (such as divide by zero and overflow) at compile time. It is used in the __duration__ and __time_point__ classes to efficiently create units of time. It can also be used in other "quantity" libraries (both std-defined and user-defined), or anywhere there is a rational constant which is known at compile time. The use of this utility can greatly reduce the chances of run time overflow because the `ratio` (and any ratios resulting from `ratio` arithmetic) are always reduced to lowest terms.
+__ratio__ is a general purpose utility inspired by Walter Brown allowing one to easily and safely compute rational values at compile time. The __ratio__ class catches all errors (such as divide by zero and overflow) at compile time. It is used in the __duration__ and __time_point__ classes to efficiently create units of time. It can also be used in other "quantity" libraries (both std-defined and user-defined), or anywhere there is a rational constant which is known at compile time. The use of this utility can greatly reduce the chances of run time overflow because the __ratio__ (and any ratios resulting from __ratio__ arithmetic) are always reduced to lowest terms.
-`ratio` is a template taking two intmax_ts, with the second defaulted to 1. In addition to copy constructors and assignement, it only has two public members, both of which are static const intmax_t. One is the numerator of the `ratio` and the other is the denominator. The `ratio` is always normalized such that it is expressed in lowest terms, and the denominator is always positive. When the numerator is 0, the denominator is always 1.
+__ratio__ is a template taking two intmax_ts, with the second defaulted to 1. In addition to copy constructors and assignement, it only has two public members, both of which are static const intmax_t. One is the numerator of the __ratio__ and the other is the denominator. The __ratio__ is always normalized such that it is expressed in lowest terms, and the denominator is always positive. When the numerator is 0, the denominator is always 1.
[*Example:]
@@ -278,7 +274,7 @@
The most immediate positive impact is that the library can immediately generate any unit, any precision it needs. This is sometimes necessary when doing comparisons or arithmetic between __duration_s__ of differing precision, assuming one wants the comparison and arithmetic to be exactly correct.
-A secondary benefit is that by publishing the class template __duration__ interface, user code can very easily create __duration_s__ with any precision they desire. The `ratio` utility is used to specify the precision, so as long as the precision can be expressed by a rational constant with respect to seconds, this framework can exactly represent it (one third of a second is no problem, and neither is one third of a `femto` second). All of this utility and flexibility comes at no cost just by making use of the no-run-time-overhead `ratio` facility.
+A secondary benefit is that by publishing the class template __duration__ interface, user code can very easily create __duration_s__ with any precision they desire. The __ratio__ utility is used to specify the precision, so as long as the precision can be expressed by a rational constant with respect to seconds, this framework can exactly represent it (one third of a second is no problem, and neither is one third of a `femto` second). All of this utility and flexibility comes at no cost just by making use of the no-run-time-overhead __ratio__ facility.
In Boost.DateTime, `hours` does not have the same representation as __nanoseconds__. The former is usually represented with a `long` whereas a `long long` is required for the latter. The reason for this is simply range. You don't need many hours to cover an extremely large range of time. But this isn't true of nanoseconds. Being able to reduce the sizeof overhead for some units when possible, can be a significant performance advantage.
@@ -290,7 +286,7 @@
template <class Rep, class Period = ratio<1> > class duration;
-The representation is simply any arithmetic type, or an emulation of such a type. The representation stores a count of ticks. This count is the only data member stored in a __duration__. If the representation is floating point, it can store fractions of a tick to the precision of the representation. The tick period is represented by a `ratio` and is encoded into the __duration__'s type, instead of stored. The tick period only has an impact on the behavior of the __duration__ when a conversion between different __duration__'s is attempted. The tick period is completely ignored when simply doing arithmetic among like __duration_s__.
+The representation is simply any arithmetic type, or an emulation of such a type. The representation stores a count of ticks. This count is the only data member stored in a __duration__. If the representation is floating point, it can store fractions of a tick to the precision of the representation. The tick period is represented by a __ratio__ and is encoded into the __duration__'s type, instead of stored. The tick period only has an impact on the behavior of the __duration__ when a conversion between different __duration__'s is attempted. The tick period is completely ignored when simply doing arithmetic among like __duration_s__.
[*Example:]
@@ -337,7 +333,7 @@
[heading How expensive is all of this?]
-If you were writing these conversions by hand, you could not make it more efficient. The use of `ratio` ensures that all conversion constants are simplified as much as possible at compile time. This usually results in the numerator or denominator of the conversion factor simplifying to `1`, and being subsequently ignored in converting the run time values of the tick counts.
+If you were writing these conversions by hand, you could not make it more efficient. The use of __ratio__ ensures that all conversion constants are simplified as much as possible at compile time. This usually results in the numerator or denominator of the conversion factor simplifying to `1`, and being subsequently ignored in converting the run time values of the tick counts.
[heading How complicated is it to build a function taking a __duration__ parameter?]
@@ -536,7 +532,7 @@
[heading Stopwatches accumulation and statistics]
-The preceding stopwatch manage only with a measure. It is also interesting to have an statisitical view of these times, for example the sum, min, max and mean. `stopwatch_accumulator<>` associates an accumulator with a stopwatch, so we are able to retrieve any statistical feature Boost.Accumulator provides.
+The preceding stopwatch manage only with a measure. It is also interesting to have an statisitical view of these times, for example the sum, min, max and mean. `stopwatch_accumulator<>` associates an accumulator with a __stopwatch__, so we are able to retrieve any statistical feature Boost.Accumulator provides.
For example
@@ -870,7 +866,7 @@
If you're not sure if you need `duration_cast<>` or not, feel free to try it without. If the conversion is exact, or if the destination has a floating point representation, it will compile. Else it will not compile.
-If you would like to programmatically inspect `thread_clock::duration`, you can get the representation type with `thread_clock::rep`, and the tick period with `thread_clock::period` (which should be a type `ratio` which has nested values `ratio::num` and `ratio::den`). The tick period of `thread_clock` is `thread_clock::period::num / thread_clock::period::den` seconds: 1/1000000000 in this case (1 billionth of a second), stored in a long long.
+If you would like to programmatically inspect `thread_clock::duration`, you can get the representation type with `thread_clock::rep`, and the tick period with `thread_clock::period` (which should be a type __ratio__ which has nested values `ratio::num` and `ratio::den`). The tick period of `thread_clock` is `thread_clock::period::num / thread_clock::period::den` seconds: 1/1000000000 in this case (1 billionth of a second), stored in a long long.
If you need to use `duration_cast<>`, but want to round up, instead of down when the conversion is inexact, here is a handy little helper function to do so. Writing it is actually a good starter project for understanding chrono:
@@ -2325,7 +2321,7 @@
[section:ratio_hpp Header `<boost/ratio.hpp>`]
[/===========================================]
-`ratio` is a facility which is useful in specifying compile time rational constants. Compile time rational arithmetic is supported with protection against overflow and divide by zero. Such a facility is very handy when needing to efficiently represent 1/3 of a nanosecond, or specifying an inch in terms of meters (for example 254/10000 meters - which `ratio` will reduce to 127/5000 meters).
+__ratio__ is a facility which is useful in specifying compile time rational constants. Compile time rational arithmetic is supported with protection against overflow and divide by zero. Such a facility is very handy when needing to efficiently represent 1/3 of a nanosecond, or specifying an inch in terms of meters (for example 254/10000 meters - which __ratio__ will reduce to 127/5000 meters).
#define BOOST_RATIO_USES_STATIC_ASSERT
#define BOOST_RATIO_USES_MPL_ASSERT
@@ -2431,7 +2427,7 @@
operator=(const ratio<_N2, _D2>&) {return *this;}
};
-A diagnostic will be emitted if `ratio` is instantiated with `D == 0`, or if the absolute value of `N` or `D` can not be represented. [*Note:] These rules ensure that infinite ratios are avoided and that for any negative input, there exists a representable value of its absolute value which is positive. In a two's complement representation, this excludes the most negative value.
+A diagnostic will be emitted if __ratio__ is instantiated with `D == 0`, or if the absolute value of `N` or `D` can not be represented. [*Note:] These rules ensure that infinite ratios are avoided and that for any negative input, there exists a representable value of its absolute value which is positive. In a two's complement representation, this excludes the most negative value.
Let `gcd` denote the greatest common divisor of `N`'s absolute value and of `D`'s absolute value.
@@ -2441,21 +2437,21 @@
The nested typedef `type` denotes the normalized form of this ratio type. It should be used when the template parameters doesn't give a normalized form.
-Two `ratio` classes `ratio<N1,D1>` and `ratio<N2,D2>` have the same normalized form if `ratio<N1,D1>::type` is the same type as `ratio<N2,D2>::type`
+Two __ratio__ classes `ratio<N1,D1>` and `ratio<N2,D2>` have the same normalized form if `ratio<N1,D1>::type` is the same type as `ratio<N2,D2>::type`
[section Construction and assignment]
template <intmax_t N2, intmax_t D2>
ratio(const ratio<N2, D2>& r);
-[*Effects:] Constructs a `ratio` object.
+[*Effects:] Constructs a __ratio__ object.
[*Remarks:] This constructor will not participate in overload resolution unless `r` has the same normalized form as `*this`.
template <intmax_t N2, intmax_t D2>
ratio& operator=(const ratio<N2, D2>& r);
-[*Effects:] Assigns a `ratio` object.
+[*Effects:] Assigns a __ratio__ object.
[*Returns:] *this.
@@ -2467,9 +2463,9 @@
[endsect]
-[section:ratio_arithmetic `ratio` arithmetic]
+[section:ratio_arithmetic __ratio__ arithmetic]
-For each of the class templates in this clause, each template parameter refers to a `ratio`. If the implementation is unable to form the indicated `ratio` due to overflow, a diagnostic will be issued.
+For each of the class templates in this clause, each template parameter refers to a `ratio`. If the implementation is unable to form the indicated __ratio__ due to overflow, a diagnostic will be issued.
template <class R1, class R2> struct ratio_add {
typedef [/see below] type;
@@ -2497,7 +2493,7 @@
[endsect]
-[section:ratio_comparison `ratio` comparison]
+[section:ratio_comparison __ratio__ comparison]
template <class R1, class R2> struct ratio_equal
: public boost::integral_constant<bool, [/see below] > {};
@@ -2561,7 +2557,7 @@
[section:chrono_hpp Header `<boost/chrono.hpp>`]
[/=============================================]
-This file is a redirection to `boost/chrono/chrono.hpp` including in addition registration for `duration<>` and `timepoint<>` class templates to Boost.Typeof.
+This file is a redirection to `boost/chrono/chrono.hpp` including in addition registration for __duration__ and __timepoint__ class templates to Boost.Typeof.
#include <boost/chrono/chrono.hpp>
@@ -2757,23 +2753,23 @@
Models of Clock:
-* [@boost_chrono/reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.class__system_clock_ system_clock]
-* [@boost_chrono/reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.class__monotonic_clock_ monotonic_clock]
-* [@boost_chrono/reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.class__high_resolution_clock_ high_resolution_clock]
-* [@boost_chrono/reference/other_clocks.html#boost_chrono.reference.other_clocks.process_cpu_clocks_hpp.class__process_real_cpu_clock_ process_real_cpu_clock]
-* [@boost_chrono/reference/other_clocks.html#boost_chrono.reference.other_clocks.process_cpu_clocks_hpp.class__process_user_cpu_clock_ process_user_cpu_clock]
-* [@boost_chrono/reference/other_clocks.html#boost_chrono.reference.other_clocks.process_cpu_clocks_hpp.class__process_system_cpu_clock_ process_system_cpu_clock]
-* [@boost_chrono/reference/other_clocks.html#boost_chrono.reference.other_clocks.thread_clock_hpp.class__thread_clock_ thread_clock]
+* __system_clock__
+* __monotonic_clock__
+* __high_resolution_clock__
+* __process_real_cpu_clock__
+* __process_user_cpu_clock__
+* __process_system_cpu_clock__
+* __thread_clock__
[endsect]
-[section Time-related traits]
+[section:traits Time-related traits]
[section:treat_as_floating_point Metafunction `treat_as_floating_point<>`]
template <class Rep> struct treat_as_floating_point
: boost::is_floating_point<Rep> {};
-The __duration__ template uses the `treat_as_floating_point` trait to help determine if a __duration__ with one tick period can be converted to another __duration__ with a different tick period. If `treat_as_floating_point<Rep>::value` is `true`, then `Rep` is a floating point type and implicit conversions are allowed among __duration_s__. Otherwise, the implicit convertibility depends on the tick periods of the __duration_s__. If `Rep` is a class type which emulates a floating point type, the author of `Rep` can specialize `treat_as_floating_point` so that __duration__ will treat this `Rep` as if it were a floating point type. Otherwise `Rep` is assumed to be an integral type, or a class emulating an integral type.
+The __duration__ template uses the __treat_as_floating_point__ trait to help determine if a __duration__ with one tick period can be converted to another __duration__ with a different tick period. If `treat_as_floating_point<Rep>::value` is `true`, then `Rep` is a floating point type and implicit conversions are allowed among __duration_s__. Otherwise, the implicit convertibility depends on the tick periods of the __duration_s__. If `Rep` is a class type which emulates a floating point type, the author of `Rep` can specialize __treat_as_floating_point__ so that __duration__ will treat this `Rep` as if it were a floating point type. Otherwise `Rep` is assumed to be an integral type, or a class emulating an integral type.
[endsect]
@@ -2788,7 +2784,7 @@
static BOOST_CHRONO_CONSTEXPR Rep min();
};
-The __duration__ template uses the `duration_values` trait to construct special values of the __duration_s__ representation (`Rep`). This is done because the representation might be a class type with behavior which requires some other implementation to return these special values. In that case, the author of that class type should specialize `duration_values` to return the indicated values.
+The __duration__ template uses the __duration_values__ trait to construct special values of the __duration_s__ representation (`Rep`). This is done because the representation might be a class type with behavior which requires some other implementation to return these special values. In that case, the author of that class type should specialize `duration_values` to return the indicated values.
[section:zero Static member Function `zero()`]
@@ -2828,7 +2824,7 @@
typedef chrono::duration<typename common_type<Rep1, Rep2>::type, see below> type;
};
-The period of the __duration__ indicated by this specialization of __common_type__ is the greatest common divisor of `Period1` and `Period2`. This can be computed by forming a `ratio` of the greatest common divisor of `Period1::num` and `Period2::num`, and the least common multiple of `Period1::den` and `Period2::den`.
+The period of the __duration__ indicated by this specialization of __common_type__ is the greatest common divisor of `Period1` and `Period2`. This can be computed by forming a __ratio__ of the greatest common divisor of `Period1::num` and `Period2::num`, and the least common multiple of `Period1::den` and `Period2::den`.
[*Note:] The typedef type is the __duration__ with the largest tick period possible where both __duration__ arguments will convert to it without requiring a division operation. The representation of this type is intended to be able to hold any value resulting from this conversion, with the possible exception of round-off error when floating point __duration_s__ are involved (but not truncation error).
@@ -2907,19 +2903,19 @@
}}
-Rep must be an arithmetic type, or a class emulating an arithmetic type, compile diagnostic otherwise. If __duration__ is instantiated with the type of `Rep` being a __duration__, compile diagnostic is issued.
+`Rep` must be an arithmetic type, or a class emulating an arithmetic type, compile diagnostic otherwise. If __duration__ is instantiated with the type of `Rep` being a __duration__, compile diagnostic is issued.
-Period must be an instantiation of `ratio`, compile diagnostic otherwise.
+`Period` must be an instantiation of `ratio`, compile diagnostic otherwise.
-Period::num must be positive, compile diagnostic otherwise.
+`Period::num` must be positive, compile diagnostic otherwise.
Examples:
- duration<long, ratio<60> > holds a count of minutes using a long.
+* `duration<long, ratio<60> >` holds a count of minutes using a long.
- duration<long long, milli> holds a count of milliseconds using a long long.
+* `duration<long long, milli>` holds a count of milliseconds using a long long.
- duration<double, ratio<1, 30> > holds a count using a double with a tick period of 1/30 second (a tick frequency of 30 Hz).
+* `duration<double, ratio<1, 30> >` holds a count using a double with a tick period of 1/30 second (a tick frequency of 30 Hz).
The following members of __duration__ do not throw an exception unless the indicated operations on the representations throw an exception.
@@ -2933,7 +2929,7 @@
* `treat_as_floating_point<rep>::value` is `true`, or
* `!treat_as_floating_point<rep>::value && !treat_as_floating_point<Rep2>::value` is `true`.
-If these constraints are not met, this constructor shall not participate in overload resolution. [*Note:] This requirement prevents construction of an integral-based __duration__ with a floating point representation. Such a construction could easily lead to confusion about the value of the __duration__.
+If these constraints are not met, this constructor will not participate in overload resolution. [*Note:] This requirement prevents construction of an integral-based __duration__ with a floating point representation. Such a construction could easily lead to confusion about the value of the __duration__.
[*Example:]
@@ -2950,7 +2946,7 @@
template <class Rep2, class Period2>
BOOST_CHRONO_CONSTEXPR duration(const duration<Rep2, Period2>& d);
-[*Remarks:] `treat_as_floating_point<rep>::value`, or `ratio_divide<Period2, period>::type::den == 1`, else this constructor shall not participate in overload resolution. [*note] This requirement prevents implicit truncation error when converting between integral-based __duration_s__. Such a construction could easily lead to confusion about the value of the __duration__.
+[*Remarks:] `treat_as_floating_point<rep>::value`, or `ratio_divide<Period2, period>::type::den == 1`, else this constructor will not participate in overload resolution. [*note] This requirement prevents implicit truncation error when converting between integral-based __duration_s__. Such a construction could easily lead to confusion about the value of the __duration__.
[*Example:]
@@ -3173,7 +3169,7 @@
duration<typename common_type<Rep1, Rep2>::type, Period>
operator%(const duration<Rep1, Period>& d, const Rep2& s);
-[*Remarks] This function will not participate in overload resolution unless Rep2 shall be implicitly convertible to CR(Rep1, Rep2) and Rep2 shall not be an instantiation of duration.
+[*Remarks] This function will not participate in overload resolution unless Rep2 must be implicitly convertible to CR(Rep1, Rep2) and Rep2 must not be an instantiation of duration.
[*Returns:] duration<CR(Rep1,Rep2), Period>(d) %= s.
[endsect]
@@ -3249,7 +3245,7 @@
[*Requires:] This function will not participate in overload resolution unless `ToDuration` is an instantiation of __duration__.
-[*Returns:] Forms `CF` which is a `ratio` resulting from `ratio_divide<Period, typename ToDuration::period>::type`. Let `CR` be the __common_type__ of `ToDuration::rep`, `Rep`, and `intmax_t`.
+[*Returns:] Forms `CF` which is a __ratio__ resulting from `ratio_divide<Period, typename ToDuration::period>::type`. Let `CR` be the __common_type__ of `ToDuration::rep`, `Rep`, and `intmax_t`.
* If `CF::num == 1` and `CF::den == 1`, then returns `ToDuration(static_cast<typename ToDuration::rep>(d.count())) `
* else if `CF::num != 1` and `CF::den == 1`, then returns
@@ -3914,7 +3910,7 @@
[/==================================================]
-[section Stopwatches]
+[section:stopwatches Stopwatches]
[/==================================================]
[/=============================================]
[section:stopwatches_hpp Header `<boost/stopwatches.hpp>`]
@@ -4027,7 +4023,7 @@
Models of `Stopwatch`:
-* [@boost_chrono/reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.template_class__stopwatch___ `stopwatch`]
+* __stopwatch__
* [@boost_chrono/reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_accumulator_hpp.template_class__stopwatch_accumulator___ `stopwatch_accumulator`]
[endsect]
@@ -4067,7 +4063,7 @@
`stopwatch<>` is a model of a __stopwatch_concept__.
Knowing how long a part of a program takes to execute is useful in both test and production environments.
-A `stopwatch` object measures elapsed time. It is recommended to use it with clocks that measure wall clock rather than CPU time since the intended use is performance measurement on systems where total elapsed time is more important than just process or CPU time.
+A __stopwatch__ object measures elapsed time. It is recommended to use it with clocks that measure wall clock rather than CPU time since the intended use is performance measurement on systems where total elapsed time is more important than just process or CPU time.
The maximum measurable elapsed time depends on the Clock parameter. The accuracy of timings depends on the
accuracy of timing information provided the Clock, and this coudl varies a great deal from one clock to another.
@@ -4113,7 +4109,7 @@
[endsect]
-[section:stopwatch_typedefs `stopwatch` useful typedefs]
+[section:stopwatch_typedefs __stopwatch__ useful typedefs]
typedef boost::chrono::stopwatch< boost::chrono::system_clock > system_stopwatch;
#ifdef BOOST_CHRONO_HAS_CLOCK_MONOTONIC
@@ -5603,7 +5599,7 @@
[*Bug Fixes]
-* Valgrind fixes: Conditional jump or move depends on uninitialised value(s)
+* Valgrind fixes: "Conditional jump or move depends on uninitialised value(s)"
[endsect]
@@ -5612,8 +5608,8 @@
[*Bug Fixes]
-* scoped_suspend warning removal
-* error_code management completed
+* `scoped_suspend` warning removal
+* `error_code` management completed
[endsect]
@@ -5627,7 +5623,7 @@
[section [*Version 0.4.2, June 18, 2010] ['Packaging fixe]]
-* Conversion library, used by Boost.Thread porting to Boost.Chrono was not packaged.
+* Boost.Conversion library, used by Boost.Thread porting to Boost.Chrono was not packaged.
[endsect]
@@ -5635,8 +5631,8 @@
[*New Features:]
-* Added thread clock implementation on Windows
-* Added Boost.Thread using Boost.Chrono
+* Added `thread_clock` implementation on Windows.
+* Added *Boost.Thread* using *Boost.Chrono*.
[endsect]
@@ -5644,11 +5640,11 @@
[*New Features:]
-* Suspendible Clock concept + template class suspendible_clock<>
-* Added scope_suspend which do suspend/resume if the Clock is a model of Suspendible Clock concept, and nothing otherwise.
-* thread_clock support on platforms providing it natively.
-* Added support for wide character for stopwatch_reporter, stopclock, and stopclock_accumulator.
-* digital_time renamed t24_hours
+* __SuspendibleClock__ concept + template class `suspendible_clock<>`.
+* Added `scope_suspend` which do `suspend`/`resume` if the __Clock__ is a model of __SuspendibleClock__ concept, and nothing otherwise.
+* `thread_clock` support on platforms providing it natively.
+* Added support for wide character for `stopwatch_reporter`, `stopclock`, and `stopclock_accumulator`.
+* `digital_time` renamed `t24_hours`.
[*Perf]
@@ -5675,13 +5671,13 @@
[section [*Version 0.3.2, January 25, 2010] ['New frequency, lifetime and percentage stopwatch_accumulator features]]
[*Features:]
-* Added overloading for operator/(Integer/Duration)
-* Added frequency, lifetime and percentage to the default stopwatch_accumulator_formatter
+* Added overloading for `operator/(Integer/Duration)`
+* Added frequency, lifetime and percentage to the default `stopwatch_accumulator_formatter`.
[*Bug Fixes]
-* Specific formatters didn't work completly
-* Replace duration(0) by duration::zero() on template classes.
-* suspend doesn't works: partial_ not initialized neither taken in account by the elapsed function.
+* Specific formatters didn't work completly.
+* Replace `duration(0)` by `duration::zero()` on template classes.
+* `suspend` doesn't works: `partial_` not initialized neither taken in account by the elapsed function.
[endsect]
@@ -5689,7 +5685,7 @@
[*Features:]
* Support for wide characters on formatters and stopclocks
-* added chrono.hpp and stopwatches.hpp at the boost level
+* added `chrono.hpp` and `stopwatches.hpp` at the boost level
[endsect]
@@ -5699,29 +5695,29 @@
* Added independent process cpu clocks for real, user, system process CPU time
* Added global process cpu clock for real, user, system process CPU time
-* Added digital_time (looking for a better name)
-* Added new *Stopwatch* concept measuring elapsed time between different points in time associated to the operations start, stop, suspend and resume.
-* Added stopwatch is a model Stopwatch measuring the elapsed time between the start and the stop operations.
-* Added stopwatch_accumulator is a model Stopwatch allowing to accumulate several time samples and give the average, ...
-* Added scoped helper classes allowing to pairwise start/stop operations, suspend/resume and resume/suspend a Stopwatch.
-* Added new stopwatch *Formatter* concept
+* Added `digital_time` (looking for a better name)
+* Added new __Stopwatch__ concept measuring elapsed time between different points in time associated to the operations `start`, `stop`, `suspend` and `resume`.
+* Added __stopwatch__ is a model __Stopwatch__ measuring the elapsed time between the `start` and the `stop` operations.
+* Added `stopwatch_accumulator` is a model __Stopwatch__ allowing to accumulate several time samples and gives the average, ...
+* Added scoped helper classes allowing to pairwise `start`/`stop` operations, `suspend`/`resume` and `resume`/`suspend` a __Stopwatch__.
+* Added new stopwatch __Formatter__ concept
* Added stopwatch formatter "%ds\\n"
* Added stopwatch accumulator formatter "%c times, sum=%ss, min=%ms, max=%Ms, mean=%as\\n"
* Added time formatter "real %rs, cpu %cs (%p%), user %us, system %ss\\n"
* Added digital_time formatter "%d days(s) %h:%m:%s.%n\\n"
-* stopwatch_reporter is a convenient generic class reporting elapsed time for the Stopwatch concept.
-* Added stopclock<Clock> shortcut stopwatch_reporter<stopwatch<Clcok>>
-* Added scoped_stopclock which
-* Added typeof registration for classes __duration__ and __time_point__
-
-* The old classes process_times, process_clock, process_timer, timer and run_timer are deprecated as the preceding additions are more generic. However for backward compatibility they preserved until inclusion of the library in Boost. Next follows the equivalences:
- * timer<> ~ stopwatch<>
- * process_timer ~ stopwatch<process_cpu_clock>
- * run_timer ~ stopclock<>
+* `stopwatch_reporter` is a convenient generic class reporting elapsed time for the Stopwatch concept.
+* Added `stopclock<Clock>` shortcut `stopwatch_reporter<stopwatch<Clock>>`
+* Added `scoped_stopclock` which
+* Added `typeof` registration for classes __duration__ and __time_point__
+
+* The old classes `process_times`, `process_clock`, `process_timer`, `timer` and `run_timer` are deprecated as the preceding additions are more generic. However for backward compatibility they preserved until inclusion of the library in Boost. Next follows the equivalences:
+ * `timer<>` ~ `stopwatch<>`
+ * `process_timer` ~ `stopwatch<process_cpu_clock>`
+ * `run_timer` ~ `stopclock<>`
[*Bug Fixes]
-* Try to correct warning C4251: 'boost::chrono::run_timer::m_format' : class 'std::basic_string<_Elem,_Traits,_Ax>' needs to have dll-interface to be used by clients of class 'boost::chrono::run_timer', by don't including inlines functions using the std::string m_format.
+* Try to correct warning "C4251: 'boost::chrono::run_timer::m_format' : class 'std::basic_string<_Elem,_Traits,_Ax>' needs to have dll-interface to be used by clients of class 'boost::chrono::run_timer'", by don't including inlines functions using the std::string `m_format`.
[endsect]
@@ -5729,23 +5725,23 @@
[*Bug Fixes]
-* Replace INTMAX_C by BOOST_INTMAX_C until boost/cstdint;hpp ensures INTMAX_C is always defined.
-* Define BOOST_CHRONO_HAS_CLOCK_MONOTONIC when BOOST_CHRONO_WINDOWS_API
+* Replace `INTMAX_C` by `BOOST_INTMAX_C` until `boost/cstdint.hpp` ensures `INTMAX_C` is always defined.
+* Define `BOOST_CHRONO_HAS_CLOCK_MONOTONIC` when `BOOST_CHRONO_WINDOWS_API`
* Commenting invalid operator declarations
-* Take care of Boost min/max recommendations
-* complete qualification when defining nested typedef duration on clocks to avoid the following compile error:
+* Take care of Boost `min`/`max` recommendations
+* Complete qualification when defining nested typedef duration on clocks to avoid the following compile error:
./boost/chrono/chrono.hpp:945: error: declaration of 'typedef class boost::chrono::duration<long long int, boost::ratio<1ll, 10000000ll> > boost::chrono::system_clock::duration'
./boost/chrono/chrono.hpp:458: error: changes meaning of 'duration' from 'class boost::chrono::duration<long long int, boost::ratio<1ll, 10000000ll> >'
* cleanup of simulated...
-* warning removal on posix/process_clock.cpp
-* disable VC++ foolishness
-* Update Jamfiles to manage with dll
-* removal of conversion warning in test_duration
-* manage with MSVC reporting a warning instead of an error when there is an integral constant overflow
-* Use STATIC_ASSERT specific macro to solve the compile failing issue
-* Qualify with boost::detail boost::chrono::detail to avoid ambiguities with MSVC
+* warning removal on `posix/process_clock.cpp`.
+* disable VC++ foolishness.
+* Update Jamfiles to manage with dll.
+* removal of conversion warning in test_duration.
+* manage with MSVC reporting a warning instead of an error when there is an integral constant overflow.
+* Use `STATIC_ASSERT` specific macro to solve the compile failing issue.
+* Qualify with `boost::detail` `boost::chrono::detail` to avoid ambiguities with MSVC.
[*Documentation:]
@@ -5758,22 +5754,22 @@
[*Features:]
-* Added ratio construction and assignment from an equivalent ratio ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281 [*LWG 1281. CopyConstruction and Assignment between ratios having the same normalized form]])
-* Added nested ratio typedef type ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281 [*LWG 1281. CopyConstruction and Assignment between ratios having the same normalized form]])
-* Added BOOST_CHRONO_HAS_CLOCK_MONOTONIC macro to state if monotonic_clock is provided on this platform.
-* Added duration operator% ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-defects.html#934 [*LGW 934. duration is missing operator%]])
-* Added BOOST_CHRONO_CONSTEXPR when constexpr should be used
-* Complete duration operator* and operator/
+* Added __ratio__ construction and assignment from an equivalent __ratio__ ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281 [*LWG 1281. CopyConstruction and Assignment between ratios having the same normalized form]])
+* Added nested __ratio__ typedef type ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281 [*LWG 1281. CopyConstruction and Assignment between ratios having the same normalized form]])
+* Added `BOOST_CHRONO_HAS_CLOCK_MONOTONIC` macro to state if `monotonic_clock` is provided on this platform.
+* Added __duration__ `operator%` ([@http://home.roadrunner.com/~hinnant/issue_review/lwg-defects.html#934 [*LGW 934. duration is missing operator%]])
+* Added BOOST_CHRONO_CONSTEXPR when constexpr should be used.
+* Complete __duration__ `operator*` and `operator/`.
[*Implementation:]
-* Use INTMAC_C to name intmax_t constants instead of LL.
-* Separate chrono.cpp on # files win/chrono.cpp, mac/chrono.cpp and posix/chrono.cpp to make easier the maintenance on different platforms.
-* Separate process_clock.cpp on # files win/process_clock.cpp, mac/process_clock.cpp and posix/process_clock.cpp to make easir the maintenace on different platforms.
-* Added the error_code prototype for monotonic_clock::now for mac/chrono.cpp
-* Fully implement mac/chrono.cpp with error handling.
-* Take care on POSIX systems when CLOCK_MONOTONIC is not defined.
+* Use `INTMAC_C` to name `intmax_t` constants instead of `LL`.
+* Separate `chrono.cpp` on # files `win/chrono.cpp`, `mac/chrono.cpp` and `posix/chrono.cpp` to make easier the maintenance on different platforms.
+* Separate `process_clock.cpp` on # files `win/process_clock.cpp`, `mac/process_clock.cpp` and `posix/process_clock.cpp` to make easier the maintenace on different platforms.
+* Added the `error_code` prototype for `monotonic_clock::now` for `mac/chrono.cpp`.
+* Fully implement `mac/chrono.cpp` with error handling.
+* Take care on POSIX systems when `CLOCK_MONOTONIC` is not defined.
[*Documentation:]
@@ -5781,10 +5777,10 @@
[*Bug Fixes]
-* operator/ was ambiguous: Disambiguate duration operator/
-* CLOCK_MONOTONIC is not defined with cygwin/gcc 3.4: Disable code when BOOST_CHRONO_HAS_CLOCK_MONOTONIC is not defined.
-* result of metafunctions ratio_multiply and ratio_divide were not normalized ratios: Use of the nested ratio typedef type on ratio arithmetic operations.
-* Copy constructor from similar duration masked the defaulted operations: Added duration defaulted implementations
+* `operator/` was ambiguous: Disambiguate duration `operator/`.
+* `CLOCK_MONOTONIC` is not defined with cygwin/gcc 3.4: Disable code when `BOOST_CHRONO_HAS_CLOCK_MONOTONIC` is not defined.
+* result of metafunctions `ratio_multiply` and `ratio_divide` were not normalized ratios: Use of the nested __ratio__ typedef type on __ratio__ arithmetic operations.
+* Copy constructor from similar __duration__ masked the defaulted operations: Added duration defaulted implementations
[endsect]
@@ -5966,11 +5962,11 @@
Much thanks to Andrei Alexandrescu, Walter Brown, Peter Dimov, Jeff Garland, Terry Golubiewski, Daniel Krugler, Anthony Williams.
-Beman Dawes added the `timer<>`, `process_clock`, `process_timer`, `run_timer` classes which are now deprecated and replaced by the `stopwatch`, `process_cpu_clock` and `stopclock` classes.
+Beman Dawes added the `timer<>`, `process_clock`, `process_timer`, `run_timer` classes which are now deprecated and replaced by the __stopwatch__, `process_cpu_clock` and `stopclock` classes.
Thanks to Adrew Chinoff for its multiple suggestion on `stopwatch_accumulator`, and helping me to polish the documentation.
-Thanks to Tom Tan for reporting some compiler issues with MSVC V10 beta and MinGW-gcc-4.4.0 and for the many suggestion he did concerning the new `stopwatch`, `process_cpu_clock`and `stopclock` classes and a deep help with wide characters implementation.
+Thanks to Tom Tan for reporting some compiler issues with MSVC V10 beta and MinGW-gcc-4.4.0 and for the many suggestion he did concerning the new __stopwatch__, `process_cpu_clock`and `stopclock` classes and a deep help with wide characters implementation.
Thanks to Ronald Bock for reporting Valgind issues and for the many suggestion he did concerning the documentation.
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/acknowledgements.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/acknowledgements.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/acknowledgements.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -44,8 +44,9 @@
<p>
Beman Dawes added the <code class="computeroutput"><span class="identifier">timer</span><span class="special"><></span></code>, <code class="computeroutput"><span class="identifier">process_clock</span></code>,
<code class="computeroutput"><span class="identifier">process_timer</span></code>, <code class="computeroutput"><span class="identifier">run_timer</span></code> classes which are now deprecated
- and replaced by the <code class="computeroutput"><span class="identifier">stopwatch</span></code>,
- <code class="computeroutput"><span class="identifier">process_cpu_clock</span></code> and <code class="computeroutput"><span class="identifier">stopclock</span></code> classes.
+ and replaced by the <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a>, <code class="computeroutput"><span class="identifier">process_cpu_clock</span></code>
+ and <code class="computeroutput"><span class="identifier">stopclock</span></code> classes.
</p>
<p>
Thanks to Adrew Chinoff for its multiple suggestion on <code class="computeroutput"><span class="identifier">stopwatch_accumulator</span></code>,
@@ -53,7 +54,8 @@
</p>
<p>
Thanks to Tom Tan for reporting some compiler issues with MSVC V10 beta and
- MinGW-gcc-4.4.0 and for the many suggestion he did concerning the new <code class="computeroutput"><span class="identifier">stopwatch</span></code>, <code class="computeroutput"><span class="identifier">process_cpu_clock</span></code>and
+ MinGW-gcc-4.4.0 and for the many suggestion he did concerning the new <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a>, <code class="computeroutput"><span class="identifier">process_cpu_clock</span></code>and
<code class="computeroutput"><span class="identifier">stopclock</span></code> classes and a deep
help with wide characters implementation.
</p>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/faq.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/faq.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/faq.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -29,7 +29,7 @@
<a name="boost_chrono.appendices.faq"></a> Appendix D: FAQ
</h3></div></div></div>
<a name="boost_chrono.appendices.faq.how_important_is_the_order_of_the_common_type_lt__gt__template_arguments_"></a><h4>
-<a name="id4938420"></a>
+<a name="id4939967"></a>
<a href="faq.html#boost_chrono.appendices.faq.how_important_is_the_order_of_the_common_type_lt__gt__template_arguments_">How
important is the order of the common_type<> template arguments?</a>
</h4>
@@ -60,7 +60,7 @@
is also undefined.
</p>
<a name="boost_chrono.appendices.faq.why_does_stopwatch_reporter_only_display_millisecond_place_precision_when_the_underlying_clock_has_nanosecond_precision_"></a><h4>
-<a name="id4938830"></a>
+<a name="id4940377"></a>
<a href="faq.html#boost_chrono.appendices.faq.why_does_stopwatch_reporter_only_display_millisecond_place_precision_when_the_underlying_clock_has_nanosecond_precision_">Why
does stopwatch_reporter only display millisecond place precision when the
underlying Clock has nanosecond precision?</a>
@@ -71,7 +71,7 @@
dangerously.
</p>
<a name="boost_chrono.appendices.faq.why_does_stopwatch_reporter_sometimes_report_more_cpu_seconds_than_real_seconds_"></a><h4>
-<a name="id4938872"></a>
+<a name="id4940418"></a>
<a href="faq.html#boost_chrono.appendices.faq.why_does_stopwatch_reporter_sometimes_report_more_cpu_seconds_than_real_seconds_">Why
does stopwatch_reporter sometimes report more cpu seconds than real seconds?</a>
</h4>
@@ -81,7 +81,7 @@
be reporting at times.
</p>
<a name="boost_chrono.appendices.faq.can_i_obtain_statistics_of_the_time_elapsed_between_calls_to_a_function_"></a><h4>
-<a name="id4938905"></a>
+<a name="id4940452"></a>
<a href="faq.html#boost_chrono.appendices.faq.can_i_obtain_statistics_of_the_time_elapsed_between_calls_to_a_function_">Can
I obtain statistics of the time elapsed between calls to a function?</a>
</h4>
@@ -89,13 +89,13 @@
The library do not provides this feature.
</p>
<a name="boost_chrono.appendices.faq.what_happens_if_i_press_ctrl_c_and_program_terminates__what_log_would_boost_chrono_output_"></a><h4>
-<a name="id4938934"></a>
+<a name="id4940480"></a>
<a href="faq.html#boost_chrono.appendices.faq.what_happens_if_i_press_ctrl_c_and_program_terminates__what_log_would_boost_chrono_output_">What
happens if I press Ctrl+C and program terminates? What log would Boost.chrono
output?</a>
</h4>
<a name="boost_chrono.appendices.faq.can_you_explain_the_pros_cons_of_common_type_against_boost_typeof_"></a><h4>
-<a name="id4938963"></a>
+<a name="id4940510"></a>
<a href="faq.html#boost_chrono.appendices.faq.can_you_explain_the_pros_cons_of_common_type_against_boost_typeof_">Can
you explain the pros/cons of common_type against Boost.Typeof?</a>
</h4>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/history.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/history.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/history.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -89,7 +89,8 @@
<span class="bold"><strong>Bug Fixes</strong></span>
</p>
<div class="itemizedlist"><ul type="disc"><li>
- Valgrind fixes: Conditional jump or move depends on uninitialised value(s)
+ Valgrind fixes: "Conditional jump or move depends on uninitialised
+ value(s)"
</li></ul></div>
</div>
<div class="section" lang="en">
@@ -103,10 +104,12 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- scoped_suspend warning removal
+<code class="computeroutput"><span class="identifier">scoped_suspend</span></code> warning
+ removal
</li>
<li>
- error_code management completed
+<code class="computeroutput"><span class="identifier">error_code</span></code> management
+ completed
</li>
</ul></div>
</div>
@@ -128,8 +131,8 @@
<a name="boost_chrono.appendices.history.__version_0_4_2__june_18__2010____packaging_fixe_"></a>Version 0.4.2, June 18, 2010 Packaging fixe
</h4></div></div></div>
<div class="itemizedlist"><ul type="disc"><li>
- Conversion library, used by Boost.Thread porting to Boost.Chrono was
- not packaged.
+ Boost.Conversion library, used by Boost.Thread porting to Boost.Chrono
+ was not packaged.
</li></ul></div>
</div>
<div class="section" lang="en">
@@ -143,10 +146,11 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Added thread clock implementation on Windows
+ Added <code class="computeroutput"><span class="identifier">thread_clock</span></code> implementation
+ on Windows.
</li>
<li>
- Added Boost.Thread using Boost.Chrono
+ Added <span class="bold"><strong>Boost.Thread</strong></span> using <span class="bold"><strong>Boost.Chrono</strong></span>.
</li>
</ul></div>
</div>
@@ -161,21 +165,25 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Suspendible Clock concept + template class suspendible_clock<>
+<span class="underline">_SuspendibleClock</span>_ concept + template
+ class <code class="computeroutput"><span class="identifier">suspendible_clock</span><span class="special"><></span></code>.
</li>
<li>
- Added scope_suspend which do suspend/resume if the Clock is a model of
- Suspendible Clock concept, and nothing otherwise.
+ Added <code class="computeroutput"><span class="identifier">scope_suspend</span></code> which
+ do <code class="computeroutput"><span class="identifier">suspend</span></code>/<code class="computeroutput"><span class="identifier">resume</span></code> if the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.clock" title="
+ Clock Requirements"><code class="computeroutput"><span class="identifier">Clock</span></code></a> is a model of <span class="underline">_SuspendibleClock</span>_ concept, and nothing otherwise.
</li>
<li>
- thread_clock support on platforms providing it natively.
+<code class="computeroutput"><span class="identifier">thread_clock</span></code> support
+ on platforms providing it natively.
</li>
<li>
- Added support for wide character for stopwatch_reporter, stopclock, and
- stopclock_accumulator.
+ Added support for wide character for <code class="computeroutput"><span class="identifier">stopwatch_reporter</span></code>,
+ <code class="computeroutput"><span class="identifier">stopclock</span></code>, and <code class="computeroutput"><span class="identifier">stopclock_accumulator</span></code>.
</li>
<li>
- digital_time renamed t24_hours
+<code class="computeroutput"><span class="identifier">digital_time</span></code> renamed
+ <code class="computeroutput"><span class="identifier">t24_hours</span></code>.
</li>
</ul></div>
<p>
@@ -219,17 +227,19 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Added overloading for operator/(Integer/Duration)
- </li>
+ Added overloading for <code class="computeroutput"><span class="keyword">operator</span><span class="special">/(</span><span class="identifier">Integer</span><span class="special">/</span><span class="identifier">Duration</span><span class="special">)</span></code>
+</li>
<li>
- Added frequency, lifetime and percentage to the default stopwatch_accumulator_formatter
+ Added frequency, lifetime and percentage to the default <code class="computeroutput"><span class="identifier">stopwatch_accumulator_formatter</span></code>.
</li>
</ul></div>
<p>
<span class="bold"><strong>Bug Fixes</strong></span> * Specific formatters didn't
- work completly * Replace duration(0) by duration::zero() on template classes.
- * suspend doesn't works: partial_ not initialized neither taken in account
- by the elapsed function.
+ work completly. * Replace <code class="computeroutput"><span class="identifier">duration</span><span class="special">(</span><span class="number">0</span><span class="special">)</span></code>
+ by <code class="computeroutput"><span class="identifier">duration</span><span class="special">::</span><span class="identifier">zero</span><span class="special">()</span></code>
+ on template classes. * <code class="computeroutput"><span class="identifier">suspend</span></code>
+ doesn't works: <code class="computeroutput"><span class="identifier">partial_</span></code>
+ not initialized neither taken in account by the elapsed function.
</p>
</div>
<div class="section" lang="en">
@@ -246,7 +256,8 @@
Support for wide characters on formatters and stopclocks
</li>
<li>
- added chrono.hpp and stopwatches.hpp at the boost level
+ added <code class="computeroutput"><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">hpp</span></code> and <code class="computeroutput"><span class="identifier">stopwatches</span><span class="special">.</span><span class="identifier">hpp</span></code>
+ at the boost level
</li>
</ul></div>
</div>
@@ -268,27 +279,37 @@
Added global process cpu clock for real, user, system process CPU time
</li>
<li>
- Added digital_time (looking for a better name)
+ Added <code class="computeroutput"><span class="identifier">digital_time</span></code> (looking
+ for a better name)
</li>
<li>
- Added new <span class="bold"><strong>Stopwatch</strong></span> concept measuring
+ Added new <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
+ Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a> concept measuring
elapsed time between different points in time associated to the operations
- start, stop, suspend and resume.
+ <code class="computeroutput"><span class="identifier">start</span></code>, <code class="computeroutput"><span class="identifier">stop</span></code>, <code class="computeroutput"><span class="identifier">suspend</span></code>
+ and <code class="computeroutput"><span class="identifier">resume</span></code>.
</li>
<li>
- Added stopwatch is a model Stopwatch measuring the elapsed time between
- the start and the stop operations.
+ Added <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a> is a model <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
+ Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a> measuring the elapsed
+ time between the <code class="computeroutput"><span class="identifier">start</span></code>
+ and the <code class="computeroutput"><span class="identifier">stop</span></code> operations.
</li>
<li>
- Added stopwatch_accumulator is a model Stopwatch allowing to accumulate
- several time samples and give the average, ...
+ Added <code class="computeroutput"><span class="identifier">stopwatch_accumulator</span></code>
+ is a model <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
+ Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a> allowing to accumulate
+ several time samples and gives the average, ...
</li>
<li>
- Added scoped helper classes allowing to pairwise start/stop operations,
- suspend/resume and resume/suspend a Stopwatch.
+ Added scoped helper classes allowing to pairwise <code class="computeroutput"><span class="identifier">start</span></code><span class="emphasis"><em>`stop`
+ operations, `suspend`</em></span><code class="computeroutput"><span class="identifier">resume</span></code>
+ and <code class="computeroutput"><span class="identifier">resume</span></code>/<code class="computeroutput"><span class="identifier">suspend</span></code> a <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
+ Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a>.
</li>
<li>
- Added new stopwatch <span class="bold"><strong>Formatter</strong></span> concept
+ Added new stopwatch Formatter concept
<div class="itemizedlist"><ul type="circle">
<li>
Added stopwatch formatter "%ds\n"
@@ -307,35 +328,42 @@
</ul></div>
</li>
<li>
- stopwatch_reporter is a convenient generic class reporting elapsed time
- for the Stopwatch concept.
+<code class="computeroutput"><span class="identifier">stopwatch_reporter</span></code> is
+ a convenient generic class reporting elapsed time for the Stopwatch concept.
</li>
<li>
- Added stopclock<Clock> shortcut stopwatch_reporter<stopwatch<Clcok>>
- </li>
+ Added <code class="computeroutput"><span class="identifier">stopclock</span><span class="special"><</span><span class="identifier">Clock</span><span class="special">></span></code>
+ shortcut <code class="computeroutput"><span class="identifier">stopwatch_reporter</span><span class="special"><</span><span class="identifier">stopwatch</span><span class="special"><</span><span class="identifier">Clock</span><span class="special">>></span></code>
+</li>
<li>
- Added scoped_stopclock which
+ Added <code class="computeroutput"><span class="identifier">scoped_stopclock</span></code>
+ which
</li>
<li>
- Added typeof registration for classes <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ Added <code class="computeroutput"><span class="identifier">typeof</span></code> registration
+ for classes <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_point" title="
Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a>
</li>
<li>
- The old classes process_times, process_clock, process_timer, timer and
- run_timer are deprecated as the preceding additions are more generic.
- However for backward compatibility they preserved until inclusion of
- the library in Boost. Next follows the equivalences:
+ The old classes <code class="computeroutput"><span class="identifier">process_times</span></code>,
+ <code class="computeroutput"><span class="identifier">process_clock</span></code>, <code class="computeroutput"><span class="identifier">process_timer</span></code>, <code class="computeroutput"><span class="identifier">timer</span></code>
+ and <code class="computeroutput"><span class="identifier">run_timer</span></code> are deprecated
+ as the preceding additions are more generic. However for backward compatibility
+ they preserved until inclusion of the library in Boost. Next follows
+ the equivalences:
<div class="itemizedlist"><ul type="circle">
<li>
- timer<> ~ stopwatch<>
- </li>
+<code class="computeroutput"><span class="identifier">timer</span><span class="special"><></span></code>
+ ~ <code class="computeroutput"><span class="identifier">stopwatch</span><span class="special"><></span></code>
+</li>
<li>
- process_timer ~ stopwatch<process_cpu_clock>
- </li>
+<code class="computeroutput"><span class="identifier">process_timer</span></code> ~
+ <code class="computeroutput"><span class="identifier">stopwatch</span><span class="special"><</span><span class="identifier">process_cpu_clock</span><span class="special">></span></code>
+</li>
<li>
- run_timer ~ stopclock<>
- </li>
+<code class="computeroutput"><span class="identifier">run_timer</span></code> ~ <code class="computeroutput"><span class="identifier">stopclock</span><span class="special"><></span></code>
+</li>
</ul></div>
</li>
</ul></div>
@@ -343,10 +371,10 @@
<span class="bold"><strong>Bug Fixes</strong></span>
</p>
<div class="itemizedlist"><ul type="disc"><li>
- Try to correct warning C4251: 'boost::chrono::run_timer::m_format' :
- class 'std::basic_string<_Elem,_Traits,_Ax>' needs to have dll-interface
- to be used by clients of class 'boost::chrono::run_timer', by don't including
- inlines functions using the std::string m_format.
+ Try to correct warning "C4251: 'boost::chrono::run_timer::m_format'
+ : class 'std::basic_string<_Elem,_Traits,_Ax>' needs to have dll-interface
+ to be used by clients of class 'boost::chrono::run_timer'", by don't
+ including inlines functions using the std::string <code class="computeroutput"><span class="identifier">m_format</span></code>.
</li></ul></div>
</div>
<div class="section" lang="en">
@@ -358,20 +386,23 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Replace INTMAX_C by BOOST_INTMAX_C until boost/cstdint;hpp ensures INTMAX_C
+ Replace <code class="computeroutput"><span class="identifier">INTMAX_C</span></code> by
+ <code class="computeroutput"><span class="identifier">BOOST_INTMAX_C</span></code> until
+ <code class="computeroutput"><span class="identifier">boost</span><span class="special">/</span><span class="identifier">cstdint</span><span class="special">.</span><span class="identifier">hpp</span></code> ensures <code class="computeroutput"><span class="identifier">INTMAX_C</span></code>
is always defined.
</li>
<li>
- Define BOOST_CHRONO_HAS_CLOCK_MONOTONIC when BOOST_CHRONO_WINDOWS_API
- </li>
+ Define <code class="computeroutput"><span class="identifier">BOOST_CHRONO_HAS_CLOCK_MONOTONIC</span></code>
+ when <code class="computeroutput"><span class="identifier">BOOST_CHRONO_WINDOWS_API</span></code>
+</li>
<li>
Commenting invalid operator declarations
</li>
<li>
- Take care of Boost min/max recommendations
+ Take care of Boost <code class="computeroutput"><span class="identifier">min</span></code>/<code class="computeroutput"><span class="identifier">max</span></code> recommendations
</li>
<li>
- complete qualification when defining nested typedef duration on clocks
+ Complete qualification when defining nested typedef duration on clocks
to avoid the following compile error:
</li>
</ul></div>
@@ -383,27 +414,28 @@
cleanup of simulated...
</li>
<li>
- warning removal on posix/process_clock.cpp
+ warning removal on <code class="computeroutput"><span class="identifier">posix</span><span class="special">/</span><span class="identifier">process_clock</span><span class="special">.</span><span class="identifier">cpp</span></code>.
</li>
<li>
- disable VC++ foolishness
+ disable VC++ foolishness.
</li>
<li>
- Update Jamfiles to manage with dll
+ Update Jamfiles to manage with dll.
</li>
<li>
- removal of conversion warning in test_duration
+ removal of conversion warning in test_duration.
</li>
<li>
manage with MSVC reporting a warning instead of an error when there is
- an integral constant overflow
+ an integral constant overflow.
</li>
<li>
- Use STATIC_ASSERT specific macro to solve the compile failing issue
+ Use <code class="computeroutput"><span class="identifier">STATIC_ASSERT</span></code> specific
+ macro to solve the compile failing issue.
</li>
<li>
- Qualify with boost::detail boost::chrono::detail to avoid ambiguities
- with MSVC
+ Qualify with <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">detail</span></code><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">chrono</span><span class="special">::</span><span class="identifier">detail</span></code>
+ to avoid ambiguities with MSVC.
</li>
</ul></div>
<p>
@@ -424,25 +456,32 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Added ratio construction and assignment from an equivalent ratio (<a href="http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281" target="_top"><span class="bold"><strong>LWG 1281. CopyConstruction and Assignment between ratios
+ Added <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> construction and assignment
+ from an equivalent <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> (<a href="http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281" target="_top"><span class="bold"><strong>LWG 1281. CopyConstruction and Assignment between ratios
having the same normalized form</strong></span></a>)
</li>
<li>
- Added nested ratio typedef type (<a href="http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281" target="_top"><span class="bold"><strong>LWG 1281. CopyConstruction and Assignment between ratios
+ Added nested <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> typedef type (<a href="http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#1281" target="_top"><span class="bold"><strong>LWG 1281. CopyConstruction and Assignment between ratios
having the same normalized form</strong></span></a>)
</li>
<li>
- Added BOOST_CHRONO_HAS_CLOCK_MONOTONIC macro to state if monotonic_clock
+ Added <code class="computeroutput"><span class="identifier">BOOST_CHRONO_HAS_CLOCK_MONOTONIC</span></code>
+ macro to state if <code class="computeroutput"><span class="identifier">monotonic_clock</span></code>
is provided on this platform.
</li>
<li>
- Added duration operator% (LGW 934. duration is missing operator%)
+ Added <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a><code class="computeroutput"><span class="keyword">operator</span><span class="special">%</span></code> (LGW 934. duration is missing operator%)
</li>
<li>
- Added BOOST_CHRONO_CONSTEXPR when constexpr should be used
+ Added BOOST_CHRONO_CONSTEXPR when constexpr should be used.
</li>
<li>
- Complete duration operator* and operator/
+ Complete <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a><code class="computeroutput"><span class="keyword">operator</span><span class="special">*</span></code> and <code class="computeroutput"><span class="keyword">operator</span><span class="special">/</span></code>.
</li>
</ul></div>
<p>
@@ -450,25 +489,32 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Use INTMAC_C to name intmax_t constants instead of LL.
+ Use <code class="computeroutput"><span class="identifier">INTMAC_C</span></code> to name
+ <code class="computeroutput"><span class="identifier">intmax_t</span></code> constants instead
+ of <code class="computeroutput"><span class="identifier">LL</span></code>.
</li>
<li>
- Separate chrono.cpp on # files win/chrono.cpp, mac/chrono.cpp and posix/chrono.cpp
+ Separate <code class="computeroutput"><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code> on # files <code class="computeroutput"><span class="identifier">win</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code>,
+ <code class="computeroutput"><span class="identifier">mac</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code> and <code class="computeroutput"><span class="identifier">posix</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code>
to make easier the maintenance on different platforms.
</li>
<li>
- Separate process_clock.cpp on # files win/process_clock.cpp, mac/process_clock.cpp
- and posix/process_clock.cpp to make easir the maintenace on different
- platforms.
+ Separate <code class="computeroutput"><span class="identifier">process_clock</span><span class="special">.</span><span class="identifier">cpp</span></code>
+ on # files <code class="computeroutput"><span class="identifier">win</span><span class="special">/</span><span class="identifier">process_clock</span><span class="special">.</span><span class="identifier">cpp</span></code>, <code class="computeroutput"><span class="identifier">mac</span><span class="special">/</span><span class="identifier">process_clock</span><span class="special">.</span><span class="identifier">cpp</span></code>
+ and <code class="computeroutput"><span class="identifier">posix</span><span class="special">/</span><span class="identifier">process_clock</span><span class="special">.</span><span class="identifier">cpp</span></code> to make easier the maintenace on
+ different platforms.
</li>
<li>
- Added the error_code prototype for monotonic_clock::now for mac/chrono.cpp
+ Added the <code class="computeroutput"><span class="identifier">error_code</span></code>
+ prototype for <code class="computeroutput"><span class="identifier">monotonic_clock</span><span class="special">::</span><span class="identifier">now</span></code>
+ for <code class="computeroutput"><span class="identifier">mac</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code>.
</li>
<li>
- Fully implement mac/chrono.cpp with error handling.
+ Fully implement <code class="computeroutput"><span class="identifier">mac</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">cpp</span></code> with error handling.
</li>
<li>
- Take care on POSIX systems when CLOCK_MONOTONIC is not defined.
+ Take care on POSIX systems when <code class="computeroutput"><span class="identifier">CLOCK_MONOTONIC</span></code>
+ is not defined.
</li>
</ul></div>
<p>
@@ -482,19 +528,25 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- operator/ was ambiguous: Disambiguate duration operator/
+<code class="computeroutput"><span class="keyword">operator</span><span class="special">/</span></code>
+ was ambiguous: Disambiguate duration <code class="computeroutput"><span class="keyword">operator</span><span class="special">/</span></code>.
</li>
<li>
- CLOCK_MONOTONIC is not defined with cygwin/gcc 3.4: Disable code when
- BOOST_CHRONO_HAS_CLOCK_MONOTONIC is not defined.
+<code class="computeroutput"><span class="identifier">CLOCK_MONOTONIC</span></code> is not
+ defined with cygwin/gcc 3.4: Disable code when <code class="computeroutput"><span class="identifier">BOOST_CHRONO_HAS_CLOCK_MONOTONIC</span></code>
+ is not defined.
</li>
<li>
- result of metafunctions ratio_multiply and ratio_divide were not normalized
- ratios: Use of the nested ratio typedef type on ratio arithmetic operations.
+ result of metafunctions <code class="computeroutput"><span class="identifier">ratio_multiply</span></code>
+ and <code class="computeroutput"><span class="identifier">ratio_divide</span></code> were
+ not normalized ratios: Use of the nested <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> typedef type on <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> arithmetic operations.
</li>
<li>
- Copy constructor from similar duration masked the defaulted operations:
- Added duration defaulted implementations
+ Copy constructor from similar <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> masked the defaulted
+ operations: Added duration defaulted implementations
</li>
</ul></div>
</div>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/perf.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/perf.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/perf.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -69,7 +69,7 @@
with a variable lifetime.
</p>
<a name="boost_chrono.appendices.perf.single_threaded_recursive_function"></a><h4>
-<a name="id4942600"></a>
+<a name="id4944295"></a>
<a href="perf.html#boost_chrono.appendices.perf.single_threaded_recursive_function">Single-Threaded
Recursive function</a>
</h4>
@@ -92,7 +92,7 @@
and thread_clock.
</p>
<a name="boost_chrono.appendices.perf.multi_threaded_recursive_function"></a><h4>
-<a name="id4942650"></a>
+<a name="id4944345"></a>
<a href="perf.html#boost_chrono.appendices.perf.multi_threaded_recursive_function">Multi-Threaded
Recursive function</a>
</h4>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/rationale.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/rationale.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/rationale.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -33,7 +33,7 @@
are an extract from this document.
</p>
<a name="boost_chrono.appendices.rationale.is_it_possible_for_the_user_to_pass_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__to_a_function_with_the_units_being_ambiguous_"></a><h4>
-<a name="id4937195"></a>
+<a name="id4938742"></a>
<a href="rationale.html#boost_chrono.appendices.rationale.is_it_possible_for_the_user_to_pass_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__to_a_function_with_the_units_being_ambiguous_">Is
it possible for the user to pass a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> to a function with the
@@ -46,7 +46,7 @@
<pre class="programlisting"><span class="identifier">f</span><span class="special">(</span><span class="number">3</span><span class="special">);</span> <span class="comment">// Will not compile, 3 is not implicitly convertible to any __duration__
</span></pre>
<a name="boost_chrono.appendices.rationale.why_duration_needs_operator_"></a><h4>
-<a name="id4937294"></a>
+<a name="id4938841"></a>
<a href="rationale.html#boost_chrono.appendices.rationale.why_duration_needs_operator_">Why
duration needs operator%</a>
</h4>
@@ -74,7 +74,7 @@
<span class="special">};</span>
</pre>
<a name="boost_chrono.appendices.rationale.why_ratio_needs_copyconstruction_and_assignment_from_ratios_having_the_same_normalized_form"></a><h4>
-<a name="id4937874"></a>
+<a name="id4939421"></a>
<a href="rationale.html#boost_chrono.appendices.rationale.why_ratio_needs_copyconstruction_and_assignment_from_ratios_having_the_same_normalized_form">Why
ratio needs CopyConstruction and Assignment from ratios having the same normalized
form</a>
@@ -102,7 +102,7 @@
ratio<1,3> and the compilation succeeds.
</p>
<a name="boost_chrono.appendices.rationale.why_ratio_needs_the_nested_normalizer_typedef_type"></a><h4>
-<a name="id4938187"></a>
+<a name="id4939734"></a>
<a href="rationale.html#boost_chrono.appendices.rationale.why_ratio_needs_the_nested_normalizer_typedef_type">Why
ratio needs the nested normalizer typedef type</a>
</h4>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/todo.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/todo.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/appendices/todo.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -26,7 +26,7 @@
<a name="boost_chrono.appendices.todo"></a> Appendix I: Future plans
</h3></div></div></div>
<a name="boost_chrono.appendices.todo.tasks_to_do_before_review"></a><h4>
-<a name="id4942716"></a>
+<a name="id4944411"></a>
<a href="todo.html#boost_chrono.appendices.todo.tasks_to_do_before_review">Tasks
to do before review</a>
</h4>
@@ -42,7 +42,7 @@
</li>
</ul></div>
<a name="boost_chrono.appendices.todo.for_later_releases"></a><h4>
-<a name="id4942755"></a>
+<a name="id4944450"></a>
<a href="todo.html#boost_chrono.appendices.todo.for_later_releases">For later
releases</a>
</h4>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -39,8 +39,27 @@
</dl></dd>
<dt><span class="section"> Caveat emptor</span></dt>
</dl></div>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+ </p>
+<p>
+ “<span class="quote">What is time, then? If nobody asks me, I know; if I have to explain
+ it to someone who has asked me, I do not know.</span>”
+ </p>
+<p>
+ </p>
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+<p>
+ </p>
+<p>
+ <span class="bold"><strong><span class="emphasis"><em>-- Augustine </em></span></strong></span>
+ </p>
+<p>
+ </p>
+</blockquote></div>
<a name="boost_chrono.overview.description"></a><h3>
-<a name="id4765019"></a>
+<a name="id4765050"></a>
<a href="overview.html#boost_chrono.overview.description">Description</a>
</h3>
<p>
@@ -95,11 +114,14 @@
which take a variety of types (e.g. "mixed mode" complex arithmetic).
</li>
<li>
- ratio is a facility which is useful in specifying compile time rational constants.
- Compile time rational arithmetic is supported with protection against overflow
- and divide by zero. Such a facility is very handy when needing to efficiently
- represent 1/3 of a nanosecond, or specifying an inch in terms of meters (for
- example 254/10000 meters - which ratio will reduce to 127/5000 meters).
+<a href="reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is a facility which is useful
+ in specifying compile time rational constants. Compile time rational arithmetic
+ is supported with protection against overflow and divide by zero. Such a
+ facility is very handy when needing to efficiently represent 1/3 of a nanosecond,
+ or specifying an inch in terms of meters (for example 254/10000 meters -
+ which <a href="reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> will reduce to 127/5000 meters).
</li>
</ul></div>
<p>
@@ -124,8 +146,8 @@
Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a>.
</li>
<li>
-<code class="computeroutput"><span class="identifier">stopwatch</span></code>, model of
- <a href="reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
+<a href="reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a>, model of <a href="reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_req" title="
Stopwatch Requirements"><code class="computeroutput"><span class="identifier">Stopwatch</span></code></a> capturing elapsed
<a href="reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.clock" title="
Clock Requirements"><code class="computeroutput"><span class="identifier">Clock</span></code></a> times.
@@ -194,7 +216,7 @@
on C++03 compilers.
</p>
<a name="boost_chrono.overview.how_to_use_this_documentation"></a><h3>
-<a name="id4803869"></a>
+<a name="id4803950"></a>
<a href="overview.html#boost_chrono.overview.how_to_use_this_documentation">How to
Use This Documentation</a>
</h3>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview/motivation.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview/motivation.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/overview/motivation.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -62,9 +62,9 @@
<p>
See N2661 - A Foundation to Sleep On which is
very informative and provides motivation for key design decisions for <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.common_type_hpp.common_type" title="
- Class Template 'common_type<>'"><code class="computeroutput"><span class="identifier">common_type</span></code></a>, <code class="computeroutput"><span class="identifier">ratio</span></code>
- and <code class="computeroutput"><span class="identifier">chrono</span></code>. This documentation
- contains a lot of extracts from this document.
+ Class Template 'common_type<>'"><code class="computeroutput"><span class="identifier">common_type</span></code></a>, <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> and <code class="computeroutput"><span class="identifier">chrono</span></code>.
+ This documentation contains a lot of extracts from this document.
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
@@ -132,29 +132,35 @@
<a name="boost_chrono.overview.motivation.ratio"></a>Ratio
</h4></div></div></div>
<p>
- <code class="computeroutput"><span class="identifier">ratio</span></code> is a general purpose
- utility inspired by Walter Brown allowing one to easily and safely compute
- rational values at compile time. The <code class="computeroutput"><span class="identifier">ratio</span></code>
- class catches all errors (such as divide by zero and overflow) at compile
- time. It is used in the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is a general purpose utility
+ inspired by Walter Brown allowing one to easily and safely compute rational
+ values at compile time. The <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> class catches all errors
+ (such as divide by zero and overflow) at compile time. It is used in the
+ <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_point" title="
Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a> classes to efficiently
create units of time. It can also be used in other "quantity"
libraries (both std-defined and user-defined), or anywhere there is a rational
constant which is known at compile time. The use of this utility can greatly
- reduce the chances of run time overflow because the <code class="computeroutput"><span class="identifier">ratio</span></code>
- (and any ratios resulting from <code class="computeroutput"><span class="identifier">ratio</span></code>
- arithmetic) are always reduced to lowest terms.
+ reduce the chances of run time overflow because the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> (and any ratios resulting
+ from <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> arithmetic) are always reduced
+ to lowest terms.
</p>
<p>
- <code class="computeroutput"><span class="identifier">ratio</span></code> is a template taking
- two intmax_ts, with the second defaulted to 1. In addition to copy constructors
+ <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is a template taking two
+ intmax_ts, with the second defaulted to 1. In addition to copy constructors
and assignement, it only has two public members, both of which are static
- const intmax_t. One is the numerator of the <code class="computeroutput"><span class="identifier">ratio</span></code>
- and the other is the denominator. The <code class="computeroutput"><span class="identifier">ratio</span></code>
- is always normalized such that it is expressed in lowest terms, and the
- denominator is always positive. When the numerator is 0, the denominator
- is always 1.
+ const intmax_t. One is the numerator of the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> and the other is the denominator.
+ The <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is always normalized such
+ that it is expressed in lowest terms, and the denominator is always positive.
+ When the numerator is 0, the denominator is always 1.
</p>
<p>
<span class="bold"><strong>Example:</strong></span>
@@ -244,14 +250,15 @@
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> interface, user code
can very easily create <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code>s</a> with any precision they
- desire. The <code class="computeroutput"><span class="identifier">ratio</span></code> utility
- is used to specify the precision, so as long as the precision can be expressed
- by a rational constant with respect to seconds, this framework can exactly
- represent it (one third of a second is no problem, and neither is one third
- of a <code class="computeroutput"><span class="identifier">femto</span></code> second). All
- of this utility and flexibility comes at no cost just by making use of
- the no-run-time-overhead <code class="computeroutput"><span class="identifier">ratio</span></code>
- facility.
+ desire. The <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> utility is used to specify
+ the precision, so as long as the precision can be expressed by a rational
+ constant with respect to seconds, this framework can exactly represent
+ it (one third of a second is no problem, and neither is one third of a
+ <code class="computeroutput"><span class="identifier">femto</span></code> second). All of this
+ utility and flexibility comes at no cost just by making use of the no-run-time-overhead
+ <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> facility.
</p>
<p>
In Boost.DateTime, <code class="computeroutput"><span class="identifier">hours</span></code>
@@ -275,7 +282,7 @@
needs only 23 bits to cover that range.
</p>
<a name="boost_chrono.overview.motivation.duration.so_what_exactly_is_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__and_how_do_i_use_one_"></a><h5>
-<a name="id4760075"></a>
+<a name="id4813230"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.so_what_exactly_is_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__and_how_do_i_use_one_">So
What Exactly is a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and How Do I Use One?</a>
@@ -293,8 +300,9 @@
data member stored in a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a>. If the representation
is floating point, it can store fractions of a tick to the precision of
- the representation. The tick period is represented by a <code class="computeroutput"><span class="identifier">ratio</span></code>
- and is encoded into the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ the representation. The tick period is represented by a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> and is encoded into the
+ <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a>'s type, instead of stored.
The tick period only has an impact on the behavior of the <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> when a conversion between
@@ -338,7 +346,7 @@
templates instead of inheritance).
</p>
<a name="boost_chrono.overview.motivation.duration.what_happens_if_i_assign__code__phrase_role__identifier__m3__phrase___phrase_role__special_____phrase___phrase_role__identifier__us3__phrase___code__to___code__phrase_role__identifier__minutes__phrase___code__instead_of__code__phrase_role__identifier__microseconds__phrase___code__"></a><h5>
-<a name="id4813827"></a>
+<a name="id4813946"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.what_happens_if_i_assign__code__phrase_role__identifier__m3__phrase___phrase_role__special_____phrase___phrase_role__identifier__us3__phrase___code__to___code__phrase_role__identifier__minutes__phrase___code__instead_of__code__phrase_role__identifier__microseconds__phrase___code__">What
happens if I assign <code class="computeroutput"><span class="identifier">m3</span> <span class="special">+</span> <span class="identifier">us3</span></code>
to <code class="computeroutput"><span class="identifier">minutes</span></code> instead of
@@ -355,7 +363,7 @@
ignored. This is similar to the problem of assigning a double to an <code class="computeroutput"><span class="keyword">int</span></code>: the fractional part gets silently discarded.
</p>
<a name="boost_chrono.overview.motivation.duration.but_what_if_the_truncation_behavior_is_what_i_want_to_do_"></a><h5>
-<a name="id4813996"></a>
+<a name="id4814115"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.but_what_if_the_truncation_behavior_is_what_i_want_to_do_">But
what if the truncation behavior is what I want to do?</a>
</h5>
@@ -376,7 +384,7 @@
as often as it can.
</p>
<a name="boost_chrono.overview.motivation.duration.i_m_trafficking_in_floating_point___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code_s__link___i_don_t_want_to_deal_with_writing__code__phrase_role__identifier__duration_cast__phrase___code__all_over_the_place__i_m_content_with_the_precision_of_my_floating_point_representation"></a><h5>
-<a name="id4814139"></a>
+<a name="id4814258"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.i_m_trafficking_in_floating_point___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code_s__link___i_don_t_want_to_deal_with_writing__code__phrase_role__identifier__duration_cast__phrase___code__all_over_the_place__i_m_content_with_the_precision_of_my_floating_point_representation">I'm
trafficking in floating point <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code>s</a>. I don't want to deal
@@ -392,21 +400,21 @@
<span class="identifier">dminutes</span> <span class="identifier">dm4</span> <span class="special">=</span> <span class="identifier">m3</span> <span class="special">+</span> <span class="identifier">us3</span><span class="special">;</span> <span class="comment">// dm4.count() == 5.000000083333333
</span></pre>
<a name="boost_chrono.overview.motivation.duration.how_expensive_is_all_of_this_"></a><h5>
-<a name="id4814458"></a>
+<a name="id4814430"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.how_expensive_is_all_of_this_">How
expensive is all of this?</a>
</h5>
<p>
If you were writing these conversions by hand, you could not make it more
- efficient. The use of <code class="computeroutput"><span class="identifier">ratio</span></code>
- ensures that all conversion constants are simplified as much as possible
- at compile time. This usually results in the numerator or denominator of
- the conversion factor simplifying to <code class="computeroutput"><span class="number">1</span></code>,
- and being subsequently ignored in converting the run time values of the
- tick counts.
+ efficient. The use of <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> ensures that all conversion
+ constants are simplified as much as possible at compile time. This usually
+ results in the numerator or denominator of the conversion factor simplifying
+ to <code class="computeroutput"><span class="number">1</span></code>, and being subsequently
+ ignored in converting the run time values of the tick counts.
</p>
<a name="boost_chrono.overview.motivation.duration.how_complicated_is_it_to_build_a_function_taking_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__parameter_"></a><h5>
-<a name="id4814510"></a>
+<a name="id4814486"></a>
<a href="motivation.html#boost_chrono.overview.motivation.duration.how_complicated_is_it_to_build_a_function_taking_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_duration___code__phrase_role__identifier__duration__phrase___code___link__parameter_">How
complicated is it to build a function taking a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> parameter?</a>
@@ -654,7 +662,7 @@
the epochs associated with each clock is known.
</p>
<a name="boost_chrono.overview.motivation.time_point.so_what_exactly_is_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_time_point___code__phrase_role__identifier__time_point__phrase___code___link__and_how_do_i_use_one_"></a><h5>
-<a name="id4816513"></a>
+<a name="id4816490"></a>
<a href="motivation.html#boost_chrono.overview.motivation.time_point.so_what_exactly_is_a___link_linkend__boost_chrono_reference_cpp0x_chrono_chrono_hpp_time_point___code__phrase_role__identifier__time_point__phrase___code___link__and_how_do_i_use_one_">So
What Exactly is a <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_point" title="
Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a> and How Do I Use One?</a>
@@ -795,7 +803,7 @@
<span class="number">0.017</span><span class="identifier">s</span>
</pre>
<a name="boost_chrono.overview.motivation.stopwatches.stopwatches_accumulation_and_statistics"></a><h5>
-<a name="id4817746"></a>
+<a name="id4817722"></a>
<a href="motivation.html#boost_chrono.overview.motivation.stopwatches.stopwatches_accumulation_and_statistics">Stopwatches
accumulation and statistics</a>
</h5>
@@ -803,8 +811,9 @@
The preceding stopwatch manage only with a measure. It is also interesting
to have an statisitical view of these times, for example the sum, min,
max and mean. <code class="computeroutput"><span class="identifier">stopwatch_accumulator</span><span class="special"><></span></code> associates an accumulator with
- a stopwatch, so we are able to retrieve any statistical feature Boost.Accumulator
- provides.
+ a <a href="../reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a>, so we are able to retrieve
+ any statistical feature Boost.Accumulator provides.
</p>
<p>
For example
@@ -832,7 +841,7 @@
<pre class="programlisting"><span class="number">3</span> <span class="identifier">times</span><span class="special">,</span> <span class="identifier">sum</span><span class="special">=</span><span class="number">0.034</span><span class="identifier">s</span><span class="special">,</span> <span class="identifier">min</span><span class="special">=</span><span class="number">0.006</span><span class="identifier">s</span><span class="special">,</span> <span class="identifier">max</span><span class="special">=</span><span class="number">0.017</span><span class="identifier">s</span><span class="special">,</span> <span class="identifier">mean</span><span class="special">=</span><span class="number">0.011</span><span class="identifier">s</span>
</pre>
<a name="boost_chrono.overview.motivation.stopwatches.wall_clock_versus_system_and_user_time"></a><h5>
-<a name="id4818263"></a>
+<a name="id4818254"></a>
<a href="motivation.html#boost_chrono.overview.motivation.stopwatches.wall_clock_versus_system_and_user_time">Wall
clock versus system and user time</a>
</h5>
@@ -888,7 +897,7 @@
</span><span class="special">}</span>
</pre>
<a name="boost_chrono.overview.motivation.stopwatches.how_reliable_are_these_measures_"></a><h5>
-<a name="id4818651"></a>
+<a name="id4818642"></a>
<a href="motivation.html#boost_chrono.overview.motivation.stopwatches.how_reliable_are_these_measures_">How
reliable are these measures?</a>
</h5>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -53,7 +53,7 @@
<dt><span class="section"><a href="reference/other_clocks.html#boost_chrono.reference.other_clocks.suspendible_clock_hpp">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">suspendible_clock</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a></span></dt>
</dl></dd>
-<dt><span class="section">Stopwatches</span></dt>
+<dt><span class="section"> Stopwatches</span></dt>
<dd><dl>
<dt><span class="section"><a href="reference/stopwatches.html#boost_chrono.reference.stopwatches.stopwatches_hpp">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stopwatches</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a></span></dt>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/cpp0x.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/cpp0x.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/cpp0x.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -45,9 +45,11 @@
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio"> Class
Template <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_arithmetic">
- <code class="computeroutput"><span class="identifier">ratio</span></code> arithmetic</a></span></dt>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> arithmetic</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_comparison">
- <code class="computeroutput"><span class="identifier">ratio</span></code> comparison</a></span></dt>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> comparison</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ration_SI_typedefs">
SI typedefs</a></span></dt>
</dl></dd>
@@ -59,8 +61,8 @@
Configuration macros</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.clock">
<code class="computeroutput"><span class="identifier">Clock</span></code> Requirements</a></span></dt>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits">Time-related
- traits</a></span></dt>
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits">
+ Time-related traits</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration">
Class template <code class="computeroutput"><span class="identifier">duration</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration_non_member_arithmetic">duration
@@ -211,20 +213,24 @@
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio"> Class
Template <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_arithmetic">
- <code class="computeroutput"><span class="identifier">ratio</span></code> arithmetic</a></span></dt>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> arithmetic</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_comparison">
- <code class="computeroutput"><span class="identifier">ratio</span></code> comparison</a></span></dt>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> comparison</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ration_SI_typedefs">
SI typedefs</a></span></dt>
</dl></div>
<p>
- <code class="computeroutput"><span class="identifier">ratio</span></code> is a facility which
- is useful in specifying compile time rational constants. Compile time rational
- arithmetic is supported with protection against overflow and divide by
- zero. Such a facility is very handy when needing to efficiently represent
- 1/3 of a nanosecond, or specifying an inch in terms of meters (for example
- 254/10000 meters - which <code class="computeroutput"><span class="identifier">ratio</span></code>
- will reduce to 127/5000 meters).
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is a facility which is useful
+ in specifying compile time rational constants. Compile time rational arithmetic
+ is supported with protection against overflow and divide by zero. Such
+ a facility is very handy when needing to efficiently represent 1/3 of a
+ nanosecond, or specifying an inch in terms of meters (for example 254/10000
+ meters - which <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> will reduce to 127/5000
+ meters).
</p>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_RATIO_USES_STATIC_ASSERT</span>
<span class="preprocessor">#define</span> <span class="identifier">BOOST_RATIO_USES_MPL_ASSERT</span>
@@ -356,14 +362,16 @@
<span class="special">};</span>
</pre>
<p>
- A diagnostic will be emitted if <code class="computeroutput"><span class="identifier">ratio</span></code>
- is instantiated with <code class="computeroutput"><span class="identifier">D</span> <span class="special">==</span> <span class="number">0</span></code>, or
- if the absolute value of <code class="computeroutput"><span class="identifier">N</span></code>
- or <code class="computeroutput"><span class="identifier">D</span></code> can not be represented.
- <span class="bold"><strong>Note:</strong></span> These rules ensure that infinite
- ratios are avoided and that for any negative input, there exists a representable
- value of its absolute value which is positive. In a two's complement
- representation, this excludes the most negative value.
+ A diagnostic will be emitted if <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> is instantiated with
+ <code class="computeroutput"><span class="identifier">D</span> <span class="special">==</span>
+ <span class="number">0</span></code>, or if the absolute value of
+ <code class="computeroutput"><span class="identifier">N</span></code> or <code class="computeroutput"><span class="identifier">D</span></code>
+ can not be represented. <span class="bold"><strong>Note:</strong></span> These
+ rules ensure that infinite ratios are avoided and that for any negative
+ input, there exists a representable value of its absolute value which
+ is positive. In a two's complement representation, this excludes the
+ most negative value.
</p>
<p>
Let <code class="computeroutput"><span class="identifier">gcd</span></code> denote the greatest
@@ -387,7 +395,8 @@
the template parameters doesn't give a normalized form.
</p>
<p>
- Two <code class="computeroutput"><span class="identifier">ratio</span></code> classes <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N1</span><span class="special">,</span><span class="identifier">D1</span><span class="special">></span></code>
+ Two <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> classes <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N1</span><span class="special">,</span><span class="identifier">D1</span><span class="special">></span></code>
and <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N2</span><span class="special">,</span><span class="identifier">D2</span><span class="special">></span></code>
have the same normalized form if <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N1</span><span class="special">,</span><span class="identifier">D1</span><span class="special">>::</span><span class="identifier">type</span></code>
is the same type as <code class="computeroutput"><span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N2</span><span class="special">,</span><span class="identifier">D2</span><span class="special">>::</span><span class="identifier">type</span></code>
@@ -402,7 +411,8 @@
<span class="identifier">ratio</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N2</span><span class="special">,</span> <span class="identifier">D2</span><span class="special">>&</span> <span class="identifier">r</span><span class="special">);</span>
</pre>
<p>
- <span class="bold"><strong>Effects:</strong></span> Constructs a <code class="computeroutput"><span class="identifier">ratio</span></code> object.
+ <span class="bold"><strong>Effects:</strong></span> Constructs a <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> object.
</p>
<p>
<span class="bold"><strong>Remarks:</strong></span> This constructor will not
@@ -413,8 +423,8 @@
<span class="identifier">ratio</span><span class="special">&</span> <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="identifier">ratio</span><span class="special"><</span><span class="identifier">N2</span><span class="special">,</span> <span class="identifier">D2</span><span class="special">>&</span> <span class="identifier">r</span><span class="special">);</span>
</pre>
<p>
- <span class="bold"><strong>Effects:</strong></span> Assigns a <code class="computeroutput"><span class="identifier">ratio</span></code>
- object.
+ <span class="bold"><strong>Effects:</strong></span> Assigns a <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> object.
</p>
<p>
<span class="bold"><strong>Returns:</strong></span> *this.
@@ -430,13 +440,15 @@
<div class="titlepage"><div><div><h5 class="title">
<a name="boost_chrono.reference.cpp0x.ratio_hpp.ratio_arithmetic"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_arithmetic" title="
ratio arithmetic">
- <code class="computeroutput"><span class="identifier">ratio</span></code> arithmetic</a>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> arithmetic</a>
</h5></div></div></div>
<p>
For each of the class templates in this clause, each template parameter
refers to a <code class="computeroutput"><span class="identifier">ratio</span></code>. If
- the implementation is unable to form the indicated <code class="computeroutput"><span class="identifier">ratio</span></code>
- due to overflow, a diagnostic will be issued.
+ the implementation is unable to form the indicated <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> due to overflow, a diagnostic
+ will be issued.
</p>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">R1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">R2</span><span class="special">></span> <span class="keyword">struct</span> <span class="identifier">ratio_add</span> <span class="special">{</span>
<span class="keyword">typedef</span> <span class="special">[/</span><span class="identifier">see</span> <span class="identifier">below</span><span class="special">]</span> <span class="identifier">type</span><span class="special">;</span>
@@ -475,7 +487,8 @@
<div class="titlepage"><div><div><h5 class="title">
<a name="boost_chrono.reference.cpp0x.ratio_hpp.ratio_comparison"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio_comparison" title="
ratio comparison">
- <code class="computeroutput"><span class="identifier">ratio</span></code> comparison</a>
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> comparison</a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">R1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">R2</span><span class="special">></span> <span class="keyword">struct</span> <span class="identifier">ratio_equal</span>
<span class="special">:</span> <span class="keyword">public</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">integral_constant</span><span class="special"><</span><span class="keyword">bool</span><span class="special">,</span> <span class="special">[/</span><span class="identifier">see</span> <span class="identifier">below</span><span class="special">]</span> <span class="special">></span> <span class="special">{};</span>
@@ -546,7 +559,9 @@
</h4></div></div></div>
<p>
This file is a redirection to <code class="computeroutput"><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">hpp</span></code>
- including in addition registration for <code class="computeroutput"><span class="identifier">duration</span><span class="special"><></span></code> and <code class="computeroutput"><span class="identifier">timepoint</span><span class="special"><></span></code> class templates to Boost.Typeof.
+ including in addition registration for <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and <span class="underline">_timepoint</span>_
+ class templates to Boost.Typeof.
</p>
<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span>
<span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">typeof</span><span class="special">/</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span>
@@ -563,8 +578,8 @@
Configuration macros</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.clock">
<code class="computeroutput"><span class="identifier">Clock</span></code> Requirements</a></span></dt>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits">Time-related
- traits</a></span></dt>
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits">
+ Time-related traits</a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration">
Class template <code class="computeroutput"><span class="identifier">duration</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration_non_member_arithmetic">duration
@@ -949,31 +964,42 @@
Models of Clock:
</p>
<div class="itemizedlist"><ul type="disc">
-<li>system_clock</li>
-<li>monotonic_clock</li>
-<li>high_resolution_clock</li>
-<li>process_real_cpu_clock</li>
-<li>process_user_cpu_clock</li>
-<li>process_system_cpu_clock</li>
-<li>thread_clock</li>
+<li><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.system_clock" title="
+ Class system_clock"><code class="computeroutput"><span class="identifier">system_clock</span></code></a></li>
+<li><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.monotonic_clock" title="
+ Class monotonic_clock"><code class="computeroutput"><span class="identifier">monotonic_clock</span></code></a></li>
+<li><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.high_resolution_clock" title="
+ Class high_resolution_clock"><code class="computeroutput"><span class="identifier">high_resolution_clock</span></code></a></li>
+<li>
+ __process_real_cpu<span class="underline">clock</span>_
+ </li>
+<li>
+ __process_user_cpu<span class="underline">clock</span>_
+ </li>
+<li>
+ __process_system_cpu<span class="underline">clock</span>_
+ </li>
+<li>
+ __thread<span class="underline">clock</span>_
+ </li>
</ul></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits" title="Time-related
- traits">Time-related
- traits</a>
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits" title="
+ Time-related traits">
+ Time-related traits</a>
</h5></div></div></div>
<div class="toc"><dl>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.treat_as_floating_point">
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point">
Metafunction <code class="computeroutput"><span class="identifier">treat_as_floating_point</span><span class="special"><></span></code></a></span></dt>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values">
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values">
Class template <code class="computeroutput"><span class="identifier">duration_values</span></code></a></span></dt>
-<dt><span class="section">common_type specializations</span></dt>
+<dt><span class="section">common_type specializations</span></dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.treat_as_floating_point"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.treat_as_floating_point" title="
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point" title="
Metafunction treat_as_floating_point<>">
Metafunction <code class="computeroutput"><span class="identifier">treat_as_floating_point</span><span class="special"><></span></code></a>
</h6></div></div></div>
@@ -983,8 +1009,9 @@
<p>
The <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> template uses the
- <code class="computeroutput"><span class="identifier">treat_as_floating_point</span></code>
- trait to help determine if a <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point" title="
+ Metafunction treat_as_floating_point<>"><code class="computeroutput"><span class="identifier">treat_as_floating_point</span></code></a> trait
+ to help determine if a <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> with one tick period
can be converted to another <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> with a different
@@ -995,8 +1022,9 @@
implicit convertibility depends on the tick periods of the <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code>s</a>. If <code class="computeroutput"><span class="identifier">Rep</span></code> is a class type which emulates
a floating point type, the author of <code class="computeroutput"><span class="identifier">Rep</span></code>
- can specialize <code class="computeroutput"><span class="identifier">treat_as_floating_point</span></code>
- so that <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ can specialize <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.treat_as_floating_point" title="
+ Metafunction treat_as_floating_point<>"><code class="computeroutput"><span class="identifier">treat_as_floating_point</span></code></a> so
+ that <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> will treat this
<code class="computeroutput"><span class="identifier">Rep</span></code> as if it were a
floating point type. Otherwise <code class="computeroutput"><span class="identifier">Rep</span></code>
@@ -1006,16 +1034,16 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values" title="
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values" title="
Class template duration_values">
Class template <code class="computeroutput"><span class="identifier">duration_values</span></code></a>
</h6></div></div></div>
<div class="toc"><dl>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.zero">
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.zero">
Static member Function <code class="computeroutput"><span class="identifier">zero</span><span class="special">()</span></code></a></span></dt>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.max">
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.max">
Static member function <code class="computeroutput"><span class="identifier">max</span><span class="special">()</span></code></a></span></dt>
-<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.min">
+<dt><span class="section"><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.min">
Static member function <code class="computeroutput"><span class="identifier">min</span><span class="special">()</span></code></a></span></dt>
</dl></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">Rep</span><span class="special">></span>
@@ -1030,8 +1058,9 @@
<p>
The <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> template uses the
- <code class="computeroutput"><span class="identifier">duration_values</span></code> trait
- to construct special values of the <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values" title="
+ Class template duration_values"><code class="computeroutput"><span class="identifier">duration_values</span></code></a> trait to construct
+ special values of the <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code>s</a> representation (<code class="computeroutput"><span class="identifier">Rep</span></code>). This is done because the representation
might be a class type with behavior which requires some other implementation
to return these special values. In that case, the author of that class
@@ -1040,7 +1069,7 @@
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.zero"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.zero" title="
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.zero"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.zero" title="
Static member Function zero()">
Static member Function <code class="computeroutput"><span class="identifier">zero</span><span class="special">()</span></code></a>
</h6></div></div></div>
@@ -1059,7 +1088,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.max"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.max" title="
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.max"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.max" title="
Static member function max()">
Static member function <code class="computeroutput"><span class="identifier">max</span><span class="special">()</span></code></a>
</h6></div></div></div>
@@ -1075,7 +1104,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.min"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits.duration_values.min" title="
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.min"></a><a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits.duration_values.min" title="
Static member function min()">
Static member function <code class="computeroutput"><span class="identifier">min</span><span class="special">()</span></code></a>
</h6></div></div></div>
@@ -1092,7 +1121,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.time_related_traits._common_type__specializations"></a>common_type specializations
+<a name="boost_chrono.reference.cpp0x.chrono_chrono_hpp.traits._common_type__specializations"></a>common_type specializations
</h6></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">Rep1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">Period1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">Rep2</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">Period2</span><span class="special">></span>
<span class="keyword">struct</span> <span class="identifier">common_type</span><span class="special"><</span><span class="identifier">chrono</span><span class="special">::</span><span class="identifier">duration</span><span class="special"><</span><span class="identifier">Rep1</span><span class="special">,</span> <span class="identifier">Period1</span><span class="special">>,</span> <span class="identifier">chrono</span><span class="special">::</span><span class="identifier">duration</span><span class="special"><</span><span class="identifier">Rep2</span><span class="special">,</span> <span class="identifier">Period2</span><span class="special">></span> <span class="special">></span>
@@ -1107,8 +1136,9 @@
Class Template 'common_type<>'"><code class="computeroutput"><span class="identifier">common_type</span></code></a> is the greatest
common divisor of <code class="computeroutput"><span class="identifier">Period1</span></code>
and <code class="computeroutput"><span class="identifier">Period2</span></code>. This can
- be computed by forming a <code class="computeroutput"><span class="identifier">ratio</span></code>
- of the greatest common divisor of <code class="computeroutput"><span class="identifier">Period1</span><span class="special">::</span><span class="identifier">num</span></code>
+ be computed by forming a <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> of the greatest common
+ divisor of <code class="computeroutput"><span class="identifier">Period1</span><span class="special">::</span><span class="identifier">num</span></code>
and <code class="computeroutput"><span class="identifier">Period2</span><span class="special">::</span><span class="identifier">num</span></code>, and the least common multiple
of <code class="computeroutput"><span class="identifier">Period1</span><span class="special">::</span><span class="identifier">den</span></code> and <code class="computeroutput"><span class="identifier">Period2</span><span class="special">::</span><span class="identifier">den</span></code>.
</p>
@@ -1256,8 +1286,9 @@
<span class="special">}}</span>
</pre>
<p>
- Rep must be an arithmetic type, or a class emulating an arithmetic type,
- compile diagnostic otherwise. If <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
+ <code class="computeroutput"><span class="identifier">Rep</span></code> must be an arithmetic
+ type, or a class emulating an arithmetic type, compile diagnostic otherwise.
+ If <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> is instantiated with
the type of <code class="computeroutput"><span class="identifier">Rep</span></code> being
a <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
@@ -1265,21 +1296,32 @@
is issued.
</p>
<p>
- Period must be an instantiation of <code class="computeroutput"><span class="identifier">ratio</span></code>,
- compile diagnostic otherwise.
+ <code class="computeroutput"><span class="identifier">Period</span></code> must be an instantiation
+ of <code class="computeroutput"><span class="identifier">ratio</span></code>, compile diagnostic
+ otherwise.
</p>
<p>
- Period::num must be positive, compile diagnostic otherwise.
+ <code class="computeroutput"><span class="identifier">Period</span><span class="special">::</span><span class="identifier">num</span></code> must be positive, compile diagnostic
+ otherwise.
</p>
<p>
Examples:
</p>
-<pre class="programlisting"><span class="identifier">duration</span><span class="special"><</span><span class="keyword">long</span><span class="special">,</span> <span class="identifier">ratio</span><span class="special"><</span><span class="number">60</span><span class="special">></span> <span class="special">></span> <span class="identifier">holds</span> <span class="identifier">a</span> <span class="identifier">count</span> <span class="identifier">of</span> <span class="identifier">minutes</span> <span class="keyword">using</span> <span class="identifier">a</span> <span class="keyword">long</span><span class="special">.</span>
-
-<span class="identifier">duration</span><span class="special"><</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">,</span> <span class="identifier">milli</span><span class="special">></span> <span class="identifier">holds</span> <span class="identifier">a</span> <span class="identifier">count</span> <span class="identifier">of</span> <span class="identifier">milliseconds</span> <span class="keyword">using</span> <span class="identifier">a</span> <span class="keyword">long</span> <span class="keyword">long</span><span class="special">.</span>
-
-<span class="identifier">duration</span><span class="special"><</span><span class="keyword">double</span><span class="special">,</span> <span class="identifier">ratio</span><span class="special"><</span><span class="number">1</span><span class="special">,</span> <span class="number">30</span><span class="special">></span> <span class="special">></span> <span class="identifier">holds</span> <span class="identifier">a</span> <span class="identifier">count</span> <span class="keyword">using</span> <span class="identifier">a</span> <span class="keyword">double</span> <span class="identifier">with</span> <span class="identifier">a</span> <span class="identifier">tick</span> <span class="identifier">period</span> <span class="identifier">of</span> <span class="number">1</span><span class="special">/</span><span class="number">30</span> <span class="identifier">second</span> <span class="special">(</span><span class="identifier">a</span> <span class="identifier">tick</span> <span class="identifier">fre
quency</span> <span class="identifier">of</span> <span class="number">30</span> <span class="identifier">Hz</span><span class="special">).</span>
-</pre>
+<div class="itemizedlist"><ul type="disc">
+<li>
+<code class="computeroutput"><span class="identifier">duration</span><span class="special"><</span><span class="keyword">long</span><span class="special">,</span> <span class="identifier">ratio</span><span class="special"><</span><span class="number">60</span><span class="special">></span> <span class="special">></span></code> holds a count of minutes using
+ a long.
+ </li>
+<li>
+<code class="computeroutput"><span class="identifier">duration</span><span class="special"><</span><span class="keyword">long</span> <span class="keyword">long</span><span class="special">,</span> <span class="identifier">milli</span><span class="special">></span></code> holds a count of milliseconds using
+ a long long.
+ </li>
+<li>
+<code class="computeroutput"><span class="identifier">duration</span><span class="special"><</span><span class="keyword">double</span><span class="special">,</span> <span class="identifier">ratio</span><span class="special"><</span><span class="number">1</span><span class="special">,</span> <span class="number">30</span><span class="special">></span> <span class="special">></span></code>
+ holds a count using a double with a tick period of 1/30 second (a tick
+ frequency of 30 Hz).
+ </li>
+</ul></div>
<p>
The following members of <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> do not throw an exception
@@ -1310,7 +1352,7 @@
</li>
</ul></div>
<p>
- If these constraints are not met, this constructor shall not participate
+ If these constraints are not met, this constructor will not participate
in overload resolution. <span class="bold"><strong>Note:</strong></span> This
requirement prevents construction of an integral-based <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
Class template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> with a floating point
@@ -1346,7 +1388,7 @@
<span class="bold"><strong>Remarks:</strong></span> <code class="computeroutput"><span class="identifier">treat_as_floating_point</span><span class="special"><</span><span class="identifier">rep</span><span class="special">>::</span><span class="identifier">value</span></code>,
or <code class="computeroutput"><span class="identifier">ratio_divide</span><span class="special"><</span><span class="identifier">Period2</span><span class="special">,</span>
<span class="identifier">period</span><span class="special">>::</span><span class="identifier">type</span><span class="special">::</span><span class="identifier">den</span> <span class="special">==</span>
- <span class="number">1</span></code>, else this constructor shall
+ <span class="number">1</span></code>, else this constructor will
not participate in overload resolution. <span class="bold"><strong>note</strong></span>
This requirement prevents implicit truncation error when converting
between integral-based <a href="cpp0x.html#boost_chrono.reference.cpp0x.chrono_chrono_hpp.duration" title="
@@ -1760,8 +1802,8 @@
</pre>
<p>
<span class="bold"><strong>Remarks</strong></span> This function will not participate
- in overload resolution unless Rep2 shall be implicitly convertible
- to CR(Rep1, Rep2) and Rep2 shall not be an instantiation of duration.
+ in overload resolution unless Rep2 must be implicitly convertible to
+ CR(Rep1, Rep2) and Rep2 must not be an instantiation of duration.
</p>
<p>
<span class="bold"><strong>Returns:</strong></span> duration<CR(Rep1,Rep2),
@@ -1917,8 +1959,8 @@
</p>
<p>
<span class="bold"><strong>Returns:</strong></span> Forms <code class="computeroutput"><span class="identifier">CF</span></code>
- which is a <code class="computeroutput"><span class="identifier">ratio</span></code> resulting
- from <code class="computeroutput"><span class="identifier">ratio_divide</span><span class="special"><</span><span class="identifier">Period</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">ToDuration</span><span class="special">::</span><span class="identifier">period</span><span class="special">>::</span><span class="identifier">type</span></code>.
+ which is a <a href="cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> resulting from <code class="computeroutput"><span class="identifier">ratio_divide</span><span class="special"><</span><span class="identifier">Period</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">ToDuration</span><span class="special">::</span><span class="identifier">period</span><span class="special">>::</span><span class="identifier">type</span></code>.
Let <code class="computeroutput"><span class="identifier">CR</span></code> be the <a href="cpp0x.html#boost_chrono.reference.cpp0x.common_type_hpp.common_type" title="
Class Template 'common_type<>'"><code class="computeroutput"><span class="identifier">common_type</span></code></a> of <code class="computeroutput"><span class="identifier">ToDuration</span><span class="special">::</span><span class="identifier">rep</span></code>, <code class="computeroutput"><span class="identifier">Rep</span></code>,
and <code class="computeroutput"><span class="identifier">intmax_t</span></code>.
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/other_clocks.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/other_clocks.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/other_clocks.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -8,7 +8,7 @@
<link rel="up" href="../reference.html" title=" Reference ">
<link rel="prev" href="cpp0x.html" title=" Included on the C++0x
recommendation">
-<link rel="next" href="stopwatches.html" title="Stopwatches">
+<link rel="next" href="stopwatches.html" title=" Stopwatches">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/reporters.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/reporters.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/reporters.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Boost.Chrono">
<link rel="up" href="../reference.html" title=" Reference ">
-<link rel="prev" href="stopwatches.html" title="Stopwatches">
+<link rel="prev" href="stopwatches.html" title=" Stopwatches">
<link rel="next" href="formatters.html" title=" Stopwatch Formatters">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -1008,7 +1008,7 @@
<span class="special">}</span>
</pre>
<a name="boost_chrono.reference.reporters.scoped_stopclock_hpp.scoped_stopclock.synopsis"></a><h6>
-<a name="id4924649"></a>
+<a name="id4924611"></a>
<a href="reporters.html#boost_chrono.reference.reporters.scoped_stopclock_hpp.scoped_stopclock.synopsis">Synopsis</a>
</h6>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span> <span class="keyword">class</span> <span class="identifier">Clock</span><span class="special">=</span><span class="identifier">process_cpu_clock</span>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/stopwatches.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/stopwatches.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/reference/stopwatches.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -1,7 +1,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
-<title>Stopwatches</title>
+<title> Stopwatches</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Boost.Chrono">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_chrono.reference.stopwatches"></a>Stopwatches
+<a name="boost_chrono.reference.stopwatches"></a> Stopwatches
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatches_hpp">
@@ -51,7 +51,8 @@
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch">
Template Class <code class="computeroutput"><span class="identifier">stopwatch</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch_typedefs">
- <code class="computeroutput"><span class="identifier">stopwatch</span></code> useful typedefs</a></span></dt>
+ <a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a> useful typedefs</a></span></dt>
</dl></dd>
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_accumulator_hpp">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">stopwatch_accumulator</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a></span></dt>
@@ -421,7 +422,8 @@
Models of <code class="computeroutput"><span class="identifier">Stopwatch</span></code>:
</p>
<div class="itemizedlist"><ul type="disc">
-<li>stopwatch</li>
+<li><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a></li>
<li>stopwatch_accumulator</li>
</ul></div>
</div>
@@ -435,7 +437,8 @@
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch">
Template Class <code class="computeroutput"><span class="identifier">stopwatch</span><span class="special"><></span></code></a></span></dt>
<dt><span class="section"><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch_typedefs">
- <code class="computeroutput"><span class="identifier">stopwatch</span></code> useful typedefs</a></span></dt>
+ <a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a> useful typedefs</a></span></dt>
</dl></div>
<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">boost</span> <span class="special">{</span> <span class="keyword">namespace</span> <span class="identifier">chrono</span> <span class="special">{</span>
<span class="keyword">struct</span> <span class="identifier">dont_start_t</span><span class="special">;</span>
@@ -478,11 +481,12 @@
</p>
<p>
Knowing how long a part of a program takes to execute is useful in both
- test and production environments. A <code class="computeroutput"><span class="identifier">stopwatch</span></code>
- object measures elapsed time. It is recommended to use it with clocks
- that measure wall clock rather than CPU time since the intended use is
- performance measurement on systems where total elapsed time is more important
- than just process or CPU time.
+ test and production environments. A <a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a> object measures elapsed
+ time. It is recommended to use it with clocks that measure wall clock
+ rather than CPU time since the intended use is performance measurement
+ on systems where total elapsed time is more important than just process
+ or CPU time.
</p>
<p>
The maximum measurable elapsed time depends on the Clock parameter. The
@@ -541,7 +545,8 @@
<div class="titlepage"><div><div><h5 class="title">
<a name="boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch_typedefs"></a><a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch_typedefs" title="
stopwatch useful typedefs">
- <code class="computeroutput"><span class="identifier">stopwatch</span></code> useful typedefs</a>
+ <a href="stopwatches.html#boost_chrono.reference.stopwatches.stopwatch_hpp.stopwatch" title="
+ Template Class stopwatch<>"><code class="computeroutput"><span class="identifier">stopwatch</span></code></a> useful typedefs</a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">typedef</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">chrono</span><span class="special">::</span><span class="identifier">stopwatch</span><span class="special"><</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">chrono</span><span class="special">::</span><span class="identifier">system_clock</span> <span class="special">></span> <span class="identifier">system_stopwatch</span><span class="special">;</span>
<span class="preprocessor">#ifdef</span> <span class="identifier">BOOST_CHRONO_HAS_CLOCK_MONOTONIC</span>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/getting_started.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/getting_started.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/getting_started.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -39,7 +39,7 @@
Installing Chrono</a>
</h4></div></div></div>
<a name="boost_chrono.users_guide.getting_started.install.getting__emphasis_role__bold__boost_chrono__emphasis__"></a><h5>
-<a name="id4819123"></a>
+<a name="id4819119"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.getting__emphasis_role__bold__boost_chrono__emphasis__">Getting
<span class="bold"><strong>Boost.Chrono</strong></span> </a>
</h5>
@@ -54,7 +54,7 @@
and follow the instructions there for anonymous SVN access.
</p>
<a name="boost_chrono.users_guide.getting_started.install.where_to_install__emphasis_role__bold__boost_chrono__emphasis___"></a><h5>
-<a name="id4819191"></a>
+<a name="id4819188"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.where_to_install__emphasis_role__bold__boost_chrono__emphasis___">Where
to install <span class="bold"><strong>Boost.Chrono</strong></span>? </a>
</h5>
@@ -70,7 +70,7 @@
variable. Any help is welcome.
</p>
<a name="boost_chrono.users_guide.getting_started.install.building__emphasis_role__bold__boost_chrono__emphasis__"></a><h5>
-<a name="id4819234"></a>
+<a name="id4819230"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.building__emphasis_role__bold__boost_chrono__emphasis__">Building
<span class="bold"><strong>Boost.Chrono</strong></span> </a>
</h5>
@@ -81,7 +81,7 @@
<pre class="programlisting"><span class="identifier">bjam</span> <span class="identifier">libs</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">build</span>
</pre>
<a name="boost_chrono.users_guide.getting_started.install.requirements"></a><h5>
-<a name="id4819301"></a>
+<a name="id4819298"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.requirements">Requirements</a>
</h5>
<p>
@@ -144,7 +144,7 @@
</dl>
</div>
<a name="boost_chrono.users_guide.getting_started.install.building_an_executable_that_uses__emphasis_role__bold__boost_chrono__emphasis__"></a><h5>
-<a name="id4819550"></a>
+<a name="id4819546"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.building_an_executable_that_uses__emphasis_role__bold__boost_chrono__emphasis__">Building
an executable that uses <span class="bold"><strong>Boost.Chrono</strong></span>
</a>
@@ -154,7 +154,7 @@
with the Boost System library.
</p>
<a name="boost_chrono.users_guide.getting_started.install.exceptions_safety_"></a><h5>
-<a name="id4819586"></a>
+<a name="id4819582"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.exceptions_safety_">Exceptions
safety </a>
</h5>
@@ -163,7 +163,7 @@
of exception safety as long as the underlying parameters provide it.
</p>
<a name="boost_chrono.users_guide.getting_started.install.thread_safety_"></a><h5>
-<a name="id4819612"></a>
+<a name="id4819609"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.thread_safety_">Thread
safety </a>
</h5>
@@ -171,7 +171,7 @@
All functions in the library are thread-unsafe except when noted explicitly.
</p>
<a name="boost_chrono.users_guide.getting_started.install.tested_compilers_"></a><h5>
-<a name="id4819637"></a>
+<a name="id4819633"></a>
<a href="getting_started.html#boost_chrono.users_guide.getting_started.install.tested_compilers_">Tested
compilers </a>
</h5>
Modified: sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/tutorial.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/tutorial.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/boost_chrono/users_guide/tutorial.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -149,11 +149,12 @@
If you would like to programmatically inspect <code class="computeroutput"><span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">duration</span></code>,
you can get the representation type with <code class="computeroutput"><span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">rep</span></code>,
and the tick period with <code class="computeroutput"><span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">period</span></code>
- (which should be a type <code class="computeroutput"><span class="identifier">ratio</span></code>
- which has nested values <code class="computeroutput"><span class="identifier">ratio</span><span class="special">::</span><span class="identifier">num</span></code>
- and <code class="computeroutput"><span class="identifier">ratio</span><span class="special">::</span><span class="identifier">den</span></code>). The tick period of <code class="computeroutput"><span class="identifier">thread_clock</span></code> is <code class="computeroutput"><span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">period</span><span class="special">::</span><span class="identifier">num</span> <span class="special">/</span> <span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">period</span><span class="special">::</span><span class="identifier">den</span></code>
- seconds: 1/1000000000 in this case (1 billionth of a second), stored
- in a long long.
+ (which should be a type <a href="../reference/cpp0x.html#boost_chrono.reference.cpp0x.ratio_hpp.ratio" title=" Class
+ Template ratio<>"><code class="computeroutput"><span class="identifier">ratio</span></code></a> which has nested values
+ <code class="computeroutput"><span class="identifier">ratio</span><span class="special">::</span><span class="identifier">num</span></code> and <code class="computeroutput"><span class="identifier">ratio</span><span class="special">::</span><span class="identifier">den</span></code>).
+ The tick period of <code class="computeroutput"><span class="identifier">thread_clock</span></code>
+ is <code class="computeroutput"><span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">period</span><span class="special">::</span><span class="identifier">num</span> <span class="special">/</span> <span class="identifier">thread_clock</span><span class="special">::</span><span class="identifier">period</span><span class="special">::</span><span class="identifier">den</span></code> seconds: 1/1000000000 in this case
+ (1 billionth of a second), stored in a long long.
</p>
<p>
If you need to use <code class="computeroutput"><span class="identifier">duration_cast</span><span class="special"><></span></code>, but want to round up, instead
Modified: sandbox/chrono/libs/chrono/doc/html/index.html
==============================================================================
--- sandbox/chrono/libs/chrono/doc/html/index.html (original)
+++ sandbox/chrono/libs/chrono/doc/html/index.html 2010-07-01 02:58:21 EDT (Thu, 01 Jul 2010)
@@ -66,7 +66,7 @@
<dt><span class="section"><a href="boost_chrono/reference/cpp0x.html"> Included on the C++0x
recommendation</a></span></dt>
<dt><span class="section">Other clocks</span></dt>
-<dt><span class="section">Stopwatches</span></dt>
+<dt><span class="section"> Stopwatches</span></dt>
<dt><span class="section"> Stopwatch Reporters</span></dt>
<dt><span class="section"> Stopwatch Formatters</span></dt>
<dt><span class="section"> Deprecated Headers</span></dt>
@@ -98,7 +98,7 @@
</table></div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: June 30, 2010 at 23:48:14 GMT</small></p></td>
+<td align="left"><p><small>Last revised: July 01, 2010 at 06:56:05 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
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