Emacs Manual Node Persistency Issues

By Xah Lee. Date: . Last updated: .

This page is a short note about emacs manual's node's persistence across manual versions.

2 issues are noted here:

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:

However, since emacs does ① already, it's easy to do ② 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

  1. Simple Changes Emacs Should Adopt
  2. Why Emacs Keys are Painful
  3. Problems of the Scratch Buffer
  4. M-key Notation vs Alt+key Notation
  5. Menu Problem
  6. Mode Line Problem
  7. cua-mode Problems
  8. kill-buffer Induces Buffer Accumulation
  9. Emacs Form Feed ^L
  10. Inconsistency of Search Features
  11. Single Key to Delete Whole Line
  12. Emacs HTML Mode Sucks
  13. Emacs Does Not Support Viewing Images Files In Windows
  14. Emacs Spell Checker Problems
  15. Adopt HTML as Texinfo Replacement
  16. Support HTML Mail
  17. Problems of “man” Command
  18. Emacs Lisp Mode Syntax Coloring Problem
  19. Emacs Ahk Mode Problems
  20. Problems of Emacs's Manual
  21. Problems of Emacs's Manual; Examples
  22. Emacs: Have You Read Emacs Manual?
  23. Elisp: Ban Syntax Table
  24. Emacs: Make elisp-index-search use Current Symbol
  25. Emacs: Usability Problems of Mode Documentation
  26. Problems of Emacswiki
  27. Emacs GNU Texinfo Problems; Invalid HTML
  28. A Record of Frustration in IT Industry; Disappearing FSF URLs, 2006
  29. Emacs Manual Node Persistency Issues
  30. Emacs: dired-do-query-replace-regex Replace ALL (fixed)
  31. Problems of Emacs Supporting Obsolete Systems
  32. Elisp: Function to Copy/Delete a Dir Recursively (fixed)
  33. Thoughts on Common Lisp Scheme Lisp Based Emacs
  34. Text Editors Popularity and Market Research
  35. Text Editor's Cursor Movement Behavior (emacs, vi, Notepad++)
  36. GNU Emacs Development Inefficiency
  37. Emacs Dev Inefficiency and Emacs Web 2.0?
  38. Letter-Case Commands Usability Problems
  39. Emacs: Select Line, between Quotes, Extend Selection
  40. Emacs: isearch Current Word
  41. Suggestions on Line Wrap Commands
  42. Emacs: Single Key to Delete Whole Line
  43. Emacs Cult Problem: Emacs vs Windows Notepad
  44. Emacs Undo and Emacs Cult Problem

If you have a question, put $5 at patreon and message me.
Or Buy Xah Emacs Tutorial
Or buy a nice keyboard: Best Keyboards for Emacs

Emacs

Emacs Lisp

Misc