ietf-tools / xml2rfc

Generate RFCs and IETF drafts from document source in XML according to the IETF xml2rfc v2 and v3 vocabularies
https://ietf-tools.github.io/xml2rfc/
BSD 3-Clause "New" or "Revised" License
63 stars 35 forks source link

Non ideal line wrapping in cref indented text output #1088

Open kesara opened 5 months ago

kesara commented 5 months ago

Describe the issue

From John C Klensin:

... Just in case this has not been reported, the text rendering (at least) seems to get confused about line wrapping and insertion of "//". See, for example, the bottom of Section 8.1.1.1, bullet 1 of draft-ietf-emailcore-rfc5321bis-25.txt.

There is nothing special about the associated XML, just normal text between the and tags. If you go back a bit in the same section of that document, you will see another comment that is properly formatted (and marked up in exactly the same way). The only thing that appears different is the indentation level of the text in which the comment is embedded in the rendered version.

Example: https://www.ietf.org/archive/id/draft-ietf-emailcore-rfc5321bis-25.txt

       // NOTE IN DRAFT: Section numbers from RFC 8126 have been
       // deliberately omitted here and below in the expectation (or at
       // least hope) that document will be replaced or updated to
       contain
       // an explicit "two alternatives" model like this one before or
       soon
       // after this document is published.

Code of Conduct