From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#72829: describe-function NEWS* scraper override Date: Sat, 31 Aug 2024 15:26:58 -0700 Message-ID: References: <79C79924-4870-4E55-9920-3D2C08A1E765@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="655"; mail-complaints-to="usenet@ciao.gmane.io" Cc: steve@sanityinc.com, Stefan Monnier To: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= , 72829@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 01 00:29:22 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 1skWav-000Acj-PA for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 01 Sep 2024 00:29:21 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1skWaf-00070N-9e; Sat, 31 Aug 2024 18:29:05 -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 1skWae-0006zy-2y for bug-gnu-emacs@gnu.org; Sat, 31 Aug 2024 18:29:04 -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 1skWad-00063b-QC for bug-gnu-emacs@gnu.org; Sat, 31 Aug 2024 18:29:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:MIME-Version:References:In-Reply-To:From:To:Subject; bh=52qiR+IQ3LlhEx2nN6WZ3SC2MGHIRL2IQyCiw1kXWIY=; b=cra4gRlAOKf/Hxo3ILEqVM2yVaX6LRNq7fKpNf0gWrcxH4RYxevTWWuWkpecoFdboHmyS0Mg0i3Acot5omP9F6oro1zFldBEoUsaDHFV4JoIPU/t6n3BRa7n0+cqD7V3QSHvp7Xys/qyezySjyJ6vtoN2lHNKD3z+PE70R22rSem5qBMBH+XlQwpB8jRvYuTVtA2UqOxzCUOpwVGVSkxs894DExoJB9E8rvaxtDYzyIrOSkYjpnAQh5yuwv55BTS65MkTXMm8wlLMsqnIhls4gO5n8YyOz1/aO/ONvb6KRW6RzCEn+A070E5JsLcGGchKSzkwS80r1N5qdeNPCZZoQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1skWba-00078m-D9 for bug-gnu-emacs@gnu.org; Sat, 31 Aug 2024 18:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 31 Aug 2024 22:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72829 X-GNU-PR-Package: emacs Original-Received: via spool by 72829-submit@debbugs.gnu.org id=B72829.172514334627331 (code B ref 72829); Sat, 31 Aug 2024 22:30:02 +0000 Original-Received: (at 72829) by debbugs.gnu.org; 31 Aug 2024 22:29:06 +0000 Original-Received: from localhost ([127.0.0.1]:58386 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skWaf-00076l-LI for submit@debbugs.gnu.org; Sat, 31 Aug 2024 18:29:05 -0400 Original-Received: from mail-ed1-f53.google.com ([209.85.208.53]:59766) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skWad-00076D-6U for 72829@debbugs.gnu.org; Sat, 31 Aug 2024 18:29:03 -0400 Original-Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-5c09fd20eddso3024376a12.3 for <72829@debbugs.gnu.org>; Sat, 31 Aug 2024 15:28:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725143219; x=1725748019; darn=debbugs.gnu.org; h=content-transfer-encoding:cc:to:subject:message-id:date :mime-version:references:in-reply-to:from:from:to:cc:subject:date :message-id:reply-to; bh=52qiR+IQ3LlhEx2nN6WZ3SC2MGHIRL2IQyCiw1kXWIY=; b=FEBE8blLHhV0+Q4FOrhW5aSmeo29mpgD9jYJMonJOdIKA6wYQ686tVCuIJN5LfBmru 9Ho8hpyvGIX4gOref08Ovdh7ORko/Ku0hwdhS7p3gv5iruZXu9y0fWqafDIKDeqAVaVf fr3vGwPcDYXKjL5F+l1ogD/dZcyuDsZg/xDQ864xAGZL+GBFOa/u5RVyJUsmagJqA79P KaJB0rRG68s3air0PMuDf4rFBe4QH1ZPQfwGanNwrSyZn1s2Q59pdQTQoGhpHbagwfMo NqmIvIrZh4b9uhteHkKFOgtLKAbYcL+y8kRuZNmObVbDjG/lxhhXtwA5aMpVITV9Rnaz qxbQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725143219; x=1725748019; h=content-transfer-encoding:cc:to:subject:message-id:date :mime-version:references:in-reply-to:from:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=52qiR+IQ3LlhEx2nN6WZ3SC2MGHIRL2IQyCiw1kXWIY=; b=pfNrylOvfdKRWrfHdOLvpbCz2WPlSSNAs8Th4kNErHBkTFTp7mM4O5+FPpOBak5xrx B51mEDeJb0qwmpD9c5XQMR0JLYiHO49rQhSdzfzlVF/ZrGa5egWi91DyhJpX48JtHkZc ch1+wPXjkdcbY/tS260O3GDuTRjfezH4851wb6bfsI3IzCUlMVw0WbJCVhttefpGKDcW jarKIv/CUUCudYxo3vvxzTFS3fP78g6N5VooQAFMBaar0HtcGdaEAVWDB8uklZxh3H7u ps6v87b2JXuDx75ejP4MXTKlpuDUZ5s82Jzwl27SBORD2C1UpqFJ7p1QcFQwCTEuJjXn uh7w== X-Forwarded-Encrypted: i=1; AJvYcCX3QqvUrsdaN+uHAyvFFijd/hBItG/D6YwZvT6e57XvXKKsqnJGiPGM6DlDRKSf7DywmhVDdw==@debbugs.gnu.org X-Gm-Message-State: AOJu0YxPInV4rA3X0/49h38VChC7TjxH9iU6Ncxq1/AY6OQg4+4TDIY4 UXBWT8jJcKgqvv591bOF4xtbig+7MgZmCM3rPBM9g9gsc7RQweqov8MAs56xs6jBp1W8FWhJumS QQpZ5DgwkgTfoGfNI7kU4d5QblPFadsgO X-Google-Smtp-Source: AGHT+IHjAraagrH946+TFZaCSqt+YRbTJN7yCa3eKY8nwn0p3qO6GpAWbP+wISj4zZk1crPC1rZ6AEg+GaELICp0Fdw= X-Received: by 2002:a05:6402:50d0:b0:5c2:4ad9:6d9f with SMTP id 4fb4d7f45d1cf-5c24ad97198mr1586296a12.1.1725143218376; Sat, 31 Aug 2024 15:26:58 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 31 Aug 2024 15:26:58 -0700 In-Reply-To: <79C79924-4870-4E55-9920-3D2C08A1E765@gmail.com> 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:291032 Archived-At: Mattias Engdeg=C3=A5rd writes: > `describe-function` sometimes gives incorrect information about when > certain functions were first introduced. NEWS.unknown can be used to > fix some problems but it only works in one direction and is unable to > help when a function name appears too early. > > A robust solution would be to make NEWS* use a mark-up like > @function{some-name} instead of just 'some-name' but meanwhile, here > is a simple patch that replaces NEWS.unknown with a more structured > file. This fixes the case for `always`. This is a welcome change. For symbols that are in symbol-releases.eld, which means we are actually sure about the addition, shouldn't the help text be changed from Probably introduced at or before Emacs version XX.Y. to something more like Added in Emacs version XX.Y. ? I mean, we should be sure about what we put in that file, presumably. Steve Purcell (in Cc) has been maintaining a relatively complete symbol to version database here: https://github.com/purcell/package-lint/blob/master/data/stdlib-changes Note that his version keeps track of also of `feature`s, and not just additions but removals as well. It would be nice if our version could be extended to do the same. Perhaps Steve has some code or ideas that he would be willing to contribute.