q about luadoc and userdata/metamethods etc

[Graham Wakefield <lists@...>]

Hi all,

I'm wondering whether there's a standard way to provide luadoc for  
modules that instantiate userdata with metamethods.

The luadoc guidelines only discuss table fields & global functions  
(http://luadoc.luaforge.net/manual.html#howto), but how would one  
document a userdata, and in particular a userdata metamethod (such as  
file:read).

On a related note, is there existing luadoc based upon the Lua  
reference manual?

Thx