1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985,86,87,88,89,93,94,95,97,98, 1999
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>
31 /* in 4.1, param.h fails to define this. */
32 #define MAXPATHLEN 1024
33 #endif /* not MAXPATHLEN */
43 #include "intervals.h"
48 #include "region-cache.h"
50 #include "blockinput.h"
53 struct buffer
*current_buffer
; /* the current buffer */
55 /* First buffer in chain of all buffers (in reverse order of creation).
56 Threaded through ->next. */
58 struct buffer
*all_buffers
;
60 /* This structure holds the default values of the buffer-local variables
61 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
62 The default value occupies the same slot in this structure
63 as an individual buffer's value occupies in that buffer.
64 Setting the default value also goes through the alist of buffers
65 and stores into each buffer that does not say it has a local value. */
67 struct buffer buffer_defaults
;
69 /* A Lisp_Object pointer to the above, used for staticpro */
71 static Lisp_Object Vbuffer_defaults
;
73 /* This structure marks which slots in a buffer have corresponding
74 default values in buffer_defaults.
75 Each such slot has a nonzero value in this structure.
76 The value has only one nonzero bit.
78 When a buffer has its own local value for a slot,
79 the bit for that slot (found in the same slot in this structure)
80 is turned on in the buffer's local_var_flags slot.
82 If a slot in this structure is -1, then even though there may
83 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
84 and the corresponding slot in buffer_defaults is not used.
86 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
87 but there is a default value which is copied into each buffer.
89 If a slot in this structure is negative, then even though there may
90 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
91 and the corresponding slot in buffer_defaults is not used.
93 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
94 zero, that is a bug */
96 struct buffer buffer_local_flags
;
98 /* This structure holds the names of symbols whose values may be
99 buffer-local. It is indexed and accessed in the same way as the above. */
101 struct buffer buffer_local_symbols
;
102 /* A Lisp_Object pointer to the above, used for staticpro */
103 static Lisp_Object Vbuffer_local_symbols
;
105 /* This structure holds the required types for the values in the
106 buffer-local slots. If a slot contains Qnil, then the
107 corresponding buffer slot may contain a value of any type. If a
108 slot contains an integer, then prospective values' tags must be
109 equal to that integer (except nil is always allowed).
110 When a tag does not match, the function
111 buffer_slot_type_mismatch will signal an error.
113 If a slot here contains -1, the corresponding variable is read-only. */
114 struct buffer buffer_local_types
;
116 /* Flags indicating which built-in buffer-local variables
117 are permanent locals. */
118 static int buffer_permanent_local_flags
;
120 Lisp_Object
Fset_buffer ();
121 void set_buffer_internal ();
122 void set_buffer_internal_1 ();
123 static void call_overlay_mod_hooks ();
124 static void swap_out_buffer_local_variables ();
125 static void reset_buffer_local_variables ();
127 /* Alist of all buffer names vs the buffers. */
128 /* This used to be a variable, but is no longer,
129 to prevent lossage due to user rplac'ing this alist or its elements. */
130 Lisp_Object Vbuffer_alist
;
132 /* Functions to call before and after each text change. */
133 Lisp_Object Vbefore_change_function
;
134 Lisp_Object Vafter_change_function
;
135 Lisp_Object Vbefore_change_functions
;
136 Lisp_Object Vafter_change_functions
;
138 Lisp_Object Vtransient_mark_mode
;
140 /* t means ignore all read-only text properties.
141 A list means ignore such a property if its value is a member of the list.
142 Any non-nil value means ignore buffer-read-only. */
143 Lisp_Object Vinhibit_read_only
;
145 /* List of functions to call that can query about killing a buffer.
146 If any of these functions returns nil, we don't kill it. */
147 Lisp_Object Vkill_buffer_query_functions
;
149 /* List of functions to call before changing an unmodified buffer. */
150 Lisp_Object Vfirst_change_hook
;
152 Lisp_Object Qfirst_change_hook
;
153 Lisp_Object Qbefore_change_functions
;
154 Lisp_Object Qafter_change_functions
;
156 /* If nonzero, all modification hooks are suppressed. */
157 int inhibit_modification_hooks
;
159 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
161 Lisp_Object Qprotected_field
;
163 Lisp_Object QSFundamental
; /* A string "Fundamental" */
165 Lisp_Object Qkill_buffer_hook
;
167 Lisp_Object Qget_file_buffer
;
169 Lisp_Object Qoverlayp
;
171 Lisp_Object Qpriority
, Qwindow
, Qevaporate
, Qbefore_string
, Qafter_string
;
173 Lisp_Object Qmodification_hooks
;
174 Lisp_Object Qinsert_in_front_hooks
;
175 Lisp_Object Qinsert_behind_hooks
;
177 /* For debugging; temporary. See set_buffer_internal. */
178 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
185 error ("No buffer named %s", XSTRING (spec
)->data
);
186 error ("Invalid buffer argument");
189 DEFUN ("buffer-live-p", Fbuffer_live_p
, Sbuffer_live_p
, 1, 1, 0,
190 "Return non-nil if OBJECT is a buffer which has not been killed.\n\
191 Value is nil if OBJECT is not a buffer or if it has been killed.")
195 return ((BUFFERP (object
) && ! NILP (XBUFFER (object
)->name
))
199 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 1, 0,
200 "Return a list of all existing live buffers.\n\
201 If the optional arg FRAME is a frame, we return that frame's buffer list.")
205 Lisp_Object framelist
, general
;
206 general
= Fmapcar (Qcdr
, Vbuffer_alist
);
212 CHECK_FRAME (frame
, 1);
214 framelist
= Fcopy_sequence (XFRAME (frame
)->buffer_list
);
216 /* Remove from GENERAL any buffer that duplicates one in FRAMELIST. */
218 while (! NILP (tail
))
220 general
= Fdelq (XCONS (tail
)->car
, general
);
221 tail
= XCONS (tail
)->cdr
;
223 return nconc2 (framelist
, general
);
229 /* Like Fassoc, but use Fstring_equal to compare
230 (which ignores text properties),
231 and don't ever QUIT. */
234 assoc_ignore_text_properties (key
, list
)
235 register Lisp_Object key
;
238 register Lisp_Object tail
;
239 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
241 register Lisp_Object elt
, tem
;
243 tem
= Fstring_equal (Fcar (elt
), key
);
250 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
251 "Return the buffer named NAME (a string).\n\
252 If there is no live buffer named NAME, return nil.\n\
253 NAME may also be a buffer; if so, the value is that buffer.")
255 register Lisp_Object name
;
259 CHECK_STRING (name
, 0);
261 return Fcdr (assoc_ignore_text_properties (name
, Vbuffer_alist
));
264 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
265 "Return the buffer visiting file FILENAME (a string).\n\
266 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
267 If there is no such live buffer, return nil.\n\
268 See also `find-buffer-visiting'.")
270 register Lisp_Object filename
;
272 register Lisp_Object tail
, buf
, tem
;
275 CHECK_STRING (filename
, 0);
276 filename
= Fexpand_file_name (filename
, Qnil
);
278 /* If the file name has special constructs in it,
279 call the corresponding file handler. */
280 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
282 return call2 (handler
, Qget_file_buffer
, filename
);
284 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
286 buf
= Fcdr (XCONS (tail
)->car
);
287 if (!BUFFERP (buf
)) continue;
288 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
289 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
297 get_truename_buffer (filename
)
298 register Lisp_Object filename
;
300 register Lisp_Object tail
, buf
, tem
;
302 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
304 buf
= Fcdr (XCONS (tail
)->car
);
305 if (!BUFFERP (buf
)) continue;
306 if (!STRINGP (XBUFFER (buf
)->file_truename
)) continue;
307 tem
= Fstring_equal (XBUFFER (buf
)->file_truename
, filename
);
314 /* Incremented for each buffer created, to assign the buffer number. */
317 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
318 "Return the buffer named NAME, or create such a buffer and return it.\n\
319 A new buffer is created if there is no live buffer named NAME.\n\
320 If NAME starts with a space, the new buffer does not keep undo information.\n\
321 If NAME is a buffer instead of a string, then it is the value returned.\n\
322 The value is never nil.")
324 register Lisp_Object name
;
326 register Lisp_Object buf
;
327 register struct buffer
*b
;
329 buf
= Fget_buffer (name
);
333 if (XSTRING (name
)->size
== 0)
334 error ("Empty string for buffer name is not allowed");
336 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
338 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
340 /* An ordinary buffer uses its own struct buffer_text. */
341 b
->text
= &b
->own_text
;
344 BUF_GAP_SIZE (b
) = 20;
346 /* We allocate extra 1-byte at the tail and keep it always '\0' for
347 anchoring a search. */
348 BUFFER_ALLOC (BUF_BEG_ADDR (b
), (BUF_GAP_SIZE (b
) + 1));
350 if (! BUF_BEG_ADDR (b
))
351 buffer_memory_full ();
359 BUF_GPT_BYTE (b
) = 1;
360 BUF_BEGV_BYTE (b
) = 1;
364 BUF_OVERLAY_MODIFF (b
) = 1;
365 BUF_SAVE_MODIFF (b
) = 1;
366 BUF_INTERVALS (b
) = 0;
367 *(BUF_GPT_ADDR (b
)) = *(BUF_Z_ADDR (b
)) = 0; /* Put an anchor '\0'. */
369 b
->newline_cache
= 0;
370 b
->width_run_cache
= 0;
371 b
->width_table
= Qnil
;
373 /* Put this on the chain of all buffers including killed ones. */
374 b
->next
= all_buffers
;
377 /* An ordinary buffer normally doesn't need markers
378 to handle BEGV and ZV. */
380 b
->begv_marker
= Qnil
;
383 name
= Fcopy_sequence (name
);
384 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
387 if (XSTRING (name
)->data
[0] != ' ')
393 reset_buffer_local_variables (b
, 1);
395 /* Put this in the alist of all live buffers. */
397 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
399 b
->mark
= Fmake_marker ();
400 BUF_MARKERS (b
) = Qnil
;
405 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
406 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
407 "Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.\n\
408 BASE-BUFFER should be an existing buffer (or buffer name).\n\
409 NAME should be a string which is not the name of an existing buffer.")
411 register Lisp_Object base_buffer
, name
;
413 register Lisp_Object buf
;
414 register struct buffer
*b
;
416 buf
= Fget_buffer (name
);
418 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
420 base_buffer
= Fget_buffer (base_buffer
);
421 if (NILP (base_buffer
))
422 error ("No such buffer: `%s'",
423 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
425 if (XSTRING (name
)->size
== 0)
426 error ("Empty string for buffer name is not allowed");
428 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
430 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
432 if (XBUFFER (base_buffer
)->base_buffer
)
433 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
435 b
->base_buffer
= XBUFFER (base_buffer
);
437 /* Use the base buffer's text object. */
438 b
->text
= b
->base_buffer
->text
;
440 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
441 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
442 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
443 BUF_BEGV_BYTE (b
) = BUF_BEGV_BYTE (b
->base_buffer
);
444 BUF_ZV_BYTE (b
) = BUF_ZV_BYTE (b
->base_buffer
);
445 BUF_PT_BYTE (b
) = BUF_PT_BYTE (b
->base_buffer
);
447 b
->newline_cache
= 0;
448 b
->width_run_cache
= 0;
449 b
->width_table
= Qnil
;
451 /* Put this on the chain of all buffers including killed ones. */
452 b
->next
= all_buffers
;
455 name
= Fcopy_sequence (name
);
456 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
460 reset_buffer_local_variables (b
, 1);
462 /* Put this in the alist of all live buffers. */
464 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
466 b
->mark
= Fmake_marker ();
469 /* The multibyte status belongs to the base buffer. */
470 b
->enable_multibyte_characters
= b
->base_buffer
->enable_multibyte_characters
;
472 /* Make sure the base buffer has markers for its narrowing. */
473 if (NILP (b
->base_buffer
->pt_marker
))
475 b
->base_buffer
->pt_marker
= Fmake_marker ();
476 set_marker_both (b
->base_buffer
->pt_marker
, base_buffer
,
477 BUF_PT (b
->base_buffer
),
478 BUF_PT_BYTE (b
->base_buffer
));
480 if (NILP (b
->base_buffer
->begv_marker
))
482 b
->base_buffer
->begv_marker
= Fmake_marker ();
483 set_marker_both (b
->base_buffer
->begv_marker
, base_buffer
,
484 BUF_BEGV (b
->base_buffer
),
485 BUF_BEGV_BYTE (b
->base_buffer
));
487 if (NILP (b
->base_buffer
->zv_marker
))
489 b
->base_buffer
->zv_marker
= Fmake_marker ();
490 set_marker_both (b
->base_buffer
->zv_marker
, base_buffer
,
491 BUF_ZV (b
->base_buffer
),
492 BUF_ZV_BYTE (b
->base_buffer
));
493 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
496 /* Give the indirect buffer markers for its narrowing. */
497 b
->pt_marker
= Fmake_marker ();
498 set_marker_both (b
->pt_marker
, buf
, BUF_PT (b
), BUF_PT_BYTE (b
));
499 b
->begv_marker
= Fmake_marker ();
500 set_marker_both (b
->begv_marker
, buf
, BUF_BEGV (b
), BUF_BEGV_BYTE (b
));
501 b
->zv_marker
= Fmake_marker ();
502 set_marker_both (b
->zv_marker
, buf
, BUF_ZV (b
), BUF_ZV_BYTE (b
));
503 XMARKER (b
->zv_marker
)->insertion_type
= 1;
508 /* Reinitialize everything about a buffer except its name and contents
509 and local variables. */
513 register struct buffer
*b
;
516 b
->file_truename
= Qnil
;
517 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
519 XSETFASTINT (b
->save_length
, 0);
520 b
->last_window_start
= 1;
521 /* It is more conservative to start out "changed" than "unchanged". */
524 b
->auto_save_modified
= 0;
525 b
->auto_save_failure_time
= -1;
526 b
->auto_save_file_name
= Qnil
;
528 b
->overlays_before
= Qnil
;
529 b
->overlays_after
= Qnil
;
530 XSETFASTINT (b
->overlay_center
, 1);
531 b
->mark_active
= Qnil
;
532 b
->point_before_scroll
= Qnil
;
533 b
->file_format
= Qnil
;
534 b
->last_selected_window
= Qnil
;
535 XSETINT (b
->display_count
, 0);
536 b
->display_time
= Qnil
;
539 b
->enable_multibyte_characters
= buffer_defaults
.enable_multibyte_characters
;
542 /* Reset buffer B's local variables info.
543 Don't use this on a buffer that has already been in use;
544 it does not treat permanent locals consistently.
545 Instead, use Fkill_all_local_variables.
547 If PERMANENT_TOO is 1, then we reset permanent built-in
548 buffer-local variables. If PERMANENT_TOO is 0,
549 we preserve those. */
552 reset_buffer_local_variables (b
, permanent_too
)
553 register struct buffer
*b
;
559 /* Decide which built-in local variables to reset. */
563 dont_reset
= buffer_permanent_local_flags
;
565 /* Reset the major mode to Fundamental, together with all the
566 things that depend on the major mode.
567 default-major-mode is handled at a higher level.
568 We ignore it here. */
569 b
->major_mode
= Qfundamental_mode
;
571 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
572 b
->mode_name
= QSFundamental
;
573 b
->minor_modes
= Qnil
;
575 /* If the standard case table has been altered and invalidated,
576 fix up its insides first. */
577 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[0])
578 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[1])
579 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[2])))
580 Fset_standard_case_table (Vascii_downcase_table
);
582 b
->downcase_table
= Vascii_downcase_table
;
583 b
->upcase_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[0];
584 b
->case_canon_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[1];
585 b
->case_eqv_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[2];
586 b
->invisibility_spec
= Qt
;
588 b
->buffer_file_type
= Qnil
;
592 b
->sort_table
= XSTRING (Vascii_sort_table
);
593 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
596 /* Reset all (or most) per-buffer variables to their defaults. */
597 b
->local_var_alist
= Qnil
;
598 b
->local_var_flags
&= dont_reset
;
600 /* For each slot that has a default value,
601 copy that into the slot. */
603 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
604 offset
< sizeof (struct buffer
);
605 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
607 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
609 /* Don't reset a permanent local. */
610 && ! (dont_reset
& flag
))
612 *(Lisp_Object
*)(offset
+ (char *)b
)
613 = *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
617 /* We split this away from generate-new-buffer, because rename-buffer
618 and set-visited-file-name ought to be able to use this to really
619 rename the buffer properly. */
621 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
623 "Return a string that is the name of no existing buffer based on NAME.\n\
624 If there is no live buffer named NAME, then return NAME.\n\
625 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
626 until an unused name is found, and then return that name.\n\
627 Optional second argument IGNORE specifies a name that is okay to use\n\
628 \(if it is in the sequence to be tried)\n\
629 even if a buffer with that name exists.")
631 register Lisp_Object name
, ignore
;
633 register Lisp_Object gentemp
, tem
;
637 CHECK_STRING (name
, 0);
639 tem
= Fget_buffer (name
);
646 sprintf (number
, "<%d>", ++count
);
647 gentemp
= concat2 (name
, build_string (number
));
648 tem
= Fstring_equal (gentemp
, ignore
);
651 tem
= Fget_buffer (gentemp
);
658 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
659 "Return the name of BUFFER, as a string.\n\
660 With no argument or nil as argument, return the name of the current buffer.")
662 register Lisp_Object buffer
;
665 return current_buffer
->name
;
666 CHECK_BUFFER (buffer
, 0);
667 return XBUFFER (buffer
)->name
;
670 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
671 "Return name of file BUFFER is visiting, or nil if none.\n\
672 No argument or nil as argument means use the current buffer.")
674 register Lisp_Object buffer
;
677 return current_buffer
->filename
;
678 CHECK_BUFFER (buffer
, 0);
679 return XBUFFER (buffer
)->filename
;
682 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
684 "Return the base buffer of indirect buffer BUFFER.\n\
685 If BUFFER is not indirect, return nil.")
687 register Lisp_Object buffer
;
690 Lisp_Object base_buffer
;
693 base
= current_buffer
->base_buffer
;
696 CHECK_BUFFER (buffer
, 0);
697 base
= XBUFFER (buffer
)->base_buffer
;
702 XSETBUFFER (base_buffer
, base
);
706 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
707 Sbuffer_local_variables
, 0, 1, 0,
708 "Return an alist of variables that are buffer-local in BUFFER.\n\
709 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
710 For a symbol that is locally unbound, just the symbol appears in the value.\n\
711 Note that storing new VALUEs in these elements doesn't change the variables.\n\
712 No argument or nil as argument means use current buffer as BUFFER.")
714 register Lisp_Object buffer
;
716 register struct buffer
*buf
;
717 register Lisp_Object result
;
720 buf
= current_buffer
;
723 CHECK_BUFFER (buffer
, 0);
724 buf
= XBUFFER (buffer
);
730 register Lisp_Object tail
;
731 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
733 Lisp_Object val
, elt
;
735 elt
= XCONS (tail
)->car
;
737 /* Reference each variable in the alist in buf.
738 If inquiring about the current buffer, this gets the current values,
739 so store them into the alist so the alist is up to date.
740 If inquiring about some other buffer, this swaps out any values
741 for that buffer, making the alist up to date automatically. */
742 val
= find_symbol_value (XCONS (elt
)->car
);
743 /* Use the current buffer value only if buf is the current buffer. */
744 if (buf
!= current_buffer
)
745 val
= XCONS (elt
)->cdr
;
747 /* If symbol is unbound, put just the symbol in the list. */
748 if (EQ (val
, Qunbound
))
749 result
= Fcons (XCONS (elt
)->car
, result
);
750 /* Otherwise, put (symbol . value) in the list. */
752 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
756 /* Add on all the variables stored in special slots. */
758 register int offset
, mask
;
760 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
761 offset
< sizeof (struct buffer
);
762 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
764 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
765 if (mask
== -1 || (buf
->local_var_flags
& mask
))
766 if (SYMBOLP (*(Lisp_Object
*)(offset
767 + (char *)&buffer_local_symbols
)))
768 result
= Fcons (Fcons (*((Lisp_Object
*)
769 (offset
+ (char *)&buffer_local_symbols
)),
770 *(Lisp_Object
*)(offset
+ (char *)buf
)),
779 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
781 "Return t if BUFFER was modified since its file was last read or saved.\n\
782 No argument or nil as argument means use current buffer as BUFFER.")
784 register Lisp_Object buffer
;
786 register struct buffer
*buf
;
788 buf
= current_buffer
;
791 CHECK_BUFFER (buffer
, 0);
792 buf
= XBUFFER (buffer
);
795 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
798 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
800 "Mark current buffer as modified or unmodified according to FLAG.\n\
801 A non-nil FLAG means mark the buffer modified.")
803 register Lisp_Object flag
;
805 register int already
;
806 register Lisp_Object fn
;
808 #ifdef CLASH_DETECTION
809 /* If buffer becoming modified, lock the file.
810 If buffer becoming unmodified, unlock the file. */
812 fn
= current_buffer
->file_truename
;
813 /* Test buffer-file-name so that binding it to nil is effective. */
814 if (!NILP (fn
) && ! NILP (current_buffer
->filename
))
816 already
= SAVE_MODIFF
< MODIFF
;
817 if (!already
&& !NILP (flag
))
819 else if (already
&& NILP (flag
))
822 #endif /* CLASH_DETECTION */
824 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
829 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
831 "Return BUFFER's tick counter, incremented for each change in text.\n\
832 Each buffer has a tick counter which is incremented each time the text in\n\
833 that buffer is changed. It wraps around occasionally.\n\
834 No argument or nil as argument means use current buffer as BUFFER.")
836 register Lisp_Object buffer
;
838 register struct buffer
*buf
;
840 buf
= current_buffer
;
843 CHECK_BUFFER (buffer
, 0);
844 buf
= XBUFFER (buffer
);
847 return make_number (BUF_MODIFF (buf
));
850 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
851 "sRename buffer (to new name): \nP",
852 "Change current buffer's name to NEWNAME (a string).\n\
853 If second arg UNIQUE is nil or omitted, it is an error if a\n\
854 buffer named NEWNAME already exists.\n\
855 If UNIQUE is non-nil, come up with a new name using\n\
856 `generate-new-buffer-name'.\n\
857 Interactively, you can set UNIQUE with a prefix argument.\n\
858 We return the name we actually gave the buffer.\n\
859 This does not change the name of the visited file (if any).")
861 register Lisp_Object newname
, unique
;
863 register Lisp_Object tem
, buf
;
865 CHECK_STRING (newname
, 0);
867 if (XSTRING (newname
)->size
== 0)
868 error ("Empty string is invalid as a buffer name");
870 tem
= Fget_buffer (newname
);
871 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
872 the buffer automatically so you can create another with the original name.
873 It makes UNIQUE equivalent to
874 (rename-buffer (generate-new-buffer-name NEWNAME)). */
875 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
876 return current_buffer
->name
;
880 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
882 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
885 current_buffer
->name
= newname
;
887 /* Catch redisplay's attention. Unless we do this, the mode lines for
888 any windows displaying current_buffer will stay unchanged. */
891 XSETBUFFER (buf
, current_buffer
);
892 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
893 if (NILP (current_buffer
->filename
)
894 && !NILP (current_buffer
->auto_save_file_name
))
895 call0 (intern ("rename-auto-save-file"));
896 /* Refetch since that last call may have done GC. */
897 return current_buffer
->name
;
900 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 3, 0,
901 "Return most recently selected buffer other than BUFFER.\n\
902 Buffers not visible in windows are preferred to visible buffers,\n\
903 unless optional second argument VISIBLE-OK is non-nil.\n\
904 If the optional third argument FRAME is non-nil, use that frame's\n\
905 buffer list instead of the selected frame's buffer list.\n\
906 If no other buffer exists, the buffer `*scratch*' is returned.\n\
907 If BUFFER is omitted or nil, some interesting buffer is returned.")
908 (buffer
, visible_ok
, frame
)
909 register Lisp_Object buffer
, visible_ok
, frame
;
911 Lisp_Object
Fset_buffer_major_mode ();
912 register Lisp_Object tail
, buf
, notsogood
, tem
, pred
, add_ons
;
916 frame
= Fselected_frame ();
918 tail
= Vbuffer_alist
;
919 pred
= frame_buffer_predicate (frame
);
921 /* Consider buffers that have been seen in the selected frame
922 before other buffers. */
924 tem
= frame_buffer_list (frame
);
928 if (BUFFERP (XCONS (tem
)->car
))
929 add_ons
= Fcons (Fcons (Qnil
, XCONS (tem
)->car
), add_ons
);
930 tem
= XCONS (tem
)->cdr
;
932 tail
= nconc2 (Fnreverse (add_ons
), tail
);
934 for (; !NILP (tail
); tail
= Fcdr (tail
))
936 buf
= Fcdr (Fcar (tail
));
937 if (EQ (buf
, buffer
))
939 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
941 /* If the selected frame has a buffer_predicate,
942 disregard buffers that don't fit the predicate. */
945 tem
= call1 (pred
, buf
);
950 if (NILP (visible_ok
))
951 tem
= Fget_buffer_window (buf
, Qt
);
956 if (NILP (notsogood
))
959 if (!NILP (notsogood
))
961 buf
= Fget_buffer_create (build_string ("*scratch*"));
962 Fset_buffer_major_mode (buf
);
966 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
968 "Make BUFFER stop keeping undo information.\n\
969 No argument or nil as argument means do this for the current buffer.")
971 register Lisp_Object buffer
;
973 Lisp_Object real_buffer
;
976 XSETBUFFER (real_buffer
, current_buffer
);
979 real_buffer
= Fget_buffer (buffer
);
980 if (NILP (real_buffer
))
984 XBUFFER (real_buffer
)->undo_list
= Qt
;
989 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
991 "Start keeping undo information for buffer BUFFER.\n\
992 No argument or nil as argument means do this for the current buffer.")
994 register Lisp_Object buffer
;
996 Lisp_Object real_buffer
;
999 XSETBUFFER (real_buffer
, current_buffer
);
1002 real_buffer
= Fget_buffer (buffer
);
1003 if (NILP (real_buffer
))
1007 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
1008 XBUFFER (real_buffer
)->undo_list
= Qnil
;
1014 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
1015 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
1016 The buffer being killed will be current while the hook is running.\n\
1019 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
1020 "Kill the buffer BUFFER.\n\
1021 The argument may be a buffer or may be the name of a buffer.\n\
1022 An argument of nil means kill the current buffer.\n\n\
1023 Value is t if the buffer is actually killed, nil if user says no.\n\n\
1024 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
1025 if not void, is a list of functions to be called, with no arguments,\n\
1026 before the buffer is actually killed. The buffer to be killed is current\n\
1027 when the hook functions are called.\n\n\
1028 Any processes that have this buffer as the `process-buffer' are killed\n\
1034 register struct buffer
*b
;
1035 register Lisp_Object tem
;
1036 register struct Lisp_Marker
*m
;
1037 struct gcpro gcpro1
, gcpro2
;
1040 buf
= Fcurrent_buffer ();
1042 buf
= Fget_buffer (buffer
);
1048 /* Avoid trouble for buffer already dead. */
1052 /* Query if the buffer is still modified. */
1053 if (INTERACTIVE
&& !NILP (b
->filename
)
1054 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
1057 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
1058 XSTRING (b
->name
)->data
));
1064 /* Run hooks with the buffer to be killed the current buffer. */
1066 register Lisp_Object val
;
1067 int count
= specpdl_ptr
- specpdl
;
1070 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1071 set_buffer_internal (b
);
1073 /* First run the query functions; if any query is answered no,
1074 don't kill the buffer. */
1075 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
1077 tem
= call0 (Fcar (list
));
1079 return unbind_to (count
, Qnil
);
1082 /* Then run the hooks. */
1083 if (!NILP (Vrun_hooks
))
1084 call1 (Vrun_hooks
, Qkill_buffer_hook
);
1085 unbind_to (count
, Qnil
);
1088 /* We have no more questions to ask. Verify that it is valid
1089 to kill the buffer. This must be done after the questions
1090 since anything can happen within do_yes_or_no_p. */
1092 /* Don't kill the minibuffer now current. */
1093 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
1099 /* When we kill a base buffer, kill all its indirect buffers.
1100 We do it at this stage so nothing terrible happens if they
1101 ask questions or their hooks get errors. */
1102 if (! b
->base_buffer
)
1104 struct buffer
*other
;
1108 for (other
= all_buffers
; other
; other
= other
->next
)
1109 /* all_buffers contains dead buffers too;
1110 don't re-kill them. */
1111 if (other
->base_buffer
== b
&& !NILP (other
->name
))
1114 XSETBUFFER (buf
, other
);
1121 /* Make this buffer not be current.
1122 In the process, notice if this is the sole visible buffer
1123 and give up if so. */
1124 if (b
== current_buffer
)
1126 tem
= Fother_buffer (buf
, Qnil
, Qnil
);
1128 if (b
== current_buffer
)
1132 /* Now there is no question: we can kill the buffer. */
1134 #ifdef CLASH_DETECTION
1135 /* Unlock this buffer's file, if it is locked. */
1137 #endif /* CLASH_DETECTION */
1139 kill_buffer_processes (buf
);
1141 tem
= Vinhibit_quit
;
1143 replace_buffer_in_all_windows (buf
);
1144 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1145 frames_discard_buffer (buf
);
1146 Vinhibit_quit
= tem
;
1148 /* Delete any auto-save file, if we saved it in this session. */
1149 if (STRINGP (b
->auto_save_file_name
)
1150 && b
->auto_save_modified
!= 0
1151 && BUF_SAVE_MODIFF (b
) < b
->auto_save_modified
)
1154 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1156 internal_delete_file (b
->auto_save_file_name
);
1161 /* Unchain all markers that belong to this indirect buffer.
1162 Don't unchain the markers that belong to the base buffer
1163 or its other indirect buffers. */
1164 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1170 unchain_marker (tem
);
1176 /* Unchain all markers of this buffer and its indirect buffers.
1177 and leave them pointing nowhere. */
1178 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1185 BUF_MARKERS (b
) = Qnil
;
1187 #ifdef USE_TEXT_PROPERTIES
1188 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1191 /* Perhaps we should explicitly free the interval tree here... */
1194 /* Reset the local variables, so that this buffer's local values
1195 won't be protected from GC. They would be protected
1196 if they happened to remain encached in their symbols.
1197 This gets rid of them for certain. */
1198 swap_out_buffer_local_variables (b
);
1199 reset_buffer_local_variables (b
, 1);
1204 if (! b
->base_buffer
)
1205 BUFFER_FREE (BUF_BEG_ADDR (b
));
1207 if (b
->newline_cache
)
1209 free_region_cache (b
->newline_cache
);
1210 b
->newline_cache
= 0;
1212 if (b
->width_run_cache
)
1214 free_region_cache (b
->width_run_cache
);
1215 b
->width_run_cache
= 0;
1217 b
->width_table
= Qnil
;
1219 b
->undo_list
= Qnil
;
1224 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1225 we do this each time BUF is selected visibly, the more recently
1226 selected buffers are always closer to the front of the list. This
1227 means that other_buffer is more likely to choose a relevant buffer. */
1233 register Lisp_Object link
, prev
;
1235 frame
= Fselected_frame ();
1238 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1240 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1245 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1246 we cannot use Fdelq itself here because it allows quitting. */
1249 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1251 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1253 XCONS (link
)->cdr
= Vbuffer_alist
;
1254 Vbuffer_alist
= link
;
1256 /* Now move this buffer to the front of frame_buffer_list also. */
1259 for (link
= frame_buffer_list (frame
); CONSP (link
);
1260 link
= XCONS (link
)->cdr
)
1262 if (EQ (XCONS (link
)->car
, buf
))
1267 /* Effectively do delq. */
1272 set_frame_buffer_list (frame
,
1273 XCONS (frame_buffer_list (frame
))->cdr
);
1275 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1277 XCONS (link
)->cdr
= frame_buffer_list (frame
);
1278 set_frame_buffer_list (frame
, link
);
1281 set_frame_buffer_list (frame
, Fcons (buf
, frame_buffer_list (frame
)));
1284 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1285 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1286 Use this function before selecting the buffer, since it may need to inspect\n\
1287 the current buffer's major mode.")
1292 Lisp_Object function
;
1294 function
= buffer_defaults
.major_mode
;
1295 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1296 function
= current_buffer
->major_mode
;
1298 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1301 count
= specpdl_ptr
- specpdl
;
1303 /* To select a nonfundamental mode,
1304 select the buffer temporarily and then call the mode function. */
1306 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1308 Fset_buffer (buffer
);
1311 return unbind_to (count
, Qnil
);
1314 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1315 "Select buffer BUFFER in the current window.\n\
1316 BUFFER may be a buffer or a buffer name.\n\
1317 Optional second arg NORECORD non-nil means\n\
1318 do not put this buffer at the front of the list of recently selected ones.\n\
1320 WARNING: This is NOT the way to work on another buffer temporarily\n\
1321 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1322 the window-buffer correspondences.")
1324 Lisp_Object buffer
, norecord
;
1326 register Lisp_Object buf
;
1329 if (EQ (minibuf_window
, selected_window
))
1330 error ("Cannot switch buffers in minibuffer window");
1331 tem
= Fwindow_dedicated_p (selected_window
);
1333 error ("Cannot switch buffers in a dedicated window");
1336 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1339 buf
= Fget_buffer (buffer
);
1342 buf
= Fget_buffer_create (buffer
);
1343 Fset_buffer_major_mode (buf
);
1347 if (NILP (norecord
))
1348 record_buffer (buf
);
1350 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1351 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1358 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 3, 0,
1359 "Select buffer BUFFER in some window, preferably a different one.\n\
1360 If BUFFER is nil, then some other buffer is chosen.\n\
1361 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1362 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1363 window even if BUFFER is already visible in the selected window.\n\
1364 This uses the function `display-buffer' as a subroutine; see the documentation\n\
1365 of `display-buffer' for additional customization information.\n\
1367 Optional third arg NORECORD non-nil means\n\
1368 do not put this buffer at the front of the list of recently selected ones.")
1369 (buffer
, other_window
, norecord
)
1370 Lisp_Object buffer
, other_window
, norecord
;
1372 register Lisp_Object buf
;
1374 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1377 buf
= Fget_buffer (buffer
);
1380 buf
= Fget_buffer_create (buffer
);
1381 Fset_buffer_major_mode (buf
);
1385 if (NILP (norecord
))
1386 record_buffer (buf
);
1387 Fselect_window (Fdisplay_buffer (buf
, other_window
, Qnil
));
1391 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1392 "Return the current buffer as a Lisp object.")
1395 register Lisp_Object buf
;
1396 XSETBUFFER (buf
, current_buffer
);
1400 /* Set the current buffer to B. */
1403 set_buffer_internal (b
)
1404 register struct buffer
*b
;
1406 register struct buffer
*old_buf
;
1407 register Lisp_Object tail
, valcontents
;
1410 if (current_buffer
== b
)
1413 windows_or_buffers_changed
= 1;
1414 set_buffer_internal_1 (b
);
1417 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1418 This is used by redisplay. */
1421 set_buffer_internal_1 (b
)
1422 register struct buffer
*b
;
1424 register struct buffer
*old_buf
;
1425 register Lisp_Object tail
, valcontents
;
1428 if (current_buffer
== b
)
1431 old_buf
= current_buffer
;
1433 last_known_column_point
= -1; /* invalidate indentation cache */
1437 /* Put the undo list back in the base buffer, so that it appears
1438 that an indirect buffer shares the undo list of its base. */
1439 if (old_buf
->base_buffer
)
1440 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1442 /* If the old current buffer has markers to record PT, BEGV and ZV
1443 when it is not current, update them now. */
1444 if (! NILP (old_buf
->pt_marker
))
1447 XSETBUFFER (obuf
, old_buf
);
1448 set_marker_both (old_buf
->pt_marker
, obuf
,
1449 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1451 if (! NILP (old_buf
->begv_marker
))
1454 XSETBUFFER (obuf
, old_buf
);
1455 set_marker_both (old_buf
->begv_marker
, obuf
,
1456 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1458 if (! NILP (old_buf
->zv_marker
))
1461 XSETBUFFER (obuf
, old_buf
);
1462 set_marker_both (old_buf
->zv_marker
, obuf
,
1463 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1467 /* Get the undo list from the base buffer, so that it appears
1468 that an indirect buffer shares the undo list of its base. */
1470 b
->undo_list
= b
->base_buffer
->undo_list
;
1472 /* If the new current buffer has markers to record PT, BEGV and ZV
1473 when it is not current, fetch them now. */
1474 if (! NILP (b
->pt_marker
))
1476 BUF_PT (b
) = marker_position (b
->pt_marker
);
1477 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1479 if (! NILP (b
->begv_marker
))
1481 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1482 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1484 if (! NILP (b
->zv_marker
))
1486 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1487 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1490 /* Look down buffer's list of local Lisp variables
1491 to find and update any that forward into C variables. */
1493 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1495 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1496 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1497 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1498 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1499 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1500 /* Just reference the variable
1501 to cause it to become set for this buffer. */
1502 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1505 /* Do the same with any others that were local to the previous buffer */
1508 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1510 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1511 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1512 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1513 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1514 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1515 /* Just reference the variable
1516 to cause it to become set for this buffer. */
1517 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1521 /* Switch to buffer B temporarily for redisplay purposes.
1522 This avoids certain things that don't need to be done within redisplay. */
1528 register struct buffer
*old_buf
;
1530 if (current_buffer
== b
)
1533 old_buf
= current_buffer
;
1538 /* If the old current buffer has markers to record PT, BEGV and ZV
1539 when it is not current, update them now. */
1540 if (! NILP (old_buf
->pt_marker
))
1543 XSETBUFFER (obuf
, old_buf
);
1544 set_marker_both (old_buf
->pt_marker
, obuf
,
1545 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1547 if (! NILP (old_buf
->begv_marker
))
1550 XSETBUFFER (obuf
, old_buf
);
1551 set_marker_both (old_buf
->begv_marker
, obuf
,
1552 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1554 if (! NILP (old_buf
->zv_marker
))
1557 XSETBUFFER (obuf
, old_buf
);
1558 set_marker_both (old_buf
->zv_marker
, obuf
,
1559 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1563 /* If the new current buffer has markers to record PT, BEGV and ZV
1564 when it is not current, fetch them now. */
1565 if (! NILP (b
->pt_marker
))
1567 BUF_PT (b
) = marker_position (b
->pt_marker
);
1568 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1570 if (! NILP (b
->begv_marker
))
1572 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1573 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1575 if (! NILP (b
->zv_marker
))
1577 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1578 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1582 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1583 "Make the buffer BUFFER current for editing operations.\n\
1584 BUFFER may be a buffer or the name of an existing buffer.\n\
1585 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1586 This function does not display the buffer, so its effect ends\n\
1587 when the current command terminates.\n\
1588 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1590 register Lisp_Object buffer
;
1592 register Lisp_Object buf
;
1593 buf
= Fget_buffer (buffer
);
1596 if (NILP (XBUFFER (buf
)->name
))
1597 error ("Selecting deleted buffer");
1598 set_buffer_internal (XBUFFER (buf
));
1602 /* Set the current buffer to BUFFER provided it is alive. */
1605 set_buffer_if_live (buffer
)
1608 if (! NILP (XBUFFER (buffer
)->name
))
1609 Fset_buffer (buffer
);
1613 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1614 Sbarf_if_buffer_read_only
, 0, 0, 0,
1615 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1618 if (!NILP (current_buffer
->read_only
)
1619 && NILP (Vinhibit_read_only
))
1620 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1624 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1625 "Put BUFFER at the end of the list of all buffers.\n\
1626 There it is the least likely candidate for `other-buffer' to return;\n\
1627 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1628 If BUFFER is nil or omitted, bury the current buffer.\n\
1629 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1630 selected window if it is displayed there.")
1632 register Lisp_Object buffer
;
1634 /* Figure out what buffer we're going to bury. */
1637 XSETBUFFER (buffer
, current_buffer
);
1639 /* If we're burying the current buffer, unshow it. */
1640 Fswitch_to_buffer (Fother_buffer (buffer
, Qnil
, Qnil
), Qnil
);
1646 buf1
= Fget_buffer (buffer
);
1652 /* Move buffer to the end of the buffer list. */
1654 register Lisp_Object aelt
, link
;
1656 aelt
= Frassq (buffer
, Vbuffer_alist
);
1657 link
= Fmemq (aelt
, Vbuffer_alist
);
1658 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1659 XCONS (link
)->cdr
= Qnil
;
1660 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1663 frames_bury_buffer (buffer
);
1668 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1669 "Delete the entire contents of the current buffer.\n\
1670 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1671 so the buffer is truly empty after this.")
1676 current_buffer
->last_window_start
= 1;
1677 /* Prevent warnings, or suspension of auto saving, that would happen
1678 if future size is less than past size. Use of erase-buffer
1679 implies that the future text is not really related to the past text. */
1680 XSETFASTINT (current_buffer
->save_length
, 0);
1685 validate_region (b
, e
)
1686 register Lisp_Object
*b
, *e
;
1688 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1689 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1691 if (XINT (*b
) > XINT (*e
))
1694 tem
= *b
; *b
= *e
; *e
= tem
;
1697 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1698 && XINT (*e
) <= ZV
))
1699 args_out_of_range (*b
, *e
);
1702 /* Advance BYTE_POS up to a character boundary
1703 and return the adjusted position. */
1706 advance_to_char_boundary (byte_pos
)
1711 if (byte_pos
== BEG
)
1712 /* Beginning of buffer is always a character boundary. */
1715 c
= FETCH_BYTE (byte_pos
);
1716 if (! CHAR_HEAD_P (c
))
1718 /* We should advance BYTE_POS only when C is a constituen of a
1719 multibyte sequence. */
1722 /* If C is a constituent of a multibyte sequence, BYTE_POS was
1723 surely advance to the correct character boundary. If C is
1724 not, BYTE_POS was unchanged. */
1730 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte
, Sset_buffer_multibyte
,
1732 "Set the multibyte flag of the current buffer to FLAG.\n\
1733 If FLAG is t, this makes the buffer a multibyte buffer.\n\
1734 If FLAG is nil, this makes the buffer a single-byte buffer.\n\
1735 The buffer contents remain unchanged as a sequence of bytes\n\
1736 but the contents viewed as characters do change.")
1740 Lisp_Object tail
, markers
;
1741 struct buffer
*other
;
1743 if (current_buffer
->base_buffer
)
1744 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
1746 /* Do nothing if nothing actually changes. */
1747 if (NILP (flag
) == NILP (current_buffer
->enable_multibyte_characters
))
1750 /* It would be better to update the list,
1751 but this is good enough for now. */
1752 if (! EQ (current_buffer
->undo_list
, Qt
))
1753 current_buffer
->undo_list
= Qnil
;
1755 /* If the cached position is for this buffer, clear it out. */
1756 clear_charpos_cache (current_buffer
);
1760 /* Do this first, so it can use CHAR_TO_BYTE
1761 to calculate the old correspondences. */
1762 set_intervals_multibyte (0);
1764 current_buffer
->enable_multibyte_characters
= Qnil
;
1770 TEMP_SET_PT_BOTH (PT_BYTE
, PT_BYTE
);
1772 tail
= BUF_MARKERS (current_buffer
);
1773 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1775 XMARKER (tail
)->charpos
= XMARKER (tail
)->bytepos
;
1776 tail
= XMARKER (tail
)->chain
;
1781 /* Be sure not to have a multibyte sequence striding over the GAP.
1782 Ex: We change this: "...abc\201\241\241 _GAP_ \241\241\241..."
1783 to: "...abc _GAP_ \201\241\241\241\241\241..." */
1785 if (GPT_BYTE
> 1 && GPT_BYTE
< Z_BYTE
1786 && ! CHAR_HEAD_P (*(GAP_END_ADDR
)))
1788 unsigned char *p
= GPT_ADDR
- 1;
1790 while (! CHAR_HEAD_P (*p
) && p
> BEG_ADDR
) p
--;
1791 if (BASE_LEADING_CODE_P (*p
))
1793 int new_gpt
= GPT_BYTE
- (GPT_ADDR
- p
);
1795 move_gap_both (new_gpt
, new_gpt
);
1799 /* Do this first, so that chars_in_text asks the right question.
1800 set_intervals_multibyte needs it too. */
1801 current_buffer
->enable_multibyte_characters
= Qt
;
1803 GPT_BYTE
= advance_to_char_boundary (GPT_BYTE
);
1804 GPT
= chars_in_text (BEG_ADDR
, GPT_BYTE
- BEG_BYTE
) + BEG
;
1806 Z
= chars_in_text (GAP_END_ADDR
, Z_BYTE
- GPT_BYTE
) + GPT
;
1808 BEGV_BYTE
= advance_to_char_boundary (BEGV_BYTE
);
1809 if (BEGV_BYTE
> GPT_BYTE
)
1810 BEGV
= chars_in_text (GAP_END_ADDR
, BEGV_BYTE
- GPT_BYTE
) + GPT
;
1812 BEGV
= chars_in_text (BEG_ADDR
, BEGV_BYTE
- BEG_BYTE
) + BEG
;
1814 ZV_BYTE
= advance_to_char_boundary (ZV_BYTE
);
1815 if (ZV_BYTE
> GPT_BYTE
)
1816 ZV
= chars_in_text (GAP_END_ADDR
, ZV_BYTE
- GPT_BYTE
) + GPT
;
1818 ZV
= chars_in_text (BEG_ADDR
, ZV_BYTE
- BEG_BYTE
) + BEG
;
1821 int pt_byte
= advance_to_char_boundary (PT_BYTE
);
1824 if (pt_byte
> GPT_BYTE
)
1825 pt
= chars_in_text (GAP_END_ADDR
, pt_byte
- GPT_BYTE
) + GPT
;
1827 pt
= chars_in_text (BEG_ADDR
, pt_byte
- BEG_BYTE
) + BEG
;
1828 TEMP_SET_PT_BOTH (pt
, pt_byte
);
1831 tail
= markers
= BUF_MARKERS (current_buffer
);
1833 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
1834 getting confused by the markers that have not yet been updated.
1835 It is also a signal that it should never create a marker. */
1836 BUF_MARKERS (current_buffer
) = Qnil
;
1838 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1840 XMARKER (tail
)->bytepos
1841 = advance_to_char_boundary (XMARKER (tail
)->bytepos
);
1842 XMARKER (tail
)->charpos
= BYTE_TO_CHAR (XMARKER (tail
)->bytepos
);
1844 tail
= XMARKER (tail
)->chain
;
1847 /* Make sure no markers were put on the chain
1848 while the chain value was incorrect. */
1849 if (! EQ (BUF_MARKERS (current_buffer
), Qnil
))
1852 BUF_MARKERS (current_buffer
) = markers
;
1854 /* Do this last, so it can calculate the new correspondences
1855 between chars and bytes. */
1856 set_intervals_multibyte (1);
1859 /* Copy this buffer's new multibyte status
1860 into all of its indirect buffers. */
1861 for (other
= all_buffers
; other
; other
= other
->next
)
1862 if (other
->base_buffer
== current_buffer
&& !NILP (other
->name
))
1863 other
->enable_multibyte_characters
1864 = current_buffer
->enable_multibyte_characters
;
1869 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1871 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1872 Most local variable bindings are eliminated so that the default values\n\
1873 become effective once more. Also, the syntax table is set from\n\
1874 `standard-syntax-table', the local keymap is set to nil,\n\
1875 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1876 This function also forces redisplay of the mode line.\n\
1878 Every function to select a new major mode starts by\n\
1879 calling this function.\n\n\
1880 As a special exception, local variables whose names have\n\
1881 a non-nil `permanent-local' property are not eliminated by this function.\n\
1883 The first thing this function does is run\n\
1884 the normal hook `change-major-mode-hook'.")
1887 register Lisp_Object alist
, sym
, tem
;
1890 if (!NILP (Vrun_hooks
))
1891 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1892 oalist
= current_buffer
->local_var_alist
;
1894 /* Make sure none of the bindings in oalist
1895 remain swapped in, in their symbols. */
1897 swap_out_buffer_local_variables (current_buffer
);
1899 /* Actually eliminate all local bindings of this buffer. */
1901 reset_buffer_local_variables (current_buffer
, 0);
1903 /* Redisplay mode lines; we are changing major mode. */
1905 update_mode_lines
++;
1907 /* Any which are supposed to be permanent,
1908 make local again, with the same values they had. */
1910 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1912 sym
= XCONS (XCONS (alist
)->car
)->car
;
1913 tem
= Fget (sym
, Qpermanent_local
);
1916 Fmake_local_variable (sym
);
1917 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1921 /* Force mode-line redisplay. Useful here because all major mode
1922 commands call this function. */
1923 update_mode_lines
++;
1928 /* Make sure no local variables remain set up with buffer B
1929 for their current values. */
1932 swap_out_buffer_local_variables (b
)
1935 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1937 XSETBUFFER (buffer
, b
);
1938 oalist
= b
->local_var_alist
;
1940 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1942 sym
= XCONS (XCONS (alist
)->car
)->car
;
1944 /* Need not do anything if some other buffer's binding is now encached. */
1945 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
;
1946 if (XBUFFER (tem
) == current_buffer
)
1948 /* Symbol is set up for this buffer's old local value.
1949 Set it up for the current buffer with the default value. */
1951 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
;
1952 /* Store the symbol's current value into the alist entry
1953 it is currently set up for. This is so that, if the
1954 local is marked permanent, and we make it local again
1955 later in Fkill_all_local_variables, we don't lose the value. */
1956 XCONS (XCONS (tem
)->car
)->cdr
1957 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
);
1958 /* Switch to the symbol's default-value alist entry. */
1959 XCONS (tem
)->car
= tem
;
1960 /* Mark it as current for buffer B. */
1961 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
= buffer
;
1962 /* Store the current value into any forwarding in the symbol. */
1963 store_symval_forwarding (sym
,
1964 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
,
1970 /* Find all the overlays in the current buffer that contain position POS.
1971 Return the number found, and store them in a vector in *VEC_PTR.
1972 Store in *LEN_PTR the size allocated for the vector.
1973 Store in *NEXT_PTR the next position after POS where an overlay starts,
1974 or ZV if there are no more overlays.
1975 Store in *PREV_PTR the previous position before POS where an overlay ends,
1976 or BEGV if there are no previous overlays.
1977 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1979 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1980 when this function is called.
1982 If EXTEND is non-zero, we make the vector bigger if necessary.
1983 If EXTEND is zero, we never extend the vector,
1984 and we store only as many overlays as will fit.
1985 But we still return the total number of overlays. */
1988 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1991 Lisp_Object
**vec_ptr
;
1996 Lisp_Object tail
, overlay
, start
, end
, result
;
1999 Lisp_Object
*vec
= *vec_ptr
;
2002 int inhibit_storing
= 0;
2004 for (tail
= current_buffer
->overlays_before
;
2006 tail
= XCONS (tail
)->cdr
)
2008 int startpos
, endpos
;
2010 overlay
= XCONS (tail
)->car
;
2012 start
= OVERLAY_START (overlay
);
2013 end
= OVERLAY_END (overlay
);
2014 endpos
= OVERLAY_POSITION (end
);
2023 startpos
= OVERLAY_POSITION (start
);
2024 if (startpos
<= pos
)
2028 /* The supplied vector is full.
2029 Either make it bigger, or don't store any more in it. */
2032 *len_ptr
= len
*= 2;
2033 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2037 inhibit_storing
= 1;
2040 if (!inhibit_storing
)
2042 /* Keep counting overlays even if we can't return them all. */
2045 else if (startpos
< next
)
2049 for (tail
= current_buffer
->overlays_after
;
2051 tail
= XCONS (tail
)->cdr
)
2053 int startpos
, endpos
;
2055 overlay
= XCONS (tail
)->car
;
2057 start
= OVERLAY_START (overlay
);
2058 end
= OVERLAY_END (overlay
);
2059 startpos
= OVERLAY_POSITION (start
);
2062 if (startpos
< next
)
2066 endpos
= OVERLAY_POSITION (end
);
2073 *len_ptr
= len
*= 2;
2074 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2078 inhibit_storing
= 1;
2081 if (!inhibit_storing
)
2085 else if (endpos
< pos
&& endpos
> prev
)
2096 /* Find all the overlays in the current buffer that overlap the range BEG-END
2097 or are empty at BEG.
2099 Return the number found, and store them in a vector in *VEC_PTR.
2100 Store in *LEN_PTR the size allocated for the vector.
2101 Store in *NEXT_PTR the next position after POS where an overlay starts,
2102 or ZV if there are no more overlays.
2103 Store in *PREV_PTR the previous position before POS where an overlay ends,
2104 or BEGV if there are no previous overlays.
2105 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2107 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2108 when this function is called.
2110 If EXTEND is non-zero, we make the vector bigger if necessary.
2111 If EXTEND is zero, we never extend the vector,
2112 and we store only as many overlays as will fit.
2113 But we still return the total number of overlays. */
2116 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2119 Lisp_Object
**vec_ptr
;
2124 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
2127 Lisp_Object
*vec
= *vec_ptr
;
2130 int inhibit_storing
= 0;
2132 for (tail
= current_buffer
->overlays_before
;
2134 tail
= XCONS (tail
)->cdr
)
2136 int startpos
, endpos
;
2138 overlay
= XCONS (tail
)->car
;
2140 ostart
= OVERLAY_START (overlay
);
2141 oend
= OVERLAY_END (overlay
);
2142 endpos
= OVERLAY_POSITION (oend
);
2149 startpos
= OVERLAY_POSITION (ostart
);
2150 /* Count an interval if it either overlaps the range
2151 or is empty at the start of the range. */
2152 if ((beg
< endpos
&& startpos
< end
)
2153 || (startpos
== endpos
&& beg
== endpos
))
2157 /* The supplied vector is full.
2158 Either make it bigger, or don't store any more in it. */
2161 *len_ptr
= len
*= 2;
2162 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2166 inhibit_storing
= 1;
2169 if (!inhibit_storing
)
2171 /* Keep counting overlays even if we can't return them all. */
2174 else if (startpos
< next
)
2178 for (tail
= current_buffer
->overlays_after
;
2180 tail
= XCONS (tail
)->cdr
)
2182 int startpos
, endpos
;
2184 overlay
= XCONS (tail
)->car
;
2186 ostart
= OVERLAY_START (overlay
);
2187 oend
= OVERLAY_END (overlay
);
2188 startpos
= OVERLAY_POSITION (ostart
);
2191 if (startpos
< next
)
2195 endpos
= OVERLAY_POSITION (oend
);
2196 /* Count an interval if it either overlaps the range
2197 or is empty at the start of the range. */
2198 if ((beg
< endpos
&& startpos
< end
)
2199 || (startpos
== endpos
&& beg
== endpos
))
2205 *len_ptr
= len
*= 2;
2206 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2210 inhibit_storing
= 1;
2213 if (!inhibit_storing
)
2217 else if (endpos
< beg
&& endpos
> prev
)
2228 /* Fast function to just test if we're at an overlay boundary. */
2230 overlay_touches_p (pos
)
2233 Lisp_Object tail
, overlay
;
2235 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
2236 tail
= XCONS (tail
)->cdr
)
2240 overlay
= XCONS (tail
)->car
;
2241 if (!GC_OVERLAYP (overlay
))
2244 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2247 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
2251 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
2252 tail
= XCONS (tail
)->cdr
)
2256 overlay
= XCONS (tail
)->car
;
2257 if (!GC_OVERLAYP (overlay
))
2260 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2263 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
2271 Lisp_Object overlay
;
2277 compare_overlays (v1
, v2
)
2278 const void *v1
, *v2
;
2280 const struct sortvec
*s1
= (const struct sortvec
*) v1
;
2281 const struct sortvec
*s2
= (const struct sortvec
*) v2
;
2282 if (s1
->priority
!= s2
->priority
)
2283 return s1
->priority
- s2
->priority
;
2284 if (s1
->beg
!= s2
->beg
)
2285 return s1
->beg
- s2
->beg
;
2286 if (s1
->end
!= s2
->end
)
2287 return s2
->end
- s1
->end
;
2291 /* Sort an array of overlays by priority. The array is modified in place.
2292 The return value is the new size; this may be smaller than the original
2293 size if some of the overlays were invalid or were window-specific. */
2295 sort_overlays (overlay_vec
, noverlays
, w
)
2296 Lisp_Object
*overlay_vec
;
2301 struct sortvec
*sortvec
;
2302 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
2304 /* Put the valid and relevant overlays into sortvec. */
2306 for (i
= 0, j
= 0; i
< noverlays
; i
++)
2309 Lisp_Object overlay
;
2311 overlay
= overlay_vec
[i
];
2312 if (OVERLAY_VALID (overlay
)
2313 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
2314 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
2316 /* If we're interested in a specific window, then ignore
2317 overlays that are limited to some other window. */
2322 window
= Foverlay_get (overlay
, Qwindow
);
2323 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2327 /* This overlay is good and counts: put it into sortvec. */
2328 sortvec
[j
].overlay
= overlay
;
2329 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2330 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2331 tem
= Foverlay_get (overlay
, Qpriority
);
2333 sortvec
[j
].priority
= XINT (tem
);
2335 sortvec
[j
].priority
= 0;
2341 /* Sort the overlays into the proper order: increasing priority. */
2344 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
2346 for (i
= 0; i
< noverlays
; i
++)
2347 overlay_vec
[i
] = sortvec
[i
].overlay
;
2353 Lisp_Object string
, string2
;
2360 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
2361 int size
; /* Allocated length of that array. */
2362 int used
; /* How much of the array is currently in use. */
2363 int bytes
; /* Total length of the strings in buf. */
2366 /* Buffers for storing information about the overlays touching a given
2367 position. These could be automatic variables in overlay_strings, but
2368 it's more efficient to hold onto the memory instead of repeatedly
2369 allocating and freeing it. */
2370 static struct sortstrlist overlay_heads
, overlay_tails
;
2371 static unsigned char *overlay_str_buf
;
2373 /* Allocated length of overlay_str_buf. */
2374 static int overlay_str_len
;
2376 /* A comparison function suitable for passing to qsort. */
2378 cmp_for_strings (as1
, as2
)
2381 struct sortstr
*s1
= (struct sortstr
*)as1
;
2382 struct sortstr
*s2
= (struct sortstr
*)as2
;
2383 if (s1
->size
!= s2
->size
)
2384 return s2
->size
- s1
->size
;
2385 if (s1
->priority
!= s2
->priority
)
2386 return s1
->priority
- s2
->priority
;
2391 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2392 struct sortstrlist
*ssl
;
2393 Lisp_Object str
, str2
, pri
;
2398 if (ssl
->used
== ssl
->size
)
2404 ssl
->buf
= ((struct sortstr
*)
2405 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2407 ssl
->buf
[ssl
->used
].string
= str
;
2408 ssl
->buf
[ssl
->used
].string2
= str2
;
2409 ssl
->buf
[ssl
->used
].size
= size
;
2410 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2413 if (NILP (current_buffer
->enable_multibyte_characters
))
2414 nbytes
= XSTRING (str
)->size
;
2415 else if (! STRING_MULTIBYTE (str
))
2416 nbytes
= count_size_as_multibyte (XSTRING (str
)->data
,
2417 STRING_BYTES (XSTRING (str
)));
2419 nbytes
= STRING_BYTES (XSTRING (str
));
2421 ssl
->bytes
+= nbytes
;
2425 if (NILP (current_buffer
->enable_multibyte_characters
))
2426 nbytes
= XSTRING (str2
)->size
;
2427 else if (! STRING_MULTIBYTE (str2
))
2428 nbytes
= count_size_as_multibyte (XSTRING (str2
)->data
,
2429 STRING_BYTES (XSTRING (str2
)));
2431 nbytes
= STRING_BYTES (XSTRING (str2
));
2433 ssl
->bytes
+= nbytes
;
2437 /* Return the concatenation of the strings associated with overlays that
2438 begin or end at POS, ignoring overlays that are specific to a window
2439 other than W. The strings are concatenated in the appropriate order:
2440 shorter overlays nest inside longer ones, and higher priority inside
2441 lower. Normally all of the after-strings come first, but zero-sized
2442 overlays have their after-strings ride along with the before-strings
2443 because it would look strange to print them inside-out.
2445 Returns the string length, and stores the contents indirectly through
2446 PSTR, if that variable is non-null. The string may be overwritten by
2447 subsequent calls. */
2450 overlay_strings (pos
, w
, pstr
)
2453 unsigned char **pstr
;
2455 Lisp_Object ov
, overlay
, window
, str
;
2456 int startpos
, endpos
;
2457 int multibyte
= ! NILP (current_buffer
->enable_multibyte_characters
);
2459 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2460 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2461 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2463 overlay
= XCONS (ov
)->car
;
2464 if (!OVERLAYP (overlay
))
2467 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2468 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2471 if (endpos
!= pos
&& startpos
!= pos
)
2473 window
= Foverlay_get (overlay
, Qwindow
);
2474 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2477 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2478 record_overlay_string (&overlay_heads
, str
,
2480 ? Foverlay_get (overlay
, Qafter_string
)
2482 Foverlay_get (overlay
, Qpriority
),
2484 else if (endpos
== pos
2485 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2486 record_overlay_string (&overlay_tails
, str
, Qnil
,
2487 Foverlay_get (overlay
, Qpriority
),
2490 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2492 overlay
= XCONS (ov
)->car
;
2493 if (!OVERLAYP (overlay
))
2496 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2497 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2500 if (endpos
!= pos
&& startpos
!= pos
)
2502 window
= Foverlay_get (overlay
, Qwindow
);
2503 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2506 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2507 record_overlay_string (&overlay_heads
, str
,
2509 ? Foverlay_get (overlay
, Qafter_string
)
2511 Foverlay_get (overlay
, Qpriority
),
2513 else if (endpos
== pos
2514 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2515 record_overlay_string (&overlay_tails
, str
, Qnil
,
2516 Foverlay_get (overlay
, Qpriority
),
2519 if (overlay_tails
.used
> 1)
2520 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2522 if (overlay_heads
.used
> 1)
2523 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2525 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2530 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2532 if (total
> overlay_str_len
)
2534 overlay_str_len
= total
;
2535 overlay_str_buf
= (unsigned char *)xrealloc (overlay_str_buf
,
2538 p
= overlay_str_buf
;
2539 for (i
= overlay_tails
.used
; --i
>= 0;)
2542 tem
= overlay_tails
.buf
[i
].string
;
2543 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2544 STRING_BYTES (XSTRING (tem
)),
2545 STRING_MULTIBYTE (tem
), multibyte
);
2548 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2551 tem
= overlay_heads
.buf
[i
].string
;
2552 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2553 STRING_BYTES (XSTRING (tem
)),
2554 STRING_MULTIBYTE (tem
), multibyte
);
2556 tem
= overlay_heads
.buf
[i
].string2
;
2559 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2560 STRING_BYTES (XSTRING (tem
)),
2561 STRING_MULTIBYTE (tem
), multibyte
);
2565 if (p
!= overlay_str_buf
+ total
)
2568 *pstr
= overlay_str_buf
;
2574 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2577 recenter_overlay_lists (buf
, pos
)
2581 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2583 /* See if anything in overlays_before should move to overlays_after. */
2585 /* We don't strictly need prev in this loop; it should always be nil.
2586 But we use it for symmetry and in case that should cease to be true
2587 with some future change. */
2589 for (tail
= buf
->overlays_before
;
2591 prev
= tail
, tail
= next
)
2593 next
= XCONS (tail
)->cdr
;
2594 overlay
= XCONS (tail
)->car
;
2596 /* If the overlay is not valid, get rid of it. */
2597 if (!OVERLAY_VALID (overlay
))
2602 /* Splice the cons cell TAIL out of overlays_before. */
2604 XCONS (prev
)->cdr
= next
;
2606 buf
->overlays_before
= next
;
2612 beg
= OVERLAY_START (overlay
);
2613 end
= OVERLAY_END (overlay
);
2615 if (OVERLAY_POSITION (end
) > pos
)
2617 /* OVERLAY needs to be moved. */
2618 int where
= OVERLAY_POSITION (beg
);
2619 Lisp_Object other
, other_prev
;
2621 /* Splice the cons cell TAIL out of overlays_before. */
2623 XCONS (prev
)->cdr
= next
;
2625 buf
->overlays_before
= next
;
2627 /* Search thru overlays_after for where to put it. */
2629 for (other
= buf
->overlays_after
;
2631 other_prev
= other
, other
= XCONS (other
)->cdr
)
2633 Lisp_Object otherbeg
, otheroverlay
, follower
;
2636 otheroverlay
= XCONS (other
)->car
;
2637 if (! OVERLAY_VALID (otheroverlay
))
2640 otherbeg
= OVERLAY_START (otheroverlay
);
2641 if (OVERLAY_POSITION (otherbeg
) >= where
)
2645 /* Add TAIL to overlays_after before OTHER. */
2646 XCONS (tail
)->cdr
= other
;
2647 if (!NILP (other_prev
))
2648 XCONS (other_prev
)->cdr
= tail
;
2650 buf
->overlays_after
= tail
;
2654 /* We've reached the things that should stay in overlays_before.
2655 All the rest of overlays_before must end even earlier,
2660 /* See if anything in overlays_after should be in overlays_before. */
2662 for (tail
= buf
->overlays_after
;
2664 prev
= tail
, tail
= next
)
2666 next
= XCONS (tail
)->cdr
;
2667 overlay
= XCONS (tail
)->car
;
2669 /* If the overlay is not valid, get rid of it. */
2670 if (!OVERLAY_VALID (overlay
))
2675 /* Splice the cons cell TAIL out of overlays_after. */
2677 XCONS (prev
)->cdr
= next
;
2679 buf
->overlays_after
= next
;
2685 beg
= OVERLAY_START (overlay
);
2686 end
= OVERLAY_END (overlay
);
2688 /* Stop looking, when we know that nothing further
2689 can possibly end before POS. */
2690 if (OVERLAY_POSITION (beg
) > pos
)
2693 if (OVERLAY_POSITION (end
) <= pos
)
2695 /* OVERLAY needs to be moved. */
2696 int where
= OVERLAY_POSITION (end
);
2697 Lisp_Object other
, other_prev
;
2699 /* Splice the cons cell TAIL out of overlays_after. */
2701 XCONS (prev
)->cdr
= next
;
2703 buf
->overlays_after
= next
;
2705 /* Search thru overlays_before for where to put it. */
2707 for (other
= buf
->overlays_before
;
2709 other_prev
= other
, other
= XCONS (other
)->cdr
)
2711 Lisp_Object otherend
, otheroverlay
;
2714 otheroverlay
= XCONS (other
)->car
;
2715 if (! OVERLAY_VALID (otheroverlay
))
2718 otherend
= OVERLAY_END (otheroverlay
);
2719 if (OVERLAY_POSITION (otherend
) <= where
)
2723 /* Add TAIL to overlays_before before OTHER. */
2724 XCONS (tail
)->cdr
= other
;
2725 if (!NILP (other_prev
))
2726 XCONS (other_prev
)->cdr
= tail
;
2728 buf
->overlays_before
= tail
;
2733 XSETFASTINT (buf
->overlay_center
, pos
);
2737 adjust_overlays_for_insert (pos
, length
)
2741 /* After an insertion, the lists are still sorted properly,
2742 but we may need to update the value of the overlay center. */
2743 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2744 XSETFASTINT (current_buffer
->overlay_center
,
2745 XFASTINT (current_buffer
->overlay_center
) + length
);
2749 adjust_overlays_for_delete (pos
, length
)
2753 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2754 /* The deletion was to our right. No change needed; the before- and
2755 after-lists are still consistent. */
2757 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2758 /* The deletion was to our left. We need to adjust the center value
2759 to account for the change in position, but the lists are consistent
2760 given the new value. */
2761 XSETFASTINT (current_buffer
->overlay_center
,
2762 XFASTINT (current_buffer
->overlay_center
) - length
);
2764 /* We're right in the middle. There might be things on the after-list
2765 that now belong on the before-list. Recentering will move them,
2766 and also update the center point. */
2767 recenter_overlay_lists (current_buffer
, pos
);
2770 /* Fix up overlays that were garbled as a result of permuting markers
2771 in the range START through END. Any overlay with at least one
2772 endpoint in this range will need to be unlinked from the overlay
2773 list and reinserted in its proper place.
2774 Such an overlay might even have negative size at this point.
2775 If so, we'll reverse the endpoints. Can you think of anything
2776 better to do in this situation? */
2778 fix_overlays_in_range (start
, end
)
2779 register int start
, end
;
2781 Lisp_Object tem
, overlay
;
2782 Lisp_Object before_list
, after_list
;
2783 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2784 int startpos
, endpos
;
2786 /* This algorithm shifts links around instead of consing and GCing.
2787 The loop invariant is that before_list (resp. after_list) is a
2788 well-formed list except that its last element, the one that
2789 *pbefore (resp. *pafter) points to, is still uninitialized.
2790 So it's not a bug that before_list isn't initialized, although
2791 it may look strange. */
2792 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2794 overlay
= XCONS (*ptail
)->car
;
2795 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2798 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2800 || (startpos
>= start
&& startpos
< end
))
2802 /* If the overlay is backwards, fix that now. */
2803 if (startpos
> endpos
)
2806 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2808 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2810 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2812 /* Add it to the end of the wrong list. Later on,
2813 recenter_overlay_lists will move it to the right place. */
2814 if (endpos
< XINT (current_buffer
->overlay_center
))
2817 pafter
= &XCONS (*ptail
)->cdr
;
2822 pbefore
= &XCONS (*ptail
)->cdr
;
2824 *ptail
= XCONS (*ptail
)->cdr
;
2827 ptail
= &XCONS (*ptail
)->cdr
;
2829 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2831 overlay
= XCONS (*ptail
)->car
;
2832 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2833 if (startpos
>= end
)
2835 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2836 if (startpos
>= start
2837 || (endpos
>= start
&& endpos
< end
))
2839 if (startpos
> endpos
)
2842 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2844 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2846 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2848 if (endpos
< XINT (current_buffer
->overlay_center
))
2851 pafter
= &XCONS (*ptail
)->cdr
;
2856 pbefore
= &XCONS (*ptail
)->cdr
;
2858 *ptail
= XCONS (*ptail
)->cdr
;
2861 ptail
= &XCONS (*ptail
)->cdr
;
2864 /* Splice the constructed (wrong) lists into the buffer's lists,
2865 and let the recenter function make it sane again. */
2866 *pbefore
= current_buffer
->overlays_before
;
2867 current_buffer
->overlays_before
= before_list
;
2868 recenter_overlay_lists (current_buffer
,
2869 XINT (current_buffer
->overlay_center
));
2871 *pafter
= current_buffer
->overlays_after
;
2872 current_buffer
->overlays_after
= after_list
;
2873 recenter_overlay_lists (current_buffer
,
2874 XINT (current_buffer
->overlay_center
));
2877 /* We have two types of overlay: the one whose ending marker is
2878 after-insertion-marker (this is the usual case) and the one whose
2879 ending marker is before-insertion-marker. When `overlays_before'
2880 contains overlays of the latter type and the former type in this
2881 order and both overlays end at inserting position, inserting a text
2882 increases only the ending marker of the latter type, which results
2883 in incorrect ordering of `overlays_before'.
2885 This function fixes ordering of overlays in the slot
2886 `overlays_before' of the buffer *BP. Before the insertion, `point'
2887 was at PREV, and now is at POS. */
2890 fix_overlays_before (bp
, prev
, pos
)
2894 Lisp_Object
*tailp
= &bp
->overlays_before
;
2895 Lisp_Object
*right_place
;
2898 /* After the insertion, the several overlays may be in incorrect
2899 order. The possibility is that, in the list `overlays_before',
2900 an overlay which ends at POS appears after an overlay which ends
2901 at PREV. Since POS is greater than PREV, we must fix the
2902 ordering of these overlays, by moving overlays ends at POS before
2903 the overlays ends at PREV. */
2905 /* At first, find a place where disordered overlays should be linked
2906 in. It is where an overlay which end before POS exists. (i.e. an
2907 overlay whose ending marker is after-insertion-marker if disorder
2909 while (!NILP (*tailp
)
2910 && ((end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
)))
2912 tailp
= &XCONS (*tailp
)->cdr
;
2914 /* If we don't find such an overlay,
2915 or the found one ends before PREV,
2916 or the found one is the last one in the list,
2917 we don't have to fix anything. */
2920 || NILP (XCONS (*tailp
)->cdr
))
2923 right_place
= tailp
;
2924 tailp
= &XCONS (*tailp
)->cdr
;
2926 /* Now, end position of overlays in the list *TAILP should be before
2927 or equal to PREV. In the loop, an overlay which ends at POS is
2928 moved ahead to the place pointed by RIGHT_PLACE. If we found an
2929 overlay which ends before PREV, the remaining overlays are in
2931 while (!NILP (*tailp
))
2933 end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
));
2936 { /* This overlay is disordered. */
2937 Lisp_Object found
= *tailp
;
2939 /* Unlink the found overlay. */
2940 *tailp
= XCONS (found
)->cdr
;
2941 /* Move an overlay at RIGHT_PLACE to the next of the found one. */
2942 XCONS (found
)->cdr
= *right_place
;
2943 /* Link it into the right place. */
2944 *right_place
= found
;
2946 else if (end
== prev
)
2947 tailp
= &XCONS (*tailp
)->cdr
;
2948 else /* No more disordered overlay. */
2953 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2954 "Return t if OBJECT is an overlay.")
2958 return (OVERLAYP (object
) ? Qt
: Qnil
);
2961 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 5, 0,
2962 "Create a new overlay with range BEG to END in BUFFER.\n\
2963 If omitted, BUFFER defaults to the current buffer.\n\
2964 BEG and END may be integers or markers.\n\
2965 The fourth arg FRONT-ADVANCE, if non-nil, makes the\n\
2966 front delimiter advance when text is inserted there.\n\
2967 The fifth arg REAR-ADVANCE, if non-nil, makes the\n\
2968 rear delimiter advance when text is inserted there.")
2969 (beg
, end
, buffer
, front_advance
, rear_advance
)
2970 Lisp_Object beg
, end
, buffer
;
2971 Lisp_Object front_advance
, rear_advance
;
2973 Lisp_Object overlay
;
2977 XSETBUFFER (buffer
, current_buffer
);
2979 CHECK_BUFFER (buffer
, 2);
2981 && ! EQ (Fmarker_buffer (beg
), buffer
))
2982 error ("Marker points into wrong buffer");
2984 && ! EQ (Fmarker_buffer (end
), buffer
))
2985 error ("Marker points into wrong buffer");
2987 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2988 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2990 if (XINT (beg
) > XINT (end
))
2993 temp
= beg
; beg
= end
; end
= temp
;
2996 b
= XBUFFER (buffer
);
2998 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2999 end
= Fset_marker (Fmake_marker (), end
, buffer
);
3001 if (!NILP (front_advance
))
3002 XMARKER (beg
)->insertion_type
= 1;
3003 if (!NILP (rear_advance
))
3004 XMARKER (end
)->insertion_type
= 1;
3006 overlay
= allocate_misc ();
3007 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
3008 XOVERLAY (overlay
)->start
= beg
;
3009 XOVERLAY (overlay
)->end
= end
;
3010 XOVERLAY (overlay
)->plist
= Qnil
;
3012 /* Put the new overlay on the wrong list. */
3013 end
= OVERLAY_END (overlay
);
3014 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3015 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3017 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3019 /* This puts it in the right list, and in the right order. */
3020 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3022 /* We don't need to redisplay the region covered by the overlay, because
3023 the overlay has no properties at the moment. */
3028 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3031 modify_overlay (buf
, start
, end
)
3041 start
= end
; end
= temp
;
3044 /* If this is a buffer not in the selected window,
3045 we must do other windows. */
3046 if (buf
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
3047 windows_or_buffers_changed
= 1;
3048 /* If it's not current, we can't use beg_unchanged, end_unchanged for it. */
3049 else if (buf
!= current_buffer
)
3050 windows_or_buffers_changed
= 1;
3051 /* If multiple windows show this buffer, we must do other windows. */
3052 else if (buffer_shared
> 1)
3053 windows_or_buffers_changed
= 1;
3056 if (unchanged_modified
== MODIFF
3057 && overlay_unchanged_modified
== OVERLAY_MODIFF
)
3059 beg_unchanged
= start
- BEG
;
3060 end_unchanged
= Z
- end
;
3064 if (Z
- end
< end_unchanged
)
3065 end_unchanged
= Z
- end
;
3066 if (start
- BEG
< beg_unchanged
)
3067 beg_unchanged
= start
- BEG
;
3071 ++BUF_OVERLAY_MODIFF (buf
);
3075 Lisp_Object
Fdelete_overlay ();
3077 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
3078 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
3079 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
3080 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
3082 (overlay
, beg
, end
, buffer
)
3083 Lisp_Object overlay
, beg
, end
, buffer
;
3085 struct buffer
*b
, *ob
;
3086 Lisp_Object obuffer
;
3087 int count
= specpdl_ptr
- specpdl
;
3089 CHECK_OVERLAY (overlay
, 0);
3091 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3093 XSETBUFFER (buffer
, current_buffer
);
3094 CHECK_BUFFER (buffer
, 3);
3097 && ! EQ (Fmarker_buffer (beg
), buffer
))
3098 error ("Marker points into wrong buffer");
3100 && ! EQ (Fmarker_buffer (end
), buffer
))
3101 error ("Marker points into wrong buffer");
3103 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3104 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3106 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3107 return Fdelete_overlay (overlay
);
3109 if (XINT (beg
) > XINT (end
))
3112 temp
= beg
; beg
= end
; end
= temp
;
3115 specbind (Qinhibit_quit
, Qt
);
3117 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3118 b
= XBUFFER (buffer
);
3119 ob
= XBUFFER (obuffer
);
3121 /* If the overlay has changed buffers, do a thorough redisplay. */
3122 if (!EQ (buffer
, obuffer
))
3124 /* Redisplay where the overlay was. */
3125 if (!NILP (obuffer
))
3130 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3131 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3133 modify_overlay (ob
, o_beg
, o_end
);
3136 /* Redisplay where the overlay is going to be. */
3137 modify_overlay (b
, XINT (beg
), XINT (end
));
3140 /* Redisplay the area the overlay has just left, or just enclosed. */
3143 int change_beg
, change_end
;
3145 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3146 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3148 if (o_beg
== XINT (beg
))
3149 modify_overlay (b
, o_end
, XINT (end
));
3150 else if (o_end
== XINT (end
))
3151 modify_overlay (b
, o_beg
, XINT (beg
));
3154 if (XINT (beg
) < o_beg
) o_beg
= XINT (beg
);
3155 if (XINT (end
) > o_end
) o_end
= XINT (end
);
3156 modify_overlay (b
, o_beg
, o_end
);
3160 if (!NILP (obuffer
))
3162 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
3163 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
3166 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
3167 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
3169 /* Put the overlay on the wrong list. */
3170 end
= OVERLAY_END (overlay
);
3171 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3172 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3174 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3176 /* This puts it in the right list, and in the right order. */
3177 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3179 return unbind_to (count
, overlay
);
3182 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
3183 "Delete the overlay OVERLAY from its buffer.")
3185 Lisp_Object overlay
;
3189 int count
= specpdl_ptr
- specpdl
;
3191 CHECK_OVERLAY (overlay
, 0);
3193 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3197 b
= XBUFFER (buffer
);
3199 specbind (Qinhibit_quit
, Qt
);
3201 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
3202 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
3205 marker_position (OVERLAY_START (overlay
)),
3206 marker_position (OVERLAY_END (overlay
)));
3208 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
3209 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
3211 return unbind_to (count
, Qnil
);
3214 /* Overlay dissection functions. */
3216 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
3217 "Return the position at which OVERLAY starts.")
3219 Lisp_Object overlay
;
3221 CHECK_OVERLAY (overlay
, 0);
3223 return (Fmarker_position (OVERLAY_START (overlay
)));
3226 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
3227 "Return the position at which OVERLAY ends.")
3229 Lisp_Object overlay
;
3231 CHECK_OVERLAY (overlay
, 0);
3233 return (Fmarker_position (OVERLAY_END (overlay
)));
3236 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
3237 "Return the buffer OVERLAY belongs to.")
3239 Lisp_Object overlay
;
3241 CHECK_OVERLAY (overlay
, 0);
3243 return Fmarker_buffer (OVERLAY_START (overlay
));
3246 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
3247 "Return a list of the properties on OVERLAY.\n\
3248 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
3251 Lisp_Object overlay
;
3253 CHECK_OVERLAY (overlay
, 0);
3255 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
3259 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
3260 "Return a list of the overlays that contain position POS.")
3265 Lisp_Object
*overlay_vec
;
3269 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3272 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3274 /* Put all the overlays we want in a vector in overlay_vec.
3275 Store the length in len. */
3276 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3277 (int *) 0, (int *) 0);
3279 /* Make a list of them all. */
3280 result
= Flist (noverlays
, overlay_vec
);
3282 xfree (overlay_vec
);
3286 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
3287 "Return a list of the overlays that overlap the region BEG ... END.\n\
3288 Overlap means that at least one character is contained within the overlay\n\
3289 and also contained within the specified region.\n\
3290 Empty overlays are included in the result if they are located at BEG\n\
3291 or between BEG and END.")
3293 Lisp_Object beg
, end
;
3296 Lisp_Object
*overlay_vec
;
3300 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
3301 CHECK_NUMBER_COERCE_MARKER (end
, 0);
3304 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3306 /* Put all the overlays we want in a vector in overlay_vec.
3307 Store the length in len. */
3308 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
3309 (int *) 0, (int *) 0);
3311 /* Make a list of them all. */
3312 result
= Flist (noverlays
, overlay_vec
);
3314 xfree (overlay_vec
);
3318 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
3320 "Return the next position after POS where an overlay starts or ends.\n\
3321 If there are no more overlay boundaries after POS, return (point-max).")
3327 Lisp_Object
*overlay_vec
;
3331 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3334 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3336 /* Put all the overlays we want in a vector in overlay_vec.
3337 Store the length in len.
3338 endpos gets the position where the next overlay starts. */
3339 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3340 &endpos
, (int *) 0);
3342 /* If any of these overlays ends before endpos,
3343 use its ending point instead. */
3344 for (i
= 0; i
< noverlays
; i
++)
3349 oend
= OVERLAY_END (overlay_vec
[i
]);
3350 oendpos
= OVERLAY_POSITION (oend
);
3351 if (oendpos
< endpos
)
3355 xfree (overlay_vec
);
3356 return make_number (endpos
);
3359 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
3360 Sprevious_overlay_change
, 1, 1, 0,
3361 "Return the previous position before POS where an overlay starts or ends.\n\
3362 If there are no more overlay boundaries before POS, return (point-min).")
3368 Lisp_Object
*overlay_vec
;
3373 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3376 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3378 /* At beginning of buffer, we know the answer;
3379 avoid bug subtracting 1 below. */
3380 if (XINT (pos
) == BEGV
)
3383 /* Put all the overlays we want in a vector in overlay_vec.
3384 Store the length in len.
3385 prevpos gets the position of an overlay end. */
3386 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3387 (int *) 0, &prevpos
);
3389 /* If any of these overlays starts after prevpos,
3390 maybe use its starting point instead. */
3391 for (i
= 0; i
< noverlays
; i
++)
3396 ostart
= OVERLAY_START (overlay_vec
[i
]);
3397 ostartpos
= OVERLAY_POSITION (ostart
);
3398 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
3399 prevpos
= ostartpos
;
3402 /* If any overlay ends at pos, consider its starting point too. */
3403 for (tail
= current_buffer
->overlays_before
;
3405 tail
= XCONS (tail
)->cdr
)
3407 Lisp_Object overlay
, ostart
;
3410 overlay
= XCONS (tail
)->car
;
3412 ostart
= OVERLAY_START (overlay
);
3413 ostartpos
= OVERLAY_POSITION (ostart
);
3414 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
3415 prevpos
= ostartpos
;
3418 xfree (overlay_vec
);
3419 return make_number (prevpos
);
3422 /* These functions are for debugging overlays. */
3424 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
3425 "Return a pair of lists giving all the overlays of the current buffer.\n\
3426 The car has all the overlays before the overlay center;\n\
3427 the cdr has all the overlays after the overlay center.\n\
3428 Recentering overlays moves overlays between these lists.\n\
3429 The lists you get are copies, so that changing them has no effect.\n\
3430 However, the overlays you get are the real objects that the buffer uses.")
3433 Lisp_Object before
, after
;
3434 before
= current_buffer
->overlays_before
;
3436 before
= Fcopy_sequence (before
);
3437 after
= current_buffer
->overlays_after
;
3439 after
= Fcopy_sequence (after
);
3441 return Fcons (before
, after
);
3444 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
3445 "Recenter the overlays of the current buffer around position POS.")
3449 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3451 recenter_overlay_lists (current_buffer
, XINT (pos
));
3455 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
3456 "Get the property of overlay OVERLAY with property name PROP.")
3458 Lisp_Object overlay
, prop
;
3460 Lisp_Object plist
, fallback
;
3462 CHECK_OVERLAY (overlay
, 0);
3466 for (plist
= XOVERLAY (overlay
)->plist
;
3467 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
3468 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
3470 if (EQ (XCONS (plist
)->car
, prop
))
3471 return XCONS (XCONS (plist
)->cdr
)->car
;
3472 else if (EQ (XCONS (plist
)->car
, Qcategory
))
3475 tem
= Fcar (Fcdr (plist
));
3477 fallback
= Fget (tem
, prop
);
3484 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
3485 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
3486 (overlay
, prop
, value
)
3487 Lisp_Object overlay
, prop
, value
;
3489 Lisp_Object tail
, buffer
;
3492 CHECK_OVERLAY (overlay
, 0);
3494 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3496 for (tail
= XOVERLAY (overlay
)->plist
;
3497 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
3498 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
3499 if (EQ (XCONS (tail
)->car
, prop
))
3501 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
3502 XCONS (XCONS (tail
)->cdr
)->car
= value
;
3505 /* It wasn't in the list, so add it to the front. */
3506 changed
= !NILP (value
);
3507 XOVERLAY (overlay
)->plist
3508 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
3510 if (! NILP (buffer
))
3513 modify_overlay (XBUFFER (buffer
),
3514 marker_position (OVERLAY_START (overlay
)),
3515 marker_position (OVERLAY_END (overlay
)));
3516 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
3517 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
3518 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
3519 Fdelete_overlay (overlay
);
3524 /* Subroutine of report_overlay_modification. */
3526 /* Lisp vector holding overlay hook functions to call.
3527 Vector elements come in pairs.
3528 Each even-index element is a list of hook functions.
3529 The following odd-index element is the overlay they came from.
3531 Before the buffer change, we fill in this vector
3532 as we call overlay hook functions.
3533 After the buffer change, we get the functions to call from this vector.
3534 This way we always call the same functions before and after the change. */
3535 static Lisp_Object last_overlay_modification_hooks
;
3537 /* Number of elements actually used in last_overlay_modification_hooks. */
3538 static int last_overlay_modification_hooks_used
;
3540 /* Add one functionlist/overlay pair
3541 to the end of last_overlay_modification_hooks. */
3544 add_overlay_mod_hooklist (functionlist
, overlay
)
3545 Lisp_Object functionlist
, overlay
;
3547 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3549 if (last_overlay_modification_hooks_used
== oldsize
)
3552 old
= last_overlay_modification_hooks
;
3553 last_overlay_modification_hooks
3554 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3555 bcopy (XVECTOR (old
)->contents
,
3556 XVECTOR (last_overlay_modification_hooks
)->contents
,
3557 sizeof (Lisp_Object
) * oldsize
);
3559 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3560 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3563 /* Run the modification-hooks of overlays that include
3564 any part of the text in START to END.
3565 If this change is an insertion, also
3566 run the insert-before-hooks of overlay starting at END,
3567 and the insert-after-hooks of overlay ending at START.
3569 This is called both before and after the modification.
3570 AFTER is nonzero when we call after the modification.
3572 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3573 When AFTER is nonzero, they are the start position,
3574 the position after the inserted new text,
3575 and the length of deleted or replaced old text. */
3578 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3579 Lisp_Object start
, end
;
3581 Lisp_Object arg1
, arg2
, arg3
;
3583 Lisp_Object prop
, overlay
, tail
;
3584 /* 1 if this change is an insertion. */
3585 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3587 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3591 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3595 /* Call the functions recorded in last_overlay_modification_hooks
3596 rather than scanning the overlays again.
3597 First copy the vector contents, in case some of these hooks
3598 do subsequent modification of the buffer. */
3599 int size
= last_overlay_modification_hooks_used
;
3600 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3603 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3604 copy
, size
* sizeof (Lisp_Object
));
3606 gcpro1
.nvars
= size
;
3608 for (i
= 0; i
< size
;)
3610 Lisp_Object prop
, overlay
;
3612 overlay
= copy
[i
++];
3613 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3619 /* We are being called before a change.
3620 Scan the overlays to find the functions to call. */
3621 last_overlay_modification_hooks_used
= 0;
3623 for (tail
= current_buffer
->overlays_before
;
3625 tail
= XCONS (tail
)->cdr
)
3627 int startpos
, endpos
;
3628 Lisp_Object ostart
, oend
;
3630 overlay
= XCONS (tail
)->car
;
3632 ostart
= OVERLAY_START (overlay
);
3633 oend
= OVERLAY_END (overlay
);
3634 endpos
= OVERLAY_POSITION (oend
);
3635 if (XFASTINT (start
) > endpos
)
3637 startpos
= OVERLAY_POSITION (ostart
);
3638 if (insertion
&& (XFASTINT (start
) == startpos
3639 || XFASTINT (end
) == startpos
))
3641 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3644 /* Copy TAIL in case the hook recenters the overlay lists. */
3646 tail
= Fcopy_sequence (tail
);
3648 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3651 if (insertion
&& (XFASTINT (start
) == endpos
3652 || XFASTINT (end
) == endpos
))
3654 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3658 tail
= Fcopy_sequence (tail
);
3660 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3663 /* Test for intersecting intervals. This does the right thing
3664 for both insertion and deletion. */
3665 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3667 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3671 tail
= Fcopy_sequence (tail
);
3673 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3679 for (tail
= current_buffer
->overlays_after
;
3681 tail
= XCONS (tail
)->cdr
)
3683 int startpos
, endpos
;
3684 Lisp_Object ostart
, oend
;
3686 overlay
= XCONS (tail
)->car
;
3688 ostart
= OVERLAY_START (overlay
);
3689 oend
= OVERLAY_END (overlay
);
3690 startpos
= OVERLAY_POSITION (ostart
);
3691 endpos
= OVERLAY_POSITION (oend
);
3692 if (XFASTINT (end
) < startpos
)
3694 if (insertion
&& (XFASTINT (start
) == startpos
3695 || XFASTINT (end
) == startpos
))
3697 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3701 tail
= Fcopy_sequence (tail
);
3703 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3706 if (insertion
&& (XFASTINT (start
) == endpos
3707 || XFASTINT (end
) == endpos
))
3709 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3713 tail
= Fcopy_sequence (tail
);
3715 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3718 /* Test for intersecting intervals. This does the right thing
3719 for both insertion and deletion. */
3720 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3722 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3726 tail
= Fcopy_sequence (tail
);
3728 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3737 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3738 Lisp_Object list
, overlay
;
3740 Lisp_Object arg1
, arg2
, arg3
;
3742 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3744 GCPRO4 (list
, arg1
, arg2
, arg3
);
3746 add_overlay_mod_hooklist (list
, overlay
);
3748 while (!NILP (list
))
3751 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3753 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3759 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3762 evaporate_overlays (pos
)
3765 Lisp_Object tail
, overlay
, hit_list
;
3768 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3769 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3770 tail
= XCONS (tail
)->cdr
)
3773 overlay
= XCONS (tail
)->car
;
3774 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3777 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3778 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3779 hit_list
= Fcons (overlay
, hit_list
);
3782 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3783 tail
= XCONS (tail
)->cdr
)
3786 overlay
= XCONS (tail
)->car
;
3787 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3790 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3791 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3792 hit_list
= Fcons (overlay
, hit_list
);
3794 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3795 Fdelete_overlay (XCONS (hit_list
)->car
);
3798 /* Somebody has tried to store a value with an unacceptable type
3799 in the slot with offset OFFSET. */
3802 buffer_slot_type_mismatch (offset
)
3807 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3808 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3810 case Lisp_Int
: type_name
= "integers"; break;
3811 case Lisp_String
: type_name
= "strings"; break;
3812 case Lisp_Symbol
: type_name
= "symbols"; break;
3818 error ("Only %s should be stored in the buffer-local variable %s",
3819 type_name
, XSYMBOL (sym
)->name
->data
);
3825 register Lisp_Object tem
;
3827 buffer_permanent_local_flags
= 0;
3829 /* Make sure all markable slots in buffer_defaults
3830 are initialized reasonably, so mark_buffer won't choke. */
3831 reset_buffer (&buffer_defaults
);
3832 reset_buffer_local_variables (&buffer_defaults
, 1);
3833 reset_buffer (&buffer_local_symbols
);
3834 reset_buffer_local_variables (&buffer_local_symbols
, 1);
3835 /* Prevent GC from getting confused. */
3836 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3837 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3838 #ifdef USE_TEXT_PROPERTIES
3839 BUF_INTERVALS (&buffer_defaults
) = 0;
3840 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3842 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3843 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3845 /* Set up the default values of various buffer slots. */
3846 /* Must do these before making the first buffer! */
3848 /* real setup is done in loaddefs.el */
3849 buffer_defaults
.mode_line_format
= build_string ("%-");
3850 buffer_defaults
.abbrev_mode
= Qnil
;
3851 buffer_defaults
.overwrite_mode
= Qnil
;
3852 buffer_defaults
.case_fold_search
= Qt
;
3853 buffer_defaults
.auto_fill_function
= Qnil
;
3854 buffer_defaults
.selective_display
= Qnil
;
3856 buffer_defaults
.selective_display_ellipses
= Qt
;
3858 buffer_defaults
.abbrev_table
= Qnil
;
3859 buffer_defaults
.display_table
= Qnil
;
3860 buffer_defaults
.undo_list
= Qnil
;
3861 buffer_defaults
.mark_active
= Qnil
;
3862 buffer_defaults
.file_format
= Qnil
;
3863 buffer_defaults
.overlays_before
= Qnil
;
3864 buffer_defaults
.overlays_after
= Qnil
;
3865 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3867 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3868 buffer_defaults
.truncate_lines
= Qnil
;
3869 buffer_defaults
.ctl_arrow
= Qt
;
3870 buffer_defaults
.direction_reversed
= Qnil
;
3873 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3875 buffer_defaults
.enable_multibyte_characters
= Qt
;
3876 buffer_defaults
.buffer_file_coding_system
= Qnil
;
3877 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3878 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3879 buffer_defaults
.cache_long_line_scans
= Qnil
;
3880 buffer_defaults
.file_truename
= Qnil
;
3881 XSETFASTINT (buffer_defaults
.display_count
, 0);
3882 buffer_defaults
.display_time
= Qnil
;
3884 /* Assign the local-flags to the slots that have default values.
3885 The local flag is a bit that is used in the buffer
3886 to say that it has its own local value for the slot.
3887 The local flag bits are in the local_var_flags slot of the buffer. */
3889 /* Nothing can work if this isn't true */
3890 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3892 /* 0 means not a lisp var, -1 means always local, else mask */
3893 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3894 XSETINT (buffer_local_flags
.filename
, -1);
3895 XSETINT (buffer_local_flags
.directory
, -1);
3896 XSETINT (buffer_local_flags
.backed_up
, -1);
3897 XSETINT (buffer_local_flags
.save_length
, -1);
3898 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3899 XSETINT (buffer_local_flags
.read_only
, -1);
3900 XSETINT (buffer_local_flags
.major_mode
, -1);
3901 XSETINT (buffer_local_flags
.mode_name
, -1);
3902 XSETINT (buffer_local_flags
.undo_list
, -1);
3903 XSETINT (buffer_local_flags
.mark_active
, -1);
3904 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3905 XSETINT (buffer_local_flags
.file_truename
, -1);
3906 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3907 XSETINT (buffer_local_flags
.file_format
, -1);
3908 XSETINT (buffer_local_flags
.display_count
, -1);
3909 XSETINT (buffer_local_flags
.display_time
, -1);
3910 XSETINT (buffer_local_flags
.enable_multibyte_characters
, -1);
3912 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3913 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3914 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3915 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3916 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3917 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3919 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3921 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3922 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3923 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3924 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3925 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3926 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3927 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3929 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3930 /* Make this one a permanent local. */
3931 buffer_permanent_local_flags
|= 0x4000;
3933 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3934 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3935 XSETFASTINT (buffer_local_flags
.category_table
, 0x20000);
3936 XSETFASTINT (buffer_local_flags
.direction_reversed
, 0x40000);
3937 XSETFASTINT (buffer_local_flags
.buffer_file_coding_system
, 0x80000);
3938 /* Make this one a permanent local. */
3939 buffer_permanent_local_flags
|= 0x80000;
3941 Vbuffer_alist
= Qnil
;
3945 QSFundamental
= build_string ("Fundamental");
3947 Qfundamental_mode
= intern ("fundamental-mode");
3948 buffer_defaults
.major_mode
= Qfundamental_mode
;
3950 Qmode_class
= intern ("mode-class");
3952 Qprotected_field
= intern ("protected-field");
3954 Qpermanent_local
= intern ("permanent-local");
3956 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3958 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3960 /* super-magic invisible buffer */
3961 Vbuffer_alist
= Qnil
;
3963 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3965 inhibit_modification_hooks
= 0;
3971 char buf
[MAXPATHLEN
+1];
3973 struct stat dotstat
, pwdstat
;
3977 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3978 if (NILP (buffer_defaults
.enable_multibyte_characters
))
3979 Fset_buffer_multibyte (Qnil
);
3981 /* If PWD is accurate, use it instead of calling getwd. This is faster
3982 when PWD is right, and may avoid a fatal error. */
3983 if ((pwd
= getenv ("PWD")) != 0
3984 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
3985 && stat (pwd
, &pwdstat
) == 0
3986 && stat (".", &dotstat
) == 0
3987 && dotstat
.st_ino
== pwdstat
.st_ino
3988 && dotstat
.st_dev
== pwdstat
.st_dev
3989 && strlen (pwd
) < MAXPATHLEN
)
3992 else if (getcwd (buf
, MAXPATHLEN
+1) == 0)
3993 fatal ("`getcwd' failed: %s\n", strerror (errno
));
3995 else if (getwd (buf
) == 0)
3996 fatal ("`getwd' failed: %s\n", buf
);
4000 /* Maybe this should really use some standard subroutine
4001 whose definition is filename syntax dependent. */
4003 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
4005 buf
[rc
] = DIRECTORY_SEP
;
4008 #endif /* not VMS */
4010 current_buffer
->directory
= build_string (buf
);
4012 /* Add /: to the front of the name
4013 if it would otherwise be treated as magic. */
4014 temp
= Ffind_file_name_handler (current_buffer
->directory
, Qt
);
4016 /* If the default dir is just /, TEMP is non-nil
4017 because of the ange-ftp completion handler.
4018 However, it is not necessary to turn / into /:/.
4019 So avoid doing that. */
4020 && strcmp ("/", XSTRING (current_buffer
->directory
)->data
))
4021 current_buffer
->directory
4022 = concat2 (build_string ("/:"), current_buffer
->directory
);
4024 temp
= get_minibuffer (0);
4025 XBUFFER (temp
)->directory
= current_buffer
->directory
;
4028 /* initialize the buffer routines */
4032 extern Lisp_Object Qdisabled
;
4034 staticpro (&last_overlay_modification_hooks
);
4035 last_overlay_modification_hooks
4036 = Fmake_vector (make_number (10), Qnil
);
4038 staticpro (&Vbuffer_defaults
);
4039 staticpro (&Vbuffer_local_symbols
);
4040 staticpro (&Qfundamental_mode
);
4041 staticpro (&Qmode_class
);
4042 staticpro (&QSFundamental
);
4043 staticpro (&Vbuffer_alist
);
4044 staticpro (&Qprotected_field
);
4045 staticpro (&Qpermanent_local
);
4046 staticpro (&Qkill_buffer_hook
);
4047 Qoverlayp
= intern ("overlayp");
4048 staticpro (&Qoverlayp
);
4049 Qevaporate
= intern ("evaporate");
4050 staticpro (&Qevaporate
);
4051 Qmodification_hooks
= intern ("modification-hooks");
4052 staticpro (&Qmodification_hooks
);
4053 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
4054 staticpro (&Qinsert_in_front_hooks
);
4055 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
4056 staticpro (&Qinsert_behind_hooks
);
4057 Qget_file_buffer
= intern ("get-file-buffer");
4058 staticpro (&Qget_file_buffer
);
4059 Qpriority
= intern ("priority");
4060 staticpro (&Qpriority
);
4061 Qwindow
= intern ("window");
4062 staticpro (&Qwindow
);
4063 Qbefore_string
= intern ("before-string");
4064 staticpro (&Qbefore_string
);
4065 Qafter_string
= intern ("after-string");
4066 staticpro (&Qafter_string
);
4067 Qfirst_change_hook
= intern ("first-change-hook");
4068 staticpro (&Qfirst_change_hook
);
4069 Qbefore_change_functions
= intern ("before-change-functions");
4070 staticpro (&Qbefore_change_functions
);
4071 Qafter_change_functions
= intern ("after-change-functions");
4072 staticpro (&Qafter_change_functions
);
4074 Fput (Qprotected_field
, Qerror_conditions
,
4075 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
4076 Fput (Qprotected_field
, Qerror_message
,
4077 build_string ("Attempt to modify a protected field"));
4079 /* All these use DEFVAR_LISP_NOPRO because the slots in
4080 buffer_defaults will all be marked via Vbuffer_defaults. */
4082 DEFVAR_LISP_NOPRO ("default-mode-line-format",
4083 &buffer_defaults
.mode_line_format
,
4084 "Default value of `mode-line-format' for buffers that don't override it.\n\
4085 This is the same as (default-value 'mode-line-format).");
4087 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
4088 &buffer_defaults
.abbrev_mode
,
4089 "Default value of `abbrev-mode' for buffers that do not override it.\n\
4090 This is the same as (default-value 'abbrev-mode).");
4092 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
4093 &buffer_defaults
.ctl_arrow
,
4094 "Default value of `ctl-arrow' for buffers that do not override it.\n\
4095 This is the same as (default-value 'ctl-arrow).");
4097 DEFVAR_LISP_NOPRO ("default-direction-reversed",
4098 &buffer_defaults
.direction_reversed
,
4099 "Default value of `direction_reversed' for buffers that do not override it.\n\
4100 This is the same as (default-value 'direction-reversed).");
4102 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
4103 &buffer_defaults
.enable_multibyte_characters
,
4104 "Default value of `enable-multibyte-characters' for buffers not overriding it.\n\
4105 This is the same as (default-value 'enable-multibyte-characters).");
4107 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
4108 &buffer_defaults
.buffer_file_coding_system
,
4109 "Default value of `buffer-file-coding-system' for buffers not overriding it.\n\
4110 This is the same as (default-value 'buffer-file-coding-system).");
4112 DEFVAR_LISP_NOPRO ("default-truncate-lines",
4113 &buffer_defaults
.truncate_lines
,
4114 "Default value of `truncate-lines' for buffers that do not override it.\n\
4115 This is the same as (default-value 'truncate-lines).");
4117 DEFVAR_LISP_NOPRO ("default-fill-column",
4118 &buffer_defaults
.fill_column
,
4119 "Default value of `fill-column' for buffers that do not override it.\n\
4120 This is the same as (default-value 'fill-column).");
4122 DEFVAR_LISP_NOPRO ("default-left-margin",
4123 &buffer_defaults
.left_margin
,
4124 "Default value of `left-margin' for buffers that do not override it.\n\
4125 This is the same as (default-value 'left-margin).");
4127 DEFVAR_LISP_NOPRO ("default-tab-width",
4128 &buffer_defaults
.tab_width
,
4129 "Default value of `tab-width' for buffers that do not override it.\n\
4130 This is the same as (default-value 'tab-width).");
4132 DEFVAR_LISP_NOPRO ("default-case-fold-search",
4133 &buffer_defaults
.case_fold_search
,
4134 "Default value of `case-fold-search' for buffers that don't override it.\n\
4135 This is the same as (default-value 'case-fold-search).");
4138 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
4139 &buffer_defaults
.buffer_file_type
,
4140 "Default file type for buffers that do not override it.\n\
4141 This is the same as (default-value 'buffer-file-type).\n\
4142 The file type is nil for text, t for binary.");
4145 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
4148 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
4149 But make-docfile finds it!
4150 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
4152 "Template for displaying mode line for current buffer.\n\
4153 Each buffer has its own value of this variable.\n\
4154 Value may be a string, a symbol or a list or cons cell.\n\
4155 For a symbol, its value is used (but it is ignored if t or nil).\n\
4156 A string appearing directly as the value of a symbol is processed verbatim\n\
4157 in that the %-constructs below are not recognized.\n\
4158 For a list whose car is a symbol, the symbol's value is taken,\n\
4159 and if that is non-nil, the cadr of the list is processed recursively.\n\
4160 Otherwise, the caddr of the list (if there is one) is processed.\n\
4161 For a list whose car is a string or list, each element is processed\n\
4162 recursively and the results are effectively concatenated.\n\
4163 For a list whose car is an integer, the cdr of the list is processed\n\
4164 and padded (if the number is positive) or truncated (if negative)\n\
4165 to the width specified by that number.\n\
4166 A string is printed verbatim in the mode line except for %-constructs:\n\
4167 (%-constructs are allowed when the string is the entire mode-line-format\n\
4168 or when it is found in a cons-cell or a list)\n\
4169 %b -- print buffer name. %f -- print visited file name.\n\
4170 %F -- print frame name.\n\
4171 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
4172 % means buffer is read-only and * means it is modified.\n\
4173 For a modified read-only buffer, %* gives % and %+ gives *.\n\
4174 %s -- print process status. %l -- print the current line number.\n\
4175 %c -- print the current column number (this makes editing slower).\n\
4176 To make the column number update correctly in all cases,\n\
4177 `column-number-mode' must be non-nil.\n\
4178 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
4179 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
4180 or print Bottom or All.\n\
4181 %n -- print Narrow if appropriate.\n\
4182 %t -- print T if file is text, B if binary.\n\
4183 %[ -- print one [ for each recursive editing level. %] similar.\n\
4184 %% -- print %. %- -- print infinitely many dashes.\n\
4185 Decimal digits after the % specify field width to which to pad.");
4188 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
4189 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
4190 nil here means use current buffer's major mode.");
4192 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
4193 make_number (Lisp_Symbol
),
4194 "Symbol for current buffer's major mode.");
4196 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
4197 make_number (Lisp_String
),
4198 "Pretty name of current buffer's major mode (a string).");
4200 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
4201 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
4202 Automatically becomes buffer-local when set in any fashion.");
4204 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
4206 "*Non-nil if searches and matches should ignore case.\n\
4207 Automatically becomes buffer-local when set in any fashion.");
4209 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
4210 make_number (Lisp_Int
),
4211 "*Column beyond which automatic line-wrapping should happen.\n\
4212 Automatically becomes buffer-local when set in any fashion.");
4214 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
4215 make_number (Lisp_Int
),
4216 "*Column for the default indent-line-function to indent to.\n\
4217 Linefeed indents to this column in Fundamental mode.\n\
4218 Automatically becomes buffer-local when set in any fashion.");
4220 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
4221 make_number (Lisp_Int
),
4222 "*Distance between tab stops (for display of tab characters), in columns.\n\
4223 Automatically becomes buffer-local when set in any fashion.");
4225 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
4226 "*Non-nil means display control chars with uparrow.\n\
4227 A value of nil means use backslash and octal digits.\n\
4228 Automatically becomes buffer-local when set in any fashion.\n\
4229 This variable does not apply to characters whose display is specified\n\
4230 in the current display table (if there is one).");
4232 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
4233 ¤t_buffer
->enable_multibyte_characters
,
4235 "Non-nil means the buffer contents are regarded as multi-byte characters.\n\
4236 Otherwise they are regarded as unibyte. This affects the display,\n\
4237 file I/O and the behavior of various editing commands.\n\
4239 This variable is buffer-local but you cannot set it directly;\n\
4240 use the function `set-buffer-multibyte' to change a buffer's representation.\n\
4241 Changing its default value with `setq-default' is supported.\n\
4242 See also variable `default-enable-multibyte-characters' and Info node\n\
4243 `(elisp)Text Representations'.");
4245 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
4246 ¤t_buffer
->buffer_file_coding_system
, Qnil
,
4247 "Coding system to be used for encoding the buffer contents on saving.\n\
4248 This variable applies to saving the buffer, and also to `write-region'\n\
4249 and other functions that use `write-region'.\n\
4250 It does not apply to sending output to subprocesses, however.\n\
4252 If this is nil, the buffer is saved without any code conversion\n\
4253 unless some coding system is specified in `file-coding-system-alist'\n\
4254 for the buffer file.\n\
4256 The variable `coding-system-for-write', if non-nil, overrides this variable.\n\
4258 This variable is never applied to a way of decoding\n\
4259 a file while reading it.");
4261 DEFVAR_PER_BUFFER ("direction-reversed", ¤t_buffer
->direction_reversed
,
4263 "*Non-nil means lines in the buffer are displayed right to left.");
4265 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
4266 "*Non-nil means do not display continuation lines;\n\
4267 give each line of text one screen line.\n\
4268 Automatically becomes buffer-local when set in any fashion.\n\
4270 Note that this is overridden by the variable\n\
4271 `truncate-partial-width-windows' if that variable is non-nil\n\
4272 and this buffer is not full-frame width.");
4275 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
4277 "Non-nil if the visited file is a binary file.\n\
4278 This variable is meaningful on MS-DOG and Windows NT.\n\
4279 On those systems, it is automatically local in every buffer.\n\
4280 On other systems, this variable is normally always nil.");
4283 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
4284 make_number (Lisp_String
),
4285 "Name of default directory of current buffer. Should end with slash.\n\
4286 Each buffer has its own value of this variable.");
4288 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
4290 "Function called (if non-nil) to perform auto-fill.\n\
4291 It is called after self-inserting a space or newline.\n\
4292 Each buffer has its own value of this variable.\n\
4293 NOTE: This variable is not a hook;\n\
4294 its value may not be a list of functions.");
4296 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
4297 make_number (Lisp_String
),
4298 "Name of file visited in current buffer, or nil if not visiting a file.\n\
4299 Each buffer has its own value of this variable.");
4301 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
4302 make_number (Lisp_String
),
4303 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
4304 The truename of a file is calculated by `file-truename'\n\
4305 and then abbreviated with `abbreviate-file-name'.\n\
4306 Each buffer has its own value of this variable.");
4308 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
4309 ¤t_buffer
->auto_save_file_name
,
4310 make_number (Lisp_String
),
4311 "Name of file for auto-saving current buffer,\n\
4312 or nil if buffer should not be auto-saved.\n\
4313 Each buffer has its own value of this variable.");
4315 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
4316 "Non-nil if this buffer is read-only.\n\
4317 Each buffer has its own value of this variable.");
4319 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
4320 "Non-nil if this buffer's file has been backed up.\n\
4321 Backing up is done before the first time the file is saved.\n\
4322 Each buffer has its own value of this variable.");
4324 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
4325 make_number (Lisp_Int
),
4326 "Length of current buffer when last read in, saved or auto-saved.\n\
4328 Each buffer has its own value of this variable.");
4330 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
4332 "Non-nil enables selective display:\n\
4333 Integer N as value means display only lines\n\
4334 that start with less than n columns of space.\n\
4335 A value of t means, after a ^M, all the rest of the line is invisible.\n\
4336 Then ^M's in the file are written into files as newlines.\n\n\
4337 Automatically becomes buffer-local when set in any fashion.");
4340 DEFVAR_PER_BUFFER ("selective-display-ellipses",
4341 ¤t_buffer
->selective_display_ellipses
,
4343 "t means display ... on previous line when a line is invisible.\n\
4344 Automatically becomes buffer-local when set in any fashion.");
4347 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
4348 "Non-nil if self-insertion should replace existing text.\n\
4349 The value should be one of `overwrite-mode-textual',\n\
4350 `overwrite-mode-binary', or nil.\n\
4351 If it is `overwrite-mode-textual', self-insertion still\n\
4352 inserts at the end of a line, and inserts when point is before a tab,\n\
4353 until the tab is filled in.\n\
4354 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
4355 Automatically becomes buffer-local when set in any fashion.");
4357 #if 0 /* The doc string is too long for some compilers,
4358 but make-docfile can find it in this comment. */
4359 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4361 "Display table that controls display of the contents of current buffer.\n\
4362 Automatically becomes buffer-local when set in any fashion.\n\
4363 The display table is a char-table created with `make-display-table'.\n\
4364 The ordinary char-table elements control how to display each possible text\n\
4365 character. Each value should be a vector of characters or nil;\n\
4366 nil means display the character in the default fashion.\n\
4367 There are six extra slots to control the display of\n\
4368 the end of a truncated screen line (extra-slot 0, a single character);\n\
4369 the end of a continued line (extra-slot 1, a single character);\n\
4370 the escape character used to display character codes in octal\n\
4371 (extra-slot 2, a single character);\n\
4372 the character used as an arrow for control characters (extra-slot 3,\n\
4373 a single character);\n\
4374 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
4375 a vector of characters);\n\
4376 the character used to draw the border between side-by-side windows\n\
4377 (extra-slot 5, a single character).\n\
4378 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
4379 If this variable is nil, the value of `standard-display-table' is used.\n\
4380 Each window can have its own, overriding display table.");
4382 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4385 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
4388 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
4389 "If non-nil, a function to call before each text change (obsolete).\n\
4390 Two arguments are passed to the function: the positions of\n\
4391 the beginning and end of the range of old text to be changed.\n\
4392 \(For an insertion, the beginning and end are at the same place.)\n\
4393 No information is given about the length of the text after the change.\n\
4395 Buffer changes made while executing the `before-change-function'\n\
4396 don't call any before-change or after-change functions.\n\
4397 That's because these variables are temporarily set to nil.\n\
4398 As a result, a hook function cannot straightforwardly alter the value of\n\
4399 these variables. See the Emacs Lisp manual for a way of\n\
4400 accomplishing an equivalent result by using other variables.\n\n\
4401 This variable is obsolete; use `before-change-functions' instead.");
4402 Vbefore_change_function
= Qnil
;
4404 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
4405 "If non-nil, a Function to call after each text change (obsolete).\n\
4406 Three arguments are passed to the function: the positions of\n\
4407 the beginning and end of the range of changed text,\n\
4408 and the length of the pre-change text replaced by that range.\n\
4409 \(For an insertion, the pre-change length is zero;\n\
4410 for a deletion, that length is the number of bytes deleted,\n\
4411 and the post-change beginning and end are at the same place.)\n\
4413 Buffer changes made while executing the `after-change-function'\n\
4414 don't call any before-change or after-change functions.\n\
4415 That's because these variables are temporarily set to nil.\n\
4416 As a result, a hook function cannot straightforwardly alter the value of\n\
4417 these variables. See the Emacs Lisp manual for a way of\n\
4418 accomplishing an equivalent result by using other variables.\n\n\
4419 This variable is obsolete; use `after-change-functions' instead.");
4420 Vafter_change_function
= Qnil
;
4422 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
4423 "List of functions to call before each text change.\n\
4424 Two arguments are passed to each function: the positions of\n\
4425 the beginning and end of the range of old text to be changed.\n\
4426 \(For an insertion, the beginning and end are at the same place.)\n\
4427 No information is given about the length of the text after the change.\n\
4429 Buffer changes made while executing the `before-change-functions'\n\
4430 don't call any before-change or after-change functions.\n\
4431 That's because these variables are temporarily set to nil.\n\
4432 As a result, a hook function cannot straightforwardly alter the value of\n\
4433 these variables. See the Emacs Lisp manual for a way of\n\
4434 accomplishing an equivalent result by using other variables.\n\
4436 If an unhandled error happens in running these functions,\n\
4437 the variable's value remains nil. That prevents the error\n\
4438 from happening repeatedly and making Emacs nonfunctional.");
4439 Vbefore_change_functions
= Qnil
;
4441 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
4442 "List of function to call after each text change.\n\
4443 Three arguments are passed to each function: the positions of\n\
4444 the beginning and end of the range of changed text,\n\
4445 and the length in bytes of the pre-change text replaced by that range.\n\
4446 \(For an insertion, the pre-change length is zero;\n\
4447 for a deletion, that length is the number of bytes deleted,\n\
4448 and the post-change beginning and end are at the same place.)\n\
4450 Buffer changes made while executing the `after-change-functions'\n\
4451 don't call any before-change or after-change functions.\n\
4452 That's because these variables are temporarily set to nil.\n\
4453 As a result, a hook function cannot straightforwardly alter the value of\n\
4454 these variables. See the Emacs Lisp manual for a way of\n\
4455 accomplishing an equivalent result by using other variables.\n\
4457 If an unhandled error happens in running these functions,\n\
4458 the variable's value remains nil. That prevents the error\n\
4459 from happening repeatedly and making Emacs nonfunctional.");
4460 Vafter_change_functions
= Qnil
;
4462 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
4463 "A list of functions to call before changing a buffer which is unmodified.\n\
4464 The functions are run using the `run-hooks' function.");
4465 Vfirst_change_hook
= Qnil
;
4467 #if 0 /* The doc string is too long for some compilers,
4468 but make-docfile can find it in this comment. */
4469 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4470 "List of undo entries in current buffer.\n\
4471 This variable is always local in all buffers.\n\
4472 Recent changes come first; older changes follow newer.\n\
4474 An entry (BEG . END) represents an insertion which begins at\n\
4475 position BEG and ends at position END.\n\
4477 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
4478 from (abs POSITION). If POSITION is positive, point was at the front\n\
4479 of the text being deleted; if negative, point was at the end.\n\
4481 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
4482 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
4483 of the visited file's modification time, as of that time. If the\n\
4484 modification time of the most recent save is different, this entry is\n\
4487 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
4488 was modified between BEG and END. PROPERTY is the property name,\n\
4489 and VALUE is the old value.\n\
4491 An entry (MARKER . DISTANCE) indicates that the marker MARKER\n\
4492 was adjusted in position by the offset DISTANCE (an integer).\n\
4494 An entry of the form POSITION indicates that point was at the buffer\n\
4495 location given by the integer. Undoing an entry of this form places\n\
4496 point at POSITION.\n\
4498 nil marks undo boundaries. The undo command treats the changes\n\
4499 between two undo boundaries as a single step to be undone.\n\
4501 If the value of the variable is t, undo information is not recorded.");
4503 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4506 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
4507 "Non-nil means the mark and region are currently active in this buffer.\n\
4508 Automatically local in all buffers.");
4510 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
4511 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
4512 This variable is buffer-local, in all buffers.\n\
4514 Normally, the line-motion functions work by scanning the buffer for\n\
4515 newlines. Columnar operations (like move-to-column and\n\
4516 compute-motion) also work by scanning the buffer, summing character\n\
4517 widths as they go. This works well for ordinary text, but if the\n\
4518 buffer's lines are very long (say, more than 500 characters), these\n\
4519 motion functions will take longer to execute. Emacs may also take\n\
4520 longer to update the display.\n\
4522 If cache-long-line-scans is non-nil, these motion functions cache the\n\
4523 results of their scans, and consult the cache to avoid rescanning\n\
4524 regions of the buffer until the text is modified. The caches are most\n\
4525 beneficial when they prevent the most searching---that is, when the\n\
4526 buffer contains long lines and large regions of characters with the\n\
4527 same, fixed screen width.\n\
4529 When cache-long-line-scans is non-nil, processing short lines will\n\
4530 become slightly slower (because of the overhead of consulting the\n\
4531 cache), and the caches will use memory roughly proportional to the\n\
4532 number of newlines and characters whose screen width varies.\n\
4534 The caches require no explicit maintenance; their accuracy is\n\
4535 maintained internally by the Emacs primitives. Enabling or disabling\n\
4536 the cache should not affect the behavior of any of the motion\n\
4537 functions; it should only affect their performance.");
4539 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
4540 "Value of point before the last series of scroll operations, or nil.\n\
4541 This variable is always local in all buffers.");
4543 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
4544 "List of formats to use when saving this buffer.\n\
4545 This variable is always local in all buffers.\n\
4546 Formats are defined by `format-alist'. This variable is\n\
4547 set when a file is visited. Automatically local in all buffers.");
4549 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
4550 ¤t_buffer
->invisibility_spec
, Qnil
,
4551 "Invisibility spec of this buffer.\n\
4552 This variable is always local in all buffers.\n\
4553 The default is t, which means that text is invisible\n\
4554 if it has a non-nil `invisible' property.\n\
4555 If the value is a list, a text character is invisible if its `invisible'\n\
4556 property is an element in that list.\n\
4557 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
4558 then characters with property value PROP are invisible,\n\
4559 and they have an ellipsis as well if ELLIPSIS is non-nil.");
4561 DEFVAR_PER_BUFFER ("buffer-display-count",
4562 ¤t_buffer
->display_count
, Qnil
,
4563 "A number incremented each time this buffer is displayed in a window.\n\
4564 This variable is always local in all buffers.\n\
4565 The function `set-window-buffer increments it.");
4567 DEFVAR_PER_BUFFER ("buffer-display-time",
4568 ¤t_buffer
->display_time
, Qnil
,
4569 "Time stamp updated each time this buffer is displayed in a window.\n\
4570 This variable is always local in all buffers.\n\
4571 The function `set-window-buffer' updates this variable\n\
4572 to the value obtained by calling `current-time'.\n\
4573 If the buffer has never been shown in a window, the value is nil.");
4575 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
4576 "*Non-nil means deactivate the mark when the buffer contents change.\n\
4577 Non-nil also enables highlighting of the region whenever the mark is active.\n\
4578 The variable `highlight-nonselected-windows' controls whether to highlight\n\
4579 all windows or just the selected window.");
4580 Vtransient_mark_mode
= Qnil
;
4582 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
4583 "*Non-nil means disregard read-only status of buffers or characters.\n\
4584 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
4585 text properties. If the value is a list, disregard `buffer-read-only'\n\
4586 and disregard a `read-only' text property if the property value\n\
4587 is a member of the list.");
4588 Vinhibit_read_only
= Qnil
;
4590 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
4591 "List of functions called with no args to query before killing a buffer.");
4592 Vkill_buffer_query_functions
= Qnil
;
4594 defsubr (&Sbuffer_live_p
);
4595 defsubr (&Sbuffer_list
);
4596 defsubr (&Sget_buffer
);
4597 defsubr (&Sget_file_buffer
);
4598 defsubr (&Sget_buffer_create
);
4599 defsubr (&Smake_indirect_buffer
);
4600 defsubr (&Sgenerate_new_buffer_name
);
4601 defsubr (&Sbuffer_name
);
4602 /*defsubr (&Sbuffer_number);*/
4603 defsubr (&Sbuffer_file_name
);
4604 defsubr (&Sbuffer_base_buffer
);
4605 defsubr (&Sbuffer_local_variables
);
4606 defsubr (&Sbuffer_modified_p
);
4607 defsubr (&Sset_buffer_modified_p
);
4608 defsubr (&Sbuffer_modified_tick
);
4609 defsubr (&Srename_buffer
);
4610 defsubr (&Sother_buffer
);
4611 defsubr (&Sbuffer_disable_undo
);
4612 defsubr (&Sbuffer_enable_undo
);
4613 defsubr (&Skill_buffer
);
4614 defsubr (&Sset_buffer_major_mode
);
4615 defsubr (&Sswitch_to_buffer
);
4616 defsubr (&Spop_to_buffer
);
4617 defsubr (&Scurrent_buffer
);
4618 defsubr (&Sset_buffer
);
4619 defsubr (&Sbarf_if_buffer_read_only
);
4620 defsubr (&Sbury_buffer
);
4621 defsubr (&Serase_buffer
);
4622 defsubr (&Sset_buffer_multibyte
);
4623 defsubr (&Skill_all_local_variables
);
4625 defsubr (&Soverlayp
);
4626 defsubr (&Smake_overlay
);
4627 defsubr (&Sdelete_overlay
);
4628 defsubr (&Smove_overlay
);
4629 defsubr (&Soverlay_start
);
4630 defsubr (&Soverlay_end
);
4631 defsubr (&Soverlay_buffer
);
4632 defsubr (&Soverlay_properties
);
4633 defsubr (&Soverlays_at
);
4634 defsubr (&Soverlays_in
);
4635 defsubr (&Snext_overlay_change
);
4636 defsubr (&Sprevious_overlay_change
);
4637 defsubr (&Soverlay_recenter
);
4638 defsubr (&Soverlay_lists
);
4639 defsubr (&Soverlay_get
);
4640 defsubr (&Soverlay_put
);
4646 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
4647 initial_define_key (control_x_map
, 'k', "kill-buffer");
4649 /* This must not be in syms_of_buffer, because Qdisabled is not
4650 initialized when that function gets called. */
4651 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);