Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r62517 - branches/units/autoprefix/libs/units/doc
From: steven_at_[hidden]
Date: 2010-06-07 16:28:45


Author: steven_watanabe
Date: 2010-06-07 16:28:43 EDT (Mon, 07 Jun 2010)
New Revision: 62517
URL: http://svn.boost.org/trac/boost/changeset/62517

Log:
Move autoscale documentation to the appropriate place in Examples
Text files modified:
   branches/units/autoprefix/libs/units/doc/units.qbk | 108 ++++++++++++++++++++--------------------
   1 files changed, 54 insertions(+), 54 deletions(-)

Modified: branches/units/autoprefix/libs/units/doc/units.qbk
==============================================================================
--- branches/units/autoprefix/libs/units/doc/units.qbk (original)
+++ branches/units/autoprefix/libs/units/doc/units.qbk 2010-06-07 16:28:43 EDT (Mon, 07 Jun 2010)
@@ -365,60 +365,6 @@
 
 [endsect] [/section Scaled Units]
 
-[section:autoscale Automatically Scaled Units]
-
-It is often desirable to scale a [___unit] automatically, depending on its value,
-to keep the integral part in a limited range, usually between 1 and 999.
-
-For example, using [@http://en.wikipedia.org/wiki/Engineering_notation engineering notation prefixes],
-
- "1234.5 m" is more helpfully displayed as "1.234 km"
- "0.000000001234 m" is more clearly displayed as "1.2345 nanometer".
-
-The iostream manipulators `engineering_prefixes` or `binary_prefixes` make this easy.
-
-[import ../example/autoprefixes.cpp]
-
-[autoprefixes_snippet_1]
-
-(The complete set of [@http://physics.nist.gov/cuu/Units/prefixes.html engineering and scientific multiples]
-is not used (not centi or deci for example), but only powers of ten that are multiples of three, 10^3).
-
-Similarly, the equivalent [@http://en.wikipedia.org/wiki/Binary_prefixes binary prefixes]
-used for displaying computing kilobytes, megabytes, gigabytes...
-
-These are the 2^10 = 1024, 2^20 = 1 048 576, 2^30 ... multiples.
-
-(See also [@http://physics.nist.gov/cuu/Units/binary.html Prefixes for binary multiples]
-
-This scale is specified in IEC 60027-2, Second edition, 2000-11,
-Letter symbols to be used in electrical technology -
-Part 2: Telecommunications and electronics).
-
-[autoprefixes_snippet_2]
-
-But note that scalar dimensionless values, like int, float and double,
-are *not* prefixed automatically by the engineering_prefix or binary_prefix iostream manipulators.
-
-[autoprefixes_snippet_3]
-
-You can output the name or symbol of a unit (rather than the most common quantity of a unit).
-
-[autoprefixes_snippet_4]
-
-Note too that all the formatting flags are persistent,
-so that if you set engineering_prefix, then it applies to all future outputs,
-until you select binary_prefix, or explicitly switch autoprefix off.
-You can specify no prefix (the default of course) in two ways:
-
-[autoprefixes_snippet_5]
-
-And you can get the format flags for diagnosing problems.
-
-[autoprefixes_snippet_6]
-
-[endsect] [/section:autoscale Automatically Scaled Units]
-
 [endsect] [/section:Units Units]
 
 [section:Quantities Quantities]
@@ -1017,6 +963,60 @@
 
 [endsect]
 
+[section:autoscale Automatically Scaled Units]
+
+It is often desirable to scale a [___unit] automatically, depending on its value,
+to keep the integral part in a limited range, usually between 1 and 999.
+
+For example, using [@http://en.wikipedia.org/wiki/Engineering_notation engineering notation prefixes],
+
+ "1234.5 m" is more helpfully displayed as "1.234 km"
+ "0.000000001234 m" is more clearly displayed as "1.2345 nanometer".
+
+The iostream manipulators `engineering_prefixes` or `binary_prefixes` make this easy.
+
+[import ../example/autoprefixes.cpp]
+
+[autoprefixes_snippet_1]
+
+(The complete set of [@http://physics.nist.gov/cuu/Units/prefixes.html engineering and scientific multiples]
+is not used (not centi or deci for example), but only powers of ten that are multiples of three, 10^3).
+
+Similarly, the equivalent [@http://en.wikipedia.org/wiki/Binary_prefixes binary prefixes]
+used for displaying computing kilobytes, megabytes, gigabytes...
+
+These are the 2^10 = 1024, 2^20 = 1 048 576, 2^30 ... multiples.
+
+(See also [@http://physics.nist.gov/cuu/Units/binary.html Prefixes for binary multiples]
+
+This scale is specified in IEC 60027-2, Second edition, 2000-11,
+Letter symbols to be used in electrical technology -
+Part 2: Telecommunications and electronics).
+
+[autoprefixes_snippet_2]
+
+But note that scalar dimensionless values, like int, float and double,
+are *not* prefixed automatically by the engineering_prefix or binary_prefix iostream manipulators.
+
+[autoprefixes_snippet_3]
+
+You can output the name or symbol of a unit (rather than the most common quantity of a unit).
+
+[autoprefixes_snippet_4]
+
+Note too that all the formatting flags are persistent,
+so that if you set engineering_prefix, then it applies to all future outputs,
+until you select binary_prefix, or explicitly switch autoprefix off.
+You can specify no prefix (the default of course) in two ways:
+
+[autoprefixes_snippet_5]
+
+And you can get the format flags for diagnosing problems.
+
+[autoprefixes_snippet_6]
+
+[endsect] [/section:autoscale Automatically Scaled Units]
+
 [section:ConversionFactor Conversion Factor]
 
 This code demonstrates the use of the `conversion_factor` free function to determine


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