Subject: [xml2rfc] #144: Does not allow RFC editor style guide order of sections for references

From: "xml2rfc issue tracker" <[email-masked]>
Date: Mon, 18 Mar 2013 21:12:07 -0000

#144: Does not allow RFC editor style guide order of sections for references

 The RFC-editor style guide:

 http://www.rfc-editor.org/rfc-style-guide/rfc-style

 States that the following section order within the body of the memo:
       8.  Body of the Memo              [Required]
         8a.  Introduction               [Required]
                or equivalent
         8b.  Requirement Words (RFC 2119)
         8c.  ...
              MAIN BODY OF THE TEXT
         8t.  ...
         8u.  Security Considerations   [Required]
         8v.  IANA Considerations
         8w.  Appendixes
         8x.  References
         8y.  Contributors
         8z.  Acknowledgments
       9. Author's Address             [Required]

 My issues is that the XML2RFC and likely the DTD does not allow me to
 place the References list after the appendixes. This is problematic:

 First it is difficult to find references when having long documents. In
 draft-ietf-mmusic-rfc2326bis, the references are on page 216 out of 284.

 I also wished I could use it as work around for ID-Nits which produces
 Unused reference warnings for any references that are only used in
 appendices.

-- 
--------------------------------------------+------------------------------
 Reporter:  [email-masked]  |      Owner:
     Type:  defect                          |  [email-masked]
 Priority:  medium                          |     Status:  new
Component:  Version 2 cli                   |  Milestone:
 Keywords:                                  |    Version:  2.3.10
--------------------------------------------+------------------------------

Ticket URL: <http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/144>
xml2rfc <http://tools.ietf.org/tools/xml2rfc/>