1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993
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"
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
;
114 Lisp_Object Vtransient_mark_mode
;
116 /* t means ignore all read-only text properties.
117 A list means ignore such a property if its value is a member of the list.
118 Any non-nil value means ignore buffer-read-only. */
119 Lisp_Object Vinhibit_read_only
;
121 /* List of functions to call before changing an unmodified buffer. */
122 Lisp_Object Vfirst_change_hook
;
123 Lisp_Object Qfirst_change_hook
;
125 Lisp_Object Qfundamental_mode
, Qmode_class
, Qpermanent_local
;
127 Lisp_Object Qprotected_field
;
129 Lisp_Object QSFundamental
; /* A string "Fundamental" */
131 Lisp_Object Qkill_buffer_hook
;
133 Lisp_Object Qoverlayp
;
135 Lisp_Object Qmodification_hooks
;
136 Lisp_Object Qinsert_in_front_hooks
;
137 Lisp_Object Qinsert_behind_hooks
;
139 /* For debugging; temporary. See set_buffer_internal. */
140 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
145 if (XTYPE (spec
) == Lisp_String
)
146 error ("No buffer named %s", XSTRING (spec
)->data
);
147 error ("Invalid buffer argument");
150 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
151 "Return a list of all existing live buffers.")
154 return Fmapcar (Qcdr
, Vbuffer_alist
);
157 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
158 "Return the buffer named NAME (a string).\n\
159 If there is no live buffer named NAME, return nil.\n\
160 NAME may also be a buffer; if so, the value is that buffer.")
162 register Lisp_Object name
;
164 if (XTYPE (name
) == Lisp_Buffer
)
166 CHECK_STRING (name
, 0);
168 return Fcdr (Fassoc (name
, Vbuffer_alist
));
171 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
172 "Return the buffer visiting file FILENAME (a string).\n\
173 If there is no such live buffer, return nil.")
175 register Lisp_Object filename
;
177 register Lisp_Object tail
, buf
, tem
;
178 CHECK_STRING (filename
, 0);
179 filename
= Fexpand_file_name (filename
, Qnil
);
181 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
183 buf
= Fcdr (XCONS (tail
)->car
);
184 if (XTYPE (buf
) != Lisp_Buffer
) continue;
185 if (XTYPE (XBUFFER (buf
)->filename
) != Lisp_String
) continue;
186 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
193 /* Incremented for each buffer created, to assign the buffer number. */
196 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
197 "Return the buffer named NAME, or create such a buffer and return it.\n\
198 A new buffer is created if there is no live buffer named NAME.\n\
199 If NAME starts with a space, the new buffer does not keep undo information.\n\
200 If NAME is a buffer instead of a string, then it is the value returned.\n\
201 The value is never nil.")
203 register Lisp_Object name
;
205 register Lisp_Object buf
, function
, tem
;
206 int count
= specpdl_ptr
- specpdl
;
207 register struct buffer
*b
;
209 buf
= Fget_buffer (name
);
213 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
215 BUF_GAP_SIZE (b
) = 20;
217 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
219 if (! BUF_BEG_ADDR (b
))
229 /* Put this on the chain of all buffers including killed ones. */
230 b
->next
= all_buffers
;
233 b
->mark
= Fmake_marker ();
234 /*b->number = make_number (++buffer_count);*/
236 if (XSTRING (name
)->data
[0] != ' ')
243 /* Put this in the alist of all live buffers. */
244 XSET (buf
, Lisp_Buffer
, b
);
245 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
247 b
->mark
= Fmake_marker ();
251 function
= buffer_defaults
.major_mode
;
254 tem
= Fget (current_buffer
->major_mode
, Qmode_class
);
256 function
= current_buffer
->major_mode
;
259 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
262 /* To select a nonfundamental mode,
263 select the buffer temporarily and then call the mode function. */
265 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
270 return unbind_to (count
, buf
);
273 /* Reinitialize everything about a buffer except its name and contents. */
277 register struct buffer
*b
;
280 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
282 b
->save_modified
= 1;
283 XFASTINT (b
->save_length
) = 0;
284 b
->last_window_start
= 1;
286 b
->auto_save_modified
= 0;
287 b
->auto_save_file_name
= Qnil
;
289 b
->overlays_before
= Qnil
;
290 b
->overlays_after
= Qnil
;
291 XFASTINT (b
->overlay_center
) = 1;
292 b
->mark_active
= Qnil
;
294 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
295 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
297 reset_buffer_local_variables(b
);
300 reset_buffer_local_variables (b
)
301 register struct buffer
*b
;
305 /* Reset the major mode to Fundamental, together with all the
306 things that depend on the major mode.
307 default-major-mode is handled at a higher level.
308 We ignore it here. */
309 b
->major_mode
= Qfundamental_mode
;
311 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
312 b
->mode_name
= QSFundamental
;
313 b
->minor_modes
= Qnil
;
314 b
->downcase_table
= Vascii_downcase_table
;
315 b
->upcase_table
= Vascii_upcase_table
;
316 b
->case_canon_table
= Vascii_downcase_table
;
317 b
->case_eqv_table
= Vascii_upcase_table
;
319 b
->sort_table
= XSTRING (Vascii_sort_table
);
320 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
323 /* Reset all per-buffer variables to their defaults. */
324 b
->local_var_alist
= Qnil
;
325 b
->local_var_flags
= 0;
327 /* For each slot that has a default value,
328 copy that into the slot. */
330 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
331 offset
< sizeof (struct buffer
);
332 offset
+= sizeof (Lisp_Object
)) /* sizeof int == sizeof Lisp_Object */
333 if (*(int *)(offset
+ (char *) &buffer_local_flags
) > 0
334 || *(int *)(offset
+ (char *) &buffer_local_flags
) == -2)
335 *(Lisp_Object
*)(offset
+ (char *)b
) =
336 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
339 /* We split this away from generate-new-buffer, because rename-buffer
340 and set-visited-file-name ought to be able to use this to really
341 rename the buffer properly. */
343 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
345 "Return a string that is the name of no existing buffer based on NAME.\n\
346 If there is no live buffer named NAME, then return NAME.\n\
347 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
348 until an unused name is found, and then return that name.\n\
349 Optional second argument IGNORE specifies a name that is okay to use\n\
350 \(if it is in the sequence to be tried)\n\
351 even if a buffer with that name exists.")
353 register Lisp_Object name
, ignore
;
355 register Lisp_Object gentemp
, tem
;
359 CHECK_STRING (name
, 0);
361 tem
= Fget_buffer (name
);
368 sprintf (number
, "<%d>", ++count
);
369 gentemp
= concat2 (name
, build_string (number
));
370 tem
= Fstring_equal (gentemp
, ignore
);
373 tem
= Fget_buffer (gentemp
);
380 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
381 "Return the name of BUFFER, as a string.\n\
382 With no argument or nil as argument, return the name of the current buffer.")
384 register Lisp_Object buffer
;
387 return current_buffer
->name
;
388 CHECK_BUFFER (buffer
, 0);
389 return XBUFFER (buffer
)->name
;
392 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
393 "Return name of file BUFFER is visiting, or nil if none.\n\
394 No argument or nil as argument means use the current buffer.")
396 register Lisp_Object buffer
;
399 return current_buffer
->filename
;
400 CHECK_BUFFER (buffer
, 0);
401 return XBUFFER (buffer
)->filename
;
404 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
405 Sbuffer_local_variables
, 0, 1, 0,
406 "Return an alist of variables that are buffer-local in BUFFER.\n\
407 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
408 For a symbol that is locally unbound, just the symbol appears in the value.\n\
409 Note that storing new VALUEs in these elements doesn't change the variables.\n\
410 No argument or nil as argument means use current buffer as BUFFER.")
412 register Lisp_Object buffer
;
414 register struct buffer
*buf
;
415 register Lisp_Object result
;
418 buf
= current_buffer
;
421 CHECK_BUFFER (buffer
, 0);
422 buf
= XBUFFER (buffer
);
428 /* Reference each variable in the alist in our current buffer.
429 If inquiring about the current buffer, this gets the current values,
430 so store them into the alist so the alist is up to date.
431 If inquiring about some other buffer, this swaps out any values
432 for that buffer, making the alist up to date automatically. */
433 register Lisp_Object tail
;
434 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
436 Lisp_Object val
, elt
;
438 elt
= XCONS (tail
)->car
;
440 if (buf
== current_buffer
)
441 val
= find_symbol_value (XCONS (elt
)->car
);
443 val
= XCONS (elt
)->cdr
;
445 /* If symbol is unbound, put just the symbol in the list. */
446 if (EQ (val
, Qunbound
))
447 result
= Fcons (XCONS (elt
)->car
, result
);
448 /* Otherwise, put (symbol . value) in the list. */
450 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
454 /* Add on all the variables stored in special slots. */
456 register int offset
, mask
;
458 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
459 offset
< sizeof (struct buffer
);
460 offset
+= (sizeof (int))) /* sizeof int == sizeof Lisp_Object */
462 mask
= *(int *)(offset
+ (char *) &buffer_local_flags
);
463 if (mask
== -1 || (buf
->local_var_flags
& mask
))
464 if (XTYPE (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
))
466 result
= Fcons (Fcons (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
),
467 *(Lisp_Object
*)(offset
+ (char *)buf
)),
476 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
478 "Return t if BUFFER was modified since its file was last read or saved.\n\
479 No argument or nil as argument means use current buffer as BUFFER.")
481 register Lisp_Object buffer
;
483 register struct buffer
*buf
;
485 buf
= current_buffer
;
488 CHECK_BUFFER (buffer
, 0);
489 buf
= XBUFFER (buffer
);
492 return buf
->save_modified
< BUF_MODIFF (buf
) ? Qt
: Qnil
;
495 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
497 "Mark current buffer as modified or unmodified according to FLAG.\n\
498 A non-nil FLAG means mark the buffer modified.")
500 register Lisp_Object flag
;
502 register int already
;
503 register Lisp_Object fn
;
505 #ifdef CLASH_DETECTION
506 /* If buffer becoming modified, lock the file.
507 If buffer becoming unmodified, unlock the file. */
509 fn
= current_buffer
->filename
;
512 already
= current_buffer
->save_modified
< MODIFF
;
513 if (!already
&& !NILP (flag
))
515 else if (already
&& NILP (flag
))
518 #endif /* CLASH_DETECTION */
520 current_buffer
->save_modified
= NILP (flag
) ? MODIFF
: 0;
525 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
527 "Return BUFFER's tick counter, incremented for each change in text.\n\
528 Each buffer has a tick counter which is incremented each time the text in\n\
529 that buffer is changed. It wraps around occasionally.\n\
530 No argument or nil as argument means use current buffer as BUFFER.")
532 register Lisp_Object buffer
;
534 register struct buffer
*buf
;
536 buf
= current_buffer
;
539 CHECK_BUFFER (buffer
, 0);
540 buf
= XBUFFER (buffer
);
543 return make_number (BUF_MODIFF (buf
));
546 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
547 "sRename buffer (to new name): \nP",
548 "Change current buffer's name to NEWNAME (a string).\n\
549 If second arg UNIQUE is nil or omitted, it is an error if a\n\
550 buffer named NEWNAME already exists.\n\
551 If UNIQUE is non-nil, come up with a new name using\n\
552 `generate-new-buffer-name'.\n\
553 Interactively, you can set UNIQUE with a prefix argument.\n\
554 We return the name we actually gave the buffer.\n\
555 This does not change the name of the visited file (if any).")
557 register Lisp_Object name
, unique
;
559 register Lisp_Object tem
, buf
;
561 CHECK_STRING (name
, 0);
562 tem
= Fget_buffer (name
);
563 if (XBUFFER (tem
) == current_buffer
)
564 return current_buffer
->name
;
568 name
= Fgenerate_new_buffer_name (name
, current_buffer
->name
);
570 error ("Buffer name \"%s\" is in use", XSTRING (name
)->data
);
573 current_buffer
->name
= name
;
575 /* Catch redisplay's attention. Unless we do this, the mode lines for
576 any windows displaying current_buffer will stay unchanged. */
579 XSET (buf
, Lisp_Buffer
, current_buffer
);
580 Fsetcar (Frassq (buf
, Vbuffer_alist
), name
);
581 if (NILP (current_buffer
->filename
) && !NILP (current_buffer
->auto_save_file_name
))
582 call0 (intern ("rename-auto-save-file"));
586 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
587 "Return most recently selected buffer other than BUFFER.\n\
588 Buffers not visible in windows are preferred to visible buffers,\n\
589 unless optional second argument VISIBLE-OK is non-nil.\n\
590 If no other buffer exists, the buffer `*scratch*' is returned.\n\
591 If BUFFER is omitted or nil, some interesting buffer is returned.")
593 register Lisp_Object buffer
, visible_ok
;
595 register Lisp_Object tail
, buf
, notsogood
, tem
;
598 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
600 buf
= Fcdr (Fcar (tail
));
601 if (EQ (buf
, buffer
))
603 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
605 if (NILP (visible_ok
))
606 tem
= Fget_buffer_window (buf
, Qt
);
611 if (NILP (notsogood
))
614 if (!NILP (notsogood
))
616 return Fget_buffer_create (build_string ("*scratch*"));
619 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
, 1,1,
621 "Make BUFFER stop keeping undo information.")
623 register Lisp_Object buffer
;
625 Lisp_Object real_buffer
;
628 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
631 real_buffer
= Fget_buffer (buffer
);
632 if (NILP (real_buffer
))
636 XBUFFER (real_buffer
)->undo_list
= Qt
;
641 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
643 "Start keeping undo information for buffer BUFFER.\n\
644 No argument or nil as argument means do this for the current buffer.")
646 register Lisp_Object buffer
;
648 Lisp_Object real_buffer
;
651 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
654 real_buffer
= Fget_buffer (buffer
);
655 if (NILP (real_buffer
))
659 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
660 XBUFFER (real_buffer
)->undo_list
= Qnil
;
666 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
667 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
668 The buffer being killed will be current while the hook is running.\n\
671 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
672 "Kill the buffer BUFFER.\n\
673 The argument may be a buffer or may be the name of a buffer.\n\
674 An argument of nil means kill the current buffer.\n\n\
675 Value is t if the buffer is actually killed, nil if user says no.\n\n\
676 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
677 if not void, is a list of functions to be called, with no arguments,\n\
678 before the buffer is actually killed. The buffer to be killed is current\n\
679 when the hook functions are called.\n\n\
680 Any processes that have this buffer as the `process-buffer' are killed\n\
681 with `delete-process'.")
686 register struct buffer
*b
;
687 register Lisp_Object tem
;
688 register struct Lisp_Marker
*m
;
689 struct gcpro gcpro1
, gcpro2
;
692 buf
= Fcurrent_buffer ();
694 buf
= Fget_buffer (bufname
);
700 /* Query if the buffer is still modified. */
701 if (INTERACTIVE
&& !NILP (b
->filename
)
702 && BUF_MODIFF (b
) > b
->save_modified
)
704 GCPRO2 (buf
, bufname
);
705 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
706 XSTRING (b
->name
)->data
));
712 /* Run kill-buffer hook with the buffer to be killed the current buffer. */
714 register Lisp_Object val
;
715 int count
= specpdl_ptr
- specpdl
;
717 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
718 set_buffer_internal (b
);
719 call1 (Vrun_hooks
, Qkill_buffer_hook
);
720 unbind_to (count
, Qnil
);
723 /* We have no more questions to ask. Verify that it is valid
724 to kill the buffer. This must be done after the questions
725 since anything can happen within do_yes_or_no_p. */
727 /* Don't kill the minibuffer now current. */
728 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
734 /* Make this buffer not be current.
735 In the process, notice if this is the sole visible buffer
736 and give up if so. */
737 if (b
== current_buffer
)
739 tem
= Fother_buffer (buf
, Qnil
);
741 if (b
== current_buffer
)
745 /* Now there is no question: we can kill the buffer. */
747 #ifdef CLASH_DETECTION
748 /* Unlock this buffer's file, if it is locked. */
750 #endif /* CLASH_DETECTION */
752 kill_buffer_processes (buf
);
756 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
757 Freplace_buffer_in_windows (buf
);
760 /* Delete any auto-save file. */
761 if (XTYPE (b
->auto_save_file_name
) == Lisp_String
)
764 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
766 unlink (XSTRING (b
->auto_save_file_name
)->data
);
769 /* Unchain all markers of this buffer
770 and leave them pointing nowhere. */
771 for (tem
= b
->markers
; !EQ (tem
, Qnil
); )
780 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
781 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
782 /* Perhaps we should explicitly free the interval tree here... */
786 BUFFER_FREE (BUF_BEG_ADDR (b
));
793 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
794 we do this each time BUF is selected visibly, the more recently
795 selected buffers are always closer to the front of the list. This
796 means that other_buffer is more likely to choose a relevant buffer. */
801 register Lisp_Object link
, prev
;
804 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
806 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
811 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
812 we cannot use Fdelq itself here because it allows quitting. */
815 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
817 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
819 XCONS(link
)->cdr
= Vbuffer_alist
;
820 Vbuffer_alist
= link
;
823 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
824 "Select buffer BUFFER in the current window.\n\
825 BUFFER may be a buffer or a buffer name.\n\
826 Optional second arg NORECORD non-nil means\n\
827 do not put this buffer at the front of the list of recently selected ones.\n\
829 WARNING: This is NOT the way to work on another buffer temporarily\n\
830 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
831 the window-buffer correspondences.")
833 Lisp_Object bufname
, norecord
;
835 register Lisp_Object buf
;
838 if (EQ (minibuf_window
, selected_window
))
839 error ("Cannot switch buffers in minibuffer window");
840 tem
= Fwindow_dedicated_p (selected_window
);
842 error ("Cannot switch buffers in a dedicated window");
845 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
847 buf
= Fget_buffer_create (bufname
);
852 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
853 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
860 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
861 "Select buffer BUFFER in some window, preferably a different one.\n\
862 If BUFFER is nil, then some other buffer is chosen.\n\
863 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
864 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
865 window even if BUFFER is already visible in the selected window.")
867 Lisp_Object bufname
, other
;
869 register Lisp_Object buf
;
871 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
873 buf
= Fget_buffer_create (bufname
);
876 Fselect_window (Fdisplay_buffer (buf
, other
));
880 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
881 "Return the current buffer as a Lisp object.")
884 register Lisp_Object buf
;
885 XSET (buf
, Lisp_Buffer
, current_buffer
);
889 /* Set the current buffer to b */
892 set_buffer_internal (b
)
893 register struct buffer
*b
;
895 register struct buffer
*old_buf
;
896 register Lisp_Object tail
, valcontents
;
899 if (current_buffer
== b
)
902 windows_or_buffers_changed
= 1;
903 old_buf
= current_buffer
;
905 last_known_column_point
= -1; /* invalidate indentation cache */
907 /* Look down buffer's list of local Lisp variables
908 to find and update any that forward into C variables. */
910 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
912 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
913 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
914 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
915 && (tem
= XTYPE (XCONS (valcontents
)->car
),
916 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
917 || tem
== Lisp_Objfwd
)))
918 /* Just reference the variable
919 to cause it to become set for this buffer. */
920 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
923 /* Do the same with any others that were local to the previous buffer */
926 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
928 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
929 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
930 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
931 && (tem
= XTYPE (XCONS (valcontents
)->car
),
932 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
933 || tem
== Lisp_Objfwd
)))
934 /* Just reference the variable
935 to cause it to become set for this buffer. */
936 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
940 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
941 "Make the buffer BUFFER current for editing operations.\n\
942 BUFFER may be a buffer or the name of an existing buffer.\n\
943 See also `save-excursion' when you want to make a buffer current temporarily.\n\
944 This function does not display the buffer, so its effect ends\n\
945 when the current command terminates.\n\
946 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
948 register Lisp_Object bufname
;
950 register Lisp_Object buffer
;
951 buffer
= Fget_buffer (bufname
);
954 if (NILP (XBUFFER (buffer
)->name
))
955 error ("Selecting deleted buffer");
956 set_buffer_internal (XBUFFER (buffer
));
960 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
961 Sbarf_if_buffer_read_only
, 0, 0, 0,
962 "Signal a `buffer-read-only' error if the current buffer is read-only.")
965 if (!NILP (current_buffer
->read_only
)
966 && NILP (Vinhibit_read_only
))
967 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
971 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
972 "Put BUFFER at the end of the list of all buffers.\n\
973 There it is the least likely candidate for `other-buffer' to return;\n\
974 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
975 If BUFFER is nil or omitted, bury the current buffer.\n\
976 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
977 selected window if it is displayed there.")
979 register Lisp_Object buf
;
981 /* Figure out what buffer we're going to bury. */
984 XSET (buf
, Lisp_Buffer
, current_buffer
);
986 /* If we're burying the current buffer, unshow it. */
987 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
993 buf1
= Fget_buffer (buf
);
999 /* Move buf to the end of the buffer list. */
1001 register Lisp_Object aelt
, link
;
1003 aelt
= Frassq (buf
, Vbuffer_alist
);
1004 link
= Fmemq (aelt
, Vbuffer_alist
);
1005 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1006 XCONS (link
)->cdr
= Qnil
;
1007 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1013 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1014 "Delete the entire contents of the current buffer.\n\
1015 Any clipping restriction in effect (see `narrow-to-region') is removed,\n\
1016 so the buffer is truly empty after this.")
1021 current_buffer
->last_window_start
= 1;
1022 /* Prevent warnings, or suspension of auto saving, that would happen
1023 if future size is less than past size. Use of erase-buffer
1024 implies that the future text is not really related to the past text. */
1025 XFASTINT (current_buffer
->save_length
) = 0;
1029 validate_region (b
, e
)
1030 register Lisp_Object
*b
, *e
;
1034 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1035 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1037 if (XINT (*b
) > XINT (*e
))
1039 i
= XFASTINT (*b
); /* This is legit even if *b is < 0 */
1041 XFASTINT (*e
) = i
; /* because this is all we do with i. */
1044 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1045 && XINT (*e
) <= ZV
))
1046 args_out_of_range (*b
, *e
);
1050 list_buffers_1 (files
)
1053 register Lisp_Object tail
, tem
, buf
;
1054 Lisp_Object col1
, col2
, col3
, minspace
;
1055 register struct buffer
*old
= current_buffer
, *b
;
1056 Lisp_Object desired_point
;
1057 Lisp_Object other_file_symbol
;
1059 desired_point
= Qnil
;
1060 other_file_symbol
= intern ("list-buffers-directory");
1062 XFASTINT (col1
) = 19;
1063 XFASTINT (col2
) = 25;
1064 XFASTINT (col3
) = 40;
1065 XFASTINT (minspace
) = 1;
1067 Fset_buffer (Vstandard_output
);
1069 tail
= intern ("Buffer-menu-mode");
1070 if (!EQ (tail
, current_buffer
->major_mode
)
1071 && (tem
= Ffboundp (tail
), !NILP (tem
)))
1073 Fbuffer_disable_undo (Vstandard_output
);
1074 current_buffer
->read_only
= Qnil
;
1077 MR Buffer Size Mode File\n\
1078 -- ------ ---- ---- ----\n", -1);
1080 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
1082 buf
= Fcdr (Fcar (tail
));
1084 /* Don't mention the minibuffers. */
1085 if (XSTRING (b
->name
)->data
[0] == ' ')
1087 /* Optionally don't mention buffers that lack files. */
1088 if (!NILP (files
) && NILP (b
->filename
))
1090 /* Identify the current buffer. */
1092 XFASTINT (desired_point
) = point
;
1093 write_string (b
== old
? "." : " ", -1);
1094 /* Identify modified buffers */
1095 write_string (BUF_MODIFF (b
) > b
->save_modified
? "*" : " ", -1);
1096 write_string (NILP (b
->read_only
) ? " " : "% ", -1);
1097 Fprinc (b
->name
, Qnil
);
1098 Findent_to (col1
, make_number (2));
1099 XFASTINT (tem
) = BUF_Z (b
) - BUF_BEG (b
);
1101 Findent_to (col2
, minspace
);
1102 Fprinc (b
->mode_name
, Qnil
);
1103 Findent_to (col3
, minspace
);
1105 if (!NILP (b
->filename
))
1106 Fprinc (b
->filename
, Qnil
);
1109 /* No visited file; check local value of list-buffers-directory. */
1111 set_buffer_internal (b
);
1112 tem
= Fboundp (other_file_symbol
);
1115 tem
= Fsymbol_value (other_file_symbol
);
1116 Fset_buffer (Vstandard_output
);
1117 if (XTYPE (tem
) == Lisp_String
)
1121 Fset_buffer (Vstandard_output
);
1123 write_string ("\n", -1);
1126 current_buffer
->read_only
= Qt
;
1127 set_buffer_internal (old
);
1128 return desired_point
;
1131 DEFUN ("list-buffers", Flist_buffers
, Slist_buffers
, 0, 1, "P",
1132 "Display a list of names of existing buffers.\n\
1133 The list is displayed in a buffer named `*Buffer List*'.\n\
1134 Note that buffers with names starting with spaces are omitted.\n\
1135 Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1137 The M column contains a * for buffers that are modified.\n\
1138 The R column contains a % for buffers that are read-only.")
1142 Lisp_Object desired_point
;
1145 internal_with_output_to_temp_buffer ("*Buffer List*",
1146 list_buffers_1
, files
);
1148 if (NUMBERP (desired_point
))
1150 int count
= specpdl_ptr
- specpdl
;
1151 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
1152 Fset_buffer (build_string ("*Buffer List*"));
1153 SET_PT (XINT (desired_point
));
1154 return unbind_to (count
, Qnil
);
1158 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1160 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1161 Most local variable bindings are eliminated so that the default values\n\
1162 become effective once more. Also, the syntax table is set from\n\
1163 `standard-syntax-table', the local keymap is set to nil,\n\
1164 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1165 This function also forces redisplay of the mode line.\n\
1167 Every function to select a new major mode starts by\n\
1168 calling this function.\n\n\
1169 As a special exception, local variables whose names have\n\
1170 a non-nil `permanent-local' property are not eliminated by this function.")
1173 register Lisp_Object alist
, sym
, tem
;
1175 oalist
= current_buffer
->local_var_alist
;
1177 /* Make sure no local variables remain set up with this buffer
1178 for their current values. */
1180 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1182 sym
= XCONS (XCONS (alist
)->car
)->car
;
1184 /* Need not do anything if some other buffer's binding is now encached. */
1185 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
;
1186 if (XBUFFER (tem
) == current_buffer
)
1188 /* Symbol is set up for this buffer's old local value.
1189 Set it up for the current buffer with the default value. */
1191 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1192 /* Store the symbol's current value into the alist entry
1193 it is currently set up for. This is so that, if the
1194 local is marked permanent, and we make it local again below,
1195 we don't lose the value. */
1196 XCONS (XCONS (tem
)->car
)->cdr
= XCONS (XSYMBOL (sym
)->value
)->car
;
1197 /* Switch to the symbol's default-value alist entry. */
1198 XCONS (tem
)->car
= tem
;
1199 /* Mark it as current for the current buffer. */
1200 XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
= Fcurrent_buffer ();
1201 /* Store the current value into any forwarding in the symbol. */
1202 store_symval_forwarding (sym
, XCONS (XSYMBOL (sym
)->value
)->car
,
1207 /* Actually eliminate all local bindings of this buffer. */
1209 reset_buffer_local_variables (current_buffer
);
1211 /* Redisplay mode lines; we are changing major mode. */
1213 update_mode_lines
++;
1215 /* Any which are supposed to be permanent,
1216 make local again, with the same values they had. */
1218 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1220 sym
= XCONS (XCONS (alist
)->car
)->car
;
1221 tem
= Fget (sym
, Qpermanent_local
);
1224 Fmake_local_variable (sym
);
1225 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1229 /* Force mode-line redisplay. Useful here because all major mode
1230 commands call this function. */
1231 update_mode_lines
++;
1236 /* Find all the overlays in the current buffer that contain position POS.
1237 Return the number found, and store them in a vector in *VEC_PTR.
1238 Store in *LEN_PTR the size allocated for the vector.
1239 Store in *NEXT_PTR the next position after POS where an overlay starts,
1240 or ZV if there are no more overlays.
1242 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1243 when this function is called.
1245 If EXTEND is non-zero, we make the vector bigger if necessary.
1246 If EXTEND is zero, we never extend the vector,
1247 and we store only as many overlays as will fit.
1248 But we still return the total number of overlays. */
1251 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
)
1254 Lisp_Object
**vec_ptr
;
1258 Lisp_Object tail
, overlay
, start
, end
, result
;
1261 Lisp_Object
*vec
= *vec_ptr
;
1263 int inhibit_storing
= 0;
1265 for (tail
= current_buffer
->overlays_before
;
1267 tail
= XCONS (tail
)->cdr
)
1271 overlay
= XCONS (tail
)->car
;
1272 if (! OVERLAY_VALID (overlay
))
1275 start
= OVERLAY_START (overlay
);
1276 end
= OVERLAY_END (overlay
);
1277 if (OVERLAY_POSITION (end
) <= pos
)
1279 startpos
= OVERLAY_POSITION (start
);
1280 if (startpos
<= pos
)
1284 /* The supplied vector is full.
1285 Either make it bigger, or don't store any more in it. */
1288 *len_ptr
= len
*= 2;
1289 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1293 inhibit_storing
= 1;
1296 if (!inhibit_storing
)
1298 /* Keep counting overlays even if we can't return them all. */
1301 else if (startpos
< next
)
1305 for (tail
= current_buffer
->overlays_after
;
1307 tail
= XCONS (tail
)->cdr
)
1311 overlay
= XCONS (tail
)->car
;
1312 if (! OVERLAY_VALID (overlay
))
1315 start
= OVERLAY_START (overlay
);
1316 end
= OVERLAY_END (overlay
);
1317 startpos
= OVERLAY_POSITION (start
);
1320 if (startpos
< next
)
1324 if (pos
< OVERLAY_POSITION (end
))
1330 *len_ptr
= len
*= 2;
1331 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1335 inhibit_storing
= 1;
1338 if (!inhibit_storing
)
1348 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1351 recenter_overlay_lists (buf
, pos
)
1355 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1357 /* See if anything in overlays_before should move to overlays_after. */
1359 /* We don't strictly need prev in this loop; it should always be nil.
1360 But we use it for symmetry and in case that should cease to be true
1361 with some future change. */
1363 for (tail
= buf
->overlays_before
;
1365 prev
= tail
, tail
= next
)
1367 next
= XCONS (tail
)->cdr
;
1368 overlay
= XCONS (tail
)->car
;
1370 /* If the overlay is not valid, get rid of it. */
1371 if (!OVERLAY_VALID (overlay
))
1376 /* Splice the cons cell TAIL out of overlays_before. */
1378 XCONS (prev
)->cdr
= next
;
1380 buf
->overlays_before
= next
;
1386 beg
= OVERLAY_START (overlay
);
1387 end
= OVERLAY_END (overlay
);
1389 if (OVERLAY_POSITION (end
) > pos
)
1391 /* OVERLAY needs to be moved. */
1392 int where
= OVERLAY_POSITION (beg
);
1393 Lisp_Object other
, other_prev
;
1395 /* Splice the cons cell TAIL out of overlays_before. */
1397 XCONS (prev
)->cdr
= next
;
1399 buf
->overlays_before
= next
;
1401 /* Search thru overlays_after for where to put it. */
1403 for (other
= buf
->overlays_after
;
1405 other_prev
= other
, other
= XCONS (other
)->cdr
)
1407 Lisp_Object otherbeg
, otheroverlay
, follower
;
1410 otheroverlay
= XCONS (other
)->car
;
1411 if (! OVERLAY_VALID (otheroverlay
))
1414 otherbeg
= OVERLAY_START (otheroverlay
);
1415 if (OVERLAY_POSITION (otherbeg
) >= where
)
1419 /* Add TAIL to overlays_after before OTHER. */
1420 XCONS (tail
)->cdr
= other
;
1421 if (!NILP (other_prev
))
1422 XCONS (other_prev
)->cdr
= tail
;
1424 buf
->overlays_after
= tail
;
1428 /* We've reached the things that should stay in overlays_before.
1429 All the rest of overlays_before must end even earlier,
1434 /* See if anything in overlays_after should be in overlays_before. */
1436 for (tail
= buf
->overlays_after
;
1438 prev
= tail
, tail
= next
)
1440 next
= XCONS (tail
)->cdr
;
1441 overlay
= XCONS (tail
)->car
;
1443 /* If the overlay is not valid, get rid of it. */
1444 if (!OVERLAY_VALID (overlay
))
1449 /* Splice the cons cell TAIL out of overlays_after. */
1451 XCONS (prev
)->cdr
= next
;
1453 buf
->overlays_after
= next
;
1459 beg
= OVERLAY_START (overlay
);
1460 end
= OVERLAY_END (overlay
);
1462 /* Stop looking, when we know that nothing further
1463 can possibly end before POS. */
1464 if (OVERLAY_POSITION (beg
) > pos
)
1467 if (OVERLAY_POSITION (end
) <= pos
)
1469 /* OVERLAY needs to be moved. */
1470 int where
= OVERLAY_POSITION (end
);
1471 Lisp_Object other
, other_prev
;
1473 /* Splice the cons cell TAIL out of overlays_after. */
1475 XCONS (prev
)->cdr
= next
;
1477 buf
->overlays_after
= next
;
1479 /* Search thru overlays_before for where to put it. */
1481 for (other
= buf
->overlays_before
;
1483 other_prev
= other
, other
= XCONS (other
)->cdr
)
1485 Lisp_Object otherend
, otheroverlay
;
1488 otheroverlay
= XCONS (other
)->car
;
1489 if (! OVERLAY_VALID (otheroverlay
))
1492 otherend
= OVERLAY_END (otheroverlay
);
1493 if (OVERLAY_POSITION (otherend
) <= where
)
1497 /* Add TAIL to overlays_before before OTHER. */
1498 XCONS (tail
)->cdr
= other
;
1499 if (!NILP (other_prev
))
1500 XCONS (other_prev
)->cdr
= tail
;
1502 buf
->overlays_before
= tail
;
1507 XFASTINT (buf
->overlay_center
) = pos
;
1510 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1511 "Return t if OBJECT is an overlay.")
1515 return (OVERLAYP (object
) ? Qt
: Qnil
);
1518 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1519 "Create a new overlay with range BEG to END in BUFFER.\n\
1520 If omitted, BUFFER defaults to the current buffer.\n\
1521 BEG and END may be integers or markers.")
1523 Lisp_Object beg
, end
, buffer
;
1525 Lisp_Object overlay
;
1529 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1531 CHECK_BUFFER (buffer
, 2);
1533 && ! EQ (Fmarker_buffer (beg
), buffer
))
1534 error ("Marker points into wrong buffer");
1536 && ! EQ (Fmarker_buffer (end
), buffer
))
1537 error ("Marker points into wrong buffer");
1539 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1540 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1542 if (XINT (beg
) > XINT (end
))
1544 Lisp_Object temp
= beg
;
1545 beg
= end
; end
= temp
;
1548 b
= XBUFFER (buffer
);
1550 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1551 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1553 overlay
= Fcons (Fcons (beg
, end
), Qnil
);
1554 XSETTYPE (overlay
, Lisp_Overlay
);
1556 /* Put the new overlay on the wrong list. */
1557 end
= OVERLAY_END (overlay
);
1558 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1559 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1561 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1563 /* This puts it in the right list, and in the right order. */
1564 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1566 /* We don't need to redisplay the region covered by the overlay, because
1567 the overlay has no properties at the moment. */
1572 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
1573 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1574 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1575 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1577 (overlay
, beg
, end
, buffer
)
1578 Lisp_Object overlay
, beg
, end
, buffer
;
1580 struct buffer
*b
, *ob
;
1581 Lisp_Object obuffer
;
1582 int count
= specpdl_ptr
- specpdl
;
1584 CHECK_OVERLAY (overlay
, 0);
1586 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1588 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1589 CHECK_BUFFER (buffer
, 3);
1592 && ! EQ (Fmarker_buffer (beg
), buffer
))
1593 error ("Marker points into wrong buffer");
1595 && ! EQ (Fmarker_buffer (end
), buffer
))
1596 error ("Marker points into wrong buffer");
1598 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1599 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1601 specbind (Qinhibit_quit
, Qt
);
1603 if (XINT (beg
) > XINT (end
))
1605 Lisp_Object temp
= beg
;
1606 beg
= end
; end
= temp
;
1609 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1610 b
= XBUFFER (buffer
);
1611 ob
= XBUFFER (obuffer
);
1613 /* If the overlay has changed buffers, do a thorough redisplay. */
1614 if (!EQ (buffer
, obuffer
))
1615 windows_or_buffers_changed
= 1;
1617 /* Redisplay the area the overlay has just left, or just enclosed. */
1621 int change_beg
, change_end
;
1623 o_beg
= OVERLAY_START (overlay
);
1624 o_end
= OVERLAY_END (overlay
);
1625 o_beg
= OVERLAY_POSITION (o_beg
);
1626 o_end
= OVERLAY_POSITION (o_end
);
1628 if (XINT (o_beg
) == XINT (beg
))
1629 redisplay_region (b
, XINT (o_end
), XINT (end
));
1630 else if (XINT (o_end
) == XINT (end
))
1631 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
1634 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
1635 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
1636 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
1640 if (!NILP (obuffer
))
1642 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
1643 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
1646 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
1647 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
1649 /* Put the overlay on the wrong list. */
1650 end
= OVERLAY_END (overlay
);
1651 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1652 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1654 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1656 /* This puts it in the right list, and in the right order. */
1657 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1659 return unbind_to (count
, overlay
);
1662 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
1663 "Delete the overlay OVERLAY from its buffer.")
1665 Lisp_Object overlay
;
1669 int count
= specpdl_ptr
- specpdl
;
1671 CHECK_OVERLAY (overlay
, 0);
1673 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1677 b
= XBUFFER (buffer
);
1679 specbind (Qinhibit_quit
, Qt
);
1681 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
1682 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
1684 redisplay_region (b
,
1685 OVERLAY_POSITION (OVERLAY_START (overlay
)),
1686 OVERLAY_POSITION (OVERLAY_END (overlay
)));
1688 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
1689 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
1691 return unbind_to (count
, Qnil
);
1694 /* Overlay dissection functions. */
1696 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
1697 "Return the position at which OVERLAY starts.")
1699 Lisp_Object overlay
;
1701 CHECK_OVERLAY (overlay
, 0);
1703 return (Fmarker_position (OVERLAY_START (overlay
)));
1706 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
1707 "Return the position at which OVERLAY ends.")
1709 Lisp_Object overlay
;
1711 CHECK_OVERLAY (overlay
, 0);
1713 return (Fmarker_position (OVERLAY_END (overlay
)));
1716 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
1717 "Return the buffer OVERLAY belongs to.")
1719 Lisp_Object overlay
;
1721 CHECK_OVERLAY (overlay
, 0);
1723 return Fmarker_buffer (OVERLAY_START (overlay
));
1726 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
1727 "Return a list of the properties on OVERLAY.\n\
1728 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
1731 Lisp_Object overlay
;
1733 CHECK_OVERLAY (overlay
, 0);
1735 return Fcopy_sequence (Fcdr_safe (XCONS (overlay
)->cdr
));
1739 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
1740 "Return a list of the overlays that contain position POS.")
1746 Lisp_Object
*overlay_vec
;
1750 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1753 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1755 /* Put all the overlays we want in a vector in overlay_vec.
1756 Store the length in len. */
1757 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1759 /* Make a list of them all. */
1760 result
= Flist (noverlays
, overlay_vec
);
1762 xfree (overlay_vec
);
1766 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
1768 "Return the next position after POS where an overlay starts or ends.")
1774 Lisp_Object
*overlay_vec
;
1779 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1782 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1784 /* Put all the overlays we want in a vector in overlay_vec.
1785 Store the length in len.
1786 endpos gets the position where the next overlay starts. */
1787 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1789 /* If any of these overlays ends before endpos,
1790 use its ending point instead. */
1791 for (i
= 0; i
< noverlays
; i
++)
1796 oend
= OVERLAY_END (overlay_vec
[i
]);
1797 oendpos
= OVERLAY_POSITION (oend
);
1798 if (oendpos
< endpos
)
1802 xfree (overlay_vec
);
1803 return make_number (endpos
);
1806 /* These functions are for debugging overlays. */
1808 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
1809 "Return a pair of lists giving all the overlays of the current buffer.\n\
1810 The car has all the overlays before the overlay center;\n\
1811 the cdr has all the overlays before the overlay center.\n\
1812 Recentering overlays moves overlays between these lists.\n\
1813 The lists you get are copies, so that changing them has no effect.\n\
1814 However, the overlays you get are the real objects that the buffer uses.")
1817 Lisp_Object before
, after
;
1818 before
= current_buffer
->overlays_before
;
1820 before
= Fcopy_sequence (before
);
1821 after
= current_buffer
->overlays_after
;
1823 after
= Fcopy_sequence (after
);
1825 return Fcons (before
, after
);
1828 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
1829 "Recenter the overlays of the current buffer around position POS.")
1833 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1835 recenter_overlay_lists (current_buffer
, XINT (pos
));
1839 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
1840 "Get the property of overlay OVERLAY with property name NAME.")
1842 Lisp_Object overlay
, prop
;
1846 CHECK_OVERLAY (overlay
, 0);
1848 for (plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1849 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
1850 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
1852 if (EQ (XCONS (plist
)->car
, prop
))
1853 return XCONS (XCONS (plist
)->cdr
)->car
;
1859 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
1860 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
1861 (overlay
, prop
, value
)
1862 Lisp_Object overlay
, prop
, value
;
1864 Lisp_Object plist
, tail
;
1866 CHECK_OVERLAY (overlay
, 0);
1868 redisplay_region (XMARKER (OVERLAY_START (overlay
))->buffer
,
1869 OVERLAY_POSITION (OVERLAY_START (overlay
)),
1870 OVERLAY_POSITION (OVERLAY_END (overlay
)));
1872 plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1875 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
1876 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
1878 if (EQ (XCONS (tail
)->car
, prop
))
1879 return XCONS (XCONS (tail
)->cdr
)->car
= value
;
1882 if (! CONSP (XCONS (overlay
)->cdr
))
1883 XCONS (overlay
)->cdr
= Fcons (Qnil
, Qnil
);
1885 XCONS (XCONS (overlay
)->cdr
)->cdr
1886 = Fcons (prop
, Fcons (value
, plist
));
1891 /* Run the modification-hooks of overlays that include
1892 any part of the text in START to END.
1893 Run the insert-before-hooks of overlay starting at END,
1894 and the insert-after-hooks of overlay ending at START. */
1897 verify_overlay_modification (start
, end
)
1898 Lisp_Object start
, end
;
1900 Lisp_Object prop
, overlay
, tail
;
1901 int insertion
= EQ (start
, end
);
1903 for (tail
= current_buffer
->overlays_before
;
1905 tail
= XCONS (tail
)->cdr
)
1907 int startpos
, endpos
;
1908 Lisp_Object ostart
, oend
;
1910 overlay
= XCONS (tail
)->car
;
1912 ostart
= OVERLAY_START (overlay
);
1913 oend
= OVERLAY_END (overlay
);
1914 endpos
= OVERLAY_POSITION (oend
);
1915 if (XFASTINT (start
) > endpos
)
1917 startpos
= OVERLAY_POSITION (ostart
);
1918 if (XFASTINT (end
) == startpos
&& insertion
)
1920 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1921 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1923 if (XFASTINT (start
) == endpos
&& insertion
)
1925 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1926 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1929 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1930 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1932 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1933 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1937 for (tail
= current_buffer
->overlays_after
;
1939 tail
= XCONS (tail
)->cdr
)
1941 int startpos
, endpos
;
1942 Lisp_Object ostart
, oend
;
1944 overlay
= XCONS (tail
)->car
;
1946 ostart
= OVERLAY_START (overlay
);
1947 oend
= OVERLAY_END (overlay
);
1948 startpos
= OVERLAY_POSITION (ostart
);
1949 endpos
= OVERLAY_POSITION (oend
);
1950 if (XFASTINT (end
) < startpos
)
1952 if (XFASTINT (end
) == startpos
&& insertion
)
1954 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1955 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1957 if (XFASTINT (start
) == endpos
&& insertion
)
1959 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1960 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1963 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1964 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1966 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1967 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1973 call_overlay_mod_hooks (list
, overlay
, start
, end
)
1974 Lisp_Object list
, overlay
, start
, end
;
1976 struct gcpro gcpro1
;
1978 while (!NILP (list
))
1980 call3 (Fcar (list
), overlay
, start
, end
);
1986 /* Somebody has tried to store NEWVAL into the buffer-local slot with
1987 offset XUINT (valcontents), and NEWVAL has an unacceptable type. */
1989 buffer_slot_type_mismatch (valcontents
, newval
)
1990 Lisp_Object valcontents
, newval
;
1992 unsigned int offset
= XUINT (valcontents
);
1993 unsigned char *symbol_name
=
1994 (XSYMBOL (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
))
1998 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
2000 case Lisp_Int
: type_name
= "integers"; break;
2001 case Lisp_String
: type_name
= "strings"; break;
2002 case Lisp_Marker
: type_name
= "markers"; break;
2003 case Lisp_Symbol
: type_name
= "symbols"; break;
2004 case Lisp_Cons
: type_name
= "lists"; break;
2005 case Lisp_Vector
: type_name
= "vectors"; break;
2010 error ("only %s should be stored in the buffer-local variable %s",
2011 type_name
, symbol_name
);
2016 register Lisp_Object tem
;
2018 /* Make sure all markable slots in buffer_defaults
2019 are initialized reasonably, so mark_buffer won't choke. */
2020 reset_buffer (&buffer_defaults
);
2021 reset_buffer (&buffer_local_symbols
);
2022 XSET (Vbuffer_defaults
, Lisp_Buffer
, &buffer_defaults
);
2023 XSET (Vbuffer_local_symbols
, Lisp_Buffer
, &buffer_local_symbols
);
2025 /* Set up the default values of various buffer slots. */
2026 /* Must do these before making the first buffer! */
2028 /* real setup is done in loaddefs.el */
2029 buffer_defaults
.mode_line_format
= build_string ("%-");
2030 buffer_defaults
.abbrev_mode
= Qnil
;
2031 buffer_defaults
.overwrite_mode
= Qnil
;
2032 buffer_defaults
.case_fold_search
= Qt
;
2033 buffer_defaults
.auto_fill_function
= Qnil
;
2034 buffer_defaults
.selective_display
= Qnil
;
2036 buffer_defaults
.selective_display_ellipses
= Qt
;
2038 buffer_defaults
.abbrev_table
= Qnil
;
2039 buffer_defaults
.display_table
= Qnil
;
2040 buffer_defaults
.undo_list
= Qnil
;
2041 buffer_defaults
.mark_active
= Qnil
;
2042 buffer_defaults
.overlays_before
= Qnil
;
2043 buffer_defaults
.overlays_after
= Qnil
;
2044 XFASTINT (buffer_defaults
.overlay_center
) = 1;
2046 XFASTINT (buffer_defaults
.tab_width
) = 8;
2047 buffer_defaults
.truncate_lines
= Qnil
;
2048 buffer_defaults
.ctl_arrow
= Qt
;
2050 XFASTINT (buffer_defaults
.fill_column
) = 70;
2051 XFASTINT (buffer_defaults
.left_margin
) = 0;
2053 /* Assign the local-flags to the slots that have default values.
2054 The local flag is a bit that is used in the buffer
2055 to say that it has its own local value for the slot.
2056 The local flag bits are in the local_var_flags slot of the buffer. */
2058 /* Nothing can work if this isn't true */
2059 if (sizeof (int) != sizeof (Lisp_Object
)) abort ();
2061 /* 0 means not a lisp var, -1 means always local, else mask */
2062 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2063 XFASTINT (buffer_local_flags
.filename
) = -1;
2064 XFASTINT (buffer_local_flags
.directory
) = -1;
2065 XFASTINT (buffer_local_flags
.backed_up
) = -1;
2066 XFASTINT (buffer_local_flags
.save_length
) = -1;
2067 XFASTINT (buffer_local_flags
.auto_save_file_name
) = -1;
2068 XFASTINT (buffer_local_flags
.read_only
) = -1;
2069 XFASTINT (buffer_local_flags
.major_mode
) = -1;
2070 XFASTINT (buffer_local_flags
.mode_name
) = -1;
2071 XFASTINT (buffer_local_flags
.undo_list
) = -1;
2072 XFASTINT (buffer_local_flags
.mark_active
) = -1;
2074 XFASTINT (buffer_local_flags
.mode_line_format
) = 1;
2075 XFASTINT (buffer_local_flags
.abbrev_mode
) = 2;
2076 XFASTINT (buffer_local_flags
.overwrite_mode
) = 4;
2077 XFASTINT (buffer_local_flags
.case_fold_search
) = 8;
2078 XFASTINT (buffer_local_flags
.auto_fill_function
) = 0x10;
2079 XFASTINT (buffer_local_flags
.selective_display
) = 0x20;
2081 XFASTINT (buffer_local_flags
.selective_display_ellipses
) = 0x40;
2083 XFASTINT (buffer_local_flags
.tab_width
) = 0x80;
2084 XFASTINT (buffer_local_flags
.truncate_lines
) = 0x100;
2085 XFASTINT (buffer_local_flags
.ctl_arrow
) = 0x200;
2086 XFASTINT (buffer_local_flags
.fill_column
) = 0x400;
2087 XFASTINT (buffer_local_flags
.left_margin
) = 0x800;
2088 XFASTINT (buffer_local_flags
.abbrev_table
) = 0x1000;
2089 XFASTINT (buffer_local_flags
.display_table
) = 0x2000;
2090 XFASTINT (buffer_local_flags
.syntax_table
) = 0x8000;
2092 Vbuffer_alist
= Qnil
;
2096 QSFundamental
= build_string ("Fundamental");
2098 Qfundamental_mode
= intern ("fundamental-mode");
2099 buffer_defaults
.major_mode
= Qfundamental_mode
;
2101 Qmode_class
= intern ("mode-class");
2103 Qprotected_field
= intern ("protected-field");
2105 Qpermanent_local
= intern ("permanent-local");
2107 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2109 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2110 /* super-magic invisible buffer */
2111 Vbuffer_alist
= Qnil
;
2113 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2118 char buf
[MAXPATHLEN
+1];
2120 struct stat dotstat
, pwdstat
;
2123 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2125 /* If PWD is accurate, use it instead of calling getwd. This is faster
2126 when PWD is right, and may avoid a fatal error. */
2127 if ((pwd
= getenv ("PWD")) != 0 && *pwd
== '/'
2128 && stat (pwd
, &pwdstat
) == 0
2129 && stat (".", &dotstat
) == 0
2130 && dotstat
.st_ino
== pwdstat
.st_ino
2131 && dotstat
.st_dev
== pwdstat
.st_dev
2132 && strlen (pwd
) < MAXPATHLEN
)
2134 else if (getwd (buf
) == 0)
2135 fatal ("`getwd' failed: %s.\n", buf
);
2138 /* Maybe this should really use some standard subroutine
2139 whose definition is filename syntax dependent. */
2140 if (buf
[strlen (buf
) - 1] != '/')
2142 #endif /* not VMS */
2143 current_buffer
->directory
= build_string (buf
);
2145 temp
= get_minibuffer (0);
2146 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2149 /* initialize the buffer routines */
2152 extern Lisp_Object Qdisabled
;
2154 staticpro (&Vbuffer_defaults
);
2155 staticpro (&Vbuffer_local_symbols
);
2156 staticpro (&Qfundamental_mode
);
2157 staticpro (&Qmode_class
);
2158 staticpro (&QSFundamental
);
2159 staticpro (&Vbuffer_alist
);
2160 staticpro (&Qprotected_field
);
2161 staticpro (&Qpermanent_local
);
2162 staticpro (&Qkill_buffer_hook
);
2163 staticpro (&Qoverlayp
);
2164 staticpro (&Qmodification_hooks
);
2165 Qmodification_hooks
= intern ("modification-hooks");
2166 staticpro (&Qinsert_in_front_hooks
);
2167 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
2168 staticpro (&Qinsert_behind_hooks
);
2169 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
2171 Qoverlayp
= intern ("overlayp");
2173 Fput (Qprotected_field
, Qerror_conditions
,
2174 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2175 Fput (Qprotected_field
, Qerror_message
,
2176 build_string ("Attempt to modify a protected field"));
2178 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);
2180 /* All these use DEFVAR_LISP_NOPRO because the slots in
2181 buffer_defaults will all be marked via Vbuffer_defaults. */
2183 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2184 &buffer_defaults
.mode_line_format
,
2185 "Default value of `mode-line-format' for buffers that don't override it.\n\
2186 This is the same as (default-value 'mode-line-format).");
2188 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2189 &buffer_defaults
.abbrev_mode
,
2190 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2191 This is the same as (default-value 'abbrev-mode).");
2193 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2194 &buffer_defaults
.ctl_arrow
,
2195 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2196 This is the same as (default-value 'ctl-arrow).");
2198 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2199 &buffer_defaults
.truncate_lines
,
2200 "Default value of `truncate-lines' for buffers that do not override it.\n\
2201 This is the same as (default-value 'truncate-lines).");
2203 DEFVAR_LISP_NOPRO ("default-fill-column",
2204 &buffer_defaults
.fill_column
,
2205 "Default value of `fill-column' for buffers that do not override it.\n\
2206 This is the same as (default-value 'fill-column).");
2208 DEFVAR_LISP_NOPRO ("default-left-margin",
2209 &buffer_defaults
.left_margin
,
2210 "Default value of `left-margin' for buffers that do not override it.\n\
2211 This is the same as (default-value 'left-margin).");
2213 DEFVAR_LISP_NOPRO ("default-tab-width",
2214 &buffer_defaults
.tab_width
,
2215 "Default value of `tab-width' for buffers that do not override it.\n\
2216 This is the same as (default-value 'tab-width).");
2218 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2219 &buffer_defaults
.case_fold_search
,
2220 "Default value of `case-fold-search' for buffers that don't override it.\n\
2221 This is the same as (default-value 'case-fold-search).");
2223 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2226 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2227 But make-docfile finds it!
2228 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2230 "Template for displaying mode line for current buffer.\n\
2231 Each buffer has its own value of this variable.\n\
2232 Value may be a string, a symbol or a list or cons cell.\n\
2233 For a symbol, its value is used (but it is ignored if t or nil).\n\
2234 A string appearing directly as the value of a symbol is processed verbatim\n\
2235 in that the %-constructs below are not recognized.\n\
2236 For a list whose car is a symbol, the symbol's value is taken,\n\
2237 and if that is non-nil, the cadr of the list is processed recursively.\n\
2238 Otherwise, the caddr of the list (if there is one) is processed.\n\
2239 For a list whose car is a string or list, each element is processed\n\
2240 recursively and the results are effectively concatenated.\n\
2241 For a list whose car is an integer, the cdr of the list is processed\n\
2242 and padded (if the number is positive) or truncated (if negative)\n\
2243 to the width specified by that number.\n\
2244 A string is printed verbatim in the mode line except for %-constructs:\n\
2245 (%-constructs are allowed when the string is the entire mode-line-format\n\
2246 or when it is found in a cons-cell or a list)\n\
2247 %b -- print buffer name. %f -- print visited file name.\n\
2248 %* -- print *, % or hyphen. %m -- print value of mode-name (obsolete).\n\
2249 %s -- print process status. %l -- print the current line number.\n\
2250 %p -- print percent of buffer above top of window, or top, bot or all.\n\
2251 %n -- print Narrow if appropriate.\n\
2252 %[ -- print one [ for each recursive editing level. %] similar.\n\
2253 %% -- print %. %- -- print infinitely many dashes.\n\
2254 Decimal digits after the % specify field width to which to pad.");
2257 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2258 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2259 nil here means use current buffer's major mode.");
2261 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2262 make_number (Lisp_Symbol
),
2263 "Symbol for current buffer's major mode.");
2265 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2266 make_number (Lisp_String
),
2267 "Pretty name of current buffer's major mode (a string).");
2269 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2270 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2271 Automatically becomes buffer-local when set in any fashion.");
2273 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2275 "*Non-nil if searches should ignore case.\n\
2276 Automatically becomes buffer-local when set in any fashion.");
2278 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2279 make_number (Lisp_Int
),
2280 "*Column beyond which automatic line-wrapping should happen.\n\
2281 Automatically becomes buffer-local when set in any fashion.");
2283 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2284 make_number (Lisp_Int
),
2285 "*Column for the default indent-line-function to indent to.\n\
2286 Linefeed indents to this column in Fundamental mode.\n\
2287 Automatically becomes buffer-local when set in any fashion.");
2289 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2290 make_number (Lisp_Int
),
2291 "*Distance between tab stops (for display of tab characters), in columns.\n\
2292 Automatically becomes buffer-local when set in any fashion.");
2294 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2295 "*Non-nil means display control chars with uparrow.\n\
2296 Nil means use backslash and octal digits.\n\
2297 Automatically becomes buffer-local when set in any fashion.\n\
2298 This variable does not apply to characters whose display is specified\n\
2299 in the current display table (if there is one).");
2301 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2302 "*Non-nil means do not display continuation lines;\n\
2303 give each line of text one screen line.\n\
2304 Automatically becomes buffer-local when set in any fashion.\n\
2306 Note that this is overridden by the variable\n\
2307 `truncate-partial-width-windows' if that variable is non-nil\n\
2308 and this buffer is not full-frame width.");
2310 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2311 make_number (Lisp_String
),
2312 "Name of default directory of current buffer. Should end with slash.\n\
2313 Each buffer has its own value of this variable.");
2315 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2317 "Function called (if non-nil) to perform auto-fill.\n\
2318 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2319 Each buffer has its own value of this variable.\n\
2320 NOTE: This variable is not an ordinary hook;\n\
2321 It may not be a list of functions.");
2323 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2324 make_number (Lisp_String
),
2325 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2326 Each buffer has its own value of this variable.");
2328 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2329 ¤t_buffer
->auto_save_file_name
,
2330 make_number (Lisp_String
),
2331 "Name of file for auto-saving current buffer,\n\
2332 or nil if buffer should not be auto-saved.\n\
2333 Each buffer has its own value of this variable.");
2335 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2336 "Non-nil if this buffer is read-only.\n\
2337 Each buffer has its own value of this variable.");
2339 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2340 "Non-nil if this buffer's file has been backed up.\n\
2341 Backing up is done before the first time the file is saved.\n\
2342 Each buffer has its own value of this variable.");
2344 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2345 make_number (Lisp_Int
),
2346 "Length of current buffer when last read in, saved or auto-saved.\n\
2348 Each buffer has its own value of this variable.");
2350 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2352 "Non-nil enables selective display:\n\
2353 Integer N as value means display only lines\n\
2354 that start with less than n columns of space.\n\
2355 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2356 Then ^M's in the file are written into files as newlines.\n\n\
2357 Automatically becomes buffer-local when set in any fashion.");
2360 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2361 ¤t_buffer
->selective_display_ellipses
,
2363 "t means display ... on previous line when a line is invisible.\n\
2364 Automatically becomes buffer-local when set in any fashion.");
2367 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2368 "Non-nil if self-insertion should replace existing text.\n\
2369 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2370 inserts at the end of a line, and inserts when point is before a tab,\n\
2371 until the tab is filled in.\n\
2372 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2373 Automatically becomes buffer-local when set in any fashion.");
2375 #if 0 /* The doc string is too long for some compilers,
2376 but make-docfile can find it in this comment. */
2377 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2379 "Display table that controls display of the contents of current buffer.\n\
2380 Automatically becomes buffer-local when set in any fashion.\n\
2381 The display table is a vector created with `make-display-table'.\n\
2382 The first 256 elements control how to display each possible text character.\n\
2383 Each value should be a vector of characters or nil;\n\
2384 nil means display the character in the default fashion.\n\
2385 The remaining five elements control the display of\n\
2386 the end of a truncated screen line (element 256, a single character);\n\
2387 the end of a continued line (element 257, a single character);\n\
2388 the escape character used to display character codes in octal\n\
2389 (element 258, a single character);\n\
2390 the character used as an arrow for control characters (element 259,\n\
2391 a single character);\n\
2392 the decoration indicating the presence of invisible lines (element 260,\n\
2393 a vector of characters).\n\
2394 If this variable is nil, the value of `standard-display-table' is used.\n\
2395 Each window can have its own, overriding display table.");
2397 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2400 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2403 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2404 "Function to call before each text change.\n\
2405 Two arguments are passed to the function: the positions of\n\
2406 the beginning and end of the range of old text to be changed.\n\
2407 \(For an insertion, the beginning and end are at the same place.)\n\
2408 No information is given about the length of the text after the change.\n\
2409 position of the change\n\
2411 While executing the `before-change-function', changes to buffers do not\n\
2412 cause calls to any `before-change-function' or `after-change-function'.");
2413 Vbefore_change_function
= Qnil
;
2415 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2416 "Function to call after each text change.\n\
2417 Three arguments are passed to the function: the positions of\n\
2418 the beginning and end of the range of changed text,\n\
2419 and the length of the pre-change text replaced by that range.\n\
2420 \(For an insertion, the pre-change length is zero;\n\
2421 for a deletion, that length is the number of characters deleted,\n\
2422 and the post-change beginning and end are at the same place.)\n\
2424 While executing the `after-change-function', changes to buffers do not\n\
2425 cause calls to any `before-change-function' or `after-change-function'.");
2426 Vafter_change_function
= Qnil
;
2428 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2429 "A list of functions to call before changing a buffer which is unmodified.\n\
2430 The functions are run using the `run-hooks' function.");
2431 Vfirst_change_hook
= Qnil
;
2432 Qfirst_change_hook
= intern ("first-change-hook");
2433 staticpro (&Qfirst_change_hook
);
2435 #if 0 /* The doc string is too long for some compilers,
2436 but make-docfile can find it in this comment. */
2437 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2438 "List of undo entries in current buffer.\n\
2439 Recent changes come first; older changes follow newer.\n\
2441 An entry (START . END) represents an insertion which begins at\n\
2442 position START and ends at position END.\n\
2444 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2445 from (abs POSITION). If POSITION is positive, point was at the front\n\
2446 of the text being deleted; if negative, point was at the end.\n\
2448 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2449 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
2450 16-bit words of the buffer's modification count at the time. If the\n\
2451 modification count of the most recent save is different, this entry is\n\
2454 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2455 was modified between BEG and END. PROP is the property name,\n\
2456 and VAL is the old value.\n\
2458 An entry of the form POSITION indicates that point was at the buffer\n\
2459 location given by the integer. Undoing an entry of this form places\n\
2460 point at POSITION.\n\
2462 nil marks undo boundaries. The undo command treats the changes\n\
2463 between two undo boundaries as a single step to be undone.\n\
2465 If the value of the variable is t, undo information is not recorded.");
2467 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2470 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
2471 "Non-nil means the mark and region are currently active in this buffer.\n\
2472 Automatically local in all buffers.");
2474 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
2475 "*Non-nil means deactivate the mark when the buffer contents change.");
2476 Vtransient_mark_mode
= Qnil
;
2478 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
2479 "*Non-nil means disregard read-only status of buffers or characters.\n\
2480 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
2481 text properties. If the value is a list, disregard `buffer-read-only'\n\
2482 and disregard a `read-only' text property if the property value\n\
2483 is a member of the list.");
2484 Vinhibit_read_only
= Qnil
;
2486 defsubr (&Sbuffer_list
);
2487 defsubr (&Sget_buffer
);
2488 defsubr (&Sget_file_buffer
);
2489 defsubr (&Sget_buffer_create
);
2490 defsubr (&Sgenerate_new_buffer_name
);
2491 defsubr (&Sbuffer_name
);
2492 /*defsubr (&Sbuffer_number);*/
2493 defsubr (&Sbuffer_file_name
);
2494 defsubr (&Sbuffer_local_variables
);
2495 defsubr (&Sbuffer_modified_p
);
2496 defsubr (&Sset_buffer_modified_p
);
2497 defsubr (&Sbuffer_modified_tick
);
2498 defsubr (&Srename_buffer
);
2499 defsubr (&Sother_buffer
);
2500 defsubr (&Sbuffer_disable_undo
);
2501 defsubr (&Sbuffer_enable_undo
);
2502 defsubr (&Skill_buffer
);
2503 defsubr (&Serase_buffer
);
2504 defsubr (&Sswitch_to_buffer
);
2505 defsubr (&Spop_to_buffer
);
2506 defsubr (&Scurrent_buffer
);
2507 defsubr (&Sset_buffer
);
2508 defsubr (&Sbarf_if_buffer_read_only
);
2509 defsubr (&Sbury_buffer
);
2510 defsubr (&Slist_buffers
);
2511 defsubr (&Skill_all_local_variables
);
2513 defsubr (&Soverlayp
);
2514 defsubr (&Smake_overlay
);
2515 defsubr (&Sdelete_overlay
);
2516 defsubr (&Smove_overlay
);
2517 defsubr (&Soverlay_start
);
2518 defsubr (&Soverlay_end
);
2519 defsubr (&Soverlay_buffer
);
2520 defsubr (&Soverlay_properties
);
2521 defsubr (&Soverlays_at
);
2522 defsubr (&Snext_overlay_change
);
2523 defsubr (&Soverlay_recenter
);
2524 defsubr (&Soverlay_lists
);
2525 defsubr (&Soverlay_get
);
2526 defsubr (&Soverlay_put
);
2531 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
2532 initial_define_key (control_x_map
, 'k', "kill-buffer");
2533 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");