Re: [Boost-bugs] [Boost C++ Libraries] #2701: Quickbook docs on internal link may be misleading

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #2701: Quickbook docs on internal link may be misleading
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2009-02-02 11:03:09

#2701: Quickbook docs on internal link may be misleading
-------------------------------+--------------------------------------------
  Reporter:  pbristow          |       Owner:  eric_niebler          
      Type:  Feature Requests  |      Status:  new                   
 Milestone:  Boost 1.39.0      |   Component:  quickbook             
   Version:  Boost 1.37.0      |    Severity:  Cosmetic              
Resolution:                    |    Keywords:  Quickbook link article
-------------------------------+--------------------------------------------

Comment(by pbristow):

 OK fine - this is not urgent, but when you have nothing better to do ;-)

 <?xml version="1.0"?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www

 .oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <article
 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision"
 id="SVG_plot" name="SVG Plot Manual document title" dirname="SVG_plot" rev
 :last-revision="$Date: 2009/02/02 10:46:37 $">

 has the title, ID and dirname as we both expect.

 But am I wrong to be surprised that the section id comes from the title,
 and not from the id

   <title>SVG Plot Manual document title</title>
   <section id="svg_plot_manual_document_title.howtouse">
     <title><link linkend="svg_plot_manual_document_title.howtouse"> How To
 Use This
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 Perhaps this is a feature?

 (I'm also uncertain (but that's not uncommon) what dirname is intended
 for).

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