metanorma-nist 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed6d6518c86f59d927b205f623877b3e860e6874d561e1748b53142ee6d26d25
-  data.tar.gz: 881aa89fd9aeceea3216f116fb5465fd2082bd636f77d6f4dbf6b15ef08a7ba6
+  metadata.gz: a296f752c16a5279fad1ac980465232967eee37122eb4f746109b4b6d27ff3e6
+  data.tar.gz: a9171483b061e88d6113149a523e04d6d18a8da3aa2edeeb5dfd999cad68bde9
 SHA512:
-  metadata.gz: b468ba8980ad51e00d0ffddc0d09b3440fe6d1d2d381df330f2807cfdb476d460469a62fb36be75e0b031950a99394f0458236d442030540c5787bfcb51cde4d
-  data.tar.gz: '0012912ef3a4dc926c45432ab69c30af5dd771b3042ca86e30615d892ca1eb1281d06dff0dc8372697e3a9b8e2f164ec3b2cbcf7447a1b8191e36a30632bfa23'
+  metadata.gz: 70afce02c91127a9e83bf4e38f34d7562dd48eb844efac9e13995717022b927f9d4431bb2fde216f9ac3cb2c18a6dffaf330cd74a84f138bfd7daa8071d13702
+  data.tar.gz: c82dcd587d815256fd895edb0fa4ff73502e6d6a15507bfa22fb5ce0a40efcde5381b0dbe9ccb253c02fbe5de078c95cd3e0899e857314d6d59f48e89a494de3

data/README.adoc

@@ -128,9 +128,7 @@ the document was issued.
 (mandatory). If absent, the first line of the AsciiDoc document, which contains the title
 introduced with `=`, is used.
 
-`:title-sub:`:: The subtitle of the document.
-
-`:technical-committee:`:: The name of the relevant committee producing the document (mandatory). 
+`:technical-committee:`:: The name of the relevant committee producing the document.
 
 `:published-date:`:: The publication date for the document.
 
@@ -142,8 +140,8 @@ docnumber-edition (if edition is present)
 
 `:docidentifier:`:: The document identifier for the document. Normally this should not be supplied,
 as the document identifier is composed from the document series, document number, 
-and edition/revision. If the `:docidentifier:` value is provided, it will override this composed
-value.
+and edition/revision (e.g. _NIST SP 800 Revision 1_). 
+If the `:docidentifier:` value is provided, it will override this composed value.
 
 `:edition:`:: Edition (revision) of the document. The value of
 this attribute will be displayed as part of the heading, prefixed with "Revision".
@@ -158,48 +156,44 @@ this attribute will be displayed as part of the heading, prefixed with "Revision
 * `withdrawn`
 --
 
-////
+`:fullname{_i}:`, `:affiliation{_i}:`, `:address{_i}`::
+The full name of a person who is a contributor to the document,
+their organization, and the address of that person or organization.
+In NIST, only the city is given as the address.
+A second person is indicated by using a numeric suffix: `:fullname:`, `:fullname_2:`, `fullname_3:`, &c.
+The same convention applies to all the following attributes.
 
-`:doctype:`:: The document type (mandatory). The permitted types are:
-+
---
-* Standards
-`standard`::: Implementation Standard
-`standard-with-suite`::: Implementation Standard with Compliance Suite
-`abstract-specification`::: Abstract Specification
-`community-standard`::: Community Standard
-`profile`::: Profile / Application Profile
-`best-practice`::: Best Practices Document
-
-* Other
-`engineering-report`::: Engineering Report
-`discussion-paper`::: Discussion Paper
-`reference-model`::: OGC Reference Model
-`user-guide`::: User Guide
-`policy`::: OGC Policy Document
-`guide`::: Guide
-`amendment`::: Technical Amendment
-`technical-corrigendum`::: Corrigendum (errata) Changes to OGC Standards
-`administrative`::: Internal administrative documents
---
+[[surname]] `:surname{_i}:`::
+The surname of a person who is a contributor to the document.
 
-`:committee:`:: The name of the relevant committee producing the document (mandatory). The legal values are:
-`technical`, `planning`, `strategic-member-advisory`
-`:subcommittee:`:: The name of the relevant subcommittee producing the document
-`:workgroup:` (OGC: `:workingGroup:`):: The name of the relevant working group producing the document (mandatory)
+[[givenname]] `:givenname{_i}:`::
+The given name(s) of a person who is a contributor to the document.
 
