From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <v.shpilevoy@tarantool.org>
Received: from smtpng3.m.smailru.net (smtpng3.m.smailru.net [94.100.177.149])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256
 bits)) (No client certificate requested)
 by dev.tarantool.org (Postfix) with ESMTPS id CF340469719
 for <tarantool-patches@dev.tarantool.org>;
 Sat,  3 Oct 2020 00:48:34 +0300 (MSK)
References: <cover.1600955781.git.tsafin@tarantool.org>
 <f1c93189f822cb09756fe24ae64149b932abbb3d.1600955781.git.tsafin@tarantool.org>
 <847daa09-7b38-2663-ae88-951d8dfade01@tarantool.org>
 <09ea01d698b7$5a141130$0e3c3390$@tarantool.org>
From: Vladislav Shpilevoy <v.shpilevoy@tarantool.org>
Message-ID: <d0bebe3d-d083-727f-1cdb-bb2a6cb0cf35@tarantool.org>
Date: Fri, 2 Oct 2020 23:48:33 +0200
MIME-Version: 1.0
In-Reply-To: <09ea01d698b7$5a141130$0e3c3390$@tarantool.org>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Subject: Re: [Tarantool-patches] [PATCH 2.X 3/7] module api: luaT_newthread
List-Id: Tarantool development patches <tarantool-patches.dev.tarantool.org>
List-Unsubscribe: <https://lists.tarantool.org/mailman/options/tarantool-patches>, 
 <mailto:tarantool-patches-request@dev.tarantool.org?subject=unsubscribe>
List-Archive: <https://lists.tarantool.org/pipermail/tarantool-patches/>
List-Post: <mailto:tarantool-patches@dev.tarantool.org>
List-Help: <mailto:tarantool-patches-request@dev.tarantool.org?subject=help>
List-Subscribe: <https://lists.tarantool.org/mailman/listinfo/tarantool-patches>, 
 <mailto:tarantool-patches-request@dev.tarantool.org?subject=subscribe>
To: Timur Safin <tsafin@tarantool.org>, alexander.turenko@tarantool.org
Cc: tarantool-patches@dev.tarantool.org

> : > +/**
> : > + * @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?