From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Andrea Corallo Newsgroups: gmane.emacs.devel Subject: Re: Declaring Lisp function types Date: Wed, 01 May 2024 16:54:04 -0400 Message-ID: References: <8634sdjgoj.fsf@gnu.org> <86mspaq4ro.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32803"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: emacs-devel@gnu.org, stefankangas@gmail.com, adam@alphapapa.net, monnier@iro.umontreal.ca, arthur.miller@live.com To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed May 01 22:54:57 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1s2Gyf-0008K7-3I for ged-emacs-devel@m.gmane-mx.org; Wed, 01 May 2024 22:54:57 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1s2Gxz-0007lU-HD; Wed, 01 May 2024 16:54:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s2Gxu-0007kw-Hh for emacs-devel@gnu.org; Wed, 01 May 2024 16:54:11 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s2Gxs-0002CL-9H; Wed, 01 May 2024 16:54:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=7Pu2Ps44qTq++p0sURHbVPduuqI0AZVsEeZcXuOoAlg=; b=YQvMxCyVxTKf+Mw4Ffep f41U8y//ER36h0VFgilhao1LnPmHGzZjwg6rrRA4iDmRttHj8BvaM5SsY6INq23V7ZvL+t3stiBzl 7bD0jTs3hOVFM0oMy9qvTddjaHwy5F/1Y4Vovl5jM02UtdH4IV2Vao3OcTUtia69HWg+v/0FJBNsd KDqX5Nx/n9UlU8B6PBHOgZxQD6/oGmCVpwqtjmqgNk0Ifz5QQRYfmJD11qbZcshCMnp22mIDnZJSf DuptMg+BUHWvPrTFZEbnqgpUJ39CxlbRcY3DNtDUF2+VBzDobPNDVdtmObc7rPEc3uuLwr6NXHwY+ 1T15WrNGYa5FVg==; Original-Received: from acorallo by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1s2Gxp-0001Hp-22; Wed, 01 May 2024 16:54:05 -0400 In-Reply-To: <86mspaq4ro.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 30 Apr 2024 17:55:23 +0300") X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:318517 Archived-At: Eli Zaretskii writes: >> From: Andrea Corallo >> Cc: emacs-devel@gnu.org, stefankangas@gmail.com, adam@alphapapa.net, >> monnier@iro.umontreal.ca, arthur.miller@live.com >> Date: Mon, 29 Apr 2024 13:48:01 -0400 >> >> Here we go, I pushed on 'scratch/lisp-func-type-decls' the >> implementation of what we discussed with a doc entry. Any suggestion or >> is it okay for master? > > I think you can land it on master, but please expand this terse > description: > > @item (type @var{type}) > Declare @var{type} to be the type of this function. This is used for > documentation by @code{describe-function}. Also it can be used by the > native compiler (@pxref{Native-Compilation}) for improving code > generation and for deriving more precisely the type of other functions > without type declaration. Agree, I tried to add some of this. > Without any discussion of what can be @var{type} and no examples, this > is too abstract. I learned more about it from the other parts of the > changeset, where you actually use this. So please say something about > what can be @var{type}, and add one or two examples. > > Also, should we say something in NEWS about this? Entry added. Please let me know if you like me to merge it or I can improve it further. Thanks Andrea