-`:published-date:` (OGC: `:publicationDate:`):: The publication date for the document.
-`:issued-date:`  (OGC: `:approvalDate:`):: The approval date for the document.
-`:created-date:`:: The creation date for the document.
-`:received-date:`  (OGC: `:submissionDate:`):: The date at which the document was submitted to the standards body.
+`:initials{_i}:`::
+The initials(s) of a person who is a contributor to the document.
 
-////
+[[role]] `:role{_i}:`::
+The role of a a person who is a contributor to the document.
+By default, they are coded as an `editor`; they can also be represented as an `author`.
+
+`:affiliation{_i}:`::
+The organizational affiliation of a person who is a contributor to the document.
+
+`:address{_i}:`::
+The organizational address of a person who is a contributor to the document.
+
+`:obsoleted-date:`::
+The date at which a document is considered no longer valid (withdrawn). If a document
+is not currently withdrawn (as indicated through `:status: withdrawn`),
+but will be in the future, that is still indicated in the rendering of the document.
 
 === NIST-specific attributes
 
 The following document attributes are specific to this document class:
 
-`:subtitle:`:: Document subtitle.
+`:title-sub:`:: The subtitle of the document.
+`:title-document-class:`:: The title of the document class that the document belongs to;
+e.g. "Computer Security" for SP 800.
 
 `:keywords:`:: Comma-delimited list of the keywords associated with the document.
 
@@ -267,12 +261,85 @@ they are published in front of any appendixes. This is the prescribed behaviour
 forward. If present, bibliographies are treated in the legacy manner: they are treated like appendixes,
 and are given an appendix number according to where in the document they occur.
 
+`:boilerplate-authority:`:: Nominate a Metanorma XML file encoding the authority statement of the document,
+to overwrite the default authority statement included in the gem (link:lib/asciidoctor/nist/nist_intro.xml[]),
+in case the document is historical, and needs to be generated with a previous authority statement.
+
+`:obsoletes:`::
+One or more NIST document that this NIST document standard renders obsolete; implies that the obsoleted
+document is withdrawn, and no longer in effect. Comma delimited.
+Format is document identifier, e.g. _SP 800-53A Rev. 1_
+
+`:obsoleted-by:`::
+One or more corresponding NIST document that this NIST document standard is obsoleted by; requires that
+this document is withdrawn, and no longer in effect. Comma delimited.
+Format is document identifier, e.g. _SP 800-53A Rev. 1_
+
+`:supersedes:`::
+One or more NIST document that this NIST document standard supersedes; the superseded
+document may still remain in effect. Comma delimited.
+Format is document identifier, e.g. _SP 800-53A Rev. 1_
+
+`:superseded-by`::
+One or more corresponding NIST document that this NIST document standard is superseded by;
+this document may still remain in effect. Comma delimited.
+Format is document identifier, e.g. _SP 800-53A Rev. 1_
+
+
 == Asciidoctor features specific to NIST
 
 The https://github.com/metanorma/metanorma-standoc[metanorma-standoc]
 gem documents the customisations of Asciidoctor markup common to all metanorma gems.
 The following markup is specific to this gem:
 
