From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Robin Tarsiger Newsgroups: gmane.emacs.devel Subject: Why does help-fns--first-release not key on `' delimiters? Date: Thu, 6 Jan 2022 10:58:35 -0600 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37242"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.4.1 To: Emacs-Devel List Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jan 06 18:02:50 2022 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 1n5WA5-0009Vm-HY for ged-emacs-devel@m.gmane-mx.org; Thu, 06 Jan 2022 18:02:50 +0100 Original-Received: from localhost ([::1]:51378 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n5WA4-0005QK-10 for ged-emacs-devel@m.gmane-mx.org; Thu, 06 Jan 2022 12:02:48 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40298) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n5W66-0003Mu-KS for emacs-devel@gnu.org; Thu, 06 Jan 2022 11:58:42 -0500 Original-Received: from out3-smtp.messagingengine.com ([66.111.4.27]:32961) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n5W64-0000Xq-SG for emacs-devel@gnu.org; Thu, 06 Jan 2022 11:58:42 -0500 Original-Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id C46545C0165 for ; Thu, 6 Jan 2022 11:58:36 -0500 (EST) Original-Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Thu, 06 Jan 2022 11:58:36 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=dasyatidae.com; h=message-id:date:mime-version:to:from:subject:content-type :content-transfer-encoding; s=fm3; bh=GrAC2BCKESsjEtrVOmtzwcAFf7 CXsTNZRCyAJpEOYNs=; b=GJzECLD6U7xMs/q+Esy2uik6K6DAwu+4KSsp/HTJsB BoB4/aijbjKRdJM2KkiRJxHnWBLKGIb7+YXpP/uso236OSfmvhr8B+2xq2XOAts+ ekeLywCvxghG9L5VN49uREpi4Ngcn19CV7VoRC/+DsLQuwy+/m9DEMan2C7YUzH0 5gA2nc0s5fFLQGvvnss5vQPmBSNqb5av8dlqrJ5VR8TpzoyJ+0hgrUdUCVOMdbs0 n8gdAPGAmDGNEQKdu5B/7Heovj17z+EwAS1oHzgJnhvDZHI2S3zS7aqgUvnCk4MM m2hSJlyz++wuWN8jtUa+m/vbsDP5R+mNlp1aMvza3wDQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:message-id:mime-version:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=GrAC2B CKESsjEtrVOmtzwcAFf7CXsTNZRCyAJpEOYNs=; b=fy4+7d7aJNdDAwFXzMIxnw 1jeOzPKQh21eE6w9MAn+2myJnWkKgZbfaMtpL22ZVL9jGiZBIuRA2w1AA+iXZ+Cd zTc6OrVhUzOEQqH7EDe01O3e3DMn1pxdWlxwE2/kr5QCDrIBa8v+oRnAnwywZu/G q/7q1V/JR5NX+QrSiw6R7O33UbjWycixl2PDPib4qb7Yz64e97UpqV0OLKhl7UnM VSQYfoxSeYV9rtOsdermU14o2d2Wf8+ardU02Kw8BVdpisx/BHmGsCFGAAjz1pdV tHlSw06J+plJws2ILXE/lXxfe5AHfMqNBwBHS5mMBwkZHylxBEdAgfakrW9SCwHQ == X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddrudefledgleefucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepkfffgggfvffhufgtgfesthejredttdefjeenucfhrhhomheptfhosghinhcu vfgrrhhsihhgvghruceorhhtthesuggrshihrghtihgurggvrdgtohhmqeenucggtffrrg htthgvrhhnpeeihefhtdfgieejvdevffegtdffieelieduffeggfehhefggeefffehgeek gedtgfenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpe hrthhtsegurghshigrthhiuggrvgdrtghomh X-ME-Proxy: Original-Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Thu, 6 Jan 2022 11:58:36 -0500 (EST) Content-Language: en-US-large Received-SPF: pass client-ip=66.111.4.27; envelope-from=rtt@dasyatidae.com; helo=out3-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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" Xref: news.gmane.io gmane.emacs.devel:284330 Archived-At: So, for some context first: Recently, I went to check when the tagged record type had been added to Emacs, and typed C-h f record, only to see: > (record TYPE &rest SLOTS) > > Probably introduced at or before Emacs version 1.9. This didn't seem right at all, and unfortunately, the NEWS.1-17 line it linked to was part of the following paragraph: > ** write-kbd-macro and append-kbd-macro are used to save > a kbd macro definition in a file (as Lisp code to > redefine the macro when the file is loaded). > These commands differ in that write-kbd-macro > discards the previous contents of the file. > If given a prefix argument, both commands > record the keys which invoke the macro as well as the ^^^^^^ > macro's definition. This is a very silly result. (For the, er, record, the _actual_ NEWS entry for record types is at NEWS.26:1507, under the section for Lisp changes in Emacs 26.1.) Looking at the function help-fns--first-release that generates this text, it looks like it just searches for the symbol name. However, it seems to be conventional in these NEWS files for important symbols to be surrounded by `' pseudo-quotes, just like in e.g. elisp docstrings. Is there a reason help-fns--first-release doesn't already expect these? Presumably the matching is best-effort to begin with, and this seems like it could eliminate a lot of false positives. It's not costless, of course; one counterexample I saw is that Emacs 17's section on renaming `dot' to `point' in various symbols doesn't use those delimiters around each of the indvidual names: > ** `dot' renamed `point'. > > The word `dot' has been replaced with `point' in all > function and variable names, including: > > point, point-min, point-max, > point-marker, point-min-marker, point-max-marker, > window-point, set-window-point, > point-to-register, register-to-point, > exchange-point-and-mark. > > The old names are still supported, for now. but at first glance this seems like an acceptable tradeoff. Thoughts? -RTT