[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