1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
22 #include <sys/types.h>
24 #include <sys/param.h>
27 /* in 4.1, param.h fails to define this. */
28 #define MAXPATHLEN 1024
29 #endif /* not MAXPATHLEN */
33 #include "intervals.h"
37 #include "region-cache.h"
39 #include "blockinput.h"
41 struct buffer
*current_buffer
; /* the current buffer */
43 /* First buffer in chain of all buffers (in reverse order of creation).
44 Threaded through ->next. */
46 struct buffer
*all_buffers
;
48 /* This structure holds the default values of the buffer-local variables
49 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
50 The default value occupies the same slot in this structure
51 as an individual buffer's value occupies in that buffer.
52 Setting the default value also goes through the alist of buffers
53 and stores into each buffer that does not say it has a local value. */
55 struct buffer buffer_defaults
;
57 /* A Lisp_Object pointer to the above, used for staticpro */
59 static Lisp_Object Vbuffer_defaults
;
61 /* This structure marks which slots in a buffer have corresponding
62 default values in buffer_defaults.
63 Each such slot has a nonzero value in this structure.
64 The value has only one nonzero bit.
66 When a buffer has its own local value for a slot,
67 the bit for that slot (found in the same slot in this structure)
68 is turned on in the buffer's local_var_flags slot.
70 If a slot in this structure is -1, then even though there may
71 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
72 and the corresponding slot in buffer_defaults is not used.
74 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
75 but there is a default value which is copied into each buffer.
77 If a slot in this structure is negative, then even though there may
78 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
79 and the corresponding slot in buffer_defaults is not used.
81 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
82 zero, that is a bug */
84 struct buffer buffer_local_flags
;
86 /* This structure holds the names of symbols whose values may be
87 buffer-local. It is indexed and accessed in the same way as the above. */
89 struct buffer buffer_local_symbols
;
90 /* A Lisp_Object pointer to the above, used for staticpro */
91 static Lisp_Object Vbuffer_local_symbols
;
93 /* This structure holds the required types for the values in the
94 buffer-local slots. If a slot contains Qnil, then the
95 corresponding buffer slot may contain a value of any type. If a
96 slot contains an integer, then prospective values' tags must be
97 equal to that integer. When a tag does not match, the function
98 buffer_slot_type_mismatch will signal an error. */
99 struct buffer buffer_local_types
;
101 Lisp_Object
Fset_buffer ();
102 void set_buffer_internal ();
103 void set_buffer_internal_1 ();
104 static void call_overlay_mod_hooks ();
105 static void swap_out_buffer_local_variables ();
107 /* Alist of all buffer names vs the buffers. */
108 /* This used to be a variable, but is no longer,
109 to prevent lossage due to user rplac'ing this alist or its elements. */
110 Lisp_Object Vbuffer_alist
;
112 /* Functions to call before and after each text change. */
113 Lisp_Object Vbefore_change_function
;
114 Lisp_Object Vafter_change_function
;
115 Lisp_Object Vbefore_change_functions
;
116 Lisp_Object Vafter_change_functions
;
118 Lisp_Object Vtransient_mark_mode
;
120 /* t means ignore all read-only text properties.
121 A list means ignore such a property if its value is a member of the list.
122 Any non-nil value means ignore buffer-read-only. */
123 Lisp_Object Vinhibit_read_only
;
125 /* List of functions to call that can query about killing a buffer.
126 If any of these functions returns nil, we don't kill it. */
127 Lisp_Object Vkill_buffer_query_functions
;
129 /* List of functions to call before changing an unmodified buffer. */
130 Lisp_Object Vfirst_change_hook
;
132 Lisp_Object Qfirst_change_hook
;
133 Lisp_Object Qbefore_change_functions
;
134 Lisp_Object Qafter_change_functions
;
136 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
138 Lisp_Object Qprotected_field
;
140 Lisp_Object QSFundamental
; /* A string "Fundamental" */
142 Lisp_Object Qkill_buffer_hook
;
144 Lisp_Object Qget_file_buffer
;
146 Lisp_Object Qoverlayp
;
148 Lisp_Object Qpriority
, Qwindow
, Qevaporate
, Qbefore_string
, Qafter_string
;
150 Lisp_Object Qmodification_hooks
;
151 Lisp_Object Qinsert_in_front_hooks
;
152 Lisp_Object Qinsert_behind_hooks
;
154 /* For debugging; temporary. See set_buffer_internal. */
155 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
161 error ("No buffer named %s", XSTRING (spec
)->data
);
162 error ("Invalid buffer argument");
165 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
166 "Return a list of all existing live buffers.")
169 return Fmapcar (Qcdr
, Vbuffer_alist
);
172 /* Like Fassoc, but use Fstring_equal to compare
173 (which ignores text properties),
174 and don't ever QUIT. */
177 assoc_ignore_text_properties (key
, list
)
178 register Lisp_Object key
;
181 register Lisp_Object tail
;
182 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
184 register Lisp_Object elt
, tem
;
186 tem
= Fstring_equal (Fcar (elt
), key
);
193 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
194 "Return the buffer named NAME (a string).\n\
195 If there is no live buffer named NAME, return nil.\n\
196 NAME may also be a buffer; if so, the value is that buffer.")
198 register Lisp_Object name
;
202 CHECK_STRING (name
, 0);
204 return Fcdr (assoc_ignore_text_properties (name
, Vbuffer_alist
));
207 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
208 "Return the buffer visiting file FILENAME (a string).\n\
209 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
210 If there is no such live buffer, return nil.\n\
211 See also `find-buffer-visiting'.")
213 register Lisp_Object filename
;
215 register Lisp_Object tail
, buf
, tem
;
218 CHECK_STRING (filename
, 0);
219 filename
= Fexpand_file_name (filename
, Qnil
);
221 /* If the file name has special constructs in it,
222 call the corresponding file handler. */
223 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
225 return call2 (handler
, Qget_file_buffer
, filename
);
227 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
229 buf
= Fcdr (XCONS (tail
)->car
);
230 if (!BUFFERP (buf
)) continue;
231 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
232 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
240 get_truename_buffer (filename
)
241 register Lisp_Object filename
;
243 register Lisp_Object tail
, buf
, tem
;
245 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
247 buf
= Fcdr (XCONS (tail
)->car
);
248 if (!BUFFERP (buf
)) continue;
249 if (!STRINGP (XBUFFER (buf
)->file_truename
)) continue;
250 tem
= Fstring_equal (XBUFFER (buf
)->file_truename
, filename
);
257 /* Incremented for each buffer created, to assign the buffer number. */
260 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
261 "Return the buffer named NAME, or create such a buffer and return it.\n\
262 A new buffer is created if there is no live buffer named NAME.\n\
263 If NAME starts with a space, the new buffer does not keep undo information.\n\
264 If NAME is a buffer instead of a string, then it is the value returned.\n\
265 The value is never nil.")
267 register Lisp_Object name
;
269 register Lisp_Object buf
;
270 register struct buffer
*b
;
272 buf
= Fget_buffer (name
);
276 if (XSTRING (name
)->size
== 0)
277 error ("Empty string for buffer name is not allowed");
279 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
281 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
283 /* An ordinary buffer uses its own struct buffer_text. */
284 b
->text
= &b
->own_text
;
287 BUF_GAP_SIZE (b
) = 20;
289 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
291 if (! BUF_BEG_ADDR (b
))
292 buffer_memory_full ();
300 BUF_SAVE_MODIFF (b
) = 1;
301 BUF_INTERVALS (b
) = 0;
303 b
->newline_cache
= 0;
304 b
->width_run_cache
= 0;
305 b
->width_table
= Qnil
;
307 /* Put this on the chain of all buffers including killed ones. */
308 b
->next
= all_buffers
;
311 /* An ordinary buffer normally doesn't need markers
312 to handle BEGV and ZV. */
314 b
->begv_marker
= Qnil
;
317 name
= Fcopy_sequence (name
);
318 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
321 if (XSTRING (name
)->data
[0] != ' ')
327 reset_buffer_local_variables (b
);
329 /* Put this in the alist of all live buffers. */
331 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
333 b
->mark
= Fmake_marker ();
334 BUF_MARKERS (b
) = Qnil
;
339 DEFUN ("make-indirect-buffer",
340 Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
341 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
342 "Create and return an indirect buffer for buffer BASE, named NAME.\n\
343 BASE should be an existing buffer (or buffer name).\n\
344 NAME should be a string which is not the name of an existing buffer.")
346 register Lisp_Object base_buffer
, name
;
348 register Lisp_Object buf
;
349 register struct buffer
*b
;
351 buf
= Fget_buffer (name
);
353 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
355 base_buffer
= Fget_buffer (base_buffer
);
356 if (NILP (base_buffer
))
357 error ("No such buffer: `%s'",
358 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
360 if (XSTRING (name
)->size
== 0)
361 error ("Empty string for buffer name is not allowed");
363 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
365 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
367 if (XBUFFER (base_buffer
)->base_buffer
)
368 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
370 b
->base_buffer
= XBUFFER (base_buffer
);
372 /* Use the base buffer's text object. */
373 b
->text
= b
->base_buffer
->text
;
375 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
376 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
377 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
379 b
->newline_cache
= 0;
380 b
->width_run_cache
= 0;
381 b
->width_table
= Qnil
;
383 /* Put this on the chain of all buffers including killed ones. */
384 b
->next
= all_buffers
;
387 name
= Fcopy_sequence (name
);
388 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
392 reset_buffer_local_variables (b
);
394 /* Put this in the alist of all live buffers. */
396 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
398 b
->mark
= Fmake_marker ();
401 /* Make sure the base buffer has markers for its narrowing. */
402 if (NILP (b
->base_buffer
->pt_marker
))
404 b
->base_buffer
->pt_marker
= Fmake_marker ();
405 Fset_marker (b
->base_buffer
->pt_marker
,
406 make_number (BUF_PT (b
->base_buffer
)), base_buffer
);
408 if (NILP (b
->base_buffer
->begv_marker
))
410 b
->base_buffer
->begv_marker
= Fmake_marker ();
411 Fset_marker (b
->base_buffer
->begv_marker
,
412 make_number (BUF_BEGV (b
->base_buffer
)), base_buffer
);
414 if (NILP (b
->base_buffer
->zv_marker
))
416 b
->base_buffer
->zv_marker
= Fmake_marker ();
417 Fset_marker (b
->base_buffer
->zv_marker
,
418 make_number (BUF_ZV (b
->base_buffer
)), base_buffer
);
419 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
422 /* Give the indirect buffer markers for its narrowing. */
423 b
->pt_marker
= Fmake_marker ();
424 Fset_marker (b
->pt_marker
, make_number (BUF_PT (b
)), buf
);
425 b
->begv_marker
= Fmake_marker ();
426 Fset_marker (b
->begv_marker
, make_number (BUF_BEGV (b
)), buf
);
427 b
->zv_marker
= Fmake_marker ();
428 Fset_marker (b
->zv_marker
, make_number (BUF_ZV (b
)), buf
);
430 XMARKER (b
->zv_marker
)->insertion_type
= 1;
435 /* Reinitialize everything about a buffer except its name and contents
436 and local variables. */
440 register struct buffer
*b
;
443 b
->file_truename
= Qnil
;
444 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
446 XSETFASTINT (b
->save_length
, 0);
447 b
->last_window_start
= 1;
449 b
->auto_save_modified
= 0;
450 b
->auto_save_failure_time
= -1;
451 b
->auto_save_file_name
= Qnil
;
453 b
->overlays_before
= Qnil
;
454 b
->overlays_after
= Qnil
;
455 XSETFASTINT (b
->overlay_center
, 1);
456 b
->mark_active
= Qnil
;
457 b
->point_before_scroll
= Qnil
;
458 b
->file_format
= Qnil
;
461 /* Reset buffer B's local variables info.
462 Don't use this on a buffer that has already been in use;
463 it does not treat permanent locals consistently.
464 Instead, use Fkill_all_local_variables. */
466 reset_buffer_local_variables (b
)
467 register struct buffer
*b
;
471 /* Reset the major mode to Fundamental, together with all the
472 things that depend on the major mode.
473 default-major-mode is handled at a higher level.
474 We ignore it here. */
475 b
->major_mode
= Qfundamental_mode
;
477 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
478 b
->mode_name
= QSFundamental
;
479 b
->minor_modes
= Qnil
;
480 b
->downcase_table
= Vascii_downcase_table
;
481 b
->upcase_table
= Vascii_upcase_table
;
482 b
->case_canon_table
= Vascii_canon_table
;
483 b
->case_eqv_table
= Vascii_eqv_table
;
484 b
->buffer_file_type
= Qnil
;
485 b
->invisibility_spec
= Qt
;
488 b
->sort_table
= XSTRING (Vascii_sort_table
);
489 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
492 /* Reset all per-buffer variables to their defaults. */
493 b
->local_var_alist
= Qnil
;
494 b
->local_var_flags
= 0;
496 /* For each slot that has a default value,
497 copy that into the slot. */
499 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
500 offset
< sizeof (struct buffer
);
501 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
503 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
504 if (flag
> 0 || flag
== -2)
505 *(Lisp_Object
*)(offset
+ (char *)b
) =
506 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
510 /* We split this away from generate-new-buffer, because rename-buffer
511 and set-visited-file-name ought to be able to use this to really
512 rename the buffer properly. */
514 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
516 "Return a string that is the name of no existing buffer based on NAME.\n\
517 If there is no live buffer named NAME, then return NAME.\n\
518 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
519 until an unused name is found, and then return that name.\n\
520 Optional second argument IGNORE specifies a name that is okay to use\n\
521 \(if it is in the sequence to be tried)\n\
522 even if a buffer with that name exists.")
524 register Lisp_Object name
, ignore
;
526 register Lisp_Object gentemp
, tem
;
530 CHECK_STRING (name
, 0);
532 tem
= Fget_buffer (name
);
539 sprintf (number
, "<%d>", ++count
);
540 gentemp
= concat2 (name
, build_string (number
));
541 tem
= Fstring_equal (gentemp
, ignore
);
544 tem
= Fget_buffer (gentemp
);
551 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
552 "Return the name of BUFFER, as a string.\n\
553 With no argument or nil as argument, return the name of the current buffer.")
555 register Lisp_Object buffer
;
558 return current_buffer
->name
;
559 CHECK_BUFFER (buffer
, 0);
560 return XBUFFER (buffer
)->name
;
563 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
564 "Return name of file BUFFER is visiting, or nil if none.\n\
565 No argument or nil as argument means use the current buffer.")
567 register Lisp_Object buffer
;
570 return current_buffer
->filename
;
571 CHECK_BUFFER (buffer
, 0);
572 return XBUFFER (buffer
)->filename
;
575 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
577 "Return the base buffer of indirect buffer BUFFER.\n\
578 If BUFFER is not indirect, return nil.")
580 register Lisp_Object buffer
;
583 Lisp_Object base_buffer
;
586 base
= current_buffer
->base_buffer
;
589 CHECK_BUFFER (buffer
, 0);
590 base
= XBUFFER (buffer
)->base_buffer
;
595 XSETBUFFER (base_buffer
, base
);
599 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
600 Sbuffer_local_variables
, 0, 1, 0,
601 "Return an alist of variables that are buffer-local in BUFFER.\n\
602 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
603 For a symbol that is locally unbound, just the symbol appears in the value.\n\
604 Note that storing new VALUEs in these elements doesn't change the variables.\n\
605 No argument or nil as argument means use current buffer as BUFFER.")
607 register Lisp_Object buffer
;
609 register struct buffer
*buf
;
610 register Lisp_Object result
;
613 buf
= current_buffer
;
616 CHECK_BUFFER (buffer
, 0);
617 buf
= XBUFFER (buffer
);
623 register Lisp_Object tail
;
624 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
626 Lisp_Object val
, elt
;
628 elt
= XCONS (tail
)->car
;
630 /* Reference each variable in the alist in buf.
631 If inquiring about the current buffer, this gets the current values,
632 so store them into the alist so the alist is up to date.
633 If inquiring about some other buffer, this swaps out any values
634 for that buffer, making the alist up to date automatically. */
635 val
= find_symbol_value (XCONS (elt
)->car
);
636 /* Use the current buffer value only if buf is the current buffer. */
637 if (buf
!= current_buffer
)
638 val
= XCONS (elt
)->cdr
;
640 /* If symbol is unbound, put just the symbol in the list. */
641 if (EQ (val
, Qunbound
))
642 result
= Fcons (XCONS (elt
)->car
, result
);
643 /* Otherwise, put (symbol . value) in the list. */
645 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
649 /* Add on all the variables stored in special slots. */
651 register int offset
, mask
;
653 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
654 offset
< sizeof (struct buffer
);
655 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
657 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
658 if (mask
== -1 || (buf
->local_var_flags
& mask
))
659 if (SYMBOLP (*(Lisp_Object
*)(offset
660 + (char *)&buffer_local_symbols
)))
661 result
= Fcons (Fcons (*((Lisp_Object
*)
662 (offset
+ (char *)&buffer_local_symbols
)),
663 *(Lisp_Object
*)(offset
+ (char *)buf
)),
672 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
674 "Return t if BUFFER was modified since its file was last read or saved.\n\
675 No argument or nil as argument means use current buffer as BUFFER.")
677 register Lisp_Object buffer
;
679 register struct buffer
*buf
;
681 buf
= current_buffer
;
684 CHECK_BUFFER (buffer
, 0);
685 buf
= XBUFFER (buffer
);
688 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
691 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
693 "Mark current buffer as modified or unmodified according to FLAG.\n\
694 A non-nil FLAG means mark the buffer modified.")
696 register Lisp_Object flag
;
698 register int already
;
699 register Lisp_Object fn
;
701 #ifdef CLASH_DETECTION
702 /* If buffer becoming modified, lock the file.
703 If buffer becoming unmodified, unlock the file. */
705 fn
= current_buffer
->file_truename
;
708 already
= SAVE_MODIFF
< MODIFF
;
709 if (!already
&& !NILP (flag
))
711 else if (already
&& NILP (flag
))
714 #endif /* CLASH_DETECTION */
716 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
721 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
723 "Return BUFFER's tick counter, incremented for each change in text.\n\
724 Each buffer has a tick counter which is incremented each time the text in\n\
725 that buffer is changed. It wraps around occasionally.\n\
726 No argument or nil as argument means use current buffer as BUFFER.")
728 register Lisp_Object buffer
;
730 register struct buffer
*buf
;
732 buf
= current_buffer
;
735 CHECK_BUFFER (buffer
, 0);
736 buf
= XBUFFER (buffer
);
739 return make_number (BUF_MODIFF (buf
));
742 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
743 "sRename buffer (to new name): \nP",
744 "Change current buffer's name to NEWNAME (a string).\n\
745 If second arg UNIQUE is nil or omitted, it is an error if a\n\
746 buffer named NEWNAME already exists.\n\
747 If UNIQUE is non-nil, come up with a new name using\n\
748 `generate-new-buffer-name'.\n\
749 Interactively, you can set UNIQUE with a prefix argument.\n\
750 We return the name we actually gave the buffer.\n\
751 This does not change the name of the visited file (if any).")
753 register Lisp_Object newname
, unique
;
755 register Lisp_Object tem
, buf
;
757 CHECK_STRING (newname
, 0);
759 if (XSTRING (newname
)->size
== 0)
760 error ("Empty string is invalid as a buffer name");
762 tem
= Fget_buffer (newname
);
763 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
764 the buffer automatically so you can create another with the original name.
765 It makes UNIQUE equivalent to
766 (rename-buffer (generate-new-buffer-name NEWNAME)). */
767 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
768 return current_buffer
->name
;
772 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
774 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
777 current_buffer
->name
= newname
;
779 /* Catch redisplay's attention. Unless we do this, the mode lines for
780 any windows displaying current_buffer will stay unchanged. */
783 XSETBUFFER (buf
, current_buffer
);
784 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
785 if (NILP (current_buffer
->filename
)
786 && !NILP (current_buffer
->auto_save_file_name
))
787 call0 (intern ("rename-auto-save-file"));
788 /* Refetch since that last call may have done GC. */
789 return current_buffer
->name
;
792 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
793 "Return most recently selected buffer other than BUFFER.\n\
794 Buffers not visible in windows are preferred to visible buffers,\n\
795 unless optional second argument VISIBLE-OK is non-nil.\n\
796 If no other buffer exists, the buffer `*scratch*' is returned.\n\
797 If BUFFER is omitted or nil, some interesting buffer is returned.")
799 register Lisp_Object buffer
, visible_ok
;
801 register Lisp_Object tail
, buf
, notsogood
, tem
;
804 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
806 buf
= Fcdr (Fcar (tail
));
807 if (EQ (buf
, buffer
))
809 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
812 /* If the selected frame has a buffer_predicate,
813 disregard buffers that don't fit the predicate. */
814 tem
= frame_buffer_predicate ();
817 tem
= call1 (tem
, buf
);
823 if (NILP (visible_ok
))
824 tem
= Fget_buffer_window (buf
, Qt
);
829 if (NILP (notsogood
))
832 if (!NILP (notsogood
))
834 return Fget_buffer_create (build_string ("*scratch*"));
837 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
839 "Make BUFFER stop keeping undo information.\n\
840 No argument or nil as argument means do this for the current buffer.")
842 register Lisp_Object buffer
;
844 Lisp_Object real_buffer
;
847 XSETBUFFER (real_buffer
, current_buffer
);
850 real_buffer
= Fget_buffer (buffer
);
851 if (NILP (real_buffer
))
855 XBUFFER (real_buffer
)->undo_list
= Qt
;
860 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
862 "Start keeping undo information for buffer BUFFER.\n\
863 No argument or nil as argument means do this for the current buffer.")
865 register Lisp_Object buffer
;
867 Lisp_Object real_buffer
;
870 XSETBUFFER (real_buffer
, current_buffer
);
873 real_buffer
= Fget_buffer (buffer
);
874 if (NILP (real_buffer
))
878 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
879 XBUFFER (real_buffer
)->undo_list
= Qnil
;
885 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
886 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
887 The buffer being killed will be current while the hook is running.\n\
890 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
891 "Kill the buffer BUFFER.\n\
892 The argument may be a buffer or may be the name of a buffer.\n\
893 An argument of nil means kill the current buffer.\n\n\
894 Value is t if the buffer is actually killed, nil if user says no.\n\n\
895 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
896 if not void, is a list of functions to be called, with no arguments,\n\
897 before the buffer is actually killed. The buffer to be killed is current\n\
898 when the hook functions are called.\n\n\
899 Any processes that have this buffer as the `process-buffer' are killed\n\
900 with `delete-process'.")
905 register struct buffer
*b
;
906 register Lisp_Object tem
;
907 register struct Lisp_Marker
*m
;
908 struct gcpro gcpro1
, gcpro2
;
911 buf
= Fcurrent_buffer ();
913 buf
= Fget_buffer (bufname
);
919 /* Avoid trouble for buffer already dead. */
923 /* Query if the buffer is still modified. */
924 if (INTERACTIVE
&& !NILP (b
->filename
)
925 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
927 GCPRO2 (buf
, bufname
);
928 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
929 XSTRING (b
->name
)->data
));
935 /* Run hooks with the buffer to be killed the current buffer. */
937 register Lisp_Object val
;
938 int count
= specpdl_ptr
- specpdl
;
941 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
942 set_buffer_internal (b
);
944 /* First run the query functions; if any query is answered no,
945 don't kill the buffer. */
946 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
948 tem
= call0 (Fcar (list
));
950 return unbind_to (count
, Qnil
);
953 /* Then run the hooks. */
954 if (!NILP (Vrun_hooks
))
955 call1 (Vrun_hooks
, Qkill_buffer_hook
);
956 unbind_to (count
, Qnil
);
959 /* We have no more questions to ask. Verify that it is valid
960 to kill the buffer. This must be done after the questions
961 since anything can happen within do_yes_or_no_p. */
963 /* Don't kill the minibuffer now current. */
964 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
970 /* When we kill a base buffer, kill all its indirect buffers.
971 We do it at this stage so nothing terrible happens if they
972 ask questions or their hooks get errors. */
973 if (! b
->base_buffer
)
975 struct buffer
*other
;
979 for (other
= all_buffers
; other
; other
= other
->next
)
980 /* all_buffers contains dead buffers too;
981 don't re-kill them. */
982 if (other
->base_buffer
== b
&& !NILP (other
->name
))
985 XSETBUFFER (buf
, other
);
992 /* Make this buffer not be current.
993 In the process, notice if this is the sole visible buffer
994 and give up if so. */
995 if (b
== current_buffer
)
997 tem
= Fother_buffer (buf
, Qnil
);
999 if (b
== current_buffer
)
1003 /* Now there is no question: we can kill the buffer. */
1005 #ifdef CLASH_DETECTION
1006 /* Unlock this buffer's file, if it is locked. */
1008 #endif /* CLASH_DETECTION */
1010 kill_buffer_processes (buf
);
1012 tem
= Vinhibit_quit
;
1014 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1015 Freplace_buffer_in_windows (buf
);
1016 Vinhibit_quit
= tem
;
1018 /* Delete any auto-save file, if we saved it in this session. */
1019 if (STRINGP (b
->auto_save_file_name
)
1020 && b
->auto_save_modified
!= 0)
1023 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1025 internal_delete_file (b
->auto_save_file_name
);
1030 /* Unchain all markers that belong to this indirect buffer.
1031 Don't unchain the markers that belong to the base buffer
1032 or its other indirect buffers. */
1033 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1039 unchain_marker (tem
);
1045 /* Unchain all markers of this buffer and its indirect buffers.
1046 and leave them pointing nowhere. */
1047 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1054 BUF_MARKERS (b
) = Qnil
;
1056 #ifdef USE_TEXT_PROPERTIES
1057 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1060 /* Perhaps we should explicitly free the interval tree here... */
1063 /* Reset the local variables, so that this buffer's local values
1064 won't be protected from GC. They would be protected
1065 if they happened to remain encached in their symbols.
1066 This gets rid of them for certain. */
1067 swap_out_buffer_local_variables (b
);
1068 reset_buffer_local_variables (b
);
1073 if (! b
->base_buffer
)
1074 BUFFER_FREE (BUF_BEG_ADDR (b
));
1076 if (b
->newline_cache
)
1078 free_region_cache (b
->newline_cache
);
1079 b
->newline_cache
= 0;
1081 if (b
->width_run_cache
)
1083 free_region_cache (b
->width_run_cache
);
1084 b
->width_run_cache
= 0;
1086 b
->width_table
= Qnil
;
1088 b
->undo_list
= Qnil
;
1093 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1094 we do this each time BUF is selected visibly, the more recently
1095 selected buffers are always closer to the front of the list. This
1096 means that other_buffer is more likely to choose a relevant buffer. */
1101 register Lisp_Object link
, prev
;
1104 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1106 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1111 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1112 we cannot use Fdelq itself here because it allows quitting. */
1115 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1117 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1119 XCONS(link
)->cdr
= Vbuffer_alist
;
1120 Vbuffer_alist
= link
;
1123 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1124 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1125 Use this function before selecting the buffer, since it may need to inspect\n\
1126 the current buffer's major mode.")
1131 Lisp_Object function
;
1133 function
= buffer_defaults
.major_mode
;
1134 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1135 function
= current_buffer
->major_mode
;
1137 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1140 count
= specpdl_ptr
- specpdl
;
1142 /* To select a nonfundamental mode,
1143 select the buffer temporarily and then call the mode function. */
1145 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1150 return unbind_to (count
, Qnil
);
1153 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1154 "Select buffer BUFFER in the current window.\n\
1155 BUFFER may be a buffer or a buffer name.\n\
1156 Optional second arg NORECORD non-nil means\n\
1157 do not put this buffer at the front of the list of recently selected ones.\n\
1159 WARNING: This is NOT the way to work on another buffer temporarily\n\
1160 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1161 the window-buffer correspondences.")
1163 Lisp_Object bufname
, norecord
;
1165 register Lisp_Object buf
;
1168 if (EQ (minibuf_window
, selected_window
))
1169 error ("Cannot switch buffers in minibuffer window");
1170 tem
= Fwindow_dedicated_p (selected_window
);
1172 error ("Cannot switch buffers in a dedicated window");
1175 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1178 buf
= Fget_buffer (bufname
);
1181 buf
= Fget_buffer_create (bufname
);
1182 Fset_buffer_major_mode (buf
);
1186 if (NILP (norecord
))
1187 record_buffer (buf
);
1189 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1190 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1197 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
1198 "Select buffer BUFFER in some window, preferably a different one.\n\
1199 If BUFFER is nil, then some other buffer is chosen.\n\
1200 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1201 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1202 window even if BUFFER is already visible in the selected window.")
1204 Lisp_Object bufname
, other
;
1206 register Lisp_Object buf
;
1208 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1211 buf
= Fget_buffer (bufname
);
1214 buf
= Fget_buffer_create (bufname
);
1215 Fset_buffer_major_mode (buf
);
1219 record_buffer (buf
);
1220 Fselect_window (Fdisplay_buffer (buf
, other
));
1224 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1225 "Return the current buffer as a Lisp object.")
1228 register Lisp_Object buf
;
1229 XSETBUFFER (buf
, current_buffer
);
1233 /* Set the current buffer to B. */
1236 set_buffer_internal (b
)
1237 register struct buffer
*b
;
1239 register struct buffer
*old_buf
;
1240 register Lisp_Object tail
, valcontents
;
1243 if (current_buffer
== b
)
1246 windows_or_buffers_changed
= 1;
1247 set_buffer_internal_1 (b
);
1250 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1251 This is used by redisplay. */
1254 set_buffer_internal_1 (b
)
1255 register struct buffer
*b
;
1257 register struct buffer
*old_buf
;
1258 register Lisp_Object tail
, valcontents
;
1261 if (current_buffer
== b
)
1264 old_buf
= current_buffer
;
1266 last_known_column_point
= -1; /* invalidate indentation cache */
1270 /* Put the undo list back in the base buffer, so that it appears
1271 that an indirect buffer shares the undo list of its base. */
1272 if (old_buf
->base_buffer
)
1273 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1275 /* If the old current buffer has markers to record PT, BEGV and ZV
1276 when it is not current, update them now. */
1277 if (! NILP (old_buf
->pt_marker
))
1280 XSETBUFFER (obuf
, old_buf
);
1281 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1283 if (! NILP (old_buf
->begv_marker
))
1286 XSETBUFFER (obuf
, old_buf
);
1287 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1289 if (! NILP (old_buf
->zv_marker
))
1292 XSETBUFFER (obuf
, old_buf
);
1293 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1297 /* Get the undo list from the base buffer, so that it appears
1298 that an indirect buffer shares the undo list of its base. */
1300 b
->undo_list
= b
->base_buffer
->undo_list
;
1302 /* If the new current buffer has markers to record PT, BEGV and ZV
1303 when it is not current, fetch them now. */
1304 if (! NILP (b
->pt_marker
))
1305 BUF_PT (b
) = marker_position (b
->pt_marker
);
1306 if (! NILP (b
->begv_marker
))
1307 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1308 if (! NILP (b
->zv_marker
))
1309 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1311 /* Look down buffer's list of local Lisp variables
1312 to find and update any that forward into C variables. */
1314 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1316 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1317 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1318 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1319 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1320 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1321 /* Just reference the variable
1322 to cause it to become set for this buffer. */
1323 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1326 /* Do the same with any others that were local to the previous buffer */
1329 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1331 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1332 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1333 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1334 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1335 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1336 /* Just reference the variable
1337 to cause it to become set for this buffer. */
1338 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1342 /* Switch to buffer B temporarily for redisplay purposes.
1343 This avoids certain things that don't need to be done within redisplay. */
1349 register struct buffer
*old_buf
;
1351 if (current_buffer
== b
)
1354 old_buf
= current_buffer
;
1359 /* If the old current buffer has markers to record PT, BEGV and ZV
1360 when it is not current, update them now. */
1361 if (! NILP (old_buf
->pt_marker
))
1364 XSETBUFFER (obuf
, old_buf
);
1365 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1367 if (! NILP (old_buf
->begv_marker
))
1370 XSETBUFFER (obuf
, old_buf
);
1371 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1373 if (! NILP (old_buf
->zv_marker
))
1376 XSETBUFFER (obuf
, old_buf
);
1377 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1381 /* If the new current buffer has markers to record PT, BEGV and ZV
1382 when it is not current, fetch them now. */
1383 if (! NILP (b
->pt_marker
))
1384 BUF_PT (b
) = marker_position (b
->pt_marker
);
1385 if (! NILP (b
->begv_marker
))
1386 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1387 if (! NILP (b
->zv_marker
))
1388 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1391 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1392 "Make the buffer BUFFER current for editing operations.\n\
1393 BUFFER may be a buffer or the name of an existing buffer.\n\
1394 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1395 This function does not display the buffer, so its effect ends\n\
1396 when the current command terminates.\n\
1397 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1399 register Lisp_Object bufname
;
1401 register Lisp_Object buffer
;
1402 buffer
= Fget_buffer (bufname
);
1405 if (NILP (XBUFFER (buffer
)->name
))
1406 error ("Selecting deleted buffer");
1407 set_buffer_internal (XBUFFER (buffer
));
1411 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1412 Sbarf_if_buffer_read_only
, 0, 0, 0,
1413 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1416 if (!NILP (current_buffer
->read_only
)
1417 && NILP (Vinhibit_read_only
))
1418 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1422 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1423 "Put BUFFER at the end of the list of all buffers.\n\
1424 There it is the least likely candidate for `other-buffer' to return;\n\
1425 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1426 If BUFFER is nil or omitted, bury the current buffer.\n\
1427 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1428 selected window if it is displayed there.")
1430 register Lisp_Object buf
;
1432 /* Figure out what buffer we're going to bury. */
1435 XSETBUFFER (buf
, current_buffer
);
1437 /* If we're burying the current buffer, unshow it. */
1438 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
1444 buf1
= Fget_buffer (buf
);
1450 /* Move buf to the end of the buffer list. */
1452 register Lisp_Object aelt
, link
;
1454 aelt
= Frassq (buf
, Vbuffer_alist
);
1455 link
= Fmemq (aelt
, Vbuffer_alist
);
1456 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1457 XCONS (link
)->cdr
= Qnil
;
1458 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1464 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1465 "Delete the entire contents of the current buffer.\n\
1466 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1467 so the buffer is truly empty after this.")
1472 current_buffer
->last_window_start
= 1;
1473 /* Prevent warnings, or suspension of auto saving, that would happen
1474 if future size is less than past size. Use of erase-buffer
1475 implies that the future text is not really related to the past text. */
1476 XSETFASTINT (current_buffer
->save_length
, 0);
1480 validate_region (b
, e
)
1481 register Lisp_Object
*b
, *e
;
1483 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1484 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1486 if (XINT (*b
) > XINT (*e
))
1489 tem
= *b
; *b
= *e
; *e
= tem
;
1492 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1493 && XINT (*e
) <= ZV
))
1494 args_out_of_range (*b
, *e
);
1497 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1499 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1500 Most local variable bindings are eliminated so that the default values\n\
1501 become effective once more. Also, the syntax table is set from\n\
1502 `standard-syntax-table', the local keymap is set to nil,\n\
1503 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1504 This function also forces redisplay of the mode line.\n\
1506 Every function to select a new major mode starts by\n\
1507 calling this function.\n\n\
1508 As a special exception, local variables whose names have\n\
1509 a non-nil `permanent-local' property are not eliminated by this function.\n\
1511 The first thing this function does is run\n\
1512 the normal hook `change-major-mode-hook'.")
1515 register Lisp_Object alist
, sym
, tem
;
1518 if (!NILP (Vrun_hooks
))
1519 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1520 oalist
= current_buffer
->local_var_alist
;
1522 /* Make sure none of the bindings in oalist
1523 remain swapped in, in their symbols. */
1525 swap_out_buffer_local_variables (current_buffer
);
1527 /* Actually eliminate all local bindings of this buffer. */
1529 reset_buffer_local_variables (current_buffer
);
1531 /* Redisplay mode lines; we are changing major mode. */
1533 update_mode_lines
++;
1535 /* Any which are supposed to be permanent,
1536 make local again, with the same values they had. */
1538 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1540 sym
= XCONS (XCONS (alist
)->car
)->car
;
1541 tem
= Fget (sym
, Qpermanent_local
);
1544 Fmake_local_variable (sym
);
1545 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1549 /* Force mode-line redisplay. Useful here because all major mode
1550 commands call this function. */
1551 update_mode_lines
++;
1556 /* Make sure no local variables remain set up with buffer B
1557 for their current values. */
1560 swap_out_buffer_local_variables (b
)
1563 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1565 XSETBUFFER (buffer
, b
);
1566 oalist
= b
->local_var_alist
;
1568 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1570 sym
= XCONS (XCONS (alist
)->car
)->car
;
1572 /* Need not do anything if some other buffer's binding is now encached. */
1573 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
;
1574 if (XBUFFER (tem
) == current_buffer
)
1576 /* Symbol is set up for this buffer's old local value.
1577 Set it up for the current buffer with the default value. */
1579 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1580 /* Store the symbol's current value into the alist entry
1581 it is currently set up for. This is so that, if the
1582 local is marked permanent, and we make it local again
1583 later in Fkill_all_local_variables, we don't lose the value. */
1584 XCONS (XCONS (tem
)->car
)->cdr
1585 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
);
1586 /* Switch to the symbol's default-value alist entry. */
1587 XCONS (tem
)->car
= tem
;
1588 /* Mark it as current for buffer B. */
1589 XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1591 /* Store the current value into any forwarding in the symbol. */
1592 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1598 /* Find all the overlays in the current buffer that contain position POS.
1599 Return the number found, and store them in a vector in *VEC_PTR.
1600 Store in *LEN_PTR the size allocated for the vector.
1601 Store in *NEXT_PTR the next position after POS where an overlay starts,
1602 or ZV if there are no more overlays.
1603 Store in *PREV_PTR the previous position before POS where an overlay ends,
1604 or BEGV if there are no previous overlays.
1605 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1607 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1608 when this function is called.
1610 If EXTEND is non-zero, we make the vector bigger if necessary.
1611 If EXTEND is zero, we never extend the vector,
1612 and we store only as many overlays as will fit.
1613 But we still return the total number of overlays. */
1616 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1619 Lisp_Object
**vec_ptr
;
1624 Lisp_Object tail
, overlay
, start
, end
, result
;
1627 Lisp_Object
*vec
= *vec_ptr
;
1630 int inhibit_storing
= 0;
1632 for (tail
= current_buffer
->overlays_before
;
1634 tail
= XCONS (tail
)->cdr
)
1636 int startpos
, endpos
;
1638 overlay
= XCONS (tail
)->car
;
1640 start
= OVERLAY_START (overlay
);
1641 end
= OVERLAY_END (overlay
);
1642 endpos
= OVERLAY_POSITION (end
);
1651 startpos
= OVERLAY_POSITION (start
);
1652 if (startpos
<= pos
)
1656 /* The supplied vector is full.
1657 Either make it bigger, or don't store any more in it. */
1660 *len_ptr
= len
*= 2;
1661 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1665 inhibit_storing
= 1;
1668 if (!inhibit_storing
)
1670 /* Keep counting overlays even if we can't return them all. */
1673 else if (startpos
< next
)
1677 for (tail
= current_buffer
->overlays_after
;
1679 tail
= XCONS (tail
)->cdr
)
1681 int startpos
, endpos
;
1683 overlay
= XCONS (tail
)->car
;
1685 start
= OVERLAY_START (overlay
);
1686 end
= OVERLAY_END (overlay
);
1687 startpos
= OVERLAY_POSITION (start
);
1690 if (startpos
< next
)
1694 endpos
= OVERLAY_POSITION (end
);
1701 *len_ptr
= len
*= 2;
1702 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1706 inhibit_storing
= 1;
1709 if (!inhibit_storing
)
1713 else if (endpos
< pos
&& endpos
> prev
)
1724 /* Find all the overlays in the current buffer that overlap the range BEG-END
1725 or are empty at BEG.
1727 Return the number found, and store them in a vector in *VEC_PTR.
1728 Store in *LEN_PTR the size allocated for the vector.
1729 Store in *NEXT_PTR the next position after POS where an overlay starts,
1730 or ZV if there are no more overlays.
1731 Store in *PREV_PTR the previous position before POS where an overlay ends,
1732 or BEGV if there are no previous overlays.
1733 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1735 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1736 when this function is called.
1738 If EXTEND is non-zero, we make the vector bigger if necessary.
1739 If EXTEND is zero, we never extend the vector,
1740 and we store only as many overlays as will fit.
1741 But we still return the total number of overlays. */
1744 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1747 Lisp_Object
**vec_ptr
;
1752 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
1755 Lisp_Object
*vec
= *vec_ptr
;
1758 int inhibit_storing
= 0;
1760 for (tail
= current_buffer
->overlays_before
;
1762 tail
= XCONS (tail
)->cdr
)
1764 int startpos
, endpos
;
1766 overlay
= XCONS (tail
)->car
;
1768 ostart
= OVERLAY_START (overlay
);
1769 oend
= OVERLAY_END (overlay
);
1770 endpos
= OVERLAY_POSITION (oend
);
1777 startpos
= OVERLAY_POSITION (ostart
);
1778 /* Count an interval if it either overlaps the range
1779 or is empty at the start of the range. */
1780 if ((beg
< endpos
&& startpos
< end
)
1781 || (startpos
== endpos
&& beg
== endpos
))
1785 /* The supplied vector is full.
1786 Either make it bigger, or don't store any more in it. */
1789 *len_ptr
= len
*= 2;
1790 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1794 inhibit_storing
= 1;
1797 if (!inhibit_storing
)
1799 /* Keep counting overlays even if we can't return them all. */
1802 else if (startpos
< next
)
1806 for (tail
= current_buffer
->overlays_after
;
1808 tail
= XCONS (tail
)->cdr
)
1810 int startpos
, endpos
;
1812 overlay
= XCONS (tail
)->car
;
1814 ostart
= OVERLAY_START (overlay
);
1815 oend
= OVERLAY_END (overlay
);
1816 startpos
= OVERLAY_POSITION (ostart
);
1819 if (startpos
< next
)
1823 endpos
= OVERLAY_POSITION (oend
);
1824 /* Count an interval if it either overlaps the range
1825 or is empty at the start of the range. */
1826 if ((beg
< endpos
&& startpos
< end
)
1827 || (startpos
== endpos
&& beg
== endpos
))
1833 *len_ptr
= len
*= 2;
1834 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1838 inhibit_storing
= 1;
1841 if (!inhibit_storing
)
1845 else if (endpos
< beg
&& endpos
> prev
)
1856 /* Fast function to just test if we're at an overlay boundary. */
1858 overlay_touches_p (pos
)
1861 Lisp_Object tail
, overlay
;
1863 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
1864 tail
= XCONS (tail
)->cdr
)
1868 overlay
= XCONS (tail
)->car
;
1869 if (!GC_OVERLAYP (overlay
))
1872 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1875 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
1879 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
1880 tail
= XCONS (tail
)->cdr
)
1884 overlay
= XCONS (tail
)->car
;
1885 if (!GC_OVERLAYP (overlay
))
1888 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1891 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
1899 Lisp_Object overlay
;
1905 compare_overlays (s1
, s2
)
1906 struct sortvec
*s1
, *s2
;
1908 if (s1
->priority
!= s2
->priority
)
1909 return s1
->priority
- s2
->priority
;
1910 if (s1
->beg
!= s2
->beg
)
1911 return s1
->beg
- s2
->beg
;
1912 if (s1
->end
!= s2
->end
)
1913 return s2
->end
- s1
->end
;
1917 /* Sort an array of overlays by priority. The array is modified in place.
1918 The return value is the new size; this may be smaller than the original
1919 size if some of the overlays were invalid or were window-specific. */
1921 sort_overlays (overlay_vec
, noverlays
, w
)
1922 Lisp_Object
*overlay_vec
;
1927 struct sortvec
*sortvec
;
1928 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1930 /* Put the valid and relevant overlays into sortvec. */
1932 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1935 Lisp_Object overlay
;
1937 overlay
= overlay_vec
[i
];
1938 if (OVERLAY_VALID (overlay
)
1939 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1940 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1942 /* If we're interested in a specific window, then ignore
1943 overlays that are limited to some other window. */
1948 window
= Foverlay_get (overlay
, Qwindow
);
1949 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1953 /* This overlay is good and counts: put it into sortvec. */
1954 sortvec
[j
].overlay
= overlay
;
1955 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1956 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1957 tem
= Foverlay_get (overlay
, Qpriority
);
1959 sortvec
[j
].priority
= XINT (tem
);
1961 sortvec
[j
].priority
= 0;
1967 /* Sort the overlays into the proper order: increasing priority. */
1970 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1972 for (i
= 0; i
< noverlays
; i
++)
1973 overlay_vec
[i
] = sortvec
[i
].overlay
;
1979 Lisp_Object string
, string2
;
1986 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
1987 int size
; /* Allocated length of that array. */
1988 int used
; /* How much of the array is currently in use. */
1989 int bytes
; /* Total length of the strings in buf. */
1992 /* Buffers for storing information about the overlays touching a given
1993 position. These could be automatic variables in overlay_strings, but
1994 it's more efficient to hold onto the memory instead of repeatedly
1995 allocating and freeing it. */
1996 static struct sortstrlist overlay_heads
, overlay_tails
;
1997 static char *overlay_str_buf
;
1999 /* Allocated length of overlay_str_buf. */
2000 static int overlay_str_len
;
2002 /* A comparison function suitable for passing to qsort. */
2004 cmp_for_strings (as1
, as2
)
2007 struct sortstr
*s1
= (struct sortstr
*)as1
;
2008 struct sortstr
*s2
= (struct sortstr
*)as2
;
2009 if (s1
->size
!= s2
->size
)
2010 return s2
->size
- s1
->size
;
2011 if (s1
->priority
!= s2
->priority
)
2012 return s1
->priority
- s2
->priority
;
2017 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2018 struct sortstrlist
*ssl
;
2019 Lisp_Object str
, str2
, pri
;
2022 if (ssl
->used
== ssl
->size
)
2028 ssl
->buf
= ((struct sortstr
*)
2029 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2031 ssl
->buf
[ssl
->used
].string
= str
;
2032 ssl
->buf
[ssl
->used
].string2
= str2
;
2033 ssl
->buf
[ssl
->used
].size
= size
;
2034 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2036 ssl
->bytes
+= XSTRING (str
)->size
;
2038 ssl
->bytes
+= XSTRING (str2
)->size
;
2041 /* Return the concatenation of the strings associated with overlays that
2042 begin or end at POS, ignoring overlays that are specific to a window
2043 other than W. The strings are concatenated in the appropriate order:
2044 shorter overlays nest inside longer ones, and higher priority inside
2045 lower. Normally all of the after-strings come first, but zero-sized
2046 overlays have their after-strings ride along with the before-strings
2047 because it would look strange to print them inside-out.
2049 Returns the string length, and stores the contents indirectly through
2050 PSTR, if that variable is non-null. The string may be overwritten by
2051 subsequent calls. */
2053 overlay_strings (pos
, w
, pstr
)
2058 Lisp_Object ov
, overlay
, window
, str
;
2059 int startpos
, endpos
;
2061 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2062 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2063 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2065 overlay
= XCONS (ov
)->car
;
2066 if (!OVERLAYP (overlay
))
2069 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2070 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2073 if (endpos
!= pos
&& startpos
!= pos
)
2075 window
= Foverlay_get (overlay
, Qwindow
);
2076 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2079 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2080 record_overlay_string (&overlay_heads
, str
,
2082 ? Foverlay_get (overlay
, Qafter_string
)
2084 Foverlay_get (overlay
, Qpriority
),
2086 else if (endpos
== pos
2087 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2088 record_overlay_string (&overlay_tails
, str
, Qnil
,
2089 Foverlay_get (overlay
, Qpriority
),
2092 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2094 overlay
= XCONS (ov
)->car
;
2095 if (!OVERLAYP (overlay
))
2098 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2099 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2102 if (endpos
!= pos
&& startpos
!= pos
)
2104 window
= Foverlay_get (overlay
, Qwindow
);
2105 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2108 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2109 record_overlay_string (&overlay_heads
, str
,
2111 ? Foverlay_get (overlay
, Qafter_string
)
2113 Foverlay_get (overlay
, Qpriority
),
2115 else if (endpos
== pos
2116 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2117 record_overlay_string (&overlay_tails
, str
, Qnil
,
2118 Foverlay_get (overlay
, Qpriority
),
2121 if (overlay_tails
.used
> 1)
2122 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2124 if (overlay_heads
.used
> 1)
2125 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2127 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2132 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2134 if (total
> overlay_str_len
)
2135 overlay_str_buf
= (char *)xrealloc (overlay_str_buf
,
2136 overlay_str_len
= total
);
2137 p
= overlay_str_buf
;
2138 for (i
= overlay_tails
.used
; --i
>= 0;)
2140 tem
= overlay_tails
.buf
[i
].string
;
2141 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2142 p
+= XSTRING (tem
)->size
;
2144 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2146 tem
= overlay_heads
.buf
[i
].string
;
2147 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2148 p
+= XSTRING (tem
)->size
;
2149 tem
= overlay_heads
.buf
[i
].string2
;
2152 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2153 p
+= XSTRING (tem
)->size
;
2156 if (p
!= overlay_str_buf
+ total
)
2159 *pstr
= overlay_str_buf
;
2165 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2168 recenter_overlay_lists (buf
, pos
)
2172 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2174 /* See if anything in overlays_before should move to overlays_after. */
2176 /* We don't strictly need prev in this loop; it should always be nil.
2177 But we use it for symmetry and in case that should cease to be true
2178 with some future change. */
2180 for (tail
= buf
->overlays_before
;
2182 prev
= tail
, tail
= next
)
2184 next
= XCONS (tail
)->cdr
;
2185 overlay
= XCONS (tail
)->car
;
2187 /* If the overlay is not valid, get rid of it. */
2188 if (!OVERLAY_VALID (overlay
))
2193 /* Splice the cons cell TAIL out of overlays_before. */
2195 XCONS (prev
)->cdr
= next
;
2197 buf
->overlays_before
= next
;
2203 beg
= OVERLAY_START (overlay
);
2204 end
= OVERLAY_END (overlay
);
2206 if (OVERLAY_POSITION (end
) > pos
)
2208 /* OVERLAY needs to be moved. */
2209 int where
= OVERLAY_POSITION (beg
);
2210 Lisp_Object other
, other_prev
;
2212 /* Splice the cons cell TAIL out of overlays_before. */
2214 XCONS (prev
)->cdr
= next
;
2216 buf
->overlays_before
= next
;
2218 /* Search thru overlays_after for where to put it. */
2220 for (other
= buf
->overlays_after
;
2222 other_prev
= other
, other
= XCONS (other
)->cdr
)
2224 Lisp_Object otherbeg
, otheroverlay
, follower
;
2227 otheroverlay
= XCONS (other
)->car
;
2228 if (! OVERLAY_VALID (otheroverlay
))
2231 otherbeg
= OVERLAY_START (otheroverlay
);
2232 if (OVERLAY_POSITION (otherbeg
) >= where
)
2236 /* Add TAIL to overlays_after before OTHER. */
2237 XCONS (tail
)->cdr
= other
;
2238 if (!NILP (other_prev
))
2239 XCONS (other_prev
)->cdr
= tail
;
2241 buf
->overlays_after
= tail
;
2245 /* We've reached the things that should stay in overlays_before.
2246 All the rest of overlays_before must end even earlier,
2251 /* See if anything in overlays_after should be in overlays_before. */
2253 for (tail
= buf
->overlays_after
;
2255 prev
= tail
, tail
= next
)
2257 next
= XCONS (tail
)->cdr
;
2258 overlay
= XCONS (tail
)->car
;
2260 /* If the overlay is not valid, get rid of it. */
2261 if (!OVERLAY_VALID (overlay
))
2266 /* Splice the cons cell TAIL out of overlays_after. */
2268 XCONS (prev
)->cdr
= next
;
2270 buf
->overlays_after
= next
;
2276 beg
= OVERLAY_START (overlay
);
2277 end
= OVERLAY_END (overlay
);
2279 /* Stop looking, when we know that nothing further
2280 can possibly end before POS. */
2281 if (OVERLAY_POSITION (beg
) > pos
)
2284 if (OVERLAY_POSITION (end
) <= pos
)
2286 /* OVERLAY needs to be moved. */
2287 int where
= OVERLAY_POSITION (end
);
2288 Lisp_Object other
, other_prev
;
2290 /* Splice the cons cell TAIL out of overlays_after. */
2292 XCONS (prev
)->cdr
= next
;
2294 buf
->overlays_after
= next
;
2296 /* Search thru overlays_before for where to put it. */
2298 for (other
= buf
->overlays_before
;
2300 other_prev
= other
, other
= XCONS (other
)->cdr
)
2302 Lisp_Object otherend
, otheroverlay
;
2305 otheroverlay
= XCONS (other
)->car
;
2306 if (! OVERLAY_VALID (otheroverlay
))
2309 otherend
= OVERLAY_END (otheroverlay
);
2310 if (OVERLAY_POSITION (otherend
) <= where
)
2314 /* Add TAIL to overlays_before before OTHER. */
2315 XCONS (tail
)->cdr
= other
;
2316 if (!NILP (other_prev
))
2317 XCONS (other_prev
)->cdr
= tail
;
2319 buf
->overlays_before
= tail
;
2324 XSETFASTINT (buf
->overlay_center
, pos
);
2328 adjust_overlays_for_insert (pos
, length
)
2332 /* After an insertion, the lists are still sorted properly,
2333 but we may need to update the value of the overlay center. */
2334 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2335 XSETFASTINT (current_buffer
->overlay_center
,
2336 XFASTINT (current_buffer
->overlay_center
) + length
);
2340 adjust_overlays_for_delete (pos
, length
)
2344 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2345 /* The deletion was to our right. No change needed; the before- and
2346 after-lists are still consistent. */
2348 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2349 /* The deletion was to our left. We need to adjust the center value
2350 to account for the change in position, but the lists are consistent
2351 given the new value. */
2352 XSETFASTINT (current_buffer
->overlay_center
,
2353 XFASTINT (current_buffer
->overlay_center
) - length
);
2355 /* We're right in the middle. There might be things on the after-list
2356 that now belong on the before-list. Recentering will move them,
2357 and also update the center point. */
2358 recenter_overlay_lists (current_buffer
, pos
);
2361 /* Fix up overlays that were garbled as a result of permuting markers
2362 in the range START through END. Any overlay with at least one
2363 endpoint in this range will need to be unlinked from the overlay
2364 list and reinserted in its proper place.
2365 Such an overlay might even have negative size at this point.
2366 If so, we'll reverse the endpoints. Can you think of anything
2367 better to do in this situation? */
2369 fix_overlays_in_range (start
, end
)
2370 register int start
, end
;
2372 Lisp_Object tem
, overlay
;
2373 Lisp_Object before_list
, after_list
;
2374 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2375 int startpos
, endpos
;
2377 /* This algorithm shifts links around instead of consing and GCing.
2378 The loop invariant is that before_list (resp. after_list) is a
2379 well-formed list except that its last element, the one that
2380 *pbefore (resp. *pafter) points to, is still uninitialized.
2381 So it's not a bug that before_list isn't initialized, although
2382 it may look strange. */
2383 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2385 overlay
= XCONS (*ptail
)->car
;
2386 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2389 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2391 || (startpos
>= start
&& startpos
< end
))
2393 /* If the overlay is backwards, fix that now. */
2394 if (startpos
> endpos
)
2397 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2398 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2399 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2401 /* Add it to the end of the wrong list. Later on,
2402 recenter_overlay_lists will move it to the right place. */
2403 if (endpos
< XINT (current_buffer
->overlay_center
))
2406 pafter
= &XCONS (*ptail
)->cdr
;
2411 pbefore
= &XCONS (*ptail
)->cdr
;
2413 *ptail
= XCONS (*ptail
)->cdr
;
2416 ptail
= &XCONS (*ptail
)->cdr
;
2418 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2420 overlay
= XCONS (*ptail
)->car
;
2421 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2422 if (startpos
>= end
)
2424 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2425 if (startpos
>= start
2426 || (endpos
>= start
&& endpos
< end
))
2428 if (startpos
> endpos
)
2431 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2432 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2433 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2435 if (endpos
< XINT (current_buffer
->overlay_center
))
2438 pafter
= &XCONS (*ptail
)->cdr
;
2443 pbefore
= &XCONS (*ptail
)->cdr
;
2445 *ptail
= XCONS (*ptail
)->cdr
;
2448 ptail
= &XCONS (*ptail
)->cdr
;
2451 /* Splice the constructed (wrong) lists into the buffer's lists,
2452 and let the recenter function make it sane again. */
2453 *pbefore
= current_buffer
->overlays_before
;
2454 current_buffer
->overlays_before
= before_list
;
2455 recenter_overlay_lists (current_buffer
,
2456 XINT (current_buffer
->overlay_center
));
2458 *pafter
= current_buffer
->overlays_after
;
2459 current_buffer
->overlays_after
= after_list
;
2460 recenter_overlay_lists (current_buffer
,
2461 XINT (current_buffer
->overlay_center
));
2464 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2465 "Return t if OBJECT is an overlay.")
2469 return (OVERLAYP (object
) ? Qt
: Qnil
);
2472 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
2473 "Create a new overlay with range BEG to END in BUFFER.\n\
2474 If omitted, BUFFER defaults to the current buffer.\n\
2475 BEG and END may be integers or markers.")
2477 Lisp_Object beg
, end
, buffer
;
2479 Lisp_Object overlay
;
2483 XSETBUFFER (buffer
, current_buffer
);
2485 CHECK_BUFFER (buffer
, 2);
2487 && ! EQ (Fmarker_buffer (beg
), buffer
))
2488 error ("Marker points into wrong buffer");
2490 && ! EQ (Fmarker_buffer (end
), buffer
))
2491 error ("Marker points into wrong buffer");
2493 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2494 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2496 if (XINT (beg
) > XINT (end
))
2499 temp
= beg
; beg
= end
; end
= temp
;
2502 b
= XBUFFER (buffer
);
2504 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2505 end
= Fset_marker (Fmake_marker (), end
, buffer
);
2507 XMARKER (end
)->insertion_type
= 1;
2509 overlay
= allocate_misc ();
2510 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
2511 XOVERLAY (overlay
)->start
= beg
;
2512 XOVERLAY (overlay
)->end
= end
;
2513 XOVERLAY (overlay
)->plist
= Qnil
;
2515 /* Put the new overlay on the wrong list. */
2516 end
= OVERLAY_END (overlay
);
2517 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2518 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2520 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2522 /* This puts it in the right list, and in the right order. */
2523 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2525 /* We don't need to redisplay the region covered by the overlay, because
2526 the overlay has no properties at the moment. */
2531 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
2532 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
2533 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
2534 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
2536 (overlay
, beg
, end
, buffer
)
2537 Lisp_Object overlay
, beg
, end
, buffer
;
2539 struct buffer
*b
, *ob
;
2540 Lisp_Object obuffer
;
2541 int count
= specpdl_ptr
- specpdl
;
2543 CHECK_OVERLAY (overlay
, 0);
2545 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2547 XSETBUFFER (buffer
, current_buffer
);
2548 CHECK_BUFFER (buffer
, 3);
2551 && ! EQ (Fmarker_buffer (beg
), buffer
))
2552 error ("Marker points into wrong buffer");
2554 && ! EQ (Fmarker_buffer (end
), buffer
))
2555 error ("Marker points into wrong buffer");
2557 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2558 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2560 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
2561 return Fdelete_overlay (overlay
);
2563 if (XINT (beg
) > XINT (end
))
2566 temp
= beg
; beg
= end
; end
= temp
;
2569 specbind (Qinhibit_quit
, Qt
);
2571 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2572 b
= XBUFFER (buffer
);
2573 ob
= XBUFFER (obuffer
);
2575 /* If the overlay has changed buffers, do a thorough redisplay. */
2576 if (!EQ (buffer
, obuffer
))
2578 /* Redisplay where the overlay was. */
2579 if (!NILP (obuffer
))
2584 o_beg
= OVERLAY_START (overlay
);
2585 o_end
= OVERLAY_END (overlay
);
2586 o_beg
= OVERLAY_POSITION (o_beg
);
2587 o_end
= OVERLAY_POSITION (o_end
);
2589 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
2592 /* Redisplay where the overlay is going to be. */
2593 redisplay_region (b
, XINT (beg
), XINT (end
));
2596 /* Redisplay the area the overlay has just left, or just enclosed. */
2600 int change_beg
, change_end
;
2602 o_beg
= OVERLAY_START (overlay
);
2603 o_end
= OVERLAY_END (overlay
);
2604 o_beg
= OVERLAY_POSITION (o_beg
);
2605 o_end
= OVERLAY_POSITION (o_end
);
2607 if (XINT (o_beg
) == XINT (beg
))
2608 redisplay_region (b
, XINT (o_end
), XINT (end
));
2609 else if (XINT (o_end
) == XINT (end
))
2610 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
2613 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
2614 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
2615 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
2619 if (!NILP (obuffer
))
2621 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
2622 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
2625 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
2626 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
2628 /* Put the overlay on the wrong list. */
2629 end
= OVERLAY_END (overlay
);
2630 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2631 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2633 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2635 /* This puts it in the right list, and in the right order. */
2636 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2638 return unbind_to (count
, overlay
);
2641 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
2642 "Delete the overlay OVERLAY from its buffer.")
2644 Lisp_Object overlay
;
2648 int count
= specpdl_ptr
- specpdl
;
2650 CHECK_OVERLAY (overlay
, 0);
2652 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2656 b
= XBUFFER (buffer
);
2658 specbind (Qinhibit_quit
, Qt
);
2660 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
2661 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2663 redisplay_region (b
,
2664 marker_position (OVERLAY_START (overlay
)),
2665 marker_position (OVERLAY_END (overlay
)));
2667 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2668 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2670 return unbind_to (count
, Qnil
);
2673 /* Overlay dissection functions. */
2675 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2676 "Return the position at which OVERLAY starts.")
2678 Lisp_Object overlay
;
2680 CHECK_OVERLAY (overlay
, 0);
2682 return (Fmarker_position (OVERLAY_START (overlay
)));
2685 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2686 "Return the position at which OVERLAY ends.")
2688 Lisp_Object overlay
;
2690 CHECK_OVERLAY (overlay
, 0);
2692 return (Fmarker_position (OVERLAY_END (overlay
)));
2695 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2696 "Return the buffer OVERLAY belongs to.")
2698 Lisp_Object overlay
;
2700 CHECK_OVERLAY (overlay
, 0);
2702 return Fmarker_buffer (OVERLAY_START (overlay
));
2705 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2706 "Return a list of the properties on OVERLAY.\n\
2707 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2710 Lisp_Object overlay
;
2712 CHECK_OVERLAY (overlay
, 0);
2714 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
2718 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2719 "Return a list of the overlays that contain position POS.")
2724 Lisp_Object
*overlay_vec
;
2728 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2731 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2733 /* Put all the overlays we want in a vector in overlay_vec.
2734 Store the length in len. */
2735 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2736 (int *) 0, (int *) 0);
2738 /* Make a list of them all. */
2739 result
= Flist (noverlays
, overlay_vec
);
2741 xfree (overlay_vec
);
2745 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
2746 "Return a list of the overlays that overlap the region BEG ... END.\n\
2747 Overlap means that at least one character is contained within the overlay\n\
2748 and also contained within the specified region.\n\
2749 Empty overlays are included in the result if they are located at BEG\n\
2750 or between BEG and END.")
2752 Lisp_Object beg
, end
;
2755 Lisp_Object
*overlay_vec
;
2759 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
2760 CHECK_NUMBER_COERCE_MARKER (end
, 0);
2763 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2765 /* Put all the overlays we want in a vector in overlay_vec.
2766 Store the length in len. */
2767 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
2768 (int *) 0, (int *) 0);
2770 /* Make a list of them all. */
2771 result
= Flist (noverlays
, overlay_vec
);
2773 xfree (overlay_vec
);
2777 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2779 "Return the next position after POS where an overlay starts or ends.\n\
2780 If there are no more overlay boundaries after POS, return (point-max).")
2786 Lisp_Object
*overlay_vec
;
2790 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2793 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2795 /* Put all the overlays we want in a vector in overlay_vec.
2796 Store the length in len.
2797 endpos gets the position where the next overlay starts. */
2798 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2799 &endpos
, (int *) 0);
2801 /* If any of these overlays ends before endpos,
2802 use its ending point instead. */
2803 for (i
= 0; i
< noverlays
; i
++)
2808 oend
= OVERLAY_END (overlay_vec
[i
]);
2809 oendpos
= OVERLAY_POSITION (oend
);
2810 if (oendpos
< endpos
)
2814 xfree (overlay_vec
);
2815 return make_number (endpos
);
2818 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2819 Sprevious_overlay_change
, 1, 1, 0,
2820 "Return the previous position before POS where an overlay starts or ends.\n\
2821 If there are no more overlay boundaries before POS, return (point-min).")
2827 Lisp_Object
*overlay_vec
;
2832 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2835 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2837 /* At beginning of buffer, we know the answer;
2838 avoid bug subtracting 1 below. */
2839 if (XINT (pos
) == BEGV
)
2842 /* Put all the overlays we want in a vector in overlay_vec.
2843 Store the length in len.
2844 prevpos gets the position of an overlay end. */
2845 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2846 (int *) 0, &prevpos
);
2848 /* If any of these overlays starts after prevpos,
2849 maybe use its starting point instead. */
2850 for (i
= 0; i
< noverlays
; i
++)
2855 ostart
= OVERLAY_START (overlay_vec
[i
]);
2856 ostartpos
= OVERLAY_POSITION (ostart
);
2857 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2858 prevpos
= ostartpos
;
2861 /* If any overlay ends at pos, consider its starting point too. */
2862 for (tail
= current_buffer
->overlays_before
;
2864 tail
= XCONS (tail
)->cdr
)
2866 Lisp_Object overlay
, ostart
;
2869 overlay
= XCONS (tail
)->car
;
2871 ostart
= OVERLAY_START (overlay
);
2872 ostartpos
= OVERLAY_POSITION (ostart
);
2873 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2874 prevpos
= ostartpos
;
2877 xfree (overlay_vec
);
2878 return make_number (prevpos
);
2881 /* These functions are for debugging overlays. */
2883 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2884 "Return a pair of lists giving all the overlays of the current buffer.\n\
2885 The car has all the overlays before the overlay center;\n\
2886 the cdr has all the overlays after the overlay center.\n\
2887 Recentering overlays moves overlays between these lists.\n\
2888 The lists you get are copies, so that changing them has no effect.\n\
2889 However, the overlays you get are the real objects that the buffer uses.")
2892 Lisp_Object before
, after
;
2893 before
= current_buffer
->overlays_before
;
2895 before
= Fcopy_sequence (before
);
2896 after
= current_buffer
->overlays_after
;
2898 after
= Fcopy_sequence (after
);
2900 return Fcons (before
, after
);
2903 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2904 "Recenter the overlays of the current buffer around position POS.")
2908 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2910 recenter_overlay_lists (current_buffer
, XINT (pos
));
2914 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2915 "Get the property of overlay OVERLAY with property name NAME.")
2917 Lisp_Object overlay
, prop
;
2919 Lisp_Object plist
, fallback
;
2921 CHECK_OVERLAY (overlay
, 0);
2925 for (plist
= XOVERLAY (overlay
)->plist
;
2926 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2927 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2929 if (EQ (XCONS (plist
)->car
, prop
))
2930 return XCONS (XCONS (plist
)->cdr
)->car
;
2931 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2934 tem
= Fcar (Fcdr (plist
));
2936 fallback
= Fget (tem
, prop
);
2943 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2944 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2945 (overlay
, prop
, value
)
2946 Lisp_Object overlay
, prop
, value
;
2948 Lisp_Object tail
, buffer
;
2951 CHECK_OVERLAY (overlay
, 0);
2953 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2955 for (tail
= XOVERLAY (overlay
)->plist
;
2956 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2957 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2958 if (EQ (XCONS (tail
)->car
, prop
))
2960 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2961 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2964 /* It wasn't in the list, so add it to the front. */
2965 changed
= !NILP (value
);
2966 XOVERLAY (overlay
)->plist
2967 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
2969 if (! NILP (buffer
))
2972 redisplay_region (XBUFFER (buffer
),
2973 marker_position (OVERLAY_START (overlay
)),
2974 marker_position (OVERLAY_END (overlay
)));
2975 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2976 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2977 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2978 Fdelete_overlay (overlay
);
2983 /* Subroutine of report_overlay_modification. */
2985 /* Lisp vector holding overlay hook functions to call.
2986 Vector elements come in pairs.
2987 Each even-index element is a list of hook functions.
2988 The following odd-index element is the overlay they came from.
2990 Before the buffer change, we fill in this vector
2991 as we call overlay hook functions.
2992 After the buffer change, we get the functions to call from this vector.
2993 This way we always call the same functions before and after the change. */
2994 static Lisp_Object last_overlay_modification_hooks
;
2996 /* Number of elements actually used in last_overlay_modification_hooks. */
2997 static int last_overlay_modification_hooks_used
;
2999 /* Add one functionlist/overlay pair
3000 to the end of last_overlay_modification_hooks. */
3003 add_overlay_mod_hooklist (functionlist
, overlay
)
3004 Lisp_Object functionlist
, overlay
;
3006 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3008 if (last_overlay_modification_hooks_used
== oldsize
)
3011 old
= last_overlay_modification_hooks
;
3012 last_overlay_modification_hooks
3013 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3014 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3015 XVECTOR (old
)->contents
,
3016 sizeof (Lisp_Object
) * oldsize
);
3018 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3019 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3022 /* Run the modification-hooks of overlays that include
3023 any part of the text in START to END.
3024 If this change is an insertion, also
3025 run the insert-before-hooks of overlay starting at END,
3026 and the insert-after-hooks of overlay ending at START.
3028 This is called both before and after the modification.
3029 AFTER is nonzero when we call after the modification.
3031 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3032 When AFTER is nonzero, they are the start position,
3033 the position after the inserted new text,
3034 and the length of deleted or replaced old text. */
3037 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3038 Lisp_Object start
, end
;
3040 Lisp_Object arg1
, arg2
, arg3
;
3042 Lisp_Object prop
, overlay
, tail
;
3043 /* 1 if this change is an insertion. */
3044 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3046 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3050 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3054 /* Call the functions recorded in last_overlay_modification_hooks
3055 rather than scanning the overlays again.
3056 First copy the vector contents, in case some of these hooks
3057 do subsequent modification of the buffer. */
3058 int size
= last_overlay_modification_hooks_used
;
3059 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3062 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3063 copy
, size
* sizeof (Lisp_Object
));
3065 gcpro1
.nvars
= size
;
3067 for (i
= 0; i
< size
;)
3069 Lisp_Object prop
, overlay
;
3071 overlay
= copy
[i
++];
3072 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3078 /* We are being called before a change.
3079 Scan the overlays to find the functions to call. */
3080 last_overlay_modification_hooks_used
= 0;
3082 for (tail
= current_buffer
->overlays_before
;
3084 tail
= XCONS (tail
)->cdr
)
3086 int startpos
, endpos
;
3087 Lisp_Object ostart
, oend
;
3089 overlay
= XCONS (tail
)->car
;
3091 ostart
= OVERLAY_START (overlay
);
3092 oend
= OVERLAY_END (overlay
);
3093 endpos
= OVERLAY_POSITION (oend
);
3094 if (XFASTINT (start
) > endpos
)
3096 startpos
= OVERLAY_POSITION (ostart
);
3097 if (insertion
&& (XFASTINT (start
) == startpos
3098 || XFASTINT (end
) == startpos
))
3100 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3103 /* Copy TAIL in case the hook recenters the overlay lists. */
3105 tail
= Fcopy_sequence (tail
);
3107 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3110 if (insertion
&& (XFASTINT (start
) == endpos
3111 || XFASTINT (end
) == endpos
))
3113 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3117 tail
= Fcopy_sequence (tail
);
3119 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3122 /* Test for intersecting intervals. This does the right thing
3123 for both insertion and deletion. */
3124 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3126 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3130 tail
= Fcopy_sequence (tail
);
3132 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3138 for (tail
= current_buffer
->overlays_after
;
3140 tail
= XCONS (tail
)->cdr
)
3142 int startpos
, endpos
;
3143 Lisp_Object ostart
, oend
;
3145 overlay
= XCONS (tail
)->car
;
3147 ostart
= OVERLAY_START (overlay
);
3148 oend
= OVERLAY_END (overlay
);
3149 startpos
= OVERLAY_POSITION (ostart
);
3150 endpos
= OVERLAY_POSITION (oend
);
3151 if (XFASTINT (end
) < startpos
)
3153 if (insertion
&& (XFASTINT (start
) == startpos
3154 || XFASTINT (end
) == startpos
))
3156 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3160 tail
= Fcopy_sequence (tail
);
3162 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3165 if (insertion
&& (XFASTINT (start
) == endpos
3166 || XFASTINT (end
) == endpos
))
3168 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3172 tail
= Fcopy_sequence (tail
);
3174 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3177 /* Test for intersecting intervals. This does the right thing
3178 for both insertion and deletion. */
3179 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3181 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3185 tail
= Fcopy_sequence (tail
);
3187 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3196 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3197 Lisp_Object list
, overlay
;
3199 Lisp_Object arg1
, arg2
, arg3
;
3201 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3203 GCPRO4 (list
, arg1
, arg2
, arg3
);
3205 add_overlay_mod_hooklist (list
, overlay
);
3207 while (!NILP (list
))
3210 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3212 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3218 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3221 evaporate_overlays (pos
)
3224 Lisp_Object tail
, overlay
, hit_list
;
3227 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3228 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3229 tail
= XCONS (tail
)->cdr
)
3232 overlay
= XCONS (tail
)->car
;
3233 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3236 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3237 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3238 hit_list
= Fcons (overlay
, hit_list
);
3241 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3242 tail
= XCONS (tail
)->cdr
)
3245 overlay
= XCONS (tail
)->car
;
3246 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3249 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3250 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3251 hit_list
= Fcons (overlay
, hit_list
);
3253 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3254 Fdelete_overlay (XCONS (hit_list
)->car
);
3257 /* Somebody has tried to store a value with an unacceptable type
3258 into the buffer-local slot with offset OFFSET. */
3260 buffer_slot_type_mismatch (offset
)
3265 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3266 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3268 case Lisp_Int
: type_name
= "integers"; break;
3269 case Lisp_String
: type_name
= "strings"; break;
3270 case Lisp_Symbol
: type_name
= "symbols"; break;
3275 error ("only %s should be stored in the buffer-local variable %s",
3276 type_name
, XSYMBOL (sym
)->name
->data
);
3281 register Lisp_Object tem
;
3283 /* Make sure all markable slots in buffer_defaults
3284 are initialized reasonably, so mark_buffer won't choke. */
3285 reset_buffer (&buffer_defaults
);
3286 reset_buffer_local_variables (&buffer_defaults
);
3287 reset_buffer (&buffer_local_symbols
);
3288 reset_buffer_local_variables (&buffer_local_symbols
);
3289 /* Prevent GC from getting confused. */
3290 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3291 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3292 #ifdef USE_TEXT_PROPERTIES
3293 BUF_INTERVALS (&buffer_defaults
) = 0;
3294 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3296 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3297 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3299 /* Set up the default values of various buffer slots. */
3300 /* Must do these before making the first buffer! */
3302 /* real setup is done in loaddefs.el */
3303 buffer_defaults
.mode_line_format
= build_string ("%-");
3304 buffer_defaults
.abbrev_mode
= Qnil
;
3305 buffer_defaults
.overwrite_mode
= Qnil
;
3306 buffer_defaults
.case_fold_search
= Qt
;
3307 buffer_defaults
.auto_fill_function
= Qnil
;
3308 buffer_defaults
.selective_display
= Qnil
;
3310 buffer_defaults
.selective_display_ellipses
= Qt
;
3312 buffer_defaults
.abbrev_table
= Qnil
;
3313 buffer_defaults
.display_table
= Qnil
;
3314 buffer_defaults
.undo_list
= Qnil
;
3315 buffer_defaults
.mark_active
= Qnil
;
3316 buffer_defaults
.file_format
= Qnil
;
3317 buffer_defaults
.overlays_before
= Qnil
;
3318 buffer_defaults
.overlays_after
= Qnil
;
3319 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3321 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3322 buffer_defaults
.truncate_lines
= Qnil
;
3323 buffer_defaults
.ctl_arrow
= Qt
;
3326 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3328 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3329 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3330 buffer_defaults
.cache_long_line_scans
= Qnil
;
3331 buffer_defaults
.file_truename
= Qnil
;
3333 /* Assign the local-flags to the slots that have default values.
3334 The local flag is a bit that is used in the buffer
3335 to say that it has its own local value for the slot.
3336 The local flag bits are in the local_var_flags slot of the buffer. */
3338 /* Nothing can work if this isn't true */
3339 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3341 /* 0 means not a lisp var, -1 means always local, else mask */
3342 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3343 XSETINT (buffer_local_flags
.filename
, -1);
3344 XSETINT (buffer_local_flags
.directory
, -1);
3345 XSETINT (buffer_local_flags
.backed_up
, -1);
3346 XSETINT (buffer_local_flags
.save_length
, -1);
3347 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3348 XSETINT (buffer_local_flags
.read_only
, -1);
3349 XSETINT (buffer_local_flags
.major_mode
, -1);
3350 XSETINT (buffer_local_flags
.mode_name
, -1);
3351 XSETINT (buffer_local_flags
.undo_list
, -1);
3352 XSETINT (buffer_local_flags
.mark_active
, -1);
3353 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3354 XSETINT (buffer_local_flags
.file_truename
, -1);
3355 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3356 XSETFASTINT (buffer_local_flags
.file_format
, -1);
3358 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3359 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3360 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3361 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3362 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3363 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3365 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3367 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3368 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3369 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3370 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3371 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3372 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3373 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3374 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3375 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3377 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3380 Vbuffer_alist
= Qnil
;
3384 QSFundamental
= build_string ("Fundamental");
3386 Qfundamental_mode
= intern ("fundamental-mode");
3387 buffer_defaults
.major_mode
= Qfundamental_mode
;
3389 Qmode_class
= intern ("mode-class");
3391 Qprotected_field
= intern ("protected-field");
3393 Qpermanent_local
= intern ("permanent-local");
3395 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3397 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3398 /* super-magic invisible buffer */
3399 Vbuffer_alist
= Qnil
;
3401 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3406 char buf
[MAXPATHLEN
+1];
3408 struct stat dotstat
, pwdstat
;
3412 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3414 /* If PWD is accurate, use it instead of calling getwd. This is faster
3415 when PWD is right, and may avoid a fatal error. */
3416 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
3417 && stat (pwd
, &pwdstat
) == 0
3418 && stat (".", &dotstat
) == 0
3419 && dotstat
.st_ino
== pwdstat
.st_ino
3420 && dotstat
.st_dev
== pwdstat
.st_dev
3421 && strlen (pwd
) < MAXPATHLEN
)
3423 else if (getwd (buf
) == 0)
3424 fatal ("`getwd' failed: %s\n", buf
);
3427 /* Maybe this should really use some standard subroutine
3428 whose definition is filename syntax dependent. */
3430 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
3432 buf
[rc
] = DIRECTORY_SEP
;
3435 #endif /* not VMS */
3436 current_buffer
->directory
= build_string (buf
);
3438 temp
= get_minibuffer (0);
3439 XBUFFER (temp
)->directory
= current_buffer
->directory
;
3442 /* initialize the buffer routines */
3445 extern Lisp_Object Qdisabled
;
3447 staticpro (&last_overlay_modification_hooks
);
3448 last_overlay_modification_hooks
3449 = Fmake_vector (make_number (10), Qnil
);
3451 staticpro (&Vbuffer_defaults
);
3452 staticpro (&Vbuffer_local_symbols
);
3453 staticpro (&Qfundamental_mode
);
3454 staticpro (&Qmode_class
);
3455 staticpro (&QSFundamental
);
3456 staticpro (&Vbuffer_alist
);
3457 staticpro (&Qprotected_field
);
3458 staticpro (&Qpermanent_local
);
3459 staticpro (&Qkill_buffer_hook
);
3460 Qoverlayp
= intern ("overlayp");
3461 staticpro (&Qoverlayp
);
3462 Qevaporate
= intern ("evaporate");
3463 staticpro (&Qevaporate
);
3464 Qmodification_hooks
= intern ("modification-hooks");
3465 staticpro (&Qmodification_hooks
);
3466 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
3467 staticpro (&Qinsert_in_front_hooks
);
3468 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
3469 staticpro (&Qinsert_behind_hooks
);
3470 Qget_file_buffer
= intern ("get-file-buffer");
3471 staticpro (&Qget_file_buffer
);
3472 Qpriority
= intern ("priority");
3473 staticpro (&Qpriority
);
3474 Qwindow
= intern ("window");
3475 staticpro (&Qwindow
);
3476 Qbefore_string
= intern ("before-string");
3477 staticpro (&Qbefore_string
);
3478 Qafter_string
= intern ("after-string");
3479 staticpro (&Qafter_string
);
3480 Qfirst_change_hook
= intern ("first-change-hook");
3481 staticpro (&Qfirst_change_hook
);
3482 Qbefore_change_functions
= intern ("before-change-functions");
3483 staticpro (&Qbefore_change_functions
);
3484 Qafter_change_functions
= intern ("after-change-functions");
3485 staticpro (&Qafter_change_functions
);
3487 Fput (Qprotected_field
, Qerror_conditions
,
3488 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
3489 Fput (Qprotected_field
, Qerror_message
,
3490 build_string ("Attempt to modify a protected field"));
3492 /* All these use DEFVAR_LISP_NOPRO because the slots in
3493 buffer_defaults will all be marked via Vbuffer_defaults. */
3495 DEFVAR_LISP_NOPRO ("default-mode-line-format",
3496 &buffer_defaults
.mode_line_format
,
3497 "Default value of `mode-line-format' for buffers that don't override it.\n\
3498 This is the same as (default-value 'mode-line-format).");
3500 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
3501 &buffer_defaults
.abbrev_mode
,
3502 "Default value of `abbrev-mode' for buffers that do not override it.\n\
3503 This is the same as (default-value 'abbrev-mode).");
3505 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
3506 &buffer_defaults
.ctl_arrow
,
3507 "Default value of `ctl-arrow' for buffers that do not override it.\n\
3508 This is the same as (default-value 'ctl-arrow).");
3510 DEFVAR_LISP_NOPRO ("default-truncate-lines",
3511 &buffer_defaults
.truncate_lines
,
3512 "Default value of `truncate-lines' for buffers that do not override it.\n\
3513 This is the same as (default-value 'truncate-lines).");
3515 DEFVAR_LISP_NOPRO ("default-fill-column",
3516 &buffer_defaults
.fill_column
,
3517 "Default value of `fill-column' for buffers that do not override it.\n\
3518 This is the same as (default-value 'fill-column).");
3520 DEFVAR_LISP_NOPRO ("default-left-margin",
3521 &buffer_defaults
.left_margin
,
3522 "Default value of `left-margin' for buffers that do not override it.\n\
3523 This is the same as (default-value 'left-margin).");
3525 DEFVAR_LISP_NOPRO ("default-tab-width",
3526 &buffer_defaults
.tab_width
,
3527 "Default value of `tab-width' for buffers that do not override it.\n\
3528 This is the same as (default-value 'tab-width).");
3530 DEFVAR_LISP_NOPRO ("default-case-fold-search",
3531 &buffer_defaults
.case_fold_search
,
3532 "Default value of `case-fold-search' for buffers that don't override it.\n\
3533 This is the same as (default-value 'case-fold-search).");
3536 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
3537 &buffer_defaults
.buffer_file_type
,
3538 "Default file type for buffers that do not override it.\n\
3539 This is the same as (default-value 'buffer-file-type).\n\
3540 The file type is nil for text, t for binary.");
3543 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
3546 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
3547 But make-docfile finds it!
3548 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
3550 "Template for displaying mode line for current buffer.\n\
3551 Each buffer has its own value of this variable.\n\
3552 Value may be a string, a symbol or a list or cons cell.\n\
3553 For a symbol, its value is used (but it is ignored if t or nil).\n\
3554 A string appearing directly as the value of a symbol is processed verbatim\n\
3555 in that the %-constructs below are not recognized.\n\
3556 For a list whose car is a symbol, the symbol's value is taken,\n\
3557 and if that is non-nil, the cadr of the list is processed recursively.\n\
3558 Otherwise, the caddr of the list (if there is one) is processed.\n\
3559 For a list whose car is a string or list, each element is processed\n\
3560 recursively and the results are effectively concatenated.\n\
3561 For a list whose car is an integer, the cdr of the list is processed\n\
3562 and padded (if the number is positive) or truncated (if negative)\n\
3563 to the width specified by that number.\n\
3564 A string is printed verbatim in the mode line except for %-constructs:\n\
3565 (%-constructs are allowed when the string is the entire mode-line-format\n\
3566 or when it is found in a cons-cell or a list)\n\
3567 %b -- print buffer name. %f -- print visited file name.\n\
3568 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
3569 % means buffer is read-only and * means it is modified.\n\
3570 For a modified read-only buffer, %* gives % and %+ gives *.\n\
3571 %s -- print process status. %l -- print the current line number.\n\
3572 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
3573 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
3574 or print Bottom or All.\n\
3575 %n -- print Narrow if appropriate.\n\
3576 %t -- print T if files is text, B if binary.\n\
3577 %[ -- print one [ for each recursive editing level. %] similar.\n\
3578 %% -- print %. %- -- print infinitely many dashes.\n\
3579 Decimal digits after the % specify field width to which to pad.");
3582 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
3583 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
3584 nil here means use current buffer's major mode.");
3586 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
3587 make_number (Lisp_Symbol
),
3588 "Symbol for current buffer's major mode.");
3590 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
3591 make_number (Lisp_String
),
3592 "Pretty name of current buffer's major mode (a string).");
3594 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
3595 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
3596 Automatically becomes buffer-local when set in any fashion.");
3598 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
3600 "*Non-nil if searches should ignore case.\n\
3601 Automatically becomes buffer-local when set in any fashion.");
3603 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
3604 make_number (Lisp_Int
),
3605 "*Column beyond which automatic line-wrapping should happen.\n\
3606 Automatically becomes buffer-local when set in any fashion.");
3608 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
3609 make_number (Lisp_Int
),
3610 "*Column for the default indent-line-function to indent to.\n\
3611 Linefeed indents to this column in Fundamental mode.\n\
3612 Automatically becomes buffer-local when set in any fashion.");
3614 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
3615 make_number (Lisp_Int
),
3616 "*Distance between tab stops (for display of tab characters), in columns.\n\
3617 Automatically becomes buffer-local when set in any fashion.");
3619 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
3620 "*Non-nil means display control chars with uparrow.\n\
3621 Nil means use backslash and octal digits.\n\
3622 Automatically becomes buffer-local when set in any fashion.\n\
3623 This variable does not apply to characters whose display is specified\n\
3624 in the current display table (if there is one).");
3626 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
3627 "*Non-nil means do not display continuation lines;\n\
3628 give each line of text one screen line.\n\
3629 Automatically becomes buffer-local when set in any fashion.\n\
3631 Note that this is overridden by the variable\n\
3632 `truncate-partial-width-windows' if that variable is non-nil\n\
3633 and this buffer is not full-frame width.");
3636 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
3638 "Non-nil if the visited file is a binary file.\n\
3639 This variable is meaningful on MS-DOG and Windows NT.\n\
3640 On those systems, it is automatically local in every buffer.\n\
3641 On other systems, this variable is normally always nil.");
3644 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
3645 make_number (Lisp_String
),
3646 "Name of default directory of current buffer. Should end with slash.\n\
3647 Each buffer has its own value of this variable.");
3649 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
3651 "Function called (if non-nil) to perform auto-fill.\n\
3652 It is called after self-inserting a space at a column beyond `fill-column'.\n\
3653 Each buffer has its own value of this variable.\n\
3654 NOTE: This variable is not an ordinary hook;\n\
3655 It may not be a list of functions.");
3657 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
3658 make_number (Lisp_String
),
3659 "Name of file visited in current buffer, or nil if not visiting a file.\n\
3660 Each buffer has its own value of this variable.");
3662 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
3663 make_number (Lisp_String
),
3664 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
3665 The truename of a file is calculated by `file-truename'\n\
3666 and then abbreviated with `abbreviate-file-name'.\n\
3667 Each buffer has its own value of this variable.");
3669 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
3670 ¤t_buffer
->auto_save_file_name
,
3671 make_number (Lisp_String
),
3672 "Name of file for auto-saving current buffer,\n\
3673 or nil if buffer should not be auto-saved.\n\
3674 Each buffer has its own value of this variable.");
3676 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
3677 "Non-nil if this buffer is read-only.\n\
3678 Each buffer has its own value of this variable.");
3680 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
3681 "Non-nil if this buffer's file has been backed up.\n\
3682 Backing up is done before the first time the file is saved.\n\
3683 Each buffer has its own value of this variable.");
3685 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
3686 make_number (Lisp_Int
),
3687 "Length of current buffer when last read in, saved or auto-saved.\n\
3689 Each buffer has its own value of this variable.");
3691 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
3693 "Non-nil enables selective display:\n\
3694 Integer N as value means display only lines\n\
3695 that start with less than n columns of space.\n\
3696 A value of t means, after a ^M, all the rest of the line is invisible.\n\
3697 Then ^M's in the file are written into files as newlines.\n\n\
3698 Automatically becomes buffer-local when set in any fashion.");
3701 DEFVAR_PER_BUFFER ("selective-display-ellipses",
3702 ¤t_buffer
->selective_display_ellipses
,
3704 "t means display ... on previous line when a line is invisible.\n\
3705 Automatically becomes buffer-local when set in any fashion.");
3708 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
3709 "Non-nil if self-insertion should replace existing text.\n\
3710 The value should be one of `overwrite-mode-textual',\n\
3711 `overwrite-mode-binary', or nil.\n\
3712 If it is `overwrite-mode-textual', self-insertion still\n\
3713 inserts at the end of a line, and inserts when point is before a tab,\n\
3714 until the tab is filled in.\n\
3715 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
3716 Automatically becomes buffer-local when set in any fashion.");
3718 #if 0 /* The doc string is too long for some compilers,
3719 but make-docfile can find it in this comment. */
3720 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3722 "Display table that controls display of the contents of current buffer.\n\
3723 Automatically becomes buffer-local when set in any fashion.\n\
3724 The display table is a char-table created with `make-display-table'.\n\
3725 The ordinary char-table elements control how to display each possible text\n\
3726 character. Each value should be a vector of characters or nil;\n\
3727 nil means display the character in the default fashion.\n\
3728 There are six extra slots to control the display of\n\
3729 the end of a truncated screen line (extra-slot 0, a single character);\n\
3730 the end of a continued line (extra-slot 1, a single character);\n\
3731 the escape character used to display character codes in octal\n\
3732 (extra-slot 2, a single character);\n\
3733 the character used as an arrow for control characters (extra-slot 3,\n\
3734 a single character);\n\
3735 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
3736 a vector of characters);\n\
3737 the character used to draw the border between side-by-side windows\n\
3738 (extra-slot 5, a single character).\n\
3739 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
3740 If this variable is nil, the value of `standard-display-table' is used.\n\
3741 Each window can have its own, overriding display table.");
3743 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3746 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
3749 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
3750 "Function to call before each text change.\n\
3751 Two arguments are passed to the function: the positions of\n\
3752 the beginning and end of the range of old text to be changed.\n\
3753 \(For an insertion, the beginning and end are at the same place.)\n\
3754 No information is given about the length of the text after the change.\n\
3756 Buffer changes made while executing the `before-change-function'\n\
3757 don't call any before-change or after-change functions.\n\
3758 That's because these variables are temporarily set to nil.\n\
3759 As a result, a hook function cannot straightforwardly alter the value of\n\
3760 these variables. See the Emacs Lisp manual for a way of\n\
3761 accomplishing an equivalent result by using other variables.");
3762 Vbefore_change_function
= Qnil
;
3764 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
3765 "Function to call after each text change.\n\
3766 Three arguments are passed to the function: the positions of\n\
3767 the beginning and end of the range of changed text,\n\
3768 and the length of the pre-change text replaced by that range.\n\
3769 \(For an insertion, the pre-change length is zero;\n\
3770 for a deletion, that length is the number of characters deleted,\n\
3771 and the post-change beginning and end are at the same place.)\n\
3773 Buffer changes made while executing the `after-change-function'\n\
3774 don't call any before-change or after-change functions.\n\
3775 That's because these variables are temporarily set to nil.\n\
3776 As a result, a hook function cannot straightforwardly alter the value of\n\
3777 these variables. See the Emacs Lisp manual for a way of\n\
3778 accomplishing an equivalent result by using other variables.");
3779 Vafter_change_function
= Qnil
;
3781 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
3782 "List of functions to call before each text change.\n\
3783 Two arguments are passed to each function: the positions of\n\
3784 the beginning and end of the range of old text to be changed.\n\
3785 \(For an insertion, the beginning and end are at the same place.)\n\
3786 No information is given about the length of the text after the change.\n\
3788 Buffer changes made while executing the `before-change-functions'\n\
3789 don't call any before-change or after-change functions.\n\
3790 That's because these variables are temporarily set to nil.\n\
3791 As a result, a hook function cannot straightforwardly alter the value of\n\
3792 these variables. See the Emacs Lisp manual for a way of\n\
3793 accomplishing an equivalent result by using other variables.");
3794 Vbefore_change_functions
= Qnil
;
3796 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
3797 "List of function to call after each text change.\n\
3798 Three arguments are passed to each function: the positions of\n\
3799 the beginning and end of the range of changed text,\n\
3800 and the length of the pre-change text replaced by that range.\n\
3801 \(For an insertion, the pre-change length is zero;\n\
3802 for a deletion, that length is the number of characters deleted,\n\
3803 and the post-change beginning and end are at the same place.)\n\
3805 Buffer changes made while executing the `after-change-functions'\n\
3806 don't call any before-change or after-change functions.\n\
3807 That's because these variables are temporarily set to nil.\n\
3808 As a result, a hook function cannot straightforwardly alter the value of\n\
3809 these variables. See the Emacs Lisp manual for a way of\n\
3810 accomplishing an equivalent result by using other variables.");
3812 Vafter_change_functions
= Qnil
;
3814 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
3815 "A list of functions to call before changing a buffer which is unmodified.\n\
3816 The functions are run using the `run-hooks' function.");
3817 Vfirst_change_hook
= Qnil
;
3819 #if 0 /* The doc string is too long for some compilers,
3820 but make-docfile can find it in this comment. */
3821 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3822 "List of undo entries in current buffer.\n\
3823 Recent changes come first; older changes follow newer.\n\
3825 An entry (BEG . END) represents an insertion which begins at\n\
3826 position BEG and ends at position END.\n\
3828 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
3829 from (abs POSITION). If POSITION is positive, point was at the front\n\
3830 of the text being deleted; if negative, point was at the end.\n\
3832 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
3833 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
3834 of the visited file's modification time, as of that time. If the\n\
3835 modification time of the most recent save is different, this entry is\n\
3838 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
3839 was modified between BEG and END. PROPERTY is the property name,\n\
3840 and VALUE is the old value.\n\
3842 An entry of the form POSITION indicates that point was at the buffer\n\
3843 location given by the integer. Undoing an entry of this form places\n\
3844 point at POSITION.\n\
3846 nil marks undo boundaries. The undo command treats the changes\n\
3847 between two undo boundaries as a single step to be undone.\n\
3849 If the value of the variable is t, undo information is not recorded.");
3851 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3854 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3855 "Non-nil means the mark and region are currently active in this buffer.\n\
3856 Automatically local in all buffers.");
3858 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3859 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3860 This variable is buffer-local, in all buffers.\n\
3862 Normally, the line-motion functions work by scanning the buffer for\n\
3863 newlines. Columnar operations (like move-to-column and\n\
3864 compute-motion) also work by scanning the buffer, summing character\n\
3865 widths as they go. This works well for ordinary text, but if the\n\
3866 buffer's lines are very long (say, more than 500 characters), these\n\
3867 motion functions will take longer to execute. Emacs may also take\n\
3868 longer to update the display.\n\
3870 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3871 results of their scans, and consult the cache to avoid rescanning\n\
3872 regions of the buffer until the text is modified. The caches are most\n\
3873 beneficial when they prevent the most searching---that is, when the\n\
3874 buffer contains long lines and large regions of characters with the\n\
3875 same, fixed screen width.\n\
3877 When cache-long-line-scans is non-nil, processing short lines will\n\
3878 become slightly slower (because of the overhead of consulting the\n\
3879 cache), and the caches will use memory roughly proportional to the\n\
3880 number of newlines and characters whose screen width varies.\n\
3882 The caches require no explicit maintenance; their accuracy is\n\
3883 maintained internally by the Emacs primitives. Enabling or disabling\n\
3884 the cache should not affect the behavior of any of the motion\n\
3885 functions; it should only affect their performance.");
3887 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
3888 "Value of point before the last series of scroll operations, or nil.");
3890 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
3891 "List of formats to use when saving this buffer.\n\
3892 Formats are defined by `format-alist'. This variable is\n\
3893 set when a file is visited. Automatically local in all buffers.");
3895 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
3896 ¤t_buffer
->invisibility_spec
, Qnil
,
3897 "Invisibility spec of this buffer.\n\
3898 The default is t, which means that text is invisible\n\
3899 if it has a non-nil `invisible' property.\n\
3900 If the value is a list, a text character is invisible if its `invisible'\n\
3901 property is an element in that list.\n\
3902 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
3903 then characters with property value PROP are invisible,\n\
3904 and they have an ellipsis as well if ELLIPSIS is non-nil.");
3906 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3907 "*Non-nil means deactivate the mark when the buffer contents change.");
3908 Vtransient_mark_mode
= Qnil
;
3910 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3911 "*Non-nil means disregard read-only status of buffers or characters.\n\
3912 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3913 text properties. If the value is a list, disregard `buffer-read-only'\n\
3914 and disregard a `read-only' text property if the property value\n\
3915 is a member of the list.");
3916 Vinhibit_read_only
= Qnil
;
3918 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3919 "List of functions called with no args to query before killing a buffer.");
3920 Vkill_buffer_query_functions
= Qnil
;
3922 defsubr (&Sbuffer_list
);
3923 defsubr (&Sget_buffer
);
3924 defsubr (&Sget_file_buffer
);
3925 defsubr (&Sget_buffer_create
);
3926 defsubr (&Smake_indirect_buffer
);
3927 defsubr (&Sgenerate_new_buffer_name
);
3928 defsubr (&Sbuffer_name
);
3929 /*defsubr (&Sbuffer_number);*/
3930 defsubr (&Sbuffer_file_name
);
3931 defsubr (&Sbuffer_base_buffer
);
3932 defsubr (&Sbuffer_local_variables
);
3933 defsubr (&Sbuffer_modified_p
);
3934 defsubr (&Sset_buffer_modified_p
);
3935 defsubr (&Sbuffer_modified_tick
);
3936 defsubr (&Srename_buffer
);
3937 defsubr (&Sother_buffer
);
3938 defsubr (&Sbuffer_disable_undo
);
3939 defsubr (&Sbuffer_enable_undo
);
3940 defsubr (&Skill_buffer
);
3941 defsubr (&Serase_buffer
);
3942 defsubr (&Sset_buffer_major_mode
);
3943 defsubr (&Sswitch_to_buffer
);
3944 defsubr (&Spop_to_buffer
);
3945 defsubr (&Scurrent_buffer
);
3946 defsubr (&Sset_buffer
);
3947 defsubr (&Sbarf_if_buffer_read_only
);
3948 defsubr (&Sbury_buffer
);
3949 defsubr (&Skill_all_local_variables
);
3951 defsubr (&Soverlayp
);
3952 defsubr (&Smake_overlay
);
3953 defsubr (&Sdelete_overlay
);
3954 defsubr (&Smove_overlay
);
3955 defsubr (&Soverlay_start
);
3956 defsubr (&Soverlay_end
);
3957 defsubr (&Soverlay_buffer
);
3958 defsubr (&Soverlay_properties
);
3959 defsubr (&Soverlays_at
);
3960 defsubr (&Soverlays_in
);
3961 defsubr (&Snext_overlay_change
);
3962 defsubr (&Sprevious_overlay_change
);
3963 defsubr (&Soverlay_recenter
);
3964 defsubr (&Soverlay_lists
);
3965 defsubr (&Soverlay_get
);
3966 defsubr (&Soverlay_put
);
3971 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3972 initial_define_key (control_x_map
, 'k', "kill-buffer");
3974 /* This must not be in syms_of_buffer, because Qdisabled is not
3975 initialized when that function gets called. */
3976 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);