Re: Ref manual; lua_State documentation

[Coda Highland <chighland@...>]

On Fri, May 11, 2012 at 1:42 PM, liam mail <liam.list@googlemail.com> wrote:
> On 11 May 2012 19:25, Coda Highland <chighland@gmail.com> wrote:
>> It may be opaque but there's still a relationship between them that
>> needs documented.
>
> But "The reference manual is the official definition of the Lua
> language."[1][2] and this is an implementation detail.
>
> [1] http://www.lua.org/manual/5.1/
> [2] http://www.lua.org/manual/5.2/
>
> Liam
>

Coroutines are a documented function and the relationship between
coroutines is well-defined. As such, while the WAY two lua_States
implement their information sharing is an implementation detail, the
FACT that they share information is not. As such, it should be
documented that two distinct lua_States can share global data and that
coroutines are an example of how this might happen.

/s/ Adam