Emacs Manual Node Persistency Issues
This page is a short note about emacs manual's node's persistence across manual versions.
2 issues are noted here:
- (1) Emacs Lisp function
Info-copy-current-node-name
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 โbad linkโ references in existing literature.
info-copy-current-node-name
In emacs 22, when in info inside emacs, if i press c (Info-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
<span class="ref">(info "(emacs)dired")</span>
Note: This is a trivial issue. My command can be trivially fixed. This change did not break backward compatibility with emacs 22. I've tested, that in emacs 22, the function info
works correctly regardless if there's this extra space in the argument.
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 exist in emacs 23's manual.
Shouldn't the manual nodes be persistent across versions, for example, providing redirect when node changed?
As a practical 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.
Just noticed, there was a manual page
(info "(emacs) Mac Input")
, but it seems gone in emacs manual for GNU Emacs version 23.2.
The page discuss variables like mac-option-modifier, mac-command-modifier, mac-control-modifier.
Emacs Modernization
- Emacs Modernization: Simple Changes Emacs Should Adopt
- Why Emacs Keys are Painful
- Emacs: Problems of the Scratch Buffer
- Emacs M-key Notation vs Alt+key Notation
- Emacs Menu Usability Problem
- Emacs Mode Line Problem
- Emacs cua-mode Problems
- Emacs: Inconsistency of Search Features
- Problems of grep in Emacs
- Emacs: Usability Problems of Mode Documentation
- Problems of Emacs Manual
- Emacs Manual Sucks by Examples
- Emacs: kill-buffer Induces Buffer Accumulation
- Emacs Spell Checker Problems
- Emacs Form Feed ^L Problems
- Emacs: Single Key to Delete Whole Line
- Emacs HTML Mode Sucks
- Emacs Does Not Support Viewing Images Files In Windows
- Emacs Should Adopt HTML as Texinfo Replacement
- Emacs Should Support HTML Mail
- Problems of Emacs's โmanโ Command
- Emacs Lisp Mode Syntax Coloring Problem
- Emacs AutoHotkey Mode Problems
- Emacs Lisp: Ban Syntax Table
- Emacs: Make elisp-index-search use Current Symbol
- Emacs GNU Texinfo Problems; Invalid HTML
- A Record of Frustration in IT Industry; Disappearing FSF URLs, 2006
- Emacs Manual Node Persistency Issues
- Emacs: dired-do-query-replace-regex Replace ALL (fixed)
- Problems of Emacs Supporting Obsolete Systems
- Emacs Lisp: Function to Copy/Delete a Dir Recursively (fixed)
- Thoughts on Common Lisp Scheme Lisp Based Emacs
- Text Editors Popularity and Market Research
- Text Editor's Cursor Movement Behavior (emacs, vi, Notepad++)
- Emacs: Toggle Letter Case ๐
- Emacs: Select Line, between Quotes, Extend Selection ๐
- Emacs: isearch Current Word ๐
- Emacs fill-paragraph Problem