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, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include <sys/types.h>
25 #include <sys/param.h>
28 /* in 4.1, param.h fails to define this. */
29 #define MAXPATHLEN 1024
30 #endif /* not MAXPATHLEN */
34 #include "intervals.h"
38 #include "region-cache.h"
40 #include "blockinput.h"
42 struct buffer
*current_buffer
; /* the current buffer */
44 /* First buffer in chain of all buffers (in reverse order of creation).
45 Threaded through ->next. */
47 struct buffer
*all_buffers
;
49 /* This structure holds the default values of the buffer-local variables
50 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
51 The default value occupies the same slot in this structure
52 as an individual buffer's value occupies in that buffer.
53 Setting the default value also goes through the alist of buffers
54 and stores into each buffer that does not say it has a local value. */
56 struct buffer buffer_defaults
;
58 /* A Lisp_Object pointer to the above, used for staticpro */
60 static Lisp_Object Vbuffer_defaults
;
62 /* This structure marks which slots in a buffer have corresponding
63 default values in buffer_defaults.
64 Each such slot has a nonzero value in this structure.
65 The value has only one nonzero bit.
67 When a buffer has its own local value for a slot,
68 the bit for that slot (found in the same slot in this structure)
69 is turned on in the buffer's local_var_flags slot.
71 If a slot in this structure is -1, then even though there may
72 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
73 and the corresponding slot in buffer_defaults is not used.
75 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
76 but there is a default value which is copied into each buffer.
78 If a slot in this structure is negative, then even though there may
79 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
80 and the corresponding slot in buffer_defaults is not used.
82 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
83 zero, that is a bug */
85 struct buffer buffer_local_flags
;
87 /* This structure holds the names of symbols whose values may be
88 buffer-local. It is indexed and accessed in the same way as the above. */
90 struct buffer buffer_local_symbols
;
91 /* A Lisp_Object pointer to the above, used for staticpro */
92 static Lisp_Object Vbuffer_local_symbols
;
94 /* This structure holds the required types for the values in the
95 buffer-local slots. If a slot contains Qnil, then the
96 corresponding buffer slot may contain a value of any type. If a
97 slot contains an integer, then prospective values' tags must be
98 equal to that integer. When a tag does not match, the function
99 buffer_slot_type_mismatch will signal an error. */
100 struct buffer buffer_local_types
;
102 Lisp_Object
Fset_buffer ();
103 void set_buffer_internal ();
104 void set_buffer_internal_1 ();
105 static void call_overlay_mod_hooks ();
106 static void swap_out_buffer_local_variables ();
108 /* Alist of all buffer names vs the buffers. */
109 /* This used to be a variable, but is no longer,
110 to prevent lossage due to user rplac'ing this alist or its elements. */
111 Lisp_Object Vbuffer_alist
;
113 /* Functions to call before and after each text change. */
114 Lisp_Object Vbefore_change_function
;
115 Lisp_Object Vafter_change_function
;
116 Lisp_Object Vbefore_change_functions
;
117 Lisp_Object Vafter_change_functions
;
119 Lisp_Object Vtransient_mark_mode
;
121 /* t means ignore all read-only text properties.
122 A list means ignore such a property if its value is a member of the list.
123 Any non-nil value means ignore buffer-read-only. */
124 Lisp_Object Vinhibit_read_only
;
126 /* List of functions to call that can query about killing a buffer.
127 If any of these functions returns nil, we don't kill it. */
128 Lisp_Object Vkill_buffer_query_functions
;
130 /* List of functions to call before changing an unmodified buffer. */
131 Lisp_Object Vfirst_change_hook
;
133 Lisp_Object Qfirst_change_hook
;
134 Lisp_Object Qbefore_change_functions
;
135 Lisp_Object Qafter_change_functions
;
137 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
139 Lisp_Object Qprotected_field
;
141 Lisp_Object QSFundamental
; /* A string "Fundamental" */
143 Lisp_Object Qkill_buffer_hook
;
145 Lisp_Object Qget_file_buffer
;
147 Lisp_Object Qoverlayp
;
149 Lisp_Object Qpriority
, Qwindow
, Qevaporate
, Qbefore_string
, Qafter_string
;
151 Lisp_Object Qmodification_hooks
;
152 Lisp_Object Qinsert_in_front_hooks
;
153 Lisp_Object Qinsert_behind_hooks
;
155 /* For debugging; temporary. See set_buffer_internal. */
156 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
162 error ("No buffer named %s", XSTRING (spec
)->data
);
163 error ("Invalid buffer argument");
166 DEFUN ("buffer-live-p", Fbuffer_live_p
, Sbuffer_live_p
, 1, 1, 0,
167 "Return non-nil if OBJECT is a buffer which has not been killed.\n\
168 Value is nil if OBJECT is not a buffer or if it has been killed.")
172 return ((BUFFERP (object
) && ! NILP (XBUFFER (object
)->name
))
176 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
177 "Return a list of all existing live buffers.")
180 return Fmapcar (Qcdr
, Vbuffer_alist
);
183 /* Like Fassoc, but use Fstring_equal to compare
184 (which ignores text properties),
185 and don't ever QUIT. */
188 assoc_ignore_text_properties (key
, list
)
189 register Lisp_Object key
;
192 register Lisp_Object tail
;
193 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
195 register Lisp_Object elt
, tem
;
197 tem
= Fstring_equal (Fcar (elt
), key
);
204 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
205 "Return the buffer named NAME (a string).\n\
206 If there is no live buffer named NAME, return nil.\n\
207 NAME may also be a buffer; if so, the value is that buffer.")
209 register Lisp_Object name
;
213 CHECK_STRING (name
, 0);
215 return Fcdr (assoc_ignore_text_properties (name
, Vbuffer_alist
));
218 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
219 "Return the buffer visiting file FILENAME (a string).\n\
220 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
221 If there is no such live buffer, return nil.\n\
222 See also `find-buffer-visiting'.")
224 register Lisp_Object filename
;
226 register Lisp_Object tail
, buf
, tem
;
229 CHECK_STRING (filename
, 0);
230 filename
= Fexpand_file_name (filename
, Qnil
);
232 /* If the file name has special constructs in it,
233 call the corresponding file handler. */
234 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
236 return call2 (handler
, Qget_file_buffer
, filename
);
238 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
240 buf
= Fcdr (XCONS (tail
)->car
);
241 if (!BUFFERP (buf
)) continue;
242 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
243 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
251 get_truename_buffer (filename
)
252 register Lisp_Object filename
;
254 register Lisp_Object tail
, buf
, tem
;
256 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
258 buf
= Fcdr (XCONS (tail
)->car
);
259 if (!BUFFERP (buf
)) continue;
260 if (!STRINGP (XBUFFER (buf
)->file_truename
)) continue;
261 tem
= Fstring_equal (XBUFFER (buf
)->file_truename
, filename
);
268 /* Incremented for each buffer created, to assign the buffer number. */
271 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
272 "Return the buffer named NAME, or create such a buffer and return it.\n\
273 A new buffer is created if there is no live buffer named NAME.\n\
274 If NAME starts with a space, the new buffer does not keep undo information.\n\
275 If NAME is a buffer instead of a string, then it is the value returned.\n\
276 The value is never nil.")
278 register Lisp_Object name
;
280 register Lisp_Object buf
;
281 register struct buffer
*b
;
283 buf
= Fget_buffer (name
);
287 if (XSTRING (name
)->size
== 0)
288 error ("Empty string for buffer name is not allowed");
290 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
292 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
294 /* An ordinary buffer uses its own struct buffer_text. */
295 b
->text
= &b
->own_text
;
298 BUF_GAP_SIZE (b
) = 20;
300 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
302 if (! BUF_BEG_ADDR (b
))
303 buffer_memory_full ();
311 BUF_SAVE_MODIFF (b
) = 1;
312 BUF_INTERVALS (b
) = 0;
314 b
->newline_cache
= 0;
315 b
->width_run_cache
= 0;
316 b
->width_table
= Qnil
;
318 /* Put this on the chain of all buffers including killed ones. */
319 b
->next
= all_buffers
;
322 /* An ordinary buffer normally doesn't need markers
323 to handle BEGV and ZV. */
325 b
->begv_marker
= Qnil
;
328 name
= Fcopy_sequence (name
);
329 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
332 if (XSTRING (name
)->data
[0] != ' ')
338 reset_buffer_local_variables (b
);
340 /* Put this in the alist of all live buffers. */
342 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
344 b
->mark
= Fmake_marker ();
345 BUF_MARKERS (b
) = Qnil
;
350 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
351 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
352 "Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.\n\
353 BASE-BUFFER should be an existing buffer (or buffer name).\n\
354 NAME should be a string which is not the name of an existing buffer.")
356 register Lisp_Object base_buffer
, name
;
358 register Lisp_Object buf
;
359 register struct buffer
*b
;
361 buf
= Fget_buffer (name
);
363 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
365 base_buffer
= Fget_buffer (base_buffer
);
366 if (NILP (base_buffer
))
367 error ("No such buffer: `%s'",
368 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
370 if (XSTRING (name
)->size
== 0)
371 error ("Empty string for buffer name is not allowed");
373 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
375 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
377 if (XBUFFER (base_buffer
)->base_buffer
)
378 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
380 b
->base_buffer
= XBUFFER (base_buffer
);
382 /* Use the base buffer's text object. */
383 b
->text
= b
->base_buffer
->text
;
385 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
386 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
387 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
389 b
->newline_cache
= 0;
390 b
->width_run_cache
= 0;
391 b
->width_table
= Qnil
;
393 /* Put this on the chain of all buffers including killed ones. */
394 b
->next
= all_buffers
;
397 name
= Fcopy_sequence (name
);
398 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
402 reset_buffer_local_variables (b
);
404 /* Put this in the alist of all live buffers. */
406 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
408 b
->mark
= Fmake_marker ();
411 /* Make sure the base buffer has markers for its narrowing. */
412 if (NILP (b
->base_buffer
->pt_marker
))
414 b
->base_buffer
->pt_marker
= Fmake_marker ();
415 Fset_marker (b
->base_buffer
->pt_marker
,
416 make_number (BUF_PT (b
->base_buffer
)), base_buffer
);
418 if (NILP (b
->base_buffer
->begv_marker
))
420 b
->base_buffer
->begv_marker
= Fmake_marker ();
421 Fset_marker (b
->base_buffer
->begv_marker
,
422 make_number (BUF_BEGV (b
->base_buffer
)), base_buffer
);
424 if (NILP (b
->base_buffer
->zv_marker
))
426 b
->base_buffer
->zv_marker
= Fmake_marker ();
427 Fset_marker (b
->base_buffer
->zv_marker
,
428 make_number (BUF_ZV (b
->base_buffer
)), base_buffer
);
429 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
432 /* Give the indirect buffer markers for its narrowing. */
433 b
->pt_marker
= Fmake_marker ();
434 Fset_marker (b
->pt_marker
, make_number (BUF_PT (b
)), buf
);
435 b
->begv_marker
= Fmake_marker ();
436 Fset_marker (b
->begv_marker
, make_number (BUF_BEGV (b
)), buf
);
437 b
->zv_marker
= Fmake_marker ();
438 Fset_marker (b
->zv_marker
, make_number (BUF_ZV (b
)), buf
);
440 XMARKER (b
->zv_marker
)->insertion_type
= 1;
445 /* Reinitialize everything about a buffer except its name and contents
446 and local variables. */
450 register struct buffer
*b
;
453 b
->file_truename
= Qnil
;
454 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
456 XSETFASTINT (b
->save_length
, 0);
457 b
->last_window_start
= 1;
459 b
->auto_save_modified
= 0;
460 b
->auto_save_failure_time
= -1;
461 b
->auto_save_file_name
= Qnil
;
463 b
->overlays_before
= Qnil
;
464 b
->overlays_after
= Qnil
;
465 XSETFASTINT (b
->overlay_center
, 1);
466 b
->mark_active
= Qnil
;
467 b
->point_before_scroll
= Qnil
;
468 b
->file_format
= Qnil
;
474 /* Reset buffer B's local variables info.
475 Don't use this on a buffer that has already been in use;
476 it does not treat permanent locals consistently.
477 Instead, use Fkill_all_local_variables. */
479 reset_buffer_local_variables (b
)
480 register struct buffer
*b
;
484 /* Reset the major mode to Fundamental, together with all the
485 things that depend on the major mode.
486 default-major-mode is handled at a higher level.
487 We ignore it here. */
488 b
->major_mode
= Qfundamental_mode
;
490 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
491 b
->mode_name
= QSFundamental
;
492 b
->minor_modes
= Qnil
;
494 /* If the standard case table has been altered and invalidated,
495 fix up its insides first. */
496 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[0])
497 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[1])
498 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[2])))
499 Fset_standard_case_table (Vascii_downcase_table
);
501 b
->downcase_table
= Vascii_downcase_table
;
502 b
->upcase_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[0];
503 b
->case_canon_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[1];
504 b
->case_eqv_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[2];
505 b
->buffer_file_type
= Qnil
;
506 b
->invisibility_spec
= Qt
;
509 b
->sort_table
= XSTRING (Vascii_sort_table
);
510 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
513 /* Reset all per-buffer variables to their defaults. */
514 b
->local_var_alist
= Qnil
;
515 b
->local_var_flags
= 0;
517 /* For each slot that has a default value,
518 copy that into the slot. */
520 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
521 offset
< sizeof (struct buffer
);
522 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
524 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
525 if (flag
> 0 || flag
== -2)
526 *(Lisp_Object
*)(offset
+ (char *)b
) =
527 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
531 /* We split this away from generate-new-buffer, because rename-buffer
532 and set-visited-file-name ought to be able to use this to really
533 rename the buffer properly. */
535 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
537 "Return a string that is the name of no existing buffer based on NAME.\n\
538 If there is no live buffer named NAME, then return NAME.\n\
539 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
540 until an unused name is found, and then return that name.\n\
541 Optional second argument IGNORE specifies a name that is okay to use\n\
542 \(if it is in the sequence to be tried)\n\
543 even if a buffer with that name exists.")
545 register Lisp_Object name
, ignore
;
547 register Lisp_Object gentemp
, tem
;
551 CHECK_STRING (name
, 0);
553 tem
= Fget_buffer (name
);
560 sprintf (number
, "<%d>", ++count
);
561 gentemp
= concat2 (name
, build_string (number
));
562 tem
= Fstring_equal (gentemp
, ignore
);
565 tem
= Fget_buffer (gentemp
);
572 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
573 "Return the name of BUFFER, as a string.\n\
574 With no argument or nil as argument, return the name of the current buffer.")
576 register Lisp_Object buffer
;
579 return current_buffer
->name
;
580 CHECK_BUFFER (buffer
, 0);
581 return XBUFFER (buffer
)->name
;
584 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
585 "Return name of file BUFFER is visiting, or nil if none.\n\
586 No argument or nil as argument means use the current buffer.")
588 register Lisp_Object buffer
;
591 return current_buffer
->filename
;
592 CHECK_BUFFER (buffer
, 0);
593 return XBUFFER (buffer
)->filename
;
596 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
598 "Return the base buffer of indirect buffer BUFFER.\n\
599 If BUFFER is not indirect, return nil.")
601 register Lisp_Object buffer
;
604 Lisp_Object base_buffer
;
607 base
= current_buffer
->base_buffer
;
610 CHECK_BUFFER (buffer
, 0);
611 base
= XBUFFER (buffer
)->base_buffer
;
616 XSETBUFFER (base_buffer
, base
);
620 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
621 Sbuffer_local_variables
, 0, 1, 0,
622 "Return an alist of variables that are buffer-local in BUFFER.\n\
623 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
624 For a symbol that is locally unbound, just the symbol appears in the value.\n\
625 Note that storing new VALUEs in these elements doesn't change the variables.\n\
626 No argument or nil as argument means use current buffer as BUFFER.")
628 register Lisp_Object buffer
;
630 register struct buffer
*buf
;
631 register Lisp_Object result
;
634 buf
= current_buffer
;
637 CHECK_BUFFER (buffer
, 0);
638 buf
= XBUFFER (buffer
);
644 register Lisp_Object tail
;
645 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
647 Lisp_Object val
, elt
;
649 elt
= XCONS (tail
)->car
;
651 /* Reference each variable in the alist in buf.
652 If inquiring about the current buffer, this gets the current values,
653 so store them into the alist so the alist is up to date.
654 If inquiring about some other buffer, this swaps out any values
655 for that buffer, making the alist up to date automatically. */
656 val
= find_symbol_value (XCONS (elt
)->car
);
657 /* Use the current buffer value only if buf is the current buffer. */
658 if (buf
!= current_buffer
)
659 val
= XCONS (elt
)->cdr
;
661 /* If symbol is unbound, put just the symbol in the list. */
662 if (EQ (val
, Qunbound
))
663 result
= Fcons (XCONS (elt
)->car
, result
);
664 /* Otherwise, put (symbol . value) in the list. */
666 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
670 /* Add on all the variables stored in special slots. */
672 register int offset
, mask
;
674 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
675 offset
< sizeof (struct buffer
);
676 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
678 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
679 if (mask
== -1 || (buf
->local_var_flags
& mask
))
680 if (SYMBOLP (*(Lisp_Object
*)(offset
681 + (char *)&buffer_local_symbols
)))
682 result
= Fcons (Fcons (*((Lisp_Object
*)
683 (offset
+ (char *)&buffer_local_symbols
)),
684 *(Lisp_Object
*)(offset
+ (char *)buf
)),
693 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
695 "Return t if BUFFER was modified since its file was last read or saved.\n\
696 No argument or nil as argument means use current buffer as BUFFER.")
698 register Lisp_Object buffer
;
700 register struct buffer
*buf
;
702 buf
= current_buffer
;
705 CHECK_BUFFER (buffer
, 0);
706 buf
= XBUFFER (buffer
);
709 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
712 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
714 "Mark current buffer as modified or unmodified according to FLAG.\n\
715 A non-nil FLAG means mark the buffer modified.")
717 register Lisp_Object flag
;
719 register int already
;
720 register Lisp_Object fn
;
722 #ifdef CLASH_DETECTION
723 /* If buffer becoming modified, lock the file.
724 If buffer becoming unmodified, unlock the file. */
726 fn
= current_buffer
->file_truename
;
729 already
= SAVE_MODIFF
< MODIFF
;
730 if (!already
&& !NILP (flag
))
732 else if (already
&& NILP (flag
))
735 #endif /* CLASH_DETECTION */
737 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
742 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
744 "Return BUFFER's tick counter, incremented for each change in text.\n\
745 Each buffer has a tick counter which is incremented each time the text in\n\
746 that buffer is changed. It wraps around occasionally.\n\
747 No argument or nil as argument means use current buffer as BUFFER.")
749 register Lisp_Object buffer
;
751 register struct buffer
*buf
;
753 buf
= current_buffer
;
756 CHECK_BUFFER (buffer
, 0);
757 buf
= XBUFFER (buffer
);
760 return make_number (BUF_MODIFF (buf
));
763 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
764 "sRename buffer (to new name): \nP",
765 "Change current buffer's name to NEWNAME (a string).\n\
766 If second arg UNIQUE is nil or omitted, it is an error if a\n\
767 buffer named NEWNAME already exists.\n\
768 If UNIQUE is non-nil, come up with a new name using\n\
769 `generate-new-buffer-name'.\n\
770 Interactively, you can set UNIQUE with a prefix argument.\n\
771 We return the name we actually gave the buffer.\n\
772 This does not change the name of the visited file (if any).")
774 register Lisp_Object newname
, unique
;
776 register Lisp_Object tem
, buf
;
778 CHECK_STRING (newname
, 0);
780 if (XSTRING (newname
)->size
== 0)
781 error ("Empty string is invalid as a buffer name");
783 tem
= Fget_buffer (newname
);
784 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
785 the buffer automatically so you can create another with the original name.
786 It makes UNIQUE equivalent to
787 (rename-buffer (generate-new-buffer-name NEWNAME)). */
788 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
789 return current_buffer
->name
;
793 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
795 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
798 current_buffer
->name
= newname
;
800 /* Catch redisplay's attention. Unless we do this, the mode lines for
801 any windows displaying current_buffer will stay unchanged. */
804 XSETBUFFER (buf
, current_buffer
);
805 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
806 if (NILP (current_buffer
->filename
)
807 && !NILP (current_buffer
->auto_save_file_name
))
808 call0 (intern ("rename-auto-save-file"));
809 /* Refetch since that last call may have done GC. */
810 return current_buffer
->name
;
813 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
814 "Return most recently selected buffer other than BUFFER.\n\
815 Buffers not visible in windows are preferred to visible buffers,\n\
816 unless optional second argument VISIBLE-OK is non-nil.\n\
817 If no other buffer exists, the buffer `*scratch*' is returned.\n\
818 If BUFFER is omitted or nil, some interesting buffer is returned.")
820 register Lisp_Object buffer
, visible_ok
;
822 Lisp_Object
Fset_buffer_major_mode ();
823 register Lisp_Object tail
, buf
, notsogood
, tem
;
826 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
828 buf
= Fcdr (Fcar (tail
));
829 if (EQ (buf
, buffer
))
831 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
834 /* If the selected frame has a buffer_predicate,
835 disregard buffers that don't fit the predicate. */
836 tem
= frame_buffer_predicate ();
839 tem
= call1 (tem
, buf
);
845 if (NILP (visible_ok
))
846 tem
= Fget_buffer_window (buf
, Qt
);
851 if (NILP (notsogood
))
854 if (!NILP (notsogood
))
856 buf
= Fget_buffer_create (build_string ("*scratch*"));
857 Fset_buffer_major_mode (buf
);
861 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
863 "Make BUFFER stop keeping undo information.\n\
864 No argument or nil as argument means do this for the current buffer.")
866 register Lisp_Object buffer
;
868 Lisp_Object real_buffer
;
871 XSETBUFFER (real_buffer
, current_buffer
);
874 real_buffer
= Fget_buffer (buffer
);
875 if (NILP (real_buffer
))
879 XBUFFER (real_buffer
)->undo_list
= Qt
;
884 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
886 "Start keeping undo information for buffer BUFFER.\n\
887 No argument or nil as argument means do this for the current buffer.")
889 register Lisp_Object buffer
;
891 Lisp_Object real_buffer
;
894 XSETBUFFER (real_buffer
, current_buffer
);
897 real_buffer
= Fget_buffer (buffer
);
898 if (NILP (real_buffer
))
902 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
903 XBUFFER (real_buffer
)->undo_list
= Qnil
;
909 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
910 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
911 The buffer being killed will be current while the hook is running.\n\
914 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
915 "Kill the buffer BUFFER.\n\
916 The argument may be a buffer or may be the name of a buffer.\n\
917 An argument of nil means kill the current buffer.\n\n\
918 Value is t if the buffer is actually killed, nil if user says no.\n\n\
919 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
920 if not void, is a list of functions to be called, with no arguments,\n\
921 before the buffer is actually killed. The buffer to be killed is current\n\
922 when the hook functions are called.\n\n\
923 Any processes that have this buffer as the `process-buffer' are killed\n\
924 with `delete-process'.")
929 register struct buffer
*b
;
930 register Lisp_Object tem
;
931 register struct Lisp_Marker
*m
;
932 struct gcpro gcpro1
, gcpro2
;
935 buf
= Fcurrent_buffer ();
937 buf
= Fget_buffer (buffer
);
943 /* Avoid trouble for buffer already dead. */
947 /* Query if the buffer is still modified. */
948 if (INTERACTIVE
&& !NILP (b
->filename
)
949 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
952 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
953 XSTRING (b
->name
)->data
));
959 /* Run hooks with the buffer to be killed the current buffer. */
961 register Lisp_Object val
;
962 int count
= specpdl_ptr
- specpdl
;
965 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
966 set_buffer_internal (b
);
968 /* First run the query functions; if any query is answered no,
969 don't kill the buffer. */
970 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
972 tem
= call0 (Fcar (list
));
974 return unbind_to (count
, Qnil
);
977 /* Then run the hooks. */
978 if (!NILP (Vrun_hooks
))
979 call1 (Vrun_hooks
, Qkill_buffer_hook
);
980 unbind_to (count
, Qnil
);
983 /* We have no more questions to ask. Verify that it is valid
984 to kill the buffer. This must be done after the questions
985 since anything can happen within do_yes_or_no_p. */
987 /* Don't kill the minibuffer now current. */
988 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
994 /* When we kill a base buffer, kill all its indirect buffers.
995 We do it at this stage so nothing terrible happens if they
996 ask questions or their hooks get errors. */
997 if (! b
->base_buffer
)
999 struct buffer
*other
;
1003 for (other
= all_buffers
; other
; other
= other
->next
)
1004 /* all_buffers contains dead buffers too;
1005 don't re-kill them. */
1006 if (other
->base_buffer
== b
&& !NILP (other
->name
))
1009 XSETBUFFER (buf
, other
);
1016 /* Make this buffer not be current.
1017 In the process, notice if this is the sole visible buffer
1018 and give up if so. */
1019 if (b
== current_buffer
)
1021 tem
= Fother_buffer (buf
, Qnil
);
1023 if (b
== current_buffer
)
1027 /* Now there is no question: we can kill the buffer. */
1029 #ifdef CLASH_DETECTION
1030 /* Unlock this buffer's file, if it is locked. */
1032 #endif /* CLASH_DETECTION */
1034 kill_buffer_processes (buf
);
1036 tem
= Vinhibit_quit
;
1038 replace_buffer_in_all_windows (buf
);
1039 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1040 Vinhibit_quit
= tem
;
1042 /* Delete any auto-save file, if we saved it in this session. */
1043 if (STRINGP (b
->auto_save_file_name
)
1044 && b
->auto_save_modified
!= 0
1045 && SAVE_MODIFF
< b
->auto_save_modified
)
1048 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1050 internal_delete_file (b
->auto_save_file_name
);
1055 /* Unchain all markers that belong to this indirect buffer.
1056 Don't unchain the markers that belong to the base buffer
1057 or its other indirect buffers. */
1058 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1064 unchain_marker (tem
);
1070 /* Unchain all markers of this buffer and its indirect buffers.
1071 and leave them pointing nowhere. */
1072 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1079 BUF_MARKERS (b
) = Qnil
;
1081 #ifdef USE_TEXT_PROPERTIES
1082 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1085 /* Perhaps we should explicitly free the interval tree here... */
1088 /* Reset the local variables, so that this buffer's local values
1089 won't be protected from GC. They would be protected
1090 if they happened to remain encached in their symbols.
1091 This gets rid of them for certain. */
1092 swap_out_buffer_local_variables (b
);
1093 reset_buffer_local_variables (b
);
1098 if (! b
->base_buffer
)
1099 BUFFER_FREE (BUF_BEG_ADDR (b
));
1101 if (b
->newline_cache
)
1103 free_region_cache (b
->newline_cache
);
1104 b
->newline_cache
= 0;
1106 if (b
->width_run_cache
)
1108 free_region_cache (b
->width_run_cache
);
1109 b
->width_run_cache
= 0;
1111 b
->width_table
= Qnil
;
1113 b
->undo_list
= Qnil
;
1118 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1119 we do this each time BUF is selected visibly, the more recently
1120 selected buffers are always closer to the front of the list. This
1121 means that other_buffer is more likely to choose a relevant buffer. */
1126 register Lisp_Object link
, prev
;
1129 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1131 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1136 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1137 we cannot use Fdelq itself here because it allows quitting. */
1140 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1142 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1144 XCONS(link
)->cdr
= Vbuffer_alist
;
1145 Vbuffer_alist
= link
;
1148 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1149 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1150 Use this function before selecting the buffer, since it may need to inspect\n\
1151 the current buffer's major mode.")
1156 Lisp_Object function
;
1158 function
= buffer_defaults
.major_mode
;
1159 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1160 function
= current_buffer
->major_mode
;
1162 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1165 count
= specpdl_ptr
- specpdl
;
1167 /* To select a nonfundamental mode,
1168 select the buffer temporarily and then call the mode function. */
1170 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1172 Fset_buffer (buffer
);
1175 return unbind_to (count
, Qnil
);
1178 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1179 "Select buffer BUFFER in the current window.\n\
1180 BUFFER may be a buffer or a buffer name.\n\
1181 Optional second arg NORECORD non-nil means\n\
1182 do not put this buffer at the front of the list of recently selected ones.\n\
1184 WARNING: This is NOT the way to work on another buffer temporarily\n\
1185 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1186 the window-buffer correspondences.")
1188 Lisp_Object buffer
, norecord
;
1190 register Lisp_Object buf
;
1193 if (EQ (minibuf_window
, selected_window
))
1194 error ("Cannot switch buffers in minibuffer window");
1195 tem
= Fwindow_dedicated_p (selected_window
);
1197 error ("Cannot switch buffers in a dedicated window");
1200 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1203 buf
= Fget_buffer (buffer
);
1206 buf
= Fget_buffer_create (buffer
);
1207 Fset_buffer_major_mode (buf
);
1211 if (NILP (norecord
))
1212 record_buffer (buf
);
1214 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1215 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1222 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
1223 "Select buffer BUFFER in some window, preferably a different one.\n\
1224 If BUFFER is nil, then some other buffer is chosen.\n\
1225 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1226 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1227 window even if BUFFER is already visible in the selected window.\n\
1228 This uses the function `display-buffer' as a subroutine; see the documentation\n\
1229 of `display-buffer' for additional customization information.")
1230 (buffer
, other_window
)
1231 Lisp_Object buffer
, other_window
;
1233 register Lisp_Object buf
;
1235 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
1238 buf
= Fget_buffer (buffer
);
1241 buf
= Fget_buffer_create (buffer
);
1242 Fset_buffer_major_mode (buf
);
1246 record_buffer (buf
);
1247 Fselect_window (Fdisplay_buffer (buf
, other_window
));
1251 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1252 "Return the current buffer as a Lisp object.")
1255 register Lisp_Object buf
;
1256 XSETBUFFER (buf
, current_buffer
);
1260 /* Set the current buffer to B. */
1263 set_buffer_internal (b
)
1264 register struct buffer
*b
;
1266 register struct buffer
*old_buf
;
1267 register Lisp_Object tail
, valcontents
;
1270 if (current_buffer
== b
)
1273 windows_or_buffers_changed
= 1;
1274 set_buffer_internal_1 (b
);
1277 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1278 This is used by redisplay. */
1281 set_buffer_internal_1 (b
)
1282 register struct buffer
*b
;
1284 register struct buffer
*old_buf
;
1285 register Lisp_Object tail
, valcontents
;
1288 if (current_buffer
== b
)
1291 old_buf
= current_buffer
;
1293 last_known_column_point
= -1; /* invalidate indentation cache */
1297 /* Put the undo list back in the base buffer, so that it appears
1298 that an indirect buffer shares the undo list of its base. */
1299 if (old_buf
->base_buffer
)
1300 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1302 /* If the old current buffer has markers to record PT, BEGV and ZV
1303 when it is not current, update them now. */
1304 if (! NILP (old_buf
->pt_marker
))
1307 XSETBUFFER (obuf
, old_buf
);
1308 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1310 if (! NILP (old_buf
->begv_marker
))
1313 XSETBUFFER (obuf
, old_buf
);
1314 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1316 if (! NILP (old_buf
->zv_marker
))
1319 XSETBUFFER (obuf
, old_buf
);
1320 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1324 /* Get the undo list from the base buffer, so that it appears
1325 that an indirect buffer shares the undo list of its base. */
1327 b
->undo_list
= b
->base_buffer
->undo_list
;
1329 /* If the new current buffer has markers to record PT, BEGV and ZV
1330 when it is not current, fetch them now. */
1331 if (! NILP (b
->pt_marker
))
1332 BUF_PT (b
) = marker_position (b
->pt_marker
);
1333 if (! NILP (b
->begv_marker
))
1334 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1335 if (! NILP (b
->zv_marker
))
1336 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1338 /* Look down buffer's list of local Lisp variables
1339 to find and update any that forward into C variables. */
1341 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1343 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1344 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1345 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1346 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1347 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1348 /* Just reference the variable
1349 to cause it to become set for this buffer. */
1350 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1353 /* Do the same with any others that were local to the previous buffer */
1356 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1358 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1359 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1360 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1361 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->car
,
1362 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1363 /* Just reference the variable
1364 to cause it to become set for this buffer. */
1365 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1369 /* Switch to buffer B temporarily for redisplay purposes.
1370 This avoids certain things that don't need to be done within redisplay. */
1376 register struct buffer
*old_buf
;
1378 if (current_buffer
== b
)
1381 old_buf
= current_buffer
;
1386 /* If the old current buffer has markers to record PT, BEGV and ZV
1387 when it is not current, update them now. */
1388 if (! NILP (old_buf
->pt_marker
))
1391 XSETBUFFER (obuf
, old_buf
);
1392 Fset_marker (old_buf
->pt_marker
, BUF_PT (old_buf
), obuf
);
1394 if (! NILP (old_buf
->begv_marker
))
1397 XSETBUFFER (obuf
, old_buf
);
1398 Fset_marker (old_buf
->begv_marker
, BUF_BEGV (old_buf
), obuf
);
1400 if (! NILP (old_buf
->zv_marker
))
1403 XSETBUFFER (obuf
, old_buf
);
1404 Fset_marker (old_buf
->zv_marker
, BUF_ZV (old_buf
), obuf
);
1408 /* If the new current buffer has markers to record PT, BEGV and ZV
1409 when it is not current, fetch them now. */
1410 if (! NILP (b
->pt_marker
))
1411 BUF_PT (b
) = marker_position (b
->pt_marker
);
1412 if (! NILP (b
->begv_marker
))
1413 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1414 if (! NILP (b
->zv_marker
))
1415 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1418 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1419 "Make the buffer BUFFER current for editing operations.\n\
1420 BUFFER may be a buffer or the name of an existing buffer.\n\
1421 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1422 This function does not display the buffer, so its effect ends\n\
1423 when the current command terminates.\n\
1424 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1426 register Lisp_Object buffer
;
1428 register Lisp_Object buf
;
1429 buf
= Fget_buffer (buffer
);
1432 if (NILP (XBUFFER (buf
)->name
))
1433 error ("Selecting deleted buffer");
1434 set_buffer_internal (XBUFFER (buf
));
1438 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1439 Sbarf_if_buffer_read_only
, 0, 0, 0,
1440 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1443 if (!NILP (current_buffer
->read_only
)
1444 && NILP (Vinhibit_read_only
))
1445 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1449 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1450 "Put BUFFER at the end of the list of all buffers.\n\
1451 There it is the least likely candidate for `other-buffer' to return;\n\
1452 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1453 If BUFFER is nil or omitted, bury the current buffer.\n\
1454 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1455 selected window if it is displayed there.")
1457 register Lisp_Object buffer
;
1459 /* Figure out what buffer we're going to bury. */
1462 XSETBUFFER (buffer
, current_buffer
);
1464 /* If we're burying the current buffer, unshow it. */
1465 Fswitch_to_buffer (Fother_buffer (buffer
, Qnil
), Qnil
);
1471 buf1
= Fget_buffer (buffer
);
1477 /* Move buffer to the end of the buffer list. */
1479 register Lisp_Object aelt
, link
;
1481 aelt
= Frassq (buffer
, Vbuffer_alist
);
1482 link
= Fmemq (aelt
, Vbuffer_alist
);
1483 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1484 XCONS (link
)->cdr
= Qnil
;
1485 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1491 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1492 "Delete the entire contents of the current buffer.\n\
1493 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1494 so the buffer is truly empty after this.")
1499 current_buffer
->last_window_start
= 1;
1500 /* Prevent warnings, or suspension of auto saving, that would happen
1501 if future size is less than past size. Use of erase-buffer
1502 implies that the future text is not really related to the past text. */
1503 XSETFASTINT (current_buffer
->save_length
, 0);
1507 validate_region (b
, e
)
1508 register Lisp_Object
*b
, *e
;
1510 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1511 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1513 if (XINT (*b
) > XINT (*e
))
1516 tem
= *b
; *b
= *e
; *e
= tem
;
1519 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1520 && XINT (*e
) <= ZV
))
1521 args_out_of_range (*b
, *e
);
1524 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1526 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1527 Most local variable bindings are eliminated so that the default values\n\
1528 become effective once more. Also, the syntax table is set from\n\
1529 `standard-syntax-table', the local keymap is set to nil,\n\
1530 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1531 This function also forces redisplay of the mode line.\n\
1533 Every function to select a new major mode starts by\n\
1534 calling this function.\n\n\
1535 As a special exception, local variables whose names have\n\
1536 a non-nil `permanent-local' property are not eliminated by this function.\n\
1538 The first thing this function does is run\n\
1539 the normal hook `change-major-mode-hook'.")
1542 register Lisp_Object alist
, sym
, tem
;
1545 if (!NILP (Vrun_hooks
))
1546 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1547 oalist
= current_buffer
->local_var_alist
;
1549 /* Make sure none of the bindings in oalist
1550 remain swapped in, in their symbols. */
1552 swap_out_buffer_local_variables (current_buffer
);
1554 /* Actually eliminate all local bindings of this buffer. */
1556 reset_buffer_local_variables (current_buffer
);
1558 /* Redisplay mode lines; we are changing major mode. */
1560 update_mode_lines
++;
1562 /* Any which are supposed to be permanent,
1563 make local again, with the same values they had. */
1565 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1567 sym
= XCONS (XCONS (alist
)->car
)->car
;
1568 tem
= Fget (sym
, Qpermanent_local
);
1571 Fmake_local_variable (sym
);
1572 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1576 /* Force mode-line redisplay. Useful here because all major mode
1577 commands call this function. */
1578 update_mode_lines
++;
1583 /* Make sure no local variables remain set up with buffer B
1584 for their current values. */
1587 swap_out_buffer_local_variables (b
)
1590 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1592 XSETBUFFER (buffer
, b
);
1593 oalist
= b
->local_var_alist
;
1595 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1597 sym
= XCONS (XCONS (alist
)->car
)->car
;
1599 /* Need not do anything if some other buffer's binding is now encached. */
1600 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
;
1601 if (XBUFFER (tem
) == current_buffer
)
1603 /* Symbol is set up for this buffer's old local value.
1604 Set it up for the current buffer with the default value. */
1606 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1607 /* Store the symbol's current value into the alist entry
1608 it is currently set up for. This is so that, if the
1609 local is marked permanent, and we make it local again
1610 later in Fkill_all_local_variables, we don't lose the value. */
1611 XCONS (XCONS (tem
)->car
)->cdr
1612 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
);
1613 /* Switch to the symbol's default-value alist entry. */
1614 XCONS (tem
)->car
= tem
;
1615 /* Mark it as current for buffer B. */
1616 XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1618 /* Store the current value into any forwarding in the symbol. */
1619 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1625 /* Find all the overlays in the current buffer that contain position POS.
1626 Return the number found, and store them in a vector in *VEC_PTR.
1627 Store in *LEN_PTR the size allocated for the vector.
1628 Store in *NEXT_PTR the next position after POS where an overlay starts,
1629 or ZV if there are no more overlays.
1630 Store in *PREV_PTR the previous position before POS where an overlay ends,
1631 or BEGV if there are no previous overlays.
1632 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1634 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1635 when this function is called.
1637 If EXTEND is non-zero, we make the vector bigger if necessary.
1638 If EXTEND is zero, we never extend the vector,
1639 and we store only as many overlays as will fit.
1640 But we still return the total number of overlays. */
1643 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1646 Lisp_Object
**vec_ptr
;
1651 Lisp_Object tail
, overlay
, start
, end
, result
;
1654 Lisp_Object
*vec
= *vec_ptr
;
1657 int inhibit_storing
= 0;
1659 for (tail
= current_buffer
->overlays_before
;
1661 tail
= XCONS (tail
)->cdr
)
1663 int startpos
, endpos
;
1665 overlay
= XCONS (tail
)->car
;
1667 start
= OVERLAY_START (overlay
);
1668 end
= OVERLAY_END (overlay
);
1669 endpos
= OVERLAY_POSITION (end
);
1678 startpos
= OVERLAY_POSITION (start
);
1679 if (startpos
<= pos
)
1683 /* The supplied vector is full.
1684 Either make it bigger, or don't store any more in it. */
1687 *len_ptr
= len
*= 2;
1688 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1692 inhibit_storing
= 1;
1695 if (!inhibit_storing
)
1697 /* Keep counting overlays even if we can't return them all. */
1700 else if (startpos
< next
)
1704 for (tail
= current_buffer
->overlays_after
;
1706 tail
= XCONS (tail
)->cdr
)
1708 int startpos
, endpos
;
1710 overlay
= XCONS (tail
)->car
;
1712 start
= OVERLAY_START (overlay
);
1713 end
= OVERLAY_END (overlay
);
1714 startpos
= OVERLAY_POSITION (start
);
1717 if (startpos
< next
)
1721 endpos
= OVERLAY_POSITION (end
);
1728 *len_ptr
= len
*= 2;
1729 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1733 inhibit_storing
= 1;
1736 if (!inhibit_storing
)
1740 else if (endpos
< pos
&& endpos
> prev
)
1751 /* Find all the overlays in the current buffer that overlap the range BEG-END
1752 or are empty at BEG.
1754 Return the number found, and store them in a vector in *VEC_PTR.
1755 Store in *LEN_PTR the size allocated for the vector.
1756 Store in *NEXT_PTR the next position after POS where an overlay starts,
1757 or ZV if there are no more overlays.
1758 Store in *PREV_PTR the previous position before POS where an overlay ends,
1759 or BEGV if there are no previous overlays.
1760 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1762 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1763 when this function is called.
1765 If EXTEND is non-zero, we make the vector bigger if necessary.
1766 If EXTEND is zero, we never extend the vector,
1767 and we store only as many overlays as will fit.
1768 But we still return the total number of overlays. */
1771 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1774 Lisp_Object
**vec_ptr
;
1779 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
1782 Lisp_Object
*vec
= *vec_ptr
;
1785 int inhibit_storing
= 0;
1787 for (tail
= current_buffer
->overlays_before
;
1789 tail
= XCONS (tail
)->cdr
)
1791 int startpos
, endpos
;
1793 overlay
= XCONS (tail
)->car
;
1795 ostart
= OVERLAY_START (overlay
);
1796 oend
= OVERLAY_END (overlay
);
1797 endpos
= OVERLAY_POSITION (oend
);
1804 startpos
= OVERLAY_POSITION (ostart
);
1805 /* Count an interval if it either overlaps the range
1806 or is empty at the start of the range. */
1807 if ((beg
< endpos
&& startpos
< end
)
1808 || (startpos
== endpos
&& beg
== endpos
))
1812 /* The supplied vector is full.
1813 Either make it bigger, or don't store any more in it. */
1816 *len_ptr
= len
*= 2;
1817 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1821 inhibit_storing
= 1;
1824 if (!inhibit_storing
)
1826 /* Keep counting overlays even if we can't return them all. */
1829 else if (startpos
< next
)
1833 for (tail
= current_buffer
->overlays_after
;
1835 tail
= XCONS (tail
)->cdr
)
1837 int startpos
, endpos
;
1839 overlay
= XCONS (tail
)->car
;
1841 ostart
= OVERLAY_START (overlay
);
1842 oend
= OVERLAY_END (overlay
);
1843 startpos
= OVERLAY_POSITION (ostart
);
1846 if (startpos
< next
)
1850 endpos
= OVERLAY_POSITION (oend
);
1851 /* Count an interval if it either overlaps the range
1852 or is empty at the start of the range. */
1853 if ((beg
< endpos
&& startpos
< end
)
1854 || (startpos
== endpos
&& beg
== endpos
))
1860 *len_ptr
= len
*= 2;
1861 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1865 inhibit_storing
= 1;
1868 if (!inhibit_storing
)
1872 else if (endpos
< beg
&& endpos
> prev
)
1883 /* Fast function to just test if we're at an overlay boundary. */
1885 overlay_touches_p (pos
)
1888 Lisp_Object tail
, overlay
;
1890 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
1891 tail
= XCONS (tail
)->cdr
)
1895 overlay
= XCONS (tail
)->car
;
1896 if (!GC_OVERLAYP (overlay
))
1899 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1902 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
1906 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
1907 tail
= XCONS (tail
)->cdr
)
1911 overlay
= XCONS (tail
)->car
;
1912 if (!GC_OVERLAYP (overlay
))
1915 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1918 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
1926 Lisp_Object overlay
;
1932 compare_overlays (s1
, s2
)
1933 struct sortvec
*s1
, *s2
;
1935 if (s1
->priority
!= s2
->priority
)
1936 return s1
->priority
- s2
->priority
;
1937 if (s1
->beg
!= s2
->beg
)
1938 return s1
->beg
- s2
->beg
;
1939 if (s1
->end
!= s2
->end
)
1940 return s2
->end
- s1
->end
;
1944 /* Sort an array of overlays by priority. The array is modified in place.
1945 The return value is the new size; this may be smaller than the original
1946 size if some of the overlays were invalid or were window-specific. */
1948 sort_overlays (overlay_vec
, noverlays
, w
)
1949 Lisp_Object
*overlay_vec
;
1954 struct sortvec
*sortvec
;
1955 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1957 /* Put the valid and relevant overlays into sortvec. */
1959 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1962 Lisp_Object overlay
;
1964 overlay
= overlay_vec
[i
];
1965 if (OVERLAY_VALID (overlay
)
1966 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1967 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1969 /* If we're interested in a specific window, then ignore
1970 overlays that are limited to some other window. */
1975 window
= Foverlay_get (overlay
, Qwindow
);
1976 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1980 /* This overlay is good and counts: put it into sortvec. */
1981 sortvec
[j
].overlay
= overlay
;
1982 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1983 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1984 tem
= Foverlay_get (overlay
, Qpriority
);
1986 sortvec
[j
].priority
= XINT (tem
);
1988 sortvec
[j
].priority
= 0;
1994 /* Sort the overlays into the proper order: increasing priority. */
1997 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1999 for (i
= 0; i
< noverlays
; i
++)
2000 overlay_vec
[i
] = sortvec
[i
].overlay
;
2006 Lisp_Object string
, string2
;
2013 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
2014 int size
; /* Allocated length of that array. */
2015 int used
; /* How much of the array is currently in use. */
2016 int bytes
; /* Total length of the strings in buf. */
2019 /* Buffers for storing information about the overlays touching a given
2020 position. These could be automatic variables in overlay_strings, but
2021 it's more efficient to hold onto the memory instead of repeatedly
2022 allocating and freeing it. */
2023 static struct sortstrlist overlay_heads
, overlay_tails
;
2024 static char *overlay_str_buf
;
2026 /* Allocated length of overlay_str_buf. */
2027 static int overlay_str_len
;
2029 /* A comparison function suitable for passing to qsort. */
2031 cmp_for_strings (as1
, as2
)
2034 struct sortstr
*s1
= (struct sortstr
*)as1
;
2035 struct sortstr
*s2
= (struct sortstr
*)as2
;
2036 if (s1
->size
!= s2
->size
)
2037 return s2
->size
- s1
->size
;
2038 if (s1
->priority
!= s2
->priority
)
2039 return s1
->priority
- s2
->priority
;
2044 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2045 struct sortstrlist
*ssl
;
2046 Lisp_Object str
, str2
, pri
;
2049 if (ssl
->used
== ssl
->size
)
2055 ssl
->buf
= ((struct sortstr
*)
2056 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2058 ssl
->buf
[ssl
->used
].string
= str
;
2059 ssl
->buf
[ssl
->used
].string2
= str2
;
2060 ssl
->buf
[ssl
->used
].size
= size
;
2061 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2063 ssl
->bytes
+= XSTRING (str
)->size
;
2065 ssl
->bytes
+= XSTRING (str2
)->size
;
2068 /* Return the concatenation of the strings associated with overlays that
2069 begin or end at POS, ignoring overlays that are specific to a window
2070 other than W. The strings are concatenated in the appropriate order:
2071 shorter overlays nest inside longer ones, and higher priority inside
2072 lower. Normally all of the after-strings come first, but zero-sized
2073 overlays have their after-strings ride along with the before-strings
2074 because it would look strange to print them inside-out.
2076 Returns the string length, and stores the contents indirectly through
2077 PSTR, if that variable is non-null. The string may be overwritten by
2078 subsequent calls. */
2080 overlay_strings (pos
, w
, pstr
)
2085 Lisp_Object ov
, overlay
, window
, str
;
2086 int startpos
, endpos
;
2088 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2089 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2090 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2092 overlay
= XCONS (ov
)->car
;
2093 if (!OVERLAYP (overlay
))
2096 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2097 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2100 if (endpos
!= pos
&& startpos
!= pos
)
2102 window
= Foverlay_get (overlay
, Qwindow
);
2103 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2106 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2107 record_overlay_string (&overlay_heads
, str
,
2109 ? Foverlay_get (overlay
, Qafter_string
)
2111 Foverlay_get (overlay
, Qpriority
),
2113 else if (endpos
== pos
2114 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2115 record_overlay_string (&overlay_tails
, str
, Qnil
,
2116 Foverlay_get (overlay
, Qpriority
),
2119 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2121 overlay
= XCONS (ov
)->car
;
2122 if (!OVERLAYP (overlay
))
2125 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2126 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2129 if (endpos
!= pos
&& startpos
!= pos
)
2131 window
= Foverlay_get (overlay
, Qwindow
);
2132 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2135 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2136 record_overlay_string (&overlay_heads
, str
,
2138 ? Foverlay_get (overlay
, Qafter_string
)
2140 Foverlay_get (overlay
, Qpriority
),
2142 else if (endpos
== pos
2143 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2144 record_overlay_string (&overlay_tails
, str
, Qnil
,
2145 Foverlay_get (overlay
, Qpriority
),
2148 if (overlay_tails
.used
> 1)
2149 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2151 if (overlay_heads
.used
> 1)
2152 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2154 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2159 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2161 if (total
> overlay_str_len
)
2162 overlay_str_buf
= (char *)xrealloc (overlay_str_buf
,
2163 overlay_str_len
= total
);
2164 p
= overlay_str_buf
;
2165 for (i
= overlay_tails
.used
; --i
>= 0;)
2167 tem
= overlay_tails
.buf
[i
].string
;
2168 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2169 p
+= XSTRING (tem
)->size
;
2171 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2173 tem
= overlay_heads
.buf
[i
].string
;
2174 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2175 p
+= XSTRING (tem
)->size
;
2176 tem
= overlay_heads
.buf
[i
].string2
;
2179 bcopy (XSTRING (tem
)->data
, p
, XSTRING (tem
)->size
);
2180 p
+= XSTRING (tem
)->size
;
2183 if (p
!= overlay_str_buf
+ total
)
2186 *pstr
= overlay_str_buf
;
2192 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2195 recenter_overlay_lists (buf
, pos
)
2199 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2201 /* See if anything in overlays_before should move to overlays_after. */
2203 /* We don't strictly need prev in this loop; it should always be nil.
2204 But we use it for symmetry and in case that should cease to be true
2205 with some future change. */
2207 for (tail
= buf
->overlays_before
;
2209 prev
= tail
, tail
= next
)
2211 next
= XCONS (tail
)->cdr
;
2212 overlay
= XCONS (tail
)->car
;
2214 /* If the overlay is not valid, get rid of it. */
2215 if (!OVERLAY_VALID (overlay
))
2220 /* Splice the cons cell TAIL out of overlays_before. */
2222 XCONS (prev
)->cdr
= next
;
2224 buf
->overlays_before
= next
;
2230 beg
= OVERLAY_START (overlay
);
2231 end
= OVERLAY_END (overlay
);
2233 if (OVERLAY_POSITION (end
) > pos
)
2235 /* OVERLAY needs to be moved. */
2236 int where
= OVERLAY_POSITION (beg
);
2237 Lisp_Object other
, other_prev
;
2239 /* Splice the cons cell TAIL out of overlays_before. */
2241 XCONS (prev
)->cdr
= next
;
2243 buf
->overlays_before
= next
;
2245 /* Search thru overlays_after for where to put it. */
2247 for (other
= buf
->overlays_after
;
2249 other_prev
= other
, other
= XCONS (other
)->cdr
)
2251 Lisp_Object otherbeg
, otheroverlay
, follower
;
2254 otheroverlay
= XCONS (other
)->car
;
2255 if (! OVERLAY_VALID (otheroverlay
))
2258 otherbeg
= OVERLAY_START (otheroverlay
);
2259 if (OVERLAY_POSITION (otherbeg
) >= where
)
2263 /* Add TAIL to overlays_after before OTHER. */
2264 XCONS (tail
)->cdr
= other
;
2265 if (!NILP (other_prev
))
2266 XCONS (other_prev
)->cdr
= tail
;
2268 buf
->overlays_after
= tail
;
2272 /* We've reached the things that should stay in overlays_before.
2273 All the rest of overlays_before must end even earlier,
2278 /* See if anything in overlays_after should be in overlays_before. */
2280 for (tail
= buf
->overlays_after
;
2282 prev
= tail
, tail
= next
)
2284 next
= XCONS (tail
)->cdr
;
2285 overlay
= XCONS (tail
)->car
;
2287 /* If the overlay is not valid, get rid of it. */
2288 if (!OVERLAY_VALID (overlay
))
2293 /* Splice the cons cell TAIL out of overlays_after. */
2295 XCONS (prev
)->cdr
= next
;
2297 buf
->overlays_after
= next
;
2303 beg
= OVERLAY_START (overlay
);
2304 end
= OVERLAY_END (overlay
);
2306 /* Stop looking, when we know that nothing further
2307 can possibly end before POS. */
2308 if (OVERLAY_POSITION (beg
) > pos
)
2311 if (OVERLAY_POSITION (end
) <= pos
)
2313 /* OVERLAY needs to be moved. */
2314 int where
= OVERLAY_POSITION (end
);
2315 Lisp_Object other
, other_prev
;
2317 /* Splice the cons cell TAIL out of overlays_after. */
2319 XCONS (prev
)->cdr
= next
;
2321 buf
->overlays_after
= next
;
2323 /* Search thru overlays_before for where to put it. */
2325 for (other
= buf
->overlays_before
;
2327 other_prev
= other
, other
= XCONS (other
)->cdr
)
2329 Lisp_Object otherend
, otheroverlay
;
2332 otheroverlay
= XCONS (other
)->car
;
2333 if (! OVERLAY_VALID (otheroverlay
))
2336 otherend
= OVERLAY_END (otheroverlay
);
2337 if (OVERLAY_POSITION (otherend
) <= where
)
2341 /* Add TAIL to overlays_before before OTHER. */
2342 XCONS (tail
)->cdr
= other
;
2343 if (!NILP (other_prev
))
2344 XCONS (other_prev
)->cdr
= tail
;
2346 buf
->overlays_before
= tail
;
2351 XSETFASTINT (buf
->overlay_center
, pos
);
2355 adjust_overlays_for_insert (pos
, length
)
2359 /* After an insertion, the lists are still sorted properly,
2360 but we may need to update the value of the overlay center. */
2361 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2362 XSETFASTINT (current_buffer
->overlay_center
,
2363 XFASTINT (current_buffer
->overlay_center
) + length
);
2367 adjust_overlays_for_delete (pos
, length
)
2371 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2372 /* The deletion was to our right. No change needed; the before- and
2373 after-lists are still consistent. */
2375 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2376 /* The deletion was to our left. We need to adjust the center value
2377 to account for the change in position, but the lists are consistent
2378 given the new value. */
2379 XSETFASTINT (current_buffer
->overlay_center
,
2380 XFASTINT (current_buffer
->overlay_center
) - length
);
2382 /* We're right in the middle. There might be things on the after-list
2383 that now belong on the before-list. Recentering will move them,
2384 and also update the center point. */
2385 recenter_overlay_lists (current_buffer
, pos
);
2388 /* Fix up overlays that were garbled as a result of permuting markers
2389 in the range START through END. Any overlay with at least one
2390 endpoint in this range will need to be unlinked from the overlay
2391 list and reinserted in its proper place.
2392 Such an overlay might even have negative size at this point.
2393 If so, we'll reverse the endpoints. Can you think of anything
2394 better to do in this situation? */
2396 fix_overlays_in_range (start
, end
)
2397 register int start
, end
;
2399 Lisp_Object tem
, overlay
;
2400 Lisp_Object before_list
, after_list
;
2401 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2402 int startpos
, endpos
;
2404 /* This algorithm shifts links around instead of consing and GCing.
2405 The loop invariant is that before_list (resp. after_list) is a
2406 well-formed list except that its last element, the one that
2407 *pbefore (resp. *pafter) points to, is still uninitialized.
2408 So it's not a bug that before_list isn't initialized, although
2409 it may look strange. */
2410 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2412 overlay
= XCONS (*ptail
)->car
;
2413 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2416 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2418 || (startpos
>= start
&& startpos
< end
))
2420 /* If the overlay is backwards, fix that now. */
2421 if (startpos
> endpos
)
2424 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2425 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2426 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2428 /* Add it to the end of the wrong list. Later on,
2429 recenter_overlay_lists will move it to the right place. */
2430 if (endpos
< XINT (current_buffer
->overlay_center
))
2433 pafter
= &XCONS (*ptail
)->cdr
;
2438 pbefore
= &XCONS (*ptail
)->cdr
;
2440 *ptail
= XCONS (*ptail
)->cdr
;
2443 ptail
= &XCONS (*ptail
)->cdr
;
2445 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2447 overlay
= XCONS (*ptail
)->car
;
2448 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2449 if (startpos
>= end
)
2451 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2452 if (startpos
>= start
2453 || (endpos
>= start
&& endpos
< end
))
2455 if (startpos
> endpos
)
2458 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
2459 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
2460 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2462 if (endpos
< XINT (current_buffer
->overlay_center
))
2465 pafter
= &XCONS (*ptail
)->cdr
;
2470 pbefore
= &XCONS (*ptail
)->cdr
;
2472 *ptail
= XCONS (*ptail
)->cdr
;
2475 ptail
= &XCONS (*ptail
)->cdr
;
2478 /* Splice the constructed (wrong) lists into the buffer's lists,
2479 and let the recenter function make it sane again. */
2480 *pbefore
= current_buffer
->overlays_before
;
2481 current_buffer
->overlays_before
= before_list
;
2482 recenter_overlay_lists (current_buffer
,
2483 XINT (current_buffer
->overlay_center
));
2485 *pafter
= current_buffer
->overlays_after
;
2486 current_buffer
->overlays_after
= after_list
;
2487 recenter_overlay_lists (current_buffer
,
2488 XINT (current_buffer
->overlay_center
));
2491 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2492 "Return t if OBJECT is an overlay.")
2496 return (OVERLAYP (object
) ? Qt
: Qnil
);
2499 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 5, 0,
2500 "Create a new overlay with range BEG to END in BUFFER.\n\
2501 If omitted, BUFFER defaults to the current buffer.\n\
2502 BEG and END may be integers or markers.\n\
2503 The fourth arg FRONT-ADVANCE, if non-nil, makes the\n\
2504 front delimiter advance when text is inserted there.\n\
2505 The fifth arg REAR-ADVANCE, if non-nil, makes the\n\
2506 rear delimiter advance when text is inserted there.")
2507 (beg
, end
, buffer
, front_advance
, rear_advance
)
2508 Lisp_Object beg
, end
, buffer
;
2509 Lisp_Object front_advance
, rear_advance
;
2511 Lisp_Object overlay
;
2515 XSETBUFFER (buffer
, current_buffer
);
2517 CHECK_BUFFER (buffer
, 2);
2519 && ! EQ (Fmarker_buffer (beg
), buffer
))
2520 error ("Marker points into wrong buffer");
2522 && ! EQ (Fmarker_buffer (end
), buffer
))
2523 error ("Marker points into wrong buffer");
2525 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2526 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2528 if (XINT (beg
) > XINT (end
))
2531 temp
= beg
; beg
= end
; end
= temp
;
2534 b
= XBUFFER (buffer
);
2536 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2537 end
= Fset_marker (Fmake_marker (), end
, buffer
);
2539 if (!NILP (front_advance
))
2540 XMARKER (beg
)->insertion_type
= 1;
2541 if (!NILP (rear_advance
))
2542 XMARKER (end
)->insertion_type
= 1;
2544 overlay
= allocate_misc ();
2545 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
2546 XOVERLAY (overlay
)->start
= beg
;
2547 XOVERLAY (overlay
)->end
= end
;
2548 XOVERLAY (overlay
)->plist
= Qnil
;
2550 /* Put the new overlay on the wrong list. */
2551 end
= OVERLAY_END (overlay
);
2552 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2553 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2555 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2557 /* This puts it in the right list, and in the right order. */
2558 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2560 /* We don't need to redisplay the region covered by the overlay, because
2561 the overlay has no properties at the moment. */
2566 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
2567 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
2568 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
2569 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
2571 (overlay
, beg
, end
, buffer
)
2572 Lisp_Object overlay
, beg
, end
, buffer
;
2574 struct buffer
*b
, *ob
;
2575 Lisp_Object obuffer
;
2576 int count
= specpdl_ptr
- specpdl
;
2578 CHECK_OVERLAY (overlay
, 0);
2580 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2582 XSETBUFFER (buffer
, current_buffer
);
2583 CHECK_BUFFER (buffer
, 3);
2586 && ! EQ (Fmarker_buffer (beg
), buffer
))
2587 error ("Marker points into wrong buffer");
2589 && ! EQ (Fmarker_buffer (end
), buffer
))
2590 error ("Marker points into wrong buffer");
2592 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2593 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2595 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
2596 return Fdelete_overlay (overlay
);
2598 if (XINT (beg
) > XINT (end
))
2601 temp
= beg
; beg
= end
; end
= temp
;
2604 specbind (Qinhibit_quit
, Qt
);
2606 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2607 b
= XBUFFER (buffer
);
2608 ob
= XBUFFER (obuffer
);
2610 /* If the overlay has changed buffers, do a thorough redisplay. */
2611 if (!EQ (buffer
, obuffer
))
2613 /* Redisplay where the overlay was. */
2614 if (!NILP (obuffer
))
2619 o_beg
= OVERLAY_START (overlay
);
2620 o_end
= OVERLAY_END (overlay
);
2621 o_beg
= OVERLAY_POSITION (o_beg
);
2622 o_end
= OVERLAY_POSITION (o_end
);
2624 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
2627 /* Redisplay where the overlay is going to be. */
2628 redisplay_region (b
, XINT (beg
), XINT (end
));
2631 /* Redisplay the area the overlay has just left, or just enclosed. */
2635 int change_beg
, change_end
;
2637 o_beg
= OVERLAY_START (overlay
);
2638 o_end
= OVERLAY_END (overlay
);
2639 o_beg
= OVERLAY_POSITION (o_beg
);
2640 o_end
= OVERLAY_POSITION (o_end
);
2642 if (XINT (o_beg
) == XINT (beg
))
2643 redisplay_region (b
, XINT (o_end
), XINT (end
));
2644 else if (XINT (o_end
) == XINT (end
))
2645 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
2648 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
2649 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
2650 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
2654 if (!NILP (obuffer
))
2656 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
2657 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
2660 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
2661 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
2663 /* Put the overlay on the wrong list. */
2664 end
= OVERLAY_END (overlay
);
2665 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
2666 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
2668 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
2670 /* This puts it in the right list, and in the right order. */
2671 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
2673 return unbind_to (count
, overlay
);
2676 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
2677 "Delete the overlay OVERLAY from its buffer.")
2679 Lisp_Object overlay
;
2683 int count
= specpdl_ptr
- specpdl
;
2685 CHECK_OVERLAY (overlay
, 0);
2687 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2691 b
= XBUFFER (buffer
);
2693 specbind (Qinhibit_quit
, Qt
);
2695 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
2696 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2698 redisplay_region (b
,
2699 marker_position (OVERLAY_START (overlay
)),
2700 marker_position (OVERLAY_END (overlay
)));
2702 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2703 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2705 return unbind_to (count
, Qnil
);
2708 /* Overlay dissection functions. */
2710 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2711 "Return the position at which OVERLAY starts.")
2713 Lisp_Object overlay
;
2715 CHECK_OVERLAY (overlay
, 0);
2717 return (Fmarker_position (OVERLAY_START (overlay
)));
2720 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2721 "Return the position at which OVERLAY ends.")
2723 Lisp_Object overlay
;
2725 CHECK_OVERLAY (overlay
, 0);
2727 return (Fmarker_position (OVERLAY_END (overlay
)));
2730 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2731 "Return the buffer OVERLAY belongs to.")
2733 Lisp_Object overlay
;
2735 CHECK_OVERLAY (overlay
, 0);
2737 return Fmarker_buffer (OVERLAY_START (overlay
));
2740 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2741 "Return a list of the properties on OVERLAY.\n\
2742 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2745 Lisp_Object overlay
;
2747 CHECK_OVERLAY (overlay
, 0);
2749 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
2753 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2754 "Return a list of the overlays that contain position POS.")
2759 Lisp_Object
*overlay_vec
;
2763 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2766 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2768 /* Put all the overlays we want in a vector in overlay_vec.
2769 Store the length in len. */
2770 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2771 (int *) 0, (int *) 0);
2773 /* Make a list of them all. */
2774 result
= Flist (noverlays
, overlay_vec
);
2776 xfree (overlay_vec
);
2780 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
2781 "Return a list of the overlays that overlap the region BEG ... END.\n\
2782 Overlap means that at least one character is contained within the overlay\n\
2783 and also contained within the specified region.\n\
2784 Empty overlays are included in the result if they are located at BEG\n\
2785 or between BEG and END.")
2787 Lisp_Object beg
, end
;
2790 Lisp_Object
*overlay_vec
;
2794 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
2795 CHECK_NUMBER_COERCE_MARKER (end
, 0);
2798 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2800 /* Put all the overlays we want in a vector in overlay_vec.
2801 Store the length in len. */
2802 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
2803 (int *) 0, (int *) 0);
2805 /* Make a list of them all. */
2806 result
= Flist (noverlays
, overlay_vec
);
2808 xfree (overlay_vec
);
2812 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2814 "Return the next position after POS where an overlay starts or ends.\n\
2815 If there are no more overlay boundaries after POS, return (point-max).")
2821 Lisp_Object
*overlay_vec
;
2825 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2828 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2830 /* Put all the overlays we want in a vector in overlay_vec.
2831 Store the length in len.
2832 endpos gets the position where the next overlay starts. */
2833 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2834 &endpos
, (int *) 0);
2836 /* If any of these overlays ends before endpos,
2837 use its ending point instead. */
2838 for (i
= 0; i
< noverlays
; i
++)
2843 oend
= OVERLAY_END (overlay_vec
[i
]);
2844 oendpos
= OVERLAY_POSITION (oend
);
2845 if (oendpos
< endpos
)
2849 xfree (overlay_vec
);
2850 return make_number (endpos
);
2853 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2854 Sprevious_overlay_change
, 1, 1, 0,
2855 "Return the previous position before POS where an overlay starts or ends.\n\
2856 If there are no more overlay boundaries before POS, return (point-min).")
2862 Lisp_Object
*overlay_vec
;
2867 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2870 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2872 /* At beginning of buffer, we know the answer;
2873 avoid bug subtracting 1 below. */
2874 if (XINT (pos
) == BEGV
)
2877 /* Put all the overlays we want in a vector in overlay_vec.
2878 Store the length in len.
2879 prevpos gets the position of an overlay end. */
2880 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
2881 (int *) 0, &prevpos
);
2883 /* If any of these overlays starts after prevpos,
2884 maybe use its starting point instead. */
2885 for (i
= 0; i
< noverlays
; i
++)
2890 ostart
= OVERLAY_START (overlay_vec
[i
]);
2891 ostartpos
= OVERLAY_POSITION (ostart
);
2892 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2893 prevpos
= ostartpos
;
2896 /* If any overlay ends at pos, consider its starting point too. */
2897 for (tail
= current_buffer
->overlays_before
;
2899 tail
= XCONS (tail
)->cdr
)
2901 Lisp_Object overlay
, ostart
;
2904 overlay
= XCONS (tail
)->car
;
2906 ostart
= OVERLAY_START (overlay
);
2907 ostartpos
= OVERLAY_POSITION (ostart
);
2908 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2909 prevpos
= ostartpos
;
2912 xfree (overlay_vec
);
2913 return make_number (prevpos
);
2916 /* These functions are for debugging overlays. */
2918 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2919 "Return a pair of lists giving all the overlays of the current buffer.\n\
2920 The car has all the overlays before the overlay center;\n\
2921 the cdr has all the overlays after the overlay center.\n\
2922 Recentering overlays moves overlays between these lists.\n\
2923 The lists you get are copies, so that changing them has no effect.\n\
2924 However, the overlays you get are the real objects that the buffer uses.")
2927 Lisp_Object before
, after
;
2928 before
= current_buffer
->overlays_before
;
2930 before
= Fcopy_sequence (before
);
2931 after
= current_buffer
->overlays_after
;
2933 after
= Fcopy_sequence (after
);
2935 return Fcons (before
, after
);
2938 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2939 "Recenter the overlays of the current buffer around position POS.")
2943 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2945 recenter_overlay_lists (current_buffer
, XINT (pos
));
2949 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2950 "Get the property of overlay OVERLAY with property name PROP.")
2952 Lisp_Object overlay
, prop
;
2954 Lisp_Object plist
, fallback
;
2956 CHECK_OVERLAY (overlay
, 0);
2960 for (plist
= XOVERLAY (overlay
)->plist
;
2961 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2962 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2964 if (EQ (XCONS (plist
)->car
, prop
))
2965 return XCONS (XCONS (plist
)->cdr
)->car
;
2966 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2969 tem
= Fcar (Fcdr (plist
));
2971 fallback
= Fget (tem
, prop
);
2978 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2979 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2980 (overlay
, prop
, value
)
2981 Lisp_Object overlay
, prop
, value
;
2983 Lisp_Object tail
, buffer
;
2986 CHECK_OVERLAY (overlay
, 0);
2988 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2990 for (tail
= XOVERLAY (overlay
)->plist
;
2991 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2992 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2993 if (EQ (XCONS (tail
)->car
, prop
))
2995 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2996 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2999 /* It wasn't in the list, so add it to the front. */
3000 changed
= !NILP (value
);
3001 XOVERLAY (overlay
)->plist
3002 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
3004 if (! NILP (buffer
))
3007 redisplay_region (XBUFFER (buffer
),
3008 marker_position (OVERLAY_START (overlay
)),
3009 marker_position (OVERLAY_END (overlay
)));
3010 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
3011 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
3012 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
3013 Fdelete_overlay (overlay
);
3018 /* Subroutine of report_overlay_modification. */
3020 /* Lisp vector holding overlay hook functions to call.
3021 Vector elements come in pairs.
3022 Each even-index element is a list of hook functions.
3023 The following odd-index element is the overlay they came from.
3025 Before the buffer change, we fill in this vector
3026 as we call overlay hook functions.
3027 After the buffer change, we get the functions to call from this vector.
3028 This way we always call the same functions before and after the change. */
3029 static Lisp_Object last_overlay_modification_hooks
;
3031 /* Number of elements actually used in last_overlay_modification_hooks. */
3032 static int last_overlay_modification_hooks_used
;
3034 /* Add one functionlist/overlay pair
3035 to the end of last_overlay_modification_hooks. */
3038 add_overlay_mod_hooklist (functionlist
, overlay
)
3039 Lisp_Object functionlist
, overlay
;
3041 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3043 if (last_overlay_modification_hooks_used
== oldsize
)
3046 old
= last_overlay_modification_hooks
;
3047 last_overlay_modification_hooks
3048 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3049 bcopy (XVECTOR (old
)->contents
,
3050 XVECTOR (last_overlay_modification_hooks
)->contents
,
3051 sizeof (Lisp_Object
) * oldsize
);
3053 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3054 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3057 /* Run the modification-hooks of overlays that include
3058 any part of the text in START to END.
3059 If this change is an insertion, also
3060 run the insert-before-hooks of overlay starting at END,
3061 and the insert-after-hooks of overlay ending at START.
3063 This is called both before and after the modification.
3064 AFTER is nonzero when we call after the modification.
3066 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3067 When AFTER is nonzero, they are the start position,
3068 the position after the inserted new text,
3069 and the length of deleted or replaced old text. */
3072 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3073 Lisp_Object start
, end
;
3075 Lisp_Object arg1
, arg2
, arg3
;
3077 Lisp_Object prop
, overlay
, tail
;
3078 /* 1 if this change is an insertion. */
3079 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3081 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3085 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3089 /* Call the functions recorded in last_overlay_modification_hooks
3090 rather than scanning the overlays again.
3091 First copy the vector contents, in case some of these hooks
3092 do subsequent modification of the buffer. */
3093 int size
= last_overlay_modification_hooks_used
;
3094 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3097 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3098 copy
, size
* sizeof (Lisp_Object
));
3100 gcpro1
.nvars
= size
;
3102 for (i
= 0; i
< size
;)
3104 Lisp_Object prop
, overlay
;
3106 overlay
= copy
[i
++];
3107 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3113 /* We are being called before a change.
3114 Scan the overlays to find the functions to call. */
3115 last_overlay_modification_hooks_used
= 0;
3117 for (tail
= current_buffer
->overlays_before
;
3119 tail
= XCONS (tail
)->cdr
)
3121 int startpos
, endpos
;
3122 Lisp_Object ostart
, oend
;
3124 overlay
= XCONS (tail
)->car
;
3126 ostart
= OVERLAY_START (overlay
);
3127 oend
= OVERLAY_END (overlay
);
3128 endpos
= OVERLAY_POSITION (oend
);
3129 if (XFASTINT (start
) > endpos
)
3131 startpos
= OVERLAY_POSITION (ostart
);
3132 if (insertion
&& (XFASTINT (start
) == startpos
3133 || XFASTINT (end
) == startpos
))
3135 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3138 /* Copy TAIL in case the hook recenters the overlay lists. */
3140 tail
= Fcopy_sequence (tail
);
3142 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3145 if (insertion
&& (XFASTINT (start
) == endpos
3146 || XFASTINT (end
) == endpos
))
3148 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3152 tail
= Fcopy_sequence (tail
);
3154 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3157 /* Test for intersecting intervals. This does the right thing
3158 for both insertion and deletion. */
3159 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3161 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3165 tail
= Fcopy_sequence (tail
);
3167 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3173 for (tail
= current_buffer
->overlays_after
;
3175 tail
= XCONS (tail
)->cdr
)
3177 int startpos
, endpos
;
3178 Lisp_Object ostart
, oend
;
3180 overlay
= XCONS (tail
)->car
;
3182 ostart
= OVERLAY_START (overlay
);
3183 oend
= OVERLAY_END (overlay
);
3184 startpos
= OVERLAY_POSITION (ostart
);
3185 endpos
= OVERLAY_POSITION (oend
);
3186 if (XFASTINT (end
) < startpos
)
3188 if (insertion
&& (XFASTINT (start
) == startpos
3189 || XFASTINT (end
) == startpos
))
3191 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3195 tail
= Fcopy_sequence (tail
);
3197 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3200 if (insertion
&& (XFASTINT (start
) == endpos
3201 || XFASTINT (end
) == endpos
))
3203 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3207 tail
= Fcopy_sequence (tail
);
3209 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3212 /* Test for intersecting intervals. This does the right thing
3213 for both insertion and deletion. */
3214 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3216 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3220 tail
= Fcopy_sequence (tail
);
3222 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3231 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3232 Lisp_Object list
, overlay
;
3234 Lisp_Object arg1
, arg2
, arg3
;
3236 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3238 GCPRO4 (list
, arg1
, arg2
, arg3
);
3240 add_overlay_mod_hooklist (list
, overlay
);
3242 while (!NILP (list
))
3245 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3247 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3253 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3256 evaporate_overlays (pos
)
3259 Lisp_Object tail
, overlay
, hit_list
;
3262 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3263 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3264 tail
= XCONS (tail
)->cdr
)
3267 overlay
= XCONS (tail
)->car
;
3268 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3271 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3272 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3273 hit_list
= Fcons (overlay
, hit_list
);
3276 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3277 tail
= XCONS (tail
)->cdr
)
3280 overlay
= XCONS (tail
)->car
;
3281 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3284 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3285 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3286 hit_list
= Fcons (overlay
, hit_list
);
3288 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3289 Fdelete_overlay (XCONS (hit_list
)->car
);
3292 /* Somebody has tried to store a value with an unacceptable type
3293 into the buffer-local slot with offset OFFSET. */
3295 buffer_slot_type_mismatch (offset
)
3300 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3301 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3303 case Lisp_Int
: type_name
= "integers"; break;
3304 case Lisp_String
: type_name
= "strings"; break;
3305 case Lisp_Symbol
: type_name
= "symbols"; break;
3310 error ("only %s should be stored in the buffer-local variable %s",
3311 type_name
, XSYMBOL (sym
)->name
->data
);
3316 register Lisp_Object tem
;
3318 /* Make sure all markable slots in buffer_defaults
3319 are initialized reasonably, so mark_buffer won't choke. */
3320 reset_buffer (&buffer_defaults
);
3321 reset_buffer_local_variables (&buffer_defaults
);
3322 reset_buffer (&buffer_local_symbols
);
3323 reset_buffer_local_variables (&buffer_local_symbols
);
3324 /* Prevent GC from getting confused. */
3325 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3326 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3327 #ifdef USE_TEXT_PROPERTIES
3328 BUF_INTERVALS (&buffer_defaults
) = 0;
3329 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3331 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3332 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3334 /* Set up the default values of various buffer slots. */
3335 /* Must do these before making the first buffer! */
3337 /* real setup is done in loaddefs.el */
3338 buffer_defaults
.mode_line_format
= build_string ("%-");
3339 buffer_defaults
.abbrev_mode
= Qnil
;
3340 buffer_defaults
.overwrite_mode
= Qnil
;
3341 buffer_defaults
.case_fold_search
= Qt
;
3342 buffer_defaults
.auto_fill_function
= Qnil
;
3343 buffer_defaults
.selective_display
= Qnil
;
3345 buffer_defaults
.selective_display_ellipses
= Qt
;
3347 buffer_defaults
.abbrev_table
= Qnil
;
3348 buffer_defaults
.display_table
= Qnil
;
3349 buffer_defaults
.undo_list
= Qnil
;
3350 buffer_defaults
.mark_active
= Qnil
;
3351 buffer_defaults
.file_format
= Qnil
;
3352 buffer_defaults
.overlays_before
= Qnil
;
3353 buffer_defaults
.overlays_after
= Qnil
;
3354 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3356 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3357 buffer_defaults
.truncate_lines
= Qnil
;
3358 buffer_defaults
.ctl_arrow
= Qt
;
3361 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3363 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3364 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3365 buffer_defaults
.cache_long_line_scans
= Qnil
;
3366 buffer_defaults
.file_truename
= Qnil
;
3368 /* Assign the local-flags to the slots that have default values.
3369 The local flag is a bit that is used in the buffer
3370 to say that it has its own local value for the slot.
3371 The local flag bits are in the local_var_flags slot of the buffer. */
3373 /* Nothing can work if this isn't true */
3374 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3376 /* 0 means not a lisp var, -1 means always local, else mask */
3377 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3378 XSETINT (buffer_local_flags
.filename
, -1);
3379 XSETINT (buffer_local_flags
.directory
, -1);
3380 XSETINT (buffer_local_flags
.backed_up
, -1);
3381 XSETINT (buffer_local_flags
.save_length
, -1);
3382 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3383 XSETINT (buffer_local_flags
.read_only
, -1);
3384 XSETINT (buffer_local_flags
.major_mode
, -1);
3385 XSETINT (buffer_local_flags
.mode_name
, -1);
3386 XSETINT (buffer_local_flags
.undo_list
, -1);
3387 XSETINT (buffer_local_flags
.mark_active
, -1);
3388 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3389 XSETINT (buffer_local_flags
.file_truename
, -1);
3390 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3391 XSETINT (buffer_local_flags
.file_format
, -1);
3393 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3394 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3395 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3396 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3397 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3398 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3400 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3402 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3403 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3404 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3405 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3406 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3407 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3408 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3409 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3410 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3412 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3415 Vbuffer_alist
= Qnil
;
3419 QSFundamental
= build_string ("Fundamental");
3421 Qfundamental_mode
= intern ("fundamental-mode");
3422 buffer_defaults
.major_mode
= Qfundamental_mode
;
3424 Qmode_class
= intern ("mode-class");
3426 Qprotected_field
= intern ("protected-field");
3428 Qpermanent_local
= intern ("permanent-local");
3430 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3432 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3434 /* super-magic invisible buffer */
3435 Vbuffer_alist
= Qnil
;
3437 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3442 char buf
[MAXPATHLEN
+1];
3444 struct stat dotstat
, pwdstat
;
3448 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3450 /* If PWD is accurate, use it instead of calling getwd. This is faster
3451 when PWD is right, and may avoid a fatal error. */
3452 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
3453 && stat (pwd
, &pwdstat
) == 0
3454 && stat (".", &dotstat
) == 0
3455 && dotstat
.st_ino
== pwdstat
.st_ino
3456 && dotstat
.st_dev
== pwdstat
.st_dev
3457 && strlen (pwd
) < MAXPATHLEN
)
3459 else if (getwd (buf
) == 0)
3460 fatal ("`getwd' failed: %s\n", buf
);
3463 /* Maybe this should really use some standard subroutine
3464 whose definition is filename syntax dependent. */
3466 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
3468 buf
[rc
] = DIRECTORY_SEP
;
3471 #endif /* not VMS */
3472 current_buffer
->directory
= build_string (buf
);
3474 temp
= get_minibuffer (0);
3475 XBUFFER (temp
)->directory
= current_buffer
->directory
;
3478 /* initialize the buffer routines */
3481 extern Lisp_Object Qdisabled
;
3483 staticpro (&last_overlay_modification_hooks
);
3484 last_overlay_modification_hooks
3485 = Fmake_vector (make_number (10), Qnil
);
3487 staticpro (&Vbuffer_defaults
);
3488 staticpro (&Vbuffer_local_symbols
);
3489 staticpro (&Qfundamental_mode
);
3490 staticpro (&Qmode_class
);
3491 staticpro (&QSFundamental
);
3492 staticpro (&Vbuffer_alist
);
3493 staticpro (&Qprotected_field
);
3494 staticpro (&Qpermanent_local
);
3495 staticpro (&Qkill_buffer_hook
);
3496 Qoverlayp
= intern ("overlayp");
3497 staticpro (&Qoverlayp
);
3498 Qevaporate
= intern ("evaporate");
3499 staticpro (&Qevaporate
);
3500 Qmodification_hooks
= intern ("modification-hooks");
3501 staticpro (&Qmodification_hooks
);
3502 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
3503 staticpro (&Qinsert_in_front_hooks
);
3504 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
3505 staticpro (&Qinsert_behind_hooks
);
3506 Qget_file_buffer
= intern ("get-file-buffer");
3507 staticpro (&Qget_file_buffer
);
3508 Qpriority
= intern ("priority");
3509 staticpro (&Qpriority
);
3510 Qwindow
= intern ("window");
3511 staticpro (&Qwindow
);
3512 Qbefore_string
= intern ("before-string");
3513 staticpro (&Qbefore_string
);
3514 Qafter_string
= intern ("after-string");
3515 staticpro (&Qafter_string
);
3516 Qfirst_change_hook
= intern ("first-change-hook");
3517 staticpro (&Qfirst_change_hook
);
3518 Qbefore_change_functions
= intern ("before-change-functions");
3519 staticpro (&Qbefore_change_functions
);
3520 Qafter_change_functions
= intern ("after-change-functions");
3521 staticpro (&Qafter_change_functions
);
3523 Fput (Qprotected_field
, Qerror_conditions
,
3524 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
3525 Fput (Qprotected_field
, Qerror_message
,
3526 build_string ("Attempt to modify a protected field"));
3528 /* All these use DEFVAR_LISP_NOPRO because the slots in
3529 buffer_defaults will all be marked via Vbuffer_defaults. */
3531 DEFVAR_LISP_NOPRO ("default-mode-line-format",
3532 &buffer_defaults
.mode_line_format
,
3533 "Default value of `mode-line-format' for buffers that don't override it.\n\
3534 This is the same as (default-value 'mode-line-format).");
3536 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
3537 &buffer_defaults
.abbrev_mode
,
3538 "Default value of `abbrev-mode' for buffers that do not override it.\n\
3539 This is the same as (default-value 'abbrev-mode).");
3541 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
3542 &buffer_defaults
.ctl_arrow
,
3543 "Default value of `ctl-arrow' for buffers that do not override it.\n\
3544 This is the same as (default-value 'ctl-arrow).");
3546 DEFVAR_LISP_NOPRO ("default-truncate-lines",
3547 &buffer_defaults
.truncate_lines
,
3548 "Default value of `truncate-lines' for buffers that do not override it.\n\
3549 This is the same as (default-value 'truncate-lines).");
3551 DEFVAR_LISP_NOPRO ("default-fill-column",
3552 &buffer_defaults
.fill_column
,
3553 "Default value of `fill-column' for buffers that do not override it.\n\
3554 This is the same as (default-value 'fill-column).");
3556 DEFVAR_LISP_NOPRO ("default-left-margin",
3557 &buffer_defaults
.left_margin
,
3558 "Default value of `left-margin' for buffers that do not override it.\n\
3559 This is the same as (default-value 'left-margin).");
3561 DEFVAR_LISP_NOPRO ("default-tab-width",
3562 &buffer_defaults
.tab_width
,
3563 "Default value of `tab-width' for buffers that do not override it.\n\
3564 This is the same as (default-value 'tab-width).");
3566 DEFVAR_LISP_NOPRO ("default-case-fold-search",
3567 &buffer_defaults
.case_fold_search
,
3568 "Default value of `case-fold-search' for buffers that don't override it.\n\
3569 This is the same as (default-value 'case-fold-search).");
3572 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
3573 &buffer_defaults
.buffer_file_type
,
3574 "Default file type for buffers that do not override it.\n\
3575 This is the same as (default-value 'buffer-file-type).\n\
3576 The file type is nil for text, t for binary.");
3579 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
3582 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
3583 But make-docfile finds it!
3584 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
3586 "Template for displaying mode line for current buffer.\n\
3587 Each buffer has its own value of this variable.\n\
3588 Value may be a string, a symbol or a list or cons cell.\n\
3589 For a symbol, its value is used (but it is ignored if t or nil).\n\
3590 A string appearing directly as the value of a symbol is processed verbatim\n\
3591 in that the %-constructs below are not recognized.\n\
3592 For a list whose car is a symbol, the symbol's value is taken,\n\
3593 and if that is non-nil, the cadr of the list is processed recursively.\n\
3594 Otherwise, the caddr of the list (if there is one) is processed.\n\
3595 For a list whose car is a string or list, each element is processed\n\
3596 recursively and the results are effectively concatenated.\n\
3597 For a list whose car is an integer, the cdr of the list is processed\n\
3598 and padded (if the number is positive) or truncated (if negative)\n\
3599 to the width specified by that number.\n\
3600 A string is printed verbatim in the mode line except for %-constructs:\n\
3601 (%-constructs are allowed when the string is the entire mode-line-format\n\
3602 or when it is found in a cons-cell or a list)\n\
3603 %b -- print buffer name. %f -- print visited file name.\n\
3604 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
3605 % means buffer is read-only and * means it is modified.\n\
3606 For a modified read-only buffer, %* gives % and %+ gives *.\n\
3607 %s -- print process status. %l -- print the current line number.\n\
3608 %c -- print the current column number (this makes editing slower).\n\
3609 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
3610 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
3611 or print Bottom or All.\n\
3612 %n -- print Narrow if appropriate.\n\
3613 %t -- print T if files is text, B if binary.\n\
3614 %[ -- print one [ for each recursive editing level. %] similar.\n\
3615 %% -- print %. %- -- print infinitely many dashes.\n\
3616 Decimal digits after the % specify field width to which to pad.");
3619 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
3620 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
3621 nil here means use current buffer's major mode.");
3623 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
3624 make_number (Lisp_Symbol
),
3625 "Symbol for current buffer's major mode.");
3627 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
3628 make_number (Lisp_String
),
3629 "Pretty name of current buffer's major mode (a string).");
3631 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
3632 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
3633 Automatically becomes buffer-local when set in any fashion.");
3635 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
3637 "*Non-nil if searches should ignore case.\n\
3638 Automatically becomes buffer-local when set in any fashion.");
3640 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
3641 make_number (Lisp_Int
),
3642 "*Column beyond which automatic line-wrapping should happen.\n\
3643 Automatically becomes buffer-local when set in any fashion.");
3645 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
3646 make_number (Lisp_Int
),
3647 "*Column for the default indent-line-function to indent to.\n\
3648 Linefeed indents to this column in Fundamental mode.\n\
3649 Automatically becomes buffer-local when set in any fashion.");
3651 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
3652 make_number (Lisp_Int
),
3653 "*Distance between tab stops (for display of tab characters), in columns.\n\
3654 Automatically becomes buffer-local when set in any fashion.");
3656 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
3657 "*Non-nil means display control chars with uparrow.\n\
3658 Nil means use backslash and octal digits.\n\
3659 Automatically becomes buffer-local when set in any fashion.\n\
3660 This variable does not apply to characters whose display is specified\n\
3661 in the current display table (if there is one).");
3663 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
3664 "*Non-nil means do not display continuation lines;\n\
3665 give each line of text one screen line.\n\
3666 Automatically becomes buffer-local when set in any fashion.\n\
3668 Note that this is overridden by the variable\n\
3669 `truncate-partial-width-windows' if that variable is non-nil\n\
3670 and this buffer is not full-frame width.");
3673 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
3675 "Non-nil if the visited file is a binary file.\n\
3676 This variable is meaningful on MS-DOG and Windows NT.\n\
3677 On those systems, it is automatically local in every buffer.\n\
3678 On other systems, this variable is normally always nil.");
3681 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
3682 make_number (Lisp_String
),
3683 "Name of default directory of current buffer. Should end with slash.\n\
3684 Each buffer has its own value of this variable.");
3686 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
3688 "Function called (if non-nil) to perform auto-fill.\n\
3689 It is called after self-inserting a space at a column beyond `fill-column'.\n\
3690 Each buffer has its own value of this variable.\n\
3691 NOTE: This variable is not an ordinary hook;\n\
3692 It may not be a list of functions.");
3694 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
3695 make_number (Lisp_String
),
3696 "Name of file visited in current buffer, or nil if not visiting a file.\n\
3697 Each buffer has its own value of this variable.");
3699 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
3700 make_number (Lisp_String
),
3701 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
3702 The truename of a file is calculated by `file-truename'\n\
3703 and then abbreviated with `abbreviate-file-name'.\n\
3704 Each buffer has its own value of this variable.");
3706 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
3707 ¤t_buffer
->auto_save_file_name
,
3708 make_number (Lisp_String
),
3709 "Name of file for auto-saving current buffer,\n\
3710 or nil if buffer should not be auto-saved.\n\
3711 Each buffer has its own value of this variable.");
3713 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
3714 "Non-nil if this buffer is read-only.\n\
3715 Each buffer has its own value of this variable.");
3717 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
3718 "Non-nil if this buffer's file has been backed up.\n\
3719 Backing up is done before the first time the file is saved.\n\
3720 Each buffer has its own value of this variable.");
3722 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
3723 make_number (Lisp_Int
),
3724 "Length of current buffer when last read in, saved or auto-saved.\n\
3726 Each buffer has its own value of this variable.");
3728 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
3730 "Non-nil enables selective display:\n\
3731 Integer N as value means display only lines\n\
3732 that start with less than n columns of space.\n\
3733 A value of t means, after a ^M, all the rest of the line is invisible.\n\
3734 Then ^M's in the file are written into files as newlines.\n\n\
3735 Automatically becomes buffer-local when set in any fashion.");
3738 DEFVAR_PER_BUFFER ("selective-display-ellipses",
3739 ¤t_buffer
->selective_display_ellipses
,
3741 "t means display ... on previous line when a line is invisible.\n\
3742 Automatically becomes buffer-local when set in any fashion.");
3745 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
3746 "Non-nil if self-insertion should replace existing text.\n\
3747 The value should be one of `overwrite-mode-textual',\n\
3748 `overwrite-mode-binary', or nil.\n\
3749 If it is `overwrite-mode-textual', self-insertion still\n\
3750 inserts at the end of a line, and inserts when point is before a tab,\n\
3751 until the tab is filled in.\n\
3752 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
3753 Automatically becomes buffer-local when set in any fashion.");
3755 #if 0 /* The doc string is too long for some compilers,
3756 but make-docfile can find it in this comment. */
3757 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3759 "Display table that controls display of the contents of current buffer.\n\
3760 Automatically becomes buffer-local when set in any fashion.\n\
3761 The display table is a char-table created with `make-display-table'.\n\
3762 The ordinary char-table elements control how to display each possible text\n\
3763 character. Each value should be a vector of characters or nil;\n\
3764 nil means display the character in the default fashion.\n\
3765 There are six extra slots to control the display of\n\
3766 the end of a truncated screen line (extra-slot 0, a single character);\n\
3767 the end of a continued line (extra-slot 1, a single character);\n\
3768 the escape character used to display character codes in octal\n\
3769 (extra-slot 2, a single character);\n\
3770 the character used as an arrow for control characters (extra-slot 3,\n\
3771 a single character);\n\
3772 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
3773 a vector of characters);\n\
3774 the character used to draw the border between side-by-side windows\n\
3775 (extra-slot 5, a single character).\n\
3776 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
3777 If this variable is nil, the value of `standard-display-table' is used.\n\
3778 Each window can have its own, overriding display table.");
3780 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
3783 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
3786 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
3787 "Function to call before each text change.\n\
3788 Two arguments are passed to the function: the positions of\n\
3789 the beginning and end of the range of old text to be changed.\n\
3790 \(For an insertion, the beginning and end are at the same place.)\n\
3791 No information is given about the length of the text after the change.\n\
3793 Buffer changes made while executing the `before-change-function'\n\
3794 don't call any before-change or after-change functions.\n\
3795 That's because these variables are temporarily set to nil.\n\
3796 As a result, a hook function cannot straightforwardly alter the value of\n\
3797 these variables. See the Emacs Lisp manual for a way of\n\
3798 accomplishing an equivalent result by using other variables.");
3799 Vbefore_change_function
= Qnil
;
3801 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
3802 "Function to call after each text change.\n\
3803 Three arguments are passed to the function: the positions of\n\
3804 the beginning and end of the range of changed text,\n\
3805 and the length of the pre-change text replaced by that range.\n\
3806 \(For an insertion, the pre-change length is zero;\n\
3807 for a deletion, that length is the number of characters deleted,\n\
3808 and the post-change beginning and end are at the same place.)\n\
3810 Buffer changes made while executing the `after-change-function'\n\
3811 don't call any before-change or after-change functions.\n\
3812 That's because these variables are temporarily set to nil.\n\
3813 As a result, a hook function cannot straightforwardly alter the value of\n\
3814 these variables. See the Emacs Lisp manual for a way of\n\
3815 accomplishing an equivalent result by using other variables.");
3816 Vafter_change_function
= Qnil
;
3818 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
3819 "List of functions to call before each text change.\n\
3820 Two arguments are passed to each function: the positions of\n\
3821 the beginning and end of the range of old text to be changed.\n\
3822 \(For an insertion, the beginning and end are at the same place.)\n\
3823 No information is given about the length of the text after the change.\n\
3825 Buffer changes made while executing the `before-change-functions'\n\
3826 don't call any before-change or after-change functions.\n\
3827 That's because these variables are temporarily set to nil.\n\
3828 As a result, a hook function cannot straightforwardly alter the value of\n\
3829 these variables. See the Emacs Lisp manual for a way of\n\
3830 accomplishing an equivalent result by using other variables.");
3831 Vbefore_change_functions
= Qnil
;
3833 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
3834 "List of function to call after each text change.\n\
3835 Three arguments are passed to each function: the positions of\n\
3836 the beginning and end of the range of changed text,\n\
3837 and the length of the pre-change text replaced by that range.\n\
3838 \(For an insertion, the pre-change length is zero;\n\
3839 for a deletion, that length is the number of characters deleted,\n\
3840 and the post-change beginning and end are at the same place.)\n\
3842 Buffer changes made while executing the `after-change-functions'\n\
3843 don't call any before-change or after-change functions.\n\
3844 That's because these variables are temporarily set to nil.\n\
3845 As a result, a hook function cannot straightforwardly alter the value of\n\
3846 these variables. See the Emacs Lisp manual for a way of\n\
3847 accomplishing an equivalent result by using other variables.");
3849 Vafter_change_functions
= Qnil
;
3851 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
3852 "A list of functions to call before changing a buffer which is unmodified.\n\
3853 The functions are run using the `run-hooks' function.");
3854 Vfirst_change_hook
= Qnil
;
3856 #if 0 /* The doc string is too long for some compilers,
3857 but make-docfile can find it in this comment. */
3858 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3859 "List of undo entries in current buffer.\n\
3860 Recent changes come first; older changes follow newer.\n\
3862 An entry (BEG . END) represents an insertion which begins at\n\
3863 position BEG and ends at position END.\n\
3865 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
3866 from (abs POSITION). If POSITION is positive, point was at the front\n\
3867 of the text being deleted; if negative, point was at the end.\n\
3869 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
3870 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
3871 of the visited file's modification time, as of that time. If the\n\
3872 modification time of the most recent save is different, this entry is\n\
3875 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
3876 was modified between BEG and END. PROPERTY is the property name,\n\
3877 and VALUE is the old value.\n\
3879 An entry (MARKER . DISTANCE) indicates that the marker MARKER\n\
3880 was adjusted in position by the offset DISTANCE (an integer).\n\
3882 An entry of the form POSITION indicates that point was at the buffer\n\
3883 location given by the integer. Undoing an entry of this form places\n\
3884 point at POSITION.\n\
3886 nil marks undo boundaries. The undo command treats the changes\n\
3887 between two undo boundaries as a single step to be undone.\n\
3889 If the value of the variable is t, undo information is not recorded.");
3891 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3894 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3895 "Non-nil means the mark and region are currently active in this buffer.\n\
3896 Automatically local in all buffers.");
3898 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3899 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3900 This variable is buffer-local, in all buffers.\n\
3902 Normally, the line-motion functions work by scanning the buffer for\n\
3903 newlines. Columnar operations (like move-to-column and\n\
3904 compute-motion) also work by scanning the buffer, summing character\n\
3905 widths as they go. This works well for ordinary text, but if the\n\
3906 buffer's lines are very long (say, more than 500 characters), these\n\
3907 motion functions will take longer to execute. Emacs may also take\n\
3908 longer to update the display.\n\
3910 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3911 results of their scans, and consult the cache to avoid rescanning\n\
3912 regions of the buffer until the text is modified. The caches are most\n\
3913 beneficial when they prevent the most searching---that is, when the\n\
3914 buffer contains long lines and large regions of characters with the\n\
3915 same, fixed screen width.\n\
3917 When cache-long-line-scans is non-nil, processing short lines will\n\
3918 become slightly slower (because of the overhead of consulting the\n\
3919 cache), and the caches will use memory roughly proportional to the\n\
3920 number of newlines and characters whose screen width varies.\n\
3922 The caches require no explicit maintenance; their accuracy is\n\
3923 maintained internally by the Emacs primitives. Enabling or disabling\n\
3924 the cache should not affect the behavior of any of the motion\n\
3925 functions; it should only affect their performance.");
3927 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
3928 "Value of point before the last series of scroll operations, or nil.");
3930 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
3931 "List of formats to use when saving this buffer.\n\
3932 Formats are defined by `format-alist'. This variable is\n\
3933 set when a file is visited. Automatically local in all buffers.");
3935 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
3936 ¤t_buffer
->invisibility_spec
, Qnil
,
3937 "Invisibility spec of this buffer.\n\
3938 The default is t, which means that text is invisible\n\
3939 if it has a non-nil `invisible' property.\n\
3940 If the value is a list, a text character is invisible if its `invisible'\n\
3941 property is an element in that list.\n\
3942 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
3943 then characters with property value PROP are invisible,\n\
3944 and they have an ellipsis as well if ELLIPSIS is non-nil.");
3946 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3947 "*Non-nil means deactivate the mark when the buffer contents change.");
3948 Vtransient_mark_mode
= Qnil
;
3950 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3951 "*Non-nil means disregard read-only status of buffers or characters.\n\
3952 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3953 text properties. If the value is a list, disregard `buffer-read-only'\n\
3954 and disregard a `read-only' text property if the property value\n\
3955 is a member of the list.");
3956 Vinhibit_read_only
= Qnil
;
3958 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3959 "List of functions called with no args to query before killing a buffer.");
3960 Vkill_buffer_query_functions
= Qnil
;
3962 defsubr (&Sbuffer_live_p
);
3963 defsubr (&Sbuffer_list
);
3964 defsubr (&Sget_buffer
);
3965 defsubr (&Sget_file_buffer
);
3966 defsubr (&Sget_buffer_create
);
3967 defsubr (&Smake_indirect_buffer
);
3968 defsubr (&Sgenerate_new_buffer_name
);
3969 defsubr (&Sbuffer_name
);
3970 /*defsubr (&Sbuffer_number);*/
3971 defsubr (&Sbuffer_file_name
);
3972 defsubr (&Sbuffer_base_buffer
);
3973 defsubr (&Sbuffer_local_variables
);
3974 defsubr (&Sbuffer_modified_p
);
3975 defsubr (&Sset_buffer_modified_p
);
3976 defsubr (&Sbuffer_modified_tick
);
3977 defsubr (&Srename_buffer
);
3978 defsubr (&Sother_buffer
);
3979 defsubr (&Sbuffer_disable_undo
);
3980 defsubr (&Sbuffer_enable_undo
);
3981 defsubr (&Skill_buffer
);
3982 defsubr (&Serase_buffer
);
3983 defsubr (&Sset_buffer_major_mode
);
3984 defsubr (&Sswitch_to_buffer
);
3985 defsubr (&Spop_to_buffer
);
3986 defsubr (&Scurrent_buffer
);
3987 defsubr (&Sset_buffer
);
3988 defsubr (&Sbarf_if_buffer_read_only
);
3989 defsubr (&Sbury_buffer
);
3990 defsubr (&Skill_all_local_variables
);
3992 defsubr (&Soverlayp
);
3993 defsubr (&Smake_overlay
);
3994 defsubr (&Sdelete_overlay
);
3995 defsubr (&Smove_overlay
);
3996 defsubr (&Soverlay_start
);
3997 defsubr (&Soverlay_end
);
3998 defsubr (&Soverlay_buffer
);
3999 defsubr (&Soverlay_properties
);
4000 defsubr (&Soverlays_at
);
4001 defsubr (&Soverlays_in
);
4002 defsubr (&Snext_overlay_change
);
4003 defsubr (&Sprevious_overlay_change
);
4004 defsubr (&Soverlay_recenter
);
4005 defsubr (&Soverlay_lists
);
4006 defsubr (&Soverlay_get
);
4007 defsubr (&Soverlay_put
);
4012 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
4013 initial_define_key (control_x_map
, 'k', "kill-buffer");
4015 /* This must not be in syms_of_buffer, because Qdisabled is not
4016 initialized when that function gets called. */
4017 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);