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 newname
, unique
;
574 register Lisp_Object tem
, buf
;
576 CHECK_STRING (newname
, 0);
578 if (XSTRING (newname
)->size
== 0)
579 error ("Empty string is invalid as a buffer name");
581 tem
= Fget_buffer (newname
);
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 NEWNAME)). */
586 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
587 return current_buffer
->name
;
591 newname
= Fgenerate_new_buffer_name (newname
, current_buffer
->name
);
593 error ("Buffer name `%s' is in use", XSTRING (newname
)->data
);
596 current_buffer
->name
= newname
;
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
), newname
);
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
= XBUFFER_LOCAL_VALUE (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
= XBUFFER_LOCAL_VALUE (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
, PT
);
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 (XBUFFER_LOCAL_VALUE (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 (XBUFFER_LOCAL_VALUE (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 (XBUFFER_LOCAL_VALUE (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 (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1293 = Fcurrent_buffer ();
1294 /* Store the current value into any forwarding in the symbol. */
1295 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1300 /* Actually eliminate all local bindings of this buffer. */
1302 reset_buffer_local_variables (current_buffer
);
1304 /* Redisplay mode lines; we are changing major mode. */
1306 update_mode_lines
++;
1308 /* Any which are supposed to be permanent,
1309 make local again, with the same values they had. */
1311 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1313 sym
= XCONS (XCONS (alist
)->car
)->car
;
1314 tem
= Fget (sym
, Qpermanent_local
);
1317 Fmake_local_variable (sym
);
1318 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1322 /* Force mode-line redisplay. Useful here because all major mode
1323 commands call this function. */
1324 update_mode_lines
++;
1329 /* Find all the overlays in the current buffer that contain position POS.
1330 Return the number found, and store them in a vector in *VEC_PTR.
1331 Store in *LEN_PTR the size allocated for the vector.
1332 Store in *NEXT_PTR the next position after POS where an overlay starts,
1333 or ZV if there are no more overlays.
1334 Store in *PREV_PTR the previous position after POS where an overlay ends,
1335 or BEGV if there are no previous overlays.
1336 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1338 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1339 when this function is called.
1341 If EXTEND is non-zero, we make the vector bigger if necessary.
1342 If EXTEND is zero, we never extend the vector,
1343 and we store only as many overlays as will fit.
1344 But we still return the total number of overlays. */
1347 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1350 Lisp_Object
**vec_ptr
;
1355 Lisp_Object tail
, overlay
, start
, end
, result
;
1358 Lisp_Object
*vec
= *vec_ptr
;
1361 int inhibit_storing
= 0;
1363 for (tail
= current_buffer
->overlays_before
;
1365 tail
= XCONS (tail
)->cdr
)
1367 int startpos
, endpos
;
1369 overlay
= XCONS (tail
)->car
;
1371 start
= OVERLAY_START (overlay
);
1372 end
= OVERLAY_END (overlay
);
1373 endpos
= OVERLAY_POSITION (end
);
1382 startpos
= OVERLAY_POSITION (start
);
1383 if (startpos
<= pos
)
1387 /* The supplied vector is full.
1388 Either make it bigger, or don't store any more in it. */
1391 *len_ptr
= len
*= 2;
1392 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1396 inhibit_storing
= 1;
1399 if (!inhibit_storing
)
1401 /* Keep counting overlays even if we can't return them all. */
1404 else if (startpos
< next
)
1408 for (tail
= current_buffer
->overlays_after
;
1410 tail
= XCONS (tail
)->cdr
)
1412 int startpos
, endpos
;
1414 overlay
= XCONS (tail
)->car
;
1416 start
= OVERLAY_START (overlay
);
1417 end
= OVERLAY_END (overlay
);
1418 startpos
= OVERLAY_POSITION (start
);
1421 if (startpos
< next
)
1425 endpos
= OVERLAY_POSITION (end
);
1432 *len_ptr
= len
*= 2;
1433 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1437 inhibit_storing
= 1;
1440 if (!inhibit_storing
)
1444 else if (endpos
< pos
&& endpos
> prev
)
1457 Lisp_Object overlay
;
1463 compare_overlays (s1
, s2
)
1464 struct sortvec
*s1
, *s2
;
1466 if (s1
->priority
!= s2
->priority
)
1467 return s1
->priority
- s2
->priority
;
1468 if (s1
->beg
!= s2
->beg
)
1469 return s1
->beg
- s2
->beg
;
1470 if (s1
->end
!= s2
->end
)
1471 return s2
->end
- s1
->end
;
1475 /* Sort an array of overlays by priority. The array is modified in place.
1476 The return value is the new size; this may be smaller than the original
1477 size if some of the overlays were invalid or were window-specific. */
1479 sort_overlays (overlay_vec
, noverlays
, w
)
1480 Lisp_Object
*overlay_vec
;
1485 struct sortvec
*sortvec
;
1486 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1488 /* Put the valid and relevant overlays into sortvec. */
1490 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1493 Lisp_Object overlay
;
1495 overlay
= overlay_vec
[i
];
1496 if (OVERLAY_VALID (overlay
)
1497 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1498 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1500 /* If we're interested in a specific window, then ignore
1501 overlays that are limited to some other window. */
1506 window
= Foverlay_get (overlay
, Qwindow
);
1507 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1511 /* This overlay is good and counts: put it into sortvec. */
1512 sortvec
[j
].overlay
= overlay
;
1513 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1514 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1515 tem
= Foverlay_get (overlay
, Qpriority
);
1517 sortvec
[j
].priority
= XINT (tem
);
1519 sortvec
[j
].priority
= 0;
1525 /* Sort the overlays into the proper order: increasing priority. */
1528 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1530 for (i
= 0; i
< noverlays
; i
++)
1531 overlay_vec
[i
] = sortvec
[i
].overlay
;
1535 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1538 recenter_overlay_lists (buf
, pos
)
1542 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1544 /* See if anything in overlays_before should move to overlays_after. */
1546 /* We don't strictly need prev in this loop; it should always be nil.
1547 But we use it for symmetry and in case that should cease to be true
1548 with some future change. */
1550 for (tail
= buf
->overlays_before
;
1552 prev
= tail
, tail
= next
)
1554 next
= XCONS (tail
)->cdr
;
1555 overlay
= XCONS (tail
)->car
;
1557 /* If the overlay is not valid, get rid of it. */
1558 if (!OVERLAY_VALID (overlay
))
1563 /* Splice the cons cell TAIL out of overlays_before. */
1565 XCONS (prev
)->cdr
= next
;
1567 buf
->overlays_before
= next
;
1573 beg
= OVERLAY_START (overlay
);
1574 end
= OVERLAY_END (overlay
);
1576 if (OVERLAY_POSITION (end
) > pos
)
1578 /* OVERLAY needs to be moved. */
1579 int where
= OVERLAY_POSITION (beg
);
1580 Lisp_Object other
, other_prev
;
1582 /* Splice the cons cell TAIL out of overlays_before. */
1584 XCONS (prev
)->cdr
= next
;
1586 buf
->overlays_before
= next
;
1588 /* Search thru overlays_after for where to put it. */
1590 for (other
= buf
->overlays_after
;
1592 other_prev
= other
, other
= XCONS (other
)->cdr
)
1594 Lisp_Object otherbeg
, otheroverlay
, follower
;
1597 otheroverlay
= XCONS (other
)->car
;
1598 if (! OVERLAY_VALID (otheroverlay
))
1601 otherbeg
= OVERLAY_START (otheroverlay
);
1602 if (OVERLAY_POSITION (otherbeg
) >= where
)
1606 /* Add TAIL to overlays_after before OTHER. */
1607 XCONS (tail
)->cdr
= other
;
1608 if (!NILP (other_prev
))
1609 XCONS (other_prev
)->cdr
= tail
;
1611 buf
->overlays_after
= tail
;
1615 /* We've reached the things that should stay in overlays_before.
1616 All the rest of overlays_before must end even earlier,
1621 /* See if anything in overlays_after should be in overlays_before. */
1623 for (tail
= buf
->overlays_after
;
1625 prev
= tail
, tail
= next
)
1627 next
= XCONS (tail
)->cdr
;
1628 overlay
= XCONS (tail
)->car
;
1630 /* If the overlay is not valid, get rid of it. */
1631 if (!OVERLAY_VALID (overlay
))
1636 /* Splice the cons cell TAIL out of overlays_after. */
1638 XCONS (prev
)->cdr
= next
;
1640 buf
->overlays_after
= next
;
1646 beg
= OVERLAY_START (overlay
);
1647 end
= OVERLAY_END (overlay
);
1649 /* Stop looking, when we know that nothing further
1650 can possibly end before POS. */
1651 if (OVERLAY_POSITION (beg
) > pos
)
1654 if (OVERLAY_POSITION (end
) <= pos
)
1656 /* OVERLAY needs to be moved. */
1657 int where
= OVERLAY_POSITION (end
);
1658 Lisp_Object other
, other_prev
;
1660 /* Splice the cons cell TAIL out of overlays_after. */
1662 XCONS (prev
)->cdr
= next
;
1664 buf
->overlays_after
= next
;
1666 /* Search thru overlays_before for where to put it. */
1668 for (other
= buf
->overlays_before
;
1670 other_prev
= other
, other
= XCONS (other
)->cdr
)
1672 Lisp_Object otherend
, otheroverlay
;
1675 otheroverlay
= XCONS (other
)->car
;
1676 if (! OVERLAY_VALID (otheroverlay
))
1679 otherend
= OVERLAY_END (otheroverlay
);
1680 if (OVERLAY_POSITION (otherend
) <= where
)
1684 /* Add TAIL to overlays_before before OTHER. */
1685 XCONS (tail
)->cdr
= other
;
1686 if (!NILP (other_prev
))
1687 XCONS (other_prev
)->cdr
= tail
;
1689 buf
->overlays_before
= tail
;
1694 XSETFASTINT (buf
->overlay_center
, pos
);
1697 /* Fix up overlays that were garbled as a result of permuting markers
1698 in the range START through END. Any overlay with at least one
1699 endpoint in this range will need to be unlinked from the overlay
1700 list and reinserted in its proper place.
1701 Such an overlay might even have negative size at this point.
1702 If so, we'll reverse the endpoints. Can you think of anything
1703 better to do in this situation? */
1705 fix_overlays_in_range (start
, end
)
1706 register int start
, end
;
1708 Lisp_Object tem
, overlay
;
1709 Lisp_Object before_list
, after_list
;
1710 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
1711 int startpos
, endpos
;
1713 /* This algorithm shifts links around instead of consing and GCing.
1714 The loop invariant is that before_list (resp. after_list) is a
1715 well-formed list except that its last element, the one that
1716 *pbefore (resp. *pafter) points to, is still uninitialized.
1717 So it's not a bug that before_list isn't initialized, although
1718 it may look strange. */
1719 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
1721 overlay
= XCONS (*ptail
)->car
;
1722 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1725 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1727 || (startpos
>= start
&& startpos
< end
))
1729 /* If the overlay is backwards, fix that now. */
1730 if (startpos
> endpos
)
1733 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1734 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1735 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1737 /* Add it to the end of the wrong list. Later on,
1738 recenter_overlay_lists will move it to the right place. */
1739 if (endpos
< XINT (current_buffer
->overlay_center
))
1742 pafter
= &XCONS (*ptail
)->cdr
;
1747 pbefore
= &XCONS (*ptail
)->cdr
;
1749 *ptail
= XCONS (*ptail
)->cdr
;
1752 ptail
= &XCONS (*ptail
)->cdr
;
1754 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
1756 overlay
= XCONS (*ptail
)->car
;
1757 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1758 if (startpos
>= end
)
1760 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1761 if (startpos
>= start
1762 || (endpos
>= start
&& endpos
< end
))
1764 if (startpos
> endpos
)
1767 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1768 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1769 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1771 if (endpos
< XINT (current_buffer
->overlay_center
))
1774 pafter
= &XCONS (*ptail
)->cdr
;
1779 pbefore
= &XCONS (*ptail
)->cdr
;
1781 *ptail
= XCONS (*ptail
)->cdr
;
1784 ptail
= &XCONS (*ptail
)->cdr
;
1787 /* Splice the constructed (wrong) lists into the buffer's lists,
1788 and let the recenter function make it sane again. */
1789 *pbefore
= current_buffer
->overlays_before
;
1790 current_buffer
->overlays_before
= before_list
;
1791 recenter_overlay_lists (current_buffer
,
1792 XINT (current_buffer
->overlay_center
));
1794 *pafter
= current_buffer
->overlays_after
;
1795 current_buffer
->overlays_after
= after_list
;
1796 recenter_overlay_lists (current_buffer
,
1797 XINT (current_buffer
->overlay_center
));
1800 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1801 "Return t if OBJECT is an overlay.")
1805 return (OVERLAYP (object
) ? Qt
: Qnil
);
1808 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1809 "Create a new overlay with range BEG to END in BUFFER.\n\
1810 If omitted, BUFFER defaults to the current buffer.\n\
1811 BEG and END may be integers or markers.")
1813 Lisp_Object beg
, end
, buffer
;
1815 Lisp_Object overlay
;
1819 XSETBUFFER (buffer
, current_buffer
);
1821 CHECK_BUFFER (buffer
, 2);
1823 && ! EQ (Fmarker_buffer (beg
), buffer
))
1824 error ("Marker points into wrong buffer");
1826 && ! EQ (Fmarker_buffer (end
), buffer
))
1827 error ("Marker points into wrong buffer");
1829 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1830 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1832 if (XINT (beg
) > XINT (end
))
1835 temp
= beg
; beg
= end
; end
= temp
;
1838 b
= XBUFFER (buffer
);
1840 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1841 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1843 overlay
= allocate_misc ();
1844 XMISC (overlay
)->type
= Lisp_Misc_Overlay
;
1845 XOVERLAY (overlay
)->start
= beg
;
1846 XOVERLAY (overlay
)->end
= end
;
1847 XOVERLAY (overlay
)->plist
= Qnil
;
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 (XOVERLAY (overlay
)->plist
);
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
= XOVERLAY (overlay
)->plist
;
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 tail
, buffer
;
2231 CHECK_OVERLAY (overlay
, 0);
2233 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2235 for (tail
= XOVERLAY (overlay
)->plist
;
2236 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2237 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2238 if (EQ (XCONS (tail
)->car
, prop
))
2240 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2241 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2244 /* It wasn't in the list, so add it to the front. */
2245 changed
= !NILP (value
);
2246 XOVERLAY (overlay
)->plist
2247 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
2249 if (! NILP (buffer
))
2252 redisplay_region (XBUFFER (buffer
),
2253 marker_position (OVERLAY_START (overlay
)),
2254 marker_position (OVERLAY_END (overlay
)));
2255 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2256 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2257 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2258 Fdelete_overlay (overlay
);
2263 /* Run the modification-hooks of overlays that include
2264 any part of the text in START to END.
2265 Run the insert-before-hooks of overlay starting at END,
2266 and the insert-after-hooks of overlay ending at START. */
2269 verify_overlay_modification (start
, end
)
2270 Lisp_Object start
, end
;
2272 Lisp_Object prop
, overlay
, tail
;
2273 int insertion
= EQ (start
, end
);
2275 struct gcpro gcpro1
, gcpro2
;
2279 GCPRO2 (overlay
, tail
);
2282 for (tail
= current_buffer
->overlays_before
;
2284 tail
= XCONS (tail
)->cdr
)
2286 int startpos
, endpos
;
2287 Lisp_Object ostart
, oend
;
2289 overlay
= XCONS (tail
)->car
;
2291 ostart
= OVERLAY_START (overlay
);
2292 oend
= OVERLAY_END (overlay
);
2293 endpos
= OVERLAY_POSITION (oend
);
2294 if (XFASTINT (start
) > endpos
)
2296 startpos
= OVERLAY_POSITION (ostart
);
2297 if (XFASTINT (end
) == startpos
&& insertion
)
2299 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2302 /* Copy TAIL in case the hook recenters the overlay lists. */
2304 tail
= Fcopy_sequence (tail
);
2306 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2309 if (XFASTINT (start
) == endpos
&& insertion
)
2311 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2315 tail
= Fcopy_sequence (tail
);
2317 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2320 /* Test for intersecting intervals. This does the right thing
2321 for both insertion and deletion. */
2322 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2324 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2328 tail
= Fcopy_sequence (tail
);
2330 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2336 for (tail
= current_buffer
->overlays_after
;
2338 tail
= XCONS (tail
)->cdr
)
2340 int startpos
, endpos
;
2341 Lisp_Object ostart
, oend
;
2343 overlay
= XCONS (tail
)->car
;
2345 ostart
= OVERLAY_START (overlay
);
2346 oend
= OVERLAY_END (overlay
);
2347 startpos
= OVERLAY_POSITION (ostart
);
2348 endpos
= OVERLAY_POSITION (oend
);
2349 if (XFASTINT (end
) < startpos
)
2351 if (XFASTINT (end
) == startpos
&& insertion
)
2353 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2357 tail
= Fcopy_sequence (tail
);
2359 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2362 if (XFASTINT (start
) == endpos
&& insertion
)
2364 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2368 tail
= Fcopy_sequence (tail
);
2370 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2373 /* Test for intersecting intervals. This does the right thing
2374 for both insertion and deletion. */
2375 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2377 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2381 tail
= Fcopy_sequence (tail
);
2383 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
2392 call_overlay_mod_hooks (list
, overlay
, start
, end
)
2393 Lisp_Object list
, overlay
, start
, end
;
2395 struct gcpro gcpro1
;
2397 while (!NILP (list
))
2399 call3 (Fcar (list
), overlay
, start
, end
);
2405 /* Delete any zero-sized overlays at position POS, if the `evaporate'
2408 evaporate_overlays (pos
)
2411 Lisp_Object tail
, overlay
, hit_list
;
2414 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
2415 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
2416 tail
= XCONS (tail
)->cdr
)
2419 overlay
= XCONS (tail
)->car
;
2420 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2423 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
2424 && Foverlay_get (overlay
, Qevaporate
))
2425 hit_list
= Fcons (overlay
, hit_list
);
2428 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
2429 tail
= XCONS (tail
)->cdr
)
2432 overlay
= XCONS (tail
)->car
;
2433 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2436 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
2437 && Foverlay_get (overlay
, Qevaporate
))
2438 hit_list
= Fcons (overlay
, hit_list
);
2440 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
2441 Fdelete_overlay (XCONS (hit_list
)->car
);
2444 /* Somebody has tried to store a value with an unacceptable type
2445 into the buffer-local slot with offset OFFSET. */
2447 buffer_slot_type_mismatch (offset
)
2452 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
2453 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
2455 case Lisp_Int
: type_name
= "integers"; break;
2456 case Lisp_String
: type_name
= "strings"; break;
2457 case Lisp_Symbol
: type_name
= "symbols"; break;
2462 error ("only %s should be stored in the buffer-local variable %s",
2463 type_name
, XSYMBOL (sym
)->name
->data
);
2468 register Lisp_Object tem
;
2470 /* Make sure all markable slots in buffer_defaults
2471 are initialized reasonably, so mark_buffer won't choke. */
2472 reset_buffer (&buffer_defaults
);
2473 reset_buffer_local_variables (&buffer_defaults
);
2474 reset_buffer (&buffer_local_symbols
);
2475 reset_buffer_local_variables (&buffer_local_symbols
);
2476 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
2477 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
2479 /* Set up the default values of various buffer slots. */
2480 /* Must do these before making the first buffer! */
2482 /* real setup is done in loaddefs.el */
2483 buffer_defaults
.mode_line_format
= build_string ("%-");
2484 buffer_defaults
.abbrev_mode
= Qnil
;
2485 buffer_defaults
.overwrite_mode
= Qnil
;
2486 buffer_defaults
.case_fold_search
= Qt
;
2487 buffer_defaults
.auto_fill_function
= Qnil
;
2488 buffer_defaults
.selective_display
= Qnil
;
2490 buffer_defaults
.selective_display_ellipses
= Qt
;
2492 buffer_defaults
.abbrev_table
= Qnil
;
2493 buffer_defaults
.display_table
= Qnil
;
2494 buffer_defaults
.undo_list
= Qnil
;
2495 buffer_defaults
.mark_active
= Qnil
;
2496 buffer_defaults
.overlays_before
= Qnil
;
2497 buffer_defaults
.overlays_after
= Qnil
;
2498 XSETFASTINT (buffer_defaults
.overlay_center
, 1);
2500 XSETFASTINT (buffer_defaults
.tab_width
, 8);
2501 buffer_defaults
.truncate_lines
= Qnil
;
2502 buffer_defaults
.ctl_arrow
= Qt
;
2505 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
2507 XSETFASTINT (buffer_defaults
.fill_column
, 70);
2508 XSETFASTINT (buffer_defaults
.left_margin
, 0);
2509 buffer_defaults
.cache_long_line_scans
= Qnil
;
2511 /* Assign the local-flags to the slots that have default values.
2512 The local flag is a bit that is used in the buffer
2513 to say that it has its own local value for the slot.
2514 The local flag bits are in the local_var_flags slot of the buffer. */
2516 /* Nothing can work if this isn't true */
2517 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
2519 /* 0 means not a lisp var, -1 means always local, else mask */
2520 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2521 XSETINT (buffer_local_flags
.filename
, -1);
2522 XSETINT (buffer_local_flags
.directory
, -1);
2523 XSETINT (buffer_local_flags
.backed_up
, -1);
2524 XSETINT (buffer_local_flags
.save_length
, -1);
2525 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
2526 XSETINT (buffer_local_flags
.read_only
, -1);
2527 XSETINT (buffer_local_flags
.major_mode
, -1);
2528 XSETINT (buffer_local_flags
.mode_name
, -1);
2529 XSETINT (buffer_local_flags
.undo_list
, -1);
2530 XSETINT (buffer_local_flags
.mark_active
, -1);
2532 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
2533 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
2534 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
2535 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
2536 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
2537 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
2539 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
2541 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
2542 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
2543 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
2544 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
2545 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
2546 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
2547 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
2548 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
2549 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
2551 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
2554 Vbuffer_alist
= Qnil
;
2558 QSFundamental
= build_string ("Fundamental");
2560 Qfundamental_mode
= intern ("fundamental-mode");
2561 buffer_defaults
.major_mode
= Qfundamental_mode
;
2563 Qmode_class
= intern ("mode-class");
2565 Qprotected_field
= intern ("protected-field");
2567 Qpermanent_local
= intern ("permanent-local");
2569 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2571 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2572 /* super-magic invisible buffer */
2573 Vbuffer_alist
= Qnil
;
2575 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2580 char buf
[MAXPATHLEN
+1];
2582 struct stat dotstat
, pwdstat
;
2586 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2588 /* If PWD is accurate, use it instead of calling getwd. This is faster
2589 when PWD is right, and may avoid a fatal error. */
2590 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
2591 && stat (pwd
, &pwdstat
) == 0
2592 && stat (".", &dotstat
) == 0
2593 && dotstat
.st_ino
== pwdstat
.st_ino
2594 && dotstat
.st_dev
== pwdstat
.st_dev
2595 && strlen (pwd
) < MAXPATHLEN
)
2597 else if (getwd (buf
) == 0)
2598 fatal ("`getwd' failed: %s\n", buf
);
2601 /* Maybe this should really use some standard subroutine
2602 whose definition is filename syntax dependent. */
2604 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
2606 buf
[rc
] = DIRECTORY_SEP
;
2609 #endif /* not VMS */
2610 current_buffer
->directory
= build_string (buf
);
2612 temp
= get_minibuffer (0);
2613 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2616 /* initialize the buffer routines */
2619 extern Lisp_Object Qdisabled
;
2621 staticpro (&Vbuffer_defaults
);
2622 staticpro (&Vbuffer_local_symbols
);
2623 staticpro (&Qfundamental_mode
);
2624 staticpro (&Qmode_class
);
2625 staticpro (&QSFundamental
);
2626 staticpro (&Vbuffer_alist
);
2627 staticpro (&Qprotected_field
);
2628 staticpro (&Qpermanent_local
);
2629 staticpro (&Qkill_buffer_hook
);
2630 staticpro (&Qoverlayp
);
2631 Qevaporate
= intern ("evaporate");
2632 staticpro (&Qevaporate
);
2633 staticpro (&Qmodification_hooks
);
2634 Qmodification_hooks
= intern ("modification-hooks");
2635 staticpro (&Qinsert_in_front_hooks
);
2636 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
2637 staticpro (&Qinsert_behind_hooks
);
2638 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
2639 staticpro (&Qget_file_buffer
);
2640 Qget_file_buffer
= intern ("get-file-buffer");
2641 Qpriority
= intern ("priority");
2642 staticpro (&Qpriority
);
2643 Qwindow
= intern ("window");
2644 staticpro (&Qwindow
);
2646 Qoverlayp
= intern ("overlayp");
2648 Fput (Qprotected_field
, Qerror_conditions
,
2649 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2650 Fput (Qprotected_field
, Qerror_message
,
2651 build_string ("Attempt to modify a protected field"));
2653 /* All these use DEFVAR_LISP_NOPRO because the slots in
2654 buffer_defaults will all be marked via Vbuffer_defaults. */
2656 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2657 &buffer_defaults
.mode_line_format
,
2658 "Default value of `mode-line-format' for buffers that don't override it.\n\
2659 This is the same as (default-value 'mode-line-format).");
2661 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2662 &buffer_defaults
.abbrev_mode
,
2663 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2664 This is the same as (default-value 'abbrev-mode).");
2666 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2667 &buffer_defaults
.ctl_arrow
,
2668 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2669 This is the same as (default-value 'ctl-arrow).");
2671 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2672 &buffer_defaults
.truncate_lines
,
2673 "Default value of `truncate-lines' for buffers that do not override it.\n\
2674 This is the same as (default-value 'truncate-lines).");
2676 DEFVAR_LISP_NOPRO ("default-fill-column",
2677 &buffer_defaults
.fill_column
,
2678 "Default value of `fill-column' for buffers that do not override it.\n\
2679 This is the same as (default-value 'fill-column).");
2681 DEFVAR_LISP_NOPRO ("default-left-margin",
2682 &buffer_defaults
.left_margin
,
2683 "Default value of `left-margin' for buffers that do not override it.\n\
2684 This is the same as (default-value 'left-margin).");
2686 DEFVAR_LISP_NOPRO ("default-tab-width",
2687 &buffer_defaults
.tab_width
,
2688 "Default value of `tab-width' for buffers that do not override it.\n\
2689 This is the same as (default-value 'tab-width).");
2691 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2692 &buffer_defaults
.case_fold_search
,
2693 "Default value of `case-fold-search' for buffers that don't override it.\n\
2694 This is the same as (default-value 'case-fold-search).");
2697 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
2698 &buffer_defaults
.buffer_file_type
,
2699 "Default file type for buffers that do not override it.\n\
2700 This is the same as (default-value 'buffer-file-type).\n\
2701 The file type is nil for text, t for binary.");
2704 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2707 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2708 But make-docfile finds it!
2709 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2711 "Template for displaying mode line for current buffer.\n\
2712 Each buffer has its own value of this variable.\n\
2713 Value may be a string, a symbol or a list or cons cell.\n\
2714 For a symbol, its value is used (but it is ignored if t or nil).\n\
2715 A string appearing directly as the value of a symbol is processed verbatim\n\
2716 in that the %-constructs below are not recognized.\n\
2717 For a list whose car is a symbol, the symbol's value is taken,\n\
2718 and if that is non-nil, the cadr of the list is processed recursively.\n\
2719 Otherwise, the caddr of the list (if there is one) is processed.\n\
2720 For a list whose car is a string or list, each element is processed\n\
2721 recursively and the results are effectively concatenated.\n\
2722 For a list whose car is an integer, the cdr of the list is processed\n\
2723 and padded (if the number is positive) or truncated (if negative)\n\
2724 to the width specified by that number.\n\
2725 A string is printed verbatim in the mode line except for %-constructs:\n\
2726 (%-constructs are allowed when the string is the entire mode-line-format\n\
2727 or when it is found in a cons-cell or a list)\n\
2728 %b -- print buffer name. %f -- print visited file name.\n\
2729 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
2730 % means buffer is read-only and * means it is modified.\n\
2731 For a modified read-only buffer, %* gives % and %+ gives *.\n\
2732 %s -- print process status. %l -- print the current line number.\n\
2733 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
2734 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
2735 or print Bottom or All.\n\
2736 %n -- print Narrow if appropriate.\n\
2737 %t -- print T if files is text, B if binary.\n\
2738 %[ -- print one [ for each recursive editing level. %] similar.\n\
2739 %% -- print %. %- -- print infinitely many dashes.\n\
2740 Decimal digits after the % specify field width to which to pad.");
2743 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2744 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2745 nil here means use current buffer's major mode.");
2747 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2748 make_number (Lisp_Symbol
),
2749 "Symbol for current buffer's major mode.");
2751 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2752 make_number (Lisp_String
),
2753 "Pretty name of current buffer's major mode (a string).");
2755 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2756 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2757 Automatically becomes buffer-local when set in any fashion.");
2759 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2761 "*Non-nil if searches should ignore case.\n\
2762 Automatically becomes buffer-local when set in any fashion.");
2764 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2765 make_number (Lisp_Int
),
2766 "*Column beyond which automatic line-wrapping should happen.\n\
2767 Automatically becomes buffer-local when set in any fashion.");
2769 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2770 make_number (Lisp_Int
),
2771 "*Column for the default indent-line-function to indent to.\n\
2772 Linefeed indents to this column in Fundamental mode.\n\
2773 Automatically becomes buffer-local when set in any fashion.");
2775 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2776 make_number (Lisp_Int
),
2777 "*Distance between tab stops (for display of tab characters), in columns.\n\
2778 Automatically becomes buffer-local when set in any fashion.");
2780 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2781 "*Non-nil means display control chars with uparrow.\n\
2782 Nil means use backslash and octal digits.\n\
2783 Automatically becomes buffer-local when set in any fashion.\n\
2784 This variable does not apply to characters whose display is specified\n\
2785 in the current display table (if there is one).");
2787 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2788 "*Non-nil means do not display continuation lines;\n\
2789 give each line of text one screen line.\n\
2790 Automatically becomes buffer-local when set in any fashion.\n\
2792 Note that this is overridden by the variable\n\
2793 `truncate-partial-width-windows' if that variable is non-nil\n\
2794 and this buffer is not full-frame width.");
2797 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
2799 "*If visited file is text, nil; otherwise, t.");
2802 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2803 make_number (Lisp_String
),
2804 "Name of default directory of current buffer. Should end with slash.\n\
2805 Each buffer has its own value of this variable.");
2807 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2809 "Function called (if non-nil) to perform auto-fill.\n\
2810 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2811 Each buffer has its own value of this variable.\n\
2812 NOTE: This variable is not an ordinary hook;\n\
2813 It may not be a list of functions.");
2815 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2816 make_number (Lisp_String
),
2817 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2818 Each buffer has its own value of this variable.");
2820 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2821 ¤t_buffer
->auto_save_file_name
,
2822 make_number (Lisp_String
),
2823 "Name of file for auto-saving current buffer,\n\
2824 or nil if buffer should not be auto-saved.\n\
2825 Each buffer has its own value of this variable.");
2827 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2828 "Non-nil if this buffer is read-only.\n\
2829 Each buffer has its own value of this variable.");
2831 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2832 "Non-nil if this buffer's file has been backed up.\n\
2833 Backing up is done before the first time the file is saved.\n\
2834 Each buffer has its own value of this variable.");
2836 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2837 make_number (Lisp_Int
),
2838 "Length of current buffer when last read in, saved or auto-saved.\n\
2840 Each buffer has its own value of this variable.");
2842 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2844 "Non-nil enables selective display:\n\
2845 Integer N as value means display only lines\n\
2846 that start with less than n columns of space.\n\
2847 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2848 Then ^M's in the file are written into files as newlines.\n\n\
2849 Automatically becomes buffer-local when set in any fashion.");
2852 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2853 ¤t_buffer
->selective_display_ellipses
,
2855 "t means display ... on previous line when a line is invisible.\n\
2856 Automatically becomes buffer-local when set in any fashion.");
2859 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2860 "Non-nil if self-insertion should replace existing text.\n\
2861 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2862 inserts at the end of a line, and inserts when point is before a tab,\n\
2863 until the tab is filled in.\n\
2864 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2865 Automatically becomes buffer-local when set in any fashion.");
2867 #if 0 /* The doc string is too long for some compilers,
2868 but make-docfile can find it in this comment. */
2869 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2871 "Display table that controls display of the contents of current buffer.\n\
2872 Automatically becomes buffer-local when set in any fashion.\n\
2873 The display table is a vector created with `make-display-table'.\n\
2874 The first 256 elements control how to display each possible text character.\n\
2875 Each value should be a vector of characters or nil;\n\
2876 nil means display the character in the default fashion.\n\
2877 The remaining six elements control the display of\n\
2878 the end of a truncated screen line (element 256, a single character);\n\
2879 the end of a continued line (element 257, a single character);\n\
2880 the escape character used to display character codes in octal\n\
2881 (element 258, a single character);\n\
2882 the character used as an arrow for control characters (element 259,\n\
2883 a single character);\n\
2884 the decoration indicating the presence of invisible lines (element 260,\n\
2885 a vector of characters);\n\
2886 the character used to draw the border between side-by-side windows\n\
2887 (element 261, a single character).\n\
2888 If this variable is nil, the value of `standard-display-table' is used.\n\
2889 Each window can have its own, overriding display table.");
2891 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2894 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2897 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2898 "Function to call before each text change.\n\
2899 Two arguments are passed to the function: the positions of\n\
2900 the beginning and end of the range of old text to be changed.\n\
2901 \(For an insertion, the beginning and end are at the same place.)\n\
2902 No information is given about the length of the text after the change.\n\
2904 Buffer changes made while executing the `before-change-function'\n\
2905 don't call any before-change or after-change functions.\n\
2906 That's because these variables are temporarily set to nil.\n\
2907 As a result, a hook function cannot straightforwardly alter the value of\n\
2908 these variables. See the Emacs Lisp manual for a way of\n\
2909 accomplishing an equivalent result by using other variables.");
2910 Vbefore_change_function
= Qnil
;
2912 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2913 "Function to call after each text change.\n\
2914 Three arguments are passed to the function: the positions of\n\
2915 the beginning and end of the range of changed text,\n\
2916 and the length of the pre-change text replaced by that range.\n\
2917 \(For an insertion, the pre-change length is zero;\n\
2918 for a deletion, that length is the number of characters deleted,\n\
2919 and the post-change beginning and end are at the same place.)\n\
2921 Buffer changes made while executing the `after-change-function'\n\
2922 don't call any before-change or after-change functions.\n\
2923 That's because these variables are temporarily set to nil.\n\
2924 As a result, a hook function cannot straightforwardly alter the value of\n\
2925 these variables. See the Emacs Lisp manual for a way of\n\
2926 accomplishing an equivalent result by using other variables.");
2927 Vafter_change_function
= Qnil
;
2929 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
2930 "List of functions to call before each text change.\n\
2931 Two arguments are passed to each function: the positions of\n\
2932 the beginning and end of the range of old text to be changed.\n\
2933 \(For an insertion, the beginning and end are at the same place.)\n\
2934 No information is given about the length of the text after the change.\n\
2936 Buffer changes made while executing the `before-change-functions'\n\
2937 don't call any before-change or after-change functions.\n\
2938 That's because these variables are temporarily set to nil.\n\
2939 As a result, a hook function cannot straightforwardly alter the value of\n\
2940 these variables. See the Emacs Lisp manual for a way of\n\
2941 accomplishing an equivalent result by using other variables.");
2942 Vbefore_change_functions
= Qnil
;
2944 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
2945 "List of function to call after each text change.\n\
2946 Three arguments are passed to each function: the positions of\n\
2947 the beginning and end of the range of changed text,\n\
2948 and the length of the pre-change text replaced by that range.\n\
2949 \(For an insertion, the pre-change length is zero;\n\
2950 for a deletion, that length is the number of characters deleted,\n\
2951 and the post-change beginning and end are at the same place.)\n\
2953 Buffer changes made while executing the `after-change-functions'\n\
2954 don't call any before-change or after-change functions.\n\
2955 That's because these variables are temporarily set to nil.\n\
2956 As a result, a hook function cannot straightforwardly alter the value of\n\
2957 these variables. See the Emacs Lisp manual for a way of\n\
2958 accomplishing an equivalent result by using other variables.");
2960 Vafter_change_functions
= Qnil
;
2962 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2963 "A list of functions to call before changing a buffer which is unmodified.\n\
2964 The functions are run using the `run-hooks' function.");
2965 Vfirst_change_hook
= Qnil
;
2966 Qfirst_change_hook
= intern ("first-change-hook");
2967 staticpro (&Qfirst_change_hook
);
2969 #if 0 /* The doc string is too long for some compilers,
2970 but make-docfile can find it in this comment. */
2971 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2972 "List of undo entries in current buffer.\n\
2973 Recent changes come first; older changes follow newer.\n\
2975 An entry (START . END) represents an insertion which begins at\n\
2976 position START and ends at position END.\n\
2978 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2979 from (abs POSITION). If POSITION is positive, point was at the front\n\
2980 of the text being deleted; if negative, point was at the end.\n\
2982 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2983 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
2984 16-bit words of the buffer's modification count at the time. If the\n\
2985 modification count of the most recent save is different, this entry is\n\
2988 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2989 was modified between BEG and END. PROP is the property name,\n\
2990 and VAL is the old value.\n\
2992 An entry of the form POSITION indicates that point was at the buffer\n\
2993 location given by the integer. Undoing an entry of this form places\n\
2994 point at POSITION.\n\
2996 nil marks undo boundaries. The undo command treats the changes\n\
2997 between two undo boundaries as a single step to be undone.\n\
2999 If the value of the variable is t, undo information is not recorded.");
3001 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3004 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3005 "Non-nil means the mark and region are currently active in this buffer.\n\
3006 Automatically local in all buffers.");
3008 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3009 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3010 This variable is buffer-local, in all buffers.\n\
3012 Normally, the line-motion functions work by scanning the buffer for\n\
3013 newlines. Columnar operations (like move-to-column and\n\
3014 compute-motion) also work by scanning the buffer, summing character\n\
3015 widths as they go. This works well for ordinary text, but if the\n\
3016 buffer's lines are very long (say, more than 500 characters), these\n\
3017 motion functions will take longer to execute. Emacs may also take\n\
3018 longer to update the display.\n\
3020 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3021 results of their scans, and consult the cache to avoid rescanning\n\
3022 regions of the buffer until the text is modified. The caches are most\n\
3023 beneficial when they prevent the most searching---that is, when the\n\
3024 buffer contains long lines and large regions of characters with the\n\
3025 same, fixed screen width.\n\
3027 When cache-long-line-scans is non-nil, processing short lines will\n\
3028 become slightly slower (because of the overhead of consulting the\n\
3029 cache), and the caches will use memory roughly proportional to the\n\
3030 number of newlines and characters whose screen width varies.\n\
3032 The caches require no explicit maintenance; their accuracy is\n\
3033 maintained internally by the Emacs primitives. Enabling or disabling\n\
3034 the cache should not affect the behavior of any of the motion\n\
3035 functions; it should only affect their performance.");
3037 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3038 "*Non-nil means deactivate the mark when the buffer contents change.");
3039 Vtransient_mark_mode
= Qnil
;
3041 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3042 "*Non-nil means disregard read-only status of buffers or characters.\n\
3043 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3044 text properties. If the value is a list, disregard `buffer-read-only'\n\
3045 and disregard a `read-only' text property if the property value\n\
3046 is a member of the list.");
3047 Vinhibit_read_only
= Qnil
;
3049 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3050 "List of functions called with no args to query before killing a buffer.");
3051 Vkill_buffer_query_functions
= Qnil
;
3053 defsubr (&Sbuffer_list
);
3054 defsubr (&Sget_buffer
);
3055 defsubr (&Sget_file_buffer
);
3056 defsubr (&Sget_buffer_create
);
3057 defsubr (&Sgenerate_new_buffer_name
);
3058 defsubr (&Sbuffer_name
);
3059 /*defsubr (&Sbuffer_number);*/
3060 defsubr (&Sbuffer_file_name
);
3061 defsubr (&Sbuffer_local_variables
);
3062 defsubr (&Sbuffer_modified_p
);
3063 defsubr (&Sset_buffer_modified_p
);
3064 defsubr (&Sbuffer_modified_tick
);
3065 defsubr (&Srename_buffer
);
3066 defsubr (&Sother_buffer
);
3067 defsubr (&Sbuffer_disable_undo
);
3068 defsubr (&Sbuffer_enable_undo
);
3069 defsubr (&Skill_buffer
);
3070 defsubr (&Serase_buffer
);
3071 defsubr (&Sset_buffer_major_mode
);
3072 defsubr (&Sswitch_to_buffer
);
3073 defsubr (&Spop_to_buffer
);
3074 defsubr (&Scurrent_buffer
);
3075 defsubr (&Sset_buffer
);
3076 defsubr (&Sbarf_if_buffer_read_only
);
3077 defsubr (&Sbury_buffer
);
3078 defsubr (&Slist_buffers
);
3079 defsubr (&Skill_all_local_variables
);
3081 defsubr (&Soverlayp
);
3082 defsubr (&Smake_overlay
);
3083 defsubr (&Sdelete_overlay
);
3084 defsubr (&Smove_overlay
);
3085 defsubr (&Soverlay_start
);
3086 defsubr (&Soverlay_end
);
3087 defsubr (&Soverlay_buffer
);
3088 defsubr (&Soverlay_properties
);
3089 defsubr (&Soverlays_at
);
3090 defsubr (&Snext_overlay_change
);
3091 defsubr (&Sprevious_overlay_change
);
3092 defsubr (&Soverlay_recenter
);
3093 defsubr (&Soverlay_lists
);
3094 defsubr (&Soverlay_get
);
3095 defsubr (&Soverlay_put
);
3100 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3101 initial_define_key (control_x_map
, 'k', "kill-buffer");
3102 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");
3104 /* This must not be in syms_of_buffer, because Qdisabled is not
3105 initialized when that function gets called. */
3106 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);