This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
“Definitions” have anchors that allow them to be addressed by cross-references, but you should note that cross-references are text hyperlinks that have no identifier by which a reader can find the definition without using the hyperlink. That is to say when I see: *** A lexical QName with a prefix can be converted into an expanded QName by resolving its namespace prefix to a namespace URI, using the statically known namespaces. (in the paragraph following production [118] of XPath 3.1) *** The hyperlinks in the original will take me to various parts of the document where these definitions occur, but if I have printed the document, I have no clue where to look for these definitions. The better practice is to number all the definitions and since they are all self-contained, to put them in a single location. Additionally, all interlinear references to those definitions (or other internal cross-references) should have a visible reference that enables a reader to find the definition or cross-reference, without use of an internal hyperlink. Example: *** A lexical QName Def-21 with a prefix can be converted into an expanded QName Def-19 by resolving its namespace prefix to a namespace URI, using the statically known namespaces. Def-99 [These are fake links to draw your attention to the text in question. The Def numbers are fictitious in this example. Actual references would have the visible definition numbers assigned to the appropriate definition.] ***
(Personal response). The Working Groups decided many years ago not to produce "print" versions of the specifications; there was some experimenal work to do so, but no-one felt the results were very satisfactory. Our only definitive publication is in hypertext designed for online viewing, and if you attempt to print that hypertext and find the results unsatisfactory, that is not our problem. I would encourage you to use the specs the way they are designed to be used, namely online hypertext browsing. For that usage, attaching reference numbers to every link and every anchor would be extremely distracting, especially for those specs like XSLT that are very heavily hyperlinked. Alternatively, we publish the XML, so if you want an alternative rendition, you could work from the XML master.
*** Bug 28013 has been marked as a duplicate of this bug. ***
*** Bug 28014 has been marked as a duplicate of this bug. ***
The Working Group discussed this bug (together with 28013 and 28014) and decided to resolve as WONTFIX, accepting the rationale offered by Mike Kay in comment 1 (namely: for better or worse, the specs are written to be read in an interactive hypertext system, not on paper). Many thanks for taking the time to review these documents.
I strongly disagree with forcing readers into a particular mode of reading to use the text. Having said that, the wg has chosen otherwise. If IP restrictions allow, I will seek some other remedy for this issue.