metanorma-standoc 1.10.3.1 → 1.10.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9189fd92cd1faa176828d42a9f0e7b7b58dc995eeb945fad0d13214d41c54c0d
-  data.tar.gz: a6fa58d732b182153c56c04b9e83df2788abd01a497d12ed9746e990662ecec1
+  metadata.gz: 69e06ff811f3411ddd5ddccb1bfd52b82c92b49e1458d781fcfffac4397c1062
+  data.tar.gz: c600a5d9e17f3f271d176cefb5c6d3f860d887369efac0f2ad03ec5bf78b01a7
 SHA512:
-  metadata.gz: 4c5ae33422d77c5ce51e88c2d8006a61795542949687f7ceaec0e253298f15398d1e1a3bb65314e834952cb370d44d03b3af759f8be9e51487709e5d926ac6ae
-  data.tar.gz: 341c38c603a0f7b0f7913605309f633e5b76e8051ea41a6205342ec5b54fb3e4fb8799198c2deb12871251e2956ef2d09cb842ca1106baea042a56094b0c891f
+  metadata.gz: 785c49c3ef49c5bdc393f1f10f44fb2cf3a59e10583b08f1b40ecf282ebe015b1b98a0c9d8f3c796c81d2495e7e1273ba28d15b5a6ad4c6b543dbbe42dbae47f
+  data.tar.gz: a55c32649ba87a57dd417802ea70f91efbbae57dc786b294cc08704fbfce0b2ecf03a90827578a7bcc7c138402f0cb87992309fe3aa6397702a400a426cb5640

data/lib/asciidoctor/standoc/converter.rb

@@ -27,6 +27,7 @@ module Asciidoctor
         preprocessor Metanorma::Plugin::Datastruct::Yaml2TextPreprocessor
         preprocessor Metanorma::Plugin::Lutaml::LutamlPreprocessor
         preprocessor Metanorma::Plugin::Lutaml::LutamlUmlAttributesTablePreprocessor
+        preprocessor Metanorma::Plugin::Lutaml::LutamlUmlDatamodelDescriptionPreprocessor
         inline_macro Asciidoctor::Standoc::AltTermInlineMacro
         inline_macro Asciidoctor::Standoc::DeprecatedTermInlineMacro
         inline_macro Asciidoctor::Standoc::DomainTermInlineMacro
@@ -48,6 +49,7 @@ module Asciidoctor
         inline_macro Asciidoctor::Standoc::FormSelectMacro
         inline_macro Asciidoctor::Standoc::FormOptionMacro
         inline_macro Asciidoctor::Standoc::ToCInlineMacro
+        inline_macro Metanorma::Plugin::Lutaml::LutamlFigureInlineMacro
         block_macro Metanorma::Plugin::Lutaml::LutamlDiagramBlockMacro
         block Asciidoctor::Standoc::ToDoAdmonitionBlock
         treeprocessor Asciidoctor::Standoc::ToDoInlineAdmonitionBlock

data/lib/asciidoctor/standoc/reqt.rb

@@ -6,20 +6,23 @@ require "base64"
 module Asciidoctor
   module Standoc
     module Blocks
-      def reqt_subpart(x)
+      def reqt_subpart(name)
         %w(specification measurement-target verification import label
-             subject inherit classification title).include? x
+           component subject inherit classification title).include? name
       end
 
-      def reqt_subpart_attrs(node)
-        attr_code(keep_attrs(node).merge(exclude: node.option?("exclude"),
-                                     type: node.attr("type")))
+      def reqt_subpart_attrs(node, name)
+        klass = node.attr("class") || "component"
+        attr_code(keep_attrs(node)
+          .merge(exclude: node.option?("exclude"),
+                 type: node.attr("type"),
+                 class: name == "component" ? klass : nil))
       end
 
       def requirement_subpart(node)
         name = node.role || node.attr("style")
         noko do |xml|
-          xml.send name, **reqt_subpart_attrs(node) do |o|
+          xml.send name, **reqt_subpart_attrs(node, name) do |o|
             o << node.content
           end
         end
@@ -30,14 +33,15 @@ module Asciidoctor
         HTMLEntities.new.decode(classif).split(/;\s*/).each do |c|
           c1 = c.split(/:\s*/)
           next unless c1.size == 2