+=== Authority statement
+
+The authority statement in NIST consists of five sections, and these are marked up in
+Metanorma XML with the tags `<authority1>, <authority2>, <authority3>, <authority4>, <authority5>`:
+
+`authority1`:: The initial section of the authority section ("This publication has been developed
+by NIST...").
+`authority2`:: The identifier, revision date, and URL of the document.
+`authority3`:: The boxed disclaimer statement ("Any mention of commercial products or reference to commercial organizations...")
+`authority4`:: The public comment period, for drafts
+`authority5`:: The contact details for comments
+
+The authority statement has been marked up in Metanorma XML rather than Asciidoctor because of its complexity.
+If you wish to supply a different authority statement, you will need to provide a piece of Metanorma XML corresponding
+to the existing default statement (available from link:lib/asciidoctor/nist/nist_intro.xml[]), and containing
+text corresponding to the sections given above. You can give the location of your own authority statement file 
+relative to the current document through the document attribute `:boilerplate-authority:`.
+
+=== Author affiliations
+
+Each author of a NIST document may have their own organizational affiliation, and optionally
+a city for that organization. This information is given using the `:fullname:`, `:affiliation:`,
+and `:address:` document attributes, with separate organization and address listings for each
+author. Metanorma will take care of grouping authors together by organization.
+
+[source,asciidoctor]
+--
+:fullname: Hildegard Ferraiolo
+:affiliation: Computer Security Division, Information Technology Laboratory
+:fullname_2: Ketan Mehta
+:affiliation_2: Computer Security Division, Information Technology Laboratory
+:fullname_3: Nabil Ghadiali
+:affiliation_3: National Gallery of Art
+:address_3: Washington, DC
+:fullname_4: Jason Mohler
+:affiliation_4: Electrosoft Services, Inc.
+:address_4: Reston, Virginia
+:fullname_5: Vincent Johnson
+:affiliation_5: Electrosoft Services, Inc.
+:address_5: Reston, Virginia
+:fullname_6: Steven Brady
+:affiliation_6: Electrosoft Services, Inc.
+:address_6: Reston, Virginia
+--
+
+Note that the organization location must be given for every author it applies to; rendering will differentiate
+between different locations of the same organization.
+
 === Preface
 
 The following sections are automatically moved to the document preface.

data/lib/asciidoctor/nist/biblio.rng

@@ -837,26 +837,29 @@
       <ref name="ContributorInfo"/>
     </element>
   </define>
+  <define name="DocRelationType">
+    <choice>
+      <value>obsoletes</value>
+      <value>updates</value>
+      <value>updatedBy</value>
+      <value>complements</value>
+      <value>derivedFrom</value>
+      <value>translatedFrom</value>
+      <value>adoptedFrom</value>
+      <value>equivalent</value>
+      <value>identical</value>
+      <value>nonequivalent</value>
+      <value>includedIn</value>
+      <value>includes</value>
+      <value>instance</value>
+      <value>partOf</value>
+      <value>hasDraft</value>
+    </choice>
+  </define>
   <define name="docrelation">
     <element name="relation">
       <attribute name="type">
-        <choice>
-          <value>obsoletes</value>
-          <value>updates</value>
-          <value>updatedBy</value>
-          <value>complements</value>
-          <value>derivedFrom</value>
-          <value>translatedFrom</value>
-          <value>adoptedFrom</value>
-          <value>equivalent</value>
-          <value>identical</value>
-          <value>nonequivalent</value>
-          <value>includedIn</value>
-          <value>includes</value>
-          <value>instance</value>
-          <value>partOf</value>
-          <value>hasDraft</value>
-        </choice>
+        <ref name="DocRelationType"/>
       </attribute>
       <element name="bibitem">
         <ref name="BibliographicItem"/>

data/lib/asciidoctor/nist/boilerplate.rb

@@ -0,0 +1,58 @@
+module Asciidoctor
+  module NIST
+    class Converter < Standoc::Converter
+      CALL_FOR_PATENT_CLAIMS = <<~END.freeze
+      <clause><title>Call for Patent Claims</title>
+      <p>This public review includes a call for information on essential patent claims (claims whose use would be required for compliance with the guidance or requirements in this Information Technology Laboratory (ITL) draft publication). Such guidance and/or requirements may be directly stated in this ITL Publication or by reference to another publication. This call also includes disclosure, where known, of the existence of pending U.S. or foreign patent applications relating to this ITL draft publication and of any relevant unexpired U.S. or foreign patents.</p>
+
+<p>ITL may require from the patent holder, or a party authorized to make assurances on its behalf, in written or electronic form, either:</p>
+
+<ol><li><p>assurance in the form of a general disclaimer to the effect that such party does not hold and does not currently intend holding any essential patent claim(s); or</p></li>
+
+<li><p>assurance that a license to such essential patent claim(s) will be made available to applicants desiring to utilize the license for the purpose of complying with the guidance or requirements in this ITL draft publication either:</p>
+
+        <ol><li><p>under reasonable terms and conditions that are demonstrably free of any unfair discrimination; or</p></li>
+
+        <li><p>without compensation and under reasonable terms and conditions that are demonstrably free of any unfair discrimination.</p></li></ol>
+</li></ol>
+
+<p>Such assurance shall indicate that the patent holder (or third party authorized to make assurances on its behalf) will include in any documents transferring ownership of patents subject to the assurance, provisions sufficient to ensure that the commitments in the assurance are binding on the transferee, and that the transferee will similarly include appropriate provisions in the event of future transfers with the goal of binding each successor-in-interest.</p>
+
+<p>The assurance shall also indicate that it is intended to be binding on successors-in-interest regardless of whether such provisions are included in the relevant transfer documents.</p>
+
+<p>Such statements should be addressed to: ITL-POINT-OF_CONTACT.</p>
+</clause>
+      END
+
+      PATENT_DISCLOSURE_NOTICE1 = <<~END.freeze
+            <clause><title>Patent Disclosure Notice</title>
+      <p>NOTICE: The Information Technology Laboratory (ITL) has requested that holders of patent claims whose use may be required for compliance with the guidance or requirements of this publication disclose such patent claims to ITL. However, holders of patents are not obligated to respond to ITL calls for patents and ITL has not undertaken a patent search in order to identify which, if any, patents may apply to this publication. </p>
+<p>Following the ITL call for the identification of patent claims whose use may be required for compliance with the guidance or requirements of this publication, notice of one or more such claims has been received. </p>
+<p>By publication, no position is taken by ITL with respect to the validity or scope of any patent claim or of any rights in connection therewith. The known patent holder(s) has (have), however, provided to NIST a letter of assurance stating either (1) a general disclaimer to the effect that it does (they do) not hold and does (do) not currently intend holding any essential patent claim(s), or (2) that it (they) will negotiate royalty-free or royalty-bearing licenses with other parties on a demonstrably nondiscriminatory basis with reasonable terms and conditions. </p>
+<p>Details may be obtained from ITL-POINT-OF_CONTACT. </p>
+<p>No representation is made or implied that this is the only license that may be required to avoid patent infringement in the use of this publication. </p>
+</clause>
+      END
+
+      PATENT_DISCLOSURE_NOTICE2 = <<~END.freeze
+            <clause><title>Patent Disclosure Notice</title>
+      <p>NOTICE: ITL has requested that holders of patent claims whose use may be required for compliance with the guidance or requirements of this publication disclose such patent claims to ITL. However, holders of patents are not obligated to respond to ITL calls for patents and ITL has not undertaken a patent search in order to identify which, if any, patents may apply to this publication.</p>
+<p>As of the date of publication and following call(s) for the identification of patent claims whose use may be required for compliance with the guidance or requirements of this publication, no such patent claims have been identified to ITL.</p>
+<p>No representation is made or implied by ITL that licenses are not required to avoid patent infringement in the use of this publication.</p>
+</clause>
+      END
+
+      def boilerplate(x_orig)
+        x = x_orig.dup
+        x.root.add_namespace(nil, EXAMPLE_NAMESPACE)
+        x = Nokogiri::XML(x.to_xml)
+        conv = IsoDoc::NIST::HtmlConvert.new({})
+        conv.metadata_init("en", "Latn", {})
+        conv.info(x, nil)
+        file = @boilerplateauthority ? "#{@localdir}/#{@boilerplateauthority}" :
+          File.join(File.dirname(__FILE__),"nist_intro.xml")
+        conv.populate_template((File.read(file, encoding: "UTF-8")), nil)
+      end
+    end
+  end
+end

data/lib/asciidoctor/nist/cleanup.rb

@@ -0,0 +1,89 @@
+module Asciidoctor
+  module NIST
+    class Converter < Standoc::Converter
+      def cleanup(xmldoc)
+        sourcecode_cleanup(xmldoc)
+        super
+      end
+
+      def sourcecode_cleanup(xmldoc)
+        xmldoc.xpath("//sourcecode").each do |x|
+          x.traverse do |n|
+            next unless n.text?
+            n.replace(Nokogiri::XML::NodeSet.new(n.document,
+                                                 nistvariable_insert(n)))
+          end
+        end
+      end
+
+      # skip annex/terms/terms, which is empty node
+      def termdef_subclause_cleanup(xmldoc)
+        xmldoc.xpath("//terms[terms]").each do |t|
+          next if t.parent.name == "terms"
+          t.children.each { |n| n.parent = t.parent }
+          t.remove
+        end
+      end
+
+      def sections_cleanup(x)
+        super
+        x.xpath("//*[@inline-header]").each do |h|
+          h.delete("inline-header")
+        end
+      end
+
+      def move_sections_into_preface(x, preface)
+        abstract = x.at("//abstract")
+        preface.add_child abstract.remove if abstract
+        if x.at("//authority")
+          boilerplate = x.at("//authority")
+          preface.add_child boilerplate.remove
+        else
+          preface.add_child boilerplate(x)
+        end
+        foreword = x.at("//foreword")
+        preface.add_child foreword.remove if foreword
+        introduction = x.at("//introduction")
+        preface.add_child introduction.remove if introduction
+        x.xpath("//clause[@preface]").each do |c|
+          c.delete("preface")
+          title = c&.at("./title")&.text.downcase
+          c.name = "reviewernote" if title == "note to reviewers"
+          c.name = "executivesummary" if title == "executive summary"
+          preface.add_child c.remove
+        end
+        callforpatentclaims(x, preface)
+      end
+
+      def callforpatentclaims(x, preface)
+        if @callforpatentclaims
+          docemail = x&.at("//uri[@type = 'email']")&.text || "???"
+          docnumber = x&.at("//docnumber")&.text || "???"
+          status = x&.at("//bibdata/status/stage")&.text
+          published = status.nil? || status == "final"
+          preface.add_child patent_text(published, docemail, docnumber)
+        end
+      end
+
+      def patent_text(published, docemail, docnumber)
+        patent = (!published ? CALL_FOR_PATENT_CLAIMS :
+                  (@commitmenttolicence ? PATENT_DISCLOSURE_NOTICE1 :
+                   PATENT_DISCLOSURE_NOTICE2)).clone
+        patent.gsub(/ITL-POINT-OF_CONTACT/, published ?
+                    (@patentcontact || docemail) :
+                    (@patentcontact ||
+                     "#{docemail}, with the Subject: #{docnumber} "\
+                     "Call for Patent Claims"))
+      end
+
+      def make_preface(x, s)
+        #if x.at("//foreword | //introduction | //abstract | //preface") ||
+        #    @callforpatentclaims
+        preface = s.add_previous_sibling("<preface/>").first
+        move_sections_into_preface(x, preface)
+        summ = x.at("//executivesummary") and preface.add_child summ.remove
+        #end
+      end
+    end
+  end
+end

data/lib/asciidoctor/nist/converter.rb

@@ -4,6 +4,9 @@ require "asciidoctor/standoc/converter"
 require "isodoc/nist/html_convert"
 require "isodoc/nist/word_convert"
 require_relative "front"
+require_relative "boilerplate"
+require_relative "validate"
+require_relative "cleanup"
 require "fileutils"
 
 module Asciidoctor
@@ -12,10 +15,6 @@ module Asciidoctor
 
       register_for "nist"
 
-      def title_validate(root)
-        nil
-      end
-
       def example(node)
         return pseudocode_example(node) if node.attr("style") == "pseudocode"
         super
@@ -78,11 +77,6 @@ module Asciidoctor
         end.join("\n")
       end
 
-      def cleanup(xmldoc)
-        sourcecode_cleanup(xmldoc)
-        super
-      end
-
       def nistvariable_insert(n)
         acc = []
         n.text.split(/((?<!\{)\{{3}(?!\{)|(?<!\})\}{3}(?!\}))/).each_slice(4).
@@ -95,25 +89,6 @@ module Asciidoctor
         acc
       end
 
-      def sourcecode_cleanup(xmldoc)
-        xmldoc.xpath("//sourcecode").each do |x|
-          x.traverse do |n|
-            next unless n.text?
-            n.replace(Nokogiri::XML::NodeSet.new(n.document, 
-                                                 nistvariable_insert(n)))
-          end
-        end
-      end
-
-      # skip annex/terms/terms, which is empty node
-       def termdef_subclause_cleanup(xmldoc)
-        xmldoc.xpath("//terms[terms]").each do |t|
-          next if t.parent.name == "terms"
-          t.children.each { |n| n.parent = t.parent }
-          t.remove
-        end
-      end
-
       def makexml(node)
         result = ["<?xml version='1.0' encoding='UTF-8'?>\n<nist-standard>"]
         @draft = node.attributes.has_key?("draft")
@@ -129,12 +104,7 @@ module Asciidoctor
 
       def doctype(node)
         d = node.attr("doctype")
-        unless %w{policy-and-procedures best-practices 
-          supporting-document report legal directives proposal 
-          standard}.include? d
-          warn "#{d} is not a legal document type: reverting to 'standard'"
-          d = "standard"
-        end
+        d = "standard" if d == "article" # article is Asciidoctor default
         d
       end
 
@@ -143,6 +113,7 @@ module Asciidoctor
         @commitmenttolicence = node.attr("commitment-to-licence")
         @patentcontact = node.attr("patent-contact")
         @biblioasappendix = node.attr("biblio-as-appendix")
+        @boilerplateauthority = node.attr("boilerplate-authority")
         super
       end
 
@@ -162,107 +133,6 @@ module Asciidoctor
         ret
       end
 
-      def validate(doc)
-        content_validate(doc)
-        schema_validate(formattedstr_strip(doc.dup),
-                        File.join(File.dirname(__FILE__), "nist.rng"))
-      end
-
-      def sections_cleanup(x)
-        super
-        x.xpath("//*[@inline-header]").each do |h|
-          h.delete("inline-header")
-        end
-      end
-
-      def move_sections_into_preface(x, preface)
-        abstract = x.at("//abstract")
-        preface.add_child abstract.remove if abstract
-        foreword = x.at("//foreword")
-        preface.add_child foreword.remove if foreword
-        introduction = x.at("//introduction")
-        preface.add_child introduction.remove if introduction
-        x.xpath("//clause[@preface]").each do |c|
-          c.delete("preface")
-          title = c&.at("./title")&.text.downcase
-          c.name = "reviewernote" if title == "note to reviewers"
-          c.name = "executivesummary" if title == "executive summary"
-          preface.add_child c.remove
-        end
-        callforpatentclaims(x, preface)
-      end
-
-      CALL_FOR_PATENT_CLAIMS = <<~END.freeze
-      <clause><title>Call for Patent Claims</title>
-      <p>This public review includes a call for information on essential patent claims (claims whose use would be required for compliance with the guidance or requirements in this Information Technology Laboratory (ITL) draft publication). Such guidance and/or requirements may be directly stated in this ITL Publication or by reference to another publication. This call also includes disclosure, where known, of the existence of pending U.S. or foreign patent applications relating to this ITL draft publication and of any relevant unexpired U.S. or foreign patents.</p>
-
-<p>ITL may require from the patent holder, or a party authorized to make assurances on its behalf, in written or electronic form, either:</p>
-
-<ol><li><p>assurance in the form of a general disclaimer to the effect that such party does not hold and does not currently intend holding any essential patent claim(s); or</p></li>
-
-<li><p>assurance that a license to such essential patent claim(s) will be made available to applicants desiring to utilize the license for the purpose of complying with the guidance or requirements in this ITL draft publication either:</p>
-
-        <ol><li><p>under reasonable terms and conditions that are demonstrably free of any unfair discrimination; or</p></li>
-
-        <li><p>without compensation and under reasonable terms and conditions that are demonstrably free of any unfair discrimination.</p></li></ol>
-</li></ol>
-
-<p>Such assurance shall indicate that the patent holder (or third party authorized to make assurances on its behalf) will include in any documents transferring ownership of patents subject to the assurance, provisions sufficient to ensure that the commitments in the assurance are binding on the transferee, and that the transferee will similarly include appropriate provisions in the event of future transfers with the goal of binding each successor-in-interest.</p>
-
-<p>The assurance shall also indicate that it is intended to be binding on successors-in-interest regardless of whether such provisions are included in the relevant transfer documents.</p>
-
-<p>Such statements should be addressed to: ITL-POINT-OF_CONTACT.</p>
-</clause>
-      END
-
-      PATENT_DISCLOSURE_NOTICE1 = <<~END.freeze
-            <clause><title>Patent Disclosure Notice</title>
-      <p>NOTICE: The Information Technology Laboratory (ITL) has requested that holders of patent claims whose use may be required for compliance with the guidance or requirements of this publication disclose such patent claims to ITL. However, holders of patents are not obligated to respond to ITL calls for patents and ITL has not undertaken a patent search in order to identify which, if any, patents may apply to this publication. </p>
-<p>Following the ITL call for the identification of patent claims whose use may be required for compliance with the guidance or requirements of this publication, notice of one or more such claims has been received. </p>
-<p>By publication, no position is taken by ITL with respect to the validity or scope of any patent claim or of any rights in connection therewith. The known patent holder(s) has (have), however, provided to NIST a letter of assurance stating either (1) a general disclaimer to the effect that it does (they do) not hold and does (do) not currently intend holding any essential patent claim(s), or (2) that it (they) will negotiate royalty-free or royalty-bearing licenses with other parties on a demonstrably nondiscriminatory basis with reasonable terms and conditions. </p>
-<p>Details may be obtained from ITL-POINT-OF_CONTACT. </p>
-<p>No representation is made or implied that this is the only license that may be required to avoid patent infringement in the use of this publication. </p>
-</clause>
-      END
-
-      PATENT_DISCLOSURE_NOTICE2 = <<~END.freeze
-            <clause><title>Patent Disclosure Notice</title>
-      <p>NOTICE: ITL has requested that holders of patent claims whose use may be required for compliance with the guidance or requirements of this publication disclose such patent claims to ITL. However, holders of patents are not obligated to respond to ITL calls for patents and ITL has not undertaken a patent search in order to identify which, if any, patents may apply to this publication.</p>
-<p>As of the date of publication and following call(s) for the identification of patent claims whose use may be required for compliance with the guidance or requirements of this publication, no such patent claims have been identified to ITL.</p>
-<p>No representation is made or implied by ITL that licenses are not required to avoid patent infringement in the use of this publication.</p>
-</clause>
-      END
-
-      def callforpatentclaims(x, preface)
-        if @callforpatentclaims
-          docemail = x&.at("//uri[@type = 'email']")&.text || "???"
-          docnumber = x&.at("//docnumber")&.text || "???"
-          status = x&.at("//bibdata/status/stage")&.text 
-          published = status.nil? || status == "final"
-          preface.add_child patent_text(published, docemail, docnumber)
-        end
-      end
-
-      def patent_text(published, docemail, docnumber)
-        patent = (!published ? CALL_FOR_PATENT_CLAIMS :
-                  (@commitmenttolicence ? PATENT_DISCLOSURE_NOTICE1 :
-                   PATENT_DISCLOSURE_NOTICE2)).clone
-        patent.gsub(/ITL-POINT-OF_CONTACT/, published ?
-                    (@patentcontact || docemail) :
-                    (@patentcontact ||
-                     "#{docemail}, with the Subject: #{docnumber} "\
-                     "Call for Patent Claims"))
-      end
-
-      def make_preface(x, s)
-        if x.at("//foreword | //introduction | //abstract | //preface") ||
-            @callforpatentclaims
-          preface = s.add_previous_sibling("<preface/>").first
-          move_sections_into_preface(x, preface)
-          summ = x.at("//executivesummary") and preface.add_child summ.remove
-        end
-      end
-
       def clause_parse(attrs, xml, node)
         attrs[:preface] = true if node.attr("style") == "preface"
         super
@@ -351,21 +221,6 @@ module Asciidoctor
         end
       end
 
-      SECTIONS_TO_VALIDATE = "//references[not(parent::clause)]/title | "\
-        "//clause[descendant::references][not(parent::clause)]/title".freeze
-
-      def section_validate(doc)
-        super
-        f = doc.xpath(SECTIONS_TO_VALIDATE)
-        names = f.map { |s| s&.text }
-        return if names.empty?
-        return if names == ["References"]
-        return if names == ["Bibliography"]
-        return if names == ["References", "Bibliography"]
-        warn "Reference clauses #{names.join(', ')} do not follow expected "\
-          "pattern in NIST"
-      end
-
       def sections_order_cleanup(x)
         s = x.at("//sections")
         make_preface(x, s)