From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords' Date: Fri, 2 Jan 2015 23:59:54 -0800 (PST) Message-ID: <10e946e2-cda1-49be-9cb2-d6575f415d14@default> References: 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 1420272081 18569 80.91.229.3 (3 Jan 2015 08:01:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 3 Jan 2015 08:01:21 +0000 (UTC) Cc: 19483-done@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jan 03 09:01:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1Y7Je3-0003zj-NH for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Jan 2015 09:01:11 +0100 Original-Received: from localhost ([::1]:53688 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7Je2-00019d-UF for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Jan 2015 03:01:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41508) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7Jdz-00018h-AX for bug-gnu-emacs@gnu.org; Sat, 03 Jan 2015 03:01:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y7Jdu-00056m-BO for bug-gnu-emacs@gnu.org; Sat, 03 Jan 2015 03:01:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54240) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7Jdu-00056i-8q for bug-gnu-emacs@gnu.org; Sat, 03 Jan 2015 03:01:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Y7Jdt-0002Bd-P9 for bug-gnu-emacs@gnu.org; Sat, 03 Jan 2015 03:01:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 03 Jan 2015 08:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19483 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 19483-done@debbugs.gnu.org id=D19483.14202720058273 (code D ref 19483); Sat, 03 Jan 2015 08:01:01 +0000 Original-Received: (at 19483-done) by debbugs.gnu.org; 3 Jan 2015 08:00:05 +0000 Original-Received: from localhost ([127.0.0.1]:35373 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Y7Jcy-00029M-5T for submit@debbugs.gnu.org; Sat, 03 Jan 2015 03:00:04 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:21130) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Y7Jct-00028L-Ft for 19483-done@debbugs.gnu.org; Sat, 03 Jan 2015 03:00:00 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t037xtbL028608 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 3 Jan 2015 07:59:58 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t037xskY006133 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 3 Jan 2015 07:59:54 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t037xrcE003618; Sat, 3 Jan 2015 07:59:54 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:97955 Archived-At: > tags 19483 notabug > thanks >=20 > > `C-h v font-lock-syntactic-keywords' says that the variable is > > obsolete since 24.1. >=20 > That's right. >=20 > > But in font-lock.el, the code, multiple doc strings, and > > the Commentary all rely on it. >=20 > No, they just keep supporting it, because it's only "obsolete" and > not "removed". The doc and Commentary should reflect the fact that it has been declared "obsolete". That's the point. > Do you really want to advocate we remove features right away when we > decide they're obsolete? Strawman, again. No one suggested that you remove any feature. Read the bug report. It's about the doc (including Commentary).=20 When you deprecate something, the doc for it should state that it is deprecated. Everywhere. That the doc was not brought up to date about this as soon as the status changed to deprecated was a doc bug 4 releases ago. The bug is still there. Emacs is the self-documenting editor. It should tell users about itself accurately.