lua-users home
lua-l archive

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


Hi,
I assume LDoc, as the name says, seems to be a documentation tool, which are then fed to some parsing tool to produce documentation. 
I'm not sure how this is relevant for my use-case, where the annotation should somehow guide/modify the runtime behaviour of the annotated entity (be it a table, a function, a variable, etc). 

best,
valerio

On Fri, Mar 27, 2015 at 12:31 AM, Nagaev Boris <bnagaev@gmail.com> wrote:
On Thu, Mar 26, 2015 at 11:22 PM, Valerio Schiavoni
<valerio.schiavoni@gmail.com> wrote:
> Hi,
> is there some easy way to annotate Lua source, similarly to what happens
> with the @Annotate mechanism in Java?
> Ideally, such annotations should assigned to variables, tables and
> functions.
> Annotations should be assigned to behaviours triggered by operations that
> are specific to each type of annotation.
>
> Something like this:
>  --begin lua code
> [[@some_annotation]]
> table={}
>
> The effect of the presence of the annotation should be reflected by the init
> of the table's meta-table to trigger some application-specific action.
>
> Without such annotation mechanism, I can only see the following
> alternatives, which would however require
> some more efforts:
> - somehow override the table creation mechanism so that the table's
> metatables are automatically modified upon creation
> - similarly for variables and functions
>
>
> Any suggestion is greatly appreciated.
>
>
> valerio

Hello,

LDoc - A Lua Documentation Tool [1] provides annotations for functions
like this:

--- Summary ends with a period.
-- Some description, can be over several lines.
-- @param p1 first parameter
-- @param p2 second parameter
-- @return a string value
-- @see second_fun
function mod1.first_fun(p1,p2)
end

[1] https://github.com/stevedonovan/ldoc

Best regards,
Boris Nagaev