From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by turing.freelists.org (Avenir Technologies Mail Multiplex) with ESMTP id 57A9629EDA for ; Mon, 1 Apr 2019 01:17:10 -0400 (EDT) Received: from turing.freelists.org ([127.0.0.1]) by localhost (turing.freelists.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 0tzddSP3R23f for ; Mon, 1 Apr 2019 01:17:10 -0400 (EDT) Received: from smtp39.i.mail.ru (smtp39.i.mail.ru [94.100.177.99]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by turing.freelists.org (Avenir Technologies Mail Multiplex) with ESMTPS id 1112029DAA for ; Mon, 1 Apr 2019 01:17:09 -0400 (EDT) Date: Mon, 1 Apr 2019 08:17:07 +0300 From: Konstantin Osipov Subject: [tarantool-patches] Re: [PATCH v2 2/4] sql: refactor getNewIid() function Message-ID: <20190401051707.GA8239@chai> References: <2047d49bec832a3c6c639b253fda249225b9c8ea.1553729426.git.korablev@tarantool.org> <32bf26dc-79ef-6bee-725a-2e1acf37d297@tarantool.org> <611549C1-8E50-42E2-9242-1E5CE9AE4D74@tarantool.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <611549C1-8E50-42E2-9242-1E5CE9AE4D74@tarantool.org> Sender: tarantool-patches-bounce@freelists.org Errors-to: tarantool-patches-bounce@freelists.org Reply-To: tarantool-patches@freelists.org List-Help: List-Unsubscribe: List-software: Ecartis version 1.0.0 List-Id: tarantool-patches List-Subscribe: List-Owner: List-post: List-Archive: To: tarantool-patches@freelists.org Cc: Vladislav Shpilevoy * n.pettik [19/03/29 21:18]: > > 1. According to doxygen docs http://www.doxygen.nl/manual/commands.html > > there is no such a command as @space_id. But obviously I know what > > you've implied here. For references to parameters we use '@a' before a > > parameter. Like this: > > ... > > * the space identifier by @a space_id. > > ... > > Does anybody even try to generate doxygen doc? > I still believe that doxygen format may be useful only > for external (aka interface) functions. The rest of comments > (especially for static funcs) are seem to be aimed solely at > developers. True, but functions and comments live for a long time so it's better to stick to a single style of comments. -- Konstantin Osipov, Moscow, Russia, +7 903 626 22 32 http://tarantool.io - www.twitter.com/kostja_osipov