cmark

diff --git a/man/make_man_page.py b/man/make_man_page.py
@@ -1,18 +1,25 @@
 #!/usr/bin/env python
 
 # Creates a man page from a C file.
+
 # Lines beginning with /// are treated as Markdown.
+
 # Non-blank lines immediately following a /// line are treated
-# as function signatures or examples and included verbatim.
+# as function signatures or examples and included verbatim. The
+# immediately preceding markdown chunk is printed after the example
+# as a comment on it.
+
 # That's about it!
 
 import sys
 import re
 
-special_comment_re = re.compile('\/\/\/');
+special_comment_re = re.compile('^\/\/\/ ?');
 blank_re = re.compile('^\s*$');
 
 mdlines = []
+chunk = []
+sig = []
 
 with open('../src/cmark.h', 'r') as cmarkh:
     state = 'default'
@@ -27,11 +34,26 @@ with open('../src/cmark.h', 'r') as cmarkh:
             state = 'signature'
 
         # handle line
-        if oldstate != state and len(mdlines) > 0 and mdlines[-1] != '\n':
-            mdlines.append('\n')
+        #if oldstate != state and len(mdlines) > 0 and mdlines[-1] != '\n':
+        #    mdlines.append('\n')
         if state == 'markdown':
-            mdlines.append(line[4:])
+            chunk.append(re.sub(special_comment_re, '', line))
         elif state == 'signature':
-            mdlines.append('    ' + line)
+            sig.append('    ' + line)
+        elif oldstate == 'signature' and state != 'signature':
+            if len(mdlines) > 0 and mdlines[-1] != '\n':
+                mdlines.append('\n')
+            mdlines += sig   # add sig, then prepended markdown comment
+            if len(mdlines) > 0 and mdlines[-1] != '\n':
+                mdlines.append('\n')
+            mdlines += chunk
+            chunk = []
+            sig = []
+        elif oldstate == 'markdown' and state != 'signature':
+            if len(mdlines) > 0 and mdlines[-1] != '\n':
+                mdlines.append('\n')
+            mdlines += chunk # add markdown chunk
+            chunk = []
+            mdlines.append('\n')
 
 sys.stdout.write(''.join(mdlines))