|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r71396 - trunk/libs/math/doc/sf_and_dist
From: pbristow_at_[hidden]
Date: 2011-04-20 13:24:56
Author: pbristow
Date: 2011-04-20 13:24:55 EDT (Wed, 20 Apr 2011)
New Revision: 71396
URL: http://svn.boost.org/trac/boost/changeset/71396
Log:
Minor edits.
Text files modified:
trunk/libs/math/doc/sf_and_dist/fp_facets.qbk | 23 +++++++++++++++++------
1 files changed, 17 insertions(+), 6 deletions(-)
Modified: trunk/libs/math/doc/sf_and_dist/fp_facets.qbk
==============================================================================
--- trunk/libs/math/doc/sf_and_dist/fp_facets.qbk (original)
+++ trunk/libs/math/doc/sf_and_dist/fp_facets.qbk 2011-04-20 13:24:55 EDT (Wed, 20 Apr 2011)
@@ -38,11 +38,11 @@
#include <boost\math\special_functions\nonfinite_num_facets.hpp>
-[h4 Introduction]
+[section:intro Introduction]
[h5 The Problem]
-The C++98 standard does not specify how infinity and NaN are represented in text streams.
+The C++98 standard does not specify how ['infinity] and ['NaN] are represented in text streams.
As a result, different platforms use different string representations.
This can cause undefined behavior when text files are moved between different platforms.
Some platforms cannot even input parse their own output!
@@ -189,7 +189,9 @@
[warning This implementation does not (yet) provide output of, or access to, the NaN payload.]
-[h4 Reference]
+[endsect] [/section:intro Introduction]
+
+[section:reference Reference]
[h5 The Facet `nonfinite_num_put`]
@@ -351,7 +353,10 @@
Same as `trap_infinity`, but positive and negative NaN are trapped instead.
-[h3 Examples]
+[endsect] [/section:reference Reference]
+
+
+[section:examples Examples]
[h5 Simple example with std::stringstreams]
@@ -481,13 +486,17 @@
A full demonstration of serialization by Francois Mauger is at
[@../../../example/nonfinite_num_facet_serialization.cpp]
-[h4 Portability]
+[endsect] [/section:examples Examples]
+
+[section:portability Portability]
This library uses the floating-point number classification and sign-bit from Boost.Math library,
and should work on all platforms where that library works.
See the portability information for that library.
-[h4 Design Rationale]
+[endsect] [/section:portability Portability]
+
+[section:rationale Design Rationale]
* The flags are implemented as a const data member of the facet.
Facets are reference counted, and locales can share facets.
@@ -506,6 +515,8 @@
It would be better if the facet set the fail bit of the stream.
However, facets derived from `std::num_put` do not have access to the stream state.
+[endsect] [/section:rationale Design Rationale]
+
[endsect] [/section:fp_facets Facets for Floating-Point Infinities and NaNs]
[/
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