Re: [boost] [QuickBook] missing prev/next

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: http://www.boost.org/doc/libs/1_45_0/doc/html/quickbook/install.html#quickbook.install.windows

> 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 :
$(BOOST_ROOT)"/bin.v2/tools/quickbook/src/msvc-8.0/debug/link-static/threading-multi/quickbook.exe"
: ;
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?

-- 
Lorenzo