fixes #530 pull out the docs

utils/dev_units2rst.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+
+'''
+Developers: use this code to develop and test nxdl2rst.py
+'''
+
+import sys
+from units2rst import worker
+
+
+sys.argv.append("../nxdlTypes.xsd")
+worker('anyUnitsAttr')

utils/units2rst.py

@@ -49,7 +49,15 @@ def worker(nodeMatchString, section = 'units'):
         node_name = node.get('name')
         if 'nxdl:' + node_name in members:
             words = node.xpath('xs:annotation/xs:documentation', namespaces=ns)[0]
-            db[node_name] = words.text
+            examples = []
+            for example in words.iterchildren():
+                nm = example.attrib.get("name")
+                if nm is not None and nm == "example":
+                    examples.append("``"+example.text+"``")
+            a = words.text
+            if len(examples) > 0:
+                a = a.strip() + " -- example(s): " + " | ".join(examples)
+            db[node_name] = a
 
 #             for item in node.xpath('xs:restriction//xs:enumeration', namespaces=ns):
 #                 key = '%s' % item.get('value')