[OT] of [OT] I am a developer and I hate documentation

Stefan Koch via Digitalmars-d digitalmars-d at puremagic.com
Thu Aug 18 06:49:07 PDT 2016


On Thursday, 18 August 2016 at 13:19:13 UTC, Chris wrote:

> Isn't there a way to auto-generate a minimal documentation with 
> the help of the compiler? As in
>
> int myFunction(int a, int b)
> {
>   if (a > -1)
>     return a + b;
>   return -1;
> }
>
> // auto-gen:
> Returns `int`, if `a` is greater than -1, else returns -1.
> Parameters: `int`, `int`; Returns `int`.
>
> Something like that.

Would you like a patch ? that will at least autogen Returns 
`int`, Parameters: `int a`, `int b`;

No automatic Semantics though.


More information about the Digitalmars-d mailing list