-          c1[1].split(/,\s*/).each { |v| ret << [ c1[0], v ] }
+
+          c1[1].split(/,\s*/).each { |v| ret << [c1[0], v] }
         end
         ret
       end
 
-      def requirement_classification(classif, ex)
+      def requirement_classification(classif, out)
         req_classif_parse(classif).each do |r|
-          ex.classification do |c|
+          out.classification do |c|
             c.tag { |t| t << r[0] }
             c.value { |v| v << r[1] }
           end
@@ -46,29 +50,37 @@ module Asciidoctor
 
       def reqt_attrs(node)
         attr_code(keep_attrs(node).merge(id_unnum_attrs(node)).merge(
-          id: Metanorma::Utils::anchor_or_uuid(node),
-          unnumbered: node.option?("unnumbered") ? "true" : nil,
-          number: node.attr("number"),
-          subsequence: node.attr("subsequence"),
-          obligation: node.attr("obligation"),
-          filename: node.attr("filename"),
-          type: node.attr("type"),
-          model: node.attr("model"),
-        ))
+                    id: Metanorma::Utils::anchor_or_uuid(node),
+                    unnumbered: node.option?("unnumbered") ? "true" : nil,
+                    number: node.attr("number"),
+                    subsequence: node.attr("subsequence"),
+                    obligation: node.attr("obligation"),
+                    filename: node.attr("filename"),
+                    type: node.attr("type"),
+                    model: node.attr("model"),
+                  ))
+      end
+
+      def requirement_elems(node, out)
+        node.title and out.title { |t| t << node.title }
+        a = node.attr("label") and out.label do |l|
+          l << a
+        end
+        a = node.attr("subject") and csv_split(a)&.each do |subj|
+          out.subject { |s| s << subj }
+        end
+        a = HTMLEntities.new.decode(node.attr("inherit")) and
+          csv_split(a)&.each do |i|
+            out.inherit { |inh| inh << i }
+          end
+        classif = node.attr("classification") and
+          requirement_classification(classif, out)
       end
 
       def requirement(node, obligation)
-        classif = node.attr("classification")
         noko do |xml|
           xml.send obligation, **reqt_attrs(node) do |ex|
-            node.title and ex.title { |t| t << node.title }
-            node.attr("label") and ex.label { |l| l << node.attr("label") }
-            node.attr("subject") and ex.subject { |s| s << node.attr("subject") }
-            i = HTMLEntities.new.decode(node.attr("inherit"))
-            i&.split(/;\s*/)&.each do |i|
-              ex.inherit { |inh| inh << i }
-            end
-            requirement_classification(classif, ex) if classif
+            requirement_elems(node, ex)
             wrap_in_para(node, ex)
           end
         end.join("\n")

data/lib/asciidoctor/standoc/reqt.rng

@@ -80,6 +80,7 @@
         <ref name="verification"/>
         <ref name="import"/>
         <ref name="description"/>
+        <ref name="component"/>
       </choice>
     </zeroOrMore>
     <optional>
@@ -138,6 +139,12 @@
       <ref name="RequirementSubpart"/>
     </element>
   </define>
+  <define name="component">
+    <element name="component">
+      <attribute name="class"/>
+      <ref name="RequirementSubpart"/>
+    </element>
+  </define>
   <define name="reqt_references">
     <element name="references">
       <oneOrMore>

data/lib/asciidoctor/standoc/validate_section.rb

@@ -42,7 +42,8 @@ module Asciidoctor
         root.xpath("//clause | //annex | //foreword | //introduction | "\
                    "//acknowledgements").each do |c|
           next unless c.at("./clause")
-          next if c.elements.select { |n| n.name != "clause" }.empty?
+          next if c.elements.reject { |n| %w(clause title).include? n.name }.empty?
+
           style_warning(c, "Hanging paragraph in clause")
         end
       end

data/lib/metanorma/standoc/version.rb

@@ -19,6 +19,6 @@ module Metanorma
   end
 
   module Standoc
-    VERSION = "1.10.3.1".freeze
+    VERSION = "1.10.4".freeze
   end
 end

data/spec/asciidoctor/blocks_spec.rb

@@ -264,6 +264,8 @@ RSpec.describe Asciidoctor::Standoc do
       </sections>
       </standard-document>
     OUTPUT
