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

incorrect handling of unnumbered sections #433

Closed
ietf-svn-bot opened this issue Sep 23, 2019 · 6 comments
Closed

incorrect handling of unnumbered sections #433

ietf-svn-bot opened this issue Sep 23, 2019 · 6 comments

Comments

@ietf-svn-bot
Copy link

resolution_fixed type_defect | by julian.reschke@gmx.de


Consider an unnumbered top-level section last in . Whether it's numbered or not affects the numbering of the references section.

In the example, we get:

Table of Contents

   1.  Introduction
   2.  <xref> Tests
     2.1.  ...to <abstract> Element
     2.2.  ...to <aside> Element
     2.3.  ...to bare <artwork> Element
     2.4.  ...to <blockquote> Element
     2.5.  ...to <comment> Element
     2.6.  ...to <dl> Element
     2.7.  ...to <figure> Element
     2.8.  ...to <reference> Element
     2.9.  ...to <references> Element
     2.10. ...to <section> Element
     2.11. ...to unnumbered <section> Element
     2.12. ...to <section> Element inside <back>
     2.13. ...to unnumbered <section> Element inside <back>
     2.14. ...to <t> Element
   3.  Test Link Targets
     3.1.  Section Title
   Unnumbered Section Title
   5.  References
   Appendix A.  Appendix Title
   Unnumbered Appendix Title
   Author's Address

So the unnumbered section contributes to the numbering, but itself does not get numbered.

One way to fix this is to abort with an error, as per https://greenbytes.de/tech/webdav/rfc7991.html#element.section.attribute.numbered. The alternative would be to skip the section for the purpose of numbering (that's the approach now taken by rfc2629.xslt, in addition to a non-fatal error message).


Issue migrated from trac:433 at 2022-02-05 12:50:33 +0000

@ietf-svn-bot
Copy link
Author

@julian.reschke@gmx.de uploaded file xref-tests-rfc7991.xml2rfcv3.unpg (14.5 KiB)

@ietf-svn-bot
Copy link
Author

@julian.reschke@gmx.de uploaded file xref-tests-rfc7991.xml (28.0 KiB)

@ietf-svn-bot
Copy link
Author

@henrik@levkowetz.com changed component from Version_3_cli_txt to v3 vocabulary, v2 xml2rfc

@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 3cd533b:

Added a preptool check for numbered sections occurring after or under unnumbered sections, and changed the code for Reference sections to not emit section numbers if the previous section was unnumbered. Fixes issue #433

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