[dapper] xreflabel considered harmful

Rocco Stanzione grasshopper at linuxkungfu.org
Sun Apr 16 00:40:17 UTC 2006


On Saturday 15 April 2006 17:39, Matthew East wrote:
> Why? You should just take it out completely, then the link uses the text
> from the section's title. You shouldn't need to change any strings. In
> terms of making sense, the stylesheets should deal with it. So a section
> with a title of "Bug Trackers", referred to in a linkend, will generally
> appear like this with most stylesheets: "the section called Bug
> Trackers". With the Yelp stylesheets, it will often look something like
> "Chapter 5, Bug Trackers".
>
> It really shouldn't be any problem simply to remove them.

I wouldn't be able to tell you where, but I'm certain I've seen (maybe even 
implemented) instances of this where the tag was used deliberately because 
simply using the section's title would interrupt the narrative flow of the 
sentence calling the xref.  I don't know how easy it is to reverse-resolve 
the xref so we can see whether that's the case, but I think the safe bet is 
that the author used the tag deliberately.

Rocco Stanzione




More information about the ubuntu-doc mailing list