From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.devel Subject: Re: master 930c578c104: ; Improvements to PEG documentation Date: Sat, 20 Apr 2024 17:51:44 -0700 Message-ID: <87il0bleqn.fsf@ericabrahamsen.net> References: <171323742013.5283.3736155251539337632@vcs2.savannah.gnu.org> <20240416031700.9D2B1C1FB45@vcs2.savannah.gnu.org> <87le5dmxuf.fsf@gmx.de> <3800BF0D-113B-44B5-905E-A41B57E8BBB3@gmail.com> <87wmowltel.fsf@ericabrahamsen.net> <87frvk90it.fsf@web.de> <87jzkwlk3i.fsf@ericabrahamsen.net> <87y199j5kg.fsf@ericabrahamsen.net> <87mspn8uzl.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6186"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: emacs-devel@gnu.org Cancel-Lock: sha1:fh+3hmEg8eMzT9SO6v3DQTrGKWg= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Apr 21 06:38:05 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 1ryOxo-0001Mp-Ui for ged-emacs-devel@m.gmane-mx.org; Sun, 21 Apr 2024 06:38:04 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ryOx7-0003XJ-Ph; Sun, 21 Apr 2024 00:37:22 -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 1ryLQx-0002oH-6N for emacs-devel@gnu.org; Sat, 20 Apr 2024 20:51:56 -0400 Original-Received: from ciao.gmane.io ([116.202.254.214]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ryLQv-0008Vp-Tu for emacs-devel@gnu.org; Sat, 20 Apr 2024 20:51:54 -0400 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1ryLQu-0001ZZ-2t for emacs-devel@gnu.org; Sun, 21 Apr 2024 02:51:52 +0200 X-Injected-Via-Gmane: http://gmane.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=ged-emacs-devel@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: -5 X-Spam_score: -0.6 X-Spam_bar: / X-Spam_report: (-0.6 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, THIS_AD=1.043 autolearn=no autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 21 Apr 2024 00:37:19 -0400 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:317897 Archived-At: Michael Heerdegen via "Emacs development discussions." writes: > Eric Abrahamsen writes: > >> I've fixed this -- I ended up using "anonymous function" instead, >> mostly because the sentence was a bit confusing with just "function". > > Thanks. > > [ "Function" would have been fine with me, since it would be really > surprising if the code would name this ad-hoc constructed function that > is useful only once. And it doesn't matter. What matters a bit maybe > is the signature of this function - although one can guess it. ] It was more the language of the documentation: two "functions" in close proximity that referred to different functions; I found it a bit ambiguous, and awkward.