[Boost-bugs] [Boost C++ Libraries] #2712: Quickbook uses article title rather than article id for links

Subject: [Boost-bugs] [Boost C++ Libraries] #2712: Quickbook uses article title rather than article id for links
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2009-02-02 12:57:59

#2712: Quickbook uses article title rather than article id for links
---------------------------------------------+------------------------------
 Reporter:  pbristow                         |       Owner:  danieljames
     Type:  Bugs                             |      Status:  new        
Milestone:  Boost 1.38.0                     |   Component:  None       
  Version:  Boost 1.37.0                     |    Severity:  Cosmetic   
 Keywords:  quickbook link article id title  |  
---------------------------------------------+------------------------------
 This Quickbook with a long title but short id

 [article Title of test of quickbook
     [quickbook 1.4]
     [id quick_test]
     [authors [Bristow, Paul A.]]
     [copyright 2009 Paul A. Bristow]
     [license
         Distributed under the Boost Software License, Version 1.0.
         (See accompanying file LICENSE_1_0.txt or copy at
         [@http://www.boost.org/LICENSE_1_0.txt])
     ]
     [source-mode c++]
     [purpose  test of links that include title or article id.]
 ]


 [/ I expect that link would start with article id:  quick_test]
 [/ And NOT the converted article title "Title of test of quickbook"
 [def __test_link [link quick_test.my_section1 Section One]]

 [section: my_section1 This is my 1st section]

 Section 1
 ...

 [endsect] [/section: my_section1 This is my 1st section]

 [/ test_q.qbk
   Copyright 2009 Paul A. Bristow.
   Distributed under the Boost Software License, Version 1.0.
   (See accompanying file LICENSE_1_0.txt or copy at
   http://www.boost.org/LICENSE_1_0.txt).
 ]

 produces this output

 Note the

 <section id="quick_test._my_section1_this_is_my_1st_section">
                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 uses the converted title, and not the article id, as I expected.

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
 "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
 <article id="quick_test" name="Title of test of quickbook"
 dirname="quick_test" last-revision="$Date: 2009/02/02 12:46:50 $"
  xmlns:xi="http://www.w3.org/2001/XInclude">
   <articleinfo>
     <authorgroup>
     <author>
       <firstname>Paul A.</firstname> <surname>Bristow</surname>
     </author>
     </authorgroup>
     <copyright>
       <year>2009</year> <holder>Paul A. Bristow</holder>
     </copyright>
     <legalnotice>
       <para>
         Distributed under the Boost Software License, Version 1.0. (See
 accompanying
         file LICENSE_1_0.txt or copy at <ulink
 url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt>)
       </para>
     </legalnotice>
     <articlepurpose>
       test of links that include title or article id.
     </articlepurpose>
   </articleinfo>
   <title>Title of test of quickbook</title>
   <para>
     [/ And NOT the converted article title &quot;Title of test of
 quickbook&quot;
   </para>
   <section id="quick_test._my_section1_this_is_my_1st_section">
     <title><link linkend="quick_test._my_section1_this_is_my_1st_section">
 my_section1
     This is my 1st section</link></title>
     <para>
       Section 1 ...
     </para>
   </section>
 </article>

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