From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jeremy Bryant via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#66928: [PATCH 2/2] Update names to match the docstring Date: Sat, 04 Nov 2023 22:56:14 +0000 Message-ID: <878r7dw2i0.fsf@jeremybryant.net> References: <87cywpwuid.fsf@jeremybryant.net> Reply-To: Jeremy Bryant Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30115"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 66928@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Nov 04 23:58:51 2023 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 1qzPbO-0007bn-AO for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Nov 2023 23:58:50 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qzPb1-00088E-VO; Sat, 04 Nov 2023 18:58:27 -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 1qzPb0-000885-DO for bug-gnu-emacs@gnu.org; Sat, 04 Nov 2023 18:58:26 -0400 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 1qzPb0-0002pu-5b for bug-gnu-emacs@gnu.org; Sat, 04 Nov 2023 18:58:26 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qzPba-0001Ze-85 for bug-gnu-emacs@gnu.org; Sat, 04 Nov 2023 18:59:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jeremy Bryant Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 04 Nov 2023 22:59:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66928 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 66928-submit@debbugs.gnu.org id=B66928.16991386925988 (code B ref 66928); Sat, 04 Nov 2023 22:59:02 +0000 Original-Received: (at 66928) by debbugs.gnu.org; 4 Nov 2023 22:58:12 +0000 Original-Received: from localhost ([127.0.0.1]:35887 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qzPal-0001YW-Sx for submit@debbugs.gnu.org; Sat, 04 Nov 2023 18:58:12 -0400 Original-Received: from out-188.mta1.migadu.com ([2001:41d0:203:375::bc]:32421) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qzPaj-0001YM-9O for 66928@debbugs.gnu.org; Sat, 04 Nov 2023 18:58:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jeremybryant.net; s=key1; t=1699138651; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=pWGwqOHgpxRumDn5IX/FUd4tUxRf1N+k+fqMYn88aso=; b=CU/R8kyCiOTp7761K707rRnpSA4Wp5PVzPX2x3G5vawBIQnOHVLb1EafCWLjhnYzr400a9 7y6VsJRvZz8dqwnV6SXSXOWKXzIK088XKQ0x+j1Ejan+p1lxJ1bUhCvRuT7EBrci2c/4v1 nY0m2uF2DXUSipwH6iyed3n3cHuRhWyfjV4rKZJ847y83khwlwZsUPA74SsyeyCsNiqLRv aX7ZzNbeSkFNENwSGAHlmNJZ6C6QnmivhgG+5rnLxwWzUs2ZdIP5V/JtoFtS0/UEN9iz5f CULQMkC7cKXc6D0gHmRj2ceL5B3fXiebbZNHq2GZ+4lJOnIkgyH6yKie1HpitQ== X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. In-reply-to: X-Migadu-Flow: FLOW_OUT 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:273794 Archived-At: thank you, I will work on this. One question, the elisp manual mentions that the \(fn ARGLIST) facility is particularly useful for macros. Why would we use this for defuns? What is TRT in general? Stefan Monnier writes: >> I noticed that for the function below the docstring doesn't match the >> arg names. > > I agree it's an odd choice (requiring the use of `\n(fn SYMBOL PROPNAME)`), > but it's not a big problem since the (fn SYMBOL PROPNAME) makes sure > that the right names are presented in `C-h o`. > > If you want to install a patch like you suggest, then please remove the > (fn SYMBOL PROPNAME) since it makes it redundant. > It'd be considered as a cosmetic patch. > > One more thing: the first line of the commit should be a bit more > specific, e.g. it could start with "(cl-remprop):" > > > Stefan