removed boost/stdint.h from documentation

[SVN r8175]

cstdint.htm

@@ -12,11 +12,10 @@
 <h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="center" width="277" height="86">Header
 boost/cstdint.hpp&nbsp;</h1>
 <p>The header <code><a href="../../boost/cstdint.hpp">&lt;boost/cstdint.hpp&gt;</a></code>
-places the contents of the header <code><a href="../../boost/stdint.h">&lt;boost/stdint.h&gt;</a></code>
+provides the typedef's useful for
-in namespace boost.&nbsp; That header consists entirely of typedef's useful for
+writing portable code that requires certain integer widths.  All typedef's are in namespace boost.</p>
-writing portable code that requires certain integer widths.</p>
 <p>The specifications are based on the ISO/IEC 9899:1999 C Language standard
-header stdint.h.&nbsp; The 64-bit types required by the C standard are not
+header &lt;stdint.h&gt;.&nbsp; The 64-bit types required by the C standard are not
 required in the boost header, and may not be supplied in all implementations,
 because <code>long long</code> is not [yet] included in the C++ standard.</p>
 <p>See <a href="cstdint_test.cpp">cstdint_test.cpp</a> for a test program.</p>
@@ -70,7 +69,7 @@ representing any value of any signed integer type.</p>
 capable of representing any value of any unsigned integer type.</p>
 <p>These types are required.</p>
 <hr>
-<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %b %Y" startspan -->29 Jun 2000<!--webbot bot="Timestamp" endspan i-checksum="15060" -->
+<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %b %Y" startspan -->12 Nov 2000<!--webbot bot="Timestamp" endspan i-checksum="15060" -->
 </p>
 <p>&nbsp;</p>
 

index.htm

@@ -34,19 +34,12 @@
       </a></code><a href="cstdint.htm"><br>
       documentation</a>
     </td>
-    <td valign="top">Contents of <code>&lt;boost/stdint.h&gt;</code> wrapped in namespace boost.</td>
+    <td valign="top">Typedef's based on the 1999 C Standard header &lt;<code>stdint.h&gt;</code>, wrapped in namespace boost.
+      This implementation may #include the compiler
+      supplied &lt;<code>stdint.h&gt;</code>, if present.  </td>
     <td valign="top">Supplies typedefs for standard integer types such as <code> int32_t</code> or <code>uint_least16_t</code>.
-      Use in preference to &lt;<code>stdint.h&gt;</code> or<code> &lt;boost/stdint.h&gt;</code>
+      Use in preference to &lt;<code>stdint.h&gt;</code>
-      because the names are safely placed in the boost namespace.</td>
+      for enhanced portability.  Furthermore, all names are safely placed in the boost namespace.</td>
-  </tr>
-  <tr>
-    <td align="center"><code><a href="../../boost/stdint.h">&lt;boost/stdint.h&gt;</a></code></td>
-    <td valign="top">Typedefs as defined in the C99 standard header &lt;<code>stdint.h&gt;</code>.
-      This implementation #includes the compiler
-      supplied &lt;<code>stdint.h&gt;</code>, if present.</td>
-    <td valign="top"> Supplied
-      for use in the implementation of &lt;boost/cstdint.hpp&gt; and to ease transition to the C99 standard.
-      Other uses are not recommended because this header places its names in the global namespace.&nbsp;</td>
   </tr>
   <tr>
     <td align="center"><code><a href="../../boost/integer_traits.hpp">&lt;boost/integer_traits.hpp&gt;</a></code><br>
@@ -70,17 +63,16 @@
 
 <h2>Rationale</h2>
 <p>The organization of boost integer headers and classes is designed to take
-advantage of <code>&lt;stdint.h&gt;</code> types from in the 1999 C standard
+advantage of <code>&lt;stdint.h&gt;</code> types from the 1999 C standard
 without resorting to undefined behavior in terms of
 the 1998 C++ standard.&nbsp; The header <code>&lt;boost/cstdint.hpp&gt;</code>
-makes the standard integer types safely available in namespace boost without placing any names in the
+makes the standard integer types safely available in namespace boost without placing any names in namespace std. As always, the intension is to complement rather than
-global namespace or namespace std. As always, the intension is to complement rather than
 compete with the C++ Standard Library.&nbsp; Should some future C++ standard
-include <code>&lt;stdint.h&gt;</code> and <code>&lt;cstdint&gt;</code>, then <code>&lt;boost/stdint.h&gt;</code> and <code>&lt;boost/cstdint.hpp&gt;</code>
+include <code>&lt;stdint.h&gt;</code> and <code>&lt;cstdint&gt;</code>, then <code>&lt;boost/cstdint.hpp&gt;</code>
 will continue to function, but will become redundant and may be safely deprecated.</p>
 <p>Because these are boost headers, their names conform to boost header naming
-conventions rather than C++ Standard Library header naming conventions.&nbsp; An
+conventions rather than C++ Standard Library header naming conventions.
-exception is <code>&lt;boost/stdint.h&gt; </code>which uses a <b> .h</b> extension to indicate its C rather than C++ heritage.</p>
+
 <h2>Caveat emptor</h2>
 <p>As an
       implementation artifact, certain C &lt;limits.h&gt; macro names may possibly be
@@ -88,9 +80,17 @@ visible to users of &lt;boost/cstdint.hpp&gt;.&nbsp; Don't use these macros; the
 any Boost specified interface.&nbsp;
       Use boost:: integer_traits&lt;&gt; or std::numeric_limits&lt;&gt; instead.</p>
 
+<p>
+As another implementation artifact, certain C
+<code>&lt;stdint.h&gt;</code> typedef names may possibly be visible in the
+global namespace to users of <code>&lt;boost/cstdint.hpp&gt;</code>.
+Don't use these names, they are not part of any Boost specified
+interface.  Use the respective names in namespace <code>boost</code>
+instead.
+
 <hr>
 
-<p>Revised: <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %b %Y" startspan -->10 Nov 2000<!--webbot bot="Timestamp" endspan i-checksum="15233" -->
+<p>Revised: <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %b %Y" startspan -->12 Nov 2000<!--webbot bot="Timestamp" endspan i-checksum="15233" -->
 </p>
 
 </body>