From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: How to properly document that a feature is new Date: Mon, 11 May 2015 11:12:29 -0700 (PDT) Message-ID: <9bb242ca-8559-40da-868c-5ea4c78948c8@default> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1431367971 27805 80.91.229.3 (11 May 2015 18:12:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 11 May 2015 18:12:51 +0000 (UTC) To: bruce.connor.am@gmail.com, emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 11 20:12:38 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1YrsBy-0003SH-Gx for ged-emacs-devel@m.gmane.org; Mon, 11 May 2015 20:12:38 +0200 Original-Received: from localhost ([::1]:39053 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrsBx-00070O-Lu for ged-emacs-devel@m.gmane.org; Mon, 11 May 2015 14:12:37 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58862) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrsBv-00070I-4a for emacs-devel@gnu.org; Mon, 11 May 2015 14:12:36 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrsBs-0006dA-3F for emacs-devel@gnu.org; Mon, 11 May 2015 14:12:35 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:34977) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrsBr-0006bU-Sn for emacs-devel@gnu.org; Mon, 11 May 2015 14:12:32 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t4BICUkN007417 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 11 May 2015 18:12:30 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t4BICUxW006884 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 11 May 2015 18:12:30 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t4BICUgZ023075; Mon, 11 May 2015 18:12:30 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 141.146.126.69 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:186426 Archived-At: > My question is: where do I specifically document the fact that this > is new to 25.1? Docstring, manual, both, or neither? NEWS (only). (Well, AntiNEWS too, if that still exists.) NEWS is the Emacs equivalent of Release Notes. In general, only NEWS covers release-specific stuff. The current doc should describe the current release of Emacs. It can mention that XYZ started with version N.M of Emacs, if that is really needed for some reason (e.g. security), but that should be the case rarely, if at all. (My opinion, not necessarily official policy.)