On Sun, Jun 11, 2017 at 1:36 PM, Martin <eden_martin_fuhrspam@gmx.de> wrote:
> May not, unless you are Steve Donovan.
Heh. Well to be honest, all the @ soup can be irritating. ldoc also
supports plain doc comments (that start with ---) without needing any
directives. (This is pretty much the style of the Lua standard library
as well) I think that some care in structured documentation is useful
for external APIs in dynamic languages, because there are no explicit
types. (In fact, I'm curious about any progress with TypedLua, since
dynamic languages with type annotations are fashionable at the
moment.)