Boost logo

Boost :

Subject: Re: [boost] [QuickBook] missing prev/next
From: Lorenzo Caminiti (lorcaminiti_at_[hidden])
Date: 2011-01-07 12:26:56

On Fri, Jan 7, 2011 at 11:58 AM, Daniel James <dnljms_at_[hidden]> wrote:
> On 7 January 2011 16:29, Lorenzo Caminiti <lorcaminiti_at_[hidden]> wrote:
>> I installed xsltproc and docbook following the instructions on the
>> Boost website for Windows (but I am sure I messed up something...). Is
>> there a way I can check/post specific XSL/DocBook configuration files?
>> Where are these configuration files?
> There are a few different places with installation instructions - can
> you link to the page you followed? Also are you using cygwin and did

I followed:

> you use the setup_boostbook script, or did you write your
> user-config.jam yourself? Can you post your user-config.jam if you
> did.

I am not using CygWin. I wrote my user-config.jam:

import os ;
local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;

using msvc ; # Toolset.

# Boost.QuickBook (and related tools).
using quickbook :
: ;
using xsltproc : "C:/Users/example/Documents/boost/xml/bin/xsltproc.exe" ;
using boostbook : "C:/Users/example/Documents/boost/xml/docbook-xsl" :
"C:/Users/example/Documents/boost/xml/docbook-xml" ;
using doxygen : "C:/Program Files/doxygen/bin/doxygen.exe" ;

>> Also, how can I get the Doxygen reference documentation to have hyper
>> links? I would like for both for Doxygen to link Doxygen pages as well
>> as the QuickBook sections. I had to manually use the <a> HTML command
>> but it that is not ideal and it broke in the build you have posted on
>> boost-sandbox website...
> I'm not sure as I don't use doxygen, I'll look into it. Can you link
> to a page where it didn't work? I can't find any anchors in your
> headers.

I am using the @Ref (link to from Doxygen to Doxygen) and @Sect (link
from Doxygen to QuickBook) alias defined in the jamfile.jam which
expand to a <a>...</a> HTML commands -- this is probably a bad idea,
that's why I am asking how to do this right.

However, I just realized that this manual <a> command also work in the
documentation build you generated (before I was getting an error on
something else... sorry). That said, is there a better way to link
from Doxygen to other Doxygen pages and to QuickBook pages when the
Doxygen documentation is generated for QuickBook?


Boost list run by bdawes at, gregod at, cpdaniel at, john at