Autodocument arguments blocks

[XiaoCasd]

It would be helpful to auto-document the argument blocks of a function, and show the argument types, validations, and comments. For example, the following argument block in MATLAB

arguments 
   var string %It is a string
end

can be converted to a docstring

:param string var: It is a string

[joeced]

This is partly being worked on in this branch. The PR #261 adds parsing of argument blocks. Maybe this could be a future feature.

[apozharski]

@XiaoCasd and anyone else interested in this feature:

With the merging of #261 into main this feature now should work (and is tested in test_parse_mfile). I am not yet ready to cut a new release as I want to write a few more tests to verify that the new parsing works correctly for the newly supported features (enumerations, argument blocks, and events) and that the output for these is correct. If you have any feedback I would be happy to hear it.

I will close this issue as completed in the next release.