[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RE: Undo limit variables in Emacs Manual
From: |
Drew Adams |
Subject: |
RE: Undo limit variables in Emacs Manual |
Date: |
Mon, 30 Jan 2006 11:30:24 -0800 |
I think they're in the right place. Move them to a subnode
of `Undo', perhaps. Options affecting a feature are usually
mentioned
along with the feature.
It's the right place _logically_, but it's wrong because it is complex
details which will be too much for the people reading that chapter to
swallow.
One way to deal with that is to mention that this info can be skipped if...
This is a reasonable approach, if you don't plan to create a Getting Started
section.
Otherwise, if you want Basics to just be a Getting Started
section, then cover just a tiny bit on undo in Basics and have the
complete doc of undo elsewhere.
Perhaps that is the right thing to do.
You passed over the other part of it:
In that case, do likewise for all of Basics: treat it as a
Getting Started section in all respects.
This is non-trivial. An alternative is to add a Getting Started item to the
main menu, but have it just send people to the tutorial. The tutorial no
doubt covers undo. Of course, that doesn't work for the written manual.
Where should that new Undo section go?
It does not fit in any of the existing sections. Create a new section on
Undo (if you don't want it in Basic Editing). It's OK to have a one-node
section (this is the case for Major Modes, for instance) - that just
indicates that 1) it belongs alone and 2) it is important (since it is in
the top-level menu). But that node would cover everything about undo, so
some of its info would be repeated (if also in Basic Editing).
Other things _could_ be grouped with Undo in the same section, but the
grouping choice would be artificial, because undo touches everything except
for persistence (e.g. file saving). That is, almost everything can be
undone, and undoing can be used in editing text, fixing typos, moving point
and mark,....
Suggestion: I would leave things as they are, and just mention that this
stuff is for more advanced use.