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_UNCHANGED_MODIFIED (b
) = 1;
368 BUF_OVERLAY_UNCHANGED_MODIFIED (b
) = 1;
369 BUF_END_UNCHANGED (b
) = 0;
370 BUF_BEG_UNCHANGED (b
) = 0;
371 *(BUF_GPT_ADDR (b
)) = *(BUF_Z_ADDR (b
)) = 0; /* Put an anchor '\0'. */
373 b
->newline_cache
= 0;
374 b
->width_run_cache
= 0;
375 b
->width_table
= Qnil
;
376 b
->prevent_redisplay_optimizations_p
= 1;
378 /* Put this on the chain of all buffers including killed ones. */
379 b
->next
= all_buffers
;
382 /* An ordinary buffer normally doesn't need markers
383 to handle BEGV and ZV. */
385 b
->begv_marker
= Qnil
;
388 name
= Fcopy_sequence (name
);
389 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
392 if (XSTRING (name
)->data
[0] != ' ')
398 reset_buffer_local_variables (b
, 1);
400 /* Put this in the alist of all live buffers. */
402 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
404 b
->mark
= Fmake_marker ();
405 BUF_MARKERS (b
) = Qnil
;
410 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
411 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
412 "Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.\n\
413 BASE-BUFFER should be an existing buffer (or buffer name).\n\
414 NAME should be a string which is not the name of an existing buffer.")
416 register Lisp_Object base_buffer
, name
;
418 register Lisp_Object buf
;
419 register struct buffer
*b
;
421 buf
= Fget_buffer (name
);
423 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
425 base_buffer
= Fget_buffer (base_buffer
);
426 if (NILP (base_buffer
))
427 error ("No such buffer: `%s'",
428 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
430 if (XSTRING (name
)->size
== 0)
431 error ("Empty string for buffer name is not allowed");
433 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
435 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
437 if (XBUFFER (base_buffer
)->base_buffer
)
438 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
440 b
->base_buffer
= XBUFFER (base_buffer
);
442 /* Use the base buffer's text object. */
443 b
->text
= b
->base_buffer
->text
;
445 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
446 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
447 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
448 BUF_BEGV_BYTE (b
) = BUF_BEGV_BYTE (b
->base_buffer
);
449 BUF_ZV_BYTE (b
) = BUF_ZV_BYTE (b
->base_buffer
);
450 BUF_PT_BYTE (b
) = BUF_PT_BYTE (b
->base_buffer
);
452 b
->newline_cache
= 0;
453 b
->width_run_cache
= 0;
454 b
->width_table
= Qnil
;
456 /* Put this on the chain of all buffers including killed ones. */
457 b
->next
= all_buffers
;
460 name
= Fcopy_sequence (name
);
461 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
465 reset_buffer_local_variables (b
, 1);
467 /* Put this in the alist of all live buffers. */
469 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
471 b
->mark
= Fmake_marker ();
474 /* The multibyte status belongs to the base buffer. */
475 b
->enable_multibyte_characters
= b
->base_buffer
->enable_multibyte_characters
;
477 /* Make sure the base buffer has markers for its narrowing. */
478 if (NILP (b
->base_buffer
->pt_marker
))
480 b
->base_buffer
->pt_marker
= Fmake_marker ();
481 set_marker_both (b
->base_buffer
->pt_marker
, base_buffer
,
482 BUF_PT (b
->base_buffer
),
483 BUF_PT_BYTE (b
->base_buffer
));
485 if (NILP (b
->base_buffer
->begv_marker
))
487 b
->base_buffer
->begv_marker
= Fmake_marker ();
488 set_marker_both (b
->base_buffer
->begv_marker
, base_buffer
,
489 BUF_BEGV (b
->base_buffer
),
490 BUF_BEGV_BYTE (b
->base_buffer
));
492 if (NILP (b
->base_buffer
->zv_marker
))
494 b
->base_buffer
->zv_marker
= Fmake_marker ();
495 set_marker_both (b
->base_buffer
->zv_marker
, base_buffer
,
496 BUF_ZV (b
->base_buffer
),
497 BUF_ZV_BYTE (b
->base_buffer
));
498 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
501 /* Give the indirect buffer markers for its narrowing. */
502 b
->pt_marker
= Fmake_marker ();
503 set_marker_both (b
->pt_marker
, buf
, BUF_PT (b
), BUF_PT_BYTE (b
));
504 b
->begv_marker
= Fmake_marker ();
505 set_marker_both (b
->begv_marker
, buf
, BUF_BEGV (b
), BUF_BEGV_BYTE (b
));
506 b
->zv_marker
= Fmake_marker ();
507 set_marker_both (b
->zv_marker
, buf
, BUF_ZV (b
), BUF_ZV_BYTE (b
));
508 XMARKER (b
->zv_marker
)->insertion_type
= 1;
513 /* Reinitialize everything about a buffer except its name and contents
514 and local variables. */
518 register struct buffer
*b
;
521 b
->file_truename
= Qnil
;
522 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
524 XSETFASTINT (b
->save_length
, 0);
525 b
->last_window_start
= 1;
526 /* It is more conservative to start out "changed" than "unchanged". */
528 b
->prevent_redisplay_optimizations_p
= 1;
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
= selected_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
;
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 int count
= specpdl_ptr
- specpdl
;
1075 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1076 set_buffer_internal (b
);
1078 /* First run the query functions; if any query is answered no,
1079 don't kill the buffer. */
1080 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
1082 tem
= call0 (Fcar (list
));
1084 return unbind_to (count
, Qnil
);
1087 /* Then run the hooks. */
1088 if (!NILP (Vrun_hooks
))
1089 call1 (Vrun_hooks
, Qkill_buffer_hook
);
1090 unbind_to (count
, Qnil
);
1093 /* We have no more questions to ask. Verify that it is valid
1094 to kill the buffer. This must be done after the questions
1095 since anything can happen within do_yes_or_no_p. */
1097 /* Don't kill the minibuffer now current. */
1098 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
1104 /* When we kill a base buffer, kill all its indirect buffers.
1105 We do it at this stage so nothing terrible happens if they
1106 ask questions or their hooks get errors. */
1107 if (! b
->base_buffer
)
1109 struct buffer
*other
;
1113 for (other
= all_buffers
; other
; other
= other
->next
)
1114 /* all_buffers contains dead buffers too;
1115 don't re-kill them. */
1116 if (other
->base_buffer
== b
&& !NILP (other
->name
))
1119 XSETBUFFER (buf
, other
);
1126 /* Make this buffer not be current.
1127 In the process, notice if this is the sole visible buffer
1128 and give up if so. */
1129 if (b
== current_buffer
)
1131 tem
= Fother_buffer (buf
, Qnil
, Qnil
);
1133 if (b
== current_buffer
)
1137 /* Now there is no question: we can kill the buffer. */
1139 #ifdef CLASH_DETECTION
1140 /* Unlock this buffer's file, if it is locked. */
1142 #endif /* CLASH_DETECTION */
1144 kill_buffer_processes (buf
);
1146 tem
= Vinhibit_quit
;
1148 replace_buffer_in_all_windows (buf
);
1149 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1150 frames_discard_buffer (buf
);
1151 Vinhibit_quit
= tem
;
1153 /* Delete any auto-save file, if we saved it in this session. */
1154 if (STRINGP (b
->auto_save_file_name
)
1155 && b
->auto_save_modified
!= 0
1156 && BUF_SAVE_MODIFF (b
) < b
->auto_save_modified
)
1159 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1161 internal_delete_file (b
->auto_save_file_name
);
1166 /* Unchain all markers that belong to this indirect buffer.
1167 Don't unchain the markers that belong to the base buffer
1168 or its other indirect buffers. */
1169 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1175 unchain_marker (tem
);
1181 /* Unchain all markers of this buffer and its indirect buffers.
1182 and leave them pointing nowhere. */
1183 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1190 BUF_MARKERS (b
) = Qnil
;
1192 #ifdef USE_TEXT_PROPERTIES
1193 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1196 /* Perhaps we should explicitly free the interval tree here... */
1199 /* Reset the local variables, so that this buffer's local values
1200 won't be protected from GC. They would be protected
1201 if they happened to remain encached in their symbols.
1202 This gets rid of them for certain. */
1203 swap_out_buffer_local_variables (b
);
1204 reset_buffer_local_variables (b
, 1);
1209 if (! b
->base_buffer
)
1210 BUFFER_FREE (BUF_BEG_ADDR (b
));
1212 if (b
->newline_cache
)
1214 free_region_cache (b
->newline_cache
);
1215 b
->newline_cache
= 0;
1217 if (b
->width_run_cache
)
1219 free_region_cache (b
->width_run_cache
);
1220 b
->width_run_cache
= 0;
1222 b
->width_table
= Qnil
;
1224 b
->undo_list
= Qnil
;
1229 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1230 we do this each time BUF is selected visibly, the more recently
1231 selected buffers are always closer to the front of the list. This
1232 means that other_buffer is more likely to choose a relevant buffer. */
1238 register Lisp_Object link
, prev
;
1240 frame
= selected_frame
;
1243 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1245 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1250 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1251 we cannot use Fdelq itself here because it allows quitting. */
1254 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1256 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1258 XCONS (link
)->cdr
= Vbuffer_alist
;
1259 Vbuffer_alist
= link
;
1261 /* Now move this buffer to the front of frame_buffer_list also. */
1264 for (link
= frame_buffer_list (frame
); CONSP (link
);
1265 link
= XCONS (link
)->cdr
)
1267 if (EQ (XCONS (link
)->car
, buf
))
1272 /* Effectively do delq. */
1277 set_frame_buffer_list (frame
,
1278 XCONS (frame_buffer_list (frame
))->cdr
);
1280 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1282 XCONS (link
)->cdr
= frame_buffer_list (frame
);
1283 set_frame_buffer_list (frame
, link
);
1286 set_frame_buffer_list (frame
, Fcons (buf
, frame_buffer_list (frame
)));
1289 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1290 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1291 Use this function before selecting the buffer, since it may need to inspect\n\
1292 the current buffer's major mode.")
1297 Lisp_Object function
;
1299 function
= buffer_defaults
.major_mode
;
1300 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1301 function
= current_buffer
->major_mode
;
1303 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1306 count
= specpdl_ptr
- specpdl
;
1308 /* To select a nonfundamental mode,
1309 select the buffer temporarily and then call the mode function. */
1311 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1313 Fset_buffer (buffer
);
1316 return unbind_to (count
, Qnil
);
1319 /* If switching buffers in WINDOW would be an error, return
1320 a C string saying what the error would be. */
1323 no_switch_window (window
)
1327 if (EQ (minibuf_window
, window
))
1328 return "Cannot switch buffers in minibuffer window";
1329 tem
= Fwindow_dedicated_p (window
);
1331 return "Cannot switch buffers in a dedicated window";
1335 /* Switch to buffer BUFFER in the selected window.
1336 If NORECORD is non-nil, don't call record_buffer. */
1339 switch_to_buffer_1 (buffer
, norecord
)
1340 Lisp_Object buffer
, norecord
;
1342 register Lisp_Object buf
;
1345 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1348 buf
= Fget_buffer (buffer
);
1351 buf
= Fget_buffer_create (buffer
);
1352 Fset_buffer_major_mode (buf
);
1356 if (NILP (norecord
))
1357 record_buffer (buf
);
1359 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1360 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1367 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1368 "Select buffer BUFFER in the current window.\n\
1369 BUFFER may be a buffer or a buffer name.\n\
1370 Optional second arg NORECORD non-nil means\n\
1371 do not put this buffer at the front of the list of recently selected ones.\n\
1373 WARNING: This is NOT the way to work on another buffer temporarily\n\
1374 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1375 the window-buffer correspondences.")
1377 Lisp_Object buffer
, norecord
;
1381 err
= no_switch_window (selected_window
);
1382 if (err
) error (err
);
1384 return switch_to_buffer_1 (buffer
, norecord
);
1387 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 3, 0,
1388 "Select buffer BUFFER in some window, preferably a different one.\n\
1389 If BUFFER is nil, then some other buffer is chosen.\n\
1390 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1391 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1392 window even if BUFFER is already visible in the selected window.\n\
1393 This uses the function `display-buffer' as a subroutine; see the documentation\n\
1394 of `display-buffer' for additional customization information.\n\
1396 Optional third arg NORECORD non-nil means\n\
1397 do not put this buffer at the front of the list of recently selected ones.")
1398 (buffer
, other_window
, norecord
)
1399 Lisp_Object buffer
, other_window
, norecord
;
1401 register Lisp_Object buf
;
1403 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1406 buf
= Fget_buffer (buffer
);
1409 buf
= Fget_buffer_create (buffer
);
1410 Fset_buffer_major_mode (buf
);
1414 if (NILP (norecord
))
1415 record_buffer (buf
);
1416 Fselect_window (Fdisplay_buffer (buf
, other_window
, Qnil
));
1420 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1421 "Return the current buffer as a Lisp object.")
1424 register Lisp_Object buf
;
1425 XSETBUFFER (buf
, current_buffer
);
1429 /* Set the current buffer to B.
1431 We previously set windows_or_buffers_changed here to invalidate
1432 global unchanged information in beg_unchanged and end_unchanged.
1433 This is no longer necessary because we now compute unchanged
1434 information on a buffer-basis. Every action affecting other
1435 windows than the selected one requires a select_window at some
1436 time, and that increments windows_or_buffers_changed. */
1439 set_buffer_internal (b
)
1440 register struct buffer
*b
;
1442 if (current_buffer
!= b
)
1443 set_buffer_internal_1 (b
);
1446 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1447 This is used by redisplay. */
1450 set_buffer_internal_1 (b
)
1451 register struct buffer
*b
;
1453 register struct buffer
*old_buf
;
1454 register Lisp_Object tail
, valcontents
;
1457 if (current_buffer
== b
)
1460 old_buf
= current_buffer
;
1462 last_known_column_point
= -1; /* invalidate indentation cache */
1466 /* Put the undo list back in the base buffer, so that it appears
1467 that an indirect buffer shares the undo list of its base. */
1468 if (old_buf
->base_buffer
)
1469 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1471 /* If the old current buffer has markers to record PT, BEGV and ZV
1472 when it is not current, update them now. */
1473 if (! NILP (old_buf
->pt_marker
))
1476 XSETBUFFER (obuf
, old_buf
);
1477 set_marker_both (old_buf
->pt_marker
, obuf
,
1478 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1480 if (! NILP (old_buf
->begv_marker
))
1483 XSETBUFFER (obuf
, old_buf
);
1484 set_marker_both (old_buf
->begv_marker
, obuf
,
1485 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1487 if (! NILP (old_buf
->zv_marker
))
1490 XSETBUFFER (obuf
, old_buf
);
1491 set_marker_both (old_buf
->zv_marker
, obuf
,
1492 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1496 /* Get the undo list from the base buffer, so that it appears
1497 that an indirect buffer shares the undo list of its base. */
1499 b
->undo_list
= b
->base_buffer
->undo_list
;
1501 /* If the new current buffer has markers to record PT, BEGV and ZV
1502 when it is not current, fetch them now. */
1503 if (! NILP (b
->pt_marker
))
1505 BUF_PT (b
) = marker_position (b
->pt_marker
);
1506 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1508 if (! NILP (b
->begv_marker
))
1510 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1511 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1513 if (! NILP (b
->zv_marker
))
1515 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1516 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1519 /* Look down buffer's list of local Lisp variables
1520 to find and update any that forward into C variables. */
1522 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1524 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1525 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1526 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1527 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1528 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1529 /* Just reference the variable
1530 to cause it to become set for this buffer. */
1531 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1534 /* Do the same with any others that were local to the previous buffer */
1537 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1539 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1540 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1541 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1542 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1543 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1544 /* Just reference the variable
1545 to cause it to become set for this buffer. */
1546 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1550 /* Switch to buffer B temporarily for redisplay purposes.
1551 This avoids certain things that don't need to be done within redisplay. */
1557 register struct buffer
*old_buf
;
1559 if (current_buffer
== b
)
1562 old_buf
= current_buffer
;
1567 /* If the old current buffer has markers to record PT, BEGV and ZV
1568 when it is not current, update them now. */
1569 if (! NILP (old_buf
->pt_marker
))
1572 XSETBUFFER (obuf
, old_buf
);
1573 set_marker_both (old_buf
->pt_marker
, obuf
,
1574 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1576 if (! NILP (old_buf
->begv_marker
))
1579 XSETBUFFER (obuf
, old_buf
);
1580 set_marker_both (old_buf
->begv_marker
, obuf
,
1581 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1583 if (! NILP (old_buf
->zv_marker
))
1586 XSETBUFFER (obuf
, old_buf
);
1587 set_marker_both (old_buf
->zv_marker
, obuf
,
1588 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1592 /* If the new current buffer has markers to record PT, BEGV and ZV
1593 when it is not current, fetch them now. */
1594 if (! NILP (b
->pt_marker
))
1596 BUF_PT (b
) = marker_position (b
->pt_marker
);
1597 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1599 if (! NILP (b
->begv_marker
))
1601 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1602 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1604 if (! NILP (b
->zv_marker
))
1606 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1607 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1611 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1612 "Make the buffer BUFFER current for editing operations.\n\
1613 BUFFER may be a buffer or the name of an existing buffer.\n\
1614 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1615 This function does not display the buffer, so its effect ends\n\
1616 when the current command terminates.\n\
1617 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1619 register Lisp_Object buffer
;
1621 register Lisp_Object buf
;
1622 buf
= Fget_buffer (buffer
);
1625 if (NILP (XBUFFER (buf
)->name
))
1626 error ("Selecting deleted buffer");
1627 set_buffer_internal (XBUFFER (buf
));
1631 /* Set the current buffer to BUFFER provided it is alive. */
1634 set_buffer_if_live (buffer
)
1637 if (! NILP (XBUFFER (buffer
)->name
))
1638 Fset_buffer (buffer
);
1642 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1643 Sbarf_if_buffer_read_only
, 0, 0, 0,
1644 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1647 if (!NILP (current_buffer
->read_only
)
1648 && NILP (Vinhibit_read_only
))
1649 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1653 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1654 "Put BUFFER at the end of the list of all buffers.\n\
1655 There it is the least likely candidate for `other-buffer' to return;\n\
1656 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1657 If BUFFER is nil or omitted, bury the current buffer.\n\
1658 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1659 selected window if it is displayed there.")
1661 register Lisp_Object buffer
;
1663 /* Figure out what buffer we're going to bury. */
1666 XSETBUFFER (buffer
, current_buffer
);
1668 /* If we're burying the current buffer, unshow it. */
1669 Fswitch_to_buffer (Fother_buffer (buffer
, Qnil
, Qnil
), Qnil
);
1675 buf1
= Fget_buffer (buffer
);
1681 /* Move buffer to the end of the buffer list. */
1683 register Lisp_Object aelt
, link
;
1685 aelt
= Frassq (buffer
, Vbuffer_alist
);
1686 link
= Fmemq (aelt
, Vbuffer_alist
);
1687 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1688 XCONS (link
)->cdr
= Qnil
;
1689 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1692 frames_bury_buffer (buffer
);
1697 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1698 "Delete the entire contents of the current buffer.\n\
1699 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1700 so the buffer is truly empty after this.")
1707 current_buffer
->last_window_start
= 1;
1708 /* Prevent warnings, or suspension of auto saving, that would happen
1709 if future size is less than past size. Use of erase-buffer
1710 implies that the future text is not really related to the past text. */
1711 XSETFASTINT (current_buffer
->save_length
, 0);
1716 validate_region (b
, e
)
1717 register Lisp_Object
*b
, *e
;
1719 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1720 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1722 if (XINT (*b
) > XINT (*e
))
1725 tem
= *b
; *b
= *e
; *e
= tem
;
1728 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1729 && XINT (*e
) <= ZV
))
1730 args_out_of_range (*b
, *e
);
1733 /* Advance BYTE_POS up to a character boundary
1734 and return the adjusted position. */
1737 advance_to_char_boundary (byte_pos
)
1742 if (byte_pos
== BEG
)
1743 /* Beginning of buffer is always a character boundary. */
1746 c
= FETCH_BYTE (byte_pos
);
1747 if (! CHAR_HEAD_P (c
))
1749 /* We should advance BYTE_POS only when C is a constituent of a
1750 multibyte sequence. */
1753 /* If C is a constituent of a multibyte sequence, BYTE_POS was
1754 surely advance to the correct character boundary. If C is
1755 not, BYTE_POS was unchanged. */
1761 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte
, Sset_buffer_multibyte
,
1763 "Set the multibyte flag of the current buffer to FLAG.\n\
1764 If FLAG is t, this makes the buffer a multibyte buffer.\n\
1765 If FLAG is nil, this makes the buffer a single-byte buffer.\n\
1766 The buffer contents remain unchanged as a sequence of bytes\n\
1767 but the contents viewed as characters do change.")
1771 Lisp_Object tail
, markers
;
1772 struct buffer
*other
;
1774 if (current_buffer
->base_buffer
)
1775 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
1777 /* Do nothing if nothing actually changes. */
1778 if (NILP (flag
) == NILP (current_buffer
->enable_multibyte_characters
))
1781 /* It would be better to update the list,
1782 but this is good enough for now. */
1783 if (! EQ (current_buffer
->undo_list
, Qt
))
1784 current_buffer
->undo_list
= Qnil
;
1786 /* If the cached position is for this buffer, clear it out. */
1787 clear_charpos_cache (current_buffer
);
1791 /* Do this first, so it can use CHAR_TO_BYTE
1792 to calculate the old correspondences. */
1793 set_intervals_multibyte (0);
1795 current_buffer
->enable_multibyte_characters
= Qnil
;
1801 TEMP_SET_PT_BOTH (PT_BYTE
, PT_BYTE
);
1803 tail
= BUF_MARKERS (current_buffer
);
1804 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1806 XMARKER (tail
)->charpos
= XMARKER (tail
)->bytepos
;
1807 tail
= XMARKER (tail
)->chain
;
1812 /* Be sure not to have a multibyte sequence striding over the GAP.
1813 Ex: We change this: "...abc\201\241\241 _GAP_ \241\241\241..."
1814 to: "...abc _GAP_ \201\241\241\241\241\241..." */
1816 if (GPT_BYTE
> 1 && GPT_BYTE
< Z_BYTE
1817 && ! CHAR_HEAD_P (*(GAP_END_ADDR
)))
1819 unsigned char *p
= GPT_ADDR
- 1;
1821 while (! CHAR_HEAD_P (*p
) && p
> BEG_ADDR
) p
--;
1822 if (BASE_LEADING_CODE_P (*p
))
1824 int new_gpt
= GPT_BYTE
- (GPT_ADDR
- p
);
1826 move_gap_both (new_gpt
, new_gpt
);
1830 /* Do this first, so that chars_in_text asks the right question.
1831 set_intervals_multibyte needs it too. */
1832 current_buffer
->enable_multibyte_characters
= Qt
;
1834 GPT_BYTE
= advance_to_char_boundary (GPT_BYTE
);
1835 GPT
= chars_in_text (BEG_ADDR
, GPT_BYTE
- BEG_BYTE
) + BEG
;
1837 Z
= chars_in_text (GAP_END_ADDR
, Z_BYTE
- GPT_BYTE
) + GPT
;
1839 BEGV_BYTE
= advance_to_char_boundary (BEGV_BYTE
);
1840 if (BEGV_BYTE
> GPT_BYTE
)
1841 BEGV
= chars_in_text (GAP_END_ADDR
, BEGV_BYTE
- GPT_BYTE
) + GPT
;
1843 BEGV
= chars_in_text (BEG_ADDR
, BEGV_BYTE
- BEG_BYTE
) + BEG
;
1845 ZV_BYTE
= advance_to_char_boundary (ZV_BYTE
);
1846 if (ZV_BYTE
> GPT_BYTE
)
1847 ZV
= chars_in_text (GAP_END_ADDR
, ZV_BYTE
- GPT_BYTE
) + GPT
;
1849 ZV
= chars_in_text (BEG_ADDR
, ZV_BYTE
- BEG_BYTE
) + BEG
;
1852 int pt_byte
= advance_to_char_boundary (PT_BYTE
);
1855 if (pt_byte
> GPT_BYTE
)
1856 pt
= chars_in_text (GAP_END_ADDR
, pt_byte
- GPT_BYTE
) + GPT
;
1858 pt
= chars_in_text (BEG_ADDR
, pt_byte
- BEG_BYTE
) + BEG
;
1859 TEMP_SET_PT_BOTH (pt
, pt_byte
);
1862 tail
= markers
= BUF_MARKERS (current_buffer
);
1864 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
1865 getting confused by the markers that have not yet been updated.
1866 It is also a signal that it should never create a marker. */
1867 BUF_MARKERS (current_buffer
) = Qnil
;
1869 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1871 XMARKER (tail
)->bytepos
1872 = advance_to_char_boundary (XMARKER (tail
)->bytepos
);
1873 XMARKER (tail
)->charpos
= BYTE_TO_CHAR (XMARKER (tail
)->bytepos
);
1875 tail
= XMARKER (tail
)->chain
;
1878 /* Make sure no markers were put on the chain
1879 while the chain value was incorrect. */
1880 if (! EQ (BUF_MARKERS (current_buffer
), Qnil
))
1883 BUF_MARKERS (current_buffer
) = markers
;
1885 /* Do this last, so it can calculate the new correspondences
1886 between chars and bytes. */
1887 set_intervals_multibyte (1);
1890 /* Copy this buffer's new multibyte status
1891 into all of its indirect buffers. */
1892 for (other
= all_buffers
; other
; other
= other
->next
)
1893 if (other
->base_buffer
== current_buffer
&& !NILP (other
->name
))
1894 other
->enable_multibyte_characters
1895 = current_buffer
->enable_multibyte_characters
;
1900 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1902 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1903 Most local variable bindings are eliminated so that the default values\n\
1904 become effective once more. Also, the syntax table is set from\n\
1905 `standard-syntax-table', the local keymap is set to nil,\n\
1906 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1907 This function also forces redisplay of the mode line.\n\
1909 Every function to select a new major mode starts by\n\
1910 calling this function.\n\n\
1911 As a special exception, local variables whose names have\n\
1912 a non-nil `permanent-local' property are not eliminated by this function.\n\
1914 The first thing this function does is run\n\
1915 the normal hook `change-major-mode-hook'.")
1918 register Lisp_Object alist
, sym
, tem
;
1921 if (!NILP (Vrun_hooks
))
1922 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1923 oalist
= current_buffer
->local_var_alist
;
1925 /* Make sure none of the bindings in oalist
1926 remain swapped in, in their symbols. */
1928 swap_out_buffer_local_variables (current_buffer
);
1930 /* Actually eliminate all local bindings of this buffer. */
1932 reset_buffer_local_variables (current_buffer
, 0);
1934 /* Redisplay mode lines; we are changing major mode. */
1936 update_mode_lines
++;
1938 /* Any which are supposed to be permanent,
1939 make local again, with the same values they had. */
1941 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1943 sym
= XCONS (XCONS (alist
)->car
)->car
;
1944 tem
= Fget (sym
, Qpermanent_local
);
1947 Fmake_local_variable (sym
);
1948 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1952 /* Force mode-line redisplay. Useful here because all major mode
1953 commands call this function. */
1954 update_mode_lines
++;
1959 /* Make sure no local variables remain set up with buffer B
1960 for their current values. */
1963 swap_out_buffer_local_variables (b
)
1966 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1968 XSETBUFFER (buffer
, b
);
1969 oalist
= b
->local_var_alist
;
1971 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1973 sym
= XCONS (XCONS (alist
)->car
)->car
;
1975 /* Need not do anything if some other buffer's binding is now encached. */
1976 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
;
1977 if (XBUFFER (tem
) == current_buffer
)
1979 /* Symbol is set up for this buffer's old local value.
1980 Set it up for the current buffer with the default value. */
1982 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
;
1983 /* Store the symbol's current value into the alist entry
1984 it is currently set up for. This is so that, if the
1985 local is marked permanent, and we make it local again
1986 later in Fkill_all_local_variables, we don't lose the value. */
1987 XCONS (XCONS (tem
)->car
)->cdr
1988 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
);
1989 /* Switch to the symbol's default-value alist entry. */
1990 XCONS (tem
)->car
= tem
;
1991 /* Mark it as current for buffer B. */
1992 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
= buffer
;
1993 /* Store the current value into any forwarding in the symbol. */
1994 store_symval_forwarding (sym
,
1995 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
,
2001 /* Find all the overlays in the current buffer that contain position POS.
2002 Return the number found, and store them in a vector in *VEC_PTR.
2003 Store in *LEN_PTR the size allocated for the vector.
2004 Store in *NEXT_PTR the next position after POS where an overlay starts,
2005 or ZV if there are no more overlays.
2006 Store in *PREV_PTR the previous position before POS where an overlay ends,
2007 or where an overlay starts which ends at or after POS;
2008 or BEGV if there are no such overlays.
2009 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2011 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2012 when this function is called.
2014 If EXTEND is non-zero, we make the vector bigger if necessary.
2015 If EXTEND is zero, we never extend the vector,
2016 and we store only as many overlays as will fit.
2017 But we still return the total number of overlays. */
2020 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2023 Lisp_Object
**vec_ptr
;
2028 Lisp_Object tail
, overlay
, start
, end
;
2031 Lisp_Object
*vec
= *vec_ptr
;
2034 int inhibit_storing
= 0;
2036 for (tail
= current_buffer
->overlays_before
;
2038 tail
= XCONS (tail
)->cdr
)
2040 int startpos
, endpos
;
2042 overlay
= XCONS (tail
)->car
;
2044 start
= OVERLAY_START (overlay
);
2045 end
= OVERLAY_END (overlay
);
2046 endpos
= OVERLAY_POSITION (end
);
2053 startpos
= OVERLAY_POSITION (start
);
2054 /* This one ends at or after POS
2055 so its start counts for PREV_PTR if it's before POS. */
2056 if (prev
< startpos
&& startpos
< pos
)
2060 if (startpos
<= pos
)
2064 /* The supplied vector is full.
2065 Either make it bigger, or don't store any more in it. */
2068 /* Make it work with an initial len == 0. */
2073 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2077 inhibit_storing
= 1;
2080 if (!inhibit_storing
)
2082 /* Keep counting overlays even if we can't return them all. */
2085 else if (startpos
< next
)
2089 for (tail
= current_buffer
->overlays_after
;
2091 tail
= XCONS (tail
)->cdr
)
2093 int startpos
, endpos
;
2095 overlay
= XCONS (tail
)->car
;
2097 start
= OVERLAY_START (overlay
);
2098 end
= OVERLAY_END (overlay
);
2099 startpos
= OVERLAY_POSITION (start
);
2102 if (startpos
< next
)
2106 endpos
= OVERLAY_POSITION (end
);
2113 *len_ptr
= len
*= 2;
2116 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2120 inhibit_storing
= 1;
2123 if (!inhibit_storing
)
2127 if (startpos
< pos
&& startpos
> prev
)
2130 else if (endpos
< pos
&& endpos
> prev
)
2132 else if (endpos
== pos
&& startpos
> prev
)
2143 /* Find all the overlays in the current buffer that overlap the range BEG-END
2144 or are empty at BEG.
2146 Return the number found, and store them in a vector in *VEC_PTR.
2147 Store in *LEN_PTR the size allocated for the vector.
2148 Store in *NEXT_PTR the next position after POS where an overlay starts,
2149 or ZV if there are no more overlays.
2150 Store in *PREV_PTR the previous position before POS where an overlay ends,
2151 or BEGV if there are no previous overlays.
2152 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2154 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2155 when this function is called.
2157 If EXTEND is non-zero, we make the vector bigger if necessary.
2158 If EXTEND is zero, we never extend the vector,
2159 and we store only as many overlays as will fit.
2160 But we still return the total number of overlays. */
2163 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2166 Lisp_Object
**vec_ptr
;
2171 Lisp_Object tail
, overlay
, ostart
, oend
;
2174 Lisp_Object
*vec
= *vec_ptr
;
2177 int inhibit_storing
= 0;
2179 for (tail
= current_buffer
->overlays_before
;
2181 tail
= XCONS (tail
)->cdr
)
2183 int startpos
, endpos
;
2185 overlay
= XCONS (tail
)->car
;
2187 ostart
= OVERLAY_START (overlay
);
2188 oend
= OVERLAY_END (overlay
);
2189 endpos
= OVERLAY_POSITION (oend
);
2196 startpos
= OVERLAY_POSITION (ostart
);
2197 /* Count an interval if it either overlaps the range
2198 or is empty at the start of the range. */
2199 if ((beg
< endpos
&& startpos
< end
)
2200 || (startpos
== endpos
&& beg
== endpos
))
2204 /* The supplied vector is full.
2205 Either make it bigger, or don't store any more in it. */
2208 *len_ptr
= len
*= 2;
2209 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2213 inhibit_storing
= 1;
2216 if (!inhibit_storing
)
2218 /* Keep counting overlays even if we can't return them all. */
2221 else if (startpos
< next
)
2225 for (tail
= current_buffer
->overlays_after
;
2227 tail
= XCONS (tail
)->cdr
)
2229 int startpos
, endpos
;
2231 overlay
= XCONS (tail
)->car
;
2233 ostart
= OVERLAY_START (overlay
);
2234 oend
= OVERLAY_END (overlay
);
2235 startpos
= OVERLAY_POSITION (ostart
);
2238 if (startpos
< next
)
2242 endpos
= OVERLAY_POSITION (oend
);
2243 /* Count an interval if it either overlaps the range
2244 or is empty at the start of the range. */
2245 if ((beg
< endpos
&& startpos
< end
)
2246 || (startpos
== endpos
&& beg
== endpos
))
2252 *len_ptr
= len
*= 2;
2253 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2257 inhibit_storing
= 1;
2260 if (!inhibit_storing
)
2264 else if (endpos
< beg
&& endpos
> prev
)
2275 /* Fast function to just test if we're at an overlay boundary. */
2277 overlay_touches_p (pos
)
2280 Lisp_Object tail
, overlay
;
2282 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
2283 tail
= XCONS (tail
)->cdr
)
2287 overlay
= XCONS (tail
)->car
;
2288 if (!GC_OVERLAYP (overlay
))
2291 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2294 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
2298 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
2299 tail
= XCONS (tail
)->cdr
)
2303 overlay
= XCONS (tail
)->car
;
2304 if (!GC_OVERLAYP (overlay
))
2307 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2310 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
2318 Lisp_Object overlay
;
2324 compare_overlays (v1
, v2
)
2325 const void *v1
, *v2
;
2327 const struct sortvec
*s1
= (const struct sortvec
*) v1
;
2328 const struct sortvec
*s2
= (const struct sortvec
*) v2
;
2329 if (s1
->priority
!= s2
->priority
)
2330 return s1
->priority
- s2
->priority
;
2331 if (s1
->beg
!= s2
->beg
)
2332 return s1
->beg
- s2
->beg
;
2333 if (s1
->end
!= s2
->end
)
2334 return s2
->end
- s1
->end
;
2338 /* Sort an array of overlays by priority. The array is modified in place.
2339 The return value is the new size; this may be smaller than the original
2340 size if some of the overlays were invalid or were window-specific. */
2342 sort_overlays (overlay_vec
, noverlays
, w
)
2343 Lisp_Object
*overlay_vec
;
2348 struct sortvec
*sortvec
;
2349 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
2351 /* Put the valid and relevant overlays into sortvec. */
2353 for (i
= 0, j
= 0; i
< noverlays
; i
++)
2356 Lisp_Object overlay
;
2358 overlay
= overlay_vec
[i
];
2359 if (OVERLAY_VALID (overlay
)
2360 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
2361 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
2363 /* If we're interested in a specific window, then ignore
2364 overlays that are limited to some other window. */
2369 window
= Foverlay_get (overlay
, Qwindow
);
2370 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2374 /* This overlay is good and counts: put it into sortvec. */
2375 sortvec
[j
].overlay
= overlay
;
2376 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2377 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2378 tem
= Foverlay_get (overlay
, Qpriority
);
2380 sortvec
[j
].priority
= XINT (tem
);
2382 sortvec
[j
].priority
= 0;
2388 /* Sort the overlays into the proper order: increasing priority. */
2391 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
2393 for (i
= 0; i
< noverlays
; i
++)
2394 overlay_vec
[i
] = sortvec
[i
].overlay
;
2400 Lisp_Object string
, string2
;
2407 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
2408 int size
; /* Allocated length of that array. */
2409 int used
; /* How much of the array is currently in use. */
2410 int bytes
; /* Total length of the strings in buf. */
2413 /* Buffers for storing information about the overlays touching a given
2414 position. These could be automatic variables in overlay_strings, but
2415 it's more efficient to hold onto the memory instead of repeatedly
2416 allocating and freeing it. */
2417 static struct sortstrlist overlay_heads
, overlay_tails
;
2418 static unsigned char *overlay_str_buf
;
2420 /* Allocated length of overlay_str_buf. */
2421 static int overlay_str_len
;
2423 /* A comparison function suitable for passing to qsort. */
2425 cmp_for_strings (as1
, as2
)
2428 struct sortstr
*s1
= (struct sortstr
*)as1
;
2429 struct sortstr
*s2
= (struct sortstr
*)as2
;
2430 if (s1
->size
!= s2
->size
)
2431 return s2
->size
- s1
->size
;
2432 if (s1
->priority
!= s2
->priority
)
2433 return s1
->priority
- s2
->priority
;
2438 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2439 struct sortstrlist
*ssl
;
2440 Lisp_Object str
, str2
, pri
;
2445 if (ssl
->used
== ssl
->size
)
2451 ssl
->buf
= ((struct sortstr
*)
2452 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2454 ssl
->buf
[ssl
->used
].string
= str
;
2455 ssl
->buf
[ssl
->used
].string2
= str2
;
2456 ssl
->buf
[ssl
->used
].size
= size
;
2457 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2460 if (NILP (current_buffer
->enable_multibyte_characters
))
2461 nbytes
= XSTRING (str
)->size
;
2462 else if (! STRING_MULTIBYTE (str
))
2463 nbytes
= count_size_as_multibyte (XSTRING (str
)->data
,
2464 STRING_BYTES (XSTRING (str
)));
2466 nbytes
= STRING_BYTES (XSTRING (str
));
2468 ssl
->bytes
+= nbytes
;
2472 if (NILP (current_buffer
->enable_multibyte_characters
))
2473 nbytes
= XSTRING (str2
)->size
;
2474 else if (! STRING_MULTIBYTE (str2
))
2475 nbytes
= count_size_as_multibyte (XSTRING (str2
)->data
,
2476 STRING_BYTES (XSTRING (str2
)));
2478 nbytes
= STRING_BYTES (XSTRING (str2
));
2480 ssl
->bytes
+= nbytes
;
2484 /* Return the concatenation of the strings associated with overlays that
2485 begin or end at POS, ignoring overlays that are specific to a window
2486 other than W. The strings are concatenated in the appropriate order:
2487 shorter overlays nest inside longer ones, and higher priority inside
2488 lower. Normally all of the after-strings come first, but zero-sized
2489 overlays have their after-strings ride along with the before-strings
2490 because it would look strange to print them inside-out.
2492 Returns the string length, and stores the contents indirectly through
2493 PSTR, if that variable is non-null. The string may be overwritten by
2494 subsequent calls. */
2497 overlay_strings (pos
, w
, pstr
)
2500 unsigned char **pstr
;
2502 Lisp_Object ov
, overlay
, window
, str
;
2503 int startpos
, endpos
;
2504 int multibyte
= ! NILP (current_buffer
->enable_multibyte_characters
);
2506 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2507 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2508 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2510 overlay
= XCONS (ov
)->car
;
2511 if (!OVERLAYP (overlay
))
2514 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2515 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2518 if (endpos
!= pos
&& startpos
!= pos
)
2520 window
= Foverlay_get (overlay
, Qwindow
);
2521 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2524 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2525 record_overlay_string (&overlay_heads
, str
,
2527 ? Foverlay_get (overlay
, Qafter_string
)
2529 Foverlay_get (overlay
, Qpriority
),
2531 else if (endpos
== pos
2532 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2533 record_overlay_string (&overlay_tails
, str
, Qnil
,
2534 Foverlay_get (overlay
, Qpriority
),
2537 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2539 overlay
= XCONS (ov
)->car
;
2540 if (!OVERLAYP (overlay
))
2543 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2544 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2547 if (endpos
!= pos
&& startpos
!= pos
)
2549 window
= Foverlay_get (overlay
, Qwindow
);
2550 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2553 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2554 record_overlay_string (&overlay_heads
, str
,
2556 ? Foverlay_get (overlay
, Qafter_string
)
2558 Foverlay_get (overlay
, Qpriority
),
2560 else if (endpos
== pos
2561 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2562 record_overlay_string (&overlay_tails
, str
, Qnil
,
2563 Foverlay_get (overlay
, Qpriority
),
2566 if (overlay_tails
.used
> 1)
2567 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2569 if (overlay_heads
.used
> 1)
2570 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2572 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2577 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2579 if (total
> overlay_str_len
)
2581 overlay_str_len
= total
;
2582 overlay_str_buf
= (unsigned char *)xrealloc (overlay_str_buf
,
2585 p
= overlay_str_buf
;
2586 for (i
= overlay_tails
.used
; --i
>= 0;)
2589 tem
= overlay_tails
.buf
[i
].string
;
2590 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2591 STRING_BYTES (XSTRING (tem
)),
2592 STRING_MULTIBYTE (tem
), multibyte
);
2595 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2598 tem
= overlay_heads
.buf
[i
].string
;
2599 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2600 STRING_BYTES (XSTRING (tem
)),
2601 STRING_MULTIBYTE (tem
), multibyte
);
2603 tem
= overlay_heads
.buf
[i
].string2
;
2606 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2607 STRING_BYTES (XSTRING (tem
)),
2608 STRING_MULTIBYTE (tem
), multibyte
);
2612 if (p
!= overlay_str_buf
+ total
)
2615 *pstr
= overlay_str_buf
;
2621 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2624 recenter_overlay_lists (buf
, pos
)
2628 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2630 /* See if anything in overlays_before should move to overlays_after. */
2632 /* We don't strictly need prev in this loop; it should always be nil.
2633 But we use it for symmetry and in case that should cease to be true
2634 with some future change. */
2636 for (tail
= buf
->overlays_before
;
2638 prev
= tail
, tail
= next
)
2640 next
= XCONS (tail
)->cdr
;
2641 overlay
= XCONS (tail
)->car
;
2643 /* If the overlay is not valid, get rid of it. */
2644 if (!OVERLAY_VALID (overlay
))
2649 /* Splice the cons cell TAIL out of overlays_before. */
2651 XCONS (prev
)->cdr
= next
;
2653 buf
->overlays_before
= next
;
2659 beg
= OVERLAY_START (overlay
);
2660 end
= OVERLAY_END (overlay
);
2662 if (OVERLAY_POSITION (end
) > pos
)
2664 /* OVERLAY needs to be moved. */
2665 int where
= OVERLAY_POSITION (beg
);
2666 Lisp_Object other
, other_prev
;
2668 /* Splice the cons cell TAIL out of overlays_before. */
2670 XCONS (prev
)->cdr
= next
;
2672 buf
->overlays_before
= next
;
2674 /* Search thru overlays_after for where to put it. */
2676 for (other
= buf
->overlays_after
;
2678 other_prev
= other
, other
= XCONS (other
)->cdr
)
2680 Lisp_Object otherbeg
, otheroverlay
;
2682 otheroverlay
= XCONS (other
)->car
;
2683 if (! OVERLAY_VALID (otheroverlay
))
2686 otherbeg
= OVERLAY_START (otheroverlay
);
2687 if (OVERLAY_POSITION (otherbeg
) >= where
)
2691 /* Add TAIL to overlays_after before OTHER. */
2692 XCONS (tail
)->cdr
= other
;
2693 if (!NILP (other_prev
))
2694 XCONS (other_prev
)->cdr
= tail
;
2696 buf
->overlays_after
= tail
;
2700 /* We've reached the things that should stay in overlays_before.
2701 All the rest of overlays_before must end even earlier,
2706 /* See if anything in overlays_after should be in overlays_before. */
2708 for (tail
= buf
->overlays_after
;
2710 prev
= tail
, tail
= next
)
2712 next
= XCONS (tail
)->cdr
;
2713 overlay
= XCONS (tail
)->car
;
2715 /* If the overlay is not valid, get rid of it. */
2716 if (!OVERLAY_VALID (overlay
))
2721 /* Splice the cons cell TAIL out of overlays_after. */
2723 XCONS (prev
)->cdr
= next
;
2725 buf
->overlays_after
= next
;
2731 beg
= OVERLAY_START (overlay
);
2732 end
= OVERLAY_END (overlay
);
2734 /* Stop looking, when we know that nothing further
2735 can possibly end before POS. */
2736 if (OVERLAY_POSITION (beg
) > pos
)
2739 if (OVERLAY_POSITION (end
) <= pos
)
2741 /* OVERLAY needs to be moved. */
2742 int where
= OVERLAY_POSITION (end
);
2743 Lisp_Object other
, other_prev
;
2745 /* Splice the cons cell TAIL out of overlays_after. */
2747 XCONS (prev
)->cdr
= next
;
2749 buf
->overlays_after
= next
;
2751 /* Search thru overlays_before for where to put it. */
2753 for (other
= buf
->overlays_before
;
2755 other_prev
= other
, other
= XCONS (other
)->cdr
)
2757 Lisp_Object otherend
, otheroverlay
;
2759 otheroverlay
= XCONS (other
)->car
;
2760 if (! OVERLAY_VALID (otheroverlay
))
2763 otherend
= OVERLAY_END (otheroverlay
);
2764 if (OVERLAY_POSITION (otherend
) <= where
)
2768 /* Add TAIL to overlays_before before OTHER. */
2769 XCONS (tail
)->cdr
= other
;
2770 if (!NILP (other_prev
))
2771 XCONS (other_prev
)->cdr
= tail
;
2773 buf
->overlays_before
= tail
;
2778 XSETFASTINT (buf
->overlay_center
, pos
);
2782 adjust_overlays_for_insert (pos
, length
)
2786 /* After an insertion, the lists are still sorted properly,
2787 but we may need to update the value of the overlay center. */
2788 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2789 XSETFASTINT (current_buffer
->overlay_center
,
2790 XFASTINT (current_buffer
->overlay_center
) + length
);
2794 adjust_overlays_for_delete (pos
, length
)
2798 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2799 /* The deletion was to our right. No change needed; the before- and
2800 after-lists are still consistent. */
2802 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2803 /* The deletion was to our left. We need to adjust the center value
2804 to account for the change in position, but the lists are consistent
2805 given the new value. */
2806 XSETFASTINT (current_buffer
->overlay_center
,
2807 XFASTINT (current_buffer
->overlay_center
) - length
);
2809 /* We're right in the middle. There might be things on the after-list
2810 that now belong on the before-list. Recentering will move them,
2811 and also update the center point. */
2812 recenter_overlay_lists (current_buffer
, pos
);
2815 /* Fix up overlays that were garbled as a result of permuting markers
2816 in the range START through END. Any overlay with at least one
2817 endpoint in this range will need to be unlinked from the overlay
2818 list and reinserted in its proper place.
2819 Such an overlay might even have negative size at this point.
2820 If so, we'll reverse the endpoints. Can you think of anything
2821 better to do in this situation? */
2823 fix_overlays_in_range (start
, end
)
2824 register int start
, end
;
2826 Lisp_Object overlay
;
2827 Lisp_Object before_list
, after_list
;
2828 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2829 int startpos
, endpos
;
2831 /* This algorithm shifts links around instead of consing and GCing.
2832 The loop invariant is that before_list (resp. after_list) is a
2833 well-formed list except that its last element, the one that
2834 *pbefore (resp. *pafter) points to, is still uninitialized.
2835 So it's not a bug that before_list isn't initialized, although
2836 it may look strange. */
2837 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2839 overlay
= XCONS (*ptail
)->car
;
2840 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2843 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2845 || (startpos
>= start
&& startpos
< end
))
2847 /* If the overlay is backwards, fix that now. */
2848 if (startpos
> endpos
)
2851 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2853 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2855 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2857 /* Add it to the end of the wrong list. Later on,
2858 recenter_overlay_lists will move it to the right place. */
2859 if (endpos
< XINT (current_buffer
->overlay_center
))
2862 pafter
= &XCONS (*ptail
)->cdr
;
2867 pbefore
= &XCONS (*ptail
)->cdr
;
2869 *ptail
= XCONS (*ptail
)->cdr
;
2872 ptail
= &XCONS (*ptail
)->cdr
;
2874 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2876 overlay
= XCONS (*ptail
)->car
;
2877 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2878 if (startpos
>= end
)
2880 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2881 if (startpos
>= start
2882 || (endpos
>= start
&& endpos
< end
))
2884 if (startpos
> endpos
)
2887 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2889 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2891 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2893 if (endpos
< XINT (current_buffer
->overlay_center
))
2896 pafter
= &XCONS (*ptail
)->cdr
;
2901 pbefore
= &XCONS (*ptail
)->cdr
;
2903 *ptail
= XCONS (*ptail
)->cdr
;
2906 ptail
= &XCONS (*ptail
)->cdr
;
2909 /* Splice the constructed (wrong) lists into the buffer's lists,
2910 and let the recenter function make it sane again. */
2911 *pbefore
= current_buffer
->overlays_before
;
2912 current_buffer
->overlays_before
= before_list
;
2913 recenter_overlay_lists (current_buffer
,
2914 XINT (current_buffer
->overlay_center
));
2916 *pafter
= current_buffer
->overlays_after
;
2917 current_buffer
->overlays_after
= after_list
;
2918 recenter_overlay_lists (current_buffer
,
2919 XINT (current_buffer
->overlay_center
));
2922 /* We have two types of overlay: the one whose ending marker is
2923 after-insertion-marker (this is the usual case) and the one whose
2924 ending marker is before-insertion-marker. When `overlays_before'
2925 contains overlays of the latter type and the former type in this
2926 order and both overlays end at inserting position, inserting a text
2927 increases only the ending marker of the latter type, which results
2928 in incorrect ordering of `overlays_before'.
2930 This function fixes ordering of overlays in the slot
2931 `overlays_before' of the buffer *BP. Before the insertion, `point'
2932 was at PREV, and now is at POS. */
2935 fix_overlays_before (bp
, prev
, pos
)
2939 Lisp_Object
*tailp
= &bp
->overlays_before
;
2940 Lisp_Object
*right_place
;
2943 /* After the insertion, the several overlays may be in incorrect
2944 order. The possibility is that, in the list `overlays_before',
2945 an overlay which ends at POS appears after an overlay which ends
2946 at PREV. Since POS is greater than PREV, we must fix the
2947 ordering of these overlays, by moving overlays ends at POS before
2948 the overlays ends at PREV. */
2950 /* At first, find a place where disordered overlays should be linked
2951 in. It is where an overlay which end before POS exists. (i.e. an
2952 overlay whose ending marker is after-insertion-marker if disorder
2954 while (!NILP (*tailp
)
2955 && ((end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
)))
2957 tailp
= &XCONS (*tailp
)->cdr
;
2959 /* If we don't find such an overlay,
2960 or the found one ends before PREV,
2961 or the found one is the last one in the list,
2962 we don't have to fix anything. */
2965 || NILP (XCONS (*tailp
)->cdr
))
2968 right_place
= tailp
;
2969 tailp
= &XCONS (*tailp
)->cdr
;
2971 /* Now, end position of overlays in the list *TAILP should be before
2972 or equal to PREV. In the loop, an overlay which ends at POS is
2973 moved ahead to the place pointed by RIGHT_PLACE. If we found an
2974 overlay which ends before PREV, the remaining overlays are in
2976 while (!NILP (*tailp
))
2978 end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
));
2981 { /* This overlay is disordered. */
2982 Lisp_Object found
= *tailp
;
2984 /* Unlink the found overlay. */
2985 *tailp
= XCONS (found
)->cdr
;
2986 /* Move an overlay at RIGHT_PLACE to the next of the found one. */
2987 XCONS (found
)->cdr
= *right_place
;
2988 /* Link it into the right place. */
2989 *right_place
= found
;
2991 else if (end
== prev
)
2992 tailp
= &XCONS (*tailp
)->cdr
;
2993 else /* No more disordered overlay. */
2998 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2999 "Return t if OBJECT is an overlay.")
3003 return (OVERLAYP (object
) ? Qt
: Qnil
);
3006 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 5, 0,
3007 "Create a new overlay with range BEG to END in BUFFER.\n\
3008 If omitted, BUFFER defaults to the current buffer.\n\
3009 BEG and END may be integers or markers.\n\
3010 The fourth arg FRONT-ADVANCE, if non-nil, makes the\n\
3011 front delimiter advance when text is inserted there.\n\
3012 The fifth arg REAR-ADVANCE, if non-nil, makes the\n\
3013 rear delimiter advance when text is inserted there.")
3014 (beg
, end
, buffer
, front_advance
, rear_advance
)
3015 Lisp_Object beg
, end
, buffer
;
3016 Lisp_Object front_advance
, rear_advance
;
3018 Lisp_Object overlay
;
3022 XSETBUFFER (buffer
, current_buffer
);
3024 CHECK_BUFFER (buffer
, 2);
3026 && ! EQ (Fmarker_buffer (beg
), buffer
))
3027 error ("Marker points into wrong buffer");
3029 && ! EQ (Fmarker_buffer (end
), buffer
))
3030 error ("Marker points into wrong buffer");
3032 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3033 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3035 if (XINT (beg
) > XINT (end
))
3038 temp
= beg
; beg
= end
; end
= temp
;
3041 b
= XBUFFER (buffer
);
3043 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
3044 end
= Fset_marker (Fmake_marker (), end
, buffer
);
3046 if (!NILP (front_advance
))
3047 XMARKER (beg
)->insertion_type
= 1;
3048 if (!NILP (rear_advance
))
3049 XMARKER (end
)->insertion_type
= 1;
3051 overlay
= allocate_misc ();
3052 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
3053 XOVERLAY (overlay
)->start
= beg
;
3054 XOVERLAY (overlay
)->end
= end
;
3055 XOVERLAY (overlay
)->plist
= Qnil
;
3057 /* Put the new overlay on the wrong list. */
3058 end
= OVERLAY_END (overlay
);
3059 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3060 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3062 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3064 /* This puts it in the right list, and in the right order. */
3065 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3067 /* We don't need to redisplay the region covered by the overlay, because
3068 the overlay has no properties at the moment. */
3073 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3076 modify_overlay (buf
, start
, end
)
3086 start
= end
; end
= temp
;
3089 /* If this is a buffer not in the selected window,
3090 we must do other windows. */
3091 if (buf
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
3092 windows_or_buffers_changed
= 1;
3093 /* If multiple windows show this buffer, we must do other windows. */
3094 else if (buffer_shared
> 1)
3095 windows_or_buffers_changed
= 1;
3097 BUF_COMPUTE_UNCHANGED (buf
, start
, end
);
3099 ++BUF_OVERLAY_MODIFF (buf
);
3103 Lisp_Object
Fdelete_overlay ();
3105 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
3106 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
3107 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
3108 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
3110 (overlay
, beg
, end
, buffer
)
3111 Lisp_Object overlay
, beg
, end
, buffer
;
3113 struct buffer
*b
, *ob
;
3114 Lisp_Object obuffer
;
3115 int count
= specpdl_ptr
- specpdl
;
3117 CHECK_OVERLAY (overlay
, 0);
3119 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3121 XSETBUFFER (buffer
, current_buffer
);
3122 CHECK_BUFFER (buffer
, 3);
3125 && ! EQ (Fmarker_buffer (beg
), buffer
))
3126 error ("Marker points into wrong buffer");
3128 && ! EQ (Fmarker_buffer (end
), buffer
))
3129 error ("Marker points into wrong buffer");
3131 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3132 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3134 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3135 return Fdelete_overlay (overlay
);
3137 if (XINT (beg
) > XINT (end
))
3140 temp
= beg
; beg
= end
; end
= temp
;
3143 specbind (Qinhibit_quit
, Qt
);
3145 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3146 b
= XBUFFER (buffer
);
3147 ob
= XBUFFER (obuffer
);
3149 /* If the overlay has changed buffers, do a thorough redisplay. */
3150 if (!EQ (buffer
, obuffer
))
3152 /* Redisplay where the overlay was. */
3153 if (!NILP (obuffer
))
3158 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3159 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3161 modify_overlay (ob
, o_beg
, o_end
);
3164 /* Redisplay where the overlay is going to be. */
3165 modify_overlay (b
, XINT (beg
), XINT (end
));
3168 /* Redisplay the area the overlay has just left, or just enclosed. */
3172 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3173 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3175 if (o_beg
== XINT (beg
))
3176 modify_overlay (b
, o_end
, XINT (end
));
3177 else if (o_end
== XINT (end
))
3178 modify_overlay (b
, o_beg
, XINT (beg
));
3181 if (XINT (beg
) < o_beg
) o_beg
= XINT (beg
);
3182 if (XINT (end
) > o_end
) o_end
= XINT (end
);
3183 modify_overlay (b
, o_beg
, o_end
);
3187 if (!NILP (obuffer
))
3189 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
3190 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
3193 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
3194 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
3196 /* Put the overlay on the wrong list. */
3197 end
= OVERLAY_END (overlay
);
3198 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3199 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3201 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3203 /* This puts it in the right list, and in the right order. */
3204 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3206 return unbind_to (count
, overlay
);
3209 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
3210 "Delete the overlay OVERLAY from its buffer.")
3212 Lisp_Object overlay
;
3216 int count
= specpdl_ptr
- specpdl
;
3218 CHECK_OVERLAY (overlay
, 0);
3220 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3224 b
= XBUFFER (buffer
);
3226 specbind (Qinhibit_quit
, Qt
);
3228 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
3229 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
3232 marker_position (OVERLAY_START (overlay
)),
3233 marker_position (OVERLAY_END (overlay
)));
3235 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
3236 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
3238 return unbind_to (count
, Qnil
);
3241 /* Overlay dissection functions. */
3243 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
3244 "Return the position at which OVERLAY starts.")
3246 Lisp_Object overlay
;
3248 CHECK_OVERLAY (overlay
, 0);
3250 return (Fmarker_position (OVERLAY_START (overlay
)));
3253 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
3254 "Return the position at which OVERLAY ends.")
3256 Lisp_Object overlay
;
3258 CHECK_OVERLAY (overlay
, 0);
3260 return (Fmarker_position (OVERLAY_END (overlay
)));
3263 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
3264 "Return the buffer OVERLAY belongs to.")
3266 Lisp_Object overlay
;
3268 CHECK_OVERLAY (overlay
, 0);
3270 return Fmarker_buffer (OVERLAY_START (overlay
));
3273 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
3274 "Return a list of the properties on OVERLAY.\n\
3275 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
3278 Lisp_Object overlay
;
3280 CHECK_OVERLAY (overlay
, 0);
3282 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
3286 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
3287 "Return a list of the overlays that contain position POS.")
3292 Lisp_Object
*overlay_vec
;
3296 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3299 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3301 /* Put all the overlays we want in a vector in overlay_vec.
3302 Store the length in len. */
3303 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3304 (int *) 0, (int *) 0);
3306 /* Make a list of them all. */
3307 result
= Flist (noverlays
, overlay_vec
);
3309 xfree (overlay_vec
);
3313 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
3314 "Return a list of the overlays that overlap the region BEG ... END.\n\
3315 Overlap means that at least one character is contained within the overlay\n\
3316 and also contained within the specified region.\n\
3317 Empty overlays are included in the result if they are located at BEG\n\
3318 or between BEG and END.")
3320 Lisp_Object beg
, end
;
3323 Lisp_Object
*overlay_vec
;
3327 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
3328 CHECK_NUMBER_COERCE_MARKER (end
, 0);
3331 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3333 /* Put all the overlays we want in a vector in overlay_vec.
3334 Store the length in len. */
3335 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
3336 (int *) 0, (int *) 0);
3338 /* Make a list of them all. */
3339 result
= Flist (noverlays
, overlay_vec
);
3341 xfree (overlay_vec
);
3345 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
3347 "Return the next position after POS where an overlay starts or ends.\n\
3348 If there are no more overlay boundaries after POS, return (point-max).")
3354 Lisp_Object
*overlay_vec
;
3358 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3361 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3363 /* Put all the overlays we want in a vector in overlay_vec.
3364 Store the length in len.
3365 endpos gets the position where the next overlay starts. */
3366 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3367 &endpos
, (int *) 0);
3369 /* If any of these overlays ends before endpos,
3370 use its ending point instead. */
3371 for (i
= 0; i
< noverlays
; i
++)
3376 oend
= OVERLAY_END (overlay_vec
[i
]);
3377 oendpos
= OVERLAY_POSITION (oend
);
3378 if (oendpos
< endpos
)
3382 xfree (overlay_vec
);
3383 return make_number (endpos
);
3386 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
3387 Sprevious_overlay_change
, 1, 1, 0,
3388 "Return the previous position before POS where an overlay starts or ends.\n\
3389 If there are no more overlay boundaries before POS, return (point-min).")
3395 Lisp_Object
*overlay_vec
;
3398 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3401 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3403 /* At beginning of buffer, we know the answer;
3404 avoid bug subtracting 1 below. */
3405 if (XINT (pos
) == BEGV
)
3408 /* Put all the overlays we want in a vector in overlay_vec.
3409 Store the length in len.
3410 prevpos gets the position of the previous change. */
3411 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3412 (int *) 0, &prevpos
);
3414 xfree (overlay_vec
);
3415 return make_number (prevpos
);
3418 /* These functions are for debugging overlays. */
3420 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
3421 "Return a pair of lists giving all the overlays of the current buffer.\n\
3422 The car has all the overlays before the overlay center;\n\
3423 the cdr has all the overlays after the overlay center.\n\
3424 Recentering overlays moves overlays between these lists.\n\
3425 The lists you get are copies, so that changing them has no effect.\n\
3426 However, the overlays you get are the real objects that the buffer uses.")
3429 Lisp_Object before
, after
;
3430 before
= current_buffer
->overlays_before
;
3432 before
= Fcopy_sequence (before
);
3433 after
= current_buffer
->overlays_after
;
3435 after
= Fcopy_sequence (after
);
3437 return Fcons (before
, after
);
3440 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
3441 "Recenter the overlays of the current buffer around position POS.")
3445 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3447 recenter_overlay_lists (current_buffer
, XINT (pos
));
3451 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
3452 "Get the property of overlay OVERLAY with property name PROP.")
3454 Lisp_Object overlay
, prop
;
3456 Lisp_Object plist
, fallback
;
3458 CHECK_OVERLAY (overlay
, 0);
3462 for (plist
= XOVERLAY (overlay
)->plist
;
3463 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
3464 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
3466 if (EQ (XCONS (plist
)->car
, prop
))
3467 return XCONS (XCONS (plist
)->cdr
)->car
;
3468 else if (EQ (XCONS (plist
)->car
, Qcategory
))
3471 tem
= Fcar (Fcdr (plist
));
3473 fallback
= Fget (tem
, prop
);
3480 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
3481 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
3482 (overlay
, prop
, value
)
3483 Lisp_Object overlay
, prop
, value
;
3485 Lisp_Object tail
, buffer
;
3488 CHECK_OVERLAY (overlay
, 0);
3490 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3492 for (tail
= XOVERLAY (overlay
)->plist
;
3493 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
3494 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
3495 if (EQ (XCONS (tail
)->car
, prop
))
3497 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
3498 XCONS (XCONS (tail
)->cdr
)->car
= value
;
3501 /* It wasn't in the list, so add it to the front. */
3502 changed
= !NILP (value
);
3503 XOVERLAY (overlay
)->plist
3504 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
3506 if (! NILP (buffer
))
3509 modify_overlay (XBUFFER (buffer
),
3510 marker_position (OVERLAY_START (overlay
)),
3511 marker_position (OVERLAY_END (overlay
)));
3512 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
3513 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
3514 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
3515 Fdelete_overlay (overlay
);
3520 /* Subroutine of report_overlay_modification. */
3522 /* Lisp vector holding overlay hook functions to call.
3523 Vector elements come in pairs.
3524 Each even-index element is a list of hook functions.
3525 The following odd-index element is the overlay they came from.
3527 Before the buffer change, we fill in this vector
3528 as we call overlay hook functions.
3529 After the buffer change, we get the functions to call from this vector.
3530 This way we always call the same functions before and after the change. */
3531 static Lisp_Object last_overlay_modification_hooks
;
3533 /* Number of elements actually used in last_overlay_modification_hooks. */
3534 static int last_overlay_modification_hooks_used
;
3536 /* Add one functionlist/overlay pair
3537 to the end of last_overlay_modification_hooks. */
3540 add_overlay_mod_hooklist (functionlist
, overlay
)
3541 Lisp_Object functionlist
, overlay
;
3543 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3545 if (last_overlay_modification_hooks_used
== oldsize
)
3548 old
= last_overlay_modification_hooks
;
3549 last_overlay_modification_hooks
3550 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3551 bcopy (XVECTOR (old
)->contents
,
3552 XVECTOR (last_overlay_modification_hooks
)->contents
,
3553 sizeof (Lisp_Object
) * oldsize
);
3555 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3556 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3559 /* Run the modification-hooks of overlays that include
3560 any part of the text in START to END.
3561 If this change is an insertion, also
3562 run the insert-before-hooks of overlay starting at END,
3563 and the insert-after-hooks of overlay ending at START.
3565 This is called both before and after the modification.
3566 AFTER is nonzero when we call after the modification.
3568 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3569 When AFTER is nonzero, they are the start position,
3570 the position after the inserted new text,
3571 and the length of deleted or replaced old text. */
3574 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3575 Lisp_Object start
, end
;
3577 Lisp_Object arg1
, arg2
, arg3
;
3579 Lisp_Object prop
, overlay
, tail
;
3580 /* 1 if this change is an insertion. */
3581 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3583 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3587 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3591 /* Call the functions recorded in last_overlay_modification_hooks
3592 rather than scanning the overlays again.
3593 First copy the vector contents, in case some of these hooks
3594 do subsequent modification of the buffer. */
3595 int size
= last_overlay_modification_hooks_used
;
3596 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3599 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3600 copy
, size
* sizeof (Lisp_Object
));
3602 gcpro1
.nvars
= size
;
3604 for (i
= 0; i
< size
;)
3606 Lisp_Object prop
, overlay
;
3608 overlay
= copy
[i
++];
3609 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3615 /* We are being called before a change.
3616 Scan the overlays to find the functions to call. */
3617 last_overlay_modification_hooks_used
= 0;
3619 for (tail
= current_buffer
->overlays_before
;
3621 tail
= XCONS (tail
)->cdr
)
3623 int startpos
, endpos
;
3624 Lisp_Object ostart
, oend
;
3626 overlay
= XCONS (tail
)->car
;
3628 ostart
= OVERLAY_START (overlay
);
3629 oend
= OVERLAY_END (overlay
);
3630 endpos
= OVERLAY_POSITION (oend
);
3631 if (XFASTINT (start
) > endpos
)
3633 startpos
= OVERLAY_POSITION (ostart
);
3634 if (insertion
&& (XFASTINT (start
) == startpos
3635 || XFASTINT (end
) == startpos
))
3637 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3640 /* Copy TAIL in case the hook recenters the overlay lists. */
3642 tail
= Fcopy_sequence (tail
);
3644 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3647 if (insertion
&& (XFASTINT (start
) == endpos
3648 || XFASTINT (end
) == endpos
))
3650 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3654 tail
= Fcopy_sequence (tail
);
3656 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3659 /* Test for intersecting intervals. This does the right thing
3660 for both insertion and deletion. */
3661 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3663 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3667 tail
= Fcopy_sequence (tail
);
3669 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3675 for (tail
= current_buffer
->overlays_after
;
3677 tail
= XCONS (tail
)->cdr
)
3679 int startpos
, endpos
;
3680 Lisp_Object ostart
, oend
;
3682 overlay
= XCONS (tail
)->car
;
3684 ostart
= OVERLAY_START (overlay
);
3685 oend
= OVERLAY_END (overlay
);
3686 startpos
= OVERLAY_POSITION (ostart
);
3687 endpos
= OVERLAY_POSITION (oend
);
3688 if (XFASTINT (end
) < startpos
)
3690 if (insertion
&& (XFASTINT (start
) == startpos
3691 || XFASTINT (end
) == startpos
))
3693 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3697 tail
= Fcopy_sequence (tail
);
3699 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3702 if (insertion
&& (XFASTINT (start
) == endpos
3703 || XFASTINT (end
) == endpos
))
3705 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3709 tail
= Fcopy_sequence (tail
);
3711 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3714 /* Test for intersecting intervals. This does the right thing
3715 for both insertion and deletion. */
3716 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3718 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3722 tail
= Fcopy_sequence (tail
);
3724 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3733 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3734 Lisp_Object list
, overlay
;
3736 Lisp_Object arg1
, arg2
, arg3
;
3738 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3740 GCPRO4 (list
, arg1
, arg2
, arg3
);
3742 add_overlay_mod_hooklist (list
, overlay
);
3744 while (!NILP (list
))
3747 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3749 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3755 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3758 evaporate_overlays (pos
)
3761 Lisp_Object tail
, overlay
, hit_list
;
3764 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3765 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3766 tail
= XCONS (tail
)->cdr
)
3769 overlay
= XCONS (tail
)->car
;
3770 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3773 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3774 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3775 hit_list
= Fcons (overlay
, hit_list
);
3778 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3779 tail
= XCONS (tail
)->cdr
)
3782 overlay
= XCONS (tail
)->car
;
3783 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3786 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3787 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3788 hit_list
= Fcons (overlay
, hit_list
);
3790 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3791 Fdelete_overlay (XCONS (hit_list
)->car
);
3794 /* Somebody has tried to store a value with an unacceptable type
3795 in the slot with offset OFFSET. */
3798 buffer_slot_type_mismatch (offset
)
3803 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3804 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3806 case Lisp_Int
: type_name
= "integers"; break;
3807 case Lisp_String
: type_name
= "strings"; break;
3808 case Lisp_Symbol
: type_name
= "symbols"; break;
3814 error ("Only %s should be stored in the buffer-local variable %s",
3815 type_name
, XSYMBOL (sym
)->name
->data
);
3821 buffer_permanent_local_flags
= 0;
3823 /* Make sure all markable slots in buffer_defaults
3824 are initialized reasonably, so mark_buffer won't choke. */
3825 reset_buffer (&buffer_defaults
);
3826 reset_buffer_local_variables (&buffer_defaults
, 1);
3827 reset_buffer (&buffer_local_symbols
);
3828 reset_buffer_local_variables (&buffer_local_symbols
, 1);
3829 /* Prevent GC from getting confused. */
3830 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3831 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3832 #ifdef USE_TEXT_PROPERTIES
3833 BUF_INTERVALS (&buffer_defaults
) = 0;
3834 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3836 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3837 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3839 /* Set up the default values of various buffer slots. */
3840 /* Must do these before making the first buffer! */
3842 /* real setup is done in loaddefs.el */
3843 buffer_defaults
.mode_line_format
= build_string ("%-");
3844 buffer_defaults
.header_line_format
= Qnil
;
3845 buffer_defaults
.abbrev_mode
= Qnil
;
3846 buffer_defaults
.overwrite_mode
= Qnil
;
3847 buffer_defaults
.case_fold_search
= Qt
;
3848 buffer_defaults
.auto_fill_function
= Qnil
;
3849 buffer_defaults
.selective_display
= Qnil
;
3851 buffer_defaults
.selective_display_ellipses
= Qt
;
3853 buffer_defaults
.abbrev_table
= Qnil
;
3854 buffer_defaults
.display_table
= Qnil
;
3855 buffer_defaults
.undo_list
= Qnil
;
3856 buffer_defaults
.mark_active
= Qnil
;
3857 buffer_defaults
.file_format
= Qnil
;
3858 buffer_defaults
.overlays_before
= Qnil
;
3859 buffer_defaults
.overlays_after
= Qnil
;
3860 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3862 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3863 buffer_defaults
.truncate_lines
= Qnil
;
3864 buffer_defaults
.ctl_arrow
= Qt
;
3865 buffer_defaults
.direction_reversed
= Qnil
;
3868 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3870 buffer_defaults
.enable_multibyte_characters
= Qt
;
3871 buffer_defaults
.buffer_file_coding_system
= Qnil
;
3872 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3873 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3874 buffer_defaults
.cache_long_line_scans
= Qnil
;
3875 buffer_defaults
.file_truename
= Qnil
;
3876 XSETFASTINT (buffer_defaults
.display_count
, 0);
3877 buffer_defaults
.indicate_empty_lines
= Qnil
;
3878 buffer_defaults
.scroll_up_aggressively
= Qnil
;
3879 buffer_defaults
.scroll_down_aggressively
= Qnil
;
3880 buffer_defaults
.display_time
= Qnil
;
3882 /* Assign the local-flags to the slots that have default values.
3883 The local flag is a bit that is used in the buffer
3884 to say that it has its own local value for the slot.
3885 The local flag bits are in the local_var_flags slot of the buffer. */
3887 /* Nothing can work if this isn't true */
3888 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3890 /* 0 means not a lisp var, -1 means always local, else mask */
3891 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3892 XSETINT (buffer_local_flags
.filename
, -1);
3893 XSETINT (buffer_local_flags
.directory
, -1);
3894 XSETINT (buffer_local_flags
.backed_up
, -1);
3895 XSETINT (buffer_local_flags
.save_length
, -1);
3896 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3897 XSETINT (buffer_local_flags
.read_only
, -1);
3898 XSETINT (buffer_local_flags
.major_mode
, -1);
3899 XSETINT (buffer_local_flags
.mode_name
, -1);
3900 XSETINT (buffer_local_flags
.undo_list
, -1);
3901 XSETINT (buffer_local_flags
.mark_active
, -1);
3902 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3903 XSETINT (buffer_local_flags
.file_truename
, -1);
3904 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3905 XSETINT (buffer_local_flags
.file_format
, -1);
3906 XSETINT (buffer_local_flags
.display_count
, -1);
3907 XSETINT (buffer_local_flags
.display_time
, -1);
3908 XSETINT (buffer_local_flags
.enable_multibyte_characters
, -1);
3910 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3911 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3912 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3913 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3914 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3915 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3917 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3919 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3920 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3921 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3922 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3923 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3924 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3925 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3927 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3928 /* Make this one a permanent local. */
3929 buffer_permanent_local_flags
|= 0x4000;
3931 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3932 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3933 XSETFASTINT (buffer_local_flags
.category_table
, 0x20000);
3934 XSETFASTINT (buffer_local_flags
.direction_reversed
, 0x40000);
3935 XSETFASTINT (buffer_local_flags
.buffer_file_coding_system
, 0x80000);
3936 /* Make this one a permanent local. */
3937 buffer_permanent_local_flags
|= 0x80000;
3938 XSETFASTINT (buffer_local_flags
.left_margin_width
, 0x100000);
3939 XSETFASTINT (buffer_local_flags
.right_margin_width
, 0x200000);
3940 XSETFASTINT (buffer_local_flags
.indicate_empty_lines
, 0x400000);
3941 XSETFASTINT (buffer_local_flags
.scroll_up_aggressively
, 0x800000);
3942 XSETFASTINT (buffer_local_flags
.scroll_down_aggressively
, 0x1000000);
3943 XSETFASTINT (buffer_local_flags
.header_line_format
, 0x2000000);
3945 Vbuffer_alist
= Qnil
;
3949 QSFundamental
= build_string ("Fundamental");
3951 Qfundamental_mode
= intern ("fundamental-mode");
3952 buffer_defaults
.major_mode
= Qfundamental_mode
;
3954 Qmode_class
= intern ("mode-class");
3956 Qprotected_field
= intern ("protected-field");
3958 Qpermanent_local
= intern ("permanent-local");
3960 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3962 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3964 /* super-magic invisible buffer */
3965 Vbuffer_alist
= Qnil
;
3967 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3969 inhibit_modification_hooks
= 0;
3975 char buf
[MAXPATHLEN
+1];
3977 struct stat dotstat
, pwdstat
;
3981 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3982 if (NILP (buffer_defaults
.enable_multibyte_characters
))
3983 Fset_buffer_multibyte (Qnil
);
3985 /* If PWD is accurate, use it instead of calling getwd. This is faster
3986 when PWD is right, and may avoid a fatal error. */
3987 if ((pwd
= getenv ("PWD")) != 0
3988 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
3989 && stat (pwd
, &pwdstat
) == 0
3990 && stat (".", &dotstat
) == 0
3991 && dotstat
.st_ino
== pwdstat
.st_ino
3992 && dotstat
.st_dev
== pwdstat
.st_dev
3993 && strlen (pwd
) < MAXPATHLEN
)
3996 else if (getcwd (buf
, MAXPATHLEN
+1) == 0)
3997 fatal ("`getcwd' failed: %s\n", strerror (errno
));
3999 else if (getwd (buf
) == 0)
4000 fatal ("`getwd' failed: %s\n", buf
);
4004 /* Maybe this should really use some standard subroutine
4005 whose definition is filename syntax dependent. */
4007 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
4009 buf
[rc
] = DIRECTORY_SEP
;
4012 #endif /* not VMS */
4014 current_buffer
->directory
= build_string (buf
);
4016 /* Add /: to the front of the name
4017 if it would otherwise be treated as magic. */
4018 temp
= Ffind_file_name_handler (current_buffer
->directory
, Qt
);
4020 /* If the default dir is just /, TEMP is non-nil
4021 because of the ange-ftp completion handler.
4022 However, it is not necessary to turn / into /:/.
4023 So avoid doing that. */
4024 && strcmp ("/", XSTRING (current_buffer
->directory
)->data
))
4025 current_buffer
->directory
4026 = concat2 (build_string ("/:"), current_buffer
->directory
);
4028 temp
= get_minibuffer (0);
4029 XBUFFER (temp
)->directory
= current_buffer
->directory
;
4032 /* initialize the buffer routines */
4036 staticpro (&last_overlay_modification_hooks
);
4037 last_overlay_modification_hooks
4038 = Fmake_vector (make_number (10), Qnil
);
4040 staticpro (&Vbuffer_defaults
);
4041 staticpro (&Vbuffer_local_symbols
);
4042 staticpro (&Qfundamental_mode
);
4043 staticpro (&Qmode_class
);
4044 staticpro (&QSFundamental
);
4045 staticpro (&Vbuffer_alist
);
4046 staticpro (&Qprotected_field
);
4047 staticpro (&Qpermanent_local
);
4048 staticpro (&Qkill_buffer_hook
);
4049 Qoverlayp
= intern ("overlayp");
4050 staticpro (&Qoverlayp
);
4051 Qevaporate
= intern ("evaporate");
4052 staticpro (&Qevaporate
);
4053 Qmodification_hooks
= intern ("modification-hooks");
4054 staticpro (&Qmodification_hooks
);
4055 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
4056 staticpro (&Qinsert_in_front_hooks
);
4057 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
4058 staticpro (&Qinsert_behind_hooks
);
4059 Qget_file_buffer
= intern ("get-file-buffer");
4060 staticpro (&Qget_file_buffer
);
4061 Qpriority
= intern ("priority");
4062 staticpro (&Qpriority
);
4063 Qwindow
= intern ("window");
4064 staticpro (&Qwindow
);
4065 Qbefore_string
= intern ("before-string");
4066 staticpro (&Qbefore_string
);
4067 Qafter_string
= intern ("after-string");
4068 staticpro (&Qafter_string
);
4069 Qfirst_change_hook
= intern ("first-change-hook");
4070 staticpro (&Qfirst_change_hook
);
4071 Qbefore_change_functions
= intern ("before-change-functions");
4072 staticpro (&Qbefore_change_functions
);
4073 Qafter_change_functions
= intern ("after-change-functions");
4074 staticpro (&Qafter_change_functions
);
4076 Fput (Qprotected_field
, Qerror_conditions
,
4077 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
4078 Fput (Qprotected_field
, Qerror_message
,
4079 build_string ("Attempt to modify a protected field"));
4081 /* All these use DEFVAR_LISP_NOPRO because the slots in
4082 buffer_defaults will all be marked via Vbuffer_defaults. */
4084 DEFVAR_LISP_NOPRO ("default-mode-line-format",
4085 &buffer_defaults
.mode_line_format
,
4086 "Default value of `mode-line-format' for buffers that don't override it.\n\
4087 This is the same as (default-value 'mode-line-format).");
4089 DEFVAR_LISP_NOPRO ("default-header-line-format",
4090 &buffer_defaults
.header_line_format
,
4091 "Default value of `header-line-format' for buffers that don't override it.\n\
4092 This is the same as (default-value 'header-line-format).");
4094 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
4095 &buffer_defaults
.abbrev_mode
,
4096 "Default value of `abbrev-mode' for buffers that do not override it.\n\
4097 This is the same as (default-value 'abbrev-mode).");
4099 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
4100 &buffer_defaults
.ctl_arrow
,
4101 "Default value of `ctl-arrow' for buffers that do not override it.\n\
4102 This is the same as (default-value 'ctl-arrow).");
4104 DEFVAR_LISP_NOPRO ("default-direction-reversed",
4105 &buffer_defaults
.direction_reversed
,
4106 "Default value of `direction_reversed' for buffers that do not override it.\n\
4107 This is the same as (default-value 'direction-reversed).");
4109 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
4110 &buffer_defaults
.enable_multibyte_characters
,
4111 "*Default value of `enable-multibyte-characters' for buffers not overriding it.\n\
4112 This is the same as (default-value 'enable-multibyte-characters).");
4114 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
4115 &buffer_defaults
.buffer_file_coding_system
,
4116 "Default value of `buffer-file-coding-system' for buffers not overriding it.\n\
4117 This is the same as (default-value 'buffer-file-coding-system).");
4119 DEFVAR_LISP_NOPRO ("default-truncate-lines",
4120 &buffer_defaults
.truncate_lines
,
4121 "Default value of `truncate-lines' for buffers that do not override it.\n\
4122 This is the same as (default-value 'truncate-lines).");
4124 DEFVAR_LISP_NOPRO ("default-fill-column",
4125 &buffer_defaults
.fill_column
,
4126 "Default value of `fill-column' for buffers that do not override it.\n\
4127 This is the same as (default-value 'fill-column).");
4129 DEFVAR_LISP_NOPRO ("default-left-margin",
4130 &buffer_defaults
.left_margin
,
4131 "Default value of `left-margin' for buffers that do not override it.\n\
4132 This is the same as (default-value 'left-margin).");
4134 DEFVAR_LISP_NOPRO ("default-tab-width",
4135 &buffer_defaults
.tab_width
,
4136 "Default value of `tab-width' for buffers that do not override it.\n\
4137 This is the same as (default-value 'tab-width).");
4139 DEFVAR_LISP_NOPRO ("default-case-fold-search",
4140 &buffer_defaults
.case_fold_search
,
4141 "Default value of `case-fold-search' for buffers that don't override it.\n\
4142 This is the same as (default-value 'case-fold-search).");
4145 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
4146 &buffer_defaults
.buffer_file_type
,
4147 "Default file type for buffers that do not override it.\n\
4148 This is the same as (default-value 'buffer-file-type).\n\
4149 The file type is nil for text, t for binary.");
4152 DEFVAR_LISP_NOPRO ("default-left-margin-width",
4153 &buffer_defaults
.left_margin_width
,
4154 "Default value of `left-margin-width' for buffers that don't override it.\n\
4155 This is the same as (default-value 'left-margin-width).");
4157 DEFVAR_LISP_NOPRO ("default-right-margin-width",
4158 &buffer_defaults
.right_margin_width
,
4159 "Default value of `right_margin_width' for buffers that don't override it.\n\
4160 This is the same as (default-value 'right-margin-width).");
4162 DEFVAR_LISP_NOPRO ("default-indicate-empty-lines",
4163 &buffer_defaults
.indicate_empty_lines
,
4164 "Default value of `indicate-empty-lines' for buffers that don't override it.\n\
4165 This is the same as (default-value 'indicate-empty-lines).");
4167 DEFVAR_LISP_NOPRO ("default-scroll-up-aggressively",
4168 &buffer_defaults
.scroll_up_aggressively
,
4169 "Default value of `scroll-up-aggressively' for buffers that\n\
4170 don't override it. This is the same as (default-value\n\
4171 'scroll-up-aggressively).");
4173 DEFVAR_LISP_NOPRO ("default-scroll-down-aggressively",
4174 &buffer_defaults
.scroll_down_aggressively
,
4175 "Default value of `scroll-down-aggressively' for buffers that\n\
4176 don't override it. This is the same as (default-value\n\
4177 'scroll-down-aggressively).");
4179 DEFVAR_PER_BUFFER ("header-line-format",
4180 ¤t_buffer
->header_line_format
,
4182 "Analogous to `mode-line-format', but for a mode line displayed\n\
4183 at the top of windows.");
4185 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
4188 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
4189 But make-docfile finds it!
4190 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
4192 "Template for displaying mode line for current buffer.\n\
4193 Each buffer has its own value of this variable.\n\
4194 Value may be nil, a string, a symbol or a list or cons cell.\n\
4195 A value of nil means don't display a mode line.\n\
4196 For a symbol, its value is used (but it is ignored if t or nil).\n\
4197 A string appearing directly as the value of a symbol is processed verbatim\n\
4198 in that the %-constructs below are not recognized.\n\
4199 For a list whose car is a symbol, the symbol's value is taken,\n\
4200 and if that is non-nil, the cadr of the list is processed recursively.\n\
4201 Otherwise, the caddr of the list (if there is one) is processed.\n\
4202 For a list whose car is a string or list, each element is processed\n\
4203 recursively and the results are effectively concatenated.\n\
4204 For a list whose car is an integer, the cdr of the list is processed\n\
4205 and padded (if the number is positive) or truncated (if negative)\n\
4206 to the width specified by that number.\n\
4207 A string is printed verbatim in the mode line except for %-constructs:\n\
4208 (%-constructs are allowed when the string is the entire mode-line-format\n\
4209 or when it is found in a cons-cell or a list)\n\
4210 %b -- print buffer name. %f -- print visited file name.\n\
4211 %F -- print frame name.\n\
4212 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
4213 % means buffer is read-only and * means it is modified.\n\
4214 For a modified read-only buffer, %* gives % and %+ gives *.\n\
4215 %s -- print process status. %l -- print the current line number.\n\
4216 %c -- print the current column number (this makes editing slower).\n\
4217 To make the column number update correctly in all cases,\n\
4218 `column-number-mode' must be non-nil.\n\
4219 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
4220 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
4221 or print Bottom or All.\n\
4222 %n -- print Narrow if appropriate.\n\
4223 %t -- print T if file is text, B if binary.\n\
4224 %[ -- print one [ for each recursive editing level. %] similar.\n\
4225 %% -- print %. %- -- print infinitely many dashes.\n\
4226 Decimal digits after the % specify field width to which to pad.");
4229 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
4230 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
4231 nil here means use current buffer's major mode.");
4233 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
4234 make_number (Lisp_Symbol
),
4235 "Symbol for current buffer's major mode.");
4237 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
4238 make_number (Lisp_String
),
4239 "Pretty name of current buffer's major mode (a string).");
4241 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
4242 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
4243 Automatically becomes buffer-local when set in any fashion.");
4245 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
4247 "*Non-nil if searches and matches should ignore case.\n\
4248 Automatically becomes buffer-local when set in any fashion.");
4250 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
4251 make_number (Lisp_Int
),
4252 "*Column beyond which automatic line-wrapping should happen.\n\
4253 Automatically becomes buffer-local when set in any fashion.");
4255 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
4256 make_number (Lisp_Int
),
4257 "*Column for the default indent-line-function to indent to.\n\
4258 Linefeed indents to this column in Fundamental mode.\n\
4259 Automatically becomes buffer-local when set in any fashion.");
4261 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
4262 make_number (Lisp_Int
),
4263 "*Distance between tab stops (for display of tab characters), in columns.\n\
4264 Automatically becomes buffer-local when set in any fashion.");
4266 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
4267 "*Non-nil means display control chars with uparrow.\n\
4268 A value of nil means use backslash and octal digits.\n\
4269 Automatically becomes buffer-local when set in any fashion.\n\
4270 This variable does not apply to characters whose display is specified\n\
4271 in the current display table (if there is one).");
4273 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
4274 ¤t_buffer
->enable_multibyte_characters
,
4276 "Non-nil means the buffer contents are regarded as multi-byte characters.\n\
4277 Otherwise they are regarded as unibyte. This affects the display,\n\
4278 file I/O and the behavior of various editing commands.\n\
4280 This variable is buffer-local but you cannot set it directly;\n\
4281 use the function `set-buffer-multibyte' to change a buffer's representation.\n\
4282 Changing its default value with `setq-default' is supported.\n\
4283 See also variable `default-enable-multibyte-characters' and Info node\n\
4284 `(elisp)Text Representations'.");
4286 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
4287 ¤t_buffer
->buffer_file_coding_system
, Qnil
,
4288 "Coding system to be used for encoding the buffer contents on saving.\n\
4289 This variable applies to saving the buffer, and also to `write-region'\n\
4290 and other functions that use `write-region'.\n\
4291 It does not apply to sending output to subprocesses, however.\n\
4293 If this is nil, the buffer is saved without any code conversion\n\
4294 unless some coding system is specified in `file-coding-system-alist'\n\
4295 for the buffer file.\n\
4297 The variable `coding-system-for-write', if non-nil, overrides this variable.\n\
4299 This variable is never applied to a way of decoding\n\
4300 a file while reading it.");
4302 DEFVAR_PER_BUFFER ("direction-reversed", ¤t_buffer
->direction_reversed
,
4304 "*Non-nil means lines in the buffer are displayed right to left.");
4306 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
4307 "*Non-nil means do not display continuation lines;\n\
4308 give each line of text one screen line.\n\
4309 Automatically becomes buffer-local when set in any fashion.\n\
4311 Note that this is overridden by the variable\n\
4312 `truncate-partial-width-windows' if that variable is non-nil\n\
4313 and this buffer is not full-frame width.");
4316 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
4318 "Non-nil if the visited file is a binary file.\n\
4319 This variable is meaningful on MS-DOG and Windows NT.\n\
4320 On those systems, it is automatically local in every buffer.\n\
4321 On other systems, this variable is normally always nil.");
4324 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
4325 make_number (Lisp_String
),
4326 "Name of default directory of current buffer. Should end with slash.\n\
4327 Each buffer has its own value of this variable.");
4329 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
4331 "Function called (if non-nil) to perform auto-fill.\n\
4332 It is called after self-inserting a space or newline.\n\
4333 Each buffer has its own value of this variable.\n\
4334 NOTE: This variable is not a hook;\n\
4335 its value may not be a list of functions.");
4337 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
4338 make_number (Lisp_String
),
4339 "Name of file visited in current buffer, or nil if not visiting a file.\n\
4340 Each buffer has its own value of this variable.");
4342 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
4343 make_number (Lisp_String
),
4344 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
4345 The truename of a file is calculated by `file-truename'\n\
4346 and then abbreviated with `abbreviate-file-name'.\n\
4347 Each buffer has its own value of this variable.");
4349 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
4350 ¤t_buffer
->auto_save_file_name
,
4351 make_number (Lisp_String
),
4352 "Name of file for auto-saving current buffer,\n\
4353 or nil if buffer should not be auto-saved.\n\
4354 Each buffer has its own value of this variable.");
4356 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
4357 "Non-nil if this buffer is read-only.\n\
4358 Each buffer has its own value of this variable.");
4360 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
4361 "Non-nil if this buffer's file has been backed up.\n\
4362 Backing up is done before the first time the file is saved.\n\
4363 Each buffer has its own value of this variable.");
4365 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
4366 make_number (Lisp_Int
),
4367 "Length of current buffer when last read in, saved or auto-saved.\n\
4369 Each buffer has its own value of this variable.");
4371 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
4373 "Non-nil enables selective display:\n\
4374 Integer N as value means display only lines\n\
4375 that start with less than n columns of space.\n\
4376 A value of t means, after a ^M, all the rest of the line is invisible.\n\
4377 Then ^M's in the file are written into files as newlines.\n\n\
4378 Automatically becomes buffer-local when set in any fashion.");
4381 DEFVAR_PER_BUFFER ("selective-display-ellipses",
4382 ¤t_buffer
->selective_display_ellipses
,
4384 "t means display ... on previous line when a line is invisible.\n\
4385 Automatically becomes buffer-local when set in any fashion.");
4388 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
4389 "Non-nil if self-insertion should replace existing text.\n\
4390 The value should be one of `overwrite-mode-textual',\n\
4391 `overwrite-mode-binary', or nil.\n\
4392 If it is `overwrite-mode-textual', self-insertion still\n\
4393 inserts at the end of a line, and inserts when point is before a tab,\n\
4394 until the tab is filled in.\n\
4395 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
4396 Automatically becomes buffer-local when set in any fashion.");
4398 #if 0 /* The doc string is too long for some compilers,
4399 but make-docfile can find it in this comment. */
4400 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4402 "Display table that controls display of the contents of current buffer.\n\
4403 Automatically becomes buffer-local when set in any fashion.\n\
4404 The display table is a char-table created with `make-display-table'.\n\
4405 The ordinary char-table elements control how to display each possible text\n\
4406 character. Each value should be a vector of characters or nil;\n\
4407 nil means display the character in the default fashion.\n\
4408 There are six extra slots to control the display of\n\
4409 the end of a truncated screen line (extra-slot 0, a single character);\n\
4410 the end of a continued line (extra-slot 1, a single character);\n\
4411 the escape character used to display character codes in octal\n\
4412 (extra-slot 2, a single character);\n\
4413 the character used as an arrow for control characters (extra-slot 3,\n\
4414 a single character);\n\
4415 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
4416 a vector of characters);\n\
4417 the character used to draw the border between side-by-side windows\n\
4418 (extra-slot 5, a single character).\n\
4419 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
4420 If this variable is nil, the value of `standard-display-table' is used.\n\
4421 Each window can have its own, overriding display table.");
4423 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4426 DEFVAR_PER_BUFFER ("left-margin-width", ¤t_buffer
->left_margin_width
,
4428 "*Width of left marginal area for display of a buffer.\n\
4429 Automatically becomes buffer-local when set in any fashion.\n\
4430 A value of nil means no marginal area.");
4432 DEFVAR_PER_BUFFER ("right-margin-width", ¤t_buffer
->right_margin_width
,
4434 "*Width of right marginal area for display of a buffer.\n\
4435 Automatically becomes buffer-local when set in any fashion.\n\
4436 A value of nil means no marginal area.");
4438 DEFVAR_PER_BUFFER ("indicate-empty-lines",
4439 ¤t_buffer
->indicate_empty_lines
, Qnil
,
4440 "*Non-nil means visually indicate lines not displaying text.\n\
4441 Automatically becomes buffer-local when set in any fashion.\n");
4443 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
4444 ¤t_buffer
->scroll_up_aggressively
, Qnil
,
4445 "*If a number, scroll display up aggressively.\n\
4446 If scrolling a window because point is above the window start, choose\n\
4447 a new window start so that point ends up that fraction of the window's\n\
4448 height from the bottom of the window.\n\
4449 Automatically becomes buffer-local when set in any fashion.");
4451 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
4452 ¤t_buffer
->scroll_down_aggressively
, Qnil
,
4453 "*If a number, scroll display down aggressively.\n\
4454 If scrolling a window because point is below the window end, choose\n\
4455 a new window start so that point ends up that fraction of the window's\n\
4456 height from the top of the window.\n\
4457 Automatically becomes buffer-local when set in any fashion.");
4459 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
4462 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
4463 "If non-nil, a function to call before each text change (obsolete).\n\
4464 Two arguments are passed to the function: the positions of\n\
4465 the beginning and end of the range of old text to be changed.\n\
4466 \(For an insertion, the beginning and end are at the same place.)\n\
4467 No information is given about the length of the text after the change.\n\
4469 Buffer changes made while executing the `before-change-function'\n\
4470 don't call any before-change or after-change functions.\n\
4471 That's because these variables are temporarily set to nil.\n\
4472 As a result, a hook function cannot straightforwardly alter the value of\n\
4473 these variables. See the Emacs Lisp manual for a way of\n\
4474 accomplishing an equivalent result by using other variables.\n\n\
4475 This variable is obsolete; use `before-change-functions' instead.");
4476 Vbefore_change_function
= Qnil
;
4478 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
4479 "If non-nil, a Function to call after each text change (obsolete).\n\
4480 Three arguments are passed to the function: the positions of\n\
4481 the beginning and end of the range of changed text,\n\
4482 and the length of the pre-change text replaced by that range.\n\
4483 \(For an insertion, the pre-change length is zero;\n\
4484 for a deletion, that length is the number of bytes deleted,\n\
4485 and the post-change beginning and end are at the same place.)\n\
4487 Buffer changes made while executing the `after-change-function'\n\
4488 don't call any before-change or after-change functions.\n\
4489 That's because these variables are temporarily set to nil.\n\
4490 As a result, a hook function cannot straightforwardly alter the value of\n\
4491 these variables. See the Emacs Lisp manual for a way of\n\
4492 accomplishing an equivalent result by using other variables.\n\n\
4493 This variable is obsolete; use `after-change-functions' instead.");
4494 Vafter_change_function
= Qnil
;
4496 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
4497 "List of functions to call before each text change.\n\
4498 Two arguments are passed to each function: the positions of\n\
4499 the beginning and end of the range of old text to be changed.\n\
4500 \(For an insertion, the beginning and end are at the same place.)\n\
4501 No information is given about the length of the text after the change.\n\
4503 Buffer changes made while executing the `before-change-functions'\n\
4504 don't call any before-change or after-change functions.\n\
4505 That's because these variables are temporarily set to nil.\n\
4506 As a result, a hook function cannot straightforwardly alter the value of\n\
4507 these variables. See the Emacs Lisp manual for a way of\n\
4508 accomplishing an equivalent result by using other variables.\n\
4510 If an unhandled error happens in running these functions,\n\
4511 the variable's value remains nil. That prevents the error\n\
4512 from happening repeatedly and making Emacs nonfunctional.");
4513 Vbefore_change_functions
= Qnil
;
4515 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
4516 "List of function to call after each text change.\n\
4517 Three arguments are passed to each function: the positions of\n\
4518 the beginning and end of the range of changed text,\n\
4519 and the length in bytes of the pre-change text replaced by that range.\n\
4520 \(For an insertion, the pre-change length is zero;\n\
4521 for a deletion, that length is the number of bytes deleted,\n\
4522 and the post-change beginning and end are at the same place.)\n\
4524 Buffer changes made while executing the `after-change-functions'\n\
4525 don't call any before-change or after-change functions.\n\
4526 That's because these variables are temporarily set to nil.\n\
4527 As a result, a hook function cannot straightforwardly alter the value of\n\
4528 these variables. See the Emacs Lisp manual for a way of\n\
4529 accomplishing an equivalent result by using other variables.\n\
4531 If an unhandled error happens in running these functions,\n\
4532 the variable's value remains nil. That prevents the error\n\
4533 from happening repeatedly and making Emacs nonfunctional.");
4534 Vafter_change_functions
= Qnil
;
4536 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
4537 "A list of functions to call before changing a buffer which is unmodified.\n\
4538 The functions are run using the `run-hooks' function.");
4539 Vfirst_change_hook
= Qnil
;
4541 #if 0 /* The doc string is too long for some compilers,
4542 but make-docfile can find it in this comment. */
4543 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4544 "List of undo entries in current buffer.\n\
4545 This variable is always local in all buffers.\n\
4546 Recent changes come first; older changes follow newer.\n\
4548 An entry (BEG . END) represents an insertion which begins at\n\
4549 position BEG and ends at position END.\n\
4551 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
4552 from (abs POSITION). If POSITION is positive, point was at the front\n\
4553 of the text being deleted; if negative, point was at the end.\n\
4555 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
4556 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
4557 of the visited file's modification time, as of that time. If the\n\
4558 modification time of the most recent save is different, this entry is\n\
4561 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
4562 was modified between BEG and END. PROPERTY is the property name,\n\
4563 and VALUE is the old value.\n\
4565 An entry (MARKER . DISTANCE) indicates that the marker MARKER\n\
4566 was adjusted in position by the offset DISTANCE (an integer).\n\
4568 An entry of the form POSITION indicates that point was at the buffer\n\
4569 location given by the integer. Undoing an entry of this form places\n\
4570 point at POSITION.\n\
4572 nil marks undo boundaries. The undo command treats the changes\n\
4573 between two undo boundaries as a single step to be undone.\n\
4575 If the value of the variable is t, undo information is not recorded.");
4577 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4580 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
4581 "Non-nil means the mark and region are currently active in this buffer.\n\
4582 Automatically local in all buffers.");
4584 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
4585 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
4586 This variable is buffer-local, in all buffers.\n\
4588 Normally, the line-motion functions work by scanning the buffer for\n\
4589 newlines. Columnar operations (like move-to-column and\n\
4590 compute-motion) also work by scanning the buffer, summing character\n\
4591 widths as they go. This works well for ordinary text, but if the\n\
4592 buffer's lines are very long (say, more than 500 characters), these\n\
4593 motion functions will take longer to execute. Emacs may also take\n\
4594 longer to update the display.\n\
4596 If cache-long-line-scans is non-nil, these motion functions cache the\n\
4597 results of their scans, and consult the cache to avoid rescanning\n\
4598 regions of the buffer until the text is modified. The caches are most\n\
4599 beneficial when they prevent the most searching---that is, when the\n\
4600 buffer contains long lines and large regions of characters with the\n\
4601 same, fixed screen width.\n\
4603 When cache-long-line-scans is non-nil, processing short lines will\n\
4604 become slightly slower (because of the overhead of consulting the\n\
4605 cache), and the caches will use memory roughly proportional to the\n\
4606 number of newlines and characters whose screen width varies.\n\
4608 The caches require no explicit maintenance; their accuracy is\n\
4609 maintained internally by the Emacs primitives. Enabling or disabling\n\
4610 the cache should not affect the behavior of any of the motion\n\
4611 functions; it should only affect their performance.");
4613 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
4614 "Value of point before the last series of scroll operations, or nil.\n\
4615 This variable is always local in all buffers.");
4617 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
4618 "List of formats to use when saving this buffer.\n\
4619 This variable is always local in all buffers.\n\
4620 Formats are defined by `format-alist'. This variable is\n\
4621 set when a file is visited. Automatically local in all buffers.");
4623 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
4624 ¤t_buffer
->invisibility_spec
, Qnil
,
4625 "Invisibility spec of this buffer.\n\
4626 This variable is always local in all buffers.\n\
4627 The default is t, which means that text is invisible\n\
4628 if it has a non-nil `invisible' property.\n\
4629 If the value is a list, a text character is invisible if its `invisible'\n\
4630 property is an element in that list.\n\
4631 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
4632 then characters with property value PROP are invisible,\n\
4633 and they have an ellipsis as well if ELLIPSIS is non-nil.");
4635 DEFVAR_PER_BUFFER ("buffer-display-count",
4636 ¤t_buffer
->display_count
, Qnil
,
4637 "A number incremented each time this buffer is displayed in a window.\n\
4638 This variable is always local in all buffers.\n\
4639 The function `set-window-buffer increments it.");
4641 DEFVAR_PER_BUFFER ("buffer-display-time",
4642 ¤t_buffer
->display_time
, Qnil
,
4643 "Time stamp updated each time this buffer is displayed in a window.\n\
4644 This variable is always local in all buffers.\n\
4645 The function `set-window-buffer' updates this variable\n\
4646 to the value obtained by calling `current-time'.\n\
4647 If the buffer has never been shown in a window, the value is nil.");
4649 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
4650 "*Non-nil means deactivate the mark when the buffer contents change.\n\
4651 Non-nil also enables highlighting of the region whenever the mark is active.\n\
4652 The variable `highlight-nonselected-windows' controls whether to highlight\n\
4653 all windows or just the selected window.");
4654 Vtransient_mark_mode
= Qnil
;
4656 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
4657 "*Non-nil means disregard read-only status of buffers or characters.\n\
4658 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
4659 text properties. If the value is a list, disregard `buffer-read-only'\n\
4660 and disregard a `read-only' text property if the property value\n\
4661 is a member of the list.");
4662 Vinhibit_read_only
= Qnil
;
4664 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
4665 "List of functions called with no args to query before killing a buffer.");
4666 Vkill_buffer_query_functions
= Qnil
;
4668 defsubr (&Sbuffer_live_p
);
4669 defsubr (&Sbuffer_list
);
4670 defsubr (&Sget_buffer
);
4671 defsubr (&Sget_file_buffer
);
4672 defsubr (&Sget_buffer_create
);
4673 defsubr (&Smake_indirect_buffer
);
4674 defsubr (&Sgenerate_new_buffer_name
);
4675 defsubr (&Sbuffer_name
);
4676 /*defsubr (&Sbuffer_number);*/
4677 defsubr (&Sbuffer_file_name
);
4678 defsubr (&Sbuffer_base_buffer
);
4679 defsubr (&Sbuffer_local_variables
);
4680 defsubr (&Sbuffer_modified_p
);
4681 defsubr (&Sset_buffer_modified_p
);
4682 defsubr (&Sbuffer_modified_tick
);
4683 defsubr (&Srename_buffer
);
4684 defsubr (&Sother_buffer
);
4685 defsubr (&Sbuffer_disable_undo
);
4686 defsubr (&Sbuffer_enable_undo
);
4687 defsubr (&Skill_buffer
);
4688 defsubr (&Sset_buffer_major_mode
);
4689 defsubr (&Sswitch_to_buffer
);
4690 defsubr (&Spop_to_buffer
);
4691 defsubr (&Scurrent_buffer
);
4692 defsubr (&Sset_buffer
);
4693 defsubr (&Sbarf_if_buffer_read_only
);
4694 defsubr (&Sbury_buffer
);
4695 defsubr (&Serase_buffer
);
4696 defsubr (&Sset_buffer_multibyte
);
4697 defsubr (&Skill_all_local_variables
);
4699 defsubr (&Soverlayp
);
4700 defsubr (&Smake_overlay
);
4701 defsubr (&Sdelete_overlay
);
4702 defsubr (&Smove_overlay
);
4703 defsubr (&Soverlay_start
);
4704 defsubr (&Soverlay_end
);
4705 defsubr (&Soverlay_buffer
);
4706 defsubr (&Soverlay_properties
);
4707 defsubr (&Soverlays_at
);
4708 defsubr (&Soverlays_in
);
4709 defsubr (&Snext_overlay_change
);
4710 defsubr (&Sprevious_overlay_change
);
4711 defsubr (&Soverlay_recenter
);
4712 defsubr (&Soverlay_lists
);
4713 defsubr (&Soverlay_get
);
4714 defsubr (&Soverlay_put
);
4720 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
4721 initial_define_key (control_x_map
, 'k', "kill-buffer");
4723 /* This must not be in syms_of_buffer, because Qdisabled is not
4724 initialized when that function gets called. */
4725 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);