Include generated version notes in API reference pages (#725)

* Include generated version notes in API reference pages

Change the range of text copied into the API entry point reference pages so as
to include the generated version notes.

Closes #724

* Handle the fallback case for when there is no parameter section

Author: alycm

scripts/genRef.py

@@ -393,8 +393,12 @@ def emitPage(baseDir, specDir, pi, file):
             logWarn('emitPage:', pageName, 'INCLUDE is None, no page generated')
             return
 
-        # Specification text
-        lines = remapIncludes(file[pi.begin:pi.include + 1], baseDir, specDir)
+        # Specification text from beginning to just before the parameter
+        # section. This covers the description, the prototype, the version
+        # note, and any additional version note text. If a parameter section
+        # is absent then go a line beyond the include.
+        remap_end = pi.include + 1 if pi.param is None else pi.param
+        lines = remapIncludes(file[pi.begin:remap_end], baseDir, specDir)
         specText = ''.join(lines)
 
         if pi.param is not None: