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: Please post older versions of GNU Emacs manuals on the web Date: Sat, 2 Jan 2016 09:19:01 -0800 (PST) Message-ID: <77dedbec-9cd8-4fca-87d4-219ceb4c9d41@default> References: <1e249214-6831-4c2b-98a4-d16a6d1d7048@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1451755190 24059 80.91.229.3 (2 Jan 2016 17:19:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 2 Jan 2016 17:19:50 +0000 (UTC) Cc: emacs-devel@gnu.org To: John Wiegley Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 02 18:19:37 2016 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 1aFPq1-0006nm-IW for ged-emacs-devel@m.gmane.org; Sat, 02 Jan 2016 18:19:33 +0100 Original-Received: from localhost ([::1]:39103 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFPq0-00034T-I6 for ged-emacs-devel@m.gmane.org; Sat, 02 Jan 2016 12:19:32 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33435) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFPpj-00034A-C5 for emacs-devel@gnu.org; Sat, 02 Jan 2016 12:19:16 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aFPpe-0001yP-CH for emacs-devel@gnu.org; Sat, 02 Jan 2016 12:19:15 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:30549) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFPpe-0001yL-4u for emacs-devel@gnu.org; Sat, 02 Jan 2016 12:19:10 -0500 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u02HJ5bZ029731 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 2 Jan 2016 17:19:05 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u02HJ4eI001502 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 2 Jan 2016 17:19:04 GMT Original-Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u02HJ2RL020288; Sat, 2 Jan 2016 17:19:02 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: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 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:197376 Archived-At: > > If you have a version of GNU Emacs older than 24.4 then you are lucky t= o > > still have `defadvice' documented in the Elisp manual. >=20 > Maybe we should have a "deprecated features" manual, where text gets move= d > after it is removed from the Elisp manual? Even though 25.1 may not use > defadvice, it still allows such code to be written, which means you'll > probably run across such code in the future and would like to read > documentation on how it works. >=20 > I can understand taking it out of the manual, but it would be nice to hav= e > another manual for "features you may well run into in the wild, though yo= u > shouldn't write new code this way". I'm not proposing maintaining such a > manual actively, but just copying deprecated sections like the "defadvice= " > content directly into it instead of deletion. I'm not against our doing what you suggest (as I say, IMO the `defadvice' doc should never have been removed from the manual, at least as long as it is still supported (while deprecated)). But what I propose is different. And unlike what you suggest it should require no extra effort, beyond the one-time effort of building the HTML doc, which should not be a big deal. My proposal is for GNU Emacs to post the complete Emacs and Elisp manuals for older versions. We could even add a command similar to what I posted here, which takes the current release into account when determining the URL.