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
;
372 #if !NO_PROMPT_IN_BUFFER
373 b
->minibuffer_prompt_length
= Qnil
;
376 /* Put this on the chain of all buffers including killed ones. */
377 b
->next
= all_buffers
;
380 /* An ordinary buffer normally doesn't need markers
381 to handle BEGV and ZV. */
383 b
->begv_marker
= Qnil
;
386 name
= Fcopy_sequence (name
);
387 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
390 if (XSTRING (name
)->data
[0] != ' ')
396 reset_buffer_local_variables (b
, 1);
398 /* Put this in the alist of all live buffers. */
400 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
402 b
->mark
= Fmake_marker ();
403 BUF_MARKERS (b
) = Qnil
;
408 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
409 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
410 "Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.\n\
411 BASE-BUFFER should be an existing buffer (or buffer name).\n\
412 NAME should be a string which is not the name of an existing buffer.")
414 register Lisp_Object base_buffer
, name
;
416 register Lisp_Object buf
;
417 register struct buffer
*b
;
419 buf
= Fget_buffer (name
);
421 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
423 base_buffer
= Fget_buffer (base_buffer
);
424 if (NILP (base_buffer
))
425 error ("No such buffer: `%s'",
426 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
428 if (XSTRING (name
)->size
== 0)
429 error ("Empty string for buffer name is not allowed");
431 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
433 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
435 if (XBUFFER (base_buffer
)->base_buffer
)
436 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
438 b
->base_buffer
= XBUFFER (base_buffer
);
440 /* Use the base buffer's text object. */
441 b
->text
= b
->base_buffer
->text
;
443 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
444 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
445 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
446 BUF_BEGV_BYTE (b
) = BUF_BEGV_BYTE (b
->base_buffer
);
447 BUF_ZV_BYTE (b
) = BUF_ZV_BYTE (b
->base_buffer
);
448 BUF_PT_BYTE (b
) = BUF_PT_BYTE (b
->base_buffer
);
450 b
->newline_cache
= 0;
451 b
->width_run_cache
= 0;
452 b
->width_table
= Qnil
;
453 #if !NO_PROMPT_IN_BUFFER
454 b
->minibuffer_prompt_length
= Qnil
;
457 /* Put this on the chain of all buffers including killed ones. */
458 b
->next
= all_buffers
;
461 name
= Fcopy_sequence (name
);
462 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
466 reset_buffer_local_variables (b
, 1);
468 /* Put this in the alist of all live buffers. */
470 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
472 b
->mark
= Fmake_marker ();
475 /* The multibyte status belongs to the base buffer. */
476 b
->enable_multibyte_characters
= b
->base_buffer
->enable_multibyte_characters
;
478 /* Make sure the base buffer has markers for its narrowing. */
479 if (NILP (b
->base_buffer
->pt_marker
))
481 b
->base_buffer
->pt_marker
= Fmake_marker ();
482 set_marker_both (b
->base_buffer
->pt_marker
, base_buffer
,
483 BUF_PT (b
->base_buffer
),
484 BUF_PT_BYTE (b
->base_buffer
));
486 if (NILP (b
->base_buffer
->begv_marker
))
488 b
->base_buffer
->begv_marker
= Fmake_marker ();
489 set_marker_both (b
->base_buffer
->begv_marker
, base_buffer
,
490 BUF_BEGV (b
->base_buffer
),
491 BUF_BEGV_BYTE (b
->base_buffer
));
493 if (NILP (b
->base_buffer
->zv_marker
))
495 b
->base_buffer
->zv_marker
= Fmake_marker ();
496 set_marker_both (b
->base_buffer
->zv_marker
, base_buffer
,
497 BUF_ZV (b
->base_buffer
),
498 BUF_ZV_BYTE (b
->base_buffer
));
499 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
502 /* Give the indirect buffer markers for its narrowing. */
503 b
->pt_marker
= Fmake_marker ();
504 set_marker_both (b
->pt_marker
, buf
, BUF_PT (b
), BUF_PT_BYTE (b
));
505 b
->begv_marker
= Fmake_marker ();
506 set_marker_both (b
->begv_marker
, buf
, BUF_BEGV (b
), BUF_BEGV_BYTE (b
));
507 b
->zv_marker
= Fmake_marker ();
508 set_marker_both (b
->zv_marker
, buf
, BUF_ZV (b
), BUF_ZV_BYTE (b
));
509 XMARKER (b
->zv_marker
)->insertion_type
= 1;
514 /* Reinitialize everything about a buffer except its name and contents
515 and local variables. */
519 register struct buffer
*b
;
522 b
->file_truename
= Qnil
;
523 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
525 XSETFASTINT (b
->save_length
, 0);
526 b
->last_window_start
= 1;
527 /* It is more conservative to start out "changed" than "unchanged". */
530 b
->auto_save_modified
= 0;
531 b
->auto_save_failure_time
= -1;
532 b
->auto_save_file_name
= Qnil
;
534 b
->overlays_before
= Qnil
;
535 b
->overlays_after
= Qnil
;
536 XSETFASTINT (b
->overlay_center
, 1);
537 b
->mark_active
= Qnil
;
538 b
->point_before_scroll
= Qnil
;
539 b
->file_format
= Qnil
;
540 b
->last_selected_window
= Qnil
;
541 XSETINT (b
->display_count
, 0);
542 b
->display_time
= Qnil
;
545 b
->enable_multibyte_characters
= buffer_defaults
.enable_multibyte_characters
;
548 /* Reset buffer B's local variables info.
549 Don't use this on a buffer that has already been in use;
550 it does not treat permanent locals consistently.
551 Instead, use Fkill_all_local_variables.
553 If PERMANENT_TOO is 1, then we reset permanent built-in
554 buffer-local variables. If PERMANENT_TOO is 0,
555 we preserve those. */
558 reset_buffer_local_variables (b
, permanent_too
)
559 register struct buffer
*b
;
565 /* Decide which built-in local variables to reset. */
569 dont_reset
= buffer_permanent_local_flags
;
571 /* Reset the major mode to Fundamental, together with all the
572 things that depend on the major mode.
573 default-major-mode is handled at a higher level.
574 We ignore it here. */
575 b
->major_mode
= Qfundamental_mode
;
577 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
578 b
->mode_name
= QSFundamental
;
579 b
->minor_modes
= Qnil
;
581 /* If the standard case table has been altered and invalidated,
582 fix up its insides first. */
583 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[0])
584 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[1])
585 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[2])))
586 Fset_standard_case_table (Vascii_downcase_table
);
588 b
->downcase_table
= Vascii_downcase_table
;
589 b
->upcase_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[0];
590 b
->case_canon_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[1];
591 b
->case_eqv_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[2];
592 b
->invisibility_spec
= Qt
;
594 b
->buffer_file_type
= Qnil
;
598 b
->sort_table
= XSTRING (Vascii_sort_table
);
599 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
602 /* Reset all (or most) per-buffer variables to their defaults. */
603 b
->local_var_alist
= Qnil
;
604 b
->local_var_flags
&= dont_reset
;
606 /* For each slot that has a default value,
607 copy that into the slot. */
609 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
610 offset
< sizeof (struct buffer
);
611 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
613 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
615 /* Don't reset a permanent local. */
616 && ! (dont_reset
& flag
))
618 *(Lisp_Object
*)(offset
+ (char *)b
)
619 = *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
623 /* We split this away from generate-new-buffer, because rename-buffer
624 and set-visited-file-name ought to be able to use this to really
625 rename the buffer properly. */
627 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
629 "Return a string that is the name of no existing buffer based on NAME.\n\
630 If there is no live buffer named NAME, then return NAME.\n\
631 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
632 until an unused name is found, and then return that name.\n\
633 Optional second argument IGNORE specifies a name that is okay to use\n\
634 \(if it is in the sequence to be tried)\n\
635 even if a buffer with that name exists.")
637 register Lisp_Object name
, ignore
;
639 register Lisp_Object gentemp
, tem
;
643 CHECK_STRING (name
, 0);
645 tem
= Fget_buffer (name
);
652 sprintf (number
, "<%d>", ++count
);
653 gentemp
= concat2 (name
, build_string (number
));
654 tem
= Fstring_equal (gentemp
, ignore
);
657 tem
= Fget_buffer (gentemp
);
664 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
665 "Return the name of BUFFER, as a string.\n\
666 With no argument or nil as argument, return the name of the current buffer.")
668 register Lisp_Object buffer
;
671 return current_buffer
->name
;
672 CHECK_BUFFER (buffer
, 0);
673 return XBUFFER (buffer
)->name
;
676 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
677 "Return name of file BUFFER is visiting, or nil if none.\n\
678 No argument or nil as argument means use the current buffer.")
680 register Lisp_Object buffer
;
683 return current_buffer
->filename
;
684 CHECK_BUFFER (buffer
, 0);
685 return XBUFFER (buffer
)->filename
;
688 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
690 "Return the base buffer of indirect buffer BUFFER.\n\
691 If BUFFER is not indirect, return nil.")
693 register Lisp_Object buffer
;
696 Lisp_Object base_buffer
;
699 base
= current_buffer
->base_buffer
;
702 CHECK_BUFFER (buffer
, 0);
703 base
= XBUFFER (buffer
)->base_buffer
;
708 XSETBUFFER (base_buffer
, base
);
712 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
713 Sbuffer_local_variables
, 0, 1, 0,
714 "Return an alist of variables that are buffer-local in BUFFER.\n\
715 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
716 For a symbol that is locally unbound, just the symbol appears in the value.\n\
717 Note that storing new VALUEs in these elements doesn't change the variables.\n\
718 No argument or nil as argument means use current buffer as BUFFER.")
720 register Lisp_Object buffer
;
722 register struct buffer
*buf
;
723 register Lisp_Object result
;
726 buf
= current_buffer
;
729 CHECK_BUFFER (buffer
, 0);
730 buf
= XBUFFER (buffer
);
736 register Lisp_Object tail
;
737 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
739 Lisp_Object val
, elt
;
741 elt
= XCONS (tail
)->car
;
743 /* Reference each variable in the alist in buf.
744 If inquiring about the current buffer, this gets the current values,
745 so store them into the alist so the alist is up to date.
746 If inquiring about some other buffer, this swaps out any values
747 for that buffer, making the alist up to date automatically. */
748 val
= find_symbol_value (XCONS (elt
)->car
);
749 /* Use the current buffer value only if buf is the current buffer. */
750 if (buf
!= current_buffer
)
751 val
= XCONS (elt
)->cdr
;
753 /* If symbol is unbound, put just the symbol in the list. */
754 if (EQ (val
, Qunbound
))
755 result
= Fcons (XCONS (elt
)->car
, result
);
756 /* Otherwise, put (symbol . value) in the list. */
758 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
762 /* Add on all the variables stored in special slots. */
764 register int offset
, mask
;
766 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
767 offset
< sizeof (struct buffer
);
768 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
770 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
771 if (mask
== -1 || (buf
->local_var_flags
& mask
))
772 if (SYMBOLP (*(Lisp_Object
*)(offset
773 + (char *)&buffer_local_symbols
)))
774 result
= Fcons (Fcons (*((Lisp_Object
*)
775 (offset
+ (char *)&buffer_local_symbols
)),
776 *(Lisp_Object
*)(offset
+ (char *)buf
)),
785 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
787 "Return t if BUFFER was modified since its file was last read or saved.\n\
788 No argument or nil as argument means use current buffer as BUFFER.")
790 register Lisp_Object buffer
;
792 register struct buffer
*buf
;
794 buf
= current_buffer
;
797 CHECK_BUFFER (buffer
, 0);
798 buf
= XBUFFER (buffer
);
801 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
804 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
806 "Mark current buffer as modified or unmodified according to FLAG.\n\
807 A non-nil FLAG means mark the buffer modified.")
809 register Lisp_Object flag
;
811 register int already
;
812 register Lisp_Object fn
;
814 #ifdef CLASH_DETECTION
815 /* If buffer becoming modified, lock the file.
816 If buffer becoming unmodified, unlock the file. */
818 fn
= current_buffer
->file_truename
;
819 /* Test buffer-file-name so that binding it to nil is effective. */
820 if (!NILP (fn
) && ! NILP (current_buffer
->filename
))
822 already
= SAVE_MODIFF
< MODIFF
;
823 if (!already
&& !NILP (flag
))
825 else if (already
&& NILP (flag
))
828 #endif /* CLASH_DETECTION */
830 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
835 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
837 "Return BUFFER's tick counter, incremented for each change in text.\n\
838 Each buffer has a tick counter which is incremented each time the text in\n\
839 that buffer is changed. It wraps around occasionally.\n\
840 No argument or nil as argument means use current buffer as BUFFER.")
842 register Lisp_Object buffer
;
844 register struct buffer
*buf
;
846 buf
= current_buffer
;
849 CHECK_BUFFER (buffer
, 0);
850 buf
= XBUFFER (buffer
);
853 return make_number (BUF_MODIFF (buf
));
856 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
857 "sRename buffer (to new name): \nP",
858 "Change current buffer's name to NEWNAME (a string).\n\
859 If second arg UNIQUE is nil or omitted, it is an error if a\n\
860 buffer named NEWNAME already exists.\n\
861 If UNIQUE is non-nil, come up with a new name using\n\
862 `generate-new-buffer-name'.\n\
863 Interactively, you can set UNIQUE with a prefix argument.\n\
864 We return the name we actually gave the buffer.\n\
865 This does not change the name of the visited file (if any).")
867 register Lisp_Object newname
, unique
;
869 register Lisp_Object tem
, buf
;
871 CHECK_STRING (newname
, 0);
873 if (XSTRING (newname
)->size
== 0)
874 error ("Empty string is invalid as a buffer name");
876 tem
= Fget_buffer (newname
);
877 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
878 the buffer automatically so you can create another with the original name.
879 It makes UNIQUE equivalent to
880 (rename-buffer (generate-new-buffer-name NEWNAME)). */
881 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
882 return current_buffer
->name
;
886 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
888 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
891 current_buffer
->name
= newname
;
893 /* Catch redisplay's attention. Unless we do this, the mode lines for
894 any windows displaying current_buffer will stay unchanged. */
897 XSETBUFFER (buf
, current_buffer
);
898 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
899 if (NILP (current_buffer
->filename
)
900 && !NILP (current_buffer
->auto_save_file_name
))
901 call0 (intern ("rename-auto-save-file"));
902 /* Refetch since that last call may have done GC. */
903 return current_buffer
->name
;
906 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 3, 0,
907 "Return most recently selected buffer other than BUFFER.\n\
908 Buffers not visible in windows are preferred to visible buffers,\n\
909 unless optional second argument VISIBLE-OK is non-nil.\n\
910 If the optional third argument FRAME is non-nil, use that frame's\n\
911 buffer list instead of the selected frame's buffer list.\n\
912 If no other buffer exists, the buffer `*scratch*' is returned.\n\
913 If BUFFER is omitted or nil, some interesting buffer is returned.")
914 (buffer
, visible_ok
, frame
)
915 register Lisp_Object buffer
, visible_ok
, frame
;
917 Lisp_Object
Fset_buffer_major_mode ();
918 register Lisp_Object tail
, buf
, notsogood
, tem
, pred
, add_ons
;
922 frame
= Fselected_frame ();
924 tail
= Vbuffer_alist
;
925 pred
= frame_buffer_predicate (frame
);
927 /* Consider buffers that have been seen in the selected frame
928 before other buffers. */
930 tem
= frame_buffer_list (frame
);
934 if (BUFFERP (XCONS (tem
)->car
))
935 add_ons
= Fcons (Fcons (Qnil
, XCONS (tem
)->car
), add_ons
);
936 tem
= XCONS (tem
)->cdr
;
938 tail
= nconc2 (Fnreverse (add_ons
), tail
);
940 for (; !NILP (tail
); tail
= Fcdr (tail
))
942 buf
= Fcdr (Fcar (tail
));
943 if (EQ (buf
, buffer
))
945 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
947 /* If the selected frame has a buffer_predicate,
948 disregard buffers that don't fit the predicate. */
951 tem
= call1 (pred
, buf
);
956 if (NILP (visible_ok
))
957 tem
= Fget_buffer_window (buf
, Qt
);
962 if (NILP (notsogood
))
965 if (!NILP (notsogood
))
967 buf
= Fget_buffer_create (build_string ("*scratch*"));
968 Fset_buffer_major_mode (buf
);
972 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
974 "Make BUFFER stop keeping undo information.\n\
975 No argument or nil as argument means do this for the current buffer.")
977 register Lisp_Object buffer
;
979 Lisp_Object real_buffer
;
982 XSETBUFFER (real_buffer
, current_buffer
);
985 real_buffer
= Fget_buffer (buffer
);
986 if (NILP (real_buffer
))
990 XBUFFER (real_buffer
)->undo_list
= Qt
;
995 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
997 "Start keeping undo information for buffer BUFFER.\n\
998 No argument or nil as argument means do this for the current buffer.")
1000 register Lisp_Object buffer
;
1002 Lisp_Object real_buffer
;
1005 XSETBUFFER (real_buffer
, current_buffer
);
1008 real_buffer
= Fget_buffer (buffer
);
1009 if (NILP (real_buffer
))
1013 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
1014 XBUFFER (real_buffer
)->undo_list
= Qnil
;
1020 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
1021 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
1022 The buffer being killed will be current while the hook is running.\n\
1025 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
1026 "Kill the buffer BUFFER.\n\
1027 The argument may be a buffer or may be the name of a buffer.\n\
1028 An argument of nil means kill the current buffer.\n\n\
1029 Value is t if the buffer is actually killed, nil if user says no.\n\n\
1030 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
1031 if not void, is a list of functions to be called, with no arguments,\n\
1032 before the buffer is actually killed. The buffer to be killed is current\n\
1033 when the hook functions are called.\n\n\
1034 Any processes that have this buffer as the `process-buffer' are killed\n\
1040 register struct buffer
*b
;
1041 register Lisp_Object tem
;
1042 register struct Lisp_Marker
*m
;
1043 struct gcpro gcpro1
, gcpro2
;
1046 buf
= Fcurrent_buffer ();
1048 buf
= Fget_buffer (buffer
);
1054 /* Avoid trouble for buffer already dead. */
1058 /* Query if the buffer is still modified. */
1059 if (INTERACTIVE
&& !NILP (b
->filename
)
1060 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
1063 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
1064 XSTRING (b
->name
)->data
));
1070 /* Run hooks with the buffer to be killed the current buffer. */
1072 register Lisp_Object val
;
1073 int count
= specpdl_ptr
- specpdl
;
1076 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1077 set_buffer_internal (b
);
1079 /* First run the query functions; if any query is answered no,
1080 don't kill the buffer. */
1081 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
1083 tem
= call0 (Fcar (list
));
1085 return unbind_to (count
, Qnil
);
1088 /* Then run the hooks. */
1089 if (!NILP (Vrun_hooks
))
1090 call1 (Vrun_hooks
, Qkill_buffer_hook
);
1091 unbind_to (count
, Qnil
);
1094 /* We have no more questions to ask. Verify that it is valid
1095 to kill the buffer. This must be done after the questions
1096 since anything can happen within do_yes_or_no_p. */
1098 /* Don't kill the minibuffer now current. */
1099 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
1105 /* When we kill a base buffer, kill all its indirect buffers.
1106 We do it at this stage so nothing terrible happens if they
1107 ask questions or their hooks get errors. */
1108 if (! b
->base_buffer
)
1110 struct buffer
*other
;
1114 for (other
= all_buffers
; other
; other
= other
->next
)
1115 /* all_buffers contains dead buffers too;
1116 don't re-kill them. */
1117 if (other
->base_buffer
== b
&& !NILP (other
->name
))
1120 XSETBUFFER (buf
, other
);
1127 /* Make this buffer not be current.
1128 In the process, notice if this is the sole visible buffer
1129 and give up if so. */
1130 if (b
== current_buffer
)
1132 tem
= Fother_buffer (buf
, Qnil
, Qnil
);
1134 if (b
== current_buffer
)
1138 /* Now there is no question: we can kill the buffer. */
1140 #ifdef CLASH_DETECTION
1141 /* Unlock this buffer's file, if it is locked. */
1143 #endif /* CLASH_DETECTION */
1145 kill_buffer_processes (buf
);
1147 tem
= Vinhibit_quit
;
1149 replace_buffer_in_all_windows (buf
);
1150 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1151 frames_discard_buffer (buf
);
1152 Vinhibit_quit
= tem
;
1154 /* Delete any auto-save file, if we saved it in this session. */
1155 if (STRINGP (b
->auto_save_file_name
)
1156 && b
->auto_save_modified
!= 0
1157 && BUF_SAVE_MODIFF (b
) < b
->auto_save_modified
)
1160 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1162 internal_delete_file (b
->auto_save_file_name
);
1167 /* Unchain all markers that belong to this indirect buffer.
1168 Don't unchain the markers that belong to the base buffer
1169 or its other indirect buffers. */
1170 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1176 unchain_marker (tem
);
1182 /* Unchain all markers of this buffer and its indirect buffers.
1183 and leave them pointing nowhere. */
1184 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1191 BUF_MARKERS (b
) = Qnil
;
1193 #ifdef USE_TEXT_PROPERTIES
1194 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1197 /* Perhaps we should explicitly free the interval tree here... */
1200 /* Reset the local variables, so that this buffer's local values
1201 won't be protected from GC. They would be protected
1202 if they happened to remain encached in their symbols.
1203 This gets rid of them for certain. */
1204 swap_out_buffer_local_variables (b
);
1205 reset_buffer_local_variables (b
, 1);
1210 if (! b
->base_buffer
)
1211 BUFFER_FREE (BUF_BEG_ADDR (b
));
1213 if (b
->newline_cache
)
1215 free_region_cache (b
->newline_cache
);
1216 b
->newline_cache
= 0;
1218 if (b
->width_run_cache
)
1220 free_region_cache (b
->width_run_cache
);
1221 b
->width_run_cache
= 0;
1223 b
->width_table
= Qnil
;
1224 #if !NO_PROMPT_IN_BUFFER
1225 b
->minibuffer_prompt_length
= Qnil
;
1228 b
->undo_list
= Qnil
;
1233 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1234 we do this each time BUF is selected visibly, the more recently
1235 selected buffers are always closer to the front of the list. This
1236 means that other_buffer is more likely to choose a relevant buffer. */
1242 register Lisp_Object link
, prev
;
1244 frame
= Fselected_frame ();
1247 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1249 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1254 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1255 we cannot use Fdelq itself here because it allows quitting. */
1258 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1260 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1262 XCONS (link
)->cdr
= Vbuffer_alist
;
1263 Vbuffer_alist
= link
;
1265 /* Now move this buffer to the front of frame_buffer_list also. */
1268 for (link
= frame_buffer_list (frame
); CONSP (link
);
1269 link
= XCONS (link
)->cdr
)
1271 if (EQ (XCONS (link
)->car
, buf
))
1276 /* Effectively do delq. */
1281 set_frame_buffer_list (frame
,
1282 XCONS (frame_buffer_list (frame
))->cdr
);
1284 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1286 XCONS (link
)->cdr
= frame_buffer_list (frame
);
1287 set_frame_buffer_list (frame
, link
);
1290 set_frame_buffer_list (frame
, Fcons (buf
, frame_buffer_list (frame
)));
1293 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1294 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1295 Use this function before selecting the buffer, since it may need to inspect\n\
1296 the current buffer's major mode.")
1301 Lisp_Object function
;
1303 function
= buffer_defaults
.major_mode
;
1304 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1305 function
= current_buffer
->major_mode
;
1307 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1310 count
= specpdl_ptr
- specpdl
;
1312 /* To select a nonfundamental mode,
1313 select the buffer temporarily and then call the mode function. */
1315 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1317 Fset_buffer (buffer
);
1320 return unbind_to (count
, Qnil
);
1323 /* If switching buffers in WINDOW would be an error, return
1324 a C string saying what the error would be. */
1327 no_switch_window (window
)
1331 if (EQ (minibuf_window
, window
))
1332 return "Cannot switch buffers in minibuffer window";
1333 tem
= Fwindow_dedicated_p (window
);
1335 return "Cannot switch buffers in a dedicated window";
1339 /* Switch to buffer BUFFER in the selected window.
1340 If NORECORD is non-nil, don't call record_buffer. */
1343 switch_to_buffer_1 (buffer
, norecord
)
1344 Lisp_Object buffer
, norecord
;
1346 register Lisp_Object buf
;
1349 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1352 buf
= Fget_buffer (buffer
);
1355 buf
= Fget_buffer_create (buffer
);
1356 Fset_buffer_major_mode (buf
);
1360 if (NILP (norecord
))
1361 record_buffer (buf
);
1363 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1364 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1371 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1372 "Select buffer BUFFER in the current window.\n\
1373 BUFFER may be a buffer or a buffer name.\n\
1374 Optional second arg NORECORD non-nil means\n\
1375 do not put this buffer at the front of the list of recently selected ones.\n\
1377 WARNING: This is NOT the way to work on another buffer temporarily\n\
1378 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1379 the window-buffer correspondences.")
1381 Lisp_Object buffer
, norecord
;
1385 err
= no_switch_window (selected_window
);
1386 if (err
) error (err
);
1388 return switch_to_buffer_1 (buffer
, norecord
);
1391 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 3, 0,
1392 "Select buffer BUFFER in some window, preferably a different one.\n\
1393 If BUFFER is nil, then some other buffer is chosen.\n\
1394 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1395 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1396 window even if BUFFER is already visible in the selected window.\n\
1397 This uses the function `display-buffer' as a subroutine; see the documentation\n\
1398 of `display-buffer' for additional customization information.\n\
1400 Optional third arg NORECORD non-nil means\n\
1401 do not put this buffer at the front of the list of recently selected ones.")
1402 (buffer
, other_window
, norecord
)
1403 Lisp_Object buffer
, other_window
, norecord
;
1405 register Lisp_Object buf
;
1407 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1410 buf
= Fget_buffer (buffer
);
1413 buf
= Fget_buffer_create (buffer
);
1414 Fset_buffer_major_mode (buf
);
1418 if (NILP (norecord
))
1419 record_buffer (buf
);
1420 Fselect_window (Fdisplay_buffer (buf
, other_window
, Qnil
));
1424 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1425 "Return the current buffer as a Lisp object.")
1428 register Lisp_Object buf
;
1429 XSETBUFFER (buf
, current_buffer
);
1433 /* Set the current buffer to B. */
1436 set_buffer_internal (b
)
1437 register struct buffer
*b
;
1439 register struct buffer
*old_buf
;
1440 register Lisp_Object tail
, valcontents
;
1443 if (current_buffer
== b
)
1446 /* Otherwise, force-mode-line-update doesn't work as expected. */
1447 windows_or_buffers_changed
= 1;
1448 set_buffer_internal_1 (b
);
1451 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1452 This is used by redisplay. */
1455 set_buffer_internal_1 (b
)
1456 register struct buffer
*b
;
1458 register struct buffer
*old_buf
;
1459 register Lisp_Object tail
, valcontents
;
1462 if (current_buffer
== b
)
1465 old_buf
= current_buffer
;
1467 last_known_column_point
= -1; /* invalidate indentation cache */
1471 /* Put the undo list back in the base buffer, so that it appears
1472 that an indirect buffer shares the undo list of its base. */
1473 if (old_buf
->base_buffer
)
1474 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1476 /* If the old current buffer has markers to record PT, BEGV and ZV
1477 when it is not current, update them now. */
1478 if (! NILP (old_buf
->pt_marker
))
1481 XSETBUFFER (obuf
, old_buf
);
1482 set_marker_both (old_buf
->pt_marker
, obuf
,
1483 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1485 if (! NILP (old_buf
->begv_marker
))
1488 XSETBUFFER (obuf
, old_buf
);
1489 set_marker_both (old_buf
->begv_marker
, obuf
,
1490 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1492 if (! NILP (old_buf
->zv_marker
))
1495 XSETBUFFER (obuf
, old_buf
);
1496 set_marker_both (old_buf
->zv_marker
, obuf
,
1497 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1501 /* Get the undo list from the base buffer, so that it appears
1502 that an indirect buffer shares the undo list of its base. */
1504 b
->undo_list
= b
->base_buffer
->undo_list
;
1506 /* If the new current buffer has markers to record PT, BEGV and ZV
1507 when it is not current, fetch them now. */
1508 if (! NILP (b
->pt_marker
))
1510 BUF_PT (b
) = marker_position (b
->pt_marker
);
1511 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1513 if (! NILP (b
->begv_marker
))
1515 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1516 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1518 if (! NILP (b
->zv_marker
))
1520 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1521 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1524 /* Look down buffer's list of local Lisp variables
1525 to find and update any that forward into C variables. */
1527 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1529 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1530 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1531 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1532 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1533 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1534 /* Just reference the variable
1535 to cause it to become set for this buffer. */
1536 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1539 /* Do the same with any others that were local to the previous buffer */
1542 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1544 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1545 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1546 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1547 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1548 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1549 /* Just reference the variable
1550 to cause it to become set for this buffer. */
1551 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1555 /* Switch to buffer B temporarily for redisplay purposes.
1556 This avoids certain things that don't need to be done within redisplay. */
1562 register struct buffer
*old_buf
;
1564 if (current_buffer
== b
)
1567 old_buf
= current_buffer
;
1572 /* If the old current buffer has markers to record PT, BEGV and ZV
1573 when it is not current, update them now. */
1574 if (! NILP (old_buf
->pt_marker
))
1577 XSETBUFFER (obuf
, old_buf
);
1578 set_marker_both (old_buf
->pt_marker
, obuf
,
1579 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1581 if (! NILP (old_buf
->begv_marker
))
1584 XSETBUFFER (obuf
, old_buf
);
1585 set_marker_both (old_buf
->begv_marker
, obuf
,
1586 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1588 if (! NILP (old_buf
->zv_marker
))
1591 XSETBUFFER (obuf
, old_buf
);
1592 set_marker_both (old_buf
->zv_marker
, obuf
,
1593 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1597 /* If the new current buffer has markers to record PT, BEGV and ZV
1598 when it is not current, fetch them now. */
1599 if (! NILP (b
->pt_marker
))
1601 BUF_PT (b
) = marker_position (b
->pt_marker
);
1602 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1604 if (! NILP (b
->begv_marker
))
1606 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1607 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1609 if (! NILP (b
->zv_marker
))
1611 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1612 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1616 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1617 "Make the buffer BUFFER current for editing operations.\n\
1618 BUFFER may be a buffer or the name of an existing buffer.\n\
1619 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1620 This function does not display the buffer, so its effect ends\n\
1621 when the current command terminates.\n\
1622 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1624 register Lisp_Object buffer
;
1626 register Lisp_Object buf
;
1627 buf
= Fget_buffer (buffer
);
1630 if (NILP (XBUFFER (buf
)->name
))
1631 error ("Selecting deleted buffer");
1632 set_buffer_internal (XBUFFER (buf
));
1636 /* Set the current buffer to BUFFER provided it is alive. */
1639 set_buffer_if_live (buffer
)
1642 if (! NILP (XBUFFER (buffer
)->name
))
1643 Fset_buffer (buffer
);
1647 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1648 Sbarf_if_buffer_read_only
, 0, 0, 0,
1649 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1652 if (!NILP (current_buffer
->read_only
)
1653 && NILP (Vinhibit_read_only
))
1654 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1658 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1659 "Put BUFFER at the end of the list of all buffers.\n\
1660 There it is the least likely candidate for `other-buffer' to return;\n\
1661 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1662 If BUFFER is nil or omitted, bury the current buffer.\n\
1663 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1664 selected window if it is displayed there.")
1666 register Lisp_Object buffer
;
1668 /* Figure out what buffer we're going to bury. */
1671 XSETBUFFER (buffer
, current_buffer
);
1673 /* If we're burying the current buffer, unshow it. */
1674 Fswitch_to_buffer (Fother_buffer (buffer
, Qnil
, Qnil
), Qnil
);
1680 buf1
= Fget_buffer (buffer
);
1686 /* Move buffer to the end of the buffer list. */
1688 register Lisp_Object aelt
, link
;
1690 aelt
= Frassq (buffer
, Vbuffer_alist
);
1691 link
= Fmemq (aelt
, Vbuffer_alist
);
1692 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1693 XCONS (link
)->cdr
= Qnil
;
1694 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1697 frames_bury_buffer (buffer
);
1702 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1703 "Delete the entire contents of the current buffer.\n\
1704 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1705 so the buffer is truly empty after this.")
1710 current_buffer
->last_window_start
= 1;
1711 /* Prevent warnings, or suspension of auto saving, that would happen
1712 if future size is less than past size. Use of erase-buffer
1713 implies that the future text is not really related to the past text. */
1714 XSETFASTINT (current_buffer
->save_length
, 0);
1719 validate_region (b
, e
)
1720 register Lisp_Object
*b
, *e
;
1722 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1723 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1725 if (XINT (*b
) > XINT (*e
))
1728 tem
= *b
; *b
= *e
; *e
= tem
;
1731 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1732 && XINT (*e
) <= ZV
))
1733 args_out_of_range (*b
, *e
);
1736 /* Advance BYTE_POS up to a character boundary
1737 and return the adjusted position. */
1740 advance_to_char_boundary (byte_pos
)
1745 if (byte_pos
== BEG
)
1746 /* Beginning of buffer is always a character boundary. */
1749 c
= FETCH_BYTE (byte_pos
);
1750 if (! CHAR_HEAD_P (c
))
1752 /* We should advance BYTE_POS only when C is a constituen of a
1753 multibyte sequence. */
1756 /* If C is a constituent of a multibyte sequence, BYTE_POS was
1757 surely advance to the correct character boundary. If C is
1758 not, BYTE_POS was unchanged. */
1764 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte
, Sset_buffer_multibyte
,
1766 "Set the multibyte flag of the current buffer to FLAG.\n\
1767 If FLAG is t, this makes the buffer a multibyte buffer.\n\
1768 If FLAG is nil, this makes the buffer a single-byte buffer.\n\
1769 The buffer contents remain unchanged as a sequence of bytes\n\
1770 but the contents viewed as characters do change.")
1774 Lisp_Object tail
, markers
;
1775 struct buffer
*other
;
1777 if (current_buffer
->base_buffer
)
1778 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
1780 /* Do nothing if nothing actually changes. */
1781 if (NILP (flag
) == NILP (current_buffer
->enable_multibyte_characters
))
1784 /* It would be better to update the list,
1785 but this is good enough for now. */
1786 if (! EQ (current_buffer
->undo_list
, Qt
))
1787 current_buffer
->undo_list
= Qnil
;
1789 /* If the cached position is for this buffer, clear it out. */
1790 clear_charpos_cache (current_buffer
);
1794 /* Do this first, so it can use CHAR_TO_BYTE
1795 to calculate the old correspondences. */
1796 set_intervals_multibyte (0);
1798 current_buffer
->enable_multibyte_characters
= Qnil
;
1804 TEMP_SET_PT_BOTH (PT_BYTE
, PT_BYTE
);
1806 tail
= BUF_MARKERS (current_buffer
);
1807 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1809 XMARKER (tail
)->charpos
= XMARKER (tail
)->bytepos
;
1810 tail
= XMARKER (tail
)->chain
;
1815 /* Be sure not to have a multibyte sequence striding over the GAP.
1816 Ex: We change this: "...abc\201\241\241 _GAP_ \241\241\241..."
1817 to: "...abc _GAP_ \201\241\241\241\241\241..." */
1819 if (GPT_BYTE
> 1 && GPT_BYTE
< Z_BYTE
1820 && ! CHAR_HEAD_P (*(GAP_END_ADDR
)))
1822 unsigned char *p
= GPT_ADDR
- 1;
1824 while (! CHAR_HEAD_P (*p
) && p
> BEG_ADDR
) p
--;
1825 if (BASE_LEADING_CODE_P (*p
))
1827 int new_gpt
= GPT_BYTE
- (GPT_ADDR
- p
);
1829 move_gap_both (new_gpt
, new_gpt
);
1833 /* Do this first, so that chars_in_text asks the right question.
1834 set_intervals_multibyte needs it too. */
1835 current_buffer
->enable_multibyte_characters
= Qt
;
1837 GPT_BYTE
= advance_to_char_boundary (GPT_BYTE
);
1838 GPT
= chars_in_text (BEG_ADDR
, GPT_BYTE
- BEG_BYTE
) + BEG
;
1840 Z
= chars_in_text (GAP_END_ADDR
, Z_BYTE
- GPT_BYTE
) + GPT
;
1842 BEGV_BYTE
= advance_to_char_boundary (BEGV_BYTE
);
1843 if (BEGV_BYTE
> GPT_BYTE
)
1844 BEGV
= chars_in_text (GAP_END_ADDR
, BEGV_BYTE
- GPT_BYTE
) + GPT
;
1846 BEGV
= chars_in_text (BEG_ADDR
, BEGV_BYTE
- BEG_BYTE
) + BEG
;
1848 ZV_BYTE
= advance_to_char_boundary (ZV_BYTE
);
1849 if (ZV_BYTE
> GPT_BYTE
)
1850 ZV
= chars_in_text (GAP_END_ADDR
, ZV_BYTE
- GPT_BYTE
) + GPT
;
1852 ZV
= chars_in_text (BEG_ADDR
, ZV_BYTE
- BEG_BYTE
) + BEG
;
1855 int pt_byte
= advance_to_char_boundary (PT_BYTE
);
1858 if (pt_byte
> GPT_BYTE
)
1859 pt
= chars_in_text (GAP_END_ADDR
, pt_byte
- GPT_BYTE
) + GPT
;
1861 pt
= chars_in_text (BEG_ADDR
, pt_byte
- BEG_BYTE
) + BEG
;
1862 TEMP_SET_PT_BOTH (pt
, pt_byte
);
1865 tail
= markers
= BUF_MARKERS (current_buffer
);
1867 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
1868 getting confused by the markers that have not yet been updated.
1869 It is also a signal that it should never create a marker. */
1870 BUF_MARKERS (current_buffer
) = Qnil
;
1872 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1874 XMARKER (tail
)->bytepos
1875 = advance_to_char_boundary (XMARKER (tail
)->bytepos
);
1876 XMARKER (tail
)->charpos
= BYTE_TO_CHAR (XMARKER (tail
)->bytepos
);
1878 tail
= XMARKER (tail
)->chain
;
1881 /* Make sure no markers were put on the chain
1882 while the chain value was incorrect. */
1883 if (! EQ (BUF_MARKERS (current_buffer
), Qnil
))
1886 BUF_MARKERS (current_buffer
) = markers
;
1888 /* Do this last, so it can calculate the new correspondences
1889 between chars and bytes. */
1890 set_intervals_multibyte (1);
1893 /* Copy this buffer's new multibyte status
1894 into all of its indirect buffers. */
1895 for (other
= all_buffers
; other
; other
= other
->next
)
1896 if (other
->base_buffer
== current_buffer
&& !NILP (other
->name
))
1897 other
->enable_multibyte_characters
1898 = current_buffer
->enable_multibyte_characters
;
1903 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1905 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1906 Most local variable bindings are eliminated so that the default values\n\
1907 become effective once more. Also, the syntax table is set from\n\
1908 `standard-syntax-table', the local keymap is set to nil,\n\
1909 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1910 This function also forces redisplay of the mode line.\n\
1912 Every function to select a new major mode starts by\n\
1913 calling this function.\n\n\
1914 As a special exception, local variables whose names have\n\
1915 a non-nil `permanent-local' property are not eliminated by this function.\n\
1917 The first thing this function does is run\n\
1918 the normal hook `change-major-mode-hook'.")
1921 register Lisp_Object alist
, sym
, tem
;
1924 if (!NILP (Vrun_hooks
))
1925 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1926 oalist
= current_buffer
->local_var_alist
;
1928 /* Make sure none of the bindings in oalist
1929 remain swapped in, in their symbols. */
1931 swap_out_buffer_local_variables (current_buffer
);
1933 /* Actually eliminate all local bindings of this buffer. */
1935 reset_buffer_local_variables (current_buffer
, 0);
1937 /* Redisplay mode lines; we are changing major mode. */
1939 update_mode_lines
++;
1941 /* Any which are supposed to be permanent,
1942 make local again, with the same values they had. */
1944 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1946 sym
= XCONS (XCONS (alist
)->car
)->car
;
1947 tem
= Fget (sym
, Qpermanent_local
);
1950 Fmake_local_variable (sym
);
1951 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1955 /* Force mode-line redisplay. Useful here because all major mode
1956 commands call this function. */
1957 update_mode_lines
++;
1962 /* Make sure no local variables remain set up with buffer B
1963 for their current values. */
1966 swap_out_buffer_local_variables (b
)
1969 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1971 XSETBUFFER (buffer
, b
);
1972 oalist
= b
->local_var_alist
;
1974 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1976 sym
= XCONS (XCONS (alist
)->car
)->car
;
1978 /* Need not do anything if some other buffer's binding is now encached. */
1979 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
;
1980 if (XBUFFER (tem
) == current_buffer
)
1982 /* Symbol is set up for this buffer's old local value.
1983 Set it up for the current buffer with the default value. */
1985 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
;
1986 /* Store the symbol's current value into the alist entry
1987 it is currently set up for. This is so that, if the
1988 local is marked permanent, and we make it local again
1989 later in Fkill_all_local_variables, we don't lose the value. */
1990 XCONS (XCONS (tem
)->car
)->cdr
1991 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
);
1992 /* Switch to the symbol's default-value alist entry. */
1993 XCONS (tem
)->car
= tem
;
1994 /* Mark it as current for buffer B. */
1995 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
= buffer
;
1996 /* Store the current value into any forwarding in the symbol. */
1997 store_symval_forwarding (sym
,
1998 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
,
2004 /* Find all the overlays in the current buffer that contain position POS.
2005 Return the number found, and store them in a vector in *VEC_PTR.
2006 Store in *LEN_PTR the size allocated for the vector.
2007 Store in *NEXT_PTR the next position after POS where an overlay starts,
2008 or ZV if there are no more overlays.
2009 Store in *PREV_PTR the previous position before POS where an overlay ends,
2010 or where an overlay starts which ends at or after POS;
2011 or BEGV if there are no such overlays.
2012 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2014 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2015 when this function is called.
2017 If EXTEND is non-zero, we make the vector bigger if necessary.
2018 If EXTEND is zero, we never extend the vector,
2019 and we store only as many overlays as will fit.
2020 But we still return the total number of overlays. */
2023 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2026 Lisp_Object
**vec_ptr
;
2031 Lisp_Object tail
, overlay
, start
, end
, result
;
2034 Lisp_Object
*vec
= *vec_ptr
;
2037 int inhibit_storing
= 0;
2039 for (tail
= current_buffer
->overlays_before
;
2041 tail
= XCONS (tail
)->cdr
)
2043 int startpos
, endpos
;
2045 overlay
= XCONS (tail
)->car
;
2047 start
= OVERLAY_START (overlay
);
2048 end
= OVERLAY_END (overlay
);
2049 endpos
= OVERLAY_POSITION (end
);
2056 startpos
= OVERLAY_POSITION (start
);
2057 /* This one ends at or after POS
2058 so its start counts for PREV_PTR if it's before POS. */
2059 if (prev
< startpos
&& startpos
< pos
)
2063 if (startpos
<= pos
)
2067 /* The supplied vector is full.
2068 Either make it bigger, or don't store any more in it. */
2071 /* Make it work with an initial len == 0. */
2076 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2080 inhibit_storing
= 1;
2083 if (!inhibit_storing
)
2085 /* Keep counting overlays even if we can't return them all. */
2088 else if (startpos
< next
)
2092 for (tail
= current_buffer
->overlays_after
;
2094 tail
= XCONS (tail
)->cdr
)
2096 int startpos
, endpos
;
2098 overlay
= XCONS (tail
)->car
;
2100 start
= OVERLAY_START (overlay
);
2101 end
= OVERLAY_END (overlay
);
2102 startpos
= OVERLAY_POSITION (start
);
2105 if (startpos
< next
)
2109 endpos
= OVERLAY_POSITION (end
);
2116 *len_ptr
= len
*= 2;
2119 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2123 inhibit_storing
= 1;
2126 if (!inhibit_storing
)
2130 if (startpos
< pos
&& startpos
> prev
)
2133 else if (endpos
< pos
&& endpos
> prev
)
2135 else if (endpos
== pos
&& startpos
> prev
)
2146 /* Find all the overlays in the current buffer that overlap the range BEG-END
2147 or are empty at BEG.
2149 Return the number found, and store them in a vector in *VEC_PTR.
2150 Store in *LEN_PTR the size allocated for the vector.
2151 Store in *NEXT_PTR the next position after POS where an overlay starts,
2152 or ZV if there are no more overlays.
2153 Store in *PREV_PTR the previous position before POS where an overlay ends,
2154 or BEGV if there are no previous overlays.
2155 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2157 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2158 when this function is called.
2160 If EXTEND is non-zero, we make the vector bigger if necessary.
2161 If EXTEND is zero, we never extend the vector,
2162 and we store only as many overlays as will fit.
2163 But we still return the total number of overlays. */
2166 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2169 Lisp_Object
**vec_ptr
;
2174 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
2177 Lisp_Object
*vec
= *vec_ptr
;
2180 int inhibit_storing
= 0;
2182 for (tail
= current_buffer
->overlays_before
;
2184 tail
= XCONS (tail
)->cdr
)
2186 int startpos
, endpos
;
2188 overlay
= XCONS (tail
)->car
;
2190 ostart
= OVERLAY_START (overlay
);
2191 oend
= OVERLAY_END (overlay
);
2192 endpos
= OVERLAY_POSITION (oend
);
2199 startpos
= OVERLAY_POSITION (ostart
);
2200 /* Count an interval if it either overlaps the range
2201 or is empty at the start of the range. */
2202 if ((beg
< endpos
&& startpos
< end
)
2203 || (startpos
== endpos
&& beg
== endpos
))
2207 /* The supplied vector is full.
2208 Either make it bigger, or don't store any more in it. */
2211 *len_ptr
= len
*= 2;
2212 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2216 inhibit_storing
= 1;
2219 if (!inhibit_storing
)
2221 /* Keep counting overlays even if we can't return them all. */
2224 else if (startpos
< next
)
2228 for (tail
= current_buffer
->overlays_after
;
2230 tail
= XCONS (tail
)->cdr
)
2232 int startpos
, endpos
;
2234 overlay
= XCONS (tail
)->car
;
2236 ostart
= OVERLAY_START (overlay
);
2237 oend
= OVERLAY_END (overlay
);
2238 startpos
= OVERLAY_POSITION (ostart
);
2241 if (startpos
< next
)
2245 endpos
= OVERLAY_POSITION (oend
);
2246 /* Count an interval if it either overlaps the range
2247 or is empty at the start of the range. */
2248 if ((beg
< endpos
&& startpos
< end
)
2249 || (startpos
== endpos
&& beg
== endpos
))
2255 *len_ptr
= len
*= 2;
2256 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2260 inhibit_storing
= 1;
2263 if (!inhibit_storing
)
2267 else if (endpos
< beg
&& endpos
> prev
)
2278 /* Fast function to just test if we're at an overlay boundary. */
2280 overlay_touches_p (pos
)
2283 Lisp_Object tail
, overlay
;
2285 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
2286 tail
= XCONS (tail
)->cdr
)
2290 overlay
= XCONS (tail
)->car
;
2291 if (!GC_OVERLAYP (overlay
))
2294 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2297 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
2301 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
2302 tail
= XCONS (tail
)->cdr
)
2306 overlay
= XCONS (tail
)->car
;
2307 if (!GC_OVERLAYP (overlay
))
2310 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2313 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
2321 Lisp_Object overlay
;
2327 compare_overlays (v1
, v2
)
2328 const void *v1
, *v2
;
2330 const struct sortvec
*s1
= (const struct sortvec
*) v1
;
2331 const struct sortvec
*s2
= (const struct sortvec
*) v2
;
2332 if (s1
->priority
!= s2
->priority
)
2333 return s1
->priority
- s2
->priority
;
2334 if (s1
->beg
!= s2
->beg
)
2335 return s1
->beg
- s2
->beg
;
2336 if (s1
->end
!= s2
->end
)
2337 return s2
->end
- s1
->end
;
2341 /* Sort an array of overlays by priority. The array is modified in place.
2342 The return value is the new size; this may be smaller than the original
2343 size if some of the overlays were invalid or were window-specific. */
2345 sort_overlays (overlay_vec
, noverlays
, w
)
2346 Lisp_Object
*overlay_vec
;
2351 struct sortvec
*sortvec
;
2352 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
2354 /* Put the valid and relevant overlays into sortvec. */
2356 for (i
= 0, j
= 0; i
< noverlays
; i
++)
2359 Lisp_Object overlay
;
2361 overlay
= overlay_vec
[i
];
2362 if (OVERLAY_VALID (overlay
)
2363 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
2364 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
2366 /* If we're interested in a specific window, then ignore
2367 overlays that are limited to some other window. */
2372 window
= Foverlay_get (overlay
, Qwindow
);
2373 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2377 /* This overlay is good and counts: put it into sortvec. */
2378 sortvec
[j
].overlay
= overlay
;
2379 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2380 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2381 tem
= Foverlay_get (overlay
, Qpriority
);
2383 sortvec
[j
].priority
= XINT (tem
);
2385 sortvec
[j
].priority
= 0;
2391 /* Sort the overlays into the proper order: increasing priority. */
2394 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
2396 for (i
= 0; i
< noverlays
; i
++)
2397 overlay_vec
[i
] = sortvec
[i
].overlay
;
2403 Lisp_Object string
, string2
;
2410 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
2411 int size
; /* Allocated length of that array. */
2412 int used
; /* How much of the array is currently in use. */
2413 int bytes
; /* Total length of the strings in buf. */
2416 /* Buffers for storing information about the overlays touching a given
2417 position. These could be automatic variables in overlay_strings, but
2418 it's more efficient to hold onto the memory instead of repeatedly
2419 allocating and freeing it. */
2420 static struct sortstrlist overlay_heads
, overlay_tails
;
2421 static unsigned char *overlay_str_buf
;
2423 /* Allocated length of overlay_str_buf. */
2424 static int overlay_str_len
;
2426 /* A comparison function suitable for passing to qsort. */
2428 cmp_for_strings (as1
, as2
)
2431 struct sortstr
*s1
= (struct sortstr
*)as1
;
2432 struct sortstr
*s2
= (struct sortstr
*)as2
;
2433 if (s1
->size
!= s2
->size
)
2434 return s2
->size
- s1
->size
;
2435 if (s1
->priority
!= s2
->priority
)
2436 return s1
->priority
- s2
->priority
;
2441 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2442 struct sortstrlist
*ssl
;
2443 Lisp_Object str
, str2
, pri
;
2448 if (ssl
->used
== ssl
->size
)
2454 ssl
->buf
= ((struct sortstr
*)
2455 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2457 ssl
->buf
[ssl
->used
].string
= str
;
2458 ssl
->buf
[ssl
->used
].string2
= str2
;
2459 ssl
->buf
[ssl
->used
].size
= size
;
2460 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2463 if (NILP (current_buffer
->enable_multibyte_characters
))
2464 nbytes
= XSTRING (str
)->size
;
2465 else if (! STRING_MULTIBYTE (str
))
2466 nbytes
= count_size_as_multibyte (XSTRING (str
)->data
,
2467 STRING_BYTES (XSTRING (str
)));
2469 nbytes
= STRING_BYTES (XSTRING (str
));
2471 ssl
->bytes
+= nbytes
;
2475 if (NILP (current_buffer
->enable_multibyte_characters
))
2476 nbytes
= XSTRING (str2
)->size
;
2477 else if (! STRING_MULTIBYTE (str2
))
2478 nbytes
= count_size_as_multibyte (XSTRING (str2
)->data
,
2479 STRING_BYTES (XSTRING (str2
)));
2481 nbytes
= STRING_BYTES (XSTRING (str2
));
2483 ssl
->bytes
+= nbytes
;
2487 /* Return the concatenation of the strings associated with overlays that
2488 begin or end at POS, ignoring overlays that are specific to a window
2489 other than W. The strings are concatenated in the appropriate order:
2490 shorter overlays nest inside longer ones, and higher priority inside
2491 lower. Normally all of the after-strings come first, but zero-sized
2492 overlays have their after-strings ride along with the before-strings
2493 because it would look strange to print them inside-out.
2495 Returns the string length, and stores the contents indirectly through
2496 PSTR, if that variable is non-null. The string may be overwritten by
2497 subsequent calls. */
2500 overlay_strings (pos
, w
, pstr
)
2503 unsigned char **pstr
;
2505 Lisp_Object ov
, overlay
, window
, str
;
2506 int startpos
, endpos
;
2507 int multibyte
= ! NILP (current_buffer
->enable_multibyte_characters
);
2509 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2510 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2511 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2513 overlay
= XCONS (ov
)->car
;
2514 if (!OVERLAYP (overlay
))
2517 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2518 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2521 if (endpos
!= pos
&& startpos
!= pos
)
2523 window
= Foverlay_get (overlay
, Qwindow
);
2524 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2527 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2528 record_overlay_string (&overlay_heads
, str
,
2530 ? Foverlay_get (overlay
, Qafter_string
)
2532 Foverlay_get (overlay
, Qpriority
),
2534 else if (endpos
== pos
2535 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2536 record_overlay_string (&overlay_tails
, str
, Qnil
,
2537 Foverlay_get (overlay
, Qpriority
),
2540 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2542 overlay
= XCONS (ov
)->car
;
2543 if (!OVERLAYP (overlay
))
2546 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2547 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2550 if (endpos
!= pos
&& startpos
!= pos
)
2552 window
= Foverlay_get (overlay
, Qwindow
);
2553 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2556 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2557 record_overlay_string (&overlay_heads
, str
,
2559 ? Foverlay_get (overlay
, Qafter_string
)
2561 Foverlay_get (overlay
, Qpriority
),
2563 else if (endpos
== pos
2564 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2565 record_overlay_string (&overlay_tails
, str
, Qnil
,
2566 Foverlay_get (overlay
, Qpriority
),
2569 if (overlay_tails
.used
> 1)
2570 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2572 if (overlay_heads
.used
> 1)
2573 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2575 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2580 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2582 if (total
> overlay_str_len
)
2584 overlay_str_len
= total
;
2585 overlay_str_buf
= (unsigned char *)xrealloc (overlay_str_buf
,
2588 p
= overlay_str_buf
;
2589 for (i
= overlay_tails
.used
; --i
>= 0;)
2592 tem
= overlay_tails
.buf
[i
].string
;
2593 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2594 STRING_BYTES (XSTRING (tem
)),
2595 STRING_MULTIBYTE (tem
), multibyte
);
2598 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2601 tem
= overlay_heads
.buf
[i
].string
;
2602 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2603 STRING_BYTES (XSTRING (tem
)),
2604 STRING_MULTIBYTE (tem
), multibyte
);
2606 tem
= overlay_heads
.buf
[i
].string2
;
2609 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2610 STRING_BYTES (XSTRING (tem
)),
2611 STRING_MULTIBYTE (tem
), multibyte
);
2615 if (p
!= overlay_str_buf
+ total
)
2618 *pstr
= overlay_str_buf
;
2624 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2627 recenter_overlay_lists (buf
, pos
)
2631 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2633 /* See if anything in overlays_before should move to overlays_after. */
2635 /* We don't strictly need prev in this loop; it should always be nil.
2636 But we use it for symmetry and in case that should cease to be true
2637 with some future change. */
2639 for (tail
= buf
->overlays_before
;
2641 prev
= tail
, tail
= next
)
2643 next
= XCONS (tail
)->cdr
;
2644 overlay
= XCONS (tail
)->car
;
2646 /* If the overlay is not valid, get rid of it. */
2647 if (!OVERLAY_VALID (overlay
))
2652 /* Splice the cons cell TAIL out of overlays_before. */
2654 XCONS (prev
)->cdr
= next
;
2656 buf
->overlays_before
= next
;
2662 beg
= OVERLAY_START (overlay
);
2663 end
= OVERLAY_END (overlay
);
2665 if (OVERLAY_POSITION (end
) > pos
)
2667 /* OVERLAY needs to be moved. */
2668 int where
= OVERLAY_POSITION (beg
);
2669 Lisp_Object other
, other_prev
;
2671 /* Splice the cons cell TAIL out of overlays_before. */
2673 XCONS (prev
)->cdr
= next
;
2675 buf
->overlays_before
= next
;
2677 /* Search thru overlays_after for where to put it. */
2679 for (other
= buf
->overlays_after
;
2681 other_prev
= other
, other
= XCONS (other
)->cdr
)
2683 Lisp_Object otherbeg
, otheroverlay
, follower
;
2686 otheroverlay
= XCONS (other
)->car
;
2687 if (! OVERLAY_VALID (otheroverlay
))
2690 otherbeg
= OVERLAY_START (otheroverlay
);
2691 if (OVERLAY_POSITION (otherbeg
) >= where
)
2695 /* Add TAIL to overlays_after before OTHER. */
2696 XCONS (tail
)->cdr
= other
;
2697 if (!NILP (other_prev
))
2698 XCONS (other_prev
)->cdr
= tail
;
2700 buf
->overlays_after
= tail
;
2704 /* We've reached the things that should stay in overlays_before.
2705 All the rest of overlays_before must end even earlier,
2710 /* See if anything in overlays_after should be in overlays_before. */
2712 for (tail
= buf
->overlays_after
;
2714 prev
= tail
, tail
= next
)
2716 next
= XCONS (tail
)->cdr
;
2717 overlay
= XCONS (tail
)->car
;
2719 /* If the overlay is not valid, get rid of it. */
2720 if (!OVERLAY_VALID (overlay
))
2725 /* Splice the cons cell TAIL out of overlays_after. */
2727 XCONS (prev
)->cdr
= next
;
2729 buf
->overlays_after
= next
;
2735 beg
= OVERLAY_START (overlay
);
2736 end
= OVERLAY_END (overlay
);
2738 /* Stop looking, when we know that nothing further
2739 can possibly end before POS. */
2740 if (OVERLAY_POSITION (beg
) > pos
)
2743 if (OVERLAY_POSITION (end
) <= pos
)
2745 /* OVERLAY needs to be moved. */
2746 int where
= OVERLAY_POSITION (end
);
2747 Lisp_Object other
, other_prev
;
2749 /* Splice the cons cell TAIL out of overlays_after. */
2751 XCONS (prev
)->cdr
= next
;
2753 buf
->overlays_after
= next
;
2755 /* Search thru overlays_before for where to put it. */
2757 for (other
= buf
->overlays_before
;
2759 other_prev
= other
, other
= XCONS (other
)->cdr
)
2761 Lisp_Object otherend
, otheroverlay
;
2764 otheroverlay
= XCONS (other
)->car
;
2765 if (! OVERLAY_VALID (otheroverlay
))
2768 otherend
= OVERLAY_END (otheroverlay
);
2769 if (OVERLAY_POSITION (otherend
) <= where
)
2773 /* Add TAIL to overlays_before before OTHER. */
2774 XCONS (tail
)->cdr
= other
;
2775 if (!NILP (other_prev
))
2776 XCONS (other_prev
)->cdr
= tail
;
2778 buf
->overlays_before
= tail
;
2783 XSETFASTINT (buf
->overlay_center
, pos
);
2787 adjust_overlays_for_insert (pos
, length
)
2791 /* After an insertion, the lists are still sorted properly,
2792 but we may need to update the value of the overlay center. */
2793 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2794 XSETFASTINT (current_buffer
->overlay_center
,
2795 XFASTINT (current_buffer
->overlay_center
) + length
);
2799 adjust_overlays_for_delete (pos
, length
)
2803 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2804 /* The deletion was to our right. No change needed; the before- and
2805 after-lists are still consistent. */
2807 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2808 /* The deletion was to our left. We need to adjust the center value
2809 to account for the change in position, but the lists are consistent
2810 given the new value. */
2811 XSETFASTINT (current_buffer
->overlay_center
,
2812 XFASTINT (current_buffer
->overlay_center
) - length
);
2814 /* We're right in the middle. There might be things on the after-list
2815 that now belong on the before-list. Recentering will move them,
2816 and also update the center point. */
2817 recenter_overlay_lists (current_buffer
, pos
);
2820 /* Fix up overlays that were garbled as a result of permuting markers
2821 in the range START through END. Any overlay with at least one
2822 endpoint in this range will need to be unlinked from the overlay
2823 list and reinserted in its proper place.
2824 Such an overlay might even have negative size at this point.
2825 If so, we'll reverse the endpoints. Can you think of anything
2826 better to do in this situation? */
2828 fix_overlays_in_range (start
, end
)
2829 register int start
, end
;
2831 Lisp_Object tem
, overlay
;
2832 Lisp_Object before_list
, after_list
;
2833 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2834 int startpos
, endpos
;
2836 /* This algorithm shifts links around instead of consing and GCing.
2837 The loop invariant is that before_list (resp. after_list) is a
2838 well-formed list except that its last element, the one that
2839 *pbefore (resp. *pafter) points to, is still uninitialized.
2840 So it's not a bug that before_list isn't initialized, although
2841 it may look strange. */
2842 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2844 overlay
= XCONS (*ptail
)->car
;
2845 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2848 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2850 || (startpos
>= start
&& startpos
< end
))
2852 /* If the overlay is backwards, fix that now. */
2853 if (startpos
> endpos
)
2856 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2858 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2860 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2862 /* Add it to the end of the wrong list. Later on,
2863 recenter_overlay_lists will move it to the right place. */
2864 if (endpos
< XINT (current_buffer
->overlay_center
))
2867 pafter
= &XCONS (*ptail
)->cdr
;
2872 pbefore
= &XCONS (*ptail
)->cdr
;
2874 *ptail
= XCONS (*ptail
)->cdr
;
2877 ptail
= &XCONS (*ptail
)->cdr
;
2879 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2881 overlay
= XCONS (*ptail
)->car
;
2882 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2883 if (startpos
>= end
)
2885 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2886 if (startpos
>= start
2887 || (endpos
>= start
&& endpos
< end
))
2889 if (startpos
> endpos
)
2892 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2894 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2896 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2898 if (endpos
< XINT (current_buffer
->overlay_center
))
2901 pafter
= &XCONS (*ptail
)->cdr
;
2906 pbefore
= &XCONS (*ptail
)->cdr
;
2908 *ptail
= XCONS (*ptail
)->cdr
;
2911 ptail
= &XCONS (*ptail
)->cdr
;
2914 /* Splice the constructed (wrong) lists into the buffer's lists,
2915 and let the recenter function make it sane again. */
2916 *pbefore
= current_buffer
->overlays_before
;
2917 current_buffer
->overlays_before
= before_list
;
2918 recenter_overlay_lists (current_buffer
,
2919 XINT (current_buffer
->overlay_center
));
2921 *pafter
= current_buffer
->overlays_after
;
2922 current_buffer
->overlays_after
= after_list
;
2923 recenter_overlay_lists (current_buffer
,
2924 XINT (current_buffer
->overlay_center
));
2927 /* We have two types of overlay: the one whose ending marker is
2928 after-insertion-marker (this is the usual case) and the one whose
2929 ending marker is before-insertion-marker. When `overlays_before'
2930 contains overlays of the latter type and the former type in this
2931 order and both overlays end at inserting position, inserting a text
2932 increases only the ending marker of the latter type, which results
2933 in incorrect ordering of `overlays_before'.
2935 This function fixes ordering of overlays in the slot
2936 `overlays_before' of the buffer *BP. Before the insertion, `point'
2937 was at PREV, and now is at POS. */
2940 fix_overlays_before (bp
, prev
, pos
)
2944 Lisp_Object
*tailp
= &bp
->overlays_before
;
2945 Lisp_Object
*right_place
;
2948 /* After the insertion, the several overlays may be in incorrect
2949 order. The possibility is that, in the list `overlays_before',
2950 an overlay which ends at POS appears after an overlay which ends
2951 at PREV. Since POS is greater than PREV, we must fix the
2952 ordering of these overlays, by moving overlays ends at POS before
2953 the overlays ends at PREV. */
2955 /* At first, find a place where disordered overlays should be linked
2956 in. It is where an overlay which end before POS exists. (i.e. an
2957 overlay whose ending marker is after-insertion-marker if disorder
2959 while (!NILP (*tailp
)
2960 && ((end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
)))
2962 tailp
= &XCONS (*tailp
)->cdr
;
2964 /* If we don't find such an overlay,
2965 or the found one ends before PREV,
2966 or the found one is the last one in the list,
2967 we don't have to fix anything. */
2970 || NILP (XCONS (*tailp
)->cdr
))
2973 right_place
= tailp
;
2974 tailp
= &XCONS (*tailp
)->cdr
;
2976 /* Now, end position of overlays in the list *TAILP should be before
2977 or equal to PREV. In the loop, an overlay which ends at POS is
2978 moved ahead to the place pointed by RIGHT_PLACE. If we found an
2979 overlay which ends before PREV, the remaining overlays are in
2981 while (!NILP (*tailp
))
2983 end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
));
2986 { /* This overlay is disordered. */
2987 Lisp_Object found
= *tailp
;
2989 /* Unlink the found overlay. */
2990 *tailp
= XCONS (found
)->cdr
;
2991 /* Move an overlay at RIGHT_PLACE to the next of the found one. */
2992 XCONS (found
)->cdr
= *right_place
;
2993 /* Link it into the right place. */
2994 *right_place
= found
;
2996 else if (end
== prev
)
2997 tailp
= &XCONS (*tailp
)->cdr
;
2998 else /* No more disordered overlay. */
3003 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
3004 "Return t if OBJECT is an overlay.")
3008 return (OVERLAYP (object
) ? Qt
: Qnil
);
3011 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 5, 0,
3012 "Create a new overlay with range BEG to END in BUFFER.\n\
3013 If omitted, BUFFER defaults to the current buffer.\n\
3014 BEG and END may be integers or markers.\n\
3015 The fourth arg FRONT-ADVANCE, if non-nil, makes the\n\
3016 front delimiter advance when text is inserted there.\n\
3017 The fifth arg REAR-ADVANCE, if non-nil, makes the\n\
3018 rear delimiter advance when text is inserted there.")
3019 (beg
, end
, buffer
, front_advance
, rear_advance
)
3020 Lisp_Object beg
, end
, buffer
;
3021 Lisp_Object front_advance
, rear_advance
;
3023 Lisp_Object overlay
;
3027 XSETBUFFER (buffer
, current_buffer
);
3029 CHECK_BUFFER (buffer
, 2);
3031 && ! EQ (Fmarker_buffer (beg
), buffer
))
3032 error ("Marker points into wrong buffer");
3034 && ! EQ (Fmarker_buffer (end
), buffer
))
3035 error ("Marker points into wrong buffer");
3037 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3038 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3040 if (XINT (beg
) > XINT (end
))
3043 temp
= beg
; beg
= end
; end
= temp
;
3046 b
= XBUFFER (buffer
);
3048 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
3049 end
= Fset_marker (Fmake_marker (), end
, buffer
);
3051 if (!NILP (front_advance
))
3052 XMARKER (beg
)->insertion_type
= 1;
3053 if (!NILP (rear_advance
))
3054 XMARKER (end
)->insertion_type
= 1;
3056 overlay
= allocate_misc ();
3057 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
3058 XOVERLAY (overlay
)->start
= beg
;
3059 XOVERLAY (overlay
)->end
= end
;
3060 XOVERLAY (overlay
)->plist
= Qnil
;
3062 /* Put the new overlay on the wrong list. */
3063 end
= OVERLAY_END (overlay
);
3064 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3065 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3067 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3069 /* This puts it in the right list, and in the right order. */
3070 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3072 /* We don't need to redisplay the region covered by the overlay, because
3073 the overlay has no properties at the moment. */
3078 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3081 modify_overlay (buf
, start
, end
)
3091 start
= end
; end
= temp
;
3094 /* If this is a buffer not in the selected window,
3095 we must do other windows. */
3096 if (buf
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
3097 windows_or_buffers_changed
= 1;
3098 /* If it's not current, we can't use beg_unchanged, end_unchanged for it. */
3099 else if (buf
!= current_buffer
)
3100 windows_or_buffers_changed
= 1;
3101 /* If multiple windows show this buffer, we must do other windows. */
3102 else if (buffer_shared
> 1)
3103 windows_or_buffers_changed
= 1;
3106 if (unchanged_modified
== MODIFF
3107 && overlay_unchanged_modified
== OVERLAY_MODIFF
)
3109 beg_unchanged
= start
- BEG
;
3110 end_unchanged
= Z
- end
;
3114 if (Z
- end
< end_unchanged
)
3115 end_unchanged
= Z
- end
;
3116 if (start
- BEG
< beg_unchanged
)
3117 beg_unchanged
= start
- BEG
;
3121 ++BUF_OVERLAY_MODIFF (buf
);
3125 Lisp_Object
Fdelete_overlay ();
3127 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
3128 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
3129 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
3130 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
3132 (overlay
, beg
, end
, buffer
)
3133 Lisp_Object overlay
, beg
, end
, buffer
;
3135 struct buffer
*b
, *ob
;
3136 Lisp_Object obuffer
;
3137 int count
= specpdl_ptr
- specpdl
;
3139 CHECK_OVERLAY (overlay
, 0);
3141 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3143 XSETBUFFER (buffer
, current_buffer
);
3144 CHECK_BUFFER (buffer
, 3);
3147 && ! EQ (Fmarker_buffer (beg
), buffer
))
3148 error ("Marker points into wrong buffer");
3150 && ! EQ (Fmarker_buffer (end
), buffer
))
3151 error ("Marker points into wrong buffer");
3153 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3154 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3156 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3157 return Fdelete_overlay (overlay
);
3159 if (XINT (beg
) > XINT (end
))
3162 temp
= beg
; beg
= end
; end
= temp
;
3165 specbind (Qinhibit_quit
, Qt
);
3167 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3168 b
= XBUFFER (buffer
);
3169 ob
= XBUFFER (obuffer
);
3171 /* If the overlay has changed buffers, do a thorough redisplay. */
3172 if (!EQ (buffer
, obuffer
))
3174 /* Redisplay where the overlay was. */
3175 if (!NILP (obuffer
))
3180 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3181 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3183 modify_overlay (ob
, o_beg
, o_end
);
3186 /* Redisplay where the overlay is going to be. */
3187 modify_overlay (b
, XINT (beg
), XINT (end
));
3190 /* Redisplay the area the overlay has just left, or just enclosed. */
3193 int change_beg
, change_end
;
3195 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3196 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3198 if (o_beg
== XINT (beg
))
3199 modify_overlay (b
, o_end
, XINT (end
));
3200 else if (o_end
== XINT (end
))
3201 modify_overlay (b
, o_beg
, XINT (beg
));
3204 if (XINT (beg
) < o_beg
) o_beg
= XINT (beg
);
3205 if (XINT (end
) > o_end
) o_end
= XINT (end
);
3206 modify_overlay (b
, o_beg
, o_end
);
3210 if (!NILP (obuffer
))
3212 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
3213 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
3216 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
3217 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
3219 /* Put the overlay on the wrong list. */
3220 end
= OVERLAY_END (overlay
);
3221 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3222 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3224 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3226 /* This puts it in the right list, and in the right order. */
3227 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3229 return unbind_to (count
, overlay
);
3232 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
3233 "Delete the overlay OVERLAY from its buffer.")
3235 Lisp_Object overlay
;
3239 int count
= specpdl_ptr
- specpdl
;
3241 CHECK_OVERLAY (overlay
, 0);
3243 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3247 b
= XBUFFER (buffer
);
3249 specbind (Qinhibit_quit
, Qt
);
3251 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
3252 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
3255 marker_position (OVERLAY_START (overlay
)),
3256 marker_position (OVERLAY_END (overlay
)));
3258 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
3259 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
3261 return unbind_to (count
, Qnil
);
3264 /* Overlay dissection functions. */
3266 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
3267 "Return the position at which OVERLAY starts.")
3269 Lisp_Object overlay
;
3271 CHECK_OVERLAY (overlay
, 0);
3273 return (Fmarker_position (OVERLAY_START (overlay
)));
3276 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
3277 "Return the position at which OVERLAY ends.")
3279 Lisp_Object overlay
;
3281 CHECK_OVERLAY (overlay
, 0);
3283 return (Fmarker_position (OVERLAY_END (overlay
)));
3286 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
3287 "Return the buffer OVERLAY belongs to.")
3289 Lisp_Object overlay
;
3291 CHECK_OVERLAY (overlay
, 0);
3293 return Fmarker_buffer (OVERLAY_START (overlay
));
3296 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
3297 "Return a list of the properties on OVERLAY.\n\
3298 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
3301 Lisp_Object overlay
;
3303 CHECK_OVERLAY (overlay
, 0);
3305 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
3309 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
3310 "Return a list of the overlays that contain position POS.")
3315 Lisp_Object
*overlay_vec
;
3319 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3322 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3324 /* Put all the overlays we want in a vector in overlay_vec.
3325 Store the length in len. */
3326 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3327 (int *) 0, (int *) 0);
3329 /* Make a list of them all. */
3330 result
= Flist (noverlays
, overlay_vec
);
3332 xfree (overlay_vec
);
3336 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
3337 "Return a list of the overlays that overlap the region BEG ... END.\n\
3338 Overlap means that at least one character is contained within the overlay\n\
3339 and also contained within the specified region.\n\
3340 Empty overlays are included in the result if they are located at BEG\n\
3341 or between BEG and END.")
3343 Lisp_Object beg
, end
;
3346 Lisp_Object
*overlay_vec
;
3350 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
3351 CHECK_NUMBER_COERCE_MARKER (end
, 0);
3354 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3356 /* Put all the overlays we want in a vector in overlay_vec.
3357 Store the length in len. */
3358 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
3359 (int *) 0, (int *) 0);
3361 /* Make a list of them all. */
3362 result
= Flist (noverlays
, overlay_vec
);
3364 xfree (overlay_vec
);
3368 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
3370 "Return the next position after POS where an overlay starts or ends.\n\
3371 If there are no more overlay boundaries after POS, return (point-max).")
3377 Lisp_Object
*overlay_vec
;
3381 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3384 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3386 /* Put all the overlays we want in a vector in overlay_vec.
3387 Store the length in len.
3388 endpos gets the position where the next overlay starts. */
3389 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3390 &endpos
, (int *) 0);
3392 /* If any of these overlays ends before endpos,
3393 use its ending point instead. */
3394 for (i
= 0; i
< noverlays
; i
++)
3399 oend
= OVERLAY_END (overlay_vec
[i
]);
3400 oendpos
= OVERLAY_POSITION (oend
);
3401 if (oendpos
< endpos
)
3405 xfree (overlay_vec
);
3406 return make_number (endpos
);
3409 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
3410 Sprevious_overlay_change
, 1, 1, 0,
3411 "Return the previous position before POS where an overlay starts or ends.\n\
3412 If there are no more overlay boundaries before POS, return (point-min).")
3418 Lisp_Object
*overlay_vec
;
3423 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3426 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3428 /* At beginning of buffer, we know the answer;
3429 avoid bug subtracting 1 below. */
3430 if (XINT (pos
) == BEGV
)
3433 /* Put all the overlays we want in a vector in overlay_vec.
3434 Store the length in len.
3435 prevpos gets the position of the previous change. */
3436 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3437 (int *) 0, &prevpos
);
3439 xfree (overlay_vec
);
3440 return make_number (prevpos
);
3443 /* These functions are for debugging overlays. */
3445 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
3446 "Return a pair of lists giving all the overlays of the current buffer.\n\
3447 The car has all the overlays before the overlay center;\n\
3448 the cdr has all the overlays after the overlay center.\n\
3449 Recentering overlays moves overlays between these lists.\n\
3450 The lists you get are copies, so that changing them has no effect.\n\
3451 However, the overlays you get are the real objects that the buffer uses.")
3454 Lisp_Object before
, after
;
3455 before
= current_buffer
->overlays_before
;
3457 before
= Fcopy_sequence (before
);
3458 after
= current_buffer
->overlays_after
;
3460 after
= Fcopy_sequence (after
);
3462 return Fcons (before
, after
);
3465 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
3466 "Recenter the overlays of the current buffer around position POS.")
3470 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3472 recenter_overlay_lists (current_buffer
, XINT (pos
));
3476 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
3477 "Get the property of overlay OVERLAY with property name PROP.")
3479 Lisp_Object overlay
, prop
;
3481 Lisp_Object plist
, fallback
;
3483 CHECK_OVERLAY (overlay
, 0);
3487 for (plist
= XOVERLAY (overlay
)->plist
;
3488 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
3489 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
3491 if (EQ (XCONS (plist
)->car
, prop
))
3492 return XCONS (XCONS (plist
)->cdr
)->car
;
3493 else if (EQ (XCONS (plist
)->car
, Qcategory
))
3496 tem
= Fcar (Fcdr (plist
));
3498 fallback
= Fget (tem
, prop
);
3505 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
3506 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
3507 (overlay
, prop
, value
)
3508 Lisp_Object overlay
, prop
, value
;
3510 Lisp_Object tail
, buffer
;
3513 CHECK_OVERLAY (overlay
, 0);
3515 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3517 for (tail
= XOVERLAY (overlay
)->plist
;
3518 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
3519 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
3520 if (EQ (XCONS (tail
)->car
, prop
))
3522 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
3523 XCONS (XCONS (tail
)->cdr
)->car
= value
;
3526 /* It wasn't in the list, so add it to the front. */
3527 changed
= !NILP (value
);
3528 XOVERLAY (overlay
)->plist
3529 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
3531 if (! NILP (buffer
))
3534 modify_overlay (XBUFFER (buffer
),
3535 marker_position (OVERLAY_START (overlay
)),
3536 marker_position (OVERLAY_END (overlay
)));
3537 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
3538 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
3539 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
3540 Fdelete_overlay (overlay
);
3545 /* Subroutine of report_overlay_modification. */
3547 /* Lisp vector holding overlay hook functions to call.
3548 Vector elements come in pairs.
3549 Each even-index element is a list of hook functions.
3550 The following odd-index element is the overlay they came from.
3552 Before the buffer change, we fill in this vector
3553 as we call overlay hook functions.
3554 After the buffer change, we get the functions to call from this vector.
3555 This way we always call the same functions before and after the change. */
3556 static Lisp_Object last_overlay_modification_hooks
;
3558 /* Number of elements actually used in last_overlay_modification_hooks. */
3559 static int last_overlay_modification_hooks_used
;
3561 /* Add one functionlist/overlay pair
3562 to the end of last_overlay_modification_hooks. */
3565 add_overlay_mod_hooklist (functionlist
, overlay
)
3566 Lisp_Object functionlist
, overlay
;
3568 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3570 if (last_overlay_modification_hooks_used
== oldsize
)
3573 old
= last_overlay_modification_hooks
;
3574 last_overlay_modification_hooks
3575 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3576 bcopy (XVECTOR (old
)->contents
,
3577 XVECTOR (last_overlay_modification_hooks
)->contents
,
3578 sizeof (Lisp_Object
) * oldsize
);
3580 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3581 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3584 /* Run the modification-hooks of overlays that include
3585 any part of the text in START to END.
3586 If this change is an insertion, also
3587 run the insert-before-hooks of overlay starting at END,
3588 and the insert-after-hooks of overlay ending at START.
3590 This is called both before and after the modification.
3591 AFTER is nonzero when we call after the modification.
3593 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3594 When AFTER is nonzero, they are the start position,
3595 the position after the inserted new text,
3596 and the length of deleted or replaced old text. */
3599 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3600 Lisp_Object start
, end
;
3602 Lisp_Object arg1
, arg2
, arg3
;
3604 Lisp_Object prop
, overlay
, tail
;
3605 /* 1 if this change is an insertion. */
3606 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3608 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3612 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3616 /* Call the functions recorded in last_overlay_modification_hooks
3617 rather than scanning the overlays again.
3618 First copy the vector contents, in case some of these hooks
3619 do subsequent modification of the buffer. */
3620 int size
= last_overlay_modification_hooks_used
;
3621 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3624 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3625 copy
, size
* sizeof (Lisp_Object
));
3627 gcpro1
.nvars
= size
;
3629 for (i
= 0; i
< size
;)
3631 Lisp_Object prop
, overlay
;
3633 overlay
= copy
[i
++];
3634 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3640 /* We are being called before a change.
3641 Scan the overlays to find the functions to call. */
3642 last_overlay_modification_hooks_used
= 0;
3644 for (tail
= current_buffer
->overlays_before
;
3646 tail
= XCONS (tail
)->cdr
)
3648 int startpos
, endpos
;
3649 Lisp_Object ostart
, oend
;
3651 overlay
= XCONS (tail
)->car
;
3653 ostart
= OVERLAY_START (overlay
);
3654 oend
= OVERLAY_END (overlay
);
3655 endpos
= OVERLAY_POSITION (oend
);
3656 if (XFASTINT (start
) > endpos
)
3658 startpos
= OVERLAY_POSITION (ostart
);
3659 if (insertion
&& (XFASTINT (start
) == startpos
3660 || XFASTINT (end
) == startpos
))
3662 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3665 /* Copy TAIL in case the hook recenters the overlay lists. */
3667 tail
= Fcopy_sequence (tail
);
3669 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3672 if (insertion
&& (XFASTINT (start
) == endpos
3673 || XFASTINT (end
) == endpos
))
3675 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3679 tail
= Fcopy_sequence (tail
);
3681 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3684 /* Test for intersecting intervals. This does the right thing
3685 for both insertion and deletion. */
3686 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3688 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3692 tail
= Fcopy_sequence (tail
);
3694 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3700 for (tail
= current_buffer
->overlays_after
;
3702 tail
= XCONS (tail
)->cdr
)
3704 int startpos
, endpos
;
3705 Lisp_Object ostart
, oend
;
3707 overlay
= XCONS (tail
)->car
;
3709 ostart
= OVERLAY_START (overlay
);
3710 oend
= OVERLAY_END (overlay
);
3711 startpos
= OVERLAY_POSITION (ostart
);
3712 endpos
= OVERLAY_POSITION (oend
);
3713 if (XFASTINT (end
) < startpos
)
3715 if (insertion
&& (XFASTINT (start
) == startpos
3716 || XFASTINT (end
) == startpos
))
3718 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3722 tail
= Fcopy_sequence (tail
);
3724 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3727 if (insertion
&& (XFASTINT (start
) == endpos
3728 || XFASTINT (end
) == endpos
))
3730 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3734 tail
= Fcopy_sequence (tail
);
3736 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3739 /* Test for intersecting intervals. This does the right thing
3740 for both insertion and deletion. */
3741 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3743 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3747 tail
= Fcopy_sequence (tail
);
3749 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3758 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3759 Lisp_Object list
, overlay
;
3761 Lisp_Object arg1
, arg2
, arg3
;
3763 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3765 GCPRO4 (list
, arg1
, arg2
, arg3
);
3767 add_overlay_mod_hooklist (list
, overlay
);
3769 while (!NILP (list
))
3772 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3774 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3780 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3783 evaporate_overlays (pos
)
3786 Lisp_Object tail
, overlay
, hit_list
;
3789 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3790 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3791 tail
= XCONS (tail
)->cdr
)
3794 overlay
= XCONS (tail
)->car
;
3795 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3798 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3799 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3800 hit_list
= Fcons (overlay
, hit_list
);
3803 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3804 tail
= XCONS (tail
)->cdr
)
3807 overlay
= XCONS (tail
)->car
;
3808 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3811 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3812 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3813 hit_list
= Fcons (overlay
, hit_list
);
3815 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3816 Fdelete_overlay (XCONS (hit_list
)->car
);
3819 /* Somebody has tried to store a value with an unacceptable type
3820 in the slot with offset OFFSET. */
3823 buffer_slot_type_mismatch (offset
)
3828 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3829 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3831 case Lisp_Int
: type_name
= "integers"; break;
3832 case Lisp_String
: type_name
= "strings"; break;
3833 case Lisp_Symbol
: type_name
= "symbols"; break;
3839 error ("Only %s should be stored in the buffer-local variable %s",
3840 type_name
, XSYMBOL (sym
)->name
->data
);
3846 register Lisp_Object tem
;
3848 buffer_permanent_local_flags
= 0;
3850 /* Make sure all markable slots in buffer_defaults
3851 are initialized reasonably, so mark_buffer won't choke. */
3852 reset_buffer (&buffer_defaults
);
3853 reset_buffer_local_variables (&buffer_defaults
, 1);
3854 reset_buffer (&buffer_local_symbols
);
3855 reset_buffer_local_variables (&buffer_local_symbols
, 1);
3856 /* Prevent GC from getting confused. */
3857 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3858 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3859 #ifdef USE_TEXT_PROPERTIES
3860 BUF_INTERVALS (&buffer_defaults
) = 0;
3861 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3863 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3864 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3866 /* Set up the default values of various buffer slots. */
3867 /* Must do these before making the first buffer! */
3869 /* real setup is done in loaddefs.el */
3870 buffer_defaults
.mode_line_format
= build_string ("%-");
3871 buffer_defaults
.top_line_format
= Qnil
;
3872 buffer_defaults
.abbrev_mode
= Qnil
;
3873 buffer_defaults
.overwrite_mode
= Qnil
;
3874 buffer_defaults
.case_fold_search
= Qt
;
3875 buffer_defaults
.auto_fill_function
= Qnil
;
3876 buffer_defaults
.selective_display
= Qnil
;
3878 buffer_defaults
.selective_display_ellipses
= Qt
;
3880 buffer_defaults
.abbrev_table
= Qnil
;
3881 buffer_defaults
.display_table
= Qnil
;
3882 buffer_defaults
.undo_list
= Qnil
;
3883 buffer_defaults
.mark_active
= Qnil
;
3884 buffer_defaults
.file_format
= Qnil
;
3885 buffer_defaults
.overlays_before
= Qnil
;
3886 buffer_defaults
.overlays_after
= Qnil
;
3887 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3889 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3890 buffer_defaults
.truncate_lines
= Qnil
;
3891 buffer_defaults
.ctl_arrow
= Qt
;
3892 buffer_defaults
.direction_reversed
= Qnil
;
3895 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3897 buffer_defaults
.enable_multibyte_characters
= Qt
;
3898 buffer_defaults
.buffer_file_coding_system
= Qnil
;
3899 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3900 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3901 buffer_defaults
.cache_long_line_scans
= Qnil
;
3902 buffer_defaults
.file_truename
= Qnil
;
3903 XSETFASTINT (buffer_defaults
.display_count
, 0);
3904 buffer_defaults
.indicate_empty_lines
= Qnil
;
3905 buffer_defaults
.scroll_up_aggressively
= Qnil
;
3906 buffer_defaults
.scroll_down_aggressively
= Qnil
;
3907 buffer_defaults
.display_time
= Qnil
;
3909 /* Assign the local-flags to the slots that have default values.
3910 The local flag is a bit that is used in the buffer
3911 to say that it has its own local value for the slot.
3912 The local flag bits are in the local_var_flags slot of the buffer. */
3914 /* Nothing can work if this isn't true */
3915 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3917 /* 0 means not a lisp var, -1 means always local, else mask */
3918 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3919 XSETINT (buffer_local_flags
.filename
, -1);
3920 XSETINT (buffer_local_flags
.directory
, -1);
3921 XSETINT (buffer_local_flags
.backed_up
, -1);
3922 XSETINT (buffer_local_flags
.save_length
, -1);
3923 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3924 XSETINT (buffer_local_flags
.read_only
, -1);
3925 XSETINT (buffer_local_flags
.major_mode
, -1);
3926 XSETINT (buffer_local_flags
.mode_name
, -1);
3927 XSETINT (buffer_local_flags
.undo_list
, -1);
3928 XSETINT (buffer_local_flags
.mark_active
, -1);
3929 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3930 XSETINT (buffer_local_flags
.file_truename
, -1);
3931 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3932 XSETINT (buffer_local_flags
.file_format
, -1);
3933 XSETINT (buffer_local_flags
.display_count
, -1);
3934 XSETINT (buffer_local_flags
.display_time
, -1);
3935 XSETINT (buffer_local_flags
.enable_multibyte_characters
, -1);
3937 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3938 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3939 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3940 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3941 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3942 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3944 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3946 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3947 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3948 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3949 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3950 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3951 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3952 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3954 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3955 /* Make this one a permanent local. */
3956 buffer_permanent_local_flags
|= 0x4000;
3958 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3959 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3960 XSETFASTINT (buffer_local_flags
.category_table
, 0x20000);
3961 XSETFASTINT (buffer_local_flags
.direction_reversed
, 0x40000);
3962 XSETFASTINT (buffer_local_flags
.buffer_file_coding_system
, 0x80000);
3963 /* Make this one a permanent local. */
3964 buffer_permanent_local_flags
|= 0x80000;
3965 XSETFASTINT (buffer_local_flags
.left_margin_width
, 0x100000);
3966 XSETFASTINT (buffer_local_flags
.right_margin_width
, 0x200000);
3967 XSETFASTINT (buffer_local_flags
.indicate_empty_lines
, 0x400000);
3968 XSETFASTINT (buffer_local_flags
.scroll_up_aggressively
, 0x800000);
3969 XSETFASTINT (buffer_local_flags
.scroll_down_aggressively
, 0x1000000);
3970 XSETFASTINT (buffer_local_flags
.top_line_format
, 0x2000000);
3972 Vbuffer_alist
= Qnil
;
3976 QSFundamental
= build_string ("Fundamental");
3978 Qfundamental_mode
= intern ("fundamental-mode");
3979 buffer_defaults
.major_mode
= Qfundamental_mode
;
3981 Qmode_class
= intern ("mode-class");
3983 Qprotected_field
= intern ("protected-field");
3985 Qpermanent_local
= intern ("permanent-local");
3987 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3989 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3991 /* super-magic invisible buffer */
3992 Vbuffer_alist
= Qnil
;
3994 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3996 inhibit_modification_hooks
= 0;
4002 char buf
[MAXPATHLEN
+1];
4004 struct stat dotstat
, pwdstat
;
4008 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
4009 if (NILP (buffer_defaults
.enable_multibyte_characters
))
4010 Fset_buffer_multibyte (Qnil
);
4012 /* If PWD is accurate, use it instead of calling getwd. This is faster
4013 when PWD is right, and may avoid a fatal error. */
4014 if ((pwd
= getenv ("PWD")) != 0
4015 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
4016 && stat (pwd
, &pwdstat
) == 0
4017 && stat (".", &dotstat
) == 0
4018 && dotstat
.st_ino
== pwdstat
.st_ino
4019 && dotstat
.st_dev
== pwdstat
.st_dev
4020 && strlen (pwd
) < MAXPATHLEN
)
4023 else if (getcwd (buf
, MAXPATHLEN
+1) == 0)
4024 fatal ("`getcwd' failed: %s\n", strerror (errno
));
4026 else if (getwd (buf
) == 0)
4027 fatal ("`getwd' failed: %s\n", buf
);
4031 /* Maybe this should really use some standard subroutine
4032 whose definition is filename syntax dependent. */
4034 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
4036 buf
[rc
] = DIRECTORY_SEP
;
4039 #endif /* not VMS */
4041 current_buffer
->directory
= build_string (buf
);
4043 /* Add /: to the front of the name
4044 if it would otherwise be treated as magic. */
4045 temp
= Ffind_file_name_handler (current_buffer
->directory
, Qt
);
4047 /* If the default dir is just /, TEMP is non-nil
4048 because of the ange-ftp completion handler.
4049 However, it is not necessary to turn / into /:/.
4050 So avoid doing that. */
4051 && strcmp ("/", XSTRING (current_buffer
->directory
)->data
))
4052 current_buffer
->directory
4053 = concat2 (build_string ("/:"), current_buffer
->directory
);
4055 temp
= get_minibuffer (0);
4056 XBUFFER (temp
)->directory
= current_buffer
->directory
;
4059 /* initialize the buffer routines */
4063 extern Lisp_Object Qdisabled
;
4065 staticpro (&last_overlay_modification_hooks
);
4066 last_overlay_modification_hooks
4067 = Fmake_vector (make_number (10), Qnil
);
4069 staticpro (&Vbuffer_defaults
);
4070 staticpro (&Vbuffer_local_symbols
);
4071 staticpro (&Qfundamental_mode
);
4072 staticpro (&Qmode_class
);
4073 staticpro (&QSFundamental
);
4074 staticpro (&Vbuffer_alist
);
4075 staticpro (&Qprotected_field
);
4076 staticpro (&Qpermanent_local
);
4077 staticpro (&Qkill_buffer_hook
);
4078 Qoverlayp
= intern ("overlayp");
4079 staticpro (&Qoverlayp
);
4080 Qevaporate
= intern ("evaporate");
4081 staticpro (&Qevaporate
);
4082 Qmodification_hooks
= intern ("modification-hooks");
4083 staticpro (&Qmodification_hooks
);
4084 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
4085 staticpro (&Qinsert_in_front_hooks
);
4086 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
4087 staticpro (&Qinsert_behind_hooks
);
4088 Qget_file_buffer
= intern ("get-file-buffer");
4089 staticpro (&Qget_file_buffer
);
4090 Qpriority
= intern ("priority");
4091 staticpro (&Qpriority
);
4092 Qwindow
= intern ("window");
4093 staticpro (&Qwindow
);
4094 Qbefore_string
= intern ("before-string");
4095 staticpro (&Qbefore_string
);
4096 Qafter_string
= intern ("after-string");
4097 staticpro (&Qafter_string
);
4098 Qfirst_change_hook
= intern ("first-change-hook");
4099 staticpro (&Qfirst_change_hook
);
4100 Qbefore_change_functions
= intern ("before-change-functions");
4101 staticpro (&Qbefore_change_functions
);
4102 Qafter_change_functions
= intern ("after-change-functions");
4103 staticpro (&Qafter_change_functions
);
4105 Fput (Qprotected_field
, Qerror_conditions
,
4106 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
4107 Fput (Qprotected_field
, Qerror_message
,
4108 build_string ("Attempt to modify a protected field"));
4110 /* All these use DEFVAR_LISP_NOPRO because the slots in
4111 buffer_defaults will all be marked via Vbuffer_defaults. */
4113 DEFVAR_LISP_NOPRO ("default-mode-line-format",
4114 &buffer_defaults
.mode_line_format
,
4115 "Default value of `mode-line-format' for buffers that don't override it.\n\
4116 This is the same as (default-value 'mode-line-format).");
4118 DEFVAR_LISP_NOPRO ("default-top-line-format",
4119 &buffer_defaults
.top_line_format
,
4120 "Default value of `top-line-format' for buffers that don't override it.\n\
4121 This is the same as (default-value 'top-line-format).");
4123 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
4124 &buffer_defaults
.abbrev_mode
,
4125 "Default value of `abbrev-mode' for buffers that do not override it.\n\
4126 This is the same as (default-value 'abbrev-mode).");
4128 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
4129 &buffer_defaults
.ctl_arrow
,
4130 "Default value of `ctl-arrow' for buffers that do not override it.\n\
4131 This is the same as (default-value 'ctl-arrow).");
4133 DEFVAR_LISP_NOPRO ("default-direction-reversed",
4134 &buffer_defaults
.direction_reversed
,
4135 "Default value of `direction_reversed' for buffers that do not override it.\n\
4136 This is the same as (default-value 'direction-reversed).");
4138 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
4139 &buffer_defaults
.enable_multibyte_characters
,
4140 "*Default value of `enable-multibyte-characters' for buffers not overriding it.\n\
4141 This is the same as (default-value 'enable-multibyte-characters).");
4143 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
4144 &buffer_defaults
.buffer_file_coding_system
,
4145 "Default value of `buffer-file-coding-system' for buffers not overriding it.\n\
4146 This is the same as (default-value 'buffer-file-coding-system).");
4148 DEFVAR_LISP_NOPRO ("default-truncate-lines",
4149 &buffer_defaults
.truncate_lines
,
4150 "Default value of `truncate-lines' for buffers that do not override it.\n\
4151 This is the same as (default-value 'truncate-lines).");
4153 DEFVAR_LISP_NOPRO ("default-fill-column",
4154 &buffer_defaults
.fill_column
,
4155 "Default value of `fill-column' for buffers that do not override it.\n\
4156 This is the same as (default-value 'fill-column).");
4158 DEFVAR_LISP_NOPRO ("default-left-margin",
4159 &buffer_defaults
.left_margin
,
4160 "Default value of `left-margin' for buffers that do not override it.\n\
4161 This is the same as (default-value 'left-margin).");
4163 DEFVAR_LISP_NOPRO ("default-tab-width",
4164 &buffer_defaults
.tab_width
,
4165 "Default value of `tab-width' for buffers that do not override it.\n\
4166 This is the same as (default-value 'tab-width).");
4168 DEFVAR_LISP_NOPRO ("default-case-fold-search",
4169 &buffer_defaults
.case_fold_search
,
4170 "Default value of `case-fold-search' for buffers that don't override it.\n\
4171 This is the same as (default-value 'case-fold-search).");
4174 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
4175 &buffer_defaults
.buffer_file_type
,
4176 "Default file type for buffers that do not override it.\n\
4177 This is the same as (default-value 'buffer-file-type).\n\
4178 The file type is nil for text, t for binary.");
4181 DEFVAR_LISP_NOPRO ("default-left-margin-width",
4182 &buffer_defaults
.left_margin_width
,
4183 "Default value of `left-margin-width' for buffers that don't override it.\n\
4184 This is the same as (default-value 'left-margin-width).");
4186 DEFVAR_LISP_NOPRO ("default-right-margin-width",
4187 &buffer_defaults
.right_margin_width
,
4188 "Default value of `right_margin_width' for buffers that don't override it.\n\
4189 This is the same as (default-value 'right-margin-width).");
4191 DEFVAR_LISP_NOPRO ("default-indicate-empty-lines",
4192 &buffer_defaults
.indicate_empty_lines
,
4193 "Default value of `indicate-empty-lines' for buffers that don't override it.\n\
4194 This is the same as (default-value 'indicate-empty-lines).");
4196 DEFVAR_LISP_NOPRO ("default-scroll-up-aggressively",
4197 &buffer_defaults
.scroll_up_aggressively
,
4198 "Default value of `scroll-up-aggressively' for buffers that\n\
4199 don't override it. This is the same as (default-value\n\
4200 'scroll-up-aggressively).");
4202 DEFVAR_LISP_NOPRO ("default-scroll-down-aggressively",
4203 &buffer_defaults
.scroll_down_aggressively
,
4204 "Default value of `scroll-down-aggressively' for buffers that\n\
4205 don't override it. This is the same as (default-value\n\
4206 'scroll-down-aggressively).");
4208 DEFVAR_PER_BUFFER ("top-line-format", ¤t_buffer
->top_line_format
,
4210 "Analogous to `mode-line-format', but for a mode line displayed\n\
4211 at the top of windows.");
4213 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
4216 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
4217 But make-docfile finds it!
4218 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
4220 "Template for displaying mode line for current buffer.\n\
4221 Each buffer has its own value of this variable.\n\
4222 Value may be nil, a string, a symbol or a list or cons cell.\n\
4223 A value of nil means don't display a mode line.\n\
4224 For a symbol, its value is used (but it is ignored if t or nil).\n\
4225 A string appearing directly as the value of a symbol is processed verbatim\n\
4226 in that the %-constructs below are not recognized.\n\
4227 For a list whose car is a symbol, the symbol's value is taken,\n\
4228 and if that is non-nil, the cadr of the list is processed recursively.\n\
4229 Otherwise, the caddr of the list (if there is one) is processed.\n\
4230 For a list whose car is a string or list, each element is processed\n\
4231 recursively and the results are effectively concatenated.\n\
4232 For a list whose car is an integer, the cdr of the list is processed\n\
4233 and padded (if the number is positive) or truncated (if negative)\n\
4234 to the width specified by that number.\n\
4235 A string is printed verbatim in the mode line except for %-constructs:\n\
4236 (%-constructs are allowed when the string is the entire mode-line-format\n\
4237 or when it is found in a cons-cell or a list)\n\
4238 %b -- print buffer name. %f -- print visited file name.\n\
4239 %F -- print frame name.\n\
4240 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
4241 % means buffer is read-only and * means it is modified.\n\
4242 For a modified read-only buffer, %* gives % and %+ gives *.\n\
4243 %s -- print process status. %l -- print the current line number.\n\
4244 %c -- print the current column number (this makes editing slower).\n\
4245 To make the column number update correctly in all cases,\n\
4246 `column-number-mode' must be non-nil.\n\
4247 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
4248 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
4249 or print Bottom or All.\n\
4250 %n -- print Narrow if appropriate.\n\
4251 %t -- print T if file is text, B if binary.\n\
4252 %[ -- print one [ for each recursive editing level. %] similar.\n\
4253 %% -- print %. %- -- print infinitely many dashes.\n\
4254 Decimal digits after the % specify field width to which to pad.");
4257 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
4258 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
4259 nil here means use current buffer's major mode.");
4261 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
4262 make_number (Lisp_Symbol
),
4263 "Symbol for current buffer's major mode.");
4265 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
4266 make_number (Lisp_String
),
4267 "Pretty name of current buffer's major mode (a string).");
4269 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
4270 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
4271 Automatically becomes buffer-local when set in any fashion.");
4273 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
4275 "*Non-nil if searches and matches should ignore case.\n\
4276 Automatically becomes buffer-local when set in any fashion.");
4278 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
4279 make_number (Lisp_Int
),
4280 "*Column beyond which automatic line-wrapping should happen.\n\
4281 Automatically becomes buffer-local when set in any fashion.");
4283 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
4284 make_number (Lisp_Int
),
4285 "*Column for the default indent-line-function to indent to.\n\
4286 Linefeed indents to this column in Fundamental mode.\n\
4287 Automatically becomes buffer-local when set in any fashion.");
4289 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
4290 make_number (Lisp_Int
),
4291 "*Distance between tab stops (for display of tab characters), in columns.\n\
4292 Automatically becomes buffer-local when set in any fashion.");
4294 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
4295 "*Non-nil means display control chars with uparrow.\n\
4296 A value of nil means use backslash and octal digits.\n\
4297 Automatically becomes buffer-local when set in any fashion.\n\
4298 This variable does not apply to characters whose display is specified\n\
4299 in the current display table (if there is one).");
4301 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
4302 ¤t_buffer
->enable_multibyte_characters
,
4304 "Non-nil means the buffer contents are regarded as multi-byte characters.\n\
4305 Otherwise they are regarded as unibyte. This affects the display,\n\
4306 file I/O and the behavior of various editing commands.\n\
4308 This variable is buffer-local but you cannot set it directly;\n\
4309 use the function `set-buffer-multibyte' to change a buffer's representation.\n\
4310 Changing its default value with `setq-default' is supported.\n\
4311 See also variable `default-enable-multibyte-characters' and Info node\n\
4312 `(elisp)Text Representations'.");
4314 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
4315 ¤t_buffer
->buffer_file_coding_system
, Qnil
,
4316 "Coding system to be used for encoding the buffer contents on saving.\n\
4317 This variable applies to saving the buffer, and also to `write-region'\n\
4318 and other functions that use `write-region'.\n\
4319 It does not apply to sending output to subprocesses, however.\n\
4321 If this is nil, the buffer is saved without any code conversion\n\
4322 unless some coding system is specified in `file-coding-system-alist'\n\
4323 for the buffer file.\n\
4325 The variable `coding-system-for-write', if non-nil, overrides this variable.\n\
4327 This variable is never applied to a way of decoding\n\
4328 a file while reading it.");
4330 DEFVAR_PER_BUFFER ("direction-reversed", ¤t_buffer
->direction_reversed
,
4332 "*Non-nil means lines in the buffer are displayed right to left.");
4334 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
4335 "*Non-nil means do not display continuation lines;\n\
4336 give each line of text one screen line.\n\
4337 Automatically becomes buffer-local when set in any fashion.\n\
4339 Note that this is overridden by the variable\n\
4340 `truncate-partial-width-windows' if that variable is non-nil\n\
4341 and this buffer is not full-frame width.");
4344 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
4346 "Non-nil if the visited file is a binary file.\n\
4347 This variable is meaningful on MS-DOG and Windows NT.\n\
4348 On those systems, it is automatically local in every buffer.\n\
4349 On other systems, this variable is normally always nil.");
4352 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
4353 make_number (Lisp_String
),
4354 "Name of default directory of current buffer. Should end with slash.\n\
4355 Each buffer has its own value of this variable.");
4357 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
4359 "Function called (if non-nil) to perform auto-fill.\n\
4360 It is called after self-inserting a space or newline.\n\
4361 Each buffer has its own value of this variable.\n\
4362 NOTE: This variable is not a hook;\n\
4363 its value may not be a list of functions.");
4365 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
4366 make_number (Lisp_String
),
4367 "Name of file visited in current buffer, or nil if not visiting a file.\n\
4368 Each buffer has its own value of this variable.");
4370 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
4371 make_number (Lisp_String
),
4372 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
4373 The truename of a file is calculated by `file-truename'\n\
4374 and then abbreviated with `abbreviate-file-name'.\n\
4375 Each buffer has its own value of this variable.");
4377 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
4378 ¤t_buffer
->auto_save_file_name
,
4379 make_number (Lisp_String
),
4380 "Name of file for auto-saving current buffer,\n\
4381 or nil if buffer should not be auto-saved.\n\
4382 Each buffer has its own value of this variable.");
4384 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
4385 "Non-nil if this buffer is read-only.\n\
4386 Each buffer has its own value of this variable.");
4388 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
4389 "Non-nil if this buffer's file has been backed up.\n\
4390 Backing up is done before the first time the file is saved.\n\
4391 Each buffer has its own value of this variable.");
4393 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
4394 make_number (Lisp_Int
),
4395 "Length of current buffer when last read in, saved or auto-saved.\n\
4397 Each buffer has its own value of this variable.");
4399 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
4401 "Non-nil enables selective display:\n\
4402 Integer N as value means display only lines\n\
4403 that start with less than n columns of space.\n\
4404 A value of t means, after a ^M, all the rest of the line is invisible.\n\
4405 Then ^M's in the file are written into files as newlines.\n\n\
4406 Automatically becomes buffer-local when set in any fashion.");
4409 DEFVAR_PER_BUFFER ("selective-display-ellipses",
4410 ¤t_buffer
->selective_display_ellipses
,
4412 "t means display ... on previous line when a line is invisible.\n\
4413 Automatically becomes buffer-local when set in any fashion.");
4416 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
4417 "Non-nil if self-insertion should replace existing text.\n\
4418 The value should be one of `overwrite-mode-textual',\n\
4419 `overwrite-mode-binary', or nil.\n\
4420 If it is `overwrite-mode-textual', self-insertion still\n\
4421 inserts at the end of a line, and inserts when point is before a tab,\n\
4422 until the tab is filled in.\n\
4423 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
4424 Automatically becomes buffer-local when set in any fashion.");
4426 #if 0 /* The doc string is too long for some compilers,
4427 but make-docfile can find it in this comment. */
4428 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4430 "Display table that controls display of the contents of current buffer.\n\
4431 Automatically becomes buffer-local when set in any fashion.\n\
4432 The display table is a char-table created with `make-display-table'.\n\
4433 The ordinary char-table elements control how to display each possible text\n\
4434 character. Each value should be a vector of characters or nil;\n\
4435 nil means display the character in the default fashion.\n\
4436 There are six extra slots to control the display of\n\
4437 the end of a truncated screen line (extra-slot 0, a single character);\n\
4438 the end of a continued line (extra-slot 1, a single character);\n\
4439 the escape character used to display character codes in octal\n\
4440 (extra-slot 2, a single character);\n\
4441 the character used as an arrow for control characters (extra-slot 3,\n\
4442 a single character);\n\
4443 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
4444 a vector of characters);\n\
4445 the character used to draw the border between side-by-side windows\n\
4446 (extra-slot 5, a single character).\n\
4447 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
4448 If this variable is nil, the value of `standard-display-table' is used.\n\
4449 Each window can have its own, overriding display table.");
4451 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4454 DEFVAR_PER_BUFFER ("left-margin-width", ¤t_buffer
->left_margin_width
,
4456 "*Width of left marginal area for display of a buffer.\n\
4457 Automatically becomes buffer-local when set in any fashion.\n\
4458 A value of nil means no marginal area.");
4460 DEFVAR_PER_BUFFER ("right-margin-width", ¤t_buffer
->right_margin_width
,
4462 "*Width of right marginal area for display of a buffer.\n\
4463 Automatically becomes buffer-local when set in any fashion.\n\
4464 A value of nil means no marginal area.");
4466 DEFVAR_PER_BUFFER ("indicate-empty-lines",
4467 ¤t_buffer
->indicate_empty_lines
, Qnil
,
4468 "*Non-nil means visually indicate lines not displaying text.\n\
4469 Automatically becomes buffer-local when set in any fashion.\n");
4471 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
4472 ¤t_buffer
->scroll_up_aggressively
, Qnil
,
4473 "*If a number, scroll display up aggressively.\n\
4474 If scrolling a window because point is above the window start, choose\n\
4475 a new window start so that point ends up that fraction of the window's\n\
4476 height from the bottom of the window.\n\
4477 Automatically becomes buffer-local when set in any fashion.");
4479 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
4480 ¤t_buffer
->scroll_down_aggressively
, Qnil
,
4481 "*If a number, scroll display down aggressively.\n\
4482 If scrolling a window because point is below the window end, choose\n\
4483 a new window start so that point ends up that fraction of the window's\n\
4484 height from the top of the window.\n\
4485 Automatically becomes buffer-local when set in any fashion.");
4487 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
4490 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
4491 "If non-nil, a function to call before each text change (obsolete).\n\
4492 Two arguments are passed to the function: the positions of\n\
4493 the beginning and end of the range of old text to be changed.\n\
4494 \(For an insertion, the beginning and end are at the same place.)\n\
4495 No information is given about the length of the text after the change.\n\
4497 Buffer changes made while executing the `before-change-function'\n\
4498 don't call any before-change or after-change functions.\n\
4499 That's because these variables are temporarily set to nil.\n\
4500 As a result, a hook function cannot straightforwardly alter the value of\n\
4501 these variables. See the Emacs Lisp manual for a way of\n\
4502 accomplishing an equivalent result by using other variables.\n\n\
4503 This variable is obsolete; use `before-change-functions' instead.");
4504 Vbefore_change_function
= Qnil
;
4506 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
4507 "If non-nil, a Function to call after each text change (obsolete).\n\
4508 Three arguments are passed to the function: the positions of\n\
4509 the beginning and end of the range of changed text,\n\
4510 and the length of the pre-change text replaced by that range.\n\
4511 \(For an insertion, the pre-change length is zero;\n\
4512 for a deletion, that length is the number of bytes deleted,\n\
4513 and the post-change beginning and end are at the same place.)\n\
4515 Buffer changes made while executing the `after-change-function'\n\
4516 don't call any before-change or after-change functions.\n\
4517 That's because these variables are temporarily set to nil.\n\
4518 As a result, a hook function cannot straightforwardly alter the value of\n\
4519 these variables. See the Emacs Lisp manual for a way of\n\
4520 accomplishing an equivalent result by using other variables.\n\n\
4521 This variable is obsolete; use `after-change-functions' instead.");
4522 Vafter_change_function
= Qnil
;
4524 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
4525 "List of functions to call before each text change.\n\
4526 Two arguments are passed to each function: the positions of\n\
4527 the beginning and end of the range of old text to be changed.\n\
4528 \(For an insertion, the beginning and end are at the same place.)\n\
4529 No information is given about the length of the text after the change.\n\
4531 Buffer changes made while executing the `before-change-functions'\n\
4532 don't call any before-change or after-change functions.\n\
4533 That's because these variables are temporarily set to nil.\n\
4534 As a result, a hook function cannot straightforwardly alter the value of\n\
4535 these variables. See the Emacs Lisp manual for a way of\n\
4536 accomplishing an equivalent result by using other variables.\n\
4538 If an unhandled error happens in running these functions,\n\
4539 the variable's value remains nil. That prevents the error\n\
4540 from happening repeatedly and making Emacs nonfunctional.");
4541 Vbefore_change_functions
= Qnil
;
4543 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
4544 "List of function to call after each text change.\n\
4545 Three arguments are passed to each function: the positions of\n\
4546 the beginning and end of the range of changed text,\n\
4547 and the length in bytes of the pre-change text replaced by that range.\n\
4548 \(For an insertion, the pre-change length is zero;\n\
4549 for a deletion, that length is the number of bytes deleted,\n\
4550 and the post-change beginning and end are at the same place.)\n\
4552 Buffer changes made while executing the `after-change-functions'\n\
4553 don't call any before-change or after-change functions.\n\
4554 That's because these variables are temporarily set to nil.\n\
4555 As a result, a hook function cannot straightforwardly alter the value of\n\
4556 these variables. See the Emacs Lisp manual for a way of\n\
4557 accomplishing an equivalent result by using other variables.\n\
4559 If an unhandled error happens in running these functions,\n\
4560 the variable's value remains nil. That prevents the error\n\
4561 from happening repeatedly and making Emacs nonfunctional.");
4562 Vafter_change_functions
= Qnil
;
4564 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
4565 "A list of functions to call before changing a buffer which is unmodified.\n\
4566 The functions are run using the `run-hooks' function.");
4567 Vfirst_change_hook
= Qnil
;
4569 #if 0 /* The doc string is too long for some compilers,
4570 but make-docfile can find it in this comment. */
4571 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4572 "List of undo entries in current buffer.\n\
4573 This variable is always local in all buffers.\n\
4574 Recent changes come first; older changes follow newer.\n\
4576 An entry (BEG . END) represents an insertion which begins at\n\
4577 position BEG and ends at position END.\n\
4579 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
4580 from (abs POSITION). If POSITION is positive, point was at the front\n\
4581 of the text being deleted; if negative, point was at the end.\n\
4583 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
4584 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
4585 of the visited file's modification time, as of that time. If the\n\
4586 modification time of the most recent save is different, this entry is\n\
4589 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
4590 was modified between BEG and END. PROPERTY is the property name,\n\
4591 and VALUE is the old value.\n\
4593 An entry (MARKER . DISTANCE) indicates that the marker MARKER\n\
4594 was adjusted in position by the offset DISTANCE (an integer).\n\
4596 An entry of the form POSITION indicates that point was at the buffer\n\
4597 location given by the integer. Undoing an entry of this form places\n\
4598 point at POSITION.\n\
4600 nil marks undo boundaries. The undo command treats the changes\n\
4601 between two undo boundaries as a single step to be undone.\n\
4603 If the value of the variable is t, undo information is not recorded.");
4605 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4608 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
4609 "Non-nil means the mark and region are currently active in this buffer.\n\
4610 Automatically local in all buffers.");
4612 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
4613 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
4614 This variable is buffer-local, in all buffers.\n\
4616 Normally, the line-motion functions work by scanning the buffer for\n\
4617 newlines. Columnar operations (like move-to-column and\n\
4618 compute-motion) also work by scanning the buffer, summing character\n\
4619 widths as they go. This works well for ordinary text, but if the\n\
4620 buffer's lines are very long (say, more than 500 characters), these\n\
4621 motion functions will take longer to execute. Emacs may also take\n\
4622 longer to update the display.\n\
4624 If cache-long-line-scans is non-nil, these motion functions cache the\n\
4625 results of their scans, and consult the cache to avoid rescanning\n\
4626 regions of the buffer until the text is modified. The caches are most\n\
4627 beneficial when they prevent the most searching---that is, when the\n\
4628 buffer contains long lines and large regions of characters with the\n\
4629 same, fixed screen width.\n\
4631 When cache-long-line-scans is non-nil, processing short lines will\n\
4632 become slightly slower (because of the overhead of consulting the\n\
4633 cache), and the caches will use memory roughly proportional to the\n\
4634 number of newlines and characters whose screen width varies.\n\
4636 The caches require no explicit maintenance; their accuracy is\n\
4637 maintained internally by the Emacs primitives. Enabling or disabling\n\
4638 the cache should not affect the behavior of any of the motion\n\
4639 functions; it should only affect their performance.");
4641 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
4642 "Value of point before the last series of scroll operations, or nil.\n\
4643 This variable is always local in all buffers.");
4645 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
4646 "List of formats to use when saving this buffer.\n\
4647 This variable is always local in all buffers.\n\
4648 Formats are defined by `format-alist'. This variable is\n\
4649 set when a file is visited. Automatically local in all buffers.");
4651 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
4652 ¤t_buffer
->invisibility_spec
, Qnil
,
4653 "Invisibility spec of this buffer.\n\
4654 This variable is always local in all buffers.\n\
4655 The default is t, which means that text is invisible\n\
4656 if it has a non-nil `invisible' property.\n\
4657 If the value is a list, a text character is invisible if its `invisible'\n\
4658 property is an element in that list.\n\
4659 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
4660 then characters with property value PROP are invisible,\n\
4661 and they have an ellipsis as well if ELLIPSIS is non-nil.");
4663 DEFVAR_PER_BUFFER ("buffer-display-count",
4664 ¤t_buffer
->display_count
, Qnil
,
4665 "A number incremented each time this buffer is displayed in a window.\n\
4666 This variable is always local in all buffers.\n\
4667 The function `set-window-buffer increments it.");
4669 DEFVAR_PER_BUFFER ("buffer-display-time",
4670 ¤t_buffer
->display_time
, Qnil
,
4671 "Time stamp updated each time this buffer is displayed in a window.\n\
4672 This variable is always local in all buffers.\n\
4673 The function `set-window-buffer' updates this variable\n\
4674 to the value obtained by calling `current-time'.\n\
4675 If the buffer has never been shown in a window, the value is nil.");
4677 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
4678 "*Non-nil means deactivate the mark when the buffer contents change.\n\
4679 Non-nil also enables highlighting of the region whenever the mark is active.\n\
4680 The variable `highlight-nonselected-windows' controls whether to highlight\n\
4681 all windows or just the selected window.");
4682 Vtransient_mark_mode
= Qnil
;
4684 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
4685 "*Non-nil means disregard read-only status of buffers or characters.\n\
4686 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
4687 text properties. If the value is a list, disregard `buffer-read-only'\n\
4688 and disregard a `read-only' text property if the property value\n\
4689 is a member of the list.");
4690 Vinhibit_read_only
= Qnil
;
4692 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
4693 "List of functions called with no args to query before killing a buffer.");
4694 Vkill_buffer_query_functions
= Qnil
;
4696 defsubr (&Sbuffer_live_p
);
4697 defsubr (&Sbuffer_list
);
4698 defsubr (&Sget_buffer
);
4699 defsubr (&Sget_file_buffer
);
4700 defsubr (&Sget_buffer_create
);
4701 defsubr (&Smake_indirect_buffer
);
4702 defsubr (&Sgenerate_new_buffer_name
);
4703 defsubr (&Sbuffer_name
);
4704 /*defsubr (&Sbuffer_number);*/
4705 defsubr (&Sbuffer_file_name
);
4706 defsubr (&Sbuffer_base_buffer
);
4707 defsubr (&Sbuffer_local_variables
);
4708 defsubr (&Sbuffer_modified_p
);
4709 defsubr (&Sset_buffer_modified_p
);
4710 defsubr (&Sbuffer_modified_tick
);
4711 defsubr (&Srename_buffer
);
4712 defsubr (&Sother_buffer
);
4713 defsubr (&Sbuffer_disable_undo
);
4714 defsubr (&Sbuffer_enable_undo
);
4715 defsubr (&Skill_buffer
);
4716 defsubr (&Sset_buffer_major_mode
);
4717 defsubr (&Sswitch_to_buffer
);
4718 defsubr (&Spop_to_buffer
);
4719 defsubr (&Scurrent_buffer
);
4720 defsubr (&Sset_buffer
);
4721 defsubr (&Sbarf_if_buffer_read_only
);
4722 defsubr (&Sbury_buffer
);
4723 defsubr (&Serase_buffer
);
4724 defsubr (&Sset_buffer_multibyte
);
4725 defsubr (&Skill_all_local_variables
);
4727 defsubr (&Soverlayp
);
4728 defsubr (&Smake_overlay
);
4729 defsubr (&Sdelete_overlay
);
4730 defsubr (&Smove_overlay
);
4731 defsubr (&Soverlay_start
);
4732 defsubr (&Soverlay_end
);
4733 defsubr (&Soverlay_buffer
);
4734 defsubr (&Soverlay_properties
);
4735 defsubr (&Soverlays_at
);
4736 defsubr (&Soverlays_in
);
4737 defsubr (&Snext_overlay_change
);
4738 defsubr (&Sprevious_overlay_change
);
4739 defsubr (&Soverlay_recenter
);
4740 defsubr (&Soverlay_lists
);
4741 defsubr (&Soverlay_get
);
4742 defsubr (&Soverlay_put
);
4748 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
4749 initial_define_key (control_x_map
, 'k', "kill-buffer");
4751 /* This must not be in syms_of_buffer, because Qdisabled is not
4752 initialized when that function gets called. */
4753 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);