Open ietf-svn-bot opened 3 years ago
@julian.reschke@gmx.de commented
That looks like a request for a new feature to me.
@cabo@tzi.org commented
Can you explain the provenance of the term "Part"? That large unit inside a document is rarely what is being referenced in, say, a W3C Rec.
@cabo@tzi.org commented
xml2rfc doc says:
If the reference is not an RFC or Internet-Draft that is in the v3 format, the element needs to have a "relative" attribute; in this case, the value of the "section" attribute is used to render the text of the external link.
Clearly, prepending the word "Part " before the value of the section attribute is a form of "using" the latter, but I'd consider this a deviation from the documentation. Maybe that word means something different to you.
@julian.reschke@gmx.de commented
Note that you should be able to use sectionFormat="bare" to suppress any defaults.
@julian.reschke@gmx.de commented
The issue here is that the processor has no way to determine the correct term unless it is indeed a section or appendix number.
FWIW, other use cases would be linking to chapters, figures, or tables.
A generic syntax that does not require bigger changes to the grammar would allow the author to exactly specify the text to be used.
For instance, for your use case:
so a quoted string inside the section attribute would indicate that the contents should be used verbatim.
(but in any case, this is a new feature and thus should be discussed on the v3 github)
@rjsparks@nostrum.com _changed status from new
to under_review
_
type_defect
| by cabo@tzi.orgThe current code seems to assume an xref with an @relative always goes to a "Part" if not a "Section" or "Appendix". The correct word in my test case would be "subregistry".
Test case:
Code:
Issue migrated from trac:652 at 2022-02-08 07:16:08 +0000