From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#73626: 30.0.91; Type specifiers of functions Date: Fri, 15 Nov 2024 23:21:59 -0500 Message-ID: References: <86msjkxdf5.fsf@gnu.org> <86ikthcxjx.fsf@gnu.org> <86seskbi2q.fsf@gnu.org> <86zfm8n51g.fsf@gnu.org> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23557"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, 73626@debbugs.gnu.org To: Andrea Corallo Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Nov 16 05:23:33 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1tCALL-0005wp-Oh for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 16 Nov 2024 05:23:32 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tCAKy-0008PG-1Y; Fri, 15 Nov 2024 23:23:08 -0500 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 1tCAKt-0008P1-DB for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2024 23:23:04 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tCAKt-0000jT-3p for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2024 23:23:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:References:In-Reply-To:From:To:Subject; bh=+UAOKiKVl4kCdkY28C+EXEufNDSGBJY4og2r7laUeXY=; b=un3sVjziiY1TU+/N5u14JnQ9d1orHd0+hjjWDVpKmj6weKmm7eMguWD/hnufFVyGSnLsir1Yy0DhTGPu3eEPHYyk96wHCAS92nFteSHCqe0cXsg2RKVq2zS7dhLYd9hMfNdmYsBEalZ/5Ep/kmE9eD/adM63D6Egl8StyJJwBz33H+AmGaZ06IIS/vb6NOm+Y8Bq+yUuRXV1i5ebdbxJBWL2z+cOdoe6yQQCDsJ5MIxu3puIQ3wgk47Oc8bRLE2JWN1C0nJbp7os+qWzLkmhmaZSJa9qLJiwKzvCjRRD9XRC2yRdJ9pOq2mv+ywz3c2Qh+rVYYfJ7d1vOV1PGIGj1A==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tCAKs-0002ix-KO for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2024 23:23:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Nov 2024 04:23:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73626 X-GNU-PR-Package: emacs Original-Received: via spool by 73626-submit@debbugs.gnu.org id=B73626.173173093210403 (code B ref 73626); Sat, 16 Nov 2024 04:23:02 +0000 Original-Received: (at 73626) by debbugs.gnu.org; 16 Nov 2024 04:22:12 +0000 Original-Received: from localhost ([127.0.0.1]:51683 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tCAK3-0002hj-SZ for submit@debbugs.gnu.org; Fri, 15 Nov 2024 23:22:12 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:50190) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tCAK1-0002hT-Fo for 73626@debbugs.gnu.org; Fri, 15 Nov 2024 23:22:10 -0500 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 1tCAJw-0000dP-4S for 73626@debbugs.gnu.org; Fri, 15 Nov 2024 23:22:04 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=+UAOKiKVl4kCdkY28C+EXEufNDSGBJY4og2r7laUeXY=; b=rZ63EoQcQgv6 lhWQIyWTQAPHazxkP8+UIHqzRxQCCQmipDyDgrucKk6ZVY38SjPka70X/HmCIjaZtbIzxssWaSdvz nMhp4PXQFBHhnIS/aYlyqh2Jd/5jWsM/wDhZWdNY7Y4IwKFtxQiCcRWv7mhDzhe+Yl3CgUvBocdLI gSoz4qZPzPq+IzaG8nP1yFOYZ8BWUK9VDKVsv4neJydLIxThlt67jULfFAjRxvdkY3n04Kw1pQw1B v5b33CjCimWlzEpq0YFo00Y9xTJ45kHiY2MJd60oFCW3YmbOplpKj3Hu+xi0tGgebaqublxsTPDoB 183B5OsLyjEIQrpBhRahwg==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1tCAJr-0006Lo-FB; Fri, 15 Nov 2024 23:22:00 -0500 In-Reply-To: (message from Andrea Corallo on Wed, 13 Nov 2024 19:27:52 -0500) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:295430 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > -@var{type} is a type specifier in the form @w{@code{(function > +@var{type} is a @ref{Type Specifier} in the form @w{@code{(function > (ARG-1-TYPE ... ARG-N-TYPE) RETURN-TYPE)}}. Please don't use a cross-reference to stand in for a nominal. It isn't grammatically coherent, and I think it will look completely wrong in some output formats. The right thing to use here is this: type specifier (@pxrer{Type Specifier}) -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)