From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Stefan Monnier <monnier@iro.umontreal.ca>
Newsgroups: gmane.emacs.devel
Subject: Re: Obtaining a database of new functionality per Emacs version
Date: Mon, 07 Dec 2020 10:19:48 -0500
Message-ID: <jwvv9dd8x6r.fsf-monnier+emacs@gnu.org>
References: <X84ewTWkQRrdHJhK@odonien.localdomain>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="14974"; mail-complaints-to="usenet@ciao.gmane.io"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)
To: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Dec 07 16:23:04 2020
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
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 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1kmILv-0003mg-NS
	for ged-emacs-devel@m.gmane-mx.org; Mon, 07 Dec 2020 16:23:03 +0100
Original-Received: from localhost ([::1]:33268 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1kmILu-00059l-Ot
	for ged-emacs-devel@m.gmane-mx.org; Mon, 07 Dec 2020 10:23:02 -0500
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38546)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <monnier@iro.umontreal.ca>)
 id 1kmIIv-0003G4-TW
 for emacs-devel@gnu.org; Mon, 07 Dec 2020 10:20:02 -0500
Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:56858)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <monnier@iro.umontreal.ca>)
 id 1kmIIq-0002AN-0h
 for emacs-devel@gnu.org; Mon, 07 Dec 2020 10:19:57 -0500
Original-Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1])
 by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 7EF9980F25;
 Mon,  7 Dec 2020 10:19:50 -0500 (EST)
Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
 by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 3A96480922;
 Mon,  7 Dec 2020 10:19:49 -0500 (EST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
 s=mail; t=1607354389;
 bh=d68CXxSucINnMp3iW6LoxoCNDSEYCWGjRl9LQ+8S7+c=;
 h=From:To:Subject:References:Date:In-Reply-To:From;
 b=ase7WILzuZvgyF9ltOFXCvpJP7C+M5UzPu6pgW0+WqstQHieQJyWdT9JufZEAKa8J
 05YnqGanE6WpkV7Nc23PFgjLTGf6qJP0B4Qk0IMOL18wdh9JO2F11bl3EPo+fQzcBR
 HUhGmjaqHxtxC7rbE3PShbclFNNss47PwOUDZE2jk5O5QI/dSm6V0Cv3Fsr5iDb4jb
 INlZGEJgKnGFVcEADus0eMWgEFUUC4F1VbTHecjDtmSpKYzLgJz8CvNrMJRilAGMyV
 axficBXh3ualuuL63pt83LyYWVH20fuX8ErGCj7cQfr+dH9UcFMU+TePjmMyTkf5i0
 Lgf2i/DotVeZw==
Original-Received: from alfajor (69-165-136-52.dsl.teksavvy.com [69.165.136.52])
 by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id AC073120370;
 Mon,  7 Dec 2020 10:19:48 -0500 (EST)
In-Reply-To: <X84ewTWkQRrdHJhK@odonien.localdomain> (Vasilij Schneidermann's
 message of "Mon, 7 Dec 2020 13:23:29 +0100")
Received-SPF: pass client-ip=132.204.25.50;
 envelope-from=monnier@iro.umontreal.ca; helo=mailscanner.iro.umontreal.ca
X-Spam_score_int: -42
X-Spam_score: -4.3
X-Spam_bar: ----
X-Spam_report: (-4.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_MED=-2.3,
 SPF_HELO_NONE=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.23
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org
Original-Sender: "Emacs-devel"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:260482
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/260482>

> - Relying on metadata from custom.el: Works on customizables only.
> - Combing through NEWS files: Not machine-readable, tedious, prone to
>   mistakes (not all new functionality is marked as such, for example
>   there's renames like `with-connection-local-profiles` to
>   `with-connection-local-variables`).

The version info displayed in `C-h o` comes from the NEWS files.
It's indeed approximate but I've found it surprisingly usable so far.
For such uses (i.e. for human consumption), I've found the main problem
to be that it doesn't understand that vars&functions come from packages,
so when a new package gets added in Emacs-NN.MM it doesn't tell me that
the corresponding functions and vars appeared in that version :-(

Whichever solution you end up, I hope it can be used for `C-h o`
as well.


        Stefan