From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xah Lee Newsgroups: gmane.emacs.help Subject: =?windows-1252?q?Re=3A_changes_on_=93info=94_function_in_emacs_2?= =?windows-1252?q?3?= Date: Sat, 8 Aug 2009 16:47:59 -0700 (PDT) Organization: http://groups.google.com Message-ID: References: <80e8da53-ef71-47fc-b7b5-73d817414605@d4g2000prc.googlegroups.com> <85fc0b81-d7cc-4a6d-94d2-a5a2b76ae6d1@x6g2000prc.googlegroups.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1249803962 12376 80.91.229.12 (9 Aug 2009 07:46:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Aug 2009 07:46:02 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun Aug 09 09:45:55 2009 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Ma36J-0001Nk-6O for geh-help-gnu-emacs@m.gmane.org; Sun, 09 Aug 2009 09:45:55 +0200 Original-Received: from localhost ([127.0.0.1]:59039 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ma36I-00033B-Mm for geh-help-gnu-emacs@m.gmane.org; Sun, 09 Aug 2009 03:45:54 -0400 Original-Path: news.stanford.edu!newsfeed.stanford.edu!postnews.google.com!l35g2000pra.googlegroups.com!not-for-mail Original-Newsgroups: gnu.emacs.help,comp.emacs Original-Lines: 92 Original-NNTP-Posting-Host: 76.102.12.87 Original-X-Trace: posting.google.com 1249775280 6460 127.0.0.1 (8 Aug 2009 23:48:00 GMT) Original-X-Complaints-To: groups-abuse@google.com Original-NNTP-Posting-Date: Sat, 8 Aug 2009 23:48:00 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: l35g2000pra.googlegroups.com; posting-host=76.102.12.87; posting-account=bRPKjQoAAACxZsR8_VPXCX27T2YcsyMA User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 6.0; en-US) AppleWebKit/530.5 (KHTML, like Gecko) Chrome/2.0.172.39 Safari/530.5, gzip(gfe), gzip(gfe) Original-Xref: news.stanford.edu gnu.emacs.help:171820 comp.emacs:98557 X-Mailman-Approved-At: Sun, 09 Aug 2009 03:45:30 -0400 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:67002 Archived-At: wrote a clean summary on this issue: =E2=80=A2 Emacs Manual Node Persistency Issues http://xahlee.org/emacs/emacs_manual_persistent_nodes.html plain text version follows: -------------------------------------------------- Emacs Manual Node Persistency Issues Xah Lee, 2009-08-08 This page is a short note about emacs manual's node's persistency across manual versions. 2 issues are noted here: * (1) Emacs Lisp function =E2=80=9Cinfo-copy-Current-node-name=E2=80=9D= changed its output slightly, between emacs 22 and emacs 23. * (2) Emacs manual node entries are not persistent across manual versions, this creates a problem of =E2=80=9Cbad link=E2=80=9D references i= n existing literature. -------------------- info-copy-current-node-name In emacs 22, when in info inside emacs, if i press =E2=80=9Cc=E2=80=9D (inf= o-copy- current-node-name), i get the node name in my kill ring (aka clip board), for example: (elisp)System Environment But in emacs 23, i get: (elisp) System Environment This change is not documented in the emacs 23 release notes (aka NEWS file). This change actually broke one of my personal elisp command. My command turns a line of the form: (emacs)dired into (info "(emacs)dired") Note: This is a trivial issue. My command can be trivially fixed. This section only record a elisp command's undocumented behavior change that actually broke a user's code (me). Note: however, this change did not break backward compatibility with emacs 22. I've tested, that in emacs 22, both with or without the extra space works. -------------------- Info Node Persistency A more important issue i just discovered is that some info node in emacs 22 are gone in emacs 23. In emacs 22, there's this node: (info "(emacs)Transient Mark") but it does not exit in emacs 23's manual. Shouldn't the manual nodes be persistant across versions, e.g. providing redirect when node changed? As a pratical matter, this means now i have to search my emacs publications to fix the nodes. A task that's not particularly trivial. This applies to any publication on emacs that reference to the manual by node. This is a problem with Python's documentation too. thinking about this, actually i don't know if there are any manual that: * (1) Provide a computable reference to the chapter/sections. * (2) Maintain this on different versions of the manual. However, since emacs does (1) already, it's easy to do (2) too. Xah =E2=88=91 http://xahlee.org/ =E2=98=84