AW: Feature request: api docs

2022-02-07 Thread Reißner Ernst
> It seems to me that what is in the numpydoc specification is somewhat too > specific to be > relevant for Texinfo. However, I also think that we should make sure that a > corresponding > formatting can be achieved, even if without some specific semantic. It seems > to me that almost > ev

AW: Feature request: api docs

2022-02-07 Thread Reißner Ernst
I must correct myself: @result and @error are not usable, Because it has also semantics and within apidocs this would be misuse. I think @param, @return and @throws would be fine at least for functions. The above shall be to describe sth, like so: @return the return value is the @var{n} th prim

AW: Feature request: api docs

2022-02-07 Thread Reißner Ernst
-Ursprüngliche Nachricht- Von: Gavin Smith Gesendet: Freitag, 4. Februar 2022 18:27 An: Reißner Ernst Cc: bug-texinfo@gnu.org; rei3...@arcor.de Betreff: Re: Feature request: api docs CAUTION: This email originated from outside your organization. Exercise caution when opening attachme