Use two-part valueHelp with format and description.

Rename helpString to just help.

2 files changed, 24 insertions, 20 deletions

diff --git a/data/schemata/interface_definition.rnc b/data/schemata/interface_definition.rnc
index d28d06d..a0d6bc1 100644
--- a/data/schemata/interface_definition.rnc
+++ b/data/schemata/interface_definition.rnc
@@ -45,11 +45,11 @@ children = element children
 # but whether they are used or not is implementation-defined
 properties = element properties
 {
-    helpString?,
+    help?,
     constraint?,
 
     # These are meaningful only for leaf nodes
-    valueHelpString?,
+    valueHelp?,
     (multi | valueless)?
 }
 
@@ -149,15 +149,15 @@ valueless = element valueless
     empty
 }
 
-# helpString tag contains brief description of the purpose of the node
-# Must have description= attribute
-helpString = element helpString
+# help tags contains brief description of the purpose of the node
+help = element help
 {
     text
 }
 
-# valueHelpString tags contain information about acceptable value format
-valueHelpString = element valueHelpString
+# valueHelp tags contain information about acceptable value format
+valueHelp = element valueHelp
 {
-    text
+    element format { text } &
+    element description { text }
 }
diff --git a/data/schemata/interface_definition.rng b/data/schemata/interface_definition.rng
index bc55542..7766716 100644
--- a/data/schemata/interface_definition.rng
+++ b/data/schemata/interface_definition.rng
@@ -63,14 +63,14 @@
   <define name="properties">
     <element name="properties">
       <optional>
-        <ref name="helpString"/>
+        <ref name="help"/>
       </optional>
       <optional>
         <ref name="constraint"/>
       </optional>
       <optional>
         <!-- These are meaningful only for leaf nodes -->
-        <ref name="valueHelpString"/>
+        <ref name="valueHelp"/>
       </optional>
       <optional>
         <choice>
@@ -212,19 +212,23 @@
       <empty/>
     </element>
   </define>
-  <!--
-    helpString tag contains brief description of the purpose of the node
-    Must have description= attribute
-  -->
-  <define name="helpString">
-    <element name="helpString">
+  <!-- help tags contains brief description of the purpose of the node -->
+  <define name="help">
+    <element name="help">
       <text/>
     </element>
   </define>
-  <!-- valueHelpString tags contain information about acceptable value format -->
-  <define name="valueHelpString">
-    <element name="valueHelpString">
-      <text/>
+  <!-- valueHelp tags contain information about acceptable value format -->
+  <define name="valueHelp">
+    <element name="valueHelp">
+      <interleave>
+        <element name="format">
+          <text/>
+        </element>
+        <element name="description">
+          <text/>
+        </element>
+      </interleave>
     </element>
   </define>
 </grammar>