Boost logo

Boost-Commit :

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]
 


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk