Possible edge case

[ianhi]

I'm not sure what I'd expect velin to do here but just pointing out that it doesn't currently recognize the returns as a section in this docstring, instead treating it as another parameter. I suppose there is a fundamental ambiguity here unfortunately, so it may not be fixable, but perhaps should be flagged?

def f(blarg):
    """
    Parameters
    ----------
    blarg : bool
        some description
    returns
    -------
    init_val, control
    """
    pass

gives this output:

(mpl-inter) ian@fermented-beans:~/Documents/jupyter/mpl-interactions$ velin v_test.py 
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:513 in  | v_test.py:f
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:514 in  |   missing: set()
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:515 in  |   extra: {'-------', 'returns', 'init_val', 'control'}
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:513 in  | v_test.py:f
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:514 in  |   missing: set()
~/mambaforge/envs/mpl-inter/lib/python3.9/site-packages/velin/ref.py:515 in  |   extra: {'-------', 'returns', 'init_val', 'control'}

[Carreau]

This is an issue in numpydoc parsing. you actually do need a blank line before Returns