Auto-commit of generated files.
[emacs.git] / src / buffer.c
blob619a729a859bfa1a8f748d9adb40b03f094f7115
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;
551 BUF_GAP_SIZE (b) = 20;
552 block_input ();
553 /* We allocate extra 1-byte at the tail and keep it always '\0' for
554 anchoring a search. */
555 alloc_buffer_text (b, BUF_GAP_SIZE (b) + 1);
556 unblock_input ();
557 if (! BUF_BEG_ADDR (b))
558 buffer_memory_full (BUF_GAP_SIZE (b) + 1);
560 b->pt = BEG;
561 b->begv = BEG;
562 b->zv = BEG;
563 b->pt_byte = BEG_BYTE;
564 b->begv_byte = BEG_BYTE;
565 b->zv_byte = BEG_BYTE;
567 BUF_GPT (b) = BEG;
568 BUF_GPT_BYTE (b) = BEG_BYTE;
570 BUF_Z (b) = BEG;
571 BUF_Z_BYTE (b) = BEG_BYTE;
572 BUF_MODIFF (b) = 1;
573 BUF_CHARS_MODIFF (b) = 1;
574 BUF_OVERLAY_MODIFF (b) = 1;
575 BUF_SAVE_MODIFF (b) = 1;
576 set_buffer_intervals (b, NULL);
577 BUF_UNCHANGED_MODIFIED (b) = 1;
578 BUF_OVERLAY_UNCHANGED_MODIFIED (b) = 1;
579 BUF_END_UNCHANGED (b) = 0;
580 BUF_BEG_UNCHANGED (b) = 0;
581 *(BUF_GPT_ADDR (b)) = *(BUF_Z_ADDR (b)) = 0; /* Put an anchor '\0'. */
582 b->text->inhibit_shrinking = 0;
584 b->newline_cache = 0;
585 b->width_run_cache = 0;
586 bset_width_table (b, Qnil);
587 b->prevent_redisplay_optimizations_p = 1;
589 /* An ordinary buffer normally doesn't need markers
590 to handle BEGV and ZV. */
591 bset_pt_marker (b, Qnil);
592 bset_begv_marker (b, Qnil);
593 bset_zv_marker (b, Qnil);
595 name = Fcopy_sequence (buffer_or_name);
596 set_string_intervals (name, NULL);
597 bset_name (b, name);
599 bset_undo_list (b, SREF (name, 0) != ' ' ? Qnil : Qt);
601 reset_buffer (b);
602 reset_buffer_local_variables (b, 1);
604 bset_mark (b, Fmake_marker ());
605 BUF_MARKERS (b) = NULL;
607 /* Put this in the alist of all live buffers. */
608 XSETBUFFER (buffer, b);
609 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buffer), Qnil));
610 /* And run buffer-list-update-hook. */
611 if (!NILP (Vrun_hooks))
612 call1 (Vrun_hooks, Qbuffer_list_update_hook);
614 return buffer;
618 /* Return a list of overlays which is a copy of the overlay list
619 LIST, but for buffer B. */
621 static struct Lisp_Overlay *
622 copy_overlays (struct buffer *b, struct Lisp_Overlay *list)
624 struct Lisp_Overlay *result = NULL, *tail = NULL;
626 for (; list; list = list->next)
628 Lisp_Object overlay, start, end;
629 struct Lisp_Marker *m;
631 eassert (MARKERP (list->start));
632 m = XMARKER (list->start);
633 start = build_marker (b, m->charpos, m->bytepos);
634 XMARKER (start)->insertion_type = m->insertion_type;
636 eassert (MARKERP (list->end));
637 m = XMARKER (list->end);
638 end = build_marker (b, m->charpos, m->bytepos);
639 XMARKER (end)->insertion_type = m->insertion_type;
641 overlay = build_overlay (start, end, Fcopy_sequence (list->plist));
642 if (tail)
643 tail = tail->next = XOVERLAY (overlay);
644 else
645 result = tail = XOVERLAY (overlay);
648 return result;
651 /* Set an appropriate overlay of B. */
653 static void
654 set_buffer_overlays_before (struct buffer *b, struct Lisp_Overlay *o)
656 b->overlays_before = o;
659 static void
660 set_buffer_overlays_after (struct buffer *b, struct Lisp_Overlay *o)
662 b->overlays_after = o;
665 /* Clone per-buffer values of buffer FROM.
667 Buffer TO gets the same per-buffer values as FROM, with the
668 following exceptions: (1) TO's name is left untouched, (2) markers
669 are copied and made to refer to TO, and (3) overlay lists are
670 copied. */
672 static void
673 clone_per_buffer_values (struct buffer *from, struct buffer *to)
675 int offset;
677 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
679 Lisp_Object obj;
681 /* Don't touch the `name' which should be unique for every buffer. */
682 if (offset == PER_BUFFER_VAR_OFFSET (name))
683 continue;
685 obj = per_buffer_value (from, offset);
686 if (MARKERP (obj) && XMARKER (obj)->buffer == from)
688 struct Lisp_Marker *m = XMARKER (obj);
690 obj = build_marker (to, m->charpos, m->bytepos);
691 XMARKER (obj)->insertion_type = m->insertion_type;
694 set_per_buffer_value (to, offset, obj);
697 memcpy (to->local_flags, from->local_flags, sizeof to->local_flags);
699 set_buffer_overlays_before (to, copy_overlays (to, from->overlays_before));
700 set_buffer_overlays_after (to, copy_overlays (to, from->overlays_after));
702 /* Get (a copy of) the alist of Lisp-level local variables of FROM
703 and install that in TO. */
704 bset_local_var_alist (to, buffer_lisp_local_variables (from, 1));
708 /* If buffer B has markers to record PT, BEGV and ZV when it is not
709 current, update these markers. */
711 static void
712 record_buffer_markers (struct buffer *b)
714 if (! NILP (BVAR (b, pt_marker)))
716 Lisp_Object buffer;
718 eassert (!NILP (BVAR (b, begv_marker)));
719 eassert (!NILP (BVAR (b, zv_marker)));
721 XSETBUFFER (buffer, b);
722 set_marker_both (BVAR (b, pt_marker), buffer, b->pt, b->pt_byte);
723 set_marker_both (BVAR (b, begv_marker), buffer, b->begv, b->begv_byte);
724 set_marker_both (BVAR (b, zv_marker), buffer, b->zv, b->zv_byte);
729 /* If buffer B has markers to record PT, BEGV and ZV when it is not
730 current, fetch these values into B->begv etc. */
732 static void
733 fetch_buffer_markers (struct buffer *b)
735 if (! NILP (BVAR (b, pt_marker)))
737 Lisp_Object m;
739 eassert (!NILP (BVAR (b, begv_marker)));
740 eassert (!NILP (BVAR (b, zv_marker)));
742 m = BVAR (b, pt_marker);
743 SET_BUF_PT_BOTH (b, marker_position (m), marker_byte_position (m));
745 m = BVAR (b, begv_marker);
746 SET_BUF_BEGV_BOTH (b, marker_position (m), marker_byte_position (m));
748 m = BVAR (b, zv_marker);
749 SET_BUF_ZV_BOTH (b, marker_position (m), marker_byte_position (m));
754 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer, Smake_indirect_buffer,
755 2, 3,
756 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
757 doc: /* Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.
758 BASE-BUFFER should be a live buffer, or the name of an existing buffer.
759 NAME should be a string which is not the name of an existing buffer.
760 Optional argument CLONE non-nil means preserve BASE-BUFFER's state,
761 such as major and minor modes, in the indirect buffer.
762 CLONE nil means the indirect buffer's state is reset to default values. */)
763 (Lisp_Object base_buffer, Lisp_Object name, Lisp_Object clone)
765 Lisp_Object buf, tem;
766 struct buffer *b;
768 CHECK_STRING (name);
769 buf = Fget_buffer (name);
770 if (!NILP (buf))
771 error ("Buffer name `%s' is in use", SDATA (name));
773 tem = base_buffer;
774 base_buffer = Fget_buffer (base_buffer);
775 if (NILP (base_buffer))
776 error ("No such buffer: `%s'", SDATA (tem));
777 if (!BUFFER_LIVE_P (XBUFFER (base_buffer)))
778 error ("Base buffer has been killed");
780 if (SCHARS (name) == 0)
781 error ("Empty string for buffer name is not allowed");
783 b = allocate_buffer ();
785 /* No double indirection - if base buffer is indirect,
786 new buffer becomes an indirect to base's base. */
787 b->base_buffer = (XBUFFER (base_buffer)->base_buffer
788 ? XBUFFER (base_buffer)->base_buffer
789 : XBUFFER (base_buffer));
791 /* Use the base buffer's text object. */
792 b->text = b->base_buffer->text;
793 /* We have no own text. */
794 b->indirections = -1;
795 /* Notify base buffer that we share the text now. */
796 b->base_buffer->indirections++;
798 b->pt = b->base_buffer->pt;
799 b->begv = b->base_buffer->begv;
800 b->zv = b->base_buffer->zv;
801 b->pt_byte = b->base_buffer->pt_byte;
802 b->begv_byte = b->base_buffer->begv_byte;
803 b->zv_byte = b->base_buffer->zv_byte;
805 b->newline_cache = 0;
806 b->width_run_cache = 0;
807 bset_width_table (b, Qnil);
809 name = Fcopy_sequence (name);
810 set_string_intervals (name, NULL);
811 bset_name (b, name);
813 reset_buffer (b);
814 reset_buffer_local_variables (b, 1);
816 /* Put this in the alist of all live buffers. */
817 XSETBUFFER (buf, b);
818 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
820 bset_mark (b, Fmake_marker ());
822 /* The multibyte status belongs to the base buffer. */
823 bset_enable_multibyte_characters
824 (b, BVAR (b->base_buffer, enable_multibyte_characters));
826 /* Make sure the base buffer has markers for its narrowing. */
827 if (NILP (BVAR (b->base_buffer, pt_marker)))
829 eassert (NILP (BVAR (b->base_buffer, begv_marker)));
830 eassert (NILP (BVAR (b->base_buffer, zv_marker)));
832 bset_pt_marker (b->base_buffer,
833 build_marker (b->base_buffer, b->base_buffer->pt,
834 b->base_buffer->pt_byte));
836 bset_begv_marker (b->base_buffer,
837 build_marker (b->base_buffer, b->base_buffer->begv,
838 b->base_buffer->begv_byte));
840 bset_zv_marker (b->base_buffer,
841 build_marker (b->base_buffer, b->base_buffer->zv,
842 b->base_buffer->zv_byte));
844 XMARKER (BVAR (b->base_buffer, zv_marker))->insertion_type = 1;
847 if (NILP (clone))
849 /* Give the indirect buffer markers for its narrowing. */
850 bset_pt_marker (b, build_marker (b, b->pt, b->pt_byte));
851 bset_begv_marker (b, build_marker (b, b->begv, b->begv_byte));
852 bset_zv_marker (b, build_marker (b, b->zv, b->zv_byte));
853 XMARKER (BVAR (b, zv_marker))->insertion_type = 1;
855 else
857 struct buffer *old_b = current_buffer;
859 clone_per_buffer_values (b->base_buffer, b);
860 bset_filename (b, Qnil);
861 bset_file_truename (b, Qnil);
862 bset_display_count (b, make_number (0));
863 bset_backed_up (b, Qnil);
864 bset_auto_save_file_name (b, Qnil);
865 set_buffer_internal_1 (b);
866 Fset (intern ("buffer-save-without-query"), Qnil);
867 Fset (intern ("buffer-file-number"), Qnil);
868 Fset (intern ("buffer-stale-function"), Qnil);
869 set_buffer_internal_1 (old_b);
872 /* Run buffer-list-update-hook. */
873 if (!NILP (Vrun_hooks))
874 call1 (Vrun_hooks, Qbuffer_list_update_hook);
876 return buf;
879 /* Mark OV as no longer associated with B. */
881 static void
882 drop_overlay (struct buffer *b, struct Lisp_Overlay *ov)
884 eassert (b == XBUFFER (Fmarker_buffer (ov->start)));
885 modify_overlay (b, marker_position (ov->start),
886 marker_position (ov->end));
887 Fset_marker (ov->start, Qnil, Qnil);
888 Fset_marker (ov->end, Qnil, Qnil);
892 /* Delete all overlays of B and reset it's overlay lists. */
894 void
895 delete_all_overlays (struct buffer *b)
897 struct Lisp_Overlay *ov, *next;
899 /* FIXME: Since each drop_overlay will scan BUF_MARKERS to unlink its
900 markers, we have an unneeded O(N^2) behavior here. */
901 for (ov = b->overlays_before; ov; ov = next)
903 drop_overlay (b, ov);
904 next = ov->next;
905 ov->next = NULL;
908 for (ov = b->overlays_after; ov; ov = next)
910 drop_overlay (b, ov);
911 next = ov->next;
912 ov->next = NULL;
915 set_buffer_overlays_before (b, NULL);
916 set_buffer_overlays_after (b, NULL);
919 /* Reinitialize everything about a buffer except its name and contents
920 and local variables.
921 If called on an already-initialized buffer, the list of overlays
922 should be deleted before calling this function, otherwise we end up
923 with overlays that claim to belong to the buffer but the buffer
924 claims it doesn't belong to it. */
926 void
927 reset_buffer (register struct buffer *b)
929 bset_filename (b, Qnil);
930 bset_file_truename (b, Qnil);
931 bset_directory (b, current_buffer ? BVAR (current_buffer, directory) : Qnil);
932 b->modtime = make_emacs_time (0, UNKNOWN_MODTIME_NSECS);
933 b->modtime_size = -1;
934 XSETFASTINT (BVAR (b, save_length), 0);
935 b->last_window_start = 1;
936 /* It is more conservative to start out "changed" than "unchanged". */
937 b->clip_changed = 0;
938 b->prevent_redisplay_optimizations_p = 1;
939 bset_backed_up (b, Qnil);
940 BUF_AUTOSAVE_MODIFF (b) = 0;
941 b->auto_save_failure_time = 0;
942 bset_auto_save_file_name (b, Qnil);
943 bset_read_only (b, Qnil);
944 set_buffer_overlays_before (b, NULL);
945 set_buffer_overlays_after (b, NULL);
946 b->overlay_center = BEG;
947 bset_mark_active (b, Qnil);
948 bset_point_before_scroll (b, Qnil);
949 bset_file_format (b, Qnil);
950 bset_auto_save_file_format (b, Qt);
951 bset_last_selected_window (b, Qnil);
952 bset_display_count (b, make_number (0));
953 bset_display_time (b, Qnil);
954 bset_enable_multibyte_characters
955 (b, BVAR (&buffer_defaults, enable_multibyte_characters));
956 bset_cursor_type (b, BVAR (&buffer_defaults, cursor_type));
957 bset_extra_line_spacing (b, BVAR (&buffer_defaults, extra_line_spacing));
959 b->display_error_modiff = 0;
962 /* Reset buffer B's local variables info.
963 Don't use this on a buffer that has already been in use;
964 it does not treat permanent locals consistently.
965 Instead, use Fkill_all_local_variables.
967 If PERMANENT_TOO, reset permanent buffer-local variables.
968 If not, preserve those. */
970 static void
971 reset_buffer_local_variables (struct buffer *b, bool permanent_too)
973 int offset, i;
975 /* Reset the major mode to Fundamental, together with all the
976 things that depend on the major mode.
977 default-major-mode is handled at a higher level.
978 We ignore it here. */
979 bset_major_mode (b, Qfundamental_mode);
980 bset_keymap (b, Qnil);
981 bset_mode_name (b, QSFundamental);
982 bset_minor_modes (b, Qnil);
984 /* If the standard case table has been altered and invalidated,
985 fix up its insides first. */
986 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[0])
987 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[1])
988 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[2])))
989 Fset_standard_case_table (Vascii_downcase_table);
991 bset_downcase_table (b, Vascii_downcase_table);
992 bset_upcase_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[0]);
993 bset_case_canon_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[1]);
994 bset_case_eqv_table (b, XCHAR_TABLE (Vascii_downcase_table)->extras[2]);
995 bset_invisibility_spec (b, Qt);
997 /* Reset all (or most) per-buffer variables to their defaults. */
998 if (permanent_too)
999 bset_local_var_alist (b, Qnil);
1000 else
1002 Lisp_Object tmp, prop, last = Qnil;
1003 for (tmp = BVAR (b, local_var_alist); CONSP (tmp); tmp = XCDR (tmp))
1004 if (!NILP (prop = Fget (XCAR (XCAR (tmp)), Qpermanent_local)))
1006 /* If permanent-local, keep it. */
1007 last = tmp;
1008 if (EQ (prop, Qpermanent_local_hook))
1010 /* This is a partially permanent hook variable.
1011 Preserve only the elements that want to be preserved. */
1012 Lisp_Object list, newlist;
1013 list = XCDR (XCAR (tmp));
1014 if (!CONSP (list))
1015 newlist = list;
1016 else
1017 for (newlist = Qnil; CONSP (list); list = XCDR (list))
1019 Lisp_Object elt = XCAR (list);
1020 /* Preserve element ELT if it's t,
1021 if it is a function with a `permanent-local-hook' property,
1022 or if it's not a symbol. */
1023 if (! SYMBOLP (elt)
1024 || EQ (elt, Qt)
1025 || !NILP (Fget (elt, Qpermanent_local_hook)))
1026 newlist = Fcons (elt, newlist);
1028 XSETCDR (XCAR (tmp), Fnreverse (newlist));
1031 /* Delete this local variable. */
1032 else if (NILP (last))
1033 bset_local_var_alist (b, XCDR (tmp));
1034 else
1035 XSETCDR (last, XCDR (tmp));
1038 for (i = 0; i < last_per_buffer_idx; ++i)
1039 if (permanent_too || buffer_permanent_local_flags[i] == 0)
1040 SET_PER_BUFFER_VALUE_P (b, i, 0);
1042 /* For each slot that has a default value, copy that into the slot. */
1043 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
1045 int idx = PER_BUFFER_IDX (offset);
1046 if ((idx > 0
1047 && (permanent_too
1048 || buffer_permanent_local_flags[idx] == 0)))
1049 set_per_buffer_value (b, offset, per_buffer_default (offset));
1053 /* We split this away from generate-new-buffer, because rename-buffer
1054 and set-visited-file-name ought to be able to use this to really
1055 rename the buffer properly. */
1057 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name,
1058 Sgenerate_new_buffer_name, 1, 2, 0,
1059 doc: /* Return a string that is the name of no existing buffer based on NAME.
1060 If there is no live buffer named NAME, then return NAME.
1061 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
1062 \(starting at 2) until an unused name is found, and then return that name.
1063 Optional second argument IGNORE specifies a name that is okay to use (if
1064 it is in the sequence to be tried) even if a buffer with that name exists.
1066 If NAME begins with a space (i.e., a buffer that is not normally
1067 visible to users), then if buffer NAME already exists a random number
1068 is first appended to NAME, to speed up finding a non-existent buffer. */)
1069 (register Lisp_Object name, Lisp_Object ignore)
1071 register Lisp_Object gentemp, tem, tem2;
1072 ptrdiff_t count;
1073 char number[INT_BUFSIZE_BOUND (ptrdiff_t) + sizeof "<>"];
1075 CHECK_STRING (name);
1077 tem = Fstring_equal (name, ignore);
1078 if (!NILP (tem))
1079 return name;
1080 tem = Fget_buffer (name);
1081 if (NILP (tem))
1082 return name;
1084 if (!strncmp (SSDATA (name), " ", 1)) /* see bug#1229 */
1086 /* Note fileio.c:make_temp_name does random differently. */
1087 tem2 = concat2 (name, make_formatted_string
1088 (number, "-%"pI"d",
1089 XFASTINT (Frandom (make_number (999999)))));
1090 tem = Fget_buffer (tem2);
1091 if (NILP (tem))
1092 return tem2;
1094 else
1095 tem2 = name;
1097 count = 1;
1098 while (1)
1100 gentemp = concat2 (tem2, make_formatted_string
1101 (number, "<%"pD"d>", ++count));
1102 tem = Fstring_equal (gentemp, ignore);
1103 if (!NILP (tem))
1104 return gentemp;
1105 tem = Fget_buffer (gentemp);
1106 if (NILP (tem))
1107 return gentemp;
1112 DEFUN ("buffer-name", Fbuffer_name, Sbuffer_name, 0, 1, 0,
1113 doc: /* Return the name of BUFFER, as a string.
1114 BUFFER defaults to the current buffer.
1115 Return nil if BUFFER has been killed. */)
1116 (register Lisp_Object buffer)
1118 if (NILP (buffer))
1119 return BVAR (current_buffer, name);
1120 CHECK_BUFFER (buffer);
1121 return BVAR (XBUFFER (buffer), name);
1124 DEFUN ("buffer-file-name", Fbuffer_file_name, Sbuffer_file_name, 0, 1, 0,
1125 doc: /* Return name of file BUFFER is visiting, or nil if none.
1126 No argument or nil as argument means use the current buffer. */)
1127 (register Lisp_Object buffer)
1129 if (NILP (buffer))
1130 return BVAR (current_buffer, filename);
1131 CHECK_BUFFER (buffer);
1132 return BVAR (XBUFFER (buffer), filename);
1135 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer, Sbuffer_base_buffer,
1136 0, 1, 0,
1137 doc: /* Return the base buffer of indirect buffer BUFFER.
1138 If BUFFER is not indirect, return nil.
1139 BUFFER defaults to the current buffer. */)
1140 (register Lisp_Object buffer)
1142 struct buffer *base;
1143 Lisp_Object base_buffer;
1145 if (NILP (buffer))
1146 base = current_buffer->base_buffer;
1147 else
1149 CHECK_BUFFER (buffer);
1150 base = XBUFFER (buffer)->base_buffer;
1153 if (! base)
1154 return Qnil;
1155 XSETBUFFER (base_buffer, base);
1156 return base_buffer;
1159 DEFUN ("buffer-local-value", Fbuffer_local_value,
1160 Sbuffer_local_value, 2, 2, 0,
1161 doc: /* Return the value of VARIABLE in BUFFER.
1162 If VARIABLE does not have a buffer-local binding in BUFFER, the value
1163 is the default binding of the variable. */)
1164 (register Lisp_Object variable, register Lisp_Object buffer)
1166 register Lisp_Object result = buffer_local_value_1 (variable, buffer);
1168 if (EQ (result, Qunbound))
1169 xsignal1 (Qvoid_variable, variable);
1171 return result;
1175 /* Like Fbuffer_local_value, but return Qunbound if the variable is
1176 locally unbound. */
1178 Lisp_Object
1179 buffer_local_value_1 (Lisp_Object variable, Lisp_Object buffer)
1181 register struct buffer *buf;
1182 register Lisp_Object result;
1183 struct Lisp_Symbol *sym;
1185 CHECK_SYMBOL (variable);
1186 CHECK_BUFFER (buffer);
1187 buf = XBUFFER (buffer);
1188 sym = XSYMBOL (variable);
1190 start:
1191 switch (sym->redirect)
1193 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1194 case SYMBOL_PLAINVAL: result = SYMBOL_VAL (sym); break;
1195 case SYMBOL_LOCALIZED:
1196 { /* Look in local_var_alist. */
1197 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1198 XSETSYMBOL (variable, sym); /* Update In case of aliasing. */
1199 result = Fassoc (variable, BVAR (buf, local_var_alist));
1200 if (!NILP (result))
1202 if (blv->fwd)
1203 { /* What binding is loaded right now? */
1204 Lisp_Object current_alist_element = blv->valcell;
1206 /* The value of the currently loaded binding is not
1207 stored in it, but rather in the realvalue slot.
1208 Store that value into the binding it belongs to
1209 in case that is the one we are about to use. */
1211 XSETCDR (current_alist_element,
1212 do_symval_forwarding (blv->fwd));
1214 /* Now get the (perhaps updated) value out of the binding. */
1215 result = XCDR (result);
1217 else
1218 result = Fdefault_value (variable);
1219 break;
1221 case SYMBOL_FORWARDED:
1223 union Lisp_Fwd *fwd = SYMBOL_FWD (sym);
1224 if (BUFFER_OBJFWDP (fwd))
1225 result = per_buffer_value (buf, XBUFFER_OBJFWD (fwd)->offset);
1226 else
1227 result = Fdefault_value (variable);
1228 break;
1230 default: emacs_abort ();
1233 return result;
1236 /* Return an alist of the Lisp-level buffer-local bindings of
1237 buffer BUF. That is, don't include the variables maintained
1238 in special slots in the buffer object.
1239 If not CLONE, replace elements of the form (VAR . unbound)
1240 by VAR. */
1242 static Lisp_Object
1243 buffer_lisp_local_variables (struct buffer *buf, bool clone)
1245 Lisp_Object result = Qnil;
1246 Lisp_Object tail;
1247 for (tail = BVAR (buf, local_var_alist); CONSP (tail); tail = XCDR (tail))
1249 Lisp_Object val, elt;
1251 elt = XCAR (tail);
1253 /* Reference each variable in the alist in buf.
1254 If inquiring about the current buffer, this gets the current values,
1255 so store them into the alist so the alist is up to date.
1256 If inquiring about some other buffer, this swaps out any values
1257 for that buffer, making the alist up to date automatically. */
1258 val = find_symbol_value (XCAR (elt));
1259 /* Use the current buffer value only if buf is the current buffer. */
1260 if (buf != current_buffer)
1261 val = XCDR (elt);
1263 result = Fcons (!clone && EQ (val, Qunbound)
1264 ? XCAR (elt)
1265 : Fcons (XCAR (elt), val),
1266 result);
1269 return result;
1272 DEFUN ("buffer-local-variables", Fbuffer_local_variables,
1273 Sbuffer_local_variables, 0, 1, 0,
1274 doc: /* Return an alist of variables that are buffer-local in BUFFER.
1275 Most elements look like (SYMBOL . VALUE), describing one variable.
1276 For a symbol that is locally unbound, just the symbol appears in the value.
1277 Note that storing new VALUEs in these elements doesn't change the variables.
1278 No argument or nil as argument means use current buffer as BUFFER. */)
1279 (register Lisp_Object buffer)
1281 register struct buffer *buf;
1282 register Lisp_Object result;
1284 if (NILP (buffer))
1285 buf = current_buffer;
1286 else
1288 CHECK_BUFFER (buffer);
1289 buf = XBUFFER (buffer);
1292 result = buffer_lisp_local_variables (buf, 0);
1294 /* Add on all the variables stored in special slots. */
1296 int offset, idx;
1298 FOR_EACH_PER_BUFFER_OBJECT_AT (offset)
1300 idx = PER_BUFFER_IDX (offset);
1301 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1302 && SYMBOLP (PER_BUFFER_SYMBOL (offset)))
1304 Lisp_Object sym = PER_BUFFER_SYMBOL (offset);
1305 Lisp_Object val = per_buffer_value (buf, offset);
1306 result = Fcons (EQ (val, Qunbound) ? sym : Fcons (sym, val),
1307 result);
1312 return result;
1315 DEFUN ("buffer-modified-p", Fbuffer_modified_p, Sbuffer_modified_p,
1316 0, 1, 0,
1317 doc: /* Return t if BUFFER was modified since its file was last read or saved.
1318 No argument or nil as argument means use current buffer as BUFFER. */)
1319 (register Lisp_Object buffer)
1321 register struct buffer *buf;
1322 if (NILP (buffer))
1323 buf = current_buffer;
1324 else
1326 CHECK_BUFFER (buffer);
1327 buf = XBUFFER (buffer);
1330 return BUF_SAVE_MODIFF (buf) < BUF_MODIFF (buf) ? Qt : Qnil;
1333 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
1334 1, 1, 0,
1335 doc: /* Mark current buffer as modified or unmodified according to FLAG.
1336 A non-nil FLAG means mark the buffer modified. */)
1337 (Lisp_Object flag)
1339 Lisp_Object fn, buffer, window;
1341 #ifdef CLASH_DETECTION
1342 /* If buffer becoming modified, lock the file.
1343 If buffer becoming unmodified, unlock the file. */
1345 struct buffer *b = current_buffer->base_buffer
1346 ? current_buffer->base_buffer
1347 : current_buffer;
1349 fn = BVAR (b, file_truename);
1350 /* Test buffer-file-name so that binding it to nil is effective. */
1351 if (!NILP (fn) && ! NILP (BVAR (b, filename)))
1353 bool already = SAVE_MODIFF < MODIFF;
1354 if (!already && !NILP (flag))
1355 lock_file (fn);
1356 else if (already && NILP (flag))
1357 unlock_file (fn);
1359 #endif /* CLASH_DETECTION */
1361 /* Here we have a problem. SAVE_MODIFF is used here to encode
1362 buffer-modified-p (as SAVE_MODIFF<MODIFF) as well as
1363 recent-auto-save-p (as SAVE_MODIFF<auto_save_modified). So if we
1364 modify SAVE_MODIFF to affect one, we may affect the other
1365 as well.
1366 E.g. if FLAG is nil we need to set SAVE_MODIFF to MODIFF, but
1367 if SAVE_MODIFF<auto_save_modified that means we risk changing
1368 recent-auto-save-p from t to nil.
1369 Vice versa, if FLAG is non-nil and SAVE_MODIFF>=auto_save_modified
1370 we risk changing recent-auto-save-p from nil to t. */
1371 SAVE_MODIFF = (NILP (flag)
1372 /* FIXME: This unavoidably sets recent-auto-save-p to nil. */
1373 ? MODIFF
1374 /* Let's try to preserve recent-auto-save-p. */
1375 : SAVE_MODIFF < MODIFF ? SAVE_MODIFF
1376 /* If SAVE_MODIFF == auto_save_modified == MODIFF,
1377 we can either decrease SAVE_MODIFF and auto_save_modified
1378 or increase MODIFF. */
1379 : MODIFF++);
1381 /* Set update_mode_lines only if buffer is displayed in some window.
1382 Packages like jit-lock or lazy-lock preserve a buffer's modified
1383 state by recording/restoring the state around blocks of code.
1384 Setting update_mode_lines makes redisplay consider all windows
1385 (on all frames). Stealth fontification of buffers not displayed
1386 would incur additional redisplay costs if we'd set
1387 update_modes_lines unconditionally.
1389 Ideally, I think there should be another mechanism for fontifying
1390 buffers without "modifying" buffers, or redisplay should be
1391 smarter about updating the `*' in mode lines. --gerd */
1392 XSETBUFFER (buffer, current_buffer);
1393 window = Fget_buffer_window (buffer, Qt);
1394 if (WINDOWP (window))
1396 ++update_mode_lines;
1397 current_buffer->prevent_redisplay_optimizations_p = 1;
1400 return flag;
1403 DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p,
1404 Srestore_buffer_modified_p, 1, 1, 0,
1405 doc: /* Like `set-buffer-modified-p', with a difference concerning redisplay.
1406 It is not ensured that mode lines will be updated to show the modified
1407 state of the current buffer. Use with care. */)
1408 (Lisp_Object flag)
1410 #ifdef CLASH_DETECTION
1411 Lisp_Object fn;
1413 /* If buffer becoming modified, lock the file.
1414 If buffer becoming unmodified, unlock the file. */
1416 fn = BVAR (current_buffer, file_truename);
1417 /* Test buffer-file-name so that binding it to nil is effective. */
1418 if (!NILP (fn) && ! NILP (BVAR (current_buffer, filename)))
1420 bool already = SAVE_MODIFF < MODIFF;
1421 if (!already && !NILP (flag))
1422 lock_file (fn);
1423 else if (already && NILP (flag))
1424 unlock_file (fn);
1426 #endif /* CLASH_DETECTION */
1428 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1429 return flag;
1432 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick, Sbuffer_modified_tick,
1433 0, 1, 0,
1434 doc: /* Return BUFFER's tick counter, incremented for each change in text.
1435 Each buffer has a tick counter which is incremented each time the
1436 text in that buffer is changed. It wraps around occasionally.
1437 No argument or nil as argument means use current buffer as BUFFER. */)
1438 (register Lisp_Object buffer)
1440 register struct buffer *buf;
1441 if (NILP (buffer))
1442 buf = current_buffer;
1443 else
1445 CHECK_BUFFER (buffer);
1446 buf = XBUFFER (buffer);
1449 return make_number (BUF_MODIFF (buf));
1452 DEFUN ("buffer-chars-modified-tick", Fbuffer_chars_modified_tick,
1453 Sbuffer_chars_modified_tick, 0, 1, 0,
1454 doc: /* Return BUFFER's character-change tick counter.
1455 Each buffer has a character-change tick counter, which is set to the
1456 value of the buffer's tick counter \(see `buffer-modified-tick'), each
1457 time text in that buffer is inserted or deleted. By comparing the
1458 values returned by two individual calls of `buffer-chars-modified-tick',
1459 you can tell whether a character change occurred in that buffer in
1460 between these calls. No argument or nil as argument means use current
1461 buffer as BUFFER. */)
1462 (register Lisp_Object buffer)
1464 register struct buffer *buf;
1465 if (NILP (buffer))
1466 buf = current_buffer;
1467 else
1469 CHECK_BUFFER (buffer);
1470 buf = XBUFFER (buffer);
1473 return make_number (BUF_CHARS_MODIFF (buf));
1476 DEFUN ("rename-buffer", Frename_buffer, Srename_buffer, 1, 2,
1477 "(list (read-string \"Rename buffer (to new name): \" \
1478 nil 'buffer-name-history (buffer-name (current-buffer))) \
1479 current-prefix-arg)",
1480 doc: /* Change current buffer's name to NEWNAME (a string).
1481 If second arg UNIQUE is nil or omitted, it is an error if a
1482 buffer named NEWNAME already exists.
1483 If UNIQUE is non-nil, come up with a new name using
1484 `generate-new-buffer-name'.
1485 Interactively, you can set UNIQUE with a prefix argument.
1486 We return the name we actually gave the buffer.
1487 This does not change the name of the visited file (if any). */)
1488 (register Lisp_Object newname, Lisp_Object unique)
1490 register Lisp_Object tem, buf;
1492 CHECK_STRING (newname);
1494 if (SCHARS (newname) == 0)
1495 error ("Empty string is invalid as a buffer name");
1497 tem = Fget_buffer (newname);
1498 if (!NILP (tem))
1500 /* Don't short-circuit if UNIQUE is t. That is a useful way to
1501 rename the buffer automatically so you can create another
1502 with the original name. It makes UNIQUE equivalent to
1503 (rename-buffer (generate-new-buffer-name NEWNAME)). */
1504 if (NILP (unique) && XBUFFER (tem) == current_buffer)
1505 return BVAR (current_buffer, name);
1506 if (!NILP (unique))
1507 newname = Fgenerate_new_buffer_name (newname, BVAR (current_buffer, name));
1508 else
1509 error ("Buffer name `%s' is in use", SDATA (newname));
1512 bset_name (current_buffer, newname);
1514 /* Catch redisplay's attention. Unless we do this, the mode lines for
1515 any windows displaying current_buffer will stay unchanged. */
1516 update_mode_lines++;
1518 XSETBUFFER (buf, current_buffer);
1519 Fsetcar (Frassq (buf, Vbuffer_alist), newname);
1520 if (NILP (BVAR (current_buffer, filename))
1521 && !NILP (BVAR (current_buffer, auto_save_file_name)))
1522 call0 (intern ("rename-auto-save-file"));
1524 /* Run buffer-list-update-hook. */
1525 if (!NILP (Vrun_hooks))
1526 call1 (Vrun_hooks, Qbuffer_list_update_hook);
1528 /* Refetch since that last call may have done GC. */
1529 return BVAR (current_buffer, name);
1532 DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 3, 0,
1533 doc: /* Return most recently selected buffer other than BUFFER.
1534 Buffers not visible in windows are preferred to visible buffers, unless
1535 optional second argument VISIBLE-OK is non-nil. Ignore the argument
1536 BUFFER unless it denotes a live buffer. If the optional third argument
1537 FRAME is non-nil, use that frame's buffer list instead of the selected
1538 frame's buffer list.
1540 The buffer is found by scanning the selected or specified frame's buffer
1541 list first, followed by the list of all buffers. If no other buffer
1542 exists, return the buffer `*scratch*' (creating it if necessary). */)
1543 (register Lisp_Object buffer, Lisp_Object visible_ok, Lisp_Object frame)
1545 struct frame *f = decode_any_frame (frame);
1546 Lisp_Object tail = f->buffer_list, pred = f->buffer_predicate;
1547 Lisp_Object buf, notsogood = Qnil;
1549 /* Consider buffers that have been seen in the frame first. */
1550 for (; CONSP (tail); tail = XCDR (tail))
1552 buf = XCAR (tail);
1553 if (BUFFERP (buf) && !EQ (buf, buffer)
1554 && BUFFER_LIVE_P (XBUFFER (buf))
1555 && (SREF (BVAR (XBUFFER (buf), name), 0) != ' ')
1556 /* If the frame has a buffer_predicate, disregard buffers that
1557 don't fit the predicate. */
1558 && (NILP (pred) || !NILP (call1 (pred, buf))))
1560 if (!NILP (visible_ok)
1561 || NILP (Fget_buffer_window (buf, Qvisible)))
1562 return buf;
1563 else if (NILP (notsogood))
1564 notsogood = buf;
1568 /* Consider alist of all buffers next. */
1569 tail = Vbuffer_alist;
1570 for (; CONSP (tail); tail = XCDR (tail))
1572 buf = Fcdr (XCAR (tail));
1573 if (BUFFERP (buf) && !EQ (buf, buffer)
1574 && BUFFER_LIVE_P (XBUFFER (buf))
1575 && (SREF (BVAR (XBUFFER (buf), name), 0) != ' ')
1576 /* If the frame has a buffer_predicate, disregard buffers that
1577 don't fit the predicate. */
1578 && (NILP (pred) || !NILP (call1 (pred, buf))))
1580 if (!NILP (visible_ok)
1581 || NILP (Fget_buffer_window (buf, Qvisible)))
1582 return buf;
1583 else if (NILP (notsogood))
1584 notsogood = buf;
1588 if (!NILP (notsogood))
1589 return notsogood;
1590 else
1592 buf = Fget_buffer (build_string ("*scratch*"));
1593 if (NILP (buf))
1595 buf = Fget_buffer_create (build_string ("*scratch*"));
1596 Fset_buffer_major_mode (buf);
1598 return buf;
1602 /* The following function is a safe variant of Fother_buffer: It doesn't
1603 pay attention to any frame-local buffer lists, doesn't care about
1604 visibility of buffers, and doesn't evaluate any frame predicates. */
1606 Lisp_Object
1607 other_buffer_safely (Lisp_Object buffer)
1609 Lisp_Object tail, buf;
1611 tail = Vbuffer_alist;
1612 for (; CONSP (tail); tail = XCDR (tail))
1614 buf = Fcdr (XCAR (tail));
1615 if (BUFFERP (buf) && !EQ (buf, buffer)
1616 && BUFFER_LIVE_P (XBUFFER (buf))
1617 && (SREF (BVAR (XBUFFER (buf), name), 0) != ' '))
1618 return buf;
1621 buf = Fget_buffer (build_string ("*scratch*"));
1622 if (NILP (buf))
1624 buf = Fget_buffer_create (build_string ("*scratch*"));
1625 Fset_buffer_major_mode (buf);
1628 return buf;
1631 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo, Sbuffer_enable_undo,
1632 0, 1, "",
1633 doc: /* Start keeping undo information for buffer BUFFER.
1634 No argument or nil as argument means do this for the current buffer. */)
1635 (register Lisp_Object buffer)
1637 Lisp_Object real_buffer;
1639 if (NILP (buffer))
1640 XSETBUFFER (real_buffer, current_buffer);
1641 else
1643 real_buffer = Fget_buffer (buffer);
1644 if (NILP (real_buffer))
1645 nsberror (buffer);
1648 if (EQ (BVAR (XBUFFER (real_buffer), undo_list), Qt))
1649 bset_undo_list (XBUFFER (real_buffer), Qnil);
1651 return Qnil;
1654 /* Truncate undo list and shrink the gap of BUFFER. */
1656 void
1657 compact_buffer (struct buffer *buffer)
1659 BUFFER_CHECK_INDIRECTION (buffer);
1661 /* Skip dead buffers, indirect buffers and buffers
1662 which aren't changed since last compaction. */
1663 if (BUFFER_LIVE_P (buffer)
1664 && (buffer->base_buffer == NULL)
1665 && (buffer->text->compact != buffer->text->modiff))
1667 /* If a buffer's undo list is Qt, that means that undo is
1668 turned off in that buffer. Calling truncate_undo_list on
1669 Qt tends to return NULL, which effectively turns undo back on.
1670 So don't call truncate_undo_list if undo_list is Qt. */
1671 if (!EQ (buffer->INTERNAL_FIELD (undo_list), Qt))
1672 truncate_undo_list (buffer);
1674 /* Shrink buffer gaps. */
1675 if (!buffer->text->inhibit_shrinking)
1677 /* If a buffer's gap size is more than 10% of the buffer
1678 size, or larger than 2000 bytes, then shrink it
1679 accordingly. Keep a minimum size of 20 bytes. */
1680 int size = min (2000, max (20, (buffer->text->z_byte / 10)));
1682 if (buffer->text->gap_size > size)
1684 struct buffer *save_current = current_buffer;
1685 current_buffer = buffer;
1686 make_gap (-(buffer->text->gap_size - size));
1687 current_buffer = save_current;
1690 buffer->text->compact = buffer->text->modiff;
1694 DEFUN ("kill-buffer", Fkill_buffer, Skill_buffer, 0, 1, "bKill buffer: ",
1695 doc: /* Kill the buffer specified by BUFFER-OR-NAME.
1696 The argument may be a buffer or the name of an existing buffer.
1697 Argument nil or omitted means kill the current buffer. Return t if the
1698 buffer is actually killed, nil otherwise.
1700 The functions in `kill-buffer-query-functions' are called with the
1701 buffer to be killed as the current buffer. If any of them returns nil,
1702 the buffer is not killed. The hook `kill-buffer-hook' is run before the
1703 buffer is actually killed. The buffer being killed will be current
1704 while the hook is running. Functions called by any of these hooks are
1705 supposed to not change the current buffer.
1707 Any processes that have this buffer as the `process-buffer' are killed
1708 with SIGHUP. This function calls `replace-buffer-in-windows' for
1709 cleaning up all windows currently displaying the buffer to be killed. */)
1710 (Lisp_Object buffer_or_name)
1712 Lisp_Object buffer;
1713 register struct buffer *b;
1714 register Lisp_Object tem;
1715 register struct Lisp_Marker *m;
1716 struct gcpro gcpro1;
1718 if (NILP (buffer_or_name))
1719 buffer = Fcurrent_buffer ();
1720 else
1721 buffer = Fget_buffer (buffer_or_name);
1722 if (NILP (buffer))
1723 nsberror (buffer_or_name);
1725 b = XBUFFER (buffer);
1727 /* Avoid trouble for buffer already dead. */
1728 if (!BUFFER_LIVE_P (b))
1729 return Qnil;
1731 /* Query if the buffer is still modified. */
1732 if (INTERACTIVE && !NILP (BVAR (b, filename))
1733 && BUF_MODIFF (b) > BUF_SAVE_MODIFF (b))
1735 GCPRO1 (buffer);
1736 tem = do_yes_or_no_p (format2 ("Buffer %s modified; kill anyway? ",
1737 BVAR (b, name), make_number (0)));
1738 UNGCPRO;
1739 if (NILP (tem))
1740 return Qnil;
1743 /* Run hooks with the buffer to be killed the current buffer. */
1745 ptrdiff_t count = SPECPDL_INDEX ();
1746 Lisp_Object arglist[1];
1748 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1749 set_buffer_internal (b);
1751 /* First run the query functions; if any query is answered no,
1752 don't kill the buffer. */
1753 arglist[0] = Qkill_buffer_query_functions;
1754 tem = Frun_hook_with_args_until_failure (1, arglist);
1755 if (NILP (tem))
1756 return unbind_to (count, Qnil);
1758 /* Then run the hooks. */
1759 Frun_hooks (1, &Qkill_buffer_hook);
1760 unbind_to (count, Qnil);
1763 /* If the hooks have killed the buffer, exit now. */
1764 if (!BUFFER_LIVE_P (b))
1765 return Qt;
1767 /* We have no more questions to ask. Verify that it is valid
1768 to kill the buffer. This must be done after the questions
1769 since anything can happen within do_yes_or_no_p. */
1771 /* Don't kill the minibuffer now current. */
1772 if (EQ (buffer, XWINDOW (minibuf_window)->buffer))
1773 return Qnil;
1775 /* When we kill an ordinary buffer which shares it's buffer text
1776 with indirect buffer(s), we must kill indirect buffer(s) too.
1777 We do it at this stage so nothing terrible happens if they
1778 ask questions or their hooks get errors. */
1779 if (!b->base_buffer && b->indirections > 0)
1781 struct buffer *other;
1783 GCPRO1 (buffer);
1785 FOR_EACH_BUFFER (other)
1786 if (other->base_buffer == b)
1788 Lisp_Object buf;
1789 XSETBUFFER (buf, other);
1790 Fkill_buffer (buf);
1793 UNGCPRO;
1795 /* Exit if we now have killed the base buffer (Bug#11665). */
1796 if (!BUFFER_LIVE_P (b))
1797 return Qt;
1800 /* Run replace_buffer_in_windows before making another buffer current
1801 since set-window-buffer-start-and-point will refuse to make another
1802 buffer current if the selected window does not show the current
1803 buffer. (Bug#10114) */
1804 replace_buffer_in_windows (buffer);
1806 /* Exit if replacing the buffer in windows has killed our buffer. */
1807 if (!BUFFER_LIVE_P (b))
1808 return Qt;
1810 /* Make this buffer not be current. Exit if it is the sole visible
1811 buffer. */
1812 if (b == current_buffer)
1814 tem = Fother_buffer (buffer, Qnil, Qnil);
1815 Fset_buffer (tem);
1816 if (b == current_buffer)
1817 return Qnil;
1820 /* If the buffer now current is shown in the minibuffer and our buffer
1821 is the sole other buffer give up. */
1822 XSETBUFFER (tem, current_buffer);
1823 if (EQ (tem, XWINDOW (minibuf_window)->buffer)
1824 && EQ (buffer, Fother_buffer (buffer, Qnil, Qnil)))
1825 return Qnil;
1827 /* Now there is no question: we can kill the buffer. */
1829 #ifdef CLASH_DETECTION
1830 /* Unlock this buffer's file, if it is locked. */
1831 unlock_buffer (b);
1832 #endif /* CLASH_DETECTION */
1834 GCPRO1 (buffer);
1835 kill_buffer_processes (buffer);
1836 UNGCPRO;
1838 /* Killing buffer processes may run sentinels which may have killed
1839 our buffer. */
1840 if (!BUFFER_LIVE_P (b))
1841 return Qt;
1843 /* These may run Lisp code and into infinite loops (if someone
1844 insisted on circular lists) so allow quitting here. */
1845 frames_discard_buffer (buffer);
1847 clear_charpos_cache (b);
1849 tem = Vinhibit_quit;
1850 Vinhibit_quit = Qt;
1851 /* Remove the buffer from the list of all buffers. */
1852 Vbuffer_alist = Fdelq (Frassq (buffer, Vbuffer_alist), Vbuffer_alist);
1853 /* If replace_buffer_in_windows didn't do its job fix that now. */
1854 replace_buffer_in_windows_safely (buffer);
1855 Vinhibit_quit = tem;
1857 /* Delete any auto-save file, if we saved it in this session.
1858 But not if the buffer is modified. */
1859 if (STRINGP (BVAR (b, auto_save_file_name))
1860 && BUF_AUTOSAVE_MODIFF (b) != 0
1861 && BUF_SAVE_MODIFF (b) < BUF_AUTOSAVE_MODIFF (b)
1862 && BUF_SAVE_MODIFF (b) < BUF_MODIFF (b)
1863 && NILP (Fsymbol_value (intern ("auto-save-visited-file-name"))))
1865 Lisp_Object delete;
1866 delete = Fsymbol_value (intern ("delete-auto-save-files"));
1867 if (! NILP (delete))
1868 internal_delete_file (BVAR (b, auto_save_file_name));
1871 /* Deleting an auto-save file could have killed our buffer. */
1872 if (!BUFFER_LIVE_P (b))
1873 return Qt;
1875 if (b->base_buffer)
1877 /* Unchain all markers that belong to this indirect buffer.
1878 Don't unchain the markers that belong to the base buffer
1879 or its other indirect buffers. */
1880 struct Lisp_Marker **mp = &BUF_MARKERS (b);
1881 while ((m = *mp))
1883 if (m->buffer == b)
1885 m->buffer = NULL;
1886 *mp = m->next;
1888 else
1889 mp = &m->next;
1892 else
1894 /* Unchain all markers of this buffer and its indirect buffers.
1895 and leave them pointing nowhere. */
1896 for (m = BUF_MARKERS (b); m; )
1898 struct Lisp_Marker *next = m->next;
1899 m->buffer = 0;
1900 m->next = NULL;
1901 m = next;
1903 BUF_MARKERS (b) = NULL;
1904 set_buffer_intervals (b, NULL);
1906 /* Perhaps we should explicitly free the interval tree here... */
1908 /* Since we've unlinked the markers, the overlays can't be here any more
1909 either. */
1910 b->overlays_before = NULL;
1911 b->overlays_after = NULL;
1913 /* Reset the local variables, so that this buffer's local values
1914 won't be protected from GC. They would be protected
1915 if they happened to remain cached in their symbols.
1916 This gets rid of them for certain. */
1917 swap_out_buffer_local_variables (b);
1918 reset_buffer_local_variables (b, 1);
1920 bset_name (b, Qnil);
1922 block_input ();
1923 if (b->base_buffer)
1925 /* Notify our base buffer that we don't share the text anymore. */
1926 eassert (b->indirections == -1);
1927 b->base_buffer->indirections--;
1928 eassert (b->base_buffer->indirections >= 0);
1930 else
1931 /* No one shares our buffer text, can free it. */
1932 free_buffer_text (b);
1934 if (b->newline_cache)
1936 free_region_cache (b->newline_cache);
1937 b->newline_cache = 0;
1939 if (b->width_run_cache)
1941 free_region_cache (b->width_run_cache);
1942 b->width_run_cache = 0;
1944 bset_width_table (b, Qnil);
1945 unblock_input ();
1946 bset_undo_list (b, Qnil);
1948 /* Run buffer-list-update-hook. */
1949 if (!NILP (Vrun_hooks))
1950 call1 (Vrun_hooks, Qbuffer_list_update_hook);
1952 return Qt;
1955 /* Move association for BUFFER to the front of buffer (a)lists. Since
1956 we do this each time BUFFER is selected visibly, the more recently
1957 selected buffers are always closer to the front of those lists. This
1958 means that other_buffer is more likely to choose a relevant buffer.
1960 Note that this moves BUFFER to the front of the buffer lists of the
1961 selected frame even if BUFFER is not shown there. If BUFFER is not
1962 shown in the selected frame, consider the present behavior a feature.
1963 `select-window' gets this right since it shows BUFFER in the selected
1964 window when calling us. */
1966 void
1967 record_buffer (Lisp_Object buffer)
1969 Lisp_Object aelt, aelt_cons, tem;
1970 register struct frame *f = XFRAME (selected_frame);
1972 CHECK_BUFFER (buffer);
1974 /* Update Vbuffer_alist (we know that it has an entry for BUFFER).
1975 Don't allow quitting since this might leave the buffer list in an
1976 inconsistent state. */
1977 tem = Vinhibit_quit;
1978 Vinhibit_quit = Qt;
1979 aelt = Frassq (buffer, Vbuffer_alist);
1980 aelt_cons = Fmemq (aelt, Vbuffer_alist);
1981 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
1982 XSETCDR (aelt_cons, Vbuffer_alist);
1983 Vbuffer_alist = aelt_cons;
1984 Vinhibit_quit = tem;
1986 /* Update buffer list of selected frame. */
1987 fset_buffer_list (f, Fcons (buffer, Fdelq (buffer, f->buffer_list)));
1988 fset_buried_buffer_list (f, Fdelq (buffer, f->buried_buffer_list));
1990 /* Run buffer-list-update-hook. */
1991 if (!NILP (Vrun_hooks))
1992 call1 (Vrun_hooks, Qbuffer_list_update_hook);
1996 /* Move BUFFER to the end of the buffer (a)lists. Do nothing if the
1997 buffer is killed. For the selected frame's buffer list this moves
1998 BUFFER to its end even if it was never shown in that frame. If
1999 this happens we have a feature, hence `bury-buffer-internal' should be
2000 called only when BUFFER was shown in the selected frame. */
2002 DEFUN ("bury-buffer-internal", Fbury_buffer_internal, Sbury_buffer_internal,
2003 1, 1, 0,
2004 doc: /* Move BUFFER to the end of the buffer list. */)
2005 (Lisp_Object buffer)
2007 Lisp_Object aelt, aelt_cons, tem;
2008 register struct frame *f = XFRAME (selected_frame);
2010 CHECK_BUFFER (buffer);
2012 /* Update Vbuffer_alist (we know that it has an entry for BUFFER).
2013 Don't allow quitting since this might leave the buffer list in an
2014 inconsistent state. */
2015 tem = Vinhibit_quit;
2016 Vinhibit_quit = Qt;
2017 aelt = Frassq (buffer, Vbuffer_alist);
2018 aelt_cons = Fmemq (aelt, Vbuffer_alist);
2019 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
2020 XSETCDR (aelt_cons, Qnil);
2021 Vbuffer_alist = nconc2 (Vbuffer_alist, aelt_cons);
2022 Vinhibit_quit = tem;
2024 /* Update buffer lists of selected frame. */
2025 fset_buffer_list (f, Fdelq (buffer, f->buffer_list));
2026 fset_buried_buffer_list
2027 (f, Fcons (buffer, Fdelq (buffer, f->buried_buffer_list)));
2029 /* Run buffer-list-update-hook. */
2030 if (!NILP (Vrun_hooks))
2031 call1 (Vrun_hooks, Qbuffer_list_update_hook);
2033 return Qnil;
2036 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode, Sset_buffer_major_mode, 1, 1, 0,
2037 doc: /* Set an appropriate major mode for BUFFER.
2038 For the *scratch* buffer, use `initial-major-mode', otherwise choose a mode
2039 according to `default-major-mode'.
2040 Use this function before selecting the buffer, since it may need to inspect
2041 the current buffer's major mode. */)
2042 (Lisp_Object buffer)
2044 ptrdiff_t count;
2045 Lisp_Object function;
2047 CHECK_BUFFER (buffer);
2049 if (!BUFFER_LIVE_P (XBUFFER (buffer)))
2050 error ("Attempt to set major mode for a dead buffer");
2052 if (strcmp (SSDATA (BVAR (XBUFFER (buffer), name)), "*scratch*") == 0)
2053 function = find_symbol_value (intern ("initial-major-mode"));
2054 else
2056 function = BVAR (&buffer_defaults, major_mode);
2057 if (NILP (function)
2058 && NILP (Fget (BVAR (current_buffer, major_mode), Qmode_class)))
2059 function = BVAR (current_buffer, major_mode);
2062 if (NILP (function) || EQ (function, Qfundamental_mode))
2063 return Qnil;
2065 count = SPECPDL_INDEX ();
2067 /* To select a nonfundamental mode,
2068 select the buffer temporarily and then call the mode function. */
2070 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2072 Fset_buffer (buffer);
2073 call0 (function);
2075 return unbind_to (count, Qnil);
2078 DEFUN ("current-buffer", Fcurrent_buffer, Scurrent_buffer, 0, 0, 0,
2079 doc: /* Return the current buffer as a Lisp object. */)
2080 (void)
2082 register Lisp_Object buf;
2083 XSETBUFFER (buf, current_buffer);
2084 return buf;
2087 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
2088 This is used by redisplay. */
2090 void
2091 set_buffer_internal_1 (register struct buffer *b)
2093 register struct buffer *old_buf;
2094 register Lisp_Object tail;
2096 #ifdef USE_MMAP_FOR_BUFFERS
2097 if (b->text->beg == NULL)
2098 enlarge_buffer_text (b, 0);
2099 #endif /* USE_MMAP_FOR_BUFFERS */
2101 if (current_buffer == b)
2102 return;
2104 BUFFER_CHECK_INDIRECTION (b);
2106 old_buf = current_buffer;
2107 current_buffer = b;
2108 last_known_column_point = -1; /* invalidate indentation cache */
2110 if (old_buf)
2112 /* Put the undo list back in the base buffer, so that it appears
2113 that an indirect buffer shares the undo list of its base. */
2114 if (old_buf->base_buffer)
2115 bset_undo_list (old_buf->base_buffer, BVAR (old_buf, undo_list));
2117 /* If the old current buffer has markers to record PT, BEGV and ZV
2118 when it is not current, update them now. */
2119 record_buffer_markers (old_buf);
2122 /* Get the undo list from the base buffer, so that it appears
2123 that an indirect buffer shares the undo list of its base. */
2124 if (b->base_buffer)
2125 bset_undo_list (b, BVAR (b->base_buffer, undo_list));
2127 /* If the new current buffer has markers to record PT, BEGV and ZV
2128 when it is not current, fetch them now. */
2129 fetch_buffer_markers (b);
2131 /* Look down buffer's list of local Lisp variables
2132 to find and update any that forward into C variables. */
2136 for (tail = BVAR (b, local_var_alist); CONSP (tail); tail = XCDR (tail))
2138 Lisp_Object var = XCAR (XCAR (tail));
2139 struct Lisp_Symbol *sym = XSYMBOL (var);
2140 if (sym->redirect == SYMBOL_LOCALIZED /* Just to be sure. */
2141 && SYMBOL_BLV (sym)->fwd)
2142 /* Just reference the variable
2143 to cause it to become set for this buffer. */
2144 Fsymbol_value (var);
2147 /* Do the same with any others that were local to the previous buffer */
2148 while (b != old_buf && (b = old_buf, b));
2151 /* Switch to buffer B temporarily for redisplay purposes.
2152 This avoids certain things that don't need to be done within redisplay. */
2154 void
2155 set_buffer_temp (struct buffer *b)
2157 register struct buffer *old_buf;
2159 if (current_buffer == b)
2160 return;
2162 old_buf = current_buffer;
2163 current_buffer = b;
2165 /* If the old current buffer has markers to record PT, BEGV and ZV
2166 when it is not current, update them now. */
2167 record_buffer_markers (old_buf);
2169 /* If the new current buffer has markers to record PT, BEGV and ZV
2170 when it is not current, fetch them now. */
2171 fetch_buffer_markers (b);
2174 DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
2175 doc: /* Make buffer BUFFER-OR-NAME current for editing operations.
2176 BUFFER-OR-NAME may be a buffer or the name of an existing buffer. See
2177 also `with-current-buffer' when you want to make a buffer current
2178 temporarily. This function does not display the buffer, so its effect
2179 ends when the current command terminates. Use `switch-to-buffer' or
2180 `pop-to-buffer' to switch buffers permanently. */)
2181 (register Lisp_Object buffer_or_name)
2183 register Lisp_Object buffer;
2184 buffer = Fget_buffer (buffer_or_name);
2185 if (NILP (buffer))
2186 nsberror (buffer_or_name);
2187 if (!BUFFER_LIVE_P (XBUFFER (buffer)))
2188 error ("Selecting deleted buffer");
2189 set_buffer_internal (XBUFFER (buffer));
2190 return buffer;
2193 /* Set the current buffer to BUFFER provided if it is alive. */
2195 Lisp_Object
2196 set_buffer_if_live (Lisp_Object buffer)
2198 if (BUFFER_LIVE_P (XBUFFER (buffer)))
2199 set_buffer_internal (XBUFFER (buffer));
2200 return Qnil;
2203 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only,
2204 Sbarf_if_buffer_read_only, 0, 0, 0,
2205 doc: /* Signal a `buffer-read-only' error if the current buffer is read-only. */)
2206 (void)
2208 if (!NILP (BVAR (current_buffer, read_only))
2209 && NILP (Vinhibit_read_only))
2210 xsignal1 (Qbuffer_read_only, Fcurrent_buffer ());
2211 return Qnil;
2214 DEFUN ("erase-buffer", Ferase_buffer, Serase_buffer, 0, 0, "*",
2215 doc: /* Delete the entire contents of the current buffer.
2216 Any narrowing restriction in effect (see `narrow-to-region') is removed,
2217 so the buffer is truly empty after this. */)
2218 (void)
2220 Fwiden ();
2222 del_range (BEG, Z);
2224 current_buffer->last_window_start = 1;
2225 /* Prevent warnings, or suspension of auto saving, that would happen
2226 if future size is less than past size. Use of erase-buffer
2227 implies that the future text is not really related to the past text. */
2228 XSETFASTINT (BVAR (current_buffer, save_length), 0);
2229 return Qnil;
2232 void
2233 validate_region (register Lisp_Object *b, register Lisp_Object *e)
2235 CHECK_NUMBER_COERCE_MARKER (*b);
2236 CHECK_NUMBER_COERCE_MARKER (*e);
2238 if (XINT (*b) > XINT (*e))
2240 Lisp_Object tem;
2241 tem = *b; *b = *e; *e = tem;
2244 if (! (BEGV <= XINT (*b) && XINT (*e) <= ZV))
2245 args_out_of_range (*b, *e);
2248 /* Advance BYTE_POS up to a character boundary
2249 and return the adjusted position. */
2251 static ptrdiff_t
2252 advance_to_char_boundary (ptrdiff_t byte_pos)
2254 int c;
2256 if (byte_pos == BEG)
2257 /* Beginning of buffer is always a character boundary. */
2258 return BEG;
2260 c = FETCH_BYTE (byte_pos);
2261 if (! CHAR_HEAD_P (c))
2263 /* We should advance BYTE_POS only when C is a constituent of a
2264 multibyte sequence. */
2265 ptrdiff_t orig_byte_pos = byte_pos;
2269 byte_pos--;
2270 c = FETCH_BYTE (byte_pos);
2272 while (! CHAR_HEAD_P (c) && byte_pos > BEG);
2273 INC_POS (byte_pos);
2274 if (byte_pos < orig_byte_pos)
2275 byte_pos = orig_byte_pos;
2276 /* If C is a constituent of a multibyte sequence, BYTE_POS was
2277 surely advance to the correct character boundary. If C is
2278 not, BYTE_POS was unchanged. */
2281 return byte_pos;
2284 DEFUN ("buffer-swap-text", Fbuffer_swap_text, Sbuffer_swap_text,
2285 1, 1, 0,
2286 doc: /* Swap the text between current buffer and BUFFER. */)
2287 (Lisp_Object buffer)
2289 struct buffer *other_buffer;
2290 CHECK_BUFFER (buffer);
2291 other_buffer = XBUFFER (buffer);
2293 if (!BUFFER_LIVE_P (other_buffer))
2294 error ("Cannot swap a dead buffer's text");
2296 /* Actually, it probably works just fine.
2297 * if (other_buffer == current_buffer)
2298 * error ("Cannot swap a buffer's text with itself"); */
2300 /* Actually, this may be workable as well, tho probably only if they're
2301 *both* indirect. */
2302 if (other_buffer->base_buffer
2303 || current_buffer->base_buffer)
2304 error ("Cannot swap indirect buffers's text");
2306 { /* This is probably harder to make work. */
2307 struct buffer *other;
2308 FOR_EACH_BUFFER (other)
2309 if (other->base_buffer == other_buffer
2310 || other->base_buffer == current_buffer)
2311 error ("One of the buffers to swap has indirect buffers");
2314 #define swapfield(field, type) \
2315 do { \
2316 type tmp##field = other_buffer->field; \
2317 other_buffer->field = current_buffer->field; \
2318 current_buffer->field = tmp##field; \
2319 } while (0)
2320 #define swapfield_(field, type) \
2321 do { \
2322 type tmp##field = BVAR (other_buffer, field); \
2323 bset_##field (other_buffer, BVAR (current_buffer, field)); \
2324 bset_##field (current_buffer, tmp##field); \
2325 } while (0)
2327 swapfield (own_text, struct buffer_text);
2328 eassert (current_buffer->text == &current_buffer->own_text);
2329 eassert (other_buffer->text == &other_buffer->own_text);
2330 #ifdef REL_ALLOC
2331 r_alloc_reset_variable ((void **) &current_buffer->own_text.beg,
2332 (void **) &other_buffer->own_text.beg);
2333 r_alloc_reset_variable ((void **) &other_buffer->own_text.beg,
2334 (void **) &current_buffer->own_text.beg);
2335 #endif /* REL_ALLOC */
2337 swapfield (pt, ptrdiff_t);
2338 swapfield (pt_byte, ptrdiff_t);
2339 swapfield (begv, ptrdiff_t);
2340 swapfield (begv_byte, ptrdiff_t);
2341 swapfield (zv, ptrdiff_t);
2342 swapfield (zv_byte, ptrdiff_t);
2343 eassert (!current_buffer->base_buffer);
2344 eassert (!other_buffer->base_buffer);
2345 swapfield (indirections, ptrdiff_t);
2346 current_buffer->clip_changed = 1; other_buffer->clip_changed = 1;
2347 swapfield (newline_cache, struct region_cache *);
2348 swapfield (width_run_cache, struct region_cache *);
2349 current_buffer->prevent_redisplay_optimizations_p = 1;
2350 other_buffer->prevent_redisplay_optimizations_p = 1;
2351 swapfield (overlays_before, struct Lisp_Overlay *);
2352 swapfield (overlays_after, struct Lisp_Overlay *);
2353 swapfield (overlay_center, ptrdiff_t);
2354 swapfield_ (undo_list, Lisp_Object);
2355 swapfield_ (mark, Lisp_Object);
2356 swapfield_ (enable_multibyte_characters, Lisp_Object);
2357 swapfield_ (bidi_display_reordering, Lisp_Object);
2358 swapfield_ (bidi_paragraph_direction, Lisp_Object);
2359 /* FIXME: Not sure what we should do with these *_marker fields.
2360 Hopefully they're just nil anyway. */
2361 swapfield_ (pt_marker, Lisp_Object);
2362 swapfield_ (begv_marker, Lisp_Object);
2363 swapfield_ (zv_marker, Lisp_Object);
2364 bset_point_before_scroll (current_buffer, Qnil);
2365 bset_point_before_scroll (other_buffer, Qnil);
2367 current_buffer->text->modiff++; other_buffer->text->modiff++;
2368 current_buffer->text->chars_modiff++; other_buffer->text->chars_modiff++;
2369 current_buffer->text->overlay_modiff++; other_buffer->text->overlay_modiff++;
2370 current_buffer->text->beg_unchanged = current_buffer->text->gpt;
2371 current_buffer->text->end_unchanged = current_buffer->text->gpt;
2372 other_buffer->text->beg_unchanged = other_buffer->text->gpt;
2373 other_buffer->text->end_unchanged = other_buffer->text->gpt;
2375 struct Lisp_Marker *m;
2376 for (m = BUF_MARKERS (current_buffer); m; m = m->next)
2377 if (m->buffer == other_buffer)
2378 m->buffer = current_buffer;
2379 else
2380 /* Since there's no indirect buffer in sight, markers on
2381 BUF_MARKERS(buf) should either be for `buf' or dead. */
2382 eassert (!m->buffer);
2383 for (m = BUF_MARKERS (other_buffer); m; m = m->next)
2384 if (m->buffer == current_buffer)
2385 m->buffer = other_buffer;
2386 else
2387 /* Since there's no indirect buffer in sight, markers on
2388 BUF_MARKERS(buf) should either be for `buf' or dead. */
2389 eassert (!m->buffer);
2391 { /* Some of the C code expects that w->buffer == w->pointm->buffer.
2392 So since we just swapped the markers between the two buffers, we need
2393 to undo the effect of this swap for window markers. */
2394 Lisp_Object w = Fselected_window (), ws = Qnil;
2395 Lisp_Object buf1, buf2;
2396 XSETBUFFER (buf1, current_buffer); XSETBUFFER (buf2, other_buffer);
2398 while (NILP (Fmemq (w, ws)))
2400 ws = Fcons (w, ws);
2401 if (MARKERP (XWINDOW (w)->pointm)
2402 && (EQ (XWINDOW (w)->buffer, buf1)
2403 || EQ (XWINDOW (w)->buffer, buf2)))
2404 Fset_marker (XWINDOW (w)->pointm,
2405 make_number
2406 (BUF_BEGV (XBUFFER (XWINDOW (w)->buffer))),
2407 XWINDOW (w)->buffer);
2408 w = Fnext_window (w, Qt, Qt);
2412 if (current_buffer->text->intervals)
2413 (eassert (EQ (current_buffer->text->intervals->up.obj, buffer)),
2414 XSETBUFFER (current_buffer->text->intervals->up.obj, current_buffer));
2415 if (other_buffer->text->intervals)
2416 (eassert (EQ (other_buffer->text->intervals->up.obj, Fcurrent_buffer ())),
2417 XSETBUFFER (other_buffer->text->intervals->up.obj, other_buffer));
2419 return Qnil;
2422 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte, Sset_buffer_multibyte,
2423 1, 1, 0,
2424 doc: /* Set the multibyte flag of the current buffer to FLAG.
2425 If FLAG is t, this makes the buffer a multibyte buffer.
2426 If FLAG is nil, this makes the buffer a single-byte buffer.
2427 In these cases, the buffer contents remain unchanged as a sequence of
2428 bytes but the contents viewed as characters do change.
2429 If FLAG is `to', this makes the buffer a multibyte buffer by changing
2430 all eight-bit bytes to eight-bit characters.
2431 If the multibyte flag was really changed, undo information of the
2432 current buffer is cleared. */)
2433 (Lisp_Object flag)
2435 struct Lisp_Marker *tail, *markers;
2436 struct buffer *other;
2437 ptrdiff_t begv, zv;
2438 bool narrowed = (BEG != BEGV || Z != ZV);
2439 bool modified_p = !NILP (Fbuffer_modified_p (Qnil));
2440 Lisp_Object old_undo = BVAR (current_buffer, undo_list);
2441 struct gcpro gcpro1;
2443 if (current_buffer->base_buffer)
2444 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
2446 /* Do nothing if nothing actually changes. */
2447 if (NILP (flag) == NILP (BVAR (current_buffer, enable_multibyte_characters)))
2448 return flag;
2450 GCPRO1 (old_undo);
2452 /* Don't record these buffer changes. We will put a special undo entry
2453 instead. */
2454 bset_undo_list (current_buffer, Qt);
2456 /* If the cached position is for this buffer, clear it out. */
2457 clear_charpos_cache (current_buffer);
2459 if (NILP (flag))
2460 begv = BEGV_BYTE, zv = ZV_BYTE;
2461 else
2462 begv = BEGV, zv = ZV;
2464 if (narrowed)
2465 error ("Changing multibyteness in a narrowed buffer");
2467 if (NILP (flag))
2469 ptrdiff_t pos, stop;
2470 unsigned char *p;
2472 /* Do this first, so it can use CHAR_TO_BYTE
2473 to calculate the old correspondences. */
2474 set_intervals_multibyte (0);
2476 bset_enable_multibyte_characters (current_buffer, Qnil);
2478 Z = Z_BYTE;
2479 BEGV = BEGV_BYTE;
2480 ZV = ZV_BYTE;
2481 GPT = GPT_BYTE;
2482 TEMP_SET_PT_BOTH (PT_BYTE, PT_BYTE);
2485 for (tail = BUF_MARKERS (current_buffer); tail; tail = tail->next)
2486 tail->charpos = tail->bytepos;
2488 /* Convert multibyte form of 8-bit characters to unibyte. */
2489 pos = BEG;
2490 stop = GPT;
2491 p = BEG_ADDR;
2492 while (1)
2494 int c, bytes;
2496 if (pos == stop)
2498 if (pos == Z)
2499 break;
2500 p = GAP_END_ADDR;
2501 stop = Z;
2503 if (ASCII_BYTE_P (*p))
2504 p++, pos++;
2505 else if (CHAR_BYTE8_HEAD_P (*p))
2507 c = STRING_CHAR_AND_LENGTH (p, bytes);
2508 /* Delete all bytes for this 8-bit character but the
2509 last one, and change the last one to the character
2510 code. */
2511 bytes--;
2512 del_range_2 (pos, pos, pos + bytes, pos + bytes, 0);
2513 p = GAP_END_ADDR;
2514 *p++ = c;
2515 pos++;
2516 if (begv > pos)
2517 begv -= bytes;
2518 if (zv > pos)
2519 zv -= bytes;
2520 stop = Z;
2522 else
2524 bytes = BYTES_BY_CHAR_HEAD (*p);
2525 p += bytes, pos += bytes;
2528 if (narrowed)
2529 Fnarrow_to_region (make_number (begv), make_number (zv));
2531 else
2533 ptrdiff_t pt = PT;
2534 ptrdiff_t pos, stop;
2535 unsigned char *p, *pend;
2537 /* Be sure not to have a multibyte sequence striding over the GAP.
2538 Ex: We change this: "...abc\302 _GAP_ \241def..."
2539 to: "...abc _GAP_ \302\241def..." */
2541 if (EQ (flag, Qt)
2542 && GPT_BYTE > 1 && GPT_BYTE < Z_BYTE
2543 && ! CHAR_HEAD_P (*(GAP_END_ADDR)))
2545 unsigned char *q = GPT_ADDR - 1;
2547 while (! CHAR_HEAD_P (*q) && q > BEG_ADDR) q--;
2548 if (LEADING_CODE_P (*q))
2550 ptrdiff_t new_gpt = GPT_BYTE - (GPT_ADDR - q);
2552 move_gap_both (new_gpt, new_gpt);
2556 /* Make the buffer contents valid as multibyte by converting
2557 8-bit characters to multibyte form. */
2558 pos = BEG;
2559 stop = GPT;
2560 p = BEG_ADDR;
2561 pend = GPT_ADDR;
2562 while (1)
2564 int bytes;
2566 if (pos == stop)
2568 if (pos == Z)
2569 break;
2570 p = GAP_END_ADDR;
2571 pend = Z_ADDR;
2572 stop = Z;
2575 if (ASCII_BYTE_P (*p))
2576 p++, pos++;
2577 else if (EQ (flag, Qt)
2578 && ! CHAR_BYTE8_HEAD_P (*p)
2579 && (bytes = MULTIBYTE_LENGTH (p, pend)) > 0)
2580 p += bytes, pos += bytes;
2581 else
2583 unsigned char tmp[MAX_MULTIBYTE_LENGTH];
2584 int c;
2586 c = BYTE8_TO_CHAR (*p);
2587 bytes = CHAR_STRING (c, tmp);
2588 *p = tmp[0];
2589 TEMP_SET_PT_BOTH (pos + 1, pos + 1);
2590 bytes--;
2591 insert_1_both ((char *) tmp + 1, bytes, bytes, 1, 0, 0);
2592 /* Now the gap is after the just inserted data. */
2593 pos = GPT;
2594 p = GAP_END_ADDR;
2595 if (pos <= begv)
2596 begv += bytes;
2597 if (pos <= zv)
2598 zv += bytes;
2599 if (pos <= pt)
2600 pt += bytes;
2601 pend = Z_ADDR;
2602 stop = Z;
2606 if (pt != PT)
2607 TEMP_SET_PT (pt);
2609 if (narrowed)
2610 Fnarrow_to_region (make_number (begv), make_number (zv));
2612 /* Do this first, so that chars_in_text asks the right question.
2613 set_intervals_multibyte needs it too. */
2614 bset_enable_multibyte_characters (current_buffer, Qt);
2616 GPT_BYTE = advance_to_char_boundary (GPT_BYTE);
2617 GPT = chars_in_text (BEG_ADDR, GPT_BYTE - BEG_BYTE) + BEG;
2619 Z = chars_in_text (GAP_END_ADDR, Z_BYTE - GPT_BYTE) + GPT;
2621 BEGV_BYTE = advance_to_char_boundary (BEGV_BYTE);
2622 if (BEGV_BYTE > GPT_BYTE)
2623 BEGV = chars_in_text (GAP_END_ADDR, BEGV_BYTE - GPT_BYTE) + GPT;
2624 else
2625 BEGV = chars_in_text (BEG_ADDR, BEGV_BYTE - BEG_BYTE) + BEG;
2627 ZV_BYTE = advance_to_char_boundary (ZV_BYTE);
2628 if (ZV_BYTE > GPT_BYTE)
2629 ZV = chars_in_text (GAP_END_ADDR, ZV_BYTE - GPT_BYTE) + GPT;
2630 else
2631 ZV = chars_in_text (BEG_ADDR, ZV_BYTE - BEG_BYTE) + BEG;
2634 ptrdiff_t byte = advance_to_char_boundary (PT_BYTE);
2635 ptrdiff_t position;
2637 if (byte > GPT_BYTE)
2638 position = chars_in_text (GAP_END_ADDR, byte - GPT_BYTE) + GPT;
2639 else
2640 position = chars_in_text (BEG_ADDR, byte - BEG_BYTE) + BEG;
2641 TEMP_SET_PT_BOTH (position, byte);
2644 tail = markers = BUF_MARKERS (current_buffer);
2646 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
2647 getting confused by the markers that have not yet been updated.
2648 It is also a signal that it should never create a marker. */
2649 BUF_MARKERS (current_buffer) = NULL;
2651 for (; tail; tail = tail->next)
2653 tail->bytepos = advance_to_char_boundary (tail->bytepos);
2654 tail->charpos = BYTE_TO_CHAR (tail->bytepos);
2657 /* Make sure no markers were put on the chain
2658 while the chain value was incorrect. */
2659 if (BUF_MARKERS (current_buffer))
2660 emacs_abort ();
2662 BUF_MARKERS (current_buffer) = markers;
2664 /* Do this last, so it can calculate the new correspondences
2665 between chars and bytes. */
2666 set_intervals_multibyte (1);
2669 if (!EQ (old_undo, Qt))
2671 /* Represent all the above changes by a special undo entry. */
2672 bset_undo_list (current_buffer,
2673 Fcons (list3 (Qapply,
2674 intern ("set-buffer-multibyte"),
2675 NILP (flag) ? Qt : Qnil),
2676 old_undo));
2679 UNGCPRO;
2681 /* Changing the multibyteness of a buffer means that all windows
2682 showing that buffer must be updated thoroughly. */
2683 current_buffer->prevent_redisplay_optimizations_p = 1;
2684 ++windows_or_buffers_changed;
2686 /* Copy this buffer's new multibyte status
2687 into all of its indirect buffers. */
2688 FOR_EACH_BUFFER (other)
2689 if (other->base_buffer == current_buffer && BUFFER_LIVE_P (other))
2691 BVAR (other, enable_multibyte_characters)
2692 = BVAR (current_buffer, enable_multibyte_characters);
2693 other->prevent_redisplay_optimizations_p = 1;
2696 /* Restore the modifiedness of the buffer. */
2697 if (!modified_p && !NILP (Fbuffer_modified_p (Qnil)))
2698 Fset_buffer_modified_p (Qnil);
2700 /* Update coding systems of this buffer's process (if any). */
2702 Lisp_Object process;
2704 process = Fget_buffer_process (Fcurrent_buffer ());
2705 if (PROCESSP (process))
2706 setup_process_coding_systems (process);
2709 return flag;
2712 DEFUN ("kill-all-local-variables", Fkill_all_local_variables,
2713 Skill_all_local_variables, 0, 0, 0,
2714 doc: /* Switch to Fundamental mode by killing current buffer's local variables.
2715 Most local variable bindings are eliminated so that the default values
2716 become effective once more. Also, the syntax table is set from
2717 `standard-syntax-table', the local keymap is set to nil,
2718 and the abbrev table from `fundamental-mode-abbrev-table'.
2719 This function also forces redisplay of the mode line.
2721 Every function to select a new major mode starts by
2722 calling this function.
2724 As a special exception, local variables whose names have
2725 a non-nil `permanent-local' property are not eliminated by this function.
2727 The first thing this function does is run
2728 the normal hook `change-major-mode-hook'. */)
2729 (void)
2731 Frun_hooks (1, &Qchange_major_mode_hook);
2733 /* Make sure none of the bindings in local_var_alist
2734 remain swapped in, in their symbols. */
2736 swap_out_buffer_local_variables (current_buffer);
2738 /* Actually eliminate all local bindings of this buffer. */
2740 reset_buffer_local_variables (current_buffer, 0);
2742 /* Force mode-line redisplay. Useful here because all major mode
2743 commands call this function. */
2744 update_mode_lines++;
2746 return Qnil;
2749 /* Make sure no local variables remain set up with buffer B
2750 for their current values. */
2752 static void
2753 swap_out_buffer_local_variables (struct buffer *b)
2755 Lisp_Object oalist, alist, buffer;
2757 XSETBUFFER (buffer, b);
2758 oalist = BVAR (b, local_var_alist);
2760 for (alist = oalist; CONSP (alist); alist = XCDR (alist))
2762 Lisp_Object sym = XCAR (XCAR (alist));
2763 eassert (XSYMBOL (sym)->redirect == SYMBOL_LOCALIZED);
2764 /* Need not do anything if some other buffer's binding is
2765 now cached. */
2766 if (EQ (SYMBOL_BLV (XSYMBOL (sym))->where, buffer))
2768 /* Symbol is set up for this buffer's old local value:
2769 swap it out! */
2770 swap_in_global_binding (XSYMBOL (sym));
2775 /* Find all the overlays in the current buffer that contain position POS.
2776 Return the number found, and store them in a vector in *VEC_PTR.
2777 Store in *LEN_PTR the size allocated for the vector.
2778 Store in *NEXT_PTR the next position after POS where an overlay starts,
2779 or ZV if there are no more overlays between POS and ZV.
2780 Store in *PREV_PTR the previous position before POS where an overlay ends,
2781 or where an overlay starts which ends at or after POS;
2782 or BEGV if there are no such overlays from BEGV to POS.
2783 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2785 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2786 when this function is called.
2788 If EXTEND, make the vector bigger if necessary.
2789 If not, never extend the vector,
2790 and store only as many overlays as will fit.
2791 But still return the total number of overlays.
2793 If CHANGE_REQ, any position written into *PREV_PTR or
2794 *NEXT_PTR is guaranteed to be not equal to POS, unless it is the
2795 default (BEGV or ZV). */
2797 ptrdiff_t
2798 overlays_at (EMACS_INT pos, bool extend, Lisp_Object **vec_ptr,
2799 ptrdiff_t *len_ptr,
2800 ptrdiff_t *next_ptr, ptrdiff_t *prev_ptr, bool change_req)
2802 Lisp_Object overlay, start, end;
2803 struct Lisp_Overlay *tail;
2804 ptrdiff_t idx = 0;
2805 ptrdiff_t len = *len_ptr;
2806 Lisp_Object *vec = *vec_ptr;
2807 ptrdiff_t next = ZV;
2808 ptrdiff_t prev = BEGV;
2809 bool inhibit_storing = 0;
2811 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2813 ptrdiff_t startpos, endpos;
2815 XSETMISC (overlay, tail);
2817 start = OVERLAY_START (overlay);
2818 end = OVERLAY_END (overlay);
2819 endpos = OVERLAY_POSITION (end);
2820 if (endpos < pos)
2822 if (prev < endpos)
2823 prev = endpos;
2824 break;
2826 startpos = OVERLAY_POSITION (start);
2827 /* This one ends at or after POS
2828 so its start counts for PREV_PTR if it's before POS. */
2829 if (prev < startpos && startpos < pos)
2830 prev = startpos;
2831 if (endpos == pos)
2832 continue;
2833 if (startpos <= pos)
2835 if (idx == len)
2837 /* The supplied vector is full.
2838 Either make it bigger, or don't store any more in it. */
2839 if (extend)
2841 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2842 sizeof *vec);
2843 *vec_ptr = vec;
2844 len = *len_ptr;
2846 else
2847 inhibit_storing = 1;
2850 if (!inhibit_storing)
2851 vec[idx] = overlay;
2852 /* Keep counting overlays even if we can't return them all. */
2853 idx++;
2855 else if (startpos < next)
2856 next = startpos;
2859 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
2861 ptrdiff_t startpos, endpos;
2863 XSETMISC (overlay, tail);
2865 start = OVERLAY_START (overlay);
2866 end = OVERLAY_END (overlay);
2867 startpos = OVERLAY_POSITION (start);
2868 if (pos < startpos)
2870 if (startpos < next)
2871 next = startpos;
2872 break;
2874 endpos = OVERLAY_POSITION (end);
2875 if (pos < endpos)
2877 if (idx == len)
2879 if (extend)
2881 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2882 sizeof *vec);
2883 *vec_ptr = vec;
2884 len = *len_ptr;
2886 else
2887 inhibit_storing = 1;
2890 if (!inhibit_storing)
2891 vec[idx] = overlay;
2892 idx++;
2894 if (startpos < pos && startpos > prev)
2895 prev = startpos;
2897 else if (endpos < pos && endpos > prev)
2898 prev = endpos;
2899 else if (endpos == pos && startpos > prev
2900 && (!change_req || startpos < pos))
2901 prev = startpos;
2904 if (next_ptr)
2905 *next_ptr = next;
2906 if (prev_ptr)
2907 *prev_ptr = prev;
2908 return idx;
2911 /* Find all the overlays in the current buffer that overlap the range
2912 BEG-END, or are empty at BEG, or are empty at END provided END
2913 denotes the position at the end of the current buffer.
2915 Return the number found, and store them in a vector in *VEC_PTR.
2916 Store in *LEN_PTR the size allocated for the vector.
2917 Store in *NEXT_PTR the next position after POS where an overlay starts,
2918 or ZV if there are no more overlays.
2919 Store in *PREV_PTR the previous position before POS where an overlay ends,
2920 or BEGV if there are no previous overlays.
2921 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2923 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2924 when this function is called.
2926 If EXTEND, make the vector bigger if necessary.
2927 If not, never extend the vector,
2928 and store only as many overlays as will fit.
2929 But still return the total number of overlays. */
2931 static ptrdiff_t
2932 overlays_in (EMACS_INT beg, EMACS_INT end, bool extend,
2933 Lisp_Object **vec_ptr, ptrdiff_t *len_ptr,
2934 ptrdiff_t *next_ptr, ptrdiff_t *prev_ptr)
2936 Lisp_Object overlay, ostart, oend;
2937 struct Lisp_Overlay *tail;
2938 ptrdiff_t idx = 0;
2939 ptrdiff_t len = *len_ptr;
2940 Lisp_Object *vec = *vec_ptr;
2941 ptrdiff_t next = ZV;
2942 ptrdiff_t prev = BEGV;
2943 bool inhibit_storing = 0;
2944 bool end_is_Z = end == Z;
2946 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2948 ptrdiff_t startpos, endpos;
2950 XSETMISC (overlay, tail);
2952 ostart = OVERLAY_START (overlay);
2953 oend = OVERLAY_END (overlay);
2954 endpos = OVERLAY_POSITION (oend);
2955 if (endpos < beg)
2957 if (prev < endpos)
2958 prev = endpos;
2959 break;
2961 startpos = OVERLAY_POSITION (ostart);
2962 /* Count an interval if it overlaps the range, is empty at the
2963 start of the range, or is empty at END provided END denotes the
2964 end of the buffer. */
2965 if ((beg < endpos && startpos < end)
2966 || (startpos == endpos
2967 && (beg == endpos || (end_is_Z && endpos == end))))
2969 if (idx == len)
2971 /* The supplied vector is full.
2972 Either make it bigger, or don't store any more in it. */
2973 if (extend)
2975 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
2976 sizeof *vec);
2977 *vec_ptr = vec;
2978 len = *len_ptr;
2980 else
2981 inhibit_storing = 1;
2984 if (!inhibit_storing)
2985 vec[idx] = overlay;
2986 /* Keep counting overlays even if we can't return them all. */
2987 idx++;
2989 else if (startpos < next)
2990 next = startpos;
2993 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
2995 ptrdiff_t startpos, endpos;
2997 XSETMISC (overlay, tail);
2999 ostart = OVERLAY_START (overlay);
3000 oend = OVERLAY_END (overlay);
3001 startpos = OVERLAY_POSITION (ostart);
3002 if (end < startpos)
3004 if (startpos < next)
3005 next = startpos;
3006 break;
3008 endpos = OVERLAY_POSITION (oend);
3009 /* Count an interval if it overlaps the range, is empty at the
3010 start of the range, or is empty at END provided END denotes the
3011 end of the buffer. */
3012 if ((beg < endpos && startpos < end)
3013 || (startpos == endpos
3014 && (beg == endpos || (end_is_Z && endpos == end))))
3016 if (idx == len)
3018 if (extend)
3020 vec = xpalloc (vec, len_ptr, 1, OVERLAY_COUNT_MAX,
3021 sizeof *vec);
3022 *vec_ptr = vec;
3023 len = *len_ptr;
3025 else
3026 inhibit_storing = 1;
3029 if (!inhibit_storing)
3030 vec[idx] = overlay;
3031 idx++;
3033 else if (endpos < beg && endpos > prev)
3034 prev = endpos;
3037 if (next_ptr)
3038 *next_ptr = next;
3039 if (prev_ptr)
3040 *prev_ptr = prev;
3041 return idx;
3045 /* Return true if there exists an overlay with a non-nil
3046 `mouse-face' property overlapping OVERLAY. */
3048 bool
3049 mouse_face_overlay_overlaps (Lisp_Object overlay)
3051 ptrdiff_t start = OVERLAY_POSITION (OVERLAY_START (overlay));
3052 ptrdiff_t end = OVERLAY_POSITION (OVERLAY_END (overlay));
3053 ptrdiff_t n, i, size;
3054 Lisp_Object *v, tem;
3056 size = 10;
3057 v = alloca (size * sizeof *v);
3058 n = overlays_in (start, end, 0, &v, &size, NULL, NULL);
3059 if (n > size)
3061 v = alloca (n * sizeof *v);
3062 overlays_in (start, end, 0, &v, &n, NULL, NULL);
3065 for (i = 0; i < n; ++i)
3066 if (!EQ (v[i], overlay)
3067 && (tem = Foverlay_get (overlay, Qmouse_face),
3068 !NILP (tem)))
3069 break;
3071 return i < n;
3076 /* Fast function to just test if we're at an overlay boundary. */
3077 bool
3078 overlay_touches_p (ptrdiff_t pos)
3080 Lisp_Object overlay;
3081 struct Lisp_Overlay *tail;
3083 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
3085 ptrdiff_t endpos;
3087 XSETMISC (overlay ,tail);
3088 eassert (OVERLAYP (overlay));
3090 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3091 if (endpos < pos)
3092 break;
3093 if (endpos == pos || OVERLAY_POSITION (OVERLAY_START (overlay)) == pos)
3094 return 1;
3097 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
3099 ptrdiff_t startpos;
3101 XSETMISC (overlay, tail);
3102 eassert (OVERLAYP (overlay));
3104 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3105 if (pos < startpos)
3106 break;
3107 if (startpos == pos || OVERLAY_POSITION (OVERLAY_END (overlay)) == pos)
3108 return 1;
3110 return 0;
3113 struct sortvec
3115 Lisp_Object overlay;
3116 ptrdiff_t beg, end;
3117 EMACS_INT priority;
3120 static int
3121 compare_overlays (const void *v1, const void *v2)
3123 const struct sortvec *s1 = (const struct sortvec *) v1;
3124 const struct sortvec *s2 = (const struct sortvec *) v2;
3125 if (s1->priority != s2->priority)
3126 return s1->priority < s2->priority ? -1 : 1;
3127 if (s1->beg != s2->beg)
3128 return s1->beg < s2->beg ? -1 : 1;
3129 if (s1->end != s2->end)
3130 return s2->end < s1->end ? -1 : 1;
3131 /* Avoid the non-determinism of qsort by choosing an arbitrary ordering
3132 between "equal" overlays. The result can still change between
3133 invocations of Emacs, but it won't change in the middle of
3134 `find_field' (bug#6830). */
3135 if (!EQ (s1->overlay, s2->overlay))
3136 return XLI (s1->overlay) < XLI (s2->overlay) ? -1 : 1;
3137 return 0;
3140 /* Sort an array of overlays by priority. The array is modified in place.
3141 The return value is the new size; this may be smaller than the original
3142 size if some of the overlays were invalid or were window-specific. */
3143 ptrdiff_t
3144 sort_overlays (Lisp_Object *overlay_vec, ptrdiff_t noverlays, struct window *w)
3146 ptrdiff_t i, j;
3147 struct sortvec *sortvec = alloca (noverlays * sizeof *sortvec);
3149 /* Put the valid and relevant overlays into sortvec. */
3151 for (i = 0, j = 0; i < noverlays; i++)
3153 Lisp_Object tem;
3154 Lisp_Object overlay;
3156 overlay = overlay_vec[i];
3157 if (OVERLAYP (overlay)
3158 && OVERLAY_POSITION (OVERLAY_START (overlay)) > 0
3159 && OVERLAY_POSITION (OVERLAY_END (overlay)) > 0)
3161 /* If we're interested in a specific window, then ignore
3162 overlays that are limited to some other window. */
3163 if (w)
3165 Lisp_Object window;
3167 window = Foverlay_get (overlay, Qwindow);
3168 if (WINDOWP (window) && XWINDOW (window) != w)
3169 continue;
3172 /* This overlay is good and counts: put it into sortvec. */
3173 sortvec[j].overlay = overlay;
3174 sortvec[j].beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3175 sortvec[j].end = OVERLAY_POSITION (OVERLAY_END (overlay));
3176 tem = Foverlay_get (overlay, Qpriority);
3177 if (INTEGERP (tem))
3178 sortvec[j].priority = XINT (tem);
3179 else
3180 sortvec[j].priority = 0;
3181 j++;
3184 noverlays = j;
3186 /* Sort the overlays into the proper order: increasing priority. */
3188 if (noverlays > 1)
3189 qsort (sortvec, noverlays, sizeof (struct sortvec), compare_overlays);
3191 for (i = 0; i < noverlays; i++)
3192 overlay_vec[i] = sortvec[i].overlay;
3193 return (noverlays);
3196 struct sortstr
3198 Lisp_Object string, string2;
3199 ptrdiff_t size;
3200 EMACS_INT priority;
3203 struct sortstrlist
3205 struct sortstr *buf; /* An array that expands as needed; never freed. */
3206 ptrdiff_t size; /* Allocated length of that array. */
3207 ptrdiff_t used; /* How much of the array is currently in use. */
3208 ptrdiff_t bytes; /* Total length of the strings in buf. */
3211 /* Buffers for storing information about the overlays touching a given
3212 position. These could be automatic variables in overlay_strings, but
3213 it's more efficient to hold onto the memory instead of repeatedly
3214 allocating and freeing it. */
3215 static struct sortstrlist overlay_heads, overlay_tails;
3216 static unsigned char *overlay_str_buf;
3218 /* Allocated length of overlay_str_buf. */
3219 static ptrdiff_t overlay_str_len;
3221 /* A comparison function suitable for passing to qsort. */
3222 static int
3223 cmp_for_strings (const void *as1, const void *as2)
3225 struct sortstr *s1 = (struct sortstr *)as1;
3226 struct sortstr *s2 = (struct sortstr *)as2;
3227 if (s1->size != s2->size)
3228 return s2->size < s1->size ? -1 : 1;
3229 if (s1->priority != s2->priority)
3230 return s1->priority < s2->priority ? -1 : 1;
3231 return 0;
3234 static void
3235 record_overlay_string (struct sortstrlist *ssl, Lisp_Object str,
3236 Lisp_Object str2, Lisp_Object pri, ptrdiff_t size)
3238 ptrdiff_t nbytes;
3240 if (ssl->used == ssl->size)
3241 ssl->buf = xpalloc (ssl->buf, &ssl->size, 5, -1, sizeof *ssl->buf);
3242 ssl->buf[ssl->used].string = str;
3243 ssl->buf[ssl->used].string2 = str2;
3244 ssl->buf[ssl->used].size = size;
3245 ssl->buf[ssl->used].priority = (INTEGERP (pri) ? XINT (pri) : 0);
3246 ssl->used++;
3248 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
3249 nbytes = SCHARS (str);
3250 else if (! STRING_MULTIBYTE (str))
3251 nbytes = count_size_as_multibyte (SDATA (str),
3252 SBYTES (str));
3253 else
3254 nbytes = SBYTES (str);
3256 if (INT_ADD_OVERFLOW (ssl->bytes, nbytes))
3257 memory_full (SIZE_MAX);
3258 ssl->bytes += nbytes;
3260 if (STRINGP (str2))
3262 if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
3263 nbytes = SCHARS (str2);
3264 else if (! STRING_MULTIBYTE (str2))
3265 nbytes = count_size_as_multibyte (SDATA (str2),
3266 SBYTES (str2));
3267 else
3268 nbytes = SBYTES (str2);
3270 if (INT_ADD_OVERFLOW (ssl->bytes, nbytes))
3271 memory_full (SIZE_MAX);
3272 ssl->bytes += nbytes;
3276 /* Return the concatenation of the strings associated with overlays that
3277 begin or end at POS, ignoring overlays that are specific to a window
3278 other than W. The strings are concatenated in the appropriate order:
3279 shorter overlays nest inside longer ones, and higher priority inside
3280 lower. Normally all of the after-strings come first, but zero-sized
3281 overlays have their after-strings ride along with the before-strings
3282 because it would look strange to print them inside-out.
3284 Returns the string length, and stores the contents indirectly through
3285 PSTR, if that variable is non-null. The string may be overwritten by
3286 subsequent calls. */
3288 ptrdiff_t
3289 overlay_strings (ptrdiff_t pos, struct window *w, unsigned char **pstr)
3291 Lisp_Object overlay, window, str;
3292 struct Lisp_Overlay *ov;
3293 ptrdiff_t startpos, endpos;
3294 bool multibyte = ! NILP (BVAR (current_buffer, enable_multibyte_characters));
3296 overlay_heads.used = overlay_heads.bytes = 0;
3297 overlay_tails.used = overlay_tails.bytes = 0;
3298 for (ov = current_buffer->overlays_before; ov; ov = ov->next)
3300 XSETMISC (overlay, ov);
3301 eassert (OVERLAYP (overlay));
3303 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3304 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3305 if (endpos < pos)
3306 break;
3307 if (endpos != pos && startpos != pos)
3308 continue;
3309 window = Foverlay_get (overlay, Qwindow);
3310 if (WINDOWP (window) && XWINDOW (window) != w)
3311 continue;
3312 if (startpos == pos
3313 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3314 record_overlay_string (&overlay_heads, str,
3315 (startpos == endpos
3316 ? Foverlay_get (overlay, Qafter_string)
3317 : Qnil),
3318 Foverlay_get (overlay, Qpriority),
3319 endpos - startpos);
3320 else if (endpos == pos
3321 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3322 record_overlay_string (&overlay_tails, str, Qnil,
3323 Foverlay_get (overlay, Qpriority),
3324 endpos - startpos);
3326 for (ov = current_buffer->overlays_after; ov; ov = ov->next)
3328 XSETMISC (overlay, ov);
3329 eassert (OVERLAYP (overlay));
3331 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3332 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3333 if (startpos > pos)
3334 break;
3335 if (endpos != pos && startpos != pos)
3336 continue;
3337 window = Foverlay_get (overlay, Qwindow);
3338 if (WINDOWP (window) && XWINDOW (window) != w)
3339 continue;
3340 if (startpos == pos
3341 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3342 record_overlay_string (&overlay_heads, str,
3343 (startpos == endpos
3344 ? Foverlay_get (overlay, Qafter_string)
3345 : Qnil),
3346 Foverlay_get (overlay, Qpriority),
3347 endpos - startpos);
3348 else if (endpos == pos
3349 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3350 record_overlay_string (&overlay_tails, str, Qnil,
3351 Foverlay_get (overlay, Qpriority),
3352 endpos - startpos);
3354 if (overlay_tails.used > 1)
3355 qsort (overlay_tails.buf, overlay_tails.used, sizeof (struct sortstr),
3356 cmp_for_strings);
3357 if (overlay_heads.used > 1)
3358 qsort (overlay_heads.buf, overlay_heads.used, sizeof (struct sortstr),
3359 cmp_for_strings);
3360 if (overlay_heads.bytes || overlay_tails.bytes)
3362 Lisp_Object tem;
3363 ptrdiff_t i;
3364 unsigned char *p;
3365 ptrdiff_t total;
3367 if (INT_ADD_OVERFLOW (overlay_heads.bytes, overlay_tails.bytes))
3368 memory_full (SIZE_MAX);
3369 total = overlay_heads.bytes + overlay_tails.bytes;
3370 if (total > overlay_str_len)
3371 overlay_str_buf = xpalloc (overlay_str_buf, &overlay_str_len,
3372 total - overlay_str_len, -1, 1);
3374 p = overlay_str_buf;
3375 for (i = overlay_tails.used; --i >= 0;)
3377 ptrdiff_t nbytes;
3378 tem = overlay_tails.buf[i].string;
3379 nbytes = copy_text (SDATA (tem), p,
3380 SBYTES (tem),
3381 STRING_MULTIBYTE (tem), multibyte);
3382 p += nbytes;
3384 for (i = 0; i < overlay_heads.used; ++i)
3386 ptrdiff_t nbytes;
3387 tem = overlay_heads.buf[i].string;
3388 nbytes = copy_text (SDATA (tem), p,
3389 SBYTES (tem),
3390 STRING_MULTIBYTE (tem), multibyte);
3391 p += nbytes;
3392 tem = overlay_heads.buf[i].string2;
3393 if (STRINGP (tem))
3395 nbytes = copy_text (SDATA (tem), p,
3396 SBYTES (tem),
3397 STRING_MULTIBYTE (tem), multibyte);
3398 p += nbytes;
3401 if (p != overlay_str_buf + total)
3402 emacs_abort ();
3403 if (pstr)
3404 *pstr = overlay_str_buf;
3405 return total;
3407 return 0;
3410 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
3412 void
3413 recenter_overlay_lists (struct buffer *buf, ptrdiff_t pos)
3415 Lisp_Object overlay, beg, end;
3416 struct Lisp_Overlay *prev, *tail, *next;
3418 /* See if anything in overlays_before should move to overlays_after. */
3420 /* We don't strictly need prev in this loop; it should always be nil.
3421 But we use it for symmetry and in case that should cease to be true
3422 with some future change. */
3423 prev = NULL;
3424 for (tail = buf->overlays_before; tail; prev = tail, tail = next)
3426 next = tail->next;
3427 XSETMISC (overlay, tail);
3428 eassert (OVERLAYP (overlay));
3430 beg = OVERLAY_START (overlay);
3431 end = OVERLAY_END (overlay);
3433 if (OVERLAY_POSITION (end) > pos)
3435 /* OVERLAY needs to be moved. */
3436 ptrdiff_t where = OVERLAY_POSITION (beg);
3437 struct Lisp_Overlay *other, *other_prev;
3439 /* Splice the cons cell TAIL out of overlays_before. */
3440 if (prev)
3441 prev->next = next;
3442 else
3443 set_buffer_overlays_before (buf, next);
3445 /* Search thru overlays_after for where to put it. */
3446 other_prev = NULL;
3447 for (other = buf->overlays_after; other;
3448 other_prev = other, other = other->next)
3450 Lisp_Object otherbeg, otheroverlay;
3452 XSETMISC (otheroverlay, other);
3453 eassert (OVERLAYP (otheroverlay));
3455 otherbeg = OVERLAY_START (otheroverlay);
3456 if (OVERLAY_POSITION (otherbeg) >= where)
3457 break;
3460 /* Add TAIL to overlays_after before OTHER. */
3461 tail->next = other;
3462 if (other_prev)
3463 other_prev->next = tail;
3464 else
3465 set_buffer_overlays_after (buf, tail);
3466 tail = prev;
3468 else
3469 /* We've reached the things that should stay in overlays_before.
3470 All the rest of overlays_before must end even earlier,
3471 so stop now. */
3472 break;
3475 /* See if anything in overlays_after should be in overlays_before. */
3476 prev = NULL;
3477 for (tail = buf->overlays_after; tail; prev = tail, tail = next)
3479 next = tail->next;
3480 XSETMISC (overlay, tail);
3481 eassert (OVERLAYP (overlay));
3483 beg = OVERLAY_START (overlay);
3484 end = OVERLAY_END (overlay);
3486 /* Stop looking, when we know that nothing further
3487 can possibly end before POS. */
3488 if (OVERLAY_POSITION (beg) > pos)
3489 break;
3491 if (OVERLAY_POSITION (end) <= pos)
3493 /* OVERLAY needs to be moved. */
3494 ptrdiff_t where = OVERLAY_POSITION (end);
3495 struct Lisp_Overlay *other, *other_prev;
3497 /* Splice the cons cell TAIL out of overlays_after. */
3498 if (prev)
3499 prev->next = next;
3500 else
3501 set_buffer_overlays_after (buf, next);
3503 /* Search thru overlays_before for where to put it. */
3504 other_prev = NULL;
3505 for (other = buf->overlays_before; other;
3506 other_prev = other, other = other->next)
3508 Lisp_Object otherend, otheroverlay;
3510 XSETMISC (otheroverlay, other);
3511 eassert (OVERLAYP (otheroverlay));
3513 otherend = OVERLAY_END (otheroverlay);
3514 if (OVERLAY_POSITION (otherend) <= where)
3515 break;
3518 /* Add TAIL to overlays_before before OTHER. */
3519 tail->next = other;
3520 if (other_prev)
3521 other_prev->next = tail;
3522 else
3523 set_buffer_overlays_before (buf, tail);
3524 tail = prev;
3528 buf->overlay_center = pos;
3531 void
3532 adjust_overlays_for_insert (ptrdiff_t pos, ptrdiff_t length)
3534 /* After an insertion, the lists are still sorted properly,
3535 but we may need to update the value of the overlay center. */
3536 if (current_buffer->overlay_center >= pos)
3537 current_buffer->overlay_center += length;
3540 void
3541 adjust_overlays_for_delete (ptrdiff_t pos, ptrdiff_t length)
3543 if (current_buffer->overlay_center < pos)
3544 /* The deletion was to our right. No change needed; the before- and
3545 after-lists are still consistent. */
3547 else if (current_buffer->overlay_center - pos > length)
3548 /* The deletion was to our left. We need to adjust the center value
3549 to account for the change in position, but the lists are consistent
3550 given the new value. */
3551 current_buffer->overlay_center -= length;
3552 else
3553 /* We're right in the middle. There might be things on the after-list
3554 that now belong on the before-list. Recentering will move them,
3555 and also update the center point. */
3556 recenter_overlay_lists (current_buffer, pos);
3559 /* Fix up overlays that were garbled as a result of permuting markers
3560 in the range START through END. Any overlay with at least one
3561 endpoint in this range will need to be unlinked from the overlay
3562 list and reinserted in its proper place.
3563 Such an overlay might even have negative size at this point.
3564 If so, we'll make the overlay empty. */
3565 void
3566 fix_start_end_in_overlays (register ptrdiff_t start, register ptrdiff_t end)
3568 Lisp_Object overlay;
3569 struct Lisp_Overlay *before_list IF_LINT (= NULL);
3570 struct Lisp_Overlay *after_list IF_LINT (= NULL);
3571 /* These are either nil, indicating that before_list or after_list
3572 should be assigned, or the cons cell the cdr of which should be
3573 assigned. */
3574 struct Lisp_Overlay *beforep = NULL, *afterp = NULL;
3575 /* 'Parent', likewise, indicates a cons cell or
3576 current_buffer->overlays_before or overlays_after, depending
3577 which loop we're in. */
3578 struct Lisp_Overlay *tail, *parent;
3579 ptrdiff_t startpos, endpos;
3581 /* This algorithm shifts links around instead of consing and GCing.
3582 The loop invariant is that before_list (resp. after_list) is a
3583 well-formed list except that its last element, the CDR of beforep
3584 (resp. afterp) if beforep (afterp) isn't nil or before_list
3585 (after_list) if it is, is still uninitialized. So it's not a bug
3586 that before_list isn't initialized, although it may look
3587 strange. */
3588 for (parent = NULL, tail = current_buffer->overlays_before; tail;)
3590 XSETMISC (overlay, tail);
3592 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3593 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3595 /* If the overlay is backwards, make it empty. */
3596 if (endpos < startpos)
3598 startpos = endpos;
3599 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3600 Qnil);
3603 if (endpos < start)
3604 break;
3606 if (endpos < end
3607 || (startpos >= start && startpos < end))
3609 /* Add it to the end of the wrong list. Later on,
3610 recenter_overlay_lists will move it to the right place. */
3611 if (endpos < current_buffer->overlay_center)
3613 if (!afterp)
3614 after_list = tail;
3615 else
3616 afterp->next = tail;
3617 afterp = tail;
3619 else
3621 if (!beforep)
3622 before_list = tail;
3623 else
3624 beforep->next = tail;
3625 beforep = tail;
3627 if (!parent)
3628 set_buffer_overlays_before (current_buffer, tail->next);
3629 else
3630 parent->next = tail->next;
3631 tail = tail->next;
3633 else
3634 parent = tail, tail = parent->next;
3636 for (parent = NULL, tail = current_buffer->overlays_after; tail;)
3638 XSETMISC (overlay, tail);
3640 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3641 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3643 /* If the overlay is backwards, make it empty. */
3644 if (endpos < startpos)
3646 startpos = endpos;
3647 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3648 Qnil);
3651 if (startpos >= end)
3652 break;
3654 if (startpos >= start
3655 || (endpos >= start && endpos < end))
3657 if (endpos < current_buffer->overlay_center)
3659 if (!afterp)
3660 after_list = tail;
3661 else
3662 afterp->next = tail;
3663 afterp = tail;
3665 else
3667 if (!beforep)
3668 before_list = tail;
3669 else
3670 beforep->next = tail;
3671 beforep = tail;
3673 if (!parent)
3674 set_buffer_overlays_after (current_buffer, tail->next);
3675 else
3676 parent->next = tail->next;
3677 tail = tail->next;
3679 else
3680 parent = tail, tail = parent->next;
3683 /* Splice the constructed (wrong) lists into the buffer's lists,
3684 and let the recenter function make it sane again. */
3685 if (beforep)
3687 beforep->next = current_buffer->overlays_before;
3688 set_buffer_overlays_before (current_buffer, before_list);
3691 if (afterp)
3693 afterp->next = current_buffer->overlays_after;
3694 set_buffer_overlays_after (current_buffer, after_list);
3696 recenter_overlay_lists (current_buffer, current_buffer->overlay_center);
3699 /* We have two types of overlay: the one whose ending marker is
3700 after-insertion-marker (this is the usual case) and the one whose
3701 ending marker is before-insertion-marker. When `overlays_before'
3702 contains overlays of the latter type and the former type in this
3703 order and both overlays end at inserting position, inserting a text
3704 increases only the ending marker of the latter type, which results
3705 in incorrect ordering of `overlays_before'.
3707 This function fixes ordering of overlays in the slot
3708 `overlays_before' of the buffer *BP. Before the insertion, `point'
3709 was at PREV, and now is at POS. */
3711 void
3712 fix_overlays_before (struct buffer *bp, ptrdiff_t prev, ptrdiff_t pos)
3714 /* If parent is nil, replace overlays_before; otherwise, parent->next. */
3715 struct Lisp_Overlay *tail = bp->overlays_before, *parent = NULL, *right_pair;
3716 Lisp_Object tem;
3717 ptrdiff_t end IF_LINT (= 0);
3719 /* After the insertion, the several overlays may be in incorrect
3720 order. The possibility is that, in the list `overlays_before',
3721 an overlay which ends at POS appears after an overlay which ends
3722 at PREV. Since POS is greater than PREV, we must fix the
3723 ordering of these overlays, by moving overlays ends at POS before
3724 the overlays ends at PREV. */
3726 /* At first, find a place where disordered overlays should be linked
3727 in. It is where an overlay which end before POS exists. (i.e. an
3728 overlay whose ending marker is after-insertion-marker if disorder
3729 exists). */
3730 while (tail
3731 && (XSETMISC (tem, tail),
3732 (end = OVERLAY_POSITION (OVERLAY_END (tem))) >= pos))
3734 parent = tail;
3735 tail = tail->next;
3738 /* If we don't find such an overlay,
3739 or the found one ends before PREV,
3740 or the found one is the last one in the list,
3741 we don't have to fix anything. */
3742 if (!tail || end < prev || !tail->next)
3743 return;
3745 right_pair = parent;
3746 parent = tail;
3747 tail = tail->next;
3749 /* Now, end position of overlays in the list TAIL should be before
3750 or equal to PREV. In the loop, an overlay which ends at POS is
3751 moved ahead to the place indicated by the CDR of RIGHT_PAIR. If
3752 we found an overlay which ends before PREV, the remaining
3753 overlays are in correct order. */
3754 while (tail)
3756 XSETMISC (tem, tail);
3757 end = OVERLAY_POSITION (OVERLAY_END (tem));
3759 if (end == pos)
3760 { /* This overlay is disordered. */
3761 struct Lisp_Overlay *found = tail;
3763 /* Unlink the found overlay. */
3764 tail = found->next;
3765 parent->next = tail;
3766 /* Move an overlay at RIGHT_PLACE to the next of the found one,
3767 and link it into the right place. */
3768 if (!right_pair)
3770 found->next = bp->overlays_before;
3771 set_buffer_overlays_before (bp, found);
3773 else
3775 found->next = right_pair->next;
3776 right_pair->next = found;
3779 else if (end == prev)
3781 parent = tail;
3782 tail = tail->next;
3784 else /* No more disordered overlay. */
3785 break;
3789 DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
3790 doc: /* Return t if OBJECT is an overlay. */)
3791 (Lisp_Object object)
3793 return (OVERLAYP (object) ? Qt : Qnil);
3796 DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 5, 0,
3797 doc: /* Create a new overlay with range BEG to END in BUFFER.
3798 If omitted, BUFFER defaults to the current buffer.
3799 BEG and END may be integers or markers.
3800 The fourth arg FRONT-ADVANCE, if non-nil, makes the marker
3801 for the front of the overlay advance when text is inserted there
3802 \(which means the text *is not* included in the overlay).
3803 The fifth arg REAR-ADVANCE, if non-nil, makes the marker
3804 for the rear of the overlay advance when text is inserted there
3805 \(which means the text *is* included in the overlay). */)
3806 (Lisp_Object beg, Lisp_Object end, Lisp_Object buffer, Lisp_Object front_advance, Lisp_Object rear_advance)
3808 Lisp_Object overlay;
3809 struct buffer *b;
3811 if (NILP (buffer))
3812 XSETBUFFER (buffer, current_buffer);
3813 else
3814 CHECK_BUFFER (buffer);
3815 if (MARKERP (beg)
3816 && ! EQ (Fmarker_buffer (beg), buffer))
3817 error ("Marker points into wrong buffer");
3818 if (MARKERP (end)
3819 && ! EQ (Fmarker_buffer (end), buffer))
3820 error ("Marker points into wrong buffer");
3822 CHECK_NUMBER_COERCE_MARKER (beg);
3823 CHECK_NUMBER_COERCE_MARKER (end);
3825 if (XINT (beg) > XINT (end))
3827 Lisp_Object temp;
3828 temp = beg; beg = end; end = temp;
3831 b = XBUFFER (buffer);
3833 beg = Fset_marker (Fmake_marker (), beg, buffer);
3834 end = Fset_marker (Fmake_marker (), end, buffer);
3836 if (!NILP (front_advance))
3837 XMARKER (beg)->insertion_type = 1;
3838 if (!NILP (rear_advance))
3839 XMARKER (end)->insertion_type = 1;
3841 overlay = build_overlay (beg, end, Qnil);
3843 /* Put the new overlay on the wrong list. */
3844 end = OVERLAY_END (overlay);
3845 if (OVERLAY_POSITION (end) < b->overlay_center)
3847 eassert (b->overlays_after || (XOVERLAY (overlay)->next == NULL));
3848 XOVERLAY (overlay)->next = b->overlays_after;
3849 set_buffer_overlays_after (b, XOVERLAY (overlay));
3851 else
3853 eassert (b->overlays_before || (XOVERLAY (overlay)->next == NULL));
3854 XOVERLAY (overlay)->next = b->overlays_before;
3855 set_buffer_overlays_before (b, XOVERLAY (overlay));
3857 /* This puts it in the right list, and in the right order. */
3858 recenter_overlay_lists (b, b->overlay_center);
3860 /* We don't need to redisplay the region covered by the overlay, because
3861 the overlay has no properties at the moment. */
3863 return overlay;
3866 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3868 static void
3869 modify_overlay (struct buffer *buf, ptrdiff_t start, ptrdiff_t end)
3871 if (start > end)
3873 ptrdiff_t temp = start;
3874 start = end;
3875 end = temp;
3878 BUF_COMPUTE_UNCHANGED (buf, start, end);
3880 /* If this is a buffer not in the selected window,
3881 we must do other windows. */
3882 if (buf != XBUFFER (XWINDOW (selected_window)->buffer))
3883 windows_or_buffers_changed = 1;
3884 /* If multiple windows show this buffer, we must do other windows. */
3885 else if (buffer_shared > 1)
3886 windows_or_buffers_changed = 1;
3887 /* If we modify an overlay at the end of the buffer, we cannot
3888 be sure that window end is still valid. */
3889 else if (end >= ZV && start <= ZV)
3890 windows_or_buffers_changed = 1;
3892 ++BUF_OVERLAY_MODIFF (buf);
3895 /* Remove OVERLAY from LIST. */
3897 static struct Lisp_Overlay *
3898 unchain_overlay (struct Lisp_Overlay *list, struct Lisp_Overlay *overlay)
3900 register struct Lisp_Overlay *tail, **prev = &list;
3902 for (tail = list; tail; prev = &tail->next, tail = *prev)
3903 if (tail == overlay)
3905 *prev = overlay->next;
3906 overlay->next = NULL;
3907 break;
3909 return list;
3912 /* Remove OVERLAY from both overlay lists of B. */
3914 static void
3915 unchain_both (struct buffer *b, Lisp_Object overlay)
3917 struct Lisp_Overlay *ov = XOVERLAY (overlay);
3919 set_buffer_overlays_before (b, unchain_overlay (b->overlays_before, ov));
3920 set_buffer_overlays_after (b, unchain_overlay (b->overlays_after, ov));
3921 eassert (XOVERLAY (overlay)->next == NULL);
3924 DEFUN ("move-overlay", Fmove_overlay, Smove_overlay, 3, 4, 0,
3925 doc: /* Set the endpoints of OVERLAY to BEG and END in BUFFER.
3926 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
3927 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
3928 buffer. */)
3929 (Lisp_Object overlay, Lisp_Object beg, Lisp_Object end, Lisp_Object buffer)
3931 struct buffer *b, *ob = 0;
3932 Lisp_Object obuffer;
3933 ptrdiff_t count = SPECPDL_INDEX ();
3934 ptrdiff_t n_beg, n_end, o_beg IF_LINT (= 0), o_end IF_LINT (= 0);
3936 CHECK_OVERLAY (overlay);
3937 if (NILP (buffer))
3938 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3939 if (NILP (buffer))
3940 XSETBUFFER (buffer, current_buffer);
3941 CHECK_BUFFER (buffer);
3943 if (NILP (Fbuffer_live_p (buffer)))
3944 error ("Attempt to move overlay to a dead buffer");
3946 if (MARKERP (beg)
3947 && ! EQ (Fmarker_buffer (beg), buffer))
3948 error ("Marker points into wrong buffer");
3949 if (MARKERP (end)
3950 && ! EQ (Fmarker_buffer (end), buffer))
3951 error ("Marker points into wrong buffer");
3953 CHECK_NUMBER_COERCE_MARKER (beg);
3954 CHECK_NUMBER_COERCE_MARKER (end);
3956 if (XINT (beg) > XINT (end))
3958 Lisp_Object temp;
3959 temp = beg; beg = end; end = temp;
3962 specbind (Qinhibit_quit, Qt);
3964 obuffer = Fmarker_buffer (OVERLAY_START (overlay));
3965 b = XBUFFER (buffer);
3967 if (!NILP (obuffer))
3969 ob = XBUFFER (obuffer);
3971 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3972 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3974 unchain_both (ob, overlay);
3977 /* Set the overlay boundaries, which may clip them. */
3978 Fset_marker (OVERLAY_START (overlay), beg, buffer);
3979 Fset_marker (OVERLAY_END (overlay), end, buffer);
3981 n_beg = marker_position (OVERLAY_START (overlay));
3982 n_end = marker_position (OVERLAY_END (overlay));
3984 /* If the overlay has changed buffers, do a thorough redisplay. */
3985 if (!EQ (buffer, obuffer))
3987 /* Redisplay where the overlay was. */
3988 if (ob)
3989 modify_overlay (ob, o_beg, o_end);
3991 /* Redisplay where the overlay is going to be. */
3992 modify_overlay (b, n_beg, n_end);
3994 else
3995 /* Redisplay the area the overlay has just left, or just enclosed. */
3997 if (o_beg == n_beg)
3998 modify_overlay (b, o_end, n_end);
3999 else if (o_end == n_end)
4000 modify_overlay (b, o_beg, n_beg);
4001 else
4002 modify_overlay (b, min (o_beg, n_beg), max (o_end, n_end));
4005 /* Delete the overlay if it is empty after clipping and has the
4006 evaporate property. */
4007 if (n_beg == n_end && !NILP (Foverlay_get (overlay, Qevaporate)))
4008 return unbind_to (count, Fdelete_overlay (overlay));
4010 /* Put the overlay into the new buffer's overlay lists, first on the
4011 wrong list. */
4012 if (n_end < b->overlay_center)
4014 XOVERLAY (overlay)->next = b->overlays_after;
4015 set_buffer_overlays_after (b, XOVERLAY (overlay));
4017 else
4019 XOVERLAY (overlay)->next = b->overlays_before;
4020 set_buffer_overlays_before (b, XOVERLAY (overlay));
4023 /* This puts it in the right list, and in the right order. */
4024 recenter_overlay_lists (b, b->overlay_center);
4026 return unbind_to (count, overlay);
4029 DEFUN ("delete-overlay", Fdelete_overlay, Sdelete_overlay, 1, 1, 0,
4030 doc: /* Delete the overlay OVERLAY from its buffer. */)
4031 (Lisp_Object overlay)
4033 Lisp_Object buffer;
4034 struct buffer *b;
4035 ptrdiff_t count = SPECPDL_INDEX ();
4037 CHECK_OVERLAY (overlay);
4039 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4040 if (NILP (buffer))
4041 return Qnil;
4043 b = XBUFFER (buffer);
4044 specbind (Qinhibit_quit, Qt);
4046 unchain_both (b, overlay);
4047 drop_overlay (b, XOVERLAY (overlay));
4049 /* When deleting an overlay with before or after strings, turn off
4050 display optimizations for the affected buffer, on the basis that
4051 these strings may contain newlines. This is easier to do than to
4052 check for that situation during redisplay. */
4053 if (!windows_or_buffers_changed
4054 && (!NILP (Foverlay_get (overlay, Qbefore_string))
4055 || !NILP (Foverlay_get (overlay, Qafter_string))))
4056 b->prevent_redisplay_optimizations_p = 1;
4058 return unbind_to (count, Qnil);
4061 DEFUN ("delete-all-overlays", Fdelete_all_overlays, Sdelete_all_overlays, 0, 1, 0,
4062 doc: /* Delete all overlays of BUFFER.
4063 BUFFER omitted or nil means delete all overlays of the current
4064 buffer. */)
4065 (Lisp_Object buffer)
4067 register struct buffer *buf;
4069 if (NILP (buffer))
4070 buf = current_buffer;
4071 else
4073 CHECK_BUFFER (buffer);
4074 buf = XBUFFER (buffer);
4077 delete_all_overlays (buf);
4078 return Qnil;
4081 /* Overlay dissection functions. */
4083 DEFUN ("overlay-start", Foverlay_start, Soverlay_start, 1, 1, 0,
4084 doc: /* Return the position at which OVERLAY starts. */)
4085 (Lisp_Object overlay)
4087 CHECK_OVERLAY (overlay);
4089 return (Fmarker_position (OVERLAY_START (overlay)));
4092 DEFUN ("overlay-end", Foverlay_end, Soverlay_end, 1, 1, 0,
4093 doc: /* Return the position at which OVERLAY ends. */)
4094 (Lisp_Object overlay)
4096 CHECK_OVERLAY (overlay);
4098 return (Fmarker_position (OVERLAY_END (overlay)));
4101 DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
4102 doc: /* Return the buffer OVERLAY belongs to.
4103 Return nil if OVERLAY has been deleted. */)
4104 (Lisp_Object overlay)
4106 CHECK_OVERLAY (overlay);
4108 return Fmarker_buffer (OVERLAY_START (overlay));
4111 DEFUN ("overlay-properties", Foverlay_properties, Soverlay_properties, 1, 1, 0,
4112 doc: /* Return a list of the properties on OVERLAY.
4113 This is a copy of OVERLAY's plist; modifying its conses has no effect on
4114 OVERLAY. */)
4115 (Lisp_Object overlay)
4117 CHECK_OVERLAY (overlay);
4119 return Fcopy_sequence (XOVERLAY (overlay)->plist);
4123 DEFUN ("overlays-at", Foverlays_at, Soverlays_at, 1, 1, 0,
4124 doc: /* Return a list of the overlays that contain the character at POS. */)
4125 (Lisp_Object pos)
4127 ptrdiff_t len, noverlays;
4128 Lisp_Object *overlay_vec;
4129 Lisp_Object result;
4131 CHECK_NUMBER_COERCE_MARKER (pos);
4133 len = 10;
4134 /* We can't use alloca here because overlays_at can call xrealloc. */
4135 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4137 /* Put all the overlays we want in a vector in overlay_vec.
4138 Store the length in len. */
4139 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4140 NULL, NULL, 0);
4142 /* Make a list of them all. */
4143 result = Flist (noverlays, overlay_vec);
4145 xfree (overlay_vec);
4146 return result;
4149 DEFUN ("overlays-in", Foverlays_in, Soverlays_in, 2, 2, 0,
4150 doc: /* Return a list of the overlays that overlap the region BEG ... END.
4151 Overlap means that at least one character is contained within the overlay
4152 and also contained within the specified region.
4153 Empty overlays are included in the result if they are located at BEG,
4154 between BEG and END, or at END provided END denotes the position at the
4155 end of the buffer. */)
4156 (Lisp_Object beg, Lisp_Object end)
4158 ptrdiff_t len, noverlays;
4159 Lisp_Object *overlay_vec;
4160 Lisp_Object result;
4162 CHECK_NUMBER_COERCE_MARKER (beg);
4163 CHECK_NUMBER_COERCE_MARKER (end);
4165 len = 10;
4166 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4168 /* Put all the overlays we want in a vector in overlay_vec.
4169 Store the length in len. */
4170 noverlays = overlays_in (XINT (beg), XINT (end), 1, &overlay_vec, &len,
4171 NULL, NULL);
4173 /* Make a list of them all. */
4174 result = Flist (noverlays, overlay_vec);
4176 xfree (overlay_vec);
4177 return result;
4180 DEFUN ("next-overlay-change", Fnext_overlay_change, Snext_overlay_change,
4181 1, 1, 0,
4182 doc: /* Return the next position after POS where an overlay starts or ends.
4183 If there are no overlay boundaries from POS to (point-max),
4184 the value is (point-max). */)
4185 (Lisp_Object pos)
4187 ptrdiff_t i, len, noverlays;
4188 ptrdiff_t endpos;
4189 Lisp_Object *overlay_vec;
4191 CHECK_NUMBER_COERCE_MARKER (pos);
4193 len = 10;
4194 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4196 /* Put all the overlays we want in a vector in overlay_vec.
4197 Store the length in len.
4198 endpos gets the position where the next overlay starts. */
4199 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4200 &endpos, 0, 1);
4202 /* If any of these overlays ends before endpos,
4203 use its ending point instead. */
4204 for (i = 0; i < noverlays; i++)
4206 Lisp_Object oend;
4207 ptrdiff_t oendpos;
4209 oend = OVERLAY_END (overlay_vec[i]);
4210 oendpos = OVERLAY_POSITION (oend);
4211 if (oendpos < endpos)
4212 endpos = oendpos;
4215 xfree (overlay_vec);
4216 return make_number (endpos);
4219 DEFUN ("previous-overlay-change", Fprevious_overlay_change,
4220 Sprevious_overlay_change, 1, 1, 0,
4221 doc: /* Return the previous position before POS where an overlay starts or ends.
4222 If there are no overlay boundaries from (point-min) to POS,
4223 the value is (point-min). */)
4224 (Lisp_Object pos)
4226 ptrdiff_t prevpos;
4227 Lisp_Object *overlay_vec;
4228 ptrdiff_t len;
4230 CHECK_NUMBER_COERCE_MARKER (pos);
4232 /* At beginning of buffer, we know the answer;
4233 avoid bug subtracting 1 below. */
4234 if (XINT (pos) == BEGV)
4235 return pos;
4237 len = 10;
4238 overlay_vec = xmalloc (len * sizeof *overlay_vec);
4240 /* Put all the overlays we want in a vector in overlay_vec.
4241 Store the length in len.
4242 prevpos gets the position of the previous change. */
4243 overlays_at (XINT (pos), 1, &overlay_vec, &len,
4244 0, &prevpos, 1);
4246 xfree (overlay_vec);
4247 return make_number (prevpos);
4250 /* These functions are for debugging overlays. */
4252 DEFUN ("overlay-lists", Foverlay_lists, Soverlay_lists, 0, 0, 0,
4253 doc: /* Return a pair of lists giving all the overlays of the current buffer.
4254 The car has all the overlays before the overlay center;
4255 the cdr has all the overlays after the overlay center.
4256 Recentering overlays moves overlays between these lists.
4257 The lists you get are copies, so that changing them has no effect.
4258 However, the overlays you get are the real objects that the buffer uses. */)
4259 (void)
4261 struct Lisp_Overlay *ol;
4262 Lisp_Object before = Qnil, after = Qnil, tmp;
4264 for (ol = current_buffer->overlays_before; ol; ol = ol->next)
4266 XSETMISC (tmp, ol);
4267 before = Fcons (tmp, before);
4269 for (ol = current_buffer->overlays_after; ol; ol = ol->next)
4271 XSETMISC (tmp, ol);
4272 after = Fcons (tmp, after);
4275 return Fcons (Fnreverse (before), Fnreverse (after));
4278 DEFUN ("overlay-recenter", Foverlay_recenter, Soverlay_recenter, 1, 1, 0,
4279 doc: /* Recenter the overlays of the current buffer around position POS.
4280 That makes overlay lookup faster for positions near POS (but perhaps slower
4281 for positions far away from POS). */)
4282 (Lisp_Object pos)
4284 ptrdiff_t p;
4285 CHECK_NUMBER_COERCE_MARKER (pos);
4287 p = clip_to_bounds (PTRDIFF_MIN, XINT (pos), PTRDIFF_MAX);
4288 recenter_overlay_lists (current_buffer, p);
4289 return Qnil;
4292 DEFUN ("overlay-get", Foverlay_get, Soverlay_get, 2, 2, 0,
4293 doc: /* Get the property of overlay OVERLAY with property name PROP. */)
4294 (Lisp_Object overlay, Lisp_Object prop)
4296 CHECK_OVERLAY (overlay);
4297 return lookup_char_property (XOVERLAY (overlay)->plist, prop, 0);
4300 DEFUN ("overlay-put", Foverlay_put, Soverlay_put, 3, 3, 0,
4301 doc: /* Set one property of overlay OVERLAY: give property PROP value VALUE.
4302 VALUE will be returned.*/)
4303 (Lisp_Object overlay, Lisp_Object prop, Lisp_Object value)
4305 Lisp_Object tail, buffer;
4306 bool changed;
4308 CHECK_OVERLAY (overlay);
4310 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4312 for (tail = XOVERLAY (overlay)->plist;
4313 CONSP (tail) && CONSP (XCDR (tail));
4314 tail = XCDR (XCDR (tail)))
4315 if (EQ (XCAR (tail), prop))
4317 changed = !EQ (XCAR (XCDR (tail)), value);
4318 XSETCAR (XCDR (tail), value);
4319 goto found;
4321 /* It wasn't in the list, so add it to the front. */
4322 changed = !NILP (value);
4323 set_overlay_plist
4324 (overlay, Fcons (prop, Fcons (value, XOVERLAY (overlay)->plist)));
4325 found:
4326 if (! NILP (buffer))
4328 if (changed)
4329 modify_overlay (XBUFFER (buffer),
4330 marker_position (OVERLAY_START (overlay)),
4331 marker_position (OVERLAY_END (overlay)));
4332 if (EQ (prop, Qevaporate) && ! NILP (value)
4333 && (OVERLAY_POSITION (OVERLAY_START (overlay))
4334 == OVERLAY_POSITION (OVERLAY_END (overlay))))
4335 Fdelete_overlay (overlay);
4338 return value;
4341 /* Subroutine of report_overlay_modification. */
4343 /* Lisp vector holding overlay hook functions to call.
4344 Vector elements come in pairs.
4345 Each even-index element is a list of hook functions.
4346 The following odd-index element is the overlay they came from.
4348 Before the buffer change, we fill in this vector
4349 as we call overlay hook functions.
4350 After the buffer change, we get the functions to call from this vector.
4351 This way we always call the same functions before and after the change. */
4352 static Lisp_Object last_overlay_modification_hooks;
4354 /* Number of elements actually used in last_overlay_modification_hooks. */
4355 static ptrdiff_t last_overlay_modification_hooks_used;
4357 /* Add one functionlist/overlay pair
4358 to the end of last_overlay_modification_hooks. */
4360 static void
4361 add_overlay_mod_hooklist (Lisp_Object functionlist, Lisp_Object overlay)
4363 ptrdiff_t oldsize = ASIZE (last_overlay_modification_hooks);
4365 if (oldsize - 1 <= last_overlay_modification_hooks_used)
4366 last_overlay_modification_hooks =
4367 larger_vector (last_overlay_modification_hooks, 2, -1);
4368 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4369 functionlist); last_overlay_modification_hooks_used++;
4370 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4371 overlay); last_overlay_modification_hooks_used++;
4374 /* Run the modification-hooks of overlays that include
4375 any part of the text in START to END.
4376 If this change is an insertion, also
4377 run the insert-before-hooks of overlay starting at END,
4378 and the insert-after-hooks of overlay ending at START.
4380 This is called both before and after the modification.
4381 AFTER is true when we call after the modification.
4383 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
4384 When AFTER is nonzero, they are the start position,
4385 the position after the inserted new text,
4386 and the length of deleted or replaced old text. */
4388 void
4389 report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after,
4390 Lisp_Object arg1, Lisp_Object arg2, Lisp_Object arg3)
4392 Lisp_Object prop, overlay;
4393 struct Lisp_Overlay *tail;
4394 /* True if this change is an insertion. */
4395 bool insertion = (after ? XFASTINT (arg3) == 0 : EQ (start, end));
4396 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4398 overlay = Qnil;
4399 tail = NULL;
4401 /* We used to run the functions as soon as we found them and only register
4402 them in last_overlay_modification_hooks for the purpose of the `after'
4403 case. But running elisp code as we traverse the list of overlays is
4404 painful because the list can be modified by the elisp code so we had to
4405 copy at several places. We now simply do a read-only traversal that
4406 only collects the functions to run and we run them afterwards. It's
4407 simpler, especially since all the code was already there. -stef */
4409 if (!after)
4411 /* We are being called before a change.
4412 Scan the overlays to find the functions to call. */
4413 last_overlay_modification_hooks_used = 0;
4414 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4416 ptrdiff_t startpos, endpos;
4417 Lisp_Object ostart, oend;
4419 XSETMISC (overlay, tail);
4421 ostart = OVERLAY_START (overlay);
4422 oend = OVERLAY_END (overlay);
4423 endpos = OVERLAY_POSITION (oend);
4424 if (XFASTINT (start) > endpos)
4425 break;
4426 startpos = OVERLAY_POSITION (ostart);
4427 if (insertion && (XFASTINT (start) == startpos
4428 || XFASTINT (end) == startpos))
4430 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4431 if (!NILP (prop))
4432 add_overlay_mod_hooklist (prop, overlay);
4434 if (insertion && (XFASTINT (start) == endpos
4435 || XFASTINT (end) == endpos))
4437 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4438 if (!NILP (prop))
4439 add_overlay_mod_hooklist (prop, overlay);
4441 /* Test for intersecting intervals. This does the right thing
4442 for both insertion and deletion. */
4443 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4445 prop = Foverlay_get (overlay, Qmodification_hooks);
4446 if (!NILP (prop))
4447 add_overlay_mod_hooklist (prop, overlay);
4451 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4453 ptrdiff_t startpos, endpos;
4454 Lisp_Object ostart, oend;
4456 XSETMISC (overlay, tail);
4458 ostart = OVERLAY_START (overlay);
4459 oend = OVERLAY_END (overlay);
4460 startpos = OVERLAY_POSITION (ostart);
4461 endpos = OVERLAY_POSITION (oend);
4462 if (XFASTINT (end) < startpos)
4463 break;
4464 if (insertion && (XFASTINT (start) == startpos
4465 || XFASTINT (end) == startpos))
4467 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4468 if (!NILP (prop))
4469 add_overlay_mod_hooklist (prop, overlay);
4471 if (insertion && (XFASTINT (start) == endpos
4472 || XFASTINT (end) == endpos))
4474 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4475 if (!NILP (prop))
4476 add_overlay_mod_hooklist (prop, overlay);
4478 /* Test for intersecting intervals. This does the right thing
4479 for both insertion and deletion. */
4480 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4482 prop = Foverlay_get (overlay, Qmodification_hooks);
4483 if (!NILP (prop))
4484 add_overlay_mod_hooklist (prop, overlay);
4489 GCPRO4 (overlay, arg1, arg2, arg3);
4491 /* Call the functions recorded in last_overlay_modification_hooks.
4492 First copy the vector contents, in case some of these hooks
4493 do subsequent modification of the buffer. */
4494 ptrdiff_t size = last_overlay_modification_hooks_used;
4495 Lisp_Object *copy = alloca (size * sizeof *copy);
4496 ptrdiff_t i;
4498 memcpy (copy, XVECTOR (last_overlay_modification_hooks)->contents,
4499 size * word_size);
4500 gcpro1.var = copy;
4501 gcpro1.nvars = size;
4503 for (i = 0; i < size;)
4505 Lisp_Object prop_i, overlay_i;
4506 prop_i = copy[i++];
4507 overlay_i = copy[i++];
4508 call_overlay_mod_hooks (prop_i, overlay_i, after, arg1, arg2, arg3);
4511 UNGCPRO;
4514 static void
4515 call_overlay_mod_hooks (Lisp_Object list, Lisp_Object overlay, bool after,
4516 Lisp_Object arg1, Lisp_Object arg2, Lisp_Object arg3)
4518 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4520 GCPRO4 (list, arg1, arg2, arg3);
4522 while (CONSP (list))
4524 if (NILP (arg3))
4525 call4 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2);
4526 else
4527 call5 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2, arg3);
4528 list = XCDR (list);
4530 UNGCPRO;
4533 /* Delete any zero-sized overlays at position POS, if the `evaporate'
4534 property is set. */
4535 void
4536 evaporate_overlays (ptrdiff_t pos)
4538 Lisp_Object overlay, hit_list;
4539 struct Lisp_Overlay *tail;
4541 hit_list = Qnil;
4542 if (pos <= current_buffer->overlay_center)
4543 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4545 ptrdiff_t endpos;
4546 XSETMISC (overlay, tail);
4547 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
4548 if (endpos < pos)
4549 break;
4550 if (endpos == pos && OVERLAY_POSITION (OVERLAY_START (overlay)) == pos
4551 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4552 hit_list = Fcons (overlay, hit_list);
4554 else
4555 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4557 ptrdiff_t startpos;
4558 XSETMISC (overlay, tail);
4559 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
4560 if (startpos > pos)
4561 break;
4562 if (startpos == pos && OVERLAY_POSITION (OVERLAY_END (overlay)) == pos
4563 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4564 hit_list = Fcons (overlay, hit_list);
4566 for (; CONSP (hit_list); hit_list = XCDR (hit_list))
4567 Fdelete_overlay (XCAR (hit_list));
4570 /* Somebody has tried to store a value with an unacceptable type
4571 in the slot with offset OFFSET. */
4573 void
4574 buffer_slot_type_mismatch (Lisp_Object newval, int type)
4576 Lisp_Object predicate;
4578 switch (type)
4580 case_Lisp_Int: predicate = Qintegerp; break;
4581 case Lisp_String: predicate = Qstringp; break;
4582 case Lisp_Symbol: predicate = Qsymbolp; break;
4583 default: emacs_abort ();
4586 wrong_type_argument (predicate, newval);
4590 /***********************************************************************
4591 Allocation with mmap
4592 ***********************************************************************/
4594 #ifdef USE_MMAP_FOR_BUFFERS
4596 #include <sys/types.h>
4597 #include <sys/mman.h>
4599 #ifndef MAP_ANON
4600 #ifdef MAP_ANONYMOUS
4601 #define MAP_ANON MAP_ANONYMOUS
4602 #else
4603 #define MAP_ANON 0
4604 #endif
4605 #endif
4607 #ifndef MAP_FAILED
4608 #define MAP_FAILED ((void *) -1)
4609 #endif
4611 #include <stdio.h>
4613 #if MAP_ANON == 0
4614 #include <fcntl.h>
4615 #endif
4617 #include "coding.h"
4620 /* Memory is allocated in regions which are mapped using mmap(2).
4621 The current implementation lets the system select mapped
4622 addresses; we're not using MAP_FIXED in general, except when
4623 trying to enlarge regions.
4625 Each mapped region starts with a mmap_region structure, the user
4626 area starts after that structure, aligned to MEM_ALIGN.
4628 +-----------------------+
4629 | struct mmap_info + |
4630 | padding |
4631 +-----------------------+
4632 | user data |
4635 +-----------------------+ */
4637 struct mmap_region
4639 /* User-specified size. */
4640 size_t nbytes_specified;
4642 /* Number of bytes mapped */
4643 size_t nbytes_mapped;
4645 /* Pointer to the location holding the address of the memory
4646 allocated with the mmap'd block. The variable actually points
4647 after this structure. */
4648 void **var;
4650 /* Next and previous in list of all mmap'd regions. */
4651 struct mmap_region *next, *prev;
4654 /* Doubly-linked list of mmap'd regions. */
4656 static struct mmap_region *mmap_regions;
4658 /* File descriptor for mmap. If we don't have anonymous mapping,
4659 /dev/zero will be opened on it. */
4661 static int mmap_fd;
4663 /* Temporary storage for mmap_set_vars, see there. */
4665 static struct mmap_region *mmap_regions_1;
4666 static int mmap_fd_1;
4668 /* Page size on this system. */
4670 static int mmap_page_size;
4672 /* 1 means mmap has been initialized. */
4674 static bool mmap_initialized_p;
4676 /* Value is X rounded up to the next multiple of N. */
4678 #define ROUND(X, N) (((X) + (N) - 1) / (N) * (N))
4680 /* Size of mmap_region structure plus padding. */
4682 #define MMAP_REGION_STRUCT_SIZE \
4683 ROUND (sizeof (struct mmap_region), MEM_ALIGN)
4685 /* Given a pointer P to the start of the user-visible part of a mapped
4686 region, return a pointer to the start of the region. */
4688 #define MMAP_REGION(P) \
4689 ((struct mmap_region *) ((char *) (P) - MMAP_REGION_STRUCT_SIZE))
4691 /* Given a pointer P to the start of a mapped region, return a pointer
4692 to the start of the user-visible part of the region. */
4694 #define MMAP_USER_AREA(P) \
4695 ((void *) ((char *) (P) + MMAP_REGION_STRUCT_SIZE))
4697 #define MEM_ALIGN sizeof (double)
4699 /* Predicate returning true if part of the address range [START .. END]
4700 is currently mapped. Used to prevent overwriting an existing
4701 memory mapping.
4703 Default is to conservatively assume the address range is occupied by
4704 something else. This can be overridden by system configuration
4705 files if system-specific means to determine this exists. */
4707 #ifndef MMAP_ALLOCATED_P
4708 #define MMAP_ALLOCATED_P(start, end) 1
4709 #endif
4711 /* Perform necessary initializations for the use of mmap. */
4713 static void
4714 mmap_init (void)
4716 #if MAP_ANON == 0
4717 /* The value of mmap_fd is initially 0 in temacs, and -1
4718 in a dumped Emacs. */
4719 if (mmap_fd <= 0)
4721 /* No anonymous mmap -- we need the file descriptor. */
4722 mmap_fd = open ("/dev/zero", O_RDONLY);
4723 if (mmap_fd == -1)
4724 fatal ("Cannot open /dev/zero: %s", emacs_strerror (errno));
4726 #endif /* MAP_ANON == 0 */
4728 if (mmap_initialized_p)
4729 return;
4730 mmap_initialized_p = 1;
4732 #if MAP_ANON != 0
4733 mmap_fd = -1;
4734 #endif
4736 mmap_page_size = getpagesize ();
4739 /* Return a region overlapping address range START...END, or null if
4740 none. END is not including, i.e. the last byte in the range
4741 is at END - 1. */
4743 static struct mmap_region *
4744 mmap_find (void *start, void *end)
4746 struct mmap_region *r;
4747 char *s = (char *) start, *e = (char *) end;
4749 for (r = mmap_regions; r; r = r->next)
4751 char *rstart = (char *) r;
4752 char *rend = rstart + r->nbytes_mapped;
4754 if (/* First byte of range, i.e. START, in this region? */
4755 (s >= rstart && s < rend)
4756 /* Last byte of range, i.e. END - 1, in this region? */
4757 || (e > rstart && e <= rend)
4758 /* First byte of this region in the range? */
4759 || (rstart >= s && rstart < e)
4760 /* Last byte of this region in the range? */
4761 || (rend > s && rend <= e))
4762 break;
4765 return r;
4769 /* Unmap a region. P is a pointer to the start of the user-araa of
4770 the region. */
4772 static void
4773 mmap_free_1 (struct mmap_region *r)
4775 if (r->next)
4776 r->next->prev = r->prev;
4777 if (r->prev)
4778 r->prev->next = r->next;
4779 else
4780 mmap_regions = r->next;
4782 if (munmap (r, r->nbytes_mapped) == -1)
4783 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4787 /* Enlarge region R by NPAGES pages. NPAGES < 0 means shrink R.
4788 Value is true if successful. */
4790 static bool
4791 mmap_enlarge (struct mmap_region *r, int npages)
4793 char *region_end = (char *) r + r->nbytes_mapped;
4794 size_t nbytes;
4795 bool success = 0;
4797 if (npages < 0)
4799 /* Unmap pages at the end of the region. */
4800 nbytes = - npages * mmap_page_size;
4801 if (munmap (region_end - nbytes, nbytes) == -1)
4802 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4803 else
4805 r->nbytes_mapped -= nbytes;
4806 success = 1;
4809 else if (npages > 0)
4811 nbytes = npages * mmap_page_size;
4813 /* Try to map additional pages at the end of the region. We
4814 cannot do this if the address range is already occupied by
4815 something else because mmap deletes any previous mapping.
4816 I'm not sure this is worth doing, let's see. */
4817 if (!MMAP_ALLOCATED_P (region_end, region_end + nbytes))
4819 void *p;
4821 p = mmap (region_end, nbytes, PROT_READ | PROT_WRITE,
4822 MAP_ANON | MAP_PRIVATE | MAP_FIXED, mmap_fd, 0);
4823 if (p == MAP_FAILED)
4824 ; /* fprintf (stderr, "mmap: %s\n", emacs_strerror (errno)); */
4825 else if (p != region_end)
4827 /* Kernels are free to choose a different address. In
4828 that case, unmap what we've mapped above; we have
4829 no use for it. */
4830 if (munmap (p, nbytes) == -1)
4831 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4833 else
4835 r->nbytes_mapped += nbytes;
4836 success = 1;
4841 return success;
4845 /* Set or reset variables holding references to mapped regions.
4846 If not RESTORE_P, set all variables to null. If RESTORE_P, set all
4847 variables to the start of the user-areas of mapped regions.
4849 This function is called from Fdump_emacs to ensure that the dumped
4850 Emacs doesn't contain references to memory that won't be mapped
4851 when Emacs starts. */
4853 void
4854 mmap_set_vars (bool restore_p)
4856 struct mmap_region *r;
4858 if (restore_p)
4860 mmap_regions = mmap_regions_1;
4861 mmap_fd = mmap_fd_1;
4862 for (r = mmap_regions; r; r = r->next)
4863 *r->var = MMAP_USER_AREA (r);
4865 else
4867 for (r = mmap_regions; r; r = r->next)
4868 *r->var = NULL;
4869 mmap_regions_1 = mmap_regions;
4870 mmap_regions = NULL;
4871 mmap_fd_1 = mmap_fd;
4872 mmap_fd = -1;
4877 /* Allocate a block of storage large enough to hold NBYTES bytes of
4878 data. A pointer to the data is returned in *VAR. VAR is thus the
4879 address of some variable which will use the data area.
4881 The allocation of 0 bytes is valid.
4883 If we can't allocate the necessary memory, set *VAR to null, and
4884 return null. */
4886 static void *
4887 mmap_alloc (void **var, size_t nbytes)
4889 void *p;
4890 size_t map;
4892 mmap_init ();
4894 map = ROUND (nbytes + MMAP_REGION_STRUCT_SIZE, mmap_page_size);
4895 p = mmap (NULL, map, PROT_READ | PROT_WRITE, MAP_ANON | MAP_PRIVATE,
4896 mmap_fd, 0);
4898 if (p == MAP_FAILED)
4900 if (errno != ENOMEM)
4901 fprintf (stderr, "mmap: %s\n", emacs_strerror (errno));
4902 p = NULL;
4904 else
4906 struct mmap_region *r = (struct mmap_region *) p;
4908 r->nbytes_specified = nbytes;
4909 r->nbytes_mapped = map;
4910 r->var = var;
4911 r->prev = NULL;
4912 r->next = mmap_regions;
4913 if (r->next)
4914 r->next->prev = r;
4915 mmap_regions = r;
4917 p = MMAP_USER_AREA (p);
4920 return *var = p;
4924 /* Free a block of relocatable storage whose data is pointed to by
4925 PTR. Store 0 in *PTR to show there's no block allocated. */
4927 static void
4928 mmap_free (void **var)
4930 mmap_init ();
4932 if (*var)
4934 mmap_free_1 (MMAP_REGION (*var));
4935 *var = NULL;
4940 /* Given a pointer at address VAR to data allocated with mmap_alloc,
4941 resize it to size NBYTES. Change *VAR to reflect the new block,
4942 and return this value. If more memory cannot be allocated, then
4943 leave *VAR unchanged, and return null. */
4945 static void *
4946 mmap_realloc (void **var, size_t nbytes)
4948 void *result;
4950 mmap_init ();
4952 if (*var == NULL)
4953 result = mmap_alloc (var, nbytes);
4954 else if (nbytes == 0)
4956 mmap_free (var);
4957 result = mmap_alloc (var, nbytes);
4959 else
4961 struct mmap_region *r = MMAP_REGION (*var);
4962 size_t room = r->nbytes_mapped - MMAP_REGION_STRUCT_SIZE;
4964 if (room < nbytes)
4966 /* Must enlarge. */
4967 void *old_ptr = *var;
4969 /* Try to map additional pages at the end of the region.
4970 If that fails, allocate a new region, copy data
4971 from the old region, then free it. */
4972 if (mmap_enlarge (r, (ROUND (nbytes - room, mmap_page_size)
4973 / mmap_page_size)))
4975 r->nbytes_specified = nbytes;
4976 *var = result = old_ptr;
4978 else if (mmap_alloc (var, nbytes))
4980 memcpy (*var, old_ptr, r->nbytes_specified);
4981 mmap_free_1 (MMAP_REGION (old_ptr));
4982 result = *var;
4983 r = MMAP_REGION (result);
4984 r->nbytes_specified = nbytes;
4986 else
4988 *var = old_ptr;
4989 result = NULL;
4992 else if (room - nbytes >= mmap_page_size)
4994 /* Shrinking by at least a page. Let's give some
4995 memory back to the system.
4997 The extra parens are to make the division happens first,
4998 on positive values, so we know it will round towards
4999 zero. */
5000 mmap_enlarge (r, - ((room - nbytes) / mmap_page_size));
5001 result = *var;
5002 r->nbytes_specified = nbytes;
5004 else
5006 /* Leave it alone. */
5007 result = *var;
5008 r->nbytes_specified = nbytes;
5012 return result;
5016 #endif /* USE_MMAP_FOR_BUFFERS */
5020 /***********************************************************************
5021 Buffer-text Allocation
5022 ***********************************************************************/
5024 /* Allocate NBYTES bytes for buffer B's text buffer. */
5026 static void
5027 alloc_buffer_text (struct buffer *b, ptrdiff_t nbytes)
5029 void *p;
5031 block_input ();
5032 #if defined USE_MMAP_FOR_BUFFERS
5033 p = mmap_alloc ((void **) &b->text->beg, nbytes);
5034 #elif defined REL_ALLOC
5035 p = r_alloc ((void **) &b->text->beg, nbytes);
5036 #else
5037 p = xmalloc (nbytes);
5038 #endif
5040 if (p == NULL)
5042 unblock_input ();
5043 memory_full (nbytes);
5046 b->text->beg = (unsigned char *) p;
5047 unblock_input ();
5050 /* Enlarge buffer B's text buffer by DELTA bytes. DELTA < 0 means
5051 shrink it. */
5053 void
5054 enlarge_buffer_text (struct buffer *b, ptrdiff_t delta)
5056 void *p;
5057 ptrdiff_t nbytes = (BUF_Z_BYTE (b) - BUF_BEG_BYTE (b) + BUF_GAP_SIZE (b) + 1
5058 + delta);
5059 block_input ();
5060 #if defined USE_MMAP_FOR_BUFFERS
5061 p = mmap_realloc ((void **) &b->text->beg, nbytes);
5062 #elif defined REL_ALLOC
5063 p = r_re_alloc ((void **) &b->text->beg, nbytes);
5064 #else
5065 p = xrealloc (b->text->beg, nbytes);
5066 #endif
5068 if (p == NULL)
5070 unblock_input ();
5071 memory_full (nbytes);
5074 BUF_BEG_ADDR (b) = (unsigned char *) p;
5075 unblock_input ();
5079 /* Free buffer B's text buffer. */
5081 static void
5082 free_buffer_text (struct buffer *b)
5084 block_input ();
5086 #if defined USE_MMAP_FOR_BUFFERS
5087 mmap_free ((void **) &b->text->beg);
5088 #elif defined REL_ALLOC
5089 r_alloc_free ((void **) &b->text->beg);
5090 #else
5091 xfree (b->text->beg);
5092 #endif
5094 BUF_BEG_ADDR (b) = NULL;
5095 unblock_input ();
5100 /***********************************************************************
5101 Initialization
5102 ***********************************************************************/
5104 void
5105 init_buffer_once (void)
5107 int idx;
5109 memset (buffer_permanent_local_flags, 0, sizeof buffer_permanent_local_flags);
5111 /* Make sure all markable slots in buffer_defaults
5112 are initialized reasonably, so mark_buffer won't choke. */
5113 reset_buffer (&buffer_defaults);
5114 eassert (EQ (BVAR (&buffer_defaults, name), make_number (0)));
5115 reset_buffer_local_variables (&buffer_defaults, 1);
5116 eassert (EQ (BVAR (&buffer_local_symbols, name), make_number (0)));
5117 reset_buffer (&buffer_local_symbols);
5118 reset_buffer_local_variables (&buffer_local_symbols, 1);
5119 /* Prevent GC from getting confused. */
5120 buffer_defaults.text = &buffer_defaults.own_text;
5121 buffer_local_symbols.text = &buffer_local_symbols.own_text;
5122 /* No one will share the text with these buffers, but let's play it safe. */
5123 buffer_defaults.indirections = 0;
5124 buffer_local_symbols.indirections = 0;
5125 set_buffer_intervals (&buffer_defaults, NULL);
5126 set_buffer_intervals (&buffer_local_symbols, NULL);
5127 /* This is not strictly necessary, but let's make them initialized. */
5128 bset_name (&buffer_defaults, build_pure_c_string (" *buffer-defaults*"));
5129 bset_name (&buffer_local_symbols, build_pure_c_string (" *buffer-local-symbols*"));
5130 BUFFER_PVEC_INIT (&buffer_defaults);
5131 BUFFER_PVEC_INIT (&buffer_local_symbols);
5133 /* Set up the default values of various buffer slots. */
5134 /* Must do these before making the first buffer! */
5136 /* real setup is done in bindings.el */
5137 bset_mode_line_format (&buffer_defaults, build_pure_c_string ("%-"));
5138 bset_header_line_format (&buffer_defaults, Qnil);
5139 bset_abbrev_mode (&buffer_defaults, Qnil);
5140 bset_overwrite_mode (&buffer_defaults, Qnil);
5141 bset_case_fold_search (&buffer_defaults, Qt);
5142 bset_auto_fill_function (&buffer_defaults, Qnil);
5143 bset_selective_display (&buffer_defaults, Qnil);
5144 bset_selective_display_ellipses (&buffer_defaults, Qt);
5145 bset_abbrev_table (&buffer_defaults, Qnil);
5146 bset_display_table (&buffer_defaults, Qnil);
5147 bset_undo_list (&buffer_defaults, Qnil);
5148 bset_mark_active (&buffer_defaults, Qnil);
5149 bset_file_format (&buffer_defaults, Qnil);
5150 bset_auto_save_file_format (&buffer_defaults, Qt);
5151 set_buffer_overlays_before (&buffer_defaults, NULL);
5152 set_buffer_overlays_after (&buffer_defaults, NULL);
5153 buffer_defaults.overlay_center = BEG;
5155 XSETFASTINT (BVAR (&buffer_defaults, tab_width), 8);
5156 bset_truncate_lines (&buffer_defaults, Qnil);
5157 bset_word_wrap (&buffer_defaults, Qnil);
5158 bset_ctl_arrow (&buffer_defaults, Qt);
5159 bset_bidi_display_reordering (&buffer_defaults, Qt);
5160 bset_bidi_paragraph_direction (&buffer_defaults, Qnil);
5161 bset_cursor_type (&buffer_defaults, Qt);
5162 bset_extra_line_spacing (&buffer_defaults, Qnil);
5163 bset_cursor_in_non_selected_windows (&buffer_defaults, Qt);
5165 bset_enable_multibyte_characters (&buffer_defaults, Qt);
5166 bset_buffer_file_coding_system (&buffer_defaults, Qnil);
5167 XSETFASTINT (BVAR (&buffer_defaults, fill_column), 70);
5168 XSETFASTINT (BVAR (&buffer_defaults, left_margin), 0);
5169 bset_cache_long_line_scans (&buffer_defaults, Qnil);
5170 bset_file_truename (&buffer_defaults, Qnil);
5171 XSETFASTINT (BVAR (&buffer_defaults, display_count), 0);
5172 XSETFASTINT (BVAR (&buffer_defaults, left_margin_cols), 0);
5173 XSETFASTINT (BVAR (&buffer_defaults, right_margin_cols), 0);
5174 bset_left_fringe_width (&buffer_defaults, Qnil);
5175 bset_right_fringe_width (&buffer_defaults, Qnil);
5176 bset_fringes_outside_margins (&buffer_defaults, Qnil);
5177 bset_scroll_bar_width (&buffer_defaults, Qnil);
5178 bset_vertical_scroll_bar_type (&buffer_defaults, Qt);
5179 bset_indicate_empty_lines (&buffer_defaults, Qnil);
5180 bset_indicate_buffer_boundaries (&buffer_defaults, Qnil);
5181 bset_fringe_indicator_alist (&buffer_defaults, Qnil);
5182 bset_fringe_cursor_alist (&buffer_defaults, Qnil);
5183 bset_scroll_up_aggressively (&buffer_defaults, Qnil);
5184 bset_scroll_down_aggressively (&buffer_defaults, Qnil);
5185 bset_display_time (&buffer_defaults, Qnil);
5187 /* Assign the local-flags to the slots that have default values.
5188 The local flag is a bit that is used in the buffer
5189 to say that it has its own local value for the slot.
5190 The local flag bits are in the local_var_flags slot of the buffer. */
5192 /* Nothing can work if this isn't true */
5193 { verify (sizeof (EMACS_INT) == word_size); }
5195 /* 0 means not a lisp var, -1 means always local, else mask */
5196 memset (&buffer_local_flags, 0, sizeof buffer_local_flags);
5197 bset_filename (&buffer_local_flags, make_number (-1));
5198 bset_directory (&buffer_local_flags, make_number (-1));
5199 bset_backed_up (&buffer_local_flags, make_number (-1));
5200 bset_save_length (&buffer_local_flags, make_number (-1));
5201 bset_auto_save_file_name (&buffer_local_flags, make_number (-1));
5202 bset_read_only (&buffer_local_flags, make_number (-1));
5203 bset_major_mode (&buffer_local_flags, make_number (-1));
5204 bset_mode_name (&buffer_local_flags, make_number (-1));
5205 bset_undo_list (&buffer_local_flags, make_number (-1));
5206 bset_mark_active (&buffer_local_flags, make_number (-1));
5207 bset_point_before_scroll (&buffer_local_flags, make_number (-1));
5208 bset_file_truename (&buffer_local_flags, make_number (-1));
5209 bset_invisibility_spec (&buffer_local_flags, make_number (-1));
5210 bset_file_format (&buffer_local_flags, make_number (-1));
5211 bset_auto_save_file_format (&buffer_local_flags, make_number (-1));
5212 bset_display_count (&buffer_local_flags, make_number (-1));
5213 bset_display_time (&buffer_local_flags, make_number (-1));
5214 bset_enable_multibyte_characters (&buffer_local_flags, make_number (-1));
5216 idx = 1;
5217 XSETFASTINT (BVAR (&buffer_local_flags, mode_line_format), idx); ++idx;
5218 XSETFASTINT (BVAR (&buffer_local_flags, abbrev_mode), idx); ++idx;
5219 XSETFASTINT (BVAR (&buffer_local_flags, overwrite_mode), idx); ++idx;
5220 XSETFASTINT (BVAR (&buffer_local_flags, case_fold_search), idx); ++idx;
5221 XSETFASTINT (BVAR (&buffer_local_flags, auto_fill_function), idx); ++idx;
5222 XSETFASTINT (BVAR (&buffer_local_flags, selective_display), idx); ++idx;
5223 XSETFASTINT (BVAR (&buffer_local_flags, selective_display_ellipses), idx); ++idx;
5224 XSETFASTINT (BVAR (&buffer_local_flags, tab_width), idx); ++idx;
5225 XSETFASTINT (BVAR (&buffer_local_flags, truncate_lines), idx); ++idx;
5226 XSETFASTINT (BVAR (&buffer_local_flags, word_wrap), idx); ++idx;
5227 XSETFASTINT (BVAR (&buffer_local_flags, ctl_arrow), idx); ++idx;
5228 XSETFASTINT (BVAR (&buffer_local_flags, fill_column), idx); ++idx;
5229 XSETFASTINT (BVAR (&buffer_local_flags, left_margin), idx); ++idx;
5230 XSETFASTINT (BVAR (&buffer_local_flags, abbrev_table), idx); ++idx;
5231 XSETFASTINT (BVAR (&buffer_local_flags, display_table), idx); ++idx;
5232 XSETFASTINT (BVAR (&buffer_local_flags, syntax_table), idx); ++idx;
5233 XSETFASTINT (BVAR (&buffer_local_flags, cache_long_line_scans), idx); ++idx;
5234 XSETFASTINT (BVAR (&buffer_local_flags, category_table), idx); ++idx;
5235 XSETFASTINT (BVAR (&buffer_local_flags, bidi_display_reordering), idx); ++idx;
5236 XSETFASTINT (BVAR (&buffer_local_flags, bidi_paragraph_direction), idx); ++idx;
5237 XSETFASTINT (BVAR (&buffer_local_flags, buffer_file_coding_system), idx);
5238 /* Make this one a permanent local. */
5239 buffer_permanent_local_flags[idx++] = 1;
5240 XSETFASTINT (BVAR (&buffer_local_flags, left_margin_cols), idx); ++idx;
5241 XSETFASTINT (BVAR (&buffer_local_flags, right_margin_cols), idx); ++idx;
5242 XSETFASTINT (BVAR (&buffer_local_flags, left_fringe_width), idx); ++idx;
5243 XSETFASTINT (BVAR (&buffer_local_flags, right_fringe_width), idx); ++idx;
5244 XSETFASTINT (BVAR (&buffer_local_flags, fringes_outside_margins), idx); ++idx;
5245 XSETFASTINT (BVAR (&buffer_local_flags, scroll_bar_width), idx); ++idx;
5246 XSETFASTINT (BVAR (&buffer_local_flags, vertical_scroll_bar_type), idx); ++idx;
5247 XSETFASTINT (BVAR (&buffer_local_flags, indicate_empty_lines), idx); ++idx;
5248 XSETFASTINT (BVAR (&buffer_local_flags, indicate_buffer_boundaries), idx); ++idx;
5249 XSETFASTINT (BVAR (&buffer_local_flags, fringe_indicator_alist), idx); ++idx;
5250 XSETFASTINT (BVAR (&buffer_local_flags, fringe_cursor_alist), idx); ++idx;
5251 XSETFASTINT (BVAR (&buffer_local_flags, scroll_up_aggressively), idx); ++idx;
5252 XSETFASTINT (BVAR (&buffer_local_flags, scroll_down_aggressively), idx); ++idx;
5253 XSETFASTINT (BVAR (&buffer_local_flags, header_line_format), idx); ++idx;
5254 XSETFASTINT (BVAR (&buffer_local_flags, cursor_type), idx); ++idx;
5255 XSETFASTINT (BVAR (&buffer_local_flags, extra_line_spacing), idx); ++idx;
5256 XSETFASTINT (BVAR (&buffer_local_flags, cursor_in_non_selected_windows), idx); ++idx;
5258 /* Need more room? */
5259 if (idx >= MAX_PER_BUFFER_VARS)
5260 emacs_abort ();
5261 last_per_buffer_idx = idx;
5263 Vbuffer_alist = Qnil;
5264 current_buffer = 0;
5265 all_buffers = 0;
5267 QSFundamental = build_pure_c_string ("Fundamental");
5269 Qfundamental_mode = intern_c_string ("fundamental-mode");
5270 bset_major_mode (&buffer_defaults, Qfundamental_mode);
5272 Qmode_class = intern_c_string ("mode-class");
5274 Qprotected_field = intern_c_string ("protected-field");
5276 Qpermanent_local = intern_c_string ("permanent-local");
5278 Qkill_buffer_hook = intern_c_string ("kill-buffer-hook");
5279 Fput (Qkill_buffer_hook, Qpermanent_local, Qt);
5281 /* super-magic invisible buffer */
5282 Vprin1_to_string_buffer = Fget_buffer_create (build_pure_c_string (" prin1"));
5283 Vbuffer_alist = Qnil;
5285 Fset_buffer (Fget_buffer_create (build_pure_c_string ("*scratch*")));
5287 inhibit_modification_hooks = 0;
5290 void
5291 init_buffer (void)
5293 char *pwd;
5294 Lisp_Object temp;
5295 ptrdiff_t len;
5297 #ifdef USE_MMAP_FOR_BUFFERS
5299 /* When using the ralloc implementation based on mmap(2), buffer
5300 text pointers will have been set to null in the dumped Emacs.
5301 Map new memory. */
5302 struct buffer *b;
5304 FOR_EACH_BUFFER (b)
5305 if (b->text->beg == NULL)
5306 enlarge_buffer_text (b, 0);
5308 #endif /* USE_MMAP_FOR_BUFFERS */
5310 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5311 if (NILP (BVAR (&buffer_defaults, enable_multibyte_characters)))
5312 Fset_buffer_multibyte (Qnil);
5314 pwd = get_current_dir_name ();
5316 if (!pwd)
5317 fatal ("`get_current_dir_name' failed: %s\n", strerror (errno));
5319 /* Maybe this should really use some standard subroutine
5320 whose definition is filename syntax dependent. */
5321 len = strlen (pwd);
5322 if (!(IS_DIRECTORY_SEP (pwd[len - 1])))
5324 /* Grow buffer to add directory separator and '\0'. */
5325 pwd = realloc (pwd, len + 2);
5326 if (!pwd)
5327 fatal ("`get_current_dir_name' failed: %s\n", strerror (errno));
5328 pwd[len] = DIRECTORY_SEP;
5329 pwd[len + 1] = '\0';
5330 len++;
5333 bset_directory (current_buffer, make_unibyte_string (pwd, len));
5334 if (! NILP (BVAR (&buffer_defaults, enable_multibyte_characters)))
5335 /* At this moment, we still don't know how to decode the
5336 directory name. So, we keep the bytes in multibyte form so
5337 that ENCODE_FILE correctly gets the original bytes. */
5338 bset_directory
5339 (current_buffer, string_to_multibyte (BVAR (current_buffer, directory)));
5341 /* Add /: to the front of the name
5342 if it would otherwise be treated as magic. */
5343 temp = Ffind_file_name_handler (BVAR (current_buffer, directory), Qt);
5344 if (! NILP (temp)
5345 /* If the default dir is just /, TEMP is non-nil
5346 because of the ange-ftp completion handler.
5347 However, it is not necessary to turn / into /:/.
5348 So avoid doing that. */
5349 && strcmp ("/", SSDATA (BVAR (current_buffer, directory))))
5350 bset_directory
5351 (current_buffer,
5352 concat2 (build_string ("/:"), BVAR (current_buffer, directory)));
5354 temp = get_minibuffer (0);
5355 bset_directory (XBUFFER (temp), BVAR (current_buffer, directory));
5357 free (pwd);
5360 /* Similar to defvar_lisp but define a variable whose value is the Lisp
5361 Object stored in the current buffer. address is the address of the slot
5362 in the buffer that is current now. */
5364 /* TYPE is nil for a general Lisp variable.
5365 An integer specifies a type; then only Lisp values
5366 with that type code are allowed (except that nil is allowed too).
5367 LNAME is the Lisp-level variable name.
5368 VNAME is the name of the buffer slot.
5369 DOC is a dummy where you write the doc string as a comment. */
5370 #define DEFVAR_PER_BUFFER(lname, vname, type, doc) \
5371 do { \
5372 static struct Lisp_Buffer_Objfwd bo_fwd; \
5373 defvar_per_buffer (&bo_fwd, lname, vname, type); \
5374 } while (0)
5376 static void
5377 defvar_per_buffer (struct Lisp_Buffer_Objfwd *bo_fwd, const char *namestring,
5378 Lisp_Object *address, Lisp_Object type)
5380 struct Lisp_Symbol *sym;
5381 int offset;
5383 sym = XSYMBOL (intern (namestring));
5384 offset = (char *)address - (char *)current_buffer;
5386 bo_fwd->type = Lisp_Fwd_Buffer_Obj;
5387 bo_fwd->offset = offset;
5388 bo_fwd->slottype = type;
5389 sym->declared_special = 1;
5390 sym->redirect = SYMBOL_FORWARDED;
5392 /* I tried to do the job without a cast, but it seems impossible.
5393 union Lisp_Fwd *fwd; &(fwd->u_buffer_objfwd) = bo_fwd; */
5394 SET_SYMBOL_FWD (sym, (union Lisp_Fwd *)bo_fwd);
5396 XSETSYMBOL (PER_BUFFER_SYMBOL (offset), sym);
5398 if (PER_BUFFER_IDX (offset) == 0)
5399 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
5400 slot of buffer_local_flags */
5401 emacs_abort ();
5405 /* initialize the buffer routines */
5406 void
5407 syms_of_buffer (void)
5409 staticpro (&last_overlay_modification_hooks);
5410 last_overlay_modification_hooks
5411 = Fmake_vector (make_number (10), Qnil);
5413 staticpro (&Qfundamental_mode);
5414 staticpro (&Qmode_class);
5415 staticpro (&QSFundamental);
5416 staticpro (&Vbuffer_alist);
5417 staticpro (&Qprotected_field);
5418 staticpro (&Qpermanent_local);
5419 staticpro (&Qkill_buffer_hook);
5421 DEFSYM (Qpermanent_local_hook, "permanent-local-hook");
5422 DEFSYM (Qoverlayp, "overlayp");
5423 DEFSYM (Qevaporate, "evaporate");
5424 DEFSYM (Qmodification_hooks, "modification-hooks");
5425 DEFSYM (Qinsert_in_front_hooks, "insert-in-front-hooks");
5426 DEFSYM (Qinsert_behind_hooks, "insert-behind-hooks");
5427 DEFSYM (Qget_file_buffer, "get-file-buffer");
5428 DEFSYM (Qpriority, "priority");
5429 DEFSYM (Qbefore_string, "before-string");
5430 DEFSYM (Qafter_string, "after-string");
5431 DEFSYM (Qfirst_change_hook, "first-change-hook");
5432 DEFSYM (Qbefore_change_functions, "before-change-functions");
5433 DEFSYM (Qafter_change_functions, "after-change-functions");
5434 DEFSYM (Qkill_buffer_query_functions, "kill-buffer-query-functions");
5436 Fput (Qprotected_field, Qerror_conditions,
5437 listn (CONSTYPE_PURE, 2, Qprotected_field, Qerror));
5438 Fput (Qprotected_field, Qerror_message,
5439 build_pure_c_string ("Attempt to modify a protected field"));
5441 DEFVAR_BUFFER_DEFAULTS ("default-mode-line-format",
5442 mode_line_format,
5443 doc: /* Default value of `mode-line-format' for buffers that don't override it.
5444 This is the same as (default-value 'mode-line-format). */);
5446 DEFVAR_BUFFER_DEFAULTS ("default-header-line-format",
5447 header_line_format,
5448 doc: /* Default value of `header-line-format' for buffers that don't override it.
5449 This is the same as (default-value 'header-line-format). */);
5451 DEFVAR_BUFFER_DEFAULTS ("default-cursor-type", cursor_type,
5452 doc: /* Default value of `cursor-type' for buffers that don't override it.
5453 This is the same as (default-value 'cursor-type). */);
5455 DEFVAR_BUFFER_DEFAULTS ("default-line-spacing",
5456 extra_line_spacing,
5457 doc: /* Default value of `line-spacing' for buffers that don't override it.
5458 This is the same as (default-value 'line-spacing). */);
5460 DEFVAR_BUFFER_DEFAULTS ("default-cursor-in-non-selected-windows",
5461 cursor_in_non_selected_windows,
5462 doc: /* Default value of `cursor-in-non-selected-windows'.
5463 This is the same as (default-value 'cursor-in-non-selected-windows). */);
5465 DEFVAR_BUFFER_DEFAULTS ("default-abbrev-mode",
5466 abbrev_mode,
5467 doc: /* Default value of `abbrev-mode' for buffers that do not override it.
5468 This is the same as (default-value 'abbrev-mode). */);
5470 DEFVAR_BUFFER_DEFAULTS ("default-ctl-arrow",
5471 ctl_arrow,
5472 doc: /* Default value of `ctl-arrow' for buffers that do not override it.
5473 This is the same as (default-value 'ctl-arrow). */);
5475 DEFVAR_BUFFER_DEFAULTS ("default-enable-multibyte-characters",
5476 enable_multibyte_characters,
5477 doc: /* Default value of `enable-multibyte-characters' for buffers not overriding it.
5478 This is the same as (default-value 'enable-multibyte-characters). */);
5480 DEFVAR_BUFFER_DEFAULTS ("default-buffer-file-coding-system",
5481 buffer_file_coding_system,
5482 doc: /* Default value of `buffer-file-coding-system' for buffers not overriding it.
5483 This is the same as (default-value 'buffer-file-coding-system). */);
5485 DEFVAR_BUFFER_DEFAULTS ("default-truncate-lines",
5486 truncate_lines,
5487 doc: /* Default value of `truncate-lines' for buffers that do not override it.
5488 This is the same as (default-value 'truncate-lines). */);
5490 DEFVAR_BUFFER_DEFAULTS ("default-fill-column",
5491 fill_column,
5492 doc: /* Default value of `fill-column' for buffers that do not override it.
5493 This is the same as (default-value 'fill-column). */);
5495 DEFVAR_BUFFER_DEFAULTS ("default-left-margin",
5496 left_margin,
5497 doc: /* Default value of `left-margin' for buffers that do not override it.
5498 This is the same as (default-value 'left-margin). */);
5500 DEFVAR_BUFFER_DEFAULTS ("default-tab-width",
5501 tab_width,
5502 doc: /* Default value of `tab-width' for buffers that do not override it.
5503 This is the same as (default-value 'tab-width). */);
5505 DEFVAR_BUFFER_DEFAULTS ("default-case-fold-search",
5506 case_fold_search,
5507 doc: /* Default value of `case-fold-search' for buffers that don't override it.
5508 This is the same as (default-value 'case-fold-search). */);
5510 DEFVAR_BUFFER_DEFAULTS ("default-left-margin-width",
5511 left_margin_cols,
5512 doc: /* Default value of `left-margin-width' for buffers that don't override it.
5513 This is the same as (default-value 'left-margin-width). */);
5515 DEFVAR_BUFFER_DEFAULTS ("default-right-margin-width",
5516 right_margin_cols,
5517 doc: /* Default value of `right-margin-width' for buffers that don't override it.
5518 This is the same as (default-value 'right-margin-width). */);
5520 DEFVAR_BUFFER_DEFAULTS ("default-left-fringe-width",
5521 left_fringe_width,
5522 doc: /* Default value of `left-fringe-width' for buffers that don't override it.
5523 This is the same as (default-value 'left-fringe-width). */);
5525 DEFVAR_BUFFER_DEFAULTS ("default-right-fringe-width",
5526 right_fringe_width,
5527 doc: /* Default value of `right-fringe-width' for buffers that don't override it.
5528 This is the same as (default-value 'right-fringe-width). */);
5530 DEFVAR_BUFFER_DEFAULTS ("default-fringes-outside-margins",
5531 fringes_outside_margins,
5532 doc: /* Default value of `fringes-outside-margins' for buffers that don't override it.
5533 This is the same as (default-value 'fringes-outside-margins). */);
5535 DEFVAR_BUFFER_DEFAULTS ("default-scroll-bar-width",
5536 scroll_bar_width,
5537 doc: /* Default value of `scroll-bar-width' for buffers that don't override it.
5538 This is the same as (default-value 'scroll-bar-width). */);
5540 DEFVAR_BUFFER_DEFAULTS ("default-vertical-scroll-bar",
5541 vertical_scroll_bar_type,
5542 doc: /* Default value of `vertical-scroll-bar' for buffers that don't override it.
5543 This is the same as (default-value 'vertical-scroll-bar). */);
5545 DEFVAR_BUFFER_DEFAULTS ("default-indicate-empty-lines",
5546 indicate_empty_lines,
5547 doc: /* Default value of `indicate-empty-lines' for buffers that don't override it.
5548 This is the same as (default-value 'indicate-empty-lines). */);
5550 DEFVAR_BUFFER_DEFAULTS ("default-indicate-buffer-boundaries",
5551 indicate_buffer_boundaries,
5552 doc: /* Default value of `indicate-buffer-boundaries' for buffers that don't override it.
5553 This is the same as (default-value 'indicate-buffer-boundaries). */);
5555 DEFVAR_BUFFER_DEFAULTS ("default-fringe-indicator-alist",
5556 fringe_indicator_alist,
5557 doc: /* Default value of `fringe-indicator-alist' for buffers that don't override it.
5558 This is the same as (default-value 'fringe-indicator-alist'). */);
5560 DEFVAR_BUFFER_DEFAULTS ("default-fringe-cursor-alist",
5561 fringe_cursor_alist,
5562 doc: /* Default value of `fringe-cursor-alist' for buffers that don't override it.
5563 This is the same as (default-value 'fringe-cursor-alist'). */);
5565 DEFVAR_BUFFER_DEFAULTS ("default-scroll-up-aggressively",
5566 scroll_up_aggressively,
5567 doc: /* Default value of `scroll-up-aggressively'.
5568 This value applies in buffers that don't have their own local values.
5569 This is the same as (default-value 'scroll-up-aggressively). */);
5571 DEFVAR_BUFFER_DEFAULTS ("default-scroll-down-aggressively",
5572 scroll_down_aggressively,
5573 doc: /* Default value of `scroll-down-aggressively'.
5574 This value applies in buffers that don't have their own local values.
5575 This is the same as (default-value 'scroll-down-aggressively). */);
5577 DEFVAR_PER_BUFFER ("header-line-format",
5578 &BVAR (current_buffer, header_line_format),
5579 Qnil,
5580 doc: /* Analogous to `mode-line-format', but controls the header line.
5581 The header line appears, optionally, at the top of a window;
5582 the mode line appears at the bottom. */);
5584 DEFVAR_PER_BUFFER ("mode-line-format", &BVAR (current_buffer, mode_line_format),
5585 Qnil,
5586 doc: /* Template for displaying mode line for current buffer.
5588 The value may be nil, a string, a symbol or a list.
5590 A value of nil means don't display a mode line.
5592 For any symbol other than t or nil, the symbol's value is processed as
5593 a mode line construct. As a special exception, if that value is a
5594 string, the string is processed verbatim, without handling any
5595 %-constructs (see below). Also, unless the symbol has a non-nil
5596 `risky-local-variable' property, all properties in any strings, as
5597 well as all :eval and :propertize forms in the value, are ignored.
5599 A list whose car is a string or list is processed by processing each
5600 of the list elements recursively, as separate mode line constructs,
5601 and concatenating the results.
5603 A list of the form `(:eval FORM)' is processed by evaluating FORM and
5604 using the result as a mode line construct. Be careful--FORM should
5605 not load any files, because that can cause an infinite recursion.
5607 A list of the form `(:propertize ELT PROPS...)' is processed by
5608 processing ELT as the mode line construct, and adding the text
5609 properties PROPS to the result.
5611 A list whose car is a symbol is processed by examining the symbol's
5612 value, and, if that value is non-nil, processing the cadr of the list
5613 recursively; and if that value is nil, processing the caddr of the
5614 list recursively.
5616 A list whose car is an integer is processed by processing the cadr of
5617 the list, and padding (if the number is positive) or truncating (if
5618 negative) to the width specified by that number.
5620 A string is printed verbatim in the mode line except for %-constructs:
5621 %b -- print buffer name. %f -- print visited file name.
5622 %F -- print frame name.
5623 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.
5624 %& is like %*, but ignore read-only-ness.
5625 % means buffer is read-only and * means it is modified.
5626 For a modified read-only buffer, %* gives % and %+ gives *.
5627 %s -- print process status. %l -- print the current line number.
5628 %c -- print the current column number (this makes editing slower).
5629 To make the column number update correctly in all cases,
5630 `column-number-mode' must be non-nil.
5631 %i -- print the size of the buffer.
5632 %I -- like %i, but use k, M, G, etc., to abbreviate.
5633 %p -- print percent of buffer above top of window, or Top, Bot or All.
5634 %P -- print percent of buffer above bottom of window, perhaps plus Top,
5635 or print Bottom or All.
5636 %n -- print Narrow if appropriate.
5637 %t -- visited file is text or binary (if OS supports this distinction).
5638 %z -- print mnemonics of keyboard, terminal, and buffer coding systems.
5639 %Z -- like %z, but including the end-of-line format.
5640 %e -- print error message about full memory.
5641 %@ -- print @ or hyphen. @ means that default-directory is on a
5642 remote machine.
5643 %[ -- print one [ for each recursive editing level. %] similar.
5644 %% -- print %. %- -- print infinitely many dashes.
5645 Decimal digits after the % specify field width to which to pad. */);
5647 DEFVAR_BUFFER_DEFAULTS ("default-major-mode", major_mode,
5648 doc: /* Value of `major-mode' for new buffers. */);
5650 DEFVAR_PER_BUFFER ("major-mode", &BVAR (current_buffer, major_mode),
5651 make_number (Lisp_Symbol),
5652 doc: /* Symbol for current buffer's major mode.
5653 The default value (normally `fundamental-mode') affects new buffers.
5654 A value of nil means to use the current buffer's major mode, provided
5655 it is not marked as "special".
5657 When a mode is used by default, `find-file' switches to it before it
5658 reads the contents into the buffer and before it finishes setting up
5659 the buffer. Thus, the mode and its hooks should not expect certain
5660 variables such as `buffer-read-only' and `buffer-file-coding-system'
5661 to be set up. */);
5663 DEFVAR_PER_BUFFER ("mode-name", &BVAR (current_buffer, mode_name),
5664 Qnil,
5665 doc: /* Pretty name of current buffer's major mode.
5666 Usually a string, but can use any of the constructs for `mode-line-format',
5667 which see.
5668 Format with `format-mode-line' to produce a string value. */);
5670 DEFVAR_PER_BUFFER ("local-abbrev-table", &BVAR (current_buffer, abbrev_table), Qnil,
5671 doc: /* Local (mode-specific) abbrev table of current buffer. */);
5673 DEFVAR_PER_BUFFER ("abbrev-mode", &BVAR (current_buffer, abbrev_mode), Qnil,
5674 doc: /* Non-nil if Abbrev mode is enabled.
5675 Use the command `abbrev-mode' to change this variable. */);
5677 DEFVAR_PER_BUFFER ("case-fold-search", &BVAR (current_buffer, case_fold_search),
5678 Qnil,
5679 doc: /* Non-nil if searches and matches should ignore case. */);
5681 DEFVAR_PER_BUFFER ("fill-column", &BVAR (current_buffer, fill_column),
5682 make_number (Lisp_Int0),
5683 doc: /* Column beyond which automatic line-wrapping should happen.
5684 Interactively, you can set the buffer local value using \\[set-fill-column]. */);
5686 DEFVAR_PER_BUFFER ("left-margin", &BVAR (current_buffer, left_margin),
5687 make_number (Lisp_Int0),
5688 doc: /* Column for the default `indent-line-function' to indent to.
5689 Linefeed indents to this column in Fundamental mode. */);
5691 DEFVAR_PER_BUFFER ("tab-width", &BVAR (current_buffer, tab_width),
5692 make_number (Lisp_Int0),
5693 doc: /* Distance between tab stops (for display of tab characters), in columns.
5694 This should be an integer greater than zero. */);
5696 DEFVAR_PER_BUFFER ("ctl-arrow", &BVAR (current_buffer, ctl_arrow), Qnil,
5697 doc: /* Non-nil means display control chars with uparrow.
5698 A value of nil means use backslash and octal digits.
5699 This variable does not apply to characters whose display is specified
5700 in the current display table (if there is one). */);
5702 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
5703 &BVAR (current_buffer, enable_multibyte_characters),
5704 Qnil,
5705 doc: /* Non-nil means the buffer contents are regarded as multi-byte characters.
5706 Otherwise they are regarded as unibyte. This affects the display,
5707 file I/O and the behavior of various editing commands.
5709 This variable is buffer-local but you cannot set it directly;
5710 use the function `set-buffer-multibyte' to change a buffer's representation.
5711 See also Info node `(elisp)Text Representations'. */);
5712 XSYMBOL (intern_c_string ("enable-multibyte-characters"))->constant = 1;
5714 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
5715 &BVAR (current_buffer, buffer_file_coding_system), Qnil,
5716 doc: /* Coding system to be used for encoding the buffer contents on saving.
5717 This variable applies to saving the buffer, and also to `write-region'
5718 and other functions that use `write-region'.
5719 It does not apply to sending output to subprocesses, however.
5721 If this is nil, the buffer is saved without any code conversion
5722 unless some coding system is specified in `file-coding-system-alist'
5723 for the buffer file.
5725 If the text to be saved cannot be encoded as specified by this variable,
5726 an alternative encoding is selected by `select-safe-coding-system', which see.
5728 The variable `coding-system-for-write', if non-nil, overrides this variable.
5730 This variable is never applied to a way of decoding a file while reading it. */);
5732 DEFVAR_PER_BUFFER ("bidi-display-reordering",
5733 &BVAR (current_buffer, bidi_display_reordering), Qnil,
5734 doc: /* Non-nil means reorder bidirectional text for display in the visual order. */);
5736 DEFVAR_PER_BUFFER ("bidi-paragraph-direction",
5737 &BVAR (current_buffer, bidi_paragraph_direction), Qnil,
5738 doc: /* If non-nil, forces directionality of text paragraphs in the buffer.
5740 If this is nil (the default), the direction of each paragraph is
5741 determined by the first strong directional character of its text.
5742 The values of `right-to-left' and `left-to-right' override that.
5743 Any other value is treated as nil.
5745 This variable has no effect unless the buffer's value of
5746 \`bidi-display-reordering' is non-nil. */);
5748 DEFVAR_PER_BUFFER ("truncate-lines", &BVAR (current_buffer, truncate_lines), Qnil,
5749 doc: /* Non-nil means do not display continuation lines.
5750 Instead, give each line of text just one screen line.
5752 Note that this is overridden by the variable
5753 `truncate-partial-width-windows' if that variable is non-nil
5754 and this buffer is not full-frame width.
5756 Minibuffers set this variable to nil. */);
5758 DEFVAR_PER_BUFFER ("word-wrap", &BVAR (current_buffer, word_wrap), Qnil,
5759 doc: /* Non-nil means to use word-wrapping for continuation lines.
5760 When word-wrapping is on, continuation lines are wrapped at the space
5761 or tab character nearest to the right window edge.
5762 If nil, continuation lines are wrapped at the right screen edge.
5764 This variable has no effect if long lines are truncated (see
5765 `truncate-lines' and `truncate-partial-width-windows'). If you use
5766 word-wrapping, you might want to reduce the value of
5767 `truncate-partial-width-windows', since wrapping can make text readable
5768 in narrower windows.
5770 Instead of setting this variable directly, most users should use
5771 Visual Line mode . Visual Line mode, when enabled, sets `word-wrap'
5772 to t, and additionally redefines simple editing commands to act on
5773 visual lines rather than logical lines. See the documentation of
5774 `visual-line-mode'. */);
5776 DEFVAR_PER_BUFFER ("default-directory", &BVAR (current_buffer, directory),
5777 make_number (Lisp_String),
5778 doc: /* Name of default directory of current buffer. Should end with slash.
5779 To interactively change the default directory, use command `cd'. */);
5781 DEFVAR_PER_BUFFER ("auto-fill-function", &BVAR (current_buffer, auto_fill_function),
5782 Qnil,
5783 doc: /* Function called (if non-nil) to perform auto-fill.
5784 It is called after self-inserting any character specified in
5785 the `auto-fill-chars' table.
5786 NOTE: This variable is not a hook;
5787 its value may not be a list of functions. */);
5789 DEFVAR_PER_BUFFER ("buffer-file-name", &BVAR (current_buffer, filename),
5790 make_number (Lisp_String),
5791 doc: /* Name of file visited in current buffer, or nil if not visiting a file. */);
5793 DEFVAR_PER_BUFFER ("buffer-file-truename", &BVAR (current_buffer, file_truename),
5794 make_number (Lisp_String),
5795 doc: /* Abbreviated truename of file visited in current buffer, or nil if none.
5796 The truename of a file is calculated by `file-truename'
5797 and then abbreviated with `abbreviate-file-name'. */);
5799 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
5800 &BVAR (current_buffer, auto_save_file_name),
5801 make_number (Lisp_String),
5802 doc: /* Name of file for auto-saving current buffer.
5803 If it is nil, that means don't auto-save this buffer. */);
5805 DEFVAR_PER_BUFFER ("buffer-read-only", &BVAR (current_buffer, read_only), Qnil,
5806 doc: /* Non-nil if this buffer is read-only. */);
5808 DEFVAR_PER_BUFFER ("buffer-backed-up", &BVAR (current_buffer, backed_up), Qnil,
5809 doc: /* Non-nil if this buffer's file has been backed up.
5810 Backing up is done before the first time the file is saved. */);
5812 DEFVAR_PER_BUFFER ("buffer-saved-size", &BVAR (current_buffer, save_length),
5813 make_number (Lisp_Int0),
5814 doc: /* Length of current buffer when last read in, saved or auto-saved.
5815 0 initially.
5816 -1 means auto-saving turned off until next real save.
5818 If you set this to -2, that means don't turn off auto-saving in this buffer
5819 if its text size shrinks. If you use `buffer-swap-text' on a buffer,
5820 you probably should set this to -2 in that buffer. */);
5822 DEFVAR_PER_BUFFER ("selective-display", &BVAR (current_buffer, selective_display),
5823 Qnil,
5824 doc: /* Non-nil enables selective display.
5825 An integer N as value means display only lines
5826 that start with less than N columns of space.
5827 A value of t means that the character ^M makes itself and
5828 all the rest of the line invisible; also, when saving the buffer
5829 in a file, save the ^M as a newline. */);
5831 DEFVAR_PER_BUFFER ("selective-display-ellipses",
5832 &BVAR (current_buffer, selective_display_ellipses),
5833 Qnil,
5834 doc: /* Non-nil means display ... on previous line when a line is invisible. */);
5836 DEFVAR_PER_BUFFER ("overwrite-mode", &BVAR (current_buffer, overwrite_mode), Qnil,
5837 doc: /* Non-nil if self-insertion should replace existing text.
5838 The value should be one of `overwrite-mode-textual',
5839 `overwrite-mode-binary', or nil.
5840 If it is `overwrite-mode-textual', self-insertion still
5841 inserts at the end of a line, and inserts when point is before a tab,
5842 until the tab is filled in.
5843 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too. */);
5845 DEFVAR_PER_BUFFER ("buffer-display-table", &BVAR (current_buffer, display_table),
5846 Qnil,
5847 doc: /* Display table that controls display of the contents of current buffer.
5849 If this variable is nil, the value of `standard-display-table' is used.
5850 Each window can have its own, overriding display table, see
5851 `set-window-display-table' and `window-display-table'.
5853 The display table is a char-table created with `make-display-table'.
5854 A char-table is an array indexed by character codes. Normal array
5855 primitives `aref' and `aset' can be used to access elements of a char-table.
5857 Each of the char-table elements control how to display the corresponding
5858 text character: the element at index C in the table says how to display
5859 the character whose code is C. Each element should be a vector of
5860 characters or nil. The value nil means display the character in the
5861 default fashion; otherwise, the characters from the vector are delivered
5862 to the screen instead of the original character.
5864 For example, (aset buffer-display-table ?X [?Y]) tells Emacs
5865 to display a capital Y instead of each X character.
5867 In addition, a char-table has six extra slots to control the display of:
5869 the end of a truncated screen line (extra-slot 0, a single character);
5870 the end of a continued line (extra-slot 1, a single character);
5871 the escape character used to display character codes in octal
5872 (extra-slot 2, a single character);
5873 the character used as an arrow for control characters (extra-slot 3,
5874 a single character);
5875 the decoration indicating the presence of invisible lines (extra-slot 4,
5876 a vector of characters);
5877 the character used to draw the border between side-by-side windows
5878 (extra-slot 5, a single character).
5880 See also the functions `display-table-slot' and `set-display-table-slot'. */);
5882 DEFVAR_PER_BUFFER ("left-margin-width", &BVAR (current_buffer, left_margin_cols),
5883 Qnil,
5884 doc: /* Width of left marginal area for display of a buffer.
5885 A value of nil means no marginal area. */);
5887 DEFVAR_PER_BUFFER ("right-margin-width", &BVAR (current_buffer, right_margin_cols),
5888 Qnil,
5889 doc: /* Width of right marginal area for display of a buffer.
5890 A value of nil means no marginal area. */);
5892 DEFVAR_PER_BUFFER ("left-fringe-width", &BVAR (current_buffer, left_fringe_width),
5893 Qnil,
5894 doc: /* Width of this buffer's left fringe (in pixels).
5895 A value of 0 means no left fringe is shown in this buffer's window.
5896 A value of nil means to use the left fringe width from the window's frame. */);
5898 DEFVAR_PER_BUFFER ("right-fringe-width", &BVAR (current_buffer, right_fringe_width),
5899 Qnil,
5900 doc: /* Width of this buffer's right fringe (in pixels).
5901 A value of 0 means no right fringe is shown in this buffer's window.
5902 A value of nil means to use the right fringe width from the window's frame. */);
5904 DEFVAR_PER_BUFFER ("fringes-outside-margins", &BVAR (current_buffer, fringes_outside_margins),
5905 Qnil,
5906 doc: /* Non-nil means to display fringes outside display margins.
5907 A value of nil means to display fringes between margins and buffer text. */);
5909 DEFVAR_PER_BUFFER ("scroll-bar-width", &BVAR (current_buffer, scroll_bar_width),
5910 Qnil,
5911 doc: /* Width of this buffer's scroll bars in pixels.
5912 A value of nil means to use the scroll bar width from the window's frame. */);
5914 DEFVAR_PER_BUFFER ("vertical-scroll-bar", &BVAR (current_buffer, vertical_scroll_bar_type),
5915 Qnil,
5916 doc: /* Position of this buffer's vertical scroll bar.
5917 The value takes effect whenever you tell a window to display this buffer;
5918 for instance, with `set-window-buffer' or when `display-buffer' displays it.
5920 A value of `left' or `right' means put the vertical scroll bar at that side
5921 of the window; a value of nil means don't show any vertical scroll bars.
5922 A value of t (the default) means do whatever the window's frame specifies. */);
5924 DEFVAR_PER_BUFFER ("indicate-empty-lines",
5925 &BVAR (current_buffer, indicate_empty_lines), Qnil,
5926 doc: /* Visually indicate empty lines after the buffer end.
5927 If non-nil, a bitmap is displayed in the left fringe of a window on
5928 window-systems. */);
5930 DEFVAR_PER_BUFFER ("indicate-buffer-boundaries",
5931 &BVAR (current_buffer, indicate_buffer_boundaries), Qnil,
5932 doc: /* Visually indicate buffer boundaries and scrolling.
5933 If non-nil, the first and last line of the buffer are marked in the fringe
5934 of a window on window-systems with angle bitmaps, or if the window can be
5935 scrolled, the top and bottom line of the window are marked with up and down
5936 arrow bitmaps.
5938 If value is a symbol `left' or `right', both angle and arrow bitmaps
5939 are displayed in the left or right fringe, resp. Any other value
5940 that doesn't look like an alist means display the angle bitmaps in
5941 the left fringe but no arrows.
5943 You can exercise more precise control by using an alist as the
5944 value. Each alist element (INDICATOR . POSITION) specifies
5945 where to show one of the indicators. INDICATOR is one of `top',
5946 `bottom', `up', `down', or t, which specifies the default position,
5947 and POSITION is one of `left', `right', or nil, meaning do not show
5948 this indicator.
5950 For example, ((top . left) (t . right)) places the top angle bitmap in
5951 left fringe, the bottom angle bitmap in right fringe, and both arrow
5952 bitmaps in right fringe. To show just the angle bitmaps in the left
5953 fringe, but no arrow bitmaps, use ((top . left) (bottom . left)). */);
5955 DEFVAR_PER_BUFFER ("fringe-indicator-alist",
5956 &BVAR (current_buffer, fringe_indicator_alist), Qnil,
5957 doc: /* Mapping from logical to physical fringe indicator bitmaps.
5958 The value is an alist where each element (INDICATOR . BITMAPS)
5959 specifies the fringe bitmaps used to display a specific logical
5960 fringe indicator.
5962 INDICATOR specifies the logical indicator type which is one of the
5963 following symbols: `truncation' , `continuation', `overlay-arrow',
5964 `top', `bottom', `top-bottom', `up', `down', empty-line', or `unknown'.
5966 BITMAPS is a list of symbols (LEFT RIGHT [LEFT1 RIGHT1]) which specifies
5967 the actual bitmap shown in the left or right fringe for the logical
5968 indicator. LEFT and RIGHT are the bitmaps shown in the left and/or
5969 right fringe for the specific indicator. The LEFT1 or RIGHT1 bitmaps
5970 are used only for the `bottom' and `top-bottom' indicators when the
5971 last (only) line has no final newline. BITMAPS may also be a single
5972 symbol which is used in both left and right fringes. */);
5974 DEFVAR_PER_BUFFER ("fringe-cursor-alist",
5975 &BVAR (current_buffer, fringe_cursor_alist), Qnil,
5976 doc: /* Mapping from logical to physical fringe cursor bitmaps.
5977 The value is an alist where each element (CURSOR . BITMAP)
5978 specifies the fringe bitmaps used to display a specific logical
5979 cursor type in the fringe.
5981 CURSOR specifies the logical cursor type which is one of the following
5982 symbols: `box' , `hollow', `bar', `hbar', or `hollow-small'. The last
5983 one is used to show a hollow cursor on narrow lines display lines
5984 where the normal hollow cursor will not fit.
5986 BITMAP is the corresponding fringe bitmap shown for the logical
5987 cursor type. */);
5989 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
5990 &BVAR (current_buffer, scroll_up_aggressively), Qnil,
5991 doc: /* How far to scroll windows upward.
5992 If you move point off the bottom, the window scrolls automatically.
5993 This variable controls how far it scrolls. The value nil, the default,
5994 means scroll to center point. A fraction means scroll to put point
5995 that fraction of the window's height from the bottom of the window.
5996 When the value is 0.0, point goes at the bottom line, which in the
5997 simple case that you moved off with C-f means scrolling just one line.
5998 1.0 means point goes at the top, so that in that simple case, the
5999 window scrolls by a full window height. Meaningful values are
6000 between 0.0 and 1.0, inclusive. */);
6002 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
6003 &BVAR (current_buffer, scroll_down_aggressively), Qnil,
6004 doc: /* How far to scroll windows downward.
6005 If you move point off the top, the window scrolls automatically.
6006 This variable controls how far it scrolls. The value nil, the default,
6007 means scroll to center point. A fraction means scroll to put point
6008 that fraction of the window's height from the top of the window.
6009 When the value is 0.0, point goes at the top line, which in the
6010 simple case that you moved off with C-b means scrolling just one line.
6011 1.0 means point goes at the bottom, so that in that simple case, the
6012 window scrolls by a full window height. Meaningful values are
6013 between 0.0 and 1.0, inclusive. */);
6015 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
6016 "Don't ask.");
6019 DEFVAR_LISP ("before-change-functions", Vbefore_change_functions,
6020 doc: /* List of functions to call before each text change.
6021 Two arguments are passed to each function: the positions of
6022 the beginning and end of the range of old text to be changed.
6023 \(For an insertion, the beginning and end are at the same place.)
6024 No information is given about the length of the text after the change.
6026 Buffer changes made while executing the `before-change-functions'
6027 don't call any before-change or after-change functions.
6028 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6030 If an unhandled error happens in running these functions,
6031 the variable's value remains nil. That prevents the error
6032 from happening repeatedly and making Emacs nonfunctional. */);
6033 Vbefore_change_functions = Qnil;
6035 DEFVAR_LISP ("after-change-functions", Vafter_change_functions,
6036 doc: /* List of functions to call after each text change.
6037 Three arguments are passed to each function: the positions of
6038 the beginning and end of the range of changed text,
6039 and the length in bytes of the pre-change text replaced by that range.
6040 \(For an insertion, the pre-change length is zero;
6041 for a deletion, that length is the number of bytes deleted,
6042 and the post-change beginning and end are at the same place.)
6044 Buffer changes made while executing the `after-change-functions'
6045 don't call any before-change or after-change functions.
6046 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6048 If an unhandled error happens in running these functions,
6049 the variable's value remains nil. That prevents the error
6050 from happening repeatedly and making Emacs nonfunctional. */);
6051 Vafter_change_functions = Qnil;
6053 DEFVAR_LISP ("first-change-hook", Vfirst_change_hook,
6054 doc: /* A list of functions to call before changing a buffer which is unmodified.
6055 The functions are run using the `run-hooks' function. */);
6056 Vfirst_change_hook = Qnil;
6058 DEFVAR_PER_BUFFER ("buffer-undo-list", &BVAR (current_buffer, undo_list), Qnil,
6059 doc: /* List of undo entries in current buffer.
6060 Recent changes come first; older changes follow newer.
6062 An entry (BEG . END) represents an insertion which begins at
6063 position BEG and ends at position END.
6065 An entry (TEXT . POSITION) represents the deletion of the string TEXT
6066 from (abs POSITION). If POSITION is positive, point was at the front
6067 of the text being deleted; if negative, point was at the end.
6069 An entry (t HIGH LOW USEC PSEC) indicates that the buffer was previously
6070 unmodified; (HIGH LOW USEC PSEC) is in the same style as (current-time)
6071 and is the visited file's modification time, as of that time. If the
6072 modification time of the most recent save is different, this entry is
6073 obsolete.
6075 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property
6076 was modified between BEG and END. PROPERTY is the property name,
6077 and VALUE is the old value.
6079 An entry (apply FUN-NAME . ARGS) means undo the change with
6080 \(apply FUN-NAME ARGS).
6082 An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo
6083 in the active region. BEG and END is the range affected by this entry
6084 and DELTA is the number of bytes added or deleted in that range by
6085 this change.
6087 An entry (MARKER . DISTANCE) indicates that the marker MARKER
6088 was adjusted in position by the offset DISTANCE (an integer).
6090 An entry of the form POSITION indicates that point was at the buffer
6091 location given by the integer. Undoing an entry of this form places
6092 point at POSITION.
6094 Entries with value `nil' mark undo boundaries. The undo command treats
6095 the changes between two undo boundaries as a single step to be undone.
6097 If the value of the variable is t, undo information is not recorded. */);
6099 DEFVAR_PER_BUFFER ("mark-active", &BVAR (current_buffer, mark_active), Qnil,
6100 doc: /* Non-nil means the mark and region are currently active in this buffer. */);
6102 DEFVAR_PER_BUFFER ("cache-long-line-scans", &BVAR (current_buffer, cache_long_line_scans), Qnil,
6103 doc: /* Non-nil means that Emacs should use caches to handle long lines more quickly.
6105 Normally, the line-motion functions work by scanning the buffer for
6106 newlines. Columnar operations (like `move-to-column' and
6107 `compute-motion') also work by scanning the buffer, summing character
6108 widths as they go. This works well for ordinary text, but if the
6109 buffer's lines are very long (say, more than 500 characters), these
6110 motion functions will take longer to execute. Emacs may also take
6111 longer to update the display.
6113 If `cache-long-line-scans' is non-nil, these motion functions cache the
6114 results of their scans, and consult the cache to avoid rescanning
6115 regions of the buffer until the text is modified. The caches are most
6116 beneficial when they prevent the most searching---that is, when the
6117 buffer contains long lines and large regions of characters with the
6118 same, fixed screen width.
6120 When `cache-long-line-scans' is non-nil, processing short lines will
6121 become slightly slower (because of the overhead of consulting the
6122 cache), and the caches will use memory roughly proportional to the
6123 number of newlines and characters whose screen width varies.
6125 The caches require no explicit maintenance; their accuracy is
6126 maintained internally by the Emacs primitives. Enabling or disabling
6127 the cache should not affect the behavior of any of the motion
6128 functions; it should only affect their performance. */);
6130 DEFVAR_PER_BUFFER ("point-before-scroll", &BVAR (current_buffer, point_before_scroll), Qnil,
6131 doc: /* Value of point before the last series of scroll operations, or nil. */);
6133 DEFVAR_PER_BUFFER ("buffer-file-format", &BVAR (current_buffer, file_format), Qnil,
6134 doc: /* List of formats to use when saving this buffer.
6135 Formats are defined by `format-alist'. This variable is
6136 set when a file is visited. */);
6138 DEFVAR_PER_BUFFER ("buffer-auto-save-file-format",
6139 &BVAR (current_buffer, auto_save_file_format), Qnil,
6140 doc: /* Format in which to write auto-save files.
6141 Should be a list of symbols naming formats that are defined in `format-alist'.
6142 If it is t, which is the default, auto-save files are written in the
6143 same format as a regular save would use. */);
6145 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
6146 &BVAR (current_buffer, invisibility_spec), Qnil,
6147 doc: /* Invisibility spec of this buffer.
6148 The default is t, which means that text is invisible
6149 if it has a non-nil `invisible' property.
6150 If the value is a list, a text character is invisible if its `invisible'
6151 property is an element in that list (or is a list with members in common).
6152 If an element is a cons cell of the form (PROP . ELLIPSIS),
6153 then characters with property value PROP are invisible,
6154 and they have an ellipsis as well if ELLIPSIS is non-nil. */);
6156 DEFVAR_PER_BUFFER ("buffer-display-count",
6157 &BVAR (current_buffer, display_count), Qnil,
6158 doc: /* A number incremented each time this buffer is displayed in a window.
6159 The function `set-window-buffer' increments it. */);
6161 DEFVAR_PER_BUFFER ("buffer-display-time",
6162 &BVAR (current_buffer, display_time), Qnil,
6163 doc: /* Time stamp updated each time this buffer is displayed in a window.
6164 The function `set-window-buffer' updates this variable
6165 to the value obtained by calling `current-time'.
6166 If the buffer has never been shown in a window, the value is nil. */);
6168 DEFVAR_LISP ("transient-mark-mode", Vtransient_mark_mode,
6169 doc: /* Non-nil if Transient Mark mode is enabled.
6170 See the command `transient-mark-mode' for a description of this minor mode.
6172 Non-nil also enables highlighting of the region whenever the mark is active.
6173 The variable `highlight-nonselected-windows' controls whether to highlight
6174 all windows or just the selected window.
6176 Lisp programs may give this variable certain special values:
6178 - A value of `lambda' enables Transient Mark mode temporarily.
6179 It is disabled again after any subsequent action that would
6180 normally deactivate the mark (e.g. buffer modification).
6182 - A value of (only . OLDVAL) enables Transient Mark mode
6183 temporarily. After any subsequent point motion command that is
6184 not shift-translated, or any other action that would normally
6185 deactivate the mark (e.g. buffer modification), the value of
6186 `transient-mark-mode' is set to OLDVAL. */);
6187 Vtransient_mark_mode = Qnil;
6189 DEFVAR_LISP ("inhibit-read-only", Vinhibit_read_only,
6190 doc: /* Non-nil means disregard read-only status of buffers or characters.
6191 If the value is t, disregard `buffer-read-only' and all `read-only'
6192 text properties. If the value is a list, disregard `buffer-read-only'
6193 and disregard a `read-only' text property if the property value
6194 is a member of the list. */);
6195 Vinhibit_read_only = Qnil;
6197 DEFVAR_PER_BUFFER ("cursor-type", &BVAR (current_buffer, cursor_type), Qnil,
6198 doc: /* Cursor to use when this buffer is in the selected window.
6199 Values are interpreted as follows:
6201 t use the cursor specified for the frame
6202 nil don't display a cursor
6203 box display a filled box cursor
6204 hollow display a hollow box cursor
6205 bar display a vertical bar cursor with default width
6206 (bar . WIDTH) display a vertical bar cursor with width WIDTH
6207 hbar display a horizontal bar cursor with default height
6208 (hbar . HEIGHT) display a horizontal bar cursor with height HEIGHT
6209 ANYTHING ELSE display a hollow box cursor
6211 When the buffer is displayed in a non-selected window, the
6212 cursor's appearance is instead controlled by the variable
6213 `cursor-in-non-selected-windows'. */);
6215 DEFVAR_PER_BUFFER ("line-spacing",
6216 &BVAR (current_buffer, extra_line_spacing), Qnil,
6217 doc: /* Additional space to put between lines when displaying a buffer.
6218 The space is measured in pixels, and put below lines on graphic displays,
6219 see `display-graphic-p'.
6220 If value is a floating point number, it specifies the spacing relative
6221 to the default frame line height. A value of nil means add no extra space. */);
6223 DEFVAR_PER_BUFFER ("cursor-in-non-selected-windows",
6224 &BVAR (current_buffer, cursor_in_non_selected_windows), Qnil,
6225 doc: /* Non-nil means show a cursor in non-selected windows.
6226 If nil, only shows a cursor in the selected window.
6227 If t, displays a cursor related to the usual cursor type
6228 \(a solid box becomes hollow, a bar becomes a narrower bar).
6229 You can also specify the cursor type as in the `cursor-type' variable.
6230 Use Custom to set this variable and update the display." */);
6232 DEFVAR_LISP ("kill-buffer-query-functions", Vkill_buffer_query_functions,
6233 doc: /* List of functions called with no args to query before killing a buffer.
6234 The buffer being killed will be current while the functions are running.
6236 If any of them returns nil, the buffer is not killed. Functions run by
6237 this hook are supposed to not change the current buffer. */);
6238 Vkill_buffer_query_functions = Qnil;
6240 DEFVAR_LISP ("change-major-mode-hook", Vchange_major_mode_hook,
6241 doc: /* Normal hook run before changing the major mode of a buffer.
6242 The function `kill-all-local-variables' runs this before doing anything else. */);
6243 Vchange_major_mode_hook = Qnil;
6244 DEFSYM (Qchange_major_mode_hook, "change-major-mode-hook");
6246 DEFVAR_LISP ("buffer-list-update-hook", Vbuffer_list_update_hook,
6247 doc: /* Hook run when the buffer list changes.
6248 Functions running this hook are `get-buffer-create',
6249 `make-indirect-buffer', `rename-buffer', `kill-buffer',
6250 and `bury-buffer-internal'. */);
6251 Vbuffer_list_update_hook = Qnil;
6252 DEFSYM (Qbuffer_list_update_hook, "buffer-list-update-hook");
6254 defsubr (&Sbuffer_live_p);
6255 defsubr (&Sbuffer_list);
6256 defsubr (&Sget_buffer);
6257 defsubr (&Sget_file_buffer);
6258 defsubr (&Sget_buffer_create);
6259 defsubr (&Smake_indirect_buffer);
6260 defsubr (&Sgenerate_new_buffer_name);
6261 defsubr (&Sbuffer_name);
6262 defsubr (&Sbuffer_file_name);
6263 defsubr (&Sbuffer_base_buffer);
6264 defsubr (&Sbuffer_local_value);
6265 defsubr (&Sbuffer_local_variables);
6266 defsubr (&Sbuffer_modified_p);
6267 defsubr (&Sset_buffer_modified_p);
6268 defsubr (&Sbuffer_modified_tick);
6269 defsubr (&Sbuffer_chars_modified_tick);
6270 defsubr (&Srename_buffer);
6271 defsubr (&Sother_buffer);
6272 defsubr (&Sbuffer_enable_undo);
6273 defsubr (&Skill_buffer);
6274 defsubr (&Sbury_buffer_internal);
6275 defsubr (&Sset_buffer_major_mode);
6276 defsubr (&Scurrent_buffer);
6277 defsubr (&Sset_buffer);
6278 defsubr (&Sbarf_if_buffer_read_only);
6279 defsubr (&Serase_buffer);
6280 defsubr (&Sbuffer_swap_text);
6281 defsubr (&Sset_buffer_multibyte);
6282 defsubr (&Skill_all_local_variables);
6284 defsubr (&Soverlayp);
6285 defsubr (&Smake_overlay);
6286 defsubr (&Sdelete_overlay);
6287 defsubr (&Sdelete_all_overlays);
6288 defsubr (&Smove_overlay);
6289 defsubr (&Soverlay_start);
6290 defsubr (&Soverlay_end);
6291 defsubr (&Soverlay_buffer);
6292 defsubr (&Soverlay_properties);
6293 defsubr (&Soverlays_at);
6294 defsubr (&Soverlays_in);
6295 defsubr (&Snext_overlay_change);
6296 defsubr (&Sprevious_overlay_change);
6297 defsubr (&Soverlay_recenter);
6298 defsubr (&Soverlay_lists);
6299 defsubr (&Soverlay_get);
6300 defsubr (&Soverlay_put);
6301 defsubr (&Srestore_buffer_modified_p);
6304 void
6305 keys_of_buffer (void)
6307 initial_define_key (control_x_map, 'b', "switch-to-buffer");
6308 initial_define_key (control_x_map, 'k', "kill-buffer");
6310 /* This must not be in syms_of_buffer, because Qdisabled is not
6311 initialized when that function gets called. */
6312 Fput (intern_c_string ("erase-buffer"), Qdisabled, Qt);