lua-users home
lua-l archive

[Date Prev][Date Next][Thread Prev][Thread Next] [Date Index] [Thread Index]


I try to document what types *should* be passed to functions, which means I make heavy use of typed argument and typed return values, but I don't think I brew too much @-soup when programming besides that.

On Sun, Jun 11, 2017, 11:18 steve donovan <steve.j.donovan@gmail.com> wrote:
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.)

--
--

Ryan <vandor2012@gmail.com>
Software Developer / System Administrator
https://hashbang.sh