+    expect(xmlpp(strip_guid(Asciidoctor.convert(input, *OPTIONS))))
+      .to be_equivalent_to xmlpp(output)
   end
 
   it "processes review blocks if document is in draft mode" do
@@ -1173,7 +1175,7 @@ RSpec.describe Asciidoctor::Standoc do
   it "processes recommendation" do
     input = <<~"INPUT"
       #{ASCIIDOC_BLANK_HDR}
-      [.recommendation,label="/ogc/recommendation/wfs/2",subject="user",inherit="/ss/584/2015/level/1; /ss/584/2015/level/2",options="unnumbered",type=verification,model=ogc]
+      [.recommendation,label="/ogc/recommendation/wfs/2",subject="user;developer, implementer",inherit="/ss/584/2015/level/1; /ss/584/2015/level/2",options="unnumbered",type=verification,model=ogc]
       ====
       I recommend this
       ====
@@ -1184,6 +1186,7 @@ RSpec.describe Asciidoctor::Standoc do
         <recommendation id="_" unnumbered="true" type="verification" model="ogc">
         <label>/ogc/recommendation/wfs/2</label>
       <subject>user</subject>
+      <subject>developer, implementer</subject>
       <inherit>/ss/584/2015/level/1</inherit>
       <inherit>/ss/584/2015/level/2</inherit>
         <description><p id="_">I recommend this</p></description>
@@ -1330,31 +1333,48 @@ RSpec.describe Asciidoctor::Standoc do
       success-response()
       ----
       --
+
+      [.component]
+      --
+      Hello
+      --
+
+      [.component,class=condition]
+      --
+      If this be thus
+      --
       ====
     INPUT
     output = <<~"OUTPUT"
-                  #{BLANK_HDR}
-             <sections>
-             <recommendation id="ABC"  obligation="permission,recommendation" filename="reqt1.rq"><label>/ogc/recommendation/wfs/2</label><subject>user</subject>
-      <classification><tag>control-class</tag><value>Technical</value></classification><classification><tag>priority</tag><value>P0</value></classification><classification><tag>family</tag><value>System &amp; Communications Protection</value></classification><classification><tag>family</tag><value>System and Communications Protocols</value></classification>
-              <description><p id="_">I recommend <em>this</em>.</p>
-             </description><specification exclude="false" type="tabular" keep-with-next="true" keep-lines-together="true"><p id="_">This is the object of the recommendation:</p><table id="_">  <tbody>    <tr>      <td valign="top" align="left">Object</td>      <td valign="top" align="left">Value</td>    </tr>    <tr>      <td valign="top" align="left">Mission</td>      <td valign="top" align="left">Accomplished</td>    </tr>  </tbody></table></specification><description>
-             <p id="_">As for the measurement targets,</p>
-             </description><measurement-target exclude="false"><p id="_">The measurement target shall be measured as:</p><formula id="_">  <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac>
-             <mrow>
-        <mi>r</mi>
-      </mrow>
-      <mrow>
-        <mn>1</mn>
-      </mrow>
-      </mfrac><mo>=</mo><mn>0</mn></math></stem></formula></measurement-target>
-             <verification exclude="false"><p id="_">The following code will be run for verification:</p><sourcecode  lang="CoreRoot" id="_">CoreRoot(success): HttpResponse
-      if (success)
-        recommendation(label: success-response)
-      end</sourcecode></verification>
-             <import exclude="true">  <sourcecode  lang="CoreRoot" id="_">success-response()</sourcecode></import></recommendation>
-             </sections>
-             </standard-document>
+         #{BLANK_HDR}
+                 <sections>
+                 <recommendation id="ABC"  obligation="permission,recommendation" filename="reqt1.rq"><label>/ogc/recommendation/wfs/2</label><subject>user</subject>
+          <classification><tag>control-class</tag><value>Technical</value></classification><classification><tag>priority</tag><value>P0</value></classification><classification><tag>family</tag><value>System &amp; Communications Protection</value></classification><classification><tag>family</tag><value>System and Communications Protocols</value></classification>
+                  <description><p id="_">I recommend <em>this</em>.</p>
+                 </description><specification exclude="false" type="tabular" keep-with-next="true" keep-lines-together="true"><p id="_">This is the object of the recommendation:</p><table id="_">  <tbody>    <tr>      <td valign="top" align="left">Object</td>      <td valign="top" align="left">Value</td>    </tr>    <tr>      <td valign="top" align="left">Mission</td>      <td valign="top" align="left">Accomplished</td>    </tr>  </tbody></table></specification><description>
+                 <p id="_">As for the measurement targets,</p>
+                 </description><measurement-target exclude="false"><p id="_">The measurement target shall be measured as:</p><formula id="_">  <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac>
+                 <mrow>
+            <mi>r</mi>
+          </mrow>
+          <mrow>
+            <mn>1</mn>
+          </mrow>
+          </mfrac><mo>=</mo><mn>0</mn></math></stem></formula></measurement-target>
+                 <verification exclude="false"><p id="_">The following code will be run for verification:</p><sourcecode  lang="CoreRoot" id="_">CoreRoot(success): HttpResponse
+          if (success)
+            recommendation(label: success-response)
+          end</sourcecode></verification>
+                 <import exclude="true">  <sourcecode  lang="CoreRoot" id="_">success-response()</sourcecode></import>
+                 <component exclude='false' class='component'>
+        <p id='_'>Hello</p>
+      </component>
+      <component exclude='false' class='condition'>
+        <p id='_'>If this be thus</p>
+      </component>
+          </recommendation>
+                 </sections>
+                 </standard-document>
     OUTPUT
 
     expect(xmlpp(strip_guid(Asciidoctor.convert(input, *OPTIONS))))

