Re: q about luadoc and userdata/metamethods etc

[Graham Wakefield <lists@...>]

I guessed that the answer to other part of my Q, about whether there  
is luadoc for the main lua libraries, is no.

I was asking this because I thought it would be beneficial to users  
of Lua and Lua modules (including relatively novice users such as  
those making use of the recent Windows package) to be able to make  
use of a unified reference source, conforming to a principle of least  
surprise. The same might apply to Lua + modules embedded within a  
specific app; modifying an existing reference would be easier (more  
likely to happen) than each developer writing a reference from  
scratch.  So, in the spirit of helping a great language move forward,  
a couple of speculative suggestions in that direction:

1- make luadoc an important and automatic component within a rockspec
2- put together a luadoc for the main Lua language & libraries (based  
on the reference manual)
3- put luadoc into the luaforge system, or the luarocks website, or  
some other online repo, so that many modules' functionality can  
easily be browsed online

Any thoughts? Is luadoc considered mature and stable enough for this?