[Tarantool-patches] [PATCH 2.X 3/7] module api: luaT_newthread

[Vladislav Shpilevoy]

> : > +/**
> : > + * @brief Creates a new Lua coroutine in a protected frame. If
> : > + * <lua_newthread> call underneath succeeds, the created Lua state
> : > + * is on the top of the guest stack and a pointer to this state is
> : > + * returned. Otherwise LUA_ERRMEM error is handled and the result
> : > + * is NULL.
> : > + * @param L is a Lua state
> : 
> : 2.
> : 	@param L Lua state.
> : 
> : Or probably could be even dropped. Such description is useless anyway.
> 
> Do you consider that L is obvious for external author 
> that it means Lua state? I'd rather disagree.

Its type is literally 'lua_State'. Why don't you describe that an
integer parameter is an 'int' then?