1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995, 1997, 1998
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include <sys/types.h>
25 #include <sys/param.h>
31 /* in 4.1, param.h fails to define this. */
32 #define MAXPATHLEN 1024
33 #endif /* not MAXPATHLEN */
43 #include "intervals.h"
48 #include "region-cache.h"
50 #include "blockinput.h"
53 struct buffer
*current_buffer
; /* the current buffer */
55 /* First buffer in chain of all buffers (in reverse order of creation).
56 Threaded through ->next. */
58 struct buffer
*all_buffers
;
60 /* This structure holds the default values of the buffer-local variables
61 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
62 The default value occupies the same slot in this structure
63 as an individual buffer's value occupies in that buffer.
64 Setting the default value also goes through the alist of buffers
65 and stores into each buffer that does not say it has a local value. */
67 struct buffer buffer_defaults
;
69 /* A Lisp_Object pointer to the above, used for staticpro */
71 static Lisp_Object Vbuffer_defaults
;
73 /* This structure marks which slots in a buffer have corresponding
74 default values in buffer_defaults.
75 Each such slot has a nonzero value in this structure.
76 The value has only one nonzero bit.
78 When a buffer has its own local value for a slot,
79 the bit for that slot (found in the same slot in this structure)
80 is turned on in the buffer's local_var_flags slot.
82 If a slot in this structure is -1, then even though there may
83 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
84 and the corresponding slot in buffer_defaults is not used.
86 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
87 but there is a default value which is copied into each buffer.
89 If a slot in this structure is negative, then even though there may
90 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
91 and the corresponding slot in buffer_defaults is not used.
93 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
94 zero, that is a bug */
96 struct buffer buffer_local_flags
;
98 /* This structure holds the names of symbols whose values may be
99 buffer-local. It is indexed and accessed in the same way as the above. */
101 struct buffer buffer_local_symbols
;
102 /* A Lisp_Object pointer to the above, used for staticpro */
103 static Lisp_Object Vbuffer_local_symbols
;
105 /* This structure holds the required types for the values in the
106 buffer-local slots. If a slot contains Qnil, then the
107 corresponding buffer slot may contain a value of any type. If a
108 slot contains an integer, then prospective values' tags must be
109 equal to that integer (except nil is always allowed).
110 When a tag does not match, the function
111 buffer_slot_type_mismatch will signal an error.
113 If a slot here contains -1, the corresponding variable is read-only. */
114 struct buffer buffer_local_types
;
116 /* Flags indicating which built-in buffer-local variables
117 are permanent locals. */
118 static int buffer_permanent_local_flags
;
120 Lisp_Object
Fset_buffer ();
121 void set_buffer_internal ();
122 void set_buffer_internal_1 ();
123 static void call_overlay_mod_hooks ();
124 static void swap_out_buffer_local_variables ();
125 static void reset_buffer_local_variables ();
127 /* Alist of all buffer names vs the buffers. */
128 /* This used to be a variable, but is no longer,
129 to prevent lossage due to user rplac'ing this alist or its elements. */
130 Lisp_Object Vbuffer_alist
;
132 /* Functions to call before and after each text change. */
133 Lisp_Object Vbefore_change_function
;
134 Lisp_Object Vafter_change_function
;
135 Lisp_Object Vbefore_change_functions
;
136 Lisp_Object Vafter_change_functions
;
138 Lisp_Object Vtransient_mark_mode
;
140 /* t means ignore all read-only text properties.
141 A list means ignore such a property if its value is a member of the list.
142 Any non-nil value means ignore buffer-read-only. */
143 Lisp_Object Vinhibit_read_only
;
145 /* List of functions to call that can query about killing a buffer.
146 If any of these functions returns nil, we don't kill it. */
147 Lisp_Object Vkill_buffer_query_functions
;
149 /* List of functions to call before changing an unmodified buffer. */
150 Lisp_Object Vfirst_change_hook
;
152 Lisp_Object Qfirst_change_hook
;
153 Lisp_Object Qbefore_change_functions
;
154 Lisp_Object Qafter_change_functions
;
156 /* If nonzero, all modification hooks are suppressed. */
157 int inhibit_modification_hooks
;
159 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
161 Lisp_Object Qprotected_field
;
163 Lisp_Object QSFundamental
; /* A string "Fundamental" */
165 Lisp_Object Qkill_buffer_hook
;
167 Lisp_Object Qget_file_buffer
;
169 Lisp_Object Qoverlayp
;
171 Lisp_Object Qpriority
, Qwindow
, Qevaporate
, Qbefore_string
, Qafter_string
;
173 Lisp_Object Qmodification_hooks
;
174 Lisp_Object Qinsert_in_front_hooks
;
175 Lisp_Object Qinsert_behind_hooks
;
177 /* For debugging; temporary. See set_buffer_internal. */
178 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
185 error ("No buffer named %s", XSTRING (spec
)->data
);
186 error ("Invalid buffer argument");
189 DEFUN ("buffer-live-p", Fbuffer_live_p
, Sbuffer_live_p
, 1, 1, 0,
190 "Return non-nil if OBJECT is a buffer which has not been killed.\n\
191 Value is nil if OBJECT is not a buffer or if it has been killed.")
195 return ((BUFFERP (object
) && ! NILP (XBUFFER (object
)->name
))
199 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 1, 0,
200 "Return a list of all existing live buffers.\n\
201 If the optional arg FRAME is a frame, we return that frame's buffer list.")
205 Lisp_Object framelist
, general
;
206 general
= Fmapcar (Qcdr
, Vbuffer_alist
);
212 CHECK_FRAME (frame
, 1);
214 framelist
= Fcopy_sequence (XFRAME (frame
)->buffer_list
);
216 /* Remove from GENERAL any buffer that duplicates one in FRAMELIST. */
218 while (! NILP (tail
))
220 general
= Fdelq (XCONS (tail
)->car
, general
);
221 tail
= XCONS (tail
)->cdr
;
223 return nconc2 (framelist
, general
);
229 /* Like Fassoc, but use Fstring_equal to compare
230 (which ignores text properties),
231 and don't ever QUIT. */
234 assoc_ignore_text_properties (key
, list
)
235 register Lisp_Object key
;
238 register Lisp_Object tail
;
239 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
241 register Lisp_Object elt
, tem
;
243 tem
= Fstring_equal (Fcar (elt
), key
);
250 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
251 "Return the buffer named NAME (a string).\n\
252 If there is no live buffer named NAME, return nil.\n\
253 NAME may also be a buffer; if so, the value is that buffer.")
255 register Lisp_Object name
;
259 CHECK_STRING (name
, 0);
261 return Fcdr (assoc_ignore_text_properties (name
, Vbuffer_alist
));
264 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
265 "Return the buffer visiting file FILENAME (a string).\n\
266 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
267 If there is no such live buffer, return nil.\n\
268 See also `find-buffer-visiting'.")
270 register Lisp_Object filename
;
272 register Lisp_Object tail
, buf
, tem
;
275 CHECK_STRING (filename
, 0);
276 filename
= Fexpand_file_name (filename
, Qnil
);
278 /* If the file name has special constructs in it,
279 call the corresponding file handler. */
280 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
282 return call2 (handler
, Qget_file_buffer
, filename
);
284 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
286 buf
= Fcdr (XCONS (tail
)->car
);
287 if (!BUFFERP (buf
)) continue;
288 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
289 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
297 get_truename_buffer (filename
)
298 register Lisp_Object filename
;
300 register Lisp_Object tail
, buf
, tem
;
302 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
304 buf
= Fcdr (XCONS (tail
)->car
);
305 if (!BUFFERP (buf
)) continue;
306 if (!STRINGP (XBUFFER (buf
)->file_truename
)) continue;
307 tem
= Fstring_equal (XBUFFER (buf
)->file_truename
, filename
);
314 /* Incremented for each buffer created, to assign the buffer number. */
317 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
318 "Return the buffer named NAME, or create such a buffer and return it.\n\
319 A new buffer is created if there is no live buffer named NAME.\n\
320 If NAME starts with a space, the new buffer does not keep undo information.\n\
321 If NAME is a buffer instead of a string, then it is the value returned.\n\
322 The value is never nil.")
324 register Lisp_Object name
;
326 register Lisp_Object buf
;
327 register struct buffer
*b
;
329 buf
= Fget_buffer (name
);
333 if (XSTRING (name
)->size
== 0)
334 error ("Empty string for buffer name is not allowed");
336 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
338 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
340 /* An ordinary buffer uses its own struct buffer_text. */
341 b
->text
= &b
->own_text
;
344 BUF_GAP_SIZE (b
) = 20;
346 /* We allocate extra 1-byte at the tail and keep it always '\0' for
347 anchoring a search. */
348 BUFFER_ALLOC (BUF_BEG_ADDR (b
), (BUF_GAP_SIZE (b
) + 1));
350 if (! BUF_BEG_ADDR (b
))
351 buffer_memory_full ();
359 BUF_GPT_BYTE (b
) = 1;
360 BUF_BEGV_BYTE (b
) = 1;
364 BUF_OVERLAY_MODIFF (b
) = 1;
365 BUF_SAVE_MODIFF (b
) = 1;
366 BUF_INTERVALS (b
) = 0;
367 *(BUF_GPT_ADDR (b
)) = *(BUF_Z_ADDR (b
)) = 0; /* Put an anchor '\0'. */
369 b
->newline_cache
= 0;
370 b
->width_run_cache
= 0;
371 b
->width_table
= Qnil
;
373 /* Put this on the chain of all buffers including killed ones. */
374 b
->next
= all_buffers
;
377 /* An ordinary buffer normally doesn't need markers
378 to handle BEGV and ZV. */
380 b
->begv_marker
= Qnil
;
383 name
= Fcopy_sequence (name
);
384 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
387 if (XSTRING (name
)->data
[0] != ' ')
393 reset_buffer_local_variables (b
, 1);
395 /* Put this in the alist of all live buffers. */
397 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
399 b
->mark
= Fmake_marker ();
400 BUF_MARKERS (b
) = Qnil
;
405 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer
, Smake_indirect_buffer
, 2, 2,
406 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
407 "Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.\n\
408 BASE-BUFFER should be an existing buffer (or buffer name).\n\
409 NAME should be a string which is not the name of an existing buffer.")
411 register Lisp_Object base_buffer
, name
;
413 register Lisp_Object buf
;
414 register struct buffer
*b
;
416 buf
= Fget_buffer (name
);
418 error ("Buffer name `%s' is in use", XSTRING (name
)->data
);
420 base_buffer
= Fget_buffer (base_buffer
);
421 if (NILP (base_buffer
))
422 error ("No such buffer: `%s'",
423 XSTRING (XBUFFER (base_buffer
)->name
)->data
);
425 if (XSTRING (name
)->size
== 0)
426 error ("Empty string for buffer name is not allowed");
428 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
430 b
->size
= sizeof (struct buffer
) / sizeof (EMACS_INT
);
432 if (XBUFFER (base_buffer
)->base_buffer
)
433 b
->base_buffer
= XBUFFER (base_buffer
)->base_buffer
;
435 b
->base_buffer
= XBUFFER (base_buffer
);
437 /* Use the base buffer's text object. */
438 b
->text
= b
->base_buffer
->text
;
440 BUF_BEGV (b
) = BUF_BEGV (b
->base_buffer
);
441 BUF_ZV (b
) = BUF_ZV (b
->base_buffer
);
442 BUF_PT (b
) = BUF_PT (b
->base_buffer
);
443 BUF_BEGV_BYTE (b
) = BUF_BEGV_BYTE (b
->base_buffer
);
444 BUF_ZV_BYTE (b
) = BUF_ZV_BYTE (b
->base_buffer
);
445 BUF_PT_BYTE (b
) = BUF_PT_BYTE (b
->base_buffer
);
447 b
->newline_cache
= 0;
448 b
->width_run_cache
= 0;
449 b
->width_table
= Qnil
;
451 /* Put this on the chain of all buffers including killed ones. */
452 b
->next
= all_buffers
;
455 name
= Fcopy_sequence (name
);
456 INITIALIZE_INTERVAL (XSTRING (name
), NULL_INTERVAL
);
460 reset_buffer_local_variables (b
, 1);
462 /* Put this in the alist of all live buffers. */
464 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
466 b
->mark
= Fmake_marker ();
469 /* Make sure the base buffer has markers for its narrowing. */
470 if (NILP (b
->base_buffer
->pt_marker
))
472 b
->base_buffer
->pt_marker
= Fmake_marker ();
473 set_marker_both (b
->base_buffer
->pt_marker
, base_buffer
,
474 BUF_PT (b
->base_buffer
),
475 BUF_PT_BYTE (b
->base_buffer
));
477 if (NILP (b
->base_buffer
->begv_marker
))
479 b
->base_buffer
->begv_marker
= Fmake_marker ();
480 set_marker_both (b
->base_buffer
->begv_marker
, base_buffer
,
481 BUF_BEGV (b
->base_buffer
),
482 BUF_BEGV_BYTE (b
->base_buffer
));
484 if (NILP (b
->base_buffer
->zv_marker
))
486 b
->base_buffer
->zv_marker
= Fmake_marker ();
487 set_marker_both (b
->base_buffer
->zv_marker
, base_buffer
,
488 BUF_ZV (b
->base_buffer
),
489 BUF_ZV_BYTE (b
->base_buffer
));
490 XMARKER (b
->base_buffer
->zv_marker
)->insertion_type
= 1;
493 /* Give the indirect buffer markers for its narrowing. */
494 b
->pt_marker
= Fmake_marker ();
495 set_marker_both (b
->pt_marker
, buf
, BUF_PT (b
), BUF_PT_BYTE (b
));
496 b
->begv_marker
= Fmake_marker ();
497 set_marker_both (b
->begv_marker
, buf
, BUF_BEGV (b
), BUF_BEGV_BYTE (b
));
498 b
->zv_marker
= Fmake_marker ();
499 set_marker_both (b
->zv_marker
, buf
, BUF_ZV (b
), BUF_ZV_BYTE (b
));
500 XMARKER (b
->zv_marker
)->insertion_type
= 1;
505 /* Reinitialize everything about a buffer except its name and contents
506 and local variables. */
510 register struct buffer
*b
;
513 b
->file_truename
= Qnil
;
514 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
516 XSETFASTINT (b
->save_length
, 0);
517 b
->last_window_start
= 1;
518 /* It is more conservative to start out "changed" than "unchanged". */
521 b
->auto_save_modified
= 0;
522 b
->auto_save_failure_time
= -1;
523 b
->auto_save_file_name
= Qnil
;
525 b
->overlays_before
= Qnil
;
526 b
->overlays_after
= Qnil
;
527 XSETFASTINT (b
->overlay_center
, 1);
528 b
->mark_active
= Qnil
;
529 b
->point_before_scroll
= Qnil
;
530 b
->file_format
= Qnil
;
531 b
->last_selected_window
= Qnil
;
532 XSETINT (b
->display_count
, 0);
533 b
->display_time
= Qnil
;
536 b
->enable_multibyte_characters
= buffer_defaults
.enable_multibyte_characters
;
539 /* Reset buffer B's local variables info.
540 Don't use this on a buffer that has already been in use;
541 it does not treat permanent locals consistently.
542 Instead, use Fkill_all_local_variables.
544 If PERMANENT_TOO is 1, then we reset permanent built-in
545 buffer-local variables. If PERMANENT_TOO is 0,
546 we preserve those. */
549 reset_buffer_local_variables (b
, permanent_too
)
550 register struct buffer
*b
;
556 /* Decide which built-in local variables to reset. */
560 dont_reset
= buffer_permanent_local_flags
;
562 /* Reset the major mode to Fundamental, together with all the
563 things that depend on the major mode.
564 default-major-mode is handled at a higher level.
565 We ignore it here. */
566 b
->major_mode
= Qfundamental_mode
;
568 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
569 b
->mode_name
= QSFundamental
;
570 b
->minor_modes
= Qnil
;
572 /* If the standard case table has been altered and invalidated,
573 fix up its insides first. */
574 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[0])
575 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[1])
576 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table
)->extras
[2])))
577 Fset_standard_case_table (Vascii_downcase_table
);
579 b
->downcase_table
= Vascii_downcase_table
;
580 b
->upcase_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[0];
581 b
->case_canon_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[1];
582 b
->case_eqv_table
= XCHAR_TABLE (Vascii_downcase_table
)->extras
[2];
583 b
->invisibility_spec
= Qt
;
585 b
->buffer_file_type
= Qnil
;
589 b
->sort_table
= XSTRING (Vascii_sort_table
);
590 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
593 /* Reset all (or most) per-buffer variables to their defaults. */
594 b
->local_var_alist
= Qnil
;
595 b
->local_var_flags
&= dont_reset
;
597 /* For each slot that has a default value,
598 copy that into the slot. */
600 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
601 offset
< sizeof (struct buffer
);
602 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
604 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
606 /* Don't reset a permanent local. */
607 && ! (dont_reset
& flag
))
609 *(Lisp_Object
*)(offset
+ (char *)b
)
610 = *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
614 /* We split this away from generate-new-buffer, because rename-buffer
615 and set-visited-file-name ought to be able to use this to really
616 rename the buffer properly. */
618 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
620 "Return a string that is the name of no existing buffer based on NAME.\n\
621 If there is no live buffer named NAME, then return NAME.\n\
622 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
623 until an unused name is found, and then return that name.\n\
624 Optional second argument IGNORE specifies a name that is okay to use\n\
625 \(if it is in the sequence to be tried)\n\
626 even if a buffer with that name exists.")
628 register Lisp_Object name
, ignore
;
630 register Lisp_Object gentemp
, tem
;
634 CHECK_STRING (name
, 0);
636 tem
= Fget_buffer (name
);
643 sprintf (number
, "<%d>", ++count
);
644 gentemp
= concat2 (name
, build_string (number
));
645 tem
= Fstring_equal (gentemp
, ignore
);
648 tem
= Fget_buffer (gentemp
);
655 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
656 "Return the name of BUFFER, as a string.\n\
657 With no argument or nil as argument, return the name of the current buffer.")
659 register Lisp_Object buffer
;
662 return current_buffer
->name
;
663 CHECK_BUFFER (buffer
, 0);
664 return XBUFFER (buffer
)->name
;
667 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
668 "Return name of file BUFFER is visiting, or nil if none.\n\
669 No argument or nil as argument means use the current buffer.")
671 register Lisp_Object buffer
;
674 return current_buffer
->filename
;
675 CHECK_BUFFER (buffer
, 0);
676 return XBUFFER (buffer
)->filename
;
679 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer
, Sbuffer_base_buffer
,
681 "Return the base buffer of indirect buffer BUFFER.\n\
682 If BUFFER is not indirect, return nil.")
684 register Lisp_Object buffer
;
687 Lisp_Object base_buffer
;
690 base
= current_buffer
->base_buffer
;
693 CHECK_BUFFER (buffer
, 0);
694 base
= XBUFFER (buffer
)->base_buffer
;
699 XSETBUFFER (base_buffer
, base
);
703 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
704 Sbuffer_local_variables
, 0, 1, 0,
705 "Return an alist of variables that are buffer-local in BUFFER.\n\
706 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
707 For a symbol that is locally unbound, just the symbol appears in the value.\n\
708 Note that storing new VALUEs in these elements doesn't change the variables.\n\
709 No argument or nil as argument means use current buffer as BUFFER.")
711 register Lisp_Object buffer
;
713 register struct buffer
*buf
;
714 register Lisp_Object result
;
717 buf
= current_buffer
;
720 CHECK_BUFFER (buffer
, 0);
721 buf
= XBUFFER (buffer
);
727 register Lisp_Object tail
;
728 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
730 Lisp_Object val
, elt
;
732 elt
= XCONS (tail
)->car
;
734 /* Reference each variable in the alist in buf.
735 If inquiring about the current buffer, this gets the current values,
736 so store them into the alist so the alist is up to date.
737 If inquiring about some other buffer, this swaps out any values
738 for that buffer, making the alist up to date automatically. */
739 val
= find_symbol_value (XCONS (elt
)->car
);
740 /* Use the current buffer value only if buf is the current buffer. */
741 if (buf
!= current_buffer
)
742 val
= XCONS (elt
)->cdr
;
744 /* If symbol is unbound, put just the symbol in the list. */
745 if (EQ (val
, Qunbound
))
746 result
= Fcons (XCONS (elt
)->car
, result
);
747 /* Otherwise, put (symbol . value) in the list. */
749 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
753 /* Add on all the variables stored in special slots. */
755 register int offset
, mask
;
757 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
758 offset
< sizeof (struct buffer
);
759 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
761 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
762 if (mask
== -1 || (buf
->local_var_flags
& mask
))
763 if (SYMBOLP (*(Lisp_Object
*)(offset
764 + (char *)&buffer_local_symbols
)))
765 result
= Fcons (Fcons (*((Lisp_Object
*)
766 (offset
+ (char *)&buffer_local_symbols
)),
767 *(Lisp_Object
*)(offset
+ (char *)buf
)),
776 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
778 "Return t if BUFFER was modified since its file was last read or saved.\n\
779 No argument or nil as argument means use current buffer as BUFFER.")
781 register Lisp_Object buffer
;
783 register struct buffer
*buf
;
785 buf
= current_buffer
;
788 CHECK_BUFFER (buffer
, 0);
789 buf
= XBUFFER (buffer
);
792 return BUF_SAVE_MODIFF (buf
) < BUF_MODIFF (buf
) ? Qt
: Qnil
;
795 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
797 "Mark current buffer as modified or unmodified according to FLAG.\n\
798 A non-nil FLAG means mark the buffer modified.")
800 register Lisp_Object flag
;
802 register int already
;
803 register Lisp_Object fn
;
805 #ifdef CLASH_DETECTION
806 /* If buffer becoming modified, lock the file.
807 If buffer becoming unmodified, unlock the file. */
809 fn
= current_buffer
->file_truename
;
812 already
= SAVE_MODIFF
< MODIFF
;
813 if (!already
&& !NILP (flag
))
815 else if (already
&& NILP (flag
))
818 #endif /* CLASH_DETECTION */
820 SAVE_MODIFF
= NILP (flag
) ? MODIFF
: 0;
825 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
827 "Return BUFFER's tick counter, incremented for each change in text.\n\
828 Each buffer has a tick counter which is incremented each time the text in\n\
829 that buffer is changed. It wraps around occasionally.\n\
830 No argument or nil as argument means use current buffer as BUFFER.")
832 register Lisp_Object buffer
;
834 register struct buffer
*buf
;
836 buf
= current_buffer
;
839 CHECK_BUFFER (buffer
, 0);
840 buf
= XBUFFER (buffer
);
843 return make_number (BUF_MODIFF (buf
));
846 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
847 "sRename buffer (to new name): \nP",
848 "Change current buffer's name to NEWNAME (a string).\n\
849 If second arg UNIQUE is nil or omitted, it is an error if a\n\
850 buffer named NEWNAME already exists.\n\
851 If UNIQUE is non-nil, come up with a new name using\n\
852 `generate-new-buffer-name'.\n\
853 Interactively, you can set UNIQUE with a prefix argument.\n\
854 We return the name we actually gave the buffer.\n\
855 This does not change the name of the visited file (if any).")
857 register Lisp_Object newname
, unique
;
859 register Lisp_Object tem
, buf
;
861 CHECK_STRING (newname
, 0);
863 if (XSTRING (newname
)->size
== 0)
864 error ("Empty string is invalid as a buffer name");
866 tem
= Fget_buffer (newname
);
867 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
868 the buffer automatically so you can create another with the original name.
869 It makes UNIQUE equivalent to
870 (rename-buffer (generate-new-buffer-name NEWNAME)). */
871 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
872 return current_buffer
->name
;
876 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
878 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
881 current_buffer
->name
= newname
;
883 /* Catch redisplay's attention. Unless we do this, the mode lines for
884 any windows displaying current_buffer will stay unchanged. */
887 XSETBUFFER (buf
, current_buffer
);
888 Fsetcar (Frassq (buf
, Vbuffer_alist
), newname
);
889 if (NILP (current_buffer
->filename
)
890 && !NILP (current_buffer
->auto_save_file_name
))
891 call0 (intern ("rename-auto-save-file"));
892 /* Refetch since that last call may have done GC. */
893 return current_buffer
->name
;
896 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 3, 0,
897 "Return most recently selected buffer other than BUFFER.\n\
898 Buffers not visible in windows are preferred to visible buffers,\n\
899 unless optional second argument VISIBLE-OK is non-nil.\n\
900 If the optional third argument FRAME is non-nil, use that frame's\n\
901 buffer list instead of the selected frame's buffer list.\n\
902 If no other buffer exists, the buffer `*scratch*' is returned.\n\
903 If BUFFER is omitted or nil, some interesting buffer is returned.")
904 (buffer
, visible_ok
, frame
)
905 register Lisp_Object buffer
, visible_ok
, frame
;
907 Lisp_Object
Fset_buffer_major_mode ();
908 register Lisp_Object tail
, buf
, notsogood
, tem
, pred
, add_ons
;
912 frame
= Fselected_frame ();
914 tail
= Vbuffer_alist
;
915 pred
= frame_buffer_predicate (frame
);
917 /* Consider buffers that have been seen in the selected frame
918 before other buffers. */
920 tem
= frame_buffer_list (frame
);
924 if (BUFFERP (XCONS (tem
)->car
))
925 add_ons
= Fcons (Fcons (Qnil
, XCONS (tem
)->car
), add_ons
);
926 tem
= XCONS (tem
)->cdr
;
928 tail
= nconc2 (Fnreverse (add_ons
), tail
);
930 for (; !NILP (tail
); tail
= Fcdr (tail
))
932 buf
= Fcdr (Fcar (tail
));
933 if (EQ (buf
, buffer
))
935 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
937 /* If the selected frame has a buffer_predicate,
938 disregard buffers that don't fit the predicate. */
941 tem
= call1 (pred
, buf
);
946 if (NILP (visible_ok
))
947 tem
= Fget_buffer_window (buf
, Qt
);
952 if (NILP (notsogood
))
955 if (!NILP (notsogood
))
957 buf
= Fget_buffer_create (build_string ("*scratch*"));
958 Fset_buffer_major_mode (buf
);
962 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
,
964 "Make BUFFER stop keeping undo information.\n\
965 No argument or nil as argument means do this for the current buffer.")
967 register Lisp_Object buffer
;
969 Lisp_Object real_buffer
;
972 XSETBUFFER (real_buffer
, current_buffer
);
975 real_buffer
= Fget_buffer (buffer
);
976 if (NILP (real_buffer
))
980 XBUFFER (real_buffer
)->undo_list
= Qt
;
985 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
987 "Start keeping undo information for buffer BUFFER.\n\
988 No argument or nil as argument means do this for the current buffer.")
990 register Lisp_Object buffer
;
992 Lisp_Object real_buffer
;
995 XSETBUFFER (real_buffer
, current_buffer
);
998 real_buffer
= Fget_buffer (buffer
);
999 if (NILP (real_buffer
))
1003 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
1004 XBUFFER (real_buffer
)->undo_list
= Qnil
;
1010 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
1011 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
1012 The buffer being killed will be current while the hook is running.\n\
1015 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
1016 "Kill the buffer BUFFER.\n\
1017 The argument may be a buffer or may be the name of a buffer.\n\
1018 An argument of nil means kill the current buffer.\n\n\
1019 Value is t if the buffer is actually killed, nil if user says no.\n\n\
1020 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
1021 if not void, is a list of functions to be called, with no arguments,\n\
1022 before the buffer is actually killed. The buffer to be killed is current\n\
1023 when the hook functions are called.\n\n\
1024 Any processes that have this buffer as the `process-buffer' are killed\n\
1030 register struct buffer
*b
;
1031 register Lisp_Object tem
;
1032 register struct Lisp_Marker
*m
;
1033 struct gcpro gcpro1
, gcpro2
;
1036 buf
= Fcurrent_buffer ();
1038 buf
= Fget_buffer (buffer
);
1044 /* Avoid trouble for buffer already dead. */
1048 /* Query if the buffer is still modified. */
1049 if (INTERACTIVE
&& !NILP (b
->filename
)
1050 && BUF_MODIFF (b
) > BUF_SAVE_MODIFF (b
))
1053 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
1054 XSTRING (b
->name
)->data
));
1060 /* Run hooks with the buffer to be killed the current buffer. */
1062 register Lisp_Object val
;
1063 int count
= specpdl_ptr
- specpdl
;
1066 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1067 set_buffer_internal (b
);
1069 /* First run the query functions; if any query is answered no,
1070 don't kill the buffer. */
1071 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
1073 tem
= call0 (Fcar (list
));
1075 return unbind_to (count
, Qnil
);
1078 /* Then run the hooks. */
1079 if (!NILP (Vrun_hooks
))
1080 call1 (Vrun_hooks
, Qkill_buffer_hook
);
1081 unbind_to (count
, Qnil
);
1084 /* We have no more questions to ask. Verify that it is valid
1085 to kill the buffer. This must be done after the questions
1086 since anything can happen within do_yes_or_no_p. */
1088 /* Don't kill the minibuffer now current. */
1089 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
1095 /* When we kill a base buffer, kill all its indirect buffers.
1096 We do it at this stage so nothing terrible happens if they
1097 ask questions or their hooks get errors. */
1098 if (! b
->base_buffer
)
1100 struct buffer
*other
;
1104 for (other
= all_buffers
; other
; other
= other
->next
)
1105 /* all_buffers contains dead buffers too;
1106 don't re-kill them. */
1107 if (other
->base_buffer
== b
&& !NILP (other
->name
))
1110 XSETBUFFER (buf
, other
);
1117 /* Make this buffer not be current.
1118 In the process, notice if this is the sole visible buffer
1119 and give up if so. */
1120 if (b
== current_buffer
)
1122 tem
= Fother_buffer (buf
, Qnil
, Qnil
);
1124 if (b
== current_buffer
)
1128 /* Now there is no question: we can kill the buffer. */
1130 #ifdef CLASH_DETECTION
1131 /* Unlock this buffer's file, if it is locked. */
1133 #endif /* CLASH_DETECTION */
1135 kill_buffer_processes (buf
);
1137 tem
= Vinhibit_quit
;
1139 replace_buffer_in_all_windows (buf
);
1140 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
1141 frames_discard_buffer (buf
);
1142 Vinhibit_quit
= tem
;
1144 /* Delete any auto-save file, if we saved it in this session. */
1145 if (STRINGP (b
->auto_save_file_name
)
1146 && b
->auto_save_modified
!= 0
1147 && BUF_SAVE_MODIFF (b
) < b
->auto_save_modified
)
1150 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
1152 internal_delete_file (b
->auto_save_file_name
);
1157 /* Unchain all markers that belong to this indirect buffer.
1158 Don't unchain the markers that belong to the base buffer
1159 or its other indirect buffers. */
1160 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1166 unchain_marker (tem
);
1172 /* Unchain all markers of this buffer and its indirect buffers.
1173 and leave them pointing nowhere. */
1174 for (tem
= BUF_MARKERS (b
); !NILP (tem
); )
1181 BUF_MARKERS (b
) = Qnil
;
1183 #ifdef USE_TEXT_PROPERTIES
1184 BUF_INTERVALS (b
) = NULL_INTERVAL
;
1187 /* Perhaps we should explicitly free the interval tree here... */
1190 /* Reset the local variables, so that this buffer's local values
1191 won't be protected from GC. They would be protected
1192 if they happened to remain encached in their symbols.
1193 This gets rid of them for certain. */
1194 swap_out_buffer_local_variables (b
);
1195 reset_buffer_local_variables (b
, 1);
1200 if (! b
->base_buffer
)
1201 BUFFER_FREE (BUF_BEG_ADDR (b
));
1203 if (b
->newline_cache
)
1205 free_region_cache (b
->newline_cache
);
1206 b
->newline_cache
= 0;
1208 if (b
->width_run_cache
)
1210 free_region_cache (b
->width_run_cache
);
1211 b
->width_run_cache
= 0;
1213 b
->width_table
= Qnil
;
1215 b
->undo_list
= Qnil
;
1220 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1221 we do this each time BUF is selected visibly, the more recently
1222 selected buffers are always closer to the front of the list. This
1223 means that other_buffer is more likely to choose a relevant buffer. */
1229 register Lisp_Object link
, prev
;
1231 frame
= Fselected_frame ();
1234 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
1236 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
1241 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1242 we cannot use Fdelq itself here because it allows quitting. */
1245 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
1247 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1249 XCONS (link
)->cdr
= Vbuffer_alist
;
1250 Vbuffer_alist
= link
;
1252 /* Now move this buffer to the front of frame_buffer_list also. */
1255 for (link
= frame_buffer_list (frame
); CONSP (link
);
1256 link
= XCONS (link
)->cdr
)
1258 if (EQ (XCONS (link
)->car
, buf
))
1263 /* Effectively do delq. */
1268 set_frame_buffer_list (frame
,
1269 XCONS (frame_buffer_list (frame
))->cdr
);
1271 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
1273 XCONS (link
)->cdr
= frame_buffer_list (frame
);
1274 set_frame_buffer_list (frame
, link
);
1277 set_frame_buffer_list (frame
, Fcons (buf
, frame_buffer_list (frame
)));
1280 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
1281 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
1282 Use this function before selecting the buffer, since it may need to inspect\n\
1283 the current buffer's major mode.")
1288 Lisp_Object function
;
1290 function
= buffer_defaults
.major_mode
;
1291 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
1292 function
= current_buffer
->major_mode
;
1294 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
1297 count
= specpdl_ptr
- specpdl
;
1299 /* To select a nonfundamental mode,
1300 select the buffer temporarily and then call the mode function. */
1302 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1304 Fset_buffer (buffer
);
1307 return unbind_to (count
, Qnil
);
1310 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
1311 "Select buffer BUFFER in the current window.\n\
1312 BUFFER may be a buffer or a buffer name.\n\
1313 Optional second arg NORECORD non-nil means\n\
1314 do not put this buffer at the front of the list of recently selected ones.\n\
1316 WARNING: This is NOT the way to work on another buffer temporarily\n\
1317 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
1318 the window-buffer correspondences.")
1320 Lisp_Object buffer
, norecord
;
1322 register Lisp_Object buf
;
1325 if (EQ (minibuf_window
, selected_window
))
1326 error ("Cannot switch buffers in minibuffer window");
1327 tem
= Fwindow_dedicated_p (selected_window
);
1329 error ("Cannot switch buffers in a dedicated window");
1332 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1335 buf
= Fget_buffer (buffer
);
1338 buf
= Fget_buffer_create (buffer
);
1339 Fset_buffer_major_mode (buf
);
1343 if (NILP (norecord
))
1344 record_buffer (buf
);
1346 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
1347 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
1354 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 3, 0,
1355 "Select buffer BUFFER in some window, preferably a different one.\n\
1356 If BUFFER is nil, then some other buffer is chosen.\n\
1357 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
1358 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
1359 window even if BUFFER is already visible in the selected window.\n\
1360 This uses the function `display-buffer' as a subroutine; see the documentation\n\
1361 of `display-buffer' for additional customization information.\n\
1363 Optional third arg NORECORD non-nil means\n\
1364 do not put this buffer at the front of the list of recently selected ones.")
1365 (buffer
, other_window
, norecord
)
1366 Lisp_Object buffer
, other_window
, norecord
;
1368 register Lisp_Object buf
;
1370 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
);
1373 buf
= Fget_buffer (buffer
);
1376 buf
= Fget_buffer_create (buffer
);
1377 Fset_buffer_major_mode (buf
);
1381 if (NILP (norecord
))
1382 record_buffer (buf
);
1383 Fselect_window (Fdisplay_buffer (buf
, other_window
, Qnil
));
1387 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
1388 "Return the current buffer as a Lisp object.")
1391 register Lisp_Object buf
;
1392 XSETBUFFER (buf
, current_buffer
);
1396 /* Set the current buffer to B. */
1399 set_buffer_internal (b
)
1400 register struct buffer
*b
;
1402 register struct buffer
*old_buf
;
1403 register Lisp_Object tail
, valcontents
;
1406 if (current_buffer
== b
)
1409 windows_or_buffers_changed
= 1;
1410 set_buffer_internal_1 (b
);
1413 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1414 This is used by redisplay. */
1417 set_buffer_internal_1 (b
)
1418 register struct buffer
*b
;
1420 register struct buffer
*old_buf
;
1421 register Lisp_Object tail
, valcontents
;
1424 if (current_buffer
== b
)
1427 old_buf
= current_buffer
;
1429 last_known_column_point
= -1; /* invalidate indentation cache */
1433 /* Put the undo list back in the base buffer, so that it appears
1434 that an indirect buffer shares the undo list of its base. */
1435 if (old_buf
->base_buffer
)
1436 old_buf
->base_buffer
->undo_list
= old_buf
->undo_list
;
1438 /* If the old current buffer has markers to record PT, BEGV and ZV
1439 when it is not current, update them now. */
1440 if (! NILP (old_buf
->pt_marker
))
1443 XSETBUFFER (obuf
, old_buf
);
1444 set_marker_both (old_buf
->pt_marker
, obuf
,
1445 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1447 if (! NILP (old_buf
->begv_marker
))
1450 XSETBUFFER (obuf
, old_buf
);
1451 set_marker_both (old_buf
->begv_marker
, obuf
,
1452 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1454 if (! NILP (old_buf
->zv_marker
))
1457 XSETBUFFER (obuf
, old_buf
);
1458 set_marker_both (old_buf
->zv_marker
, obuf
,
1459 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1463 /* Get the undo list from the base buffer, so that it appears
1464 that an indirect buffer shares the undo list of its base. */
1466 b
->undo_list
= b
->base_buffer
->undo_list
;
1468 /* If the new current buffer has markers to record PT, BEGV and ZV
1469 when it is not current, fetch them now. */
1470 if (! NILP (b
->pt_marker
))
1472 BUF_PT (b
) = marker_position (b
->pt_marker
);
1473 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1475 if (! NILP (b
->begv_marker
))
1477 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1478 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1480 if (! NILP (b
->zv_marker
))
1482 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1483 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1486 /* Look down buffer's list of local Lisp variables
1487 to find and update any that forward into C variables. */
1489 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1491 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1492 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1493 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1494 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1495 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1496 /* Just reference the variable
1497 to cause it to become set for this buffer. */
1498 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1501 /* Do the same with any others that were local to the previous buffer */
1504 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1506 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1507 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1508 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1509 && (tem
= XBUFFER_LOCAL_VALUE (valcontents
)->realvalue
,
1510 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1511 /* Just reference the variable
1512 to cause it to become set for this buffer. */
1513 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1517 /* Switch to buffer B temporarily for redisplay purposes.
1518 This avoids certain things that don't need to be done within redisplay. */
1524 register struct buffer
*old_buf
;
1526 if (current_buffer
== b
)
1529 old_buf
= current_buffer
;
1534 /* If the old current buffer has markers to record PT, BEGV and ZV
1535 when it is not current, update them now. */
1536 if (! NILP (old_buf
->pt_marker
))
1539 XSETBUFFER (obuf
, old_buf
);
1540 set_marker_both (old_buf
->pt_marker
, obuf
,
1541 BUF_PT (old_buf
), BUF_PT_BYTE (old_buf
));
1543 if (! NILP (old_buf
->begv_marker
))
1546 XSETBUFFER (obuf
, old_buf
);
1547 set_marker_both (old_buf
->begv_marker
, obuf
,
1548 BUF_BEGV (old_buf
), BUF_BEGV_BYTE (old_buf
));
1550 if (! NILP (old_buf
->zv_marker
))
1553 XSETBUFFER (obuf
, old_buf
);
1554 set_marker_both (old_buf
->zv_marker
, obuf
,
1555 BUF_ZV (old_buf
), BUF_ZV_BYTE (old_buf
));
1559 /* If the new current buffer has markers to record PT, BEGV and ZV
1560 when it is not current, fetch them now. */
1561 if (! NILP (b
->pt_marker
))
1563 BUF_PT (b
) = marker_position (b
->pt_marker
);
1564 BUF_PT_BYTE (b
) = marker_byte_position (b
->pt_marker
);
1566 if (! NILP (b
->begv_marker
))
1568 BUF_BEGV (b
) = marker_position (b
->begv_marker
);
1569 BUF_BEGV_BYTE (b
) = marker_byte_position (b
->begv_marker
);
1571 if (! NILP (b
->zv_marker
))
1573 BUF_ZV (b
) = marker_position (b
->zv_marker
);
1574 BUF_ZV_BYTE (b
) = marker_byte_position (b
->zv_marker
);
1578 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1579 "Make the buffer BUFFER current for editing operations.\n\
1580 BUFFER may be a buffer or the name of an existing buffer.\n\
1581 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1582 This function does not display the buffer, so its effect ends\n\
1583 when the current command terminates.\n\
1584 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1586 register Lisp_Object buffer
;
1588 register Lisp_Object buf
;
1589 buf
= Fget_buffer (buffer
);
1592 if (NILP (XBUFFER (buf
)->name
))
1593 error ("Selecting deleted buffer");
1594 set_buffer_internal (XBUFFER (buf
));
1598 /* Set the current buffer to BUFFER provided it is alive. */
1601 set_buffer_if_live (buffer
)
1604 if (! NILP (XBUFFER (buffer
)->name
))
1605 Fset_buffer (buffer
);
1609 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1610 Sbarf_if_buffer_read_only
, 0, 0, 0,
1611 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1614 if (!NILP (current_buffer
->read_only
)
1615 && NILP (Vinhibit_read_only
))
1616 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1620 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1621 "Put BUFFER at the end of the list of all buffers.\n\
1622 There it is the least likely candidate for `other-buffer' to return;\n\
1623 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1624 If BUFFER is nil or omitted, bury the current buffer.\n\
1625 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1626 selected window if it is displayed there.")
1628 register Lisp_Object buffer
;
1630 /* Figure out what buffer we're going to bury. */
1633 XSETBUFFER (buffer
, current_buffer
);
1635 /* If we're burying the current buffer, unshow it. */
1636 Fswitch_to_buffer (Fother_buffer (buffer
, Qnil
, Qnil
), Qnil
);
1642 buf1
= Fget_buffer (buffer
);
1648 /* Move buffer to the end of the buffer list. */
1650 register Lisp_Object aelt
, link
;
1652 aelt
= Frassq (buffer
, Vbuffer_alist
);
1653 link
= Fmemq (aelt
, Vbuffer_alist
);
1654 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1655 XCONS (link
)->cdr
= Qnil
;
1656 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1659 frames_bury_buffer (buffer
);
1664 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1665 "Delete the entire contents of the current buffer.\n\
1666 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1667 so the buffer is truly empty after this.")
1672 current_buffer
->last_window_start
= 1;
1673 /* Prevent warnings, or suspension of auto saving, that would happen
1674 if future size is less than past size. Use of erase-buffer
1675 implies that the future text is not really related to the past text. */
1676 XSETFASTINT (current_buffer
->save_length
, 0);
1681 validate_region (b
, e
)
1682 register Lisp_Object
*b
, *e
;
1684 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1685 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1687 if (XINT (*b
) > XINT (*e
))
1690 tem
= *b
; *b
= *e
; *e
= tem
;
1693 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1694 && XINT (*e
) <= ZV
))
1695 args_out_of_range (*b
, *e
);
1698 /* Advance BYTE_POS up to a character boundary
1699 and return the adjusted position. */
1702 advance_to_char_boundary (byte_pos
)
1707 if (byte_pos
== BEG
)
1708 /* Beginning of buffer is always a character boundary. */
1711 c
= FETCH_BYTE (byte_pos
);
1712 if (! CHAR_HEAD_P (c
))
1714 /* We should advance BYTE_POS only when C is a constituen of a
1715 multibyte sequence. */
1718 /* If C is a constituent of a multibyte sequence, BYTE_POS was
1719 surely advance to the correct character boundary. If C is
1720 not, BYTE_POS was unchanged. */
1726 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte
, Sset_buffer_multibyte
,
1728 "Set the multibyte flag of the current buffer to FLAG.\n\
1729 If FLAG is t, this makes the buffer a multibyte buffer.\n\
1730 If FLAG is nil, this makes the buffer a single-byte buffer.\n\
1731 The buffer contents remain unchanged as a sequence of bytes\n\
1732 but the contents viewed as characters do change.")
1736 Lisp_Object tail
, markers
;
1738 if (current_buffer
->base_buffer
)
1739 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
1741 /* Do nothing if nothing actually changes. */
1742 if (NILP (flag
) == NILP (current_buffer
->enable_multibyte_characters
))
1745 /* It would be better to update the list,
1746 but this is good enough for now. */
1747 if (! EQ (current_buffer
->undo_list
, Qt
))
1748 current_buffer
->undo_list
= Qnil
;
1750 /* If the cached position is for this buffer, clear it out. */
1751 clear_charpos_cache (current_buffer
);
1755 /* Do this first, so it can use CHAR_TO_BYTE
1756 to calculate the old correspondences. */
1757 set_intervals_multibyte (0);
1759 current_buffer
->enable_multibyte_characters
= Qnil
;
1765 TEMP_SET_PT_BOTH (PT_BYTE
, PT_BYTE
);
1767 tail
= BUF_MARKERS (current_buffer
);
1768 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1770 XMARKER (tail
)->charpos
= XMARKER (tail
)->bytepos
;
1771 tail
= XMARKER (tail
)->chain
;
1776 /* Be sure not to have a multibyte sequence striding over the GAP.
1777 Ex: We change this: "...abc\201\241\241 _GAP_ \241\241\241..."
1778 to: "...abc _GAP_ \201\241\241\241\241\241..." */
1780 if (GPT_BYTE
> 1 && GPT_BYTE
< Z_BYTE
1781 && ! CHAR_HEAD_P (*(GAP_END_ADDR
)))
1783 unsigned char *p
= GPT_ADDR
- 1;
1785 while (! CHAR_HEAD_P (*p
) && p
> BEG_ADDR
) p
--;
1786 if (BASE_LEADING_CODE_P (*p
))
1788 int new_gpt
= GPT_BYTE
- (GPT_ADDR
- p
);
1790 move_gap_both (new_gpt
, new_gpt
);
1794 /* Do this first, so that chars_in_text asks the right question.
1795 set_intervals_multibyte needs it too. */
1796 current_buffer
->enable_multibyte_characters
= Qt
;
1798 GPT_BYTE
= advance_to_char_boundary (GPT_BYTE
);
1799 GPT
= chars_in_text (BEG_ADDR
, GPT_BYTE
- BEG_BYTE
) + BEG
;
1801 Z
= chars_in_text (GAP_END_ADDR
, Z_BYTE
- GPT_BYTE
) + GPT
;
1803 BEGV_BYTE
= advance_to_char_boundary (BEGV_BYTE
);
1804 if (BEGV_BYTE
> GPT_BYTE
)
1805 BEGV
= chars_in_text (GAP_END_ADDR
, BEGV_BYTE
- GPT_BYTE
) + GPT
;
1807 BEGV
= chars_in_text (BEG_ADDR
, BEGV_BYTE
- BEG_BYTE
) + BEG
;
1809 ZV_BYTE
= advance_to_char_boundary (ZV_BYTE
);
1810 if (ZV_BYTE
> GPT_BYTE
)
1811 ZV
= chars_in_text (GAP_END_ADDR
, ZV_BYTE
- GPT_BYTE
) + GPT
;
1813 ZV
= chars_in_text (BEG_ADDR
, ZV_BYTE
- BEG_BYTE
) + BEG
;
1816 int pt_byte
= advance_to_char_boundary (PT_BYTE
);
1819 if (pt_byte
> GPT_BYTE
)
1820 pt
= chars_in_text (GAP_END_ADDR
, pt_byte
- GPT_BYTE
) + GPT
;
1822 pt
= chars_in_text (BEG_ADDR
, pt_byte
- BEG_BYTE
) + BEG
;
1823 TEMP_SET_PT_BOTH (pt
, pt_byte
);
1826 tail
= markers
= BUF_MARKERS (current_buffer
);
1828 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
1829 getting confused by the markers that have not yet been updated.
1830 It is also a signal that it should never create a marker. */
1831 BUF_MARKERS (current_buffer
) = Qnil
;
1833 while (XSYMBOL (tail
) != XSYMBOL (Qnil
))
1835 XMARKER (tail
)->bytepos
1836 = advance_to_char_boundary (XMARKER (tail
)->bytepos
);
1837 XMARKER (tail
)->charpos
= BYTE_TO_CHAR (XMARKER (tail
)->bytepos
);
1839 tail
= XMARKER (tail
)->chain
;
1842 /* Make sure no markers were put on the chain
1843 while the chain value was incorrect. */
1844 if (! EQ (BUF_MARKERS (current_buffer
), Qnil
))
1847 BUF_MARKERS (current_buffer
) = markers
;
1849 /* Do this last, so it can calculate the new correspondences
1850 between chars and bytes. */
1851 set_intervals_multibyte (1);
1857 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1859 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1860 Most local variable bindings are eliminated so that the default values\n\
1861 become effective once more. Also, the syntax table is set from\n\
1862 `standard-syntax-table', the local keymap is set to nil,\n\
1863 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1864 This function also forces redisplay of the mode line.\n\
1866 Every function to select a new major mode starts by\n\
1867 calling this function.\n\n\
1868 As a special exception, local variables whose names have\n\
1869 a non-nil `permanent-local' property are not eliminated by this function.\n\
1871 The first thing this function does is run\n\
1872 the normal hook `change-major-mode-hook'.")
1875 register Lisp_Object alist
, sym
, tem
;
1878 if (!NILP (Vrun_hooks
))
1879 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1880 oalist
= current_buffer
->local_var_alist
;
1882 /* Make sure none of the bindings in oalist
1883 remain swapped in, in their symbols. */
1885 swap_out_buffer_local_variables (current_buffer
);
1887 /* Actually eliminate all local bindings of this buffer. */
1889 reset_buffer_local_variables (current_buffer
, 0);
1891 /* Redisplay mode lines; we are changing major mode. */
1893 update_mode_lines
++;
1895 /* Any which are supposed to be permanent,
1896 make local again, with the same values they had. */
1898 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1900 sym
= XCONS (XCONS (alist
)->car
)->car
;
1901 tem
= Fget (sym
, Qpermanent_local
);
1904 Fmake_local_variable (sym
);
1905 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1909 /* Force mode-line redisplay. Useful here because all major mode
1910 commands call this function. */
1911 update_mode_lines
++;
1916 /* Make sure no local variables remain set up with buffer B
1917 for their current values. */
1920 swap_out_buffer_local_variables (b
)
1923 Lisp_Object oalist
, alist
, sym
, tem
, buffer
;
1925 XSETBUFFER (buffer
, b
);
1926 oalist
= b
->local_var_alist
;
1928 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1930 sym
= XCONS (XCONS (alist
)->car
)->car
;
1932 /* Need not do anything if some other buffer's binding is now encached. */
1933 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
;
1934 if (XBUFFER (tem
) == current_buffer
)
1936 /* Symbol is set up for this buffer's old local value.
1937 Set it up for the current buffer with the default value. */
1939 tem
= XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
;
1940 /* Store the symbol's current value into the alist entry
1941 it is currently set up for. This is so that, if the
1942 local is marked permanent, and we make it local again
1943 later in Fkill_all_local_variables, we don't lose the value. */
1944 XCONS (XCONS (tem
)->car
)->cdr
1945 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
);
1946 /* Switch to the symbol's default-value alist entry. */
1947 XCONS (tem
)->car
= tem
;
1948 /* Mark it as current for buffer B. */
1949 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->buffer
= buffer
;
1950 /* Store the current value into any forwarding in the symbol. */
1951 store_symval_forwarding (sym
,
1952 XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->realvalue
,
1958 /* Find all the overlays in the current buffer that contain position POS.
1959 Return the number found, and store them in a vector in *VEC_PTR.
1960 Store in *LEN_PTR the size allocated for the vector.
1961 Store in *NEXT_PTR the next position after POS where an overlay starts,
1962 or ZV if there are no more overlays.
1963 Store in *PREV_PTR the previous position before POS where an overlay ends,
1964 or BEGV if there are no previous overlays.
1965 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1967 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1968 when this function is called.
1970 If EXTEND is non-zero, we make the vector bigger if necessary.
1971 If EXTEND is zero, we never extend the vector,
1972 and we store only as many overlays as will fit.
1973 But we still return the total number of overlays. */
1976 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1979 Lisp_Object
**vec_ptr
;
1984 Lisp_Object tail
, overlay
, start
, end
, result
;
1987 Lisp_Object
*vec
= *vec_ptr
;
1990 int inhibit_storing
= 0;
1992 for (tail
= current_buffer
->overlays_before
;
1994 tail
= XCONS (tail
)->cdr
)
1996 int startpos
, endpos
;
1998 overlay
= XCONS (tail
)->car
;
2000 start
= OVERLAY_START (overlay
);
2001 end
= OVERLAY_END (overlay
);
2002 endpos
= OVERLAY_POSITION (end
);
2011 startpos
= OVERLAY_POSITION (start
);
2012 if (startpos
<= pos
)
2016 /* The supplied vector is full.
2017 Either make it bigger, or don't store any more in it. */
2020 *len_ptr
= len
*= 2;
2021 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2025 inhibit_storing
= 1;
2028 if (!inhibit_storing
)
2030 /* Keep counting overlays even if we can't return them all. */
2033 else if (startpos
< next
)
2037 for (tail
= current_buffer
->overlays_after
;
2039 tail
= XCONS (tail
)->cdr
)
2041 int startpos
, endpos
;
2043 overlay
= XCONS (tail
)->car
;
2045 start
= OVERLAY_START (overlay
);
2046 end
= OVERLAY_END (overlay
);
2047 startpos
= OVERLAY_POSITION (start
);
2050 if (startpos
< next
)
2054 endpos
= OVERLAY_POSITION (end
);
2061 *len_ptr
= len
*= 2;
2062 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2066 inhibit_storing
= 1;
2069 if (!inhibit_storing
)
2073 else if (endpos
< pos
&& endpos
> prev
)
2084 /* Find all the overlays in the current buffer that overlap the range BEG-END
2085 or are empty at BEG.
2087 Return the number found, and store them in a vector in *VEC_PTR.
2088 Store in *LEN_PTR the size allocated for the vector.
2089 Store in *NEXT_PTR the next position after POS where an overlay starts,
2090 or ZV if there are no more overlays.
2091 Store in *PREV_PTR the previous position before POS where an overlay ends,
2092 or BEGV if there are no previous overlays.
2093 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2095 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2096 when this function is called.
2098 If EXTEND is non-zero, we make the vector bigger if necessary.
2099 If EXTEND is zero, we never extend the vector,
2100 and we store only as many overlays as will fit.
2101 But we still return the total number of overlays. */
2104 overlays_in (beg
, end
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
2107 Lisp_Object
**vec_ptr
;
2112 Lisp_Object tail
, overlay
, ostart
, oend
, result
;
2115 Lisp_Object
*vec
= *vec_ptr
;
2118 int inhibit_storing
= 0;
2120 for (tail
= current_buffer
->overlays_before
;
2122 tail
= XCONS (tail
)->cdr
)
2124 int startpos
, endpos
;
2126 overlay
= XCONS (tail
)->car
;
2128 ostart
= OVERLAY_START (overlay
);
2129 oend
= OVERLAY_END (overlay
);
2130 endpos
= OVERLAY_POSITION (oend
);
2137 startpos
= OVERLAY_POSITION (ostart
);
2138 /* Count an interval if it either overlaps the range
2139 or is empty at the start of the range. */
2140 if ((beg
< endpos
&& startpos
< end
)
2141 || (startpos
== endpos
&& beg
== endpos
))
2145 /* The supplied vector is full.
2146 Either make it bigger, or don't store any more in it. */
2149 *len_ptr
= len
*= 2;
2150 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2154 inhibit_storing
= 1;
2157 if (!inhibit_storing
)
2159 /* Keep counting overlays even if we can't return them all. */
2162 else if (startpos
< next
)
2166 for (tail
= current_buffer
->overlays_after
;
2168 tail
= XCONS (tail
)->cdr
)
2170 int startpos
, endpos
;
2172 overlay
= XCONS (tail
)->car
;
2174 ostart
= OVERLAY_START (overlay
);
2175 oend
= OVERLAY_END (overlay
);
2176 startpos
= OVERLAY_POSITION (ostart
);
2179 if (startpos
< next
)
2183 endpos
= OVERLAY_POSITION (oend
);
2184 /* Count an interval if it either overlaps the range
2185 or is empty at the start of the range. */
2186 if ((beg
< endpos
&& startpos
< end
)
2187 || (startpos
== endpos
&& beg
== endpos
))
2193 *len_ptr
= len
*= 2;
2194 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
2198 inhibit_storing
= 1;
2201 if (!inhibit_storing
)
2205 else if (endpos
< beg
&& endpos
> prev
)
2216 /* Fast function to just test if we're at an overlay boundary. */
2218 overlay_touches_p (pos
)
2221 Lisp_Object tail
, overlay
;
2223 for (tail
= current_buffer
->overlays_before
; GC_CONSP (tail
);
2224 tail
= XCONS (tail
)->cdr
)
2228 overlay
= XCONS (tail
)->car
;
2229 if (!GC_OVERLAYP (overlay
))
2232 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2235 if (endpos
== pos
|| OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
)
2239 for (tail
= current_buffer
->overlays_after
; GC_CONSP (tail
);
2240 tail
= XCONS (tail
)->cdr
)
2244 overlay
= XCONS (tail
)->car
;
2245 if (!GC_OVERLAYP (overlay
))
2248 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2251 if (startpos
== pos
|| OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
)
2259 Lisp_Object overlay
;
2265 compare_overlays (v1
, v2
)
2266 const void *v1
, *v2
;
2268 const struct sortvec
*s1
= (const struct sortvec
*) v1
;
2269 const struct sortvec
*s2
= (const struct sortvec
*) v2
;
2270 if (s1
->priority
!= s2
->priority
)
2271 return s1
->priority
- s2
->priority
;
2272 if (s1
->beg
!= s2
->beg
)
2273 return s1
->beg
- s2
->beg
;
2274 if (s1
->end
!= s2
->end
)
2275 return s2
->end
- s1
->end
;
2279 /* Sort an array of overlays by priority. The array is modified in place.
2280 The return value is the new size; this may be smaller than the original
2281 size if some of the overlays were invalid or were window-specific. */
2283 sort_overlays (overlay_vec
, noverlays
, w
)
2284 Lisp_Object
*overlay_vec
;
2289 struct sortvec
*sortvec
;
2290 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
2292 /* Put the valid and relevant overlays into sortvec. */
2294 for (i
= 0, j
= 0; i
< noverlays
; i
++)
2297 Lisp_Object overlay
;
2299 overlay
= overlay_vec
[i
];
2300 if (OVERLAY_VALID (overlay
)
2301 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
2302 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
2304 /* If we're interested in a specific window, then ignore
2305 overlays that are limited to some other window. */
2310 window
= Foverlay_get (overlay
, Qwindow
);
2311 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2315 /* This overlay is good and counts: put it into sortvec. */
2316 sortvec
[j
].overlay
= overlay
;
2317 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2318 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2319 tem
= Foverlay_get (overlay
, Qpriority
);
2321 sortvec
[j
].priority
= XINT (tem
);
2323 sortvec
[j
].priority
= 0;
2329 /* Sort the overlays into the proper order: increasing priority. */
2332 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
2334 for (i
= 0; i
< noverlays
; i
++)
2335 overlay_vec
[i
] = sortvec
[i
].overlay
;
2341 Lisp_Object string
, string2
;
2348 struct sortstr
*buf
; /* An array that expands as needed; never freed. */
2349 int size
; /* Allocated length of that array. */
2350 int used
; /* How much of the array is currently in use. */
2351 int bytes
; /* Total length of the strings in buf. */
2354 /* Buffers for storing information about the overlays touching a given
2355 position. These could be automatic variables in overlay_strings, but
2356 it's more efficient to hold onto the memory instead of repeatedly
2357 allocating and freeing it. */
2358 static struct sortstrlist overlay_heads
, overlay_tails
;
2359 static unsigned char *overlay_str_buf
;
2361 /* Allocated length of overlay_str_buf. */
2362 static int overlay_str_len
;
2364 /* A comparison function suitable for passing to qsort. */
2366 cmp_for_strings (as1
, as2
)
2369 struct sortstr
*s1
= (struct sortstr
*)as1
;
2370 struct sortstr
*s2
= (struct sortstr
*)as2
;
2371 if (s1
->size
!= s2
->size
)
2372 return s2
->size
- s1
->size
;
2373 if (s1
->priority
!= s2
->priority
)
2374 return s1
->priority
- s2
->priority
;
2379 record_overlay_string (ssl
, str
, str2
, pri
, size
)
2380 struct sortstrlist
*ssl
;
2381 Lisp_Object str
, str2
, pri
;
2386 if (ssl
->used
== ssl
->size
)
2392 ssl
->buf
= ((struct sortstr
*)
2393 xrealloc (ssl
->buf
, ssl
->size
* sizeof (struct sortstr
)));
2395 ssl
->buf
[ssl
->used
].string
= str
;
2396 ssl
->buf
[ssl
->used
].string2
= str2
;
2397 ssl
->buf
[ssl
->used
].size
= size
;
2398 ssl
->buf
[ssl
->used
].priority
= (INTEGERP (pri
) ? XINT (pri
) : 0);
2401 if (NILP (current_buffer
->enable_multibyte_characters
))
2402 nbytes
= XSTRING (str
)->size
;
2403 else if (! STRING_MULTIBYTE (str
))
2404 nbytes
= count_size_as_multibyte (XSTRING (str
)->data
,
2405 STRING_BYTES (XSTRING (str
)));
2407 nbytes
= STRING_BYTES (XSTRING (str
));
2409 ssl
->bytes
+= nbytes
;
2413 if (NILP (current_buffer
->enable_multibyte_characters
))
2414 nbytes
= XSTRING (str2
)->size
;
2415 else if (! STRING_MULTIBYTE (str2
))
2416 nbytes
= count_size_as_multibyte (XSTRING (str2
)->data
,
2417 STRING_BYTES (XSTRING (str2
)));
2419 nbytes
= STRING_BYTES (XSTRING (str2
));
2421 ssl
->bytes
+= nbytes
;
2425 /* Return the concatenation of the strings associated with overlays that
2426 begin or end at POS, ignoring overlays that are specific to a window
2427 other than W. The strings are concatenated in the appropriate order:
2428 shorter overlays nest inside longer ones, and higher priority inside
2429 lower. Normally all of the after-strings come first, but zero-sized
2430 overlays have their after-strings ride along with the before-strings
2431 because it would look strange to print them inside-out.
2433 Returns the string length, and stores the contents indirectly through
2434 PSTR, if that variable is non-null. The string may be overwritten by
2435 subsequent calls. */
2438 overlay_strings (pos
, w
, pstr
)
2441 unsigned char **pstr
;
2443 Lisp_Object ov
, overlay
, window
, str
;
2444 int startpos
, endpos
;
2445 int multibyte
= ! NILP (current_buffer
->enable_multibyte_characters
);
2447 overlay_heads
.used
= overlay_heads
.bytes
= 0;
2448 overlay_tails
.used
= overlay_tails
.bytes
= 0;
2449 for (ov
= current_buffer
->overlays_before
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2451 overlay
= XCONS (ov
)->car
;
2452 if (!OVERLAYP (overlay
))
2455 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2456 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2459 if (endpos
!= pos
&& startpos
!= pos
)
2461 window
= Foverlay_get (overlay
, Qwindow
);
2462 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2465 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2466 record_overlay_string (&overlay_heads
, str
,
2468 ? Foverlay_get (overlay
, Qafter_string
)
2470 Foverlay_get (overlay
, Qpriority
),
2472 else if (endpos
== pos
2473 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2474 record_overlay_string (&overlay_tails
, str
, Qnil
,
2475 Foverlay_get (overlay
, Qpriority
),
2478 for (ov
= current_buffer
->overlays_after
; CONSP (ov
); ov
= XCONS (ov
)->cdr
)
2480 overlay
= XCONS (ov
)->car
;
2481 if (!OVERLAYP (overlay
))
2484 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2485 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2488 if (endpos
!= pos
&& startpos
!= pos
)
2490 window
= Foverlay_get (overlay
, Qwindow
);
2491 if (WINDOWP (window
) && XWINDOW (window
) != w
)
2494 && (str
= Foverlay_get (overlay
, Qbefore_string
), STRINGP (str
)))
2495 record_overlay_string (&overlay_heads
, str
,
2497 ? Foverlay_get (overlay
, Qafter_string
)
2499 Foverlay_get (overlay
, Qpriority
),
2501 else if (endpos
== pos
2502 && (str
= Foverlay_get (overlay
, Qafter_string
), STRINGP (str
)))
2503 record_overlay_string (&overlay_tails
, str
, Qnil
,
2504 Foverlay_get (overlay
, Qpriority
),
2507 if (overlay_tails
.used
> 1)
2508 qsort (overlay_tails
.buf
, overlay_tails
.used
, sizeof (struct sortstr
),
2510 if (overlay_heads
.used
> 1)
2511 qsort (overlay_heads
.buf
, overlay_heads
.used
, sizeof (struct sortstr
),
2513 if (overlay_heads
.bytes
|| overlay_tails
.bytes
)
2518 int total
= overlay_heads
.bytes
+ overlay_tails
.bytes
;
2520 if (total
> overlay_str_len
)
2522 overlay_str_len
= total
;
2523 overlay_str_buf
= (unsigned char *)xrealloc (overlay_str_buf
,
2526 p
= overlay_str_buf
;
2527 for (i
= overlay_tails
.used
; --i
>= 0;)
2530 tem
= overlay_tails
.buf
[i
].string
;
2531 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2532 STRING_BYTES (XSTRING (tem
)),
2533 STRING_MULTIBYTE (tem
), multibyte
);
2536 for (i
= 0; i
< overlay_heads
.used
; ++i
)
2539 tem
= overlay_heads
.buf
[i
].string
;
2540 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2541 STRING_BYTES (XSTRING (tem
)),
2542 STRING_MULTIBYTE (tem
), multibyte
);
2544 tem
= overlay_heads
.buf
[i
].string2
;
2547 nbytes
= copy_text (XSTRING (tem
)->data
, p
,
2548 STRING_BYTES (XSTRING (tem
)),
2549 STRING_MULTIBYTE (tem
), multibyte
);
2553 if (p
!= overlay_str_buf
+ total
)
2556 *pstr
= overlay_str_buf
;
2562 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
2565 recenter_overlay_lists (buf
, pos
)
2569 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
2571 /* See if anything in overlays_before should move to overlays_after. */
2573 /* We don't strictly need prev in this loop; it should always be nil.
2574 But we use it for symmetry and in case that should cease to be true
2575 with some future change. */
2577 for (tail
= buf
->overlays_before
;
2579 prev
= tail
, tail
= next
)
2581 next
= XCONS (tail
)->cdr
;
2582 overlay
= XCONS (tail
)->car
;
2584 /* If the overlay is not valid, get rid of it. */
2585 if (!OVERLAY_VALID (overlay
))
2590 /* Splice the cons cell TAIL out of overlays_before. */
2592 XCONS (prev
)->cdr
= next
;
2594 buf
->overlays_before
= next
;
2600 beg
= OVERLAY_START (overlay
);
2601 end
= OVERLAY_END (overlay
);
2603 if (OVERLAY_POSITION (end
) > pos
)
2605 /* OVERLAY needs to be moved. */
2606 int where
= OVERLAY_POSITION (beg
);
2607 Lisp_Object other
, other_prev
;
2609 /* Splice the cons cell TAIL out of overlays_before. */
2611 XCONS (prev
)->cdr
= next
;
2613 buf
->overlays_before
= next
;
2615 /* Search thru overlays_after for where to put it. */
2617 for (other
= buf
->overlays_after
;
2619 other_prev
= other
, other
= XCONS (other
)->cdr
)
2621 Lisp_Object otherbeg
, otheroverlay
, follower
;
2624 otheroverlay
= XCONS (other
)->car
;
2625 if (! OVERLAY_VALID (otheroverlay
))
2628 otherbeg
= OVERLAY_START (otheroverlay
);
2629 if (OVERLAY_POSITION (otherbeg
) >= where
)
2633 /* Add TAIL to overlays_after before OTHER. */
2634 XCONS (tail
)->cdr
= other
;
2635 if (!NILP (other_prev
))
2636 XCONS (other_prev
)->cdr
= tail
;
2638 buf
->overlays_after
= tail
;
2642 /* We've reached the things that should stay in overlays_before.
2643 All the rest of overlays_before must end even earlier,
2648 /* See if anything in overlays_after should be in overlays_before. */
2650 for (tail
= buf
->overlays_after
;
2652 prev
= tail
, tail
= next
)
2654 next
= XCONS (tail
)->cdr
;
2655 overlay
= XCONS (tail
)->car
;
2657 /* If the overlay is not valid, get rid of it. */
2658 if (!OVERLAY_VALID (overlay
))
2663 /* Splice the cons cell TAIL out of overlays_after. */
2665 XCONS (prev
)->cdr
= next
;
2667 buf
->overlays_after
= next
;
2673 beg
= OVERLAY_START (overlay
);
2674 end
= OVERLAY_END (overlay
);
2676 /* Stop looking, when we know that nothing further
2677 can possibly end before POS. */
2678 if (OVERLAY_POSITION (beg
) > pos
)
2681 if (OVERLAY_POSITION (end
) <= pos
)
2683 /* OVERLAY needs to be moved. */
2684 int where
= OVERLAY_POSITION (end
);
2685 Lisp_Object other
, other_prev
;
2687 /* Splice the cons cell TAIL out of overlays_after. */
2689 XCONS (prev
)->cdr
= next
;
2691 buf
->overlays_after
= next
;
2693 /* Search thru overlays_before for where to put it. */
2695 for (other
= buf
->overlays_before
;
2697 other_prev
= other
, other
= XCONS (other
)->cdr
)
2699 Lisp_Object otherend
, otheroverlay
;
2702 otheroverlay
= XCONS (other
)->car
;
2703 if (! OVERLAY_VALID (otheroverlay
))
2706 otherend
= OVERLAY_END (otheroverlay
);
2707 if (OVERLAY_POSITION (otherend
) <= where
)
2711 /* Add TAIL to overlays_before before OTHER. */
2712 XCONS (tail
)->cdr
= other
;
2713 if (!NILP (other_prev
))
2714 XCONS (other_prev
)->cdr
= tail
;
2716 buf
->overlays_before
= tail
;
2721 XSETFASTINT (buf
->overlay_center
, pos
);
2725 adjust_overlays_for_insert (pos
, length
)
2729 /* After an insertion, the lists are still sorted properly,
2730 but we may need to update the value of the overlay center. */
2731 if (XFASTINT (current_buffer
->overlay_center
) >= pos
)
2732 XSETFASTINT (current_buffer
->overlay_center
,
2733 XFASTINT (current_buffer
->overlay_center
) + length
);
2737 adjust_overlays_for_delete (pos
, length
)
2741 if (XFASTINT (current_buffer
->overlay_center
) < pos
)
2742 /* The deletion was to our right. No change needed; the before- and
2743 after-lists are still consistent. */
2745 else if (XFASTINT (current_buffer
->overlay_center
) > pos
+ length
)
2746 /* The deletion was to our left. We need to adjust the center value
2747 to account for the change in position, but the lists are consistent
2748 given the new value. */
2749 XSETFASTINT (current_buffer
->overlay_center
,
2750 XFASTINT (current_buffer
->overlay_center
) - length
);
2752 /* We're right in the middle. There might be things on the after-list
2753 that now belong on the before-list. Recentering will move them,
2754 and also update the center point. */
2755 recenter_overlay_lists (current_buffer
, pos
);
2758 /* Fix up overlays that were garbled as a result of permuting markers
2759 in the range START through END. Any overlay with at least one
2760 endpoint in this range will need to be unlinked from the overlay
2761 list and reinserted in its proper place.
2762 Such an overlay might even have negative size at this point.
2763 If so, we'll reverse the endpoints. Can you think of anything
2764 better to do in this situation? */
2766 fix_overlays_in_range (start
, end
)
2767 register int start
, end
;
2769 Lisp_Object tem
, overlay
;
2770 Lisp_Object before_list
, after_list
;
2771 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
2772 int startpos
, endpos
;
2774 /* This algorithm shifts links around instead of consing and GCing.
2775 The loop invariant is that before_list (resp. after_list) is a
2776 well-formed list except that its last element, the one that
2777 *pbefore (resp. *pafter) points to, is still uninitialized.
2778 So it's not a bug that before_list isn't initialized, although
2779 it may look strange. */
2780 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
2782 overlay
= XCONS (*ptail
)->car
;
2783 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2786 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2788 || (startpos
>= start
&& startpos
< end
))
2790 /* If the overlay is backwards, fix that now. */
2791 if (startpos
> endpos
)
2794 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2796 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2798 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2800 /* Add it to the end of the wrong list. Later on,
2801 recenter_overlay_lists will move it to the right place. */
2802 if (endpos
< XINT (current_buffer
->overlay_center
))
2805 pafter
= &XCONS (*ptail
)->cdr
;
2810 pbefore
= &XCONS (*ptail
)->cdr
;
2812 *ptail
= XCONS (*ptail
)->cdr
;
2815 ptail
= &XCONS (*ptail
)->cdr
;
2817 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
2819 overlay
= XCONS (*ptail
)->car
;
2820 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2821 if (startpos
>= end
)
2823 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2824 if (startpos
>= start
2825 || (endpos
>= start
&& endpos
< end
))
2827 if (startpos
> endpos
)
2830 Fset_marker (OVERLAY_START (overlay
), make_number (endpos
),
2832 Fset_marker (OVERLAY_END (overlay
), make_number (startpos
),
2834 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
2836 if (endpos
< XINT (current_buffer
->overlay_center
))
2839 pafter
= &XCONS (*ptail
)->cdr
;
2844 pbefore
= &XCONS (*ptail
)->cdr
;
2846 *ptail
= XCONS (*ptail
)->cdr
;
2849 ptail
= &XCONS (*ptail
)->cdr
;
2852 /* Splice the constructed (wrong) lists into the buffer's lists,
2853 and let the recenter function make it sane again. */
2854 *pbefore
= current_buffer
->overlays_before
;
2855 current_buffer
->overlays_before
= before_list
;
2856 recenter_overlay_lists (current_buffer
,
2857 XINT (current_buffer
->overlay_center
));
2859 *pafter
= current_buffer
->overlays_after
;
2860 current_buffer
->overlays_after
= after_list
;
2861 recenter_overlay_lists (current_buffer
,
2862 XINT (current_buffer
->overlay_center
));
2865 /* We have two types of overlay: the one whose ending marker is
2866 after-insertion-marker (this is the usual case) and the one whose
2867 ending marker is before-insertion-marker. When `overlays_before'
2868 contains overlays of the latter type and the former type in this
2869 order and both overlays end at inserting position, inserting a text
2870 increases only the ending marker of the latter type, which results
2871 in incorrect ordering of `overlays_before'.
2873 This function fixes ordering of overlays in the slot
2874 `overlays_before' of the buffer *BP. Before the insertion, `point'
2875 was at PREV, and now is at POS. */
2878 fix_overlays_before (bp
, prev
, pos
)
2882 Lisp_Object
*tailp
= &bp
->overlays_before
;
2883 Lisp_Object
*right_place
;
2886 /* After the insertion, the several overlays may be in incorrect
2887 order. The possibility is that, in the list `overlays_before',
2888 an overlay which ends at POS appears after an overlay which ends
2889 at PREV. Since POS is greater than PREV, we must fix the
2890 ordering of these overlays, by moving overlays ends at POS before
2891 the overlays ends at PREV. */
2893 /* At first, find a place where disordered overlays should be linked
2894 in. It is where an overlay which end before POS exists. (i.e. an
2895 overlay whose ending marker is after-insertion-marker if disorder
2897 while (!NILP (*tailp
)
2898 && ((end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
)))
2900 tailp
= &XCONS (*tailp
)->cdr
;
2902 /* If we don't find such an overlay,
2903 or the found one ends before PREV,
2904 or the found one is the last one in the list,
2905 we don't have to fix anything. */
2908 || NILP (XCONS (*tailp
)->cdr
))
2911 right_place
= tailp
;
2912 tailp
= &XCONS (*tailp
)->cdr
;
2914 /* Now, end position of overlays in the list *TAILP should be before
2915 or equal to PREV. In the loop, an overlay which ends at POS is
2916 moved ahead to the place pointed by RIGHT_PLACE. If we found an
2917 overlay which ends before PREV, the remaining overlays are in
2919 while (!NILP (*tailp
))
2921 end
= OVERLAY_POSITION (OVERLAY_END (XCONS (*tailp
)->car
));
2924 { /* This overlay is disordered. */
2925 Lisp_Object found
= *tailp
;
2927 /* Unlink the found overlay. */
2928 *tailp
= XCONS (found
)->cdr
;
2929 /* Move an overlay at RIGHT_PLACE to the next of the found one. */
2930 XCONS (found
)->cdr
= *right_place
;
2931 /* Link it into the right place. */
2932 *right_place
= found
;
2934 else if (end
== prev
)
2935 tailp
= &XCONS (*tailp
)->cdr
;
2936 else /* No more disordered overlay. */
2941 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
2942 "Return t if OBJECT is an overlay.")
2946 return (OVERLAYP (object
) ? Qt
: Qnil
);
2949 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 5, 0,
2950 "Create a new overlay with range BEG to END in BUFFER.\n\
2951 If omitted, BUFFER defaults to the current buffer.\n\
2952 BEG and END may be integers or markers.\n\
2953 The fourth arg FRONT-ADVANCE, if non-nil, makes the\n\
2954 front delimiter advance when text is inserted there.\n\
2955 The fifth arg REAR-ADVANCE, if non-nil, makes the\n\
2956 rear delimiter advance when text is inserted there.")
2957 (beg
, end
, buffer
, front_advance
, rear_advance
)
2958 Lisp_Object beg
, end
, buffer
;
2959 Lisp_Object front_advance
, rear_advance
;
2961 Lisp_Object overlay
;
2965 XSETBUFFER (buffer
, current_buffer
);
2967 CHECK_BUFFER (buffer
, 2);
2969 && ! EQ (Fmarker_buffer (beg
), buffer
))
2970 error ("Marker points into wrong buffer");
2972 && ! EQ (Fmarker_buffer (end
), buffer
))
2973 error ("Marker points into wrong buffer");
2975 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
2976 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2978 if (XINT (beg
) > XINT (end
))
2981 temp
= beg
; beg
= end
; end
= temp
;
2984 b
= XBUFFER (buffer
);
2986 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
2987 end
= Fset_marker (Fmake_marker (), end
, buffer
);
2989 if (!NILP (front_advance
))
2990 XMARKER (beg
)->insertion_type
= 1;
2991 if (!NILP (rear_advance
))
2992 XMARKER (end
)->insertion_type
= 1;
2994 overlay
= allocate_misc ();
2995 XMISCTYPE (overlay
) = Lisp_Misc_Overlay
;
2996 XOVERLAY (overlay
)->start
= beg
;
2997 XOVERLAY (overlay
)->end
= end
;
2998 XOVERLAY (overlay
)->plist
= Qnil
;
3000 /* Put the new overlay on the wrong list. */
3001 end
= OVERLAY_END (overlay
);
3002 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3003 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3005 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3007 /* This puts it in the right list, and in the right order. */
3008 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3010 /* We don't need to redisplay the region covered by the overlay, because
3011 the overlay has no properties at the moment. */
3016 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3019 modify_overlay (buf
, start
, end
)
3029 start
= end
; end
= temp
;
3032 /* If this is a buffer not in the selected window,
3033 we must do other windows. */
3034 if (buf
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
3035 windows_or_buffers_changed
= 1;
3036 /* If it's not current, we can't use beg_unchanged, end_unchanged for it. */
3037 else if (buf
!= current_buffer
)
3038 windows_or_buffers_changed
= 1;
3039 /* If multiple windows show this buffer, we must do other windows. */
3040 else if (buffer_shared
> 1)
3041 windows_or_buffers_changed
= 1;
3044 if (unchanged_modified
== MODIFF
3045 && overlay_unchanged_modified
== OVERLAY_MODIFF
)
3047 beg_unchanged
= start
- BEG
;
3048 end_unchanged
= Z
- end
;
3052 if (Z
- end
< end_unchanged
)
3053 end_unchanged
= Z
- end
;
3054 if (start
- BEG
< beg_unchanged
)
3055 beg_unchanged
= start
- BEG
;
3059 ++BUF_OVERLAY_MODIFF (buf
);
3063 Lisp_Object
Fdelete_overlay ();
3065 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
3066 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
3067 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
3068 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
3070 (overlay
, beg
, end
, buffer
)
3071 Lisp_Object overlay
, beg
, end
, buffer
;
3073 struct buffer
*b
, *ob
;
3074 Lisp_Object obuffer
;
3075 int count
= specpdl_ptr
- specpdl
;
3077 CHECK_OVERLAY (overlay
, 0);
3079 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3081 XSETBUFFER (buffer
, current_buffer
);
3082 CHECK_BUFFER (buffer
, 3);
3085 && ! EQ (Fmarker_buffer (beg
), buffer
))
3086 error ("Marker points into wrong buffer");
3088 && ! EQ (Fmarker_buffer (end
), buffer
))
3089 error ("Marker points into wrong buffer");
3091 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
3092 CHECK_NUMBER_COERCE_MARKER (end
, 1);
3094 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3095 return Fdelete_overlay (overlay
);
3097 if (XINT (beg
) > XINT (end
))
3100 temp
= beg
; beg
= end
; end
= temp
;
3103 specbind (Qinhibit_quit
, Qt
);
3105 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3106 b
= XBUFFER (buffer
);
3107 ob
= XBUFFER (obuffer
);
3109 /* If the overlay has changed buffers, do a thorough redisplay. */
3110 if (!EQ (buffer
, obuffer
))
3112 /* Redisplay where the overlay was. */
3113 if (!NILP (obuffer
))
3118 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3119 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3121 modify_overlay (ob
, o_beg
, o_end
);
3124 /* Redisplay where the overlay is going to be. */
3125 modify_overlay (b
, XINT (beg
), XINT (end
));
3128 /* Redisplay the area the overlay has just left, or just enclosed. */
3131 int change_beg
, change_end
;
3133 o_beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3134 o_end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3136 if (o_beg
== XINT (beg
))
3137 modify_overlay (b
, o_end
, XINT (end
));
3138 else if (o_end
== XINT (end
))
3139 modify_overlay (b
, o_beg
, XINT (beg
));
3142 if (XINT (beg
) < o_beg
) o_beg
= XINT (beg
);
3143 if (XINT (end
) > o_end
) o_end
= XINT (end
);
3144 modify_overlay (b
, o_beg
, o_end
);
3148 if (!NILP (obuffer
))
3150 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
3151 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
3154 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
3155 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
3157 /* Put the overlay on the wrong list. */
3158 end
= OVERLAY_END (overlay
);
3159 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
3160 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
3162 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
3164 /* This puts it in the right list, and in the right order. */
3165 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
3167 return unbind_to (count
, overlay
);
3170 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
3171 "Delete the overlay OVERLAY from its buffer.")
3173 Lisp_Object overlay
;
3177 int count
= specpdl_ptr
- specpdl
;
3179 CHECK_OVERLAY (overlay
, 0);
3181 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3185 b
= XBUFFER (buffer
);
3187 specbind (Qinhibit_quit
, Qt
);
3189 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
3190 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
3193 marker_position (OVERLAY_START (overlay
)),
3194 marker_position (OVERLAY_END (overlay
)));
3196 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
3197 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
3199 return unbind_to (count
, Qnil
);
3202 /* Overlay dissection functions. */
3204 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
3205 "Return the position at which OVERLAY starts.")
3207 Lisp_Object overlay
;
3209 CHECK_OVERLAY (overlay
, 0);
3211 return (Fmarker_position (OVERLAY_START (overlay
)));
3214 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
3215 "Return the position at which OVERLAY ends.")
3217 Lisp_Object overlay
;
3219 CHECK_OVERLAY (overlay
, 0);
3221 return (Fmarker_position (OVERLAY_END (overlay
)));
3224 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
3225 "Return the buffer OVERLAY belongs to.")
3227 Lisp_Object overlay
;
3229 CHECK_OVERLAY (overlay
, 0);
3231 return Fmarker_buffer (OVERLAY_START (overlay
));
3234 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
3235 "Return a list of the properties on OVERLAY.\n\
3236 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
3239 Lisp_Object overlay
;
3241 CHECK_OVERLAY (overlay
, 0);
3243 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
3247 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
3248 "Return a list of the overlays that contain position POS.")
3253 Lisp_Object
*overlay_vec
;
3257 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3260 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3262 /* Put all the overlays we want in a vector in overlay_vec.
3263 Store the length in len. */
3264 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3265 (int *) 0, (int *) 0);
3267 /* Make a list of them all. */
3268 result
= Flist (noverlays
, overlay_vec
);
3270 xfree (overlay_vec
);
3274 DEFUN ("overlays-in", Foverlays_in
, Soverlays_in
, 2, 2, 0,
3275 "Return a list of the overlays that overlap the region BEG ... END.\n\
3276 Overlap means that at least one character is contained within the overlay\n\
3277 and also contained within the specified region.\n\
3278 Empty overlays are included in the result if they are located at BEG\n\
3279 or between BEG and END.")
3281 Lisp_Object beg
, end
;
3284 Lisp_Object
*overlay_vec
;
3288 CHECK_NUMBER_COERCE_MARKER (beg
, 0);
3289 CHECK_NUMBER_COERCE_MARKER (end
, 0);
3292 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3294 /* Put all the overlays we want in a vector in overlay_vec.
3295 Store the length in len. */
3296 noverlays
= overlays_in (XINT (beg
), XINT (end
), 1, &overlay_vec
, &len
,
3297 (int *) 0, (int *) 0);
3299 /* Make a list of them all. */
3300 result
= Flist (noverlays
, overlay_vec
);
3302 xfree (overlay_vec
);
3306 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
3308 "Return the next position after POS where an overlay starts or ends.\n\
3309 If there are no more overlay boundaries after POS, return (point-max).")
3315 Lisp_Object
*overlay_vec
;
3319 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3322 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3324 /* Put all the overlays we want in a vector in overlay_vec.
3325 Store the length in len.
3326 endpos gets the position where the next overlay starts. */
3327 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3328 &endpos
, (int *) 0);
3330 /* If any of these overlays ends before endpos,
3331 use its ending point instead. */
3332 for (i
= 0; i
< noverlays
; i
++)
3337 oend
= OVERLAY_END (overlay_vec
[i
]);
3338 oendpos
= OVERLAY_POSITION (oend
);
3339 if (oendpos
< endpos
)
3343 xfree (overlay_vec
);
3344 return make_number (endpos
);
3347 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
3348 Sprevious_overlay_change
, 1, 1, 0,
3349 "Return the previous position before POS where an overlay starts or ends.\n\
3350 If there are no more overlay boundaries before POS, return (point-min).")
3356 Lisp_Object
*overlay_vec
;
3361 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3364 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
3366 /* At beginning of buffer, we know the answer;
3367 avoid bug subtracting 1 below. */
3368 if (XINT (pos
) == BEGV
)
3371 /* Put all the overlays we want in a vector in overlay_vec.
3372 Store the length in len.
3373 prevpos gets the position of an overlay end. */
3374 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
,
3375 (int *) 0, &prevpos
);
3377 /* If any of these overlays starts after prevpos,
3378 maybe use its starting point instead. */
3379 for (i
= 0; i
< noverlays
; i
++)
3384 ostart
= OVERLAY_START (overlay_vec
[i
]);
3385 ostartpos
= OVERLAY_POSITION (ostart
);
3386 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
3387 prevpos
= ostartpos
;
3390 /* If any overlay ends at pos, consider its starting point too. */
3391 for (tail
= current_buffer
->overlays_before
;
3393 tail
= XCONS (tail
)->cdr
)
3395 Lisp_Object overlay
, ostart
;
3398 overlay
= XCONS (tail
)->car
;
3400 ostart
= OVERLAY_START (overlay
);
3401 ostartpos
= OVERLAY_POSITION (ostart
);
3402 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
3403 prevpos
= ostartpos
;
3406 xfree (overlay_vec
);
3407 return make_number (prevpos
);
3410 /* These functions are for debugging overlays. */
3412 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
3413 "Return a pair of lists giving all the overlays of the current buffer.\n\
3414 The car has all the overlays before the overlay center;\n\
3415 the cdr has all the overlays after the overlay center.\n\
3416 Recentering overlays moves overlays between these lists.\n\
3417 The lists you get are copies, so that changing them has no effect.\n\
3418 However, the overlays you get are the real objects that the buffer uses.")
3421 Lisp_Object before
, after
;
3422 before
= current_buffer
->overlays_before
;
3424 before
= Fcopy_sequence (before
);
3425 after
= current_buffer
->overlays_after
;
3427 after
= Fcopy_sequence (after
);
3429 return Fcons (before
, after
);
3432 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
3433 "Recenter the overlays of the current buffer around position POS.")
3437 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
3439 recenter_overlay_lists (current_buffer
, XINT (pos
));
3443 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
3444 "Get the property of overlay OVERLAY with property name PROP.")
3446 Lisp_Object overlay
, prop
;
3448 Lisp_Object plist
, fallback
;
3450 CHECK_OVERLAY (overlay
, 0);
3454 for (plist
= XOVERLAY (overlay
)->plist
;
3455 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
3456 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
3458 if (EQ (XCONS (plist
)->car
, prop
))
3459 return XCONS (XCONS (plist
)->cdr
)->car
;
3460 else if (EQ (XCONS (plist
)->car
, Qcategory
))
3463 tem
= Fcar (Fcdr (plist
));
3465 fallback
= Fget (tem
, prop
);
3472 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
3473 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
3474 (overlay
, prop
, value
)
3475 Lisp_Object overlay
, prop
, value
;
3477 Lisp_Object tail
, buffer
;
3480 CHECK_OVERLAY (overlay
, 0);
3482 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
3484 for (tail
= XOVERLAY (overlay
)->plist
;
3485 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
3486 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
3487 if (EQ (XCONS (tail
)->car
, prop
))
3489 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
3490 XCONS (XCONS (tail
)->cdr
)->car
= value
;
3493 /* It wasn't in the list, so add it to the front. */
3494 changed
= !NILP (value
);
3495 XOVERLAY (overlay
)->plist
3496 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
3498 if (! NILP (buffer
))
3501 modify_overlay (XBUFFER (buffer
),
3502 marker_position (OVERLAY_START (overlay
)),
3503 marker_position (OVERLAY_END (overlay
)));
3504 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
3505 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
3506 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
3507 Fdelete_overlay (overlay
);
3512 /* Subroutine of report_overlay_modification. */
3514 /* Lisp vector holding overlay hook functions to call.
3515 Vector elements come in pairs.
3516 Each even-index element is a list of hook functions.
3517 The following odd-index element is the overlay they came from.
3519 Before the buffer change, we fill in this vector
3520 as we call overlay hook functions.
3521 After the buffer change, we get the functions to call from this vector.
3522 This way we always call the same functions before and after the change. */
3523 static Lisp_Object last_overlay_modification_hooks
;
3525 /* Number of elements actually used in last_overlay_modification_hooks. */
3526 static int last_overlay_modification_hooks_used
;
3528 /* Add one functionlist/overlay pair
3529 to the end of last_overlay_modification_hooks. */
3532 add_overlay_mod_hooklist (functionlist
, overlay
)
3533 Lisp_Object functionlist
, overlay
;
3535 int oldsize
= XVECTOR (last_overlay_modification_hooks
)->size
;
3537 if (last_overlay_modification_hooks_used
== oldsize
)
3540 old
= last_overlay_modification_hooks
;
3541 last_overlay_modification_hooks
3542 = Fmake_vector (make_number (oldsize
* 2), Qnil
);
3543 bcopy (XVECTOR (old
)->contents
,
3544 XVECTOR (last_overlay_modification_hooks
)->contents
,
3545 sizeof (Lisp_Object
) * oldsize
);
3547 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = functionlist
;
3548 XVECTOR (last_overlay_modification_hooks
)->contents
[last_overlay_modification_hooks_used
++] = overlay
;
3551 /* Run the modification-hooks of overlays that include
3552 any part of the text in START to END.
3553 If this change is an insertion, also
3554 run the insert-before-hooks of overlay starting at END,
3555 and the insert-after-hooks of overlay ending at START.
3557 This is called both before and after the modification.
3558 AFTER is nonzero when we call after the modification.
3560 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
3561 When AFTER is nonzero, they are the start position,
3562 the position after the inserted new text,
3563 and the length of deleted or replaced old text. */
3566 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
3567 Lisp_Object start
, end
;
3569 Lisp_Object arg1
, arg2
, arg3
;
3571 Lisp_Object prop
, overlay
, tail
;
3572 /* 1 if this change is an insertion. */
3573 int insertion
= (after
? XFASTINT (arg3
) == 0 : EQ (start
, end
));
3575 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
3579 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
3583 /* Call the functions recorded in last_overlay_modification_hooks
3584 rather than scanning the overlays again.
3585 First copy the vector contents, in case some of these hooks
3586 do subsequent modification of the buffer. */
3587 int size
= last_overlay_modification_hooks_used
;
3588 Lisp_Object
*copy
= (Lisp_Object
*) alloca (size
* sizeof (Lisp_Object
));
3591 bcopy (XVECTOR (last_overlay_modification_hooks
)->contents
,
3592 copy
, size
* sizeof (Lisp_Object
));
3594 gcpro1
.nvars
= size
;
3596 for (i
= 0; i
< size
;)
3598 Lisp_Object prop
, overlay
;
3600 overlay
= copy
[i
++];
3601 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3607 /* We are being called before a change.
3608 Scan the overlays to find the functions to call. */
3609 last_overlay_modification_hooks_used
= 0;
3611 for (tail
= current_buffer
->overlays_before
;
3613 tail
= XCONS (tail
)->cdr
)
3615 int startpos
, endpos
;
3616 Lisp_Object ostart
, oend
;
3618 overlay
= XCONS (tail
)->car
;
3620 ostart
= OVERLAY_START (overlay
);
3621 oend
= OVERLAY_END (overlay
);
3622 endpos
= OVERLAY_POSITION (oend
);
3623 if (XFASTINT (start
) > endpos
)
3625 startpos
= OVERLAY_POSITION (ostart
);
3626 if (insertion
&& (XFASTINT (start
) == startpos
3627 || XFASTINT (end
) == startpos
))
3629 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3632 /* Copy TAIL in case the hook recenters the overlay lists. */
3634 tail
= Fcopy_sequence (tail
);
3636 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3639 if (insertion
&& (XFASTINT (start
) == endpos
3640 || XFASTINT (end
) == endpos
))
3642 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3646 tail
= Fcopy_sequence (tail
);
3648 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3651 /* Test for intersecting intervals. This does the right thing
3652 for both insertion and deletion. */
3653 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3655 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3659 tail
= Fcopy_sequence (tail
);
3661 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3667 for (tail
= current_buffer
->overlays_after
;
3669 tail
= XCONS (tail
)->cdr
)
3671 int startpos
, endpos
;
3672 Lisp_Object ostart
, oend
;
3674 overlay
= XCONS (tail
)->car
;
3676 ostart
= OVERLAY_START (overlay
);
3677 oend
= OVERLAY_END (overlay
);
3678 startpos
= OVERLAY_POSITION (ostart
);
3679 endpos
= OVERLAY_POSITION (oend
);
3680 if (XFASTINT (end
) < startpos
)
3682 if (insertion
&& (XFASTINT (start
) == startpos
3683 || XFASTINT (end
) == startpos
))
3685 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
3689 tail
= Fcopy_sequence (tail
);
3691 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3694 if (insertion
&& (XFASTINT (start
) == endpos
3695 || XFASTINT (end
) == endpos
))
3697 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
3701 tail
= Fcopy_sequence (tail
);
3703 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3706 /* Test for intersecting intervals. This does the right thing
3707 for both insertion and deletion. */
3708 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
3710 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
3714 tail
= Fcopy_sequence (tail
);
3716 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
3725 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
3726 Lisp_Object list
, overlay
;
3728 Lisp_Object arg1
, arg2
, arg3
;
3730 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
3732 GCPRO4 (list
, arg1
, arg2
, arg3
);
3734 add_overlay_mod_hooklist (list
, overlay
);
3736 while (!NILP (list
))
3739 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
3741 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
3747 /* Delete any zero-sized overlays at position POS, if the `evaporate'
3750 evaporate_overlays (pos
)
3753 Lisp_Object tail
, overlay
, hit_list
;
3756 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
3757 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
3758 tail
= XCONS (tail
)->cdr
)
3761 overlay
= XCONS (tail
)->car
;
3762 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
3765 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
3766 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3767 hit_list
= Fcons (overlay
, hit_list
);
3770 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
3771 tail
= XCONS (tail
)->cdr
)
3774 overlay
= XCONS (tail
)->car
;
3775 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
3778 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
3779 && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
3780 hit_list
= Fcons (overlay
, hit_list
);
3782 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
3783 Fdelete_overlay (XCONS (hit_list
)->car
);
3786 /* Somebody has tried to store a value with an unacceptable type
3787 in the slot with offset OFFSET. */
3790 buffer_slot_type_mismatch (offset
)
3795 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
3796 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
3798 case Lisp_Int
: type_name
= "integers"; break;
3799 case Lisp_String
: type_name
= "strings"; break;
3800 case Lisp_Symbol
: type_name
= "symbols"; break;
3806 error ("Only %s should be stored in the buffer-local variable %s",
3807 type_name
, XSYMBOL (sym
)->name
->data
);
3813 register Lisp_Object tem
;
3815 buffer_permanent_local_flags
= 0;
3817 /* Make sure all markable slots in buffer_defaults
3818 are initialized reasonably, so mark_buffer won't choke. */
3819 reset_buffer (&buffer_defaults
);
3820 reset_buffer_local_variables (&buffer_defaults
, 1);
3821 reset_buffer (&buffer_local_symbols
);
3822 reset_buffer_local_variables (&buffer_local_symbols
, 1);
3823 /* Prevent GC from getting confused. */
3824 buffer_defaults
.text
= &buffer_defaults
.own_text
;
3825 buffer_local_symbols
.text
= &buffer_local_symbols
.own_text
;
3826 #ifdef USE_TEXT_PROPERTIES
3827 BUF_INTERVALS (&buffer_defaults
) = 0;
3828 BUF_INTERVALS (&buffer_local_symbols
) = 0;
3830 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
3831 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
3833 /* Set up the default values of various buffer slots. */
3834 /* Must do these before making the first buffer! */
3836 /* real setup is done in loaddefs.el */
3837 buffer_defaults
.mode_line_format
= build_string ("%-");
3838 buffer_defaults
.abbrev_mode
= Qnil
;
3839 buffer_defaults
.overwrite_mode
= Qnil
;
3840 buffer_defaults
.case_fold_search
= Qt
;
3841 buffer_defaults
.auto_fill_function
= Qnil
;
3842 buffer_defaults
.selective_display
= Qnil
;
3844 buffer_defaults
.selective_display_ellipses
= Qt
;
3846 buffer_defaults
.abbrev_table
= Qnil
;
3847 buffer_defaults
.display_table
= Qnil
;
3848 buffer_defaults
.undo_list
= Qnil
;
3849 buffer_defaults
.mark_active
= Qnil
;
3850 buffer_defaults
.file_format
= Qnil
;
3851 buffer_defaults
.overlays_before
= Qnil
;
3852 buffer_defaults
.overlays_after
= Qnil
;
3853 XSETFASTINT (buffer_defaults
.overlay_center
, BEG
);
3855 XSETFASTINT (buffer_defaults
.tab_width
, 8);
3856 buffer_defaults
.truncate_lines
= Qnil
;
3857 buffer_defaults
.ctl_arrow
= Qt
;
3858 buffer_defaults
.direction_reversed
= Qnil
;
3861 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
3863 buffer_defaults
.enable_multibyte_characters
= Qt
;
3864 buffer_defaults
.buffer_file_coding_system
= Qnil
;
3865 XSETFASTINT (buffer_defaults
.fill_column
, 70);
3866 XSETFASTINT (buffer_defaults
.left_margin
, 0);
3867 buffer_defaults
.cache_long_line_scans
= Qnil
;
3868 buffer_defaults
.file_truename
= Qnil
;
3869 XSETFASTINT (buffer_defaults
.display_count
, 0);
3870 buffer_defaults
.display_time
= Qnil
;
3872 /* Assign the local-flags to the slots that have default values.
3873 The local flag is a bit that is used in the buffer
3874 to say that it has its own local value for the slot.
3875 The local flag bits are in the local_var_flags slot of the buffer. */
3877 /* Nothing can work if this isn't true */
3878 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
3880 /* 0 means not a lisp var, -1 means always local, else mask */
3881 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
3882 XSETINT (buffer_local_flags
.filename
, -1);
3883 XSETINT (buffer_local_flags
.directory
, -1);
3884 XSETINT (buffer_local_flags
.backed_up
, -1);
3885 XSETINT (buffer_local_flags
.save_length
, -1);
3886 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
3887 XSETINT (buffer_local_flags
.read_only
, -1);
3888 XSETINT (buffer_local_flags
.major_mode
, -1);
3889 XSETINT (buffer_local_flags
.mode_name
, -1);
3890 XSETINT (buffer_local_flags
.undo_list
, -1);
3891 XSETINT (buffer_local_flags
.mark_active
, -1);
3892 XSETINT (buffer_local_flags
.point_before_scroll
, -1);
3893 XSETINT (buffer_local_flags
.file_truename
, -1);
3894 XSETINT (buffer_local_flags
.invisibility_spec
, -1);
3895 XSETINT (buffer_local_flags
.file_format
, -1);
3896 XSETINT (buffer_local_flags
.display_count
, -1);
3897 XSETINT (buffer_local_flags
.display_time
, -1);
3898 XSETINT (buffer_local_flags
.enable_multibyte_characters
, -1);
3900 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
3901 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
3902 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
3903 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
3904 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
3905 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
3907 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
3909 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
3910 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
3911 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
3912 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
3913 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
3914 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
3915 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
3917 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
3918 /* Make this one a permanent local. */
3919 buffer_permanent_local_flags
|= 0x4000;
3921 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
3922 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
3923 XSETFASTINT (buffer_local_flags
.category_table
, 0x20000);
3924 XSETFASTINT (buffer_local_flags
.direction_reversed
, 0x40000);
3925 XSETFASTINT (buffer_local_flags
.buffer_file_coding_system
, 0x80000);
3926 /* Make this one a permanent local. */
3927 buffer_permanent_local_flags
|= 0x80000;
3929 Vbuffer_alist
= Qnil
;
3933 QSFundamental
= build_string ("Fundamental");
3935 Qfundamental_mode
= intern ("fundamental-mode");
3936 buffer_defaults
.major_mode
= Qfundamental_mode
;
3938 Qmode_class
= intern ("mode-class");
3940 Qprotected_field
= intern ("protected-field");
3942 Qpermanent_local
= intern ("permanent-local");
3944 Qkill_buffer_hook
= intern ("kill-buffer-hook");
3946 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
3948 /* super-magic invisible buffer */
3949 Vbuffer_alist
= Qnil
;
3951 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3953 inhibit_modification_hooks
= 0;
3959 char buf
[MAXPATHLEN
+1];
3961 struct stat dotstat
, pwdstat
;
3965 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
3966 if (NILP (buffer_defaults
.enable_multibyte_characters
))
3967 Fset_buffer_multibyte (Qnil
);
3969 /* If PWD is accurate, use it instead of calling getwd. This is faster
3970 when PWD is right, and may avoid a fatal error. */
3971 if ((pwd
= getenv ("PWD")) != 0
3972 && (IS_DIRECTORY_SEP (*pwd
) || (*pwd
&& IS_DEVICE_SEP (pwd
[1])))
3973 && stat (pwd
, &pwdstat
) == 0
3974 && stat (".", &dotstat
) == 0
3975 && dotstat
.st_ino
== pwdstat
.st_ino
3976 && dotstat
.st_dev
== pwdstat
.st_dev
3977 && strlen (pwd
) < MAXPATHLEN
)
3980 else if (getcwd (buf
, MAXPATHLEN
+1) == 0)
3981 fatal ("`getcwd' failed: %s\n", strerror (errno
));
3983 else if (getwd (buf
) == 0)
3984 fatal ("`getwd' failed: %s\n", buf
);
3988 /* Maybe this should really use some standard subroutine
3989 whose definition is filename syntax dependent. */
3991 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
3993 buf
[rc
] = DIRECTORY_SEP
;
3996 #endif /* not VMS */
3998 current_buffer
->directory
= build_string (buf
);
4000 /* Add /: to the front of the name
4001 if it would otherwise be treated as magic. */
4002 temp
= Ffind_file_name_handler (current_buffer
->directory
, Qt
);
4004 /* If the default dir is just /, TEMP is non-nil
4005 because of the ange-ftp completion handler.
4006 However, it is not necessary to turn / into /:/.
4007 So avoid doing that. */
4008 && strcmp ("/", XSTRING (current_buffer
->directory
)->data
))
4009 current_buffer
->directory
4010 = concat2 (build_string ("/:"), current_buffer
->directory
);
4012 temp
= get_minibuffer (0);
4013 XBUFFER (temp
)->directory
= current_buffer
->directory
;
4016 /* initialize the buffer routines */
4020 extern Lisp_Object Qdisabled
;
4022 staticpro (&last_overlay_modification_hooks
);
4023 last_overlay_modification_hooks
4024 = Fmake_vector (make_number (10), Qnil
);
4026 staticpro (&Vbuffer_defaults
);
4027 staticpro (&Vbuffer_local_symbols
);
4028 staticpro (&Qfundamental_mode
);
4029 staticpro (&Qmode_class
);
4030 staticpro (&QSFundamental
);
4031 staticpro (&Vbuffer_alist
);
4032 staticpro (&Qprotected_field
);
4033 staticpro (&Qpermanent_local
);
4034 staticpro (&Qkill_buffer_hook
);
4035 Qoverlayp
= intern ("overlayp");
4036 staticpro (&Qoverlayp
);
4037 Qevaporate
= intern ("evaporate");
4038 staticpro (&Qevaporate
);
4039 Qmodification_hooks
= intern ("modification-hooks");
4040 staticpro (&Qmodification_hooks
);
4041 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
4042 staticpro (&Qinsert_in_front_hooks
);
4043 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
4044 staticpro (&Qinsert_behind_hooks
);
4045 Qget_file_buffer
= intern ("get-file-buffer");
4046 staticpro (&Qget_file_buffer
);
4047 Qpriority
= intern ("priority");
4048 staticpro (&Qpriority
);
4049 Qwindow
= intern ("window");
4050 staticpro (&Qwindow
);
4051 Qbefore_string
= intern ("before-string");
4052 staticpro (&Qbefore_string
);
4053 Qafter_string
= intern ("after-string");
4054 staticpro (&Qafter_string
);
4055 Qfirst_change_hook
= intern ("first-change-hook");
4056 staticpro (&Qfirst_change_hook
);
4057 Qbefore_change_functions
= intern ("before-change-functions");
4058 staticpro (&Qbefore_change_functions
);
4059 Qafter_change_functions
= intern ("after-change-functions");
4060 staticpro (&Qafter_change_functions
);
4062 Fput (Qprotected_field
, Qerror_conditions
,
4063 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
4064 Fput (Qprotected_field
, Qerror_message
,
4065 build_string ("Attempt to modify a protected field"));
4067 /* All these use DEFVAR_LISP_NOPRO because the slots in
4068 buffer_defaults will all be marked via Vbuffer_defaults. */
4070 DEFVAR_LISP_NOPRO ("default-mode-line-format",
4071 &buffer_defaults
.mode_line_format
,
4072 "Default value of `mode-line-format' for buffers that don't override it.\n\
4073 This is the same as (default-value 'mode-line-format).");
4075 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
4076 &buffer_defaults
.abbrev_mode
,
4077 "Default value of `abbrev-mode' for buffers that do not override it.\n\
4078 This is the same as (default-value 'abbrev-mode).");
4080 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
4081 &buffer_defaults
.ctl_arrow
,
4082 "Default value of `ctl-arrow' for buffers that do not override it.\n\
4083 This is the same as (default-value 'ctl-arrow).");
4085 DEFVAR_LISP_NOPRO ("default-direction-reversed",
4086 &buffer_defaults
.direction_reversed
,
4087 "Default value of `direction_reversed' for buffers that do not override it.\n\
4088 This is the same as (default-value 'direction-reversed).");
4090 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
4091 &buffer_defaults
.enable_multibyte_characters
,
4092 "Default value of `enable-multibyte-characters' for buffers not overriding it.\n\
4093 This is the same as (default-value 'enable-multibyte-characters).");
4095 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
4096 &buffer_defaults
.buffer_file_coding_system
,
4097 "Default value of `buffer-file-coding-system' for buffers not overriding it.\n\
4098 This is the same as (default-value 'buffer-file-coding-system).");
4100 DEFVAR_LISP_NOPRO ("default-truncate-lines",
4101 &buffer_defaults
.truncate_lines
,
4102 "Default value of `truncate-lines' for buffers that do not override it.\n\
4103 This is the same as (default-value 'truncate-lines).");
4105 DEFVAR_LISP_NOPRO ("default-fill-column",
4106 &buffer_defaults
.fill_column
,
4107 "Default value of `fill-column' for buffers that do not override it.\n\
4108 This is the same as (default-value 'fill-column).");
4110 DEFVAR_LISP_NOPRO ("default-left-margin",
4111 &buffer_defaults
.left_margin
,
4112 "Default value of `left-margin' for buffers that do not override it.\n\
4113 This is the same as (default-value 'left-margin).");
4115 DEFVAR_LISP_NOPRO ("default-tab-width",
4116 &buffer_defaults
.tab_width
,
4117 "Default value of `tab-width' for buffers that do not override it.\n\
4118 This is the same as (default-value 'tab-width).");
4120 DEFVAR_LISP_NOPRO ("default-case-fold-search",
4121 &buffer_defaults
.case_fold_search
,
4122 "Default value of `case-fold-search' for buffers that don't override it.\n\
4123 This is the same as (default-value 'case-fold-search).");
4126 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
4127 &buffer_defaults
.buffer_file_type
,
4128 "Default file type for buffers that do not override it.\n\
4129 This is the same as (default-value 'buffer-file-type).\n\
4130 The file type is nil for text, t for binary.");
4133 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
4136 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
4137 But make-docfile finds it!
4138 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
4140 "Template for displaying mode line for current buffer.\n\
4141 Each buffer has its own value of this variable.\n\
4142 Value may be a string, a symbol or a list or cons cell.\n\
4143 For a symbol, its value is used (but it is ignored if t or nil).\n\
4144 A string appearing directly as the value of a symbol is processed verbatim\n\
4145 in that the %-constructs below are not recognized.\n\
4146 For a list whose car is a symbol, the symbol's value is taken,\n\
4147 and if that is non-nil, the cadr of the list is processed recursively.\n\
4148 Otherwise, the caddr of the list (if there is one) is processed.\n\
4149 For a list whose car is a string or list, each element is processed\n\
4150 recursively and the results are effectively concatenated.\n\
4151 For a list whose car is an integer, the cdr of the list is processed\n\
4152 and padded (if the number is positive) or truncated (if negative)\n\
4153 to the width specified by that number.\n\
4154 A string is printed verbatim in the mode line except for %-constructs:\n\
4155 (%-constructs are allowed when the string is the entire mode-line-format\n\
4156 or when it is found in a cons-cell or a list)\n\
4157 %b -- print buffer name. %f -- print visited file name.\n\
4158 %F -- print frame name.\n\
4159 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
4160 % means buffer is read-only and * means it is modified.\n\
4161 For a modified read-only buffer, %* gives % and %+ gives *.\n\
4162 %s -- print process status. %l -- print the current line number.\n\
4163 %c -- print the current column number (this makes editing slower).\n\
4164 To make the column number update correctly in all cases,\n\
4165 `column-number-mode' must be non-nil.\n\
4166 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
4167 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
4168 or print Bottom or All.\n\
4169 %n -- print Narrow if appropriate.\n\
4170 %t -- print T if file is text, B if binary.\n\
4171 %[ -- print one [ for each recursive editing level. %] similar.\n\
4172 %% -- print %. %- -- print infinitely many dashes.\n\
4173 Decimal digits after the % specify field width to which to pad.");
4176 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
4177 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
4178 nil here means use current buffer's major mode.");
4180 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
4181 make_number (Lisp_Symbol
),
4182 "Symbol for current buffer's major mode.");
4184 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
4185 make_number (Lisp_String
),
4186 "Pretty name of current buffer's major mode (a string).");
4188 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
4189 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
4190 Automatically becomes buffer-local when set in any fashion.");
4192 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
4194 "*Non-nil if searches should ignore case.\n\
4195 Automatically becomes buffer-local when set in any fashion.");
4197 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
4198 make_number (Lisp_Int
),
4199 "*Column beyond which automatic line-wrapping should happen.\n\
4200 Automatically becomes buffer-local when set in any fashion.");
4202 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
4203 make_number (Lisp_Int
),
4204 "*Column for the default indent-line-function to indent to.\n\
4205 Linefeed indents to this column in Fundamental mode.\n\
4206 Automatically becomes buffer-local when set in any fashion.");
4208 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
4209 make_number (Lisp_Int
),
4210 "*Distance between tab stops (for display of tab characters), in columns.\n\
4211 Automatically becomes buffer-local when set in any fashion.");
4213 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
4214 "*Non-nil means display control chars with uparrow.\n\
4215 A value of nil means use backslash and octal digits.\n\
4216 Automatically becomes buffer-local when set in any fashion.\n\
4217 This variable does not apply to characters whose display is specified\n\
4218 in the current display table (if there is one).");
4220 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
4221 ¤t_buffer
->enable_multibyte_characters
,
4223 "*Non-nil means the buffer contents are regarded as multi-byte characters.\n\
4224 Otherwise they are regarded as unibyte. This affects the display,\n\
4225 file I/O and the behavior of various editing commands.");
4227 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
4228 ¤t_buffer
->buffer_file_coding_system
, Qnil
,
4229 "Coding system to be used for encoding the buffer contents on saving.\n\
4230 If it is nil, the buffer is saved without any code conversion unless\n\
4231 some coding system is specified in `file-coding-system-alist'\n\
4232 for the buffer file.\n\
4234 This variable is never applied to a way of decoding\n\
4235 a file while reading it.");
4237 DEFVAR_PER_BUFFER ("direction-reversed", ¤t_buffer
->direction_reversed
,
4239 "*Non-nil means lines in the buffer are displayed right to left.");
4241 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
4242 "*Non-nil means do not display continuation lines;\n\
4243 give each line of text one screen line.\n\
4244 Automatically becomes buffer-local when set in any fashion.\n\
4246 Note that this is overridden by the variable\n\
4247 `truncate-partial-width-windows' if that variable is non-nil\n\
4248 and this buffer is not full-frame width.");
4251 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
4253 "Non-nil if the visited file is a binary file.\n\
4254 This variable is meaningful on MS-DOG and Windows NT.\n\
4255 On those systems, it is automatically local in every buffer.\n\
4256 On other systems, this variable is normally always nil.");
4259 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
4260 make_number (Lisp_String
),
4261 "Name of default directory of current buffer. Should end with slash.\n\
4262 Each buffer has its own value of this variable.");
4264 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
4266 "Function called (if non-nil) to perform auto-fill.\n\
4267 It is called after self-inserting a space or newline.\n\
4268 Each buffer has its own value of this variable.\n\
4269 NOTE: This variable is not a hook;\n\
4270 its value may not be a list of functions.");
4272 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
4273 make_number (Lisp_String
),
4274 "Name of file visited in current buffer, or nil if not visiting a file.\n\
4275 Each buffer has its own value of this variable.");
4277 DEFVAR_PER_BUFFER ("buffer-file-truename", ¤t_buffer
->file_truename
,
4278 make_number (Lisp_String
),
4279 "Abbreviated truename of file visited in current buffer, or nil if none.\n\
4280 The truename of a file is calculated by `file-truename'\n\
4281 and then abbreviated with `abbreviate-file-name'.\n\
4282 Each buffer has its own value of this variable.");
4284 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
4285 ¤t_buffer
->auto_save_file_name
,
4286 make_number (Lisp_String
),
4287 "Name of file for auto-saving current buffer,\n\
4288 or nil if buffer should not be auto-saved.\n\
4289 Each buffer has its own value of this variable.");
4291 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
4292 "Non-nil if this buffer is read-only.\n\
4293 Each buffer has its own value of this variable.");
4295 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
4296 "Non-nil if this buffer's file has been backed up.\n\
4297 Backing up is done before the first time the file is saved.\n\
4298 Each buffer has its own value of this variable.");
4300 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
4301 make_number (Lisp_Int
),
4302 "Length of current buffer when last read in, saved or auto-saved.\n\
4304 Each buffer has its own value of this variable.");
4306 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
4308 "Non-nil enables selective display:\n\
4309 Integer N as value means display only lines\n\
4310 that start with less than n columns of space.\n\
4311 A value of t means, after a ^M, all the rest of the line is invisible.\n\
4312 Then ^M's in the file are written into files as newlines.\n\n\
4313 Automatically becomes buffer-local when set in any fashion.");
4316 DEFVAR_PER_BUFFER ("selective-display-ellipses",
4317 ¤t_buffer
->selective_display_ellipses
,
4319 "t means display ... on previous line when a line is invisible.\n\
4320 Automatically becomes buffer-local when set in any fashion.");
4323 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
4324 "Non-nil if self-insertion should replace existing text.\n\
4325 The value should be one of `overwrite-mode-textual',\n\
4326 `overwrite-mode-binary', or nil.\n\
4327 If it is `overwrite-mode-textual', self-insertion still\n\
4328 inserts at the end of a line, and inserts when point is before a tab,\n\
4329 until the tab is filled in.\n\
4330 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
4331 Automatically becomes buffer-local when set in any fashion.");
4333 #if 0 /* The doc string is too long for some compilers,
4334 but make-docfile can find it in this comment. */
4335 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4337 "Display table that controls display of the contents of current buffer.\n\
4338 Automatically becomes buffer-local when set in any fashion.\n\
4339 The display table is a char-table created with `make-display-table'.\n\
4340 The ordinary char-table elements control how to display each possible text\n\
4341 character. Each value should be a vector of characters or nil;\n\
4342 nil means display the character in the default fashion.\n\
4343 There are six extra slots to control the display of\n\
4344 the end of a truncated screen line (extra-slot 0, a single character);\n\
4345 the end of a continued line (extra-slot 1, a single character);\n\
4346 the escape character used to display character codes in octal\n\
4347 (extra-slot 2, a single character);\n\
4348 the character used as an arrow for control characters (extra-slot 3,\n\
4349 a single character);\n\
4350 the decoration indicating the presence of invisible lines (extra-slot 4,\n\
4351 a vector of characters);\n\
4352 the character used to draw the border between side-by-side windows\n\
4353 (extra-slot 5, a single character).\n\
4354 See also the functions `display-table-slot' and `set-display-table-slot'.\n\
4355 If this variable is nil, the value of `standard-display-table' is used.\n\
4356 Each window can have its own, overriding display table.");
4358 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
4361 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
4364 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
4365 "If non-nil, a function to call before each text change (obsolete).\n\
4366 Two arguments are passed to the function: the positions of\n\
4367 the beginning and end of the range of old text to be changed.\n\
4368 \(For an insertion, the beginning and end are at the same place.)\n\
4369 No information is given about the length of the text after the change.\n\
4371 Buffer changes made while executing the `before-change-function'\n\
4372 don't call any before-change or after-change functions.\n\
4373 That's because these variables are temporarily set to nil.\n\
4374 As a result, a hook function cannot straightforwardly alter the value of\n\
4375 these variables. See the Emacs Lisp manual for a way of\n\
4376 accomplishing an equivalent result by using other variables.\n\n\
4377 This variable is obsolete; use `before-change-functions' instead.");
4378 Vbefore_change_function
= Qnil
;
4380 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
4381 "If non-nil, a Function to call after each text change (obsolete).\n\
4382 Three arguments are passed to the function: the positions of\n\
4383 the beginning and end of the range of changed text,\n\
4384 and the length of the pre-change text replaced by that range.\n\
4385 \(For an insertion, the pre-change length is zero;\n\
4386 for a deletion, that length is the number of bytes deleted,\n\
4387 and the post-change beginning and end are at the same place.)\n\
4389 Buffer changes made while executing the `after-change-function'\n\
4390 don't call any before-change or after-change functions.\n\
4391 That's because these variables are temporarily set to nil.\n\
4392 As a result, a hook function cannot straightforwardly alter the value of\n\
4393 these variables. See the Emacs Lisp manual for a way of\n\
4394 accomplishing an equivalent result by using other variables.\n\n\
4395 This variable is obsolete; use `after-change-functions' instead.");
4396 Vafter_change_function
= Qnil
;
4398 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
4399 "List of functions to call before each text change.\n\
4400 Two arguments are passed to each function: the positions of\n\
4401 the beginning and end of the range of old text to be changed.\n\
4402 \(For an insertion, the beginning and end are at the same place.)\n\
4403 No information is given about the length of the text after the change.\n\
4405 Buffer changes made while executing the `before-change-functions'\n\
4406 don't call any before-change or after-change functions.\n\
4407 That's because these variables are temporarily set to nil.\n\
4408 As a result, a hook function cannot straightforwardly alter the value of\n\
4409 these variables. See the Emacs Lisp manual for a way of\n\
4410 accomplishing an equivalent result by using other variables.\n\
4412 If an unhandled error happens in running these functions,\n\
4413 the variable's value remains nil. That prevents the error\n\
4414 from happening repeatedly and making Emacs nonfunctional.");
4415 Vbefore_change_functions
= Qnil
;
4417 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
4418 "List of function to call after each text change.\n\
4419 Three arguments are passed to each function: the positions of\n\
4420 the beginning and end of the range of changed text,\n\
4421 and the length in bytes of the pre-change text replaced by that range.\n\
4422 \(For an insertion, the pre-change length is zero;\n\
4423 for a deletion, that length is the number of bytes deleted,\n\
4424 and the post-change beginning and end are at the same place.)\n\
4426 Buffer changes made while executing the `after-change-functions'\n\
4427 don't call any before-change or after-change functions.\n\
4428 That's because these variables are temporarily set to nil.\n\
4429 As a result, a hook function cannot straightforwardly alter the value of\n\
4430 these variables. See the Emacs Lisp manual for a way of\n\
4431 accomplishing an equivalent result by using other variables.\n\
4433 If an unhandled error happens in running these functions,\n\
4434 the variable's value remains nil. That prevents the error\n\
4435 from happening repeatedly and making Emacs nonfunctional.");
4436 Vafter_change_functions
= Qnil
;
4438 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
4439 "A list of functions to call before changing a buffer which is unmodified.\n\
4440 The functions are run using the `run-hooks' function.");
4441 Vfirst_change_hook
= Qnil
;
4443 #if 0 /* The doc string is too long for some compilers,
4444 but make-docfile can find it in this comment. */
4445 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4446 "List of undo entries in current buffer.\n\
4447 This variable is always local in all buffers.\n\
4448 Recent changes come first; older changes follow newer.\n\
4450 An entry (BEG . END) represents an insertion which begins at\n\
4451 position BEG and ends at position END.\n\
4453 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
4454 from (abs POSITION). If POSITION is positive, point was at the front\n\
4455 of the text being deleted; if negative, point was at the end.\n\
4457 An entry (t HIGH . LOW) indicates that the buffer previously had\n\
4458 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions\n\
4459 of the visited file's modification time, as of that time. If the\n\
4460 modification time of the most recent save is different, this entry is\n\
4463 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property\n\
4464 was modified between BEG and END. PROPERTY is the property name,\n\
4465 and VALUE is the old value.\n\
4467 An entry (MARKER . DISTANCE) indicates that the marker MARKER\n\
4468 was adjusted in position by the offset DISTANCE (an integer).\n\
4470 An entry of the form POSITION indicates that point was at the buffer\n\
4471 location given by the integer. Undoing an entry of this form places\n\
4472 point at POSITION.\n\
4474 nil marks undo boundaries. The undo command treats the changes\n\
4475 between two undo boundaries as a single step to be undone.\n\
4477 If the value of the variable is t, undo information is not recorded.");
4479 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
4482 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
4483 "Non-nil means the mark and region are currently active in this buffer.\n\
4484 Automatically local in all buffers.");
4486 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
4487 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
4488 This variable is buffer-local, in all buffers.\n\
4490 Normally, the line-motion functions work by scanning the buffer for\n\
4491 newlines. Columnar operations (like move-to-column and\n\
4492 compute-motion) also work by scanning the buffer, summing character\n\
4493 widths as they go. This works well for ordinary text, but if the\n\
4494 buffer's lines are very long (say, more than 500 characters), these\n\
4495 motion functions will take longer to execute. Emacs may also take\n\
4496 longer to update the display.\n\
4498 If cache-long-line-scans is non-nil, these motion functions cache the\n\
4499 results of their scans, and consult the cache to avoid rescanning\n\
4500 regions of the buffer until the text is modified. The caches are most\n\
4501 beneficial when they prevent the most searching---that is, when the\n\
4502 buffer contains long lines and large regions of characters with the\n\
4503 same, fixed screen width.\n\
4505 When cache-long-line-scans is non-nil, processing short lines will\n\
4506 become slightly slower (because of the overhead of consulting the\n\
4507 cache), and the caches will use memory roughly proportional to the\n\
4508 number of newlines and characters whose screen width varies.\n\
4510 The caches require no explicit maintenance; their accuracy is\n\
4511 maintained internally by the Emacs primitives. Enabling or disabling\n\
4512 the cache should not affect the behavior of any of the motion\n\
4513 functions; it should only affect their performance.");
4515 DEFVAR_PER_BUFFER ("point-before-scroll", ¤t_buffer
->point_before_scroll
, Qnil
,
4516 "Value of point before the last series of scroll operations, or nil.\n\
4517 This variable is always local in all buffers.");
4519 DEFVAR_PER_BUFFER ("buffer-file-format", ¤t_buffer
->file_format
, Qnil
,
4520 "List of formats to use when saving this buffer.\n\
4521 This variable is always local in all buffers.\n\
4522 Formats are defined by `format-alist'. This variable is\n\
4523 set when a file is visited. Automatically local in all buffers.");
4525 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
4526 ¤t_buffer
->invisibility_spec
, Qnil
,
4527 "Invisibility spec of this buffer.\n\
4528 This variable is always local in all buffers.\n\
4529 The default is t, which means that text is invisible\n\
4530 if it has a non-nil `invisible' property.\n\
4531 If the value is a list, a text character is invisible if its `invisible'\n\
4532 property is an element in that list.\n\
4533 If an element is a cons cell of the form (PROP . ELLIPSIS),\n\
4534 then characters with property value PROP are invisible,\n\
4535 and they have an ellipsis as well if ELLIPSIS is non-nil.");
4537 DEFVAR_PER_BUFFER ("buffer-display-count",
4538 ¤t_buffer
->display_count
, Qnil
,
4539 "A number incremented each time this buffer is displayed in a window.\n\
4540 This variable is always local in all buffers.\n\
4541 The function `set-window-buffer increments it.");
4543 DEFVAR_PER_BUFFER ("buffer-display-time",
4544 ¤t_buffer
->display_time
, Qnil
,
4545 "Time stamp updated each time this buffer is displayed in a window.\n\
4546 This variable is always local in all buffers.\n\
4547 The function `set-window-buffer' updates this variable\n\
4548 to the value obtained by calling `current-time'.\n\
4549 If the buffer has never been shown in a window, the value is nil.");
4551 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
4552 "*Non-nil means deactivate the mark when the buffer contents change.\n\
4553 Non-nil also enables highlighting of the region whenever the mark is active.\n\
4554 The variable `highlight-nonselected-windows' controls whether to highlight\n\
4555 all windows or just the selected window.");
4556 Vtransient_mark_mode
= Qnil
;
4558 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
4559 "*Non-nil means disregard read-only status of buffers or characters.\n\
4560 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
4561 text properties. If the value is a list, disregard `buffer-read-only'\n\
4562 and disregard a `read-only' text property if the property value\n\
4563 is a member of the list.");
4564 Vinhibit_read_only
= Qnil
;
4566 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
4567 "List of functions called with no args to query before killing a buffer.");
4568 Vkill_buffer_query_functions
= Qnil
;
4570 defsubr (&Sbuffer_live_p
);
4571 defsubr (&Sbuffer_list
);
4572 defsubr (&Sget_buffer
);
4573 defsubr (&Sget_file_buffer
);
4574 defsubr (&Sget_buffer_create
);
4575 defsubr (&Smake_indirect_buffer
);
4576 defsubr (&Sgenerate_new_buffer_name
);
4577 defsubr (&Sbuffer_name
);
4578 /*defsubr (&Sbuffer_number);*/
4579 defsubr (&Sbuffer_file_name
);
4580 defsubr (&Sbuffer_base_buffer
);
4581 defsubr (&Sbuffer_local_variables
);
4582 defsubr (&Sbuffer_modified_p
);
4583 defsubr (&Sset_buffer_modified_p
);
4584 defsubr (&Sbuffer_modified_tick
);
4585 defsubr (&Srename_buffer
);
4586 defsubr (&Sother_buffer
);
4587 defsubr (&Sbuffer_disable_undo
);
4588 defsubr (&Sbuffer_enable_undo
);
4589 defsubr (&Skill_buffer
);
4590 defsubr (&Sset_buffer_major_mode
);
4591 defsubr (&Sswitch_to_buffer
);
4592 defsubr (&Spop_to_buffer
);
4593 defsubr (&Scurrent_buffer
);
4594 defsubr (&Sset_buffer
);
4595 defsubr (&Sbarf_if_buffer_read_only
);
4596 defsubr (&Sbury_buffer
);
4597 defsubr (&Serase_buffer
);
4598 defsubr (&Sset_buffer_multibyte
);
4599 defsubr (&Skill_all_local_variables
);
4601 defsubr (&Soverlayp
);
4602 defsubr (&Smake_overlay
);
4603 defsubr (&Sdelete_overlay
);
4604 defsubr (&Smove_overlay
);
4605 defsubr (&Soverlay_start
);
4606 defsubr (&Soverlay_end
);
4607 defsubr (&Soverlay_buffer
);
4608 defsubr (&Soverlay_properties
);
4609 defsubr (&Soverlays_at
);
4610 defsubr (&Soverlays_in
);
4611 defsubr (&Snext_overlay_change
);
4612 defsubr (&Sprevious_overlay_change
);
4613 defsubr (&Soverlay_recenter
);
4614 defsubr (&Soverlay_lists
);
4615 defsubr (&Soverlay_get
);
4616 defsubr (&Soverlay_put
);
4622 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
4623 initial_define_key (control_x_map
, 'k', "kill-buffer");
4625 /* This must not be in syms_of_buffer, because Qdisabled is not
4626 initialized when that function gets called. */
4627 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);