lua-users home
lua-l archive

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


Wow, totally forgot @usage :P thanks for the quick reply! I use @usage as well for basically every public function, but not for scripts (as instead <script> --help ; auto generates documentation instead! <3)

On Sun, Jun 11, 2017, 12:25 steve donovan <steve.j.donovan@gmail.com> wrote:
On Sun, Jun 11, 2017 at 7:17 PM, Charles Heywood <vandor2012@gmail.com> wrote:
> 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.

That's the important part, I think. @usage is often helpful, but
having type in some _structured_ form in the doc comments not only
help the human consumers of the API, but might be used by some
automatic tools as well.  I think this is done by the Lua Eclipse
plugin, but in their wisdom they chose a format which is not quite
ldoc compatible.

--
--

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