unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Undo limit variables in Emacs Manual
@ 2006-01-29 16:47 Richard M. Stallman
  2006-01-29 18:10 ` Chong Yidong
  2006-01-29 18:18 ` Drew Adams
  0 siblings, 2 replies; 7+ messages in thread
From: Richard M. Stallman @ 2006-01-29 16:47 UTC (permalink / raw)


The variables undo-limit, undo-strong-limit and undo-outer-limit are
in basic.texi because that's where undo is documented, but they are
anything but basic.  I think they are important enough to be mentioned
in the manual.  I'd like to move their documentation to a different
place in the manual, but I am not sure where.

Can anyone suggest a good place?

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Undo limit variables in Emacs Manual
  2006-01-29 16:47 Undo limit variables in Emacs Manual Richard M. Stallman
@ 2006-01-29 18:10 ` Chong Yidong
  2006-01-30 18:45   ` Richard M. Stallman
  2006-01-29 18:18 ` Drew Adams
  1 sibling, 1 reply; 7+ messages in thread
From: Chong Yidong @ 2006-01-29 18:10 UTC (permalink / raw)
  Cc: emacs-devel

"Richard M. Stallman" <rms@gnu.org> writes:

> The variables undo-limit, undo-strong-limit and undo-outer-limit are
> in basic.texi because that's where undo is documented, but they are
> anything but basic.  I think they are important enough to be mentioned
> in the manual.  I'd like to move their documentation to a different
> place in the manual, but I am not sure where.
>
> Can anyone suggest a good place?

One possibility is to make a new subsection of Using Multiple Buffers,
which discusses the maximum size (currently described in Using
Multiple Buffers) and undo limit size of each buffer.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* RE: Undo limit variables in Emacs Manual
  2006-01-29 16:47 Undo limit variables in Emacs Manual Richard M. Stallman
  2006-01-29 18:10 ` Chong Yidong
@ 2006-01-29 18:18 ` Drew Adams
  2006-01-30 18:46   ` Richard M. Stallman
  1 sibling, 1 reply; 7+ messages in thread
From: Drew Adams @ 2006-01-29 18:18 UTC (permalink / raw)


    The variables undo-limit, undo-strong-limit and undo-outer-limit are
    in basic.texi because that's where undo is documented, but they are
    anything but basic.  I think they are important enough to be mentioned
    in the manual.  I'd like to move their documentation to a different
    place in the manual, but I am not sure where.

    Can anyone suggest a good place?

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.

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. In that case, do likewise for all of Basics: treat it as a
Getting Started section in all respects.

In any case, wherever undo is documented completely is where these options
should be documented.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Undo limit variables in Emacs Manual
  2006-01-29 18:10 ` Chong Yidong
@ 2006-01-30 18:45   ` Richard M. Stallman
  0 siblings, 0 replies; 7+ messages in thread
From: Richard M. Stallman @ 2006-01-30 18:45 UTC (permalink / raw)
  Cc: emacs-devel

    One possibility is to make a new subsection of Using Multiple Buffers,
    which discusses the maximum size (currently described in Using
    Multiple Buffers) and undo limit size of each buffer.

Thanks, but that doesn't seem like a very natural place for it.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Undo limit variables in Emacs Manual
  2006-01-29 18:18 ` Drew Adams
@ 2006-01-30 18:46   ` Richard M. Stallman
  2006-01-30 19:30     ` Drew Adams
  0 siblings, 1 reply; 7+ messages in thread
From: Richard M. Stallman @ 2006-01-30 18:46 UTC (permalink / raw)
  Cc: emacs-devel

    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.

    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.

Where should that new Undo section go?

^ permalink raw reply	[flat|nested] 7+ messages in thread

* RE: Undo limit variables in Emacs Manual
  2006-01-30 18:46   ` Richard M. Stallman
@ 2006-01-30 19:30     ` Drew Adams
  2006-01-31 18:03       ` Richard M. Stallman
  0 siblings, 1 reply; 7+ messages in thread
From: Drew Adams @ 2006-01-30 19:30 UTC (permalink / raw)


        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.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Undo limit variables in Emacs Manual
  2006-01-30 19:30     ` Drew Adams
@ 2006-01-31 18:03       ` Richard M. Stallman
  0 siblings, 0 replies; 7+ messages in thread
From: Richard M. Stallman @ 2006-01-31 18:03 UTC (permalink / raw)
  Cc: emacs-devel

    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.

That's because I am not interested in that suggestion.  I see no
reason to take a rigid approach about this.

^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2006-01-31 18:03 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-01-29 16:47 Undo limit variables in Emacs Manual Richard M. Stallman
2006-01-29 18:10 ` Chong Yidong
2006-01-30 18:45   ` Richard M. Stallman
2006-01-29 18:18 ` Drew Adams
2006-01-30 18:46   ` Richard M. Stallman
2006-01-30 19:30     ` Drew Adams
2006-01-31 18:03       ` Richard M. Stallman

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).