Boost C++ Libraries: Ticket #4128: Inspect script finds many Docutils-generated duplicate bookmarks

Daniel James — Tue, 20 Apr 2010 19:22:47 GMT

That's a legitimate issue. Id's in a html document should be unique. I'm surprised that docutils would generate such markup, there's probably some configuration to stop it, or the generated documentation could be run through tidy.

status changed; resolution set

John Maddock — Wed, 21 Apr 2010 09:01:11 GMT

status new → closed
resolution → invalid

I believe this should be reported to the docutils guys - it appears not to be within our control to fix this?

Closing down for now.

John.

Daniel James — Wed, 21 Apr 2010 12:09:59 GMT

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 MPL documentation).

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