Add test that documentation is properly formatted Markdown

The leading and trailing blank line requirement is just to ease editing and
maintenance, for example so that naive tools can wrap paragraphs.

1 files changed, 10 insertions, 0 deletions

diff --git a/wscript b/wscript
index d67efb2..fa45db5 100644
--- a/wscript
+++ b/wscript
@@ -500,6 +500,16 @@ def test_vocabularies(check, specs, files):
             check(lambda: comment == comment.strip(),
                   name = "%s comment has stripped whitespace" % subject)
 
+        # Check that lv2:documentation, if present, is proper Markdown
+        documentation = model.value(subject, lv2.documentation, None)
+        if documentation is not None:
+            check(lambda: documentation.datatype == lv2.Markdown,
+                  name = "%s documentation is explicitly Markdown" % subject)
+            check(lambda: str(documentation).startswith('\n\n'),
+                  name = "%s documentation starts with blank line" % subject)
+            check(lambda: str(documentation).endswith('\n\n'),
+                  name = "%s documentation ends with blank line" % subject)
+
 
 def test(tst):
     import tempfile