Re: [Boost-bugs] [Boost C++ Libraries] #1166: [boostbook] paths relative to boost.root

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #1166: [boostbook] paths relative to boost.root
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2008-03-31 20:36:43

#1166: [boostbook] paths relative to boost.root
-------------------------------+--------------------------------------------
  Reporter:  steven_watanabe   |       Owner:  danieljames  
      Type:  Feature Requests  |      Status:  assigned     
 Milestone:  To Be Determined  |   Component:  Documentation
   Version:  Boost 1.35.0      |    Severity:  Problem      
Resolution:                    |    Keywords:               
-------------------------------+--------------------------------------------
Changes (by danieljames):

  * owner:  => danieljames
  * status:  new => assigned
  * version:  Boost 1.34.1 => Boost 1.35.0
  * component:  Building Boost => Documentation
  * severity:  Not Applicable => Problem

Comment:

 Yes, this is definitely needed.

 {{{boost://libs/mpl/index.html}}} is probably wrong, as the {{{://}}}
 usually indicates that the first past part of the path is a server name.
 {{{boost:/libs/mpl/index.html}}} or perhaps
 {{{boost:libs/mpl/index.html}}} is better.

 Another possibility is to just do this for paths starting with '/', as
 that does suggest the root of the distribution. I like this, as I'm not
 keen on inventing our own protocol name. But 'boost:' will work very well
 if $boost.root == 'http://www.boost.org' - so it'll be ideal for candidate
 libraries.

 I'll attach an updated patch which implements what I described, and also
 fixes a small bug when the link is from a sub-directory.

 I'll bring this up on the Boost Docs list soon, as someone might have a
 better idea.

-- 
Ticket URL: <http://svn.boost.org/trac/boost/ticket/1166#comment:2>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.