|
|
@@ -114,18 +114,15 @@
|
|
|
<h2><a name="standards-conforming" id="standards-conforming">Standards
|
|
|
Conforming</a> Documentation</h2>
|
|
|
|
|
|
- <p>The documentation structure required for the standard is an
|
|
|
- effective way to describe the technical specifications for a
|
|
|
- library. Although terse, that format is familiar to many Boost
|
|
|
- users and is far more precise than most ad hoc formats.
|
|
|
- This section (apart from the introduction) is taken from the
|
|
|
- C++ standard's method of description (Section 17.3). The
|
|
|
- <a href="#more">following section</a> fleshes this out with
|
|
|
- more detail. Note
|
|
|
- that Standard proposals must include full standardese wording,
|
|
|
- which the committee will not do for you, to be accepted. That
|
|
|
- level of detail is not expected of Boost library
|
|
|
- documentation.</p>
|
|
|
+ <p>The documentation structure required for the C++ Standard is
|
|
|
+ an effective way to describe the technical specifications for
|
|
|
+ a library. Although terse, that format is familiar to many
|
|
|
+ Boost users and is far more precise than most ad hoc formats.
|
|
|
+ The following description is based upon §17.3 of the
|
|
|
+ Standard. (Note that while final Standard proposals must
|
|
|
+ include full standardese wording, which the committee will
|
|
|
+ not do for you, that level of detail is not expected of Boost
|
|
|
+ library documentation.)</p>
|
|
|
|
|
|
<h3><a name="elements" id="elements">Document elements</a></h3>
|
|
|
|