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
= Fpoint_marker ();
424 b
->begv_marker
= Fpoint_min_marker ();
425 b
->zv_marker
= Fpoint_max_marker ();
426 XMARKER (b
->zv_marker
)->insertion_type
= 1;
431 /* Reinitialize everything about a buffer except its name and contents
432 and local variables. */
436 register struct buffer
*b
;
439 b
->file_truename
= Qnil
;
440 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
442 XSETFASTINT (b
->save_length
, 0);
443 b
->last_window_start
= 1;
445 b
->auto_save_modified
= 0;
446 b
->auto_save_failure_time
= -1;
447 b
->auto_save_file_name
= Qnil
;
449 b
->overlays_before
= Qnil
;
450 b
->overlays_after
= Qnil
;
451 XSETFASTINT (b
->overlay_center
, 1);
452 b
->mark_active
= Qnil
;
453 b
->point_before_scroll
= Qnil
;
454 b
->file_format
= Qnil
;
457 /* Reset buffer B's local variables info.
458 Don't use this on a buffer that has already been in use;
459 it does not treat permanent locals consistently.
460 Instead, use Fkill_all_local_variables. */
462 reset_buffer_local_variables (b
)
463 register struct buffer
*b
;
467 /* Reset the major mode to Fundamental, together with all the
468 things that depend on the major mode.
469 default-major-mode is handled at a higher level.
470 We ignore it here. */
471 b
->major_mode
= Qfundamental_mode
;
473 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
474 b
->mode_name
= QSFundamental
;
475 b
->minor_modes
= Qnil
;
476 b
->downcase_table
= Vascii_downcase_table
;
477 b
->upcase_table
= Vascii_upcase_table
;
478 b
->case_canon_table
= Vascii_canon_table
;
479 b
->case_eqv_table
= Vascii_eqv_table
;
480 b
->buffer_file_type
= Qnil
;
481 b
->invisibility_spec
= Qt
;
484 b
->sort_table
= XSTRING (Vascii_sort_table
);
485 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
488 /* Reset all per-buffer variables to their defaults. */
489 b
->local_var_alist
= Qnil
;
490 b
->local_var_flags
= 0;
492 /* For each slot that has a default value,
493 copy that into the slot. */
495 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
496 offset
< sizeof (struct buffer
);
497 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
499 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
500 if (flag
> 0 || flag
== -2)
501 *(Lisp_Object
*)(offset
+ (char *)b
) =
502 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
506 /* We split this away from generate-new-buffer, because rename-buffer
507 and set-visited-file-name ought to be able to use this to really
508 rename the buffer properly. */
510 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
512 "Return a string that is the name of no existing buffer based on NAME.\n\
513 If there is no live buffer named NAME, then return NAME.\n\
514 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
515 until an unused name is found, and then return that name.\n\
516 Optional second argument IGNORE specifies a name that is okay to use\n\
517 \(if it is in the sequence to be tried)\n\
518 even if a buffer with that name exists.")
520 register Lisp_Object name
, ignore
;
522 register Lisp_Object gentemp
, tem
;
526 CHECK_STRING (name
, 0);
528 tem
= Fget_buffer (name
);
535 sprintf (number
, "<%d>", ++count
);
536 gentemp
= concat2 (name
, build_string (number
));
537 tem
= Fstring_equal (gentemp
, ignore
);
540 tem
= Fget_buffer (gentemp
);
547 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
548 "Return the name of BUFFER, as a string.\n\
549 With no argument or nil as argument, return the name of the current buffer.")
551 register Lisp_Object buffer
;
554 return current_buffer
->name
;
555 CHECK_BUFFER (buffer
, 0);
556 return XBUFFER (buffer
)->name
;
559 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
560 "Return name of file BUFFER is visiting, or nil if none.\n\
561 No argument or nil as argument means use the current buffer.")
563 register Lisp_Object buffer
;
566 return current_buffer
->filename
;
567 CHECK_BUFFER (buffer
, 0);
568 return XBUFFER (buffer
)->filename
;
571 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
573 "Return the base buffer of indirect buffer BUFFER.\n\
574 If BUFFER is not indirect, return nil.")
576 register Lisp_Object buffer
;
579 Lisp_Object base_buffer
;
582 base
= current_buffer
->base_buffer
;
585 CHECK_BUFFER (buffer
, 0);
586 base
= XBUFFER (buffer
)->base_buffer
;
591 XSETBUFFER (base_buffer
, base
);
595 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
596 Sbuffer_local_variables
, 0, 1, 0,
597 "Return an alist of variables that are buffer-local in BUFFER.\n\
598 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
599 For a symbol that is locally unbound, just the symbol appears in the value.\n\
600 Note that storing new VALUEs in these elements doesn't change the variables.\n\
601 No argument or nil as argument means use current buffer as BUFFER.")
603 register Lisp_Object buffer
;
605 register struct buffer
*buf
;
606 register Lisp_Object result
;
609 buf
= current_buffer
;
612 CHECK_BUFFER (buffer
, 0);
613 buf
= XBUFFER (buffer
);
619 register Lisp_Object tail
;
620 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
622 Lisp_Object val
, elt
;
624 elt
= XCONS (tail
)->car
;
626 /* Reference each variable in the alist in buf.
627 If inquiring about the current buffer, this gets the current values,
628 so store them into the alist so the alist is up to date.
629 If inquiring about some other buffer, this swaps out any values
630 for that buffer, making the alist up to date automatically. */
631 val
= find_symbol_value (XCONS (elt
)->car
);
632 /* Use the current buffer value only if buf is the current buffer. */
633 if (buf
!= current_buffer
)
634 val
= XCONS (elt
)->cdr
;
636 /* If symbol is unbound, put just the symbol in the list. */
637 if (EQ (val
, Qunbound
))
638 result
= Fcons (XCONS (elt
)->car
, result
);
639 /* Otherwise, put (symbol . value) in the list. */
641 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
645 /* Add on all the variables stored in special slots. */
647 register int offset
, mask
;
649 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
650 offset
< sizeof (struct buffer
);
651 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
653 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
654 if (mask
== -1 || (buf
->local_var_flags
& mask
))
655 if (SYMBOLP (*(Lisp_Object
*)(offset
656 + (char *)&buffer_local_symbols
)))
657 result
= Fcons (Fcons (*((Lisp_Object
*)
658 (offset
+ (char *)&buffer_local_symbols
)),
659 *(Lisp_Object
*)(offset
+ (char *)buf
)),
668 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
670 "Return t if BUFFER was modified since its file was last read or saved.\n\
671 No argument or nil as argument means use current buffer as BUFFER.")
673 register Lisp_Object buffer
;
675 register struct buffer
*buf
;
677 buf
= current_buffer
;
680 CHECK_BUFFER (buffer
, 0);
681 buf
= XBUFFER (buffer
);
684 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
687 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
689 "Mark current buffer as modified or unmodified according to FLAG.\n\
690 A non-nil FLAG means mark the buffer modified.")
692 register Lisp_Object flag
;
694 register int already
;
695 register Lisp_Object fn
;
697 #ifdef CLASH_DETECTION
698 /* If buffer becoming modified, lock the file.
699 If buffer becoming unmodified, unlock the file. */
701 fn
= current_buffer
->file_truename
;
704 already
= SAVE_MODIFF
< MODIFF
;
705 if (!already
&& !NILP (flag
))
707 else if (already
&& NILP (flag
))
710 #endif /* CLASH_DETECTION */
712 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
717 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
719 "Return BUFFER's tick counter, incremented for each change in text.\n\
720 Each buffer has a tick counter which is incremented each time the text in\n\
721 that buffer is changed. It wraps around occasionally.\n\
722 No argument or nil as argument means use current buffer as BUFFER.")
724 register Lisp_Object buffer
;
726 register struct buffer
*buf
;
728 buf
= current_buffer
;
731 CHECK_BUFFER (buffer
, 0);
732 buf
= XBUFFER (buffer
);
735 return make_number (BUF_MODIFF (buf
));
738 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
739 "sRename buffer (to new name): \nP",
740 "Change current buffer's name to NEWNAME (a string).\n\
741 If second arg UNIQUE is nil or omitted, it is an error if a\n\
742 buffer named NEWNAME already exists.\n\
743 If UNIQUE is non-nil, come up with a new name using\n\
744 `generate-new-buffer-name'.\n\
745 Interactively, you can set UNIQUE with a prefix argument.\n\
746 We return the name we actually gave the buffer.\n\
747 This does not change the name of the visited file (if any).")
749 register Lisp_Object newname
, unique
;
751 register Lisp_Object tem
, buf
;
753 CHECK_STRING (newname
, 0);
755 if (XSTRING (newname
)->size
== 0)
756 error ("Empty string is invalid as a buffer name");
758 tem
= Fget_buffer (newname
);
759 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
760 the buffer automatically so you can create another with the original name.
761 It makes UNIQUE equivalent to
762 (rename-buffer (generate-new-buffer-name NEWNAME)). */
763 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
764 return current_buffer
->name
;
768 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
770 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
773 current_buffer
->name
= newname
;
775 /* Catch redisplay's attention. Unless we do this, the mode lines for
776 any windows displaying current_buffer will stay unchanged. */
779 XSETBUFFER (buf
, current_buffer
);
780 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
781 if (NILP (current_buffer
->filename
)
782 && !NILP (current_buffer
->auto_save_file_name
))
783 call0 (intern ("rename-auto-save-file"));
784 /* Refetch since that last call may have done GC. */
785 return current_buffer
->name
;
788 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
789 "Return most recently selected buffer other than BUFFER.\n\
790 Buffers not visible in windows are preferred to visible buffers,\n\
791 unless optional second argument VISIBLE-OK is non-nil.\n\
792 If no other buffer exists, the buffer `*scratch*' is returned.\n\
793 If BUFFER is omitted or nil, some interesting buffer is returned.")
795 register Lisp_Object buffer
, visible_ok
;
797 register Lisp_Object tail
, buf
, notsogood
, tem
;
800 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
802 buf
= Fcdr (Fcar (tail
));
803 if (EQ (buf
, buffer
))
805 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
808 /* If the selected frame has a buffer_predicate,
809 disregard buffers that don't fit the predicate. */
810 tem
= frame_buffer_predicate ();
813 tem
= call1 (tem
, buf
);
819 if (NILP (visible_ok
))
820 tem
= Fget_buffer_window (buf
, Qt
);
825 if (NILP (notsogood
))
828 if (!NILP (notsogood
))
830 return Fget_buffer_create (build_string ("*scratch*"));
833 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
835 "Make BUFFER stop keeping undo information.\n\
836 No argument or nil as argument means do this for the current buffer.")
838 register Lisp_Object buffer
;
840 Lisp_Object real_buffer
;
843 XSETBUFFER (real_buffer
, current_buffer
);
846 real_buffer
= Fget_buffer (buffer
);
847 if (NILP (real_buffer
))
851 XBUFFER (real_buffer
)->undo_list
= Qt
;
856 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
858 "Start keeping undo information for buffer BUFFER.\n\
859 No argument or nil as argument means do this for the current buffer.")
861 register Lisp_Object buffer
;
863 Lisp_Object real_buffer
;
866 XSETBUFFER (real_buffer
, current_buffer
);
869 real_buffer
= Fget_buffer (buffer
);
870 if (NILP (real_buffer
))
874 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
875 XBUFFER (real_buffer
)->undo_list
= Qnil
;
881 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
882 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
883 The buffer being killed will be current while the hook is running.\n\
886 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
887 "Kill the buffer BUFFER.\n\
888 The argument may be a buffer or may be the name of a buffer.\n\
889 An argument of nil means kill the current buffer.\n\n\
890 Value is t if the buffer is actually killed, nil if user says no.\n\n\
891 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
892 if not void, is a list of functions to be called, with no arguments,\n\
893 before the buffer is actually killed. The buffer to be killed is current\n\
894 when the hook functions are called.\n\n\
895 Any processes that have this buffer as the `process-buffer' are killed\n\
896 with `delete-process'.")
901 register struct buffer
*b
;
902 register Lisp_Object tem
;
903 register struct Lisp_Marker
*m
;
904 struct gcpro gcpro1
, gcpro2
;
907 buf
= Fcurrent_buffer ();
909 buf
= Fget_buffer (bufname
);
915 /* Avoid trouble for buffer already dead. */
919 /* Query if the buffer is still modified. */
920 if (INTERACTIVE
&& !NILP (b
->filename
)
921 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
923 GCPRO2 (buf
, bufname
);
924 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
925 XSTRING (b
->name
)->data
));
931 /* Run hooks with the buffer to be killed the current buffer. */
933 register Lisp_Object val
;
934 int count
= specpdl_ptr
- specpdl
;
937 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
938 set_buffer_internal (b
);
940 /* First run the query functions; if any query is answered no,
941 don't kill the buffer. */
942 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
944 tem
= call0 (Fcar (list
));
946 return unbind_to (count
, Qnil
);
949 /* Then run the hooks. */
950 if (!NILP (Vrun_hooks
))
951 call1 (Vrun_hooks
, Qkill_buffer_hook
);
952 unbind_to (count
, Qnil
);
955 /* We have no more questions to ask. Verify that it is valid
956 to kill the buffer. This must be done after the questions
957 since anything can happen within do_yes_or_no_p. */
959 /* Don't kill the minibuffer now current. */
960 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
966 /* When we kill a base buffer, kill all its indirect buffers.
967 We do it at this stage so nothing terrible happens if they
968 ask questions or their hooks get errors. */
969 if (! b
->base_buffer
)
971 struct buffer
*other
;
975 for (other
= all_buffers
; other
; other
= other
->next
)
976 /* all_buffers contains dead buffers too;
977 don't re-kill them. */
978 if (other
->base_buffer
== b
&& !NILP (other
->name
))
981 XSETBUFFER (buf
, other
);
988 /* Make this buffer not be current.
989 In the process, notice if this is the sole visible buffer
990 and give up if so. */
991 if (b
== current_buffer
)
993 tem
= Fother_buffer (buf
, Qnil
);
995 if (b
== current_buffer
)
999 /* Now there is no question: we can kill the buffer. */
1001 #ifdef CLASH_DETECTION
1002 /* Unlock this buffer's file, if it is locked. */
1004 #endif /* CLASH_DETECTION */
1006 kill_buffer_processes (buf
);
1008 tem
= Vinhibit_quit
;
1010 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1011 Freplace_buffer_in_windows (buf
);
1012 Vinhibit_quit
= tem
;
1014 /* Delete any auto-save file, if we saved it in this session. */
1015 if (STRINGP (b
->auto_save_file_name
)
1016 && b
->auto_save_modified
!= 0)
1019 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1021 internal_delete_file (b
->auto_save_file_name
);
1026 /* Unchain all markers that belong to this indirect buffer.
1027 Don't unchain the markers that belong to the base buffer
1028 or its other indirect buffers. */
1029 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1035 unchain_marker (tem
);
1041 /* Unchain all markers of this buffer and its indirect buffers.
1042 and leave them pointing nowhere. */
1043 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1050 BUF_MARKERS (b
) = Qnil
;
1052 #ifdef USE_TEXT_PROPERTIES
1053 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1056 /* Perhaps we should explicitly free the interval tree here... */
1059 /* Reset the local variables, so that this buffer's local values
1060 won't be protected from GC. They would be protected
1061 if they happened to remain encached in their symbols.
1062 This gets rid of them for certain. */
1063 swap_out_buffer_local_variables (b
);
1064 reset_buffer_local_variables (b
);
1069 if (! b
->base_buffer
)
1070 BUFFER_FREE (BUF_BEG_ADDR (b
));
1072 if (b
->newline_cache
)
1074 free_region_cache (b
->newline_cache
);
1075 b
->newline_cache
= 0;
1077 if (b
->width_run_cache
)
1079 free_region_cache (b
->width_run_cache
);
1080 b
->width_run_cache
= 0;
1082 b
->width_table
= Qnil
;
1084 b
->undo_list
= Qnil
;
1089 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1090 we do this each time BUF is selected visibly, the more recently
1091 selected buffers are always closer to the front of the list. This
1092 means that other_buffer is more likely to choose a relevant buffer. */
1097 register Lisp_Object link
, prev
;
1100 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1102 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1107 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1108 we cannot use Fdelq itself here because it allows quitting. */
1111 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1113 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1115 XCONS(link
)->cdr
= Vbuffer_alist
;
1116 Vbuffer_alist
= link
;
1119 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1120 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1121 Use this function before selecting the buffer, since it may need to inspect\n\
1122 the current buffer's major mode.")
1127 Lisp_Object function
;
1129 function
= buffer_defaults
.major_mode
;
1130 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1131 function
= current_buffer
->major_mode
;
1133 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1136 count
= specpdl_ptr
- specpdl
;
1138 /* To select a nonfundamental mode,
1139 select the buffer temporarily and then call the mode function. */
1141 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1146 return unbind_to (count
, Qnil
);
1149 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1150 "Select buffer BUFFER in the current window.\n\
1151 BUFFER may be a buffer or a buffer name.\n\
1152 Optional second arg NORECORD non-nil means\n\
1153 do not put this buffer at the front of the list of recently selected ones.\n\
1155 WARNING: This is NOT the way to work on another buffer temporarily\n\
1156 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1157 the window-buffer correspondences.")
1159 Lisp_Object bufname
, norecord
;
1161 register Lisp_Object buf
;
1164 if (EQ (minibuf_window
, selected_window
))
1165 error ("Cannot switch buffers in minibuffer window");
1166 tem
= Fwindow_dedicated_p (selected_window
);
1168 error ("Cannot switch buffers in a dedicated window");
1171 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1174 buf
= Fget_buffer (bufname
);
1177 buf
= Fget_buffer_create (bufname
);
1178 Fset_buffer_major_mode (buf
);
1182 if (NILP (norecord
))
1183 record_buffer (buf
);
1185 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1186 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1193 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
1194 "Select buffer BUFFER in some window, preferably a different one.\n\
1195 If BUFFER is nil, then some other buffer is chosen.\n\
1196 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1197 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1198 window even if BUFFER is already visible in the selected window.")
1200 Lisp_Object bufname
, other
;
1202 register Lisp_Object buf
;
1204 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1207 buf
= Fget_buffer (bufname
);
1210 buf
= Fget_buffer_create (bufname
);
1211 Fset_buffer_major_mode (buf
);
1215 record_buffer (buf
);
1216 Fselect_window (Fdisplay_buffer (buf
, other
));
1220 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1221 "Return the current buffer as a Lisp object.")
1224 register Lisp_Object buf
;
1225 XSETBUFFER (buf
, current_buffer
);
1229 /* Set the current buffer to B. */
1232 set_buffer_internal (b
)
1233 register struct buffer
*b
;
1235 register struct buffer
*old_buf
;
1236 register Lisp_Object tail
, valcontents
;
1239 if (current_buffer
== b
)
1242 windows_or_buffers_changed
= 1;
1243 set_buffer_internal_1 (b
);
1246 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1247 This is used by redisplay. */
1250 set_buffer_internal_1 (b
)
1251 register struct buffer
*b
;
1253 register struct buffer
*old_buf
;
1254 register Lisp_Object tail
, valcontents
;
1257 if (current_buffer
== b
)
1260 old_buf
= current_buffer
;
1262 last_known_column_point
= -1; /* invalidate indentation cache */
1266 /* Put the undo list back in the base buffer, so that it appears
1267 that an indirect buffer shares the undo list of its base. */
1268 if (old_buf
->base_buffer
)
1269 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1271 /* If the old current buffer has markers to record PT, BEGV and ZV
1272 when it is not current, update them now. */
1273 if (! NILP (old_buf
->pt_marker
))
1276 XSETBUFFER (obuf
, old_buf
);
1277 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1279 if (! NILP (old_buf
->begv_marker
))
1282 XSETBUFFER (obuf
, old_buf
);
1283 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1285 if (! NILP (old_buf
->zv_marker
))
1288 XSETBUFFER (obuf
, old_buf
);
1289 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1293 /* Get the undo list from the base buffer, so that it appears
1294 that an indirect buffer shares the undo list of its base. */
1296 b
->undo_list
= b
->base_buffer
->undo_list
;
1298 /* If the new current buffer has markers to record PT, BEGV and ZV
1299 when it is not current, fetch them now. */
1300 if (! NILP (b
->pt_marker
))
1301 BUF_PT (b
) = marker_position (b
->pt_marker
);
1302 if (! NILP (b
->begv_marker
))
1303 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1304 if (! NILP (b
->zv_marker
))
1305 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1307 /* Look down buffer's list of local Lisp variables
1308 to find and update any that forward into C variables. */
1310 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1312 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1313 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1314 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1315 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1316 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1317 /* Just reference the variable
1318 to cause it to become set for this buffer. */
1319 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1322 /* Do the same with any others that were local to the previous buffer */
1325 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1327 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1328 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1329 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1330 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1331 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1332 /* Just reference the variable
1333 to cause it to become set for this buffer. */
1334 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1338 /* Switch to buffer B temporarily for redisplay purposes.
1339 This avoids certain things that don't need to be done within redisplay. */
1345 register struct buffer
*old_buf
;
1347 if (current_buffer
== b
)
1350 old_buf
= current_buffer
;
1355 /* If the old current buffer has markers to record PT, BEGV and ZV
1356 when it is not current, update them now. */
1357 if (! NILP (old_buf
->pt_marker
))
1360 XSETBUFFER (obuf
, old_buf
);
1361 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1363 if (! NILP (old_buf
->begv_marker
))
1366 XSETBUFFER (obuf
, old_buf
);
1367 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1369 if (! NILP (old_buf
->zv_marker
))
1372 XSETBUFFER (obuf
, old_buf
);
1373 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1377 /* If the new current buffer has markers to record PT, BEGV and ZV
1378 when it is not current, fetch them now. */
1379 if (! NILP (b
->pt_marker
))
1380 BUF_PT (b
) = marker_position (b
->pt_marker
);
1381 if (! NILP (b
->begv_marker
))
1382 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1383 if (! NILP (b
->zv_marker
))
1384 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1387 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1388 "Make the buffer BUFFER current for editing operations.\n\
1389 BUFFER may be a buffer or the name of an existing buffer.\n\
1390 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1391 This function does not display the buffer, so its effect ends\n\
1392 when the current command terminates.\n\
1393 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1395 register Lisp_Object bufname
;
1397 register Lisp_Object buffer
;
1398 buffer
= Fget_buffer (bufname
);
1401 if (NILP (XBUFFER (buffer
)->name
))
1402 error ("Selecting deleted buffer");
1403 set_buffer_internal (XBUFFER (buffer
));
1407 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1408 Sbarf_if_buffer_read_only
, 0, 0, 0,
1409 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1412 if (!NILP (current_buffer
->read_only
)
1413 && NILP (Vinhibit_read_only
))
1414 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1418 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1419 "Put BUFFER at the end of the list of all buffers.\n\
1420 There it is the least likely candidate for `other-buffer' to return;\n\
1421 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1422 If BUFFER is nil or omitted, bury the current buffer.\n\
1423 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1424 selected window if it is displayed there.")
1426 register Lisp_Object buf
;
1428 /* Figure out what buffer we're going to bury. */
1431 XSETBUFFER (buf
, current_buffer
);
1433 /* If we're burying the current buffer, unshow it. */
1434 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
1440 buf1
= Fget_buffer (buf
);
1446 /* Move buf to the end of the buffer list. */
1448 register Lisp_Object aelt
, link
;
1450 aelt
= Frassq (buf
, Vbuffer_alist
);
1451 link
= Fmemq (aelt
, Vbuffer_alist
);
1452 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1453 XCONS (link
)->cdr
= Qnil
;
1454 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1460 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1461 "Delete the entire contents of the current buffer.\n\
1462 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1463 so the buffer is truly empty after this.")
1468 current_buffer
->last_window_start
= 1;
1469 /* Prevent warnings, or suspension of auto saving, that would happen
1470 if future size is less than past size. Use of erase-buffer
1471 implies that the future text is not really related to the past text. */
1472 XSETFASTINT (current_buffer
->save_length
, 0);
1476 validate_region (b
, e
)
1477 register Lisp_Object
*b
, *e
;
1479 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1480 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1482 if (XINT (*b
) > XINT (*e
))
1485 tem
= *b
; *b
= *e
; *e
= tem
;
1488 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1489 && XINT (*e
) <= ZV
))
1490 args_out_of_range (*b
, *e
);
1493 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1495 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1496 Most local variable bindings are eliminated so that the default values\n\
1497 become effective once more. Also, the syntax table is set from\n\
1498 `standard-syntax-table', the local keymap is set to nil,\n\
1499 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1500 This function also forces redisplay of the mode line.\n\
1502 Every function to select a new major mode starts by\n\
1503 calling this function.\n\n\
1504 As a special exception, local variables whose names have\n\
1505 a non-nil `permanent-local' property are not eliminated by this function.\n\
1507 The first thing this function does is run\n\
1508 the normal hook `change-major-mode-hook'.")
1511 register Lisp_Object alist
, sym
, tem
;
1514 if (!NILP (Vrun_hooks
))
1515 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1516 oalist
= current_buffer
->local_var_alist
;
1518 /* Make sure none of the bindings in oalist
1519 remain swapped in, in their symbols. */
1521 swap_out_buffer_local_variables (current_buffer
);
1523 /* Actually eliminate all local bindings of this buffer. */
1525 reset_buffer_local_variables (current_buffer
);
1527 /* Redisplay mode lines; we are changing major mode. */
1529 update_mode_lines
++;
1531 /* Any which are supposed to be permanent,
1532 make local again, with the same values they had. */
1534 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1536 sym
= XCONS (XCONS (alist
)->car
)->car
;
1537 tem
= Fget (sym
, Qpermanent_local
);
1540 Fmake_local_variable (sym
);
1541 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1545 /* Force mode-line redisplay. Useful here because all major mode
1546 commands call this function. */
1547 update_mode_lines
++;
1552 /* Make sure no local variables remain set up with buffer B
1553 for their current values. */
1556 swap_out_buffer_local_variables (b
)
1559 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1561 XSETBUFFER (buffer
, b
);
1562 oalist
= b
->local_var_alist
;
1564 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1566 sym
= XCONS (XCONS (alist
)->car
)->car
;
1568 /* Need not do anything if some other buffer's binding is now encached. */
1569 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
;
1570 if (XBUFFER (tem
) == current_buffer
)
1572 /* Symbol is set up for this buffer's old local value.
1573 Set it up for the current buffer with the default value. */
1575 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1576 /* Store the symbol's current value into the alist entry
1577 it is currently set up for. This is so that, if the
1578 local is marked permanent, and we make it local again
1579 later in Fkill_all_local_variables, we don't lose the value. */
1580 XCONS (XCONS (tem
)->car
)->cdr
1581 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
);
1582 /* Switch to the symbol's default-value alist entry. */
1583 XCONS (tem
)->car
= tem
;
1584 /* Mark it as current for buffer B. */
1585 XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1587 /* Store the current value into any forwarding in the symbol. */
1588 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1594 /* Find all the overlays in the current buffer that contain position POS.
1595 Return the number found, and store them in a vector in *VEC_PTR.
1596 Store in *LEN_PTR the size allocated for the vector.
1597 Store in *NEXT_PTR the next position after POS where an overlay starts,
1598 or ZV if there are no more overlays.
1599 Store in *PREV_PTR the previous position before POS where an overlay ends,
1600 or BEGV if there are no previous overlays.
1601 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1603 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1604 when this function is called.
1606 If EXTEND is non-zero, we make the vector bigger if necessary.
1607 If EXTEND is zero, we never extend the vector,
1608 and we store only as many overlays as will fit.
1609 But we still return the total number of overlays. */
1612 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1615 Lisp_Object
**vec_ptr
;
1620 Lisp_Object tail
, overlay
, start
, end
, result
;
1623 Lisp_Object
*vec
= *vec_ptr
;
1626 int inhibit_storing
= 0;
1628 for (tail
= current_buffer
->overlays_before
;
1630 tail
= XCONS (tail
)->cdr
)
1632 int startpos
, endpos
;
1634 overlay
= XCONS (tail
)->car
;
1636 start
= OVERLAY_START (overlay
);
1637 end
= OVERLAY_END (overlay
);
1638 endpos
= OVERLAY_POSITION (end
);
1647 startpos
= OVERLAY_POSITION (start
);
1648 if (startpos
<= pos
)
1652 /* The supplied vector is full.
1653 Either make it bigger, or don't store any more in it. */
1656 *len_ptr
= len
*= 2;
1657 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1661 inhibit_storing
= 1;
1664 if (!inhibit_storing
)
1666 /* Keep counting overlays even if we can't return them all. */
1669 else if (startpos
< next
)
1673 for (tail
= current_buffer
->overlays_after
;
1675 tail
= XCONS (tail
)->cdr
)
1677 int startpos
, endpos
;
1679 overlay
= XCONS (tail
)->car
;
1681 start
= OVERLAY_START (overlay
);
1682 end
= OVERLAY_END (overlay
);
1683 startpos
= OVERLAY_POSITION (start
);
1686 if (startpos
< next
)
1690 endpos
= OVERLAY_POSITION (end
);
1697 *len_ptr
= len
*= 2;
1698 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1702 inhibit_storing
= 1;
1705 if (!inhibit_storing
)
1709 else if (endpos
< pos
&& endpos
> prev
)
1720 /* Find all the overlays in the current buffer that overlap the range BEG-END
1721 or are empty at BEG.
1723 Return the number found, and store them in a vector in *VEC_PTR.
1724 Store in *LEN_PTR the size allocated for the vector.
1725 Store in *NEXT_PTR the next position after POS where an overlay starts,
1726 or ZV if there are no more overlays.
1727 Store in *PREV_PTR the previous position before POS where an overlay ends,
1728 or BEGV if there are no previous overlays.
1729 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1731 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1732 when this function is called.
1734 If EXTEND is non-zero, we make the vector bigger if necessary.
1735 If EXTEND is zero, we never extend the vector,
1736 and we store only as many overlays as will fit.
1737 But we still return the total number of overlays. */
1740 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1743 Lisp_Object
**vec_ptr
;
1748 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
1751 Lisp_Object
*vec
= *vec_ptr
;
1754 int inhibit_storing
= 0;
1756 for (tail
= current_buffer
->overlays_before
;
1758 tail
= XCONS (tail
)->cdr
)
1760 int startpos
, endpos
;
1762 overlay
= XCONS (tail
)->car
;
1764 ostart
= OVERLAY_START (overlay
);
1765 oend
= OVERLAY_END (overlay
);
1766 endpos
= OVERLAY_POSITION (oend
);
1773 startpos
= OVERLAY_POSITION (ostart
);
1774 /* Count an interval if it either overlaps the range
1775 or is empty at the start of the range. */
1776 if ((beg
< endpos
&& startpos
< end
)
1777 || (startpos
== endpos
&& beg
== endpos
))
1781 /* The supplied vector is full.
1782 Either make it bigger, or don't store any more in it. */
1785 *len_ptr
= len
*= 2;
1786 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1790 inhibit_storing
= 1;
1793 if (!inhibit_storing
)
1795 /* Keep counting overlays even if we can't return them all. */
1798 else if (startpos
< next
)
1802 for (tail
= current_buffer
->overlays_after
;
1804 tail
= XCONS (tail
)->cdr
)
1806 int startpos
, endpos
;
1808 overlay
= XCONS (tail
)->car
;
1810 ostart
= OVERLAY_START (overlay
);
1811 oend
= OVERLAY_END (overlay
);
1812 startpos
= OVERLAY_POSITION (ostart
);
1815 if (startpos
< next
)
1819 endpos
= OVERLAY_POSITION (oend
);
1820 /* Count an interval if it either overlaps the range
1821 or is empty at the start of the range. */
1822 if ((beg
< endpos
&& startpos
< end
)
1823 || (startpos
== endpos
&& beg
== endpos
))
1829 *len_ptr
= len
*= 2;
1830 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1834 inhibit_storing
= 1;
1837 if (!inhibit_storing
)
1841 else if (endpos
< beg
&& endpos
> prev
)
1852 /* Fast function to just test if we're at an overlay boundary. */
1854 overlay_touches_p (pos
)
1857 Lisp_Object tail
, overlay
;
1859 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
1860 tail
= XCONS (tail
)->cdr
)
1864 overlay
= XCONS (tail
)->car
;
1865 if (!GC_OVERLAYP (overlay
))
1868 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1871 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
1875 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
1876 tail
= XCONS (tail
)->cdr
)
1880 overlay
= XCONS (tail
)->car
;
1881 if (!GC_OVERLAYP (overlay
))
1884 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1887 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
1895 Lisp_Object overlay
;
1901 compare_overlays (s1
, s2
)
1902 struct sortvec
*s1
, *s2
;
1904 if (s1
->priority
!= s2
->priority
)
1905 return s1
->priority
- s2
->priority
;
1906 if (s1
->beg
!= s2
->beg
)
1907 return s1
->beg
- s2
->beg
;
1908 if (s1
->end
!= s2
->end
)
1909 return s2
->end
- s1
->end
;
1913 /* Sort an array of overlays by priority. The array is modified in place.
1914 The return value is the new size; this may be smaller than the original
1915 size if some of the overlays were invalid or were window-specific. */
1917 sort_overlays (overlay_vec
, noverlays
, w
)
1918 Lisp_Object
*overlay_vec
;
1923 struct sortvec
*sortvec
;
1924 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1926 /* Put the valid and relevant overlays into sortvec. */
1928 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1931 Lisp_Object overlay
;
1933 overlay
= overlay_vec
[i
];
1934 if (OVERLAY_VALID (overlay
)
1935 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1936 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1938 /* If we're interested in a specific window, then ignore
1939 overlays that are limited to some other window. */
1944 window
= Foverlay_get (overlay
, Qwindow
);
1945 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1949 /* This overlay is good and counts: put it into sortvec. */
1950 sortvec
[j
].overlay
= overlay
;
1951 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1952 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1953 tem
= Foverlay_get (overlay
, Qpriority
);
1955 sortvec
[j
].priority
= XINT (tem
);
1957 sortvec
[j
].priority
= 0;
1963 /* Sort the overlays into the proper order: increasing priority. */
1966 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1968 for (i
= 0; i
< noverlays
; i
++)
1969 overlay_vec
[i
] = sortvec
[i
].overlay
;
1975 Lisp_Object string
, string2
;
1982 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
1983 int size
; /* Allocated length of that array. */
1984 int used
; /* How much of the array is currently in use. */
1985 int bytes
; /* Total length of the strings in buf. */
1988 /* Buffers for storing information about the overlays touching a given
1989 position. These could be automatic variables in overlay_strings, but
1990 it's more efficient to hold onto the memory instead of repeatedly
1991 allocating and freeing it. */
1992 static struct sortstrlist overlay_heads
, overlay_tails
;
1993 static char *overlay_str_buf
;
1995 /* Allocated length of overlay_str_buf. */
1996 static int overlay_str_len
;
1998 /* A comparison function suitable for passing to qsort. */
2000 cmp_for_strings (as1
, as2
)
2003 struct sortstr
*s1
= (struct sortstr
*)as1
;
2004 struct sortstr
*s2
= (struct sortstr
*)as2
;
2005 if (s1
->size
!= s2
->size
)
2006 return s2
->size
- s1
->size
;
2007 if (s1
->priority
!= s2
->priority
)
2008 return s1
->priority
- s2
->priority
;
2013 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2014 struct sortstrlist
*ssl
;
2015 Lisp_Object str
, str2
, pri
;
2018 if (ssl
->used
== ssl
->size
)
2024 ssl
->buf
= ((struct sortstr
*)
2025 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2027 ssl
->buf
[ssl
->used
].string
= str
;
2028 ssl
->buf
[ssl
->used
].string2
= str2
;
2029 ssl
->buf
[ssl
->used
].size
= size
;
2030 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2032 ssl
->bytes
+= XSTRING (str
)->size
;
2034 ssl
->bytes
+= XSTRING (str2
)->size
;
2037 /* Return the concatenation of the strings associated with overlays that
2038 begin or end at POS, ignoring overlays that are specific to a window
2039 other than W. The strings are concatenated in the appropriate order:
2040 shorter overlays nest inside longer ones, and higher priority inside
2041 lower. Normally all of the after-strings come first, but zero-sized
2042 overlays have their after-strings ride along with the before-strings
2043 because it would look strange to print them inside-out.
2045 Returns the string length, and stores the contents indirectly through
2046 PSTR, if that variable is non-null. The string may be overwritten by
2047 subsequent calls. */
2049 overlay_strings (pos
, w
, pstr
)
2054 Lisp_Object ov
, overlay
, window
, str
;
2055 int startpos
, endpos
;
2057 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2058 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2059 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2061 overlay
= XCONS (ov
)->car
;
2062 if (!OVERLAYP (overlay
))
2065 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2066 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2069 if (endpos
!= pos
&& startpos
!= pos
)
2071 window
= Foverlay_get (overlay
, Qwindow
);
2072 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2075 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2076 record_overlay_string (&overlay_heads
, str
,
2078 ? Foverlay_get (overlay
, Qafter_string
)
2080 Foverlay_get (overlay
, Qpriority
),
2082 else if (endpos
== pos
2083 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2084 record_overlay_string (&overlay_tails
, str
, Qnil
,
2085 Foverlay_get (overlay
, Qpriority
),
2088 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2090 overlay
= XCONS (ov
)->car
;
2091 if (!OVERLAYP (overlay
))
2094 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2095 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2098 if (endpos
!= pos
&& startpos
!= pos
)
2100 window
= Foverlay_get (overlay
, Qwindow
);
2101 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2104 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2105 record_overlay_string (&overlay_heads
, str
,
2107 ? Foverlay_get (overlay
, Qafter_string
)
2109 Foverlay_get (overlay
, Qpriority
),
2111 else if (endpos
== pos
2112 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2113 record_overlay_string (&overlay_tails
, str
, Qnil
,
2114 Foverlay_get (overlay
, Qpriority
),
2117 if (overlay_tails
.used
> 1)
2118 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2120 if (overlay_heads
.used
> 1)
2121 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2123 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2128 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2130 if (total
> overlay_str_len
)
2131 overlay_str_buf
= (char *)xrealloc (overlay_str_buf
,
2132 overlay_str_len
= total
);
2133 p
= overlay_str_buf
;
2134 for (i
= overlay_tails
.used
; --i
>= 0;)
2136 tem
= overlay_tails
.buf
[i
].string
;
2137 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2138 p
+= XSTRING (tem
)->size
;
2140 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2142 tem
= overlay_heads
.buf
[i
].string
;
2143 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2144 p
+= XSTRING (tem
)->size
;
2145 tem
= overlay_heads
.buf
[i
].string2
;
2148 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2149 p
+= XSTRING (tem
)->size
;
2152 if (p
!= overlay_str_buf
+ total
)
2155 *pstr
= overlay_str_buf
;
2161 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2164 recenter_overlay_lists (buf
, pos
)
2168 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2170 /* See if anything in overlays_before should move to overlays_after. */
2172 /* We don't strictly need prev in this loop; it should always be nil.
2173 But we use it for symmetry and in case that should cease to be true
2174 with some future change. */
2176 for (tail
= buf
->overlays_before
;
2178 prev
= tail
, tail
= next
)
2180 next
= XCONS (tail
)->cdr
;
2181 overlay
= XCONS (tail
)->car
;
2183 /* If the overlay is not valid, get rid of it. */
2184 if (!OVERLAY_VALID (overlay
))
2189 /* Splice the cons cell TAIL out of overlays_before. */
2191 XCONS (prev
)->cdr
= next
;
2193 buf
->overlays_before
= next
;
2199 beg
= OVERLAY_START (overlay
);
2200 end
= OVERLAY_END (overlay
);
2202 if (OVERLAY_POSITION (end
) > pos
)
2204 /* OVERLAY needs to be moved. */
2205 int where
= OVERLAY_POSITION (beg
);
2206 Lisp_Object other
, other_prev
;
2208 /* Splice the cons cell TAIL out of overlays_before. */
2210 XCONS (prev
)->cdr
= next
;
2212 buf
->overlays_before
= next
;
2214 /* Search thru overlays_after for where to put it. */
2216 for (other
= buf
->overlays_after
;
2218 other_prev
= other
, other
= XCONS (other
)->cdr
)
2220 Lisp_Object otherbeg
, otheroverlay
, follower
;
2223 otheroverlay
= XCONS (other
)->car
;
2224 if (! OVERLAY_VALID (otheroverlay
))
2227 otherbeg
= OVERLAY_START (otheroverlay
);
2228 if (OVERLAY_POSITION (otherbeg
) >= where
)
2232 /* Add TAIL to overlays_after before OTHER. */
2233 XCONS (tail
)->cdr
= other
;
2234 if (!NILP (other_prev
))
2235 XCONS (other_prev
)->cdr
= tail
;
2237 buf
->overlays_after
= tail
;
2241 /* We've reached the things that should stay in overlays_before.
2242 All the rest of overlays_before must end even earlier,
2247 /* See if anything in overlays_after should be in overlays_before. */
2249 for (tail
= buf
->overlays_after
;
2251 prev
= tail
, tail
= next
)
2253 next
= XCONS (tail
)->cdr
;
2254 overlay
= XCONS (tail
)->car
;
2256 /* If the overlay is not valid, get rid of it. */
2257 if (!OVERLAY_VALID (overlay
))
2262 /* Splice the cons cell TAIL out of overlays_after. */
2264 XCONS (prev
)->cdr
= next
;
2266 buf
->overlays_after
= next
;
2272 beg
= OVERLAY_START (overlay
);
2273 end
= OVERLAY_END (overlay
);
2275 /* Stop looking, when we know that nothing further
2276 can possibly end before POS. */
2277 if (OVERLAY_POSITION (beg
) > pos
)
2280 if (OVERLAY_POSITION (end
) <= pos
)
2282 /* OVERLAY needs to be moved. */
2283 int where
= OVERLAY_POSITION (end
);
2284 Lisp_Object other
, other_prev
;
2286 /* Splice the cons cell TAIL out of overlays_after. */
2288 XCONS (prev
)->cdr
= next
;
2290 buf
->overlays_after
= next
;
2292 /* Search thru overlays_before for where to put it. */
2294 for (other
= buf
->overlays_before
;
2296 other_prev
= other
, other
= XCONS (other
)->cdr
)
2298 Lisp_Object otherend
, otheroverlay
;
2301 otheroverlay
= XCONS (other
)->car
;
2302 if (! OVERLAY_VALID (otheroverlay
))
2305 otherend
= OVERLAY_END (otheroverlay
);
2306 if (OVERLAY_POSITION (otherend
) <= where
)
2310 /* Add TAIL to overlays_before before OTHER. */
2311 XCONS (tail
)->cdr
= other
;
2312 if (!NILP (other_prev
))
2313 XCONS (other_prev
)->cdr
= tail
;
2315 buf
->overlays_before
= tail
;
2320 XSETFASTINT (buf
->overlay_center
, pos
);
2324 adjust_overlays_for_insert (pos
, length
)
2328 /* After an insertion, the lists are still sorted properly,
2329 but we may need to update the value of the overlay center. */
2330 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2331 XSETFASTINT (current_buffer
->overlay_center
,
2332 XFASTINT (current_buffer
->overlay_center
) + length
);
2336 adjust_overlays_for_delete (pos
, length
)
2340 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2341 /* The deletion was to our right. No change needed; the before- and
2342 after-lists are still consistent. */
2344 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2345 /* The deletion was to our left. We need to adjust the center value
2346 to account for the change in position, but the lists are consistent
2347 given the new value. */
2348 XSETFASTINT (current_buffer
->overlay_center
,
2349 XFASTINT (current_buffer
->overlay_center
) - length
);
2351 /* We're right in the middle. There might be things on the after-list
2352 that now belong on the before-list. Recentering will move them,
2353 and also update the center point. */
2354 recenter_overlay_lists (current_buffer
, pos
);
2357 /* Fix up overlays that were garbled as a result of permuting markers
2358 in the range START through END. Any overlay with at least one
2359 endpoint in this range will need to be unlinked from the overlay
2360 list and reinserted in its proper place.
2361 Such an overlay might even have negative size at this point.
2362 If so, we'll reverse the endpoints. Can you think of anything
2363 better to do in this situation? */
2365 fix_overlays_in_range (start
, end
)
2366 register int start
, end
;
2368 Lisp_Object tem
, overlay
;
2369 Lisp_Object before_list
, after_list
;
2370 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2371 int startpos
, endpos
;
2373 /* This algorithm shifts links around instead of consing and GCing.
2374 The loop invariant is that before_list (resp. after_list) is a
2375 well-formed list except that its last element, the one that
2376 *pbefore (resp. *pafter) points to, is still uninitialized.
2377 So it's not a bug that before_list isn't initialized, although
2378 it may look strange. */
2379 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2381 overlay
= XCONS (*ptail
)->car
;
2382 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2385 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2387 || (startpos
>= start
&& startpos
< end
))
2389 /* If the overlay is backwards, fix that now. */
2390 if (startpos
> endpos
)
2393 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2394 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2395 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2397 /* Add it to the end of the wrong list. Later on,
2398 recenter_overlay_lists will move it to the right place. */
2399 if (endpos
< XINT (current_buffer
->overlay_center
))
2402 pafter
= &XCONS (*ptail
)->cdr
;
2407 pbefore
= &XCONS (*ptail
)->cdr
;
2409 *ptail
= XCONS (*ptail
)->cdr
;
2412 ptail
= &XCONS (*ptail
)->cdr
;
2414 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2416 overlay
= XCONS (*ptail
)->car
;
2417 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2418 if (startpos
>= end
)
2420 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2421 if (startpos
>= start
2422 || (endpos
>= start
&& endpos
< end
))
2424 if (startpos
> endpos
)
2427 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2428 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2429 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2431 if (endpos
< XINT (current_buffer
->overlay_center
))
2434 pafter
= &XCONS (*ptail
)->cdr
;
2439 pbefore
= &XCONS (*ptail
)->cdr
;
2441 *ptail
= XCONS (*ptail
)->cdr
;
2444 ptail
= &XCONS (*ptail
)->cdr
;
2447 /* Splice the constructed (wrong) lists into the buffer's lists,
2448 and let the recenter function make it sane again. */
2449 *pbefore
= current_buffer
->overlays_before
;
2450 current_buffer
->overlays_before
= before_list
;
2451 recenter_overlay_lists (current_buffer
,
2452 XINT (current_buffer
->overlay_center
));
2454 *pafter
= current_buffer
->overlays_after
;
2455 current_buffer
->overlays_after
= after_list
;
2456 recenter_overlay_lists (current_buffer
,
2457 XINT (current_buffer
->overlay_center
));
2460 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2461 "Return t if OBJECT is an overlay.")
2465 return (OVERLAYP (object
) ? Qt
: Qnil
);
2468 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
2469 "Create a new overlay with range BEG to END in BUFFER.\n\
2470 If omitted, BUFFER defaults to the current buffer.\n\
2471 BEG and END may be integers or markers.")
2473 Lisp_Object beg
, end
, buffer
;
2475 Lisp_Object overlay
;
2479 XSETBUFFER (buffer
, current_buffer
);
2481 CHECK_BUFFER (buffer
, 2);
2483 && ! EQ (Fmarker_buffer (beg
), buffer
))
2484 error ("Marker points into wrong buffer");
2486 && ! EQ (Fmarker_buffer (end
), buffer
))
2487 error ("Marker points into wrong buffer");
2489 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2490 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2492 if (XINT (beg
) > XINT (end
))
2495 temp
= beg
; beg
= end
; end
= temp
;
2498 b
= XBUFFER (buffer
);
2500 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2501 end
= Fset_marker (Fmake_marker (), end
, buffer
);
2503 XMARKER (end
)->insertion_type
= 1;
2505 overlay
= allocate_misc ();
2506 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
2507 XOVERLAY (overlay
)->start
= beg
;
2508 XOVERLAY (overlay
)->end
= end
;
2509 XOVERLAY (overlay
)->plist
= Qnil
;
2511 /* Put the new overlay on the wrong list. */
2512 end
= OVERLAY_END (overlay
);
2513 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2514 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2516 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2518 /* This puts it in the right list, and in the right order. */
2519 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2521 /* We don't need to redisplay the region covered by the overlay, because
2522 the overlay has no properties at the moment. */
2527 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
2528 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
2529 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
2530 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
2532 (overlay
, beg
, end
, buffer
)
2533 Lisp_Object overlay
, beg
, end
, buffer
;
2535 struct buffer
*b
, *ob
;
2536 Lisp_Object obuffer
;
2537 int count
= specpdl_ptr
- specpdl
;
2539 CHECK_OVERLAY (overlay
, 0);
2541 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2543 XSETBUFFER (buffer
, current_buffer
);
2544 CHECK_BUFFER (buffer
, 3);
2547 && ! EQ (Fmarker_buffer (beg
), buffer
))
2548 error ("Marker points into wrong buffer");
2550 && ! EQ (Fmarker_buffer (end
), buffer
))
2551 error ("Marker points into wrong buffer");
2553 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2554 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2556 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
2557 return Fdelete_overlay (overlay
);
2559 if (XINT (beg
) > XINT (end
))
2562 temp
= beg
; beg
= end
; end
= temp
;
2565 specbind (Qinhibit_quit
, Qt
);
2567 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2568 b
= XBUFFER (buffer
);
2569 ob
= XBUFFER (obuffer
);
2571 /* If the overlay has changed buffers, do a thorough redisplay. */
2572 if (!EQ (buffer
, obuffer
))
2574 /* Redisplay where the overlay was. */
2575 if (!NILP (obuffer
))
2580 o_beg
= OVERLAY_START (overlay
);
2581 o_end
= OVERLAY_END (overlay
);
2582 o_beg
= OVERLAY_POSITION (o_beg
);
2583 o_end
= OVERLAY_POSITION (o_end
);
2585 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
2588 /* Redisplay where the overlay is going to be. */
2589 redisplay_region (b
, XINT (beg
), XINT (end
));
2592 /* Redisplay the area the overlay has just left, or just enclosed. */
2596 int change_beg
, change_end
;
2598 o_beg
= OVERLAY_START (overlay
);
2599 o_end
= OVERLAY_END (overlay
);
2600 o_beg
= OVERLAY_POSITION (o_beg
);
2601 o_end
= OVERLAY_POSITION (o_end
);
2603 if (XINT (o_beg
) == XINT (beg
))
2604 redisplay_region (b
, XINT (o_end
), XINT (end
));
2605 else if (XINT (o_end
) == XINT (end
))
2606 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
2609 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
2610 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
2611 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
2615 if (!NILP (obuffer
))
2617 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
2618 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
2621 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
2622 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
2624 /* Put the overlay on the wrong list. */
2625 end
= OVERLAY_END (overlay
);
2626 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2627 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2629 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2631 /* This puts it in the right list, and in the right order. */
2632 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2634 return unbind_to (count
, overlay
);
2637 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
2638 "Delete the overlay OVERLAY from its buffer.")
2640 Lisp_Object overlay
;
2644 int count
= specpdl_ptr
- specpdl
;
2646 CHECK_OVERLAY (overlay
, 0);
2648 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2652 b
= XBUFFER (buffer
);
2654 specbind (Qinhibit_quit
, Qt
);
2656 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
2657 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2659 redisplay_region (b
,
2660 marker_position (OVERLAY_START (overlay
)),
2661 marker_position (OVERLAY_END (overlay
)));
2663 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2664 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2666 return unbind_to (count
, Qnil
);
2669 /* Overlay dissection functions. */
2671 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2672 "Return the position at which OVERLAY starts.")
2674 Lisp_Object overlay
;
2676 CHECK_OVERLAY (overlay
, 0);
2678 return (Fmarker_position (OVERLAY_START (overlay
)));
2681 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2682 "Return the position at which OVERLAY ends.")
2684 Lisp_Object overlay
;
2686 CHECK_OVERLAY (overlay
, 0);
2688 return (Fmarker_position (OVERLAY_END (overlay
)));
2691 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2692 "Return the buffer OVERLAY belongs to.")
2694 Lisp_Object overlay
;
2696 CHECK_OVERLAY (overlay
, 0);
2698 return Fmarker_buffer (OVERLAY_START (overlay
));
2701 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2702 "Return a list of the properties on OVERLAY.\n\
2703 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2706 Lisp_Object overlay
;
2708 CHECK_OVERLAY (overlay
, 0);
2710 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
2714 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2715 "Return a list of the overlays that contain position POS.")
2720 Lisp_Object
*overlay_vec
;
2724 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2727 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2729 /* Put all the overlays we want in a vector in overlay_vec.
2730 Store the length in len. */
2731 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2732 (int *) 0, (int *) 0);
2734 /* Make a list of them all. */
2735 result
= Flist (noverlays
, overlay_vec
);
2737 xfree (overlay_vec
);
2741 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
2742 "Return a list of the overlays that overlap the region BEG ... END.\n\
2743 Overlap means that at least one character is contained within the overlay\n\
2744 and also contained within the specified region.\n\
2745 Empty overlays are included in the result if they are located at BEG\n\
2746 or between BEG and END.")
2748 Lisp_Object beg
, end
;
2751 Lisp_Object
*overlay_vec
;
2755 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
2756 CHECK_NUMBER_COERCE_MARKER (end
, 0);
2759 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2761 /* Put all the overlays we want in a vector in overlay_vec.
2762 Store the length in len. */
2763 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
2764 (int *) 0, (int *) 0);
2766 /* Make a list of them all. */
2767 result
= Flist (noverlays
, overlay_vec
);
2769 xfree (overlay_vec
);
2773 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2775 "Return the next position after POS where an overlay starts or ends.\n\
2776 If there are no more overlay boundaries after POS, return (point-max).")
2782 Lisp_Object
*overlay_vec
;
2786 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2789 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2791 /* Put all the overlays we want in a vector in overlay_vec.
2792 Store the length in len.
2793 endpos gets the position where the next overlay starts. */
2794 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2795 &endpos
, (int *) 0);
2797 /* If any of these overlays ends before endpos,
2798 use its ending point instead. */
2799 for (i
= 0; i
< noverlays
; i
++)
2804 oend
= OVERLAY_END (overlay_vec
[i
]);
2805 oendpos
= OVERLAY_POSITION (oend
);
2806 if (oendpos
< endpos
)
2810 xfree (overlay_vec
);
2811 return make_number (endpos
);
2814 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2815 Sprevious_overlay_change
, 1, 1, 0,
2816 "Return the previous position before POS where an overlay starts or ends.\n\
2817 If there are no more overlay boundaries before POS, return (point-min).")
2823 Lisp_Object
*overlay_vec
;
2828 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2831 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2833 /* At beginning of buffer, we know the answer;
2834 avoid bug subtracting 1 below. */
2835 if (XINT (pos
) == BEGV
)
2838 /* Put all the overlays we want in a vector in overlay_vec.
2839 Store the length in len.
2840 prevpos gets the position of an overlay end. */
2841 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2842 (int *) 0, &prevpos
);
2844 /* If any of these overlays starts after prevpos,
2845 maybe use its starting point instead. */
2846 for (i
= 0; i
< noverlays
; i
++)
2851 ostart
= OVERLAY_START (overlay_vec
[i
]);
2852 ostartpos
= OVERLAY_POSITION (ostart
);
2853 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2854 prevpos
= ostartpos
;
2857 /* If any overlay ends at pos, consider its starting point too. */
2858 for (tail
= current_buffer
->overlays_before
;
2860 tail
= XCONS (tail
)->cdr
)
2862 Lisp_Object overlay
, ostart
;
2865 overlay
= XCONS (tail
)->car
;
2867 ostart
= OVERLAY_START (overlay
);
2868 ostartpos
= OVERLAY_POSITION (ostart
);
2869 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2870 prevpos
= ostartpos
;
2873 xfree (overlay_vec
);
2874 return make_number (prevpos
);
2877 /* These functions are for debugging overlays. */
2879 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2880 "Return a pair of lists giving all the overlays of the current buffer.\n\
2881 The car has all the overlays before the overlay center;\n\
2882 the cdr has all the overlays after the overlay center.\n\
2883 Recentering overlays moves overlays between these lists.\n\
2884 The lists you get are copies, so that changing them has no effect.\n\
2885 However, the overlays you get are the real objects that the buffer uses.")
2888 Lisp_Object before
, after
;
2889 before
= current_buffer
->overlays_before
;
2891 before
= Fcopy_sequence (before
);
2892 after
= current_buffer
->overlays_after
;
2894 after
= Fcopy_sequence (after
);
2896 return Fcons (before
, after
);
2899 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2900 "Recenter the overlays of the current buffer around position POS.")
2904 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2906 recenter_overlay_lists (current_buffer
, XINT (pos
));
2910 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2911 "Get the property of overlay OVERLAY with property name NAME.")
2913 Lisp_Object overlay
, prop
;
2915 Lisp_Object plist
, fallback
;
2917 CHECK_OVERLAY (overlay
, 0);
2921 for (plist
= XOVERLAY (overlay
)->plist
;
2922 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2923 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2925 if (EQ (XCONS (plist
)->car
, prop
))
2926 return XCONS (XCONS (plist
)->cdr
)->car
;
2927 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2930 tem
= Fcar (Fcdr (plist
));
2932 fallback
= Fget (tem
, prop
);
2939 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2940 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2941 (overlay
, prop
, value
)
2942 Lisp_Object overlay
, prop
, value
;
2944 Lisp_Object tail
, buffer
;
2947 CHECK_OVERLAY (overlay
, 0);
2949 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2951 for (tail
= XOVERLAY (overlay
)->plist
;
2952 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2953 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2954 if (EQ (XCONS (tail
)->car
, prop
))
2956 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2957 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2960 /* It wasn't in the list, so add it to the front. */
2961 changed
= !NILP (value
);
2962 XOVERLAY (overlay
)->plist
2963 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
2965 if (! NILP (buffer
))
2968 redisplay_region (XBUFFER (buffer
),
2969 marker_position (OVERLAY_START (overlay
)),
2970 marker_position (OVERLAY_END (overlay
)));
2971 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2972 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2973 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2974 Fdelete_overlay (overlay
);
2979 /* Subroutine of report_overlay_modification. */
2981 /* Lisp vector holding overlay hook functions to call.
2982 Vector elements come in pairs.
2983 Each even-index element is a list of hook functions.
2984 The following odd-index element is the overlay they came from.
2986 Before the buffer change, we fill in this vector
2987 as we call overlay hook functions.
2988 After the buffer change, we get the functions to call from this vector.
2989 This way we always call the same functions before and after the change. */
2990 static Lisp_Object last_overlay_modification_hooks
;
2992 /* Number of elements actually used in last_overlay_modification_hooks. */
2993 static int last_overlay_modification_hooks_used
;
2995 /* Add one functionlist/overlay pair
2996 to the end of last_overlay_modification_hooks. */
2999 add_overlay_mod_hooklist (functionlist
, overlay
)
3000 Lisp_Object functionlist
, overlay
;
3002 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3004 if (last_overlay_modification_hooks_used
== oldsize
)
3007 old
= last_overlay_modification_hooks
;
3008 last_overlay_modification_hooks
3009 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3010 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3011 XVECTOR (old
)->contents
,
3012 sizeof (Lisp_Object
) * oldsize
);
3014 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3015 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3018 /* Run the modification-hooks of overlays that include
3019 any part of the text in START to END.
3020 If this change is an insertion, also
3021 run the insert-before-hooks of overlay starting at END,
3022 and the insert-after-hooks of overlay ending at START.
3024 This is called both before and after the modification.
3025 AFTER is nonzero when we call after the modification.
3027 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3028 When AFTER is nonzero, they are the start position,
3029 the position after the inserted new text,
3030 and the length of deleted or replaced old text. */
3033 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3034 Lisp_Object start
, end
;
3036 Lisp_Object arg1
, arg2
, arg3
;
3038 Lisp_Object prop
, overlay
, tail
;
3039 /* 1 if this change is an insertion. */
3040 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3042 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3046 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3050 /* Call the functions recorded in last_overlay_modification_hooks
3051 rather than scanning the overlays again.
3052 First copy the vector contents, in case some of these hooks
3053 do subsequent modification of the buffer. */
3054 int size
= last_overlay_modification_hooks_used
;
3055 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3058 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3059 copy
, size
* sizeof (Lisp_Object
));
3061 gcpro1
.nvars
= size
;
3063 for (i
= 0; i
< size
;)
3065 Lisp_Object prop
, overlay
;
3067 overlay
= copy
[i
++];
3068 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3074 /* We are being called before a change.
3075 Scan the overlays to find the functions to call. */
3076 last_overlay_modification_hooks_used
= 0;
3078 for (tail
= current_buffer
->overlays_before
;
3080 tail
= XCONS (tail
)->cdr
)
3082 int startpos
, endpos
;
3083 Lisp_Object ostart
, oend
;
3085 overlay
= XCONS (tail
)->car
;
3087 ostart
= OVERLAY_START (overlay
);
3088 oend
= OVERLAY_END (overlay
);
3089 endpos
= OVERLAY_POSITION (oend
);
3090 if (XFASTINT (start
) > endpos
)
3092 startpos
= OVERLAY_POSITION (ostart
);
3093 if (insertion
&& (XFASTINT (start
) == startpos
3094 || XFASTINT (end
) == startpos
))
3096 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3099 /* Copy TAIL in case the hook recenters the overlay lists. */
3101 tail
= Fcopy_sequence (tail
);
3103 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3106 if (insertion
&& (XFASTINT (start
) == endpos
3107 || XFASTINT (end
) == endpos
))
3109 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3113 tail
= Fcopy_sequence (tail
);
3115 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3118 /* Test for intersecting intervals. This does the right thing
3119 for both insertion and deletion. */
3120 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3122 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3126 tail
= Fcopy_sequence (tail
);
3128 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3134 for (tail
= current_buffer
->overlays_after
;
3136 tail
= XCONS (tail
)->cdr
)
3138 int startpos
, endpos
;
3139 Lisp_Object ostart
, oend
;
3141 overlay
= XCONS (tail
)->car
;
3143 ostart
= OVERLAY_START (overlay
);
3144 oend
= OVERLAY_END (overlay
);
3145 startpos
= OVERLAY_POSITION (ostart
);
3146 endpos
= OVERLAY_POSITION (oend
);
3147 if (XFASTINT (end
) < startpos
)
3149 if (insertion
&& (XFASTINT (start
) == startpos
3150 || XFASTINT (end
) == startpos
))
3152 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3156 tail
= Fcopy_sequence (tail
);
3158 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3161 if (insertion
&& (XFASTINT (start
) == endpos
3162 || XFASTINT (end
) == endpos
))
3164 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3168 tail
= Fcopy_sequence (tail
);
3170 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3173 /* Test for intersecting intervals. This does the right thing
3174 for both insertion and deletion. */
3175 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3177 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3181 tail
= Fcopy_sequence (tail
);
3183 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3192 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3193 Lisp_Object list
, overlay
;
3195 Lisp_Object arg1
, arg2
, arg3
;
3197 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3199 GCPRO4 (list
, arg1
, arg2
, arg3
);
3201 add_overlay_mod_hooklist (list
, overlay
);
3203 while (!NILP (list
))
3206 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3208 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3214 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3217 evaporate_overlays (pos
)
3220 Lisp_Object tail
, overlay
, hit_list
;
3223 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3224 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3225 tail
= XCONS (tail
)->cdr
)
3228 overlay
= XCONS (tail
)->car
;
3229 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3232 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3233 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3234 hit_list
= Fcons (overlay
, hit_list
);
3237 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3238 tail
= XCONS (tail
)->cdr
)
3241 overlay
= XCONS (tail
)->car
;
3242 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3245 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3246 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3247 hit_list
= Fcons (overlay
, hit_list
);
3249 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3250 Fdelete_overlay (XCONS (hit_list
)->car
);
3253 /* Somebody has tried to store a value with an unacceptable type
3254 into the buffer-local slot with offset OFFSET. */
3256 buffer_slot_type_mismatch (offset
)
3261 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3262 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3264 case Lisp_Int
: type_name
= "integers"; break;
3265 case Lisp_String
: type_name
= "strings"; break;
3266 case Lisp_Symbol
: type_name
= "symbols"; break;
3271 error ("only %s should be stored in the buffer-local variable %s",
3272 type_name
, XSYMBOL (sym
)->name
->data
);
3277 register Lisp_Object tem
;
3279 /* Make sure all markable slots in buffer_defaults
3280 are initialized reasonably, so mark_buffer won't choke. */
3281 reset_buffer (&buffer_defaults
);
3282 reset_buffer_local_variables (&buffer_defaults
);
3283 reset_buffer (&buffer_local_symbols
);
3284 reset_buffer_local_variables (&buffer_local_symbols
);
3285 /* Prevent GC from getting confused. */
3286 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3287 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3288 #ifdef USE_TEXT_PROPERTIES
3289 BUF_INTERVALS (&buffer_defaults
) = 0;
3290 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3292 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3293 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3295 /* Set up the default values of various buffer slots. */
3296 /* Must do these before making the first buffer! */
3298 /* real setup is done in loaddefs.el */
3299 buffer_defaults
.mode_line_format
= build_string ("%-");
3300 buffer_defaults
.abbrev_mode
= Qnil
;
3301 buffer_defaults
.overwrite_mode
= Qnil
;
3302 buffer_defaults
.case_fold_search
= Qt
;
3303 buffer_defaults
.auto_fill_function
= Qnil
;
3304 buffer_defaults
.selective_display
= Qnil
;
3306 buffer_defaults
.selective_display_ellipses
= Qt
;
3308 buffer_defaults
.abbrev_table
= Qnil
;
3309 buffer_defaults
.display_table
= Qnil
;
3310 buffer_defaults
.undo_list
= Qnil
;
3311 buffer_defaults
.mark_active
= Qnil
;
3312 buffer_defaults
.file_format
= Qnil
;
3313 buffer_defaults
.overlays_before
= Qnil
;
3314 buffer_defaults
.overlays_after
= Qnil
;
3315 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3317 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3318 buffer_defaults
.truncate_lines
= Qnil
;
3319 buffer_defaults
.ctl_arrow
= Qt
;
3322 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3324 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3325 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3326 buffer_defaults
.cache_long_line_scans
= Qnil
;
3327 buffer_defaults
.file_truename
= Qnil
;
3329 /* Assign the local-flags to the slots that have default values.
3330 The local flag is a bit that is used in the buffer
3331 to say that it has its own local value for the slot.
3332 The local flag bits are in the local_var_flags slot of the buffer. */
3334 /* Nothing can work if this isn't true */
3335 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3337 /* 0 means not a lisp var, -1 means always local, else mask */
3338 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3339 XSETINT (buffer_local_flags
.filename
, -1);
3340 XSETINT (buffer_local_flags
.directory
, -1);
3341 XSETINT (buffer_local_flags
.backed_up
, -1);
3342 XSETINT (buffer_local_flags
.save_length
, -1);
3343 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3344 XSETINT (buffer_local_flags
.read_only
, -1);
3345 XSETINT (buffer_local_flags
.major_mode
, -1);
3346 XSETINT (buffer_local_flags
.mode_name
, -1);
3347 XSETINT (buffer_local_flags
.undo_list
, -1);
3348 XSETINT (buffer_local_flags
.mark_active
, -1);
3349 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3350 XSETINT (buffer_local_flags
.file_truename
, -1);
3351 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3353 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3354 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3355 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3356 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3357 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3358 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3360 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3362 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3363 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3364 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3365 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3366 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3367 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3368 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3369 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3370 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3371 XSETFASTINT (buffer_local_flags
.file_format
, 0x20000);
3373 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3376 Vbuffer_alist
= Qnil
;
3380 QSFundamental
= build_string ("Fundamental");
3382 Qfundamental_mode
= intern ("fundamental-mode");
3383 buffer_defaults
.major_mode
= Qfundamental_mode
;
3385 Qmode_class
= intern ("mode-class");
3387 Qprotected_field
= intern ("protected-field");
3389 Qpermanent_local
= intern ("permanent-local");
3391 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3393 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3394 /* super-magic invisible buffer */
3395 Vbuffer_alist
= Qnil
;
3397 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3402 char buf
[MAXPATHLEN
+1];
3404 struct stat dotstat
, pwdstat
;
3408 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3410 /* If PWD is accurate, use it instead of calling getwd. This is faster
3411 when PWD is right, and may avoid a fatal error. */
3412 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
3413 && stat (pwd
, &pwdstat
) == 0
3414 && stat (".", &dotstat
) == 0
3415 && dotstat
.st_ino
== pwdstat
.st_ino
3416 && dotstat
.st_dev
== pwdstat
.st_dev
3417 && strlen (pwd
) < MAXPATHLEN
)
3419 else if (getwd (buf
) == 0)
3420 fatal ("`getwd' failed: %s\n", buf
);
3423 /* Maybe this should really use some standard subroutine
3424 whose definition is filename syntax dependent. */
3426 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
3428 buf
[rc
] = DIRECTORY_SEP
;
3431 #endif /* not VMS */
3432 current_buffer
->directory
= build_string (buf
);
3434 temp
= get_minibuffer (0);
3435 XBUFFER (temp
)->directory
= current_buffer
->directory
;
3438 /* initialize the buffer routines */
3441 extern Lisp_Object Qdisabled
;
3443 staticpro (&last_overlay_modification_hooks
);
3444 last_overlay_modification_hooks
3445 = Fmake_vector (make_number (10), Qnil
);
3447 staticpro (&Vbuffer_defaults
);
3448 staticpro (&Vbuffer_local_symbols
);
3449 staticpro (&Qfundamental_mode
);
3450 staticpro (&Qmode_class
);
3451 staticpro (&QSFundamental
);
3452 staticpro (&Vbuffer_alist
);
3453 staticpro (&Qprotected_field
);
3454 staticpro (&Qpermanent_local
);
3455 staticpro (&Qkill_buffer_hook
);
3456 Qoverlayp
= intern ("overlayp");
3457 staticpro (&Qoverlayp
);
3458 Qevaporate
= intern ("evaporate");
3459 staticpro (&Qevaporate
);
3460 Qmodification_hooks
= intern ("modification-hooks");
3461 staticpro (&Qmodification_hooks
);
3462 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
3463 staticpro (&Qinsert_in_front_hooks
);
3464 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
3465 staticpro (&Qinsert_behind_hooks
);
3466 Qget_file_buffer
= intern ("get-file-buffer");
3467 staticpro (&Qget_file_buffer
);
3468 Qpriority
= intern ("priority");
3469 staticpro (&Qpriority
);
3470 Qwindow
= intern ("window");
3471 staticpro (&Qwindow
);
3472 Qbefore_string
= intern ("before-string");
3473 staticpro (&Qbefore_string
);
3474 Qafter_string
= intern ("after-string");
3475 staticpro (&Qafter_string
);
3476 Qfirst_change_hook
= intern ("first-change-hook");
3477 staticpro (&Qfirst_change_hook
);
3478 Qbefore_change_functions
= intern ("before-change-functions");
3479 staticpro (&Qbefore_change_functions
);
3480 Qafter_change_functions
= intern ("after-change-functions");
3481 staticpro (&Qafter_change_functions
);
3483 Fput (Qprotected_field
, Qerror_conditions
,
3484 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
3485 Fput (Qprotected_field
, Qerror_message
,
3486 build_string ("Attempt to modify a protected field"));
3488 /* All these use DEFVAR_LISP_NOPRO because the slots in
3489 buffer_defaults will all be marked via Vbuffer_defaults. */
3491 DEFVAR_LISP_NOPRO ("default-mode-line-format",
3492 &buffer_defaults
.mode_line_format
,
3493 "Default value of `mode-line-format' for buffers that don't override it.\n\
3494 This is the same as (default-value 'mode-line-format).");
3496 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
3497 &buffer_defaults
.abbrev_mode
,
3498 "Default value of `abbrev-mode' for buffers that do not override it.\n\
3499 This is the same as (default-value 'abbrev-mode).");
3501 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
3502 &buffer_defaults
.ctl_arrow
,
3503 "Default value of `ctl-arrow' for buffers that do not override it.\n\
3504 This is the same as (default-value 'ctl-arrow).");
3506 DEFVAR_LISP_NOPRO ("default-truncate-lines",
3507 &buffer_defaults
.truncate_lines
,
3508 "Default value of `truncate-lines' for buffers that do not override it.\n\
3509 This is the same as (default-value 'truncate-lines).");
3511 DEFVAR_LISP_NOPRO ("default-fill-column",
3512 &buffer_defaults
.fill_column
,
3513 "Default value of `fill-column' for buffers that do not override it.\n\
3514 This is the same as (default-value 'fill-column).");
3516 DEFVAR_LISP_NOPRO ("default-left-margin",
3517 &buffer_defaults
.left_margin
,
3518 "Default value of `left-margin' for buffers that do not override it.\n\
3519 This is the same as (default-value 'left-margin).");
3521 DEFVAR_LISP_NOPRO ("default-tab-width",
3522 &buffer_defaults
.tab_width
,
3523 "Default value of `tab-width' for buffers that do not override it.\n\
3524 This is the same as (default-value 'tab-width).");
3526 DEFVAR_LISP_NOPRO ("default-case-fold-search",
3527 &buffer_defaults
.case_fold_search
,
3528 "Default value of `case-fold-search' for buffers that don't override it.\n\
3529 This is the same as (default-value 'case-fold-search).");
3532 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
3533 &buffer_defaults
.buffer_file_type
,
3534 "Default file type for buffers that do not override it.\n\
3535 This is the same as (default-value 'buffer-file-type).\n\
3536 The file type is nil for text, t for binary.");
3539 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
3542 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
3543 But make-docfile finds it!
3544 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
3546 "Template for displaying mode line for current buffer.\n\
3547 Each buffer has its own value of this variable.\n\
3548 Value may be a string, a symbol or a list or cons cell.\n\
3549 For a symbol, its value is used (but it is ignored if t or nil).\n\
3550 A string appearing directly as the value of a symbol is processed verbatim\n\
3551 in that the %-constructs below are not recognized.\n\
3552 For a list whose car is a symbol, the symbol's value is taken,\n\
3553 and if that is non-nil, the cadr of the list is processed recursively.\n\
3554 Otherwise, the caddr of the list (if there is one) is processed.\n\
3555 For a list whose car is a string or list, each element is processed\n\
3556 recursively and the results are effectively concatenated.\n\
3557 For a list whose car is an integer, the cdr of the list is processed\n\
3558 and padded (if the number is positive) or truncated (if negative)\n\
3559 to the width specified by that number.\n\
3560 A string is printed verbatim in the mode line except for %-constructs:\n\
3561 (%-constructs are allowed when the string is the entire mode-line-format\n\
3562 or when it is found in a cons-cell or a list)\n\
3563 %b -- print buffer name. %f -- print visited file name.\n\
3564 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
3565 % means buffer is read-only and * means it is modified.\n\
3566 For a modified read-only buffer, %* gives % and %+ gives *.\n\
3567 %s -- print process status. %l -- print the current line number.\n\
3568 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
3569 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
3570 or print Bottom or All.\n\
3571 %n -- print Narrow if appropriate.\n\
3572 %t -- print T if files is text, B if binary.\n\
3573 %[ -- print one [ for each recursive editing level. %] similar.\n\
3574 %% -- print %. %- -- print infinitely many dashes.\n\
3575 Decimal digits after the % specify field width to which to pad.");
3578 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
3579 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
3580 nil here means use current buffer's major mode.");
3582 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
3583 make_number (Lisp_Symbol
),
3584 "Symbol for current buffer's major mode.");
3586 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
3587 make_number (Lisp_String
),
3588 "Pretty name of current buffer's major mode (a string).");
3590 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
3591 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
3592 Automatically becomes buffer-local when set in any fashion.");
3594 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
3596 "*Non-nil if searches should ignore case.\n\
3597 Automatically becomes buffer-local when set in any fashion.");
3599 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
3600 make_number (Lisp_Int
),
3601 "*Column beyond which automatic line-wrapping should happen.\n\
3602 Automatically becomes buffer-local when set in any fashion.");
3604 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
3605 make_number (Lisp_Int
),
3606 "*Column for the default indent-line-function to indent to.\n\
3607 Linefeed indents to this column in Fundamental mode.\n\
3608 Automatically becomes buffer-local when set in any fashion.");
3610 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
3611 make_number (Lisp_Int
),
3612 "*Distance between tab stops (for display of tab characters), in columns.\n\
3613 Automatically becomes buffer-local when set in any fashion.");
3615 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
3616 "*Non-nil means display control chars with uparrow.\n\
3617 Nil means use backslash and octal digits.\n\
3618 Automatically becomes buffer-local when set in any fashion.\n\
3619 This variable does not apply to characters whose display is specified\n\
3620 in the current display table (if there is one).");
3622 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
3623 "*Non-nil means do not display continuation lines;\n\
3624 give each line of text one screen line.\n\
3625 Automatically becomes buffer-local when set in any fashion.\n\
3627 Note that this is overridden by the variable\n\
3628 `truncate-partial-width-windows' if that variable is non-nil\n\
3629 and this buffer is not full-frame width.");
3632 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
3634 "Non-nil if the visited file is a binary file.\n\
3635 This variable is meaningful on MS-DOG and Windows NT.\n\
3636 On those systems, it is automatically local in every buffer.\n\
3637 On other systems, this variable is normally always nil.");
3640 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
3641 make_number (Lisp_String
),
3642 "Name of default directory of current buffer. Should end with slash.\n\
3643 Each buffer has its own value of this variable.");
3645 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
3647 "Function called (if non-nil) to perform auto-fill.\n\
3648 It is called after self-inserting a space at a column beyond `fill-column'.\n\
3649 Each buffer has its own value of this variable.\n\
3650 NOTE: This variable is not an ordinary hook;\n\
3651 It may not be a list of functions.");
3653 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
3654 make_number (Lisp_String
),
3655 "Name of file visited in current buffer, or nil if not visiting a file.\n\
3656 Each buffer has its own value of this variable.");
3658 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
3659 make_number (Lisp_String
),
3660 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
3661 The truename of a file is calculated by `file-truename'\n\
3662 and then abbreviated with `abbreviate-file-name'.\n\
3663 Each buffer has its own value of this variable.");
3665 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
3666 ¤t_buffer
->auto_save_file_name
,
3667 make_number (Lisp_String
),
3668 "Name of file for auto-saving current buffer,\n\
3669 or nil if buffer should not be auto-saved.\n\
3670 Each buffer has its own value of this variable.");
3672 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
3673 "Non-nil if this buffer is read-only.\n\
3674 Each buffer has its own value of this variable.");
3676 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
3677 "Non-nil if this buffer's file has been backed up.\n\
3678 Backing up is done before the first time the file is saved.\n\
3679 Each buffer has its own value of this variable.");
3681 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
3682 make_number (Lisp_Int
),
3683 "Length of current buffer when last read in, saved or auto-saved.\n\
3685 Each buffer has its own value of this variable.");
3687 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
3689 "Non-nil enables selective display:\n\
3690 Integer N as value means display only lines\n\
3691 that start with less than n columns of space.\n\
3692 A value of t means, after a ^M, all the rest of the line is invisible.\n\
3693 Then ^M's in the file are written into files as newlines.\n\n\
3694 Automatically becomes buffer-local when set in any fashion.");
3697 DEFVAR_PER_BUFFER ("selective-display-ellipses",
3698 ¤t_buffer
->selective_display_ellipses
,
3700 "t means display ... on previous line when a line is invisible.\n\
3701 Automatically becomes buffer-local when set in any fashion.");
3704 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
3705 "Non-nil if self-insertion should replace existing text.\n\
3706 The value should be one of `overwrite-mode-textual',\n\
3707 `overwrite-mode-binary', or nil.\n\
3708 If it is `overwrite-mode-textual', self-insertion still\n\
3709 inserts at the end of a line, and inserts when point is before a tab,\n\
3710 until the tab is filled in.\n\
3711 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
3712 Automatically becomes buffer-local when set in any fashion.");
3714 #if 0 /* The doc string is too long for some compilers,
3715 but make-docfile can find it in this comment. */
3716 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3718 "Display table that controls display of the contents of current buffer.\n\
3719 Automatically becomes buffer-local when set in any fashion.\n\
3720 The display table is a vector created with `make-display-table'.\n\
3721 The first 256 elements control how to display each possible text character.\n\
3722 Each value should be a vector of characters or nil;\n\
3723 nil means display the character in the default fashion.\n\
3724 The remaining six elements control the display of\n\
3725 the end of a truncated screen line (element 256, a single character);\n\
3726 the end of a continued line (element 257, a single character);\n\
3727 the escape character used to display character codes in octal\n\
3728 (element 258, a single character);\n\
3729 the character used as an arrow for control characters (element 259,\n\
3730 a single character);\n\
3731 the decoration indicating the presence of invisible lines (element 260,\n\
3732 a vector of characters);\n\
3733 the character used to draw the border between side-by-side windows\n\
3734 (element 261, a single character).\n\
3735 If this variable is nil, the value of `standard-display-table' is used.\n\
3736 Each window can have its own, overriding display table.");
3738 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3741 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
3744 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
3745 "Function to call before each text change.\n\
3746 Two arguments are passed to the function: the positions of\n\
3747 the beginning and end of the range of old text to be changed.\n\
3748 \(For an insertion, the beginning and end are at the same place.)\n\
3749 No information is given about the length of the text after the change.\n\
3751 Buffer changes made while executing the `before-change-function'\n\
3752 don't call any before-change or after-change functions.\n\
3753 That's because these variables are temporarily set to nil.\n\
3754 As a result, a hook function cannot straightforwardly alter the value of\n\
3755 these variables. See the Emacs Lisp manual for a way of\n\
3756 accomplishing an equivalent result by using other variables.");
3757 Vbefore_change_function
= Qnil
;
3759 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
3760 "Function to call after each text change.\n\
3761 Three arguments are passed to the function: the positions of\n\
3762 the beginning and end of the range of changed text,\n\
3763 and the length of the pre-change text replaced by that range.\n\
3764 \(For an insertion, the pre-change length is zero;\n\
3765 for a deletion, that length is the number of characters deleted,\n\
3766 and the post-change beginning and end are at the same place.)\n\
3768 Buffer changes made while executing the `after-change-function'\n\
3769 don't call any before-change or after-change functions.\n\
3770 That's because these variables are temporarily set to nil.\n\
3771 As a result, a hook function cannot straightforwardly alter the value of\n\
3772 these variables. See the Emacs Lisp manual for a way of\n\
3773 accomplishing an equivalent result by using other variables.");
3774 Vafter_change_function
= Qnil
;
3776 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
3777 "List of functions to call before each text change.\n\
3778 Two arguments are passed to each function: the positions of\n\
3779 the beginning and end of the range of old text to be changed.\n\
3780 \(For an insertion, the beginning and end are at the same place.)\n\
3781 No information is given about the length of the text after the change.\n\
3783 Buffer changes made while executing the `before-change-functions'\n\
3784 don't call any before-change or after-change functions.\n\
3785 That's because these variables are temporarily set to nil.\n\
3786 As a result, a hook function cannot straightforwardly alter the value of\n\
3787 these variables. See the Emacs Lisp manual for a way of\n\
3788 accomplishing an equivalent result by using other variables.");
3789 Vbefore_change_functions
= Qnil
;
3791 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
3792 "List of function to call after each text change.\n\
3793 Three arguments are passed to each function: the positions of\n\
3794 the beginning and end of the range of changed text,\n\
3795 and the length of the pre-change text replaced by that range.\n\
3796 \(For an insertion, the pre-change length is zero;\n\
3797 for a deletion, that length is the number of characters deleted,\n\
3798 and the post-change beginning and end are at the same place.)\n\
3800 Buffer changes made while executing the `after-change-functions'\n\
3801 don't call any before-change or after-change functions.\n\
3802 That's because these variables are temporarily set to nil.\n\
3803 As a result, a hook function cannot straightforwardly alter the value of\n\
3804 these variables. See the Emacs Lisp manual for a way of\n\
3805 accomplishing an equivalent result by using other variables.");
3807 Vafter_change_functions
= Qnil
;
3809 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
3810 "A list of functions to call before changing a buffer which is unmodified.\n\
3811 The functions are run using the `run-hooks' function.");
3812 Vfirst_change_hook
= Qnil
;
3814 #if 0 /* The doc string is too long for some compilers,
3815 but make-docfile can find it in this comment. */
3816 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3817 "List of undo entries in current buffer.\n\
3818 Recent changes come first; older changes follow newer.\n\
3820 An entry (BEG . END) represents an insertion which begins at\n\
3821 position BEG and ends at position END.\n\
3823 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
3824 from (abs POSITION). If POSITION is positive, point was at the front\n\
3825 of the text being deleted; if negative, point was at the end.\n\
3827 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
3828 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
3829 of the visited file's modification time, as of that time. If the\n\
3830 modification time of the most recent save is different, this entry is\n\
3833 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
3834 was modified between BEG and END. PROPERTY is the property name,\n\
3835 and VALUE is the old value.\n\
3837 An entry of the form POSITION indicates that point was at the buffer\n\
3838 location given by the integer. Undoing an entry of this form places\n\
3839 point at POSITION.\n\
3841 nil marks undo boundaries. The undo command treats the changes\n\
3842 between two undo boundaries as a single step to be undone.\n\
3844 If the value of the variable is t, undo information is not recorded.");
3846 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3849 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3850 "Non-nil means the mark and region are currently active in this buffer.\n\
3851 Automatically local in all buffers.");
3853 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3854 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3855 This variable is buffer-local, in all buffers.\n\
3857 Normally, the line-motion functions work by scanning the buffer for\n\
3858 newlines. Columnar operations (like move-to-column and\n\
3859 compute-motion) also work by scanning the buffer, summing character\n\
3860 widths as they go. This works well for ordinary text, but if the\n\
3861 buffer's lines are very long (say, more than 500 characters), these\n\
3862 motion functions will take longer to execute. Emacs may also take\n\
3863 longer to update the display.\n\
3865 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3866 results of their scans, and consult the cache to avoid rescanning\n\
3867 regions of the buffer until the text is modified. The caches are most\n\
3868 beneficial when they prevent the most searching---that is, when the\n\
3869 buffer contains long lines and large regions of characters with the\n\
3870 same, fixed screen width.\n\
3872 When cache-long-line-scans is non-nil, processing short lines will\n\
3873 become slightly slower (because of the overhead of consulting the\n\
3874 cache), and the caches will use memory roughly proportional to the\n\
3875 number of newlines and characters whose screen width varies.\n\
3877 The caches require no explicit maintenance; their accuracy is\n\
3878 maintained internally by the Emacs primitives. Enabling or disabling\n\
3879 the cache should not affect the behavior of any of the motion\n\
3880 functions; it should only affect their performance.");
3882 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
3883 "Value of point before the last series of scroll operations, or nil.");
3885 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
3886 "List of formats to use when saving this buffer.\n\
3887 Formats are defined by `format-alist'. This variable is\n\
3888 set when a file is visited. Automatically local in all buffers.");
3890 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
3891 ¤t_buffer
->invisibility_spec
, Qnil
,
3892 "Invisibility spec of this buffer.\n\
3893 The default is t, which means that text is invisible\n\
3894 if it has a non-nil `invisible' property.\n\
3895 If the value is a list, a text character is invisible if its `invisible'\n\
3896 property is an element in that list.\n\
3897 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
3898 then characters with property value PROP are invisible,\n\
3899 and they have an ellipsis as well if ELLIPSIS is non-nil.");
3901 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3902 "*Non-nil means deactivate the mark when the buffer contents change.");
3903 Vtransient_mark_mode
= Qnil
;
3905 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3906 "*Non-nil means disregard read-only status of buffers or characters.\n\
3907 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3908 text properties. If the value is a list, disregard `buffer-read-only'\n\
3909 and disregard a `read-only' text property if the property value\n\
3910 is a member of the list.");
3911 Vinhibit_read_only
= Qnil
;
3913 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3914 "List of functions called with no args to query before killing a buffer.");
3915 Vkill_buffer_query_functions
= Qnil
;
3917 defsubr (&Sbuffer_list
);
3918 defsubr (&Sget_buffer
);
3919 defsubr (&Sget_file_buffer
);
3920 defsubr (&Sget_buffer_create
);
3921 defsubr (&Smake_indirect_buffer
);
3922 defsubr (&Sgenerate_new_buffer_name
);
3923 defsubr (&Sbuffer_name
);
3924 /*defsubr (&Sbuffer_number);*/
3925 defsubr (&Sbuffer_file_name
);
3926 defsubr (&Sbuffer_base_buffer
);
3927 defsubr (&Sbuffer_local_variables
);
3928 defsubr (&Sbuffer_modified_p
);
3929 defsubr (&Sset_buffer_modified_p
);
3930 defsubr (&Sbuffer_modified_tick
);
3931 defsubr (&Srename_buffer
);
3932 defsubr (&Sother_buffer
);
3933 defsubr (&Sbuffer_disable_undo
);
3934 defsubr (&Sbuffer_enable_undo
);
3935 defsubr (&Skill_buffer
);
3936 defsubr (&Serase_buffer
);
3937 defsubr (&Sset_buffer_major_mode
);
3938 defsubr (&Sswitch_to_buffer
);
3939 defsubr (&Spop_to_buffer
);
3940 defsubr (&Scurrent_buffer
);
3941 defsubr (&Sset_buffer
);
3942 defsubr (&Sbarf_if_buffer_read_only
);
3943 defsubr (&Sbury_buffer
);
3944 defsubr (&Skill_all_local_variables
);
3946 defsubr (&Soverlayp
);
3947 defsubr (&Smake_overlay
);
3948 defsubr (&Sdelete_overlay
);
3949 defsubr (&Smove_overlay
);
3950 defsubr (&Soverlay_start
);
3951 defsubr (&Soverlay_end
);
3952 defsubr (&Soverlay_buffer
);
3953 defsubr (&Soverlay_properties
);
3954 defsubr (&Soverlays_at
);
3955 defsubr (&Soverlays_in
);
3956 defsubr (&Snext_overlay_change
);
3957 defsubr (&Sprevious_overlay_change
);
3958 defsubr (&Soverlay_recenter
);
3959 defsubr (&Soverlay_lists
);
3960 defsubr (&Soverlay_get
);
3961 defsubr (&Soverlay_put
);
3966 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3967 initial_define_key (control_x_map
, 'k', "kill-buffer");
3969 /* This must not be in syms_of_buffer, because Qdisabled is not
3970 initialized when that function gets called. */
3971 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);