data/spec/asciidoctor/macros_spec.rb

@@ -1541,4 +1541,113 @@ RSpec.describe Asciidoctor::Standoc do
       end
     end
   end
+
+  describe "lutaml_figure macro" do
+    let(:example_file) { fixtures_path("test.xmi") }
+    let(:input) do
+      <<~TEXT
+        = Document title
+        Author
+        :docfile: test.adoc
+        :nodoc:
+        :novalid:
+        :no-isobib:
+        :imagesdir: spec/assets
+
+        [lutaml_uml_datamodel_description,#{example_file}]
+        --
+        --
+
+        This is lutaml_figure::[package="Wrapper root package", name="Fig B1 Full model"] figure
+      TEXT
+    end
+    let(:output) do
+      '<xref target="figure-EAID_0E029ABF_C35A_49e3_9EEA_FFD4F32780A8">'
+    end
+
+    it "correctly renders input" do
+      expect(strip_src(xml_string_conent(metanorma_process(input))))
+        .to(include(output))
+    end
+  end
+
+  describe "lutaml_uml_datamodel_description macro" do
+    subject(:convert) do
+      xmlpp(
+        strip_guid(
+          Asciidoctor.convert(
+            input, *OPTIONS
+          ),
+        ),
+      )
+    end
+
+    let(:example_file) { fixtures_path("test.xmi") }
+    let(:input) do
+      <<~TEXT
+        = Document title
+        Author
+        :docfile: test.adoc
+        :nodoc:
+        :novalid:
+        :no-isobib:
+        :imagesdir: spec/assets
+
+        [lutaml_uml_datamodel_description,#{example_file}]
+        --
+        [.diagram_include_block, base_path="requirements/"]
+        ...
+        Diagram text
+        ...
+
+        [.include_block, package="Another", base_path="spec/fixtures/"]
+        ...
+        my text
+        ...
+
+        [.include_block, base_path="spec/fixtures/"]
+        ...
+        my text
+        ...
+
+        [.before]
+        ...
+        mine text
+        ...
+
+        [.before, package="Another"]
+        ...
+        text before Another package
+        ...
+
+        [.after, package="Another"]
+        ...
+        text after Another package
+        ...
+
+        [.after, package="CityGML"]
+        ...
+        text after CityGML package
+        ...
+
+        [.after]
+        ...
+        footer text
+        ...
+        --
+      TEXT
+    end
+    let(:output) do
+      <<~TEXT
+        #{BLANK_HDR}
+        #{File.read(fixtures_path('datamodel_description_sections_tree.xml'))}
+        </standard-document>
+      TEXT
+    end
+
+    it "correctly renders input" do
+      expect(convert)
+        .to(be_equivalent_to(xmlpp(output)))
+    end
+  end
 end

data/spec/fixtures/datamodel_description_sections_tree.xml

@@ -0,0 +1,327 @@
+  <preface>
+    <foreword id='_' obligation='informative'>
+      <title>Foreword</title>
+      <p id='_'>mine text</p>
+    </foreword>
+  </preface>
+  <sections>
+    <clause id='_' inline-header='false' obligation='normative'>
+      <title>Wrapper nested package package</title>
+      <clause id='_' inline-header='false' obligation='normative'>
+        <title>Wrapper nested package overview</title>
+        <p id='_'>Diagram text</p>
+        <figure id='figure-EAID_0E029ABF_C35A_49e3_9EEA_FFD4F32780A8'>
+          <name>Fig B1 Full model</name>
+          <image src='spec/assets/requirements//EAID_0E029ABF_C35A_49e3_9EEA_FFD4F32780A8.png' id='_' mimetype='image/png' height='auto' width='auto'/>
+        </figure>
+        <p id='_'>The Wrapper nested package package is organized into 1 packages:</p>
+        <ol id='_' type='arabic'>
+          <li>
+            <p id='_'>ISO 19135 Procedures for item registration XML package</p>
+          </li>
+        </ol>
+        <p id='_'>mine text</p>
+      </clause>
+      <clause id='_' inline-header='false' obligation='normative'>
+        <title>ISO 19135 Procedures for item registration XML package</title>
+        <clause id='_' inline-header='false' obligation='normative'>
+          <title>ISO 19135 Procedures for item registration XML overview</title>
+          <p id='_'>Diagram text</p>
+          <figure id='figure-EAID_0E029ABF_C35A_49e3_9EEA_FFD4F32780A8'>
+            <name>Fig B1 Full model</name>
+            <image src='spec/assets/requirements//EAID_0E029ABF_C35A_49e3_9EEA_FFD4F32780A8.png' id='_' mimetype='image/png' height='auto' width='auto'/>
+          </figure>
+        </clause>
+        <clause id='_' inline-header='false' obligation='normative'>
+          <title>Defining tables</title>
+          <table id='tab-P-iso_19135_procedures_for_item_registration_xml-C-re_register' width='100%'>
+            <name>Elements of ISO 19135 Procedures for item registration XML::RE_Register</name>
+            <tbody>
+              <tr>
+                <th valign='top' align='left'>Name:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>RE_Register</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' align='left'>Definition:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>
+                    The class &#8220;RE_Register&#8221; specifies information
+                    about the register itself. It is a subtype of the Register
+                    class in the core profile.
+                  </p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' align='left'>Stereotype:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>interface</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' align='left'>Inheritance from:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>Register</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' align='left'>Generalization of:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>TermRegister, CL_ClassificationRegister, LC_LCMLRegister</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' align='left'>Abstract:</th>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>false</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' rowspan='2' align='left'>Associations:</th>
+                <td colspan='4' valign='top' align='left'>
+                  <p id='_'>
+                    <em>Association with:</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Obligation</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Maximum occurrence</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Provides:</em>
+                  </p>
+                </td>
+              </tr>
+              <tr>
+                <td colspan='4' valign='top' align='left'>
+                  <p id='_'>RE_ReferenceSource</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>C</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>*</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>citation</p>
+                </td>
+              </tr>
+              <tr>
+                <th valign='top' rowspan='6' align='left'>Public attributes:</th>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Name</em>
+                  </p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    <em>Definition</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Derived</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Obligation</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Maximum occurrence</em>
+                  </p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <em>Data type</em>
+                  </p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>alternativeLanguages</p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    The attribute &#8220;alternativeLanguages&#8221; supports
+                    cultural and linguistic adaptability, individual items in a
+                    register may provide elements of information in additional
+                    languages other than the operating language of the register.
+                    The attribute
+                    <em>alternativeLanguages</em>
+                      shall be represented as a set of instances of RE_Locale,
+                    each specifying an additional unique locale used by items in
+                    the register. Every member of the set shall be used by at
+                    least one item in the register. The
+                    <em>locale</em>
+                      of every
+                    <em>alternativeExpression</em>
+                      used by any item in the register shall be included in this
+                    set of RE_Locales. This attribute provides a summary of
+                    alternative locales used by items in a register. Register
+                    owners shall specify and publish their policy as to whether
+                    all or only some of the items in a register shall have
+                    alternative expressions.
+                  </p>
+                </td>
+                <td valign='top' align='left'/>
+                <td valign='top' align='left'>
+                  <p id='_'>C</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>1</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>Set&lt;RE_Locale&gt;</p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>contentSummary</p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    The attribute &#8220;contentSummary&#8221; is be represented
+                    as a CharacterString containing a general statement of the
+                    purpose for which items in the register are made available
+                    to potential users. It should also specify any limits to the
+                    scope of the register and identify the types of applications
+                    for which the items are intended. NOTE The scope of a
+                    register could be limited by theme, by region, by language
+                    or other criteria. EXAMPLE The scope of a terminology
+                    register could be limited to Spanish terms used to describe
+                    landforms in Latin America.
+                  </p>
+                </td>
+                <td valign='top' align='left'/>
+                <td valign='top' align='left'>
+                  <p id='_'>M</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>1</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>CharacterString</p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>name</p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    The attribute &#8220;name&#8221; is be represented as a
+                    CharacterString containing a compact and human-readable
+                    designator that is used to uniquely denote that register
+                    within the set of registers maintained by the register
+                    owner. In the case of a hierarchical register, the &#8220;
+                    <em>name&#8221;</em>
+                      of a subregister shall uniquely identify that subregister
+                    within the scope EXAMPLE &#239;&#191;&#189;ISO/TC 211
+                    Register of Feature Data Dictionaries and Feature
+                    Catalogues&#239;&#191;&#189; might be the name of the
+                    principal register of of all registers established by the
+                    owner of the principal register. a hierarchical register.
+                    &#239;&#191;&#189;DGIWG FACC Data
+                    Dictionary&#239;&#191;&#189; and &#239;&#191;&#189;IHO S-57
+                    Object Dictionary&#239;&#191;&#189; might be the names of
+                    subregisters within the hierarchy.
+                  </p>
+                </td>
+                <td valign='top' align='left'/>
+                <td valign='top' align='left'>
+                  <p id='_'>M</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>1</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>CharacterString</p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>operatingLanguage</p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    The attribute &#8220;operatingLanguage&#8221; is represented
+                    as an instance of class RE_Locale that is used to specify
+                    language, country information and character encoding for the
+                    proper interpretation of the content of character strings in
+                    the register. The values of all character strings in the
+                    register shall be in accordance with the value of
+                    &#8220;operatingLanguage&#8221;, unless otherwise stated.
+                  </p>
+                </td>
+                <td valign='top' align='left'/>
+                <td valign='top' align='left'>
+                  <p id='_'>M</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>1</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>EAID_3996125E_4828_4f3c_93BD_605E9059DE05</p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>uniformResourceIdentifier</p>
+                </td>
+                <td colspan='2' valign='top' align='left'>
+                  <p id='_'>
+                    The attribute &#8220;uniformResourceIdentifier&#8221; takes
+                    as its value a set of URI&#8217;s, each referencing
+                    information about online resources associated with the
+                    register. EXAMPLE
+                    &#239;&#191;&#189;http://www.digest.org/Navigate2.htm&#239;&#191;&#189; and &#239;&#191;&#189;http://www.epa.gov/opppmsd1/PPISdata/index.html&#239;&#191;&#189; are sample valuescorresponding value of the attribute
+                    <em>OnLineResource.linkage</em>
+                      specifies a resource providing access to the complete
+                    content of the register. EXAMPLE
+                    &#239;&#191;&#189;http://www.digest.org/Navigate2.htm&#239;&#191;&#189; and &#239;&#191;&#189;http://www.epa.gov/opppmsd1/PPISdata/index.html&#239;&#191;&#189; are sample values of
+                    <em>OnLineResource.linkage</em>
+                    .
+                  </p>
+                </td>
+                <td valign='top' align='left'/>
+                <td valign='top' align='left'>
+                  <p id='_'>M</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>*</p>
+                </td>
+                <td valign='top' align='left'>
+                  <p id='_'>URI</p>
+                </td>
+              </tr>
+              <tr>
+                <td valign='top' align='left'>
+                  <p id='_'>
+                    <strong>Constraints:</strong>
+                  </p>
+                </td>
+                <td colspan='7' valign='top' align='left'>
+                  <p id='_'>
+                    <tt>count(self.version +self.dateOfLastChange) &gt;= 1</tt>
+                  </p>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+          <p id='_'>footer text</p>
+          <p id='_'>footer text</p>
+        </clause>
+      </clause>
+    </clause>
+  </sections>