Mercurial > emacs
comparison lispref/text.texi @ 11555:4cc0a5e1bdac
Explan when boundaries are made automatically.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Tue, 25 Apr 1995 05:29:11 +0000 |
parents | 981b97215c46 |
children | 73dc8205d259 |
comparison
equal
deleted
inserted
replaced
11554:ac21a7106ffd | 11555:4cc0a5e1bdac |
---|---|
963 @defun undo-boundary | 963 @defun undo-boundary |
964 This function places a boundary element in the undo list. The undo | 964 This function places a boundary element in the undo list. The undo |
965 command stops at such a boundary, and successive undo commands undo | 965 command stops at such a boundary, and successive undo commands undo |
966 to earlier and earlier boundaries. This function returns @code{nil}. | 966 to earlier and earlier boundaries. This function returns @code{nil}. |
967 | 967 |
968 The editor command loop automatically creates an undo boundary between | 968 The editor command loop automatically creates an undo boundary before |
969 keystroke commands. Thus, each undo normally undoes the effects of one | 969 each key sequence is executed. Thus, each undo normally undoes the |
970 command. Calling this function explicitly is useful for splitting the | 970 effects of one command. Self-inserting input characters are an |
971 effects of a command into more than one unit. For example, | 971 exception. The command loop makes a boundary for the first such |
972 @code{query-replace} calls this function after each replacement so that | 972 character; the next 19 consecutive self-inserting input characters do |
973 the user can undo individual replacements one by one. | 973 not make boundaries, and then the 20th does, and so on as long as |
974 self-inserting characters continue. | |
975 | |
976 All buffer modifications add a boundary whenever the previous undoable | |
977 change was made in some other buffer. This way, a command that modifies | |
978 several buffers makes a boundary in each buffer it changes. | |
979 | |
980 Calling this function explicitly is useful for splitting the effects of | |
981 a command into more than one unit. For example, @code{query-replace} | |
982 calls @code{undo-boundary} after each replacement, so that the user can | |
983 undo individual replacements one by one. | |
974 @end defun | 984 @end defun |
975 | 985 |
976 @defun primitive-undo count list | 986 @defun primitive-undo count list |
977 This is the basic function for undoing elements of an undo list. | 987 This is the basic function for undoing elements of an undo list. |
978 It undoes the first @var{count} elements of @var{list}, returning | 988 It undoes the first @var{count} elements of @var{list}, returning |