1 /* undo handling for GNU Emacs.
2 Copyright (C) 1990, 1993-1994, 2000-2015 Free Software Foundation,
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
24 #include "character.h"
29 /* Last buffer for which undo information was recorded. */
30 /* BEWARE: This is not traced by the GC, so never dereference it! */
31 static struct buffer
*last_undo_buffer
;
33 /* Position of point last time we inserted a boundary. */
34 static struct buffer
*last_boundary_buffer
;
35 static ptrdiff_t last_boundary_position
;
37 /* The first time a command records something for undo.
38 it also allocates the undo-boundary object
39 which will be added to the list at the end of the command.
40 This ensures we can't run out of space while trying to make
42 static Lisp_Object pending_boundary
;
44 /* Record point as it was at beginning of this command (if necessary)
45 and prepare the undo info for recording a change.
46 PT is the position of point that will naturally occur as a result of the
47 undo record that will be added just after this command terminates. */
50 record_point (ptrdiff_t pt
)
54 /* Don't record position of pt when undo_inhibit_record_point holds. */
55 if (undo_inhibit_record_point
)
58 /* Allocate a cons cell to be the undo boundary after this command. */
59 if (NILP (pending_boundary
))
60 pending_boundary
= Fcons (Qnil
, Qnil
);
62 if ((current_buffer
!= last_undo_buffer
)
63 /* Don't call Fundo_boundary for the first change. Otherwise we
64 risk overwriting last_boundary_position in Fundo_boundary with
65 PT of the current buffer and as a consequence not insert an
66 undo boundary because last_boundary_position will equal pt in
67 the test at the end of the present function (Bug#731). */
68 && (MODIFF
> SAVE_MODIFF
))
70 last_undo_buffer
= current_buffer
;
72 at_boundary
= ! CONSP (BVAR (current_buffer
, undo_list
))
73 || NILP (XCAR (BVAR (current_buffer
, undo_list
)));
75 if (MODIFF
<= SAVE_MODIFF
)
76 record_first_change ();
78 /* If we are just after an undo boundary, and
79 point wasn't at start of deleted range, record where it was. */
81 && current_buffer
== last_boundary_buffer
82 && last_boundary_position
!= pt
)
83 bset_undo_list (current_buffer
,
84 Fcons (make_number (last_boundary_position
),
85 BVAR (current_buffer
, undo_list
)));
88 /* Record an insertion that just happened or is about to happen,
89 for LENGTH characters at position BEG.
90 (It is possible to record an insertion before or after the fact
91 because we don't need to record the contents.) */
94 record_insert (ptrdiff_t beg
, ptrdiff_t length
)
96 Lisp_Object lbeg
, lend
;
98 if (EQ (BVAR (current_buffer
, undo_list
), Qt
))
103 /* If this is following another insertion and consecutive with it
104 in the buffer, combine the two. */
105 if (CONSP (BVAR (current_buffer
, undo_list
)))
108 elt
= XCAR (BVAR (current_buffer
, undo_list
));
110 && INTEGERP (XCAR (elt
))
111 && INTEGERP (XCDR (elt
))
112 && XINT (XCDR (elt
)) == beg
)
114 XSETCDR (elt
, make_number (beg
+ length
));
119 XSETFASTINT (lbeg
, beg
);
120 XSETINT (lend
, beg
+ length
);
121 bset_undo_list (current_buffer
,
122 Fcons (Fcons (lbeg
, lend
), BVAR (current_buffer
, undo_list
)));
125 /* Record the fact that markers in the region of FROM, TO are about to
126 be adjusted. This is done only when a marker points within text
127 being deleted, because that's the only case where an automatic
128 marker adjustment won't be inverted automatically by undoing the
129 buffer modification. */
132 record_marker_adjustments (ptrdiff_t from
, ptrdiff_t to
)
135 register struct Lisp_Marker
*m
;
136 register ptrdiff_t charpos
, adjustment
;
138 /* Allocate a cons cell to be the undo boundary after this command. */
139 if (NILP (pending_boundary
))
140 pending_boundary
= Fcons (Qnil
, Qnil
);
142 if (current_buffer
!= last_undo_buffer
)
144 last_undo_buffer
= current_buffer
;
146 for (m
= BUF_MARKERS (current_buffer
); m
; m
= m
->next
)
148 charpos
= m
->charpos
;
149 eassert (charpos
<= Z
);
151 if (from
<= charpos
&& charpos
<= to
)
153 /* insertion_type nil markers will end up at the beginning of
154 the re-inserted text after undoing a deletion, and must be
155 adjusted to move them to the correct place.
157 insertion_type t markers will automatically move forward
158 upon re-inserting the deleted text, so we have to arrange
159 for them to move backward to the correct position. */
160 adjustment
= (m
->insertion_type
? to
: from
) - charpos
;
164 XSETMISC (marker
, m
);
167 Fcons (Fcons (marker
, make_number (adjustment
)),
168 BVAR (current_buffer
, undo_list
)));
174 /* Record that a deletion is about to take place, of the characters in
175 STRING, at location BEG. Optionally record adjustments for markers
176 in the region STRING occupies in the current buffer. */
179 record_delete (ptrdiff_t beg
, Lisp_Object string
, bool record_markers
)
183 if (EQ (BVAR (current_buffer
, undo_list
), Qt
))
186 if (PT
== beg
+ SCHARS (string
))
188 XSETINT (sbeg
, -beg
);
193 XSETFASTINT (sbeg
, beg
);
197 /* primitive-undo assumes marker adjustments are recorded
198 immediately before the deletion is recorded. See bug 16818
201 record_marker_adjustments (beg
, beg
+ SCHARS (string
));
205 Fcons (Fcons (string
, sbeg
), BVAR (current_buffer
, undo_list
)));
208 /* Record that a replacement is about to take place,
209 for LENGTH characters at location BEG.
210 The replacement must not change the number of characters. */
213 record_change (ptrdiff_t beg
, ptrdiff_t length
)
215 record_delete (beg
, make_buffer_string (beg
, beg
+ length
, true), false);
216 record_insert (beg
, length
);
219 /* Record that an unmodified buffer is about to be changed.
220 Record the file modification date so that when undoing this entry
221 we can tell whether it is obsolete because the file was saved again. */
224 record_first_change (void)
226 struct buffer
*base_buffer
= current_buffer
;
228 if (EQ (BVAR (current_buffer
, undo_list
), Qt
))
231 if (current_buffer
!= last_undo_buffer
)
233 last_undo_buffer
= current_buffer
;
235 if (base_buffer
->base_buffer
)
236 base_buffer
= base_buffer
->base_buffer
;
238 bset_undo_list (current_buffer
,
239 Fcons (Fcons (Qt
, Fvisited_file_modtime ()),
240 BVAR (current_buffer
, undo_list
)));
243 /* Record a change in property PROP (whose old value was VAL)
244 for LENGTH characters starting at position BEG in BUFFER. */
247 record_property_change (ptrdiff_t beg
, ptrdiff_t length
,
248 Lisp_Object prop
, Lisp_Object value
,
251 Lisp_Object lbeg
, lend
, entry
;
252 struct buffer
*obuf
= current_buffer
, *buf
= XBUFFER (buffer
);
253 bool boundary
= false;
255 if (EQ (BVAR (buf
, undo_list
), Qt
))
258 /* Allocate a cons cell to be the undo boundary after this command. */
259 if (NILP (pending_boundary
))
260 pending_boundary
= Fcons (Qnil
, Qnil
);
262 if (buf
!= last_undo_buffer
)
264 last_undo_buffer
= buf
;
266 /* Switch temporarily to the buffer that was changed. */
267 current_buffer
= buf
;
272 if (MODIFF
<= SAVE_MODIFF
)
273 record_first_change ();
276 XSETINT (lend
, beg
+ length
);
277 entry
= Fcons (Qnil
, Fcons (prop
, Fcons (value
, Fcons (lbeg
, lend
))));
278 bset_undo_list (current_buffer
,
279 Fcons (entry
, BVAR (current_buffer
, undo_list
)));
281 current_buffer
= obuf
;
284 DEFUN ("undo-boundary", Fundo_boundary
, Sundo_boundary
, 0, 0, 0,
285 doc
: /* Mark a boundary between units of undo.
286 An undo command will stop at this point,
287 but another undo command will undo to the previous boundary. */)
291 if (EQ (BVAR (current_buffer
, undo_list
), Qt
))
293 tem
= Fcar (BVAR (current_buffer
, undo_list
));
296 /* One way or another, cons nil onto the front of the undo list. */
297 if (!NILP (pending_boundary
))
299 /* If we have preallocated the cons cell to use here,
301 XSETCDR (pending_boundary
, BVAR (current_buffer
, undo_list
));
302 bset_undo_list (current_buffer
, pending_boundary
);
303 pending_boundary
= Qnil
;
306 bset_undo_list (current_buffer
,
307 Fcons (Qnil
, BVAR (current_buffer
, undo_list
)));
309 last_boundary_position
= PT
;
310 last_boundary_buffer
= current_buffer
;
314 /* At garbage collection time, make an undo list shorter at the end,
315 returning the truncated list. How this is done depends on the
316 variables undo-limit, undo-strong-limit and undo-outer-limit.
317 In some cases this works by calling undo-outer-limit-function. */
320 truncate_undo_list (struct buffer
*b
)
323 Lisp_Object prev
, next
, last_boundary
;
324 EMACS_INT size_so_far
= 0;
326 /* Make sure that calling undo-outer-limit-function
327 won't cause another GC. */
328 ptrdiff_t count
= inhibit_garbage_collection ();
330 /* Make the buffer current to get its local values of variables such
331 as undo_limit. Also so that Vundo_outer_limit_function can
332 tell which buffer to operate on. */
333 record_unwind_current_buffer ();
334 set_buffer_internal (b
);
336 list
= BVAR (b
, undo_list
);
340 last_boundary
= Qnil
;
342 /* If the first element is an undo boundary, skip past it. */
343 if (CONSP (next
) && NILP (XCAR (next
)))
345 /* Add in the space occupied by this element and its chain link. */
346 size_so_far
+= sizeof (struct Lisp_Cons
);
348 /* Advance to next element. */
353 /* Always preserve at least the most recent undo record
354 unless it is really horribly big.
356 Skip, skip, skip the undo, skip, skip, skip the undo,
357 Skip, skip, skip the undo, skip to the undo bound'ry. */
359 while (CONSP (next
) && ! NILP (XCAR (next
)))
364 /* Add in the space occupied by this element and its chain link. */
365 size_so_far
+= sizeof (struct Lisp_Cons
);
368 size_so_far
+= sizeof (struct Lisp_Cons
);
369 if (STRINGP (XCAR (elt
)))
370 size_so_far
+= (sizeof (struct Lisp_String
) - 1
371 + SCHARS (XCAR (elt
)));
374 /* Advance to next element. */
379 /* If by the first boundary we have already passed undo_outer_limit,
380 we're heading for memory full, so offer to clear out the list. */
381 if (INTEGERP (Vundo_outer_limit
)
382 && size_so_far
> XINT (Vundo_outer_limit
)
383 && !NILP (Vundo_outer_limit_function
))
386 struct buffer
*temp
= last_undo_buffer
;
388 /* Normally the function this calls is undo-outer-limit-truncate. */
389 tem
= call1 (Vundo_outer_limit_function
, make_number (size_so_far
));
392 /* The function is responsible for making
393 any desired changes in buffer-undo-list. */
394 unbind_to (count
, Qnil
);
397 /* That function probably used the minibuffer, and if so, that
398 changed last_undo_buffer. Change it back so that we don't
399 force next change to make an undo boundary here. */
400 last_undo_buffer
= temp
;
404 last_boundary
= prev
;
406 /* Keep additional undo data, if it fits in the limits. */
412 /* When we get to a boundary, decide whether to truncate
413 either before or after it. The lower threshold, undo_limit,
414 tells us to truncate after it. If its size pushes past
415 the higher threshold undo_strong_limit, we truncate before it. */
418 if (size_so_far
> undo_strong_limit
)
420 last_boundary
= prev
;
421 if (size_so_far
> undo_limit
)
425 /* Add in the space occupied by this element and its chain link. */
426 size_so_far
+= sizeof (struct Lisp_Cons
);
429 size_so_far
+= sizeof (struct Lisp_Cons
);
430 if (STRINGP (XCAR (elt
)))
431 size_so_far
+= (sizeof (struct Lisp_String
) - 1
432 + SCHARS (XCAR (elt
)));
435 /* Advance to next element. */
440 /* If we scanned the whole list, it is short enough; don't change it. */
443 /* Truncate at the boundary where we decided to truncate. */
444 else if (!NILP (last_boundary
))
445 XSETCDR (last_boundary
, Qnil
);
446 /* There's nothing we decided to keep, so clear it out. */
448 bset_undo_list (b
, Qnil
);
450 unbind_to (count
, Qnil
);
457 DEFSYM (Qinhibit_read_only
, "inhibit-read-only");
459 /* Marker for function call undo list elements. */
460 DEFSYM (Qapply
, "apply");
462 pending_boundary
= Qnil
;
463 staticpro (&pending_boundary
);
465 last_undo_buffer
= NULL
;
466 last_boundary_buffer
= NULL
;
468 defsubr (&Sundo_boundary
);
470 DEFVAR_INT ("undo-limit", undo_limit
,
471 doc
: /* Keep no more undo information once it exceeds this size.
472 This limit is applied when garbage collection happens.
473 When a previous command increases the total undo list size past this
474 value, the earlier commands that came before it are forgotten.
476 The size is counted as the number of bytes occupied,
477 which includes both saved text and other data. */);
480 DEFVAR_INT ("undo-strong-limit", undo_strong_limit
,
481 doc
: /* Don't keep more than this much size of undo information.
482 This limit is applied when garbage collection happens.
483 When a previous command increases the total undo list size past this
484 value, that command and the earlier commands that came before it are forgotten.
485 However, the most recent buffer-modifying command's undo info
486 is never discarded for this reason.
488 The size is counted as the number of bytes occupied,
489 which includes both saved text and other data. */);
490 undo_strong_limit
= 120000;
492 DEFVAR_LISP ("undo-outer-limit", Vundo_outer_limit
,
493 doc
: /* Outer limit on size of undo information for one command.
494 At garbage collection time, if the current command has produced
495 more than this much undo information, it discards the info and displays
496 a warning. This is a last-ditch limit to prevent memory overflow.
498 The size is counted as the number of bytes occupied, which includes
499 both saved text and other data. A value of nil means no limit. In
500 this case, accumulating one huge undo entry could make Emacs crash as
501 a result of memory overflow.
503 In fact, this calls the function which is the value of
504 `undo-outer-limit-function' with one argument, the size.
505 The text above describes the behavior of the function
506 that variable usually specifies. */);
507 Vundo_outer_limit
= make_number (12000000);
509 DEFVAR_LISP ("undo-outer-limit-function", Vundo_outer_limit_function
,
510 doc
: /* Function to call when an undo list exceeds `undo-outer-limit'.
511 This function is called with one argument, the current undo list size
512 for the most recent command (since the last undo boundary).
513 If the function returns t, that means truncation has been fully handled.
514 If it returns nil, the other forms of truncation are done.
516 Garbage collection is inhibited around the call to this function,
517 so it must make sure not to do a lot of consing. */);
518 Vundo_outer_limit_function
= Qnil
;
520 DEFVAR_BOOL ("undo-inhibit-record-point", undo_inhibit_record_point
,
521 doc
: /* Non-nil means do not record `point' in `buffer-undo-list'. */);
522 undo_inhibit_record_point
= false;