|
|
@@ -149,6 +149,11 @@ library, but a reasonable effort to comply is expected.</p>
|
|
|
uppercase letter. Macro (gasp!) names should be all uppercase and begin with
|
|
|
BOOST_.</li>
|
|
|
</ul>
|
|
|
+<ul>
|
|
|
+ <li>Choose meaningful names - explicit is better than implicit, and readability counts.
|
|
|
+ There is a strong preference for clear and descriptive names, even if
|
|
|
+ lengthy.</li>
|
|
|
+</ul>
|
|
|
<ul>
|
|
|
<li>Use exceptions to report errors where appropriate, and write code that is
|
|
|
safe in the face of exceptions.</li>
|
|
|
@@ -294,17 +299,15 @@ detail, and over a long period of time. The discussion was repeated again in
|
|
|
early boost postings. A short summary:</p>
|
|
|
<ul>
|
|
|
<li>Naming conventions are contentious, and although several are widely used,
|
|
|
- no one style predominates.<br>
|
|
|
+ no one style predominates.
|
|
|
</li>
|
|
|
<li>Given the intent to propose portions of boost for the next revision of the
|
|
|
C++ standard library, boost decided to follow the standard library's
|
|
|
- conventions.<br>
|
|
|
+ conventions.
|
|
|
</li>
|
|
|
<li>Once a library settles on a particular convention, a vast majority of
|
|
|
- stakeholders want that style to be consistently used.<br>
|
|
|
+ stakeholders want that style to be consistently used.
|
|
|
</li>
|
|
|
- <li>There is a strong preference for clear and descriptive names, even if
|
|
|
- lengthy.</li>
|
|
|
</ul>
|
|
|
<hr>
|
|
|
<h3>Source <a name="code fonts">code fonts</a> rationale</h3>
|
|
|
@@ -336,7 +339,7 @@ suggestion. Major contributions are usually acknowledged in the
|
|
|
documentation, while minor fixes are often mentioned in comments within the code
|
|
|
itself.</p>
|
|
|
<hr>
|
|
|
-<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->29 January, 2001<!--webbot bot="Timestamp" endspan i-checksum="38328" --></p>
|
|
|
+<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->06 February, 2001<!--webbot bot="Timestamp" endspan i-checksum="40406" --></p>
|
|
|
|
|
|
</body>
|
|
|
|