[Boost-commit] svn:boost r52398 - in branches/release: . tools/boostbook/doc tools/quickbook/doc

Subject: [Boost-commit] svn:boost r52398 - in branches/release: . tools/boostbook/doc tools/quickbook/doc
From: daniel_james_at_[hidden]
Date: 2009-04-15 03:37:47

Author: danieljames
Date: 2009-04-15 03:37:45 EDT (Wed, 15 Apr 2009)
New Revision: 52398
URL: http://svn.boost.org/trac/boost/changeset/52398

Log:
Document 'boost:' links in boostbook & quickbook.

Merged revisions 52352 via svnmerge from 
https://svn.boost.org/svn/boost/trunk

........
  r52352 | danieljames | 2009-04-12 12:21:59 +0100 (Sun, 12 Apr 2009) | 3 lines
  
  Document 'boost:' links in boostbook & quickbook.
  
  Fixes #2861.
........

Properties modified: 
   branches/release/   (props changed)
Text files modified: 
   branches/release/tools/boostbook/doc/together.xml  |    12 ++++++++++++                            
   branches/release/tools/quickbook/doc/quickbook.qbk |    12 ++++++++++++                            
   2 files changed, 24 insertions(+), 0 deletions(-)

Modified: branches/release/tools/boostbook/doc/together.xml
==============================================================================
--- branches/release/tools/boostbook/doc/together.xml	(original)
+++ branches/release/tools/boostbook/doc/together.xml	2009-04-15 03:37:45 EDT (Wed, 15 Apr 2009)
@@ -51,6 +51,18 @@
     url="http://www.boost.org"&gt;Boost&lt;/ulink&gt;,</code> which
     appears in the document like this: <ulink
     url="http://www.boost.org">Boost</ulink>.</para>
+    
+    <para>In BoostBook, &lt;ulink&gt; supports a custom url schema for
+    linking to files within the boost distribution. This is formed by
+    setting the <code>url</code> attribute to <code>boost:</code>
+    followed by the file's path. For example, we can link to the
+    flyweight library with
+    <code>&lt;ulink
+    url="boost:/libs/flyweight/index.html"&gt;Boost.Flyweight&lt;/ulink&gt;</code>,
+    which will appear like this: <ulink
+    url="boost:/libs/flyweight/index.html">Boost.Flyweight</ulink>.
+    This schema is only supported for BoostBook &lt;ulink&gt; elements.
+    It isn't available for any other elements or in Docbook.</para>
 
     <para>The &lt;classname&gt;, &lt;functionname&gt;,
     &lt;methodname&gt;, and &lt;libraryname&gt; link to classes,

Modified: branches/release/tools/quickbook/doc/quickbook.qbk
==============================================================================
--- branches/release/tools/quickbook/doc/quickbook.qbk	(original)
+++ branches/release/tools/quickbook/doc/quickbook.qbk	2009-04-15 03:37:45 EDT (Wed, 15 Apr 2009)
@@ -492,6 +492,18 @@
 
 see [@http://spirit.sourceforge.net/]
 
+Boostbook also support a custom url schema for linking to files within
+the boost distribution:
+
+[pre
+'''[@boost:/libs/spirit/index.html the Boost.Spirit documentation]'''
+]
+
+will generate: [@boost:/libs/spirit/index.html the Boost.Spirit documentation]
+
+Note that this is only available when using BoostBook, and only for links
+- it can't be used for images.
+
 [endsect]
 [section Anchor links]