Feature request: api docs

[Reißner Ernst]

Hello all,

I know that texinfo offers some commands to document a function which can be used for various computing languages.

One can document the signature: specify name of function, return variable and input parameters.

 

What is missing in my opinion: a way to document the meaning of the input parameters

And of the return value and documentation of errors/exception.

There are many api doc systems providing these things, java, c#, c++(doxygen), python(https://developer.lsst.io/python/numpydoc.html)

And the latter is a good illustration for what I want to say.

 

Also missing: a way to document a class or even a package.

Texinfo seems not yet arrived in oo world.

 

Any change to get this included?

 

I ask because texinfo has many advantages also… above all the many interesting output formats.

 

Best Regards,

Ernst