Browse Source

Merge auto-index fixes. Fixes #7899.

[SVN r83132]
Daniel James 13 years ago
parent
commit
376e7a8791
5 changed files with 36 additions and 15 deletions
  1. 29 9
      doc/Jamfile.v2
  2. 4 3
      doc/src/boost.xml
  3. 1 1
      libs/container
  4. 1 1
      libs/interprocess
  5. 1 1
      libs/intrusive

+ 29 - 9
doc/Jamfile.v2

@@ -8,6 +8,28 @@ import boostbook : boostbook ;
 
 
 alias asio : ../libs/asio/doc//asio/<xsl:param>boost.libraries=../../libs/libraries.htm ;
 alias asio : ../libs/asio/doc//asio/<xsl:param>boost.libraries=../../libs/libraries.htm ;
 
 
+#
+# Note that when refering to libraries that use auto-index we must process all the way to
+# docbook before including here.  We must also ensure that auto-index uses it's own index
+# generation, otherwise we get one big index that's repeated in each library.  Xslt's index
+# generation is also so slow that it's impractical for a build this large (takes ~ 9 hrs
+# to build with just 3 indexed libraries).  Hence we refer to these libraries as for example:
+#
+# ../libs/interprocess/doc//standalone/<format>docbook
+#
+# Within each library that uses this, make sure that the boostbook target contains
+#
+# <format>docbook:<auto-index-internal>on
+#
+# And if boost.root is set, restrict it to local html builds using:
+#
+# <format>html:<xsl:param>boost.root=../../../..
+# <format>html:<xsl:param>boost.libraries=../../../../libs/libraries.htm
+#
+# Finally, in boost.xml we xi:include interproces.auto_index.docbook which is the final
+# post-index generation docbook, rather than interprocess.xml which is the pre-indexed boostbook.
+#
+
 boostbook doc
 boostbook doc
     :
     :
     src/boost.xml
     src/boost.xml
@@ -44,14 +66,11 @@ boostbook doc
     <dependency>../libs/date_time/xmldoc//local_time_autodoc.xml
     <dependency>../libs/date_time/xmldoc//local_time_autodoc.xml
     <dependency>../tools/build/v2/doc//jam_docs
     <dependency>../tools/build/v2/doc//jam_docs
     <dependency>../tools/quickbook/doc//quickbook
     <dependency>../tools/quickbook/doc//quickbook
-    <dependency>../libs/interprocess/doc//autodoc.xml
-    <dependency>../libs/interprocess/doc//interprocess
-    <dependency>../libs/intrusive/doc//autodoc.xml
-    <dependency>../libs/intrusive/doc//intrusive
+    <dependency>../libs/interprocess/doc//standalone/<format>docbook
+    <dependency>../libs/intrusive/doc//standalone/<format>docbook
     <dependency>../libs/move/doc//autodoc.xml
     <dependency>../libs/move/doc//autodoc.xml
     <dependency>../libs/move/doc//move
     <dependency>../libs/move/doc//move
-    <dependency>../libs/container/doc//autodoc.xml
-    <dependency>../libs/container/doc//container
+    <dependency>../libs/container/doc//standalone/<format>docbook
     <dependency>../libs/units/doc//units
     <dependency>../libs/units/doc//units
     <dependency>../libs/unordered/doc//unordered
     <dependency>../libs/unordered/doc//unordered
     <dependency>../libs/thread/doc//thread
     <dependency>../libs/thread/doc//thread
@@ -82,9 +101,9 @@ boostbook doc
     <implicit-dependency>../tools/build/v2/doc//jam_docs
     <implicit-dependency>../tools/build/v2/doc//jam_docs
     <implicit-dependency>../tools/quickbook/doc//quickbook
     <implicit-dependency>../tools/quickbook/doc//quickbook
     <implicit-dependency>../libs/mpi/doc//mpi
     <implicit-dependency>../libs/mpi/doc//mpi
-    <implicit-dependency>../libs/container/doc//container
-    <implicit-dependency>../libs/interprocess/doc//interprocess
-    <implicit-dependency>../libs/intrusive/doc//intrusive
+    <implicit-dependency>../libs/container/doc//standalone/<format>docbook
+    <implicit-dependency>../libs/interprocess/doc//standalone/<format>docbook
+    <implicit-dependency>../libs/intrusive/doc//standalone/<format>docbook
     <implicit-dependency>../libs/move/doc//move
     <implicit-dependency>../libs/move/doc//move
     <implicit-dependency>../libs/units/doc//units
     <implicit-dependency>../libs/units/doc//units
     <implicit-dependency>../libs/unordered/doc//unordered
     <implicit-dependency>../libs/unordered/doc//unordered
@@ -108,3 +127,4 @@ install callouts : [ glob src/images/callouts/*.png ] : <location>html/images/ca
 explicit callouts ;
 explicit callouts ;
 
 
 
 
+

+ 4 - 3
doc/src/boost.xml

@@ -189,7 +189,7 @@
      </libraryinfo>
      </libraryinfo>
    </library>
    </library>
 
 
-   <xi:include href="container.xml"/>
+   <xi:include href="container.auto_index.docbook"/>
 
 
    <library name="Conversion" dirname="conversion" html-only="1"
    <library name="Conversion" dirname="conversion" html-only="1"
             url="../../libs/conversion/index.html">
             url="../../libs/conversion/index.html">
@@ -312,7 +312,7 @@
      </libraryinfo>
      </libraryinfo>
    </library>
    </library>
 
 
-   <xi:include href="interprocess.xml"/>
+   <xi:include href="interprocess.auto_index.docbook"/>
 
 
    <library name="Interval" dirname="numeric/interval" html-only="1"
    <library name="Interval" dirname="numeric/interval" html-only="1"
             url="../../libs/numeric/interval/doc/index.html">
             url="../../libs/numeric/interval/doc/index.html">
@@ -335,7 +335,7 @@
      </libraryinfo>
      </libraryinfo>
    </library>
    </library>
 
 
-   <xi:include href="intrusive.xml"/>
+   <xi:include href="intrusive.auto_index.docbook"/>
 
 
    <library name="I/O State Savers" dirname="io" html-only="1">
    <library name="I/O State Savers" dirname="io" html-only="1">
      <libraryinfo>
      <libraryinfo>
@@ -771,3 +771,4 @@
 </boostbook>
 </boostbook>
 
 
 
 
+

+ 1 - 1
libs/container

@@ -1 +1 @@
-Subproject commit 368a0caec973f685640aef74ade1c15f06190abf
+Subproject commit 14f376128a25d6aef044e405d7f7c9e76a14e7ac

+ 1 - 1
libs/interprocess

@@ -1 +1 @@
-Subproject commit 0d1d9397197c20d73940c46ab8c6ab197f29f617
+Subproject commit 7123037c352d287f263ba1e3066f316306cc8883

+ 1 - 1
libs/intrusive

@@ -1 +1 @@
-Subproject commit e3773373d78d5d3e1ae4497b1adc26c6ef326bb5
+Subproject commit 8b917e96a7bb7317fee693611b4834c4ae553153

粤ICP备19079148号