(bootstrap-prepare): Also chmod cal-loaddefs.el.
[emacs.git] / src / buffer.c
blob366f02a6378ebb0deb44d640cc60031471d2a0cb
1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994,
3 1995, 1997, 1998, 1999, 2000, 2001, 2002,
4 2003, 2004, 2005, 2006, 2007, 2008
5 Free Software Foundation, Inc.
7 This file is part of GNU Emacs.
9 GNU Emacs is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3, or (at your option)
12 any later version.
14 GNU Emacs is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with GNU Emacs; see the file COPYING. If not, write to
21 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA. */
24 #include <config.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 #include <sys/param.h>
29 #include <errno.h>
30 #include <stdio.h>
32 #ifndef USE_CRT_DLL
33 extern int errno;
34 #endif
37 #ifdef HAVE_UNISTD_H
38 #include <unistd.h>
39 #endif
41 #include "lisp.h"
42 #include "intervals.h"
43 #include "window.h"
44 #include "commands.h"
45 #include "buffer.h"
46 #include "character.h"
47 #include "region-cache.h"
48 #include "indent.h"
49 #include "blockinput.h"
50 #include "keyboard.h"
51 #include "keymap.h"
52 #include "frame.h"
54 struct buffer *current_buffer; /* the current buffer */
56 /* First buffer in chain of all buffers (in reverse order of creation).
57 Threaded through ->next. */
59 struct buffer *all_buffers;
61 /* This structure holds the default values of the buffer-local variables
62 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
63 The default value occupies the same slot in this structure
64 as an individual buffer's value occupies in that buffer.
65 Setting the default value also goes through the alist of buffers
66 and stores into each buffer that does not say it has a local value. */
68 DECL_ALIGN (struct buffer, buffer_defaults);
70 /* A Lisp_Object pointer to the above, used for staticpro */
72 static Lisp_Object Vbuffer_defaults;
74 /* This structure marks which slots in a buffer have corresponding
75 default values in buffer_defaults.
76 Each such slot has a nonzero value in this structure.
77 The value has only one nonzero bit.
79 When a buffer has its own local value for a slot,
80 the entry for that slot (found in the same slot in this structure)
81 is turned on in the buffer's local_flags array.
83 If a slot in this structure is -1, then even though there may
84 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
85 and the corresponding slot in buffer_defaults is not used.
87 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
88 but there is a default value which is copied into each buffer.
90 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
91 zero, that is a bug */
93 struct buffer buffer_local_flags;
95 /* This structure holds the names of symbols whose values may be
96 buffer-local. It is indexed and accessed in the same way as the above. */
98 DECL_ALIGN (struct buffer, buffer_local_symbols);
100 /* A Lisp_Object pointer to the above, used for staticpro */
101 static Lisp_Object Vbuffer_local_symbols;
103 /* Flags indicating which built-in buffer-local variables
104 are permanent locals. */
105 static char buffer_permanent_local_flags[MAX_PER_BUFFER_VARS];
107 /* Number of per-buffer variables used. */
109 int last_per_buffer_idx;
111 EXFUN (Fset_buffer, 1);
112 void set_buffer_internal P_ ((struct buffer *b));
113 void set_buffer_internal_1 P_ ((struct buffer *b));
114 static void call_overlay_mod_hooks P_ ((Lisp_Object list, Lisp_Object overlay,
115 int after, Lisp_Object arg1,
116 Lisp_Object arg2, Lisp_Object arg3));
117 static void swap_out_buffer_local_variables P_ ((struct buffer *b));
118 static void reset_buffer_local_variables P_ ((struct buffer *b, int permanent_too));
120 /* Alist of all buffer names vs the buffers. */
121 /* This used to be a variable, but is no longer,
122 to prevent lossage due to user rplac'ing this alist or its elements. */
123 Lisp_Object Vbuffer_alist;
125 /* Functions to call before and after each text change. */
126 Lisp_Object Vbefore_change_functions;
127 Lisp_Object Vafter_change_functions;
129 Lisp_Object Vtransient_mark_mode;
131 /* t means ignore all read-only text properties.
132 A list means ignore such a property if its value is a member of the list.
133 Any non-nil value means ignore buffer-read-only. */
134 Lisp_Object Vinhibit_read_only;
136 /* List of functions to call that can query about killing a buffer.
137 If any of these functions returns nil, we don't kill it. */
138 Lisp_Object Vkill_buffer_query_functions;
139 Lisp_Object Qkill_buffer_query_functions;
141 /* Hook run before changing a major mode. */
142 Lisp_Object Vchange_major_mode_hook, Qchange_major_mode_hook;
144 /* List of functions to call before changing an unmodified buffer. */
145 Lisp_Object Vfirst_change_hook;
147 Lisp_Object Qfirst_change_hook;
148 Lisp_Object Qbefore_change_functions;
149 Lisp_Object Qafter_change_functions;
150 Lisp_Object Qucs_set_table_for_input;
152 /* If nonzero, all modification hooks are suppressed. */
153 int inhibit_modification_hooks;
155 Lisp_Object Qfundamental_mode, Qmode_class, Qpermanent_local;
156 Lisp_Object Qpermanent_local_hook;
158 Lisp_Object Qprotected_field;
160 Lisp_Object QSFundamental; /* A string "Fundamental" */
162 Lisp_Object Qkill_buffer_hook;
164 Lisp_Object Qget_file_buffer;
166 Lisp_Object Qoverlayp;
168 Lisp_Object Qpriority, Qwindow, Qevaporate, Qbefore_string, Qafter_string;
170 Lisp_Object Qmodification_hooks;
171 Lisp_Object Qinsert_in_front_hooks;
172 Lisp_Object Qinsert_behind_hooks;
174 static void alloc_buffer_text P_ ((struct buffer *, size_t));
175 static void free_buffer_text P_ ((struct buffer *b));
176 static struct Lisp_Overlay * copy_overlays P_ ((struct buffer *, struct Lisp_Overlay *));
177 static void modify_overlay P_ ((struct buffer *, EMACS_INT, EMACS_INT));
178 static Lisp_Object buffer_lisp_local_variables P_ ((struct buffer *));
180 extern char * emacs_strerror P_ ((int));
182 /* For debugging; temporary. See set_buffer_internal. */
183 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
185 void
186 nsberror (spec)
187 Lisp_Object spec;
189 if (STRINGP (spec))
190 error ("No buffer named %s", SDATA (spec));
191 error ("Invalid buffer argument");
194 DEFUN ("buffer-live-p", Fbuffer_live_p, Sbuffer_live_p, 1, 1, 0,
195 doc: /* Return non-nil if OBJECT is a buffer which has not been killed.
196 Value is nil if OBJECT is not a buffer or if it has been killed. */)
197 (object)
198 Lisp_Object object;
200 return ((BUFFERP (object) && ! NILP (XBUFFER (object)->name))
201 ? Qt : Qnil);
204 DEFUN ("buffer-list", Fbuffer_list, Sbuffer_list, 0, 1, 0,
205 doc: /* Return a list of all existing live buffers.
206 If the optional arg FRAME is a frame, we return the buffer list
207 in the proper order for that frame: the buffers in FRAME's `buffer-list'
208 frame parameter come first, followed by the rest of the buffers. */)
209 (frame)
210 Lisp_Object frame;
212 Lisp_Object general;
213 general = Fmapcar (Qcdr, Vbuffer_alist);
215 if (FRAMEP (frame))
217 Lisp_Object framelist, prevlist, tail;
218 Lisp_Object args[3];
220 CHECK_FRAME (frame);
222 framelist = Fcopy_sequence (XFRAME (frame)->buffer_list);
223 prevlist = Fnreverse (Fcopy_sequence (XFRAME (frame)->buried_buffer_list));
225 /* Remove from GENERAL any buffer that duplicates one in
226 FRAMELIST or PREVLIST. */
227 tail = framelist;
228 while (CONSP (tail))
230 general = Fdelq (XCAR (tail), general);
231 tail = XCDR (tail);
233 tail = prevlist;
234 while (CONSP (tail))
236 general = Fdelq (XCAR (tail), general);
237 tail = XCDR (tail);
240 args[0] = framelist;
241 args[1] = general;
242 args[2] = prevlist;
243 return Fnconc (3, args);
246 return general;
249 /* Like Fassoc, but use Fstring_equal to compare
250 (which ignores text properties),
251 and don't ever QUIT. */
253 static Lisp_Object
254 assoc_ignore_text_properties (key, list)
255 register Lisp_Object key;
256 Lisp_Object list;
258 register Lisp_Object tail;
259 for (tail = list; CONSP (tail); tail = XCDR (tail))
261 register Lisp_Object elt, tem;
262 elt = XCAR (tail);
263 tem = Fstring_equal (Fcar (elt), key);
264 if (!NILP (tem))
265 return elt;
267 return Qnil;
270 DEFUN ("get-buffer", Fget_buffer, Sget_buffer, 1, 1, 0,
271 doc: /* Return the buffer named NAME (a string).
272 If there is no live buffer named NAME, return nil.
273 NAME may also be a buffer; if so, the value is that buffer. */)
274 (name)
275 register Lisp_Object name;
277 if (BUFFERP (name))
278 return name;
279 CHECK_STRING (name);
281 return Fcdr (assoc_ignore_text_properties (name, Vbuffer_alist));
284 DEFUN ("get-file-buffer", Fget_file_buffer, Sget_file_buffer, 1, 1, 0,
285 doc: /* Return the buffer visiting file FILENAME (a string).
286 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.
287 If there is no such live buffer, return nil.
288 See also `find-buffer-visiting'. */)
289 (filename)
290 register Lisp_Object filename;
292 register Lisp_Object tail, buf, tem;
293 Lisp_Object handler;
295 CHECK_STRING (filename);
296 filename = Fexpand_file_name (filename, Qnil);
298 /* If the file name has special constructs in it,
299 call the corresponding file handler. */
300 handler = Ffind_file_name_handler (filename, Qget_file_buffer);
301 if (!NILP (handler))
302 return call2 (handler, Qget_file_buffer, filename);
304 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
306 buf = Fcdr (XCAR (tail));
307 if (!BUFFERP (buf)) continue;
308 if (!STRINGP (XBUFFER (buf)->filename)) continue;
309 tem = Fstring_equal (XBUFFER (buf)->filename, filename);
310 if (!NILP (tem))
311 return buf;
313 return Qnil;
316 Lisp_Object
317 get_truename_buffer (filename)
318 register Lisp_Object filename;
320 register Lisp_Object tail, buf, tem;
322 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
324 buf = Fcdr (XCAR (tail));
325 if (!BUFFERP (buf)) continue;
326 if (!STRINGP (XBUFFER (buf)->file_truename)) continue;
327 tem = Fstring_equal (XBUFFER (buf)->file_truename, filename);
328 if (!NILP (tem))
329 return buf;
331 return Qnil;
334 /* Incremented for each buffer created, to assign the buffer number. */
335 int buffer_count;
337 DEFUN ("get-buffer-create", Fget_buffer_create, Sget_buffer_create, 1, 1, 0,
338 doc: /* Return the buffer named NAME, or create such a buffer and return it.
339 A new buffer is created if there is no live buffer named NAME.
340 If NAME starts with a space, the new buffer does not keep undo information.
341 If NAME is a buffer instead of a string, then it is the value returned.
342 The value is never nil. */)
343 (name)
344 register Lisp_Object name;
346 register Lisp_Object buf;
347 register struct buffer *b;
349 buf = Fget_buffer (name);
350 if (!NILP (buf))
351 return buf;
353 if (SCHARS (name) == 0)
354 error ("Empty string for buffer name is not allowed");
356 b = allocate_buffer ();
358 /* An ordinary buffer uses its own struct buffer_text. */
359 b->text = &b->own_text;
360 b->base_buffer = 0;
362 BUF_GAP_SIZE (b) = 20;
363 BLOCK_INPUT;
364 /* We allocate extra 1-byte at the tail and keep it always '\0' for
365 anchoring a search. */
366 alloc_buffer_text (b, BUF_GAP_SIZE (b) + 1);
367 UNBLOCK_INPUT;
368 if (! BUF_BEG_ADDR (b))
369 buffer_memory_full ();
371 BUF_PT (b) = BEG;
372 BUF_GPT (b) = BEG;
373 BUF_BEGV (b) = BEG;
374 BUF_ZV (b) = BEG;
375 BUF_Z (b) = BEG;
376 BUF_PT_BYTE (b) = BEG_BYTE;
377 BUF_GPT_BYTE (b) = BEG_BYTE;
378 BUF_BEGV_BYTE (b) = BEG_BYTE;
379 BUF_ZV_BYTE (b) = BEG_BYTE;
380 BUF_Z_BYTE (b) = BEG_BYTE;
381 BUF_MODIFF (b) = 1;
382 BUF_CHARS_MODIFF (b) = 1;
383 BUF_OVERLAY_MODIFF (b) = 1;
384 BUF_SAVE_MODIFF (b) = 1;
385 BUF_INTERVALS (b) = 0;
386 BUF_UNCHANGED_MODIFIED (b) = 1;
387 BUF_OVERLAY_UNCHANGED_MODIFIED (b) = 1;
388 BUF_END_UNCHANGED (b) = 0;
389 BUF_BEG_UNCHANGED (b) = 0;
390 *(BUF_GPT_ADDR (b)) = *(BUF_Z_ADDR (b)) = 0; /* Put an anchor '\0'. */
392 b->newline_cache = 0;
393 b->width_run_cache = 0;
394 b->width_table = Qnil;
395 b->prevent_redisplay_optimizations_p = 1;
397 /* Put this on the chain of all buffers including killed ones. */
398 b->next = all_buffers;
399 all_buffers = b;
401 /* An ordinary buffer normally doesn't need markers
402 to handle BEGV and ZV. */
403 b->pt_marker = Qnil;
404 b->begv_marker = Qnil;
405 b->zv_marker = Qnil;
407 name = Fcopy_sequence (name);
408 STRING_SET_INTERVALS (name, NULL_INTERVAL);
409 b->name = name;
411 b->undo_list = (SREF (name, 0) != ' ') ? Qnil : Qt;
413 reset_buffer (b);
414 reset_buffer_local_variables (b, 1);
416 b->mark = Fmake_marker ();
417 BUF_MARKERS (b) = NULL;
418 b->name = name;
420 /* Put this in the alist of all live buffers. */
421 XSETBUFFER (buf, b);
422 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
424 /* An error in calling the function here (should someone redefine it)
425 can lead to infinite regress until you run out of stack. rms
426 says that's not worth protecting against. */
427 if (!NILP (Ffboundp (Qucs_set_table_for_input)))
428 /* buf is on buffer-alist, so no gcpro. */
429 call1 (Qucs_set_table_for_input, buf);
431 return buf;
435 /* Return a list of overlays which is a copy of the overlay list
436 LIST, but for buffer B. */
438 static struct Lisp_Overlay *
439 copy_overlays (b, list)
440 struct buffer *b;
441 struct Lisp_Overlay *list;
443 Lisp_Object buffer;
444 struct Lisp_Overlay *result = NULL, *tail = NULL;
446 XSETBUFFER (buffer, b);
448 for (; list; list = list->next)
450 Lisp_Object overlay, start, end, old_overlay;
451 EMACS_INT charpos;
453 XSETMISC (old_overlay, list);
454 charpos = marker_position (OVERLAY_START (old_overlay));
455 start = Fmake_marker ();
456 Fset_marker (start, make_number (charpos), buffer);
457 XMARKER (start)->insertion_type
458 = XMARKER (OVERLAY_START (old_overlay))->insertion_type;
460 charpos = marker_position (OVERLAY_END (old_overlay));
461 end = Fmake_marker ();
462 Fset_marker (end, make_number (charpos), buffer);
463 XMARKER (end)->insertion_type
464 = XMARKER (OVERLAY_END (old_overlay))->insertion_type;
466 overlay = allocate_misc ();
467 XMISCTYPE (overlay) = Lisp_Misc_Overlay;
468 OVERLAY_START (overlay) = start;
469 OVERLAY_END (overlay) = end;
470 OVERLAY_PLIST (overlay) = Fcopy_sequence (OVERLAY_PLIST (old_overlay));
471 XOVERLAY (overlay)->next = NULL;
473 if (tail)
474 tail = tail->next = XOVERLAY (overlay);
475 else
476 result = tail = XOVERLAY (overlay);
479 return result;
483 /* Clone per-buffer values of buffer FROM.
485 Buffer TO gets the same per-buffer values as FROM, with the
486 following exceptions: (1) TO's name is left untouched, (2) markers
487 are copied and made to refer to TO, and (3) overlay lists are
488 copied. */
490 static void
491 clone_per_buffer_values (from, to)
492 struct buffer *from, *to;
494 Lisp_Object to_buffer;
495 int offset;
497 XSETBUFFER (to_buffer, to);
499 /* buffer-local Lisp variables start at `undo_list',
500 tho only the ones from `name' on are GC'd normally. */
501 for (offset = PER_BUFFER_VAR_OFFSET (undo_list) + sizeof (Lisp_Object);
502 offset < sizeof *to;
503 offset += sizeof (Lisp_Object))
505 Lisp_Object obj;
507 obj = PER_BUFFER_VALUE (from, offset);
508 if (MARKERP (obj))
510 struct Lisp_Marker *m = XMARKER (obj);
511 obj = Fmake_marker ();
512 XMARKER (obj)->insertion_type = m->insertion_type;
513 set_marker_both (obj, to_buffer, m->charpos, m->bytepos);
516 PER_BUFFER_VALUE (to, offset) = obj;
519 bcopy (from->local_flags, to->local_flags, sizeof to->local_flags);
521 to->overlays_before = copy_overlays (to, from->overlays_before);
522 to->overlays_after = copy_overlays (to, from->overlays_after);
524 /* Get (a copy of) the alist of Lisp-level local variables of FROM
525 and install that in TO. */
526 to->local_var_alist = buffer_lisp_local_variables (from);
529 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer, Smake_indirect_buffer,
530 2, 3,
531 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
532 doc: /* Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.
533 BASE-BUFFER should be a live buffer, or the name of an existing buffer.
534 NAME should be a string which is not the name of an existing buffer.
535 Optional argument CLONE non-nil means preserve BASE-BUFFER's state,
536 such as major and minor modes, in the indirect buffer.
537 CLONE nil means the indirect buffer's state is reset to default values. */)
538 (base_buffer, name, clone)
539 Lisp_Object base_buffer, name, clone;
541 Lisp_Object buf, tem;
542 struct buffer *b;
544 CHECK_STRING (name);
545 buf = Fget_buffer (name);
546 if (!NILP (buf))
547 error ("Buffer name `%s' is in use", SDATA (name));
549 tem = base_buffer;
550 base_buffer = Fget_buffer (base_buffer);
551 if (NILP (base_buffer))
552 error ("No such buffer: `%s'", SDATA (tem));
553 if (NILP (XBUFFER (base_buffer)->name))
554 error ("Base buffer has been killed");
556 if (SCHARS (name) == 0)
557 error ("Empty string for buffer name is not allowed");
559 b = allocate_buffer ();
561 b->base_buffer = (XBUFFER (base_buffer)->base_buffer
562 ? XBUFFER (base_buffer)->base_buffer
563 : XBUFFER (base_buffer));
565 /* Use the base buffer's text object. */
566 b->text = b->base_buffer->text;
568 BUF_BEGV (b) = BUF_BEGV (b->base_buffer);
569 BUF_ZV (b) = BUF_ZV (b->base_buffer);
570 BUF_PT (b) = BUF_PT (b->base_buffer);
571 BUF_BEGV_BYTE (b) = BUF_BEGV_BYTE (b->base_buffer);
572 BUF_ZV_BYTE (b) = BUF_ZV_BYTE (b->base_buffer);
573 BUF_PT_BYTE (b) = BUF_PT_BYTE (b->base_buffer);
575 b->newline_cache = 0;
576 b->width_run_cache = 0;
577 b->width_table = Qnil;
579 /* Put this on the chain of all buffers including killed ones. */
580 b->next = all_buffers;
581 all_buffers = b;
583 name = Fcopy_sequence (name);
584 STRING_SET_INTERVALS (name, NULL_INTERVAL);
585 b->name = name;
587 reset_buffer (b);
588 reset_buffer_local_variables (b, 1);
590 /* Put this in the alist of all live buffers. */
591 XSETBUFFER (buf, b);
592 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
594 b->mark = Fmake_marker ();
595 b->name = name;
597 /* The multibyte status belongs to the base buffer. */
598 b->enable_multibyte_characters = b->base_buffer->enable_multibyte_characters;
600 /* Make sure the base buffer has markers for its narrowing. */
601 if (NILP (b->base_buffer->pt_marker))
603 b->base_buffer->pt_marker = Fmake_marker ();
604 set_marker_both (b->base_buffer->pt_marker, base_buffer,
605 BUF_PT (b->base_buffer),
606 BUF_PT_BYTE (b->base_buffer));
608 if (NILP (b->base_buffer->begv_marker))
610 b->base_buffer->begv_marker = Fmake_marker ();
611 set_marker_both (b->base_buffer->begv_marker, base_buffer,
612 BUF_BEGV (b->base_buffer),
613 BUF_BEGV_BYTE (b->base_buffer));
615 if (NILP (b->base_buffer->zv_marker))
617 b->base_buffer->zv_marker = Fmake_marker ();
618 set_marker_both (b->base_buffer->zv_marker, base_buffer,
619 BUF_ZV (b->base_buffer),
620 BUF_ZV_BYTE (b->base_buffer));
621 XMARKER (b->base_buffer->zv_marker)->insertion_type = 1;
624 if (NILP (clone))
626 /* Give the indirect buffer markers for its narrowing. */
627 b->pt_marker = Fmake_marker ();
628 set_marker_both (b->pt_marker, buf, BUF_PT (b), BUF_PT_BYTE (b));
629 b->begv_marker = Fmake_marker ();
630 set_marker_both (b->begv_marker, buf, BUF_BEGV (b), BUF_BEGV_BYTE (b));
631 b->zv_marker = Fmake_marker ();
632 set_marker_both (b->zv_marker, buf, BUF_ZV (b), BUF_ZV_BYTE (b));
633 XMARKER (b->zv_marker)->insertion_type = 1;
635 else
637 struct buffer *old_b = current_buffer;
639 clone_per_buffer_values (b->base_buffer, b);
640 b->filename = Qnil;
641 b->file_truename = Qnil;
642 b->display_count = make_number (0);
643 b->backed_up = Qnil;
644 b->auto_save_file_name = Qnil;
645 set_buffer_internal_1 (b);
646 Fset (intern ("buffer-save-without-query"), Qnil);
647 Fset (intern ("buffer-file-number"), Qnil);
648 Fset (intern ("buffer-stale-function"), Qnil);
649 set_buffer_internal_1 (old_b);
652 return buf;
655 void
656 delete_all_overlays (b)
657 struct buffer *b;
659 Lisp_Object overlay;
661 /* `reset_buffer' blindly sets the list of overlays to NULL, so we
662 have to empty the list, otherwise we end up with overlays that
663 think they belong to this buffer while the buffer doesn't know about
664 them any more. */
665 while (b->overlays_before)
667 XSETMISC (overlay, b->overlays_before);
668 Fdelete_overlay (overlay);
670 while (b->overlays_after)
672 XSETMISC (overlay, b->overlays_after);
673 Fdelete_overlay (overlay);
675 eassert (b->overlays_before == NULL);
676 eassert (b->overlays_after == NULL);
679 /* Reinitialize everything about a buffer except its name and contents
680 and local variables.
681 If called on an already-initialized buffer, the list of overlays
682 should be deleted before calling this function, otherwise we end up
683 with overlays that claim to belong to the buffer but the buffer
684 claims it doesn't belong to it. */
686 void
687 reset_buffer (b)
688 register struct buffer *b;
690 b->filename = Qnil;
691 b->file_truename = Qnil;
692 b->directory = (current_buffer) ? current_buffer->directory : Qnil;
693 b->modtime = 0;
694 XSETFASTINT (b->save_length, 0);
695 b->last_window_start = 1;
696 /* It is more conservative to start out "changed" than "unchanged". */
697 b->clip_changed = 0;
698 b->prevent_redisplay_optimizations_p = 1;
699 b->backed_up = Qnil;
700 b->auto_save_modified = 0;
701 b->auto_save_failure_time = -1;
702 b->auto_save_file_name = Qnil;
703 b->read_only = Qnil;
704 b->overlays_before = NULL;
705 b->overlays_after = NULL;
706 b->overlay_center = BEG;
707 b->mark_active = Qnil;
708 b->point_before_scroll = Qnil;
709 b->file_format = Qnil;
710 b->auto_save_file_format = Qt;
711 b->last_selected_window = Qnil;
712 XSETINT (b->display_count, 0);
713 b->display_time = Qnil;
714 b->enable_multibyte_characters = buffer_defaults.enable_multibyte_characters;
715 b->cursor_type = buffer_defaults.cursor_type;
716 b->extra_line_spacing = buffer_defaults.extra_line_spacing;
718 b->display_error_modiff = 0;
721 /* Reset buffer B's local variables info.
722 Don't use this on a buffer that has already been in use;
723 it does not treat permanent locals consistently.
724 Instead, use Fkill_all_local_variables.
726 If PERMANENT_TOO is 1, then we reset permanent
727 buffer-local variables. If PERMANENT_TOO is 0,
728 we preserve those. */
730 static void
731 reset_buffer_local_variables (b, permanent_too)
732 register struct buffer *b;
733 int permanent_too;
735 register int offset;
736 int i;
738 /* Reset the major mode to Fundamental, together with all the
739 things that depend on the major mode.
740 default-major-mode is handled at a higher level.
741 We ignore it here. */
742 b->major_mode = Qfundamental_mode;
743 b->keymap = Qnil;
744 b->mode_name = QSFundamental;
745 b->minor_modes = Qnil;
747 /* If the standard case table has been altered and invalidated,
748 fix up its insides first. */
749 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[0])
750 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[1])
751 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[2])))
752 Fset_standard_case_table (Vascii_downcase_table);
754 b->downcase_table = Vascii_downcase_table;
755 b->upcase_table = XCHAR_TABLE (Vascii_downcase_table)->extras[0];
756 b->case_canon_table = XCHAR_TABLE (Vascii_downcase_table)->extras[1];
757 b->case_eqv_table = XCHAR_TABLE (Vascii_downcase_table)->extras[2];
758 b->invisibility_spec = Qt;
759 #ifndef DOS_NT
760 b->buffer_file_type = Qnil;
761 #endif
763 /* Reset all (or most) per-buffer variables to their defaults. */
764 if (permanent_too)
765 b->local_var_alist = Qnil;
766 else
768 Lisp_Object tmp, prop, last = Qnil;
769 for (tmp = b->local_var_alist; CONSP (tmp); tmp = XCDR (tmp))
770 if (CONSP (XCAR (tmp))
771 && SYMBOLP (XCAR (XCAR (tmp)))
772 && !NILP (prop = Fget (XCAR (XCAR (tmp)), Qpermanent_local)))
774 /* If permanent-local, keep it. */
775 last = tmp;
776 if (EQ (prop, Qpermanent_local_hook))
778 /* This is a partially permanent hook variable.
779 Preserve only the elements that want to be preserved. */
780 Lisp_Object list, newlist;
781 list = XCDR (XCAR (tmp));
782 if (!CONSP (list))
783 newlist = list;
784 else
785 for (newlist = Qnil; CONSP (list); list = XCDR (list))
787 Lisp_Object elt = XCAR (list);
788 /* Preserve element ELT if it's t,
789 if it is a function with a `permanent-local-hook' property,
790 or if it's not a symbol. */
791 if (! SYMBOLP (elt)
792 || EQ (elt, Qt)
793 || !NILP (Fget (elt, Qpermanent_local_hook)))
794 newlist = Fcons (elt, newlist);
796 XSETCDR (XCAR (tmp), Fnreverse (newlist));
799 /* Delete this local variable. */
800 else if (NILP (last))
801 b->local_var_alist = XCDR (tmp);
802 else
803 XSETCDR (last, XCDR (tmp));
806 for (i = 0; i < last_per_buffer_idx; ++i)
807 if (permanent_too || buffer_permanent_local_flags[i] == 0)
808 SET_PER_BUFFER_VALUE_P (b, i, 0);
810 /* For each slot that has a default value,
811 copy that into the slot. */
813 /* buffer-local Lisp variables start at `undo_list',
814 tho only the ones from `name' on are GC'd normally. */
815 for (offset = PER_BUFFER_VAR_OFFSET (undo_list);
816 offset < sizeof *b;
817 offset += sizeof (Lisp_Object))
819 int idx = PER_BUFFER_IDX (offset);
820 if ((idx > 0
821 && (permanent_too
822 || buffer_permanent_local_flags[idx] == 0))
823 /* Is -2 used anywhere? */
824 || idx == -2)
825 PER_BUFFER_VALUE (b, offset) = PER_BUFFER_DEFAULT (offset);
829 /* We split this away from generate-new-buffer, because rename-buffer
830 and set-visited-file-name ought to be able to use this to really
831 rename the buffer properly. */
833 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name, Sgenerate_new_buffer_name,
834 1, 2, 0,
835 doc: /* Return a string that is the name of no existing buffer based on NAME.
836 If there is no live buffer named NAME, then return NAME.
837 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
838 \(starting at 2) until an unused name is found, and then return that name.
839 Optional second argument IGNORE specifies a name that is okay to use (if
840 it is in the sequence to be tried) even if a buffer with that name exists. */)
841 (name, ignore)
842 register Lisp_Object name, ignore;
844 register Lisp_Object gentemp, tem;
845 int count;
846 char number[10];
848 CHECK_STRING (name);
850 tem = Fstring_equal (name, ignore);
851 if (!NILP (tem))
852 return name;
853 tem = Fget_buffer (name);
854 if (NILP (tem))
855 return name;
857 count = 1;
858 while (1)
860 sprintf (number, "<%d>", ++count);
861 gentemp = concat2 (name, build_string (number));
862 tem = Fstring_equal (gentemp, ignore);
863 if (!NILP (tem))
864 return gentemp;
865 tem = Fget_buffer (gentemp);
866 if (NILP (tem))
867 return gentemp;
872 DEFUN ("buffer-name", Fbuffer_name, Sbuffer_name, 0, 1, 0,
873 doc: /* Return the name of BUFFER, as a string.
874 With no argument or nil as argument, return the name of the current buffer. */)
875 (buffer)
876 register Lisp_Object buffer;
878 if (NILP (buffer))
879 return current_buffer->name;
880 CHECK_BUFFER (buffer);
881 return XBUFFER (buffer)->name;
884 DEFUN ("buffer-file-name", Fbuffer_file_name, Sbuffer_file_name, 0, 1, 0,
885 doc: /* Return name of file BUFFER is visiting, or nil if none.
886 No argument or nil as argument means use the current buffer. */)
887 (buffer)
888 register Lisp_Object buffer;
890 if (NILP (buffer))
891 return current_buffer->filename;
892 CHECK_BUFFER (buffer);
893 return XBUFFER (buffer)->filename;
896 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer, Sbuffer_base_buffer,
897 0, 1, 0,
898 doc: /* Return the base buffer of indirect buffer BUFFER.
899 If BUFFER is not indirect, return nil.
900 BUFFER defaults to the current buffer. */)
901 (buffer)
902 register Lisp_Object buffer;
904 struct buffer *base;
905 Lisp_Object base_buffer;
907 if (NILP (buffer))
908 base = current_buffer->base_buffer;
909 else
911 CHECK_BUFFER (buffer);
912 base = XBUFFER (buffer)->base_buffer;
915 if (! base)
916 return Qnil;
917 XSETBUFFER (base_buffer, base);
918 return base_buffer;
921 DEFUN ("buffer-local-value", Fbuffer_local_value,
922 Sbuffer_local_value, 2, 2, 0,
923 doc: /* Return the value of VARIABLE in BUFFER.
924 If VARIABLE does not have a buffer-local binding in BUFFER, the value
925 is the default binding of the variable. */)
926 (variable, buffer)
927 register Lisp_Object variable;
928 register Lisp_Object buffer;
930 register struct buffer *buf;
931 register Lisp_Object result;
933 CHECK_SYMBOL (variable);
934 CHECK_BUFFER (buffer);
935 buf = XBUFFER (buffer);
937 variable = indirect_variable (variable);
939 /* Look in local_var_list */
940 result = Fassoc (variable, buf->local_var_alist);
941 if (NILP (result))
943 int offset, idx;
944 int found = 0;
946 /* Look in special slots */
947 /* buffer-local Lisp variables start at `undo_list',
948 tho only the ones from `name' on are GC'd normally. */
949 for (offset = PER_BUFFER_VAR_OFFSET (undo_list);
950 offset < sizeof (struct buffer);
951 /* sizeof EMACS_INT == sizeof Lisp_Object */
952 offset += (sizeof (EMACS_INT)))
954 idx = PER_BUFFER_IDX (offset);
955 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
956 && SYMBOLP (PER_BUFFER_SYMBOL (offset))
957 && EQ (PER_BUFFER_SYMBOL (offset), variable))
959 result = PER_BUFFER_VALUE (buf, offset);
960 found = 1;
961 break;
965 if (!found)
966 result = Fdefault_value (variable);
968 else
970 Lisp_Object valcontents;
971 Lisp_Object current_alist_element;
973 /* What binding is loaded right now? */
974 valcontents = SYMBOL_VALUE (variable);
975 current_alist_element
976 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
978 /* The value of the currently loaded binding is not
979 stored in it, but rather in the realvalue slot.
980 Store that value into the binding it belongs to
981 in case that is the one we are about to use. */
983 Fsetcdr (current_alist_element,
984 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
986 /* Now get the (perhaps updated) value out of the binding. */
987 result = XCDR (result);
990 if (!EQ (result, Qunbound))
991 return result;
993 xsignal1 (Qvoid_variable, variable);
996 /* Return an alist of the Lisp-level buffer-local bindings of
997 buffer BUF. That is, don't include the variables maintained
998 in special slots in the buffer object. */
1000 static Lisp_Object
1001 buffer_lisp_local_variables (buf)
1002 struct buffer *buf;
1004 Lisp_Object result = Qnil;
1005 register Lisp_Object tail;
1006 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1008 Lisp_Object val, elt;
1010 elt = XCAR (tail);
1012 /* Reference each variable in the alist in buf.
1013 If inquiring about the current buffer, this gets the current values,
1014 so store them into the alist so the alist is up to date.
1015 If inquiring about some other buffer, this swaps out any values
1016 for that buffer, making the alist up to date automatically. */
1017 val = find_symbol_value (XCAR (elt));
1018 /* Use the current buffer value only if buf is the current buffer. */
1019 if (buf != current_buffer)
1020 val = XCDR (elt);
1022 /* If symbol is unbound, put just the symbol in the list. */
1023 if (EQ (val, Qunbound))
1024 result = Fcons (XCAR (elt), result);
1025 /* Otherwise, put (symbol . value) in the list. */
1026 else
1027 result = Fcons (Fcons (XCAR (elt), val), result);
1030 return result;
1033 DEFUN ("buffer-local-variables", Fbuffer_local_variables,
1034 Sbuffer_local_variables, 0, 1, 0,
1035 doc: /* Return an alist of variables that are buffer-local in BUFFER.
1036 Most elements look like (SYMBOL . VALUE), describing one variable.
1037 For a symbol that is locally unbound, just the symbol appears in the value.
1038 Note that storing new VALUEs in these elements doesn't change the variables.
1039 No argument or nil as argument means use current buffer as BUFFER. */)
1040 (buffer)
1041 register Lisp_Object buffer;
1043 register struct buffer *buf;
1044 register Lisp_Object result;
1046 if (NILP (buffer))
1047 buf = current_buffer;
1048 else
1050 CHECK_BUFFER (buffer);
1051 buf = XBUFFER (buffer);
1054 result = buffer_lisp_local_variables (buf);
1056 /* Add on all the variables stored in special slots. */
1058 int offset, idx;
1060 /* buffer-local Lisp variables start at `undo_list',
1061 tho only the ones from `name' on are GC'd normally. */
1062 for (offset = PER_BUFFER_VAR_OFFSET (undo_list);
1063 offset < sizeof (struct buffer);
1064 /* sizeof EMACS_INT == sizeof Lisp_Object */
1065 offset += (sizeof (EMACS_INT)))
1067 idx = PER_BUFFER_IDX (offset);
1068 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1069 && SYMBOLP (PER_BUFFER_SYMBOL (offset)))
1070 result = Fcons (Fcons (PER_BUFFER_SYMBOL (offset),
1071 PER_BUFFER_VALUE (buf, offset)),
1072 result);
1076 return result;
1079 DEFUN ("buffer-modified-p", Fbuffer_modified_p, Sbuffer_modified_p,
1080 0, 1, 0,
1081 doc: /* Return t if BUFFER was modified since its file was last read or saved.
1082 No argument or nil as argument means use current buffer as BUFFER. */)
1083 (buffer)
1084 register Lisp_Object buffer;
1086 register struct buffer *buf;
1087 if (NILP (buffer))
1088 buf = current_buffer;
1089 else
1091 CHECK_BUFFER (buffer);
1092 buf = XBUFFER (buffer);
1095 return BUF_SAVE_MODIFF (buf) < BUF_MODIFF (buf) ? Qt : Qnil;
1098 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
1099 1, 1, 0,
1100 doc: /* Mark current buffer as modified or unmodified according to FLAG.
1101 A non-nil FLAG means mark the buffer modified. */)
1102 (flag)
1103 register Lisp_Object flag;
1105 register int already;
1106 register Lisp_Object fn;
1107 Lisp_Object buffer, window;
1109 #ifdef CLASH_DETECTION
1110 /* If buffer becoming modified, lock the file.
1111 If buffer becoming unmodified, unlock the file. */
1113 fn = current_buffer->file_truename;
1114 /* Test buffer-file-name so that binding it to nil is effective. */
1115 if (!NILP (fn) && ! NILP (current_buffer->filename))
1117 already = SAVE_MODIFF < MODIFF;
1118 if (!already && !NILP (flag))
1119 lock_file (fn);
1120 else if (already && NILP (flag))
1121 unlock_file (fn);
1123 #endif /* CLASH_DETECTION */
1125 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1127 /* Set update_mode_lines only if buffer is displayed in some window.
1128 Packages like jit-lock or lazy-lock preserve a buffer's modified
1129 state by recording/restoring the state around blocks of code.
1130 Setting update_mode_lines makes redisplay consider all windows
1131 (on all frames). Stealth fontification of buffers not displayed
1132 would incur additional redisplay costs if we'd set
1133 update_modes_lines unconditionally.
1135 Ideally, I think there should be another mechanism for fontifying
1136 buffers without "modifying" buffers, or redisplay should be
1137 smarter about updating the `*' in mode lines. --gerd */
1138 XSETBUFFER (buffer, current_buffer);
1139 window = Fget_buffer_window (buffer, Qt);
1140 if (WINDOWP (window))
1142 ++update_mode_lines;
1143 current_buffer->prevent_redisplay_optimizations_p = 1;
1146 return flag;
1149 DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p,
1150 Srestore_buffer_modified_p, 1, 1, 0,
1151 doc: /* Like `set-buffer-modified-p', with a difference concerning redisplay.
1152 It is not ensured that mode lines will be updated to show the modified
1153 state of the current buffer. Use with care. */)
1154 (flag)
1155 Lisp_Object flag;
1157 #ifdef CLASH_DETECTION
1158 Lisp_Object fn;
1160 /* If buffer becoming modified, lock the file.
1161 If buffer becoming unmodified, unlock the file. */
1163 fn = current_buffer->file_truename;
1164 /* Test buffer-file-name so that binding it to nil is effective. */
1165 if (!NILP (fn) && ! NILP (current_buffer->filename))
1167 int already = SAVE_MODIFF < MODIFF;
1168 if (!already && !NILP (flag))
1169 lock_file (fn);
1170 else if (already && NILP (flag))
1171 unlock_file (fn);
1173 #endif /* CLASH_DETECTION */
1175 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1176 return flag;
1179 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick, Sbuffer_modified_tick,
1180 0, 1, 0,
1181 doc: /* Return BUFFER's tick counter, incremented for each change in text.
1182 Each buffer has a tick counter which is incremented each time the
1183 text in that buffer is changed. It wraps around occasionally.
1184 No argument or nil as argument means use current buffer as BUFFER. */)
1185 (buffer)
1186 register Lisp_Object buffer;
1188 register struct buffer *buf;
1189 if (NILP (buffer))
1190 buf = current_buffer;
1191 else
1193 CHECK_BUFFER (buffer);
1194 buf = XBUFFER (buffer);
1197 return make_number (BUF_MODIFF (buf));
1200 DEFUN ("buffer-chars-modified-tick", Fbuffer_chars_modified_tick,
1201 Sbuffer_chars_modified_tick, 0, 1, 0,
1202 doc: /* Return BUFFER's character-change tick counter.
1203 Each buffer has a character-change tick counter, which is set to the
1204 value of the buffer's tick counter \(see `buffer-modified-tick'), each
1205 time text in that buffer is inserted or deleted. By comparing the
1206 values returned by two individual calls of `buffer-chars-modified-tick',
1207 you can tell whether a character change occurred in that buffer in
1208 between these calls. No argument or nil as argument means use current
1209 buffer as BUFFER. */)
1210 (buffer)
1211 register Lisp_Object buffer;
1213 register struct buffer *buf;
1214 if (NILP (buffer))
1215 buf = current_buffer;
1216 else
1218 CHECK_BUFFER (buffer);
1219 buf = XBUFFER (buffer);
1222 return make_number (BUF_CHARS_MODIFF (buf));
1225 DEFUN ("rename-buffer", Frename_buffer, Srename_buffer, 1, 2,
1226 "(list (read-string \"Rename buffer (to new name): \" \
1227 nil 'buffer-name-history (buffer-name (current-buffer))) \
1228 current-prefix-arg)",
1229 doc: /* Change current buffer's name to NEWNAME (a string).
1230 If second arg UNIQUE is nil or omitted, it is an error if a
1231 buffer named NEWNAME already exists.
1232 If UNIQUE is non-nil, come up with a new name using
1233 `generate-new-buffer-name'.
1234 Interactively, you can set UNIQUE with a prefix argument.
1235 We return the name we actually gave the buffer.
1236 This does not change the name of the visited file (if any). */)
1237 (newname, unique)
1238 register Lisp_Object newname, unique;
1240 register Lisp_Object tem, buf;
1242 CHECK_STRING (newname);
1244 if (SCHARS (newname) == 0)
1245 error ("Empty string is invalid as a buffer name");
1247 tem = Fget_buffer (newname);
1248 if (!NILP (tem))
1250 /* Don't short-circuit if UNIQUE is t. That is a useful way to
1251 rename the buffer automatically so you can create another
1252 with the original name. It makes UNIQUE equivalent to
1253 (rename-buffer (generate-new-buffer-name NEWNAME)). */
1254 if (NILP (unique) && XBUFFER (tem) == current_buffer)
1255 return current_buffer->name;
1256 if (!NILP (unique))
1257 newname = Fgenerate_new_buffer_name (newname, current_buffer->name);
1258 else
1259 error ("Buffer name `%s' is in use", SDATA (newname));
1262 current_buffer->name = newname;
1264 /* Catch redisplay's attention. Unless we do this, the mode lines for
1265 any windows displaying current_buffer will stay unchanged. */
1266 update_mode_lines++;
1268 XSETBUFFER (buf, current_buffer);
1269 Fsetcar (Frassq (buf, Vbuffer_alist), newname);
1270 if (NILP (current_buffer->filename)
1271 && !NILP (current_buffer->auto_save_file_name))
1272 call0 (intern ("rename-auto-save-file"));
1273 /* Refetch since that last call may have done GC. */
1274 return current_buffer->name;
1277 DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 3, 0,
1278 doc: /* Return most recently selected buffer other than BUFFER.
1279 Buffers not visible in windows are preferred to visible buffers,
1280 unless optional second argument VISIBLE-OK is non-nil.
1281 If the optional third argument FRAME is non-nil, use that frame's
1282 buffer list instead of the selected frame's buffer list.
1283 If no other buffer exists, the buffer `*scratch*' is returned.
1284 If BUFFER is omitted or nil, some interesting buffer is returned. */)
1285 (buffer, visible_ok, frame)
1286 register Lisp_Object buffer, visible_ok, frame;
1288 Lisp_Object Fset_buffer_major_mode ();
1289 register Lisp_Object tail, buf, notsogood, tem, pred, add_ons;
1290 notsogood = Qnil;
1292 if (NILP (frame))
1293 frame = selected_frame;
1295 tail = Vbuffer_alist;
1296 pred = frame_buffer_predicate (frame);
1298 /* Consider buffers that have been seen in the selected frame
1299 before other buffers. */
1301 tem = frame_buffer_list (frame);
1302 add_ons = Qnil;
1303 while (CONSP (tem))
1305 if (BUFFERP (XCAR (tem)))
1306 add_ons = Fcons (Fcons (Qnil, XCAR (tem)), add_ons);
1307 tem = XCDR (tem);
1309 tail = nconc2 (Fnreverse (add_ons), tail);
1311 for (; CONSP (tail); tail = XCDR (tail))
1313 buf = Fcdr (XCAR (tail));
1314 if (EQ (buf, buffer))
1315 continue;
1316 if (NILP (buf))
1317 continue;
1318 if (NILP (XBUFFER (buf)->name))
1319 continue;
1320 if (SREF (XBUFFER (buf)->name, 0) == ' ')
1321 continue;
1322 /* If the selected frame has a buffer_predicate,
1323 disregard buffers that don't fit the predicate. */
1324 if (!NILP (pred))
1326 tem = call1 (pred, buf);
1327 if (NILP (tem))
1328 continue;
1331 if (NILP (visible_ok))
1332 tem = Fget_buffer_window (buf, Qvisible);
1333 else
1334 tem = Qnil;
1335 if (NILP (tem))
1336 return buf;
1337 if (NILP (notsogood))
1338 notsogood = buf;
1340 if (!NILP (notsogood))
1341 return notsogood;
1342 buf = Fget_buffer (build_string ("*scratch*"));
1343 if (NILP (buf))
1345 buf = Fget_buffer_create (build_string ("*scratch*"));
1346 Fset_buffer_major_mode (buf);
1348 return buf;
1351 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo, Sbuffer_enable_undo,
1352 0, 1, "",
1353 doc: /* Start keeping undo information for buffer BUFFER.
1354 No argument or nil as argument means do this for the current buffer. */)
1355 (buffer)
1356 register Lisp_Object buffer;
1358 Lisp_Object real_buffer;
1360 if (NILP (buffer))
1361 XSETBUFFER (real_buffer, current_buffer);
1362 else
1364 real_buffer = Fget_buffer (buffer);
1365 if (NILP (real_buffer))
1366 nsberror (buffer);
1369 if (EQ (XBUFFER (real_buffer)->undo_list, Qt))
1370 XBUFFER (real_buffer)->undo_list = Qnil;
1372 return Qnil;
1376 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
1377 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
1378 The buffer being killed will be current while the hook is running.\n\
1379 See `kill-buffer'."
1381 DEFUN ("kill-buffer", Fkill_buffer, Skill_buffer, 1, 1, "bKill buffer: ",
1382 doc: /* Kill the buffer BUFFER.
1383 The argument may be a buffer or the name of a buffer.
1384 With a nil argument, kill the current buffer.
1386 Value is t if the buffer is actually killed, nil otherwise.
1388 The functions in `kill-buffer-query-functions' are called with BUFFER as
1389 the current buffer. If any of them returns nil, the buffer is not killed.
1391 The hook `kill-buffer-hook' is run before the buffer is actually killed.
1392 The buffer being killed will be current while the hook is running.
1394 Any processes that have this buffer as the `process-buffer' are killed
1395 with SIGHUP. */)
1396 (buffer)
1397 Lisp_Object buffer;
1399 Lisp_Object buf;
1400 register struct buffer *b;
1401 register Lisp_Object tem;
1402 register struct Lisp_Marker *m;
1403 struct gcpro gcpro1;
1405 if (NILP (buffer))
1406 buf = Fcurrent_buffer ();
1407 else
1408 buf = Fget_buffer (buffer);
1409 if (NILP (buf))
1410 nsberror (buffer);
1412 b = XBUFFER (buf);
1414 /* Avoid trouble for buffer already dead. */
1415 if (NILP (b->name))
1416 return Qnil;
1418 /* Query if the buffer is still modified. */
1419 if (INTERACTIVE && !NILP (b->filename)
1420 && BUF_MODIFF (b) > BUF_SAVE_MODIFF (b))
1422 GCPRO1 (buf);
1423 tem = do_yes_or_no_p (format2 ("Buffer %s modified; kill anyway? ",
1424 b->name, make_number (0)));
1425 UNGCPRO;
1426 if (NILP (tem))
1427 return Qnil;
1430 /* Run hooks with the buffer to be killed the current buffer. */
1432 int count = SPECPDL_INDEX ();
1433 Lisp_Object arglist[1];
1435 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1436 set_buffer_internal (b);
1438 /* First run the query functions; if any query is answered no,
1439 don't kill the buffer. */
1440 arglist[0] = Qkill_buffer_query_functions;
1441 tem = Frun_hook_with_args_until_failure (1, arglist);
1442 if (NILP (tem))
1443 return unbind_to (count, Qnil);
1445 /* Then run the hooks. */
1446 Frun_hooks (1, &Qkill_buffer_hook);
1447 unbind_to (count, Qnil);
1450 /* We have no more questions to ask. Verify that it is valid
1451 to kill the buffer. This must be done after the questions
1452 since anything can happen within do_yes_or_no_p. */
1454 /* Don't kill the minibuffer now current. */
1455 if (EQ (buf, XWINDOW (minibuf_window)->buffer))
1456 return Qnil;
1458 if (NILP (b->name))
1459 return Qnil;
1461 /* When we kill a base buffer, kill all its indirect buffers.
1462 We do it at this stage so nothing terrible happens if they
1463 ask questions or their hooks get errors. */
1464 if (! b->base_buffer)
1466 struct buffer *other;
1468 GCPRO1 (buf);
1470 for (other = all_buffers; other; other = other->next)
1471 /* all_buffers contains dead buffers too;
1472 don't re-kill them. */
1473 if (other->base_buffer == b && !NILP (other->name))
1475 Lisp_Object buf;
1476 XSETBUFFER (buf, other);
1477 Fkill_buffer (buf);
1480 UNGCPRO;
1483 /* Make this buffer not be current.
1484 In the process, notice if this is the sole visible buffer
1485 and give up if so. */
1486 if (b == current_buffer)
1488 tem = Fother_buffer (buf, Qnil, Qnil);
1489 Fset_buffer (tem);
1490 if (b == current_buffer)
1491 return Qnil;
1494 /* Notice if the buffer to kill is the sole visible buffer
1495 when we're currently in the mini-buffer, and give up if so. */
1496 XSETBUFFER (tem, current_buffer);
1497 if (EQ (tem, XWINDOW (minibuf_window)->buffer))
1499 tem = Fother_buffer (buf, Qnil, Qnil);
1500 if (EQ (buf, tem))
1501 return Qnil;
1504 /* Now there is no question: we can kill the buffer. */
1506 #ifdef CLASH_DETECTION
1507 /* Unlock this buffer's file, if it is locked. */
1508 unlock_buffer (b);
1509 #endif /* CLASH_DETECTION */
1511 GCPRO1 (buf);
1512 kill_buffer_processes (buf);
1513 UNGCPRO;
1515 /* Killing buffer processes may run sentinels which may
1516 have called kill-buffer. */
1518 if (NILP (b->name))
1519 return Qnil;
1521 clear_charpos_cache (b);
1523 tem = Vinhibit_quit;
1524 Vinhibit_quit = Qt;
1525 replace_buffer_in_all_windows (buf);
1526 Vbuffer_alist = Fdelq (Frassq (buf, Vbuffer_alist), Vbuffer_alist);
1527 frames_discard_buffer (buf);
1528 Vinhibit_quit = tem;
1530 /* Delete any auto-save file, if we saved it in this session.
1531 But not if the buffer is modified. */
1532 if (STRINGP (b->auto_save_file_name)
1533 && b->auto_save_modified != 0
1534 && BUF_SAVE_MODIFF (b) < b->auto_save_modified
1535 && BUF_SAVE_MODIFF (b) < BUF_MODIFF (b)
1536 && NILP (Fsymbol_value (intern ("auto-save-visited-file-name"))))
1538 Lisp_Object tem;
1539 tem = Fsymbol_value (intern ("delete-auto-save-files"));
1540 if (! NILP (tem))
1541 internal_delete_file (b->auto_save_file_name);
1544 if (b->base_buffer)
1546 /* Unchain all markers that belong to this indirect buffer.
1547 Don't unchain the markers that belong to the base buffer
1548 or its other indirect buffers. */
1549 for (m = BUF_MARKERS (b); m; )
1551 struct Lisp_Marker *next = m->next;
1552 if (m->buffer == b)
1553 unchain_marker (m);
1554 m = next;
1557 else
1559 /* Unchain all markers of this buffer and its indirect buffers.
1560 and leave them pointing nowhere. */
1561 for (m = BUF_MARKERS (b); m; )
1563 struct Lisp_Marker *next = m->next;
1564 m->buffer = 0;
1565 m->next = NULL;
1566 m = next;
1568 BUF_MARKERS (b) = NULL;
1569 BUF_INTERVALS (b) = NULL_INTERVAL;
1571 /* Perhaps we should explicitly free the interval tree here... */
1574 /* Reset the local variables, so that this buffer's local values
1575 won't be protected from GC. They would be protected
1576 if they happened to remain encached in their symbols.
1577 This gets rid of them for certain. */
1578 swap_out_buffer_local_variables (b);
1579 reset_buffer_local_variables (b, 1);
1581 b->name = Qnil;
1583 BLOCK_INPUT;
1584 if (! b->base_buffer)
1585 free_buffer_text (b);
1587 if (b->newline_cache)
1589 free_region_cache (b->newline_cache);
1590 b->newline_cache = 0;
1592 if (b->width_run_cache)
1594 free_region_cache (b->width_run_cache);
1595 b->width_run_cache = 0;
1597 b->width_table = Qnil;
1598 UNBLOCK_INPUT;
1599 b->undo_list = Qnil;
1601 return Qt;
1604 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1605 we do this each time BUF is selected visibly, the more recently
1606 selected buffers are always closer to the front of the list. This
1607 means that other_buffer is more likely to choose a relevant buffer. */
1609 void
1610 record_buffer (buf)
1611 Lisp_Object buf;
1613 register Lisp_Object link, prev;
1614 Lisp_Object frame;
1615 frame = selected_frame;
1617 prev = Qnil;
1618 for (link = Vbuffer_alist; CONSP (link); link = XCDR (link))
1620 if (EQ (XCDR (XCAR (link)), buf))
1621 break;
1622 prev = link;
1625 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1626 we cannot use Fdelq itself here because it allows quitting. */
1628 if (NILP (prev))
1629 Vbuffer_alist = XCDR (Vbuffer_alist);
1630 else
1631 XSETCDR (prev, XCDR (XCDR (prev)));
1633 XSETCDR (link, Vbuffer_alist);
1634 Vbuffer_alist = link;
1636 /* Effectively do a delq on buried_buffer_list. */
1638 prev = Qnil;
1639 for (link = XFRAME (frame)->buried_buffer_list; CONSP (link);
1640 link = XCDR (link))
1642 if (EQ (XCAR (link), buf))
1644 if (NILP (prev))
1645 XFRAME (frame)->buried_buffer_list = XCDR (link);
1646 else
1647 XSETCDR (prev, XCDR (XCDR (prev)));
1648 break;
1650 prev = link;
1653 /* Now move this buffer to the front of frame_buffer_list also. */
1655 prev = Qnil;
1656 for (link = frame_buffer_list (frame); CONSP (link);
1657 link = XCDR (link))
1659 if (EQ (XCAR (link), buf))
1660 break;
1661 prev = link;
1664 /* Effectively do delq. */
1666 if (CONSP (link))
1668 if (NILP (prev))
1669 set_frame_buffer_list (frame,
1670 XCDR (frame_buffer_list (frame)));
1671 else
1672 XSETCDR (prev, XCDR (XCDR (prev)));
1674 XSETCDR (link, frame_buffer_list (frame));
1675 set_frame_buffer_list (frame, link);
1677 else
1678 set_frame_buffer_list (frame, Fcons (buf, frame_buffer_list (frame)));
1681 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode, Sset_buffer_major_mode, 1, 1, 0,
1682 doc: /* Set an appropriate major mode for BUFFER.
1683 For the *scratch* buffer, use `initial-major-mode', otherwise choose a mode
1684 according to `default-major-mode'.
1685 Use this function before selecting the buffer, since it may need to inspect
1686 the current buffer's major mode. */)
1687 (buffer)
1688 Lisp_Object buffer;
1690 int count;
1691 Lisp_Object function;
1693 CHECK_BUFFER (buffer);
1695 if (STRINGP (XBUFFER (buffer)->name)
1696 && strcmp (SDATA (XBUFFER (buffer)->name), "*scratch*") == 0)
1697 function = find_symbol_value (intern ("initial-major-mode"));
1698 else
1700 function = buffer_defaults.major_mode;
1701 if (NILP (function)
1702 && NILP (Fget (current_buffer->major_mode, Qmode_class)))
1703 function = current_buffer->major_mode;
1706 if (NILP (function) || EQ (function, Qfundamental_mode))
1707 return Qnil;
1709 count = SPECPDL_INDEX ();
1711 /* To select a nonfundamental mode,
1712 select the buffer temporarily and then call the mode function. */
1714 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1716 Fset_buffer (buffer);
1717 call0 (function);
1719 return unbind_to (count, Qnil);
1722 /* If switching buffers in WINDOW would be an error, return
1723 a C string saying what the error would be. */
1725 char *
1726 no_switch_window (window)
1727 Lisp_Object window;
1729 Lisp_Object tem;
1730 if (EQ (minibuf_window, window))
1731 return "Cannot switch buffers in minibuffer window";
1732 tem = Fwindow_dedicated_p (window);
1733 if (EQ (tem, Qt))
1734 return "Cannot switch buffers in a dedicated window";
1735 return NULL;
1738 /* Switch to buffer BUFFER in the selected window.
1739 If NORECORD is non-nil, don't call record_buffer. */
1741 Lisp_Object
1742 switch_to_buffer_1 (buffer, norecord)
1743 Lisp_Object buffer, norecord;
1745 register Lisp_Object buf;
1747 if (NILP (buffer))
1748 buf = Fother_buffer (Fcurrent_buffer (), Qnil, Qnil);
1749 else
1751 buf = Fget_buffer (buffer);
1752 if (NILP (buf))
1754 buf = Fget_buffer_create (buffer);
1755 Fset_buffer_major_mode (buf);
1758 Fset_buffer (buf);
1759 if (NILP (norecord))
1760 record_buffer (buf);
1762 Fset_window_buffer (EQ (selected_window, minibuf_window)
1763 ? Fnext_window (minibuf_window, Qnil, Qnil)
1764 : selected_window,
1765 buf, Qnil);
1767 return buf;
1770 DEFUN ("switch-to-buffer", Fswitch_to_buffer, Sswitch_to_buffer, 1, 2, "BSwitch to buffer: ",
1771 doc: /* Select buffer BUFFER in the current window.
1772 If BUFFER does not identify an existing buffer,
1773 then this function creates a buffer with that name.
1775 When called from Lisp, BUFFER may be a buffer, a string \(a buffer name),
1776 or nil. If BUFFER is nil, then this function chooses a buffer
1777 using `other-buffer'.
1778 Optional second arg NORECORD non-nil means
1779 do not put this buffer at the front of the list of recently selected ones.
1780 This function returns the buffer it switched to.
1782 WARNING: This is NOT the way to work on another buffer temporarily
1783 within a Lisp program! Use `set-buffer' instead. That avoids messing with
1784 the window-buffer correspondences. */)
1785 (buffer, norecord)
1786 Lisp_Object buffer, norecord;
1788 char *err;
1790 if (EQ (buffer, Fwindow_buffer (selected_window)))
1792 /* Basically a NOP. Avoid signalling an error in the case where
1793 the selected window is dedicated, or a minibuffer. */
1795 /* But do put this buffer at the front of the buffer list,
1796 unless that has been inhibited. Note that even if
1797 BUFFER is at the front of the main buffer-list already,
1798 we still want to move it to the front of the frame's buffer list. */
1799 if (NILP (norecord))
1800 record_buffer (buffer);
1801 return Fset_buffer (buffer);
1804 err = no_switch_window (selected_window);
1805 if (err) error (err);
1807 return switch_to_buffer_1 (buffer, norecord);
1810 DEFUN ("pop-to-buffer", Fpop_to_buffer, Spop_to_buffer, 1, 3, 0,
1811 doc: /* Select buffer BUFFER in some window, preferably a different one.
1812 BUFFER may be a buffer, a string \(a buffer name), or nil.
1813 If BUFFER is a string which is not the name of an existing buffer,
1814 then this function creates a buffer with that name.
1815 If BUFFER is nil, then it chooses some other buffer.
1816 If `pop-up-windows' is non-nil, windows can be split to do this.
1817 If optional second arg OTHER-WINDOW is non-nil, insist on finding another
1818 window even if BUFFER is already visible in the selected window,
1819 and ignore `same-window-regexps' and `same-window-buffer-names'.
1820 This function returns the buffer it switched to.
1821 This uses the function `display-buffer' as a subroutine; see the documentation
1822 of `display-buffer' for additional customization information.
1824 Optional third arg NORECORD non-nil means
1825 do not put this buffer at the front of the list of recently selected ones. */)
1826 (buffer, other_window, norecord)
1827 Lisp_Object buffer, other_window, norecord;
1829 register Lisp_Object buf;
1830 if (NILP (buffer))
1831 buf = Fother_buffer (Fcurrent_buffer (), Qnil, Qnil);
1832 else
1834 buf = Fget_buffer (buffer);
1835 if (NILP (buf))
1837 buf = Fget_buffer_create (buffer);
1838 Fset_buffer_major_mode (buf);
1841 Fset_buffer (buf);
1842 Fselect_window (Fdisplay_buffer (buf, other_window, Qnil), norecord);
1843 return buf;
1846 DEFUN ("current-buffer", Fcurrent_buffer, Scurrent_buffer, 0, 0, 0,
1847 doc: /* Return the current buffer as a Lisp object. */)
1850 register Lisp_Object buf;
1851 XSETBUFFER (buf, current_buffer);
1852 return buf;
1855 /* Set the current buffer to B.
1857 We previously set windows_or_buffers_changed here to invalidate
1858 global unchanged information in beg_unchanged and end_unchanged.
1859 This is no longer necessary because we now compute unchanged
1860 information on a buffer-basis. Every action affecting other
1861 windows than the selected one requires a select_window at some
1862 time, and that increments windows_or_buffers_changed. */
1864 void
1865 set_buffer_internal (b)
1866 register struct buffer *b;
1868 if (current_buffer != b)
1869 set_buffer_internal_1 (b);
1872 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1873 This is used by redisplay. */
1875 void
1876 set_buffer_internal_1 (b)
1877 register struct buffer *b;
1879 register struct buffer *old_buf;
1880 register Lisp_Object tail, valcontents;
1881 Lisp_Object tem;
1883 #ifdef USE_MMAP_FOR_BUFFERS
1884 if (b->text->beg == NULL)
1885 enlarge_buffer_text (b, 0);
1886 #endif /* USE_MMAP_FOR_BUFFERS */
1888 if (current_buffer == b)
1889 return;
1891 old_buf = current_buffer;
1892 current_buffer = b;
1893 last_known_column_point = -1; /* invalidate indentation cache */
1895 if (old_buf)
1897 /* Put the undo list back in the base buffer, so that it appears
1898 that an indirect buffer shares the undo list of its base. */
1899 if (old_buf->base_buffer)
1900 old_buf->base_buffer->undo_list = old_buf->undo_list;
1902 /* If the old current buffer has markers to record PT, BEGV and ZV
1903 when it is not current, update them now. */
1904 if (! NILP (old_buf->pt_marker))
1906 Lisp_Object obuf;
1907 XSETBUFFER (obuf, old_buf);
1908 set_marker_both (old_buf->pt_marker, obuf,
1909 BUF_PT (old_buf), BUF_PT_BYTE (old_buf));
1911 if (! NILP (old_buf->begv_marker))
1913 Lisp_Object obuf;
1914 XSETBUFFER (obuf, old_buf);
1915 set_marker_both (old_buf->begv_marker, obuf,
1916 BUF_BEGV (old_buf), BUF_BEGV_BYTE (old_buf));
1918 if (! NILP (old_buf->zv_marker))
1920 Lisp_Object obuf;
1921 XSETBUFFER (obuf, old_buf);
1922 set_marker_both (old_buf->zv_marker, obuf,
1923 BUF_ZV (old_buf), BUF_ZV_BYTE (old_buf));
1927 /* Get the undo list from the base buffer, so that it appears
1928 that an indirect buffer shares the undo list of its base. */
1929 if (b->base_buffer)
1930 b->undo_list = b->base_buffer->undo_list;
1932 /* If the new current buffer has markers to record PT, BEGV and ZV
1933 when it is not current, fetch them now. */
1934 if (! NILP (b->pt_marker))
1936 BUF_PT (b) = marker_position (b->pt_marker);
1937 BUF_PT_BYTE (b) = marker_byte_position (b->pt_marker);
1939 if (! NILP (b->begv_marker))
1941 BUF_BEGV (b) = marker_position (b->begv_marker);
1942 BUF_BEGV_BYTE (b) = marker_byte_position (b->begv_marker);
1944 if (! NILP (b->zv_marker))
1946 BUF_ZV (b) = marker_position (b->zv_marker);
1947 BUF_ZV_BYTE (b) = marker_byte_position (b->zv_marker);
1950 /* Look down buffer's list of local Lisp variables
1951 to find and update any that forward into C variables. */
1953 for (tail = b->local_var_alist; CONSP (tail); tail = XCDR (tail))
1955 valcontents = SYMBOL_VALUE (XCAR (XCAR (tail)));
1956 if ((BUFFER_LOCAL_VALUEP (valcontents))
1957 && (tem = XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1958 (BOOLFWDP (tem) || INTFWDP (tem) || OBJFWDP (tem))))
1959 /* Just reference the variable
1960 to cause it to become set for this buffer. */
1961 Fsymbol_value (XCAR (XCAR (tail)));
1964 /* Do the same with any others that were local to the previous buffer */
1966 if (old_buf)
1967 for (tail = old_buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1969 valcontents = SYMBOL_VALUE (XCAR (XCAR (tail)));
1970 if ((BUFFER_LOCAL_VALUEP (valcontents))
1971 && (tem = XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1972 (BOOLFWDP (tem) || INTFWDP (tem) || OBJFWDP (tem))))
1973 /* Just reference the variable
1974 to cause it to become set for this buffer. */
1975 Fsymbol_value (XCAR (XCAR (tail)));
1979 /* Switch to buffer B temporarily for redisplay purposes.
1980 This avoids certain things that don't need to be done within redisplay. */
1982 void
1983 set_buffer_temp (b)
1984 struct buffer *b;
1986 register struct buffer *old_buf;
1988 if (current_buffer == b)
1989 return;
1991 old_buf = current_buffer;
1992 current_buffer = b;
1994 if (old_buf)
1996 /* If the old current buffer has markers to record PT, BEGV and ZV
1997 when it is not current, update them now. */
1998 if (! NILP (old_buf->pt_marker))
2000 Lisp_Object obuf;
2001 XSETBUFFER (obuf, old_buf);
2002 set_marker_both (old_buf->pt_marker, obuf,
2003 BUF_PT (old_buf), BUF_PT_BYTE (old_buf));
2005 if (! NILP (old_buf->begv_marker))
2007 Lisp_Object obuf;
2008 XSETBUFFER (obuf, old_buf);
2009 set_marker_both (old_buf->begv_marker, obuf,
2010 BUF_BEGV (old_buf), BUF_BEGV_BYTE (old_buf));
2012 if (! NILP (old_buf->zv_marker))
2014 Lisp_Object obuf;
2015 XSETBUFFER (obuf, old_buf);
2016 set_marker_both (old_buf->zv_marker, obuf,
2017 BUF_ZV (old_buf), BUF_ZV_BYTE (old_buf));
2021 /* If the new current buffer has markers to record PT, BEGV and ZV
2022 when it is not current, fetch them now. */
2023 if (! NILP (b->pt_marker))
2025 BUF_PT (b) = marker_position (b->pt_marker);
2026 BUF_PT_BYTE (b) = marker_byte_position (b->pt_marker);
2028 if (! NILP (b->begv_marker))
2030 BUF_BEGV (b) = marker_position (b->begv_marker);
2031 BUF_BEGV_BYTE (b) = marker_byte_position (b->begv_marker);
2033 if (! NILP (b->zv_marker))
2035 BUF_ZV (b) = marker_position (b->zv_marker);
2036 BUF_ZV_BYTE (b) = marker_byte_position (b->zv_marker);
2040 DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
2041 doc: /* Make the buffer BUFFER current for editing operations.
2042 BUFFER may be a buffer or the name of an existing buffer.
2043 See also `save-excursion' when you want to make a buffer current temporarily.
2044 This function does not display the buffer, so its effect ends
2045 when the current command terminates.
2046 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently. */)
2047 (buffer)
2048 register Lisp_Object buffer;
2050 register Lisp_Object buf;
2051 buf = Fget_buffer (buffer);
2052 if (NILP (buf))
2053 nsberror (buffer);
2054 if (NILP (XBUFFER (buf)->name))
2055 error ("Selecting deleted buffer");
2056 set_buffer_internal (XBUFFER (buf));
2057 return buf;
2060 /* Set the current buffer to BUFFER provided it is alive. */
2062 Lisp_Object
2063 set_buffer_if_live (buffer)
2064 Lisp_Object buffer;
2066 if (! NILP (XBUFFER (buffer)->name))
2067 Fset_buffer (buffer);
2068 return Qnil;
2071 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only,
2072 Sbarf_if_buffer_read_only, 0, 0, 0,
2073 doc: /* Signal a `buffer-read-only' error if the current buffer is read-only. */)
2076 if (!NILP (current_buffer->read_only)
2077 && NILP (Vinhibit_read_only))
2078 xsignal1 (Qbuffer_read_only, Fcurrent_buffer ());
2079 return Qnil;
2082 DEFUN ("bury-buffer", Fbury_buffer, Sbury_buffer, 0, 1, "",
2083 doc: /* Put BUFFER at the end of the list of all buffers.
2084 There it is the least likely candidate for `other-buffer' to return;
2085 thus, the least likely buffer for \\[switch-to-buffer] to select by default.
2086 You can specify a buffer name as BUFFER, or an actual buffer object.
2087 If BUFFER is nil or omitted, bury the current buffer.
2088 Also, if BUFFER is nil or omitted, remove the current buffer from the
2089 selected window if it is displayed there. */)
2090 (buffer)
2091 register Lisp_Object buffer;
2093 /* Figure out what buffer we're going to bury. */
2094 if (NILP (buffer))
2096 Lisp_Object tem;
2097 XSETBUFFER (buffer, current_buffer);
2099 tem = Fwindow_buffer (selected_window);
2100 /* If we're burying the current buffer, unshow it. */
2101 if (EQ (buffer, tem))
2103 if (NILP (Fwindow_dedicated_p (selected_window)))
2104 Fswitch_to_buffer (Fother_buffer (buffer, Qnil, Qnil), Qnil);
2105 else if (NILP (XWINDOW (selected_window)->parent))
2106 Ficonify_frame (Fwindow_frame (selected_window));
2107 else
2108 Fdelete_window (selected_window);
2111 else
2113 Lisp_Object buf1;
2115 buf1 = Fget_buffer (buffer);
2116 if (NILP (buf1))
2117 nsberror (buffer);
2118 buffer = buf1;
2121 /* Move buffer to the end of the buffer list. Do nothing if the
2122 buffer is killed. */
2123 if (!NILP (XBUFFER (buffer)->name))
2125 Lisp_Object aelt, link;
2127 aelt = Frassq (buffer, Vbuffer_alist);
2128 link = Fmemq (aelt, Vbuffer_alist);
2129 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
2130 XSETCDR (link, Qnil);
2131 Vbuffer_alist = nconc2 (Vbuffer_alist, link);
2133 XFRAME (selected_frame)->buffer_list
2134 = Fdelq (buffer, XFRAME (selected_frame)->buffer_list);
2135 XFRAME (selected_frame)->buried_buffer_list
2136 = Fcons (buffer, Fdelq (buffer, XFRAME (selected_frame)->buried_buffer_list));
2139 return Qnil;
2142 DEFUN ("erase-buffer", Ferase_buffer, Serase_buffer, 0, 0, "*",
2143 doc: /* Delete the entire contents of the current buffer.
2144 Any narrowing restriction in effect (see `narrow-to-region') is removed,
2145 so the buffer is truly empty after this. */)
2148 Fwiden ();
2150 del_range (BEG, Z);
2152 current_buffer->last_window_start = 1;
2153 /* Prevent warnings, or suspension of auto saving, that would happen
2154 if future size is less than past size. Use of erase-buffer
2155 implies that the future text is not really related to the past text. */
2156 XSETFASTINT (current_buffer->save_length, 0);
2157 return Qnil;
2160 void
2161 validate_region (b, e)
2162 register Lisp_Object *b, *e;
2164 CHECK_NUMBER_COERCE_MARKER (*b);
2165 CHECK_NUMBER_COERCE_MARKER (*e);
2167 if (XINT (*b) > XINT (*e))
2169 Lisp_Object tem;
2170 tem = *b; *b = *e; *e = tem;
2173 if (!(BEGV <= XINT (*b) && XINT (*b) <= XINT (*e)
2174 && XINT (*e) <= ZV))
2175 args_out_of_range (*b, *e);
2178 /* Advance BYTE_POS up to a character boundary
2179 and return the adjusted position. */
2181 static int
2182 advance_to_char_boundary (byte_pos)
2183 int byte_pos;
2185 int c;
2187 if (byte_pos == BEG)
2188 /* Beginning of buffer is always a character boundary. */
2189 return BEG;
2191 c = FETCH_BYTE (byte_pos);
2192 if (! CHAR_HEAD_P (c))
2194 /* We should advance BYTE_POS only when C is a constituent of a
2195 multibyte sequence. */
2196 int orig_byte_pos = byte_pos;
2200 byte_pos--;
2201 c = FETCH_BYTE (byte_pos);
2203 while (! CHAR_HEAD_P (c) && byte_pos > BEG);
2204 INC_POS (byte_pos);
2205 if (byte_pos < orig_byte_pos)
2206 byte_pos = orig_byte_pos;
2207 /* If C is a constituent of a multibyte sequence, BYTE_POS was
2208 surely advance to the correct character boundary. If C is
2209 not, BYTE_POS was unchanged. */
2212 return byte_pos;
2215 DEFUN ("buffer-swap-text", Fbuffer_swap_text, Sbuffer_swap_text,
2216 1, 1, 0,
2217 doc: /* Swap the text between current buffer and BUFFER. */)
2218 (buffer)
2219 Lisp_Object buffer;
2221 struct buffer *other_buffer;
2222 CHECK_BUFFER (buffer);
2223 other_buffer = XBUFFER (buffer);
2225 /* Actually, it probably works just fine.
2226 * if (other_buffer == current_buffer)
2227 * error ("Cannot swap a buffer's text with itself"); */
2229 /* Actually, this may be workable as well, tho probably only if they're
2230 *both* indirect. */
2231 if (other_buffer->base_buffer
2232 || current_buffer->base_buffer)
2233 error ("Cannot swap indirect buffers's text");
2235 { /* This is probably harder to make work. */
2236 struct buffer *other;
2237 for (other = all_buffers; other; other = other->next)
2238 if (other->base_buffer == other_buffer
2239 || other->base_buffer == current_buffer)
2240 error ("One of the buffers to swap has indirect buffers");
2243 #define swapfield(field, type) \
2244 do { \
2245 type tmp##field = other_buffer->field; \
2246 other_buffer->field = current_buffer->field; \
2247 current_buffer->field = tmp##field; \
2248 } while (0)
2250 swapfield (own_text, struct buffer_text);
2251 eassert (current_buffer->text == &current_buffer->own_text);
2252 eassert (other_buffer->text == &other_buffer->own_text);
2253 swapfield (pt, EMACS_INT);
2254 swapfield (pt_byte, EMACS_INT);
2255 swapfield (begv, EMACS_INT);
2256 swapfield (begv_byte, EMACS_INT);
2257 swapfield (zv, EMACS_INT);
2258 swapfield (zv_byte, EMACS_INT);
2259 eassert (!current_buffer->base_buffer);
2260 eassert (!other_buffer->base_buffer);
2261 current_buffer->clip_changed = 1; other_buffer->clip_changed = 1;
2262 swapfield (newline_cache, struct region_cache *);
2263 swapfield (width_run_cache, struct region_cache *);
2264 current_buffer->prevent_redisplay_optimizations_p = 1;
2265 other_buffer->prevent_redisplay_optimizations_p = 1;
2266 swapfield (overlays_before, struct Lisp_Overlay *);
2267 swapfield (overlays_after, struct Lisp_Overlay *);
2268 swapfield (overlay_center, EMACS_INT);
2269 swapfield (undo_list, Lisp_Object);
2270 swapfield (mark, Lisp_Object);
2271 if (MARKERP (current_buffer->mark) && XMARKER (current_buffer->mark)->buffer)
2272 XMARKER (current_buffer->mark)->buffer = current_buffer;
2273 if (MARKERP (other_buffer->mark) && XMARKER (other_buffer->mark)->buffer)
2274 XMARKER (other_buffer->mark)->buffer = other_buffer;
2275 swapfield (enable_multibyte_characters, Lisp_Object);
2276 /* FIXME: Not sure what we should do with these *_marker fields.
2277 Hopefully they're just nil anyway. */
2278 swapfield (pt_marker, Lisp_Object);
2279 swapfield (begv_marker, Lisp_Object);
2280 swapfield (zv_marker, Lisp_Object);
2281 current_buffer->point_before_scroll = Qnil;
2282 other_buffer->point_before_scroll = Qnil;
2284 current_buffer->text->modiff++; other_buffer->text->modiff++;
2285 current_buffer->text->chars_modiff++; other_buffer->text->chars_modiff++;
2286 current_buffer->text->overlay_modiff++; other_buffer->text->overlay_modiff++;
2287 current_buffer->text->beg_unchanged = current_buffer->text->gpt;
2288 current_buffer->text->end_unchanged = current_buffer->text->gpt;
2289 other_buffer->text->beg_unchanged = current_buffer->text->gpt;
2290 other_buffer->text->end_unchanged = current_buffer->text->gpt;
2292 struct Lisp_Marker *m;
2293 for (m = BUF_MARKERS (current_buffer); m; m = m->next)
2294 if (m->buffer == other_buffer)
2295 m->buffer = current_buffer;
2296 for (m = BUF_MARKERS (other_buffer); m; m = m->next)
2297 if (m->buffer == current_buffer)
2298 m->buffer = other_buffer;
2300 if (current_buffer->text->intervals)
2301 (eassert (EQ (current_buffer->text->intervals->up.obj, buffer)),
2302 XSETBUFFER (current_buffer->text->intervals->up.obj, current_buffer));
2303 if (other_buffer->text->intervals)
2304 (eassert (EQ (other_buffer->text->intervals->up.obj, Fcurrent_buffer ())),
2305 XSETBUFFER (other_buffer->text->intervals->up.obj, other_buffer));
2307 return Qnil;
2310 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte, Sset_buffer_multibyte,
2311 1, 1, 0,
2312 doc: /* Set the multibyte flag of the current buffer to FLAG.
2313 If FLAG is t, this makes the buffer a multibyte buffer.
2314 If FLAG is nil, this makes the buffer a single-byte buffer.
2315 In these cases, the buffer contents remain unchanged as a sequence of
2316 bytes but the contents viewed as characters do change.
2317 If FLAG is `to', this makes the buffer a multibyte buffer by changing
2318 all eight-bit bytes to eight-bit characters.
2319 If the multibyte flag was really changed, undo information of the
2320 current buffer is cleared. */)
2321 (flag)
2322 Lisp_Object flag;
2324 struct Lisp_Marker *tail, *markers;
2325 struct buffer *other;
2326 int begv, zv;
2327 int narrowed = (BEG != BEGV || Z != ZV);
2328 int modified_p = !NILP (Fbuffer_modified_p (Qnil));
2329 Lisp_Object old_undo = current_buffer->undo_list;
2330 struct gcpro gcpro1;
2332 if (current_buffer->base_buffer)
2333 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
2335 /* Do nothing if nothing actually changes. */
2336 if (NILP (flag) == NILP (current_buffer->enable_multibyte_characters))
2337 return flag;
2339 GCPRO1 (old_undo);
2341 /* Don't record these buffer changes. We will put a special undo entry
2342 instead. */
2343 current_buffer->undo_list = Qt;
2345 /* If the cached position is for this buffer, clear it out. */
2346 clear_charpos_cache (current_buffer);
2348 if (NILP (flag))
2349 begv = BEGV_BYTE, zv = ZV_BYTE;
2350 else
2351 begv = BEGV, zv = ZV;
2353 if (narrowed)
2354 Fwiden ();
2356 if (NILP (flag))
2358 int pos, stop;
2359 unsigned char *p;
2361 /* Do this first, so it can use CHAR_TO_BYTE
2362 to calculate the old correspondences. */
2363 set_intervals_multibyte (0);
2365 current_buffer->enable_multibyte_characters = Qnil;
2367 Z = Z_BYTE;
2368 BEGV = BEGV_BYTE;
2369 ZV = ZV_BYTE;
2370 GPT = GPT_BYTE;
2371 TEMP_SET_PT_BOTH (PT_BYTE, PT_BYTE);
2374 for (tail = BUF_MARKERS (current_buffer); tail; tail = tail->next)
2375 tail->charpos = tail->bytepos;
2377 /* Convert multibyte form of 8-bit characters to unibyte. */
2378 pos = BEG;
2379 stop = GPT;
2380 p = BEG_ADDR;
2381 while (1)
2383 int c, bytes;
2385 if (pos == stop)
2387 if (pos == Z)
2388 break;
2389 p = GAP_END_ADDR;
2390 stop = Z;
2392 if (ASCII_BYTE_P (*p))
2393 p++, pos++;
2394 else if (CHAR_BYTE8_HEAD_P (*p))
2396 c = STRING_CHAR_AND_LENGTH (p, stop - pos, bytes);
2397 /* Delete all bytes for this 8-bit character but the
2398 last one, and change the last one to the charcter
2399 code. */
2400 bytes--;
2401 del_range_2 (pos, pos, pos + bytes, pos + bytes, 0);
2402 p = GAP_END_ADDR;
2403 *p++ = c;
2404 pos++;
2405 if (begv > pos)
2406 begv -= bytes;
2407 if (zv > pos)
2408 zv -= bytes;
2409 stop = Z;
2411 else
2413 bytes = BYTES_BY_CHAR_HEAD (*p);
2414 p += bytes, pos += bytes;
2417 if (narrowed)
2418 Fnarrow_to_region (make_number (begv), make_number (zv));
2420 else
2422 int pt = PT;
2423 int pos, stop;
2424 unsigned char *p, *pend;
2426 /* Be sure not to have a multibyte sequence striding over the GAP.
2427 Ex: We change this: "...abc\302 _GAP_ \241def..."
2428 to: "...abc _GAP_ \302\241def..." */
2430 if (EQ (flag, Qt)
2431 && GPT_BYTE > 1 && GPT_BYTE < Z_BYTE
2432 && ! CHAR_HEAD_P (*(GAP_END_ADDR)))
2434 unsigned char *p = GPT_ADDR - 1;
2436 while (! CHAR_HEAD_P (*p) && p > BEG_ADDR) p--;
2437 if (BASE_LEADING_CODE_P (*p))
2439 int new_gpt = GPT_BYTE - (GPT_ADDR - p);
2441 move_gap_both (new_gpt, new_gpt);
2445 /* Make the buffer contents valid as multibyte by converting
2446 8-bit characters to multibyte form. */
2447 pos = BEG;
2448 stop = GPT;
2449 p = BEG_ADDR;
2450 pend = GPT_ADDR;
2451 while (1)
2453 int bytes;
2455 if (pos == stop)
2457 if (pos == Z)
2458 break;
2459 p = GAP_END_ADDR;
2460 pend = Z_ADDR;
2461 stop = Z;
2464 if (ASCII_BYTE_P (*p))
2465 p++, pos++;
2466 else if (EQ (flag, Qt) && (bytes = MULTIBYTE_LENGTH (p, pend)) > 0)
2467 p += bytes, pos += bytes;
2468 else
2470 unsigned char tmp[MAX_MULTIBYTE_LENGTH];
2471 int c;
2473 c = BYTE8_TO_CHAR (*p);
2474 bytes = CHAR_STRING (c, tmp);
2475 *p = tmp[0];
2476 TEMP_SET_PT_BOTH (pos + 1, pos + 1);
2477 bytes--;
2478 insert_1_both (tmp + 1, bytes, bytes, 1, 0, 0);
2479 /* Now the gap is after the just inserted data. */
2480 pos = GPT;
2481 p = GAP_END_ADDR;
2482 if (pos <= begv)
2483 begv += bytes;
2484 if (pos <= zv)
2485 zv += bytes;
2486 if (pos <= pt)
2487 pt += bytes;
2488 pend = Z_ADDR;
2489 stop = Z;
2493 if (pt != PT)
2494 TEMP_SET_PT (pt);
2496 if (narrowed)
2497 Fnarrow_to_region (make_number (begv), make_number (zv));
2499 /* Do this first, so that chars_in_text asks the right question.
2500 set_intervals_multibyte needs it too. */
2501 current_buffer->enable_multibyte_characters = Qt;
2503 GPT_BYTE = advance_to_char_boundary (GPT_BYTE);
2504 GPT = chars_in_text (BEG_ADDR, GPT_BYTE - BEG_BYTE) + BEG;
2506 Z = chars_in_text (GAP_END_ADDR, Z_BYTE - GPT_BYTE) + GPT;
2508 BEGV_BYTE = advance_to_char_boundary (BEGV_BYTE);
2509 if (BEGV_BYTE > GPT_BYTE)
2510 BEGV = chars_in_text (GAP_END_ADDR, BEGV_BYTE - GPT_BYTE) + GPT;
2511 else
2512 BEGV = chars_in_text (BEG_ADDR, BEGV_BYTE - BEG_BYTE) + BEG;
2514 ZV_BYTE = advance_to_char_boundary (ZV_BYTE);
2515 if (ZV_BYTE > GPT_BYTE)
2516 ZV = chars_in_text (GAP_END_ADDR, ZV_BYTE - GPT_BYTE) + GPT;
2517 else
2518 ZV = chars_in_text (BEG_ADDR, ZV_BYTE - BEG_BYTE) + BEG;
2521 int pt_byte = advance_to_char_boundary (PT_BYTE);
2522 int pt;
2524 if (pt_byte > GPT_BYTE)
2525 pt = chars_in_text (GAP_END_ADDR, pt_byte - GPT_BYTE) + GPT;
2526 else
2527 pt = chars_in_text (BEG_ADDR, pt_byte - BEG_BYTE) + BEG;
2528 TEMP_SET_PT_BOTH (pt, pt_byte);
2531 tail = markers = BUF_MARKERS (current_buffer);
2533 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
2534 getting confused by the markers that have not yet been updated.
2535 It is also a signal that it should never create a marker. */
2536 BUF_MARKERS (current_buffer) = NULL;
2538 for (; tail; tail = tail->next)
2540 tail->bytepos = advance_to_char_boundary (tail->bytepos);
2541 tail->charpos = BYTE_TO_CHAR (tail->bytepos);
2544 /* Make sure no markers were put on the chain
2545 while the chain value was incorrect. */
2546 if (BUF_MARKERS (current_buffer))
2547 abort ();
2549 BUF_MARKERS (current_buffer) = markers;
2551 /* Do this last, so it can calculate the new correspondences
2552 between chars and bytes. */
2553 set_intervals_multibyte (1);
2556 if (!EQ (old_undo, Qt))
2558 /* Represent all the above changes by a special undo entry. */
2559 extern Lisp_Object Qapply;
2560 current_buffer->undo_list = Fcons (list3 (Qapply,
2561 intern ("set-buffer-multibyte"),
2562 NILP (flag) ? Qt : Qnil),
2563 old_undo);
2566 UNGCPRO;
2568 /* Changing the multibyteness of a buffer means that all windows
2569 showing that buffer must be updated thoroughly. */
2570 current_buffer->prevent_redisplay_optimizations_p = 1;
2571 ++windows_or_buffers_changed;
2573 /* Copy this buffer's new multibyte status
2574 into all of its indirect buffers. */
2575 for (other = all_buffers; other; other = other->next)
2576 if (other->base_buffer == current_buffer && !NILP (other->name))
2578 other->enable_multibyte_characters
2579 = current_buffer->enable_multibyte_characters;
2580 other->prevent_redisplay_optimizations_p = 1;
2583 /* Restore the modifiedness of the buffer. */
2584 if (!modified_p && !NILP (Fbuffer_modified_p (Qnil)))
2585 Fset_buffer_modified_p (Qnil);
2587 #ifdef subprocesses
2588 /* Update coding systems of this buffer's process (if any). */
2590 Lisp_Object process;
2592 process = Fget_buffer_process (Fcurrent_buffer ());
2593 if (PROCESSP (process))
2594 setup_process_coding_systems (process);
2596 #endif /* subprocesses */
2598 return flag;
2601 DEFUN ("kill-all-local-variables", Fkill_all_local_variables, Skill_all_local_variables,
2602 0, 0, 0,
2603 doc: /* Switch to Fundamental mode by killing current buffer's local variables.
2604 Most local variable bindings are eliminated so that the default values
2605 become effective once more. Also, the syntax table is set from
2606 `standard-syntax-table', the local keymap is set to nil,
2607 and the abbrev table from `fundamental-mode-abbrev-table'.
2608 This function also forces redisplay of the mode line.
2610 Every function to select a new major mode starts by
2611 calling this function.
2613 As a special exception, local variables whose names have
2614 a non-nil `permanent-local' property are not eliminated by this function.
2616 The first thing this function does is run
2617 the normal hook `change-major-mode-hook'. */)
2620 if (!NILP (Vrun_hooks))
2621 call1 (Vrun_hooks, Qchange_major_mode_hook);
2623 /* Make sure none of the bindings in local_var_alist
2624 remain swapped in, in their symbols. */
2626 swap_out_buffer_local_variables (current_buffer);
2628 /* Actually eliminate all local bindings of this buffer. */
2630 reset_buffer_local_variables (current_buffer, 0);
2632 /* Force mode-line redisplay. Useful here because all major mode
2633 commands call this function. */
2634 update_mode_lines++;
2636 return Qnil;
2639 /* Make sure no local variables remain set up with buffer B
2640 for their current values. */
2642 static void
2643 swap_out_buffer_local_variables (b)
2644 struct buffer *b;
2646 Lisp_Object oalist, alist, sym, tem, buffer;
2648 XSETBUFFER (buffer, b);
2649 oalist = b->local_var_alist;
2651 for (alist = oalist; CONSP (alist); alist = XCDR (alist))
2653 sym = XCAR (XCAR (alist));
2655 /* Need not do anything if some other buffer's binding is now encached. */
2656 tem = XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->buffer;
2657 if (EQ (tem, buffer))
2659 /* Symbol is set up for this buffer's old local value:
2660 swap it out! */
2661 swap_in_global_binding (sym);
2666 /* Find all the overlays in the current buffer that contain position POS.
2667 Return the number found, and store them in a vector in *VEC_PTR.
2668 Store in *LEN_PTR the size allocated for the vector.
2669 Store in *NEXT_PTR the next position after POS where an overlay starts,
2670 or ZV if there are no more overlays between POS and ZV.
2671 Store in *PREV_PTR the previous position before POS where an overlay ends,
2672 or where an overlay starts which ends at or after POS;
2673 or BEGV if there are no such overlays from BEGV to POS.
2674 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2676 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2677 when this function is called.
2679 If EXTEND is non-zero, we make the vector bigger if necessary.
2680 If EXTEND is zero, we never extend the vector,
2681 and we store only as many overlays as will fit.
2682 But we still return the total number of overlays.
2684 If CHANGE_REQ is true, then any position written into *PREV_PTR or
2685 *NEXT_PTR is guaranteed to be not equal to POS, unless it is the
2686 default (BEGV or ZV). */
2689 overlays_at (pos, extend, vec_ptr, len_ptr, next_ptr, prev_ptr, change_req)
2690 EMACS_INT pos;
2691 int extend;
2692 Lisp_Object **vec_ptr;
2693 int *len_ptr;
2694 EMACS_INT *next_ptr;
2695 EMACS_INT *prev_ptr;
2696 int change_req;
2698 Lisp_Object overlay, start, end;
2699 struct Lisp_Overlay *tail;
2700 int idx = 0;
2701 int len = *len_ptr;
2702 Lisp_Object *vec = *vec_ptr;
2703 int next = ZV;
2704 int prev = BEGV;
2705 int inhibit_storing = 0;
2707 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2709 int startpos, endpos;
2711 XSETMISC (overlay, tail);
2713 start = OVERLAY_START (overlay);
2714 end = OVERLAY_END (overlay);
2715 endpos = OVERLAY_POSITION (end);
2716 if (endpos < pos)
2718 if (prev < endpos)
2719 prev = endpos;
2720 break;
2722 startpos = OVERLAY_POSITION (start);
2723 /* This one ends at or after POS
2724 so its start counts for PREV_PTR if it's before POS. */
2725 if (prev < startpos && startpos < pos)
2726 prev = startpos;
2727 if (endpos == pos)
2728 continue;
2729 if (startpos <= pos)
2731 if (idx == len)
2733 /* The supplied vector is full.
2734 Either make it bigger, or don't store any more in it. */
2735 if (extend)
2737 /* Make it work with an initial len == 0. */
2738 len *= 2;
2739 if (len == 0)
2740 len = 4;
2741 *len_ptr = len;
2742 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2743 *vec_ptr = vec;
2745 else
2746 inhibit_storing = 1;
2749 if (!inhibit_storing)
2750 vec[idx] = overlay;
2751 /* Keep counting overlays even if we can't return them all. */
2752 idx++;
2754 else if (startpos < next)
2755 next = startpos;
2758 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
2760 int startpos, endpos;
2762 XSETMISC (overlay, tail);
2764 start = OVERLAY_START (overlay);
2765 end = OVERLAY_END (overlay);
2766 startpos = OVERLAY_POSITION (start);
2767 if (pos < startpos)
2769 if (startpos < next)
2770 next = startpos;
2771 break;
2773 endpos = OVERLAY_POSITION (end);
2774 if (pos < endpos)
2776 if (idx == len)
2778 if (extend)
2780 /* Make it work with an initial len == 0. */
2781 len *= 2;
2782 if (len == 0)
2783 len = 4;
2784 *len_ptr = len;
2785 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2786 *vec_ptr = vec;
2788 else
2789 inhibit_storing = 1;
2792 if (!inhibit_storing)
2793 vec[idx] = overlay;
2794 idx++;
2796 if (startpos < pos && startpos > prev)
2797 prev = startpos;
2799 else if (endpos < pos && endpos > prev)
2800 prev = endpos;
2801 else if (endpos == pos && startpos > prev
2802 && (!change_req || startpos < pos))
2803 prev = startpos;
2806 if (next_ptr)
2807 *next_ptr = next;
2808 if (prev_ptr)
2809 *prev_ptr = prev;
2810 return idx;
2813 /* Find all the overlays in the current buffer that overlap the range BEG-END
2814 or are empty at BEG.
2816 Return the number found, and store them in a vector in *VEC_PTR.
2817 Store in *LEN_PTR the size allocated for the vector.
2818 Store in *NEXT_PTR the next position after POS where an overlay starts,
2819 or ZV if there are no more overlays.
2820 Store in *PREV_PTR the previous position before POS where an overlay ends,
2821 or BEGV if there are no previous overlays.
2822 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2824 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2825 when this function is called.
2827 If EXTEND is non-zero, we make the vector bigger if necessary.
2828 If EXTEND is zero, we never extend the vector,
2829 and we store only as many overlays as will fit.
2830 But we still return the total number of overlays. */
2832 static int
2833 overlays_in (beg, end, extend, vec_ptr, len_ptr, next_ptr, prev_ptr)
2834 int beg, end;
2835 int extend;
2836 Lisp_Object **vec_ptr;
2837 int *len_ptr;
2838 int *next_ptr;
2839 int *prev_ptr;
2841 Lisp_Object overlay, ostart, oend;
2842 struct Lisp_Overlay *tail;
2843 int idx = 0;
2844 int len = *len_ptr;
2845 Lisp_Object *vec = *vec_ptr;
2846 int next = ZV;
2847 int prev = BEGV;
2848 int inhibit_storing = 0;
2850 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2852 int startpos, endpos;
2854 XSETMISC (overlay, tail);
2856 ostart = OVERLAY_START (overlay);
2857 oend = OVERLAY_END (overlay);
2858 endpos = OVERLAY_POSITION (oend);
2859 if (endpos < beg)
2861 if (prev < endpos)
2862 prev = endpos;
2863 break;
2865 startpos = OVERLAY_POSITION (ostart);
2866 /* Count an interval if it either overlaps the range
2867 or is empty at the start of the range. */
2868 if ((beg < endpos && startpos < end)
2869 || (startpos == endpos && beg == endpos))
2871 if (idx == len)
2873 /* The supplied vector is full.
2874 Either make it bigger, or don't store any more in it. */
2875 if (extend)
2877 /* Make it work with an initial len == 0. */
2878 len *= 2;
2879 if (len == 0)
2880 len = 4;
2881 *len_ptr = len;
2882 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2883 *vec_ptr = vec;
2885 else
2886 inhibit_storing = 1;
2889 if (!inhibit_storing)
2890 vec[idx] = overlay;
2891 /* Keep counting overlays even if we can't return them all. */
2892 idx++;
2894 else if (startpos < next)
2895 next = startpos;
2898 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
2900 int startpos, endpos;
2902 XSETMISC (overlay, tail);
2904 ostart = OVERLAY_START (overlay);
2905 oend = OVERLAY_END (overlay);
2906 startpos = OVERLAY_POSITION (ostart);
2907 if (end < startpos)
2909 if (startpos < next)
2910 next = startpos;
2911 break;
2913 endpos = OVERLAY_POSITION (oend);
2914 /* Count an interval if it either overlaps the range
2915 or is empty at the start of the range. */
2916 if ((beg < endpos && startpos < end)
2917 || (startpos == endpos && beg == endpos))
2919 if (idx == len)
2921 if (extend)
2923 /* Make it work with an initial len == 0. */
2924 len *= 2;
2925 if (len == 0)
2926 len = 4;
2927 *len_ptr = len;
2928 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2929 *vec_ptr = vec;
2931 else
2932 inhibit_storing = 1;
2935 if (!inhibit_storing)
2936 vec[idx] = overlay;
2937 idx++;
2939 else if (endpos < beg && endpos > prev)
2940 prev = endpos;
2943 if (next_ptr)
2944 *next_ptr = next;
2945 if (prev_ptr)
2946 *prev_ptr = prev;
2947 return idx;
2951 /* Return non-zero if there exists an overlay with a non-nil
2952 `mouse-face' property overlapping OVERLAY. */
2955 mouse_face_overlay_overlaps (overlay)
2956 Lisp_Object overlay;
2958 int start = OVERLAY_POSITION (OVERLAY_START (overlay));
2959 int end = OVERLAY_POSITION (OVERLAY_END (overlay));
2960 int n, i, size;
2961 Lisp_Object *v, tem;
2963 size = 10;
2964 v = (Lisp_Object *) alloca (size * sizeof *v);
2965 n = overlays_in (start, end, 0, &v, &size, NULL, NULL);
2966 if (n > size)
2968 v = (Lisp_Object *) alloca (n * sizeof *v);
2969 overlays_in (start, end, 0, &v, &n, NULL, NULL);
2972 for (i = 0; i < n; ++i)
2973 if (!EQ (v[i], overlay)
2974 && (tem = Foverlay_get (overlay, Qmouse_face),
2975 !NILP (tem)))
2976 break;
2978 return i < n;
2983 /* Fast function to just test if we're at an overlay boundary. */
2985 overlay_touches_p (pos)
2986 int pos;
2988 Lisp_Object overlay;
2989 struct Lisp_Overlay *tail;
2991 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
2993 int endpos;
2995 XSETMISC (overlay ,tail);
2996 if (!OVERLAYP (overlay))
2997 abort ();
2999 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3000 if (endpos < pos)
3001 break;
3002 if (endpos == pos || OVERLAY_POSITION (OVERLAY_START (overlay)) == pos)
3003 return 1;
3006 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
3008 int startpos;
3010 XSETMISC (overlay, tail);
3011 if (!OVERLAYP (overlay))
3012 abort ();
3014 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3015 if (pos < startpos)
3016 break;
3017 if (startpos == pos || OVERLAY_POSITION (OVERLAY_END (overlay)) == pos)
3018 return 1;
3020 return 0;
3023 struct sortvec
3025 Lisp_Object overlay;
3026 int beg, end;
3027 int priority;
3030 static int
3031 compare_overlays (v1, v2)
3032 const void *v1, *v2;
3034 const struct sortvec *s1 = (const struct sortvec *) v1;
3035 const struct sortvec *s2 = (const struct sortvec *) v2;
3036 if (s1->priority != s2->priority)
3037 return s1->priority - s2->priority;
3038 if (s1->beg != s2->beg)
3039 return s1->beg - s2->beg;
3040 if (s1->end != s2->end)
3041 return s2->end - s1->end;
3042 return 0;
3045 /* Sort an array of overlays by priority. The array is modified in place.
3046 The return value is the new size; this may be smaller than the original
3047 size if some of the overlays were invalid or were window-specific. */
3049 sort_overlays (overlay_vec, noverlays, w)
3050 Lisp_Object *overlay_vec;
3051 int noverlays;
3052 struct window *w;
3054 int i, j;
3055 struct sortvec *sortvec;
3056 sortvec = (struct sortvec *) alloca (noverlays * sizeof (struct sortvec));
3058 /* Put the valid and relevant overlays into sortvec. */
3060 for (i = 0, j = 0; i < noverlays; i++)
3062 Lisp_Object tem;
3063 Lisp_Object overlay;
3065 overlay = overlay_vec[i];
3066 if (OVERLAY_VALID (overlay)
3067 && OVERLAY_POSITION (OVERLAY_START (overlay)) > 0
3068 && OVERLAY_POSITION (OVERLAY_END (overlay)) > 0)
3070 /* If we're interested in a specific window, then ignore
3071 overlays that are limited to some other window. */
3072 if (w)
3074 Lisp_Object window;
3076 window = Foverlay_get (overlay, Qwindow);
3077 if (WINDOWP (window) && XWINDOW (window) != w)
3078 continue;
3081 /* This overlay is good and counts: put it into sortvec. */
3082 sortvec[j].overlay = overlay;
3083 sortvec[j].beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3084 sortvec[j].end = OVERLAY_POSITION (OVERLAY_END (overlay));
3085 tem = Foverlay_get (overlay, Qpriority);
3086 if (INTEGERP (tem))
3087 sortvec[j].priority = XINT (tem);
3088 else
3089 sortvec[j].priority = 0;
3090 j++;
3093 noverlays = j;
3095 /* Sort the overlays into the proper order: increasing priority. */
3097 if (noverlays > 1)
3098 qsort (sortvec, noverlays, sizeof (struct sortvec), compare_overlays);
3100 for (i = 0; i < noverlays; i++)
3101 overlay_vec[i] = sortvec[i].overlay;
3102 return (noverlays);
3105 struct sortstr
3107 Lisp_Object string, string2;
3108 int size;
3109 int priority;
3112 struct sortstrlist
3114 struct sortstr *buf; /* An array that expands as needed; never freed. */
3115 int size; /* Allocated length of that array. */
3116 int used; /* How much of the array is currently in use. */
3117 int bytes; /* Total length of the strings in buf. */
3120 /* Buffers for storing information about the overlays touching a given
3121 position. These could be automatic variables in overlay_strings, but
3122 it's more efficient to hold onto the memory instead of repeatedly
3123 allocating and freeing it. */
3124 static struct sortstrlist overlay_heads, overlay_tails;
3125 static unsigned char *overlay_str_buf;
3127 /* Allocated length of overlay_str_buf. */
3128 static int overlay_str_len;
3130 /* A comparison function suitable for passing to qsort. */
3131 static int
3132 cmp_for_strings (as1, as2)
3133 char *as1, *as2;
3135 struct sortstr *s1 = (struct sortstr *)as1;
3136 struct sortstr *s2 = (struct sortstr *)as2;
3137 if (s1->size != s2->size)
3138 return s2->size - s1->size;
3139 if (s1->priority != s2->priority)
3140 return s1->priority - s2->priority;
3141 return 0;
3144 static void
3145 record_overlay_string (ssl, str, str2, pri, size)
3146 struct sortstrlist *ssl;
3147 Lisp_Object str, str2, pri;
3148 int size;
3150 int nbytes;
3152 if (ssl->used == ssl->size)
3154 if (ssl->buf)
3155 ssl->size *= 2;
3156 else
3157 ssl->size = 5;
3158 ssl->buf = ((struct sortstr *)
3159 xrealloc (ssl->buf, ssl->size * sizeof (struct sortstr)));
3161 ssl->buf[ssl->used].string = str;
3162 ssl->buf[ssl->used].string2 = str2;
3163 ssl->buf[ssl->used].size = size;
3164 ssl->buf[ssl->used].priority = (INTEGERP (pri) ? XINT (pri) : 0);
3165 ssl->used++;
3167 if (NILP (current_buffer->enable_multibyte_characters))
3168 nbytes = SCHARS (str);
3169 else if (! STRING_MULTIBYTE (str))
3170 nbytes = count_size_as_multibyte (SDATA (str),
3171 SBYTES (str));
3172 else
3173 nbytes = SBYTES (str);
3175 ssl->bytes += nbytes;
3177 if (STRINGP (str2))
3179 if (NILP (current_buffer->enable_multibyte_characters))
3180 nbytes = SCHARS (str2);
3181 else if (! STRING_MULTIBYTE (str2))
3182 nbytes = count_size_as_multibyte (SDATA (str2),
3183 SBYTES (str2));
3184 else
3185 nbytes = SBYTES (str2);
3187 ssl->bytes += nbytes;
3191 /* Return the concatenation of the strings associated with overlays that
3192 begin or end at POS, ignoring overlays that are specific to a window
3193 other than W. The strings are concatenated in the appropriate order:
3194 shorter overlays nest inside longer ones, and higher priority inside
3195 lower. Normally all of the after-strings come first, but zero-sized
3196 overlays have their after-strings ride along with the before-strings
3197 because it would look strange to print them inside-out.
3199 Returns the string length, and stores the contents indirectly through
3200 PSTR, if that variable is non-null. The string may be overwritten by
3201 subsequent calls. */
3204 overlay_strings (pos, w, pstr)
3205 EMACS_INT pos;
3206 struct window *w;
3207 unsigned char **pstr;
3209 Lisp_Object overlay, window, str;
3210 struct Lisp_Overlay *ov;
3211 int startpos, endpos;
3212 int multibyte = ! NILP (current_buffer->enable_multibyte_characters);
3214 overlay_heads.used = overlay_heads.bytes = 0;
3215 overlay_tails.used = overlay_tails.bytes = 0;
3216 for (ov = current_buffer->overlays_before; ov; ov = ov->next)
3218 XSETMISC (overlay, ov);
3219 eassert (OVERLAYP (overlay));
3221 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3222 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3223 if (endpos < pos)
3224 break;
3225 if (endpos != pos && startpos != pos)
3226 continue;
3227 window = Foverlay_get (overlay, Qwindow);
3228 if (WINDOWP (window) && XWINDOW (window) != w)
3229 continue;
3230 if (startpos == pos
3231 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3232 record_overlay_string (&overlay_heads, str,
3233 (startpos == endpos
3234 ? Foverlay_get (overlay, Qafter_string)
3235 : Qnil),
3236 Foverlay_get (overlay, Qpriority),
3237 endpos - startpos);
3238 else if (endpos == pos
3239 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3240 record_overlay_string (&overlay_tails, str, Qnil,
3241 Foverlay_get (overlay, Qpriority),
3242 endpos - startpos);
3244 for (ov = current_buffer->overlays_after; ov; ov = ov->next)
3246 XSETMISC (overlay, ov);
3247 eassert (OVERLAYP (overlay));
3249 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3250 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3251 if (startpos > pos)
3252 break;
3253 if (endpos != pos && startpos != pos)
3254 continue;
3255 window = Foverlay_get (overlay, Qwindow);
3256 if (WINDOWP (window) && XWINDOW (window) != w)
3257 continue;
3258 if (startpos == pos
3259 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3260 record_overlay_string (&overlay_heads, str,
3261 (startpos == endpos
3262 ? Foverlay_get (overlay, Qafter_string)
3263 : Qnil),
3264 Foverlay_get (overlay, Qpriority),
3265 endpos - startpos);
3266 else if (endpos == pos
3267 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3268 record_overlay_string (&overlay_tails, str, Qnil,
3269 Foverlay_get (overlay, Qpriority),
3270 endpos - startpos);
3272 if (overlay_tails.used > 1)
3273 qsort (overlay_tails.buf, overlay_tails.used, sizeof (struct sortstr),
3274 cmp_for_strings);
3275 if (overlay_heads.used > 1)
3276 qsort (overlay_heads.buf, overlay_heads.used, sizeof (struct sortstr),
3277 cmp_for_strings);
3278 if (overlay_heads.bytes || overlay_tails.bytes)
3280 Lisp_Object tem;
3281 int i;
3282 unsigned char *p;
3283 int total = overlay_heads.bytes + overlay_tails.bytes;
3285 if (total > overlay_str_len)
3287 overlay_str_len = total;
3288 overlay_str_buf = (unsigned char *)xrealloc (overlay_str_buf,
3289 total);
3291 p = overlay_str_buf;
3292 for (i = overlay_tails.used; --i >= 0;)
3294 int nbytes;
3295 tem = overlay_tails.buf[i].string;
3296 nbytes = copy_text (SDATA (tem), p,
3297 SBYTES (tem),
3298 STRING_MULTIBYTE (tem), multibyte);
3299 p += nbytes;
3301 for (i = 0; i < overlay_heads.used; ++i)
3303 int nbytes;
3304 tem = overlay_heads.buf[i].string;
3305 nbytes = copy_text (SDATA (tem), p,
3306 SBYTES (tem),
3307 STRING_MULTIBYTE (tem), multibyte);
3308 p += nbytes;
3309 tem = overlay_heads.buf[i].string2;
3310 if (STRINGP (tem))
3312 nbytes = copy_text (SDATA (tem), p,
3313 SBYTES (tem),
3314 STRING_MULTIBYTE (tem), multibyte);
3315 p += nbytes;
3318 if (p != overlay_str_buf + total)
3319 abort ();
3320 if (pstr)
3321 *pstr = overlay_str_buf;
3322 return total;
3324 return 0;
3327 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
3329 void
3330 recenter_overlay_lists (buf, pos)
3331 struct buffer *buf;
3332 EMACS_INT pos;
3334 Lisp_Object overlay, beg, end;
3335 struct Lisp_Overlay *prev, *tail, *next;
3337 /* See if anything in overlays_before should move to overlays_after. */
3339 /* We don't strictly need prev in this loop; it should always be nil.
3340 But we use it for symmetry and in case that should cease to be true
3341 with some future change. */
3342 prev = NULL;
3343 for (tail = buf->overlays_before; tail; prev = tail, tail = next)
3345 next = tail->next;
3346 XSETMISC (overlay, tail);
3348 /* If the overlay is not valid, get rid of it. */
3349 if (!OVERLAY_VALID (overlay))
3350 #if 1
3351 abort ();
3352 #else
3354 /* Splice the cons cell TAIL out of overlays_before. */
3355 if (!NILP (prev))
3356 XCDR (prev) = next;
3357 else
3358 buf->overlays_before = next;
3359 tail = prev;
3360 continue;
3362 #endif
3364 beg = OVERLAY_START (overlay);
3365 end = OVERLAY_END (overlay);
3367 if (OVERLAY_POSITION (end) > pos)
3369 /* OVERLAY needs to be moved. */
3370 int where = OVERLAY_POSITION (beg);
3371 struct Lisp_Overlay *other, *other_prev;
3373 /* Splice the cons cell TAIL out of overlays_before. */
3374 if (prev)
3375 prev->next = next;
3376 else
3377 buf->overlays_before = next;
3379 /* Search thru overlays_after for where to put it. */
3380 other_prev = NULL;
3381 for (other = buf->overlays_after; other;
3382 other_prev = other, other = other->next)
3384 Lisp_Object otherbeg, otheroverlay;
3386 XSETMISC (otheroverlay, other);
3387 eassert (OVERLAY_VALID (otheroverlay));
3389 otherbeg = OVERLAY_START (otheroverlay);
3390 if (OVERLAY_POSITION (otherbeg) >= where)
3391 break;
3394 /* Add TAIL to overlays_after before OTHER. */
3395 tail->next = other;
3396 if (other_prev)
3397 other_prev->next = tail;
3398 else
3399 buf->overlays_after = tail;
3400 tail = prev;
3402 else
3403 /* We've reached the things that should stay in overlays_before.
3404 All the rest of overlays_before must end even earlier,
3405 so stop now. */
3406 break;
3409 /* See if anything in overlays_after should be in overlays_before. */
3410 prev = NULL;
3411 for (tail = buf->overlays_after; tail; prev = tail, tail = next)
3413 next = tail->next;
3414 XSETMISC (overlay, tail);
3416 /* If the overlay is not valid, get rid of it. */
3417 if (!OVERLAY_VALID (overlay))
3418 #if 1
3419 abort ();
3420 #else
3422 /* Splice the cons cell TAIL out of overlays_after. */
3423 if (!NILP (prev))
3424 XCDR (prev) = next;
3425 else
3426 buf->overlays_after = next;
3427 tail = prev;
3428 continue;
3430 #endif
3432 beg = OVERLAY_START (overlay);
3433 end = OVERLAY_END (overlay);
3435 /* Stop looking, when we know that nothing further
3436 can possibly end before POS. */
3437 if (OVERLAY_POSITION (beg) > pos)
3438 break;
3440 if (OVERLAY_POSITION (end) <= pos)
3442 /* OVERLAY needs to be moved. */
3443 int where = OVERLAY_POSITION (end);
3444 struct Lisp_Overlay *other, *other_prev;
3446 /* Splice the cons cell TAIL out of overlays_after. */
3447 if (prev)
3448 prev->next = next;
3449 else
3450 buf->overlays_after = next;
3452 /* Search thru overlays_before for where to put it. */
3453 other_prev = NULL;
3454 for (other = buf->overlays_before; other;
3455 other_prev = other, other = other->next)
3457 Lisp_Object otherend, otheroverlay;
3459 XSETMISC (otheroverlay, other);
3460 eassert (OVERLAY_VALID (otheroverlay));
3462 otherend = OVERLAY_END (otheroverlay);
3463 if (OVERLAY_POSITION (otherend) <= where)
3464 break;
3467 /* Add TAIL to overlays_before before OTHER. */
3468 tail->next = other;
3469 if (other_prev)
3470 other_prev->next = tail;
3471 else
3472 buf->overlays_before = tail;
3473 tail = prev;
3477 buf->overlay_center = pos;
3480 void
3481 adjust_overlays_for_insert (pos, length)
3482 EMACS_INT pos;
3483 EMACS_INT length;
3485 /* After an insertion, the lists are still sorted properly,
3486 but we may need to update the value of the overlay center. */
3487 if (current_buffer->overlay_center >= pos)
3488 current_buffer->overlay_center += length;
3491 void
3492 adjust_overlays_for_delete (pos, length)
3493 EMACS_INT pos;
3494 EMACS_INT length;
3496 if (current_buffer->overlay_center < pos)
3497 /* The deletion was to our right. No change needed; the before- and
3498 after-lists are still consistent. */
3500 else if (current_buffer->overlay_center > pos + length)
3501 /* The deletion was to our left. We need to adjust the center value
3502 to account for the change in position, but the lists are consistent
3503 given the new value. */
3504 current_buffer->overlay_center -= length;
3505 else
3506 /* We're right in the middle. There might be things on the after-list
3507 that now belong on the before-list. Recentering will move them,
3508 and also update the center point. */
3509 recenter_overlay_lists (current_buffer, pos);
3512 /* Fix up overlays that were garbled as a result of permuting markers
3513 in the range START through END. Any overlay with at least one
3514 endpoint in this range will need to be unlinked from the overlay
3515 list and reinserted in its proper place.
3516 Such an overlay might even have negative size at this point.
3517 If so, we'll make the overlay empty. */
3518 void
3519 fix_start_end_in_overlays (start, end)
3520 register int start, end;
3522 Lisp_Object overlay;
3523 struct Lisp_Overlay *before_list, *after_list;
3524 /* These are either nil, indicating that before_list or after_list
3525 should be assigned, or the cons cell the cdr of which should be
3526 assigned. */
3527 struct Lisp_Overlay *beforep = NULL, *afterp = NULL;
3528 /* 'Parent', likewise, indicates a cons cell or
3529 current_buffer->overlays_before or overlays_after, depending
3530 which loop we're in. */
3531 struct Lisp_Overlay *tail, *parent;
3532 int startpos, endpos;
3534 /* This algorithm shifts links around instead of consing and GCing.
3535 The loop invariant is that before_list (resp. after_list) is a
3536 well-formed list except that its last element, the CDR of beforep
3537 (resp. afterp) if beforep (afterp) isn't nil or before_list
3538 (after_list) if it is, is still uninitialized. So it's not a bug
3539 that before_list isn't initialized, although it may look
3540 strange. */
3541 for (parent = NULL, tail = current_buffer->overlays_before; tail;)
3543 XSETMISC (overlay, tail);
3545 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3546 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3548 /* If the overlay is backwards, make it empty. */
3549 if (endpos < startpos)
3551 startpos = endpos;
3552 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3553 Qnil);
3556 if (endpos < start)
3557 break;
3559 if (endpos < end
3560 || (startpos >= start && startpos < end))
3562 /* Add it to the end of the wrong list. Later on,
3563 recenter_overlay_lists will move it to the right place. */
3564 if (endpos < current_buffer->overlay_center)
3566 if (!afterp)
3567 after_list = tail;
3568 else
3569 afterp->next = tail;
3570 afterp = tail;
3572 else
3574 if (!beforep)
3575 before_list = tail;
3576 else
3577 beforep->next = tail;
3578 beforep = tail;
3580 if (!parent)
3581 current_buffer->overlays_before = tail->next;
3582 else
3583 parent->next = tail->next;
3584 tail = tail->next;
3586 else
3587 parent = tail, tail = parent->next;
3589 for (parent = NULL, tail = current_buffer->overlays_after; tail;)
3591 XSETMISC (overlay, tail);
3593 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3594 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3596 /* If the overlay is backwards, make it empty. */
3597 if (endpos < startpos)
3599 startpos = endpos;
3600 Fset_marker (OVERLAY_START (overlay), make_number (startpos),
3601 Qnil);
3604 if (startpos >= end)
3605 break;
3607 if (startpos >= start
3608 || (endpos >= start && endpos < end))
3610 if (endpos < current_buffer->overlay_center)
3612 if (!afterp)
3613 after_list = tail;
3614 else
3615 afterp->next = tail;
3616 afterp = tail;
3618 else
3620 if (!beforep)
3621 before_list = tail;
3622 else
3623 beforep->next = tail;
3624 beforep = tail;
3626 if (!parent)
3627 current_buffer->overlays_after = tail->next;
3628 else
3629 parent->next = tail->next;
3630 tail = tail->next;
3632 else
3633 parent = tail, tail = parent->next;
3636 /* Splice the constructed (wrong) lists into the buffer's lists,
3637 and let the recenter function make it sane again. */
3638 if (beforep)
3640 beforep->next = current_buffer->overlays_before;
3641 current_buffer->overlays_before = before_list;
3643 recenter_overlay_lists (current_buffer, current_buffer->overlay_center);
3645 if (afterp)
3647 afterp->next = current_buffer->overlays_after;
3648 current_buffer->overlays_after = after_list;
3650 recenter_overlay_lists (current_buffer, current_buffer->overlay_center);
3653 /* We have two types of overlay: the one whose ending marker is
3654 after-insertion-marker (this is the usual case) and the one whose
3655 ending marker is before-insertion-marker. When `overlays_before'
3656 contains overlays of the latter type and the former type in this
3657 order and both overlays end at inserting position, inserting a text
3658 increases only the ending marker of the latter type, which results
3659 in incorrect ordering of `overlays_before'.
3661 This function fixes ordering of overlays in the slot
3662 `overlays_before' of the buffer *BP. Before the insertion, `point'
3663 was at PREV, and now is at POS. */
3665 void
3666 fix_overlays_before (bp, prev, pos)
3667 struct buffer *bp;
3668 EMACS_INT prev, pos;
3670 /* If parent is nil, replace overlays_before; otherwise, parent->next. */
3671 struct Lisp_Overlay *tail = bp->overlays_before, *parent = NULL, *right_pair;
3672 Lisp_Object tem;
3673 EMACS_INT end;
3675 /* After the insertion, the several overlays may be in incorrect
3676 order. The possibility is that, in the list `overlays_before',
3677 an overlay which ends at POS appears after an overlay which ends
3678 at PREV. Since POS is greater than PREV, we must fix the
3679 ordering of these overlays, by moving overlays ends at POS before
3680 the overlays ends at PREV. */
3682 /* At first, find a place where disordered overlays should be linked
3683 in. It is where an overlay which end before POS exists. (i.e. an
3684 overlay whose ending marker is after-insertion-marker if disorder
3685 exists). */
3686 while (tail
3687 && (XSETMISC (tem, tail),
3688 (end = OVERLAY_POSITION (OVERLAY_END (tem))) >= pos))
3690 parent = tail;
3691 tail = tail->next;
3694 /* If we don't find such an overlay,
3695 or the found one ends before PREV,
3696 or the found one is the last one in the list,
3697 we don't have to fix anything. */
3698 if (!tail || end < prev || !tail->next)
3699 return;
3701 right_pair = parent;
3702 parent = tail;
3703 tail = tail->next;
3705 /* Now, end position of overlays in the list TAIL should be before
3706 or equal to PREV. In the loop, an overlay which ends at POS is
3707 moved ahead to the place indicated by the CDR of RIGHT_PAIR. If
3708 we found an overlay which ends before PREV, the remaining
3709 overlays are in correct order. */
3710 while (tail)
3712 XSETMISC (tem, tail);
3713 end = OVERLAY_POSITION (OVERLAY_END (tem));
3715 if (end == pos)
3716 { /* This overlay is disordered. */
3717 struct Lisp_Overlay *found = tail;
3719 /* Unlink the found overlay. */
3720 tail = found->next;
3721 parent->next = tail;
3722 /* Move an overlay at RIGHT_PLACE to the next of the found one,
3723 and link it into the right place. */
3724 if (!right_pair)
3726 found->next = bp->overlays_before;
3727 bp->overlays_before = found;
3729 else
3731 found->next = right_pair->next;
3732 right_pair->next = found;
3735 else if (end == prev)
3737 parent = tail;
3738 tail = tail->next;
3740 else /* No more disordered overlay. */
3741 break;
3745 DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
3746 doc: /* Return t if OBJECT is an overlay. */)
3747 (object)
3748 Lisp_Object object;
3750 return (OVERLAYP (object) ? Qt : Qnil);
3753 DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 5, 0,
3754 doc: /* Create a new overlay with range BEG to END in BUFFER.
3755 If omitted, BUFFER defaults to the current buffer.
3756 BEG and END may be integers or markers.
3757 The fourth arg FRONT-ADVANCE, if non-nil, makes the marker
3758 for the front of the overlay advance when text is inserted there
3759 \(which means the text *is not* included in the overlay).
3760 The fifth arg REAR-ADVANCE, if non-nil, makes the marker
3761 for the rear of the overlay advance when text is inserted there
3762 \(which means the text *is* included in the overlay). */)
3763 (beg, end, buffer, front_advance, rear_advance)
3764 Lisp_Object beg, end, buffer;
3765 Lisp_Object front_advance, rear_advance;
3767 Lisp_Object overlay;
3768 struct buffer *b;
3770 if (NILP (buffer))
3771 XSETBUFFER (buffer, current_buffer);
3772 else
3773 CHECK_BUFFER (buffer);
3774 if (MARKERP (beg)
3775 && ! EQ (Fmarker_buffer (beg), buffer))
3776 error ("Marker points into wrong buffer");
3777 if (MARKERP (end)
3778 && ! EQ (Fmarker_buffer (end), buffer))
3779 error ("Marker points into wrong buffer");
3781 CHECK_NUMBER_COERCE_MARKER (beg);
3782 CHECK_NUMBER_COERCE_MARKER (end);
3784 if (XINT (beg) > XINT (end))
3786 Lisp_Object temp;
3787 temp = beg; beg = end; end = temp;
3790 b = XBUFFER (buffer);
3792 beg = Fset_marker (Fmake_marker (), beg, buffer);
3793 end = Fset_marker (Fmake_marker (), end, buffer);
3795 if (!NILP (front_advance))
3796 XMARKER (beg)->insertion_type = 1;
3797 if (!NILP (rear_advance))
3798 XMARKER (end)->insertion_type = 1;
3800 overlay = allocate_misc ();
3801 XMISCTYPE (overlay) = Lisp_Misc_Overlay;
3802 XOVERLAY (overlay)->start = beg;
3803 XOVERLAY (overlay)->end = end;
3804 XOVERLAY (overlay)->plist = Qnil;
3805 XOVERLAY (overlay)->next = NULL;
3807 /* Put the new overlay on the wrong list. */
3808 end = OVERLAY_END (overlay);
3809 if (OVERLAY_POSITION (end) < b->overlay_center)
3811 if (b->overlays_after)
3812 XOVERLAY (overlay)->next = b->overlays_after;
3813 b->overlays_after = XOVERLAY (overlay);
3815 else
3817 if (b->overlays_before)
3818 XOVERLAY (overlay)->next = b->overlays_before;
3819 b->overlays_before = XOVERLAY (overlay);
3822 /* This puts it in the right list, and in the right order. */
3823 recenter_overlay_lists (b, b->overlay_center);
3825 /* We don't need to redisplay the region covered by the overlay, because
3826 the overlay has no properties at the moment. */
3828 return overlay;
3831 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3833 static void
3834 modify_overlay (buf, start, end)
3835 struct buffer *buf;
3836 EMACS_INT start, end;
3838 if (start > end)
3840 int temp = start;
3841 start = end;
3842 end = temp;
3845 BUF_COMPUTE_UNCHANGED (buf, start, end);
3847 /* If this is a buffer not in the selected window,
3848 we must do other windows. */
3849 if (buf != XBUFFER (XWINDOW (selected_window)->buffer))
3850 windows_or_buffers_changed = 1;
3851 /* If multiple windows show this buffer, we must do other windows. */
3852 else if (buffer_shared > 1)
3853 windows_or_buffers_changed = 1;
3854 /* If we modify an overlay at the end of the buffer, we cannot
3855 be sure that window end is still valid. */
3856 else if (end >= ZV && start <= ZV)
3857 windows_or_buffers_changed = 1;
3859 ++BUF_OVERLAY_MODIFF (buf);
3863 Lisp_Object Fdelete_overlay ();
3865 static struct Lisp_Overlay *
3866 unchain_overlay (list, overlay)
3867 struct Lisp_Overlay *list, *overlay;
3869 struct Lisp_Overlay *tmp, *prev;
3870 for (tmp = list, prev = NULL; tmp; prev = tmp, tmp = tmp->next)
3871 if (tmp == overlay)
3873 if (prev)
3874 prev->next = tmp->next;
3875 else
3876 list = tmp->next;
3877 overlay->next = NULL;
3878 break;
3880 return list;
3883 DEFUN ("move-overlay", Fmove_overlay, Smove_overlay, 3, 4, 0,
3884 doc: /* Set the endpoints of OVERLAY to BEG and END in BUFFER.
3885 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
3886 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
3887 buffer. */)
3888 (overlay, beg, end, buffer)
3889 Lisp_Object overlay, beg, end, buffer;
3891 struct buffer *b, *ob;
3892 Lisp_Object obuffer;
3893 int count = SPECPDL_INDEX ();
3895 CHECK_OVERLAY (overlay);
3896 if (NILP (buffer))
3897 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3898 if (NILP (buffer))
3899 XSETBUFFER (buffer, current_buffer);
3900 CHECK_BUFFER (buffer);
3902 if (MARKERP (beg)
3903 && ! EQ (Fmarker_buffer (beg), buffer))
3904 error ("Marker points into wrong buffer");
3905 if (MARKERP (end)
3906 && ! EQ (Fmarker_buffer (end), buffer))
3907 error ("Marker points into wrong buffer");
3909 CHECK_NUMBER_COERCE_MARKER (beg);
3910 CHECK_NUMBER_COERCE_MARKER (end);
3912 if (XINT (beg) == XINT (end) && ! NILP (Foverlay_get (overlay, Qevaporate)))
3913 return Fdelete_overlay (overlay);
3915 if (XINT (beg) > XINT (end))
3917 Lisp_Object temp;
3918 temp = beg; beg = end; end = temp;
3921 specbind (Qinhibit_quit, Qt);
3923 obuffer = Fmarker_buffer (OVERLAY_START (overlay));
3924 b = XBUFFER (buffer);
3925 ob = BUFFERP (obuffer) ? XBUFFER (obuffer) : (struct buffer *) 0;
3927 /* If the overlay has changed buffers, do a thorough redisplay. */
3928 if (!EQ (buffer, obuffer))
3930 /* Redisplay where the overlay was. */
3931 if (!NILP (obuffer))
3933 int o_beg;
3934 int o_end;
3936 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3937 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3939 modify_overlay (ob, o_beg, o_end);
3942 /* Redisplay where the overlay is going to be. */
3943 modify_overlay (b, XINT (beg), XINT (end));
3945 else
3946 /* Redisplay the area the overlay has just left, or just enclosed. */
3948 int o_beg, o_end;
3950 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3951 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3953 if (o_beg == XINT (beg))
3954 modify_overlay (b, o_end, XINT (end));
3955 else if (o_end == XINT (end))
3956 modify_overlay (b, o_beg, XINT (beg));
3957 else
3959 if (XINT (beg) < o_beg) o_beg = XINT (beg);
3960 if (XINT (end) > o_end) o_end = XINT (end);
3961 modify_overlay (b, o_beg, o_end);
3965 if (!NILP (obuffer))
3967 ob->overlays_before
3968 = unchain_overlay (ob->overlays_before, XOVERLAY (overlay));
3969 ob->overlays_after
3970 = unchain_overlay (ob->overlays_after, XOVERLAY (overlay));
3971 eassert (XOVERLAY (overlay)->next == NULL);
3974 Fset_marker (OVERLAY_START (overlay), beg, buffer);
3975 Fset_marker (OVERLAY_END (overlay), end, buffer);
3977 /* Put the overlay on the wrong list. */
3978 end = OVERLAY_END (overlay);
3979 if (OVERLAY_POSITION (end) < b->overlay_center)
3981 XOVERLAY (overlay)->next = b->overlays_after;
3982 b->overlays_after = XOVERLAY (overlay);
3984 else
3986 XOVERLAY (overlay)->next = b->overlays_before;
3987 b->overlays_before = XOVERLAY (overlay);
3990 /* This puts it in the right list, and in the right order. */
3991 recenter_overlay_lists (b, b->overlay_center);
3993 return unbind_to (count, overlay);
3996 DEFUN ("delete-overlay", Fdelete_overlay, Sdelete_overlay, 1, 1, 0,
3997 doc: /* Delete the overlay OVERLAY from its buffer. */)
3998 (overlay)
3999 Lisp_Object overlay;
4001 Lisp_Object buffer;
4002 struct buffer *b;
4003 int count = SPECPDL_INDEX ();
4005 CHECK_OVERLAY (overlay);
4007 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4008 if (NILP (buffer))
4009 return Qnil;
4011 b = XBUFFER (buffer);
4012 specbind (Qinhibit_quit, Qt);
4014 b->overlays_before = unchain_overlay (b->overlays_before,XOVERLAY (overlay));
4015 b->overlays_after = unchain_overlay (b->overlays_after, XOVERLAY (overlay));
4016 eassert (XOVERLAY (overlay)->next == NULL);
4017 modify_overlay (b,
4018 marker_position (OVERLAY_START (overlay)),
4019 marker_position (OVERLAY_END (overlay)));
4020 Fset_marker (OVERLAY_START (overlay), Qnil, Qnil);
4021 Fset_marker (OVERLAY_END (overlay), Qnil, Qnil);
4023 /* When deleting an overlay with before or after strings, turn off
4024 display optimizations for the affected buffer, on the basis that
4025 these strings may contain newlines. This is easier to do than to
4026 check for that situation during redisplay. */
4027 if (!windows_or_buffers_changed
4028 && (!NILP (Foverlay_get (overlay, Qbefore_string))
4029 || !NILP (Foverlay_get (overlay, Qafter_string))))
4030 b->prevent_redisplay_optimizations_p = 1;
4032 return unbind_to (count, Qnil);
4035 /* Overlay dissection functions. */
4037 DEFUN ("overlay-start", Foverlay_start, Soverlay_start, 1, 1, 0,
4038 doc: /* Return the position at which OVERLAY starts. */)
4039 (overlay)
4040 Lisp_Object overlay;
4042 CHECK_OVERLAY (overlay);
4044 return (Fmarker_position (OVERLAY_START (overlay)));
4047 DEFUN ("overlay-end", Foverlay_end, Soverlay_end, 1, 1, 0,
4048 doc: /* Return the position at which OVERLAY ends. */)
4049 (overlay)
4050 Lisp_Object overlay;
4052 CHECK_OVERLAY (overlay);
4054 return (Fmarker_position (OVERLAY_END (overlay)));
4057 DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
4058 doc: /* Return the buffer OVERLAY belongs to.
4059 Return nil if OVERLAY has been deleted. */)
4060 (overlay)
4061 Lisp_Object overlay;
4063 CHECK_OVERLAY (overlay);
4065 return Fmarker_buffer (OVERLAY_START (overlay));
4068 DEFUN ("overlay-properties", Foverlay_properties, Soverlay_properties, 1, 1, 0,
4069 doc: /* Return a list of the properties on OVERLAY.
4070 This is a copy of OVERLAY's plist; modifying its conses has no effect on
4071 OVERLAY. */)
4072 (overlay)
4073 Lisp_Object overlay;
4075 CHECK_OVERLAY (overlay);
4077 return Fcopy_sequence (XOVERLAY (overlay)->plist);
4081 DEFUN ("overlays-at", Foverlays_at, Soverlays_at, 1, 1, 0,
4082 doc: /* Return a list of the overlays that contain the character at POS. */)
4083 (pos)
4084 Lisp_Object pos;
4086 int noverlays;
4087 Lisp_Object *overlay_vec;
4088 int len;
4089 Lisp_Object result;
4091 CHECK_NUMBER_COERCE_MARKER (pos);
4093 len = 10;
4094 /* We can't use alloca here because overlays_at can call xrealloc. */
4095 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
4097 /* Put all the overlays we want in a vector in overlay_vec.
4098 Store the length in len. */
4099 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4100 (EMACS_INT *) 0, (EMACS_INT *) 0, 0);
4102 /* Make a list of them all. */
4103 result = Flist (noverlays, overlay_vec);
4105 xfree (overlay_vec);
4106 return result;
4109 DEFUN ("overlays-in", Foverlays_in, Soverlays_in, 2, 2, 0,
4110 doc: /* Return a list of the overlays that overlap the region BEG ... END.
4111 Overlap means that at least one character is contained within the overlay
4112 and also contained within the specified region.
4113 Empty overlays are included in the result if they are located at BEG
4114 or between BEG and END. */)
4115 (beg, end)
4116 Lisp_Object beg, end;
4118 int noverlays;
4119 Lisp_Object *overlay_vec;
4120 int len;
4121 Lisp_Object result;
4123 CHECK_NUMBER_COERCE_MARKER (beg);
4124 CHECK_NUMBER_COERCE_MARKER (end);
4126 len = 10;
4127 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
4129 /* Put all the overlays we want in a vector in overlay_vec.
4130 Store the length in len. */
4131 noverlays = overlays_in (XINT (beg), XINT (end), 1, &overlay_vec, &len,
4132 (int *) 0, (int *) 0);
4134 /* Make a list of them all. */
4135 result = Flist (noverlays, overlay_vec);
4137 xfree (overlay_vec);
4138 return result;
4141 DEFUN ("next-overlay-change", Fnext_overlay_change, Snext_overlay_change,
4142 1, 1, 0,
4143 doc: /* Return the next position after POS where an overlay starts or ends.
4144 If there are no overlay boundaries from POS to (point-max),
4145 the value is (point-max). */)
4146 (pos)
4147 Lisp_Object pos;
4149 int noverlays;
4150 EMACS_INT endpos;
4151 Lisp_Object *overlay_vec;
4152 int len;
4153 int i;
4155 CHECK_NUMBER_COERCE_MARKER (pos);
4157 len = 10;
4158 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
4160 /* Put all the overlays we want in a vector in overlay_vec.
4161 Store the length in len.
4162 endpos gets the position where the next overlay starts. */
4163 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4164 &endpos, (EMACS_INT *) 0, 1);
4166 /* If any of these overlays ends before endpos,
4167 use its ending point instead. */
4168 for (i = 0; i < noverlays; i++)
4170 Lisp_Object oend;
4171 EMACS_INT oendpos;
4173 oend = OVERLAY_END (overlay_vec[i]);
4174 oendpos = OVERLAY_POSITION (oend);
4175 if (oendpos < endpos)
4176 endpos = oendpos;
4179 xfree (overlay_vec);
4180 return make_number (endpos);
4183 DEFUN ("previous-overlay-change", Fprevious_overlay_change,
4184 Sprevious_overlay_change, 1, 1, 0,
4185 doc: /* Return the previous position before POS where an overlay starts or ends.
4186 If there are no overlay boundaries from (point-min) to POS,
4187 the value is (point-min). */)
4188 (pos)
4189 Lisp_Object pos;
4191 int noverlays;
4192 EMACS_INT prevpos;
4193 Lisp_Object *overlay_vec;
4194 int len;
4196 CHECK_NUMBER_COERCE_MARKER (pos);
4198 /* At beginning of buffer, we know the answer;
4199 avoid bug subtracting 1 below. */
4200 if (XINT (pos) == BEGV)
4201 return pos;
4203 len = 10;
4204 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
4206 /* Put all the overlays we want in a vector in overlay_vec.
4207 Store the length in len.
4208 prevpos gets the position of the previous change. */
4209 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
4210 (EMACS_INT *) 0, &prevpos, 1);
4212 xfree (overlay_vec);
4213 return make_number (prevpos);
4216 /* These functions are for debugging overlays. */
4218 DEFUN ("overlay-lists", Foverlay_lists, Soverlay_lists, 0, 0, 0,
4219 doc: /* Return a pair of lists giving all the overlays of the current buffer.
4220 The car has all the overlays before the overlay center;
4221 the cdr has all the overlays after the overlay center.
4222 Recentering overlays moves overlays between these lists.
4223 The lists you get are copies, so that changing them has no effect.
4224 However, the overlays you get are the real objects that the buffer uses. */)
4227 struct Lisp_Overlay *ol;
4228 Lisp_Object before = Qnil, after = Qnil, tmp;
4229 for (ol = current_buffer->overlays_before; ol; ol = ol->next)
4231 XSETMISC (tmp, ol);
4232 before = Fcons (tmp, before);
4234 for (ol = current_buffer->overlays_after; ol; ol = ol->next)
4236 XSETMISC (tmp, ol);
4237 after = Fcons (tmp, after);
4239 return Fcons (Fnreverse (before), Fnreverse (after));
4242 DEFUN ("overlay-recenter", Foverlay_recenter, Soverlay_recenter, 1, 1, 0,
4243 doc: /* Recenter the overlays of the current buffer around position POS.
4244 That makes overlay lookup faster for positions near POS (but perhaps slower
4245 for positions far away from POS). */)
4246 (pos)
4247 Lisp_Object pos;
4249 CHECK_NUMBER_COERCE_MARKER (pos);
4251 recenter_overlay_lists (current_buffer, XINT (pos));
4252 return Qnil;
4255 DEFUN ("overlay-get", Foverlay_get, Soverlay_get, 2, 2, 0,
4256 doc: /* Get the property of overlay OVERLAY with property name PROP. */)
4257 (overlay, prop)
4258 Lisp_Object overlay, prop;
4260 CHECK_OVERLAY (overlay);
4261 return lookup_char_property (XOVERLAY (overlay)->plist, prop, 0);
4264 DEFUN ("overlay-put", Foverlay_put, Soverlay_put, 3, 3, 0,
4265 doc: /* Set one property of overlay OVERLAY: give property PROP value VALUE. */)
4266 (overlay, prop, value)
4267 Lisp_Object overlay, prop, value;
4269 Lisp_Object tail, buffer;
4270 int changed;
4272 CHECK_OVERLAY (overlay);
4274 buffer = Fmarker_buffer (OVERLAY_START (overlay));
4276 for (tail = XOVERLAY (overlay)->plist;
4277 CONSP (tail) && CONSP (XCDR (tail));
4278 tail = XCDR (XCDR (tail)))
4279 if (EQ (XCAR (tail), prop))
4281 changed = !EQ (XCAR (XCDR (tail)), value);
4282 XSETCAR (XCDR (tail), value);
4283 goto found;
4285 /* It wasn't in the list, so add it to the front. */
4286 changed = !NILP (value);
4287 XOVERLAY (overlay)->plist
4288 = Fcons (prop, Fcons (value, XOVERLAY (overlay)->plist));
4289 found:
4290 if (! NILP (buffer))
4292 if (changed)
4293 modify_overlay (XBUFFER (buffer),
4294 marker_position (OVERLAY_START (overlay)),
4295 marker_position (OVERLAY_END (overlay)));
4296 if (EQ (prop, Qevaporate) && ! NILP (value)
4297 && (OVERLAY_POSITION (OVERLAY_START (overlay))
4298 == OVERLAY_POSITION (OVERLAY_END (overlay))))
4299 Fdelete_overlay (overlay);
4302 return value;
4305 /* Subroutine of report_overlay_modification. */
4307 /* Lisp vector holding overlay hook functions to call.
4308 Vector elements come in pairs.
4309 Each even-index element is a list of hook functions.
4310 The following odd-index element is the overlay they came from.
4312 Before the buffer change, we fill in this vector
4313 as we call overlay hook functions.
4314 After the buffer change, we get the functions to call from this vector.
4315 This way we always call the same functions before and after the change. */
4316 static Lisp_Object last_overlay_modification_hooks;
4318 /* Number of elements actually used in last_overlay_modification_hooks. */
4319 static int last_overlay_modification_hooks_used;
4321 /* Add one functionlist/overlay pair
4322 to the end of last_overlay_modification_hooks. */
4324 static void
4325 add_overlay_mod_hooklist (functionlist, overlay)
4326 Lisp_Object functionlist, overlay;
4328 int oldsize = XVECTOR (last_overlay_modification_hooks)->size;
4330 if (last_overlay_modification_hooks_used == oldsize)
4331 last_overlay_modification_hooks = larger_vector
4332 (last_overlay_modification_hooks, oldsize * 2, Qnil);
4333 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4334 functionlist); last_overlay_modification_hooks_used++;
4335 ASET (last_overlay_modification_hooks, last_overlay_modification_hooks_used,
4336 overlay); last_overlay_modification_hooks_used++;
4339 /* Run the modification-hooks of overlays that include
4340 any part of the text in START to END.
4341 If this change is an insertion, also
4342 run the insert-before-hooks of overlay starting at END,
4343 and the insert-after-hooks of overlay ending at START.
4345 This is called both before and after the modification.
4346 AFTER is nonzero when we call after the modification.
4348 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
4349 When AFTER is nonzero, they are the start position,
4350 the position after the inserted new text,
4351 and the length of deleted or replaced old text. */
4353 void
4354 report_overlay_modification (start, end, after, arg1, arg2, arg3)
4355 Lisp_Object start, end;
4356 int after;
4357 Lisp_Object arg1, arg2, arg3;
4359 Lisp_Object prop, overlay;
4360 struct Lisp_Overlay *tail;
4361 /* 1 if this change is an insertion. */
4362 int insertion = (after ? XFASTINT (arg3) == 0 : EQ (start, end));
4363 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4365 overlay = Qnil;
4366 tail = NULL;
4368 /* We used to run the functions as soon as we found them and only register
4369 them in last_overlay_modification_hooks for the purpose of the `after'
4370 case. But running elisp code as we traverse the list of overlays is
4371 painful because the list can be modified by the elisp code so we had to
4372 copy at several places. We now simply do a read-only traversal that
4373 only collects the functions to run and we run them afterwards. It's
4374 simpler, especially since all the code was already there. -stef */
4376 if (!after)
4378 /* We are being called before a change.
4379 Scan the overlays to find the functions to call. */
4380 last_overlay_modification_hooks_used = 0;
4381 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4383 int startpos, endpos;
4384 Lisp_Object ostart, oend;
4386 XSETMISC (overlay, tail);
4388 ostart = OVERLAY_START (overlay);
4389 oend = OVERLAY_END (overlay);
4390 endpos = OVERLAY_POSITION (oend);
4391 if (XFASTINT (start) > endpos)
4392 break;
4393 startpos = OVERLAY_POSITION (ostart);
4394 if (insertion && (XFASTINT (start) == startpos
4395 || XFASTINT (end) == startpos))
4397 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4398 if (!NILP (prop))
4399 add_overlay_mod_hooklist (prop, overlay);
4401 if (insertion && (XFASTINT (start) == endpos
4402 || XFASTINT (end) == endpos))
4404 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4405 if (!NILP (prop))
4406 add_overlay_mod_hooklist (prop, overlay);
4408 /* Test for intersecting intervals. This does the right thing
4409 for both insertion and deletion. */
4410 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4412 prop = Foverlay_get (overlay, Qmodification_hooks);
4413 if (!NILP (prop))
4414 add_overlay_mod_hooklist (prop, overlay);
4418 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4420 int startpos, endpos;
4421 Lisp_Object ostart, oend;
4423 XSETMISC (overlay, tail);
4425 ostart = OVERLAY_START (overlay);
4426 oend = OVERLAY_END (overlay);
4427 startpos = OVERLAY_POSITION (ostart);
4428 endpos = OVERLAY_POSITION (oend);
4429 if (XFASTINT (end) < startpos)
4430 break;
4431 if (insertion && (XFASTINT (start) == startpos
4432 || XFASTINT (end) == startpos))
4434 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4435 if (!NILP (prop))
4436 add_overlay_mod_hooklist (prop, overlay);
4438 if (insertion && (XFASTINT (start) == endpos
4439 || XFASTINT (end) == endpos))
4441 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4442 if (!NILP (prop))
4443 add_overlay_mod_hooklist (prop, overlay);
4445 /* Test for intersecting intervals. This does the right thing
4446 for both insertion and deletion. */
4447 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4449 prop = Foverlay_get (overlay, Qmodification_hooks);
4450 if (!NILP (prop))
4451 add_overlay_mod_hooklist (prop, overlay);
4456 GCPRO4 (overlay, arg1, arg2, arg3);
4458 /* Call the functions recorded in last_overlay_modification_hooks.
4459 First copy the vector contents, in case some of these hooks
4460 do subsequent modification of the buffer. */
4461 int size = last_overlay_modification_hooks_used;
4462 Lisp_Object *copy = (Lisp_Object *) alloca (size * sizeof (Lisp_Object));
4463 int i;
4465 bcopy (XVECTOR (last_overlay_modification_hooks)->contents,
4466 copy, size * sizeof (Lisp_Object));
4467 gcpro1.var = copy;
4468 gcpro1.nvars = size;
4470 for (i = 0; i < size;)
4472 Lisp_Object prop, overlay;
4473 prop = copy[i++];
4474 overlay = copy[i++];
4475 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4478 UNGCPRO;
4481 static void
4482 call_overlay_mod_hooks (list, overlay, after, arg1, arg2, arg3)
4483 Lisp_Object list, overlay;
4484 int after;
4485 Lisp_Object arg1, arg2, arg3;
4487 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4489 GCPRO4 (list, arg1, arg2, arg3);
4491 while (CONSP (list))
4493 if (NILP (arg3))
4494 call4 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2);
4495 else
4496 call5 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2, arg3);
4497 list = XCDR (list);
4499 UNGCPRO;
4502 /* Delete any zero-sized overlays at position POS, if the `evaporate'
4503 property is set. */
4504 void
4505 evaporate_overlays (pos)
4506 EMACS_INT pos;
4508 Lisp_Object overlay, hit_list;
4509 struct Lisp_Overlay *tail;
4511 hit_list = Qnil;
4512 if (pos <= current_buffer->overlay_center)
4513 for (tail = current_buffer->overlays_before; tail; tail = tail->next)
4515 int endpos;
4516 XSETMISC (overlay, tail);
4517 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
4518 if (endpos < pos)
4519 break;
4520 if (endpos == pos && OVERLAY_POSITION (OVERLAY_START (overlay)) == pos
4521 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4522 hit_list = Fcons (overlay, hit_list);
4524 else
4525 for (tail = current_buffer->overlays_after; tail; tail = tail->next)
4527 int startpos;
4528 XSETMISC (overlay, tail);
4529 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
4530 if (startpos > pos)
4531 break;
4532 if (startpos == pos && OVERLAY_POSITION (OVERLAY_END (overlay)) == pos
4533 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4534 hit_list = Fcons (overlay, hit_list);
4536 for (; CONSP (hit_list); hit_list = XCDR (hit_list))
4537 Fdelete_overlay (XCAR (hit_list));
4540 /* Somebody has tried to store a value with an unacceptable type
4541 in the slot with offset OFFSET. */
4543 void
4544 buffer_slot_type_mismatch (sym, type)
4545 Lisp_Object sym;
4546 int type;
4548 char *type_name;
4550 switch (type)
4552 case Lisp_Int:
4553 type_name = "integers";
4554 break;
4556 case Lisp_String:
4557 type_name = "strings";
4558 break;
4560 case Lisp_Symbol:
4561 type_name = "symbols";
4562 break;
4564 default:
4565 abort ();
4568 error ("Only %s should be stored in the buffer-local variable %s",
4569 type_name, SDATA (SYMBOL_NAME (sym)));
4573 /***********************************************************************
4574 Allocation with mmap
4575 ***********************************************************************/
4577 #ifdef USE_MMAP_FOR_BUFFERS
4579 #include <sys/types.h>
4580 #include <sys/mman.h>
4582 #ifndef MAP_ANON
4583 #ifdef MAP_ANONYMOUS
4584 #define MAP_ANON MAP_ANONYMOUS
4585 #else
4586 #define MAP_ANON 0
4587 #endif
4588 #endif
4590 #ifndef MAP_FAILED
4591 #define MAP_FAILED ((void *) -1)
4592 #endif
4594 #include <stdio.h>
4595 #include <errno.h>
4597 #if MAP_ANON == 0
4598 #include <fcntl.h>
4599 #endif
4601 #include "coding.h"
4604 /* Memory is allocated in regions which are mapped using mmap(2).
4605 The current implementation lets the system select mapped
4606 addresses; we're not using MAP_FIXED in general, except when
4607 trying to enlarge regions.
4609 Each mapped region starts with a mmap_region structure, the user
4610 area starts after that structure, aligned to MEM_ALIGN.
4612 +-----------------------+
4613 | struct mmap_info + |
4614 | padding |
4615 +-----------------------+
4616 | user data |
4619 +-----------------------+ */
4621 struct mmap_region
4623 /* User-specified size. */
4624 size_t nbytes_specified;
4626 /* Number of bytes mapped */
4627 size_t nbytes_mapped;
4629 /* Pointer to the location holding the address of the memory
4630 allocated with the mmap'd block. The variable actually points
4631 after this structure. */
4632 POINTER_TYPE **var;
4634 /* Next and previous in list of all mmap'd regions. */
4635 struct mmap_region *next, *prev;
4638 /* Doubly-linked list of mmap'd regions. */
4640 static struct mmap_region *mmap_regions;
4642 /* File descriptor for mmap. If we don't have anonymous mapping,
4643 /dev/zero will be opened on it. */
4645 static int mmap_fd;
4647 /* Temporary storage for mmap_set_vars, see there. */
4649 static struct mmap_region *mmap_regions_1;
4650 static int mmap_fd_1;
4652 /* Page size on this system. */
4654 static int mmap_page_size;
4656 /* 1 means mmap has been intialized. */
4658 static int mmap_initialized_p;
4660 /* Value is X rounded up to the next multiple of N. */
4662 #define ROUND(X, N) (((X) + (N) - 1) / (N) * (N))
4664 /* Size of mmap_region structure plus padding. */
4666 #define MMAP_REGION_STRUCT_SIZE \
4667 ROUND (sizeof (struct mmap_region), MEM_ALIGN)
4669 /* Given a pointer P to the start of the user-visible part of a mapped
4670 region, return a pointer to the start of the region. */
4672 #define MMAP_REGION(P) \
4673 ((struct mmap_region *) ((char *) (P) - MMAP_REGION_STRUCT_SIZE))
4675 /* Given a pointer P to the start of a mapped region, return a pointer
4676 to the start of the user-visible part of the region. */
4678 #define MMAP_USER_AREA(P) \
4679 ((POINTER_TYPE *) ((char *) (P) + MMAP_REGION_STRUCT_SIZE))
4681 #define MEM_ALIGN sizeof (double)
4683 /* Predicate returning true if part of the address range [START .. END]
4684 is currently mapped. Used to prevent overwriting an existing
4685 memory mapping.
4687 Default is to conservativly assume the address range is occupied by
4688 something else. This can be overridden by system configuration
4689 files if system-specific means to determine this exists. */
4691 #ifndef MMAP_ALLOCATED_P
4692 #define MMAP_ALLOCATED_P(start, end) 1
4693 #endif
4695 /* Function prototypes. */
4697 static int mmap_free_1 P_ ((struct mmap_region *));
4698 static int mmap_enlarge P_ ((struct mmap_region *, int));
4699 static struct mmap_region *mmap_find P_ ((POINTER_TYPE *, POINTER_TYPE *));
4700 static POINTER_TYPE *mmap_alloc P_ ((POINTER_TYPE **, size_t));
4701 static POINTER_TYPE *mmap_realloc P_ ((POINTER_TYPE **, size_t));
4702 static void mmap_free P_ ((POINTER_TYPE **ptr));
4703 static void mmap_init P_ ((void));
4706 /* Return a region overlapping address range START...END, or null if
4707 none. END is not including, i.e. the last byte in the range
4708 is at END - 1. */
4710 static struct mmap_region *
4711 mmap_find (start, end)
4712 POINTER_TYPE *start, *end;
4714 struct mmap_region *r;
4715 char *s = (char *) start, *e = (char *) end;
4717 for (r = mmap_regions; r; r = r->next)
4719 char *rstart = (char *) r;
4720 char *rend = rstart + r->nbytes_mapped;
4722 if (/* First byte of range, i.e. START, in this region? */
4723 (s >= rstart && s < rend)
4724 /* Last byte of range, i.e. END - 1, in this region? */
4725 || (e > rstart && e <= rend)
4726 /* First byte of this region in the range? */
4727 || (rstart >= s && rstart < e)
4728 /* Last byte of this region in the range? */
4729 || (rend > s && rend <= e))
4730 break;
4733 return r;
4737 /* Unmap a region. P is a pointer to the start of the user-araa of
4738 the region. Value is non-zero if successful. */
4740 static int
4741 mmap_free_1 (r)
4742 struct mmap_region *r;
4744 if (r->next)
4745 r->next->prev = r->prev;
4746 if (r->prev)
4747 r->prev->next = r->next;
4748 else
4749 mmap_regions = r->next;
4751 if (munmap ((POINTER_TYPE *) r, r->nbytes_mapped) == -1)
4753 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4754 return 0;
4757 return 1;
4761 /* Enlarge region R by NPAGES pages. NPAGES < 0 means shrink R.
4762 Value is non-zero if successful. */
4764 static int
4765 mmap_enlarge (r, npages)
4766 struct mmap_region *r;
4767 int npages;
4769 char *region_end = (char *) r + r->nbytes_mapped;
4770 size_t nbytes;
4771 int success = 0;
4773 if (npages < 0)
4775 /* Unmap pages at the end of the region. */
4776 nbytes = - npages * mmap_page_size;
4777 if (munmap (region_end - nbytes, nbytes) == -1)
4778 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4779 else
4781 r->nbytes_mapped -= nbytes;
4782 success = 1;
4785 else if (npages > 0)
4787 nbytes = npages * mmap_page_size;
4789 /* Try to map additional pages at the end of the region. We
4790 cannot do this if the address range is already occupied by
4791 something else because mmap deletes any previous mapping.
4792 I'm not sure this is worth doing, let's see. */
4793 if (!MMAP_ALLOCATED_P (region_end, region_end + nbytes))
4795 POINTER_TYPE *p;
4797 p = mmap (region_end, nbytes, PROT_READ | PROT_WRITE,
4798 MAP_ANON | MAP_PRIVATE | MAP_FIXED, mmap_fd, 0);
4799 if (p == MAP_FAILED)
4800 ; /* fprintf (stderr, "mmap: %s\n", emacs_strerror (errno)); */
4801 else if (p != (POINTER_TYPE *) region_end)
4803 /* Kernels are free to choose a different address. In
4804 that case, unmap what we've mapped above; we have
4805 no use for it. */
4806 if (munmap (p, nbytes) == -1)
4807 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4809 else
4811 r->nbytes_mapped += nbytes;
4812 success = 1;
4817 return success;
4821 /* Set or reset variables holding references to mapped regions. If
4822 RESTORE_P is zero, set all variables to null. If RESTORE_P is
4823 non-zero, set all variables to the start of the user-areas
4824 of mapped regions.
4826 This function is called from Fdump_emacs to ensure that the dumped
4827 Emacs doesn't contain references to memory that won't be mapped
4828 when Emacs starts. */
4830 void
4831 mmap_set_vars (restore_p)
4832 int restore_p;
4834 struct mmap_region *r;
4836 if (restore_p)
4838 mmap_regions = mmap_regions_1;
4839 mmap_fd = mmap_fd_1;
4840 for (r = mmap_regions; r; r = r->next)
4841 *r->var = MMAP_USER_AREA (r);
4843 else
4845 for (r = mmap_regions; r; r = r->next)
4846 *r->var = NULL;
4847 mmap_regions_1 = mmap_regions;
4848 mmap_regions = NULL;
4849 mmap_fd_1 = mmap_fd;
4850 mmap_fd = -1;
4855 /* Allocate a block of storage large enough to hold NBYTES bytes of
4856 data. A pointer to the data is returned in *VAR. VAR is thus the
4857 address of some variable which will use the data area.
4859 The allocation of 0 bytes is valid.
4861 If we can't allocate the necessary memory, set *VAR to null, and
4862 return null. */
4864 static POINTER_TYPE *
4865 mmap_alloc (var, nbytes)
4866 POINTER_TYPE **var;
4867 size_t nbytes;
4869 void *p;
4870 size_t map;
4872 mmap_init ();
4874 map = ROUND (nbytes + MMAP_REGION_STRUCT_SIZE, mmap_page_size);
4875 p = mmap (NULL, map, PROT_READ | PROT_WRITE, MAP_ANON | MAP_PRIVATE,
4876 mmap_fd, 0);
4878 if (p == MAP_FAILED)
4880 if (errno != ENOMEM)
4881 fprintf (stderr, "mmap: %s\n", emacs_strerror (errno));
4882 p = NULL;
4884 else
4886 struct mmap_region *r = (struct mmap_region *) p;
4888 r->nbytes_specified = nbytes;
4889 r->nbytes_mapped = map;
4890 r->var = var;
4891 r->prev = NULL;
4892 r->next = mmap_regions;
4893 if (r->next)
4894 r->next->prev = r;
4895 mmap_regions = r;
4897 p = MMAP_USER_AREA (p);
4900 return *var = p;
4904 /* Given a pointer at address VAR to data allocated with mmap_alloc,
4905 resize it to size NBYTES. Change *VAR to reflect the new block,
4906 and return this value. If more memory cannot be allocated, then
4907 leave *VAR unchanged, and return null. */
4909 static POINTER_TYPE *
4910 mmap_realloc (var, nbytes)
4911 POINTER_TYPE **var;
4912 size_t nbytes;
4914 POINTER_TYPE *result;
4916 mmap_init ();
4918 if (*var == NULL)
4919 result = mmap_alloc (var, nbytes);
4920 else if (nbytes == 0)
4922 mmap_free (var);
4923 result = mmap_alloc (var, nbytes);
4925 else
4927 struct mmap_region *r = MMAP_REGION (*var);
4928 size_t room = r->nbytes_mapped - MMAP_REGION_STRUCT_SIZE;
4930 if (room < nbytes)
4932 /* Must enlarge. */
4933 POINTER_TYPE *old_ptr = *var;
4935 /* Try to map additional pages at the end of the region.
4936 If that fails, allocate a new region, copy data
4937 from the old region, then free it. */
4938 if (mmap_enlarge (r, (ROUND (nbytes - room, mmap_page_size)
4939 / mmap_page_size)))
4941 r->nbytes_specified = nbytes;
4942 *var = result = old_ptr;
4944 else if (mmap_alloc (var, nbytes))
4946 bcopy (old_ptr, *var, r->nbytes_specified);
4947 mmap_free_1 (MMAP_REGION (old_ptr));
4948 result = *var;
4949 r = MMAP_REGION (result);
4950 r->nbytes_specified = nbytes;
4952 else
4954 *var = old_ptr;
4955 result = NULL;
4958 else if (room - nbytes >= mmap_page_size)
4960 /* Shrinking by at least a page. Let's give some
4961 memory back to the system.
4963 The extra parens are to make the division happens first,
4964 on positive values, so we know it will round towards
4965 zero. */
4966 mmap_enlarge (r, - ((room - nbytes) / mmap_page_size));
4967 result = *var;
4968 r->nbytes_specified = nbytes;
4970 else
4972 /* Leave it alone. */
4973 result = *var;
4974 r->nbytes_specified = nbytes;
4978 return result;
4982 /* Free a block of relocatable storage whose data is pointed to by
4983 PTR. Store 0 in *PTR to show there's no block allocated. */
4985 static void
4986 mmap_free (var)
4987 POINTER_TYPE **var;
4989 mmap_init ();
4991 if (*var)
4993 mmap_free_1 (MMAP_REGION (*var));
4994 *var = NULL;
4999 /* Perform necessary intializations for the use of mmap. */
5001 static void
5002 mmap_init ()
5004 #if MAP_ANON == 0
5005 /* The value of mmap_fd is initially 0 in temacs, and -1
5006 in a dumped Emacs. */
5007 if (mmap_fd <= 0)
5009 /* No anonymous mmap -- we need the file descriptor. */
5010 mmap_fd = open ("/dev/zero", O_RDONLY);
5011 if (mmap_fd == -1)
5012 fatal ("Cannot open /dev/zero: %s", emacs_strerror (errno));
5014 #endif /* MAP_ANON == 0 */
5016 if (mmap_initialized_p)
5017 return;
5018 mmap_initialized_p = 1;
5020 #if MAP_ANON != 0
5021 mmap_fd = -1;
5022 #endif
5024 mmap_page_size = getpagesize ();
5027 #endif /* USE_MMAP_FOR_BUFFERS */
5031 /***********************************************************************
5032 Buffer-text Allocation
5033 ***********************************************************************/
5035 #ifdef REL_ALLOC
5036 extern POINTER_TYPE *r_alloc P_ ((POINTER_TYPE **, size_t));
5037 extern POINTER_TYPE *r_re_alloc P_ ((POINTER_TYPE **, size_t));
5038 extern void r_alloc_free P_ ((POINTER_TYPE **ptr));
5039 #endif /* REL_ALLOC */
5042 /* Allocate NBYTES bytes for buffer B's text buffer. */
5044 static void
5045 alloc_buffer_text (b, nbytes)
5046 struct buffer *b;
5047 size_t nbytes;
5049 POINTER_TYPE *p;
5051 BLOCK_INPUT;
5052 #if defined USE_MMAP_FOR_BUFFERS
5053 p = mmap_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
5054 #elif defined REL_ALLOC
5055 p = r_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
5056 #else
5057 p = xmalloc (nbytes);
5058 #endif
5060 if (p == NULL)
5062 UNBLOCK_INPUT;
5063 memory_full ();
5066 b->text->beg = (unsigned char *) p;
5067 UNBLOCK_INPUT;
5070 /* Enlarge buffer B's text buffer by DELTA bytes. DELTA < 0 means
5071 shrink it. */
5073 void
5074 enlarge_buffer_text (b, delta)
5075 struct buffer *b;
5076 int delta;
5078 POINTER_TYPE *p;
5079 size_t nbytes = (BUF_Z_BYTE (b) - BUF_BEG_BYTE (b) + BUF_GAP_SIZE (b) + 1
5080 + delta);
5081 BLOCK_INPUT;
5082 #if defined USE_MMAP_FOR_BUFFERS
5083 p = mmap_realloc ((POINTER_TYPE **) &b->text->beg, nbytes);
5084 #elif defined REL_ALLOC
5085 p = r_re_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
5086 #else
5087 p = xrealloc (b->text->beg, nbytes);
5088 #endif
5090 if (p == NULL)
5092 UNBLOCK_INPUT;
5093 memory_full ();
5096 BUF_BEG_ADDR (b) = (unsigned char *) p;
5097 UNBLOCK_INPUT;
5101 /* Free buffer B's text buffer. */
5103 static void
5104 free_buffer_text (b)
5105 struct buffer *b;
5107 BLOCK_INPUT;
5109 #if defined USE_MMAP_FOR_BUFFERS
5110 mmap_free ((POINTER_TYPE **) &b->text->beg);
5111 #elif defined REL_ALLOC
5112 r_alloc_free ((POINTER_TYPE **) &b->text->beg);
5113 #else
5114 xfree (b->text->beg);
5115 #endif
5117 BUF_BEG_ADDR (b) = NULL;
5118 UNBLOCK_INPUT;
5123 /***********************************************************************
5124 Initialization
5125 ***********************************************************************/
5127 void
5128 init_buffer_once ()
5130 int idx;
5132 bzero (buffer_permanent_local_flags, sizeof buffer_permanent_local_flags);
5134 /* Make sure all markable slots in buffer_defaults
5135 are initialized reasonably, so mark_buffer won't choke. */
5136 reset_buffer (&buffer_defaults);
5137 reset_buffer_local_variables (&buffer_defaults, 1);
5138 reset_buffer (&buffer_local_symbols);
5139 reset_buffer_local_variables (&buffer_local_symbols, 1);
5140 /* Prevent GC from getting confused. */
5141 buffer_defaults.text = &buffer_defaults.own_text;
5142 buffer_local_symbols.text = &buffer_local_symbols.own_text;
5143 BUF_INTERVALS (&buffer_defaults) = 0;
5144 BUF_INTERVALS (&buffer_local_symbols) = 0;
5145 XSETPVECTYPE (&buffer_defaults, PVEC_BUFFER);
5146 XSETBUFFER (Vbuffer_defaults, &buffer_defaults);
5147 XSETPVECTYPE (&buffer_local_symbols, PVEC_BUFFER);
5148 XSETBUFFER (Vbuffer_local_symbols, &buffer_local_symbols);
5150 /* Set up the default values of various buffer slots. */
5151 /* Must do these before making the first buffer! */
5153 /* real setup is done in bindings.el */
5154 buffer_defaults.mode_line_format = build_string ("%-");
5155 buffer_defaults.header_line_format = Qnil;
5156 buffer_defaults.abbrev_mode = Qnil;
5157 buffer_defaults.overwrite_mode = Qnil;
5158 buffer_defaults.case_fold_search = Qt;
5159 buffer_defaults.auto_fill_function = Qnil;
5160 buffer_defaults.selective_display = Qnil;
5161 #ifndef old
5162 buffer_defaults.selective_display_ellipses = Qt;
5163 #endif
5164 buffer_defaults.abbrev_table = Qnil;
5165 buffer_defaults.display_table = Qnil;
5166 buffer_defaults.undo_list = Qnil;
5167 buffer_defaults.mark_active = Qnil;
5168 buffer_defaults.file_format = Qnil;
5169 buffer_defaults.auto_save_file_format = Qt;
5170 buffer_defaults.overlays_before = NULL;
5171 buffer_defaults.overlays_after = NULL;
5172 buffer_defaults.overlay_center = BEG;
5174 XSETFASTINT (buffer_defaults.tab_width, 8);
5175 buffer_defaults.truncate_lines = Qnil;
5176 buffer_defaults.ctl_arrow = Qt;
5177 buffer_defaults.direction_reversed = Qnil;
5178 buffer_defaults.cursor_type = Qt;
5179 buffer_defaults.extra_line_spacing = Qnil;
5180 buffer_defaults.cursor_in_non_selected_windows = Qt;
5182 #ifdef DOS_NT
5183 buffer_defaults.buffer_file_type = Qnil; /* TEXT */
5184 #endif
5185 buffer_defaults.enable_multibyte_characters = Qt;
5186 buffer_defaults.buffer_file_coding_system = Qnil;
5187 XSETFASTINT (buffer_defaults.fill_column, 70);
5188 XSETFASTINT (buffer_defaults.left_margin, 0);
5189 buffer_defaults.cache_long_line_scans = Qnil;
5190 buffer_defaults.file_truename = Qnil;
5191 XSETFASTINT (buffer_defaults.display_count, 0);
5192 XSETFASTINT (buffer_defaults.left_margin_cols, 0);
5193 XSETFASTINT (buffer_defaults.right_margin_cols, 0);
5194 buffer_defaults.left_fringe_width = Qnil;
5195 buffer_defaults.right_fringe_width = Qnil;
5196 buffer_defaults.fringes_outside_margins = Qnil;
5197 buffer_defaults.scroll_bar_width = Qnil;
5198 buffer_defaults.vertical_scroll_bar_type = Qt;
5199 buffer_defaults.indicate_empty_lines = Qnil;
5200 buffer_defaults.indicate_buffer_boundaries = Qnil;
5201 buffer_defaults.fringe_indicator_alist = Qnil;
5202 buffer_defaults.fringe_cursor_alist = Qnil;
5203 buffer_defaults.scroll_up_aggressively = Qnil;
5204 buffer_defaults.scroll_down_aggressively = Qnil;
5205 buffer_defaults.display_time = Qnil;
5207 /* Assign the local-flags to the slots that have default values.
5208 The local flag is a bit that is used in the buffer
5209 to say that it has its own local value for the slot.
5210 The local flag bits are in the local_var_flags slot of the buffer. */
5212 /* Nothing can work if this isn't true */
5213 if (sizeof (EMACS_INT) != sizeof (Lisp_Object)) abort ();
5215 /* 0 means not a lisp var, -1 means always local, else mask */
5216 bzero (&buffer_local_flags, sizeof buffer_local_flags);
5217 XSETINT (buffer_local_flags.filename, -1);
5218 XSETINT (buffer_local_flags.directory, -1);
5219 XSETINT (buffer_local_flags.backed_up, -1);
5220 XSETINT (buffer_local_flags.save_length, -1);
5221 XSETINT (buffer_local_flags.auto_save_file_name, -1);
5222 XSETINT (buffer_local_flags.read_only, -1);
5223 XSETINT (buffer_local_flags.major_mode, -1);
5224 XSETINT (buffer_local_flags.mode_name, -1);
5225 XSETINT (buffer_local_flags.undo_list, -1);
5226 XSETINT (buffer_local_flags.mark_active, -1);
5227 XSETINT (buffer_local_flags.point_before_scroll, -1);
5228 XSETINT (buffer_local_flags.file_truename, -1);
5229 XSETINT (buffer_local_flags.invisibility_spec, -1);
5230 XSETINT (buffer_local_flags.file_format, -1);
5231 XSETINT (buffer_local_flags.auto_save_file_format, -1);
5232 XSETINT (buffer_local_flags.display_count, -1);
5233 XSETINT (buffer_local_flags.display_time, -1);
5234 XSETINT (buffer_local_flags.enable_multibyte_characters, -1);
5236 idx = 1;
5237 XSETFASTINT (buffer_local_flags.mode_line_format, idx); ++idx;
5238 XSETFASTINT (buffer_local_flags.abbrev_mode, idx); ++idx;
5239 XSETFASTINT (buffer_local_flags.overwrite_mode, idx); ++idx;
5240 XSETFASTINT (buffer_local_flags.case_fold_search, idx); ++idx;
5241 XSETFASTINT (buffer_local_flags.auto_fill_function, idx); ++idx;
5242 XSETFASTINT (buffer_local_flags.selective_display, idx); ++idx;
5243 #ifndef old
5244 XSETFASTINT (buffer_local_flags.selective_display_ellipses, idx); ++idx;
5245 #endif
5246 XSETFASTINT (buffer_local_flags.tab_width, idx); ++idx;
5247 XSETFASTINT (buffer_local_flags.truncate_lines, idx); ++idx;
5248 XSETFASTINT (buffer_local_flags.ctl_arrow, idx); ++idx;
5249 XSETFASTINT (buffer_local_flags.fill_column, idx); ++idx;
5250 XSETFASTINT (buffer_local_flags.left_margin, idx); ++idx;
5251 XSETFASTINT (buffer_local_flags.abbrev_table, idx); ++idx;
5252 XSETFASTINT (buffer_local_flags.display_table, idx); ++idx;
5253 #ifdef DOS_NT
5254 XSETFASTINT (buffer_local_flags.buffer_file_type, idx);
5255 /* Make this one a permanent local. */
5256 buffer_permanent_local_flags[idx++] = 1;
5257 #endif
5258 XSETFASTINT (buffer_local_flags.syntax_table, idx); ++idx;
5259 XSETFASTINT (buffer_local_flags.cache_long_line_scans, idx); ++idx;
5260 XSETFASTINT (buffer_local_flags.category_table, idx); ++idx;
5261 XSETFASTINT (buffer_local_flags.direction_reversed, idx); ++idx;
5262 XSETFASTINT (buffer_local_flags.buffer_file_coding_system, idx);
5263 /* Make this one a permanent local. */
5264 buffer_permanent_local_flags[idx++] = 1;
5265 XSETFASTINT (buffer_local_flags.left_margin_cols, idx); ++idx;
5266 XSETFASTINT (buffer_local_flags.right_margin_cols, idx); ++idx;
5267 XSETFASTINT (buffer_local_flags.left_fringe_width, idx); ++idx;
5268 XSETFASTINT (buffer_local_flags.right_fringe_width, idx); ++idx;
5269 XSETFASTINT (buffer_local_flags.fringes_outside_margins, idx); ++idx;
5270 XSETFASTINT (buffer_local_flags.scroll_bar_width, idx); ++idx;
5271 XSETFASTINT (buffer_local_flags.vertical_scroll_bar_type, idx); ++idx;
5272 XSETFASTINT (buffer_local_flags.indicate_empty_lines, idx); ++idx;
5273 XSETFASTINT (buffer_local_flags.indicate_buffer_boundaries, idx); ++idx;
5274 XSETFASTINT (buffer_local_flags.fringe_indicator_alist, idx); ++idx;
5275 XSETFASTINT (buffer_local_flags.fringe_cursor_alist, idx); ++idx;
5276 XSETFASTINT (buffer_local_flags.scroll_up_aggressively, idx); ++idx;
5277 XSETFASTINT (buffer_local_flags.scroll_down_aggressively, idx); ++idx;
5278 XSETFASTINT (buffer_local_flags.header_line_format, idx); ++idx;
5279 XSETFASTINT (buffer_local_flags.cursor_type, idx); ++idx;
5280 XSETFASTINT (buffer_local_flags.extra_line_spacing, idx); ++idx;
5281 XSETFASTINT (buffer_local_flags.cursor_in_non_selected_windows, idx); ++idx;
5283 /* Need more room? */
5284 if (idx >= MAX_PER_BUFFER_VARS)
5285 abort ();
5286 last_per_buffer_idx = idx;
5288 Vbuffer_alist = Qnil;
5289 current_buffer = 0;
5290 all_buffers = 0;
5292 QSFundamental = build_string ("Fundamental");
5294 Qfundamental_mode = intern ("fundamental-mode");
5295 buffer_defaults.major_mode = Qfundamental_mode;
5297 Qmode_class = intern ("mode-class");
5299 Qprotected_field = intern ("protected-field");
5301 Qpermanent_local = intern ("permanent-local");
5303 Qkill_buffer_hook = intern ("kill-buffer-hook");
5304 Fput (Qkill_buffer_hook, Qpermanent_local, Qt);
5306 Qucs_set_table_for_input = intern ("ucs-set-table-for-input");
5308 Vprin1_to_string_buffer = Fget_buffer_create (build_string (" prin1"));
5310 /* super-magic invisible buffer */
5311 Vbuffer_alist = Qnil;
5313 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5315 inhibit_modification_hooks = 0;
5318 void
5319 init_buffer ()
5321 char *pwd;
5322 Lisp_Object temp;
5323 int len;
5325 #ifdef USE_MMAP_FOR_BUFFERS
5327 /* When using the ralloc implementation based on mmap(2), buffer
5328 text pointers will have been set to null in the dumped Emacs.
5329 Map new memory. */
5330 struct buffer *b;
5332 for (b = all_buffers; b; b = b->next)
5333 if (b->text->beg == NULL)
5334 enlarge_buffer_text (b, 0);
5336 #endif /* USE_MMAP_FOR_BUFFERS */
5338 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5339 if (NILP (buffer_defaults.enable_multibyte_characters))
5340 Fset_buffer_multibyte (Qnil);
5342 pwd = get_current_dir_name ();
5344 if (!pwd)
5345 fatal ("`get_current_dir_name' failed: %s\n", strerror (errno));
5347 #ifndef VMS
5348 /* Maybe this should really use some standard subroutine
5349 whose definition is filename syntax dependent. */
5350 len = strlen (pwd);
5351 if (!(IS_DIRECTORY_SEP (pwd[len - 1])))
5353 /* Grow buffer to add directory separator and '\0'. */
5354 pwd = (char *) xrealloc (pwd, len + 2);
5355 pwd[len] = DIRECTORY_SEP;
5356 pwd[len + 1] = '\0';
5358 #endif /* not VMS */
5360 current_buffer->directory = make_unibyte_string (pwd, strlen (pwd));
5361 if (! NILP (buffer_defaults.enable_multibyte_characters))
5362 /* At this moment, we still don't know how to decode the
5363 directory name. So, we keep the bytes in multibyte form so
5364 that ENCODE_FILE correctly gets the original bytes. */
5365 current_buffer->directory
5366 = string_to_multibyte (current_buffer->directory);
5368 /* Add /: to the front of the name
5369 if it would otherwise be treated as magic. */
5370 temp = Ffind_file_name_handler (current_buffer->directory, Qt);
5371 if (! NILP (temp)
5372 /* If the default dir is just /, TEMP is non-nil
5373 because of the ange-ftp completion handler.
5374 However, it is not necessary to turn / into /:/.
5375 So avoid doing that. */
5376 && strcmp ("/", SDATA (current_buffer->directory)))
5377 current_buffer->directory
5378 = concat2 (build_string ("/:"), current_buffer->directory);
5380 temp = get_minibuffer (0);
5381 XBUFFER (temp)->directory = current_buffer->directory;
5383 free (pwd);
5386 /* Similar to defvar_lisp but define a variable whose value is the Lisp
5387 Object stored in the current buffer. address is the address of the slot
5388 in the buffer that is current now. */
5390 /* TYPE is nil for a general Lisp variable.
5391 An integer specifies a type; then only LIsp values
5392 with that type code are allowed (except that nil is allowed too).
5393 LNAME is the LIsp-level variable name.
5394 VNAME is the name of the buffer slot.
5395 DOC is a dummy where you write the doc string as a comment. */
5396 #define DEFVAR_PER_BUFFER(lname, vname, type, doc) \
5397 defvar_per_buffer (lname, vname, type, 0)
5399 static void
5400 defvar_per_buffer (namestring, address, type, doc)
5401 char *namestring;
5402 Lisp_Object *address;
5403 Lisp_Object type;
5404 char *doc;
5406 Lisp_Object sym, val;
5407 int offset;
5409 sym = intern (namestring);
5410 val = allocate_misc ();
5411 offset = (char *)address - (char *)current_buffer;
5413 XMISCTYPE (val) = Lisp_Misc_Buffer_Objfwd;
5414 XBUFFER_OBJFWD (val)->offset = offset;
5415 XBUFFER_OBJFWD (val)->slottype = type;
5416 SET_SYMBOL_VALUE (sym, val);
5417 PER_BUFFER_SYMBOL (offset) = sym;
5419 if (PER_BUFFER_IDX (offset) == 0)
5420 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
5421 slot of buffer_local_flags */
5422 abort ();
5426 /* initialize the buffer routines */
5427 void
5428 syms_of_buffer ()
5430 staticpro (&last_overlay_modification_hooks);
5431 last_overlay_modification_hooks
5432 = Fmake_vector (make_number (10), Qnil);
5434 staticpro (&Vbuffer_defaults);
5435 staticpro (&Vbuffer_local_symbols);
5436 staticpro (&Qfundamental_mode);
5437 staticpro (&Qmode_class);
5438 staticpro (&QSFundamental);
5439 staticpro (&Vbuffer_alist);
5440 staticpro (&Qprotected_field);
5441 staticpro (&Qpermanent_local);
5442 Qpermanent_local_hook = intern ("permanent-local-hook");
5443 staticpro (&Qpermanent_local_hook);
5444 staticpro (&Qkill_buffer_hook);
5445 Qoverlayp = intern ("overlayp");
5446 staticpro (&Qoverlayp);
5447 Qevaporate = intern ("evaporate");
5448 staticpro (&Qevaporate);
5449 Qmodification_hooks = intern ("modification-hooks");
5450 staticpro (&Qmodification_hooks);
5451 Qinsert_in_front_hooks = intern ("insert-in-front-hooks");
5452 staticpro (&Qinsert_in_front_hooks);
5453 Qinsert_behind_hooks = intern ("insert-behind-hooks");
5454 staticpro (&Qinsert_behind_hooks);
5455 Qget_file_buffer = intern ("get-file-buffer");
5456 staticpro (&Qget_file_buffer);
5457 Qpriority = intern ("priority");
5458 staticpro (&Qpriority);
5459 Qwindow = intern ("window");
5460 staticpro (&Qwindow);
5461 Qbefore_string = intern ("before-string");
5462 staticpro (&Qbefore_string);
5463 Qafter_string = intern ("after-string");
5464 staticpro (&Qafter_string);
5465 Qfirst_change_hook = intern ("first-change-hook");
5466 staticpro (&Qfirst_change_hook);
5467 Qbefore_change_functions = intern ("before-change-functions");
5468 staticpro (&Qbefore_change_functions);
5469 Qafter_change_functions = intern ("after-change-functions");
5470 staticpro (&Qafter_change_functions);
5471 /* The next one is initialized in init_buffer_once. */
5472 staticpro (&Qucs_set_table_for_input);
5474 Qkill_buffer_query_functions = intern ("kill-buffer-query-functions");
5475 staticpro (&Qkill_buffer_query_functions);
5477 Fput (Qprotected_field, Qerror_conditions,
5478 Fcons (Qprotected_field, Fcons (Qerror, Qnil)));
5479 Fput (Qprotected_field, Qerror_message,
5480 build_string ("Attempt to modify a protected field"));
5482 /* All these use DEFVAR_LISP_NOPRO because the slots in
5483 buffer_defaults will all be marked via Vbuffer_defaults. */
5485 DEFVAR_LISP_NOPRO ("default-mode-line-format",
5486 &buffer_defaults.mode_line_format,
5487 doc: /* Default value of `mode-line-format' for buffers that don't override it.
5488 This is the same as (default-value 'mode-line-format). */);
5490 DEFVAR_LISP_NOPRO ("default-header-line-format",
5491 &buffer_defaults.header_line_format,
5492 doc: /* Default value of `header-line-format' for buffers that don't override it.
5493 This is the same as (default-value 'header-line-format). */);
5495 DEFVAR_LISP_NOPRO ("default-cursor-type", &buffer_defaults.cursor_type,
5496 doc: /* Default value of `cursor-type' for buffers that don't override it.
5497 This is the same as (default-value 'cursor-type). */);
5499 DEFVAR_LISP_NOPRO ("default-line-spacing",
5500 &buffer_defaults.extra_line_spacing,
5501 doc: /* Default value of `line-spacing' for buffers that don't override it.
5502 This is the same as (default-value 'line-spacing). */);
5504 DEFVAR_LISP_NOPRO ("default-cursor-in-non-selected-windows",
5505 &buffer_defaults.cursor_in_non_selected_windows,
5506 doc: /* Default value of `cursor-in-non-selected-windows'.
5507 This is the same as (default-value 'cursor-in-non-selected-windows). */);
5509 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
5510 &buffer_defaults.abbrev_mode,
5511 doc: /* Default value of `abbrev-mode' for buffers that do not override it.
5512 This is the same as (default-value 'abbrev-mode). */);
5514 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
5515 &buffer_defaults.ctl_arrow,
5516 doc: /* Default value of `ctl-arrow' for buffers that do not override it.
5517 This is the same as (default-value 'ctl-arrow). */);
5519 DEFVAR_LISP_NOPRO ("default-direction-reversed",
5520 &buffer_defaults.direction_reversed,
5521 doc: /* Default value of `direction-reversed' for buffers that do not override it.
5522 This is the same as (default-value 'direction-reversed). */);
5524 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
5525 &buffer_defaults.enable_multibyte_characters,
5526 doc: /* *Default value of `enable-multibyte-characters' for buffers not overriding it.
5527 This is the same as (default-value 'enable-multibyte-characters). */);
5529 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
5530 &buffer_defaults.buffer_file_coding_system,
5531 doc: /* Default value of `buffer-file-coding-system' for buffers not overriding it.
5532 This is the same as (default-value 'buffer-file-coding-system). */);
5534 DEFVAR_LISP_NOPRO ("default-truncate-lines",
5535 &buffer_defaults.truncate_lines,
5536 doc: /* Default value of `truncate-lines' for buffers that do not override it.
5537 This is the same as (default-value 'truncate-lines). */);
5539 DEFVAR_LISP_NOPRO ("default-fill-column",
5540 &buffer_defaults.fill_column,
5541 doc: /* Default value of `fill-column' for buffers that do not override it.
5542 This is the same as (default-value 'fill-column). */);
5544 DEFVAR_LISP_NOPRO ("default-left-margin",
5545 &buffer_defaults.left_margin,
5546 doc: /* Default value of `left-margin' for buffers that do not override it.
5547 This is the same as (default-value 'left-margin). */);
5549 DEFVAR_LISP_NOPRO ("default-tab-width",
5550 &buffer_defaults.tab_width,
5551 doc: /* Default value of `tab-width' for buffers that do not override it.
5552 This is the same as (default-value 'tab-width). */);
5554 DEFVAR_LISP_NOPRO ("default-case-fold-search",
5555 &buffer_defaults.case_fold_search,
5556 doc: /* Default value of `case-fold-search' for buffers that don't override it.
5557 This is the same as (default-value 'case-fold-search). */);
5559 #ifdef DOS_NT
5560 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
5561 &buffer_defaults.buffer_file_type,
5562 doc: /* Default file type for buffers that do not override it.
5563 This is the same as (default-value 'buffer-file-type).
5564 The file type is nil for text, t for binary. */);
5565 #endif
5567 DEFVAR_LISP_NOPRO ("default-left-margin-width",
5568 &buffer_defaults.left_margin_cols,
5569 doc: /* Default value of `left-margin-width' for buffers that don't override it.
5570 This is the same as (default-value 'left-margin-width). */);
5572 DEFVAR_LISP_NOPRO ("default-right-margin-width",
5573 &buffer_defaults.right_margin_cols,
5574 doc: /* Default value of `right-margin-width' for buffers that don't override it.
5575 This is the same as (default-value 'right-margin-width). */);
5577 DEFVAR_LISP_NOPRO ("default-left-fringe-width",
5578 &buffer_defaults.left_fringe_width,
5579 doc: /* Default value of `left-fringe-width' for buffers that don't override it.
5580 This is the same as (default-value 'left-fringe-width). */);
5582 DEFVAR_LISP_NOPRO ("default-right-fringe-width",
5583 &buffer_defaults.right_fringe_width,
5584 doc: /* Default value of `right-fringe-width' for buffers that don't override it.
5585 This is the same as (default-value 'right-fringe-width). */);
5587 DEFVAR_LISP_NOPRO ("default-fringes-outside-margins",
5588 &buffer_defaults.fringes_outside_margins,
5589 doc: /* Default value of `fringes-outside-margins' for buffers that don't override it.
5590 This is the same as (default-value 'fringes-outside-margins). */);
5592 DEFVAR_LISP_NOPRO ("default-scroll-bar-width",
5593 &buffer_defaults.scroll_bar_width,
5594 doc: /* Default value of `scroll-bar-width' for buffers that don't override it.
5595 This is the same as (default-value 'scroll-bar-width). */);
5597 DEFVAR_LISP_NOPRO ("default-vertical-scroll-bar",
5598 &buffer_defaults.vertical_scroll_bar_type,
5599 doc: /* Default value of `vertical-scroll-bar' for buffers that don't override it.
5600 This is the same as (default-value 'vertical-scroll-bar). */);
5602 DEFVAR_LISP_NOPRO ("default-indicate-empty-lines",
5603 &buffer_defaults.indicate_empty_lines,
5604 doc: /* Default value of `indicate-empty-lines' for buffers that don't override it.
5605 This is the same as (default-value 'indicate-empty-lines). */);
5607 DEFVAR_LISP_NOPRO ("default-indicate-buffer-boundaries",
5608 &buffer_defaults.indicate_buffer_boundaries,
5609 doc: /* Default value of `indicate-buffer-boundaries' for buffers that don't override it.
5610 This is the same as (default-value 'indicate-buffer-boundaries). */);
5612 DEFVAR_LISP_NOPRO ("default-fringe-indicator-alist",
5613 &buffer_defaults.fringe_indicator_alist,
5614 doc: /* Default value of `fringe-indicator-alist' for buffers that don't override it.
5615 This is the same as (default-value 'fringe-indicator-alist'). */);
5617 DEFVAR_LISP_NOPRO ("default-fringe-cursor-alist",
5618 &buffer_defaults.fringe_cursor_alist,
5619 doc: /* Default value of `fringe-cursor-alist' for buffers that don't override it.
5620 This is the same as (default-value 'fringe-cursor-alist'). */);
5622 DEFVAR_LISP_NOPRO ("default-scroll-up-aggressively",
5623 &buffer_defaults.scroll_up_aggressively,
5624 doc: /* Default value of `scroll-up-aggressively'.
5625 This value applies in buffers that don't have their own local values.
5626 This is the same as (default-value 'scroll-up-aggressively). */);
5628 DEFVAR_LISP_NOPRO ("default-scroll-down-aggressively",
5629 &buffer_defaults.scroll_down_aggressively,
5630 doc: /* Default value of `scroll-down-aggressively'.
5631 This value applies in buffers that don't have their own local values.
5632 This is the same as (default-value 'scroll-down-aggressively). */);
5634 DEFVAR_PER_BUFFER ("header-line-format",
5635 &current_buffer->header_line_format,
5636 Qnil,
5637 doc: /* Analogous to `mode-line-format', but controls the header line.
5638 The header line appears, optionally, at the top of a window;
5639 the mode line appears at the bottom. */);
5641 DEFVAR_PER_BUFFER ("mode-line-format", &current_buffer->mode_line_format,
5642 Qnil,
5643 doc: /* Template for displaying mode line for current buffer.
5644 Each buffer has its own value of this variable.
5645 Value may be nil, a string, a symbol or a list or cons cell.
5646 A value of nil means don't display a mode line.
5647 For a symbol, its value is used (but it is ignored if t or nil).
5648 A string appearing directly as the value of a symbol is processed verbatim
5649 in that the %-constructs below are not recognized.
5650 Note that unless the symbol is marked as a `risky-local-variable', all
5651 properties in any strings, as well as all :eval and :propertize forms
5652 in the value of that symbol will be ignored.
5653 For a list of the form `(:eval FORM)', FORM is evaluated and the result
5654 is used as a mode line element. Be careful--FORM should not load any files,
5655 because that can cause an infinite recursion.
5656 For a list of the form `(:propertize ELT PROPS...)', ELT is displayed
5657 with the specified properties PROPS applied.
5658 For a list whose car is a symbol, the symbol's value is taken,
5659 and if that is non-nil, the cadr of the list is processed recursively.
5660 Otherwise, the caddr of the list (if there is one) is processed.
5661 For a list whose car is a string or list, each element is processed
5662 recursively and the results are effectively concatenated.
5663 For a list whose car is an integer, the cdr of the list is processed
5664 and padded (if the number is positive) or truncated (if negative)
5665 to the width specified by that number.
5666 A string is printed verbatim in the mode line except for %-constructs:
5667 (%-constructs are allowed when the string is the entire mode-line-format
5668 or when it is found in a cons-cell or a list)
5669 %b -- print buffer name. %f -- print visited file name.
5670 %F -- print frame name.
5671 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.
5672 %& is like %*, but ignore read-only-ness.
5673 % means buffer is read-only and * means it is modified.
5674 For a modified read-only buffer, %* gives % and %+ gives *.
5675 %s -- print process status. %l -- print the current line number.
5676 %c -- print the current column number (this makes editing slower).
5677 To make the column number update correctly in all cases,
5678 `column-number-mode' must be non-nil.
5679 %i -- print the size of the buffer.
5680 %I -- like %i, but use k, M, G, etc., to abbreviate.
5681 %p -- print percent of buffer above top of window, or Top, Bot or All.
5682 %P -- print percent of buffer above bottom of window, perhaps plus Top,
5683 or print Bottom or All.
5684 %n -- print Narrow if appropriate.
5685 %t -- visited file is text or binary (if OS supports this distinction).
5686 %z -- print mnemonics of keyboard, terminal, and buffer coding systems.
5687 %Z -- like %z, but including the end-of-line format.
5688 %e -- print error message about full memory.
5689 %@ -- print @ or hyphen. @ means that default-directory is on a
5690 remote machine.
5691 %[ -- print one [ for each recursive editing level. %] similar.
5692 %% -- print %. %- -- print infinitely many dashes.
5693 Decimal digits after the % specify field width to which to pad. */);
5695 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults.major_mode,
5696 doc: /* *Major mode for new buffers. Defaults to `fundamental-mode'.
5697 A value of nil means use current buffer's major mode,
5698 provided it is not marked as "special".
5700 When a mode is used by default, `find-file' switches to it
5701 before it reads the contents into the buffer and before
5702 it finishes setting up the buffer. Thus, the mode and
5703 its hooks should not expect certain variables such as
5704 `buffer-read-only' and `buffer-file-coding-system' to be set up. */);
5706 DEFVAR_PER_BUFFER ("major-mode", &current_buffer->major_mode,
5707 make_number (Lisp_Symbol),
5708 doc: /* Symbol for current buffer's major mode. */);
5710 DEFVAR_PER_BUFFER ("mode-name", &current_buffer->mode_name,
5711 Qnil,
5712 doc: /* Pretty name of current buffer's major mode.
5713 Usually a string. See `mode-line-format' for other possible forms.
5714 Use the function `format-mode-line' to get the value as a string. */);
5716 DEFVAR_PER_BUFFER ("local-abbrev-table", &current_buffer->abbrev_table, Qnil,
5717 doc: /* Local (mode-specific) abbrev table of current buffer. */);
5719 DEFVAR_PER_BUFFER ("abbrev-mode", &current_buffer->abbrev_mode, Qnil,
5720 doc: /* Non-nil turns on automatic expansion of abbrevs as they are inserted. */);
5722 DEFVAR_PER_BUFFER ("case-fold-search", &current_buffer->case_fold_search,
5723 Qnil,
5724 doc: /* *Non-nil if searches and matches should ignore case. */);
5726 DEFVAR_PER_BUFFER ("fill-column", &current_buffer->fill_column,
5727 make_number (Lisp_Int),
5728 doc: /* *Column beyond which automatic line-wrapping should happen.
5729 Interactively, you can set the buffer local value using \\[set-fill-column]. */);
5731 DEFVAR_PER_BUFFER ("left-margin", &current_buffer->left_margin,
5732 make_number (Lisp_Int),
5733 doc: /* *Column for the default `indent-line-function' to indent to.
5734 Linefeed indents to this column in Fundamental mode. */);
5736 DEFVAR_PER_BUFFER ("tab-width", &current_buffer->tab_width,
5737 make_number (Lisp_Int),
5738 doc: /* *Distance between tab stops (for display of tab characters), in columns. */);
5740 DEFVAR_PER_BUFFER ("ctl-arrow", &current_buffer->ctl_arrow, Qnil,
5741 doc: /* *Non-nil means display control chars with uparrow.
5742 A value of nil means use backslash and octal digits.
5743 This variable does not apply to characters whose display is specified
5744 in the current display table (if there is one). */);
5746 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
5747 &current_buffer->enable_multibyte_characters,
5748 Qnil,
5749 doc: /* Non-nil means the buffer contents are regarded as multi-byte characters.
5750 Otherwise they are regarded as unibyte. This affects the display,
5751 file I/O and the behavior of various editing commands.
5753 This variable is buffer-local but you cannot set it directly;
5754 use the function `set-buffer-multibyte' to change a buffer's representation.
5755 Changing its default value with `setq-default' is supported.
5756 See also variable `default-enable-multibyte-characters' and Info node
5757 `(elisp)Text Representations'. */);
5758 XSYMBOL (intern ("enable-multibyte-characters"))->constant = 1;
5760 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
5761 &current_buffer->buffer_file_coding_system, Qnil,
5762 doc: /* Coding system to be used for encoding the buffer contents on saving.
5763 This variable applies to saving the buffer, and also to `write-region'
5764 and other functions that use `write-region'.
5765 It does not apply to sending output to subprocesses, however.
5767 If this is nil, the buffer is saved without any code conversion
5768 unless some coding system is specified in `file-coding-system-alist'
5769 for the buffer file.
5771 If the text to be saved cannot be encoded as specified by this variable,
5772 an alternative encoding is selected by `select-safe-coding-system', which see.
5774 The variable `coding-system-for-write', if non-nil, overrides this variable.
5776 This variable is never applied to a way of decoding a file while reading it. */);
5778 DEFVAR_PER_BUFFER ("direction-reversed", &current_buffer->direction_reversed,
5779 Qnil,
5780 doc: /* *Non-nil means lines in the buffer are displayed right to left. */);
5782 DEFVAR_PER_BUFFER ("truncate-lines", &current_buffer->truncate_lines, Qnil,
5783 doc: /* *Non-nil means do not display continuation lines.
5784 Instead, give each line of text just one screen line.
5786 Note that this is overridden by the variable
5787 `truncate-partial-width-windows' if that variable is non-nil
5788 and this buffer is not full-frame width. */);
5790 #ifdef DOS_NT
5791 DEFVAR_PER_BUFFER ("buffer-file-type", &current_buffer->buffer_file_type,
5792 Qnil,
5793 doc: /* Non-nil if the visited file is a binary file.
5794 This variable is meaningful on MS-DOG and Windows NT.
5795 On those systems, it is automatically local in every buffer.
5796 On other systems, this variable is normally always nil. */);
5797 #endif
5799 DEFVAR_PER_BUFFER ("default-directory", &current_buffer->directory,
5800 make_number (Lisp_String),
5801 doc: /* Name of default directory of current buffer. Should end with slash.
5802 To interactively change the default directory, use command `cd'. */);
5804 DEFVAR_PER_BUFFER ("auto-fill-function", &current_buffer->auto_fill_function,
5805 Qnil,
5806 doc: /* Function called (if non-nil) to perform auto-fill.
5807 It is called after self-inserting any character specified in
5808 the `auto-fill-chars' table.
5809 NOTE: This variable is not a hook;
5810 its value may not be a list of functions. */);
5812 DEFVAR_PER_BUFFER ("buffer-file-name", &current_buffer->filename,
5813 make_number (Lisp_String),
5814 doc: /* Name of file visited in current buffer, or nil if not visiting a file. */);
5816 DEFVAR_PER_BUFFER ("buffer-file-truename", &current_buffer->file_truename,
5817 make_number (Lisp_String),
5818 doc: /* Abbreviated truename of file visited in current buffer, or nil if none.
5819 The truename of a file is calculated by `file-truename'
5820 and then abbreviated with `abbreviate-file-name'. */);
5822 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
5823 &current_buffer->auto_save_file_name,
5824 make_number (Lisp_String),
5825 doc: /* Name of file for auto-saving current buffer.
5826 If it is nil, that means don't auto-save this buffer. */);
5828 DEFVAR_PER_BUFFER ("buffer-read-only", &current_buffer->read_only, Qnil,
5829 doc: /* Non-nil if this buffer is read-only. */);
5831 DEFVAR_PER_BUFFER ("buffer-backed-up", &current_buffer->backed_up, Qnil,
5832 doc: /* Non-nil if this buffer's file has been backed up.
5833 Backing up is done before the first time the file is saved. */);
5835 DEFVAR_PER_BUFFER ("buffer-saved-size", &current_buffer->save_length,
5836 make_number (Lisp_Int),
5837 doc: /* Length of current buffer when last read in, saved or auto-saved.
5838 0 initially. */);
5840 DEFVAR_PER_BUFFER ("selective-display", &current_buffer->selective_display,
5841 Qnil,
5842 doc: /* Non-nil enables selective display.
5843 An integer N as value means display only lines
5844 that start with less than N columns of space.
5845 A value of t means that the character ^M makes itself and
5846 all the rest of the line invisible; also, when saving the buffer
5847 in a file, save the ^M as a newline. */);
5849 #ifndef old
5850 DEFVAR_PER_BUFFER ("selective-display-ellipses",
5851 &current_buffer->selective_display_ellipses,
5852 Qnil,
5853 doc: /* Non-nil means display ... on previous line when a line is invisible. */);
5854 #endif
5856 DEFVAR_PER_BUFFER ("overwrite-mode", &current_buffer->overwrite_mode, Qnil,
5857 doc: /* Non-nil if self-insertion should replace existing text.
5858 The value should be one of `overwrite-mode-textual',
5859 `overwrite-mode-binary', or nil.
5860 If it is `overwrite-mode-textual', self-insertion still
5861 inserts at the end of a line, and inserts when point is before a tab,
5862 until the tab is filled in.
5863 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too. */);
5865 DEFVAR_PER_BUFFER ("buffer-display-table", &current_buffer->display_table,
5866 Qnil,
5867 doc: /* Display table that controls display of the contents of current buffer.
5869 If this variable is nil, the value of `standard-display-table' is used.
5870 Each window can have its own, overriding display table, see
5871 `set-window-display-table' and `window-display-table'.
5873 The display table is a char-table created with `make-display-table'.
5874 A char-table is an array indexed by character codes. Normal array
5875 primitives `aref' and `aset' can be used to access elements of a char-table.
5877 Each of the char-table elements control how to display the corresponding
5878 text character: the element at index C in the table says how to display
5879 the character whose code is C. Each element should be a vector of
5880 characters or nil. The value nil means display the character in the
5881 default fashion; otherwise, the characters from the vector are delivered
5882 to the screen instead of the original character.
5884 For example, (aset buffer-display-table ?X [?Y]) tells Emacs
5885 to display a capital Y instead of each X character.
5887 In addition, a char-table has six extra slots to control the display of:
5889 the end of a truncated screen line (extra-slot 0, a single character);
5890 the end of a continued line (extra-slot 1, a single character);
5891 the escape character used to display character codes in octal
5892 (extra-slot 2, a single character);
5893 the character used as an arrow for control characters (extra-slot 3,
5894 a single character);
5895 the decoration indicating the presence of invisible lines (extra-slot 4,
5896 a vector of characters);
5897 the character used to draw the border between side-by-side windows
5898 (extra-slot 5, a single character).
5900 See also the functions `display-table-slot' and `set-display-table-slot'. */);
5902 DEFVAR_PER_BUFFER ("left-margin-width", &current_buffer->left_margin_cols,
5903 Qnil,
5904 doc: /* *Width of left marginal area for display of a buffer.
5905 A value of nil means no marginal area. */);
5907 DEFVAR_PER_BUFFER ("right-margin-width", &current_buffer->right_margin_cols,
5908 Qnil,
5909 doc: /* *Width of right marginal area for display of a buffer.
5910 A value of nil means no marginal area. */);
5912 DEFVAR_PER_BUFFER ("left-fringe-width", &current_buffer->left_fringe_width,
5913 Qnil,
5914 doc: /* *Width of this buffer's left fringe (in pixels).
5915 A value of 0 means no left fringe is shown in this buffer's window.
5916 A value of nil means to use the left fringe width from the window's frame. */);
5918 DEFVAR_PER_BUFFER ("right-fringe-width", &current_buffer->right_fringe_width,
5919 Qnil,
5920 doc: /* *Width of this buffer's right fringe (in pixels).
5921 A value of 0 means no right fringe is shown in this buffer's window.
5922 A value of nil means to use the right fringe width from the window's frame. */);
5924 DEFVAR_PER_BUFFER ("fringes-outside-margins", &current_buffer->fringes_outside_margins,
5925 Qnil,
5926 doc: /* *Non-nil means to display fringes outside display margins.
5927 A value of nil means to display fringes between margins and buffer text. */);
5929 DEFVAR_PER_BUFFER ("scroll-bar-width", &current_buffer->scroll_bar_width,
5930 Qnil,
5931 doc: /* *Width of this buffer's scroll bars in pixels.
5932 A value of nil means to use the scroll bar width from the window's frame. */);
5934 DEFVAR_PER_BUFFER ("vertical-scroll-bar", &current_buffer->vertical_scroll_bar_type,
5935 Qnil,
5936 doc: /* *Position of this buffer's vertical scroll bar.
5937 The value takes effect whenever you tell a window to display this buffer;
5938 for instance, with `set-window-buffer' or when `display-buffer' displays it.
5940 A value of `left' or `right' means put the vertical scroll bar at that side
5941 of the window; a value of nil means don't show any vertical scroll bars.
5942 A value of t (the default) means do whatever the window's frame specifies. */);
5944 DEFVAR_PER_BUFFER ("indicate-empty-lines",
5945 &current_buffer->indicate_empty_lines, Qnil,
5946 doc: /* *Visually indicate empty lines after the buffer end.
5947 If non-nil, a bitmap is displayed in the left fringe of a window on
5948 window-systems. */);
5950 DEFVAR_PER_BUFFER ("indicate-buffer-boundaries",
5951 &current_buffer->indicate_buffer_boundaries, Qnil,
5952 doc: /* *Visually indicate buffer boundaries and scrolling.
5953 If non-nil, the first and last line of the buffer are marked in the fringe
5954 of a window on window-systems with angle bitmaps, or if the window can be
5955 scrolled, the top and bottom line of the window are marked with up and down
5956 arrow bitmaps.
5958 If value is a symbol `left' or `right', both angle and arrow bitmaps
5959 are displayed in the left or right fringe, resp. Any other value
5960 that doesn't look like an alist means display the angle bitmaps in
5961 the left fringe but no arrows.
5963 You can exercise more precise control by using an alist as the
5964 value. Each alist element (INDICATOR . POSITION) specifies
5965 where to show one of the indicators. INDICATOR is one of `top',
5966 `bottom', `up', `down', or t, which specifies the default position,
5967 and POSITION is one of `left', `right', or nil, meaning do not show
5968 this indicator.
5970 For example, ((top . left) (t . right)) places the top angle bitmap in
5971 left fringe, the bottom angle bitmap in right fringe, and both arrow
5972 bitmaps in right fringe. To show just the angle bitmaps in the left
5973 fringe, but no arrow bitmaps, use ((top . left) (bottom . left)). */);
5975 DEFVAR_PER_BUFFER ("fringe-indicator-alist",
5976 &current_buffer->fringe_indicator_alist, Qnil,
5977 doc: /* *Mapping from logical to physical fringe indicator bitmaps.
5978 The value is an alist where each element (INDICATOR . BITMAPS)
5979 specifies the fringe bitmaps used to display a specific logical
5980 fringe indicator.
5982 INDICATOR specifies the logical indicator type which is one of the
5983 following symbols: `truncation' , `continuation', `overlay-arrow',
5984 `top', `bottom', `up', `down', `one-line', `empty-line', or `unknown'.
5986 BITMAPS is list of symbols (LEFT RIGHT [LEFT1 RIGHT1]) which specifies
5987 the actual bitmap shown in the left or right fringe for the logical
5988 indicator. LEFT and RIGHT are the bitmaps shown in the left and/or
5989 right fringe for the specific indicator. The LEFT1 or RIGHT1 bitmaps
5990 are used only for the `bottom' and `one-line' indicators when the last
5991 \(only) line in has no final newline. BITMAPS may also be a single
5992 symbol which is used in both left and right fringes. */);
5994 DEFVAR_PER_BUFFER ("fringe-cursor-alist",
5995 &current_buffer->fringe_cursor_alist, Qnil,
5996 doc: /* *Mapping from logical to physical fringe cursor bitmaps.
5997 The value is an alist where each element (CURSOR . BITMAP)
5998 specifies the fringe bitmaps used to display a specific logical
5999 cursor type in the fringe.
6001 CURSOR specifies the logical cursor type which is one of the following
6002 symbols: `box' , `hollow', `bar', `hbar', or `hollow-small'. The last
6003 one is used to show a hollow cursor on narrow lines display lines
6004 where the normal hollow cursor will not fit.
6006 BITMAP is the corresponding fringe bitmap shown for the logical
6007 cursor type. */);
6009 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
6010 &current_buffer->scroll_up_aggressively, Qnil,
6011 doc: /* How far to scroll windows upward.
6012 If you move point off the bottom, the window scrolls automatically.
6013 This variable controls how far it scrolls. The value nil, the default,
6014 means scroll to center point. A fraction means scroll to put point
6015 that fraction of the window's height from the bottom of the window.
6016 When the value is 0.0, point goes at the bottom line, which in the simple
6017 case that you moved off with C-f means scrolling just one line. 1.0 means
6018 point goes at the top, so that in that simple case, the window
6019 scrolls by a full window height. Meaningful values are
6020 between 0.0 and 1.0, inclusive. */);
6022 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
6023 &current_buffer->scroll_down_aggressively, Qnil,
6024 doc: /* How far to scroll windows downward.
6025 If you move point off the top, the window scrolls automatically.
6026 This variable controls how far it scrolls. The value nil, the default,
6027 means scroll to center point. A fraction means scroll to put point
6028 that fraction of the window's height from the top of the window.
6029 When the value is 0.0, point goes at the top line, which in the simple
6030 case that you moved off with C-b means scrolling just one line. 1.0 means
6031 point goes at the bottom, so that in that simple case, the window
6032 scrolls by a full window height. Meaningful values are
6033 between 0.0 and 1.0, inclusive. */);
6035 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
6036 "Don't ask.");
6039 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions,
6040 doc: /* List of functions to call before each text change.
6041 Two arguments are passed to each function: the positions of
6042 the beginning and end of the range of old text to be changed.
6043 \(For an insertion, the beginning and end are at the same place.)
6044 No information is given about the length of the text after the change.
6046 Buffer changes made while executing the `before-change-functions'
6047 don't call any before-change or after-change functions.
6048 That's because these variables are temporarily set to nil.
6049 As a result, a hook function cannot straightforwardly alter the value of
6050 these variables. See the Emacs Lisp manual for a way of
6051 accomplishing an equivalent result by using other variables.
6053 If an unhandled error happens in running these functions,
6054 the variable's value remains nil. That prevents the error
6055 from happening repeatedly and making Emacs nonfunctional. */);
6056 Vbefore_change_functions = Qnil;
6058 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions,
6059 doc: /* List of functions to call after each text change.
6060 Three arguments are passed to each function: the positions of
6061 the beginning and end of the range of changed text,
6062 and the length in bytes of the pre-change text replaced by that range.
6063 \(For an insertion, the pre-change length is zero;
6064 for a deletion, that length is the number of bytes deleted,
6065 and the post-change beginning and end are at the same place.)
6067 Buffer changes made while executing the `after-change-functions'
6068 don't call any before-change or after-change functions.
6069 That's because these variables are temporarily set to nil.
6070 As a result, a hook function cannot straightforwardly alter the value of
6071 these variables. See the Emacs Lisp manual for a way of
6072 accomplishing an equivalent result by using other variables.
6074 If an unhandled error happens in running these functions,
6075 the variable's value remains nil. That prevents the error
6076 from happening repeatedly and making Emacs nonfunctional. */);
6077 Vafter_change_functions = Qnil;
6079 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook,
6080 doc: /* A list of functions to call before changing a buffer which is unmodified.
6081 The functions are run using the `run-hooks' function. */);
6082 Vfirst_change_hook = Qnil;
6084 DEFVAR_PER_BUFFER ("buffer-undo-list", &current_buffer->undo_list, Qnil,
6085 doc: /* List of undo entries in current buffer.
6086 Recent changes come first; older changes follow newer.
6088 An entry (BEG . END) represents an insertion which begins at
6089 position BEG and ends at position END.
6091 An entry (TEXT . POSITION) represents the deletion of the string TEXT
6092 from (abs POSITION). If POSITION is positive, point was at the front
6093 of the text being deleted; if negative, point was at the end.
6095 An entry (t HIGH . LOW) indicates that the buffer previously had
6096 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions
6097 of the visited file's modification time, as of that time. If the
6098 modification time of the most recent save is different, this entry is
6099 obsolete.
6101 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property
6102 was modified between BEG and END. PROPERTY is the property name,
6103 and VALUE is the old value.
6105 An entry (apply FUN-NAME . ARGS) means undo the change with
6106 \(apply FUN-NAME ARGS).
6108 An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo
6109 in the active region. BEG and END is the range affected by this entry
6110 and DELTA is the number of bytes added or deleted in that range by
6111 this change.
6113 An entry (MARKER . DISTANCE) indicates that the marker MARKER
6114 was adjusted in position by the offset DISTANCE (an integer).
6116 An entry of the form POSITION indicates that point was at the buffer
6117 location given by the integer. Undoing an entry of this form places
6118 point at POSITION.
6120 Entries with value `nil' mark undo boundaries. The undo command treats
6121 the changes between two undo boundaries as a single step to be undone.
6123 If the value of the variable is t, undo information is not recorded. */);
6125 DEFVAR_PER_BUFFER ("mark-active", &current_buffer->mark_active, Qnil,
6126 doc: /* Non-nil means the mark and region are currently active in this buffer. */);
6128 DEFVAR_PER_BUFFER ("cache-long-line-scans", &current_buffer->cache_long_line_scans, Qnil,
6129 doc: /* Non-nil means that Emacs should use caches to handle long lines more quickly.
6131 Normally, the line-motion functions work by scanning the buffer for
6132 newlines. Columnar operations (like `move-to-column' and
6133 `compute-motion') also work by scanning the buffer, summing character
6134 widths as they go. This works well for ordinary text, but if the
6135 buffer's lines are very long (say, more than 500 characters), these
6136 motion functions will take longer to execute. Emacs may also take
6137 longer to update the display.
6139 If `cache-long-line-scans' is non-nil, these motion functions cache the
6140 results of their scans, and consult the cache to avoid rescanning
6141 regions of the buffer until the text is modified. The caches are most
6142 beneficial when they prevent the most searching---that is, when the
6143 buffer contains long lines and large regions of characters with the
6144 same, fixed screen width.
6146 When `cache-long-line-scans' is non-nil, processing short lines will
6147 become slightly slower (because of the overhead of consulting the
6148 cache), and the caches will use memory roughly proportional to the
6149 number of newlines and characters whose screen width varies.
6151 The caches require no explicit maintenance; their accuracy is
6152 maintained internally by the Emacs primitives. Enabling or disabling
6153 the cache should not affect the behavior of any of the motion
6154 functions; it should only affect their performance. */);
6156 DEFVAR_PER_BUFFER ("point-before-scroll", &current_buffer->point_before_scroll, Qnil,
6157 doc: /* Value of point before the last series of scroll operations, or nil. */);
6159 DEFVAR_PER_BUFFER ("buffer-file-format", &current_buffer->file_format, Qnil,
6160 doc: /* List of formats to use when saving this buffer.
6161 Formats are defined by `format-alist'. This variable is
6162 set when a file is visited. */);
6164 DEFVAR_PER_BUFFER ("buffer-auto-save-file-format",
6165 &current_buffer->auto_save_file_format, Qnil,
6166 doc: /* *Format in which to write auto-save files.
6167 Should be a list of symbols naming formats that are defined in `format-alist'.
6168 If it is t, which is the default, auto-save files are written in the
6169 same format as a regular save would use. */);
6171 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
6172 &current_buffer->invisibility_spec, Qnil,
6173 doc: /* Invisibility spec of this buffer.
6174 The default is t, which means that text is invisible
6175 if it has a non-nil `invisible' property.
6176 If the value is a list, a text character is invisible if its `invisible'
6177 property is an element in that list (or is a list with members in common).
6178 If an element is a cons cell of the form (PROP . ELLIPSIS),
6179 then characters with property value PROP are invisible,
6180 and they have an ellipsis as well if ELLIPSIS is non-nil. */);
6182 DEFVAR_PER_BUFFER ("buffer-display-count",
6183 &current_buffer->display_count, Qnil,
6184 doc: /* A number incremented each time this buffer is displayed in a window.
6185 The function `set-window-buffer' increments it. */);
6187 DEFVAR_PER_BUFFER ("buffer-display-time",
6188 &current_buffer->display_time, Qnil,
6189 doc: /* Time stamp updated each time this buffer is displayed in a window.
6190 The function `set-window-buffer' updates this variable
6191 to the value obtained by calling `current-time'.
6192 If the buffer has never been shown in a window, the value is nil. */);
6194 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode,
6195 doc: /* *Non-nil means deactivate the mark when the buffer contents change.
6196 Non-nil also enables highlighting of the region whenever the mark is active.
6197 The variable `highlight-nonselected-windows' controls whether to highlight
6198 all windows or just the selected window.
6200 If the value is `lambda', that enables Transient Mark mode temporarily
6201 until the next buffer modification. If a command sets the value to `only',
6202 that enables Transient Mark mode for the following command only.
6203 During that following command, the value of `transient-mark-mode'
6204 is `identity'. If it is still `identity' at the end of that command,
6205 it changes to nil. */);
6206 Vtransient_mark_mode = Qnil;
6208 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only,
6209 doc: /* *Non-nil means disregard read-only status of buffers or characters.
6210 If the value is t, disregard `buffer-read-only' and all `read-only'
6211 text properties. If the value is a list, disregard `buffer-read-only'
6212 and disregard a `read-only' text property if the property value
6213 is a member of the list. */);
6214 Vinhibit_read_only = Qnil;
6216 DEFVAR_PER_BUFFER ("cursor-type", &current_buffer->cursor_type, Qnil,
6217 doc: /* Cursor to use when this buffer is in the selected window.
6218 Values are interpreted as follows:
6220 t use the cursor specified for the frame
6221 nil don't display a cursor
6222 box display a filled box cursor
6223 hollow display a hollow box cursor
6224 bar display a vertical bar cursor with default width
6225 (bar . WIDTH) display a vertical bar cursor with width WIDTH
6226 hbar display a horizontal bar cursor with default height
6227 (hbar . HEIGHT) display a horizontal bar cursor with height HEIGHT
6228 ANYTHING ELSE display a hollow box cursor
6230 When the buffer is displayed in a nonselected window,
6231 this variable has no effect; the cursor appears as a hollow box. */);
6233 DEFVAR_PER_BUFFER ("line-spacing",
6234 &current_buffer->extra_line_spacing, Qnil,
6235 doc: /* Additional space to put between lines when displaying a buffer.
6236 The space is measured in pixels, and put below lines on window systems.
6237 If value is a floating point number, it specifies the spacing relative
6238 to the default frame line height. A value of nil means add no extra space. */);
6240 DEFVAR_PER_BUFFER ("cursor-in-non-selected-windows",
6241 &current_buffer->cursor_in_non_selected_windows, Qnil,
6242 doc: /* *Cursor type to display in non-selected windows.
6243 The value t means to use hollow box cursor. See `cursor-type' for other values. */);
6245 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions,
6246 doc: /* List of functions called with no args to query before killing a buffer.
6247 The buffer being killed will be current while the functions are running.
6248 If any of them returns nil, the buffer is not killed. */);
6249 Vkill_buffer_query_functions = Qnil;
6251 DEFVAR_LISP ("change-major-mode-hook", &Vchange_major_mode_hook,
6252 doc: /* Normal hook run before changing the major mode of a buffer.
6253 The function `kill-all-local-variables' runs this before doing anything else. */);
6254 Vchange_major_mode_hook = Qnil;
6255 Qchange_major_mode_hook = intern ("change-major-mode-hook");
6256 staticpro (&Qchange_major_mode_hook);
6258 defsubr (&Sbuffer_live_p);
6259 defsubr (&Sbuffer_list);
6260 defsubr (&Sget_buffer);
6261 defsubr (&Sget_file_buffer);
6262 defsubr (&Sget_buffer_create);
6263 defsubr (&Smake_indirect_buffer);
6264 defsubr (&Sgenerate_new_buffer_name);
6265 defsubr (&Sbuffer_name);
6266 /*defsubr (&Sbuffer_number);*/
6267 defsubr (&Sbuffer_file_name);
6268 defsubr (&Sbuffer_base_buffer);
6269 defsubr (&Sbuffer_local_value);
6270 defsubr (&Sbuffer_local_variables);
6271 defsubr (&Sbuffer_modified_p);
6272 defsubr (&Sset_buffer_modified_p);
6273 defsubr (&Sbuffer_modified_tick);
6274 defsubr (&Sbuffer_chars_modified_tick);
6275 defsubr (&Srename_buffer);
6276 defsubr (&Sother_buffer);
6277 defsubr (&Sbuffer_enable_undo);
6278 defsubr (&Skill_buffer);
6279 defsubr (&Sset_buffer_major_mode);
6280 defsubr (&Sswitch_to_buffer);
6281 defsubr (&Spop_to_buffer);
6282 defsubr (&Scurrent_buffer);
6283 defsubr (&Sset_buffer);
6284 defsubr (&Sbarf_if_buffer_read_only);
6285 defsubr (&Sbury_buffer);
6286 defsubr (&Serase_buffer);
6287 defsubr (&Sbuffer_swap_text);
6288 defsubr (&Sset_buffer_multibyte);
6289 defsubr (&Skill_all_local_variables);
6291 defsubr (&Soverlayp);
6292 defsubr (&Smake_overlay);
6293 defsubr (&Sdelete_overlay);
6294 defsubr (&Smove_overlay);
6295 defsubr (&Soverlay_start);
6296 defsubr (&Soverlay_end);
6297 defsubr (&Soverlay_buffer);
6298 defsubr (&Soverlay_properties);
6299 defsubr (&Soverlays_at);
6300 defsubr (&Soverlays_in);
6301 defsubr (&Snext_overlay_change);
6302 defsubr (&Sprevious_overlay_change);
6303 defsubr (&Soverlay_recenter);
6304 defsubr (&Soverlay_lists);
6305 defsubr (&Soverlay_get);
6306 defsubr (&Soverlay_put);
6307 defsubr (&Srestore_buffer_modified_p);
6310 void
6311 keys_of_buffer ()
6313 initial_define_key (control_x_map, 'b', "switch-to-buffer");
6314 initial_define_key (control_x_map, 'k', "kill-buffer");
6316 /* This must not be in syms_of_buffer, because Qdisabled is not
6317 initialized when that function gets called. */
6318 Fput (intern ("erase-buffer"), Qdisabled, Qt);
6321 /* arch-tag: e48569bf-69a9-4b65-a23b-8e68769436e1
6322 (do not change this comment) */