1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994
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, 675 Mass Ave, Cambridge, MA 02139, USA. */
22 #include <sys/types.h>
24 #include <sys/param.h>
27 /* in 4.1, param.h fails to define this. */
28 #define MAXPATHLEN 1024
29 #endif /* not MAXPATHLEN */
33 #include "intervals.h"
37 #include "region-cache.h"
39 #include "blockinput.h"
41 struct buffer
*current_buffer
; /* the current buffer */
43 /* First buffer in chain of all buffers (in reverse order of creation).
44 Threaded through ->next. */
46 struct buffer
*all_buffers
;
48 /* This structure holds the default values of the buffer-local variables
49 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
50 The default value occupies the same slot in this structure
51 as an individual buffer's value occupies in that buffer.
52 Setting the default value also goes through the alist of buffers
53 and stores into each buffer that does not say it has a local value. */
55 struct buffer buffer_defaults
;
57 /* A Lisp_Object pointer to the above, used for staticpro */
59 static Lisp_Object Vbuffer_defaults
;
61 /* This structure marks which slots in a buffer have corresponding
62 default values in buffer_defaults.
63 Each such slot has a nonzero value in this structure.
64 The value has only one nonzero bit.
66 When a buffer has its own local value for a slot,
67 the bit for that slot (found in the same slot in this structure)
68 is turned on in the buffer's local_var_flags slot.
70 If a slot in this structure is -1, then even though there may
71 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
72 and the corresponding slot in buffer_defaults is not used.
74 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
75 but there is a default value which is copied into each buffer.
77 If a slot in this structure is negative, then even though there may
78 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
79 and the corresponding slot in buffer_defaults is not used.
81 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
82 zero, that is a bug */
84 struct buffer buffer_local_flags
;
86 /* This structure holds the names of symbols whose values may be
87 buffer-local. It is indexed and accessed in the same way as the above. */
89 struct buffer buffer_local_symbols
;
90 /* A Lisp_Object pointer to the above, used for staticpro */
91 static Lisp_Object Vbuffer_local_symbols
;
93 /* This structure holds the required types for the values in the
94 buffer-local slots. If a slot contains Qnil, then the
95 corresponding buffer slot may contain a value of any type. If a
96 slot contains an integer, then prospective values' tags must be
97 equal to that integer. When a tag does not match, the function
98 buffer_slot_type_mismatch will signal an error. */
99 struct buffer buffer_local_types
;
101 Lisp_Object
Fset_buffer ();
102 void set_buffer_internal ();
103 static void call_overlay_mod_hooks ();
105 /* Alist of all buffer names vs the buffers. */
106 /* This used to be a variable, but is no longer,
107 to prevent lossage due to user rplac'ing this alist or its elements. */
108 Lisp_Object Vbuffer_alist
;
110 /* Functions to call before and after each text change. */
111 Lisp_Object Vbefore_change_function
;
112 Lisp_Object Vafter_change_function
;
113 Lisp_Object Vbefore_change_functions
;
114 Lisp_Object Vafter_change_functions
;
116 Lisp_Object Vtransient_mark_mode
;
118 /* t means ignore all read-only text properties.
119 A list means ignore such a property if its value is a member of the list.
120 Any non-nil value means ignore buffer-read-only. */
121 Lisp_Object Vinhibit_read_only
;
123 /* List of functions to call that can query about killing a buffer.
124 If any of these functions returns nil, we don't kill it. */
125 Lisp_Object Vkill_buffer_query_functions
;
127 /* List of functions to call before changing an unmodified buffer. */
128 Lisp_Object Vfirst_change_hook
;
129 Lisp_Object Qfirst_change_hook
;
131 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
133 Lisp_Object Qprotected_field
;
135 Lisp_Object QSFundamental
; /* A string "Fundamental" */
137 Lisp_Object Qkill_buffer_hook
;
139 Lisp_Object Qget_file_buffer
;
141 Lisp_Object Qoverlayp
;
143 Lisp_Object Qpriority
, Qwindow
, Qevaporate
;
145 Lisp_Object Qmodification_hooks
;
146 Lisp_Object Qinsert_in_front_hooks
;
147 Lisp_Object Qinsert_behind_hooks
;
149 /* For debugging; temporary. See set_buffer_internal. */
150 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
156 error ("No buffer named %s", XSTRING (spec
)->data
);
157 error ("Invalid buffer argument");
160 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
161 "Return a list of all existing live buffers.")
164 return Fmapcar (Qcdr
, Vbuffer_alist
);
167 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
168 "Return the buffer named NAME (a string).\n\
169 If there is no live buffer named NAME, return nil.\n\
170 NAME may also be a buffer; if so, the value is that buffer.")
172 register Lisp_Object name
;
176 CHECK_STRING (name
, 0);
178 return Fcdr (Fassoc (name
, Vbuffer_alist
));
181 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
182 "Return the buffer visiting file FILENAME (a string).\n\
183 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
184 If there is no such live buffer, return nil.\n\
185 See also `find-buffer-visiting'.")
187 register Lisp_Object filename
;
189 register Lisp_Object tail
, buf
, tem
;
192 CHECK_STRING (filename
, 0);
193 filename
= Fexpand_file_name (filename
, Qnil
);
195 /* If the file name has special constructs in it,
196 call the corresponding file handler. */
197 handler
= Ffind_file_name_handler (filename
, Qget_file_buffer
);
199 return call2 (handler
, Qget_file_buffer
, filename
);
201 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
203 buf
= Fcdr (XCONS (tail
)->car
);
204 if (!BUFFERP (buf
)) continue;
205 if (!STRINGP (XBUFFER (buf
)->filename
)) continue;
206 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
213 /* Incremented for each buffer created, to assign the buffer number. */
216 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
217 "Return the buffer named NAME, or create such a buffer and return it.\n\
218 A new buffer is created if there is no live buffer named NAME.\n\
219 If NAME starts with a space, the new buffer does not keep undo information.\n\
220 If NAME is a buffer instead of a string, then it is the value returned.\n\
221 The value is never nil.")
223 register Lisp_Object name
;
225 register Lisp_Object buf
;
226 register struct buffer
*b
;
228 buf
= Fget_buffer (name
);
232 if (XSTRING (name
)->size
== 0)
233 error ("Empty string for buffer name is not allowed");
235 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
237 BUF_GAP_SIZE (b
) = 20;
239 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
241 if (! BUF_BEG_ADDR (b
))
251 b
->newline_cache
= 0;
252 b
->width_run_cache
= 0;
253 b
->width_table
= Qnil
;
255 /* Put this on the chain of all buffers including killed ones. */
256 b
->next
= all_buffers
;
259 b
->mark
= Fmake_marker ();
260 /*b->number = make_number (++buffer_count);*/
262 if (XSTRING (name
)->data
[0] != ' ')
268 reset_buffer_local_variables (b
);
270 /* Put this in the alist of all live buffers. */
272 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
274 b
->mark
= Fmake_marker ();
280 /* Reinitialize everything about a buffer except its name and contents
281 and local variables. */
285 register struct buffer
*b
;
288 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
290 b
->save_modified
= 1;
291 XSETFASTINT (b
->save_length
, 0);
292 b
->last_window_start
= 1;
294 b
->auto_save_modified
= 0;
295 b
->auto_save_failure_time
= -1;
296 b
->auto_save_file_name
= Qnil
;
298 b
->overlays_before
= Qnil
;
299 b
->overlays_after
= Qnil
;
300 XSETFASTINT (b
->overlay_center
, 1);
301 b
->mark_active
= Qnil
;
303 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
304 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
307 /* Reset buffer B's local variables info.
308 Don't use this on a buffer that has already been in use;
309 it does not treat permanent locals consistently.
310 Instead, use Fkill_all_local_variables. */
312 reset_buffer_local_variables (b
)
313 register struct buffer
*b
;
317 /* Reset the major mode to Fundamental, together with all the
318 things that depend on the major mode.
319 default-major-mode is handled at a higher level.
320 We ignore it here. */
321 b
->major_mode
= Qfundamental_mode
;
323 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
324 b
->mode_name
= QSFundamental
;
325 b
->minor_modes
= Qnil
;
326 b
->downcase_table
= Vascii_downcase_table
;
327 b
->upcase_table
= Vascii_upcase_table
;
328 b
->case_canon_table
= Vascii_canon_table
;
329 b
->case_eqv_table
= Vascii_eqv_table
;
331 b
->sort_table
= XSTRING (Vascii_sort_table
);
332 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
335 /* Reset all per-buffer variables to their defaults. */
336 b
->local_var_alist
= Qnil
;
337 b
->local_var_flags
= 0;
339 /* For each slot that has a default value,
340 copy that into the slot. */
342 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
343 offset
< sizeof (struct buffer
);
344 offset
+= sizeof (Lisp_Object
)) /* sizeof EMACS_INT == sizeof Lisp_Object */
346 int flag
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
347 if (flag
> 0 || flag
== -2)
348 *(Lisp_Object
*)(offset
+ (char *)b
) =
349 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
353 /* We split this away from generate-new-buffer, because rename-buffer
354 and set-visited-file-name ought to be able to use this to really
355 rename the buffer properly. */
357 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
359 "Return a string that is the name of no existing buffer based on NAME.\n\
360 If there is no live buffer named NAME, then return NAME.\n\
361 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
362 until an unused name is found, and then return that name.\n\
363 Optional second argument IGNORE specifies a name that is okay to use\n\
364 \(if it is in the sequence to be tried)\n\
365 even if a buffer with that name exists.")
367 register Lisp_Object name
, ignore
;
369 register Lisp_Object gentemp
, tem
;
373 CHECK_STRING (name
, 0);
375 tem
= Fget_buffer (name
);
382 sprintf (number
, "<%d>", ++count
);
383 gentemp
= concat2 (name
, build_string (number
));
384 tem
= Fstring_equal (gentemp
, ignore
);
387 tem
= Fget_buffer (gentemp
);
394 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
395 "Return the name of BUFFER, as a string.\n\
396 With no argument or nil as argument, return the name of the current buffer.")
398 register Lisp_Object buffer
;
401 return current_buffer
->name
;
402 CHECK_BUFFER (buffer
, 0);
403 return XBUFFER (buffer
)->name
;
406 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
407 "Return name of file BUFFER is visiting, or nil if none.\n\
408 No argument or nil as argument means use the current buffer.")
410 register Lisp_Object buffer
;
413 return current_buffer
->filename
;
414 CHECK_BUFFER (buffer
, 0);
415 return XBUFFER (buffer
)->filename
;
418 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
419 Sbuffer_local_variables
, 0, 1, 0,
420 "Return an alist of variables that are buffer-local in BUFFER.\n\
421 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
422 For a symbol that is locally unbound, just the symbol appears in the value.\n\
423 Note that storing new VALUEs in these elements doesn't change the variables.\n\
424 No argument or nil as argument means use current buffer as BUFFER.")
426 register Lisp_Object buffer
;
428 register struct buffer
*buf
;
429 register Lisp_Object result
;
432 buf
= current_buffer
;
435 CHECK_BUFFER (buffer
, 0);
436 buf
= XBUFFER (buffer
);
442 /* Reference each variable in the alist in our current buffer.
443 If inquiring about the current buffer, this gets the current values,
444 so store them into the alist so the alist is up to date.
445 If inquiring about some other buffer, this swaps out any values
446 for that buffer, making the alist up to date automatically. */
447 register Lisp_Object tail
;
448 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
450 Lisp_Object val
, elt
;
452 elt
= XCONS (tail
)->car
;
454 if (buf
== current_buffer
)
455 val
= find_symbol_value (XCONS (elt
)->car
);
457 val
= XCONS (elt
)->cdr
;
459 /* If symbol is unbound, put just the symbol in the list. */
460 if (EQ (val
, Qunbound
))
461 result
= Fcons (XCONS (elt
)->car
, result
);
462 /* Otherwise, put (symbol . value) in the list. */
464 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
468 /* Add on all the variables stored in special slots. */
470 register int offset
, mask
;
472 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
473 offset
< sizeof (struct buffer
);
474 offset
+= (sizeof (EMACS_INT
))) /* sizeof EMACS_INT == sizeof Lisp_Object */
476 mask
= XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
));
477 if (mask
== -1 || (buf
->local_var_flags
& mask
))
478 if (SYMBOLP (*(Lisp_Object
*)(offset
479 + (char *)&buffer_local_symbols
)))
480 result
= Fcons (Fcons (*((Lisp_Object
*)
481 (offset
+ (char *)&buffer_local_symbols
)),
482 *(Lisp_Object
*)(offset
+ (char *)buf
)),
491 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
493 "Return t if BUFFER was modified since its file was last read or saved.\n\
494 No argument or nil as argument means use current buffer as BUFFER.")
496 register Lisp_Object buffer
;
498 register struct buffer
*buf
;
500 buf
= current_buffer
;
503 CHECK_BUFFER (buffer
, 0);
504 buf
= XBUFFER (buffer
);
507 return buf
->save_modified
< BUF_MODIFF (buf
) ? Qt
: Qnil
;
510 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
512 "Mark current buffer as modified or unmodified according to FLAG.\n\
513 A non-nil FLAG means mark the buffer modified.")
515 register Lisp_Object flag
;
517 register int already
;
518 register Lisp_Object fn
;
520 #ifdef CLASH_DETECTION
521 /* If buffer becoming modified, lock the file.
522 If buffer becoming unmodified, unlock the file. */
524 fn
= current_buffer
->filename
;
527 already
= current_buffer
->save_modified
< MODIFF
;
528 if (!already
&& !NILP (flag
))
530 else if (already
&& NILP (flag
))
533 #endif /* CLASH_DETECTION */
535 current_buffer
->save_modified
= NILP (flag
) ? MODIFF
: 0;
540 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
542 "Return BUFFER's tick counter, incremented for each change in text.\n\
543 Each buffer has a tick counter which is incremented each time the text in\n\
544 that buffer is changed. It wraps around occasionally.\n\
545 No argument or nil as argument means use current buffer as BUFFER.")
547 register Lisp_Object buffer
;
549 register struct buffer
*buf
;
551 buf
= current_buffer
;
554 CHECK_BUFFER (buffer
, 0);
555 buf
= XBUFFER (buffer
);
558 return make_number (BUF_MODIFF (buf
));
561 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
562 "sRename buffer (to new name): \nP",
563 "Change current buffer's name to NEWNAME (a string).\n\
564 If second arg UNIQUE is nil or omitted, it is an error if a\n\
565 buffer named NEWNAME already exists.\n\
566 If UNIQUE is non-nil, come up with a new name using\n\
567 `generate-new-buffer-name'.\n\
568 Interactively, you can set UNIQUE with a prefix argument.\n\
569 We return the name we actually gave the buffer.\n\
570 This does not change the name of the visited file (if any).")
572 register Lisp_Object name
, unique
;
574 register Lisp_Object tem
, buf
;
576 CHECK_STRING (name
, 0);
578 if (XSTRING (name
)->size
== 0)
579 error ("Empty string is invalid as a buffer name");
581 tem
= Fget_buffer (name
);
582 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
583 the buffer automatically so you can create another with the original name.
584 It makes UNIQUE equivalent to
585 (rename-buffer (generate-new-buffer-name NAME)). */
586 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
587 return current_buffer
->name
;
591 name
= Fgenerate_new_buffer_name (name
, current_buffer
->name
);
593 error ("Buffer name \"%s\" is in use", XSTRING (name
)->data
);
596 current_buffer
->name
= name
;
598 /* Catch redisplay's attention. Unless we do this, the mode lines for
599 any windows displaying current_buffer will stay unchanged. */
602 XSETBUFFER (buf
, current_buffer
);
603 Fsetcar (Frassq (buf
, Vbuffer_alist
), name
);
604 if (NILP (current_buffer
->filename
)
605 && !NILP (current_buffer
->auto_save_file_name
))
606 call0 (intern ("rename-auto-save-file"));
607 /* refetch since that last call may have done GC */
608 return current_buffer
->name
;
611 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
612 "Return most recently selected buffer other than BUFFER.\n\
613 Buffers not visible in windows are preferred to visible buffers,\n\
614 unless optional second argument VISIBLE-OK is non-nil.\n\
615 If no other buffer exists, the buffer `*scratch*' is returned.\n\
616 If BUFFER is omitted or nil, some interesting buffer is returned.")
618 register Lisp_Object buffer
, visible_ok
;
620 register Lisp_Object tail
, buf
, notsogood
, tem
;
623 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
625 buf
= Fcdr (Fcar (tail
));
626 if (EQ (buf
, buffer
))
628 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
630 if (NILP (visible_ok
))
631 tem
= Fget_buffer_window (buf
, Qt
);
636 if (NILP (notsogood
))
639 if (!NILP (notsogood
))
641 return Fget_buffer_create (build_string ("*scratch*"));
644 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
, 0, 1,
646 "Make BUFFER stop keeping undo information.\n\
647 No argument or nil as argument means do this for the current buffer.")
649 register Lisp_Object buffer
;
651 Lisp_Object real_buffer
;
654 XSETBUFFER (real_buffer
, current_buffer
);
657 real_buffer
= Fget_buffer (buffer
);
658 if (NILP (real_buffer
))
662 XBUFFER (real_buffer
)->undo_list
= Qt
;
667 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
669 "Start keeping undo information for buffer BUFFER.\n\
670 No argument or nil as argument means do this for the current buffer.")
672 register Lisp_Object buffer
;
674 Lisp_Object real_buffer
;
677 XSETBUFFER (real_buffer
, current_buffer
);
680 real_buffer
= Fget_buffer (buffer
);
681 if (NILP (real_buffer
))
685 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
686 XBUFFER (real_buffer
)->undo_list
= Qnil
;
692 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
693 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
694 The buffer being killed will be current while the hook is running.\n\
697 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
698 "Kill the buffer BUFFER.\n\
699 The argument may be a buffer or may be the name of a buffer.\n\
700 An argument of nil means kill the current buffer.\n\n\
701 Value is t if the buffer is actually killed, nil if user says no.\n\n\
702 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
703 if not void, is a list of functions to be called, with no arguments,\n\
704 before the buffer is actually killed. The buffer to be killed is current\n\
705 when the hook functions are called.\n\n\
706 Any processes that have this buffer as the `process-buffer' are killed\n\
707 with `delete-process'.")
712 register struct buffer
*b
;
713 register Lisp_Object tem
;
714 register struct Lisp_Marker
*m
;
715 struct gcpro gcpro1
, gcpro2
;
718 buf
= Fcurrent_buffer ();
720 buf
= Fget_buffer (bufname
);
726 /* Query if the buffer is still modified. */
727 if (INTERACTIVE
&& !NILP (b
->filename
)
728 && BUF_MODIFF (b
) > b
->save_modified
)
730 GCPRO2 (buf
, bufname
);
731 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
732 XSTRING (b
->name
)->data
));
738 /* Run hooks with the buffer to be killed the current buffer. */
740 register Lisp_Object val
;
741 int count
= specpdl_ptr
- specpdl
;
744 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
745 set_buffer_internal (b
);
747 /* First run the query functions; if any query is answered no,
748 don't kill the buffer. */
749 for (list
= Vkill_buffer_query_functions
; !NILP (list
); list
= Fcdr (list
))
751 tem
= call0 (Fcar (list
));
753 return unbind_to (count
, Qnil
);
756 /* Then run the hooks. */
757 if (!NILP (Vrun_hooks
))
758 call1 (Vrun_hooks
, Qkill_buffer_hook
);
759 unbind_to (count
, Qnil
);
762 /* We have no more questions to ask. Verify that it is valid
763 to kill the buffer. This must be done after the questions
764 since anything can happen within do_yes_or_no_p. */
766 /* Don't kill the minibuffer now current. */
767 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
773 /* Make this buffer not be current.
774 In the process, notice if this is the sole visible buffer
775 and give up if so. */
776 if (b
== current_buffer
)
778 tem
= Fother_buffer (buf
, Qnil
);
780 if (b
== current_buffer
)
784 /* Now there is no question: we can kill the buffer. */
786 #ifdef CLASH_DETECTION
787 /* Unlock this buffer's file, if it is locked. */
789 #endif /* CLASH_DETECTION */
791 kill_buffer_processes (buf
);
795 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
796 Freplace_buffer_in_windows (buf
);
799 /* Delete any auto-save file, if we saved it in this session. */
800 if (STRINGP (b
->auto_save_file_name
)
801 && b
->auto_save_modified
!= 0)
804 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
806 unlink (XSTRING (b
->auto_save_file_name
)->data
);
809 /* Unchain all markers of this buffer
810 and leave them pointing nowhere. */
811 for (tem
= b
->markers
; !EQ (tem
, Qnil
); )
820 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
821 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
822 /* Perhaps we should explicitly free the interval tree here... */
826 BUFFER_FREE (BUF_BEG_ADDR (b
));
827 if (b
->newline_cache
)
829 free_region_cache (b
->newline_cache
);
830 b
->newline_cache
= 0;
832 if (b
->width_run_cache
)
834 free_region_cache (b
->width_run_cache
);
835 b
->width_run_cache
= 0;
837 b
->width_table
= Qnil
;
844 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
845 we do this each time BUF is selected visibly, the more recently
846 selected buffers are always closer to the front of the list. This
847 means that other_buffer is more likely to choose a relevant buffer. */
852 register Lisp_Object link
, prev
;
855 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
857 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
862 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
863 we cannot use Fdelq itself here because it allows quitting. */
866 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
868 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
870 XCONS(link
)->cdr
= Vbuffer_alist
;
871 Vbuffer_alist
= link
;
874 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode
, Sset_buffer_major_mode
, 1, 1, 0,
875 "Set an appropriate major mode for BUFFER, according to `default-major-mode'.\n\
876 Use this function before selecting the buffer, since it may need to inspect\n\
877 the current buffer's major mode.")
882 Lisp_Object function
;
884 function
= buffer_defaults
.major_mode
;
885 if (NILP (function
) && NILP (Fget (current_buffer
->major_mode
, Qmode_class
)))
886 function
= current_buffer
->major_mode
;
888 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
891 count
= specpdl_ptr
- specpdl
;
893 /* To select a nonfundamental mode,
894 select the buffer temporarily and then call the mode function. */
896 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
901 return unbind_to (count
, Qnil
);
904 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
905 "Select buffer BUFFER in the current window.\n\
906 BUFFER may be a buffer or a buffer name.\n\
907 Optional second arg NORECORD non-nil means\n\
908 do not put this buffer at the front of the list of recently selected ones.\n\
910 WARNING: This is NOT the way to work on another buffer temporarily\n\
911 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
912 the window-buffer correspondences.")
914 Lisp_Object bufname
, norecord
;
916 register Lisp_Object buf
;
919 if (EQ (minibuf_window
, selected_window
))
920 error ("Cannot switch buffers in minibuffer window");
921 tem
= Fwindow_dedicated_p (selected_window
);
923 error ("Cannot switch buffers in a dedicated window");
926 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
929 buf
= Fget_buffer (bufname
);
932 buf
= Fget_buffer_create (bufname
);
933 Fset_buffer_major_mode (buf
);
940 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
941 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
948 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
949 "Select buffer BUFFER in some window, preferably a different one.\n\
950 If BUFFER is nil, then some other buffer is chosen.\n\
951 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
952 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
953 window even if BUFFER is already visible in the selected window.")
955 Lisp_Object bufname
, other
;
957 register Lisp_Object buf
;
959 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
961 buf
= Fget_buffer_create (bufname
);
964 Fselect_window (Fdisplay_buffer (buf
, other
));
968 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
969 "Return the current buffer as a Lisp object.")
972 register Lisp_Object buf
;
973 XSETBUFFER (buf
, current_buffer
);
977 /* Set the current buffer to b */
980 set_buffer_internal (b
)
981 register struct buffer
*b
;
983 register struct buffer
*old_buf
;
984 register Lisp_Object tail
, valcontents
;
987 if (current_buffer
== b
)
990 windows_or_buffers_changed
= 1;
991 old_buf
= current_buffer
;
993 last_known_column_point
= -1; /* invalidate indentation cache */
995 /* Look down buffer's list of local Lisp variables
996 to find and update any that forward into C variables. */
998 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1000 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1001 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1002 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1003 && (tem
= XCONS (valcontents
)->car
,
1004 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1005 /* Just reference the variable
1006 to cause it to become set for this buffer. */
1007 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1010 /* Do the same with any others that were local to the previous buffer */
1013 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
1015 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
1016 if ((BUFFER_LOCAL_VALUEP (valcontents
)
1017 || SOME_BUFFER_LOCAL_VALUEP (valcontents
))
1018 && (tem
= XCONS (valcontents
)->car
,
1019 (BOOLFWDP (tem
) || INTFWDP (tem
) || OBJFWDP (tem
))))
1020 /* Just reference the variable
1021 to cause it to become set for this buffer. */
1022 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
1026 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
1027 "Make the buffer BUFFER current for editing operations.\n\
1028 BUFFER may be a buffer or the name of an existing buffer.\n\
1029 See also `save-excursion' when you want to make a buffer current temporarily.\n\
1030 This function does not display the buffer, so its effect ends\n\
1031 when the current command terminates.\n\
1032 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
1034 register Lisp_Object bufname
;
1036 register Lisp_Object buffer
;
1037 buffer
= Fget_buffer (bufname
);
1040 if (NILP (XBUFFER (buffer
)->name
))
1041 error ("Selecting deleted buffer");
1042 set_buffer_internal (XBUFFER (buffer
));
1046 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
1047 Sbarf_if_buffer_read_only
, 0, 0, 0,
1048 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1051 if (!NILP (current_buffer
->read_only
)
1052 && NILP (Vinhibit_read_only
))
1053 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
1057 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
1058 "Put BUFFER at the end of the list of all buffers.\n\
1059 There it is the least likely candidate for `other-buffer' to return;\n\
1060 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1061 If BUFFER is nil or omitted, bury the current buffer.\n\
1062 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1063 selected window if it is displayed there.")
1065 register Lisp_Object buf
;
1067 /* Figure out what buffer we're going to bury. */
1070 XSETBUFFER (buf
, current_buffer
);
1072 /* If we're burying the current buffer, unshow it. */
1073 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
1079 buf1
= Fget_buffer (buf
);
1085 /* Move buf to the end of the buffer list. */
1087 register Lisp_Object aelt
, link
;
1089 aelt
= Frassq (buf
, Vbuffer_alist
);
1090 link
= Fmemq (aelt
, Vbuffer_alist
);
1091 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1092 XCONS (link
)->cdr
= Qnil
;
1093 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1099 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1100 "Delete the entire contents of the current buffer.\n\
1101 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1102 so the buffer is truly empty after this.")
1107 current_buffer
->last_window_start
= 1;
1108 /* Prevent warnings, or suspension of auto saving, that would happen
1109 if future size is less than past size. Use of erase-buffer
1110 implies that the future text is not really related to the past text. */
1111 XSETFASTINT (current_buffer
->save_length
, 0);
1115 validate_region (b
, e
)
1116 register Lisp_Object
*b
, *e
;
1118 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1119 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1121 if (XINT (*b
) > XINT (*e
))
1124 tem
= *b
; *b
= *e
; *e
= tem
;
1127 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1128 && XINT (*e
) <= ZV
))
1129 args_out_of_range (*b
, *e
);
1133 list_buffers_1 (files
)
1136 register Lisp_Object tail
, tem
, buf
;
1137 Lisp_Object col1
, col2
, col3
, minspace
;
1138 register struct buffer
*old
= current_buffer
, *b
;
1139 Lisp_Object desired_point
;
1140 Lisp_Object other_file_symbol
;
1142 desired_point
= Qnil
;
1143 other_file_symbol
= intern ("list-buffers-directory");
1145 XSETFASTINT (col1
, 19);
1146 XSETFASTINT (col2
, 26);
1147 XSETFASTINT (col3
, 40);
1148 XSETFASTINT (minspace
, 1);
1150 Fset_buffer (Vstandard_output
);
1151 Fbuffer_disable_undo (Vstandard_output
);
1152 current_buffer
->read_only
= Qnil
;
1155 MR Buffer Size Mode File\n\
1156 -- ------ ---- ---- ----\n", -1);
1158 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
1160 buf
= Fcdr (Fcar (tail
));
1162 /* Don't mention the minibuffers. */
1163 if (XSTRING (b
->name
)->data
[0] == ' ')
1165 /* Optionally don't mention buffers that lack files. */
1166 if (!NILP (files
) && NILP (b
->filename
))
1168 /* Identify the current buffer. */
1170 XSETFASTINT (desired_point
, point
);
1171 write_string (b
== old
? "." : " ", -1);
1172 /* Identify modified buffers */
1173 write_string (BUF_MODIFF (b
) > b
->save_modified
? "*" : " ", -1);
1174 /* The current buffer is special-cased to be marked read-only.
1175 It is actually made read-only by the call to
1176 Buffer-menu-mode, below. */
1177 write_string ((b
!= current_buffer
&& NILP (b
->read_only
))
1179 Fprinc (b
->name
, Qnil
);
1180 Findent_to (col1
, make_number (2));
1181 XSETFASTINT (tem
, BUF_Z (b
) - BUF_BEG (b
));
1183 Findent_to (col2
, minspace
);
1184 Fprinc (b
->mode_name
, Qnil
);
1185 Findent_to (col3
, minspace
);
1187 if (!NILP (b
->filename
))
1188 Fprinc (b
->filename
, Qnil
);
1191 /* No visited file; check local value of list-buffers-directory. */
1193 set_buffer_internal (b
);
1194 tem
= Fboundp (other_file_symbol
);
1197 tem
= Fsymbol_value (other_file_symbol
);
1198 Fset_buffer (Vstandard_output
);
1203 Fset_buffer (Vstandard_output
);
1205 write_string ("\n", -1);
1208 tail
= intern ("Buffer-menu-mode");
1209 if ((tem
= Ffboundp (tail
), !NILP (tem
)))
1211 set_buffer_internal (old
);
1212 return desired_point
;
1215 DEFUN ("list-buffers", Flist_buffers
, Slist_buffers
, 0, 1, "P",
1216 "Display a list of names of existing buffers.\n\
1217 The list is displayed in a buffer named `*Buffer List*'.\n\
1218 Note that buffers with names starting with spaces are omitted.\n\
1219 Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1221 The M column contains a * for buffers that are modified.\n\
1222 The R column contains a % for buffers that are read-only.")
1226 Lisp_Object desired_point
;
1229 = internal_with_output_to_temp_buffer ("*Buffer List*",
1230 list_buffers_1
, files
);
1232 if (NUMBERP (desired_point
))
1234 int count
= specpdl_ptr
- specpdl
;
1235 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
1236 Fset_buffer (build_string ("*Buffer List*"));
1237 SET_PT (XINT (desired_point
));
1238 return unbind_to (count
, Qnil
);
1243 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1245 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1246 Most local variable bindings are eliminated so that the default values\n\
1247 become effective once more. Also, the syntax table is set from\n\
1248 `standard-syntax-table', the local keymap is set to nil,\n\
1249 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1250 This function also forces redisplay of the mode line.\n\
1252 Every function to select a new major mode starts by\n\
1253 calling this function.\n\n\
1254 As a special exception, local variables whose names have\n\
1255 a non-nil `permanent-local' property are not eliminated by this function.\n\
1257 The first thing this function does is run\n\
1258 the normal hook `change-major-mode-hook'.")
1261 register Lisp_Object alist
, sym
, tem
;
1264 if (!NILP (Vrun_hooks
))
1265 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1266 oalist
= current_buffer
->local_var_alist
;
1268 /* Make sure no local variables remain set up with this buffer
1269 for their current values. */
1271 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1273 sym
= XCONS (XCONS (alist
)->car
)->car
;
1275 /* Need not do anything if some other buffer's binding is now encached. */
1276 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
;
1277 if (XBUFFER (tem
) == current_buffer
)
1279 /* Symbol is set up for this buffer's old local value.
1280 Set it up for the current buffer with the default value. */
1282 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1283 /* Store the symbol's current value into the alist entry
1284 it is currently set up for. This is so that, if the
1285 local is marked permanent, and we make it local again below,
1286 we don't lose the value. */
1287 XCONS (XCONS (tem
)->car
)->cdr
1288 = do_symval_forwarding (XCONS (XSYMBOL (sym
)->value
)->car
);
1289 /* Switch to the symbol's default-value alist entry. */
1290 XCONS (tem
)->car
= tem
;
1291 /* Mark it as current for the current buffer. */
1292 XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
= Fcurrent_buffer ();
1293 /* Store the current value into any forwarding in the symbol. */
1294 store_symval_forwarding (sym
, XCONS (XSYMBOL (sym
)->value
)->car
,
1299 /* Actually eliminate all local bindings of this buffer. */
1301 reset_buffer_local_variables (current_buffer
);
1303 /* Redisplay mode lines; we are changing major mode. */
1305 update_mode_lines
++;
1307 /* Any which are supposed to be permanent,
1308 make local again, with the same values they had. */
1310 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1312 sym
= XCONS (XCONS (alist
)->car
)->car
;
1313 tem
= Fget (sym
, Qpermanent_local
);
1316 Fmake_local_variable (sym
);
1317 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1321 /* Force mode-line redisplay. Useful here because all major mode
1322 commands call this function. */
1323 update_mode_lines
++;
1328 /* Find all the overlays in the current buffer that contain position POS.
1329 Return the number found, and store them in a vector in *VEC_PTR.
1330 Store in *LEN_PTR the size allocated for the vector.
1331 Store in *NEXT_PTR the next position after POS where an overlay starts,
1332 or ZV if there are no more overlays.
1333 Store in *PREV_PTR the previous position after POS where an overlay ends,
1334 or BEGV if there are no previous overlays.
1335 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1337 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1338 when this function is called.
1340 If EXTEND is non-zero, we make the vector bigger if necessary.
1341 If EXTEND is zero, we never extend the vector,
1342 and we store only as many overlays as will fit.
1343 But we still return the total number of overlays. */
1346 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1349 Lisp_Object
**vec_ptr
;
1354 Lisp_Object tail
, overlay
, start
, end
, result
;
1357 Lisp_Object
*vec
= *vec_ptr
;
1360 int inhibit_storing
= 0;
1362 for (tail
= current_buffer
->overlays_before
;
1363 XGCTYPE (tail
) == Lisp_Cons
;
1364 tail
= XCONS (tail
)->cdr
)
1366 int startpos
, endpos
;
1368 overlay
= XCONS (tail
)->car
;
1369 if (XGCTYPE (overlay
) != Lisp_Overlay
)
1372 start
= OVERLAY_START (overlay
);
1373 end
= OVERLAY_END (overlay
);
1374 endpos
= OVERLAY_POSITION (end
);
1383 startpos
= OVERLAY_POSITION (start
);
1384 if (startpos
<= pos
)
1388 /* The supplied vector is full.
1389 Either make it bigger, or don't store any more in it. */
1392 *len_ptr
= len
*= 2;
1393 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1397 inhibit_storing
= 1;
1400 if (!inhibit_storing
)
1402 /* Keep counting overlays even if we can't return them all. */
1405 else if (startpos
< next
)
1409 for (tail
= current_buffer
->overlays_after
;
1410 XGCTYPE (tail
) == Lisp_Cons
;
1411 tail
= XCONS (tail
)->cdr
)
1413 int startpos
, endpos
;
1415 overlay
= XCONS (tail
)->car
;
1416 if (XGCTYPE (overlay
) != Lisp_Overlay
)
1419 start
= OVERLAY_START (overlay
);
1420 end
= OVERLAY_END (overlay
);
1421 startpos
= OVERLAY_POSITION (start
);
1424 if (startpos
< next
)
1428 endpos
= OVERLAY_POSITION (end
);
1435 *len_ptr
= len
*= 2;
1436 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1440 inhibit_storing
= 1;
1443 if (!inhibit_storing
)
1447 else if (endpos
< pos
&& endpos
> prev
)
1460 Lisp_Object overlay
;
1466 compare_overlays (s1
, s2
)
1467 struct sortvec
*s1
, *s2
;
1469 if (s1
->priority
!= s2
->priority
)
1470 return s1
->priority
- s2
->priority
;
1471 if (s1
->beg
!= s2
->beg
)
1472 return s1
->beg
- s2
->beg
;
1473 if (s1
->end
!= s2
->end
)
1474 return s2
->end
- s1
->end
;
1478 /* Sort an array of overlays by priority. The array is modified in place.
1479 The return value is the new size; this may be smaller than the original
1480 size if some of the overlays were invalid or were window-specific. */
1482 sort_overlays (overlay_vec
, noverlays
, w
)
1483 Lisp_Object
*overlay_vec
;
1488 struct sortvec
*sortvec
;
1489 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1491 /* Put the valid and relevant overlays into sortvec. */
1493 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1496 Lisp_Object overlay
;
1498 overlay
= overlay_vec
[i
];
1499 if (OVERLAY_VALID (overlay
)
1500 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1501 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1503 /* If we're interested in a specific window, then ignore
1504 overlays that are limited to some other window. */
1509 window
= Foverlay_get (overlay
, Qwindow
);
1510 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1514 /* This overlay is good and counts: put it into sortvec. */
1515 sortvec
[j
].overlay
= overlay
;
1516 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1517 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1518 tem
= Foverlay_get (overlay
, Qpriority
);
1520 sortvec
[j
].priority
= XINT (tem
);
1522 sortvec
[j
].priority
= 0;
1528 /* Sort the overlays into the proper order: increasing priority. */
1531 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1533 for (i
= 0; i
< noverlays
; i
++)
1534 overlay_vec
[i
] = sortvec
[i
].overlay
;
1538 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1541 recenter_overlay_lists (buf
, pos
)
1545 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1547 /* See if anything in overlays_before should move to overlays_after. */
1549 /* We don't strictly need prev in this loop; it should always be nil.
1550 But we use it for symmetry and in case that should cease to be true
1551 with some future change. */
1553 for (tail
= buf
->overlays_before
;
1555 prev
= tail
, tail
= next
)
1557 next
= XCONS (tail
)->cdr
;
1558 overlay
= XCONS (tail
)->car
;
1560 /* If the overlay is not valid, get rid of it. */
1561 if (!OVERLAY_VALID (overlay
))
1566 /* Splice the cons cell TAIL out of overlays_before. */
1568 XCONS (prev
)->cdr
= next
;
1570 buf
->overlays_before
= next
;
1576 beg
= OVERLAY_START (overlay
);
1577 end
= OVERLAY_END (overlay
);
1579 if (OVERLAY_POSITION (end
) > pos
)
1581 /* OVERLAY needs to be moved. */
1582 int where
= OVERLAY_POSITION (beg
);
1583 Lisp_Object other
, other_prev
;
1585 /* Splice the cons cell TAIL out of overlays_before. */
1587 XCONS (prev
)->cdr
= next
;
1589 buf
->overlays_before
= next
;
1591 /* Search thru overlays_after for where to put it. */
1593 for (other
= buf
->overlays_after
;
1595 other_prev
= other
, other
= XCONS (other
)->cdr
)
1597 Lisp_Object otherbeg
, otheroverlay
, follower
;
1600 otheroverlay
= XCONS (other
)->car
;
1601 if (! OVERLAY_VALID (otheroverlay
))
1604 otherbeg
= OVERLAY_START (otheroverlay
);
1605 if (OVERLAY_POSITION (otherbeg
) >= where
)
1609 /* Add TAIL to overlays_after before OTHER. */
1610 XCONS (tail
)->cdr
= other
;
1611 if (!NILP (other_prev
))
1612 XCONS (other_prev
)->cdr
= tail
;
1614 buf
->overlays_after
= tail
;
1618 /* We've reached the things that should stay in overlays_before.
1619 All the rest of overlays_before must end even earlier,
1624 /* See if anything in overlays_after should be in overlays_before. */
1626 for (tail
= buf
->overlays_after
;
1628 prev
= tail
, tail
= next
)
1630 next
= XCONS (tail
)->cdr
;
1631 overlay
= XCONS (tail
)->car
;
1633 /* If the overlay is not valid, get rid of it. */
1634 if (!OVERLAY_VALID (overlay
))
1639 /* Splice the cons cell TAIL out of overlays_after. */
1641 XCONS (prev
)->cdr
= next
;
1643 buf
->overlays_after
= next
;
1649 beg
= OVERLAY_START (overlay
);
1650 end
= OVERLAY_END (overlay
);
1652 /* Stop looking, when we know that nothing further
1653 can possibly end before POS. */
1654 if (OVERLAY_POSITION (beg
) > pos
)
1657 if (OVERLAY_POSITION (end
) <= pos
)
1659 /* OVERLAY needs to be moved. */
1660 int where
= OVERLAY_POSITION (end
);
1661 Lisp_Object other
, other_prev
;
1663 /* Splice the cons cell TAIL out of overlays_after. */
1665 XCONS (prev
)->cdr
= next
;
1667 buf
->overlays_after
= next
;
1669 /* Search thru overlays_before for where to put it. */
1671 for (other
= buf
->overlays_before
;
1673 other_prev
= other
, other
= XCONS (other
)->cdr
)
1675 Lisp_Object otherend
, otheroverlay
;
1678 otheroverlay
= XCONS (other
)->car
;
1679 if (! OVERLAY_VALID (otheroverlay
))
1682 otherend
= OVERLAY_END (otheroverlay
);
1683 if (OVERLAY_POSITION (otherend
) <= where
)
1687 /* Add TAIL to overlays_before before OTHER. */
1688 XCONS (tail
)->cdr
= other
;
1689 if (!NILP (other_prev
))
1690 XCONS (other_prev
)->cdr
= tail
;
1692 buf
->overlays_before
= tail
;
1697 XSETFASTINT (buf
->overlay_center
, pos
);
1700 /* Fix up overlays that were garbled as a result of permuting markers
1701 in the range START through END. Any overlay with at least one
1702 endpoint in this range will need to be unlinked from the overlay
1703 list and reinserted in its proper place.
1704 Such an overlay might even have negative size at this point.
1705 If so, we'll reverse the endpoints. Can you think of anything
1706 better to do in this situation? */
1708 fix_overlays_in_range (start
, end
)
1709 register int start
, end
;
1711 Lisp_Object tem
, overlay
;
1712 Lisp_Object before_list
, after_list
;
1713 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
1714 int startpos
, endpos
;
1716 /* This algorithm shifts links around instead of consing and GCing.
1717 The loop invariant is that before_list (resp. after_list) is a
1718 well-formed list except that its last element, the one that
1719 *pbefore (resp. *pafter) points to, is still uninitialized.
1720 So it's not a bug that before_list isn't initialized, although
1721 it may look strange. */
1722 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
1724 overlay
= XCONS (*ptail
)->car
;
1725 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1728 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1730 || (startpos
>= start
&& startpos
< end
))
1732 /* If the overlay is backwards, fix that now. */
1733 if (startpos
> endpos
)
1736 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1737 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1738 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1740 /* Add it to the end of the wrong list. Later on,
1741 recenter_overlay_lists will move it to the right place. */
1742 if (endpos
< XINT (current_buffer
->overlay_center
))
1745 pafter
= &XCONS (*ptail
)->cdr
;
1750 pbefore
= &XCONS (*ptail
)->cdr
;
1752 *ptail
= XCONS (*ptail
)->cdr
;
1755 ptail
= &XCONS (*ptail
)->cdr
;
1757 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
1759 overlay
= XCONS (*ptail
)->car
;
1760 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1761 if (startpos
>= end
)
1763 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1764 if (startpos
>= start
1765 || (endpos
>= start
&& endpos
< end
))
1767 if (startpos
> endpos
)
1770 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1771 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1772 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1774 if (endpos
< XINT (current_buffer
->overlay_center
))
1777 pafter
= &XCONS (*ptail
)->cdr
;
1782 pbefore
= &XCONS (*ptail
)->cdr
;
1784 *ptail
= XCONS (*ptail
)->cdr
;
1787 ptail
= &XCONS (*ptail
)->cdr
;
1790 /* Splice the constructed (wrong) lists into the buffer's lists,
1791 and let the recenter function make it sane again. */
1792 *pbefore
= current_buffer
->overlays_before
;
1793 current_buffer
->overlays_before
= before_list
;
1794 recenter_overlay_lists (current_buffer
,
1795 XINT (current_buffer
->overlay_center
));
1797 *pafter
= current_buffer
->overlays_after
;
1798 current_buffer
->overlays_after
= after_list
;
1799 recenter_overlay_lists (current_buffer
,
1800 XINT (current_buffer
->overlay_center
));
1803 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1804 "Return t if OBJECT is an overlay.")
1808 return (OVERLAYP (object
) ? Qt
: Qnil
);
1811 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1812 "Create a new overlay with range BEG to END in BUFFER.\n\
1813 If omitted, BUFFER defaults to the current buffer.\n\
1814 BEG and END may be integers or markers.")
1816 Lisp_Object beg
, end
, buffer
;
1818 Lisp_Object overlay
;
1822 XSETBUFFER (buffer
, current_buffer
);
1824 CHECK_BUFFER (buffer
, 2);
1826 && ! EQ (Fmarker_buffer (beg
), buffer
))
1827 error ("Marker points into wrong buffer");
1829 && ! EQ (Fmarker_buffer (end
), buffer
))
1830 error ("Marker points into wrong buffer");
1832 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1833 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1835 if (XINT (beg
) > XINT (end
))
1838 temp
= beg
; beg
= end
; end
= temp
;
1841 b
= XBUFFER (buffer
);
1843 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1844 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1846 overlay
= Fcons (Fcons (beg
, end
), Qnil
);
1847 XSETTYPE (overlay
, Lisp_Overlay
);
1849 /* Put the new overlay on the wrong list. */
1850 end
= OVERLAY_END (overlay
);
1851 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1852 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1854 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1856 /* This puts it in the right list, and in the right order. */
1857 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1859 /* We don't need to redisplay the region covered by the overlay, because
1860 the overlay has no properties at the moment. */
1865 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
1866 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1867 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1868 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1870 (overlay
, beg
, end
, buffer
)
1871 Lisp_Object overlay
, beg
, end
, buffer
;
1873 struct buffer
*b
, *ob
;
1874 Lisp_Object obuffer
;
1875 int count
= specpdl_ptr
- specpdl
;
1877 CHECK_OVERLAY (overlay
, 0);
1879 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1881 XSETBUFFER (buffer
, current_buffer
);
1882 CHECK_BUFFER (buffer
, 3);
1885 && ! EQ (Fmarker_buffer (beg
), buffer
))
1886 error ("Marker points into wrong buffer");
1888 && ! EQ (Fmarker_buffer (end
), buffer
))
1889 error ("Marker points into wrong buffer");
1891 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1892 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1894 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
1895 return Fdelete_overlay (overlay
);
1897 if (XINT (beg
) > XINT (end
))
1900 temp
= beg
; beg
= end
; end
= temp
;
1903 specbind (Qinhibit_quit
, Qt
);
1905 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1906 b
= XBUFFER (buffer
);
1907 ob
= XBUFFER (obuffer
);
1909 /* If the overlay has changed buffers, do a thorough redisplay. */
1910 if (!EQ (buffer
, obuffer
))
1912 /* Redisplay where the overlay was. */
1913 if (!NILP (obuffer
))
1918 o_beg
= OVERLAY_START (overlay
);
1919 o_end
= OVERLAY_END (overlay
);
1920 o_beg
= OVERLAY_POSITION (o_beg
);
1921 o_end
= OVERLAY_POSITION (o_end
);
1923 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
1926 /* Redisplay where the overlay is going to be. */
1927 redisplay_region (b
, XINT (beg
), XINT (end
));
1929 /* Don't limit redisplay to the selected window. */
1930 windows_or_buffers_changed
= 1;
1933 /* Redisplay the area the overlay has just left, or just enclosed. */
1937 int change_beg
, change_end
;
1939 o_beg
= OVERLAY_START (overlay
);
1940 o_end
= OVERLAY_END (overlay
);
1941 o_beg
= OVERLAY_POSITION (o_beg
);
1942 o_end
= OVERLAY_POSITION (o_end
);
1944 if (XINT (o_beg
) == XINT (beg
))
1945 redisplay_region (b
, XINT (o_end
), XINT (end
));
1946 else if (XINT (o_end
) == XINT (end
))
1947 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
1950 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
1951 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
1952 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
1956 if (!NILP (obuffer
))
1958 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
1959 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
1962 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
1963 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
1965 /* Put the overlay on the wrong list. */
1966 end
= OVERLAY_END (overlay
);
1967 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1968 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1970 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1972 /* This puts it in the right list, and in the right order. */
1973 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1975 return unbind_to (count
, overlay
);
1978 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
1979 "Delete the overlay OVERLAY from its buffer.")
1981 Lisp_Object overlay
;
1985 int count
= specpdl_ptr
- specpdl
;
1987 CHECK_OVERLAY (overlay
, 0);
1989 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1993 b
= XBUFFER (buffer
);
1995 specbind (Qinhibit_quit
, Qt
);
1997 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
1998 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2000 redisplay_region (b
,
2001 marker_position (OVERLAY_START (overlay
)),
2002 marker_position (OVERLAY_END (overlay
)));
2004 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2005 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2007 return unbind_to (count
, Qnil
);
2010 /* Overlay dissection functions. */
2012 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2013 "Return the position at which OVERLAY starts.")
2015 Lisp_Object overlay
;
2017 CHECK_OVERLAY (overlay
, 0);
2019 return (Fmarker_position (OVERLAY_START (overlay
)));
2022 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2023 "Return the position at which OVERLAY ends.")
2025 Lisp_Object overlay
;
2027 CHECK_OVERLAY (overlay
, 0);
2029 return (Fmarker_position (OVERLAY_END (overlay
)));
2032 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2033 "Return the buffer OVERLAY belongs to.")
2035 Lisp_Object overlay
;
2037 CHECK_OVERLAY (overlay
, 0);
2039 return Fmarker_buffer (OVERLAY_START (overlay
));
2042 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2043 "Return a list of the properties on OVERLAY.\n\
2044 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2047 Lisp_Object overlay
;
2049 CHECK_OVERLAY (overlay
, 0);
2051 return Fcopy_sequence (Fcdr_safe (XCONS (overlay
)->cdr
));
2055 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2056 "Return a list of the overlays that contain position POS.")
2061 Lisp_Object
*overlay_vec
;
2065 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2068 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2070 /* Put all the overlays we want in a vector in overlay_vec.
2071 Store the length in len. */
2072 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, NULL
, NULL
);
2074 /* Make a list of them all. */
2075 result
= Flist (noverlays
, overlay_vec
);
2077 xfree (overlay_vec
);
2081 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2083 "Return the next position after POS where an overlay starts or ends.\n\
2084 If there are no more overlay boundaries after POS, return (point-max).")
2090 Lisp_Object
*overlay_vec
;
2094 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2097 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2099 /* Put all the overlays we want in a vector in overlay_vec.
2100 Store the length in len.
2101 endpos gets the position where the next overlay starts. */
2102 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
, NULL
);
2104 /* If any of these overlays ends before endpos,
2105 use its ending point instead. */
2106 for (i
= 0; i
< noverlays
; i
++)
2111 oend
= OVERLAY_END (overlay_vec
[i
]);
2112 oendpos
= OVERLAY_POSITION (oend
);
2113 if (oendpos
< endpos
)
2117 xfree (overlay_vec
);
2118 return make_number (endpos
);
2121 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2122 Sprevious_overlay_change
, 1, 1, 0,
2123 "Return the previous position before POS where an overlay starts or ends.\n\
2124 If there are no more overlay boundaries after POS, return (point-min).")
2130 Lisp_Object
*overlay_vec
;
2134 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2137 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2139 /* Put all the overlays we want in a vector in overlay_vec.
2140 Store the length in len.
2141 prevpos gets the position of an overlay end. */
2142 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, NULL
, &prevpos
);
2144 /* If any of these overlays starts before endpos,
2145 maybe use its starting point instead. */
2146 for (i
= 0; i
< noverlays
; i
++)
2151 ostart
= OVERLAY_START (overlay_vec
[i
]);
2152 ostartpos
= OVERLAY_POSITION (ostart
);
2153 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2154 prevpos
= ostartpos
;
2157 xfree (overlay_vec
);
2158 return make_number (prevpos
);
2161 /* These functions are for debugging overlays. */
2163 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2164 "Return a pair of lists giving all the overlays of the current buffer.\n\
2165 The car has all the overlays before the overlay center;\n\
2166 the cdr has all the overlays after the overlay center.\n\
2167 Recentering overlays moves overlays between these lists.\n\
2168 The lists you get are copies, so that changing them has no effect.\n\
2169 However, the overlays you get are the real objects that the buffer uses.")
2172 Lisp_Object before
, after
;
2173 before
= current_buffer
->overlays_before
;
2175 before
= Fcopy_sequence (before
);
2176 after
= current_buffer
->overlays_after
;
2178 after
= Fcopy_sequence (after
);
2180 return Fcons (before
, after
);
2183 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2184 "Recenter the overlays of the current buffer around position POS.")
2188 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2190 recenter_overlay_lists (current_buffer
, XINT (pos
));
2194 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2195 "Get the property of overlay OVERLAY with property name NAME.")
2197 Lisp_Object overlay
, prop
;
2199 Lisp_Object plist
, fallback
;
2201 CHECK_OVERLAY (overlay
, 0);
2205 for (plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
2206 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2207 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2209 if (EQ (XCONS (plist
)->car
, prop
))
2210 return XCONS (XCONS (plist
)->cdr
)->car
;
2211 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2214 tem
= Fcar (Fcdr (plist
));
2216 fallback
= Fget (tem
, prop
);
2223 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2224 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2225 (overlay
, prop
, value
)
2226 Lisp_Object overlay
, prop
, value
;
2228 Lisp_Object plist
, tail
, buffer
;
2231 CHECK_OVERLAY (overlay
, 0);
2233 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2235 plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
2238 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2239 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2240 if (EQ (XCONS (tail
)->car
, prop
))
2242 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2243 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2246 /* It wasn't in the list, so add it to the front. */
2247 changed
= !NILP (value
);
2248 if (! CONSP (XCONS (overlay
)->cdr
))
2249 XCONS (overlay
)->cdr
= Fcons (Qnil
, Qnil
);
2250 XCONS (XCONS (overlay
)->cdr
)->cdr
= Fcons (prop
, Fcons (value
, plist
));
2252 if (! NILP (buffer
))
2255 redisplay_region (XBUFFER (buffer
),
2256 marker_position (OVERLAY_START (overlay
)),
2257 marker_position (OVERLAY_END (overlay
)));
2258 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2259 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2260 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2261 Fdelete_overlay (overlay
);
2266 /* Run the modification-hooks of overlays that include
2267 any part of the text in START to END.
2268 Run the insert-before-hooks of overlay starting at END,
2269 and the insert-after-hooks of overlay ending at START. */
2272 verify_overlay_modification (start
, end
)
2273 Lisp_Object start
, end
;
2275 Lisp_Object prop
, overlay
, tail
;
2276 int insertion
= EQ (start
, end
);
2278 struct gcpro gcpro1
, gcpro2
;
2282 GCPRO2 (overlay
, tail
);
2285 for (tail
= current_buffer
->overlays_before
;
2287 tail
= XCONS (tail
)->cdr
)
2289 int startpos
, endpos
;
2290 Lisp_Object ostart
, oend
;
2292 overlay
= XCONS (tail
)->car
;
2294 ostart
= OVERLAY_START (overlay
);
2295 oend
= OVERLAY_END (overlay
);
2296 endpos
= OVERLAY_POSITION (oend
);
2297 if (XFASTINT (start
) > endpos
)
2299 startpos
= OVERLAY_POSITION (ostart
);
2300 if (XFASTINT (end
) == startpos
&& insertion
)
2302 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2305 /* Copy TAIL in case the hook recenters the overlay lists. */
2307 tail
= Fcopy_sequence (tail
);
2309 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2312 if (XFASTINT (start
) == endpos
&& insertion
)
2314 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2318 tail
= Fcopy_sequence (tail
);
2320 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2323 /* Test for intersecting intervals. This does the right thing
2324 for both insertion and deletion. */
2325 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2327 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2331 tail
= Fcopy_sequence (tail
);
2333 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2339 for (tail
= current_buffer
->overlays_after
;
2341 tail
= XCONS (tail
)->cdr
)
2343 int startpos
, endpos
;
2344 Lisp_Object ostart
, oend
;
2346 overlay
= XCONS (tail
)->car
;
2348 ostart
= OVERLAY_START (overlay
);
2349 oend
= OVERLAY_END (overlay
);
2350 startpos
= OVERLAY_POSITION (ostart
);
2351 endpos
= OVERLAY_POSITION (oend
);
2352 if (XFASTINT (end
) < startpos
)
2354 if (XFASTINT (end
) == startpos
&& insertion
)
2356 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2360 tail
= Fcopy_sequence (tail
);
2362 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2365 if (XFASTINT (start
) == endpos
&& insertion
)
2367 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2371 tail
= Fcopy_sequence (tail
);
2373 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2376 /* Test for intersecting intervals. This does the right thing
2377 for both insertion and deletion. */
2378 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2380 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2384 tail
= Fcopy_sequence (tail
);
2386 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2395 call_overlay_mod_hooks (list
, overlay
, start
, end
)
2396 Lisp_Object list
, overlay
, start
, end
;
2398 struct gcpro gcpro1
;
2400 while (!NILP (list
))
2402 call3 (Fcar (list
), overlay
, start
, end
);
2408 /* Delete any zero-sized overlays at position POS, if the `evaporate'
2411 evaporate_overlays (pos
)
2414 Lisp_Object tail
, overlay
, hit_list
;
2417 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
2418 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
2419 tail
= XCONS (tail
)->cdr
)
2422 overlay
= XCONS (tail
)->car
;
2423 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2426 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
2427 && Foverlay_get (overlay
, Qevaporate
))
2428 hit_list
= Fcons (overlay
, hit_list
);
2431 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
2432 tail
= XCONS (tail
)->cdr
)
2435 overlay
= XCONS (tail
)->car
;
2436 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2439 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
2440 && Foverlay_get (overlay
, Qevaporate
))
2441 hit_list
= Fcons (overlay
, hit_list
);
2443 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
2444 Fdelete_overlay (XCONS (hit_list
)->car
);
2447 /* Somebody has tried to store a value with an unacceptable type
2448 into the buffer-local slot with offset OFFSET. */
2450 buffer_slot_type_mismatch (offset
)
2455 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
2456 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
2458 case Lisp_Int
: type_name
= "integers"; break;
2459 case Lisp_String
: type_name
= "strings"; break;
2460 case Lisp_Symbol
: type_name
= "symbols"; break;
2465 error ("only %s should be stored in the buffer-local variable %s",
2466 type_name
, XSYMBOL (sym
)->name
->data
);
2471 register Lisp_Object tem
;
2473 /* Make sure all markable slots in buffer_defaults
2474 are initialized reasonably, so mark_buffer won't choke. */
2475 reset_buffer (&buffer_defaults
);
2476 reset_buffer_local_variables (&buffer_defaults
);
2477 reset_buffer (&buffer_local_symbols
);
2478 reset_buffer_local_variables (&buffer_local_symbols
);
2479 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
2480 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
2482 /* Set up the default values of various buffer slots. */
2483 /* Must do these before making the first buffer! */
2485 /* real setup is done in loaddefs.el */
2486 buffer_defaults
.mode_line_format
= build_string ("%-");
2487 buffer_defaults
.abbrev_mode
= Qnil
;
2488 buffer_defaults
.overwrite_mode
= Qnil
;
2489 buffer_defaults
.case_fold_search
= Qt
;
2490 buffer_defaults
.auto_fill_function
= Qnil
;
2491 buffer_defaults
.selective_display
= Qnil
;
2493 buffer_defaults
.selective_display_ellipses
= Qt
;
2495 buffer_defaults
.abbrev_table
= Qnil
;
2496 buffer_defaults
.display_table
= Qnil
;
2497 buffer_defaults
.undo_list
= Qnil
;
2498 buffer_defaults
.mark_active
= Qnil
;
2499 buffer_defaults
.overlays_before
= Qnil
;
2500 buffer_defaults
.overlays_after
= Qnil
;
2501 XSETFASTINT (buffer_defaults
.overlay_center
, 1);
2503 XSETFASTINT (buffer_defaults
.tab_width
, 8);
2504 buffer_defaults
.truncate_lines
= Qnil
;
2505 buffer_defaults
.ctl_arrow
= Qt
;
2508 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
2510 XSETFASTINT (buffer_defaults
.fill_column
, 70);
2511 XSETFASTINT (buffer_defaults
.left_margin
, 0);
2512 buffer_defaults
.cache_long_line_scans
= Qnil
;
2514 /* Assign the local-flags to the slots that have default values.
2515 The local flag is a bit that is used in the buffer
2516 to say that it has its own local value for the slot.
2517 The local flag bits are in the local_var_flags slot of the buffer. */
2519 /* Nothing can work if this isn't true */
2520 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
2522 /* 0 means not a lisp var, -1 means always local, else mask */
2523 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2524 XSETINT (buffer_local_flags
.filename
, -1);
2525 XSETINT (buffer_local_flags
.directory
, -1);
2526 XSETINT (buffer_local_flags
.backed_up
, -1);
2527 XSETINT (buffer_local_flags
.save_length
, -1);
2528 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
2529 XSETINT (buffer_local_flags
.read_only
, -1);
2530 XSETINT (buffer_local_flags
.major_mode
, -1);
2531 XSETINT (buffer_local_flags
.mode_name
, -1);
2532 XSETINT (buffer_local_flags
.undo_list
, -1);
2533 XSETINT (buffer_local_flags
.mark_active
, -1);
2535 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
2536 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
2537 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
2538 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
2539 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
2540 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
2542 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
2544 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
2545 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
2546 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
2547 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
2548 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
2549 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
2550 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
2551 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
2552 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
2554 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
2557 Vbuffer_alist
= Qnil
;
2561 QSFundamental
= build_string ("Fundamental");
2563 Qfundamental_mode
= intern ("fundamental-mode");
2564 buffer_defaults
.major_mode
= Qfundamental_mode
;
2566 Qmode_class
= intern ("mode-class");
2568 Qprotected_field
= intern ("protected-field");
2570 Qpermanent_local
= intern ("permanent-local");
2572 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2574 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2575 /* super-magic invisible buffer */
2576 Vbuffer_alist
= Qnil
;
2578 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2583 char buf
[MAXPATHLEN
+1];
2585 struct stat dotstat
, pwdstat
;
2588 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2590 /* If PWD is accurate, use it instead of calling getwd. This is faster
2591 when PWD is right, and may avoid a fatal error. */
2592 if ((pwd
= getenv ("PWD")) != 0 && *pwd
== '/'
2593 && stat (pwd
, &pwdstat
) == 0
2594 && stat (".", &dotstat
) == 0
2595 && dotstat
.st_ino
== pwdstat
.st_ino
2596 && dotstat
.st_dev
== pwdstat
.st_dev
2597 && strlen (pwd
) < MAXPATHLEN
)
2599 else if (getwd (buf
) == 0)
2600 fatal ("`getwd' failed: %s.\n", buf
);
2603 /* Maybe this should really use some standard subroutine
2604 whose definition is filename syntax dependent. */
2605 if (buf
[strlen (buf
) - 1] != '/')
2607 #endif /* not VMS */
2608 current_buffer
->directory
= build_string (buf
);
2610 temp
= get_minibuffer (0);
2611 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2614 /* initialize the buffer routines */
2617 extern Lisp_Object Qdisabled
;
2619 staticpro (&Vbuffer_defaults
);
2620 staticpro (&Vbuffer_local_symbols
);
2621 staticpro (&Qfundamental_mode
);
2622 staticpro (&Qmode_class
);
2623 staticpro (&QSFundamental
);
2624 staticpro (&Vbuffer_alist
);
2625 staticpro (&Qprotected_field
);
2626 staticpro (&Qpermanent_local
);
2627 staticpro (&Qkill_buffer_hook
);
2628 staticpro (&Qoverlayp
);
2629 Qevaporate
= intern ("evaporate");
2630 staticpro (&Qevaporate
);
2631 staticpro (&Qmodification_hooks
);
2632 Qmodification_hooks
= intern ("modification-hooks");
2633 staticpro (&Qinsert_in_front_hooks
);
2634 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
2635 staticpro (&Qinsert_behind_hooks
);
2636 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
2637 staticpro (&Qget_file_buffer
);
2638 Qget_file_buffer
= intern ("get-file-buffer");
2639 Qpriority
= intern ("priority");
2640 staticpro (&Qpriority
);
2641 Qwindow
= intern ("window");
2642 staticpro (&Qwindow
);
2644 Qoverlayp
= intern ("overlayp");
2646 Fput (Qprotected_field
, Qerror_conditions
,
2647 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2648 Fput (Qprotected_field
, Qerror_message
,
2649 build_string ("Attempt to modify a protected field"));
2651 /* All these use DEFVAR_LISP_NOPRO because the slots in
2652 buffer_defaults will all be marked via Vbuffer_defaults. */
2654 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2655 &buffer_defaults
.mode_line_format
,
2656 "Default value of `mode-line-format' for buffers that don't override it.\n\
2657 This is the same as (default-value 'mode-line-format).");
2659 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2660 &buffer_defaults
.abbrev_mode
,
2661 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2662 This is the same as (default-value 'abbrev-mode).");
2664 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2665 &buffer_defaults
.ctl_arrow
,
2666 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2667 This is the same as (default-value 'ctl-arrow).");
2669 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2670 &buffer_defaults
.truncate_lines
,
2671 "Default value of `truncate-lines' for buffers that do not override it.\n\
2672 This is the same as (default-value 'truncate-lines).");
2674 DEFVAR_LISP_NOPRO ("default-fill-column",
2675 &buffer_defaults
.fill_column
,
2676 "Default value of `fill-column' for buffers that do not override it.\n\
2677 This is the same as (default-value 'fill-column).");
2679 DEFVAR_LISP_NOPRO ("default-left-margin",
2680 &buffer_defaults
.left_margin
,
2681 "Default value of `left-margin' for buffers that do not override it.\n\
2682 This is the same as (default-value 'left-margin).");
2684 DEFVAR_LISP_NOPRO ("default-tab-width",
2685 &buffer_defaults
.tab_width
,
2686 "Default value of `tab-width' for buffers that do not override it.\n\
2687 This is the same as (default-value 'tab-width).");
2689 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2690 &buffer_defaults
.case_fold_search
,
2691 "Default value of `case-fold-search' for buffers that don't override it.\n\
2692 This is the same as (default-value 'case-fold-search).");
2695 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
2696 &buffer_defaults
.buffer_file_type
,
2697 "Default file type for buffers that do not override it.\n\
2698 This is the same as (default-value 'buffer-file-type).\n\
2699 The file type is nil for text, t for binary.");
2702 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2705 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2706 But make-docfile finds it!
2707 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2709 "Template for displaying mode line for current buffer.\n\
2710 Each buffer has its own value of this variable.\n\
2711 Value may be a string, a symbol or a list or cons cell.\n\
2712 For a symbol, its value is used (but it is ignored if t or nil).\n\
2713 A string appearing directly as the value of a symbol is processed verbatim\n\
2714 in that the %-constructs below are not recognized.\n\
2715 For a list whose car is a symbol, the symbol's value is taken,\n\
2716 and if that is non-nil, the cadr of the list is processed recursively.\n\
2717 Otherwise, the caddr of the list (if there is one) is processed.\n\
2718 For a list whose car is a string or list, each element is processed\n\
2719 recursively and the results are effectively concatenated.\n\
2720 For a list whose car is an integer, the cdr of the list is processed\n\
2721 and padded (if the number is positive) or truncated (if negative)\n\
2722 to the width specified by that number.\n\
2723 A string is printed verbatim in the mode line except for %-constructs:\n\
2724 (%-constructs are allowed when the string is the entire mode-line-format\n\
2725 or when it is found in a cons-cell or a list)\n\
2726 %b -- print buffer name. %f -- print visited file name.\n\
2727 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
2728 % means buffer is read-only and * means it is modified.\n\
2729 For a modified read-only buffer, %* gives % and %+ gives *.\n\
2730 %s -- print process status. %l -- print the current line number.\n\
2731 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
2732 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
2733 or print Bottom or All.\n\
2734 %n -- print Narrow if appropriate.\n\
2735 %t -- print T if files is text, B if binary.\n\
2736 %[ -- print one [ for each recursive editing level. %] similar.\n\
2737 %% -- print %. %- -- print infinitely many dashes.\n\
2738 Decimal digits after the % specify field width to which to pad.");
2741 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2742 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2743 nil here means use current buffer's major mode.");
2745 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2746 make_number (Lisp_Symbol
),
2747 "Symbol for current buffer's major mode.");
2749 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2750 make_number (Lisp_String
),
2751 "Pretty name of current buffer's major mode (a string).");
2753 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2754 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2755 Automatically becomes buffer-local when set in any fashion.");
2757 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2759 "*Non-nil if searches should ignore case.\n\
2760 Automatically becomes buffer-local when set in any fashion.");
2762 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2763 make_number (Lisp_Int
),
2764 "*Column beyond which automatic line-wrapping should happen.\n\
2765 Automatically becomes buffer-local when set in any fashion.");
2767 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2768 make_number (Lisp_Int
),
2769 "*Column for the default indent-line-function to indent to.\n\
2770 Linefeed indents to this column in Fundamental mode.\n\
2771 Automatically becomes buffer-local when set in any fashion.");
2773 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2774 make_number (Lisp_Int
),
2775 "*Distance between tab stops (for display of tab characters), in columns.\n\
2776 Automatically becomes buffer-local when set in any fashion.");
2778 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2779 "*Non-nil means display control chars with uparrow.\n\
2780 Nil means use backslash and octal digits.\n\
2781 Automatically becomes buffer-local when set in any fashion.\n\
2782 This variable does not apply to characters whose display is specified\n\
2783 in the current display table (if there is one).");
2785 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2786 "*Non-nil means do not display continuation lines;\n\
2787 give each line of text one screen line.\n\
2788 Automatically becomes buffer-local when set in any fashion.\n\
2790 Note that this is overridden by the variable\n\
2791 `truncate-partial-width-windows' if that variable is non-nil\n\
2792 and this buffer is not full-frame width.");
2795 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
2797 "*If visited file is text, nil; otherwise, t.");
2800 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2801 make_number (Lisp_String
),
2802 "Name of default directory of current buffer. Should end with slash.\n\
2803 Each buffer has its own value of this variable.");
2805 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2807 "Function called (if non-nil) to perform auto-fill.\n\
2808 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2809 Each buffer has its own value of this variable.\n\
2810 NOTE: This variable is not an ordinary hook;\n\
2811 It may not be a list of functions.");
2813 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2814 make_number (Lisp_String
),
2815 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2816 Each buffer has its own value of this variable.");
2818 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2819 ¤t_buffer
->auto_save_file_name
,
2820 make_number (Lisp_String
),
2821 "Name of file for auto-saving current buffer,\n\
2822 or nil if buffer should not be auto-saved.\n\
2823 Each buffer has its own value of this variable.");
2825 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2826 "Non-nil if this buffer is read-only.\n\
2827 Each buffer has its own value of this variable.");
2829 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2830 "Non-nil if this buffer's file has been backed up.\n\
2831 Backing up is done before the first time the file is saved.\n\
2832 Each buffer has its own value of this variable.");
2834 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2835 make_number (Lisp_Int
),
2836 "Length of current buffer when last read in, saved or auto-saved.\n\
2838 Each buffer has its own value of this variable.");
2840 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2842 "Non-nil enables selective display:\n\
2843 Integer N as value means display only lines\n\
2844 that start with less than n columns of space.\n\
2845 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2846 Then ^M's in the file are written into files as newlines.\n\n\
2847 Automatically becomes buffer-local when set in any fashion.");
2850 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2851 ¤t_buffer
->selective_display_ellipses
,
2853 "t means display ... on previous line when a line is invisible.\n\
2854 Automatically becomes buffer-local when set in any fashion.");
2857 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2858 "Non-nil if self-insertion should replace existing text.\n\
2859 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2860 inserts at the end of a line, and inserts when point is before a tab,\n\
2861 until the tab is filled in.\n\
2862 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2863 Automatically becomes buffer-local when set in any fashion.");
2865 #if 0 /* The doc string is too long for some compilers,
2866 but make-docfile can find it in this comment. */
2867 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2869 "Display table that controls display of the contents of current buffer.\n\
2870 Automatically becomes buffer-local when set in any fashion.\n\
2871 The display table is a vector created with `make-display-table'.\n\
2872 The first 256 elements control how to display each possible text character.\n\
2873 Each value should be a vector of characters or nil;\n\
2874 nil means display the character in the default fashion.\n\
2875 The remaining six elements control the display of\n\
2876 the end of a truncated screen line (element 256, a single character);\n\
2877 the end of a continued line (element 257, a single character);\n\
2878 the escape character used to display character codes in octal\n\
2879 (element 258, a single character);\n\
2880 the character used as an arrow for control characters (element 259,\n\
2881 a single character);\n\
2882 the decoration indicating the presence of invisible lines (element 260,\n\
2883 a vector of characters);\n\
2884 the character used to draw the border between side-by-side windows\n\
2885 (element 261, a single character).\n\
2886 If this variable is nil, the value of `standard-display-table' is used.\n\
2887 Each window can have its own, overriding display table.");
2889 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2892 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2895 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2896 "Function to call before each text change.\n\
2897 Two arguments are passed to the function: the positions of\n\
2898 the beginning and end of the range of old text to be changed.\n\
2899 \(For an insertion, the beginning and end are at the same place.)\n\
2900 No information is given about the length of the text after the change.\n\
2902 Buffer changes made while executing the `before-change-function'\n\
2903 don't call any before-change or after-change functions.\n\
2904 That's because these variables are temporarily set to nil.\n\
2905 As a result, a hook function cannot straightforwardly alter the value of\n\
2906 these variables. See the Emacs Lisp manual for a way of\n\
2907 accomplishing an equivalent result by using other variables.");
2908 Vbefore_change_function
= Qnil
;
2910 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2911 "Function to call after each text change.\n\
2912 Three arguments are passed to the function: the positions of\n\
2913 the beginning and end of the range of changed text,\n\
2914 and the length of the pre-change text replaced by that range.\n\
2915 \(For an insertion, the pre-change length is zero;\n\
2916 for a deletion, that length is the number of characters deleted,\n\
2917 and the post-change beginning and end are at the same place.)\n\
2919 Buffer changes made while executing the `after-change-function'\n\
2920 don't call any before-change or after-change functions.\n\
2921 That's because these variables are temporarily set to nil.\n\
2922 As a result, a hook function cannot straightforwardly alter the value of\n\
2923 these variables. See the Emacs Lisp manual for a way of\n\
2924 accomplishing an equivalent result by using other variables.");
2925 Vafter_change_function
= Qnil
;
2927 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
2928 "List of functions to call before each text change.\n\
2929 Two arguments are passed to each function: the positions of\n\
2930 the beginning and end of the range of old text to be changed.\n\
2931 \(For an insertion, the beginning and end are at the same place.)\n\
2932 No information is given about the length of the text after the change.\n\
2934 Buffer changes made while executing the `before-change-functions'\n\
2935 don't call any before-change or after-change functions.\n\
2936 That's because these variables are temporarily set to nil.\n\
2937 As a result, a hook function cannot straightforwardly alter the value of\n\
2938 these variables. See the Emacs Lisp manual for a way of\n\
2939 accomplishing an equivalent result by using other variables.");
2940 Vbefore_change_functions
= Qnil
;
2942 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
2943 "List of function to call after each text change.\n\
2944 Three arguments are passed to each function: the positions of\n\
2945 the beginning and end of the range of changed text,\n\
2946 and the length of the pre-change text replaced by that range.\n\
2947 \(For an insertion, the pre-change length is zero;\n\
2948 for a deletion, that length is the number of characters deleted,\n\
2949 and the post-change beginning and end are at the same place.)\n\
2951 Buffer changes made while executing the `after-change-functions'\n\
2952 don't call any before-change or after-change functions.\n\
2953 That's because these variables are temporarily set to nil.\n\
2954 As a result, a hook function cannot straightforwardly alter the value of\n\
2955 these variables. See the Emacs Lisp manual for a way of\n\
2956 accomplishing an equivalent result by using other variables.");
2958 Vafter_change_functions
= Qnil
;
2960 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2961 "A list of functions to call before changing a buffer which is unmodified.\n\
2962 The functions are run using the `run-hooks' function.");
2963 Vfirst_change_hook
= Qnil
;
2964 Qfirst_change_hook
= intern ("first-change-hook");
2965 staticpro (&Qfirst_change_hook
);
2967 #if 0 /* The doc string is too long for some compilers,
2968 but make-docfile can find it in this comment. */
2969 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2970 "List of undo entries in current buffer.\n\
2971 Recent changes come first; older changes follow newer.\n\
2973 An entry (START . END) represents an insertion which begins at\n\
2974 position START and ends at position END.\n\
2976 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2977 from (abs POSITION). If POSITION is positive, point was at the front\n\
2978 of the text being deleted; if negative, point was at the end.\n\
2980 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2981 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
2982 16-bit words of the buffer's modification count at the time. If the\n\
2983 modification count of the most recent save is different, this entry is\n\
2986 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2987 was modified between BEG and END. PROP is the property name,\n\
2988 and VAL is the old value.\n\
2990 An entry of the form POSITION indicates that point was at the buffer\n\
2991 location given by the integer. Undoing an entry of this form places\n\
2992 point at POSITION.\n\
2994 nil marks undo boundaries. The undo command treats the changes\n\
2995 between two undo boundaries as a single step to be undone.\n\
2997 If the value of the variable is t, undo information is not recorded.");
2999 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3002 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3003 "Non-nil means the mark and region are currently active in this buffer.\n\
3004 Automatically local in all buffers.");
3006 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3007 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3008 This variable is buffer-local, in all buffers.\n\
3010 Normally, the line-motion functions work by scanning the buffer for\n\
3011 newlines. Columnar operations (like move-to-column and\n\
3012 compute-motion) also work by scanning the buffer, summing character\n\
3013 widths as they go. This works well for ordinary text, but if the\n\
3014 buffer's lines are very long (say, more than 500 characters), these\n\
3015 motion functions will take longer to execute. Emacs may also take\n\
3016 longer to update the display.\n\
3018 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3019 results of their scans, and consult the cache to avoid rescanning\n\
3020 regions of the buffer until the text is modified. The caches are most\n\
3021 beneficial when they prevent the most searching---that is, when the\n\
3022 buffer contains long lines and large regions of characters with the\n\
3023 same, fixed screen width.\n\
3025 When cache-long-line-scans is non-nil, processing short lines will\n\
3026 become slightly slower (because of the overhead of consulting the\n\
3027 cache), and the caches will use memory roughly proportional to the\n\
3028 number of newlines and characters whose screen width varies.\n\
3030 The caches require no explicit maintenance; their accuracy is\n\
3031 maintained internally by the Emacs primitives. Enabling or disabling\n\
3032 the cache should not affect the behavior of any of the motion\n\
3033 functions; it should only affect their performance.");
3035 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3036 "*Non-nil means deactivate the mark when the buffer contents change.");
3037 Vtransient_mark_mode
= Qnil
;
3039 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3040 "*Non-nil means disregard read-only status of buffers or characters.\n\
3041 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3042 text properties. If the value is a list, disregard `buffer-read-only'\n\
3043 and disregard a `read-only' text property if the property value\n\
3044 is a member of the list.");
3045 Vinhibit_read_only
= Qnil
;
3047 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3048 "List of functions called with no args to query before killing a buffer.");
3049 Vkill_buffer_query_functions
= Qnil
;
3051 defsubr (&Sbuffer_list
);
3052 defsubr (&Sget_buffer
);
3053 defsubr (&Sget_file_buffer
);
3054 defsubr (&Sget_buffer_create
);
3055 defsubr (&Sgenerate_new_buffer_name
);
3056 defsubr (&Sbuffer_name
);
3057 /*defsubr (&Sbuffer_number);*/
3058 defsubr (&Sbuffer_file_name
);
3059 defsubr (&Sbuffer_local_variables
);
3060 defsubr (&Sbuffer_modified_p
);
3061 defsubr (&Sset_buffer_modified_p
);
3062 defsubr (&Sbuffer_modified_tick
);
3063 defsubr (&Srename_buffer
);
3064 defsubr (&Sother_buffer
);
3065 defsubr (&Sbuffer_disable_undo
);
3066 defsubr (&Sbuffer_enable_undo
);
3067 defsubr (&Skill_buffer
);
3068 defsubr (&Serase_buffer
);
3069 defsubr (&Sset_buffer_major_mode
);
3070 defsubr (&Sswitch_to_buffer
);
3071 defsubr (&Spop_to_buffer
);
3072 defsubr (&Scurrent_buffer
);
3073 defsubr (&Sset_buffer
);
3074 defsubr (&Sbarf_if_buffer_read_only
);
3075 defsubr (&Sbury_buffer
);
3076 defsubr (&Slist_buffers
);
3077 defsubr (&Skill_all_local_variables
);
3079 defsubr (&Soverlayp
);
3080 defsubr (&Smake_overlay
);
3081 defsubr (&Sdelete_overlay
);
3082 defsubr (&Smove_overlay
);
3083 defsubr (&Soverlay_start
);
3084 defsubr (&Soverlay_end
);
3085 defsubr (&Soverlay_buffer
);
3086 defsubr (&Soverlay_properties
);
3087 defsubr (&Soverlays_at
);
3088 defsubr (&Snext_overlay_change
);
3089 defsubr (&Sprevious_overlay_change
);
3090 defsubr (&Soverlay_recenter
);
3091 defsubr (&Soverlay_lists
);
3092 defsubr (&Soverlay_get
);
3093 defsubr (&Soverlay_put
);
3098 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3099 initial_define_key (control_x_map
, 'k', "kill-buffer");
3100 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");
3102 /* This must not be in syms_of_buffer, because Qdisabled is not
3103 initialized when that function gets called. */
3104 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);