1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
22 #include <sys/types.h>
24 #include <sys/param.h>
27 /* in 4.1, param.h fails to define this. */
28 #define MAXPATHLEN 1024
29 #endif /* not MAXPATHLEN */
33 #include "intervals.h"
37 #include "region-cache.h"
39 #include "blockinput.h"
41 struct buffer
*current_buffer
; /* the current buffer */
43 /* First buffer in chain of all buffers (in reverse order of creation).
44 Threaded through ->next. */
46 struct buffer
*all_buffers
;
48 /* This structure holds the default values of the buffer-local variables
49 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
50 The default value occupies the same slot in this structure
51 as an individual buffer's value occupies in that buffer.
52 Setting the default value also goes through the alist of buffers
53 and stores into each buffer that does not say it has a local value. */
55 struct buffer buffer_defaults
;
57 /* A Lisp_Object pointer to the above, used for staticpro */
59 static Lisp_Object Vbuffer_defaults
;
61 /* This structure marks which slots in a buffer have corresponding
62 default values in buffer_defaults.
63 Each such slot has a nonzero value in this structure.
64 The value has only one nonzero bit.
66 When a buffer has its own local value for a slot,
67 the bit for that slot (found in the same slot in this structure)
68 is turned on in the buffer's local_var_flags slot.
70 If a slot in this structure is -1, then even though there may
71 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
72 and the corresponding slot in buffer_defaults is not used.
74 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
75 but there is a default value which is copied into each buffer.
77 If a slot in this structure is negative, then even though there may
78 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
79 and the corresponding slot in buffer_defaults is not used.
81 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
82 zero, that is a bug */
84 struct buffer buffer_local_flags
;
86 /* This structure holds the names of symbols whose values may be
87 buffer-local. It is indexed and accessed in the same way as the above. */
89 struct buffer buffer_local_symbols
;
90 /* A Lisp_Object pointer to the above, used for staticpro */
91 static Lisp_Object Vbuffer_local_symbols
;
93 /* This structure holds the required types for the values in the
94 buffer-local slots. If a slot contains Qnil, then the
95 corresponding buffer slot may contain a value of any type. If a
96 slot contains an integer, then prospective values' tags must be
97 equal to that integer. When a tag does not match, the function
98 buffer_slot_type_mismatch will signal an error. */
99 struct buffer buffer_local_types
;
101 Lisp_Object
Fset_buffer ();
102 void set_buffer_internal ();
103 void set_buffer_internal_1 ();
104 static void call_overlay_mod_hooks ();
105 static void swap_out_buffer_local_variables ();
107 /* Alist of all buffer names vs the buffers. */
108 /* This used to be a variable, but is no longer,
109 to prevent lossage due to user rplac'ing this alist or its elements. */
110 Lisp_Object Vbuffer_alist
;
112 /* Functions to call before and after each text change. */
113 Lisp_Object Vbefore_change_function
;
114 Lisp_Object Vafter_change_function
;
115 Lisp_Object Vbefore_change_functions
;
116 Lisp_Object Vafter_change_functions
;
118 Lisp_Object Vtransient_mark_mode
;
120 /* t means ignore all read-only text properties.
121 A list means ignore such a property if its value is a member of the list.
122 Any non-nil value means ignore buffer-read-only. */
123 Lisp_Object Vinhibit_read_only
;
125 /* List of functions to call that can query about killing a buffer.
126 If any of these functions returns nil, we don't kill it. */
127 Lisp_Object Vkill_buffer_query_functions
;
129 /* List of functions to call before changing an unmodified buffer. */
130 Lisp_Object Vfirst_change_hook
;
132 Lisp_Object Qfirst_change_hook
;
133 Lisp_Object Qbefore_change_functions
;
134 Lisp_Object Qafter_change_functions
;
136 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
138 Lisp_Object Qprotected_field
;
140 Lisp_Object QSFundamental
; /* A string "Fundamental" */
142 Lisp_Object Qkill_buffer_hook
;
144 Lisp_Object Qget_file_buffer
;
146 Lisp_Object Qoverlayp
;
148 Lisp_Object Qpriority
, Qwindow
, Qevaporate
, Qbefore_string
, Qafter_string
;
150 Lisp_Object Qmodification_hooks
;
151 Lisp_Object Qinsert_in_front_hooks
;
152 Lisp_Object Qinsert_behind_hooks
;
154 /* For debugging; temporary. See set_buffer_internal. */
155 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
161 error ("No buffer named %s", XSTRING (spec
)->data
);
162 error ("Invalid buffer argument");
165 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
166 "Return a list of all existing live buffers.")
169 return Fmapcar (Qcdr
, Vbuffer_alist
);
172 /* Like Fassoc, but use Fstring_equal to compare
173 (which ignores text properties),
174 and don't ever QUIT. */
177 assoc_ignore_text_properties (key
, list
)
178 register Lisp_Object key
;
181 register Lisp_Object tail
;
182 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
184 register Lisp_Object elt
, tem
;
186 tem
= Fstring_equal (Fcar (elt
), key
);
193 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
194 "Return the buffer named NAME (a string).\n\
195 If there is no live buffer named NAME, return nil.\n\
196 NAME may also be a buffer; if so, the value is that buffer.")
198 register Lisp_Object name
;
202 CHECK_STRING (name
, 0);
204 return Fcdr (assoc_ignore_text_properties (name
, Vbuffer_alist
));
207 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
208 "Return the buffer visiting file FILENAME (a string).\n\
209 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
210 If there is no such live buffer, return nil.\n\
211 See also `find-buffer-visiting'.")
213 register Lisp_Object filename
;
215 register Lisp_Object tail
, buf
, tem
;
218 CHECK_STRING (filename
, 0);
219 filename
= Fexpand_file_name (filename
, Qnil
);
221 /* If the file name has special constructs in it,
222 call the corresponding file handler. */
223 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
225 return call2 (handler
, Qget_file_buffer
, filename
);
227 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
229 buf
= Fcdr (XCONS (tail
)->car
);
230 if (!BUFFERP (buf
)) continue;
231 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
232 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
240 get_truename_buffer (filename
)
241 register Lisp_Object filename
;
243 register Lisp_Object tail
, buf
, tem
;
245 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
247 buf
= Fcdr (XCONS (tail
)->car
);
248 if (!BUFFERP (buf
)) continue;
249 if (!STRINGP (XBUFFER (buf
)->file_truename
)) continue;
250 tem
= Fstring_equal (XBUFFER (buf
)->file_truename
, filename
);
257 /* Incremented for each buffer created, to assign the buffer number. */
260 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
261 "Return the buffer named NAME, or create such a buffer and return it.\n\
262 A new buffer is created if there is no live buffer named NAME.\n\
263 If NAME starts with a space, the new buffer does not keep undo information.\n\
264 If NAME is a buffer instead of a string, then it is the value returned.\n\
265 The value is never nil.")
267 register Lisp_Object name
;
269 register Lisp_Object buf
;
270 register struct buffer
*b
;
272 buf
= Fget_buffer (name
);
276 if (XSTRING (name
)->size
== 0)
277 error ("Empty string for buffer name is not allowed");
279 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
281 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
283 /* An ordinary buffer uses its own struct buffer_text. */
284 b
->text
= &b
->own_text
;
287 BUF_GAP_SIZE (b
) = 20;
289 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
291 if (! BUF_BEG_ADDR (b
))
292 buffer_memory_full ();
300 BUF_SAVE_MODIFF (b
) = 1;
301 BUF_INTERVALS (b
) = 0;
303 b
->newline_cache
= 0;
304 b
->width_run_cache
= 0;
305 b
->width_table
= Qnil
;
307 /* Put this on the chain of all buffers including killed ones. */
308 b
->next
= all_buffers
;
311 /* An ordinary buffer normally doesn't need markers
312 to handle BEGV and ZV. */
314 b
->begv_marker
= Qnil
;
317 name
= Fcopy_sequence (name
);
318 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
321 if (XSTRING (name
)->data
[0] != ' ')
327 reset_buffer_local_variables (b
);
329 /* Put this in the alist of all live buffers. */
331 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
333 b
->mark
= Fmake_marker ();
334 BUF_MARKERS (b
) = Qnil
;
339 DEFUN ("make-indirect-buffer",
340 Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
341 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
342 "Create and return an indirect buffer for buffer BASE, named NAME.\n\
343 BASE should be an existing buffer (or buffer name).\n\
344 NAME should be a string which is not the name of an existing buffer.")
346 register Lisp_Object base_buffer
, name
;
348 register Lisp_Object buf
;
349 register struct buffer
*b
;
351 buf
= Fget_buffer (name
);
353 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
355 base_buffer
= Fget_buffer (base_buffer
);
356 if (NILP (base_buffer
))
357 error ("No such buffer: `%s'",
358 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
360 if (XSTRING (name
)->size
== 0)
361 error ("Empty string for buffer name is not allowed");
363 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
365 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
367 if (XBUFFER (base_buffer
)->base_buffer
)
368 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
370 b
->base_buffer
= XBUFFER (base_buffer
);
372 /* Use the base buffer's text object. */
373 b
->text
= b
->base_buffer
->text
;
375 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
376 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
377 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
379 b
->newline_cache
= 0;
380 b
->width_run_cache
= 0;
381 b
->width_table
= Qnil
;
383 /* Put this on the chain of all buffers including killed ones. */
384 b
->next
= all_buffers
;
387 name
= Fcopy_sequence (name
);
388 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
392 reset_buffer_local_variables (b
);
394 /* Put this in the alist of all live buffers. */
396 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
398 b
->mark
= Fmake_marker ();
401 /* Make sure the base buffer has markers for its narrowing. */
402 if (NILP (b
->base_buffer
->pt_marker
))
404 b
->base_buffer
->pt_marker
= Fmake_marker ();
405 Fset_marker (b
->base_buffer
->pt_marker
,
406 make_number (BUF_PT (b
->base_buffer
)), base_buffer
);
408 if (NILP (b
->base_buffer
->begv_marker
))
410 b
->base_buffer
->begv_marker
= Fmake_marker ();
411 Fset_marker (b
->base_buffer
->begv_marker
,
412 make_number (BUF_BEGV (b
->base_buffer
)), base_buffer
);
414 if (NILP (b
->base_buffer
->zv_marker
))
416 b
->base_buffer
->zv_marker
= Fmake_marker ();
417 Fset_marker (b
->base_buffer
->zv_marker
,
418 make_number (BUF_ZV (b
->base_buffer
)), base_buffer
);
419 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
422 /* Give the indirect buffer markers for its narrowing. */
423 b
->pt_marker
= Fmake_marker ();
424 Fset_marker (b
->pt_marker
, make_number (BUF_PT (b
)), buf
);
425 b
->begv_marker
= Fmake_marker ();
426 Fset_marker (b
->begv_marker
, make_number (BUF_BEGV (b
)), buf
);
427 b
->zv_marker
= Fmake_marker ();
428 Fset_marker (b
->zv_marker
, make_number (BUF_ZV (b
)), buf
);
430 XMARKER (b
->zv_marker
)->insertion_type
= 1;
435 /* Reinitialize everything about a buffer except its name and contents
436 and local variables. */
440 register struct buffer
*b
;
443 b
->file_truename
= Qnil
;
444 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
446 XSETFASTINT (b
->save_length
, 0);
447 b
->last_window_start
= 1;
449 b
->auto_save_modified
= 0;
450 b
->auto_save_failure_time
= -1;
451 b
->auto_save_file_name
= Qnil
;
453 b
->overlays_before
= Qnil
;
454 b
->overlays_after
= Qnil
;
455 XSETFASTINT (b
->overlay_center
, 1);
456 b
->mark_active
= Qnil
;
457 b
->point_before_scroll
= Qnil
;
458 b
->file_format
= Qnil
;
461 /* Reset buffer B's local variables info.
462 Don't use this on a buffer that has already been in use;
463 it does not treat permanent locals consistently.
464 Instead, use Fkill_all_local_variables. */
466 reset_buffer_local_variables (b
)
467 register struct buffer
*b
;
471 /* Reset the major mode to Fundamental, together with all the
472 things that depend on the major mode.
473 default-major-mode is handled at a higher level.
474 We ignore it here. */
475 b
->major_mode
= Qfundamental_mode
;
477 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
478 b
->mode_name
= QSFundamental
;
479 b
->minor_modes
= Qnil
;
480 b
->downcase_table
= Vascii_downcase_table
;
481 b
->upcase_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[0];
482 b
->case_canon_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[1];
483 b
->case_eqv_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[2];
484 b
->buffer_file_type
= Qnil
;
485 b
->invisibility_spec
= Qt
;
488 b
->sort_table
= XSTRING (Vascii_sort_table
);
489 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
492 /* Reset all per-buffer variables to their defaults. */
493 b
->local_var_alist
= Qnil
;
494 b
->local_var_flags
= 0;
496 /* For each slot that has a default value,
497 copy that into the slot. */
499 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
500 offset
< sizeof (struct buffer
);
501 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
503 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
504 if (flag
> 0 || flag
== -2)
505 *(Lisp_Object
*)(offset
+ (char *)b
) =
506 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
510 /* We split this away from generate-new-buffer, because rename-buffer
511 and set-visited-file-name ought to be able to use this to really
512 rename the buffer properly. */
514 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
516 "Return a string that is the name of no existing buffer based on NAME.\n\
517 If there is no live buffer named NAME, then return NAME.\n\
518 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
519 until an unused name is found, and then return that name.\n\
520 Optional second argument IGNORE specifies a name that is okay to use\n\
521 \(if it is in the sequence to be tried)\n\
522 even if a buffer with that name exists.")
524 register Lisp_Object name
, ignore
;
526 register Lisp_Object gentemp
, tem
;
530 CHECK_STRING (name
, 0);
532 tem
= Fget_buffer (name
);
539 sprintf (number
, "<%d>", ++count
);
540 gentemp
= concat2 (name
, build_string (number
));
541 tem
= Fstring_equal (gentemp
, ignore
);
544 tem
= Fget_buffer (gentemp
);
551 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
552 "Return the name of BUFFER, as a string.\n\
553 With no argument or nil as argument, return the name of the current buffer.")
555 register Lisp_Object buffer
;
558 return current_buffer
->name
;
559 CHECK_BUFFER (buffer
, 0);
560 return XBUFFER (buffer
)->name
;
563 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
564 "Return name of file BUFFER is visiting, or nil if none.\n\
565 No argument or nil as argument means use the current buffer.")
567 register Lisp_Object buffer
;
570 return current_buffer
->filename
;
571 CHECK_BUFFER (buffer
, 0);
572 return XBUFFER (buffer
)->filename
;
575 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
577 "Return the base buffer of indirect buffer BUFFER.\n\
578 If BUFFER is not indirect, return nil.")
580 register Lisp_Object buffer
;
583 Lisp_Object base_buffer
;
586 base
= current_buffer
->base_buffer
;
589 CHECK_BUFFER (buffer
, 0);
590 base
= XBUFFER (buffer
)->base_buffer
;
595 XSETBUFFER (base_buffer
, base
);
599 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
600 Sbuffer_local_variables
, 0, 1, 0,
601 "Return an alist of variables that are buffer-local in BUFFER.\n\
602 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
603 For a symbol that is locally unbound, just the symbol appears in the value.\n\
604 Note that storing new VALUEs in these elements doesn't change the variables.\n\
605 No argument or nil as argument means use current buffer as BUFFER.")
607 register Lisp_Object buffer
;
609 register struct buffer
*buf
;
610 register Lisp_Object result
;
613 buf
= current_buffer
;
616 CHECK_BUFFER (buffer
, 0);
617 buf
= XBUFFER (buffer
);
623 register Lisp_Object tail
;
624 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
626 Lisp_Object val
, elt
;
628 elt
= XCONS (tail
)->car
;
630 /* Reference each variable in the alist in buf.
631 If inquiring about the current buffer, this gets the current values,
632 so store them into the alist so the alist is up to date.
633 If inquiring about some other buffer, this swaps out any values
634 for that buffer, making the alist up to date automatically. */
635 val
= find_symbol_value (XCONS (elt
)->car
);
636 /* Use the current buffer value only if buf is the current buffer. */
637 if (buf
!= current_buffer
)
638 val
= XCONS (elt
)->cdr
;
640 /* If symbol is unbound, put just the symbol in the list. */
641 if (EQ (val
, Qunbound
))
642 result
= Fcons (XCONS (elt
)->car
, result
);
643 /* Otherwise, put (symbol . value) in the list. */
645 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
649 /* Add on all the variables stored in special slots. */
651 register int offset
, mask
;
653 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
654 offset
< sizeof (struct buffer
);
655 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
657 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
658 if (mask
== -1 || (buf
->local_var_flags
& mask
))
659 if (SYMBOLP (*(Lisp_Object
*)(offset
660 + (char *)&buffer_local_symbols
)))
661 result
= Fcons (Fcons (*((Lisp_Object
*)
662 (offset
+ (char *)&buffer_local_symbols
)),
663 *(Lisp_Object
*)(offset
+ (char *)buf
)),
672 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
674 "Return t if BUFFER was modified since its file was last read or saved.\n\
675 No argument or nil as argument means use current buffer as BUFFER.")
677 register Lisp_Object buffer
;
679 register struct buffer
*buf
;
681 buf
= current_buffer
;
684 CHECK_BUFFER (buffer
, 0);
685 buf
= XBUFFER (buffer
);
688 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
691 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
693 "Mark current buffer as modified or unmodified according to FLAG.\n\
694 A non-nil FLAG means mark the buffer modified.")
696 register Lisp_Object flag
;
698 register int already
;
699 register Lisp_Object fn
;
701 #ifdef CLASH_DETECTION
702 /* If buffer becoming modified, lock the file.
703 If buffer becoming unmodified, unlock the file. */
705 fn
= current_buffer
->file_truename
;
708 already
= SAVE_MODIFF
< MODIFF
;
709 if (!already
&& !NILP (flag
))
711 else if (already
&& NILP (flag
))
714 #endif /* CLASH_DETECTION */
716 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
721 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
723 "Return BUFFER's tick counter, incremented for each change in text.\n\
724 Each buffer has a tick counter which is incremented each time the text in\n\
725 that buffer is changed. It wraps around occasionally.\n\
726 No argument or nil as argument means use current buffer as BUFFER.")
728 register Lisp_Object buffer
;
730 register struct buffer
*buf
;
732 buf
= current_buffer
;
735 CHECK_BUFFER (buffer
, 0);
736 buf
= XBUFFER (buffer
);
739 return make_number (BUF_MODIFF (buf
));
742 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
743 "sRename buffer (to new name): \nP",
744 "Change current buffer's name to NEWNAME (a string).\n\
745 If second arg UNIQUE is nil or omitted, it is an error if a\n\
746 buffer named NEWNAME already exists.\n\
747 If UNIQUE is non-nil, come up with a new name using\n\
748 `generate-new-buffer-name'.\n\
749 Interactively, you can set UNIQUE with a prefix argument.\n\
750 We return the name we actually gave the buffer.\n\
751 This does not change the name of the visited file (if any).")
753 register Lisp_Object newname
, unique
;
755 register Lisp_Object tem
, buf
;
757 CHECK_STRING (newname
, 0);
759 if (XSTRING (newname
)->size
== 0)
760 error ("Empty string is invalid as a buffer name");
762 tem
= Fget_buffer (newname
);
763 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
764 the buffer automatically so you can create another with the original name.
765 It makes UNIQUE equivalent to
766 (rename-buffer (generate-new-buffer-name NEWNAME)). */
767 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
768 return current_buffer
->name
;
772 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
774 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
777 current_buffer
->name
= newname
;
779 /* Catch redisplay's attention. Unless we do this, the mode lines for
780 any windows displaying current_buffer will stay unchanged. */
783 XSETBUFFER (buf
, current_buffer
);
784 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
785 if (NILP (current_buffer
->filename
)
786 && !NILP (current_buffer
->auto_save_file_name
))
787 call0 (intern ("rename-auto-save-file"));
788 /* Refetch since that last call may have done GC. */
789 return current_buffer
->name
;
792 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
793 "Return most recently selected buffer other than BUFFER.\n\
794 Buffers not visible in windows are preferred to visible buffers,\n\
795 unless optional second argument VISIBLE-OK is non-nil.\n\
796 If no other buffer exists, the buffer `*scratch*' is returned.\n\
797 If BUFFER is omitted or nil, some interesting buffer is returned.")
799 register Lisp_Object buffer
, visible_ok
;
801 register Lisp_Object tail
, buf
, notsogood
, tem
;
804 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
806 buf
= Fcdr (Fcar (tail
));
807 if (EQ (buf
, buffer
))
809 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
812 /* If the selected frame has a buffer_predicate,
813 disregard buffers that don't fit the predicate. */
814 tem
= frame_buffer_predicate ();
817 tem
= call1 (tem
, buf
);
823 if (NILP (visible_ok
))
824 tem
= Fget_buffer_window (buf
, Qt
);
829 if (NILP (notsogood
))
832 if (!NILP (notsogood
))
834 return Fget_buffer_create (build_string ("*scratch*"));
837 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
839 "Make BUFFER stop keeping undo information.\n\
840 No argument or nil as argument means do this for the current buffer.")
842 register Lisp_Object buffer
;
844 Lisp_Object real_buffer
;
847 XSETBUFFER (real_buffer
, current_buffer
);
850 real_buffer
= Fget_buffer (buffer
);
851 if (NILP (real_buffer
))
855 XBUFFER (real_buffer
)->undo_list
= Qt
;
860 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
862 "Start keeping undo information for buffer BUFFER.\n\
863 No argument or nil as argument means do this for the current buffer.")
865 register Lisp_Object buffer
;
867 Lisp_Object real_buffer
;
870 XSETBUFFER (real_buffer
, current_buffer
);
873 real_buffer
= Fget_buffer (buffer
);
874 if (NILP (real_buffer
))
878 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
879 XBUFFER (real_buffer
)->undo_list
= Qnil
;
885 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
886 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
887 The buffer being killed will be current while the hook is running.\n\
890 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
891 "Kill the buffer BUFFER.\n\
892 The argument may be a buffer or may be the name of a buffer.\n\
893 An argument of nil means kill the current buffer.\n\n\
894 Value is t if the buffer is actually killed, nil if user says no.\n\n\
895 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
896 if not void, is a list of functions to be called, with no arguments,\n\
897 before the buffer is actually killed. The buffer to be killed is current\n\
898 when the hook functions are called.\n\n\
899 Any processes that have this buffer as the `process-buffer' are killed\n\
900 with `delete-process'.")
905 register struct buffer
*b
;
906 register Lisp_Object tem
;
907 register struct Lisp_Marker
*m
;
908 struct gcpro gcpro1
, gcpro2
;
911 buf
= Fcurrent_buffer ();
913 buf
= Fget_buffer (bufname
);
919 /* Avoid trouble for buffer already dead. */
923 /* Query if the buffer is still modified. */
924 if (INTERACTIVE
&& !NILP (b
->filename
)
925 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
927 GCPRO2 (buf
, bufname
);
928 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
929 XSTRING (b
->name
)->data
));
935 /* Run hooks with the buffer to be killed the current buffer. */
937 register Lisp_Object val
;
938 int count
= specpdl_ptr
- specpdl
;
941 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
942 set_buffer_internal (b
);
944 /* First run the query functions; if any query is answered no,
945 don't kill the buffer. */
946 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
948 tem
= call0 (Fcar (list
));
950 return unbind_to (count
, Qnil
);
953 /* Then run the hooks. */
954 if (!NILP (Vrun_hooks
))
955 call1 (Vrun_hooks
, Qkill_buffer_hook
);
956 unbind_to (count
, Qnil
);
959 /* We have no more questions to ask. Verify that it is valid
960 to kill the buffer. This must be done after the questions
961 since anything can happen within do_yes_or_no_p. */
963 /* Don't kill the minibuffer now current. */
964 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
970 /* When we kill a base buffer, kill all its indirect buffers.
971 We do it at this stage so nothing terrible happens if they
972 ask questions or their hooks get errors. */
973 if (! b
->base_buffer
)
975 struct buffer
*other
;
979 for (other
= all_buffers
; other
; other
= other
->next
)
980 /* all_buffers contains dead buffers too;
981 don't re-kill them. */
982 if (other
->base_buffer
== b
&& !NILP (other
->name
))
985 XSETBUFFER (buf
, other
);
992 /* Make this buffer not be current.
993 In the process, notice if this is the sole visible buffer
994 and give up if so. */
995 if (b
== current_buffer
)
997 tem
= Fother_buffer (buf
, Qnil
);
999 if (b
== current_buffer
)
1003 /* Now there is no question: we can kill the buffer. */
1005 #ifdef CLASH_DETECTION
1006 /* Unlock this buffer's file, if it is locked. */
1008 #endif /* CLASH_DETECTION */
1010 kill_buffer_processes (buf
);
1012 tem
= Vinhibit_quit
;
1014 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1015 Freplace_buffer_in_windows (buf
);
1016 Vinhibit_quit
= tem
;
1018 /* Delete any auto-save file, if we saved it in this session. */
1019 if (STRINGP (b
->auto_save_file_name
)
1020 && b
->auto_save_modified
!= 0
1021 && SAVE_MODIFF
< b
->auto_save_modified
)
1024 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1026 internal_delete_file (b
->auto_save_file_name
);
1031 /* Unchain all markers that belong to this indirect buffer.
1032 Don't unchain the markers that belong to the base buffer
1033 or its other indirect buffers. */
1034 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1040 unchain_marker (tem
);
1046 /* Unchain all markers of this buffer and its indirect buffers.
1047 and leave them pointing nowhere. */
1048 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1055 BUF_MARKERS (b
) = Qnil
;
1057 #ifdef USE_TEXT_PROPERTIES
1058 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1061 /* Perhaps we should explicitly free the interval tree here... */
1064 /* Reset the local variables, so that this buffer's local values
1065 won't be protected from GC. They would be protected
1066 if they happened to remain encached in their symbols.
1067 This gets rid of them for certain. */
1068 swap_out_buffer_local_variables (b
);
1069 reset_buffer_local_variables (b
);
1074 if (! b
->base_buffer
)
1075 BUFFER_FREE (BUF_BEG_ADDR (b
));
1077 if (b
->newline_cache
)
1079 free_region_cache (b
->newline_cache
);
1080 b
->newline_cache
= 0;
1082 if (b
->width_run_cache
)
1084 free_region_cache (b
->width_run_cache
);
1085 b
->width_run_cache
= 0;
1087 b
->width_table
= Qnil
;
1089 b
->undo_list
= Qnil
;
1094 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1095 we do this each time BUF is selected visibly, the more recently
1096 selected buffers are always closer to the front of the list. This
1097 means that other_buffer is more likely to choose a relevant buffer. */
1102 register Lisp_Object link
, prev
;
1105 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1107 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1112 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1113 we cannot use Fdelq itself here because it allows quitting. */
1116 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1118 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1120 XCONS(link
)->cdr
= Vbuffer_alist
;
1121 Vbuffer_alist
= link
;
1124 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1125 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1126 Use this function before selecting the buffer, since it may need to inspect\n\
1127 the current buffer's major mode.")
1132 Lisp_Object function
;
1134 function
= buffer_defaults
.major_mode
;
1135 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1136 function
= current_buffer
->major_mode
;
1138 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1141 count
= specpdl_ptr
- specpdl
;
1143 /* To select a nonfundamental mode,
1144 select the buffer temporarily and then call the mode function. */
1146 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1151 return unbind_to (count
, Qnil
);
1154 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1155 "Select buffer BUFFER in the current window.\n\
1156 BUFFER may be a buffer or a buffer name.\n\
1157 Optional second arg NORECORD non-nil means\n\
1158 do not put this buffer at the front of the list of recently selected ones.\n\
1160 WARNING: This is NOT the way to work on another buffer temporarily\n\
1161 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1162 the window-buffer correspondences.")
1164 Lisp_Object bufname
, norecord
;
1166 register Lisp_Object buf
;
1169 if (EQ (minibuf_window
, selected_window
))
1170 error ("Cannot switch buffers in minibuffer window");
1171 tem
= Fwindow_dedicated_p (selected_window
);
1173 error ("Cannot switch buffers in a dedicated window");
1176 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1179 buf
= Fget_buffer (bufname
);
1182 buf
= Fget_buffer_create (bufname
);
1183 Fset_buffer_major_mode (buf
);
1187 if (NILP (norecord
))
1188 record_buffer (buf
);
1190 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1191 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1198 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
1199 "Select buffer BUFFER in some window, preferably a different one.\n\
1200 If BUFFER is nil, then some other buffer is chosen.\n\
1201 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1202 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1203 window even if BUFFER is already visible in the selected window.")
1205 Lisp_Object bufname
, other
;
1207 register Lisp_Object buf
;
1209 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1212 buf
= Fget_buffer (bufname
);
1215 buf
= Fget_buffer_create (bufname
);
1216 Fset_buffer_major_mode (buf
);
1220 record_buffer (buf
);
1221 Fselect_window (Fdisplay_buffer (buf
, other
));
1225 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1226 "Return the current buffer as a Lisp object.")
1229 register Lisp_Object buf
;
1230 XSETBUFFER (buf
, current_buffer
);
1234 /* Set the current buffer to B. */
1237 set_buffer_internal (b
)
1238 register struct buffer
*b
;
1240 register struct buffer
*old_buf
;
1241 register Lisp_Object tail
, valcontents
;
1244 if (current_buffer
== b
)
1247 windows_or_buffers_changed
= 1;
1248 set_buffer_internal_1 (b
);
1251 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1252 This is used by redisplay. */
1255 set_buffer_internal_1 (b
)
1256 register struct buffer
*b
;
1258 register struct buffer
*old_buf
;
1259 register Lisp_Object tail
, valcontents
;
1262 if (current_buffer
== b
)
1265 old_buf
= current_buffer
;
1267 last_known_column_point
= -1; /* invalidate indentation cache */
1271 /* Put the undo list back in the base buffer, so that it appears
1272 that an indirect buffer shares the undo list of its base. */
1273 if (old_buf
->base_buffer
)
1274 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1276 /* If the old current buffer has markers to record PT, BEGV and ZV
1277 when it is not current, update them now. */
1278 if (! NILP (old_buf
->pt_marker
))
1281 XSETBUFFER (obuf
, old_buf
);
1282 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1284 if (! NILP (old_buf
->begv_marker
))
1287 XSETBUFFER (obuf
, old_buf
);
1288 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1290 if (! NILP (old_buf
->zv_marker
))
1293 XSETBUFFER (obuf
, old_buf
);
1294 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1298 /* Get the undo list from the base buffer, so that it appears
1299 that an indirect buffer shares the undo list of its base. */
1301 b
->undo_list
= b
->base_buffer
->undo_list
;
1303 /* If the new current buffer has markers to record PT, BEGV and ZV
1304 when it is not current, fetch them now. */
1305 if (! NILP (b
->pt_marker
))
1306 BUF_PT (b
) = marker_position (b
->pt_marker
);
1307 if (! NILP (b
->begv_marker
))
1308 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1309 if (! NILP (b
->zv_marker
))
1310 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1312 /* Look down buffer's list of local Lisp variables
1313 to find and update any that forward into C variables. */
1315 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1317 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1318 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1319 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1320 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1321 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1322 /* Just reference the variable
1323 to cause it to become set for this buffer. */
1324 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1327 /* Do the same with any others that were local to the previous buffer */
1330 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1332 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1333 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1334 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1335 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1336 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1337 /* Just reference the variable
1338 to cause it to become set for this buffer. */
1339 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1343 /* Switch to buffer B temporarily for redisplay purposes.
1344 This avoids certain things that don't need to be done within redisplay. */
1350 register struct buffer
*old_buf
;
1352 if (current_buffer
== b
)
1355 old_buf
= current_buffer
;
1360 /* If the old current buffer has markers to record PT, BEGV and ZV
1361 when it is not current, update them now. */
1362 if (! NILP (old_buf
->pt_marker
))
1365 XSETBUFFER (obuf
, old_buf
);
1366 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1368 if (! NILP (old_buf
->begv_marker
))
1371 XSETBUFFER (obuf
, old_buf
);
1372 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1374 if (! NILP (old_buf
->zv_marker
))
1377 XSETBUFFER (obuf
, old_buf
);
1378 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1382 /* If the new current buffer has markers to record PT, BEGV and ZV
1383 when it is not current, fetch them now. */
1384 if (! NILP (b
->pt_marker
))
1385 BUF_PT (b
) = marker_position (b
->pt_marker
);
1386 if (! NILP (b
->begv_marker
))
1387 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1388 if (! NILP (b
->zv_marker
))
1389 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1392 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1393 "Make the buffer BUFFER current for editing operations.\n\
1394 BUFFER may be a buffer or the name of an existing buffer.\n\
1395 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1396 This function does not display the buffer, so its effect ends\n\
1397 when the current command terminates.\n\
1398 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1400 register Lisp_Object bufname
;
1402 register Lisp_Object buffer
;
1403 buffer
= Fget_buffer (bufname
);
1406 if (NILP (XBUFFER (buffer
)->name
))
1407 error ("Selecting deleted buffer");
1408 set_buffer_internal (XBUFFER (buffer
));
1412 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1413 Sbarf_if_buffer_read_only
, 0, 0, 0,
1414 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1417 if (!NILP (current_buffer
->read_only
)
1418 && NILP (Vinhibit_read_only
))
1419 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1423 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1424 "Put BUFFER at the end of the list of all buffers.\n\
1425 There it is the least likely candidate for `other-buffer' to return;\n\
1426 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1427 If BUFFER is nil or omitted, bury the current buffer.\n\
1428 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1429 selected window if it is displayed there.")
1431 register Lisp_Object buf
;
1433 /* Figure out what buffer we're going to bury. */
1436 XSETBUFFER (buf
, current_buffer
);
1438 /* If we're burying the current buffer, unshow it. */
1439 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
1445 buf1
= Fget_buffer (buf
);
1451 /* Move buf to the end of the buffer list. */
1453 register Lisp_Object aelt
, link
;
1455 aelt
= Frassq (buf
, Vbuffer_alist
);
1456 link
= Fmemq (aelt
, Vbuffer_alist
);
1457 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1458 XCONS (link
)->cdr
= Qnil
;
1459 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1465 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1466 "Delete the entire contents of the current buffer.\n\
1467 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1468 so the buffer is truly empty after this.")
1473 current_buffer
->last_window_start
= 1;
1474 /* Prevent warnings, or suspension of auto saving, that would happen
1475 if future size is less than past size. Use of erase-buffer
1476 implies that the future text is not really related to the past text. */
1477 XSETFASTINT (current_buffer
->save_length
, 0);
1481 validate_region (b
, e
)
1482 register Lisp_Object
*b
, *e
;
1484 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1485 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1487 if (XINT (*b
) > XINT (*e
))
1490 tem
= *b
; *b
= *e
; *e
= tem
;
1493 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1494 && XINT (*e
) <= ZV
))
1495 args_out_of_range (*b
, *e
);
1498 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1500 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1501 Most local variable bindings are eliminated so that the default values\n\
1502 become effective once more. Also, the syntax table is set from\n\
1503 `standard-syntax-table', the local keymap is set to nil,\n\
1504 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1505 This function also forces redisplay of the mode line.\n\
1507 Every function to select a new major mode starts by\n\
1508 calling this function.\n\n\
1509 As a special exception, local variables whose names have\n\
1510 a non-nil `permanent-local' property are not eliminated by this function.\n\
1512 The first thing this function does is run\n\
1513 the normal hook `change-major-mode-hook'.")
1516 register Lisp_Object alist
, sym
, tem
;
1519 if (!NILP (Vrun_hooks
))
1520 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1521 oalist
= current_buffer
->local_var_alist
;
1523 /* Make sure none of the bindings in oalist
1524 remain swapped in, in their symbols. */
1526 swap_out_buffer_local_variables (current_buffer
);
1528 /* Actually eliminate all local bindings of this buffer. */
1530 reset_buffer_local_variables (current_buffer
);
1532 /* Redisplay mode lines; we are changing major mode. */
1534 update_mode_lines
++;
1536 /* Any which are supposed to be permanent,
1537 make local again, with the same values they had. */
1539 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1541 sym
= XCONS (XCONS (alist
)->car
)->car
;
1542 tem
= Fget (sym
, Qpermanent_local
);
1545 Fmake_local_variable (sym
);
1546 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1550 /* Force mode-line redisplay. Useful here because all major mode
1551 commands call this function. */
1552 update_mode_lines
++;
1557 /* Make sure no local variables remain set up with buffer B
1558 for their current values. */
1561 swap_out_buffer_local_variables (b
)
1564 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1566 XSETBUFFER (buffer
, b
);
1567 oalist
= b
->local_var_alist
;
1569 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1571 sym
= XCONS (XCONS (alist
)->car
)->car
;
1573 /* Need not do anything if some other buffer's binding is now encached. */
1574 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
;
1575 if (XBUFFER (tem
) == current_buffer
)
1577 /* Symbol is set up for this buffer's old local value.
1578 Set it up for the current buffer with the default value. */
1580 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1581 /* Store the symbol's current value into the alist entry
1582 it is currently set up for. This is so that, if the
1583 local is marked permanent, and we make it local again
1584 later in Fkill_all_local_variables, we don't lose the value. */
1585 XCONS (XCONS (tem
)->car
)->cdr
1586 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
);
1587 /* Switch to the symbol's default-value alist entry. */
1588 XCONS (tem
)->car
= tem
;
1589 /* Mark it as current for buffer B. */
1590 XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1592 /* Store the current value into any forwarding in the symbol. */
1593 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1599 /* Find all the overlays in the current buffer that contain position POS.
1600 Return the number found, and store them in a vector in *VEC_PTR.
1601 Store in *LEN_PTR the size allocated for the vector.
1602 Store in *NEXT_PTR the next position after POS where an overlay starts,
1603 or ZV if there are no more overlays.
1604 Store in *PREV_PTR the previous position before POS where an overlay ends,
1605 or BEGV if there are no previous overlays.
1606 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1608 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1609 when this function is called.
1611 If EXTEND is non-zero, we make the vector bigger if necessary.
1612 If EXTEND is zero, we never extend the vector,
1613 and we store only as many overlays as will fit.
1614 But we still return the total number of overlays. */
1617 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1620 Lisp_Object
**vec_ptr
;
1625 Lisp_Object tail
, overlay
, start
, end
, result
;
1628 Lisp_Object
*vec
= *vec_ptr
;
1631 int inhibit_storing
= 0;
1633 for (tail
= current_buffer
->overlays_before
;
1635 tail
= XCONS (tail
)->cdr
)
1637 int startpos
, endpos
;
1639 overlay
= XCONS (tail
)->car
;
1641 start
= OVERLAY_START (overlay
);
1642 end
= OVERLAY_END (overlay
);
1643 endpos
= OVERLAY_POSITION (end
);
1652 startpos
= OVERLAY_POSITION (start
);
1653 if (startpos
<= pos
)
1657 /* The supplied vector is full.
1658 Either make it bigger, or don't store any more in it. */
1661 *len_ptr
= len
*= 2;
1662 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1666 inhibit_storing
= 1;
1669 if (!inhibit_storing
)
1671 /* Keep counting overlays even if we can't return them all. */
1674 else if (startpos
< next
)
1678 for (tail
= current_buffer
->overlays_after
;
1680 tail
= XCONS (tail
)->cdr
)
1682 int startpos
, endpos
;
1684 overlay
= XCONS (tail
)->car
;
1686 start
= OVERLAY_START (overlay
);
1687 end
= OVERLAY_END (overlay
);
1688 startpos
= OVERLAY_POSITION (start
);
1691 if (startpos
< next
)
1695 endpos
= OVERLAY_POSITION (end
);
1702 *len_ptr
= len
*= 2;
1703 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1707 inhibit_storing
= 1;
1710 if (!inhibit_storing
)
1714 else if (endpos
< pos
&& endpos
> prev
)
1725 /* Find all the overlays in the current buffer that overlap the range BEG-END
1726 or are empty at BEG.
1728 Return the number found, and store them in a vector in *VEC_PTR.
1729 Store in *LEN_PTR the size allocated for the vector.
1730 Store in *NEXT_PTR the next position after POS where an overlay starts,
1731 or ZV if there are no more overlays.
1732 Store in *PREV_PTR the previous position before POS where an overlay ends,
1733 or BEGV if there are no previous overlays.
1734 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1736 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1737 when this function is called.
1739 If EXTEND is non-zero, we make the vector bigger if necessary.
1740 If EXTEND is zero, we never extend the vector,
1741 and we store only as many overlays as will fit.
1742 But we still return the total number of overlays. */
1745 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1748 Lisp_Object
**vec_ptr
;
1753 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
1756 Lisp_Object
*vec
= *vec_ptr
;
1759 int inhibit_storing
= 0;
1761 for (tail
= current_buffer
->overlays_before
;
1763 tail
= XCONS (tail
)->cdr
)
1765 int startpos
, endpos
;
1767 overlay
= XCONS (tail
)->car
;
1769 ostart
= OVERLAY_START (overlay
);
1770 oend
= OVERLAY_END (overlay
);
1771 endpos
= OVERLAY_POSITION (oend
);
1778 startpos
= OVERLAY_POSITION (ostart
);
1779 /* Count an interval if it either overlaps the range
1780 or is empty at the start of the range. */
1781 if ((beg
< endpos
&& startpos
< end
)
1782 || (startpos
== endpos
&& beg
== endpos
))
1786 /* The supplied vector is full.
1787 Either make it bigger, or don't store any more in it. */
1790 *len_ptr
= len
*= 2;
1791 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1795 inhibit_storing
= 1;
1798 if (!inhibit_storing
)
1800 /* Keep counting overlays even if we can't return them all. */
1803 else if (startpos
< next
)
1807 for (tail
= current_buffer
->overlays_after
;
1809 tail
= XCONS (tail
)->cdr
)
1811 int startpos
, endpos
;
1813 overlay
= XCONS (tail
)->car
;
1815 ostart
= OVERLAY_START (overlay
);
1816 oend
= OVERLAY_END (overlay
);
1817 startpos
= OVERLAY_POSITION (ostart
);
1820 if (startpos
< next
)
1824 endpos
= OVERLAY_POSITION (oend
);
1825 /* Count an interval if it either overlaps the range
1826 or is empty at the start of the range. */
1827 if ((beg
< endpos
&& startpos
< end
)
1828 || (startpos
== endpos
&& beg
== endpos
))
1834 *len_ptr
= len
*= 2;
1835 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1839 inhibit_storing
= 1;
1842 if (!inhibit_storing
)
1846 else if (endpos
< beg
&& endpos
> prev
)
1857 /* Fast function to just test if we're at an overlay boundary. */
1859 overlay_touches_p (pos
)
1862 Lisp_Object tail
, overlay
;
1864 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
1865 tail
= XCONS (tail
)->cdr
)
1869 overlay
= XCONS (tail
)->car
;
1870 if (!GC_OVERLAYP (overlay
))
1873 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1876 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
1880 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
1881 tail
= XCONS (tail
)->cdr
)
1885 overlay
= XCONS (tail
)->car
;
1886 if (!GC_OVERLAYP (overlay
))
1889 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1892 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
1900 Lisp_Object overlay
;
1906 compare_overlays (s1
, s2
)
1907 struct sortvec
*s1
, *s2
;
1909 if (s1
->priority
!= s2
->priority
)
1910 return s1
->priority
- s2
->priority
;
1911 if (s1
->beg
!= s2
->beg
)
1912 return s1
->beg
- s2
->beg
;
1913 if (s1
->end
!= s2
->end
)
1914 return s2
->end
- s1
->end
;
1918 /* Sort an array of overlays by priority. The array is modified in place.
1919 The return value is the new size; this may be smaller than the original
1920 size if some of the overlays were invalid or were window-specific. */
1922 sort_overlays (overlay_vec
, noverlays
, w
)
1923 Lisp_Object
*overlay_vec
;
1928 struct sortvec
*sortvec
;
1929 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1931 /* Put the valid and relevant overlays into sortvec. */
1933 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1936 Lisp_Object overlay
;
1938 overlay
= overlay_vec
[i
];
1939 if (OVERLAY_VALID (overlay
)
1940 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1941 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1943 /* If we're interested in a specific window, then ignore
1944 overlays that are limited to some other window. */
1949 window
= Foverlay_get (overlay
, Qwindow
);
1950 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1954 /* This overlay is good and counts: put it into sortvec. */
1955 sortvec
[j
].overlay
= overlay
;
1956 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1957 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1958 tem
= Foverlay_get (overlay
, Qpriority
);
1960 sortvec
[j
].priority
= XINT (tem
);
1962 sortvec
[j
].priority
= 0;
1968 /* Sort the overlays into the proper order: increasing priority. */
1971 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1973 for (i
= 0; i
< noverlays
; i
++)
1974 overlay_vec
[i
] = sortvec
[i
].overlay
;
1980 Lisp_Object string
, string2
;
1987 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
1988 int size
; /* Allocated length of that array. */
1989 int used
; /* How much of the array is currently in use. */
1990 int bytes
; /* Total length of the strings in buf. */
1993 /* Buffers for storing information about the overlays touching a given
1994 position. These could be automatic variables in overlay_strings, but
1995 it's more efficient to hold onto the memory instead of repeatedly
1996 allocating and freeing it. */
1997 static struct sortstrlist overlay_heads
, overlay_tails
;
1998 static char *overlay_str_buf
;
2000 /* Allocated length of overlay_str_buf. */
2001 static int overlay_str_len
;
2003 /* A comparison function suitable for passing to qsort. */
2005 cmp_for_strings (as1
, as2
)
2008 struct sortstr
*s1
= (struct sortstr
*)as1
;
2009 struct sortstr
*s2
= (struct sortstr
*)as2
;
2010 if (s1
->size
!= s2
->size
)
2011 return s2
->size
- s1
->size
;
2012 if (s1
->priority
!= s2
->priority
)
2013 return s1
->priority
- s2
->priority
;
2018 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2019 struct sortstrlist
*ssl
;
2020 Lisp_Object str
, str2
, pri
;
2023 if (ssl
->used
== ssl
->size
)
2029 ssl
->buf
= ((struct sortstr
*)
2030 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2032 ssl
->buf
[ssl
->used
].string
= str
;
2033 ssl
->buf
[ssl
->used
].string2
= str2
;
2034 ssl
->buf
[ssl
->used
].size
= size
;
2035 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2037 ssl
->bytes
+= XSTRING (str
)->size
;
2039 ssl
->bytes
+= XSTRING (str2
)->size
;
2042 /* Return the concatenation of the strings associated with overlays that
2043 begin or end at POS, ignoring overlays that are specific to a window
2044 other than W. The strings are concatenated in the appropriate order:
2045 shorter overlays nest inside longer ones, and higher priority inside
2046 lower. Normally all of the after-strings come first, but zero-sized
2047 overlays have their after-strings ride along with the before-strings
2048 because it would look strange to print them inside-out.
2050 Returns the string length, and stores the contents indirectly through
2051 PSTR, if that variable is non-null. The string may be overwritten by
2052 subsequent calls. */
2054 overlay_strings (pos
, w
, pstr
)
2059 Lisp_Object ov
, overlay
, window
, str
;
2060 int startpos
, endpos
;
2062 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2063 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2064 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2066 overlay
= XCONS (ov
)->car
;
2067 if (!OVERLAYP (overlay
))
2070 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2071 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2074 if (endpos
!= pos
&& startpos
!= pos
)
2076 window
= Foverlay_get (overlay
, Qwindow
);
2077 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2080 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2081 record_overlay_string (&overlay_heads
, str
,
2083 ? Foverlay_get (overlay
, Qafter_string
)
2085 Foverlay_get (overlay
, Qpriority
),
2087 else if (endpos
== pos
2088 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2089 record_overlay_string (&overlay_tails
, str
, Qnil
,
2090 Foverlay_get (overlay
, Qpriority
),
2093 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2095 overlay
= XCONS (ov
)->car
;
2096 if (!OVERLAYP (overlay
))
2099 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2100 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2103 if (endpos
!= pos
&& startpos
!= pos
)
2105 window
= Foverlay_get (overlay
, Qwindow
);
2106 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2109 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2110 record_overlay_string (&overlay_heads
, str
,
2112 ? Foverlay_get (overlay
, Qafter_string
)
2114 Foverlay_get (overlay
, Qpriority
),
2116 else if (endpos
== pos
2117 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2118 record_overlay_string (&overlay_tails
, str
, Qnil
,
2119 Foverlay_get (overlay
, Qpriority
),
2122 if (overlay_tails
.used
> 1)
2123 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2125 if (overlay_heads
.used
> 1)
2126 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2128 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2133 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2135 if (total
> overlay_str_len
)
2136 overlay_str_buf
= (char *)xrealloc (overlay_str_buf
,
2137 overlay_str_len
= total
);
2138 p
= overlay_str_buf
;
2139 for (i
= overlay_tails
.used
; --i
>= 0;)
2141 tem
= overlay_tails
.buf
[i
].string
;
2142 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2143 p
+= XSTRING (tem
)->size
;
2145 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2147 tem
= overlay_heads
.buf
[i
].string
;
2148 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2149 p
+= XSTRING (tem
)->size
;
2150 tem
= overlay_heads
.buf
[i
].string2
;
2153 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2154 p
+= XSTRING (tem
)->size
;
2157 if (p
!= overlay_str_buf
+ total
)
2160 *pstr
= overlay_str_buf
;
2166 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2169 recenter_overlay_lists (buf
, pos
)
2173 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2175 /* See if anything in overlays_before should move to overlays_after. */
2177 /* We don't strictly need prev in this loop; it should always be nil.
2178 But we use it for symmetry and in case that should cease to be true
2179 with some future change. */
2181 for (tail
= buf
->overlays_before
;
2183 prev
= tail
, tail
= next
)
2185 next
= XCONS (tail
)->cdr
;
2186 overlay
= XCONS (tail
)->car
;
2188 /* If the overlay is not valid, get rid of it. */
2189 if (!OVERLAY_VALID (overlay
))
2194 /* Splice the cons cell TAIL out of overlays_before. */
2196 XCONS (prev
)->cdr
= next
;
2198 buf
->overlays_before
= next
;
2204 beg
= OVERLAY_START (overlay
);
2205 end
= OVERLAY_END (overlay
);
2207 if (OVERLAY_POSITION (end
) > pos
)
2209 /* OVERLAY needs to be moved. */
2210 int where
= OVERLAY_POSITION (beg
);
2211 Lisp_Object other
, other_prev
;
2213 /* Splice the cons cell TAIL out of overlays_before. */
2215 XCONS (prev
)->cdr
= next
;
2217 buf
->overlays_before
= next
;
2219 /* Search thru overlays_after for where to put it. */
2221 for (other
= buf
->overlays_after
;
2223 other_prev
= other
, other
= XCONS (other
)->cdr
)
2225 Lisp_Object otherbeg
, otheroverlay
, follower
;
2228 otheroverlay
= XCONS (other
)->car
;
2229 if (! OVERLAY_VALID (otheroverlay
))
2232 otherbeg
= OVERLAY_START (otheroverlay
);
2233 if (OVERLAY_POSITION (otherbeg
) >= where
)
2237 /* Add TAIL to overlays_after before OTHER. */
2238 XCONS (tail
)->cdr
= other
;
2239 if (!NILP (other_prev
))
2240 XCONS (other_prev
)->cdr
= tail
;
2242 buf
->overlays_after
= tail
;
2246 /* We've reached the things that should stay in overlays_before.
2247 All the rest of overlays_before must end even earlier,
2252 /* See if anything in overlays_after should be in overlays_before. */
2254 for (tail
= buf
->overlays_after
;
2256 prev
= tail
, tail
= next
)
2258 next
= XCONS (tail
)->cdr
;
2259 overlay
= XCONS (tail
)->car
;
2261 /* If the overlay is not valid, get rid of it. */
2262 if (!OVERLAY_VALID (overlay
))
2267 /* Splice the cons cell TAIL out of overlays_after. */
2269 XCONS (prev
)->cdr
= next
;
2271 buf
->overlays_after
= next
;
2277 beg
= OVERLAY_START (overlay
);
2278 end
= OVERLAY_END (overlay
);
2280 /* Stop looking, when we know that nothing further
2281 can possibly end before POS. */
2282 if (OVERLAY_POSITION (beg
) > pos
)
2285 if (OVERLAY_POSITION (end
) <= pos
)
2287 /* OVERLAY needs to be moved. */
2288 int where
= OVERLAY_POSITION (end
);
2289 Lisp_Object other
, other_prev
;
2291 /* Splice the cons cell TAIL out of overlays_after. */
2293 XCONS (prev
)->cdr
= next
;
2295 buf
->overlays_after
= next
;
2297 /* Search thru overlays_before for where to put it. */
2299 for (other
= buf
->overlays_before
;
2301 other_prev
= other
, other
= XCONS (other
)->cdr
)
2303 Lisp_Object otherend
, otheroverlay
;
2306 otheroverlay
= XCONS (other
)->car
;
2307 if (! OVERLAY_VALID (otheroverlay
))
2310 otherend
= OVERLAY_END (otheroverlay
);
2311 if (OVERLAY_POSITION (otherend
) <= where
)
2315 /* Add TAIL to overlays_before before OTHER. */
2316 XCONS (tail
)->cdr
= other
;
2317 if (!NILP (other_prev
))
2318 XCONS (other_prev
)->cdr
= tail
;
2320 buf
->overlays_before
= tail
;
2325 XSETFASTINT (buf
->overlay_center
, pos
);
2329 adjust_overlays_for_insert (pos
, length
)
2333 /* After an insertion, the lists are still sorted properly,
2334 but we may need to update the value of the overlay center. */
2335 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2336 XSETFASTINT (current_buffer
->overlay_center
,
2337 XFASTINT (current_buffer
->overlay_center
) + length
);
2341 adjust_overlays_for_delete (pos
, length
)
2345 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2346 /* The deletion was to our right. No change needed; the before- and
2347 after-lists are still consistent. */
2349 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2350 /* The deletion was to our left. We need to adjust the center value
2351 to account for the change in position, but the lists are consistent
2352 given the new value. */
2353 XSETFASTINT (current_buffer
->overlay_center
,
2354 XFASTINT (current_buffer
->overlay_center
) - length
);
2356 /* We're right in the middle. There might be things on the after-list
2357 that now belong on the before-list. Recentering will move them,
2358 and also update the center point. */
2359 recenter_overlay_lists (current_buffer
, pos
);
2362 /* Fix up overlays that were garbled as a result of permuting markers
2363 in the range START through END. Any overlay with at least one
2364 endpoint in this range will need to be unlinked from the overlay
2365 list and reinserted in its proper place.
2366 Such an overlay might even have negative size at this point.
2367 If so, we'll reverse the endpoints. Can you think of anything
2368 better to do in this situation? */
2370 fix_overlays_in_range (start
, end
)
2371 register int start
, end
;
2373 Lisp_Object tem
, overlay
;
2374 Lisp_Object before_list
, after_list
;
2375 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2376 int startpos
, endpos
;
2378 /* This algorithm shifts links around instead of consing and GCing.
2379 The loop invariant is that before_list (resp. after_list) is a
2380 well-formed list except that its last element, the one that
2381 *pbefore (resp. *pafter) points to, is still uninitialized.
2382 So it's not a bug that before_list isn't initialized, although
2383 it may look strange. */
2384 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2386 overlay
= XCONS (*ptail
)->car
;
2387 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2390 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2392 || (startpos
>= start
&& startpos
< end
))
2394 /* If the overlay is backwards, fix that now. */
2395 if (startpos
> endpos
)
2398 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2399 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2400 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2402 /* Add it to the end of the wrong list. Later on,
2403 recenter_overlay_lists will move it to the right place. */
2404 if (endpos
< XINT (current_buffer
->overlay_center
))
2407 pafter
= &XCONS (*ptail
)->cdr
;
2412 pbefore
= &XCONS (*ptail
)->cdr
;
2414 *ptail
= XCONS (*ptail
)->cdr
;
2417 ptail
= &XCONS (*ptail
)->cdr
;
2419 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2421 overlay
= XCONS (*ptail
)->car
;
2422 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2423 if (startpos
>= end
)
2425 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2426 if (startpos
>= start
2427 || (endpos
>= start
&& endpos
< end
))
2429 if (startpos
> endpos
)
2432 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2433 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2434 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2436 if (endpos
< XINT (current_buffer
->overlay_center
))
2439 pafter
= &XCONS (*ptail
)->cdr
;
2444 pbefore
= &XCONS (*ptail
)->cdr
;
2446 *ptail
= XCONS (*ptail
)->cdr
;
2449 ptail
= &XCONS (*ptail
)->cdr
;
2452 /* Splice the constructed (wrong) lists into the buffer's lists,
2453 and let the recenter function make it sane again. */
2454 *pbefore
= current_buffer
->overlays_before
;
2455 current_buffer
->overlays_before
= before_list
;
2456 recenter_overlay_lists (current_buffer
,
2457 XINT (current_buffer
->overlay_center
));
2459 *pafter
= current_buffer
->overlays_after
;
2460 current_buffer
->overlays_after
= after_list
;
2461 recenter_overlay_lists (current_buffer
,
2462 XINT (current_buffer
->overlay_center
));
2465 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2466 "Return t if OBJECT is an overlay.")
2470 return (OVERLAYP (object
) ? Qt
: Qnil
);
2473 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
2474 "Create a new overlay with range BEG to END in BUFFER.\n\
2475 If omitted, BUFFER defaults to the current buffer.\n\
2476 BEG and END may be integers or markers.")
2478 Lisp_Object beg
, end
, buffer
;
2480 Lisp_Object overlay
;
2484 XSETBUFFER (buffer
, current_buffer
);
2486 CHECK_BUFFER (buffer
, 2);
2488 && ! EQ (Fmarker_buffer (beg
), buffer
))
2489 error ("Marker points into wrong buffer");
2491 && ! EQ (Fmarker_buffer (end
), buffer
))
2492 error ("Marker points into wrong buffer");
2494 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2495 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2497 if (XINT (beg
) > XINT (end
))
2500 temp
= beg
; beg
= end
; end
= temp
;
2503 b
= XBUFFER (buffer
);
2505 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2506 end
= Fset_marker (Fmake_marker (), end
, buffer
);
2508 XMARKER (end
)->insertion_type
= 1;
2510 overlay
= allocate_misc ();
2511 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
2512 XOVERLAY (overlay
)->start
= beg
;
2513 XOVERLAY (overlay
)->end
= end
;
2514 XOVERLAY (overlay
)->plist
= Qnil
;
2516 /* Put the new overlay on the wrong list. */
2517 end
= OVERLAY_END (overlay
);
2518 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2519 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2521 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2523 /* This puts it in the right list, and in the right order. */
2524 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2526 /* We don't need to redisplay the region covered by the overlay, because
2527 the overlay has no properties at the moment. */
2532 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
2533 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
2534 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
2535 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
2537 (overlay
, beg
, end
, buffer
)
2538 Lisp_Object overlay
, beg
, end
, buffer
;
2540 struct buffer
*b
, *ob
;
2541 Lisp_Object obuffer
;
2542 int count
= specpdl_ptr
- specpdl
;
2544 CHECK_OVERLAY (overlay
, 0);
2546 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2548 XSETBUFFER (buffer
, current_buffer
);
2549 CHECK_BUFFER (buffer
, 3);
2552 && ! EQ (Fmarker_buffer (beg
), buffer
))
2553 error ("Marker points into wrong buffer");
2555 && ! EQ (Fmarker_buffer (end
), buffer
))
2556 error ("Marker points into wrong buffer");
2558 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2559 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2561 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
2562 return Fdelete_overlay (overlay
);
2564 if (XINT (beg
) > XINT (end
))
2567 temp
= beg
; beg
= end
; end
= temp
;
2570 specbind (Qinhibit_quit
, Qt
);
2572 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2573 b
= XBUFFER (buffer
);
2574 ob
= XBUFFER (obuffer
);
2576 /* If the overlay has changed buffers, do a thorough redisplay. */
2577 if (!EQ (buffer
, obuffer
))
2579 /* Redisplay where the overlay was. */
2580 if (!NILP (obuffer
))
2585 o_beg
= OVERLAY_START (overlay
);
2586 o_end
= OVERLAY_END (overlay
);
2587 o_beg
= OVERLAY_POSITION (o_beg
);
2588 o_end
= OVERLAY_POSITION (o_end
);
2590 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
2593 /* Redisplay where the overlay is going to be. */
2594 redisplay_region (b
, XINT (beg
), XINT (end
));
2597 /* Redisplay the area the overlay has just left, or just enclosed. */
2601 int change_beg
, change_end
;
2603 o_beg
= OVERLAY_START (overlay
);
2604 o_end
= OVERLAY_END (overlay
);
2605 o_beg
= OVERLAY_POSITION (o_beg
);
2606 o_end
= OVERLAY_POSITION (o_end
);
2608 if (XINT (o_beg
) == XINT (beg
))
2609 redisplay_region (b
, XINT (o_end
), XINT (end
));
2610 else if (XINT (o_end
) == XINT (end
))
2611 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
2614 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
2615 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
2616 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
2620 if (!NILP (obuffer
))
2622 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
2623 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
2626 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
2627 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
2629 /* Put the overlay on the wrong list. */
2630 end
= OVERLAY_END (overlay
);
2631 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2632 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2634 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2636 /* This puts it in the right list, and in the right order. */
2637 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2639 return unbind_to (count
, overlay
);
2642 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
2643 "Delete the overlay OVERLAY from its buffer.")
2645 Lisp_Object overlay
;
2649 int count
= specpdl_ptr
- specpdl
;
2651 CHECK_OVERLAY (overlay
, 0);
2653 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2657 b
= XBUFFER (buffer
);
2659 specbind (Qinhibit_quit
, Qt
);
2661 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
2662 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2664 redisplay_region (b
,
2665 marker_position (OVERLAY_START (overlay
)),
2666 marker_position (OVERLAY_END (overlay
)));
2668 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2669 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2671 return unbind_to (count
, Qnil
);
2674 /* Overlay dissection functions. */
2676 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2677 "Return the position at which OVERLAY starts.")
2679 Lisp_Object overlay
;
2681 CHECK_OVERLAY (overlay
, 0);
2683 return (Fmarker_position (OVERLAY_START (overlay
)));
2686 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2687 "Return the position at which OVERLAY ends.")
2689 Lisp_Object overlay
;
2691 CHECK_OVERLAY (overlay
, 0);
2693 return (Fmarker_position (OVERLAY_END (overlay
)));
2696 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2697 "Return the buffer OVERLAY belongs to.")
2699 Lisp_Object overlay
;
2701 CHECK_OVERLAY (overlay
, 0);
2703 return Fmarker_buffer (OVERLAY_START (overlay
));
2706 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2707 "Return a list of the properties on OVERLAY.\n\
2708 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2711 Lisp_Object overlay
;
2713 CHECK_OVERLAY (overlay
, 0);
2715 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
2719 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2720 "Return a list of the overlays that contain position POS.")
2725 Lisp_Object
*overlay_vec
;
2729 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2732 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2734 /* Put all the overlays we want in a vector in overlay_vec.
2735 Store the length in len. */
2736 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2737 (int *) 0, (int *) 0);
2739 /* Make a list of them all. */
2740 result
= Flist (noverlays
, overlay_vec
);
2742 xfree (overlay_vec
);
2746 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
2747 "Return a list of the overlays that overlap the region BEG ... END.\n\
2748 Overlap means that at least one character is contained within the overlay\n\
2749 and also contained within the specified region.\n\
2750 Empty overlays are included in the result if they are located at BEG\n\
2751 or between BEG and END.")
2753 Lisp_Object beg
, end
;
2756 Lisp_Object
*overlay_vec
;
2760 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
2761 CHECK_NUMBER_COERCE_MARKER (end
, 0);
2764 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2766 /* Put all the overlays we want in a vector in overlay_vec.
2767 Store the length in len. */
2768 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
2769 (int *) 0, (int *) 0);
2771 /* Make a list of them all. */
2772 result
= Flist (noverlays
, overlay_vec
);
2774 xfree (overlay_vec
);
2778 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2780 "Return the next position after POS where an overlay starts or ends.\n\
2781 If there are no more overlay boundaries after POS, return (point-max).")
2787 Lisp_Object
*overlay_vec
;
2791 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2794 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2796 /* Put all the overlays we want in a vector in overlay_vec.
2797 Store the length in len.
2798 endpos gets the position where the next overlay starts. */
2799 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2800 &endpos
, (int *) 0);
2802 /* If any of these overlays ends before endpos,
2803 use its ending point instead. */
2804 for (i
= 0; i
< noverlays
; i
++)
2809 oend
= OVERLAY_END (overlay_vec
[i
]);
2810 oendpos
= OVERLAY_POSITION (oend
);
2811 if (oendpos
< endpos
)
2815 xfree (overlay_vec
);
2816 return make_number (endpos
);
2819 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2820 Sprevious_overlay_change
, 1, 1, 0,
2821 "Return the previous position before POS where an overlay starts or ends.\n\
2822 If there are no more overlay boundaries before POS, return (point-min).")
2828 Lisp_Object
*overlay_vec
;
2833 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2836 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2838 /* At beginning of buffer, we know the answer;
2839 avoid bug subtracting 1 below. */
2840 if (XINT (pos
) == BEGV
)
2843 /* Put all the overlays we want in a vector in overlay_vec.
2844 Store the length in len.
2845 prevpos gets the position of an overlay end. */
2846 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2847 (int *) 0, &prevpos
);
2849 /* If any of these overlays starts after prevpos,
2850 maybe use its starting point instead. */
2851 for (i
= 0; i
< noverlays
; i
++)
2856 ostart
= OVERLAY_START (overlay_vec
[i
]);
2857 ostartpos
= OVERLAY_POSITION (ostart
);
2858 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2859 prevpos
= ostartpos
;
2862 /* If any overlay ends at pos, consider its starting point too. */
2863 for (tail
= current_buffer
->overlays_before
;
2865 tail
= XCONS (tail
)->cdr
)
2867 Lisp_Object overlay
, ostart
;
2870 overlay
= XCONS (tail
)->car
;
2872 ostart
= OVERLAY_START (overlay
);
2873 ostartpos
= OVERLAY_POSITION (ostart
);
2874 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2875 prevpos
= ostartpos
;
2878 xfree (overlay_vec
);
2879 return make_number (prevpos
);
2882 /* These functions are for debugging overlays. */
2884 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2885 "Return a pair of lists giving all the overlays of the current buffer.\n\
2886 The car has all the overlays before the overlay center;\n\
2887 the cdr has all the overlays after the overlay center.\n\
2888 Recentering overlays moves overlays between these lists.\n\
2889 The lists you get are copies, so that changing them has no effect.\n\
2890 However, the overlays you get are the real objects that the buffer uses.")
2893 Lisp_Object before
, after
;
2894 before
= current_buffer
->overlays_before
;
2896 before
= Fcopy_sequence (before
);
2897 after
= current_buffer
->overlays_after
;
2899 after
= Fcopy_sequence (after
);
2901 return Fcons (before
, after
);
2904 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2905 "Recenter the overlays of the current buffer around position POS.")
2909 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2911 recenter_overlay_lists (current_buffer
, XINT (pos
));
2915 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2916 "Get the property of overlay OVERLAY with property name NAME.")
2918 Lisp_Object overlay
, prop
;
2920 Lisp_Object plist
, fallback
;
2922 CHECK_OVERLAY (overlay
, 0);
2926 for (plist
= XOVERLAY (overlay
)->plist
;
2927 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2928 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2930 if (EQ (XCONS (plist
)->car
, prop
))
2931 return XCONS (XCONS (plist
)->cdr
)->car
;
2932 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2935 tem
= Fcar (Fcdr (plist
));
2937 fallback
= Fget (tem
, prop
);
2944 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2945 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2946 (overlay
, prop
, value
)
2947 Lisp_Object overlay
, prop
, value
;
2949 Lisp_Object tail
, buffer
;
2952 CHECK_OVERLAY (overlay
, 0);
2954 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2956 for (tail
= XOVERLAY (overlay
)->plist
;
2957 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2958 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2959 if (EQ (XCONS (tail
)->car
, prop
))
2961 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2962 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2965 /* It wasn't in the list, so add it to the front. */
2966 changed
= !NILP (value
);
2967 XOVERLAY (overlay
)->plist
2968 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
2970 if (! NILP (buffer
))
2973 redisplay_region (XBUFFER (buffer
),
2974 marker_position (OVERLAY_START (overlay
)),
2975 marker_position (OVERLAY_END (overlay
)));
2976 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2977 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2978 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2979 Fdelete_overlay (overlay
);
2984 /* Subroutine of report_overlay_modification. */
2986 /* Lisp vector holding overlay hook functions to call.
2987 Vector elements come in pairs.
2988 Each even-index element is a list of hook functions.
2989 The following odd-index element is the overlay they came from.
2991 Before the buffer change, we fill in this vector
2992 as we call overlay hook functions.
2993 After the buffer change, we get the functions to call from this vector.
2994 This way we always call the same functions before and after the change. */
2995 static Lisp_Object last_overlay_modification_hooks
;
2997 /* Number of elements actually used in last_overlay_modification_hooks. */
2998 static int last_overlay_modification_hooks_used
;
3000 /* Add one functionlist/overlay pair
3001 to the end of last_overlay_modification_hooks. */
3004 add_overlay_mod_hooklist (functionlist
, overlay
)
3005 Lisp_Object functionlist
, overlay
;
3007 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3009 if (last_overlay_modification_hooks_used
== oldsize
)
3012 old
= last_overlay_modification_hooks
;
3013 last_overlay_modification_hooks
3014 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3015 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3016 XVECTOR (old
)->contents
,
3017 sizeof (Lisp_Object
) * oldsize
);
3019 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3020 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3023 /* Run the modification-hooks of overlays that include
3024 any part of the text in START to END.
3025 If this change is an insertion, also
3026 run the insert-before-hooks of overlay starting at END,
3027 and the insert-after-hooks of overlay ending at START.
3029 This is called both before and after the modification.
3030 AFTER is nonzero when we call after the modification.
3032 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3033 When AFTER is nonzero, they are the start position,
3034 the position after the inserted new text,
3035 and the length of deleted or replaced old text. */
3038 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3039 Lisp_Object start
, end
;
3041 Lisp_Object arg1
, arg2
, arg3
;
3043 Lisp_Object prop
, overlay
, tail
;
3044 /* 1 if this change is an insertion. */
3045 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3047 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3051 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3055 /* Call the functions recorded in last_overlay_modification_hooks
3056 rather than scanning the overlays again.
3057 First copy the vector contents, in case some of these hooks
3058 do subsequent modification of the buffer. */
3059 int size
= last_overlay_modification_hooks_used
;
3060 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3063 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3064 copy
, size
* sizeof (Lisp_Object
));
3066 gcpro1
.nvars
= size
;
3068 for (i
= 0; i
< size
;)
3070 Lisp_Object prop
, overlay
;
3072 overlay
= copy
[i
++];
3073 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3079 /* We are being called before a change.
3080 Scan the overlays to find the functions to call. */
3081 last_overlay_modification_hooks_used
= 0;
3083 for (tail
= current_buffer
->overlays_before
;
3085 tail
= XCONS (tail
)->cdr
)
3087 int startpos
, endpos
;
3088 Lisp_Object ostart
, oend
;
3090 overlay
= XCONS (tail
)->car
;
3092 ostart
= OVERLAY_START (overlay
);
3093 oend
= OVERLAY_END (overlay
);
3094 endpos
= OVERLAY_POSITION (oend
);
3095 if (XFASTINT (start
) > endpos
)
3097 startpos
= OVERLAY_POSITION (ostart
);
3098 if (insertion
&& (XFASTINT (start
) == startpos
3099 || XFASTINT (end
) == startpos
))
3101 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3104 /* Copy TAIL in case the hook recenters the overlay lists. */
3106 tail
= Fcopy_sequence (tail
);
3108 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3111 if (insertion
&& (XFASTINT (start
) == endpos
3112 || XFASTINT (end
) == endpos
))
3114 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3118 tail
= Fcopy_sequence (tail
);
3120 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3123 /* Test for intersecting intervals. This does the right thing
3124 for both insertion and deletion. */
3125 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3127 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3131 tail
= Fcopy_sequence (tail
);
3133 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3139 for (tail
= current_buffer
->overlays_after
;
3141 tail
= XCONS (tail
)->cdr
)
3143 int startpos
, endpos
;
3144 Lisp_Object ostart
, oend
;
3146 overlay
= XCONS (tail
)->car
;
3148 ostart
= OVERLAY_START (overlay
);
3149 oend
= OVERLAY_END (overlay
);
3150 startpos
= OVERLAY_POSITION (ostart
);
3151 endpos
= OVERLAY_POSITION (oend
);
3152 if (XFASTINT (end
) < startpos
)
3154 if (insertion
&& (XFASTINT (start
) == startpos
3155 || XFASTINT (end
) == startpos
))
3157 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3161 tail
= Fcopy_sequence (tail
);
3163 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3166 if (insertion
&& (XFASTINT (start
) == endpos
3167 || XFASTINT (end
) == endpos
))
3169 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3173 tail
= Fcopy_sequence (tail
);
3175 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3178 /* Test for intersecting intervals. This does the right thing
3179 for both insertion and deletion. */
3180 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3182 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3186 tail
= Fcopy_sequence (tail
);
3188 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3197 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3198 Lisp_Object list
, overlay
;
3200 Lisp_Object arg1
, arg2
, arg3
;
3202 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3204 GCPRO4 (list
, arg1
, arg2
, arg3
);
3206 add_overlay_mod_hooklist (list
, overlay
);
3208 while (!NILP (list
))
3211 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3213 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3219 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3222 evaporate_overlays (pos
)
3225 Lisp_Object tail
, overlay
, hit_list
;
3228 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3229 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3230 tail
= XCONS (tail
)->cdr
)
3233 overlay
= XCONS (tail
)->car
;
3234 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3237 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3238 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3239 hit_list
= Fcons (overlay
, hit_list
);
3242 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3243 tail
= XCONS (tail
)->cdr
)
3246 overlay
= XCONS (tail
)->car
;
3247 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3250 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3251 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3252 hit_list
= Fcons (overlay
, hit_list
);
3254 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3255 Fdelete_overlay (XCONS (hit_list
)->car
);
3258 /* Somebody has tried to store a value with an unacceptable type
3259 into the buffer-local slot with offset OFFSET. */
3261 buffer_slot_type_mismatch (offset
)
3266 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3267 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3269 case Lisp_Int
: type_name
= "integers"; break;
3270 case Lisp_String
: type_name
= "strings"; break;
3271 case Lisp_Symbol
: type_name
= "symbols"; break;
3276 error ("only %s should be stored in the buffer-local variable %s",
3277 type_name
, XSYMBOL (sym
)->name
->data
);
3282 register Lisp_Object tem
;
3284 /* Make sure all markable slots in buffer_defaults
3285 are initialized reasonably, so mark_buffer won't choke. */
3286 reset_buffer (&buffer_defaults
);
3287 reset_buffer_local_variables (&buffer_defaults
);
3288 reset_buffer (&buffer_local_symbols
);
3289 reset_buffer_local_variables (&buffer_local_symbols
);
3290 /* Prevent GC from getting confused. */
3291 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3292 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3293 #ifdef USE_TEXT_PROPERTIES
3294 BUF_INTERVALS (&buffer_defaults
) = 0;
3295 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3297 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3298 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3300 /* Set up the default values of various buffer slots. */
3301 /* Must do these before making the first buffer! */
3303 /* real setup is done in loaddefs.el */
3304 buffer_defaults
.mode_line_format
= build_string ("%-");
3305 buffer_defaults
.abbrev_mode
= Qnil
;
3306 buffer_defaults
.overwrite_mode
= Qnil
;
3307 buffer_defaults
.case_fold_search
= Qt
;
3308 buffer_defaults
.auto_fill_function
= Qnil
;
3309 buffer_defaults
.selective_display
= Qnil
;
3311 buffer_defaults
.selective_display_ellipses
= Qt
;
3313 buffer_defaults
.abbrev_table
= Qnil
;
3314 buffer_defaults
.display_table
= Qnil
;
3315 buffer_defaults
.undo_list
= Qnil
;
3316 buffer_defaults
.mark_active
= Qnil
;
3317 buffer_defaults
.file_format
= Qnil
;
3318 buffer_defaults
.overlays_before
= Qnil
;
3319 buffer_defaults
.overlays_after
= Qnil
;
3320 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3322 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3323 buffer_defaults
.truncate_lines
= Qnil
;
3324 buffer_defaults
.ctl_arrow
= Qt
;
3327 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3329 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3330 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3331 buffer_defaults
.cache_long_line_scans
= Qnil
;
3332 buffer_defaults
.file_truename
= Qnil
;
3334 /* Assign the local-flags to the slots that have default values.
3335 The local flag is a bit that is used in the buffer
3336 to say that it has its own local value for the slot.
3337 The local flag bits are in the local_var_flags slot of the buffer. */
3339 /* Nothing can work if this isn't true */
3340 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3342 /* 0 means not a lisp var, -1 means always local, else mask */
3343 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3344 XSETINT (buffer_local_flags
.filename
, -1);
3345 XSETINT (buffer_local_flags
.directory
, -1);
3346 XSETINT (buffer_local_flags
.backed_up
, -1);
3347 XSETINT (buffer_local_flags
.save_length
, -1);
3348 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3349 XSETINT (buffer_local_flags
.read_only
, -1);
3350 XSETINT (buffer_local_flags
.major_mode
, -1);
3351 XSETINT (buffer_local_flags
.mode_name
, -1);
3352 XSETINT (buffer_local_flags
.undo_list
, -1);
3353 XSETINT (buffer_local_flags
.mark_active
, -1);
3354 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3355 XSETINT (buffer_local_flags
.file_truename
, -1);
3356 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3357 XSETFASTINT (buffer_local_flags
.file_format
, -1);
3359 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3360 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3361 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3362 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3363 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3364 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3366 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3368 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3369 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3370 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3371 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3372 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3373 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3374 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3375 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3376 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3378 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3381 Vbuffer_alist
= Qnil
;
3385 QSFundamental
= build_string ("Fundamental");
3387 Qfundamental_mode
= intern ("fundamental-mode");
3388 buffer_defaults
.major_mode
= Qfundamental_mode
;
3390 Qmode_class
= intern ("mode-class");
3392 Qprotected_field
= intern ("protected-field");
3394 Qpermanent_local
= intern ("permanent-local");
3396 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3398 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3399 /* super-magic invisible buffer */
3400 Vbuffer_alist
= Qnil
;
3402 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3407 char buf
[MAXPATHLEN
+1];
3409 struct stat dotstat
, pwdstat
;
3413 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3415 /* If PWD is accurate, use it instead of calling getwd. This is faster
3416 when PWD is right, and may avoid a fatal error. */
3417 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
3418 && stat (pwd
, &pwdstat
) == 0
3419 && stat (".", &dotstat
) == 0
3420 && dotstat
.st_ino
== pwdstat
.st_ino
3421 && dotstat
.st_dev
== pwdstat
.st_dev
3422 && strlen (pwd
) < MAXPATHLEN
)
3424 else if (getwd (buf
) == 0)
3425 fatal ("`getwd' failed: %s\n", buf
);
3428 /* Maybe this should really use some standard subroutine
3429 whose definition is filename syntax dependent. */
3431 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
3433 buf
[rc
] = DIRECTORY_SEP
;
3436 #endif /* not VMS */
3437 current_buffer
->directory
= build_string (buf
);
3439 temp
= get_minibuffer (0);
3440 XBUFFER (temp
)->directory
= current_buffer
->directory
;
3443 /* initialize the buffer routines */
3446 extern Lisp_Object Qdisabled
;
3448 staticpro (&last_overlay_modification_hooks
);
3449 last_overlay_modification_hooks
3450 = Fmake_vector (make_number (10), Qnil
);
3452 staticpro (&Vbuffer_defaults
);
3453 staticpro (&Vbuffer_local_symbols
);
3454 staticpro (&Qfundamental_mode
);
3455 staticpro (&Qmode_class
);
3456 staticpro (&QSFundamental
);
3457 staticpro (&Vbuffer_alist
);
3458 staticpro (&Qprotected_field
);
3459 staticpro (&Qpermanent_local
);
3460 staticpro (&Qkill_buffer_hook
);
3461 Qoverlayp
= intern ("overlayp");
3462 staticpro (&Qoverlayp
);
3463 Qevaporate
= intern ("evaporate");
3464 staticpro (&Qevaporate
);
3465 Qmodification_hooks
= intern ("modification-hooks");
3466 staticpro (&Qmodification_hooks
);
3467 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
3468 staticpro (&Qinsert_in_front_hooks
);
3469 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
3470 staticpro (&Qinsert_behind_hooks
);
3471 Qget_file_buffer
= intern ("get-file-buffer");
3472 staticpro (&Qget_file_buffer
);
3473 Qpriority
= intern ("priority");
3474 staticpro (&Qpriority
);
3475 Qwindow
= intern ("window");
3476 staticpro (&Qwindow
);
3477 Qbefore_string
= intern ("before-string");
3478 staticpro (&Qbefore_string
);
3479 Qafter_string
= intern ("after-string");
3480 staticpro (&Qafter_string
);
3481 Qfirst_change_hook
= intern ("first-change-hook");
3482 staticpro (&Qfirst_change_hook
);
3483 Qbefore_change_functions
= intern ("before-change-functions");
3484 staticpro (&Qbefore_change_functions
);
3485 Qafter_change_functions
= intern ("after-change-functions");
3486 staticpro (&Qafter_change_functions
);
3488 Fput (Qprotected_field
, Qerror_conditions
,
3489 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
3490 Fput (Qprotected_field
, Qerror_message
,
3491 build_string ("Attempt to modify a protected field"));
3493 /* All these use DEFVAR_LISP_NOPRO because the slots in
3494 buffer_defaults will all be marked via Vbuffer_defaults. */
3496 DEFVAR_LISP_NOPRO ("default-mode-line-format",
3497 &buffer_defaults
.mode_line_format
,
3498 "Default value of `mode-line-format' for buffers that don't override it.\n\
3499 This is the same as (default-value 'mode-line-format).");
3501 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
3502 &buffer_defaults
.abbrev_mode
,
3503 "Default value of `abbrev-mode' for buffers that do not override it.\n\
3504 This is the same as (default-value 'abbrev-mode).");
3506 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
3507 &buffer_defaults
.ctl_arrow
,
3508 "Default value of `ctl-arrow' for buffers that do not override it.\n\
3509 This is the same as (default-value 'ctl-arrow).");
3511 DEFVAR_LISP_NOPRO ("default-truncate-lines",
3512 &buffer_defaults
.truncate_lines
,
3513 "Default value of `truncate-lines' for buffers that do not override it.\n\
3514 This is the same as (default-value 'truncate-lines).");
3516 DEFVAR_LISP_NOPRO ("default-fill-column",
3517 &buffer_defaults
.fill_column
,
3518 "Default value of `fill-column' for buffers that do not override it.\n\
3519 This is the same as (default-value 'fill-column).");
3521 DEFVAR_LISP_NOPRO ("default-left-margin",
3522 &buffer_defaults
.left_margin
,
3523 "Default value of `left-margin' for buffers that do not override it.\n\
3524 This is the same as (default-value 'left-margin).");
3526 DEFVAR_LISP_NOPRO ("default-tab-width",
3527 &buffer_defaults
.tab_width
,
3528 "Default value of `tab-width' for buffers that do not override it.\n\
3529 This is the same as (default-value 'tab-width).");
3531 DEFVAR_LISP_NOPRO ("default-case-fold-search",
3532 &buffer_defaults
.case_fold_search
,
3533 "Default value of `case-fold-search' for buffers that don't override it.\n\
3534 This is the same as (default-value 'case-fold-search).");
3537 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
3538 &buffer_defaults
.buffer_file_type
,
3539 "Default file type for buffers that do not override it.\n\
3540 This is the same as (default-value 'buffer-file-type).\n\
3541 The file type is nil for text, t for binary.");
3544 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
3547 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
3548 But make-docfile finds it!
3549 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
3551 "Template for displaying mode line for current buffer.\n\
3552 Each buffer has its own value of this variable.\n\
3553 Value may be a string, a symbol or a list or cons cell.\n\
3554 For a symbol, its value is used (but it is ignored if t or nil).\n\
3555 A string appearing directly as the value of a symbol is processed verbatim\n\
3556 in that the %-constructs below are not recognized.\n\
3557 For a list whose car is a symbol, the symbol's value is taken,\n\
3558 and if that is non-nil, the cadr of the list is processed recursively.\n\
3559 Otherwise, the caddr of the list (if there is one) is processed.\n\
3560 For a list whose car is a string or list, each element is processed\n\
3561 recursively and the results are effectively concatenated.\n\
3562 For a list whose car is an integer, the cdr of the list is processed\n\
3563 and padded (if the number is positive) or truncated (if negative)\n\
3564 to the width specified by that number.\n\
3565 A string is printed verbatim in the mode line except for %-constructs:\n\
3566 (%-constructs are allowed when the string is the entire mode-line-format\n\
3567 or when it is found in a cons-cell or a list)\n\
3568 %b -- print buffer name. %f -- print visited file name.\n\
3569 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
3570 % means buffer is read-only and * means it is modified.\n\
3571 For a modified read-only buffer, %* gives % and %+ gives *.\n\
3572 %s -- print process status. %l -- print the current line number.\n\
3573 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
3574 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
3575 or print Bottom or All.\n\
3576 %n -- print Narrow if appropriate.\n\
3577 %t -- print T if files is text, B if binary.\n\
3578 %[ -- print one [ for each recursive editing level. %] similar.\n\
3579 %% -- print %. %- -- print infinitely many dashes.\n\
3580 Decimal digits after the % specify field width to which to pad.");
3583 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
3584 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
3585 nil here means use current buffer's major mode.");
3587 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
3588 make_number (Lisp_Symbol
),
3589 "Symbol for current buffer's major mode.");
3591 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
3592 make_number (Lisp_String
),
3593 "Pretty name of current buffer's major mode (a string).");
3595 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
3596 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
3597 Automatically becomes buffer-local when set in any fashion.");
3599 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
3601 "*Non-nil if searches should ignore case.\n\
3602 Automatically becomes buffer-local when set in any fashion.");
3604 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
3605 make_number (Lisp_Int
),
3606 "*Column beyond which automatic line-wrapping should happen.\n\
3607 Automatically becomes buffer-local when set in any fashion.");
3609 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
3610 make_number (Lisp_Int
),
3611 "*Column for the default indent-line-function to indent to.\n\
3612 Linefeed indents to this column in Fundamental mode.\n\
3613 Automatically becomes buffer-local when set in any fashion.");
3615 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
3616 make_number (Lisp_Int
),
3617 "*Distance between tab stops (for display of tab characters), in columns.\n\
3618 Automatically becomes buffer-local when set in any fashion.");
3620 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
3621 "*Non-nil means display control chars with uparrow.\n\
3622 Nil means use backslash and octal digits.\n\
3623 Automatically becomes buffer-local when set in any fashion.\n\
3624 This variable does not apply to characters whose display is specified\n\
3625 in the current display table (if there is one).");
3627 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
3628 "*Non-nil means do not display continuation lines;\n\
3629 give each line of text one screen line.\n\
3630 Automatically becomes buffer-local when set in any fashion.\n\
3632 Note that this is overridden by the variable\n\
3633 `truncate-partial-width-windows' if that variable is non-nil\n\
3634 and this buffer is not full-frame width.");
3637 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
3639 "Non-nil if the visited file is a binary file.\n\
3640 This variable is meaningful on MS-DOG and Windows NT.\n\
3641 On those systems, it is automatically local in every buffer.\n\
3642 On other systems, this variable is normally always nil.");
3645 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
3646 make_number (Lisp_String
),
3647 "Name of default directory of current buffer. Should end with slash.\n\
3648 Each buffer has its own value of this variable.");
3650 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
3652 "Function called (if non-nil) to perform auto-fill.\n\
3653 It is called after self-inserting a space at a column beyond `fill-column'.\n\
3654 Each buffer has its own value of this variable.\n\
3655 NOTE: This variable is not an ordinary hook;\n\
3656 It may not be a list of functions.");
3658 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
3659 make_number (Lisp_String
),
3660 "Name of file visited in current buffer, or nil if not visiting a file.\n\
3661 Each buffer has its own value of this variable.");
3663 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
3664 make_number (Lisp_String
),
3665 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
3666 The truename of a file is calculated by `file-truename'\n\
3667 and then abbreviated with `abbreviate-file-name'.\n\
3668 Each buffer has its own value of this variable.");
3670 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
3671 ¤t_buffer
->auto_save_file_name
,
3672 make_number (Lisp_String
),
3673 "Name of file for auto-saving current buffer,\n\
3674 or nil if buffer should not be auto-saved.\n\
3675 Each buffer has its own value of this variable.");
3677 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
3678 "Non-nil if this buffer is read-only.\n\
3679 Each buffer has its own value of this variable.");
3681 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
3682 "Non-nil if this buffer's file has been backed up.\n\
3683 Backing up is done before the first time the file is saved.\n\
3684 Each buffer has its own value of this variable.");
3686 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
3687 make_number (Lisp_Int
),
3688 "Length of current buffer when last read in, saved or auto-saved.\n\
3690 Each buffer has its own value of this variable.");
3692 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
3694 "Non-nil enables selective display:\n\
3695 Integer N as value means display only lines\n\
3696 that start with less than n columns of space.\n\
3697 A value of t means, after a ^M, all the rest of the line is invisible.\n\
3698 Then ^M's in the file are written into files as newlines.\n\n\
3699 Automatically becomes buffer-local when set in any fashion.");
3702 DEFVAR_PER_BUFFER ("selective-display-ellipses",
3703 ¤t_buffer
->selective_display_ellipses
,
3705 "t means display ... on previous line when a line is invisible.\n\
3706 Automatically becomes buffer-local when set in any fashion.");
3709 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
3710 "Non-nil if self-insertion should replace existing text.\n\
3711 The value should be one of `overwrite-mode-textual',\n\
3712 `overwrite-mode-binary', or nil.\n\
3713 If it is `overwrite-mode-textual', self-insertion still\n\
3714 inserts at the end of a line, and inserts when point is before a tab,\n\
3715 until the tab is filled in.\n\
3716 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
3717 Automatically becomes buffer-local when set in any fashion.");
3719 #if 0 /* The doc string is too long for some compilers,
3720 but make-docfile can find it in this comment. */
3721 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3723 "Display table that controls display of the contents of current buffer.\n\
3724 Automatically becomes buffer-local when set in any fashion.\n\
3725 The display table is a char-table created with `make-display-table'.\n\
3726 The ordinary char-table elements control how to display each possible text\n\
3727 character. Each value should be a vector of characters or nil;\n\
3728 nil means display the character in the default fashion.\n\
3729 There are six extra slots to control the display of\n\
3730 the end of a truncated screen line (extra-slot 0, a single character);\n\
3731 the end of a continued line (extra-slot 1, a single character);\n\
3732 the escape character used to display character codes in octal\n\
3733 (extra-slot 2, a single character);\n\
3734 the character used as an arrow for control characters (extra-slot 3,\n\
3735 a single character);\n\
3736 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
3737 a vector of characters);\n\
3738 the character used to draw the border between side-by-side windows\n\
3739 (extra-slot 5, a single character).\n\
3740 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
3741 If this variable is nil, the value of `standard-display-table' is used.\n\
3742 Each window can have its own, overriding display table.");
3744 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3747 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
3750 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
3751 "Function to call before each text change.\n\
3752 Two arguments are passed to the function: the positions of\n\
3753 the beginning and end of the range of old text to be changed.\n\
3754 \(For an insertion, the beginning and end are at the same place.)\n\
3755 No information is given about the length of the text after the change.\n\
3757 Buffer changes made while executing the `before-change-function'\n\
3758 don't call any before-change or after-change functions.\n\
3759 That's because these variables are temporarily set to nil.\n\
3760 As a result, a hook function cannot straightforwardly alter the value of\n\
3761 these variables. See the Emacs Lisp manual for a way of\n\
3762 accomplishing an equivalent result by using other variables.");
3763 Vbefore_change_function
= Qnil
;
3765 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
3766 "Function to call after each text change.\n\
3767 Three arguments are passed to the function: the positions of\n\
3768 the beginning and end of the range of changed text,\n\
3769 and the length of the pre-change text replaced by that range.\n\
3770 \(For an insertion, the pre-change length is zero;\n\
3771 for a deletion, that length is the number of characters deleted,\n\
3772 and the post-change beginning and end are at the same place.)\n\
3774 Buffer changes made while executing the `after-change-function'\n\
3775 don't call any before-change or after-change functions.\n\
3776 That's because these variables are temporarily set to nil.\n\
3777 As a result, a hook function cannot straightforwardly alter the value of\n\
3778 these variables. See the Emacs Lisp manual for a way of\n\
3779 accomplishing an equivalent result by using other variables.");
3780 Vafter_change_function
= Qnil
;
3782 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
3783 "List of functions to call before each text change.\n\
3784 Two arguments are passed to each function: the positions of\n\
3785 the beginning and end of the range of old text to be changed.\n\
3786 \(For an insertion, the beginning and end are at the same place.)\n\
3787 No information is given about the length of the text after the change.\n\
3789 Buffer changes made while executing the `before-change-functions'\n\
3790 don't call any before-change or after-change functions.\n\
3791 That's because these variables are temporarily set to nil.\n\
3792 As a result, a hook function cannot straightforwardly alter the value of\n\
3793 these variables. See the Emacs Lisp manual for a way of\n\
3794 accomplishing an equivalent result by using other variables.");
3795 Vbefore_change_functions
= Qnil
;
3797 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
3798 "List of function to call after each text change.\n\
3799 Three arguments are passed to each function: the positions of\n\
3800 the beginning and end of the range of changed text,\n\
3801 and the length of the pre-change text replaced by that range.\n\
3802 \(For an insertion, the pre-change length is zero;\n\
3803 for a deletion, that length is the number of characters deleted,\n\
3804 and the post-change beginning and end are at the same place.)\n\
3806 Buffer changes made while executing the `after-change-functions'\n\
3807 don't call any before-change or after-change functions.\n\
3808 That's because these variables are temporarily set to nil.\n\
3809 As a result, a hook function cannot straightforwardly alter the value of\n\
3810 these variables. See the Emacs Lisp manual for a way of\n\
3811 accomplishing an equivalent result by using other variables.");
3813 Vafter_change_functions
= Qnil
;
3815 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
3816 "A list of functions to call before changing a buffer which is unmodified.\n\
3817 The functions are run using the `run-hooks' function.");
3818 Vfirst_change_hook
= Qnil
;
3820 #if 0 /* The doc string is too long for some compilers,
3821 but make-docfile can find it in this comment. */
3822 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3823 "List of undo entries in current buffer.\n\
3824 Recent changes come first; older changes follow newer.\n\
3826 An entry (BEG . END) represents an insertion which begins at\n\
3827 position BEG and ends at position END.\n\
3829 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
3830 from (abs POSITION). If POSITION is positive, point was at the front\n\
3831 of the text being deleted; if negative, point was at the end.\n\
3833 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
3834 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
3835 of the visited file's modification time, as of that time. If the\n\
3836 modification time of the most recent save is different, this entry is\n\
3839 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
3840 was modified between BEG and END. PROPERTY is the property name,\n\
3841 and VALUE is the old value.\n\
3843 An entry of the form POSITION indicates that point was at the buffer\n\
3844 location given by the integer. Undoing an entry of this form places\n\
3845 point at POSITION.\n\
3847 nil marks undo boundaries. The undo command treats the changes\n\
3848 between two undo boundaries as a single step to be undone.\n\
3850 If the value of the variable is t, undo information is not recorded.");
3852 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3855 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3856 "Non-nil means the mark and region are currently active in this buffer.\n\
3857 Automatically local in all buffers.");
3859 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3860 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3861 This variable is buffer-local, in all buffers.\n\
3863 Normally, the line-motion functions work by scanning the buffer for\n\
3864 newlines. Columnar operations (like move-to-column and\n\
3865 compute-motion) also work by scanning the buffer, summing character\n\
3866 widths as they go. This works well for ordinary text, but if the\n\
3867 buffer's lines are very long (say, more than 500 characters), these\n\
3868 motion functions will take longer to execute. Emacs may also take\n\
3869 longer to update the display.\n\
3871 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3872 results of their scans, and consult the cache to avoid rescanning\n\
3873 regions of the buffer until the text is modified. The caches are most\n\
3874 beneficial when they prevent the most searching---that is, when the\n\
3875 buffer contains long lines and large regions of characters with the\n\
3876 same, fixed screen width.\n\
3878 When cache-long-line-scans is non-nil, processing short lines will\n\
3879 become slightly slower (because of the overhead of consulting the\n\
3880 cache), and the caches will use memory roughly proportional to the\n\
3881 number of newlines and characters whose screen width varies.\n\
3883 The caches require no explicit maintenance; their accuracy is\n\
3884 maintained internally by the Emacs primitives. Enabling or disabling\n\
3885 the cache should not affect the behavior of any of the motion\n\
3886 functions; it should only affect their performance.");
3888 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
3889 "Value of point before the last series of scroll operations, or nil.");
3891 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
3892 "List of formats to use when saving this buffer.\n\
3893 Formats are defined by `format-alist'. This variable is\n\
3894 set when a file is visited. Automatically local in all buffers.");
3896 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
3897 ¤t_buffer
->invisibility_spec
, Qnil
,
3898 "Invisibility spec of this buffer.\n\
3899 The default is t, which means that text is invisible\n\
3900 if it has a non-nil `invisible' property.\n\
3901 If the value is a list, a text character is invisible if its `invisible'\n\
3902 property is an element in that list.\n\
3903 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
3904 then characters with property value PROP are invisible,\n\
3905 and they have an ellipsis as well if ELLIPSIS is non-nil.");
3907 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3908 "*Non-nil means deactivate the mark when the buffer contents change.");
3909 Vtransient_mark_mode
= Qnil
;
3911 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3912 "*Non-nil means disregard read-only status of buffers or characters.\n\
3913 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3914 text properties. If the value is a list, disregard `buffer-read-only'\n\
3915 and disregard a `read-only' text property if the property value\n\
3916 is a member of the list.");
3917 Vinhibit_read_only
= Qnil
;
3919 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3920 "List of functions called with no args to query before killing a buffer.");
3921 Vkill_buffer_query_functions
= Qnil
;
3923 defsubr (&Sbuffer_list
);
3924 defsubr (&Sget_buffer
);
3925 defsubr (&Sget_file_buffer
);
3926 defsubr (&Sget_buffer_create
);
3927 defsubr (&Smake_indirect_buffer
);
3928 defsubr (&Sgenerate_new_buffer_name
);
3929 defsubr (&Sbuffer_name
);
3930 /*defsubr (&Sbuffer_number);*/
3931 defsubr (&Sbuffer_file_name
);
3932 defsubr (&Sbuffer_base_buffer
);
3933 defsubr (&Sbuffer_local_variables
);
3934 defsubr (&Sbuffer_modified_p
);
3935 defsubr (&Sset_buffer_modified_p
);
3936 defsubr (&Sbuffer_modified_tick
);
3937 defsubr (&Srename_buffer
);
3938 defsubr (&Sother_buffer
);
3939 defsubr (&Sbuffer_disable_undo
);
3940 defsubr (&Sbuffer_enable_undo
);
3941 defsubr (&Skill_buffer
);
3942 defsubr (&Serase_buffer
);
3943 defsubr (&Sset_buffer_major_mode
);
3944 defsubr (&Sswitch_to_buffer
);
3945 defsubr (&Spop_to_buffer
);
3946 defsubr (&Scurrent_buffer
);
3947 defsubr (&Sset_buffer
);
3948 defsubr (&Sbarf_if_buffer_read_only
);
3949 defsubr (&Sbury_buffer
);
3950 defsubr (&Skill_all_local_variables
);
3952 defsubr (&Soverlayp
);
3953 defsubr (&Smake_overlay
);
3954 defsubr (&Sdelete_overlay
);
3955 defsubr (&Smove_overlay
);
3956 defsubr (&Soverlay_start
);
3957 defsubr (&Soverlay_end
);
3958 defsubr (&Soverlay_buffer
);
3959 defsubr (&Soverlay_properties
);
3960 defsubr (&Soverlays_at
);
3961 defsubr (&Soverlays_in
);
3962 defsubr (&Snext_overlay_change
);
3963 defsubr (&Sprevious_overlay_change
);
3964 defsubr (&Soverlay_recenter
);
3965 defsubr (&Soverlay_lists
);
3966 defsubr (&Soverlay_get
);
3967 defsubr (&Soverlay_put
);
3972 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3973 initial_define_key (control_x_map
, 'k', "kill-buffer");
3975 /* This must not be in syms_of_buffer, because Qdisabled is not
3976 initialized when that function gets called. */
3977 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);