Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

content of xref element is not present in the output #571

Closed
ietf-svn-bot opened this issue Nov 16, 2020 · 4 comments
Closed

content of xref element is not present in the output #571

ietf-svn-bot opened this issue Nov 16, 2020 · 4 comments

Comments

@ietf-svn-bot
Copy link

resolution_fixed type_defect | by arusso@amsl.com


Seems when the target exactly matches the text within the xref element, the latter is not in the output.

<xref target="UML" format="default">UML
yields
[UML]

Expected output:
UML [UML]

Original (draft-ietf-ippm-twamp-yang-13):

   The figure is annotated
   with pointers to the UML [UML] diagrams provided...

"UML" is not in the output (all 3):

   The figure is annotated
   with pointers to the [UML] diagrams provided...

Files: (This is the XML upon v2->v3 conversion.)
https://www.rfc-editor.org/v3test/rfc8913.original.v2v3.xml
https://www.rfc-editor.org/v3test/rfc8913.original.v2v3.txt
https://www.rfc-editor.org/v3test/rfc8913.original.v2v3.html
https://www.rfc-editor.org/v3test/rfc8913.original.v2v3.pdf

One workaround is to put more text inside the xref element, e.g.,
UML diagrams yields

   The figure is annotated
   with pointers to the UML diagrams [UML] provided ...

Or if the target is changed, even simply to lowercase, then the issue doesn't occur. (Arguably, the disappearing text is preventing unnecessary repetition, but in some cases the repetition is the desired output.)


Issue migrated from trac:571 at 2022-02-08 07:11:10 +0000

@ietf-svn-bot
Copy link
Author

@henrik@levkowetz.com commented


This (suppressing identical strings) was intentional and based on legacy behaviour, I think; I'm perfectly happy to change it -- that will simplify the code and make the behaviour more predictable.

@ietf-svn-bot
Copy link
Author

@henrik@levkowetz.com changed status from new to closed

@ietf-svn-bot
Copy link
Author

@henrik@levkowetz.com changed resolution from `` to fixed

@ietf-svn-bot
Copy link
Author

@henrik@levkowetz.com commented


Fixed in 36a03e6:

Changed the output text for with text content equal to the reference tag to output both, rather than suppressing one. Fixes issue #571.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant