From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Tim Cross" Newsgroups: gmane.emacs.bugs Subject: bug#6521: 23.2; Elisp Manual Ommission Date: Sat, 21 Aug 2010 08:36:50 +1000 Message-ID: <19567.898.422804.121281@puma.rapttech.com.au> References: <87iq5497b7.fsf@lion.rapttech.com.au> <20100701.173933.520277347.tcross@rapttech.com.au> Reply-To: theophilusx@gmail.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1282345863 22184 80.91.229.12 (20 Aug 2010 23:11:03 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 20 Aug 2010 23:11:03 +0000 (UTC) Cc: tcross@rapttech.com.au, 6521@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 21 01:11:01 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OmaiA-0002cZ-0W for geb-bug-gnu-emacs@m.gmane.org; Sat, 21 Aug 2010 01:11:00 +0200 Original-Received: from localhost ([127.0.0.1]:38135 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Omai2-0001wg-GA for geb-bug-gnu-emacs@m.gmane.org; Fri, 20 Aug 2010 19:09:14 -0400 Original-Received: from [140.186.70.92] (port=59766 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Omahv-0001vq-SY for bug-gnu-emacs@gnu.org; Fri, 20 Aug 2010 19:09:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Omaht-0006Ir-5c for bug-gnu-emacs@gnu.org; Fri, 20 Aug 2010 19:09:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50000) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Omaht-0006Il-3t for bug-gnu-emacs@gnu.org; Fri, 20 Aug 2010 19:09:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OmaFn-0007Nq-HT; Fri, 20 Aug 2010 18:40:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Tim Cross" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 20 Aug 2010 22:40:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6521 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6521-submit@debbugs.gnu.org id=B6521.128234396528366 (code B ref 6521); Fri, 20 Aug 2010 22:40:03 +0000 Original-Received: (at 6521) by debbugs.gnu.org; 20 Aug 2010 22:39:25 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OmaFA-0007NT-JE for submit@debbugs.gnu.org; Fri, 20 Aug 2010 18:39:25 -0400 Original-Received: from ipmail05.adl6.internode.on.net ([150.101.137.143]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OmaBg-0007KS-0o for 6521@debbugs.gnu.org; Fri, 20 Aug 2010 18:35:49 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AvsEAE+ebkx5LN3n/2dsb2JhbACgOXKpVwqIJS6IWYU3BIRnhQyHVQ Original-Received: from ppp121-44-221-231.lns20.syd7.internode.on.net (HELO puma.rapttech.com.au) ([121.44.221.231]) by ipmail05.adl6.internode.on.net with ESMTP; 21 Aug 2010 08:06:55 +0930 In-Reply-To: X-Mailer: VM 8.1.92a under 24.0.50.1 (x86_64-unknown-linux-gnu) X-Mailman-Approved-At: Fri, 20 Aug 2010 18:39:23 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 20 Aug 2010 18:40:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:39680 Archived-At: Stefan Monnier writes: > [ Can't remember responding yet. ] > >> Could you send it along, so we could see what it looks like (to > >> better assess whether it means we have a serious problem, or if > >> it's just bad luck). > > The code which failed to compile was BBDB as bundled with Debian > > testing. Do you want me to send the error message that was > > generated? (note that the code still compiles with emacs23). > > AFAIK, this problem has been fixed a little while back. Yes, the problem with compilation seems to have been fixed. However, there is still a problem. Now it is a documentation issue rather than a compilation one. The manual no longer has a section about the deprecated use of the old style backquote. The warning message generated by the byte compiler still refers the user to the backquote section of the elisp manual for more information, but there is no reference to old style backquotes in that section. This makes it very difficult for anyone who is not familiar with the change in style to understand what use to be different and what needs to be changed in the code to get rid of the warning. Given that this change in style happened many years ago, there is likely a number of users who are unfamiliar with what the old style was and they would probably benefit from some explanation/guidance. I recommend that either a footnote be added to the backquote section of the elisp reference manual or a new section be added about the old style backquotes and what needs to be changed to make it compliant with modern usage. The compiler warning message should probably also be updated to either direct users to the footnote or new section. regards, Tim -- Tim Cross tcross@rapttech.com.au There are two types of people in IT - those who do not manage what they understand and those who do not understand what they manage. -- Tim Cross tcross@rapttech.com.au There are two types of people in IT - those who do not manage what they understand and those who do not understand what they manage.