Ticket #10893: fix_typo.patch

File fix_typo.patch, 17.1 KB (added by anonymous, 8 years ago)
  • doc/chrono.qbk

    a b  
    499499This makes it easy for `boost::milliseconds` to be represented by the text "milliseconds", or a hypothetical meter
    500500class to print out "millimeter".
    501501The __duration and the __time_point i/o can be customized through the new facets: __duration_units and __time_point_units.
    502 The user can specialize these facets so that the the chrono i/o could be localizable.
     502The user can specialize these facets so that the chrono i/o could be localizable.
    503503However Boost.Chrono doesn't provides a complete locale solution. 
    504504
    505505`system_clock::time_point` I/O is proposed in terms of UTC timepoints, strongly guided by
     
    556556__Boost_Chrono__ can be configured as a header-only library defining __BOOST_CHRONO_HEADER_ONLY.
    557557However Boost.Chrono depends on the non header-only library Boost.System, so that you will need to link with boost_system.
    558558
    559 Boost.System has un undocumented feature (use of macro BOOST_ERROR_CODE_HEADER_ONLY) to make it header only.
     559Boost.System has an undocumented feature (use of macro BOOST_ERROR_CODE_HEADER_ONLY) to make it header only.
    560560 
    561561If __BOOST_CHRONO_HEADER_ONLY is not defined you need to compile it and build the library before use, for example using:
    562562
     
    12601260[warning Need to be changed
    12611261This is followed by a single space and then the compile-time unit name of the __duration. This unit name is built on the string returned from `ratio_string<>` and the data used to construct the __duration_punct which was inserted into the stream's locale. If a __duration_punct has not been inserted into the stream's locale, a default constructed __duration_punct will be added to the stream's locale.
    12621262
    1263 __duration unit names come in two varieties: long(prefix) and short(symbol). The default constructed __duration_punct provides names in the long(prefix) format. These names are English descriptions. Other languages are supported by constructing a __duration_punct with the proper spellings for "hours", "minutes" and "seconds", and their abbreviations (for the short format). The short or long format can be easily chosen by streaming a `duration_short()` or `duration_long()` manipulator respectively or using the parameterized manimulator `duration_fmt(duration_style::prefix)` or `duration_fmt(duration_style::symbol)`.
     1263__duration unit names come in two varieties: long(prefix) and short(symbol). The default constructed __duration_punct provides names in the long(prefix) format. These names are English descriptions. Other languages are supported by constructing a __duration_punct with the proper spellings for "hours", "minutes" and "seconds", and their abbreviations (for the short format). The short or long format can be easily chosen by streaming a `duration_short()` or `duration_long()` manipulator respectively or using the parameterized manipulator `duration_fmt(duration_style::prefix)` or `duration_fmt(duration_style::symbol)`.
    12641264
    12651265]
    12661266__example
     
    21782178* `d` is the number of `days`
    21792179* `h` is the number of `hours`
    21802180* `m` is the number of `minutes`
    2181 * `ss.cc` is the number of `seconds` rounded to the nearest hundreth of a second
     2181* `ss.cc` is the number of `seconds` rounded to the nearest hundredth of a second
    21822182
    21832183    #include <boost/chrono/chrono_io.hpp>
    21842184    #include <ostream>
     
    22982298    }}
    22992299
    23002300
    2301 Next is the `boost::thread::timed_mutex` modified fuctions
     2301Next is the `boost::thread::timed_mutex` modified functions
    23022302
    23032303    namespace boost {
    23042304    struct timed_mutex {
     
    25252525
    25262526[section:limitations Limitations and Extensions]
    25272527
    2528 At present, tthere is no know limitation respect to the C++11 standard.
     2528At present, there is no know limitation respect to the C++11 standard.
    25292529
    25302530The current implementation provides in addition:
    25312531
     
    25422542When `BOOST_NO_STATIC_ASSERT` is defined, the user can select the way static assertions are reported. Define
    25432543
    25442544* `BOOST_CHRONO_USES_STATIC_ASSERT`: define it if you want to use Boost.StaticAssert.
    2545 * `BOOST_CHRONO_USES_MPL_ASSERT`: define it if you want to use Boost.MPL static asertions.
    2546 * `BOOST_CHRONO_USES_ARRAY_ASSERT`: define it if you want to use internal static asertions.
     2545* `BOOST_CHRONO_USES_MPL_ASSERT`: define it if you want to use Boost.MPL static assertions.
     2546* `BOOST_CHRONO_USES_ARRAY_ASSERT`: define it if you want to use internal static assertions.
    25472547
    25482548The default behavior is as `BOOST_CHRONO_USES_ARRAY_ASSERT` was defined.
    25492549
     
    27022702            const duration<Rep2, Period2>& rhs);
    27032703
    27042704        #ifdef BOOST_CHRONO_EXTENSIONS
    2705         // Used to get frecuency of events
     2705        // Used to get frequency of events
    27062706        template <class Rep1, class Rep2, class Period>
    27072707        constexpr
    27082708        double __duration__op_div_1(
     
    40764076            std::basic_ostream<CharT, Traits>&
    40774077            operator<<(std::basic_ostream<CharT, Traits>& os, const duration<Rep, Period>& d);
    40784078
    4079 __effects outputs the __duration as an abrevieated or long text format depending on the state of the __duration_punct facet.
     4079__effects outputs the __duration as an abbreviated or long text format depending on the state of the __duration_punct facet.
    40804080
    40814081__returns the output stream
    40824082
     
    40934093            operator<<(std::basic_ostream<CharT, Traits>& os,
    40944094                   const time_point<Clock, Duration>& tp);
    40954095
    4096 __effects outputs the __time_point as an abrevieated or long text format depending on the state of the __duration_punct facet.
     4096__effects outputs the __time_point as an abbreviated or long text format depending on the state of the __duration_punct facet.
    40974097
    40984098__returns the output stream
    40994099
     
    47954795
    47964796
    47974797__effects Scan `s` for the longest of all the plural forms associated with the duration units.
    4798 If sucessfull, sets the matched ratio in `rt`. Otherwise evaluates `err = std::ios_base::failbit`.
     4798If successful, sets the matched ratio in `rt`. Otherwise evaluates `err = std::ios_base::failbit`.
    47994799
    48004800__returns `s`, an iterator pointing just beyond the last character that can be determined to be part of a valid name.
    48014801
     
    48274827
    48284828
    48294829__effects Scan `s` for the longest of all the plural forms associated with the duration units.
    4830 If sucessfull, sets the matched ratio in `rt`. Otherwise evaluates `err = std::ios_base::failbit`.
     4830If successful, sets the matched ratio in `rt`. Otherwise evaluates `err = std::ios_base::failbit`.
    48314831
    48324832__returns `s`, an iterator pointing just beyond the last character that can be determined to be part of a valid name.
    48334833
     
    52215221    class duration_units_default: public duration_units<CharT>
    52225222    {
    52235223    protected:
    5224       static const std::size_t pfs_ = 2; // The defaul English facet has two plural forms.
     5224      static const std::size_t pfs_ = 2; // The default English facet has two plural forms.
    52255225
    52265226    public:
    52275227      typedef CharT char_type;
     
    55835583
    55845584[section:manipulators I/O Manipulators]
    55855585
    5586 There is a parameterized manimulator that takes the duration_style as parameter.
     5586There is a parameterized manipulator that takes the duration_style as parameter.
    55875587The symbol or name format can be easily chosen by streaming a `symbol_format` or `name_format` manipulators respectively.
    55885588
    55895589[section:duration_fmt Template Class `duration_fmt`]
     
    64686468The conversion to `tm` use `gmtime` (when available) if the timezone is __utc, else it use localtime (if available).
    64696469
    64706470Using the `std::time_put` facet stored in `os`, this inserter writes characters to the stream using the `tm` and the
    6471 formating string stored in the `time_punct` facet, unless that facet was missing, or unless it provided an empty string.
     6471formatting string stored in the `time_punct` facet, unless that facet was missing, or unless it provided an empty string.
    64726472
    64736473If the formatting string is empty, then output as follows:
    64746474
     
    68426842
    68436843__process_system_cpu_clock satisfy the __clock_req.
    68446844
    6845 __process_system_cpu_clock class provides access to the system CPU-time steady clockof the calling process. The process relative system current time can be obtained by calling `process_system_cpu_clock::now()`.
     6845__process_system_cpu_clock class provides access to the system CPU-time steady clock of the calling process. The process relative system current time can be obtained by calling `process_system_cpu_clock::now()`.
    68466846
    68476847        class process_system_cpu_clock {
    68486848        public:
     
    69316931    operator<<(std::basic_ostream<CharT, Traits>& os,
    69326932            process_times<Rep> const& rhs);
    69336933
    6934 __effects Output each part separated by ';' and sourrounded by '{', '}'.
     6934__effects Output each part separated by ';' and surrounded by '{', '}'.
    69356935
    69366936__throws None.
    69376937
     
    72897289class `run_timer` provides a complete run-time reporting package that can be invoked in a single line of code. The reporting is controlled by two parameters:
    72907290
    72917291* format : The output format
    7292 * places(precision): the number of decimal placess used.
     7292* places(precision): the number of decimal places used.
    72937293
    72947294The default places is given by default_places and is 3.
    72957295
     
    73777377* [@http://svn.boost.org/trac/boost/ticket/9698 #9698] boost::chrono::thread_clock not declared in OSX
    73787378* [@http://svn.boost.org/trac/boost/ticket/9720 #9720] boost::this_thread::sleep_for() sometimes returns immediately on win32
    73797379* [@http://svn.boost.org/trac/boost/ticket/9859 #9859] Remove references to gcc-mingw
    7380 * [@http://svn.boost.org/trac/boost/ticket/9918 #9918] chrono compilation error on Solaris, funciton timegm
     7380* [@http://svn.boost.org/trac/boost/ticket/9918 #9918] chrono compilation error on Solaris, function timegm
    73817381* [@http://svn.boost.org/trac/boost/ticket/9811 #9811] boost/boost/chrono/duration.hpp:355:56: error: call to non-constexpr function 'static std::numeric_limits<float>::_Ty std::numeric_limits<float>::max()' /home/zosun/input_service/inputservices-core-service/other/boost/boost/chrono/duration.hpp: In static member function 'static constexpr double boost::chrono::detail::chrono_numeric_limits<double, true>::lowest()':
    73827382* [@http://svn.boost.org/trac/boost/ticket/10069 #10069] Overflow in chrono clocks on 32bit
    73837383* [@http://svn.boost.org/trac/boost/ticket/10151 #10151] timegm function not available on QNX
     
    73927392* [@http://svn.boost.org/trac/boost/ticket/7868 #7868] chrono_io parses time incorrectly (1.53 and 1.52)   
    73937393* [@http://svn.boost.org/trac/boost/ticket/9028 #9028] Typo in boost/chrono/stopwatches/formatters/base_formatter.hpp 
    73947394* [@http://svn.boost.org/trac/boost/ticket/9147 #9147] uninitialized std::tm
    7395 * [@http://svn.boost.org/trac/boost/ticket/9274 #9274] lost of precission on system_clock input.
     7395* [@http://svn.boost.org/trac/boost/ticket/9274 #9274] lost of precision on system_clock input.
    73967396* [@http://svn.boost.org/trac/boost/ticket/9276 #9276] output from a system_clock::time_point get a time_point that is one day later than expected.
    73977397
    73987398[endsect] [/section [*Version 2.0.3] ]
     
    74197419
    74207420[*Deprecated:]
    74217421
    7422 * The chrono i/o version included in Boost.Chrono 1.2.x has been completly refactored in version 2.0.0
    7423 * chrono I/O: The manipulators __duration_short, __duration_long are depreceated. You should use the parameterized form __duration_fmt or the renamed manipulators __duration_symbol and __duration_prefix  instead.
    7424 * chrono I/O: The __duration_punct<> facet is depreceated. You should use the __get_duration_style free function to get the informations and use the __duration_units facet for localization purposes.
     7422* The chrono i/o version included in Boost.Chrono 1.2.x has been completely refactored in version 2.0.0
     7423* chrono I/O: The manipulators __duration_short, __duration_long are deprecated. You should use the parameterized form __duration_fmt or the renamed manipulators __duration_symbol and __duration_prefix  instead.
     7424* chrono I/O: The __duration_punct<> facet is deprecated. You should use the __get_duration_style free function to get the informations and use the __duration_units facet for localization purposes.
    74257425
    74267426When BOOST_CHRONO_VERSION==2 the preceding deprecated functions are not available.
    74277427
     
    74467446
    74477447[*Deprecated:]
    74487448
    7449 * The chrono i/o version included in Boost.Chrono 1.2.x has been completly refactored in version 2.0.0
    7450 * chrono I/O: The manipulators __duration_short, __duration_long are depreceated. You should use the parameterized form __duration_fmt or the renamed manipulators __duration_symbol and __duration_prefix  instead.
    7451 * chrono I/O: The __duration_punct<> facet is depreceated. You should use the __get_duration_style free function to get the informations and use the __duration_units facet for localization purposes.
     7449* The chrono i/o version included in Boost.Chrono 1.2.x has been completely refactored in version 2.0.0
     7450* chrono I/O: The manipulators __duration_short, __duration_long are deprecated. You should use the parameterized form __duration_fmt or the renamed manipulators __duration_symbol and __duration_prefix  instead.
     7451* chrono I/O: The __duration_punct<> facet is deprecated. You should use the __get_duration_style free function to get the informations and use the __duration_units facet for localization purposes.
    74527452
    74537453When BOOST_CHRONO_VERSION==2 the preceding deprecated functions are not available.
    74547454
     
    74637463
    74647464* [@http://svn.boost.org/trac/boost/ticket/6871 #6871] chrono_io.hpp: operator<<(ostream& os, ...) modifies the state of os.
    74657465
    7466   * The neww io interface provided in version 2 solves this issue. You should move to the new version.
     7466  * The new io interface provided in version 2 solves this issue. You should move to the new version.
    74677467
    74687468[*Known bugs not fixed yet:]
    74697469
     
    76597659[*Bug Fixes]
    76607660
    76617661* __process_cpu_clock is now a valid model of __Clock that can be used with __stopclocks_accumulator__.
    7662 * eliminate or suppress a lot of warnings appearing with with warnings=all -Wextra
     7662* eliminate or suppress a lot of warnings appearing with warnings=all -Wextra
    76637663* improve the error code handling
    76647664
    76657665[endsect]
     
    76987698
    76997699[*Bug Fixes]
    77007700
    7701 * boost/thread/detail/cv_status.hpp file was not commited.
     7701* boost/thread/detail/cv_status.hpp file was not committed.
    77027702
    77037703[endsect]
    77047704
     
    77567756* Added frequency, lifetime and percentage to the default `stopwatch_accumulator_formatter`.
    77577757
    77587758[*Bug Fixes]
    7759 * Specific formatters didn't work completly.
     7759* Specific formatters didn't work completely.
    77607760* Replace `duration(0)` by `duration::zero()` on template classes.
    77617761* `suspend` doesn't works: `partial_` not initialized neither taken in account by the elapsed function.
    77627762
     
    77887788    * Added digital_time formatter "%d days(s) %h:%m:%s.%n\\n"
    77897789* __stopwatch_reporter is a convenient generic class reporting elapsed time for the Stopwatch concept.
    77907790* Added `stopclock<__Clock>` shortcut `stopwatch_reporter<stopwatch<__Clock>>`
    7791 * Added __scoped_stopclock__ which trace at the constuctor and destructor.
     7791* Added __scoped_stopclock__ which trace at the constructor and destructor.
    77927792* Added `typeof` registration for classes __duration and __time_point
    77937793
    77947794* 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:
     
    77987798
    77997799[*Bug Fixes]
    78007800
    7801 * 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`.
     7801* 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 inline functions using the std::string `m_format`.
    78027802
    78037803[endsect]
    78047804
     
    78477847
    78487848* Use `INTMAC_C` to name `intmax_t` constants instead of `LL`.
    78497849* Separate `chrono.cpp` on # files `win/chrono.cpp`, `mac/chrono.cpp` and `posix/chrono.cpp` to make easier the maintenance on different platforms.
    7850 * 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.
     7850* Separate `process_clock.cpp` on # files `win/process_clock.cpp`, `mac/process_clock.cpp` and `posix/process_clock.cpp` to make easier the maintenance on different platforms.
    78517851* Added the `error_code` prototype for `steady_clock::now` for `mac/chrono.cpp`.
    78527852* Fully implement `mac/chrono.cpp` with error handling.
    78537853* Take care on POSIX systems when `CLOCK_STEADY` is not defined.
     
    79297929
    79307930[heading Which APIs have been chosen to implement each clock on each platform?]
    79317931
    7932 The following table presents a resume of which API is uused for each clock on each platform
     7932The following table presents a resume of which API is used for each clock on each platform
    79337933[table Clock API correspondence
    79347934    [[Clock]                                [Windows Platform]          [Posix Platform]                 [Mac Platform]  ]
    79357935    [[__system_clock]                     [GetSystemTimeAsFileTime]   [clock_gettime( CLOCK_REALTIME)] [gettimeofday]          ]