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 internal_delete_file (b
->auto_save_file_name
);
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
, 17);
1146 XSETFASTINT (col2
, 28);
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 tem
= Findent_to (col1
, make_number (2));
1186 sprintf (sizebuf
, "%8d", BUF_Z (b
) - BUF_BEG (b
));
1187 /* Here's how many extra columns the buffer name used. */
1188 i
= XFASTINT (tem
) - XFASTINT (col1
);
1189 /* Skip that many spaces in the size, if it has that many,
1190 to keep the size values right-aligned if possible. */
1199 write_string (p
, -1);
1201 Findent_to (col2
, minspace
);
1202 Fprinc (b
->mode_name
, Qnil
);
1203 Findent_to (col3
, minspace
);
1205 if (!NILP (b
->filename
))
1206 Fprinc (b
->filename
, Qnil
);
1209 /* No visited file; check local value of list-buffers-directory. */
1211 set_buffer_internal (b
);
1212 tem
= Fboundp (other_file_symbol
);
1215 tem
= Fsymbol_value (other_file_symbol
);
1216 Fset_buffer (Vstandard_output
);
1221 Fset_buffer (Vstandard_output
);
1223 write_string ("\n", -1);
1226 tail
= intern ("Buffer-menu-mode");
1227 if ((tem
= Ffboundp (tail
), !NILP (tem
)))
1229 set_buffer_internal (old
);
1230 return desired_point
;
1233 DEFUN ("list-buffers", Flist_buffers
, Slist_buffers
, 0, 1, "P",
1234 "Display a list of names of existing buffers.\n\
1235 The list is displayed in a buffer named `*Buffer List*'.\n\
1236 Note that buffers with names starting with spaces are omitted.\n\
1237 Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1239 The M column contains a * for buffers that are modified.\n\
1240 The R column contains a % for buffers that are read-only.")
1244 Lisp_Object desired_point
;
1247 = internal_with_output_to_temp_buffer ("*Buffer List*",
1248 list_buffers_1
, files
);
1250 if (NUMBERP (desired_point
))
1252 int count
= specpdl_ptr
- specpdl
;
1253 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
1254 Fset_buffer (build_string ("*Buffer List*"));
1255 SET_PT (XINT (desired_point
));
1256 return unbind_to (count
, Qnil
);
1261 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1263 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1264 Most local variable bindings are eliminated so that the default values\n\
1265 become effective once more. Also, the syntax table is set from\n\
1266 `standard-syntax-table', the local keymap is set to nil,\n\
1267 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1268 This function also forces redisplay of the mode line.\n\
1270 Every function to select a new major mode starts by\n\
1271 calling this function.\n\n\
1272 As a special exception, local variables whose names have\n\
1273 a non-nil `permanent-local' property are not eliminated by this function.\n\
1275 The first thing this function does is run\n\
1276 the normal hook `change-major-mode-hook'.")
1279 register Lisp_Object alist
, sym
, tem
;
1282 if (!NILP (Vrun_hooks
))
1283 call1 (Vrun_hooks
, intern ("change-major-mode-hook"));
1284 oalist
= current_buffer
->local_var_alist
;
1286 /* Make sure no local variables remain set up with this buffer
1287 for their current values. */
1289 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1291 sym
= XCONS (XCONS (alist
)->car
)->car
;
1293 /* Need not do anything if some other buffer's binding is now encached. */
1294 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
;
1295 if (XBUFFER (tem
) == current_buffer
)
1297 /* Symbol is set up for this buffer's old local value.
1298 Set it up for the current buffer with the default value. */
1300 tem
= XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1301 /* Store the symbol's current value into the alist entry
1302 it is currently set up for. This is so that, if the
1303 local is marked permanent, and we make it local again below,
1304 we don't lose the value. */
1305 XCONS (XCONS (tem
)->car
)->cdr
1306 = do_symval_forwarding (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
);
1307 /* Switch to the symbol's default-value alist entry. */
1308 XCONS (tem
)->car
= tem
;
1309 /* Mark it as current for the current buffer. */
1310 XCONS (XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->cdr
)->car
1311 = Fcurrent_buffer ();
1312 /* Store the current value into any forwarding in the symbol. */
1313 store_symval_forwarding (sym
, XBUFFER_LOCAL_VALUE (XSYMBOL (sym
)->value
)->car
,
1318 /* Actually eliminate all local bindings of this buffer. */
1320 reset_buffer_local_variables (current_buffer
);
1322 /* Redisplay mode lines; we are changing major mode. */
1324 update_mode_lines
++;
1326 /* Any which are supposed to be permanent,
1327 make local again, with the same values they had. */
1329 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1331 sym
= XCONS (XCONS (alist
)->car
)->car
;
1332 tem
= Fget (sym
, Qpermanent_local
);
1335 Fmake_local_variable (sym
);
1336 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1340 /* Force mode-line redisplay. Useful here because all major mode
1341 commands call this function. */
1342 update_mode_lines
++;
1347 /* Find all the overlays in the current buffer that contain position POS.
1348 Return the number found, and store them in a vector in *VEC_PTR.
1349 Store in *LEN_PTR the size allocated for the vector.
1350 Store in *NEXT_PTR the next position after POS where an overlay starts,
1351 or ZV if there are no more overlays.
1352 Store in *PREV_PTR the previous position after POS where an overlay ends,
1353 or BEGV if there are no previous overlays.
1354 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
1356 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1357 when this function is called.
1359 If EXTEND is non-zero, we make the vector bigger if necessary.
1360 If EXTEND is zero, we never extend the vector,
1361 and we store only as many overlays as will fit.
1362 But we still return the total number of overlays. */
1365 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
, prev_ptr
)
1368 Lisp_Object
**vec_ptr
;
1373 Lisp_Object tail
, overlay
, start
, end
, result
;
1376 Lisp_Object
*vec
= *vec_ptr
;
1379 int inhibit_storing
= 0;
1381 for (tail
= current_buffer
->overlays_before
;
1383 tail
= XCONS (tail
)->cdr
)
1385 int startpos
, endpos
;
1387 overlay
= XCONS (tail
)->car
;
1389 start
= OVERLAY_START (overlay
);
1390 end
= OVERLAY_END (overlay
);
1391 endpos
= OVERLAY_POSITION (end
);
1400 startpos
= OVERLAY_POSITION (start
);
1401 if (startpos
<= pos
)
1405 /* The supplied vector is full.
1406 Either make it bigger, or don't store any more in it. */
1409 *len_ptr
= len
*= 2;
1410 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1414 inhibit_storing
= 1;
1417 if (!inhibit_storing
)
1419 /* Keep counting overlays even if we can't return them all. */
1422 else if (startpos
< next
)
1426 for (tail
= current_buffer
->overlays_after
;
1428 tail
= XCONS (tail
)->cdr
)
1430 int startpos
, endpos
;
1432 overlay
= XCONS (tail
)->car
;
1434 start
= OVERLAY_START (overlay
);
1435 end
= OVERLAY_END (overlay
);
1436 startpos
= OVERLAY_POSITION (start
);
1439 if (startpos
< next
)
1443 endpos
= OVERLAY_POSITION (end
);
1450 *len_ptr
= len
*= 2;
1451 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1455 inhibit_storing
= 1;
1458 if (!inhibit_storing
)
1462 else if (endpos
< pos
&& endpos
> prev
)
1475 Lisp_Object overlay
;
1481 compare_overlays (s1
, s2
)
1482 struct sortvec
*s1
, *s2
;
1484 if (s1
->priority
!= s2
->priority
)
1485 return s1
->priority
- s2
->priority
;
1486 if (s1
->beg
!= s2
->beg
)
1487 return s1
->beg
- s2
->beg
;
1488 if (s1
->end
!= s2
->end
)
1489 return s2
->end
- s1
->end
;
1493 /* Sort an array of overlays by priority. The array is modified in place.
1494 The return value is the new size; this may be smaller than the original
1495 size if some of the overlays were invalid or were window-specific. */
1497 sort_overlays (overlay_vec
, noverlays
, w
)
1498 Lisp_Object
*overlay_vec
;
1503 struct sortvec
*sortvec
;
1504 sortvec
= (struct sortvec
*) alloca (noverlays
* sizeof (struct sortvec
));
1506 /* Put the valid and relevant overlays into sortvec. */
1508 for (i
= 0, j
= 0; i
< noverlays
; i
++)
1511 Lisp_Object overlay
;
1513 overlay
= overlay_vec
[i
];
1514 if (OVERLAY_VALID (overlay
)
1515 && OVERLAY_POSITION (OVERLAY_START (overlay
)) > 0
1516 && OVERLAY_POSITION (OVERLAY_END (overlay
)) > 0)
1518 /* If we're interested in a specific window, then ignore
1519 overlays that are limited to some other window. */
1524 window
= Foverlay_get (overlay
, Qwindow
);
1525 if (WINDOWP (window
) && XWINDOW (window
) != w
)
1529 /* This overlay is good and counts: put it into sortvec. */
1530 sortvec
[j
].overlay
= overlay
;
1531 sortvec
[j
].beg
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1532 sortvec
[j
].end
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1533 tem
= Foverlay_get (overlay
, Qpriority
);
1535 sortvec
[j
].priority
= XINT (tem
);
1537 sortvec
[j
].priority
= 0;
1543 /* Sort the overlays into the proper order: increasing priority. */
1546 qsort (sortvec
, noverlays
, sizeof (struct sortvec
), compare_overlays
);
1548 for (i
= 0; i
< noverlays
; i
++)
1549 overlay_vec
[i
] = sortvec
[i
].overlay
;
1553 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1556 recenter_overlay_lists (buf
, pos
)
1560 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1562 /* See if anything in overlays_before should move to overlays_after. */
1564 /* We don't strictly need prev in this loop; it should always be nil.
1565 But we use it for symmetry and in case that should cease to be true
1566 with some future change. */
1568 for (tail
= buf
->overlays_before
;
1570 prev
= tail
, tail
= next
)
1572 next
= XCONS (tail
)->cdr
;
1573 overlay
= XCONS (tail
)->car
;
1575 /* If the overlay is not valid, get rid of it. */
1576 if (!OVERLAY_VALID (overlay
))
1581 /* Splice the cons cell TAIL out of overlays_before. */
1583 XCONS (prev
)->cdr
= next
;
1585 buf
->overlays_before
= next
;
1591 beg
= OVERLAY_START (overlay
);
1592 end
= OVERLAY_END (overlay
);
1594 if (OVERLAY_POSITION (end
) > pos
)
1596 /* OVERLAY needs to be moved. */
1597 int where
= OVERLAY_POSITION (beg
);
1598 Lisp_Object other
, other_prev
;
1600 /* Splice the cons cell TAIL out of overlays_before. */
1602 XCONS (prev
)->cdr
= next
;
1604 buf
->overlays_before
= next
;
1606 /* Search thru overlays_after for where to put it. */
1608 for (other
= buf
->overlays_after
;
1610 other_prev
= other
, other
= XCONS (other
)->cdr
)
1612 Lisp_Object otherbeg
, otheroverlay
, follower
;
1615 otheroverlay
= XCONS (other
)->car
;
1616 if (! OVERLAY_VALID (otheroverlay
))
1619 otherbeg
= OVERLAY_START (otheroverlay
);
1620 if (OVERLAY_POSITION (otherbeg
) >= where
)
1624 /* Add TAIL to overlays_after before OTHER. */
1625 XCONS (tail
)->cdr
= other
;
1626 if (!NILP (other_prev
))
1627 XCONS (other_prev
)->cdr
= tail
;
1629 buf
->overlays_after
= tail
;
1633 /* We've reached the things that should stay in overlays_before.
1634 All the rest of overlays_before must end even earlier,
1639 /* See if anything in overlays_after should be in overlays_before. */
1641 for (tail
= buf
->overlays_after
;
1643 prev
= tail
, tail
= next
)
1645 next
= XCONS (tail
)->cdr
;
1646 overlay
= XCONS (tail
)->car
;
1648 /* If the overlay is not valid, get rid of it. */
1649 if (!OVERLAY_VALID (overlay
))
1654 /* Splice the cons cell TAIL out of overlays_after. */
1656 XCONS (prev
)->cdr
= next
;
1658 buf
->overlays_after
= next
;
1664 beg
= OVERLAY_START (overlay
);
1665 end
= OVERLAY_END (overlay
);
1667 /* Stop looking, when we know that nothing further
1668 can possibly end before POS. */
1669 if (OVERLAY_POSITION (beg
) > pos
)
1672 if (OVERLAY_POSITION (end
) <= pos
)
1674 /* OVERLAY needs to be moved. */
1675 int where
= OVERLAY_POSITION (end
);
1676 Lisp_Object other
, other_prev
;
1678 /* Splice the cons cell TAIL out of overlays_after. */
1680 XCONS (prev
)->cdr
= next
;
1682 buf
->overlays_after
= next
;
1684 /* Search thru overlays_before for where to put it. */
1686 for (other
= buf
->overlays_before
;
1688 other_prev
= other
, other
= XCONS (other
)->cdr
)
1690 Lisp_Object otherend
, otheroverlay
;
1693 otheroverlay
= XCONS (other
)->car
;
1694 if (! OVERLAY_VALID (otheroverlay
))
1697 otherend
= OVERLAY_END (otheroverlay
);
1698 if (OVERLAY_POSITION (otherend
) <= where
)
1702 /* Add TAIL to overlays_before before OTHER. */
1703 XCONS (tail
)->cdr
= other
;
1704 if (!NILP (other_prev
))
1705 XCONS (other_prev
)->cdr
= tail
;
1707 buf
->overlays_before
= tail
;
1712 XSETFASTINT (buf
->overlay_center
, pos
);
1715 /* Fix up overlays that were garbled as a result of permuting markers
1716 in the range START through END. Any overlay with at least one
1717 endpoint in this range will need to be unlinked from the overlay
1718 list and reinserted in its proper place.
1719 Such an overlay might even have negative size at this point.
1720 If so, we'll reverse the endpoints. Can you think of anything
1721 better to do in this situation? */
1723 fix_overlays_in_range (start
, end
)
1724 register int start
, end
;
1726 Lisp_Object tem
, overlay
;
1727 Lisp_Object before_list
, after_list
;
1728 Lisp_Object
*ptail
, *pbefore
= &before_list
, *pafter
= &after_list
;
1729 int startpos
, endpos
;
1731 /* This algorithm shifts links around instead of consing and GCing.
1732 The loop invariant is that before_list (resp. after_list) is a
1733 well-formed list except that its last element, the one that
1734 *pbefore (resp. *pafter) points to, is still uninitialized.
1735 So it's not a bug that before_list isn't initialized, although
1736 it may look strange. */
1737 for (ptail
= ¤t_buffer
->overlays_before
; CONSP (*ptail
);)
1739 overlay
= XCONS (*ptail
)->car
;
1740 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1743 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1745 || (startpos
>= start
&& startpos
< end
))
1747 /* If the overlay is backwards, fix that now. */
1748 if (startpos
> endpos
)
1751 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1752 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1753 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1755 /* Add it to the end of the wrong list. Later on,
1756 recenter_overlay_lists will move it to the right place. */
1757 if (endpos
< XINT (current_buffer
->overlay_center
))
1760 pafter
= &XCONS (*ptail
)->cdr
;
1765 pbefore
= &XCONS (*ptail
)->cdr
;
1767 *ptail
= XCONS (*ptail
)->cdr
;
1770 ptail
= &XCONS (*ptail
)->cdr
;
1772 for (ptail
= ¤t_buffer
->overlays_after
; CONSP (*ptail
);)
1774 overlay
= XCONS (*ptail
)->car
;
1775 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
1776 if (startpos
>= end
)
1778 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
1779 if (startpos
>= start
1780 || (endpos
>= start
&& endpos
< end
))
1782 if (startpos
> endpos
)
1785 Fset_marker (OVERLAY_START (overlay
), endpos
, Qnil
);
1786 Fset_marker (OVERLAY_END (overlay
), startpos
, Qnil
);
1787 tem
= startpos
; startpos
= endpos
; endpos
= tem
;
1789 if (endpos
< XINT (current_buffer
->overlay_center
))
1792 pafter
= &XCONS (*ptail
)->cdr
;
1797 pbefore
= &XCONS (*ptail
)->cdr
;
1799 *ptail
= XCONS (*ptail
)->cdr
;
1802 ptail
= &XCONS (*ptail
)->cdr
;
1805 /* Splice the constructed (wrong) lists into the buffer's lists,
1806 and let the recenter function make it sane again. */
1807 *pbefore
= current_buffer
->overlays_before
;
1808 current_buffer
->overlays_before
= before_list
;
1809 recenter_overlay_lists (current_buffer
,
1810 XINT (current_buffer
->overlay_center
));
1812 *pafter
= current_buffer
->overlays_after
;
1813 current_buffer
->overlays_after
= after_list
;
1814 recenter_overlay_lists (current_buffer
,
1815 XINT (current_buffer
->overlay_center
));
1818 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1819 "Return t if OBJECT is an overlay.")
1823 return (OVERLAYP (object
) ? Qt
: Qnil
);
1826 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1827 "Create a new overlay with range BEG to END in BUFFER.\n\
1828 If omitted, BUFFER defaults to the current buffer.\n\
1829 BEG and END may be integers or markers.")
1831 Lisp_Object beg
, end
, buffer
;
1833 Lisp_Object overlay
;
1837 XSETBUFFER (buffer
, current_buffer
);
1839 CHECK_BUFFER (buffer
, 2);
1841 && ! EQ (Fmarker_buffer (beg
), buffer
))
1842 error ("Marker points into wrong buffer");
1844 && ! EQ (Fmarker_buffer (end
), buffer
))
1845 error ("Marker points into wrong buffer");
1847 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1848 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1850 if (XINT (beg
) > XINT (end
))
1853 temp
= beg
; beg
= end
; end
= temp
;
1856 b
= XBUFFER (buffer
);
1858 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1859 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1861 overlay
= allocate_misc ();
1862 XMISC (overlay
)->type
= Lisp_Misc_Overlay
;
1863 XOVERLAY (overlay
)->start
= beg
;
1864 XOVERLAY (overlay
)->end
= end
;
1865 XOVERLAY (overlay
)->plist
= Qnil
;
1867 /* Put the new overlay on the wrong list. */
1868 end
= OVERLAY_END (overlay
);
1869 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1870 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1872 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1874 /* This puts it in the right list, and in the right order. */
1875 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1877 /* We don't need to redisplay the region covered by the overlay, because
1878 the overlay has no properties at the moment. */
1883 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
1884 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1885 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1886 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1888 (overlay
, beg
, end
, buffer
)
1889 Lisp_Object overlay
, beg
, end
, buffer
;
1891 struct buffer
*b
, *ob
;
1892 Lisp_Object obuffer
;
1893 int count
= specpdl_ptr
- specpdl
;
1895 CHECK_OVERLAY (overlay
, 0);
1897 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1899 XSETBUFFER (buffer
, current_buffer
);
1900 CHECK_BUFFER (buffer
, 3);
1903 && ! EQ (Fmarker_buffer (beg
), buffer
))
1904 error ("Marker points into wrong buffer");
1906 && ! EQ (Fmarker_buffer (end
), buffer
))
1907 error ("Marker points into wrong buffer");
1909 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1910 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1912 if (XINT (beg
) == XINT (end
) && ! NILP (Foverlay_get (overlay
, Qevaporate
)))
1913 return Fdelete_overlay (overlay
);
1915 if (XINT (beg
) > XINT (end
))
1918 temp
= beg
; beg
= end
; end
= temp
;
1921 specbind (Qinhibit_quit
, Qt
);
1923 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1924 b
= XBUFFER (buffer
);
1925 ob
= XBUFFER (obuffer
);
1927 /* If the overlay has changed buffers, do a thorough redisplay. */
1928 if (!EQ (buffer
, obuffer
))
1930 /* Redisplay where the overlay was. */
1931 if (!NILP (obuffer
))
1936 o_beg
= OVERLAY_START (overlay
);
1937 o_end
= OVERLAY_END (overlay
);
1938 o_beg
= OVERLAY_POSITION (o_beg
);
1939 o_end
= OVERLAY_POSITION (o_end
);
1941 redisplay_region (ob
, XINT (o_beg
), XINT (o_end
));
1944 /* Redisplay where the overlay is going to be. */
1945 redisplay_region (b
, XINT (beg
), XINT (end
));
1947 /* Don't limit redisplay to the selected window. */
1948 windows_or_buffers_changed
= 1;
1951 /* Redisplay the area the overlay has just left, or just enclosed. */
1955 int change_beg
, change_end
;
1957 o_beg
= OVERLAY_START (overlay
);
1958 o_end
= OVERLAY_END (overlay
);
1959 o_beg
= OVERLAY_POSITION (o_beg
);
1960 o_end
= OVERLAY_POSITION (o_end
);
1962 if (XINT (o_beg
) == XINT (beg
))
1963 redisplay_region (b
, XINT (o_end
), XINT (end
));
1964 else if (XINT (o_end
) == XINT (end
))
1965 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
1968 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
1969 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
1970 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
1974 if (!NILP (obuffer
))
1976 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
1977 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
1980 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
1981 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
1983 /* Put the overlay on the wrong list. */
1984 end
= OVERLAY_END (overlay
);
1985 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1986 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1988 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1990 /* This puts it in the right list, and in the right order. */
1991 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1993 return unbind_to (count
, overlay
);
1996 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
1997 "Delete the overlay OVERLAY from its buffer.")
1999 Lisp_Object overlay
;
2003 int count
= specpdl_ptr
- specpdl
;
2005 CHECK_OVERLAY (overlay
, 0);
2007 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2011 b
= XBUFFER (buffer
);
2013 specbind (Qinhibit_quit
, Qt
);
2015 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
2016 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
2018 redisplay_region (b
,
2019 marker_position (OVERLAY_START (overlay
)),
2020 marker_position (OVERLAY_END (overlay
)));
2022 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
2023 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
2025 return unbind_to (count
, Qnil
);
2028 /* Overlay dissection functions. */
2030 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
2031 "Return the position at which OVERLAY starts.")
2033 Lisp_Object overlay
;
2035 CHECK_OVERLAY (overlay
, 0);
2037 return (Fmarker_position (OVERLAY_START (overlay
)));
2040 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
2041 "Return the position at which OVERLAY ends.")
2043 Lisp_Object overlay
;
2045 CHECK_OVERLAY (overlay
, 0);
2047 return (Fmarker_position (OVERLAY_END (overlay
)));
2050 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
2051 "Return the buffer OVERLAY belongs to.")
2053 Lisp_Object overlay
;
2055 CHECK_OVERLAY (overlay
, 0);
2057 return Fmarker_buffer (OVERLAY_START (overlay
));
2060 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
2061 "Return a list of the properties on OVERLAY.\n\
2062 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
2065 Lisp_Object overlay
;
2067 CHECK_OVERLAY (overlay
, 0);
2069 return Fcopy_sequence (XOVERLAY (overlay
)->plist
);
2073 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
2074 "Return a list of the overlays that contain position POS.")
2079 Lisp_Object
*overlay_vec
;
2083 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2086 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2088 /* Put all the overlays we want in a vector in overlay_vec.
2089 Store the length in len. */
2090 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, NULL
, NULL
);
2092 /* Make a list of them all. */
2093 result
= Flist (noverlays
, overlay_vec
);
2095 xfree (overlay_vec
);
2099 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
2101 "Return the next position after POS where an overlay starts or ends.\n\
2102 If there are no more overlay boundaries after POS, return (point-max).")
2108 Lisp_Object
*overlay_vec
;
2112 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2115 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2117 /* Put all the overlays we want in a vector in overlay_vec.
2118 Store the length in len.
2119 endpos gets the position where the next overlay starts. */
2120 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
, NULL
);
2122 /* If any of these overlays ends before endpos,
2123 use its ending point instead. */
2124 for (i
= 0; i
< noverlays
; i
++)
2129 oend
= OVERLAY_END (overlay_vec
[i
]);
2130 oendpos
= OVERLAY_POSITION (oend
);
2131 if (oendpos
< endpos
)
2135 xfree (overlay_vec
);
2136 return make_number (endpos
);
2139 DEFUN ("previous-overlay-change", Fprevious_overlay_change
,
2140 Sprevious_overlay_change
, 1, 1, 0,
2141 "Return the previous position before POS where an overlay starts or ends.\n\
2142 If there are no more overlay boundaries after POS, return (point-min).")
2148 Lisp_Object
*overlay_vec
;
2152 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2155 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
2157 /* Put all the overlays we want in a vector in overlay_vec.
2158 Store the length in len.
2159 prevpos gets the position of an overlay end. */
2160 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, NULL
, &prevpos
);
2162 /* If any of these overlays starts before endpos,
2163 maybe use its starting point instead. */
2164 for (i
= 0; i
< noverlays
; i
++)
2169 ostart
= OVERLAY_START (overlay_vec
[i
]);
2170 ostartpos
= OVERLAY_POSITION (ostart
);
2171 if (ostartpos
> prevpos
&& ostartpos
< XINT (pos
))
2172 prevpos
= ostartpos
;
2175 xfree (overlay_vec
);
2176 return make_number (prevpos
);
2179 /* These functions are for debugging overlays. */
2181 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
2182 "Return a pair of lists giving all the overlays of the current buffer.\n\
2183 The car has all the overlays before the overlay center;\n\
2184 the cdr has all the overlays after the overlay center.\n\
2185 Recentering overlays moves overlays between these lists.\n\
2186 The lists you get are copies, so that changing them has no effect.\n\
2187 However, the overlays you get are the real objects that the buffer uses.")
2190 Lisp_Object before
, after
;
2191 before
= current_buffer
->overlays_before
;
2193 before
= Fcopy_sequence (before
);
2194 after
= current_buffer
->overlays_after
;
2196 after
= Fcopy_sequence (after
);
2198 return Fcons (before
, after
);
2201 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
2202 "Recenter the overlays of the current buffer around position POS.")
2206 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
2208 recenter_overlay_lists (current_buffer
, XINT (pos
));
2212 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
2213 "Get the property of overlay OVERLAY with property name NAME.")
2215 Lisp_Object overlay
, prop
;
2217 Lisp_Object plist
, fallback
;
2219 CHECK_OVERLAY (overlay
, 0);
2223 for (plist
= XOVERLAY (overlay
)->plist
;
2224 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
2225 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
2227 if (EQ (XCONS (plist
)->car
, prop
))
2228 return XCONS (XCONS (plist
)->cdr
)->car
;
2229 else if (EQ (XCONS (plist
)->car
, Qcategory
))
2232 tem
= Fcar (Fcdr (plist
));
2234 fallback
= Fget (tem
, prop
);
2241 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
2242 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
2243 (overlay
, prop
, value
)
2244 Lisp_Object overlay
, prop
, value
;
2246 Lisp_Object tail
, buffer
;
2249 CHECK_OVERLAY (overlay
, 0);
2251 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
2253 for (tail
= XOVERLAY (overlay
)->plist
;
2254 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
2255 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
2256 if (EQ (XCONS (tail
)->car
, prop
))
2258 changed
= !EQ (XCONS (XCONS (tail
)->cdr
)->car
, value
);
2259 XCONS (XCONS (tail
)->cdr
)->car
= value
;
2262 /* It wasn't in the list, so add it to the front. */
2263 changed
= !NILP (value
);
2264 XOVERLAY (overlay
)->plist
2265 = Fcons (prop
, Fcons (value
, XOVERLAY (overlay
)->plist
));
2267 if (! NILP (buffer
))
2270 redisplay_region (XBUFFER (buffer
),
2271 marker_position (OVERLAY_START (overlay
)),
2272 marker_position (OVERLAY_END (overlay
)));
2273 if (EQ (prop
, Qevaporate
) && ! NILP (value
)
2274 && (OVERLAY_POSITION (OVERLAY_START (overlay
))
2275 == OVERLAY_POSITION (OVERLAY_END (overlay
))))
2276 Fdelete_overlay (overlay
);
2281 /* Run the modification-hooks of overlays that include
2282 any part of the text in START to END.
2283 Run the insert-before-hooks of overlay starting at END,
2284 and the insert-after-hooks of overlay ending at START.
2286 This is called both before and after the modification.
2287 AFTER is nonzero when we call after the modification.
2289 ARG1, ARG2, ARG3 are arguments to pass to the hook functions. */
2292 report_overlay_modification (start
, end
, after
, arg1
, arg2
, arg3
)
2293 Lisp_Object start
, end
;
2295 Lisp_Object arg1
, arg2
, arg3
;
2297 Lisp_Object prop
, overlay
, tail
;
2298 int insertion
= EQ (start
, end
);
2300 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
2304 GCPRO5 (overlay
, tail
, arg1
, arg2
, arg3
);
2307 for (tail
= current_buffer
->overlays_before
;
2309 tail
= XCONS (tail
)->cdr
)
2311 int startpos
, endpos
;
2312 Lisp_Object ostart
, oend
;
2314 overlay
= XCONS (tail
)->car
;
2316 ostart
= OVERLAY_START (overlay
);
2317 oend
= OVERLAY_END (overlay
);
2318 endpos
= OVERLAY_POSITION (oend
);
2319 if (XFASTINT (start
) > endpos
)
2321 startpos
= OVERLAY_POSITION (ostart
);
2322 if (XFASTINT (end
) == startpos
&& insertion
)
2324 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2327 /* Copy TAIL in case the hook recenters the overlay lists. */
2329 tail
= Fcopy_sequence (tail
);
2331 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2334 if (XFASTINT (start
) == endpos
&& insertion
)
2336 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2340 tail
= Fcopy_sequence (tail
);
2342 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2345 /* Test for intersecting intervals. This does the right thing
2346 for both insertion and deletion. */
2347 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2349 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2353 tail
= Fcopy_sequence (tail
);
2355 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2361 for (tail
= current_buffer
->overlays_after
;
2363 tail
= XCONS (tail
)->cdr
)
2365 int startpos
, endpos
;
2366 Lisp_Object ostart
, oend
;
2368 overlay
= XCONS (tail
)->car
;
2370 ostart
= OVERLAY_START (overlay
);
2371 oend
= OVERLAY_END (overlay
);
2372 startpos
= OVERLAY_POSITION (ostart
);
2373 endpos
= OVERLAY_POSITION (oend
);
2374 if (XFASTINT (end
) < startpos
)
2376 if (XFASTINT (end
) == startpos
&& insertion
)
2378 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
2382 tail
= Fcopy_sequence (tail
);
2384 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2387 if (XFASTINT (start
) == endpos
&& insertion
)
2389 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
2393 tail
= Fcopy_sequence (tail
);
2395 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2398 /* Test for intersecting intervals. This does the right thing
2399 for both insertion and deletion. */
2400 if (XFASTINT (end
) > startpos
&& XFASTINT (start
) < endpos
)
2402 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
2406 tail
= Fcopy_sequence (tail
);
2408 call_overlay_mod_hooks (prop
, overlay
, after
, arg1
, arg2
, arg3
);
2417 call_overlay_mod_hooks (list
, overlay
, after
, arg1
, arg2
, arg3
)
2418 Lisp_Object list
, overlay
;
2420 Lisp_Object arg1
, arg2
, arg3
;
2422 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
2423 GCPRO4 (list
, arg1
, arg2
, arg3
);
2424 while (!NILP (list
))
2427 call4 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
);
2429 call5 (Fcar (list
), overlay
, after
? Qt
: Qnil
, arg1
, arg2
, arg3
);
2435 /* Delete any zero-sized overlays at position POS, if the `evaporate'
2438 evaporate_overlays (pos
)
2441 Lisp_Object tail
, overlay
, hit_list
;
2444 if (pos
<= XFASTINT (current_buffer
->overlay_center
))
2445 for (tail
= current_buffer
->overlays_before
; CONSP (tail
);
2446 tail
= XCONS (tail
)->cdr
)
2449 overlay
= XCONS (tail
)->car
;
2450 endpos
= OVERLAY_POSITION (OVERLAY_END (overlay
));
2453 if (endpos
== pos
&& OVERLAY_POSITION (OVERLAY_START (overlay
)) == pos
2454 && Foverlay_get (overlay
, Qevaporate
))
2455 hit_list
= Fcons (overlay
, hit_list
);
2458 for (tail
= current_buffer
->overlays_after
; CONSP (tail
);
2459 tail
= XCONS (tail
)->cdr
)
2462 overlay
= XCONS (tail
)->car
;
2463 startpos
= OVERLAY_POSITION (OVERLAY_START (overlay
));
2466 if (startpos
== pos
&& OVERLAY_POSITION (OVERLAY_END (overlay
)) == pos
2467 && Foverlay_get (overlay
, Qevaporate
))
2468 hit_list
= Fcons (overlay
, hit_list
);
2470 for (; CONSP (hit_list
); hit_list
= XCONS (hit_list
)->cdr
)
2471 Fdelete_overlay (XCONS (hit_list
)->car
);
2474 /* Somebody has tried to store a value with an unacceptable type
2475 into the buffer-local slot with offset OFFSET. */
2477 buffer_slot_type_mismatch (offset
)
2482 sym
= *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
);
2483 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
2485 case Lisp_Int
: type_name
= "integers"; break;
2486 case Lisp_String
: type_name
= "strings"; break;
2487 case Lisp_Symbol
: type_name
= "symbols"; break;
2492 error ("only %s should be stored in the buffer-local variable %s",
2493 type_name
, XSYMBOL (sym
)->name
->data
);
2498 register Lisp_Object tem
;
2500 /* Make sure all markable slots in buffer_defaults
2501 are initialized reasonably, so mark_buffer won't choke. */
2502 reset_buffer (&buffer_defaults
);
2503 reset_buffer_local_variables (&buffer_defaults
);
2504 reset_buffer (&buffer_local_symbols
);
2505 reset_buffer_local_variables (&buffer_local_symbols
);
2506 XSETBUFFER (Vbuffer_defaults
, &buffer_defaults
);
2507 XSETBUFFER (Vbuffer_local_symbols
, &buffer_local_symbols
);
2509 /* Set up the default values of various buffer slots. */
2510 /* Must do these before making the first buffer! */
2512 /* real setup is done in loaddefs.el */
2513 buffer_defaults
.mode_line_format
= build_string ("%-");
2514 buffer_defaults
.abbrev_mode
= Qnil
;
2515 buffer_defaults
.overwrite_mode
= Qnil
;
2516 buffer_defaults
.case_fold_search
= Qt
;
2517 buffer_defaults
.auto_fill_function
= Qnil
;
2518 buffer_defaults
.selective_display
= Qnil
;
2520 buffer_defaults
.selective_display_ellipses
= Qt
;
2522 buffer_defaults
.abbrev_table
= Qnil
;
2523 buffer_defaults
.display_table
= Qnil
;
2524 buffer_defaults
.undo_list
= Qnil
;
2525 buffer_defaults
.mark_active
= Qnil
;
2526 buffer_defaults
.overlays_before
= Qnil
;
2527 buffer_defaults
.overlays_after
= Qnil
;
2528 XSETFASTINT (buffer_defaults
.overlay_center
, 1);
2530 XSETFASTINT (buffer_defaults
.tab_width
, 8);
2531 buffer_defaults
.truncate_lines
= Qnil
;
2532 buffer_defaults
.ctl_arrow
= Qt
;
2535 buffer_defaults
.buffer_file_type
= Qnil
; /* TEXT */
2537 XSETFASTINT (buffer_defaults
.fill_column
, 70);
2538 XSETFASTINT (buffer_defaults
.left_margin
, 0);
2539 buffer_defaults
.cache_long_line_scans
= Qnil
;
2541 /* Assign the local-flags to the slots that have default values.
2542 The local flag is a bit that is used in the buffer
2543 to say that it has its own local value for the slot.
2544 The local flag bits are in the local_var_flags slot of the buffer. */
2546 /* Nothing can work if this isn't true */
2547 if (sizeof (EMACS_INT
) != sizeof (Lisp_Object
)) abort ();
2549 /* 0 means not a lisp var, -1 means always local, else mask */
2550 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2551 XSETINT (buffer_local_flags
.filename
, -1);
2552 XSETINT (buffer_local_flags
.directory
, -1);
2553 XSETINT (buffer_local_flags
.backed_up
, -1);
2554 XSETINT (buffer_local_flags
.save_length
, -1);
2555 XSETINT (buffer_local_flags
.auto_save_file_name
, -1);
2556 XSETINT (buffer_local_flags
.read_only
, -1);
2557 XSETINT (buffer_local_flags
.major_mode
, -1);
2558 XSETINT (buffer_local_flags
.mode_name
, -1);
2559 XSETINT (buffer_local_flags
.undo_list
, -1);
2560 XSETINT (buffer_local_flags
.mark_active
, -1);
2562 XSETFASTINT (buffer_local_flags
.mode_line_format
, 1);
2563 XSETFASTINT (buffer_local_flags
.abbrev_mode
, 2);
2564 XSETFASTINT (buffer_local_flags
.overwrite_mode
, 4);
2565 XSETFASTINT (buffer_local_flags
.case_fold_search
, 8);
2566 XSETFASTINT (buffer_local_flags
.auto_fill_function
, 0x10);
2567 XSETFASTINT (buffer_local_flags
.selective_display
, 0x20);
2569 XSETFASTINT (buffer_local_flags
.selective_display_ellipses
, 0x40);
2571 XSETFASTINT (buffer_local_flags
.tab_width
, 0x80);
2572 XSETFASTINT (buffer_local_flags
.truncate_lines
, 0x100);
2573 XSETFASTINT (buffer_local_flags
.ctl_arrow
, 0x200);
2574 XSETFASTINT (buffer_local_flags
.fill_column
, 0x400);
2575 XSETFASTINT (buffer_local_flags
.left_margin
, 0x800);
2576 XSETFASTINT (buffer_local_flags
.abbrev_table
, 0x1000);
2577 XSETFASTINT (buffer_local_flags
.display_table
, 0x2000);
2578 XSETFASTINT (buffer_local_flags
.syntax_table
, 0x8000);
2579 XSETFASTINT (buffer_local_flags
.cache_long_line_scans
, 0x10000);
2581 XSETFASTINT (buffer_local_flags
.buffer_file_type
, 0x4000);
2584 Vbuffer_alist
= Qnil
;
2588 QSFundamental
= build_string ("Fundamental");
2590 Qfundamental_mode
= intern ("fundamental-mode");
2591 buffer_defaults
.major_mode
= Qfundamental_mode
;
2593 Qmode_class
= intern ("mode-class");
2595 Qprotected_field
= intern ("protected-field");
2597 Qpermanent_local
= intern ("permanent-local");
2599 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2601 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2602 /* super-magic invisible buffer */
2603 Vbuffer_alist
= Qnil
;
2605 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2610 char buf
[MAXPATHLEN
+1];
2612 struct stat dotstat
, pwdstat
;
2616 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2618 /* If PWD is accurate, use it instead of calling getwd. This is faster
2619 when PWD is right, and may avoid a fatal error. */
2620 if ((pwd
= getenv ("PWD")) != 0 && IS_DIRECTORY_SEP (*pwd
)
2621 && stat (pwd
, &pwdstat
) == 0
2622 && stat (".", &dotstat
) == 0
2623 && dotstat
.st_ino
== pwdstat
.st_ino
2624 && dotstat
.st_dev
== pwdstat
.st_dev
2625 && strlen (pwd
) < MAXPATHLEN
)
2627 else if (getwd (buf
) == 0)
2628 fatal ("`getwd' failed: %s\n", buf
);
2631 /* Maybe this should really use some standard subroutine
2632 whose definition is filename syntax dependent. */
2634 if (!(IS_DIRECTORY_SEP (buf
[rc
- 1])))
2636 buf
[rc
] = DIRECTORY_SEP
;
2639 #endif /* not VMS */
2640 current_buffer
->directory
= build_string (buf
);
2642 temp
= get_minibuffer (0);
2643 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2646 /* initialize the buffer routines */
2649 extern Lisp_Object Qdisabled
;
2651 staticpro (&Vbuffer_defaults
);
2652 staticpro (&Vbuffer_local_symbols
);
2653 staticpro (&Qfundamental_mode
);
2654 staticpro (&Qmode_class
);
2655 staticpro (&QSFundamental
);
2656 staticpro (&Vbuffer_alist
);
2657 staticpro (&Qprotected_field
);
2658 staticpro (&Qpermanent_local
);
2659 staticpro (&Qkill_buffer_hook
);
2660 staticpro (&Qoverlayp
);
2661 Qevaporate
= intern ("evaporate");
2662 staticpro (&Qevaporate
);
2663 staticpro (&Qmodification_hooks
);
2664 Qmodification_hooks
= intern ("modification-hooks");
2665 staticpro (&Qinsert_in_front_hooks
);
2666 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
2667 staticpro (&Qinsert_behind_hooks
);
2668 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
2669 staticpro (&Qget_file_buffer
);
2670 Qget_file_buffer
= intern ("get-file-buffer");
2671 Qpriority
= intern ("priority");
2672 staticpro (&Qpriority
);
2673 Qwindow
= intern ("window");
2674 staticpro (&Qwindow
);
2676 Qoverlayp
= intern ("overlayp");
2678 Fput (Qprotected_field
, Qerror_conditions
,
2679 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2680 Fput (Qprotected_field
, Qerror_message
,
2681 build_string ("Attempt to modify a protected field"));
2683 /* All these use DEFVAR_LISP_NOPRO because the slots in
2684 buffer_defaults will all be marked via Vbuffer_defaults. */
2686 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2687 &buffer_defaults
.mode_line_format
,
2688 "Default value of `mode-line-format' for buffers that don't override it.\n\
2689 This is the same as (default-value 'mode-line-format).");
2691 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2692 &buffer_defaults
.abbrev_mode
,
2693 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2694 This is the same as (default-value 'abbrev-mode).");
2696 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2697 &buffer_defaults
.ctl_arrow
,
2698 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2699 This is the same as (default-value 'ctl-arrow).");
2701 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2702 &buffer_defaults
.truncate_lines
,
2703 "Default value of `truncate-lines' for buffers that do not override it.\n\
2704 This is the same as (default-value 'truncate-lines).");
2706 DEFVAR_LISP_NOPRO ("default-fill-column",
2707 &buffer_defaults
.fill_column
,
2708 "Default value of `fill-column' for buffers that do not override it.\n\
2709 This is the same as (default-value 'fill-column).");
2711 DEFVAR_LISP_NOPRO ("default-left-margin",
2712 &buffer_defaults
.left_margin
,
2713 "Default value of `left-margin' for buffers that do not override it.\n\
2714 This is the same as (default-value 'left-margin).");
2716 DEFVAR_LISP_NOPRO ("default-tab-width",
2717 &buffer_defaults
.tab_width
,
2718 "Default value of `tab-width' for buffers that do not override it.\n\
2719 This is the same as (default-value 'tab-width).");
2721 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2722 &buffer_defaults
.case_fold_search
,
2723 "Default value of `case-fold-search' for buffers that don't override it.\n\
2724 This is the same as (default-value 'case-fold-search).");
2727 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
2728 &buffer_defaults
.buffer_file_type
,
2729 "Default file type for buffers that do not override it.\n\
2730 This is the same as (default-value 'buffer-file-type).\n\
2731 The file type is nil for text, t for binary.");
2734 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2737 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2738 But make-docfile finds it!
2739 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2741 "Template for displaying mode line for current buffer.\n\
2742 Each buffer has its own value of this variable.\n\
2743 Value may be a string, a symbol or a list or cons cell.\n\
2744 For a symbol, its value is used (but it is ignored if t or nil).\n\
2745 A string appearing directly as the value of a symbol is processed verbatim\n\
2746 in that the %-constructs below are not recognized.\n\
2747 For a list whose car is a symbol, the symbol's value is taken,\n\
2748 and if that is non-nil, the cadr of the list is processed recursively.\n\
2749 Otherwise, the caddr of the list (if there is one) is processed.\n\
2750 For a list whose car is a string or list, each element is processed\n\
2751 recursively and the results are effectively concatenated.\n\
2752 For a list whose car is an integer, the cdr of the list is processed\n\
2753 and padded (if the number is positive) or truncated (if negative)\n\
2754 to the width specified by that number.\n\
2755 A string is printed verbatim in the mode line except for %-constructs:\n\
2756 (%-constructs are allowed when the string is the entire mode-line-format\n\
2757 or when it is found in a cons-cell or a list)\n\
2758 %b -- print buffer name. %f -- print visited file name.\n\
2759 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.\n\
2760 % means buffer is read-only and * means it is modified.\n\
2761 For a modified read-only buffer, %* gives % and %+ gives *.\n\
2762 %s -- print process status. %l -- print the current line number.\n\
2763 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
2764 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
2765 or print Bottom or All.\n\
2766 %n -- print Narrow if appropriate.\n\
2767 %t -- print T if files is text, B if binary.\n\
2768 %[ -- print one [ for each recursive editing level. %] similar.\n\
2769 %% -- print %. %- -- print infinitely many dashes.\n\
2770 Decimal digits after the % specify field width to which to pad.");
2773 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2774 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2775 nil here means use current buffer's major mode.");
2777 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2778 make_number (Lisp_Symbol
),
2779 "Symbol for current buffer's major mode.");
2781 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2782 make_number (Lisp_String
),
2783 "Pretty name of current buffer's major mode (a string).");
2785 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2786 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2787 Automatically becomes buffer-local when set in any fashion.");
2789 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2791 "*Non-nil if searches should ignore case.\n\
2792 Automatically becomes buffer-local when set in any fashion.");
2794 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2795 make_number (Lisp_Int
),
2796 "*Column beyond which automatic line-wrapping should happen.\n\
2797 Automatically becomes buffer-local when set in any fashion.");
2799 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2800 make_number (Lisp_Int
),
2801 "*Column for the default indent-line-function to indent to.\n\
2802 Linefeed indents to this column in Fundamental mode.\n\
2803 Automatically becomes buffer-local when set in any fashion.");
2805 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2806 make_number (Lisp_Int
),
2807 "*Distance between tab stops (for display of tab characters), in columns.\n\
2808 Automatically becomes buffer-local when set in any fashion.");
2810 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2811 "*Non-nil means display control chars with uparrow.\n\
2812 Nil means use backslash and octal digits.\n\
2813 Automatically becomes buffer-local when set in any fashion.\n\
2814 This variable does not apply to characters whose display is specified\n\
2815 in the current display table (if there is one).");
2817 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2818 "*Non-nil means do not display continuation lines;\n\
2819 give each line of text one screen line.\n\
2820 Automatically becomes buffer-local when set in any fashion.\n\
2822 Note that this is overridden by the variable\n\
2823 `truncate-partial-width-windows' if that variable is non-nil\n\
2824 and this buffer is not full-frame width.");
2827 DEFVAR_PER_BUFFER ("buffer-file-type", ¤t_buffer
->buffer_file_type
,
2829 "*If visited file is text, nil; otherwise, t.");
2832 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2833 make_number (Lisp_String
),
2834 "Name of default directory of current buffer. Should end with slash.\n\
2835 Each buffer has its own value of this variable.");
2837 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2839 "Function called (if non-nil) to perform auto-fill.\n\
2840 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2841 Each buffer has its own value of this variable.\n\
2842 NOTE: This variable is not an ordinary hook;\n\
2843 It may not be a list of functions.");
2845 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2846 make_number (Lisp_String
),
2847 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2848 Each buffer has its own value of this variable.");
2850 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2851 ¤t_buffer
->auto_save_file_name
,
2852 make_number (Lisp_String
),
2853 "Name of file for auto-saving current buffer,\n\
2854 or nil if buffer should not be auto-saved.\n\
2855 Each buffer has its own value of this variable.");
2857 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2858 "Non-nil if this buffer is read-only.\n\
2859 Each buffer has its own value of this variable.");
2861 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2862 "Non-nil if this buffer's file has been backed up.\n\
2863 Backing up is done before the first time the file is saved.\n\
2864 Each buffer has its own value of this variable.");
2866 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2867 make_number (Lisp_Int
),
2868 "Length of current buffer when last read in, saved or auto-saved.\n\
2870 Each buffer has its own value of this variable.");
2872 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2874 "Non-nil enables selective display:\n\
2875 Integer N as value means display only lines\n\
2876 that start with less than n columns of space.\n\
2877 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2878 Then ^M's in the file are written into files as newlines.\n\n\
2879 Automatically becomes buffer-local when set in any fashion.");
2882 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2883 ¤t_buffer
->selective_display_ellipses
,
2885 "t means display ... on previous line when a line is invisible.\n\
2886 Automatically becomes buffer-local when set in any fashion.");
2889 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2890 "Non-nil if self-insertion should replace existing text.\n\
2891 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2892 inserts at the end of a line, and inserts when point is before a tab,\n\
2893 until the tab is filled in.\n\
2894 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2895 Automatically becomes buffer-local when set in any fashion.");
2897 #if 0 /* The doc string is too long for some compilers,
2898 but make-docfile can find it in this comment. */
2899 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2901 "Display table that controls display of the contents of current buffer.\n\
2902 Automatically becomes buffer-local when set in any fashion.\n\
2903 The display table is a vector created with `make-display-table'.\n\
2904 The first 256 elements control how to display each possible text character.\n\
2905 Each value should be a vector of characters or nil;\n\
2906 nil means display the character in the default fashion.\n\
2907 The remaining six elements control the display of\n\
2908 the end of a truncated screen line (element 256, a single character);\n\
2909 the end of a continued line (element 257, a single character);\n\
2910 the escape character used to display character codes in octal\n\
2911 (element 258, a single character);\n\
2912 the character used as an arrow for control characters (element 259,\n\
2913 a single character);\n\
2914 the decoration indicating the presence of invisible lines (element 260,\n\
2915 a vector of characters);\n\
2916 the character used to draw the border between side-by-side windows\n\
2917 (element 261, a single character).\n\
2918 If this variable is nil, the value of `standard-display-table' is used.\n\
2919 Each window can have its own, overriding display table.");
2921 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2924 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2927 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2928 "Function to call before each text change.\n\
2929 Two arguments are passed to the function: the positions of\n\
2930 the beginning and end of the range of old text to be changed.\n\
2931 \(For an insertion, the beginning and end are at the same place.)\n\
2932 No information is given about the length of the text after the change.\n\
2934 Buffer changes made while executing the `before-change-function'\n\
2935 don't call any before-change or after-change functions.\n\
2936 That's because these variables are temporarily set to nil.\n\
2937 As a result, a hook function cannot straightforwardly alter the value of\n\
2938 these variables. See the Emacs Lisp manual for a way of\n\
2939 accomplishing an equivalent result by using other variables.");
2940 Vbefore_change_function
= Qnil
;
2942 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2943 "Function to call after each text change.\n\
2944 Three arguments are passed to the function: the positions of\n\
2945 the beginning and end of the range of changed text,\n\
2946 and the length of the pre-change text replaced by that range.\n\
2947 \(For an insertion, the pre-change length is zero;\n\
2948 for a deletion, that length is the number of characters deleted,\n\
2949 and the post-change beginning and end are at the same place.)\n\
2951 Buffer changes made while executing the `after-change-function'\n\
2952 don't call any before-change or after-change functions.\n\
2953 That's because these variables are temporarily set to nil.\n\
2954 As a result, a hook function cannot straightforwardly alter the value of\n\
2955 these variables. See the Emacs Lisp manual for a way of\n\
2956 accomplishing an equivalent result by using other variables.");
2957 Vafter_change_function
= Qnil
;
2959 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions
,
2960 "List of functions to call before each text change.\n\
2961 Two arguments are passed to each function: the positions of\n\
2962 the beginning and end of the range of old text to be changed.\n\
2963 \(For an insertion, the beginning and end are at the same place.)\n\
2964 No information is given about the length of the text after the change.\n\
2966 Buffer changes made while executing the `before-change-functions'\n\
2967 don't call any before-change or after-change functions.\n\
2968 That's because these variables are temporarily set to nil.\n\
2969 As a result, a hook function cannot straightforwardly alter the value of\n\
2970 these variables. See the Emacs Lisp manual for a way of\n\
2971 accomplishing an equivalent result by using other variables.");
2972 Vbefore_change_functions
= Qnil
;
2974 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions
,
2975 "List of function to call after each text change.\n\
2976 Three arguments are passed to each function: the positions of\n\
2977 the beginning and end of the range of changed text,\n\
2978 and the length of the pre-change text replaced by that range.\n\
2979 \(For an insertion, the pre-change length is zero;\n\
2980 for a deletion, that length is the number of characters deleted,\n\
2981 and the post-change beginning and end are at the same place.)\n\
2983 Buffer changes made while executing the `after-change-functions'\n\
2984 don't call any before-change or after-change functions.\n\
2985 That's because these variables are temporarily set to nil.\n\
2986 As a result, a hook function cannot straightforwardly alter the value of\n\
2987 these variables. See the Emacs Lisp manual for a way of\n\
2988 accomplishing an equivalent result by using other variables.");
2990 Vafter_change_functions
= Qnil
;
2992 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2993 "A list of functions to call before changing a buffer which is unmodified.\n\
2994 The functions are run using the `run-hooks' function.");
2995 Vfirst_change_hook
= Qnil
;
2996 Qfirst_change_hook
= intern ("first-change-hook");
2997 staticpro (&Qfirst_change_hook
);
2999 #if 0 /* The doc string is too long for some compilers,
3000 but make-docfile can find it in this comment. */
3001 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3002 "List of undo entries in current buffer.\n\
3003 Recent changes come first; older changes follow newer.\n\
3005 An entry (START . END) represents an insertion which begins at\n\
3006 position START and ends at position END.\n\
3008 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
3009 from (abs POSITION). If POSITION is positive, point was at the front\n\
3010 of the text being deleted; if negative, point was at the end.\n\
3012 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
3013 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
3014 16-bit words of the buffer's modification count at the time. If the\n\
3015 modification count of the most recent save is different, this entry is\n\
3018 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
3019 was modified between BEG and END. PROP is the property name,\n\
3020 and VAL is the old value.\n\
3022 An entry of the form POSITION indicates that point was at the buffer\n\
3023 location given by the integer. Undoing an entry of this form places\n\
3024 point at POSITION.\n\
3026 nil marks undo boundaries. The undo command treats the changes\n\
3027 between two undo boundaries as a single step to be undone.\n\
3029 If the value of the variable is t, undo information is not recorded.");
3031 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
3034 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
3035 "Non-nil means the mark and region are currently active in this buffer.\n\
3036 Automatically local in all buffers.");
3038 DEFVAR_PER_BUFFER ("cache-long-line-scans", ¤t_buffer
->cache_long_line_scans
, Qnil
,
3039 "Non-nil means that Emacs should use caches to handle long lines more quickly.\n\
3040 This variable is buffer-local, in all buffers.\n\
3042 Normally, the line-motion functions work by scanning the buffer for\n\
3043 newlines. Columnar operations (like move-to-column and\n\
3044 compute-motion) also work by scanning the buffer, summing character\n\
3045 widths as they go. This works well for ordinary text, but if the\n\
3046 buffer's lines are very long (say, more than 500 characters), these\n\
3047 motion functions will take longer to execute. Emacs may also take\n\
3048 longer to update the display.\n\
3050 If cache-long-line-scans is non-nil, these motion functions cache the\n\
3051 results of their scans, and consult the cache to avoid rescanning\n\
3052 regions of the buffer until the text is modified. The caches are most\n\
3053 beneficial when they prevent the most searching---that is, when the\n\
3054 buffer contains long lines and large regions of characters with the\n\
3055 same, fixed screen width.\n\
3057 When cache-long-line-scans is non-nil, processing short lines will\n\
3058 become slightly slower (because of the overhead of consulting the\n\
3059 cache), and the caches will use memory roughly proportional to the\n\
3060 number of newlines and characters whose screen width varies.\n\
3062 The caches require no explicit maintenance; their accuracy is\n\
3063 maintained internally by the Emacs primitives. Enabling or disabling\n\
3064 the cache should not affect the behavior of any of the motion\n\
3065 functions; it should only affect their performance.");
3067 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
3068 "*Non-nil means deactivate the mark when the buffer contents change.");
3069 Vtransient_mark_mode
= Qnil
;
3071 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
3072 "*Non-nil means disregard read-only status of buffers or characters.\n\
3073 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
3074 text properties. If the value is a list, disregard `buffer-read-only'\n\
3075 and disregard a `read-only' text property if the property value\n\
3076 is a member of the list.");
3077 Vinhibit_read_only
= Qnil
;
3079 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions
,
3080 "List of functions called with no args to query before killing a buffer.");
3081 Vkill_buffer_query_functions
= Qnil
;
3083 defsubr (&Sbuffer_list
);
3084 defsubr (&Sget_buffer
);
3085 defsubr (&Sget_file_buffer
);
3086 defsubr (&Sget_buffer_create
);
3087 defsubr (&Sgenerate_new_buffer_name
);
3088 defsubr (&Sbuffer_name
);
3089 /*defsubr (&Sbuffer_number);*/
3090 defsubr (&Sbuffer_file_name
);
3091 defsubr (&Sbuffer_local_variables
);
3092 defsubr (&Sbuffer_modified_p
);
3093 defsubr (&Sset_buffer_modified_p
);
3094 defsubr (&Sbuffer_modified_tick
);
3095 defsubr (&Srename_buffer
);
3096 defsubr (&Sother_buffer
);
3097 defsubr (&Sbuffer_disable_undo
);
3098 defsubr (&Sbuffer_enable_undo
);
3099 defsubr (&Skill_buffer
);
3100 defsubr (&Serase_buffer
);
3101 defsubr (&Sset_buffer_major_mode
);
3102 defsubr (&Sswitch_to_buffer
);
3103 defsubr (&Spop_to_buffer
);
3104 defsubr (&Scurrent_buffer
);
3105 defsubr (&Sset_buffer
);
3106 defsubr (&Sbarf_if_buffer_read_only
);
3107 defsubr (&Sbury_buffer
);
3108 defsubr (&Slist_buffers
);
3109 defsubr (&Skill_all_local_variables
);
3111 defsubr (&Soverlayp
);
3112 defsubr (&Smake_overlay
);
3113 defsubr (&Sdelete_overlay
);
3114 defsubr (&Smove_overlay
);
3115 defsubr (&Soverlay_start
);
3116 defsubr (&Soverlay_end
);
3117 defsubr (&Soverlay_buffer
);
3118 defsubr (&Soverlay_properties
);
3119 defsubr (&Soverlays_at
);
3120 defsubr (&Snext_overlay_change
);
3121 defsubr (&Sprevious_overlay_change
);
3122 defsubr (&Soverlay_recenter
);
3123 defsubr (&Soverlay_lists
);
3124 defsubr (&Soverlay_get
);
3125 defsubr (&Soverlay_put
);
3130 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
3131 initial_define_key (control_x_map
, 'k', "kill-buffer");
3132 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");
3134 /* This must not be in syms_of_buffer, because Qdisabled is not
3135 initialized when that function gets called. */
3136 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);