mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2025-09-06 19:38:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

gen_vimdoc.py: skip "Parameters" header if all excluded

Browse Source
This commit is contained in:
Justin M. Keyes
2019-04-22 21:24:46 +02:00
parent 544305e802
commit c1887f465d
2 changed files with 9 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
scripts/gen_vimdoc.py
View File

@@ -219,6 +219,14 @@ def doc_wrap(text, prefix='', width=70, func=False, indent=None):
return result
def has_nonexcluded_params(nodes):
"""Returns true if any of the given <parameterlist> elements has at least
one non-excluded item."""
for n in nodes:
if render_params(n) != '':
return True
def render_params(parent, width=62):
"""Renders Doxygen <parameterlist> tag as Vim help text."""
name_length = 0
@@ -356,7 +364,7 @@ def render_para(parent, indent='', width=62):
chunks = [text]
# Generate text from the gathered items.
if len(groups['params']) > 0:
if len(groups['params']) > 0 and has_nonexcluded_params(groups['params']):
chunks.append('\nParameters: ~')
for child in groups['params']:
chunks.append(render_params(child, width=width))