howto.html: Finish allocator notes (inst and 3.0).

2001-11-29  Phil Edwards  <pme@gcc.gnu.org>

	* docs/html/ext/howto.html:  Finish allocator notes (inst and 3.0).

From-SVN: r47452

diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog
index 083f41237021dabdb0fb2ce0912ce48bb3210dc7..58e899f3cfca1e880a6b84b12afde18e01eb86e1 100644 (file)
--- a/libstdc++-v3/ChangeLog
+++ b/libstdc++-v3/ChangeLog
@@ -1,3 +1,7 @@
+2001-11-29  Phil Edwards  <pme@gcc.gnu.org>
+
+       * docs/html/ext/howto.html:  Finish allocator notes (inst and 3.0).
+
 2001-11-29  Benjamin Kosnik  <bkoz@redhat.com>
 
        * include/bits/locale_facets.tcc (num_get::do_get(long double)):

diff --git a/libstdc++-v3/docs/html/ext/howto.html b/libstdc++-v3/docs/html/ext/howto.html
index 53c29498d0010beaf395cdff03d1b987920b5ee7..e5518cf9a9981b71392721d053a790f2833da4e7 100644 (file)
--- a/libstdc++-v3/docs/html/ext/howto.html
+++ b/libstdc++-v3/docs/html/ext/howto.html
@@ -276,6 +276,9 @@
       <code>__alloc</code> should not be noticably slower than
       <code>__single_client_alloc</code>.)
    </p>
+   <p>[Another threadsafe allocator where each thread keeps its own free
+      list, so that no locking is needed, might be described here.]
+   </p>
    <h3>A cannon to swat a fly:<code>  __USE_MALLOC</code></h3>
    <p>If you've already read <a href="../23_containers/howto.html#3">this
       advice</a> and decided to define this macro, then the situation changes
@@ -320,16 +323,30 @@
       <code>__default_alloc_template</code> classes take an integer parameter,
       called inst here.  This number is completely unused.
    </p>
-   <p>  More soon.
+   <p>The point of the number is to allow multiple instantiations of the
+      classes without changing the semantics at all.  All three of
+      <pre>
+    typedef  __default_alloc_template&lt;true,0&gt;    normal;
+    typedef  __default_alloc_template&lt;true,1&gt;    private;
+    typedef  __default_alloc_template&lt;true,42&gt;   also_private;</pre>
+      behave exactly the same way.  However, the memory pool for each type
+      (and remember that different instantiations result in different types)
+      remains separate.
    </p>
-   <p>
+   <p>The library uses <strong>0</strong> in all its instantiations.  If you
+      wish to keep separate free lists for a particular purpose, use a
+      different number.
    </p>
    <h3>3.0.x</h3>
-   <p>I don't even remember.  More soon.
+   <p>For 3.0.x, many of the names were incorrectly <em>not</em> prefixed
+      with underscores.  So symbols such as &quot;std::single_client_alloc&quot;
+      are present.  Be very careful to not depend on these names any more
+      than you would depend on implementation-only names.
    </p>
-   <p>
+   <p>Certain macros like <code>_NOTHREADS</code> and <code>__STL_THREADS</code>
+      can affect the 3.0.x allocators.  Do not use them.
    </p>
-   <p>
+   <p>More notes as we remember them...
    </p>
    <p>Return <a href="#top">to top of page</a> or
       <a href="../faq/index.html">to the FAQ</a>.