Re: [Boost-bugs] [Boost C++ Libraries] #4128: Inspect script finds many Docutils-generated duplicate bookmarks

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #4128: Inspect script finds many Docutils-generated duplicate bookmarks
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2010-04-21 12:09:59

#4128: Inspect script finds many Docutils-generated duplicate bookmarks
---------------------------+------------------------------------------------
  Reporter:  jewillco      |       Owner:  johnmaddock      
      Type:  Bugs          |      Status:  closed           
 Milestone:  Boost 1.43.0  |   Component:  inspection script
   Version:  Boost 1.42.0  |    Severity:  Problem          
Resolution:  invalid       |    Keywords:                   
---------------------------+------------------------------------------------

Comment(by danieljames):

 Looking at the MPL documentation, inspect seems to be complaining about
 things like:

 {{{
 <div class="section" id="the-problem">
 <h2><a name="the-problem">The Problem</a></h2>
 ...
 </div>
 }}}

 which is valid, since both the `name` and `id` attributes are unique. IIRC
 modern browsers will use the `id` and ignore the `name` in this case.
 Although, it's a pain for inspect to recognise that the `id` and `name`
 are basically at the same point. I also try to avoid putting any content
 inside anchors used as bookmarks, as it makes them look like links, when
 they aren't (you can see this in the
 [http://www.boost.org/doc/libs/1_42_0/libs/mpl/doc/tutorial/broken-

 integral-constant.html MPL documentation]).

 Inspect is probably wrong to complain about this case, but it's not very
 good use of html.

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