gen_vimdoc.py: fix "seealso", "xrefs"

- Also fix xrefs ("Deprecated" section)
- Fix "Deprecated" rendering by a weird hack (see comment).
- Eliminate unnecessary use of render_para()

1 files changed, 7 insertions, 5 deletions

diff --git a/scripts/gen_vimdoc.py b/scripts/gen_vimdoc.py
index 2ca121c299..676e6b5be9 100755
--- a/scripts/gen_vimdoc.py
+++ b/scripts/gen_vimdoc.py
@@ -435,9 +435,11 @@ def para_as_map(parent, indent='', width=62):
         chunks['seealso'].append(render_node(
             child, '', indent=indent, width=width))
     for child in groups['xrefs']:
-        title = get_text(get_child(child, 'xreftitle'))
+        # XXX: Add a space (or any char) to `title` here, otherwise xrefs
+        # ("Deprecated" section) acts very weird...
+        title = get_text(get_child(child, 'xreftitle')) + ' '
         xrefs.add(title)
-        xrefdesc = render_para(get_child(child, 'xrefdescription'), width=width)
+        xrefdesc = get_text(get_child(child, 'xrefdescription'))
         chunks['xrefs'].append(doc_wrap(xrefdesc, prefix='{}: '.format(title),
                                         width=width) + '\n')
 
@@ -496,7 +498,7 @@ def extract_from_xml(filename, mode, fmt_vimhelp):
     fmt_doxygen_xml_as_vimhelp(). (TODO: ugly :)
     """
     global xrefs
-    xrefs = set()
+    xrefs.clear()
     functions = {}  # Map of func_name:docstring.
     deprecated_functions = {}  # Map of func_name:docstring.
 
@@ -623,8 +625,8 @@ def extract_from_xml(filename, mode, fmt_vimhelp):
                 fn['parameters_doc'].update(m['params'])
             if 'return' in m and len(m['return']) > 0:
                 fn['return'] += m['return']
-            if 'seealso' in m and len(m['xrefs']) > 0:
-                fn['seealso'].append(str(m['xrefs']))
+            if 'seealso' in m and len(m['seealso']) > 0:
+                fn['seealso'] += m['seealso']
 
         if INCLUDE_C_DECL:
             fn['c_decl'] = c_decl