* net/tramp.el (tramp-handle-file-accessible-directory-p): New defun.
[emacs.git] / src / buffer.c
blob59b139359e2518f8d6c2b97f0d32eba4a5a29b36
1 /* Buffer manipulation primitives for GNU Emacs.
3 Copyright (C) 1985-1989, 1993-1995, 1997-2012 Free Software Foundation, Inc.
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/>. */
20 #include <config.h>
22 #define BUFFER_INLINE EXTERN_INLINE
24 #include <sys/types.h>
25 #include <sys/stat.h>
26 #include <sys/param.h>
27 #include <errno.h>
28 #include <stdio.h>
29 #include <unistd.h>
31 #include <verify.h>
33 #include "lisp.h"
34 #include "intervals.h"
35 #include "window.h"
36 #include "commands.h"
37 #include "character.h"
38 #include "buffer.h"
39 #include "region-cache.h"
40 #include "indent.h"
41 #include "blockinput.h"
42 #include "keyboard.h"
43 #include "keymap.h"
44 #include "frame.h"
46 struct buffer *current_buffer; /* The current buffer. */
48 /* First buffer in chain of all buffers (in reverse order of creation).
49 Threaded through ->header.next.buffer. */
51 struct buffer *all_buffers;
53 /* This structure holds the default values of the buffer-local variables
54 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
55 The default value occupies the same slot in this structure
56 as an individual buffer's value occupies in that buffer.
57 Setting the default value also goes through the alist of buffers
58 and stores into each buffer that does not say it has a local value. */
60 struct buffer alignas (GCALIGNMENT) buffer_defaults;
62 /* This structure marks which slots in a buffer have corresponding
63 default values in buffer_defaults.
64 Each such slot has a nonzero value in this structure.
65 The value has only one nonzero bit.
67 When a buffer has its own local value for a slot,
68 the entry for that slot (found in the same slot in this structure)
69 is turned on in the buffer's local_flags array.
71 If a slot in this structure is -1, then even though there may
72 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
73 and the corresponding slot in buffer_defaults is not used.
75 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
76 zero, that is a bug. */
78 struct buffer buffer_local_flags;
80 /* This structure holds the names of symbols whose values may be
81 buffer-local. It is indexed and accessed in the same way as the above. */
83 struct buffer alignas (GCALIGNMENT) buffer_local_symbols;
85 /* Return the symbol of the per-buffer variable at offset OFFSET in
86 the buffer structure. */
88 #define PER_BUFFER_SYMBOL(OFFSET) \
89 (*(Lisp_Object *)((OFFSET) + (char *) &buffer_local_symbols))
91 /* Maximum length of an overlay vector. */
92 #define OVERLAY_COUNT_MAX \
93 ((ptrdiff_t) min (MOST_POSITIVE_FIXNUM, \
94 min (PTRDIFF_MAX, SIZE_MAX) / word_size))
96 /* Flags indicating which built-in buffer-local variables
97 are permanent locals. */
98 static char buffer_permanent_local_flags[MAX_PER_BUFFER_VARS];
100 /* Number of per-buffer variables used. */
102 int last_per_buffer_idx;
104 static void call_overlay_mod_hooks (Lisp_Object list, Lisp_Object overlay,
105 bool after, Lisp_Object arg1,
106 Lisp_Object arg2, Lisp_Object arg3);
107 static void swap_out_buffer_local_variables (struct buffer *b);
108 static void reset_buffer_local_variables (struct buffer *, bool);
110 /* Alist of all buffer names vs the buffers. */
111 /* This used to be a variable, but is no longer,
112 to prevent lossage due to user rplac'ing this alist or its elements. */
113 Lisp_Object Vbuffer_alist;
115 static Lisp_Object Qkill_buffer_query_functions;
117 /* Hook run before changing a major mode. */
118 static Lisp_Object Qchange_major_mode_hook;
120 Lisp_Object Qfirst_change_hook;
121 Lisp_Object Qbefore_change_functions;
122 Lisp_Object Qafter_change_functions;
124 static Lisp_Object Qfundamental_mode, Qmode_class, Qpermanent_local;
125 static Lisp_Object Qpermanent_local_hook;
127 static Lisp_Object Qprotected_field;
129 static Lisp_Object QSFundamental; /* A string "Fundamental". */
131 static Lisp_Object Qkill_buffer_hook;
132 static Lisp_Object Qbuffer_list_update_hook;
134 static Lisp_Object Qget_file_buffer;
136 static Lisp_Object Qoverlayp;
138 Lisp_Object Qpriority, Qbefore_string, Qafter_string;
140 static Lisp_Object Qevaporate;
142 Lisp_Object Qmodification_hooks;
143 Lisp_Object Qinsert_in_front_hooks;
144 Lisp_Object Qinsert_behind_hooks;
146 static void alloc_buffer_text (struct buffer *, ptrdiff_t);
147 static void free_buffer_text (struct buffer *b);
148 static struct Lisp_Overlay * copy_overlays (struct buffer *, struct Lisp_Overlay *);
149 static void modify_overlay (struct buffer *, ptrdiff_t, ptrdiff_t);
150 static Lisp_Object buffer_lisp_local_variables (struct buffer *, bool);
152 /* These setters are used only in this file, so they can be private. */
153 static void
154 bset_abbrev_mode (struct buffer *b, Lisp_Object val)
156 b->INTERNAL_FIELD (abbrev_mode) = val;
158 static void
159 bset_abbrev_table (struct buffer *b, Lisp_Object val)
161 b->INTERNAL_FIELD (abbrev_table) = val;
163 static void
164 bset_auto_fill_function (struct buffer *b, Lisp_Object val)
166 b->INTERNAL_FIELD (auto_fill_function) = val;
168 static void
169 bset_auto_save_file_format (struct buffer *b, Lisp_Object val)
171 b->INTERNAL_FIELD (auto_save_file_format) = val;
173 static void
174 bset_auto_save_file_name (struct buffer *b, Lisp_Object val)
176 b->INTERNAL_FIELD (auto_save_file_name) = val;
178 static void
179 bset_backed_up (struct buffer *b, Lisp_Object val)
181 b->INTERNAL_FIELD (backed_up) = val;
183 static void
184 bset_begv_marker (struct buffer *b, Lisp_Object val)
186 b->INTERNAL_FIELD (begv_marker) = val;
188 static void
189 bset_bidi_display_reordering (struct buffer *b, Lisp_Object val)
191 b->INTERNAL_FIELD (bidi_display_reordering) = val;
193 static void
194 bset_buffer_file_coding_system (struct buffer *b, Lisp_Object val)
196 b->INTERNAL_FIELD (buffer_file_coding_system) = val;
198 static void
199 bset_cache_long_line_scans (struct buffer *b, Lisp_Object val)
201 b->INTERNAL_FIELD (cache_long_line_scans) = val;
203 static void
204 bset_case_fold_search (struct buffer *b, Lisp_Object val)
206 b->INTERNAL_FIELD (case_fold_search) = val;
208 static void
209 bset_ctl_arrow (struct buffer *b, Lisp_Object val)
211 b->INTERNAL_FIELD (ctl_arrow) = val;
213 static void
214 bset_cursor_in_non_selected_windows (struct buffer *b, Lisp_Object val)
216 b->INTERNAL_FIELD (cursor_in_non_selected_windows) = val;
218 static void
219 bset_cursor_type (struct buffer *b, Lisp_Object val)
221 b->INTERNAL_FIELD (cursor_type) = val;
223 static void
224 bset_display_table (struct buffer *b, Lisp_Object val)
226 b->INTERNAL_FIELD (display_table) = val;
228 static void
229 bset_extra_line_spacing (struct buffer *b, Lisp_Object val)
231 b->INTERNAL_FIELD (extra_line_spacing) = val;
233 static void
234 bset_file_format (struct buffer *b, Lisp_Object val)
236 b->INTERNAL_FIELD (file_format) = val;
238 static void
239 bset_file_truename (struct buffer *b, Lisp_Object val)
241 b->INTERNAL_FIELD (file_truename) = val;
243 static void
244 bset_fringe_cursor_alist (struct buffer *b, Lisp_Object val)
246 b->INTERNAL_FIELD (fringe_cursor_alist) = val;
248 static void
249 bset_fringe_indicator_alist (struct buffer *b, Lisp_Object val)
251 b->INTERNAL_FIELD (fringe_indicator_alist) = val;
253 static void
254 bset_fringes_outside_margins (struct buffer *b, Lisp_Object val)
256 b->INTERNAL_FIELD (fringes_outside_margins) = val;
258 static void
259 bset_header_line_format (struct buffer *b, Lisp_Object val)
261 b->INTERNAL_FIELD (header_line_format) = val;
263 static void
264 bset_indicate_buffer_boundaries (struct buffer *b, Lisp_Object val)
266 b->INTERNAL_FIELD (indicate_buffer_boundaries) = val;
268 static void
269 bset_indicate_empty_lines (struct buffer *b, Lisp_Object val)
271 b->INTERNAL_FIELD (indicate_empty_lines) = val;
273 static void
274 bset_invisibility_spec (struct buffer *b, Lisp_Object val)
276 b->INTERNAL_FIELD (invisibility_spec) = val;
278 static void
279 bset_left_fringe_width (struct buffer *b, Lisp_Object val)
281 b->INTERNAL_FIELD (left_fringe_width) = val;
283 static void
284 bset_major_mode (struct buffer *b, Lisp_Object val)
286 b->INTERNAL_FIELD (major_mode) = val;
288 static void
289 bset_mark (struct buffer *b, Lisp_Object val)
291 b->INTERNAL_FIELD (mark) = val;
293 static void
294 bset_minor_modes (struct buffer *b, Lisp_Object val)
296 b->INTERNAL_FIELD (minor_modes) = val;
298 static void
299 bset_mode_line_format (struct buffer *b, Lisp_Object val)
301 b->INTERNAL_FIELD (mode_line_format) = val;
303 static void
304 bset_mode_name (struct buffer *b, Lisp_Object val)
306 b->INTERNAL_FIELD (mode_name) = val;
308 static void
309 bset_name (struct buffer *b, Lisp_Object val)
311 b->INTERNAL_FIELD (name) = val;
313 static void
314 bset_overwrite_mode (struct buffer *b, Lisp_Object val)
316 b->INTERNAL_FIELD (overwrite_mode) = val;
318 static void
319 bset_pt_marker (struct buffer *b, Lisp_Object val)
321 b->INTERNAL_FIELD (pt_marker) = val;
323 static void
324 bset_right_fringe_width (struct buffer *b, Lisp_Object val)
326 b->INTERNAL_FIELD (right_fringe_width) = val;
328 static void
329 bset_save_length (struct buffer *b, Lisp_Object val)
331 b->INTERNAL_FIELD (save_length) = val;
333 static void
334 bset_scroll_bar_width (struct buffer *b, Lisp_Object val)
336 b->INTERNAL_FIELD (scroll_bar_width) = val;
338 static void
339 bset_scroll_down_aggressively (struct buffer *b, Lisp_Object val)
341 b->INTERNAL_FIELD (scroll_down_aggressively) = val;
343 static void
344 bset_scroll_up_aggressively (struct buffer *b, Lisp_Object val)
346 b->INTERNAL_FIELD (scroll_up_aggressively) = val;
348 static void
349 bset_selective_display (struct buffer *b, Lisp_Object val)
351 b->INTERNAL_FIELD (selective_display) = val;
353 static void
354 bset_selective_display_ellipses (struct buffer *b, Lisp_Object val)
356 b->INTERNAL_FIELD (selective_display_ellipses) = val;
358 static void
359 bset_vertical_scroll_bar_type (struct buffer *b, Lisp_Object val)
361 b->INTERNAL_FIELD (vertical_scroll_bar_type) = val;
363 static void
364 bset_word_wrap (struct buffer *b, Lisp_Object val)
366 b->INTERNAL_FIELD (word_wrap) = val;
368 static void
369 bset_zv_marker (struct buffer *b, Lisp_Object val)
371 b->INTERNAL_FIELD (zv_marker) = val;
374 /* For debugging; temporary. See set_buffer_internal. */
375 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
377 void
378 nsberror (Lisp_Object spec)
380 if (STRINGP (spec))
381 error ("No buffer named %s", SDATA (spec));
382 error ("Invalid buffer argument");
385 DEFUN ("buffer-live-p", Fbuffer_live_p, Sbuffer_live_p, 1, 1, 0,
386 doc: /* Return non-nil if OBJECT is a buffer which has not been killed.
387 Value is nil if OBJECT is not a buffer or if it has been killed. */)
388 (Lisp_Object object)
390 return ((BUFFERP (object) && BUFFER_LIVE_P (XBUFFER (object)))
391 ? Qt : Qnil);
394 DEFUN ("buffer-list", Fbuffer_list, Sbuffer_list, 0, 1, 0,
395 doc: /* Return a list of all existing live buffers.
396 If the optional arg FRAME is a frame, we return the buffer list in the
397 proper order for that frame: the buffers show in FRAME come first,
398 followed by the rest of the buffers. */)
399 (Lisp_Object frame)
401 Lisp_Object general;
402 general = Fmapcar (Qcdr, Vbuffer_alist);
404 if (FRAMEP (frame))
406 Lisp_Object framelist, prevlist, tail;
407 Lisp_Object args[3];
409 framelist = Fcopy_sequence (XFRAME (frame)->buffer_list);
410 prevlist = Fnreverse (Fcopy_sequence
411 (XFRAME (frame)->buried_buffer_list));
413 /* Remove from GENERAL any buffer that duplicates one in
414 FRAMELIST or PREVLIST. */
415 tail = framelist;
416 while (CONSP (tail))
418 general = Fdelq (XCAR (tail), general);
419 tail = XCDR (tail);
421 tail = prevlist;
422 while (CONSP (tail))
424 general = Fdelq (XCAR (tail), general);
425 tail = XCDR (tail);
428 args[0] = framelist;
429 args[1] = general;
430 args[2] = prevlist;
431 return Fnconc (3, args);
433 else
434 return general;
437 /* Like Fassoc, but use Fstring_equal to compare
438 (which ignores text properties),
439 and don't ever QUIT. */
441 static Lisp_Object
442 assoc_ignore_text_properties (register Lisp_Object key, Lisp_Object list)
444 register Lisp_Object tail;
445 for (tail = list; CONSP (tail); tail = XCDR (tail))
447 register Lisp_Object elt, tem;
448 elt = XCAR (tail);
449 tem = Fstring_equal (Fcar (elt), key);
450 if (!NILP (tem))
451 return elt;
453 return Qnil;
456 DEFUN ("get-buffer", Fget_buffer, Sget_buffer, 1, 1, 0,
457 doc: /* Return the buffer named BUFFER-OR-NAME.
458 BUFFER-OR-NAME must be either a string or a buffer. If BUFFER-OR-NAME
459 is a string and there is no buffer with that name, return nil. If
460 BUFFER-OR-NAME is a buffer, return it as given. */)
461 (register Lisp_Object buffer_or_name)
463 if (BUFFERP (buffer_or_name))
464 return buffer_or_name;
465 CHECK_STRING (buffer_or_name);
467 return Fcdr (assoc_ignore_text_properties (buffer_or_name, Vbuffer_alist));
470 DEFUN ("get-file-buffer", Fget_file_buffer, Sget_file_buffer, 1, 1, 0,
471 doc: /* Return the buffer visiting file FILENAME (a string).
472 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.
473 If there is no such live buffer, return nil.
474 See also `find-buffer-visiting'. */)
475 (register Lisp_Object filename)
477 register Lisp_Object tail, buf, tem;
478 Lisp_Object handler;
480 CHECK_STRING (filename);
481 filename = Fexpand_file_name (filename, Qnil);
483 /* If the file name has special constructs in it,
484 call the corresponding file handler. */
485 handler = Ffind_file_name_handler (filename, Qget_file_buffer);
486 if (!NILP (handler))
488 Lisp_Object handled_buf = call2 (handler, Qget_file_buffer,
489 filename);
490 return BUFFERP (handled_buf) ? handled_buf : Qnil;
493 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
495 buf = Fcdr (XCAR (tail));
496 if (!BUFFERP (buf)) continue;
497 if (!STRINGP (BVAR (XBUFFER (buf), filename))) continue;
498 tem = Fstring_equal (BVAR (XBUFFER (buf), filename), filename);
499 if (!NILP (tem))
500 return buf;
502 return Qnil;
505 Lisp_Object
506 get_truename_buffer (register Lisp_Object filename)
508 register Lisp_Object tail, buf, tem;
510 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
512 buf = Fcdr (XCAR (tail));
513 if (!BUFFERP (buf)) continue;
514 if (!STRINGP (BVAR (XBUFFER (buf), file_truename))) continue;
515 tem = Fstring_equal (BVAR (XBUFFER (buf), file_truename), filename);
516 if (!NILP (tem))
517 return buf;
519 return Qnil;
522 DEFUN ("get-buffer-create", Fget_buffer_create, Sget_buffer_create, 1, 1, 0,
523 doc: /* Return the buffer specified by BUFFER-OR-NAME, creating a new one if needed.
524 If BUFFER-OR-NAME is a string and a live buffer with that name exists,
525 return that buffer. If no such buffer exists, create a new buffer with
526 that name and return it. If BUFFER-OR-NAME starts with a space, the new
527 buffer does not keep undo information.
529 If BUFFER-OR-NAME is a buffer instead of a string, return it as given,
530 even if it is dead. The return value is never nil. */)
531 (register Lisp_Object buffer_or_name)
533 register Lisp_Object buffer, name;
534 register struct buffer *b;
536 buffer = Fget_buffer (buffer_or_name);
537 if (!NILP (buffer))
538 return buffer;
540 if (SCHARS (buffer_or_name) == 0)
541 error ("Empty string for buffer name is not allowed");
543 b = allocate_buffer ();
545 /* An ordinary buffer uses its own struct buffer_text. */
546 b->text = &b->own_text;
547 b->base_buffer = NULL;
548 /* No one shares the text with us now. */
549 b->indirections = 0;
550 /* No one shows us now. */
551 b->window_count = 0;
553 BUF_GAP_SIZE (b) = 20;
554 block_input ();
555 /* We allocate extra 1-byte at the tail and keep it always '\0' for
556 anchoring a search. */
557 alloc_buffer_text (b, BUF_GAP_SIZE (b) + 1);
558 unblock_input ();
559 if (! BUF_BEG_ADDR (b))
560 buffer_memory_full (BUF_GAP_SIZE (b) + 1);
562 b->pt = BEG;
563 b->begv = BEG;
564 b->zv = BEG;
565 b->pt_byte = BEG_BYTE;
566 b->begv_byte = BEG_BYTE;
567 b->zv_byte = BEG_BYTE;
569 BUF_GPT (b) = BEG;
570 BUF_GPT_BYTE (b) = BEG_BYTE;
572 BUF_Z (b) = BEG;
573 BUF_Z_BYTE (b) = BEG_BYTE;
574 BUF_MODIFF (b) = 1;
575 BUF_CHARS_MODIFF (b) = 1;
576 BUF_OVERLAY_MODIFF (b) = 1;
577 BUF_SAVE_MODIFF (b) = 1;
578 BUF_COMPACT (b) = 1;
579 set_buffer_intervals (b, NULL);
580 BUF_UNCHANGED_MODIFIED (b) = 1;
581 BUF_OVERLAY_UNCHANGED_MODIFIED (b) = 1;
582 BUF_END_UNCHANGED (b) = 0;
583 BUF_BEG_UNCHANGED (b) = 0;
584 *(BUF_GPT_ADDR (b)) = *(BUF_Z_ADDR (b)) = 0; /* Put an anchor '\0'. */
585 b->text->inhibit_shrinking = 0;
587 b->newline_cache = 0;
588 b->width_run_cache = 0;
589 bset_width_table (b, Qnil);
590 b->prevent_redisplay_optimizations_p = 1;
592 /* An ordinary buffer normally doesn't need markers
593 to handle BEGV and ZV. */
594 bset_pt_marker (b, Qnil);
595 bset_begv_marker (b, Qnil);
596 bset_zv_marker (b, Qnil);
598 name = Fcopy_sequence (buffer_or_name);
599 set_string_intervals (name, NULL);
600 bset_name (b, name);
602 bset_undo_list (b, SREF (name, 0) != ' ' ? Qnil : Qt);
604 reset_buffer (b);
605 reset_buffer_local_variables (b, 1);
607 bset_mark (b, Fmake_marker ());
608 BUF_MARKERS (b) = NULL;
610 /* Put this in the alist of all live buffers. */
611 XSETBUFFER (buffer, b);
612 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buffer), Qnil));
613 /* And run buffer-list-update-hook. */
614 if (!NILP (Vrun_hooks))
615 call1 (Vrun_hooks, Qbuffer_list_update_hook);
617 return buffer;
621 /* Return a list of overlays which is a copy of the overlay list
622 LIST, but for buffer B. */
624 static struct Lisp_Overlay *
625 copy_overlays (struct buffer *b, struct Lisp_Overlay *list)
627 struct Lisp_Overlay *result = NULL, *tail = NULL;
629 for (; list; list = list->next)
631 Lisp_Object overlay, start, end;
632 struct Lisp_Marker *m;
634 eassert (MARKERP (list->start));
635 m = XMARKER (list->start);
636 start = build_marker (b, m->charpos, m->bytepos);
637 XMARKER (start)->insertion_type = m->insertion_type;
639 eassert (MARKERP (list->end));
640 m = XMARKER (list->end);
641 end = build_marker (b, m->charpos, m->bytepos);
642 XMARKER (end)->insertion_type = m->insertion_type;
644 overlay = build_overlay (start, end, Fcopy_sequence (list->plist));
645 if (tail)
646 tail = tail->next = XOVERLAY (overlay);
647 else
648 result = tail = XOVERLAY (overlay);
651 return result;
654 /* Set an appropriate overlay of B. */
656 static void
657 set_buffer_overlays_before (struct buffer *b, struct Lisp_Overlay *o)
659 b->overlays_before = o;
662 static void
663 set_buffer_overlays_after (struct buffer *b, struct Lisp_Overlay *o)
665 b->overlays_after = o;
668 /* Clone per-buffer values of buffer FROM.
670 Buffer TO gets the same per-buffer values as FROM, with the
671 following exceptions: (1) TO's name is left untouched, (2) markers
672 are copied and made to refer to TO, and (3) overlay lists are
673 copied. */
675 static void
676 clone_per_buffer_values (struct buffer *from, struct buffer *to)
678 int offset;
680 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
682 Lisp_Object obj;
684 /* Don't touch the `name' which should be unique for every buffer. */
685 if (offset == PER_BUFFER_VAR_OFFSET (name))
686 continue;
688 obj = per_buffer_value (from, offset);
689 if (MARKERP (obj) && XMARKER (obj)->buffer == from)
691 struct Lisp_Marker *m = XMARKER (obj);
693 obj = build_marker (to, m->charpos, m->bytepos);
694 XMARKER (obj)->insertion_type = m->insertion_type;
697 set_per_buffer_value (to, offset, obj);
700 memcpy (to->local_flags, from->local_flags, sizeof to->local_flags);
702 set_buffer_overlays_before (to, copy_overlays (to, from->overlays_before));
703 set_buffer_overlays_after (to, copy_overlays (to, from->overlays_after));
705 /* Get (a copy of) the alist of Lisp-level local variables of FROM
706 and install that in TO. */
707 bset_local_var_alist (to, buffer_lisp_local_variables (from, 1));
711 /* If buffer B has markers to record PT, BEGV and ZV when it is not
712 current, update these markers. */
714 static void
715 record_buffer_markers (struct buffer *b)
717 if (! NILP (BVAR (b, pt_marker)))
719 Lisp_Object buffer;
721 eassert (!NILP (BVAR (b, begv_marker)));
722 eassert (!NILP (BVAR (b, zv_marker)));
724 XSETBUFFER (buffer, b);
725 set_marker_both (BVAR (b, pt_marker), buffer, b->pt, b->pt_byte);
726 set_marker_both (BVAR (b, begv_marker), buffer, b->begv, b->begv_byte);
727 set_marker_both (BVAR (b, zv_marker), buffer, b->zv, b->zv_byte);
732 /* If buffer B has markers to record PT, BEGV and ZV when it is not
733 current, fetch these values into B->begv etc. */
735 static void
736 fetch_buffer_markers (struct buffer *b)
738 if (! NILP (BVAR (b, pt_marker)))
740 Lisp_Object m;
742 eassert (!NILP (BVAR (b, begv_marker)));
743 eassert (!NILP (BVAR (b, zv_marker)));
745 m = BVAR (b, pt_marker);
746 SET_BUF_PT_BOTH (b, marker_position (m), marker_byte_position (m));
748 m = BVAR (b, begv_marker);
749 SET_BUF_BEGV_BOTH (b, marker_position (m), marker_byte_position (m));
751 m = BVAR (b, zv_marker);
752 SET_BUF_ZV_BOTH (b, marker_position (m), marker_byte_position (m));
757 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer, Smake_indirect_buffer,
758 2, 3,
759 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
760 doc: /* Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.
761 BASE-BUFFER should be a live buffer, or the name of an existing buffer.
762 NAME should be a string which is not the name of an existing buffer.
763 Optional argument CLONE non-nil means preserve BASE-BUFFER's state,
764 such as major and minor modes, in the indirect buffer.
765 CLONE nil means the indirect buffer's state is reset to default values. */)
766 (Lisp_Object base_buffer, Lisp_Object name, Lisp_Object clone)
768 Lisp_Object buf, tem;
769 struct buffer *b;
771 CHECK_STRING (name);
772 buf = Fget_buffer (name);
773 if (!NILP (buf))
774 error ("Buffer name `%s' is in use", SDATA (name));
776 tem = base_buffer;
777 base_buffer = Fget_buffer (base_buffer);
778 if (NILP (base_buffer))
779 error ("No such buffer: `%s'", SDATA (tem));
780 if (!BUFFER_LIVE_P (XBUFFER (base_buffer)))
781 error ("Base buffer has been killed");
783 if (SCHARS (name) == 0)
784 error ("Empty string for buffer name is not allowed");
786 b = allocate_buffer ();
788 /* No double indirection - if base buffer is indirect,
789 new buffer becomes an indirect to base's base. */
790 b->base_buffer = (XBUFFER (base_buffer)->base_buffer
791 ? XBUFFER (base_buffer)->base_buffer
792 : XBUFFER (base_buffer));
794 /* Use the base buffer's text object. */
795 b->text = b->base_buffer->text;
796 /* We have no own text. */
797 b->indirections = -1;
798 /* Notify base buffer that we share the text now. */
799 b->base_buffer->indirections++;
800 /* Always -1 for an indirect buffer. */
801 b->window_count = -1;
803 b->pt = b->base_buffer->pt;
804 b->begv = b->base_buffer->begv;
805 b->zv = b->base_buffer->zv;
806 b->pt_byte = b->base_buffer->pt_byte;
807 b->begv_byte = b->base_buffer->begv_byte;
808 b->zv_byte = b->base_buffer->zv_byte;
810 b->newline_cache = 0;
811 b->width_run_cache = 0;
812 bset_width_table (b, Qnil);
814 name = Fcopy_sequence (name);
815 set_string_intervals (name, NULL);
816 bset_name (b, name);
818 reset_buffer (b);
819 reset_buffer_local_variables (b, 1);
821 /* Put this in the alist of all live buffers. */
822 XSETBUFFER (buf, b);
823 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
825 bset_mark (b, Fmake_marker ());
827 /* The multibyte status belongs to the base buffer. */
828 bset_enable_multibyte_characters
829 (b, BVAR (b->base_buffer, enable_multibyte_characters));
831 /* Make sure the base buffer has markers for its narrowing. */
832 if (NILP (BVAR (b->base_buffer, pt_marker)))
834 eassert (NILP (BVAR (b->base_buffer, begv_marker)));
835 eassert (NILP (BVAR (b->base_buffer, zv_marker)));
837 bset_pt_marker (b->base_buffer,
838 build_marker (b->base_buffer, b->base_buffer->pt,
839 b->base_buffer->pt_byte));
841 bset_begv_marker (b->base_buffer,
842 build_marker (b->base_buffer, b->base_buffer->begv,
843 b->base_buffer->begv_byte));
845 bset_zv_marker (b->base_buffer,
846 build_marker (b->base_buffer, b->base_buffer->zv,
847 b->base_buffer->zv_byte));
849 XMARKER (BVAR (b->base_buffer, zv_marker))->insertion_type = 1;
852 if (NILP (clone))
854 /* Give the indirect buffer markers for its narrowing. */
855 bset_pt_marker (b, build_marker (b, b->pt, b->pt_byte));
856 bset_begv_marker (b, build_marker (b, b->begv, b->begv_byte));
857 bset_zv_marker (b, build_marker (b, b->zv, b->zv_byte));
858 XMARKER (BVAR (b, zv_marker))->insertion_type = 1;
860 else
862 struct buffer *old_b = current_buffer;
864 clone_per_buffer_values (b->base_buffer, b);
865 bset_filename (b, Qnil);
866 bset_file_truename (b, Qnil);
867 bset_display_count (b, make_number (0));
868 bset_backed_up (b, Qnil);
869 bset_auto_save_file_name (b, Qnil);
870 set_buffer_internal_1 (b);
871 Fset (intern ("buffer-save-without-query"), Qnil);
872 Fset (intern ("buffer-file-number"), Qnil);
873 Fset (intern ("buffer-stale-function"), Qnil);
874 set_buffer_internal_1 (old_b);
877 /* Run buffer-list-update-hook. */
878 if (!NILP (Vrun_hooks))
879 call1 (Vrun_hooks, Qbuffer_list_update_hook);
881 return buf;
884 /* Mark OV as no longer associated with B. */
886 static void
887 drop_overlay (struct buffer *b, struct Lisp_Overlay *ov)
889 eassert (b == XBUFFER (Fmarker_buffer (ov->start)));
890 modify_overlay (b, marker_position (ov->start),
891 marker_position (ov->end));
892 Fset_marker (ov->start, Qnil, Qnil);
893 Fset_marker (ov->end, Qnil, Qnil);
897 /* Delete all overlays of B and reset it's overlay lists. */
899 void
900 delete_all_overlays (struct buffer *b)
902 struct Lisp_Overlay *ov, *next;
904 /* FIXME: Since each drop_overlay will scan BUF_MARKERS to unlink its
905 markers, we have an unneeded O(N^2) behavior here. */
906 for (ov = b->overlays_before; ov; ov = next)
908 drop_overlay (b, ov);
909 next = ov->next;
910 ov->next = NULL;
913 for (ov = b->overlays_after; ov; ov = next)
915 drop_overlay (b, ov);
916 next = ov->next;
917 ov->next = NULL;
920 set_buffer_overlays_before (b, NULL);
921 set_buffer_overlays_after (b, NULL);
924 /* Reinitialize everything about a buffer except its name and contents
925 and local variables.
926 If called on an already-initialized buffer, the list of overlays
927 should be deleted before calling this function, otherwise we end up
928 with overlays that claim to belong to the buffer but the buffer
929 claims it doesn't belong to it. */
931 void
932 reset_buffer (register struct buffer *b)
934 bset_filename (b, Qnil);
935 bset_file_truename (b, Qnil);
936 bset_directory (b, current_buffer ? BVAR (current_buffer, directory) : Qnil);
937 b->modtime = make_emacs_time (0, UNKNOWN_MODTIME_NSECS);
938 b->modtime_size = -1;
939 XSETFASTINT (BVAR (b, save_length), 0);
940 b->last_window_start = 1;
941 /* It is more conservative to start out "changed" than "unchanged". */
942 b->clip_changed = 0;
943 b->prevent_redisplay_optimizations_p = 1;
944 bset_backed_up (b, Qnil);
945 BUF_AUTOSAVE_MODIFF (b) = 0;
946 b->auto_save_failure_time = 0;
947 bset_auto_save_file_name (b, Qnil);
948 bset_read_only (b, Qnil);
949 set_buffer_overlays_before (b, NULL);
950 set_buffer_overlays_after (b, NULL);
951 b->overlay_center = BEG;
952 bset_mark_active (b, Qnil);
953 bset_point_before_scroll (b, Qnil);
954 bset_file_format (b, Qnil);
955 bset_auto_save_file_format (b, Qt);
956 bset_last_selected_window (b, Qnil);
957 bset_display_count (b, make_number (0));
958 bset_display_time (b, Qnil);
959 bset_enable_multibyte_characters
960 (b, BVAR (&buffer_defaults, enable_multibyte_characters));
961 bset_cursor_type (b, BVAR (&buffer_defaults, cursor_type));
962 bset_extra_line_spacing (b, BVAR (&buffer_defaults, extra_line_spacing));
964 b->display_error_modiff = 0;
967 /* Reset buffer B's local variables info.
968 Don't use this on a buffer that has already been in use;
969 it does not treat permanent locals consistently.
970 Instead, use Fkill_all_local_variables.
972 If PERMANENT_TOO, reset permanent buffer-local variables.
973 If not, preserve those. */
975 static void
976 reset_buffer_local_variables (struct buffer *b, bool permanent_too)
978 int offset, i;
980 /* Reset the major mode to Fundamental, together with all the
981 things that depend on the major mode.
982 default-major-mode is handled at a higher level.
983 We ignore it here. */
984 bset_major_mode (b, Qfundamental_mode);
985 bset_keymap (b, Qnil);
986 bset_mode_name (b, QSFundamental);
987 bset_minor_modes (b, Qnil);
989 /* If the standard case table has been altered and invalidated,
990 fix up its insides first. */
991 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[0])
992 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[1])
993 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[2])))
994 Fset_standard_case_table (Vascii_downcase_table);
996 bset_downcase_table (b, Vascii_downcase_table);
997 bset_upcase_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[0]);
998 bset_case_canon_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[1]);
999 bset_case_eqv_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[2]);
1000 bset_invisibility_spec (b, Qt);
1002 /* Reset all (or most) per-buffer variables to their defaults. */
1003 if (permanent_too)
1004 bset_local_var_alist (b, Qnil);
1005 else
1007 Lisp_Object tmp, prop, last = Qnil;
1008 for (tmp = BVAR (b, local_var_alist); CONSP (tmp); tmp = XCDR (tmp))
1009 if (!NILP (prop = Fget (XCAR (XCAR (tmp)), Qpermanent_local)))
1011 /* If permanent-local, keep it. */
1012 last = tmp;
1013 if (EQ (prop, Qpermanent_local_hook))
1015 /* This is a partially permanent hook variable.
1016 Preserve only the elements that want to be preserved. */
1017 Lisp_Object list, newlist;
1018 list = XCDR (XCAR (tmp));
1019 if (!CONSP (list))
1020 newlist = list;
1021 else
1022 for (newlist = Qnil; CONSP (list); list = XCDR (list))
1024 Lisp_Object elt = XCAR (list);
1025 /* Preserve element ELT if it's t,
1026 if it is a function with a `permanent-local-hook' property,
1027 or if it's not a symbol. */
1028 if (! SYMBOLP (elt)
1029 || EQ (elt, Qt)
1030 || !NILP (Fget (elt, Qpermanent_local_hook)))
1031 newlist = Fcons (elt, newlist);
1033 XSETCDR (XCAR (tmp), Fnreverse (newlist));
1036 /* Delete this local variable. */
1037 else if (NILP (last))
1038 bset_local_var_alist (b, XCDR (tmp));
1039 else
1040 XSETCDR (last, XCDR (tmp));
1043 for (i = 0; i < last_per_buffer_idx; ++i)
1044 if (permanent_too || buffer_permanent_local_flags[i] == 0)
1045 SET_PER_BUFFER_VALUE_P (b, i, 0);
1047 /* For each slot that has a default value, copy that into the slot. */
1048 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
1050 int idx = PER_BUFFER_IDX (offset);
1051 if ((idx > 0
1052 && (permanent_too
1053 || buffer_permanent_local_flags[idx] == 0)))
1054 set_per_buffer_value (b, offset, per_buffer_default (offset));
1058 /* We split this away from generate-new-buffer, because rename-buffer
1059 and set-visited-file-name ought to be able to use this to really
1060 rename the buffer properly. */
1062 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name,
1063 Sgenerate_new_buffer_name, 1, 2, 0,
1064 doc: /* Return a string that is the name of no existing buffer based on NAME.
1065 If there is no live buffer named NAME, then return NAME.
1066 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
1067 \(starting at 2) until an unused name is found, and then return that name.
1068 Optional second argument IGNORE specifies a name that is okay to use (if
1069 it is in the sequence to be tried) even if a buffer with that name exists.
1071 If NAME begins with a space (i.e., a buffer that is not normally
1072 visible to users), then if buffer NAME already exists a random number
1073 is first appended to NAME, to speed up finding a non-existent buffer. */)
1074 (register Lisp_Object name, Lisp_Object ignore)
1076 register Lisp_Object gentemp, tem, tem2;
1077 ptrdiff_t count;
1078 char number[INT_BUFSIZE_BOUND (ptrdiff_t) + sizeof "<>"];
1080 CHECK_STRING (name);
1082 tem = Fstring_equal (name, ignore);
1083 if (!NILP (tem))
1084 return name;
1085 tem = Fget_buffer (name);
1086 if (NILP (tem))
1087 return name;
1089 if (!strncmp (SSDATA (name), " ", 1)) /* see bug#1229 */
1091 /* Note fileio.c:make_temp_name does random differently. */
1092 tem2 = concat2 (name, make_formatted_string
1093 (number, "-%"pI"d",
1094 XFASTINT (Frandom (make_number (999999)))));
1095 tem = Fget_buffer (tem2);
1096 if (NILP (tem))
1097 return tem2;
1099 else
1100 tem2 = name;
1102 count = 1;
1103 while (1)
1105 gentemp = concat2 (tem2, make_formatted_string
1106 (number, "<%"pD"d>", ++count));
1107 tem = Fstring_equal (gentemp, ignore);
1108 if (!NILP (tem))
1109 return gentemp;
1110 tem = Fget_buffer (gentemp);
1111 if (NILP (tem))
1112 return gentemp;
1117 DEFUN ("buffer-name", Fbuffer_name, Sbuffer_name, 0, 1, 0,
1118 doc: /* Return the name of BUFFER, as a string.
1119 BUFFER defaults to the current buffer.
1120 Return nil if BUFFER has been killed. */)
1121 (register Lisp_Object buffer)
1123 if (NILP (buffer))
1124 return BVAR (current_buffer, name);
1125 CHECK_BUFFER (buffer);
1126 return BVAR (XBUFFER (buffer), name);
1129 DEFUN ("buffer-file-name", Fbuffer_file_name, Sbuffer_file_name, 0, 1, 0,
1130 doc: /* Return name of file BUFFER is visiting, or nil if none.
1131 No argument or nil as argument means use the current buffer. */)
1132 (register Lisp_Object buffer)
1134 if (NILP (buffer))
1135 return BVAR (current_buffer, filename);
1136 CHECK_BUFFER (buffer);
1137 return BVAR (XBUFFER (buffer), filename);
1140 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer, Sbuffer_base_buffer,
1141 0, 1, 0,
1142 doc: /* Return the base buffer of indirect buffer BUFFER.
1143 If BUFFER is not indirect, return nil.
1144 BUFFER defaults to the current buffer. */)
1145 (register Lisp_Object buffer)
1147 struct buffer *base;
1148 Lisp_Object base_buffer;
1150 if (NILP (buffer))
1151 base = current_buffer->base_buffer;
1152 else
1154 CHECK_BUFFER (buffer);
1155 base = XBUFFER (buffer)->base_buffer;
1158 if (! base)
1159 return Qnil;
1160 XSETBUFFER (base_buffer, base);
1161 return base_buffer;
1164 DEFUN ("buffer-local-value", Fbuffer_local_value,
1165 Sbuffer_local_value, 2, 2, 0,
1166 doc: /* Return the value of VARIABLE in BUFFER.
1167 If VARIABLE does not have a buffer-local binding in BUFFER, the value
1168 is the default binding of the variable. */)
1169 (register Lisp_Object variable, register Lisp_Object buffer)
1171 register Lisp_Object result = buffer_local_value_1 (variable, buffer);
1173 if (EQ (result, Qunbound))
1174 xsignal1 (Qvoid_variable, variable);
1176 return result;
1180 /* Like Fbuffer_local_value, but return Qunbound if the variable is
1181 locally unbound. */
1183 Lisp_Object
1184 buffer_local_value_1 (Lisp_Object variable, Lisp_Object buffer)
1186 register struct buffer *buf;
1187 register Lisp_Object result;
1188 struct Lisp_Symbol *sym;
1190 CHECK_SYMBOL (variable);
1191 CHECK_BUFFER (buffer);
1192 buf = XBUFFER (buffer);
1193 sym = XSYMBOL (variable);
1195 start:
1196 switch (sym->redirect)
1198 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1199 case SYMBOL_PLAINVAL: result = SYMBOL_VAL (sym); break;
1200 case SYMBOL_LOCALIZED:
1201 { /* Look in local_var_alist. */
1202 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1203 XSETSYMBOL (variable, sym); /* Update In case of aliasing. */
1204 result = Fassoc (variable, BVAR (buf, local_var_alist));
1205 if (!NILP (result))
1207 if (blv->fwd)
1208 { /* What binding is loaded right now? */
1209 Lisp_Object current_alist_element = blv->valcell;
1211 /* The value of the currently loaded binding is not
1212 stored in it, but rather in the realvalue slot.
1213 Store that value into the binding it belongs to
1214 in case that is the one we are about to use. */
1216 XSETCDR (current_alist_element,
1217 do_symval_forwarding (blv->fwd));
1219 /* Now get the (perhaps updated) value out of the binding. */
1220 result = XCDR (result);
1222 else
1223 result = Fdefault_value (variable);
1224 break;
1226 case SYMBOL_FORWARDED:
1228 union Lisp_Fwd *fwd = SYMBOL_FWD (sym);
1229 if (BUFFER_OBJFWDP (fwd))
1230 result = per_buffer_value (buf, XBUFFER_OBJFWD (fwd)->offset);
1231 else
1232 result = Fdefault_value (variable);
1233 break;
1235 default: emacs_abort ();
1238 return result;
1241 /* Return an alist of the Lisp-level buffer-local bindings of
1242 buffer BUF. That is, don't include the variables maintained
1243 in special slots in the buffer object.
1244 If not CLONE, replace elements of the form (VAR . unbound)
1245 by VAR. */
1247 static Lisp_Object
1248 buffer_lisp_local_variables (struct buffer *buf, bool clone)
1250 Lisp_Object result = Qnil;
1251 Lisp_Object tail;
1252 for (tail = BVAR (buf, local_var_alist); CONSP (tail); tail = XCDR (tail))
1254 Lisp_Object val, elt;
1256 elt = XCAR (tail);
1258 /* Reference each variable in the alist in buf.
1259 If inquiring about the current buffer, this gets the current values,
1260 so store them into the alist so the alist is up to date.
1261 If inquiring about some other buffer, this swaps out any values
1262 for that buffer, making the alist up to date automatically. */
1263 val = find_symbol_value (XCAR (elt));
1264 /* Use the current buffer value only if buf is the current buffer. */
1265 if (buf != current_buffer)
1266 val = XCDR (elt);
1268 result = Fcons (!clone && EQ (val, Qunbound)
1269 ? XCAR (elt)
1270 : Fcons (XCAR (elt), val),
1271 result);
1274 return result;
1277 DEFUN ("buffer-local-variables", Fbuffer_local_variables,
1278 Sbuffer_local_variables, 0, 1, 0,
1279 doc: /* Return an alist of variables that are buffer-local in BUFFER.
1280 Most elements look like (SYMBOL . VALUE), describing one variable.
1281 For a symbol that is locally unbound, just the symbol appears in the value.
1282 Note that storing new VALUEs in these elements doesn't change the variables.
1283 No argument or nil as argument means use current buffer as BUFFER. */)
1284 (register Lisp_Object buffer)
1286 register struct buffer *buf;
1287 register Lisp_Object result;
1289 if (NILP (buffer))
1290 buf = current_buffer;
1291 else
1293 CHECK_BUFFER (buffer);
1294 buf = XBUFFER (buffer);
1297 result = buffer_lisp_local_variables (buf, 0);
1299 /* Add on all the variables stored in special slots. */
1301 int offset, idx;
1303 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
1305 idx = PER_BUFFER_IDX (offset);
1306 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1307 && SYMBOLP (PER_BUFFER_SYMBOL (offset)))
1309 Lisp_Object sym = PER_BUFFER_SYMBOL (offset);
1310 Lisp_Object val = per_buffer_value (buf, offset);
1311 result = Fcons (EQ (val, Qunbound) ? sym : Fcons (sym, val),
1312 result);
1317 return result;
1320 DEFUN ("buffer-modified-p", Fbuffer_modified_p, Sbuffer_modified_p,
1321 0, 1, 0,
1322 doc: /* Return t if BUFFER was modified since its file was last read or saved.
1323 No argument or nil as argument means use current buffer as BUFFER. */)
1324 (register Lisp_Object buffer)
1326 register struct buffer *buf;
1327 if (NILP (buffer))
1328 buf = current_buffer;
1329 else
1331 CHECK_BUFFER (buffer);
1332 buf = XBUFFER (buffer);
1335 return BUF_SAVE_MODIFF (buf) < BUF_MODIFF (buf) ? Qt : Qnil;
1338 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
1339 1, 1, 0,
1340 doc: /* Mark current buffer as modified or unmodified according to FLAG.
1341 A non-nil FLAG means mark the buffer modified. */)
1342 (Lisp_Object flag)
1344 Lisp_Object fn;
1346 #ifdef CLASH_DETECTION
1347 /* If buffer becoming modified, lock the file.
1348 If buffer becoming unmodified, unlock the file. */
1350 struct buffer *b = current_buffer->base_buffer
1351 ? current_buffer->base_buffer
1352 : current_buffer;
1354 fn = BVAR (b, file_truename);
1355 /* Test buffer-file-name so that binding it to nil is effective. */
1356 if (!NILP (fn) && ! NILP (BVAR (b, filename)))
1358 bool already = SAVE_MODIFF < MODIFF;
1359 if (!already && !NILP (flag))
1360 lock_file (fn);
1361 else if (already && NILP (flag))
1362 unlock_file (fn);
1364 #endif /* CLASH_DETECTION */
1366 /* Here we have a problem. SAVE_MODIFF is used here to encode
1367 buffer-modified-p (as SAVE_MODIFF<MODIFF) as well as
1368 recent-auto-save-p (as SAVE_MODIFF<auto_save_modified). So if we
1369 modify SAVE_MODIFF to affect one, we may affect the other
1370 as well.
1371 E.g. if FLAG is nil we need to set SAVE_MODIFF to MODIFF, but
1372 if SAVE_MODIFF<auto_save_modified that means we risk changing
1373 recent-auto-save-p from t to nil.
1374 Vice versa, if FLAG is non-nil and SAVE_MODIFF>=auto_save_modified
1375 we risk changing recent-auto-save-p from nil to t. */
1376 SAVE_MODIFF = (NILP (flag)
1377 /* FIXME: This unavoidably sets recent-auto-save-p to nil. */
1378 ? MODIFF
1379 /* Let's try to preserve recent-auto-save-p. */
1380 : SAVE_MODIFF < MODIFF ? SAVE_MODIFF
1381 /* If SAVE_MODIFF == auto_save_modified == MODIFF,
1382 we can either decrease SAVE_MODIFF and auto_save_modified
1383 or increase MODIFF. */
1384 : MODIFF++);
1386 /* Set update_mode_lines only if buffer is displayed in some window.
1387 Packages like jit-lock or lazy-lock preserve a buffer's modified
1388 state by recording/restoring the state around blocks of code.
1389 Setting update_mode_lines makes redisplay consider all windows
1390 (on all frames). Stealth fontification of buffers not displayed
1391 would incur additional redisplay costs if we'd set
1392 update_modes_lines unconditionally.
1394 Ideally, I think there should be another mechanism for fontifying
1395 buffers without "modifying" buffers, or redisplay should be
1396 smarter about updating the `*' in mode lines. --gerd */
1397 if (buffer_window_count (current_buffer))
1399 ++update_mode_lines;
1400 current_buffer->prevent_redisplay_optimizations_p = 1;
1403 return flag;
1406 DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p,
1407 Srestore_buffer_modified_p, 1, 1, 0,
1408 doc: /* Like `set-buffer-modified-p', with a difference concerning redisplay.
1409 It is not ensured that mode lines will be updated to show the modified
1410 state of the current buffer. Use with care. */)
1411 (Lisp_Object flag)
1413 #ifdef CLASH_DETECTION
1414 Lisp_Object fn;
1416 /* If buffer becoming modified, lock the file.
1417 If buffer becoming unmodified, unlock the file. */
1419 fn = BVAR (current_buffer, file_truename);
1420 /* Test buffer-file-name so that binding it to nil is effective. */
1421 if (!NILP (fn) && ! NILP (BVAR (current_buffer, filename)))
1423 bool already = SAVE_MODIFF < MODIFF;
1424 if (!already && !NILP (flag))
1425 lock_file (fn);
1426 else if (already && NILP (flag))
1427 unlock_file (fn);
1429 #endif /* CLASH_DETECTION */
1431 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1432 return flag;
1435 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick, Sbuffer_modified_tick,
1436 0, 1, 0,
1437 doc: /* Return BUFFER's tick counter, incremented for each change in text.
1438 Each buffer has a tick counter which is incremented each time the
1439 text in that buffer is changed. It wraps around occasionally.
1440 No argument or nil as argument means use current buffer as BUFFER. */)
1441 (register Lisp_Object buffer)
1443 register struct buffer *buf;
1444 if (NILP (buffer))
1445 buf = current_buffer;
1446 else
1448 CHECK_BUFFER (buffer);
1449 buf = XBUFFER (buffer);
1452 return make_number (BUF_MODIFF (buf));
1455 DEFUN ("buffer-chars-modified-tick", Fbuffer_chars_modified_tick,
1456 Sbuffer_chars_modified_tick, 0, 1, 0,
1457 doc: /* Return BUFFER's character-change tick counter.
1458 Each buffer has a character-change tick counter, which is set to the
1459 value of the buffer's tick counter \(see `buffer-modified-tick'), each
1460 time text in that buffer is inserted or deleted. By comparing the
1461 values returned by two individual calls of `buffer-chars-modified-tick',
1462 you can tell whether a character change occurred in that buffer in
1463 between these calls. No argument or nil as argument means use current
1464 buffer as BUFFER. */)
1465 (register Lisp_Object buffer)
1467 register struct buffer *buf;
1468 if (NILP (buffer))
1469 buf = current_buffer;
1470 else
1472 CHECK_BUFFER (buffer);
1473 buf = XBUFFER (buffer);
1476 return make_number (BUF_CHARS_MODIFF (buf));
1479 DEFUN ("rename-buffer", Frename_buffer, Srename_buffer, 1, 2,
1480 "(list (read-string \"Rename buffer (to new name): \" \
1481 nil 'buffer-name-history (buffer-name (current-buffer))) \
1482 current-prefix-arg)",
1483 doc: /* Change current buffer's name to NEWNAME (a string).
1484 If second arg UNIQUE is nil or omitted, it is an error if a
1485 buffer named NEWNAME already exists.
1486 If UNIQUE is non-nil, come up with a new name using
1487 `generate-new-buffer-name'.
1488 Interactively, you can set UNIQUE with a prefix argument.
1489 We return the name we actually gave the buffer.
1490 This does not change the name of the visited file (if any). */)
1491 (register Lisp_Object newname, Lisp_Object unique)
1493 register Lisp_Object tem, buf;
1495 CHECK_STRING (newname);
1497 if (SCHARS (newname) == 0)
1498 error ("Empty string is invalid as a buffer name");
1500 tem = Fget_buffer (newname);
1501 if (!NILP (tem))
1503 /* Don't short-circuit if UNIQUE is t. That is a useful way to
1504 rename the buffer automatically so you can create another
1505 with the original name. It makes UNIQUE equivalent to
1506 (rename-buffer (generate-new-buffer-name NEWNAME)). */
1507 if (NILP (unique) && XBUFFER (tem) == current_buffer)
1508 return BVAR (current_buffer, name);
1509 if (!NILP (unique))
1510 newname = Fgenerate_new_buffer_name (newname, BVAR (current_buffer, name));
1511 else
1512 error ("Buffer name `%s' is in use", SDATA (newname));
1515 bset_name (current_buffer, newname);
1517 /* Catch redisplay's attention. Unless we do this, the mode lines for
1518 any windows displaying current_buffer will stay unchanged. */
1519 update_mode_lines++;
1521 XSETBUFFER (buf, current_buffer);
1522 Fsetcar (Frassq (buf, Vbuffer_alist), newname);
1523 if (NILP (BVAR (current_buffer, filename))
1524 && !NILP (BVAR (current_buffer, auto_save_file_name)))
1525 call0 (intern ("rename-auto-save-file"));
1527 /* Run buffer-list-update-hook. */
1528 if (!NILP (Vrun_hooks))
1529 call1 (Vrun_hooks, Qbuffer_list_update_hook);
1531 /* Refetch since that last call may have done GC. */
1532 return BVAR (current_buffer, name);
1535 /* True if B can be used as 'other-than-BUFFER' buffer. */
1537 static bool
1538 candidate_buffer (Lisp_Object b, Lisp_Object buffer)
1540 return (BUFFERP (b) && !EQ (b, buffer)
1541 && BUFFER_LIVE_P (XBUFFER (b))
1542 && !BUFFER_HIDDEN_P (XBUFFER (b)));
1545 DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 3, 0,
1546 doc: /* Return most recently selected buffer other than BUFFER.
1547 Buffers not visible in windows are preferred to visible buffers, unless
1548 optional second argument VISIBLE-OK is non-nil. Ignore the argument
1549 BUFFER unless it denotes a live buffer. If the optional third argument
1550 FRAME is non-nil, use that frame's buffer list instead of the selected
1551 frame's buffer list.
1553 The buffer is found by scanning the selected or specified frame's buffer
1554 list first, followed by the list of all buffers. If no other buffer
1555 exists, return the buffer `*scratch*' (creating it if necessary). */)
1556 (register Lisp_Object buffer, Lisp_Object visible_ok, Lisp_Object frame)
1558 struct frame *f = decode_any_frame (frame);
1559 Lisp_Object tail = f->buffer_list, pred = f->buffer_predicate;
1560 Lisp_Object buf, notsogood = Qnil;
1562 /* Consider buffers that have been seen in the frame first. */
1563 for (; CONSP (tail); tail = XCDR (tail))
1565 buf = XCAR (tail);
1566 if (candidate_buffer (buf, buffer)
1567 /* If the frame has a buffer_predicate, disregard buffers that
1568 don't fit the predicate. */
1569 && (NILP (pred) || !NILP (call1 (pred, buf))))
1571 if (!NILP (visible_ok)
1572 || NILP (Fget_buffer_window (buf, Qvisible)))
1573 return buf;
1574 else if (NILP (notsogood))
1575 notsogood = buf;
1579 /* Consider alist of all buffers next. */
1580 tail = Vbuffer_alist;
1581 for (; CONSP (tail); tail = XCDR (tail))
1583 buf = Fcdr (XCAR (tail));
1584 if (candidate_buffer (buf, buffer)
1585 /* If the frame has a buffer_predicate, disregard buffers that
1586 don't fit the predicate. */
1587 && (NILP (pred) || !NILP (call1 (pred, buf))))
1589 if (!NILP (visible_ok)
1590 || NILP (Fget_buffer_window (buf, Qvisible)))
1591 return buf;
1592 else if (NILP (notsogood))
1593 notsogood = buf;
1597 if (!NILP (notsogood))
1598 return notsogood;
1599 else
1601 buf = Fget_buffer (build_string ("*scratch*"));
1602 if (NILP (buf))
1604 buf = Fget_buffer_create (build_string ("*scratch*"));
1605 Fset_buffer_major_mode (buf);
1607 return buf;
1611 /* The following function is a safe variant of Fother_buffer: It doesn't
1612 pay attention to any frame-local buffer lists, doesn't care about
1613 visibility of buffers, and doesn't evaluate any frame predicates. */
1615 Lisp_Object
1616 other_buffer_safely (Lisp_Object buffer)
1618 Lisp_Object tail, buf;
1620 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
1622 buf = Fcdr (XCAR (tail));
1623 if (candidate_buffer (buf, buffer))
1624 return buf;
1627 buf = Fget_buffer (build_string ("*scratch*"));
1628 if (NILP (buf))
1630 buf = Fget_buffer_create (build_string ("*scratch*"));
1631 Fset_buffer_major_mode (buf);
1634 return buf;
1637 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo, Sbuffer_enable_undo,
1638 0, 1, "",
1639 doc: /* Start keeping undo information for buffer BUFFER.
1640 No argument or nil as argument means do this for the current buffer. */)
1641 (register Lisp_Object buffer)
1643 Lisp_Object real_buffer;
1645 if (NILP (buffer))
1646 XSETBUFFER (real_buffer, current_buffer);
1647 else
1649 real_buffer = Fget_buffer (buffer);
1650 if (NILP (real_buffer))
1651 nsberror (buffer);
1654 if (EQ (BVAR (XBUFFER (real_buffer), undo_list), Qt))
1655 bset_undo_list (XBUFFER (real_buffer), Qnil);
1657 return Qnil;
1660 /* Truncate undo list and shrink the gap of BUFFER. */
1662 void
1663 compact_buffer (struct buffer *buffer)
1665 BUFFER_CHECK_INDIRECTION (buffer);
1667 /* Skip dead buffers, indirect buffers and buffers
1668 which aren't changed since last compaction. */
1669 if (BUFFER_LIVE_P (buffer)
1670 && (buffer->base_buffer == NULL)
1671 && (BUF_COMPACT (buffer) != BUF_MODIFF (buffer)))
1673 /* If a buffer's undo list is Qt, that means that undo is
1674 turned off in that buffer. Calling truncate_undo_list on
1675 Qt tends to return NULL, which effectively turns undo back on.
1676 So don't call truncate_undo_list if undo_list is Qt. */
1677 if (!EQ (buffer->INTERNAL_FIELD (undo_list), Qt))
1678 truncate_undo_list (buffer);
1680 /* Shrink buffer gaps. */
1681 if (!buffer->text->inhibit_shrinking)
1683 /* If a buffer's gap size is more than 10% of the buffer
1684 size, or larger than 2000 bytes, then shrink it
1685 accordingly. Keep a minimum size of 20 bytes. */
1686 int size = min (2000, max (20, (buffer->text->z_byte / 10)));
1688 if (buffer->text->gap_size > size)
1690 struct buffer *save_current = current_buffer;
1691 current_buffer = buffer;
1692 make_gap (-(buffer->text->gap_size - size));
1693 current_buffer = save_current;
1696 BUF_COMPACT (buffer) = BUF_MODIFF (buffer);
1700 DEFUN ("kill-buffer", Fkill_buffer, Skill_buffer, 0, 1, "bKill buffer: ",
1701 doc: /* Kill the buffer specified by BUFFER-OR-NAME.
1702 The argument may be a buffer or the name of an existing buffer.
1703 Argument nil or omitted means kill the current buffer. Return t if the
1704 buffer is actually killed, nil otherwise.
1706 The functions in `kill-buffer-query-functions' are called with the
1707 buffer to be killed as the current buffer. If any of them returns nil,
1708 the buffer is not killed. The hook `kill-buffer-hook' is run before the
1709 buffer is actually killed. The buffer being killed will be current
1710 while the hook is running. Functions called by any of these hooks are
1711 supposed to not change the current buffer.
1713 Any processes that have this buffer as the `process-buffer' are killed
1714 with SIGHUP. This function calls `replace-buffer-in-windows' for
1715 cleaning up all windows currently displaying the buffer to be killed. */)
1716 (Lisp_Object buffer_or_name)
1718 Lisp_Object buffer;
1719 register struct buffer *b;
1720 register Lisp_Object tem;
1721 register struct Lisp_Marker *m;
1722 struct gcpro gcpro1;
1724 if (NILP (buffer_or_name))
1725 buffer = Fcurrent_buffer ();
1726 else
1727 buffer = Fget_buffer (buffer_or_name);
1728 if (NILP (buffer))
1729 nsberror (buffer_or_name);
1731 b = XBUFFER (buffer);
1733 /* Avoid trouble for buffer already dead. */
1734 if (!BUFFER_LIVE_P (b))
1735 return Qnil;
1737 /* Query if the buffer is still modified. */
1738 if (INTERACTIVE && !NILP (BVAR (b, filename))
1739 && BUF_MODIFF (b) > BUF_SAVE_MODIFF (b))
1741 GCPRO1 (buffer);
1742 tem = do_yes_or_no_p (format2 ("Buffer %s modified; kill anyway? ",
1743 BVAR (b, name), make_number (0)));
1744 UNGCPRO;
1745 if (NILP (tem))
1746 return Qnil;
1749 /* Run hooks with the buffer to be killed the current buffer. */
1751 ptrdiff_t count = SPECPDL_INDEX ();
1752 Lisp_Object arglist[1];
1754 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1755 set_buffer_internal (b);
1757 /* First run the query functions; if any query is answered no,
1758 don't kill the buffer. */
1759 arglist[0] = Qkill_buffer_query_functions;
1760 tem = Frun_hook_with_args_until_failure (1, arglist);
1761 if (NILP (tem))
1762 return unbind_to (count, Qnil);
1764 /* Then run the hooks. */
1765 Frun_hooks (1, &Qkill_buffer_hook);
1766 unbind_to (count, Qnil);
1769 /* If the hooks have killed the buffer, exit now. */
1770 if (!BUFFER_LIVE_P (b))
1771 return Qt;
1773 /* We have no more questions to ask. Verify that it is valid
1774 to kill the buffer. This must be done after the questions
1775 since anything can happen within do_yes_or_no_p. */
1777 /* Don't kill the minibuffer now current. */
1778 if (EQ (buffer, XWINDOW (minibuf_window)->buffer))
1779 return Qnil;
1781 /* When we kill an ordinary buffer which shares it's buffer text
1782 with indirect buffer(s), we must kill indirect buffer(s) too.
1783 We do it at this stage so nothing terrible happens if they
1784 ask questions or their hooks get errors. */
1785 if (!b->base_buffer && b->indirections > 0)
1787 struct buffer *other;
1789 GCPRO1 (buffer);
1791 FOR_EACH_BUFFER (other)
1792 if (other->base_buffer == b)
1794 Lisp_Object buf;
1795 XSETBUFFER (buf, other);
1796 Fkill_buffer (buf);
1799 UNGCPRO;
1801 /* Exit if we now have killed the base buffer (Bug#11665). */
1802 if (!BUFFER_LIVE_P (b))
1803 return Qt;
1806 /* Run replace_buffer_in_windows before making another buffer current
1807 since set-window-buffer-start-and-point will refuse to make another
1808 buffer current if the selected window does not show the current
1809 buffer. (Bug#10114) */
1810 replace_buffer_in_windows (buffer);
1812 /* Exit if replacing the buffer in windows has killed our buffer. */
1813 if (!BUFFER_LIVE_P (b))
1814 return Qt;
1816 /* Make this buffer not be current. Exit if it is the sole visible
1817 buffer. */
1818 if (b == current_buffer)
1820 tem = Fother_buffer (buffer, Qnil, Qnil);
1821 Fset_buffer (tem);
1822 if (b == current_buffer)
1823 return Qnil;
1826 /* If the buffer now current is shown in the minibuffer and our buffer
1827 is the sole other buffer give up. */
1828 XSETBUFFER (tem, current_buffer);
1829 if (EQ (tem, XWINDOW (minibuf_window)->buffer)
1830 && EQ (buffer, Fother_buffer (buffer, Qnil, Qnil)))
1831 return Qnil;
1833 /* Now there is no question: we can kill the buffer. */
1835 #ifdef CLASH_DETECTION
1836 /* Unlock this buffer's file, if it is locked. */
1837 unlock_buffer (b);
1838 #endif /* CLASH_DETECTION */
1840 GCPRO1 (buffer);
1841 kill_buffer_processes (buffer);
1842 UNGCPRO;
1844 /* Killing buffer processes may run sentinels which may have killed
1845 our buffer. */
1846 if (!BUFFER_LIVE_P (b))
1847 return Qt;
1849 /* These may run Lisp code and into infinite loops (if someone
1850 insisted on circular lists) so allow quitting here. */
1851 frames_discard_buffer (buffer);
1853 clear_charpos_cache (b);
1855 tem = Vinhibit_quit;
1856 Vinhibit_quit = Qt;
1857 /* Remove the buffer from the list of all buffers. */
1858 Vbuffer_alist = Fdelq (Frassq (buffer, Vbuffer_alist), Vbuffer_alist);
1859 /* If replace_buffer_in_windows didn't do its job fix that now. */
1860 replace_buffer_in_windows_safely (buffer);
1861 Vinhibit_quit = tem;
1863 /* Delete any auto-save file, if we saved it in this session.
1864 But not if the buffer is modified. */
1865 if (STRINGP (BVAR (b, auto_save_file_name))
1866 && BUF_AUTOSAVE_MODIFF (b) != 0
1867 && BUF_SAVE_MODIFF (b) < BUF_AUTOSAVE_MODIFF (b)
1868 && BUF_SAVE_MODIFF (b) < BUF_MODIFF (b)
1869 && NILP (Fsymbol_value (intern ("auto-save-visited-file-name"))))
1871 Lisp_Object delete;
1872 delete = Fsymbol_value (intern ("delete-auto-save-files"));
1873 if (! NILP (delete))
1874 internal_delete_file (BVAR (b, auto_save_file_name));
1877 /* Deleting an auto-save file could have killed our buffer. */
1878 if (!BUFFER_LIVE_P (b))
1879 return Qt;
1881 if (b->base_buffer)
1883 /* Unchain all markers that belong to this indirect buffer.
1884 Don't unchain the markers that belong to the base buffer
1885 or its other indirect buffers. */
1886 struct Lisp_Marker **mp = &BUF_MARKERS (b);
1887 while ((m = *mp))
1889 if (m->buffer == b)
1891 m->buffer = NULL;
1892 *mp = m->next;
1894 else
1895 mp = &m->next;
1898 else
1900 /* Unchain all markers of this buffer and its indirect buffers.
1901 and leave them pointing nowhere. */
1902 for (m = BUF_MARKERS (b); m; )
1904 struct Lisp_Marker *next = m->next;
1905 m->buffer = 0;
1906 m->next = NULL;
1907 m = next;
1909 BUF_MARKERS (b) = NULL;
1910 set_buffer_intervals (b, NULL);
1912 /* Perhaps we should explicitly free the interval tree here... */
1914 /* Since we've unlinked the markers, the overlays can't be here any more
1915 either. */
1916 b->overlays_before = NULL;
1917 b->overlays_after = NULL;
1919 /* Reset the local variables, so that this buffer's local values
1920 won't be protected from GC. They would be protected
1921 if they happened to remain cached in their symbols.
1922 This gets rid of them for certain. */
1923 swap_out_buffer_local_variables (b);
1924 reset_buffer_local_variables (b, 1);
1926 bset_name (b, Qnil);
1928 block_input ();
1929 if (b->base_buffer)
1931 /* Notify our base buffer that we don't share the text anymore. */
1932 eassert (b->indirections == -1);
1933 b->base_buffer->indirections--;
1934 eassert (b->base_buffer->indirections >= 0);
1935 /* Make sure that we wasn't confused. */
1936 eassert (b->window_count == -1);
1938 else
1940 /* Make sure that no one shows us. */
1941 eassert (b->window_count == 0);
1942 /* No one shares our buffer text, can free it. */
1943 free_buffer_text (b);
1946 if (b->newline_cache)
1948 free_region_cache (b->newline_cache);
1949 b->newline_cache = 0;
1951 if (b->width_run_cache)
1953 free_region_cache (b->width_run_cache);
1954 b->width_run_cache = 0;
1956 bset_width_table (b, Qnil);
1957 unblock_input ();
1958 bset_undo_list (b, Qnil);
1960 /* Run buffer-list-update-hook. */
1961 if (!NILP (Vrun_hooks))
1962 call1 (Vrun_hooks, Qbuffer_list_update_hook);
1964 return Qt;
1967 /* Move association for BUFFER to the front of buffer (a)lists. Since
1968 we do this each time BUFFER is selected visibly, the more recently
1969 selected buffers are always closer to the front of those lists. This
1970 means that other_buffer is more likely to choose a relevant buffer.
1972 Note that this moves BUFFER to the front of the buffer lists of the
1973 selected frame even if BUFFER is not shown there. If BUFFER is not
1974 shown in the selected frame, consider the present behavior a feature.
1975 `select-window' gets this right since it shows BUFFER in the selected
1976 window when calling us. */
1978 void
1979 record_buffer (Lisp_Object buffer)
1981 Lisp_Object aelt, aelt_cons, tem;
1982 register struct frame *f = XFRAME (selected_frame);
1984 CHECK_BUFFER (buffer);
1986 /* Update Vbuffer_alist (we know that it has an entry for BUFFER).
1987 Don't allow quitting since this might leave the buffer list in an
1988 inconsistent state. */
1989 tem = Vinhibit_quit;
1990 Vinhibit_quit = Qt;
1991 aelt = Frassq (buffer, Vbuffer_alist);
1992 aelt_cons = Fmemq (aelt, Vbuffer_alist);
1993 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
1994 XSETCDR (aelt_cons, Vbuffer_alist);
1995 Vbuffer_alist = aelt_cons;
1996 Vinhibit_quit = tem;
1998 /* Update buffer list of selected frame. */
1999 fset_buffer_list (f, Fcons (buffer, Fdelq (buffer, f->buffer_list)));
2000 fset_buried_buffer_list (f, Fdelq (buffer, f->buried_buffer_list));
2002 /* Run buffer-list-update-hook. */
2003 if (!NILP (Vrun_hooks))
2004 call1 (Vrun_hooks, Qbuffer_list_update_hook);
2008 /* Move BUFFER to the end of the buffer (a)lists. Do nothing if the
2009 buffer is killed. For the selected frame's buffer list this moves
2010 BUFFER to its end even if it was never shown in that frame. If
2011 this happens we have a feature, hence `bury-buffer-internal' should be
2012 called only when BUFFER was shown in the selected frame. */
2014 DEFUN ("bury-buffer-internal", Fbury_buffer_internal, Sbury_buffer_internal,
2015 1, 1, 0,
2016 doc: /* Move BUFFER to the end of the buffer list. */)
2017 (Lisp_Object buffer)
2019 Lisp_Object aelt, aelt_cons, tem;
2020 register struct frame *f = XFRAME (selected_frame);
2022 CHECK_BUFFER (buffer);
2024 /* Update Vbuffer_alist (we know that it has an entry for BUFFER).
2025 Don't allow quitting since this might leave the buffer list in an
2026 inconsistent state. */
2027 tem = Vinhibit_quit;
2028 Vinhibit_quit = Qt;
2029 aelt = Frassq (buffer, Vbuffer_alist);
2030 aelt_cons = Fmemq (aelt, Vbuffer_alist);
2031 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
2032 XSETCDR (aelt_cons, Qnil);
2033 Vbuffer_alist = nconc2 (Vbuffer_alist, aelt_cons);
2034 Vinhibit_quit = tem;
2036 /* Update buffer lists of selected frame. */
2037 fset_buffer_list (f, Fdelq (buffer, f->buffer_list));
2038 fset_buried_buffer_list
2039 (f, Fcons (buffer, Fdelq (buffer, f->buried_buffer_list)));
2041 /* Run buffer-list-update-hook. */
2042 if (!NILP (Vrun_hooks))
2043 call1 (Vrun_hooks, Qbuffer_list_update_hook);
2045 return Qnil;
2048 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode, Sset_buffer_major_mode, 1, 1, 0,
2049 doc: /* Set an appropriate major mode for BUFFER.
2050 For the *scratch* buffer, use `initial-major-mode', otherwise choose a mode
2051 according to the default value of `major-mode'.
2052 Use this function before selecting the buffer, since it may need to inspect
2053 the current buffer's major mode. */)
2054 (Lisp_Object buffer)
2056 ptrdiff_t count;
2057 Lisp_Object function;
2059 CHECK_BUFFER (buffer);
2061 if (!BUFFER_LIVE_P (XBUFFER (buffer)))
2062 error ("Attempt to set major mode for a dead buffer");
2064 if (strcmp (SSDATA (BVAR (XBUFFER (buffer), name)), "*scratch*") == 0)
2065 function = find_symbol_value (intern ("initial-major-mode"));
2066 else
2068 function = BVAR (&buffer_defaults, major_mode);
2069 if (NILP (function)
2070 && NILP (Fget (BVAR (current_buffer, major_mode), Qmode_class)))
2071 function = BVAR (current_buffer, major_mode);
2074 if (NILP (function) || EQ (function, Qfundamental_mode))
2075 return Qnil;
2077 count = SPECPDL_INDEX ();
2079 /* To select a nonfundamental mode,
2080 select the buffer temporarily and then call the mode function. */
2082 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2084 Fset_buffer (buffer);
2085 call0 (function);
2087 return unbind_to (count, Qnil);
2090 DEFUN ("current-buffer", Fcurrent_buffer, Scurrent_buffer, 0, 0, 0,
2091 doc: /* Return the current buffer as a Lisp object. */)
2092 (void)
2094 register Lisp_Object buf;
2095 XSETBUFFER (buf, current_buffer);
2096 return buf;
2099 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
2100 This is used by redisplay. */
2102 void
2103 set_buffer_internal_1 (register struct buffer *b)
2105 register struct buffer *old_buf;
2106 register Lisp_Object tail;
2108 #ifdef USE_MMAP_FOR_BUFFERS
2109 if (b->text->beg == NULL)
2110 enlarge_buffer_text (b, 0);
2111 #endif /* USE_MMAP_FOR_BUFFERS */
2113 if (current_buffer == b)
2114 return;
2116 BUFFER_CHECK_INDIRECTION (b);
2118 old_buf = current_buffer;
2119 current_buffer = b;
2120 last_known_column_point = -1; /* invalidate indentation cache */
2122 if (old_buf)
2124 /* Put the undo list back in the base buffer, so that it appears
2125 that an indirect buffer shares the undo list of its base. */
2126 if (old_buf->base_buffer)
2127 bset_undo_list (old_buf->base_buffer, BVAR (old_buf, undo_list));
2129 /* If the old current buffer has markers to record PT, BEGV and ZV
2130 when it is not current, update them now. */
2131 record_buffer_markers (old_buf);
2134 /* Get the undo list from the base buffer, so that it appears
2135 that an indirect buffer shares the undo list of its base. */
2136 if (b->base_buffer)
2137 bset_undo_list (b, BVAR (b->base_buffer, undo_list));
2139 /* If the new current buffer has markers to record PT, BEGV and ZV
2140 when it is not current, fetch them now. */
2141 fetch_buffer_markers (b);
2143 /* Look down buffer's list of local Lisp variables
2144 to find and update any that forward into C variables. */
2148 for (tail = BVAR (b, local_var_alist); CONSP (tail); tail = XCDR (tail))
2150 Lisp_Object var = XCAR (XCAR (tail));
2151 struct Lisp_Symbol *sym = XSYMBOL (var);
2152 if (sym->redirect == SYMBOL_LOCALIZED /* Just to be sure. */
2153 && SYMBOL_BLV (sym)->fwd)
2154 /* Just reference the variable
2155 to cause it to become set for this buffer. */
2156 Fsymbol_value (var);
2159 /* Do the same with any others that were local to the previous buffer */
2160 while (b != old_buf && (b = old_buf, b));
2163 /* Switch to buffer B temporarily for redisplay purposes.
2164 This avoids certain things that don't need to be done within redisplay. */
2166 void
2167 set_buffer_temp (struct buffer *b)
2169 register struct buffer *old_buf;
2171 if (current_buffer == b)
2172 return;
2174 old_buf = current_buffer;
2175 current_buffer = b;
2177 /* If the old current buffer has markers to record PT, BEGV and ZV
2178 when it is not current, update them now. */
2179 record_buffer_markers (old_buf);
2181 /* If the new current buffer has markers to record PT, BEGV and ZV
2182 when it is not current, fetch them now. */
2183 fetch_buffer_markers (b);
2186 DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
2187 doc: /* Make buffer BUFFER-OR-NAME current for editing operations.
2188 BUFFER-OR-NAME may be a buffer or the name of an existing buffer. See
2189 also `with-current-buffer' when you want to make a buffer current
2190 temporarily. This function does not display the buffer, so its effect
2191 ends when the current command terminates. Use `switch-to-buffer' or
2192 `pop-to-buffer' to switch buffers permanently. */)
2193 (register Lisp_Object buffer_or_name)
2195 register Lisp_Object buffer;
2196 buffer = Fget_buffer (buffer_or_name);
2197 if (NILP (buffer))
2198 nsberror (buffer_or_name);
2199 if (!BUFFER_LIVE_P (XBUFFER (buffer)))
2200 error ("Selecting deleted buffer");
2201 set_buffer_internal (XBUFFER (buffer));
2202 return buffer;
2205 /* Set the current buffer to BUFFER provided if it is alive. */
2207 Lisp_Object
2208 set_buffer_if_live (Lisp_Object buffer)
2210 if (BUFFER_LIVE_P (XBUFFER (buffer)))
2211 set_buffer_internal (XBUFFER (buffer));
2212 return Qnil;
2215 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only,
2216 Sbarf_if_buffer_read_only, 0, 0, 0,
2217 doc: /* Signal a `buffer-read-only' error if the current buffer is read-only. */)
2218 (void)
2220 if (!NILP (BVAR (current_buffer, read_only))
2221 && NILP (Vinhibit_read_only))
2222 xsignal1 (Qbuffer_read_only, Fcurrent_buffer ());
2223 return Qnil;
2226 DEFUN ("erase-buffer", Ferase_buffer, Serase_buffer, 0, 0, "*",
2227 doc: /* Delete the entire contents of the current buffer.
2228 Any narrowing restriction in effect (see `narrow-to-region') is removed,
2229 so the buffer is truly empty after this. */)
2230 (void)
2232 Fwiden ();
2234 del_range (BEG, Z);
2236 current_buffer->last_window_start = 1;
2237 /* Prevent warnings, or suspension of auto saving, that would happen
2238 if future size is less than past size. Use of erase-buffer
2239 implies that the future text is not really related to the past text. */
2240 XSETFASTINT (BVAR (current_buffer, save_length), 0);
2241 return Qnil;
2244 void
2245 validate_region (register Lisp_Object *b, register Lisp_Object *e)
2247 CHECK_NUMBER_COERCE_MARKER (*b);
2248 CHECK_NUMBER_COERCE_MARKER (*e);
2250 if (XINT (*b) > XINT (*e))
2252 Lisp_Object tem;
2253 tem = *b; *b = *e; *e = tem;
2256 if (! (BEGV <= XINT (*b) && XINT (*e) <= ZV))
2257 args_out_of_range (*b, *e);
2260 /* Advance BYTE_POS up to a character boundary
2261 and return the adjusted position. */
2263 static ptrdiff_t
2264 advance_to_char_boundary (ptrdiff_t byte_pos)
2266 int c;
2268 if (byte_pos == BEG)
2269 /* Beginning of buffer is always a character boundary. */
2270 return BEG;
2272 c = FETCH_BYTE (byte_pos);
2273 if (! CHAR_HEAD_P (c))
2275 /* We should advance BYTE_POS only when C is a constituent of a
2276 multibyte sequence. */
2277 ptrdiff_t orig_byte_pos = byte_pos;
2281 byte_pos--;
2282 c = FETCH_BYTE (byte_pos);
2284 while (! CHAR_HEAD_P (c) && byte_pos > BEG);
2285 INC_POS (byte_pos);
2286 if (byte_pos < orig_byte_pos)
2287 byte_pos = orig_byte_pos;
2288 /* If C is a constituent of a multibyte sequence, BYTE_POS was
2289 surely advance to the correct character boundary. If C is
2290 not, BYTE_POS was unchanged. */
2293 return byte_pos;
2296 DEFUN ("buffer-swap-text", Fbuffer_swap_text, Sbuffer_swap_text,
2297 1, 1, 0,
2298 doc: /* Swap the text between current buffer and BUFFER. */)
2299 (Lisp_Object buffer)
2301 struct buffer *other_buffer;
2302 CHECK_BUFFER (buffer);
2303 other_buffer = XBUFFER (buffer);
2305 if (!BUFFER_LIVE_P (other_buffer))
2306 error ("Cannot swap a dead buffer's text");
2308 /* Actually, it probably works just fine.
2309 * if (other_buffer == current_buffer)
2310 * error ("Cannot swap a buffer's text with itself"); */
2312 /* Actually, this may be workable as well, tho probably only if they're
2313 *both* indirect. */
2314 if (other_buffer->base_buffer
2315 || current_buffer->base_buffer)
2316 error ("Cannot swap indirect buffers's text");
2318 { /* This is probably harder to make work. */
2319 struct buffer *other;
2320 FOR_EACH_BUFFER (other)
2321 if (other->base_buffer == other_buffer
2322 || other->base_buffer == current_buffer)
2323 error ("One of the buffers to swap has indirect buffers");
2326 #define swapfield(field, type) \
2327 do { \
2328 type tmp##field = other_buffer->field; \
2329 other_buffer->field = current_buffer->field; \
2330 current_buffer->field = tmp##field; \
2331 } while (0)
2332 #define swapfield_(field, type) \
2333 do { \
2334 type tmp##field = BVAR (other_buffer, field); \
2335 bset_##field (other_buffer, BVAR (current_buffer, field)); \
2336 bset_##field (current_buffer, tmp##field); \
2337 } while (0)
2339 swapfield (own_text, struct buffer_text);
2340 eassert (current_buffer->text == &current_buffer->own_text);
2341 eassert (other_buffer->text == &other_buffer->own_text);
2342 #ifdef REL_ALLOC
2343 r_alloc_reset_variable ((void **) &current_buffer->own_text.beg,
2344 (void **) &other_buffer->own_text.beg);
2345 r_alloc_reset_variable ((void **) &other_buffer->own_text.beg,
2346 (void **) &current_buffer->own_text.beg);
2347 #endif /* REL_ALLOC */
2349 swapfield (pt, ptrdiff_t);
2350 swapfield (pt_byte, ptrdiff_t);
2351 swapfield (begv, ptrdiff_t);
2352 swapfield (begv_byte, ptrdiff_t);
2353 swapfield (zv, ptrdiff_t);
2354 swapfield (zv_byte, ptrdiff_t);
2355 eassert (!current_buffer->base_buffer);
2356 eassert (!other_buffer->base_buffer);
2357 swapfield (indirections, ptrdiff_t);
2358 current_buffer->clip_changed = 1; other_buffer->clip_changed = 1;
2359 swapfield (newline_cache, struct region_cache *);
2360 swapfield (width_run_cache, struct region_cache *);
2361 current_buffer->prevent_redisplay_optimizations_p = 1;
2362 other_buffer->prevent_redisplay_optimizations_p = 1;
2363 swapfield (overlays_before, struct Lisp_Overlay *);
2364 swapfield (overlays_after, struct Lisp_Overlay *);
2365 swapfield (overlay_center, ptrdiff_t);
2366 swapfield_ (undo_list, Lisp_Object);
2367 swapfield_ (mark, Lisp_Object);
2368 swapfield_ (enable_multibyte_characters, Lisp_Object);
2369 swapfield_ (bidi_display_reordering, Lisp_Object);
2370 swapfield_ (bidi_paragraph_direction, Lisp_Object);
2371 /* FIXME: Not sure what we should do with these *_marker fields.
2372 Hopefully they're just nil anyway. */
2373 swapfield_ (pt_marker, Lisp_Object);
2374 swapfield_ (begv_marker, Lisp_Object);
2375 swapfield_ (zv_marker, Lisp_Object);
2376 bset_point_before_scroll (current_buffer, Qnil);
2377 bset_point_before_scroll (other_buffer, Qnil);
2379 current_buffer->text->modiff++; other_buffer->text->modiff++;
2380 current_buffer->text->chars_modiff++; other_buffer->text->chars_modiff++;
2381 current_buffer->text->overlay_modiff++; other_buffer->text->overlay_modiff++;
2382 current_buffer->text->beg_unchanged = current_buffer->text->gpt;
2383 current_buffer->text->end_unchanged = current_buffer->text->gpt;
2384 other_buffer->text->beg_unchanged = other_buffer->text->gpt;
2385 other_buffer->text->end_unchanged = other_buffer->text->gpt;
2387 struct Lisp_Marker *m;
2388 for (m = BUF_MARKERS (current_buffer); m; m = m->next)
2389 if (m->buffer == other_buffer)
2390 m->buffer = current_buffer;
2391 else
2392 /* Since there's no indirect buffer in sight, markers on
2393 BUF_MARKERS(buf) should either be for `buf' or dead. */
2394 eassert (!m->buffer);
2395 for (m = BUF_MARKERS (other_buffer); m; m = m->next)
2396 if (m->buffer == current_buffer)
2397 m->buffer = other_buffer;
2398 else
2399 /* Since there's no indirect buffer in sight, markers on
2400 BUF_MARKERS(buf) should either be for `buf' or dead. */
2401 eassert (!m->buffer);
2403 { /* Some of the C code expects that w->buffer == w->pointm->buffer.
2404 So since we just swapped the markers between the two buffers, we need
2405 to undo the effect of this swap for window markers. */
2406 Lisp_Object w = Fselected_window (), ws = Qnil;
2407 Lisp_Object buf1, buf2;
2408 XSETBUFFER (buf1, current_buffer); XSETBUFFER (buf2, other_buffer);
2410 while (NILP (Fmemq (w, ws)))
2412 ws = Fcons (w, ws);
2413 if (MARKERP (XWINDOW (w)->pointm)
2414 && (EQ (XWINDOW (w)->buffer, buf1)
2415 || EQ (XWINDOW (w)->buffer, buf2)))
2416 Fset_marker (XWINDOW (w)->pointm,
2417 make_number
2418 (BUF_BEGV (XBUFFER (XWINDOW (w)->buffer))),
2419 XWINDOW (w)->buffer);
2420 w = Fnext_window (w, Qt, Qt);
2424 if (current_buffer->text->intervals)
2425 (eassert (EQ (current_buffer->text->intervals->up.obj, buffer)),
2426 XSETBUFFER (current_buffer->text->intervals->up.obj, current_buffer));
2427 if (other_buffer->text->intervals)
2428 (eassert (EQ (other_buffer->text->intervals->up.obj, Fcurrent_buffer ())),
2429 XSETBUFFER (other_buffer->text->intervals->up.obj, other_buffer));
2431 return Qnil;
2434 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte, Sset_buffer_multibyte,
2435 1, 1, 0,
2436 doc: /* Set the multibyte flag of the current buffer to FLAG.
2437 If FLAG is t, this makes the buffer a multibyte buffer.
2438 If FLAG is nil, this makes the buffer a single-byte buffer.
2439 In these cases, the buffer contents remain unchanged as a sequence of
2440 bytes but the contents viewed as characters do change.
2441 If FLAG is `to', this makes the buffer a multibyte buffer by changing
2442 all eight-bit bytes to eight-bit characters.
2443 If the multibyte flag was really changed, undo information of the
2444 current buffer is cleared. */)
2445 (Lisp_Object flag)
2447 struct Lisp_Marker *tail, *markers;
2448 struct buffer *other;
2449 ptrdiff_t begv, zv;
2450 bool narrowed = (BEG != BEGV || Z != ZV);
2451 bool modified_p = !NILP (Fbuffer_modified_p (Qnil));
2452 Lisp_Object old_undo = BVAR (current_buffer, undo_list);
2453 struct gcpro gcpro1;
2455 if (current_buffer->base_buffer)
2456 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
2458 /* Do nothing if nothing actually changes. */
2459 if (NILP (flag) == NILP (BVAR (current_buffer, enable_multibyte_characters)))
2460 return flag;
2462 GCPRO1 (old_undo);
2464 /* Don't record these buffer changes. We will put a special undo entry
2465 instead. */
2466 bset_undo_list (current_buffer, Qt);
2468 /* If the cached position is for this buffer, clear it out. */
2469 clear_charpos_cache (current_buffer);
2471 if (NILP (flag))
2472 begv = BEGV_BYTE, zv = ZV_BYTE;
2473 else
2474 begv = BEGV, zv = ZV;
2476 if (narrowed)
2477 error ("Changing multibyteness in a narrowed buffer");
2479 if (NILP (flag))
2481 ptrdiff_t pos, stop;
2482 unsigned char *p;
2484 /* Do this first, so it can use CHAR_TO_BYTE
2485 to calculate the old correspondences. */
2486 set_intervals_multibyte (0);
2488 bset_enable_multibyte_characters (current_buffer, Qnil);
2490 Z = Z_BYTE;
2491 BEGV = BEGV_BYTE;
2492 ZV = ZV_BYTE;
2493 GPT = GPT_BYTE;
2494 TEMP_SET_PT_BOTH (PT_BYTE, PT_BYTE);
2497 for (tail = BUF_MARKERS (current_buffer); tail; tail = tail->next)
2498 tail->charpos = tail->bytepos;
2500 /* Convert multibyte form of 8-bit characters to unibyte. */
2501 pos = BEG;
2502 stop = GPT;
2503 p = BEG_ADDR;
2504 while (1)
2506 int c, bytes;
2508 if (pos == stop)
2510 if (pos == Z)
2511 break;
2512 p = GAP_END_ADDR;
2513 stop = Z;
2515 if (ASCII_BYTE_P (*p))
2516 p++, pos++;
2517 else if (CHAR_BYTE8_HEAD_P (*p))
2519 c = STRING_CHAR_AND_LENGTH (p, bytes);
2520 /* Delete all bytes for this 8-bit character but the
2521 last one, and change the last one to the character
2522 code. */
2523 bytes--;
2524 del_range_2 (pos, pos, pos + bytes, pos + bytes, 0);
2525 p = GAP_END_ADDR;
2526 *p++ = c;
2527 pos++;
2528 if (begv > pos)
2529 begv -= bytes;
2530 if (zv > pos)
2531 zv -= bytes;
2532 stop = Z;
2534 else
2536 bytes = BYTES_BY_CHAR_HEAD (*p);
2537 p += bytes, pos += bytes;
2540 if (narrowed)
2541 Fnarrow_to_region (make_number (begv), make_number (zv));
2543 else
2545 ptrdiff_t pt = PT;
2546 ptrdiff_t pos, stop;
2547 unsigned char *p, *pend;
2549 /* Be sure not to have a multibyte sequence striding over the GAP.
2550 Ex: We change this: "...abc\302 _GAP_ \241def..."
2551 to: "...abc _GAP_ \302\241def..." */
2553 if (EQ (flag, Qt)
2554 && GPT_BYTE > 1 && GPT_BYTE < Z_BYTE
2555 && ! CHAR_HEAD_P (*(GAP_END_ADDR)))
2557 unsigned char *q = GPT_ADDR - 1;
2559 while (! CHAR_HEAD_P (*q) && q > BEG_ADDR) q--;
2560 if (LEADING_CODE_P (*q))
2562 ptrdiff_t new_gpt = GPT_BYTE - (GPT_ADDR - q);
2564 move_gap_both (new_gpt, new_gpt);
2568 /* Make the buffer contents valid as multibyte by converting
2569 8-bit characters to multibyte form. */
2570 pos = BEG;
2571 stop = GPT;
2572 p = BEG_ADDR;
2573 pend = GPT_ADDR;
2574 while (1)
2576 int bytes;
2578 if (pos == stop)
2580 if (pos == Z)
2581 break;
2582 p = GAP_END_ADDR;
2583 pend = Z_ADDR;
2584 stop = Z;
2587 if (ASCII_BYTE_P (*p))
2588 p++, pos++;
2589 else if (EQ (flag, Qt)
2590 && ! CHAR_BYTE8_HEAD_P (*p)
2591 && (bytes = MULTIBYTE_LENGTH (p, pend)) > 0)
2592 p += bytes, pos += bytes;
2593 else
2595 unsigned char tmp[MAX_MULTIBYTE_LENGTH];
2596 int c;
2598 c = BYTE8_TO_CHAR (*p);
2599 bytes = CHAR_STRING (c, tmp);
2600 *p = tmp[0];
2601 TEMP_SET_PT_BOTH (pos + 1, pos + 1);
2602 bytes--;
2603 insert_1_both ((char *) tmp + 1, bytes, bytes, 1, 0, 0);
2604 /* Now the gap is after the just inserted data. */
2605 pos = GPT;
2606 p = GAP_END_ADDR;
2607 if (pos <= begv)
2608 begv += bytes;
2609 if (pos <= zv)
2610 zv += bytes;
2611 if (pos <= pt)
2612 pt += bytes;
2613 pend = Z_ADDR;
2614 stop = Z;
2618 if (pt != PT)
2619 TEMP_SET_PT (pt);
2621 if (narrowed)
2622 Fnarrow_to_region (make_number (begv), make_number (zv));
2624 /* Do this first, so that chars_in_text asks the right question.
2625 set_intervals_multibyte needs it too. */
2626 bset_enable_multibyte_characters (current_buffer, Qt);
2628 GPT_BYTE = advance_to_char_boundary (GPT_BYTE);
2629 GPT = chars_in_text (BEG_ADDR, GPT_BYTE - BEG_BYTE) + BEG;
2631 Z = chars_in_text (GAP_END_ADDR, Z_BYTE - GPT_BYTE) + GPT;
2633 BEGV_BYTE = advance_to_char_boundary (BEGV_BYTE);
2634 if (BEGV_BYTE > GPT_BYTE)
2635 BEGV = chars_in_text (GAP_END_ADDR, BEGV_BYTE - GPT_BYTE) + GPT;
2636 else
2637 BEGV = chars_in_text (BEG_ADDR, BEGV_BYTE - BEG_BYTE) + BEG;
2639 ZV_BYTE = advance_to_char_boundary (ZV_BYTE);
2640 if (ZV_BYTE > GPT_BYTE)
2641 ZV = chars_in_text (GAP_END_ADDR, ZV_BYTE - GPT_BYTE) + GPT;
2642 else
2643 ZV = chars_in_text (BEG_ADDR, ZV_BYTE - BEG_BYTE) + BEG;
2646 ptrdiff_t byte = advance_to_char_boundary (PT_BYTE);
2647 ptrdiff_t position;
2649 if (byte > GPT_BYTE)
2650 position = chars_in_text (GAP_END_ADDR, byte - GPT_BYTE) + GPT;
2651 else
2652 position = chars_in_text (BEG_ADDR, byte - BEG_BYTE) + BEG;
2653 TEMP_SET_PT_BOTH (position, byte);
2656 tail = markers = BUF_MARKERS (current_buffer);
2658 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
2659 getting confused by the markers that have not yet been updated.
2660 It is also a signal that it should never create a marker. */
2661 BUF_MARKERS (current_buffer) = NULL;
2663 for (; tail; tail = tail->next)
2665 tail->bytepos = advance_to_char_boundary (tail->bytepos);
2666 tail->charpos = BYTE_TO_CHAR (tail->bytepos);
2669 /* Make sure no markers were put on the chain
2670 while the chain value was incorrect. */
2671 if (BUF_MARKERS (current_buffer))
2672 emacs_abort ();
2674 BUF_MARKERS (current_buffer) = markers;
2676 /* Do this last, so it can calculate the new correspondences
2677 between chars and bytes. */
2678 set_intervals_multibyte (1);
2681 if (!EQ (old_undo, Qt))
2683 /* Represent all the above changes by a special undo entry. */
2684 bset_undo_list (current_buffer,
2685 Fcons (list3 (Qapply,
2686 intern ("set-buffer-multibyte"),
2687 NILP (flag) ? Qt : Qnil),
2688 old_undo));
2691 UNGCPRO;
2693 current_buffer->prevent_redisplay_optimizations_p = 1;
2695 /* If buffer is shown in a window, let redisplay consider other windows. */
2696 if (buffer_window_count (current_buffer))
2697 ++windows_or_buffers_changed;
2699 /* Copy this buffer's new multibyte status
2700 into all of its indirect buffers. */
2701 FOR_EACH_BUFFER (other)
2702 if (other->base_buffer == current_buffer && BUFFER_LIVE_P (other))
2704 BVAR (other, enable_multibyte_characters)
2705 = BVAR (current_buffer, enable_multibyte_characters);
2706 other->prevent_redisplay_optimizations_p = 1;
2709 /* Restore the modifiedness of the buffer. */
2710 if (!modified_p && !NILP (Fbuffer_modified_p (Qnil)))
2711 Fset_buffer_modified_p (Qnil);
2713 /* Update coding systems of this buffer's process (if any). */
2715 Lisp_Object process;
2717 process = Fget_buffer_process (Fcurrent_buffer ());
2718 if (PROCESSP (process))
2719 setup_process_coding_systems (process);
2722 return flag;
2725 DEFUN ("kill-all-local-variables", Fkill_all_local_variables,
2726 Skill_all_local_variables, 0, 0, 0,
2727 doc: /* Switch to Fundamental mode by killing current buffer's local variables.
2728 Most local variable bindings are eliminated so that the default values
2729 become effective once more. Also, the syntax table is set from
2730 `standard-syntax-table', the local keymap is set to nil,
2731 and the abbrev table from `fundamental-mode-abbrev-table'.
2732 This function also forces redisplay of the mode line.
2734 Every function to select a new major mode starts by
2735 calling this function.
2737 As a special exception, local variables whose names have
2738 a non-nil `permanent-local' property are not eliminated by this function.
2740 The first thing this function does is run
2741 the normal hook `change-major-mode-hook'. */)
2742 (void)
2744 Frun_hooks (1, &Qchange_major_mode_hook);
2746 /* Make sure none of the bindings in local_var_alist
2747 remain swapped in, in their symbols. */
2749 swap_out_buffer_local_variables (current_buffer);
2751 /* Actually eliminate all local bindings of this buffer. */
2753 reset_buffer_local_variables (current_buffer, 0);
2755 /* Force mode-line redisplay. Useful here because all major mode
2756 commands call this function. */
2757 update_mode_lines++;
2759 return Qnil;
2762 /* Make sure no local variables remain set up with buffer B
2763 for their current values. */
2765 static void
2766 swap_out_buffer_local_variables (struct buffer *b)
2768 Lisp_Object oalist, alist, buffer;
2770 XSETBUFFER (buffer, b);
2771 oalist = BVAR (b, local_var_alist);
2773 for (alist = oalist; CONSP (alist); alist = XCDR (alist))
2775 Lisp_Object sym = XCAR (XCAR (alist));
2776 eassert (XSYMBOL (sym)->redirect == SYMBOL_LOCALIZED);
2777 /* Need not do anything if some other buffer's binding is
2778 now cached. */
2779 if (EQ (SYMBOL_BLV (XSYMBOL (sym))->where, buffer))
2781 /* Symbol is set up for this buffer's old local value:
2782 swap it out! */
2783 swap_in_global_binding (XSYMBOL (sym));
2788 /* Find all the overlays in the current buffer that contain position POS.
2789 Return the number found, and store them in a vector in *VEC_PTR.
2790 Store in *LEN_PTR the size allocated for the vector.
2791 Store in *NEXT_PTR the next position after POS where an overlay starts,
2792 or ZV if there are no more overlays between POS and ZV.
2793 Store in *PREV_PTR the previous position before POS where an overlay ends,
2794 or where an overlay starts which ends at or after POS;
2795 or BEGV if there are no such overlays from BEGV to POS.
2796 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2798 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2799 when this function is called.
2801 If EXTEND, make the vector bigger if necessary.
2802 If not, never extend the vector,
2803 and store only as many overlays as will fit.
2804 But still return the total number of overlays.
2806 If CHANGE_REQ, any position written into *PREV_PTR or
2807 *NEXT_PTR is guaranteed to be not equal to POS, unless it is the
2808 default (BEGV or ZV). */
2810 ptrdiff_t
2811 overlays_at (EMACS_INT pos, bool extend, Lisp_Object **vec_ptr,
2812 ptrdiff_t *len_ptr,
2813 ptrdiff_t *next_ptr, ptrdiff_t *prev_ptr, bool change_req)
2815 Lisp_Object overlay, start, end;
2816 struct Lisp_Overlay *tail;
2817 ptrdiff_t idx = 0;
2818 ptrdiff_t len = *len_ptr;
2819 Lisp_Object *vec = *vec_ptr;
2820 ptrdiff_t next = ZV;
2821 ptrdiff_t prev = BEGV;
2822 bool inhibit_storing = 0;
2824 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2826 ptrdiff_t startpos, endpos;
2828 XSETMISC (overlay, tail);
2830 start = OVERLAY_START (overlay);
2831 end = OVERLAY_END (overlay);
2832 endpos = OVERLAY_POSITION (end);
2833 if (endpos < pos)
2835 if (prev < endpos)
2836 prev = endpos;
2837 break;
2839 startpos = OVERLAY_POSITION (start);
2840 /* This one ends at or after POS
2841 so its start counts for PREV_PTR if it's before POS. */
2842 if (prev < startpos && startpos < pos)
2843 prev = startpos;
2844 if (endpos == pos)
2845 continue;
2846 if (startpos <= pos)
2848 if (idx == len)
2850 /* The supplied vector is full.
2851 Either make it bigger, or don't store any more in it. */
2852 if (extend)
2854 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2855 sizeof *vec);
2856 *vec_ptr = vec;
2857 len = *len_ptr;
2859 else
2860 inhibit_storing = 1;
2863 if (!inhibit_storing)
2864 vec[idx] = overlay;
2865 /* Keep counting overlays even if we can't return them all. */
2866 idx++;
2868 else if (startpos < next)
2869 next = startpos;
2872 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
2874 ptrdiff_t startpos, endpos;
2876 XSETMISC (overlay, tail);
2878 start = OVERLAY_START (overlay);
2879 end = OVERLAY_END (overlay);
2880 startpos = OVERLAY_POSITION (start);
2881 if (pos < startpos)
2883 if (startpos < next)
2884 next = startpos;
2885 break;
2887 endpos = OVERLAY_POSITION (end);
2888 if (pos < endpos)
2890 if (idx == len)
2892 if (extend)
2894 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2895 sizeof *vec);
2896 *vec_ptr = vec;
2897 len = *len_ptr;
2899 else
2900 inhibit_storing = 1;
2903 if (!inhibit_storing)
2904 vec[idx] = overlay;
2905 idx++;
2907 if (startpos < pos && startpos > prev)
2908 prev = startpos;
2910 else if (endpos < pos && endpos > prev)
2911 prev = endpos;
2912 else if (endpos == pos && startpos > prev
2913 && (!change_req || startpos < pos))
2914 prev = startpos;
2917 if (next_ptr)
2918 *next_ptr = next;
2919 if (prev_ptr)
2920 *prev_ptr = prev;
2921 return idx;
2924 /* Find all the overlays in the current buffer that overlap the range
2925 BEG-END, or are empty at BEG, or are empty at END provided END
2926 denotes the position at the end of the current buffer.
2928 Return the number found, and store them in a vector in *VEC_PTR.
2929 Store in *LEN_PTR the size allocated for the vector.
2930 Store in *NEXT_PTR the next position after POS where an overlay starts,
2931 or ZV if there are no more overlays.
2932 Store in *PREV_PTR the previous position before POS where an overlay ends,
2933 or BEGV if there are no previous overlays.
2934 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2936 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2937 when this function is called.
2939 If EXTEND, make the vector bigger if necessary.
2940 If not, never extend the vector,
2941 and store only as many overlays as will fit.
2942 But still return the total number of overlays. */
2944 static ptrdiff_t
2945 overlays_in (EMACS_INT beg, EMACS_INT end, bool extend,
2946 Lisp_Object **vec_ptr, ptrdiff_t *len_ptr,
2947 ptrdiff_t *next_ptr, ptrdiff_t *prev_ptr)
2949 Lisp_Object overlay, ostart, oend;
2950 struct Lisp_Overlay *tail;
2951 ptrdiff_t idx = 0;
2952 ptrdiff_t len = *len_ptr;
2953 Lisp_Object *vec = *vec_ptr;
2954 ptrdiff_t next = ZV;
2955 ptrdiff_t prev = BEGV;
2956 bool inhibit_storing = 0;
2957 bool end_is_Z = end == Z;
2959 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2961 ptrdiff_t startpos, endpos;
2963 XSETMISC (overlay, tail);
2965 ostart = OVERLAY_START (overlay);
2966 oend = OVERLAY_END (overlay);
2967 endpos = OVERLAY_POSITION (oend);
2968 if (endpos < beg)
2970 if (prev < endpos)
2971 prev = endpos;
2972 break;
2974 startpos = OVERLAY_POSITION (ostart);
2975 /* Count an interval if it overlaps the range, is empty at the
2976 start of the range, or is empty at END provided END denotes the
2977 end of the buffer. */
2978 if ((beg < endpos && startpos < end)
2979 || (startpos == endpos
2980 && (beg == endpos || (end_is_Z && endpos == end))))
2982 if (idx == len)
2984 /* The supplied vector is full.
2985 Either make it bigger, or don't store any more in it. */
2986 if (extend)
2988 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2989 sizeof *vec);
2990 *vec_ptr = vec;
2991 len = *len_ptr;
2993 else
2994 inhibit_storing = 1;
2997 if (!inhibit_storing)
2998 vec[idx] = overlay;
2999 /* Keep counting overlays even if we can't return them all. */
3000 idx++;
3002 else if (startpos < next)
3003 next = startpos;
3006 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
3008 ptrdiff_t startpos, endpos;
3010 XSETMISC (overlay, tail);
3012 ostart = OVERLAY_START (overlay);
3013 oend = OVERLAY_END (overlay);
3014 startpos = OVERLAY_POSITION (ostart);
3015 if (end < startpos)
3017 if (startpos < next)
3018 next = startpos;
3019 break;
3021 endpos = OVERLAY_POSITION (oend);
3022 /* Count an interval if it overlaps the range, is empty at the
3023 start of the range, or is empty at END provided END denotes the
3024 end of the buffer. */
3025 if ((beg < endpos && startpos < end)
3026 || (startpos == endpos
3027 && (beg == endpos || (end_is_Z && endpos == end))))
3029 if (idx == len)
3031 if (extend)
3033 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
3034 sizeof *vec);
3035 *vec_ptr = vec;
3036 len = *len_ptr;
3038 else
3039 inhibit_storing = 1;
3042 if (!inhibit_storing)
3043 vec[idx] = overlay;
3044 idx++;
3046 else if (endpos < beg && endpos > prev)
3047 prev = endpos;
3050 if (next_ptr)
3051 *next_ptr = next;
3052 if (prev_ptr)
3053 *prev_ptr = prev;
3054 return idx;
3058 /* Return true if there exists an overlay with a non-nil
3059 `mouse-face' property overlapping OVERLAY. */
3061 bool
3062 mouse_face_overlay_overlaps (Lisp_Object overlay)
3064 ptrdiff_t start = OVERLAY_POSITION (OVERLAY_START (overlay));
3065 ptrdiff_t end = OVERLAY_POSITION (OVERLAY_END (overlay));
3066 ptrdiff_t n, i, size;
3067 Lisp_Object *v, tem;
3069 size = 10;
3070 v = alloca (size * sizeof *v);
3071 n = overlays_in (start, end, 0, &v, &size, NULL, NULL);
3072 if (n > size)
3074 v = alloca (n * sizeof *v);
3075 overlays_in (start, end, 0, &v, &n, NULL, NULL);
3078 for (i = 0; i < n; ++i)
3079 if (!EQ (v[i], overlay)
3080 && (tem = Foverlay_get (overlay, Qmouse_face),
3081 !NILP (tem)))
3082 break;
3084 return i < n;
3089 /* Fast function to just test if we're at an overlay boundary. */
3090 bool
3091 overlay_touches_p (ptrdiff_t pos)
3093 Lisp_Object overlay;
3094 struct Lisp_Overlay *tail;
3096 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
3098 ptrdiff_t endpos;
3100 XSETMISC (overlay ,tail);
3101 eassert (OVERLAYP (overlay));
3103 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3104 if (endpos < pos)
3105 break;
3106 if (endpos == pos || OVERLAY_POSITION (OVERLAY_START (overlay)) == pos)
3107 return 1;
3110 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
3112 ptrdiff_t startpos;
3114 XSETMISC (overlay, tail);
3115 eassert (OVERLAYP (overlay));
3117 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3118 if (pos < startpos)
3119 break;
3120 if (startpos == pos || OVERLAY_POSITION (OVERLAY_END (overlay)) == pos)
3121 return 1;
3123 return 0;
3126 struct sortvec
3128 Lisp_Object overlay;
3129 ptrdiff_t beg, end;
3130 EMACS_INT priority;
3133 static int
3134 compare_overlays (const void *v1, const void *v2)
3136 const struct sortvec *s1 = (const struct sortvec *) v1;
3137 const struct sortvec *s2 = (const struct sortvec *) v2;
3138 if (s1->priority != s2->priority)
3139 return s1->priority < s2->priority ? -1 : 1;
3140 if (s1->beg != s2->beg)
3141 return s1->beg < s2->beg ? -1 : 1;
3142 if (s1->end != s2->end)
3143 return s2->end < s1->end ? -1 : 1;
3144 /* Avoid the non-determinism of qsort by choosing an arbitrary ordering
3145 between "equal" overlays. The result can still change between
3146 invocations of Emacs, but it won't change in the middle of
3147 `find_field' (bug#6830). */
3148 if (!EQ (s1->overlay, s2->overlay))
3149 return XLI (s1->overlay) < XLI (s2->overlay) ? -1 : 1;
3150 return 0;
3153 /* Sort an array of overlays by priority. The array is modified in place.
3154 The return value is the new size; this may be smaller than the original
3155 size if some of the overlays were invalid or were window-specific. */
3156 ptrdiff_t
3157 sort_overlays (Lisp_Object *overlay_vec, ptrdiff_t noverlays, struct window *w)
3159 ptrdiff_t i, j;
3160 struct sortvec *sortvec = alloca (noverlays * sizeof *sortvec);
3162 /* Put the valid and relevant overlays into sortvec. */
3164 for (i = 0, j = 0; i < noverlays; i++)
3166 Lisp_Object tem;
3167 Lisp_Object overlay;
3169 overlay = overlay_vec[i];
3170 if (OVERLAYP (overlay)
3171 && OVERLAY_POSITION (OVERLAY_START (overlay)) > 0
3172 && OVERLAY_POSITION (OVERLAY_END (overlay)) > 0)
3174 /* If we're interested in a specific window, then ignore
3175 overlays that are limited to some other window. */
3176 if (w)
3178 Lisp_Object window;
3180 window = Foverlay_get (overlay, Qwindow);
3181 if (WINDOWP (window) && XWINDOW (window) != w)
3182 continue;
3185 /* This overlay is good and counts: put it into sortvec. */
3186 sortvec[j].overlay = overlay;
3187 sortvec[j].beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3188 sortvec[j].end = OVERLAY_POSITION (OVERLAY_END (overlay));
3189 tem = Foverlay_get (overlay, Qpriority);
3190 if (INTEGERP (tem))
3191 sortvec[j].priority = XINT (tem);
3192 else
3193 sortvec[j].priority = 0;
3194 j++;
3197 noverlays = j;
3199 /* Sort the overlays into the proper order: increasing priority. */
3201 if (noverlays > 1)
3202 qsort (sortvec, noverlays, sizeof (struct sortvec), compare_overlays);
3204 for (i = 0; i < noverlays; i++)
3205 overlay_vec[i] = sortvec[i].overlay;
3206 return (noverlays);
3209 struct sortstr
3211 Lisp_Object string, string2;
3212 ptrdiff_t size;
3213 EMACS_INT priority;
3216 struct sortstrlist
3218 struct sortstr *buf; /* An array that expands as needed; never freed. */
3219 ptrdiff_t size; /* Allocated length of that array. */
3220 ptrdiff_t used; /* How much of the array is currently in use. */
3221 ptrdiff_t bytes; /* Total length of the strings in buf. */
3224 /* Buffers for storing information about the overlays touching a given
3225 position. These could be automatic variables in overlay_strings, but
3226 it's more efficient to hold onto the memory instead of repeatedly
3227 allocating and freeing it. */
3228 static struct sortstrlist overlay_heads, overlay_tails;
3229 static unsigned char *overlay_str_buf;
3231 /* Allocated length of overlay_str_buf. */
3232 static ptrdiff_t overlay_str_len;
3234 /* A comparison function suitable for passing to qsort. */
3235 static int
3236 cmp_for_strings (const void *as1, const void *as2)
3238 struct sortstr *s1 = (struct sortstr *)as1;
3239 struct sortstr *s2 = (struct sortstr *)as2;
3240 if (s1->size != s2->size)
3241 return s2->size < s1->size ? -1 : 1;
3242 if (s1->priority != s2->priority)
3243 return s1->priority < s2->priority ? -1 : 1;
3244 return 0;
3247 static void
3248 record_overlay_string (struct sortstrlist *ssl, Lisp_Object str,
3249 Lisp_Object str2, Lisp_Object pri, ptrdiff_t size)
3251 ptrdiff_t nbytes;
3253 if (ssl->used == ssl->size)
3254 ssl->buf = xpalloc (ssl->buf, &ssl->size, 5, -1, sizeof *ssl->buf);
3255 ssl->buf[ssl->used].string = str;
3256 ssl->buf[ssl->used].string2 = str2;
3257 ssl->buf[ssl->used].size = size;
3258 ssl->buf[ssl->used].priority = (INTEGERP (pri) ? XINT (pri) : 0);
3259 ssl->used++;
3261 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
3262 nbytes = SCHARS (str);
3263 else if (! STRING_MULTIBYTE (str))
3264 nbytes = count_size_as_multibyte (SDATA (str),
3265 SBYTES (str));
3266 else
3267 nbytes = SBYTES (str);
3269 if (INT_ADD_OVERFLOW (ssl->bytes, nbytes))
3270 memory_full (SIZE_MAX);
3271 ssl->bytes += nbytes;
3273 if (STRINGP (str2))
3275 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
3276 nbytes = SCHARS (str2);
3277 else if (! STRING_MULTIBYTE (str2))
3278 nbytes = count_size_as_multibyte (SDATA (str2),
3279 SBYTES (str2));
3280 else
3281 nbytes = SBYTES (str2);
3283 if (INT_ADD_OVERFLOW (ssl->bytes, nbytes))
3284 memory_full (SIZE_MAX);
3285 ssl->bytes += nbytes;
3289 /* Return the concatenation of the strings associated with overlays that
3290 begin or end at POS, ignoring overlays that are specific to a window
3291 other than W. The strings are concatenated in the appropriate order:
3292 shorter overlays nest inside longer ones, and higher priority inside
3293 lower. Normally all of the after-strings come first, but zero-sized
3294 overlays have their after-strings ride along with the before-strings
3295 because it would look strange to print them inside-out.
3297 Returns the string length, and stores the contents indirectly through
3298 PSTR, if that variable is non-null. The string may be overwritten by
3299 subsequent calls. */
3301 ptrdiff_t
3302 overlay_strings (ptrdiff_t pos, struct window *w, unsigned char **pstr)
3304 Lisp_Object overlay, window, str;
3305 struct Lisp_Overlay *ov;
3306 ptrdiff_t startpos, endpos;
3307 bool multibyte = ! NILP (BVAR (current_buffer, enable_multibyte_characters));
3309 overlay_heads.used = overlay_heads.bytes = 0;
3310 overlay_tails.used = overlay_tails.bytes = 0;
3311 for (ov = current_buffer->overlays_before; ov; ov = ov->next)
3313 XSETMISC (overlay, ov);
3314 eassert (OVERLAYP (overlay));
3316 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3317 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3318 if (endpos < pos)
3319 break;
3320 if (endpos != pos && startpos != pos)
3321 continue;
3322 window = Foverlay_get (overlay, Qwindow);
3323 if (WINDOWP (window) && XWINDOW (window) != w)
3324 continue;
3325 if (startpos == pos
3326 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3327 record_overlay_string (&overlay_heads, str,
3328 (startpos == endpos
3329 ? Foverlay_get (overlay, Qafter_string)
3330 : Qnil),
3331 Foverlay_get (overlay, Qpriority),
3332 endpos - startpos);
3333 else if (endpos == pos
3334 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3335 record_overlay_string (&overlay_tails, str, Qnil,
3336 Foverlay_get (overlay, Qpriority),
3337 endpos - startpos);
3339 for (ov = current_buffer->overlays_after; ov; ov = ov->next)
3341 XSETMISC (overlay, ov);
3342 eassert (OVERLAYP (overlay));
3344 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3345 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3346 if (startpos > pos)
3347 break;
3348 if (endpos != pos && startpos != pos)
3349 continue;
3350 window = Foverlay_get (overlay, Qwindow);
3351 if (WINDOWP (window) && XWINDOW (window) != w)
3352 continue;
3353 if (startpos == pos
3354 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3355 record_overlay_string (&overlay_heads, str,
3356 (startpos == endpos
3357 ? Foverlay_get (overlay, Qafter_string)
3358 : Qnil),
3359 Foverlay_get (overlay, Qpriority),
3360 endpos - startpos);
3361 else if (endpos == pos
3362 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3363 record_overlay_string (&overlay_tails, str, Qnil,
3364 Foverlay_get (overlay, Qpriority),
3365 endpos - startpos);
3367 if (overlay_tails.used > 1)
3368 qsort (overlay_tails.buf, overlay_tails.used, sizeof (struct sortstr),
3369 cmp_for_strings);
3370 if (overlay_heads.used > 1)
3371 qsort (overlay_heads.buf, overlay_heads.used, sizeof (struct sortstr),
3372 cmp_for_strings);
3373 if (overlay_heads.bytes || overlay_tails.bytes)
3375 Lisp_Object tem;
3376 ptrdiff_t i;
3377 unsigned char *p;
3378 ptrdiff_t total;
3380 if (INT_ADD_OVERFLOW (overlay_heads.bytes, overlay_tails.bytes))
3381 memory_full (SIZE_MAX);
3382 total = overlay_heads.bytes + overlay_tails.bytes;
3383 if (total > overlay_str_len)
3384 overlay_str_buf = xpalloc (overlay_str_buf, &overlay_str_len,
3385 total - overlay_str_len, -1, 1);
3387 p = overlay_str_buf;
3388 for (i = overlay_tails.used; --i >= 0;)
3390 ptrdiff_t nbytes;
3391 tem = overlay_tails.buf[i].string;
3392 nbytes = copy_text (SDATA (tem), p,
3393 SBYTES (tem),
3394 STRING_MULTIBYTE (tem), multibyte);
3395 p += nbytes;
3397 for (i = 0; i < overlay_heads.used; ++i)
3399 ptrdiff_t nbytes;
3400 tem = overlay_heads.buf[i].string;
3401 nbytes = copy_text (SDATA (tem), p,
3402 SBYTES (tem),
3403 STRING_MULTIBYTE (tem), multibyte);
3404 p += nbytes;
3405 tem = overlay_heads.buf[i].string2;
3406 if (STRINGP (tem))
3408 nbytes = copy_text (SDATA (tem), p,
3409 SBYTES (tem),
3410 STRING_MULTIBYTE (tem), multibyte);
3411 p += nbytes;
3414 if (p != overlay_str_buf + total)
3415 emacs_abort ();
3416 if (pstr)
3417 *pstr = overlay_str_buf;
3418 return total;
3420 return 0;
3423 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
3425 void
3426 recenter_overlay_lists (struct buffer *buf, ptrdiff_t pos)
3428 Lisp_Object overlay, beg, end;
3429 struct Lisp_Overlay *prev, *tail, *next;
3431 /* See if anything in overlays_before should move to overlays_after. */
3433 /* We don't strictly need prev in this loop; it should always be nil.
3434 But we use it for symmetry and in case that should cease to be true
3435 with some future change. */
3436 prev = NULL;
3437 for (tail = buf->overlays_before; tail; prev = tail, tail = next)
3439 next = tail->next;
3440 XSETMISC (overlay, tail);
3441 eassert (OVERLAYP (overlay));
3443 beg = OVERLAY_START (overlay);
3444 end = OVERLAY_END (overlay);
3446 if (OVERLAY_POSITION (end) > pos)
3448 /* OVERLAY needs to be moved. */
3449 ptrdiff_t where = OVERLAY_POSITION (beg);
3450 struct Lisp_Overlay *other, *other_prev;
3452 /* Splice the cons cell TAIL out of overlays_before. */
3453 if (prev)
3454 prev->next = next;
3455 else
3456 set_buffer_overlays_before (buf, next);
3458 /* Search thru overlays_after for where to put it. */
3459 other_prev = NULL;
3460 for (other = buf->overlays_after; other;
3461 other_prev = other, other = other->next)
3463 Lisp_Object otherbeg, otheroverlay;
3465 XSETMISC (otheroverlay, other);
3466 eassert (OVERLAYP (otheroverlay));
3468 otherbeg = OVERLAY_START (otheroverlay);
3469 if (OVERLAY_POSITION (otherbeg) >= where)
3470 break;
3473 /* Add TAIL to overlays_after before OTHER. */
3474 tail->next = other;
3475 if (other_prev)
3476 other_prev->next = tail;
3477 else
3478 set_buffer_overlays_after (buf, tail);
3479 tail = prev;
3481 else
3482 /* We've reached the things that should stay in overlays_before.
3483 All the rest of overlays_before must end even earlier,
3484 so stop now. */
3485 break;
3488 /* See if anything in overlays_after should be in overlays_before. */
3489 prev = NULL;
3490 for (tail = buf->overlays_after; tail; prev = tail, tail = next)
3492 next = tail->next;
3493 XSETMISC (overlay, tail);
3494 eassert (OVERLAYP (overlay));
3496 beg = OVERLAY_START (overlay);
3497 end = OVERLAY_END (overlay);
3499 /* Stop looking, when we know that nothing further
3500 can possibly end before POS. */
3501 if (OVERLAY_POSITION (beg) > pos)
3502 break;
3504 if (OVERLAY_POSITION (end) <= pos)
3506 /* OVERLAY needs to be moved. */
3507 ptrdiff_t where = OVERLAY_POSITION (end);
3508 struct Lisp_Overlay *other, *other_prev;
3510 /* Splice the cons cell TAIL out of overlays_after. */
3511 if (prev)
3512 prev->next = next;
3513 else
3514 set_buffer_overlays_after (buf, next);
3516 /* Search thru overlays_before for where to put it. */
3517 other_prev = NULL;
3518 for (other = buf->overlays_before; other;
3519 other_prev = other, other = other->next)
3521 Lisp_Object otherend, otheroverlay;
3523 XSETMISC (otheroverlay, other);
3524 eassert (OVERLAYP (otheroverlay));
3526 otherend = OVERLAY_END (otheroverlay);
3527 if (OVERLAY_POSITION (otherend) <= where)
3528 break;
3531 /* Add TAIL to overlays_before before OTHER. */
3532 tail->next = other;
3533 if (other_prev)
3534 other_prev->next = tail;
3535 else
3536 set_buffer_overlays_before (buf, tail);
3537 tail = prev;
3541 buf->overlay_center = pos;
3544 void
3545 adjust_overlays_for_insert (ptrdiff_t pos, ptrdiff_t length)
3547 /* After an insertion, the lists are still sorted properly,
3548 but we may need to update the value of the overlay center. */
3549 if (current_buffer->overlay_center >= pos)
3550 current_buffer->overlay_center += length;
3553 void
3554 adjust_overlays_for_delete (ptrdiff_t pos, ptrdiff_t length)
3556 if (current_buffer->overlay_center < pos)
3557 /* The deletion was to our right. No change needed; the before- and
3558 after-lists are still consistent. */
3560 else if (current_buffer->overlay_center - pos > length)
3561 /* The deletion was to our left. We need to adjust the center value
3562 to account for the change in position, but the lists are consistent
3563 given the new value. */
3564 current_buffer->overlay_center -= length;
3565 else
3566 /* We're right in the middle. There might be things on the after-list
3567 that now belong on the before-list. Recentering will move them,
3568 and also update the center point. */
3569 recenter_overlay_lists (current_buffer, pos);
3572 /* Fix up overlays that were garbled as a result of permuting markers
3573 in the range START through END. Any overlay with at least one
3574 endpoint in this range will need to be unlinked from the overlay
3575 list and reinserted in its proper place.
3576 Such an overlay might even have negative size at this point.
3577 If so, we'll make the overlay empty. */
3578 void
3579 fix_start_end_in_overlays (register ptrdiff_t start, register ptrdiff_t end)
3581 Lisp_Object overlay;
3582 struct Lisp_Overlay *before_list IF_LINT (= NULL);
3583 struct Lisp_Overlay *after_list IF_LINT (= NULL);
3584 /* These are either nil, indicating that before_list or after_list
3585 should be assigned, or the cons cell the cdr of which should be
3586 assigned. */
3587 struct Lisp_Overlay *beforep = NULL, *afterp = NULL;
3588 /* 'Parent', likewise, indicates a cons cell or
3589 current_buffer->overlays_before or overlays_after, depending
3590 which loop we're in. */
3591 struct Lisp_Overlay *tail, *parent;
3592 ptrdiff_t startpos, endpos;
3594 /* This algorithm shifts links around instead of consing and GCing.
3595 The loop invariant is that before_list (resp. after_list) is a
3596 well-formed list except that its last element, the CDR of beforep
3597 (resp. afterp) if beforep (afterp) isn't nil or before_list
3598 (after_list) if it is, is still uninitialized. So it's not a bug
3599 that before_list isn't initialized, although it may look
3600 strange. */
3601 for (parent = NULL, tail = current_buffer->overlays_before; tail;)
3603 XSETMISC (overlay, tail);
3605 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3606 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3608 /* If the overlay is backwards, make it empty. */
3609 if (endpos < startpos)
3611 startpos = endpos;
3612 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3613 Qnil);
3616 if (endpos < start)
3617 break;
3619 if (endpos < end
3620 || (startpos >= start && startpos < end))
3622 /* Add it to the end of the wrong list. Later on,
3623 recenter_overlay_lists will move it to the right place. */
3624 if (endpos < current_buffer->overlay_center)
3626 if (!afterp)
3627 after_list = tail;
3628 else
3629 afterp->next = tail;
3630 afterp = tail;
3632 else
3634 if (!beforep)
3635 before_list = tail;
3636 else
3637 beforep->next = tail;
3638 beforep = tail;
3640 if (!parent)
3641 set_buffer_overlays_before (current_buffer, tail->next);
3642 else
3643 parent->next = tail->next;
3644 tail = tail->next;
3646 else
3647 parent = tail, tail = parent->next;
3649 for (parent = NULL, tail = current_buffer->overlays_after; tail;)
3651 XSETMISC (overlay, tail);
3653 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3654 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3656 /* If the overlay is backwards, make it empty. */
3657 if (endpos < startpos)
3659 startpos = endpos;
3660 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3661 Qnil);
3664 if (startpos >= end)
3665 break;
3667 if (startpos >= start
3668 || (endpos >= start && endpos < end))
3670 if (endpos < current_buffer->overlay_center)
3672 if (!afterp)
3673 after_list = tail;
3674 else
3675 afterp->next = tail;
3676 afterp = tail;
3678 else
3680 if (!beforep)
3681 before_list = tail;
3682 else
3683 beforep->next = tail;
3684 beforep = tail;
3686 if (!parent)
3687 set_buffer_overlays_after (current_buffer, tail->next);
3688 else
3689 parent->next = tail->next;
3690 tail = tail->next;
3692 else
3693 parent = tail, tail = parent->next;
3696 /* Splice the constructed (wrong) lists into the buffer's lists,
3697 and let the recenter function make it sane again. */
3698 if (beforep)
3700 beforep->next = current_buffer->overlays_before;
3701 set_buffer_overlays_before (current_buffer, before_list);
3704 if (afterp)
3706 afterp->next = current_buffer->overlays_after;
3707 set_buffer_overlays_after (current_buffer, after_list);
3709 recenter_overlay_lists (current_buffer, current_buffer->overlay_center);
3712 /* We have two types of overlay: the one whose ending marker is
3713 after-insertion-marker (this is the usual case) and the one whose
3714 ending marker is before-insertion-marker. When `overlays_before'
3715 contains overlays of the latter type and the former type in this
3716 order and both overlays end at inserting position, inserting a text
3717 increases only the ending marker of the latter type, which results
3718 in incorrect ordering of `overlays_before'.
3720 This function fixes ordering of overlays in the slot
3721 `overlays_before' of the buffer *BP. Before the insertion, `point'
3722 was at PREV, and now is at POS. */
3724 void
3725 fix_overlays_before (struct buffer *bp, ptrdiff_t prev, ptrdiff_t pos)
3727 /* If parent is nil, replace overlays_before; otherwise, parent->next. */
3728 struct Lisp_Overlay *tail = bp->overlays_before, *parent = NULL, *right_pair;
3729 Lisp_Object tem;
3730 ptrdiff_t end IF_LINT (= 0);
3732 /* After the insertion, the several overlays may be in incorrect
3733 order. The possibility is that, in the list `overlays_before',
3734 an overlay which ends at POS appears after an overlay which ends
3735 at PREV. Since POS is greater than PREV, we must fix the
3736 ordering of these overlays, by moving overlays ends at POS before
3737 the overlays ends at PREV. */
3739 /* At first, find a place where disordered overlays should be linked
3740 in. It is where an overlay which end before POS exists. (i.e. an
3741 overlay whose ending marker is after-insertion-marker if disorder
3742 exists). */
3743 while (tail
3744 && (XSETMISC (tem, tail),
3745 (end = OVERLAY_POSITION (OVERLAY_END (tem))) >= pos))
3747 parent = tail;
3748 tail = tail->next;
3751 /* If we don't find such an overlay,
3752 or the found one ends before PREV,
3753 or the found one is the last one in the list,
3754 we don't have to fix anything. */
3755 if (!tail || end < prev || !tail->next)
3756 return;
3758 right_pair = parent;
3759 parent = tail;
3760 tail = tail->next;
3762 /* Now, end position of overlays in the list TAIL should be before
3763 or equal to PREV. In the loop, an overlay which ends at POS is
3764 moved ahead to the place indicated by the CDR of RIGHT_PAIR. If
3765 we found an overlay which ends before PREV, the remaining
3766 overlays are in correct order. */
3767 while (tail)
3769 XSETMISC (tem, tail);
3770 end = OVERLAY_POSITION (OVERLAY_END (tem));
3772 if (end == pos)
3773 { /* This overlay is disordered. */
3774 struct Lisp_Overlay *found = tail;
3776 /* Unlink the found overlay. */
3777 tail = found->next;
3778 parent->next = tail;
3779 /* Move an overlay at RIGHT_PLACE to the next of the found one,
3780 and link it into the right place. */
3781 if (!right_pair)
3783 found->next = bp->overlays_before;
3784 set_buffer_overlays_before (bp, found);
3786 else
3788 found->next = right_pair->next;
3789 right_pair->next = found;
3792 else if (end == prev)
3794 parent = tail;
3795 tail = tail->next;
3797 else /* No more disordered overlay. */
3798 break;
3802 DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
3803 doc: /* Return t if OBJECT is an overlay. */)
3804 (Lisp_Object object)
3806 return (OVERLAYP (object) ? Qt : Qnil);
3809 DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 5, 0,
3810 doc: /* Create a new overlay with range BEG to END in BUFFER.
3811 If omitted, BUFFER defaults to the current buffer.
3812 BEG and END may be integers or markers.
3813 The fourth arg FRONT-ADVANCE, if non-nil, makes the marker
3814 for the front of the overlay advance when text is inserted there
3815 \(which means the text *is not* included in the overlay).
3816 The fifth arg REAR-ADVANCE, if non-nil, makes the marker
3817 for the rear of the overlay advance when text is inserted there
3818 \(which means the text *is* included in the overlay). */)
3819 (Lisp_Object beg, Lisp_Object end, Lisp_Object buffer, Lisp_Object front_advance, Lisp_Object rear_advance)
3821 Lisp_Object overlay;
3822 struct buffer *b;
3824 if (NILP (buffer))
3825 XSETBUFFER (buffer, current_buffer);
3826 else
3827 CHECK_BUFFER (buffer);
3828 if (MARKERP (beg)
3829 && ! EQ (Fmarker_buffer (beg), buffer))
3830 error ("Marker points into wrong buffer");
3831 if (MARKERP (end)
3832 && ! EQ (Fmarker_buffer (end), buffer))
3833 error ("Marker points into wrong buffer");
3835 CHECK_NUMBER_COERCE_MARKER (beg);
3836 CHECK_NUMBER_COERCE_MARKER (end);
3838 if (XINT (beg) > XINT (end))
3840 Lisp_Object temp;
3841 temp = beg; beg = end; end = temp;
3844 b = XBUFFER (buffer);
3846 beg = Fset_marker (Fmake_marker (), beg, buffer);
3847 end = Fset_marker (Fmake_marker (), end, buffer);
3849 if (!NILP (front_advance))
3850 XMARKER (beg)->insertion_type = 1;
3851 if (!NILP (rear_advance))
3852 XMARKER (end)->insertion_type = 1;
3854 overlay = build_overlay (beg, end, Qnil);
3856 /* Put the new overlay on the wrong list. */
3857 end = OVERLAY_END (overlay);
3858 if (OVERLAY_POSITION (end) < b->overlay_center)
3860 eassert (b->overlays_after || (XOVERLAY (overlay)->next == NULL));
3861 XOVERLAY (overlay)->next = b->overlays_after;
3862 set_buffer_overlays_after (b, XOVERLAY (overlay));
3864 else
3866 eassert (b->overlays_before || (XOVERLAY (overlay)->next == NULL));
3867 XOVERLAY (overlay)->next = b->overlays_before;
3868 set_buffer_overlays_before (b, XOVERLAY (overlay));
3870 /* This puts it in the right list, and in the right order. */
3871 recenter_overlay_lists (b, b->overlay_center);
3873 /* We don't need to redisplay the region covered by the overlay, because
3874 the overlay has no properties at the moment. */
3876 return overlay;
3879 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3881 static void
3882 modify_overlay (struct buffer *buf, ptrdiff_t start, ptrdiff_t end)
3884 if (start > end)
3886 ptrdiff_t temp = start;
3887 start = end;
3888 end = temp;
3891 BUF_COMPUTE_UNCHANGED (buf, start, end);
3893 /* If BUF is visible, consider updating the display if ... */
3894 if (buffer_window_count (buf) > 0)
3896 /* ... it's visible in other window than selected, */
3897 if (buf != XBUFFER (XWINDOW (selected_window)->buffer))
3898 windows_or_buffers_changed = 1;
3899 /* ... or if we modify an overlay at the end of the buffer
3900 and so we cannot be sure that window end is still valid. */
3901 else if (end >= ZV && start <= ZV)
3902 windows_or_buffers_changed = 1;
3905 ++BUF_OVERLAY_MODIFF (buf);
3908 /* Remove OVERLAY from LIST. */
3910 static struct Lisp_Overlay *
3911 unchain_overlay (struct Lisp_Overlay *list, struct Lisp_Overlay *overlay)
3913 register struct Lisp_Overlay *tail, **prev = &list;
3915 for (tail = list; tail; prev = &tail->next, tail = *prev)
3916 if (tail == overlay)
3918 *prev = overlay->next;
3919 overlay->next = NULL;
3920 break;
3922 return list;
3925 /* Remove OVERLAY from both overlay lists of B. */
3927 static void
3928 unchain_both (struct buffer *b, Lisp_Object overlay)
3930 struct Lisp_Overlay *ov = XOVERLAY (overlay);
3932 set_buffer_overlays_before (b, unchain_overlay (b->overlays_before, ov));
3933 set_buffer_overlays_after (b, unchain_overlay (b->overlays_after, ov));
3934 eassert (XOVERLAY (overlay)->next == NULL);
3937 DEFUN ("move-overlay", Fmove_overlay, Smove_overlay, 3, 4, 0,
3938 doc: /* Set the endpoints of OVERLAY to BEG and END in BUFFER.
3939 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
3940 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
3941 buffer. */)
3942 (Lisp_Object overlay, Lisp_Object beg, Lisp_Object end, Lisp_Object buffer)
3944 struct buffer *b, *ob = 0;
3945 Lisp_Object obuffer;
3946 ptrdiff_t count = SPECPDL_INDEX ();
3947 ptrdiff_t n_beg, n_end, o_beg IF_LINT (= 0), o_end IF_LINT (= 0);
3949 CHECK_OVERLAY (overlay);
3950 if (NILP (buffer))
3951 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3952 if (NILP (buffer))
3953 XSETBUFFER (buffer, current_buffer);
3954 CHECK_BUFFER (buffer);
3956 if (NILP (Fbuffer_live_p (buffer)))
3957 error ("Attempt to move overlay to a dead buffer");
3959 if (MARKERP (beg)
3960 && ! EQ (Fmarker_buffer (beg), buffer))
3961 error ("Marker points into wrong buffer");
3962 if (MARKERP (end)
3963 && ! EQ (Fmarker_buffer (end), buffer))
3964 error ("Marker points into wrong buffer");
3966 CHECK_NUMBER_COERCE_MARKER (beg);
3967 CHECK_NUMBER_COERCE_MARKER (end);
3969 if (XINT (beg) > XINT (end))
3971 Lisp_Object temp;
3972 temp = beg; beg = end; end = temp;
3975 specbind (Qinhibit_quit, Qt);
3977 obuffer = Fmarker_buffer (OVERLAY_START (overlay));
3978 b = XBUFFER (buffer);
3980 if (!NILP (obuffer))
3982 ob = XBUFFER (obuffer);
3984 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3985 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3987 unchain_both (ob, overlay);
3990 /* Set the overlay boundaries, which may clip them. */
3991 Fset_marker (OVERLAY_START (overlay), beg, buffer);
3992 Fset_marker (OVERLAY_END (overlay), end, buffer);
3994 n_beg = marker_position (OVERLAY_START (overlay));
3995 n_end = marker_position (OVERLAY_END (overlay));
3997 /* If the overlay has changed buffers, do a thorough redisplay. */
3998 if (!EQ (buffer, obuffer))
4000 /* Redisplay where the overlay was. */
4001 if (ob)
4002 modify_overlay (ob, o_beg, o_end);
4004 /* Redisplay where the overlay is going to be. */
4005 modify_overlay (b, n_beg, n_end);
4007 else
4008 /* Redisplay the area the overlay has just left, or just enclosed. */
4010 if (o_beg == n_beg)
4011 modify_overlay (b, o_end, n_end);
4012 else if (o_end == n_end)
4013 modify_overlay (b, o_beg, n_beg);
4014 else
4015 modify_overlay (b, min (o_beg, n_beg), max (o_end, n_end));
4018 /* Delete the overlay if it is empty after clipping and has the
4019 evaporate property. */
4020 if (n_beg == n_end && !NILP (Foverlay_get (overlay, Qevaporate)))
4021 return unbind_to (count, Fdelete_overlay (overlay));
4023 /* Put the overlay into the new buffer's overlay lists, first on the
4024 wrong list. */
4025 if (n_end < b->overlay_center)
4027 XOVERLAY (overlay)->next = b->overlays_after;
4028 set_buffer_overlays_after (b, XOVERLAY (overlay));
4030 else
4032 XOVERLAY (overlay)->next = b->overlays_before;
4033 set_buffer_overlays_before (b, XOVERLAY (overlay));
4036 /* This puts it in the right list, and in the right order. */
4037 recenter_overlay_lists (b, b->overlay_center);
4039 return unbind_to (count, overlay);
4042 DEFUN ("delete-overlay", Fdelete_overlay, Sdelete_overlay, 1, 1, 0,
4043 doc: /* Delete the overlay OVERLAY from its buffer. */)
4044 (Lisp_Object overlay)
4046 Lisp_Object buffer;
4047 struct buffer *b;
4048 ptrdiff_t count = SPECPDL_INDEX ();
4050 CHECK_OVERLAY (overlay);
4052 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4053 if (NILP (buffer))
4054 return Qnil;
4056 b = XBUFFER (buffer);
4057 specbind (Qinhibit_quit, Qt);
4059 unchain_both (b, overlay);
4060 drop_overlay (b, XOVERLAY (overlay));
4062 /* When deleting an overlay with before or after strings, turn off
4063 display optimizations for the affected buffer, on the basis that
4064 these strings may contain newlines. This is easier to do than to
4065 check for that situation during redisplay. */
4066 if (!windows_or_buffers_changed
4067 && (!NILP (Foverlay_get (overlay, Qbefore_string))
4068 || !NILP (Foverlay_get (overlay, Qafter_string))))
4069 b->prevent_redisplay_optimizations_p = 1;
4071 return unbind_to (count, Qnil);
4074 DEFUN ("delete-all-overlays", Fdelete_all_overlays, Sdelete_all_overlays, 0, 1, 0,
4075 doc: /* Delete all overlays of BUFFER.
4076 BUFFER omitted or nil means delete all overlays of the current
4077 buffer. */)
4078 (Lisp_Object buffer)
4080 register struct buffer *buf;
4082 if (NILP (buffer))
4083 buf = current_buffer;
4084 else
4086 CHECK_BUFFER (buffer);
4087 buf = XBUFFER (buffer);
4090 delete_all_overlays (buf);
4091 return Qnil;
4094 /* Overlay dissection functions. */
4096 DEFUN ("overlay-start", Foverlay_start, Soverlay_start, 1, 1, 0,
4097 doc: /* Return the position at which OVERLAY starts. */)
4098 (Lisp_Object overlay)
4100 CHECK_OVERLAY (overlay);
4102 return (Fmarker_position (OVERLAY_START (overlay)));
4105 DEFUN ("overlay-end", Foverlay_end, Soverlay_end, 1, 1, 0,
4106 doc: /* Return the position at which OVERLAY ends. */)
4107 (Lisp_Object overlay)
4109 CHECK_OVERLAY (overlay);
4111 return (Fmarker_position (OVERLAY_END (overlay)));
4114 DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
4115 doc: /* Return the buffer OVERLAY belongs to.
4116 Return nil if OVERLAY has been deleted. */)
4117 (Lisp_Object overlay)
4119 CHECK_OVERLAY (overlay);
4121 return Fmarker_buffer (OVERLAY_START (overlay));
4124 DEFUN ("overlay-properties", Foverlay_properties, Soverlay_properties, 1, 1, 0,
4125 doc: /* Return a list of the properties on OVERLAY.
4126 This is a copy of OVERLAY's plist; modifying its conses has no effect on
4127 OVERLAY. */)
4128 (Lisp_Object overlay)
4130 CHECK_OVERLAY (overlay);
4132 return Fcopy_sequence (XOVERLAY (overlay)->plist);
4136 DEFUN ("overlays-at", Foverlays_at, Soverlays_at, 1, 1, 0,
4137 doc: /* Return a list of the overlays that contain the character at POS. */)
4138 (Lisp_Object pos)
4140 ptrdiff_t len, noverlays;
4141 Lisp_Object *overlay_vec;
4142 Lisp_Object result;
4144 CHECK_NUMBER_COERCE_MARKER (pos);
4146 len = 10;
4147 /* We can't use alloca here because overlays_at can call xrealloc. */
4148 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4150 /* Put all the overlays we want in a vector in overlay_vec.
4151 Store the length in len. */
4152 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4153 NULL, NULL, 0);
4155 /* Make a list of them all. */
4156 result = Flist (noverlays, overlay_vec);
4158 xfree (overlay_vec);
4159 return result;
4162 DEFUN ("overlays-in", Foverlays_in, Soverlays_in, 2, 2, 0,
4163 doc: /* Return a list of the overlays that overlap the region BEG ... END.
4164 Overlap means that at least one character is contained within the overlay
4165 and also contained within the specified region.
4166 Empty overlays are included in the result if they are located at BEG,
4167 between BEG and END, or at END provided END denotes the position at the
4168 end of the buffer. */)
4169 (Lisp_Object beg, Lisp_Object end)
4171 ptrdiff_t len, noverlays;
4172 Lisp_Object *overlay_vec;
4173 Lisp_Object result;
4175 CHECK_NUMBER_COERCE_MARKER (beg);
4176 CHECK_NUMBER_COERCE_MARKER (end);
4178 len = 10;
4179 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4181 /* Put all the overlays we want in a vector in overlay_vec.
4182 Store the length in len. */
4183 noverlays = overlays_in (XINT (beg), XINT (end), 1, &overlay_vec, &len,
4184 NULL, NULL);
4186 /* Make a list of them all. */
4187 result = Flist (noverlays, overlay_vec);
4189 xfree (overlay_vec);
4190 return result;
4193 DEFUN ("next-overlay-change", Fnext_overlay_change, Snext_overlay_change,
4194 1, 1, 0,
4195 doc: /* Return the next position after POS where an overlay starts or ends.
4196 If there are no overlay boundaries from POS to (point-max),
4197 the value is (point-max). */)
4198 (Lisp_Object pos)
4200 ptrdiff_t i, len, noverlays;
4201 ptrdiff_t endpos;
4202 Lisp_Object *overlay_vec;
4204 CHECK_NUMBER_COERCE_MARKER (pos);
4206 len = 10;
4207 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4209 /* Put all the overlays we want in a vector in overlay_vec.
4210 Store the length in len.
4211 endpos gets the position where the next overlay starts. */
4212 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4213 &endpos, 0, 1);
4215 /* If any of these overlays ends before endpos,
4216 use its ending point instead. */
4217 for (i = 0; i < noverlays; i++)
4219 Lisp_Object oend;
4220 ptrdiff_t oendpos;
4222 oend = OVERLAY_END (overlay_vec[i]);
4223 oendpos = OVERLAY_POSITION (oend);
4224 if (oendpos < endpos)
4225 endpos = oendpos;
4228 xfree (overlay_vec);
4229 return make_number (endpos);
4232 DEFUN ("previous-overlay-change", Fprevious_overlay_change,
4233 Sprevious_overlay_change, 1, 1, 0,
4234 doc: /* Return the previous position before POS where an overlay starts or ends.
4235 If there are no overlay boundaries from (point-min) to POS,
4236 the value is (point-min). */)
4237 (Lisp_Object pos)
4239 ptrdiff_t prevpos;
4240 Lisp_Object *overlay_vec;
4241 ptrdiff_t len;
4243 CHECK_NUMBER_COERCE_MARKER (pos);
4245 /* At beginning of buffer, we know the answer;
4246 avoid bug subtracting 1 below. */
4247 if (XINT (pos) == BEGV)
4248 return pos;
4250 len = 10;
4251 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4253 /* Put all the overlays we want in a vector in overlay_vec.
4254 Store the length in len.
4255 prevpos gets the position of the previous change. */
4256 overlays_at (XINT (pos), 1, &overlay_vec, &len,
4257 0, &prevpos, 1);
4259 xfree (overlay_vec);
4260 return make_number (prevpos);
4263 /* These functions are for debugging overlays. */
4265 DEFUN ("overlay-lists", Foverlay_lists, Soverlay_lists, 0, 0, 0,
4266 doc: /* Return a pair of lists giving all the overlays of the current buffer.
4267 The car has all the overlays before the overlay center;
4268 the cdr has all the overlays after the overlay center.
4269 Recentering overlays moves overlays between these lists.
4270 The lists you get are copies, so that changing them has no effect.
4271 However, the overlays you get are the real objects that the buffer uses. */)
4272 (void)
4274 struct Lisp_Overlay *ol;
4275 Lisp_Object before = Qnil, after = Qnil, tmp;
4277 for (ol = current_buffer->overlays_before; ol; ol = ol->next)
4279 XSETMISC (tmp, ol);
4280 before = Fcons (tmp, before);
4282 for (ol = current_buffer->overlays_after; ol; ol = ol->next)
4284 XSETMISC (tmp, ol);
4285 after = Fcons (tmp, after);
4288 return Fcons (Fnreverse (before), Fnreverse (after));
4291 DEFUN ("overlay-recenter", Foverlay_recenter, Soverlay_recenter, 1, 1, 0,
4292 doc: /* Recenter the overlays of the current buffer around position POS.
4293 That makes overlay lookup faster for positions near POS (but perhaps slower
4294 for positions far away from POS). */)
4295 (Lisp_Object pos)
4297 ptrdiff_t p;
4298 CHECK_NUMBER_COERCE_MARKER (pos);
4300 p = clip_to_bounds (PTRDIFF_MIN, XINT (pos), PTRDIFF_MAX);
4301 recenter_overlay_lists (current_buffer, p);
4302 return Qnil;
4305 DEFUN ("overlay-get", Foverlay_get, Soverlay_get, 2, 2, 0,
4306 doc: /* Get the property of overlay OVERLAY with property name PROP. */)
4307 (Lisp_Object overlay, Lisp_Object prop)
4309 CHECK_OVERLAY (overlay);
4310 return lookup_char_property (XOVERLAY (overlay)->plist, prop, 0);
4313 DEFUN ("overlay-put", Foverlay_put, Soverlay_put, 3, 3, 0,
4314 doc: /* Set one property of overlay OVERLAY: give property PROP value VALUE.
4315 VALUE will be returned.*/)
4316 (Lisp_Object overlay, Lisp_Object prop, Lisp_Object value)
4318 Lisp_Object tail, buffer;
4319 bool changed;
4321 CHECK_OVERLAY (overlay);
4323 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4325 for (tail = XOVERLAY (overlay)->plist;
4326 CONSP (tail) && CONSP (XCDR (tail));
4327 tail = XCDR (XCDR (tail)))
4328 if (EQ (XCAR (tail), prop))
4330 changed = !EQ (XCAR (XCDR (tail)), value);
4331 XSETCAR (XCDR (tail), value);
4332 goto found;
4334 /* It wasn't in the list, so add it to the front. */
4335 changed = !NILP (value);
4336 set_overlay_plist
4337 (overlay, Fcons (prop, Fcons (value, XOVERLAY (overlay)->plist)));
4338 found:
4339 if (! NILP (buffer))
4341 if (changed)
4342 modify_overlay (XBUFFER (buffer),
4343 marker_position (OVERLAY_START (overlay)),
4344 marker_position (OVERLAY_END (overlay)));
4345 if (EQ (prop, Qevaporate) && ! NILP (value)
4346 && (OVERLAY_POSITION (OVERLAY_START (overlay))
4347 == OVERLAY_POSITION (OVERLAY_END (overlay))))
4348 Fdelete_overlay (overlay);
4351 return value;
4354 /* Subroutine of report_overlay_modification. */
4356 /* Lisp vector holding overlay hook functions to call.
4357 Vector elements come in pairs.
4358 Each even-index element is a list of hook functions.
4359 The following odd-index element is the overlay they came from.
4361 Before the buffer change, we fill in this vector
4362 as we call overlay hook functions.
4363 After the buffer change, we get the functions to call from this vector.
4364 This way we always call the same functions before and after the change. */
4365 static Lisp_Object last_overlay_modification_hooks;
4367 /* Number of elements actually used in last_overlay_modification_hooks. */
4368 static ptrdiff_t last_overlay_modification_hooks_used;
4370 /* Add one functionlist/overlay pair
4371 to the end of last_overlay_modification_hooks. */
4373 static void
4374 add_overlay_mod_hooklist (Lisp_Object functionlist, Lisp_Object overlay)
4376 ptrdiff_t oldsize = ASIZE (last_overlay_modification_hooks);
4378 if (oldsize - 1 <= last_overlay_modification_hooks_used)
4379 last_overlay_modification_hooks =
4380 larger_vector (last_overlay_modification_hooks, 2, -1);
4381 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4382 functionlist); last_overlay_modification_hooks_used++;
4383 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4384 overlay); last_overlay_modification_hooks_used++;
4387 /* Run the modification-hooks of overlays that include
4388 any part of the text in START to END.
4389 If this change is an insertion, also
4390 run the insert-before-hooks of overlay starting at END,
4391 and the insert-after-hooks of overlay ending at START.
4393 This is called both before and after the modification.
4394 AFTER is true when we call after the modification.
4396 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
4397 When AFTER is nonzero, they are the start position,
4398 the position after the inserted new text,
4399 and the length of deleted or replaced old text. */
4401 void
4402 report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after,
4403 Lisp_Object arg1, Lisp_Object arg2, Lisp_Object arg3)
4405 Lisp_Object prop, overlay;
4406 struct Lisp_Overlay *tail;
4407 /* True if this change is an insertion. */
4408 bool insertion = (after ? XFASTINT (arg3) == 0 : EQ (start, end));
4409 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4411 overlay = Qnil;
4412 tail = NULL;
4414 /* We used to run the functions as soon as we found them and only register
4415 them in last_overlay_modification_hooks for the purpose of the `after'
4416 case. But running elisp code as we traverse the list of overlays is
4417 painful because the list can be modified by the elisp code so we had to
4418 copy at several places. We now simply do a read-only traversal that
4419 only collects the functions to run and we run them afterwards. It's
4420 simpler, especially since all the code was already there. -stef */
4422 if (!after)
4424 /* We are being called before a change.
4425 Scan the overlays to find the functions to call. */
4426 last_overlay_modification_hooks_used = 0;
4427 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4429 ptrdiff_t startpos, endpos;
4430 Lisp_Object ostart, oend;
4432 XSETMISC (overlay, tail);
4434 ostart = OVERLAY_START (overlay);
4435 oend = OVERLAY_END (overlay);
4436 endpos = OVERLAY_POSITION (oend);
4437 if (XFASTINT (start) > endpos)
4438 break;
4439 startpos = OVERLAY_POSITION (ostart);
4440 if (insertion && (XFASTINT (start) == startpos
4441 || XFASTINT (end) == startpos))
4443 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4444 if (!NILP (prop))
4445 add_overlay_mod_hooklist (prop, overlay);
4447 if (insertion && (XFASTINT (start) == endpos
4448 || XFASTINT (end) == endpos))
4450 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4451 if (!NILP (prop))
4452 add_overlay_mod_hooklist (prop, overlay);
4454 /* Test for intersecting intervals. This does the right thing
4455 for both insertion and deletion. */
4456 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4458 prop = Foverlay_get (overlay, Qmodification_hooks);
4459 if (!NILP (prop))
4460 add_overlay_mod_hooklist (prop, overlay);
4464 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4466 ptrdiff_t startpos, endpos;
4467 Lisp_Object ostart, oend;
4469 XSETMISC (overlay, tail);
4471 ostart = OVERLAY_START (overlay);
4472 oend = OVERLAY_END (overlay);
4473 startpos = OVERLAY_POSITION (ostart);
4474 endpos = OVERLAY_POSITION (oend);
4475 if (XFASTINT (end) < startpos)
4476 break;
4477 if (insertion && (XFASTINT (start) == startpos
4478 || XFASTINT (end) == startpos))
4480 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4481 if (!NILP (prop))
4482 add_overlay_mod_hooklist (prop, overlay);
4484 if (insertion && (XFASTINT (start) == endpos
4485 || XFASTINT (end) == endpos))
4487 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4488 if (!NILP (prop))
4489 add_overlay_mod_hooklist (prop, overlay);
4491 /* Test for intersecting intervals. This does the right thing
4492 for both insertion and deletion. */
4493 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4495 prop = Foverlay_get (overlay, Qmodification_hooks);
4496 if (!NILP (prop))
4497 add_overlay_mod_hooklist (prop, overlay);
4502 GCPRO4 (overlay, arg1, arg2, arg3);
4504 /* Call the functions recorded in last_overlay_modification_hooks.
4505 First copy the vector contents, in case some of these hooks
4506 do subsequent modification of the buffer. */
4507 ptrdiff_t size = last_overlay_modification_hooks_used;
4508 Lisp_Object *copy = alloca (size * sizeof *copy);
4509 ptrdiff_t i;
4511 memcpy (copy, XVECTOR (last_overlay_modification_hooks)->contents,
4512 size * word_size);
4513 gcpro1.var = copy;
4514 gcpro1.nvars = size;
4516 for (i = 0; i < size;)
4518 Lisp_Object prop_i, overlay_i;
4519 prop_i = copy[i++];
4520 overlay_i = copy[i++];
4521 call_overlay_mod_hooks (prop_i, overlay_i, after, arg1, arg2, arg3);
4524 UNGCPRO;
4527 static void
4528 call_overlay_mod_hooks (Lisp_Object list, Lisp_Object overlay, bool after,
4529 Lisp_Object arg1, Lisp_Object arg2, Lisp_Object arg3)
4531 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4533 GCPRO4 (list, arg1, arg2, arg3);
4535 while (CONSP (list))
4537 if (NILP (arg3))
4538 call4 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2);
4539 else
4540 call5 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2, arg3);
4541 list = XCDR (list);
4543 UNGCPRO;
4546 /* Delete any zero-sized overlays at position POS, if the `evaporate'
4547 property is set. */
4548 void
4549 evaporate_overlays (ptrdiff_t pos)
4551 Lisp_Object overlay, hit_list;
4552 struct Lisp_Overlay *tail;
4554 hit_list = Qnil;
4555 if (pos <= current_buffer->overlay_center)
4556 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4558 ptrdiff_t endpos;
4559 XSETMISC (overlay, tail);
4560 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
4561 if (endpos < pos)
4562 break;
4563 if (endpos == pos && OVERLAY_POSITION (OVERLAY_START (overlay)) == pos
4564 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4565 hit_list = Fcons (overlay, hit_list);
4567 else
4568 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4570 ptrdiff_t startpos;
4571 XSETMISC (overlay, tail);
4572 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
4573 if (startpos > pos)
4574 break;
4575 if (startpos == pos && OVERLAY_POSITION (OVERLAY_END (overlay)) == pos
4576 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4577 hit_list = Fcons (overlay, hit_list);
4579 for (; CONSP (hit_list); hit_list = XCDR (hit_list))
4580 Fdelete_overlay (XCAR (hit_list));
4583 /* Somebody has tried to store a value with an unacceptable type
4584 in the slot with offset OFFSET. */
4586 void
4587 buffer_slot_type_mismatch (Lisp_Object newval, int type)
4589 Lisp_Object predicate;
4591 switch (type)
4593 case_Lisp_Int: predicate = Qintegerp; break;
4594 case Lisp_String: predicate = Qstringp; break;
4595 case Lisp_Symbol: predicate = Qsymbolp; break;
4596 default: emacs_abort ();
4599 wrong_type_argument (predicate, newval);
4603 /***********************************************************************
4604 Allocation with mmap
4605 ***********************************************************************/
4607 #ifdef USE_MMAP_FOR_BUFFERS
4609 #include <sys/types.h>
4610 #include <sys/mman.h>
4612 #ifndef MAP_ANON
4613 #ifdef MAP_ANONYMOUS
4614 #define MAP_ANON MAP_ANONYMOUS
4615 #else
4616 #define MAP_ANON 0
4617 #endif
4618 #endif
4620 #ifndef MAP_FAILED
4621 #define MAP_FAILED ((void *) -1)
4622 #endif
4624 #include <stdio.h>
4626 #if MAP_ANON == 0
4627 #include <fcntl.h>
4628 #endif
4630 #include "coding.h"
4633 /* Memory is allocated in regions which are mapped using mmap(2).
4634 The current implementation lets the system select mapped
4635 addresses; we're not using MAP_FIXED in general, except when
4636 trying to enlarge regions.
4638 Each mapped region starts with a mmap_region structure, the user
4639 area starts after that structure, aligned to MEM_ALIGN.
4641 +-----------------------+
4642 | struct mmap_info + |
4643 | padding |
4644 +-----------------------+
4645 | user data |
4648 +-----------------------+ */
4650 struct mmap_region
4652 /* User-specified size. */
4653 size_t nbytes_specified;
4655 /* Number of bytes mapped */
4656 size_t nbytes_mapped;
4658 /* Pointer to the location holding the address of the memory
4659 allocated with the mmap'd block. The variable actually points
4660 after this structure. */
4661 void **var;
4663 /* Next and previous in list of all mmap'd regions. */
4664 struct mmap_region *next, *prev;
4667 /* Doubly-linked list of mmap'd regions. */
4669 static struct mmap_region *mmap_regions;
4671 /* File descriptor for mmap. If we don't have anonymous mapping,
4672 /dev/zero will be opened on it. */
4674 static int mmap_fd;
4676 /* Temporary storage for mmap_set_vars, see there. */
4678 static struct mmap_region *mmap_regions_1;
4679 static int mmap_fd_1;
4681 /* Page size on this system. */
4683 static int mmap_page_size;
4685 /* 1 means mmap has been initialized. */
4687 static bool mmap_initialized_p;
4689 /* Value is X rounded up to the next multiple of N. */
4691 #define ROUND(X, N) (((X) + (N) - 1) / (N) * (N))
4693 /* Size of mmap_region structure plus padding. */
4695 #define MMAP_REGION_STRUCT_SIZE \
4696 ROUND (sizeof (struct mmap_region), MEM_ALIGN)
4698 /* Given a pointer P to the start of the user-visible part of a mapped
4699 region, return a pointer to the start of the region. */
4701 #define MMAP_REGION(P) \
4702 ((struct mmap_region *) ((char *) (P) - MMAP_REGION_STRUCT_SIZE))
4704 /* Given a pointer P to the start of a mapped region, return a pointer
4705 to the start of the user-visible part of the region. */
4707 #define MMAP_USER_AREA(P) \
4708 ((void *) ((char *) (P) + MMAP_REGION_STRUCT_SIZE))
4710 #define MEM_ALIGN sizeof (double)
4712 /* Predicate returning true if part of the address range [START .. END]
4713 is currently mapped. Used to prevent overwriting an existing
4714 memory mapping.
4716 Default is to conservatively assume the address range is occupied by
4717 something else. This can be overridden by system configuration
4718 files if system-specific means to determine this exists. */
4720 #ifndef MMAP_ALLOCATED_P
4721 #define MMAP_ALLOCATED_P(start, end) 1
4722 #endif
4724 /* Perform necessary initializations for the use of mmap. */
4726 static void
4727 mmap_init (void)
4729 #if MAP_ANON == 0
4730 /* The value of mmap_fd is initially 0 in temacs, and -1
4731 in a dumped Emacs. */
4732 if (mmap_fd <= 0)
4734 /* No anonymous mmap -- we need the file descriptor. */
4735 mmap_fd = open ("/dev/zero", O_RDONLY);
4736 if (mmap_fd == -1)
4737 fatal ("Cannot open /dev/zero: %s", emacs_strerror (errno));
4739 #endif /* MAP_ANON == 0 */
4741 if (mmap_initialized_p)
4742 return;
4743 mmap_initialized_p = 1;
4745 #if MAP_ANON != 0
4746 mmap_fd = -1;
4747 #endif
4749 mmap_page_size = getpagesize ();
4752 /* Return a region overlapping address range START...END, or null if
4753 none. END is not including, i.e. the last byte in the range
4754 is at END - 1. */
4756 static struct mmap_region *
4757 mmap_find (void *start, void *end)
4759 struct mmap_region *r;
4760 char *s = (char *) start, *e = (char *) end;
4762 for (r = mmap_regions; r; r = r->next)
4764 char *rstart = (char *) r;
4765 char *rend = rstart + r->nbytes_mapped;
4767 if (/* First byte of range, i.e. START, in this region? */
4768 (s >= rstart && s < rend)
4769 /* Last byte of range, i.e. END - 1, in this region? */
4770 || (e > rstart && e <= rend)
4771 /* First byte of this region in the range? */
4772 || (rstart >= s && rstart < e)
4773 /* Last byte of this region in the range? */
4774 || (rend > s && rend <= e))
4775 break;
4778 return r;
4782 /* Unmap a region. P is a pointer to the start of the user-araa of
4783 the region. */
4785 static void
4786 mmap_free_1 (struct mmap_region *r)
4788 if (r->next)
4789 r->next->prev = r->prev;
4790 if (r->prev)
4791 r->prev->next = r->next;
4792 else
4793 mmap_regions = r->next;
4795 if (munmap (r, r->nbytes_mapped) == -1)
4796 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4800 /* Enlarge region R by NPAGES pages. NPAGES < 0 means shrink R.
4801 Value is true if successful. */
4803 static bool
4804 mmap_enlarge (struct mmap_region *r, int npages)
4806 char *region_end = (char *) r + r->nbytes_mapped;
4807 size_t nbytes;
4808 bool success = 0;
4810 if (npages < 0)
4812 /* Unmap pages at the end of the region. */
4813 nbytes = - npages * mmap_page_size;
4814 if (munmap (region_end - nbytes, nbytes) == -1)
4815 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4816 else
4818 r->nbytes_mapped -= nbytes;
4819 success = 1;
4822 else if (npages > 0)
4824 nbytes = npages * mmap_page_size;
4826 /* Try to map additional pages at the end of the region. We
4827 cannot do this if the address range is already occupied by
4828 something else because mmap deletes any previous mapping.
4829 I'm not sure this is worth doing, let's see. */
4830 if (!MMAP_ALLOCATED_P (region_end, region_end + nbytes))
4832 void *p;
4834 p = mmap (region_end, nbytes, PROT_READ | PROT_WRITE,
4835 MAP_ANON | MAP_PRIVATE | MAP_FIXED, mmap_fd, 0);
4836 if (p == MAP_FAILED)
4837 ; /* fprintf (stderr, "mmap: %s\n", emacs_strerror (errno)); */
4838 else if (p != region_end)
4840 /* Kernels are free to choose a different address. In
4841 that case, unmap what we've mapped above; we have
4842 no use for it. */
4843 if (munmap (p, nbytes) == -1)
4844 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4846 else
4848 r->nbytes_mapped += nbytes;
4849 success = 1;
4854 return success;
4858 /* Set or reset variables holding references to mapped regions.
4859 If not RESTORE_P, set all variables to null. If RESTORE_P, set all
4860 variables to the start of the user-areas of mapped regions.
4862 This function is called from Fdump_emacs to ensure that the dumped
4863 Emacs doesn't contain references to memory that won't be mapped
4864 when Emacs starts. */
4866 void
4867 mmap_set_vars (bool restore_p)
4869 struct mmap_region *r;
4871 if (restore_p)
4873 mmap_regions = mmap_regions_1;
4874 mmap_fd = mmap_fd_1;
4875 for (r = mmap_regions; r; r = r->next)
4876 *r->var = MMAP_USER_AREA (r);
4878 else
4880 for (r = mmap_regions; r; r = r->next)
4881 *r->var = NULL;
4882 mmap_regions_1 = mmap_regions;
4883 mmap_regions = NULL;
4884 mmap_fd_1 = mmap_fd;
4885 mmap_fd = -1;
4890 /* Allocate a block of storage large enough to hold NBYTES bytes of
4891 data. A pointer to the data is returned in *VAR. VAR is thus the
4892 address of some variable which will use the data area.
4894 The allocation of 0 bytes is valid.
4896 If we can't allocate the necessary memory, set *VAR to null, and
4897 return null. */
4899 static void *
4900 mmap_alloc (void **var, size_t nbytes)
4902 void *p;
4903 size_t map;
4905 mmap_init ();
4907 map = ROUND (nbytes + MMAP_REGION_STRUCT_SIZE, mmap_page_size);
4908 p = mmap (NULL, map, PROT_READ | PROT_WRITE, MAP_ANON | MAP_PRIVATE,
4909 mmap_fd, 0);
4911 if (p == MAP_FAILED)
4913 if (errno != ENOMEM)
4914 fprintf (stderr, "mmap: %s\n", emacs_strerror (errno));
4915 p = NULL;
4917 else
4919 struct mmap_region *r = (struct mmap_region *) p;
4921 r->nbytes_specified = nbytes;
4922 r->nbytes_mapped = map;
4923 r->var = var;
4924 r->prev = NULL;
4925 r->next = mmap_regions;
4926 if (r->next)
4927 r->next->prev = r;
4928 mmap_regions = r;
4930 p = MMAP_USER_AREA (p);
4933 return *var = p;
4937 /* Free a block of relocatable storage whose data is pointed to by
4938 PTR. Store 0 in *PTR to show there's no block allocated. */
4940 static void
4941 mmap_free (void **var)
4943 mmap_init ();
4945 if (*var)
4947 mmap_free_1 (MMAP_REGION (*var));
4948 *var = NULL;
4953 /* Given a pointer at address VAR to data allocated with mmap_alloc,
4954 resize it to size NBYTES. Change *VAR to reflect the new block,
4955 and return this value. If more memory cannot be allocated, then
4956 leave *VAR unchanged, and return null. */
4958 static void *
4959 mmap_realloc (void **var, size_t nbytes)
4961 void *result;
4963 mmap_init ();
4965 if (*var == NULL)
4966 result = mmap_alloc (var, nbytes);
4967 else if (nbytes == 0)
4969 mmap_free (var);
4970 result = mmap_alloc (var, nbytes);
4972 else
4974 struct mmap_region *r = MMAP_REGION (*var);
4975 size_t room = r->nbytes_mapped - MMAP_REGION_STRUCT_SIZE;
4977 if (room < nbytes)
4979 /* Must enlarge. */
4980 void *old_ptr = *var;
4982 /* Try to map additional pages at the end of the region.
4983 If that fails, allocate a new region, copy data
4984 from the old region, then free it. */
4985 if (mmap_enlarge (r, (ROUND (nbytes - room, mmap_page_size)
4986 / mmap_page_size)))
4988 r->nbytes_specified = nbytes;
4989 *var = result = old_ptr;
4991 else if (mmap_alloc (var, nbytes))
4993 memcpy (*var, old_ptr, r->nbytes_specified);
4994 mmap_free_1 (MMAP_REGION (old_ptr));
4995 result = *var;
4996 r = MMAP_REGION (result);
4997 r->nbytes_specified = nbytes;
4999 else
5001 *var = old_ptr;
5002 result = NULL;
5005 else if (room - nbytes >= mmap_page_size)
5007 /* Shrinking by at least a page. Let's give some
5008 memory back to the system.
5010 The extra parens are to make the division happens first,
5011 on positive values, so we know it will round towards
5012 zero. */
5013 mmap_enlarge (r, - ((room - nbytes) / mmap_page_size));
5014 result = *var;
5015 r->nbytes_specified = nbytes;
5017 else
5019 /* Leave it alone. */
5020 result = *var;
5021 r->nbytes_specified = nbytes;
5025 return result;
5029 #endif /* USE_MMAP_FOR_BUFFERS */
5033 /***********************************************************************
5034 Buffer-text Allocation
5035 ***********************************************************************/
5037 /* Allocate NBYTES bytes for buffer B's text buffer. */
5039 static void
5040 alloc_buffer_text (struct buffer *b, ptrdiff_t nbytes)
5042 void *p;
5044 block_input ();
5045 #if defined USE_MMAP_FOR_BUFFERS
5046 p = mmap_alloc ((void **) &b->text->beg, nbytes);
5047 #elif defined REL_ALLOC
5048 p = r_alloc ((void **) &b->text->beg, nbytes);
5049 #else
5050 p = xmalloc (nbytes);
5051 #endif
5053 if (p == NULL)
5055 unblock_input ();
5056 memory_full (nbytes);
5059 b->text->beg = (unsigned char *) p;
5060 unblock_input ();
5063 /* Enlarge buffer B's text buffer by DELTA bytes. DELTA < 0 means
5064 shrink it. */
5066 void
5067 enlarge_buffer_text (struct buffer *b, ptrdiff_t delta)
5069 void *p;
5070 ptrdiff_t nbytes = (BUF_Z_BYTE (b) - BUF_BEG_BYTE (b) + BUF_GAP_SIZE (b) + 1
5071 + delta);
5072 block_input ();
5073 #if defined USE_MMAP_FOR_BUFFERS
5074 p = mmap_realloc ((void **) &b->text->beg, nbytes);
5075 #elif defined REL_ALLOC
5076 p = r_re_alloc ((void **) &b->text->beg, nbytes);
5077 #else
5078 p = xrealloc (b->text->beg, nbytes);
5079 #endif
5081 if (p == NULL)
5083 unblock_input ();
5084 memory_full (nbytes);
5087 BUF_BEG_ADDR (b) = (unsigned char *) p;
5088 unblock_input ();
5092 /* Free buffer B's text buffer. */
5094 static void
5095 free_buffer_text (struct buffer *b)
5097 block_input ();
5099 #if defined USE_MMAP_FOR_BUFFERS
5100 mmap_free ((void **) &b->text->beg);
5101 #elif defined REL_ALLOC
5102 r_alloc_free ((void **) &b->text->beg);
5103 #else
5104 xfree (b->text->beg);
5105 #endif
5107 BUF_BEG_ADDR (b) = NULL;
5108 unblock_input ();
5113 /***********************************************************************
5114 Initialization
5115 ***********************************************************************/
5117 void
5118 init_buffer_once (void)
5120 int idx;
5122 memset (buffer_permanent_local_flags, 0, sizeof buffer_permanent_local_flags);
5124 /* Make sure all markable slots in buffer_defaults
5125 are initialized reasonably, so mark_buffer won't choke. */
5126 reset_buffer (&buffer_defaults);
5127 eassert (EQ (BVAR (&buffer_defaults, name), make_number (0)));
5128 reset_buffer_local_variables (&buffer_defaults, 1);
5129 eassert (EQ (BVAR (&buffer_local_symbols, name), make_number (0)));
5130 reset_buffer (&buffer_local_symbols);
5131 reset_buffer_local_variables (&buffer_local_symbols, 1);
5132 /* Prevent GC from getting confused. */
5133 buffer_defaults.text = &buffer_defaults.own_text;
5134 buffer_local_symbols.text = &buffer_local_symbols.own_text;
5135 /* No one will share the text with these buffers, but let's play it safe. */
5136 buffer_defaults.indirections = 0;
5137 buffer_local_symbols.indirections = 0;
5138 /* Likewise no one will display them. */
5139 buffer_defaults.window_count = 0;
5140 buffer_local_symbols.window_count = 0;
5141 set_buffer_intervals (&buffer_defaults, NULL);
5142 set_buffer_intervals (&buffer_local_symbols, NULL);
5143 /* This is not strictly necessary, but let's make them initialized. */
5144 bset_name (&buffer_defaults, build_pure_c_string (" *buffer-defaults*"));
5145 bset_name (&buffer_local_symbols, build_pure_c_string (" *buffer-local-symbols*"));
5146 BUFFER_PVEC_INIT (&buffer_defaults);
5147 BUFFER_PVEC_INIT (&buffer_local_symbols);
5149 /* Set up the default values of various buffer slots. */
5150 /* Must do these before making the first buffer! */
5152 /* real setup is done in bindings.el */
5153 bset_mode_line_format (&buffer_defaults, build_pure_c_string ("%-"));
5154 bset_header_line_format (&buffer_defaults, Qnil);
5155 bset_abbrev_mode (&buffer_defaults, Qnil);
5156 bset_overwrite_mode (&buffer_defaults, Qnil);
5157 bset_case_fold_search (&buffer_defaults, Qt);
5158 bset_auto_fill_function (&buffer_defaults, Qnil);
5159 bset_selective_display (&buffer_defaults, Qnil);
5160 bset_selective_display_ellipses (&buffer_defaults, Qt);
5161 bset_abbrev_table (&buffer_defaults, Qnil);
5162 bset_display_table (&buffer_defaults, Qnil);
5163 bset_undo_list (&buffer_defaults, Qnil);
5164 bset_mark_active (&buffer_defaults, Qnil);
5165 bset_file_format (&buffer_defaults, Qnil);
5166 bset_auto_save_file_format (&buffer_defaults, Qt);
5167 set_buffer_overlays_before (&buffer_defaults, NULL);
5168 set_buffer_overlays_after (&buffer_defaults, NULL);
5169 buffer_defaults.overlay_center = BEG;
5171 XSETFASTINT (BVAR (&buffer_defaults, tab_width), 8);
5172 bset_truncate_lines (&buffer_defaults, Qnil);
5173 bset_word_wrap (&buffer_defaults, Qnil);
5174 bset_ctl_arrow (&buffer_defaults, Qt);
5175 bset_bidi_display_reordering (&buffer_defaults, Qt);
5176 bset_bidi_paragraph_direction (&buffer_defaults, Qnil);
5177 bset_cursor_type (&buffer_defaults, Qt);
5178 bset_extra_line_spacing (&buffer_defaults, Qnil);
5179 bset_cursor_in_non_selected_windows (&buffer_defaults, Qt);
5181 bset_enable_multibyte_characters (&buffer_defaults, Qt);
5182 bset_buffer_file_coding_system (&buffer_defaults, Qnil);
5183 XSETFASTINT (BVAR (&buffer_defaults, fill_column), 70);
5184 XSETFASTINT (BVAR (&buffer_defaults, left_margin), 0);
5185 bset_cache_long_line_scans (&buffer_defaults, Qnil);
5186 bset_file_truename (&buffer_defaults, Qnil);
5187 XSETFASTINT (BVAR (&buffer_defaults, display_count), 0);
5188 XSETFASTINT (BVAR (&buffer_defaults, left_margin_cols), 0);
5189 XSETFASTINT (BVAR (&buffer_defaults, right_margin_cols), 0);
5190 bset_left_fringe_width (&buffer_defaults, Qnil);
5191 bset_right_fringe_width (&buffer_defaults, Qnil);
5192 bset_fringes_outside_margins (&buffer_defaults, Qnil);
5193 bset_scroll_bar_width (&buffer_defaults, Qnil);
5194 bset_vertical_scroll_bar_type (&buffer_defaults, Qt);
5195 bset_indicate_empty_lines (&buffer_defaults, Qnil);
5196 bset_indicate_buffer_boundaries (&buffer_defaults, Qnil);
5197 bset_fringe_indicator_alist (&buffer_defaults, Qnil);
5198 bset_fringe_cursor_alist (&buffer_defaults, Qnil);
5199 bset_scroll_up_aggressively (&buffer_defaults, Qnil);
5200 bset_scroll_down_aggressively (&buffer_defaults, Qnil);
5201 bset_display_time (&buffer_defaults, Qnil);
5203 /* Assign the local-flags to the slots that have default values.
5204 The local flag is a bit that is used in the buffer
5205 to say that it has its own local value for the slot.
5206 The local flag bits are in the local_var_flags slot of the buffer. */
5208 /* Nothing can work if this isn't true */
5209 { verify (sizeof (EMACS_INT) == word_size); }
5211 /* 0 means not a lisp var, -1 means always local, else mask */
5212 memset (&buffer_local_flags, 0, sizeof buffer_local_flags);
5213 bset_filename (&buffer_local_flags, make_number (-1));
5214 bset_directory (&buffer_local_flags, make_number (-1));
5215 bset_backed_up (&buffer_local_flags, make_number (-1));
5216 bset_save_length (&buffer_local_flags, make_number (-1));
5217 bset_auto_save_file_name (&buffer_local_flags, make_number (-1));
5218 bset_read_only (&buffer_local_flags, make_number (-1));
5219 bset_major_mode (&buffer_local_flags, make_number (-1));
5220 bset_mode_name (&buffer_local_flags, make_number (-1));
5221 bset_undo_list (&buffer_local_flags, make_number (-1));
5222 bset_mark_active (&buffer_local_flags, make_number (-1));
5223 bset_point_before_scroll (&buffer_local_flags, make_number (-1));
5224 bset_file_truename (&buffer_local_flags, make_number (-1));
5225 bset_invisibility_spec (&buffer_local_flags, make_number (-1));
5226 bset_file_format (&buffer_local_flags, make_number (-1));
5227 bset_auto_save_file_format (&buffer_local_flags, make_number (-1));
5228 bset_display_count (&buffer_local_flags, make_number (-1));
5229 bset_display_time (&buffer_local_flags, make_number (-1));
5230 bset_enable_multibyte_characters (&buffer_local_flags, make_number (-1));
5232 idx = 1;
5233 XSETFASTINT (BVAR (&buffer_local_flags, mode_line_format), idx); ++idx;
5234 XSETFASTINT (BVAR (&buffer_local_flags, abbrev_mode), idx); ++idx;
5235 XSETFASTINT (BVAR (&buffer_local_flags, overwrite_mode), idx); ++idx;
5236 XSETFASTINT (BVAR (&buffer_local_flags, case_fold_search), idx); ++idx;
5237 XSETFASTINT (BVAR (&buffer_local_flags, auto_fill_function), idx); ++idx;
5238 XSETFASTINT (BVAR (&buffer_local_flags, selective_display), idx); ++idx;
5239 XSETFASTINT (BVAR (&buffer_local_flags, selective_display_ellipses), idx); ++idx;
5240 XSETFASTINT (BVAR (&buffer_local_flags, tab_width), idx); ++idx;
5241 XSETFASTINT (BVAR (&buffer_local_flags, truncate_lines), idx); ++idx;
5242 XSETFASTINT (BVAR (&buffer_local_flags, word_wrap), idx); ++idx;
5243 XSETFASTINT (BVAR (&buffer_local_flags, ctl_arrow), idx); ++idx;
5244 XSETFASTINT (BVAR (&buffer_local_flags, fill_column), idx); ++idx;
5245 XSETFASTINT (BVAR (&buffer_local_flags, left_margin), idx); ++idx;
5246 XSETFASTINT (BVAR (&buffer_local_flags, abbrev_table), idx); ++idx;
5247 XSETFASTINT (BVAR (&buffer_local_flags, display_table), idx); ++idx;
5248 XSETFASTINT (BVAR (&buffer_local_flags, syntax_table), idx); ++idx;
5249 XSETFASTINT (BVAR (&buffer_local_flags, cache_long_line_scans), idx); ++idx;
5250 XSETFASTINT (BVAR (&buffer_local_flags, category_table), idx); ++idx;
5251 XSETFASTINT (BVAR (&buffer_local_flags, bidi_display_reordering), idx); ++idx;
5252 XSETFASTINT (BVAR (&buffer_local_flags, bidi_paragraph_direction), idx); ++idx;
5253 XSETFASTINT (BVAR (&buffer_local_flags, buffer_file_coding_system), idx);
5254 /* Make this one a permanent local. */
5255 buffer_permanent_local_flags[idx++] = 1;
5256 XSETFASTINT (BVAR (&buffer_local_flags, left_margin_cols), idx); ++idx;
5257 XSETFASTINT (BVAR (&buffer_local_flags, right_margin_cols), idx); ++idx;
5258 XSETFASTINT (BVAR (&buffer_local_flags, left_fringe_width), idx); ++idx;
5259 XSETFASTINT (BVAR (&buffer_local_flags, right_fringe_width), idx); ++idx;
5260 XSETFASTINT (BVAR (&buffer_local_flags, fringes_outside_margins), idx); ++idx;
5261 XSETFASTINT (BVAR (&buffer_local_flags, scroll_bar_width), idx); ++idx;
5262 XSETFASTINT (BVAR (&buffer_local_flags, vertical_scroll_bar_type), idx); ++idx;
5263 XSETFASTINT (BVAR (&buffer_local_flags, indicate_empty_lines), idx); ++idx;
5264 XSETFASTINT (BVAR (&buffer_local_flags, indicate_buffer_boundaries), idx); ++idx;
5265 XSETFASTINT (BVAR (&buffer_local_flags, fringe_indicator_alist), idx); ++idx;
5266 XSETFASTINT (BVAR (&buffer_local_flags, fringe_cursor_alist), idx); ++idx;
5267 XSETFASTINT (BVAR (&buffer_local_flags, scroll_up_aggressively), idx); ++idx;
5268 XSETFASTINT (BVAR (&buffer_local_flags, scroll_down_aggressively), idx); ++idx;
5269 XSETFASTINT (BVAR (&buffer_local_flags, header_line_format), idx); ++idx;
5270 XSETFASTINT (BVAR (&buffer_local_flags, cursor_type), idx); ++idx;
5271 XSETFASTINT (BVAR (&buffer_local_flags, extra_line_spacing), idx); ++idx;
5272 XSETFASTINT (BVAR (&buffer_local_flags, cursor_in_non_selected_windows), idx); ++idx;
5274 /* Need more room? */
5275 if (idx >= MAX_PER_BUFFER_VARS)
5276 emacs_abort ();
5277 last_per_buffer_idx = idx;
5279 Vbuffer_alist = Qnil;
5280 current_buffer = 0;
5281 all_buffers = 0;
5283 QSFundamental = build_pure_c_string ("Fundamental");
5285 Qfundamental_mode = intern_c_string ("fundamental-mode");
5286 bset_major_mode (&buffer_defaults, Qfundamental_mode);
5288 Qmode_class = intern_c_string ("mode-class");
5290 Qprotected_field = intern_c_string ("protected-field");
5292 Qpermanent_local = intern_c_string ("permanent-local");
5294 Qkill_buffer_hook = intern_c_string ("kill-buffer-hook");
5295 Fput (Qkill_buffer_hook, Qpermanent_local, Qt);
5297 /* super-magic invisible buffer */
5298 Vprin1_to_string_buffer = Fget_buffer_create (build_pure_c_string (" prin1"));
5299 Vbuffer_alist = Qnil;
5301 Fset_buffer (Fget_buffer_create (build_pure_c_string ("*scratch*")));
5303 inhibit_modification_hooks = 0;
5306 void
5307 init_buffer (void)
5309 char *pwd;
5310 Lisp_Object temp;
5311 ptrdiff_t len;
5313 #ifdef USE_MMAP_FOR_BUFFERS
5315 /* When using the ralloc implementation based on mmap(2), buffer
5316 text pointers will have been set to null in the dumped Emacs.
5317 Map new memory. */
5318 struct buffer *b;
5320 FOR_EACH_BUFFER (b)
5321 if (b->text->beg == NULL)
5322 enlarge_buffer_text (b, 0);
5324 #endif /* USE_MMAP_FOR_BUFFERS */
5326 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5327 if (NILP (BVAR (&buffer_defaults, enable_multibyte_characters)))
5328 Fset_buffer_multibyte (Qnil);
5330 pwd = get_current_dir_name ();
5332 if (!pwd)
5333 fatal ("`get_current_dir_name' failed: %s\n", strerror (errno));
5335 /* Maybe this should really use some standard subroutine
5336 whose definition is filename syntax dependent. */
5337 len = strlen (pwd);
5338 if (!(IS_DIRECTORY_SEP (pwd[len - 1])))
5340 /* Grow buffer to add directory separator and '\0'. */
5341 pwd = realloc (pwd, len + 2);
5342 if (!pwd)
5343 fatal ("`get_current_dir_name' failed: %s\n", strerror (errno));
5344 pwd[len] = DIRECTORY_SEP;
5345 pwd[len + 1] = '\0';
5346 len++;
5349 bset_directory (current_buffer, make_unibyte_string (pwd, len));
5350 if (! NILP (BVAR (&buffer_defaults, enable_multibyte_characters)))
5351 /* At this moment, we still don't know how to decode the
5352 directory name. So, we keep the bytes in multibyte form so
5353 that ENCODE_FILE correctly gets the original bytes. */
5354 bset_directory
5355 (current_buffer, string_to_multibyte (BVAR (current_buffer, directory)));
5357 /* Add /: to the front of the name
5358 if it would otherwise be treated as magic. */
5359 temp = Ffind_file_name_handler (BVAR (current_buffer, directory), Qt);
5360 if (! NILP (temp)
5361 /* If the default dir is just /, TEMP is non-nil
5362 because of the ange-ftp completion handler.
5363 However, it is not necessary to turn / into /:/.
5364 So avoid doing that. */
5365 && strcmp ("/", SSDATA (BVAR (current_buffer, directory))))
5366 bset_directory
5367 (current_buffer,
5368 concat2 (build_string ("/:"), BVAR (current_buffer, directory)));
5370 temp = get_minibuffer (0);
5371 bset_directory (XBUFFER (temp), BVAR (current_buffer, directory));
5373 free (pwd);
5376 /* Similar to defvar_lisp but define a variable whose value is the Lisp
5377 Object stored in the current buffer. address is the address of the slot
5378 in the buffer that is current now. */
5380 /* TYPE is nil for a general Lisp variable.
5381 An integer specifies a type; then only Lisp values
5382 with that type code are allowed (except that nil is allowed too).
5383 LNAME is the Lisp-level variable name.
5384 VNAME is the name of the buffer slot.
5385 DOC is a dummy where you write the doc string as a comment. */
5386 #define DEFVAR_PER_BUFFER(lname, vname, type, doc) \
5387 do { \
5388 static struct Lisp_Buffer_Objfwd bo_fwd; \
5389 defvar_per_buffer (&bo_fwd, lname, vname, type); \
5390 } while (0)
5392 static void
5393 defvar_per_buffer (struct Lisp_Buffer_Objfwd *bo_fwd, const char *namestring,
5394 Lisp_Object *address, Lisp_Object type)
5396 struct Lisp_Symbol *sym;
5397 int offset;
5399 sym = XSYMBOL (intern (namestring));
5400 offset = (char *)address - (char *)current_buffer;
5402 bo_fwd->type = Lisp_Fwd_Buffer_Obj;
5403 bo_fwd->offset = offset;
5404 bo_fwd->slottype = type;
5405 sym->declared_special = 1;
5406 sym->redirect = SYMBOL_FORWARDED;
5408 /* I tried to do the job without a cast, but it seems impossible.
5409 union Lisp_Fwd *fwd; &(fwd->u_buffer_objfwd) = bo_fwd; */
5410 SET_SYMBOL_FWD (sym, (union Lisp_Fwd *)bo_fwd);
5412 XSETSYMBOL (PER_BUFFER_SYMBOL (offset), sym);
5414 if (PER_BUFFER_IDX (offset) == 0)
5415 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
5416 slot of buffer_local_flags */
5417 emacs_abort ();
5421 /* initialize the buffer routines */
5422 void
5423 syms_of_buffer (void)
5425 staticpro (&last_overlay_modification_hooks);
5426 last_overlay_modification_hooks
5427 = Fmake_vector (make_number (10), Qnil);
5429 staticpro (&Qfundamental_mode);
5430 staticpro (&Qmode_class);
5431 staticpro (&QSFundamental);
5432 staticpro (&Vbuffer_alist);
5433 staticpro (&Qprotected_field);
5434 staticpro (&Qpermanent_local);
5435 staticpro (&Qkill_buffer_hook);
5437 DEFSYM (Qpermanent_local_hook, "permanent-local-hook");
5438 DEFSYM (Qoverlayp, "overlayp");
5439 DEFSYM (Qevaporate, "evaporate");
5440 DEFSYM (Qmodification_hooks, "modification-hooks");
5441 DEFSYM (Qinsert_in_front_hooks, "insert-in-front-hooks");
5442 DEFSYM (Qinsert_behind_hooks, "insert-behind-hooks");
5443 DEFSYM (Qget_file_buffer, "get-file-buffer");
5444 DEFSYM (Qpriority, "priority");
5445 DEFSYM (Qbefore_string, "before-string");
5446 DEFSYM (Qafter_string, "after-string");
5447 DEFSYM (Qfirst_change_hook, "first-change-hook");
5448 DEFSYM (Qbefore_change_functions, "before-change-functions");
5449 DEFSYM (Qafter_change_functions, "after-change-functions");
5450 DEFSYM (Qkill_buffer_query_functions, "kill-buffer-query-functions");
5452 Fput (Qprotected_field, Qerror_conditions,
5453 listn (CONSTYPE_PURE, 2, Qprotected_field, Qerror));
5454 Fput (Qprotected_field, Qerror_message,
5455 build_pure_c_string ("Attempt to modify a protected field"));
5457 DEFVAR_BUFFER_DEFAULTS ("default-mode-line-format",
5458 mode_line_format,
5459 doc: /* Default value of `mode-line-format' for buffers that don't override it.
5460 This is the same as (default-value 'mode-line-format). */);
5462 DEFVAR_BUFFER_DEFAULTS ("default-header-line-format",
5463 header_line_format,
5464 doc: /* Default value of `header-line-format' for buffers that don't override it.
5465 This is the same as (default-value 'header-line-format). */);
5467 DEFVAR_BUFFER_DEFAULTS ("default-cursor-type", cursor_type,
5468 doc: /* Default value of `cursor-type' for buffers that don't override it.
5469 This is the same as (default-value 'cursor-type). */);
5471 DEFVAR_BUFFER_DEFAULTS ("default-line-spacing",
5472 extra_line_spacing,
5473 doc: /* Default value of `line-spacing' for buffers that don't override it.
5474 This is the same as (default-value 'line-spacing). */);
5476 DEFVAR_BUFFER_DEFAULTS ("default-cursor-in-non-selected-windows",
5477 cursor_in_non_selected_windows,
5478 doc: /* Default value of `cursor-in-non-selected-windows'.
5479 This is the same as (default-value 'cursor-in-non-selected-windows). */);
5481 DEFVAR_BUFFER_DEFAULTS ("default-abbrev-mode",
5482 abbrev_mode,
5483 doc: /* Default value of `abbrev-mode' for buffers that do not override it.
5484 This is the same as (default-value 'abbrev-mode). */);
5486 DEFVAR_BUFFER_DEFAULTS ("default-ctl-arrow",
5487 ctl_arrow,
5488 doc: /* Default value of `ctl-arrow' for buffers that do not override it.
5489 This is the same as (default-value 'ctl-arrow). */);
5491 DEFVAR_BUFFER_DEFAULTS ("default-enable-multibyte-characters",
5492 enable_multibyte_characters,
5493 doc: /* Default value of `enable-multibyte-characters' for buffers not overriding it.
5494 This is the same as (default-value 'enable-multibyte-characters). */);
5496 DEFVAR_BUFFER_DEFAULTS ("default-buffer-file-coding-system",
5497 buffer_file_coding_system,
5498 doc: /* Default value of `buffer-file-coding-system' for buffers not overriding it.
5499 This is the same as (default-value 'buffer-file-coding-system). */);
5501 DEFVAR_BUFFER_DEFAULTS ("default-truncate-lines",
5502 truncate_lines,
5503 doc: /* Default value of `truncate-lines' for buffers that do not override it.
5504 This is the same as (default-value 'truncate-lines). */);
5506 DEFVAR_BUFFER_DEFAULTS ("default-fill-column",
5507 fill_column,
5508 doc: /* Default value of `fill-column' for buffers that do not override it.
5509 This is the same as (default-value 'fill-column). */);
5511 DEFVAR_BUFFER_DEFAULTS ("default-left-margin",
5512 left_margin,
5513 doc: /* Default value of `left-margin' for buffers that do not override it.
5514 This is the same as (default-value 'left-margin). */);
5516 DEFVAR_BUFFER_DEFAULTS ("default-tab-width",
5517 tab_width,
5518 doc: /* Default value of `tab-width' for buffers that do not override it.
5519 This is the same as (default-value 'tab-width). */);
5521 DEFVAR_BUFFER_DEFAULTS ("default-case-fold-search",
5522 case_fold_search,
5523 doc: /* Default value of `case-fold-search' for buffers that don't override it.
5524 This is the same as (default-value 'case-fold-search). */);
5526 DEFVAR_BUFFER_DEFAULTS ("default-left-margin-width",
5527 left_margin_cols,
5528 doc: /* Default value of `left-margin-width' for buffers that don't override it.
5529 This is the same as (default-value 'left-margin-width). */);
5531 DEFVAR_BUFFER_DEFAULTS ("default-right-margin-width",
5532 right_margin_cols,
5533 doc: /* Default value of `right-margin-width' for buffers that don't override it.
5534 This is the same as (default-value 'right-margin-width). */);
5536 DEFVAR_BUFFER_DEFAULTS ("default-left-fringe-width",
5537 left_fringe_width,
5538 doc: /* Default value of `left-fringe-width' for buffers that don't override it.
5539 This is the same as (default-value 'left-fringe-width). */);
5541 DEFVAR_BUFFER_DEFAULTS ("default-right-fringe-width",
5542 right_fringe_width,
5543 doc: /* Default value of `right-fringe-width' for buffers that don't override it.
5544 This is the same as (default-value 'right-fringe-width). */);
5546 DEFVAR_BUFFER_DEFAULTS ("default-fringes-outside-margins",
5547 fringes_outside_margins,
5548 doc: /* Default value of `fringes-outside-margins' for buffers that don't override it.
5549 This is the same as (default-value 'fringes-outside-margins). */);
5551 DEFVAR_BUFFER_DEFAULTS ("default-scroll-bar-width",
5552 scroll_bar_width,
5553 doc: /* Default value of `scroll-bar-width' for buffers that don't override it.
5554 This is the same as (default-value 'scroll-bar-width). */);
5556 DEFVAR_BUFFER_DEFAULTS ("default-vertical-scroll-bar",
5557 vertical_scroll_bar_type,
5558 doc: /* Default value of `vertical-scroll-bar' for buffers that don't override it.
5559 This is the same as (default-value 'vertical-scroll-bar). */);
5561 DEFVAR_BUFFER_DEFAULTS ("default-indicate-empty-lines",
5562 indicate_empty_lines,
5563 doc: /* Default value of `indicate-empty-lines' for buffers that don't override it.
5564 This is the same as (default-value 'indicate-empty-lines). */);
5566 DEFVAR_BUFFER_DEFAULTS ("default-indicate-buffer-boundaries",
5567 indicate_buffer_boundaries,
5568 doc: /* Default value of `indicate-buffer-boundaries' for buffers that don't override it.
5569 This is the same as (default-value 'indicate-buffer-boundaries). */);
5571 DEFVAR_BUFFER_DEFAULTS ("default-fringe-indicator-alist",
5572 fringe_indicator_alist,
5573 doc: /* Default value of `fringe-indicator-alist' for buffers that don't override it.
5574 This is the same as (default-value 'fringe-indicator-alist'). */);
5576 DEFVAR_BUFFER_DEFAULTS ("default-fringe-cursor-alist",
5577 fringe_cursor_alist,
5578 doc: /* Default value of `fringe-cursor-alist' for buffers that don't override it.
5579 This is the same as (default-value 'fringe-cursor-alist'). */);
5581 DEFVAR_BUFFER_DEFAULTS ("default-scroll-up-aggressively",
5582 scroll_up_aggressively,
5583 doc: /* Default value of `scroll-up-aggressively'.
5584 This value applies in buffers that don't have their own local values.
5585 This is the same as (default-value 'scroll-up-aggressively). */);
5587 DEFVAR_BUFFER_DEFAULTS ("default-scroll-down-aggressively",
5588 scroll_down_aggressively,
5589 doc: /* Default value of `scroll-down-aggressively'.
5590 This value applies in buffers that don't have their own local values.
5591 This is the same as (default-value 'scroll-down-aggressively). */);
5593 DEFVAR_PER_BUFFER ("header-line-format",
5594 &BVAR (current_buffer, header_line_format),
5595 Qnil,
5596 doc: /* Analogous to `mode-line-format', but controls the header line.
5597 The header line appears, optionally, at the top of a window;
5598 the mode line appears at the bottom. */);
5600 DEFVAR_PER_BUFFER ("mode-line-format", &BVAR (current_buffer, mode_line_format),
5601 Qnil,
5602 doc: /* Template for displaying mode line for current buffer.
5604 The value may be nil, a string, a symbol or a list.
5606 A value of nil means don't display a mode line.
5608 For any symbol other than t or nil, the symbol's value is processed as
5609 a mode line construct. As a special exception, if that value is a
5610 string, the string is processed verbatim, without handling any
5611 %-constructs (see below). Also, unless the symbol has a non-nil
5612 `risky-local-variable' property, all properties in any strings, as
5613 well as all :eval and :propertize forms in the value, are ignored.
5615 A list whose car is a string or list is processed by processing each
5616 of the list elements recursively, as separate mode line constructs,
5617 and concatenating the results.
5619 A list of the form `(:eval FORM)' is processed by evaluating FORM and
5620 using the result as a mode line construct. Be careful--FORM should
5621 not load any files, because that can cause an infinite recursion.
5623 A list of the form `(:propertize ELT PROPS...)' is processed by
5624 processing ELT as the mode line construct, and adding the text
5625 properties PROPS to the result.
5627 A list whose car is a symbol is processed by examining the symbol's
5628 value, and, if that value is non-nil, processing the cadr of the list
5629 recursively; and if that value is nil, processing the caddr of the
5630 list recursively.
5632 A list whose car is an integer is processed by processing the cadr of
5633 the list, and padding (if the number is positive) or truncating (if
5634 negative) to the width specified by that number.
5636 A string is printed verbatim in the mode line except for %-constructs:
5637 %b -- print buffer name. %f -- print visited file name.
5638 %F -- print frame name.
5639 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.
5640 %& is like %*, but ignore read-only-ness.
5641 % means buffer is read-only and * means it is modified.
5642 For a modified read-only buffer, %* gives % and %+ gives *.
5643 %s -- print process status. %l -- print the current line number.
5644 %c -- print the current column number (this makes editing slower).
5645 To make the column number update correctly in all cases,
5646 `column-number-mode' must be non-nil.
5647 %i -- print the size of the buffer.
5648 %I -- like %i, but use k, M, G, etc., to abbreviate.
5649 %p -- print percent of buffer above top of window, or Top, Bot or All.
5650 %P -- print percent of buffer above bottom of window, perhaps plus Top,
5651 or print Bottom or All.
5652 %n -- print Narrow if appropriate.
5653 %t -- visited file is text or binary (if OS supports this distinction).
5654 %z -- print mnemonics of keyboard, terminal, and buffer coding systems.
5655 %Z -- like %z, but including the end-of-line format.
5656 %e -- print error message about full memory.
5657 %@ -- print @ or hyphen. @ means that default-directory is on a
5658 remote machine.
5659 %[ -- print one [ for each recursive editing level. %] similar.
5660 %% -- print %. %- -- print infinitely many dashes.
5661 Decimal digits after the % specify field width to which to pad. */);
5663 DEFVAR_BUFFER_DEFAULTS ("default-major-mode", major_mode,
5664 doc: /* Value of `major-mode' for new buffers. */);
5666 DEFVAR_PER_BUFFER ("major-mode", &BVAR (current_buffer, major_mode),
5667 make_number (Lisp_Symbol),
5668 doc: /* Symbol for current buffer's major mode.
5669 The default value (normally `fundamental-mode') affects new buffers.
5670 A value of nil means to use the current buffer's major mode, provided
5671 it is not marked as "special".
5673 When a mode is used by default, `find-file' switches to it before it
5674 reads the contents into the buffer and before it finishes setting up
5675 the buffer. Thus, the mode and its hooks should not expect certain
5676 variables such as `buffer-read-only' and `buffer-file-coding-system'
5677 to be set up. */);
5679 DEFVAR_PER_BUFFER ("mode-name", &BVAR (current_buffer, mode_name),
5680 Qnil,
5681 doc: /* Pretty name of current buffer's major mode.
5682 Usually a string, but can use any of the constructs for `mode-line-format',
5683 which see.
5684 Format with `format-mode-line' to produce a string value. */);
5686 DEFVAR_PER_BUFFER ("local-abbrev-table", &BVAR (current_buffer, abbrev_table), Qnil,
5687 doc: /* Local (mode-specific) abbrev table of current buffer. */);
5689 DEFVAR_PER_BUFFER ("abbrev-mode", &BVAR (current_buffer, abbrev_mode), Qnil,
5690 doc: /* Non-nil if Abbrev mode is enabled.
5691 Use the command `abbrev-mode' to change this variable. */);
5693 DEFVAR_PER_BUFFER ("case-fold-search", &BVAR (current_buffer, case_fold_search),
5694 Qnil,
5695 doc: /* Non-nil if searches and matches should ignore case. */);
5697 DEFVAR_PER_BUFFER ("fill-column", &BVAR (current_buffer, fill_column),
5698 make_number (Lisp_Int0),
5699 doc: /* Column beyond which automatic line-wrapping should happen.
5700 Interactively, you can set the buffer local value using \\[set-fill-column]. */);
5702 DEFVAR_PER_BUFFER ("left-margin", &BVAR (current_buffer, left_margin),
5703 make_number (Lisp_Int0),
5704 doc: /* Column for the default `indent-line-function' to indent to.
5705 Linefeed indents to this column in Fundamental mode. */);
5707 DEFVAR_PER_BUFFER ("tab-width", &BVAR (current_buffer, tab_width),
5708 make_number (Lisp_Int0),
5709 doc: /* Distance between tab stops (for display of tab characters), in columns.
5710 This should be an integer greater than zero. */);
5712 DEFVAR_PER_BUFFER ("ctl-arrow", &BVAR (current_buffer, ctl_arrow), Qnil,
5713 doc: /* Non-nil means display control chars with uparrow.
5714 A value of nil means use backslash and octal digits.
5715 This variable does not apply to characters whose display is specified
5716 in the current display table (if there is one). */);
5718 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
5719 &BVAR (current_buffer, enable_multibyte_characters),
5720 Qnil,
5721 doc: /* Non-nil means the buffer contents are regarded as multi-byte characters.
5722 Otherwise they are regarded as unibyte. This affects the display,
5723 file I/O and the behavior of various editing commands.
5725 This variable is buffer-local but you cannot set it directly;
5726 use the function `set-buffer-multibyte' to change a buffer's representation.
5727 See also Info node `(elisp)Text Representations'. */);
5728 XSYMBOL (intern_c_string ("enable-multibyte-characters"))->constant = 1;
5730 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
5731 &BVAR (current_buffer, buffer_file_coding_system), Qnil,
5732 doc: /* Coding system to be used for encoding the buffer contents on saving.
5733 This variable applies to saving the buffer, and also to `write-region'
5734 and other functions that use `write-region'.
5735 It does not apply to sending output to subprocesses, however.
5737 If this is nil, the buffer is saved without any code conversion
5738 unless some coding system is specified in `file-coding-system-alist'
5739 for the buffer file.
5741 If the text to be saved cannot be encoded as specified by this variable,
5742 an alternative encoding is selected by `select-safe-coding-system', which see.
5744 The variable `coding-system-for-write', if non-nil, overrides this variable.
5746 This variable is never applied to a way of decoding a file while reading it. */);
5748 DEFVAR_PER_BUFFER ("bidi-display-reordering",
5749 &BVAR (current_buffer, bidi_display_reordering), Qnil,
5750 doc: /* Non-nil means reorder bidirectional text for display in the visual order. */);
5752 DEFVAR_PER_BUFFER ("bidi-paragraph-direction",
5753 &BVAR (current_buffer, bidi_paragraph_direction), Qnil,
5754 doc: /* If non-nil, forces directionality of text paragraphs in the buffer.
5756 If this is nil (the default), the direction of each paragraph is
5757 determined by the first strong directional character of its text.
5758 The values of `right-to-left' and `left-to-right' override that.
5759 Any other value is treated as nil.
5761 This variable has no effect unless the buffer's value of
5762 \`bidi-display-reordering' is non-nil. */);
5764 DEFVAR_PER_BUFFER ("truncate-lines", &BVAR (current_buffer, truncate_lines), Qnil,
5765 doc: /* Non-nil means do not display continuation lines.
5766 Instead, give each line of text just one screen line.
5768 Note that this is overridden by the variable
5769 `truncate-partial-width-windows' if that variable is non-nil
5770 and this buffer is not full-frame width.
5772 Minibuffers set this variable to nil. */);
5774 DEFVAR_PER_BUFFER ("word-wrap", &BVAR (current_buffer, word_wrap), Qnil,
5775 doc: /* Non-nil means to use word-wrapping for continuation lines.
5776 When word-wrapping is on, continuation lines are wrapped at the space
5777 or tab character nearest to the right window edge.
5778 If nil, continuation lines are wrapped at the right screen edge.
5780 This variable has no effect if long lines are truncated (see
5781 `truncate-lines' and `truncate-partial-width-windows'). If you use
5782 word-wrapping, you might want to reduce the value of
5783 `truncate-partial-width-windows', since wrapping can make text readable
5784 in narrower windows.
5786 Instead of setting this variable directly, most users should use
5787 Visual Line mode . Visual Line mode, when enabled, sets `word-wrap'
5788 to t, and additionally redefines simple editing commands to act on
5789 visual lines rather than logical lines. See the documentation of
5790 `visual-line-mode'. */);
5792 DEFVAR_PER_BUFFER ("default-directory", &BVAR (current_buffer, directory),
5793 make_number (Lisp_String),
5794 doc: /* Name of default directory of current buffer. Should end with slash.
5795 To interactively change the default directory, use command `cd'. */);
5797 DEFVAR_PER_BUFFER ("auto-fill-function", &BVAR (current_buffer, auto_fill_function),
5798 Qnil,
5799 doc: /* Function called (if non-nil) to perform auto-fill.
5800 It is called after self-inserting any character specified in
5801 the `auto-fill-chars' table.
5802 NOTE: This variable is not a hook;
5803 its value may not be a list of functions. */);
5805 DEFVAR_PER_BUFFER ("buffer-file-name", &BVAR (current_buffer, filename),
5806 make_number (Lisp_String),
5807 doc: /* Name of file visited in current buffer, or nil if not visiting a file. */);
5809 DEFVAR_PER_BUFFER ("buffer-file-truename", &BVAR (current_buffer, file_truename),
5810 make_number (Lisp_String),
5811 doc: /* Abbreviated truename of file visited in current buffer, or nil if none.
5812 The truename of a file is calculated by `file-truename'
5813 and then abbreviated with `abbreviate-file-name'. */);
5815 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
5816 &BVAR (current_buffer, auto_save_file_name),
5817 make_number (Lisp_String),
5818 doc: /* Name of file for auto-saving current buffer.
5819 If it is nil, that means don't auto-save this buffer. */);
5821 DEFVAR_PER_BUFFER ("buffer-read-only", &BVAR (current_buffer, read_only), Qnil,
5822 doc: /* Non-nil if this buffer is read-only. */);
5824 DEFVAR_PER_BUFFER ("buffer-backed-up", &BVAR (current_buffer, backed_up), Qnil,
5825 doc: /* Non-nil if this buffer's file has been backed up.
5826 Backing up is done before the first time the file is saved. */);
5828 DEFVAR_PER_BUFFER ("buffer-saved-size", &BVAR (current_buffer, save_length),
5829 make_number (Lisp_Int0),
5830 doc: /* Length of current buffer when last read in, saved or auto-saved.
5831 0 initially.
5832 -1 means auto-saving turned off until next real save.
5834 If you set this to -2, that means don't turn off auto-saving in this buffer
5835 if its text size shrinks. If you use `buffer-swap-text' on a buffer,
5836 you probably should set this to -2 in that buffer. */);
5838 DEFVAR_PER_BUFFER ("selective-display", &BVAR (current_buffer, selective_display),
5839 Qnil,
5840 doc: /* Non-nil enables selective display.
5841 An integer N as value means display only lines
5842 that start with less than N columns of space.
5843 A value of t means that the character ^M makes itself and
5844 all the rest of the line invisible; also, when saving the buffer
5845 in a file, save the ^M as a newline. */);
5847 DEFVAR_PER_BUFFER ("selective-display-ellipses",
5848 &BVAR (current_buffer, selective_display_ellipses),
5849 Qnil,
5850 doc: /* Non-nil means display ... on previous line when a line is invisible. */);
5852 DEFVAR_PER_BUFFER ("overwrite-mode", &BVAR (current_buffer, overwrite_mode), Qnil,
5853 doc: /* Non-nil if self-insertion should replace existing text.
5854 The value should be one of `overwrite-mode-textual',
5855 `overwrite-mode-binary', or nil.
5856 If it is `overwrite-mode-textual', self-insertion still
5857 inserts at the end of a line, and inserts when point is before a tab,
5858 until the tab is filled in.
5859 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too. */);
5861 DEFVAR_PER_BUFFER ("buffer-display-table", &BVAR (current_buffer, display_table),
5862 Qnil,
5863 doc: /* Display table that controls display of the contents of current buffer.
5865 If this variable is nil, the value of `standard-display-table' is used.
5866 Each window can have its own, overriding display table, see
5867 `set-window-display-table' and `window-display-table'.
5869 The display table is a char-table created with `make-display-table'.
5870 A char-table is an array indexed by character codes. Normal array
5871 primitives `aref' and `aset' can be used to access elements of a char-table.
5873 Each of the char-table elements control how to display the corresponding
5874 text character: the element at index C in the table says how to display
5875 the character whose code is C. Each element should be a vector of
5876 characters or nil. The value nil means display the character in the
5877 default fashion; otherwise, the characters from the vector are delivered
5878 to the screen instead of the original character.
5880 For example, (aset buffer-display-table ?X [?Y]) tells Emacs
5881 to display a capital Y instead of each X character.
5883 In addition, a char-table has six extra slots to control the display of:
5885 the end of a truncated screen line (extra-slot 0, a single character);
5886 the end of a continued line (extra-slot 1, a single character);
5887 the escape character used to display character codes in octal
5888 (extra-slot 2, a single character);
5889 the character used as an arrow for control characters (extra-slot 3,
5890 a single character);
5891 the decoration indicating the presence of invisible lines (extra-slot 4,
5892 a vector of characters);
5893 the character used to draw the border between side-by-side windows
5894 (extra-slot 5, a single character).
5896 See also the functions `display-table-slot' and `set-display-table-slot'. */);
5898 DEFVAR_PER_BUFFER ("left-margin-width", &BVAR (current_buffer, left_margin_cols),
5899 Qnil,
5900 doc: /* Width of left marginal area for display of a buffer.
5901 A value of nil means no marginal area. */);
5903 DEFVAR_PER_BUFFER ("right-margin-width", &BVAR (current_buffer, right_margin_cols),
5904 Qnil,
5905 doc: /* Width of right marginal area for display of a buffer.
5906 A value of nil means no marginal area. */);
5908 DEFVAR_PER_BUFFER ("left-fringe-width", &BVAR (current_buffer, left_fringe_width),
5909 Qnil,
5910 doc: /* Width of this buffer's left fringe (in pixels).
5911 A value of 0 means no left fringe is shown in this buffer's window.
5912 A value of nil means to use the left fringe width from the window's frame. */);
5914 DEFVAR_PER_BUFFER ("right-fringe-width", &BVAR (current_buffer, right_fringe_width),
5915 Qnil,
5916 doc: /* Width of this buffer's right fringe (in pixels).
5917 A value of 0 means no right fringe is shown in this buffer's window.
5918 A value of nil means to use the right fringe width from the window's frame. */);
5920 DEFVAR_PER_BUFFER ("fringes-outside-margins", &BVAR (current_buffer, fringes_outside_margins),
5921 Qnil,
5922 doc: /* Non-nil means to display fringes outside display margins.
5923 A value of nil means to display fringes between margins and buffer text. */);
5925 DEFVAR_PER_BUFFER ("scroll-bar-width", &BVAR (current_buffer, scroll_bar_width),
5926 Qnil,
5927 doc: /* Width of this buffer's scroll bars in pixels.
5928 A value of nil means to use the scroll bar width from the window's frame. */);
5930 DEFVAR_PER_BUFFER ("vertical-scroll-bar", &BVAR (current_buffer, vertical_scroll_bar_type),
5931 Qnil,
5932 doc: /* Position of this buffer's vertical scroll bar.
5933 The value takes effect whenever you tell a window to display this buffer;
5934 for instance, with `set-window-buffer' or when `display-buffer' displays it.
5936 A value of `left' or `right' means put the vertical scroll bar at that side
5937 of the window; a value of nil means don't show any vertical scroll bars.
5938 A value of t (the default) means do whatever the window's frame specifies. */);
5940 DEFVAR_PER_BUFFER ("indicate-empty-lines",
5941 &BVAR (current_buffer, indicate_empty_lines), Qnil,
5942 doc: /* Visually indicate empty lines after the buffer end.
5943 If non-nil, a bitmap is displayed in the left fringe of a window on
5944 window-systems. */);
5946 DEFVAR_PER_BUFFER ("indicate-buffer-boundaries",
5947 &BVAR (current_buffer, indicate_buffer_boundaries), Qnil,
5948 doc: /* Visually indicate buffer boundaries and scrolling.
5949 If non-nil, the first and last line of the buffer are marked in the fringe
5950 of a window on window-systems with angle bitmaps, or if the window can be
5951 scrolled, the top and bottom line of the window are marked with up and down
5952 arrow bitmaps.
5954 If value is a symbol `left' or `right', both angle and arrow bitmaps
5955 are displayed in the left or right fringe, resp. Any other value
5956 that doesn't look like an alist means display the angle bitmaps in
5957 the left fringe but no arrows.
5959 You can exercise more precise control by using an alist as the
5960 value. Each alist element (INDICATOR . POSITION) specifies
5961 where to show one of the indicators. INDICATOR is one of `top',
5962 `bottom', `up', `down', or t, which specifies the default position,
5963 and POSITION is one of `left', `right', or nil, meaning do not show
5964 this indicator.
5966 For example, ((top . left) (t . right)) places the top angle bitmap in
5967 left fringe, the bottom angle bitmap in right fringe, and both arrow
5968 bitmaps in right fringe. To show just the angle bitmaps in the left
5969 fringe, but no arrow bitmaps, use ((top . left) (bottom . left)). */);
5971 DEFVAR_PER_BUFFER ("fringe-indicator-alist",
5972 &BVAR (current_buffer, fringe_indicator_alist), Qnil,
5973 doc: /* Mapping from logical to physical fringe indicator bitmaps.
5974 The value is an alist where each element (INDICATOR . BITMAPS)
5975 specifies the fringe bitmaps used to display a specific logical
5976 fringe indicator.
5978 INDICATOR specifies the logical indicator type which is one of the
5979 following symbols: `truncation' , `continuation', `overlay-arrow',
5980 `top', `bottom', `top-bottom', `up', `down', empty-line', or `unknown'.
5982 BITMAPS is a list of symbols (LEFT RIGHT [LEFT1 RIGHT1]) which specifies
5983 the actual bitmap shown in the left or right fringe for the logical
5984 indicator. LEFT and RIGHT are the bitmaps shown in the left and/or
5985 right fringe for the specific indicator. The LEFT1 or RIGHT1 bitmaps
5986 are used only for the `bottom' and `top-bottom' indicators when the
5987 last (only) line has no final newline. BITMAPS may also be a single
5988 symbol which is used in both left and right fringes. */);
5990 DEFVAR_PER_BUFFER ("fringe-cursor-alist",
5991 &BVAR (current_buffer, fringe_cursor_alist), Qnil,
5992 doc: /* Mapping from logical to physical fringe cursor bitmaps.
5993 The value is an alist where each element (CURSOR . BITMAP)
5994 specifies the fringe bitmaps used to display a specific logical
5995 cursor type in the fringe.
5997 CURSOR specifies the logical cursor type which is one of the following
5998 symbols: `box' , `hollow', `bar', `hbar', or `hollow-small'. The last
5999 one is used to show a hollow cursor on narrow lines display lines
6000 where the normal hollow cursor will not fit.
6002 BITMAP is the corresponding fringe bitmap shown for the logical
6003 cursor type. */);
6005 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
6006 &BVAR (current_buffer, scroll_up_aggressively), Qnil,
6007 doc: /* How far to scroll windows upward.
6008 If you move point off the bottom, the window scrolls automatically.
6009 This variable controls how far it scrolls. The value nil, the default,
6010 means scroll to center point. A fraction means scroll to put point
6011 that fraction of the window's height from the bottom of the window.
6012 When the value is 0.0, point goes at the bottom line, which in the
6013 simple case that you moved off with C-f means scrolling just one line.
6014 1.0 means point goes at the top, so that in that simple case, the
6015 window scrolls by a full window height. Meaningful values are
6016 between 0.0 and 1.0, inclusive. */);
6018 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
6019 &BVAR (current_buffer, scroll_down_aggressively), Qnil,
6020 doc: /* How far to scroll windows downward.
6021 If you move point off the top, the window scrolls automatically.
6022 This variable controls how far it scrolls. The value nil, the default,
6023 means scroll to center point. A fraction means scroll to put point
6024 that fraction of the window's height from the top of the window.
6025 When the value is 0.0, point goes at the top line, which in the
6026 simple case that you moved off with C-b means scrolling just one line.
6027 1.0 means point goes at the bottom, so that in that simple case, the
6028 window scrolls by a full window height. Meaningful values are
6029 between 0.0 and 1.0, inclusive. */);
6031 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
6032 "Don't ask.");
6035 DEFVAR_LISP ("before-change-functions", Vbefore_change_functions,
6036 doc: /* List of functions to call before each text change.
6037 Two arguments are passed to each function: the positions of
6038 the beginning and end of the range of old text to be changed.
6039 \(For an insertion, the beginning and end are at the same place.)
6040 No information is given about the length of the text after the change.
6042 Buffer changes made while executing the `before-change-functions'
6043 don't call any before-change or after-change functions.
6044 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6046 If an unhandled error happens in running these functions,
6047 the variable's value remains nil. That prevents the error
6048 from happening repeatedly and making Emacs nonfunctional. */);
6049 Vbefore_change_functions = Qnil;
6051 DEFVAR_LISP ("after-change-functions", Vafter_change_functions,
6052 doc: /* List of functions to call after each text change.
6053 Three arguments are passed to each function: the positions of
6054 the beginning and end of the range of changed text,
6055 and the length in bytes of the pre-change text replaced by that range.
6056 \(For an insertion, the pre-change length is zero;
6057 for a deletion, that length is the number of bytes deleted,
6058 and the post-change beginning and end are at the same place.)
6060 Buffer changes made while executing the `after-change-functions'
6061 don't call any before-change or after-change functions.
6062 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6064 If an unhandled error happens in running these functions,
6065 the variable's value remains nil. That prevents the error
6066 from happening repeatedly and making Emacs nonfunctional. */);
6067 Vafter_change_functions = Qnil;
6069 DEFVAR_LISP ("first-change-hook", Vfirst_change_hook,
6070 doc: /* A list of functions to call before changing a buffer which is unmodified.
6071 The functions are run using the `run-hooks' function. */);
6072 Vfirst_change_hook = Qnil;
6074 DEFVAR_PER_BUFFER ("buffer-undo-list", &BVAR (current_buffer, undo_list), Qnil,
6075 doc: /* List of undo entries in current buffer.
6076 Recent changes come first; older changes follow newer.
6078 An entry (BEG . END) represents an insertion which begins at
6079 position BEG and ends at position END.
6081 An entry (TEXT . POSITION) represents the deletion of the string TEXT
6082 from (abs POSITION). If POSITION is positive, point was at the front
6083 of the text being deleted; if negative, point was at the end.
6085 An entry (t HIGH LOW USEC PSEC) indicates that the buffer was previously
6086 unmodified; (HIGH LOW USEC PSEC) is in the same style as (current-time)
6087 and is the visited file's modification time, as of that time. If the
6088 modification time of the most recent save is different, this entry is
6089 obsolete.
6091 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property
6092 was modified between BEG and END. PROPERTY is the property name,
6093 and VALUE is the old value.
6095 An entry (apply FUN-NAME . ARGS) means undo the change with
6096 \(apply FUN-NAME ARGS).
6098 An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo
6099 in the active region. BEG and END is the range affected by this entry
6100 and DELTA is the number of bytes added or deleted in that range by
6101 this change.
6103 An entry (MARKER . DISTANCE) indicates that the marker MARKER
6104 was adjusted in position by the offset DISTANCE (an integer).
6106 An entry of the form POSITION indicates that point was at the buffer
6107 location given by the integer. Undoing an entry of this form places
6108 point at POSITION.
6110 Entries with value `nil' mark undo boundaries. The undo command treats
6111 the changes between two undo boundaries as a single step to be undone.
6113 If the value of the variable is t, undo information is not recorded. */);
6115 DEFVAR_PER_BUFFER ("mark-active", &BVAR (current_buffer, mark_active), Qnil,
6116 doc: /* Non-nil means the mark and region are currently active in this buffer. */);
6118 DEFVAR_PER_BUFFER ("cache-long-line-scans", &BVAR (current_buffer, cache_long_line_scans), Qnil,
6119 doc: /* Non-nil means that Emacs should use caches to handle long lines more quickly.
6121 Normally, the line-motion functions work by scanning the buffer for
6122 newlines. Columnar operations (like `move-to-column' and
6123 `compute-motion') also work by scanning the buffer, summing character
6124 widths as they go. This works well for ordinary text, but if the
6125 buffer's lines are very long (say, more than 500 characters), these
6126 motion functions will take longer to execute. Emacs may also take
6127 longer to update the display.
6129 If `cache-long-line-scans' is non-nil, these motion functions cache the
6130 results of their scans, and consult the cache to avoid rescanning
6131 regions of the buffer until the text is modified. The caches are most
6132 beneficial when they prevent the most searching---that is, when the
6133 buffer contains long lines and large regions of characters with the
6134 same, fixed screen width.
6136 When `cache-long-line-scans' is non-nil, processing short lines will
6137 become slightly slower (because of the overhead of consulting the
6138 cache), and the caches will use memory roughly proportional to the
6139 number of newlines and characters whose screen width varies.
6141 The caches require no explicit maintenance; their accuracy is
6142 maintained internally by the Emacs primitives. Enabling or disabling
6143 the cache should not affect the behavior of any of the motion
6144 functions; it should only affect their performance. */);
6146 DEFVAR_PER_BUFFER ("point-before-scroll", &BVAR (current_buffer, point_before_scroll), Qnil,
6147 doc: /* Value of point before the last series of scroll operations, or nil. */);
6149 DEFVAR_PER_BUFFER ("buffer-file-format", &BVAR (current_buffer, file_format), Qnil,
6150 doc: /* List of formats to use when saving this buffer.
6151 Formats are defined by `format-alist'. This variable is
6152 set when a file is visited. */);
6154 DEFVAR_PER_BUFFER ("buffer-auto-save-file-format",
6155 &BVAR (current_buffer, auto_save_file_format), Qnil,
6156 doc: /* Format in which to write auto-save files.
6157 Should be a list of symbols naming formats that are defined in `format-alist'.
6158 If it is t, which is the default, auto-save files are written in the
6159 same format as a regular save would use. */);
6161 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
6162 &BVAR (current_buffer, invisibility_spec), Qnil,
6163 doc: /* Invisibility spec of this buffer.
6164 The default is t, which means that text is invisible
6165 if it has a non-nil `invisible' property.
6166 If the value is a list, a text character is invisible if its `invisible'
6167 property is an element in that list (or is a list with members in common).
6168 If an element is a cons cell of the form (PROP . ELLIPSIS),
6169 then characters with property value PROP are invisible,
6170 and they have an ellipsis as well if ELLIPSIS is non-nil. */);
6172 DEFVAR_PER_BUFFER ("buffer-display-count",
6173 &BVAR (current_buffer, display_count), Qnil,
6174 doc: /* A number incremented each time this buffer is displayed in a window.
6175 The function `set-window-buffer' increments it. */);
6177 DEFVAR_PER_BUFFER ("buffer-display-time",
6178 &BVAR (current_buffer, display_time), Qnil,
6179 doc: /* Time stamp updated each time this buffer is displayed in a window.
6180 The function `set-window-buffer' updates this variable
6181 to the value obtained by calling `current-time'.
6182 If the buffer has never been shown in a window, the value is nil. */);
6184 DEFVAR_LISP ("transient-mark-mode", Vtransient_mark_mode,
6185 doc: /* Non-nil if Transient Mark mode is enabled.
6186 See the command `transient-mark-mode' for a description of this minor mode.
6188 Non-nil also enables highlighting of the region whenever the mark is active.
6189 The variable `highlight-nonselected-windows' controls whether to highlight
6190 all windows or just the selected window.
6192 Lisp programs may give this variable certain special values:
6194 - A value of `lambda' enables Transient Mark mode temporarily.
6195 It is disabled again after any subsequent action that would
6196 normally deactivate the mark (e.g. buffer modification).
6198 - A value of (only . OLDVAL) enables Transient Mark mode
6199 temporarily. After any subsequent point motion command that is
6200 not shift-translated, or any other action that would normally
6201 deactivate the mark (e.g. buffer modification), the value of
6202 `transient-mark-mode' is set to OLDVAL. */);
6203 Vtransient_mark_mode = Qnil;
6205 DEFVAR_LISP ("inhibit-read-only", Vinhibit_read_only,
6206 doc: /* Non-nil means disregard read-only status of buffers or characters.
6207 If the value is t, disregard `buffer-read-only' and all `read-only'
6208 text properties. If the value is a list, disregard `buffer-read-only'
6209 and disregard a `read-only' text property if the property value
6210 is a member of the list. */);
6211 Vinhibit_read_only = Qnil;
6213 DEFVAR_PER_BUFFER ("cursor-type", &BVAR (current_buffer, cursor_type), Qnil,
6214 doc: /* Cursor to use when this buffer is in the selected window.
6215 Values are interpreted as follows:
6217 t use the cursor specified for the frame
6218 nil don't display a cursor
6219 box display a filled box cursor
6220 hollow display a hollow box cursor
6221 bar display a vertical bar cursor with default width
6222 (bar . WIDTH) display a vertical bar cursor with width WIDTH
6223 hbar display a horizontal bar cursor with default height
6224 (hbar . HEIGHT) display a horizontal bar cursor with height HEIGHT
6225 ANYTHING ELSE display a hollow box cursor
6227 When the buffer is displayed in a non-selected window, the
6228 cursor's appearance is instead controlled by the variable
6229 `cursor-in-non-selected-windows'. */);
6231 DEFVAR_PER_BUFFER ("line-spacing",
6232 &BVAR (current_buffer, extra_line_spacing), Qnil,
6233 doc: /* Additional space to put between lines when displaying a buffer.
6234 The space is measured in pixels, and put below lines on graphic displays,
6235 see `display-graphic-p'.
6236 If value is a floating point number, it specifies the spacing relative
6237 to the default frame line height. A value of nil means add no extra space. */);
6239 DEFVAR_PER_BUFFER ("cursor-in-non-selected-windows",
6240 &BVAR (current_buffer, cursor_in_non_selected_windows), Qnil,
6241 doc: /* Non-nil means show a cursor in non-selected windows.
6242 If nil, only shows a cursor in the selected window.
6243 If t, displays a cursor related to the usual cursor type
6244 \(a solid box becomes hollow, a bar becomes a narrower bar).
6245 You can also specify the cursor type as in the `cursor-type' variable.
6246 Use Custom to set this variable and update the display." */);
6248 DEFVAR_LISP ("kill-buffer-query-functions", Vkill_buffer_query_functions,
6249 doc: /* List of functions called with no args to query before killing a buffer.
6250 The buffer being killed will be current while the functions are running.
6252 If any of them returns nil, the buffer is not killed. Functions run by
6253 this hook are supposed to not change the current buffer. */);
6254 Vkill_buffer_query_functions = Qnil;
6256 DEFVAR_LISP ("change-major-mode-hook", Vchange_major_mode_hook,
6257 doc: /* Normal hook run before changing the major mode of a buffer.
6258 The function `kill-all-local-variables' runs this before doing anything else. */);
6259 Vchange_major_mode_hook = Qnil;
6260 DEFSYM (Qchange_major_mode_hook, "change-major-mode-hook");
6262 DEFVAR_LISP ("buffer-list-update-hook", Vbuffer_list_update_hook,
6263 doc: /* Hook run when the buffer list changes.
6264 Functions running this hook are `get-buffer-create',
6265 `make-indirect-buffer', `rename-buffer', `kill-buffer',
6266 and `bury-buffer-internal'. */);
6267 Vbuffer_list_update_hook = Qnil;
6268 DEFSYM (Qbuffer_list_update_hook, "buffer-list-update-hook");
6270 defsubr (&Sbuffer_live_p);
6271 defsubr (&Sbuffer_list);
6272 defsubr (&Sget_buffer);
6273 defsubr (&Sget_file_buffer);
6274 defsubr (&Sget_buffer_create);
6275 defsubr (&Smake_indirect_buffer);
6276 defsubr (&Sgenerate_new_buffer_name);
6277 defsubr (&Sbuffer_name);
6278 defsubr (&Sbuffer_file_name);
6279 defsubr (&Sbuffer_base_buffer);
6280 defsubr (&Sbuffer_local_value);
6281 defsubr (&Sbuffer_local_variables);
6282 defsubr (&Sbuffer_modified_p);
6283 defsubr (&Sset_buffer_modified_p);
6284 defsubr (&Sbuffer_modified_tick);
6285 defsubr (&Sbuffer_chars_modified_tick);
6286 defsubr (&Srename_buffer);
6287 defsubr (&Sother_buffer);
6288 defsubr (&Sbuffer_enable_undo);
6289 defsubr (&Skill_buffer);
6290 defsubr (&Sbury_buffer_internal);
6291 defsubr (&Sset_buffer_major_mode);
6292 defsubr (&Scurrent_buffer);
6293 defsubr (&Sset_buffer);
6294 defsubr (&Sbarf_if_buffer_read_only);
6295 defsubr (&Serase_buffer);
6296 defsubr (&Sbuffer_swap_text);
6297 defsubr (&Sset_buffer_multibyte);
6298 defsubr (&Skill_all_local_variables);
6300 defsubr (&Soverlayp);
6301 defsubr (&Smake_overlay);
6302 defsubr (&Sdelete_overlay);
6303 defsubr (&Sdelete_all_overlays);
6304 defsubr (&Smove_overlay);
6305 defsubr (&Soverlay_start);
6306 defsubr (&Soverlay_end);
6307 defsubr (&Soverlay_buffer);
6308 defsubr (&Soverlay_properties);
6309 defsubr (&Soverlays_at);
6310 defsubr (&Soverlays_in);
6311 defsubr (&Snext_overlay_change);
6312 defsubr (&Sprevious_overlay_change);
6313 defsubr (&Soverlay_recenter);
6314 defsubr (&Soverlay_lists);
6315 defsubr (&Soverlay_get);
6316 defsubr (&Soverlay_put);
6317 defsubr (&Srestore_buffer_modified_p);
6320 void
6321 keys_of_buffer (void)
6323 initial_define_key (control_x_map, 'b', "switch-to-buffer");
6324 initial_define_key (control_x_map, 'k', "kill-buffer");
6326 /* This must not be in syms_of_buffer, because Qdisabled is not
6327 initialized when that function gets called. */
6328 Fput (intern_c_string ("erase-buffer"), Qdisabled, Qt);