Added What's In This Document

[SVN r35203]

doc/src/boost.xml

@@ -3,12 +3,24 @@
   "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
 <boostbook xmlns:xi="http://www.w3.org/2001/XInclude"
            last-revision="$Date$">
-  <title>The Boost C++ Libraries</title>
+  <title>The Boost C++ Libraries BoostBook Documentation Subset</title>
+
+  <preface id="about">
+    <title>What's Included in This Document</title>
+
+    <para>This document represents only a subset of the full Boost
+    documentation: that part which is generated from BoostBook or
+    QuickBook sources.  Eventually all Boost libraries may use these
+    formats, but in the meantime, much of Boost's documentation is not
+    available here.  Please
+    see <ulink
+    url="http://www.boost.org/libs">http://www.boost.org/libs</ulink>
+    for complete documentation.
+    </para>
 
-  <part id="libraries">
-    <title>The Boost C++ Libraries</title>
     <para>
-      Documentation for some libraries is available in alternative formats:
+      Documentation for some of the libraries described in this document is
+      available in alternative formats:
        <itemizedlist>
          <listitem>
            <simpara><ulink url="http://www.boost.org/doc/boost-doc-html.tar.gz">HTML (tarred, gzipped)</ulink></simpara>
@@ -32,6 +44,11 @@
        </itemizedlist>
     </para>
 
+  </preface>
+
+  <part id="libraries">
+    <title>The Boost C++ Libraries (BoostBook Subset)</title>
+
     <xi:include href="../../libs/any/doc/any.xml"/>
     <xi:include href="../../libs/array/doc/array.xml"/>