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 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
564 the buffer automatically so you can create another with the original name.
565 It makes UNIQUE equivalent to
566 (rename-buffer (generate-new-buffer-name NAME)). */
567 if (NILP (unique
) && XBUFFER (tem
) == current_buffer
)
568 return current_buffer
->name
;
572 name
= Fgenerate_new_buffer_name (name
, current_buffer
->name
);
574 error ("Buffer name \"%s\" is in use", XSTRING (name
)->data
);
577 current_buffer
->name
= name
;
579 /* Catch redisplay's attention. Unless we do this, the mode lines for
580 any windows displaying current_buffer will stay unchanged. */
583 XSET (buf
, Lisp_Buffer
, current_buffer
);
584 Fsetcar (Frassq (buf
, Vbuffer_alist
), name
);
585 if (NILP (current_buffer
->filename
) && !NILP (current_buffer
->auto_save_file_name
))
586 call0 (intern ("rename-auto-save-file"));
590 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
591 "Return most recently selected buffer other than BUFFER.\n\
592 Buffers not visible in windows are preferred to visible buffers,\n\
593 unless optional second argument VISIBLE-OK is non-nil.\n\
594 If no other buffer exists, the buffer `*scratch*' is returned.\n\
595 If BUFFER is omitted or nil, some interesting buffer is returned.")
597 register Lisp_Object buffer
, visible_ok
;
599 register Lisp_Object tail
, buf
, notsogood
, tem
;
602 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
604 buf
= Fcdr (Fcar (tail
));
605 if (EQ (buf
, buffer
))
607 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
609 if (NILP (visible_ok
))
610 tem
= Fget_buffer_window (buf
, Qt
);
615 if (NILP (notsogood
))
618 if (!NILP (notsogood
))
620 return Fget_buffer_create (build_string ("*scratch*"));
623 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
, 0, 1,
625 "Make BUFFER stop keeping undo information.\n\
626 No argument or nil as argument means do this for the current buffer.")
628 register Lisp_Object buffer
;
630 Lisp_Object real_buffer
;
633 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
636 real_buffer
= Fget_buffer (buffer
);
637 if (NILP (real_buffer
))
641 XBUFFER (real_buffer
)->undo_list
= Qt
;
646 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
648 "Start keeping undo information for buffer BUFFER.\n\
649 No argument or nil as argument means do this for the current buffer.")
651 register Lisp_Object buffer
;
653 Lisp_Object real_buffer
;
656 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
659 real_buffer
= Fget_buffer (buffer
);
660 if (NILP (real_buffer
))
664 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
665 XBUFFER (real_buffer
)->undo_list
= Qnil
;
671 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
672 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
673 The buffer being killed will be current while the hook is running.\n\
676 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
677 "Kill the buffer BUFFER.\n\
678 The argument may be a buffer or may be the name of a buffer.\n\
679 An argument of nil means kill the current buffer.\n\n\
680 Value is t if the buffer is actually killed, nil if user says no.\n\n\
681 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
682 if not void, is a list of functions to be called, with no arguments,\n\
683 before the buffer is actually killed. The buffer to be killed is current\n\
684 when the hook functions are called.\n\n\
685 Any processes that have this buffer as the `process-buffer' are killed\n\
686 with `delete-process'.")
691 register struct buffer
*b
;
692 register Lisp_Object tem
;
693 register struct Lisp_Marker
*m
;
694 struct gcpro gcpro1
, gcpro2
;
697 buf
= Fcurrent_buffer ();
699 buf
= Fget_buffer (bufname
);
705 /* Query if the buffer is still modified. */
706 if (INTERACTIVE
&& !NILP (b
->filename
)
707 && BUF_MODIFF (b
) > b
->save_modified
)
709 GCPRO2 (buf
, bufname
);
710 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
711 XSTRING (b
->name
)->data
));
717 /* Run kill-buffer hook with the buffer to be killed the current buffer. */
719 register Lisp_Object val
;
720 int count
= specpdl_ptr
- specpdl
;
722 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
723 set_buffer_internal (b
);
724 call1 (Vrun_hooks
, Qkill_buffer_hook
);
725 unbind_to (count
, Qnil
);
728 /* We have no more questions to ask. Verify that it is valid
729 to kill the buffer. This must be done after the questions
730 since anything can happen within do_yes_or_no_p. */
732 /* Don't kill the minibuffer now current. */
733 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
739 /* Make this buffer not be current.
740 In the process, notice if this is the sole visible buffer
741 and give up if so. */
742 if (b
== current_buffer
)
744 tem
= Fother_buffer (buf
, Qnil
);
746 if (b
== current_buffer
)
750 /* Now there is no question: we can kill the buffer. */
752 #ifdef CLASH_DETECTION
753 /* Unlock this buffer's file, if it is locked. */
755 #endif /* CLASH_DETECTION */
757 kill_buffer_processes (buf
);
761 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
762 Freplace_buffer_in_windows (buf
);
765 /* Delete any auto-save file. */
766 if (XTYPE (b
->auto_save_file_name
) == Lisp_String
)
769 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
771 unlink (XSTRING (b
->auto_save_file_name
)->data
);
774 /* Unchain all markers of this buffer
775 and leave them pointing nowhere. */
776 for (tem
= b
->markers
; !EQ (tem
, Qnil
); )
785 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
786 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
787 /* Perhaps we should explicitly free the interval tree here... */
791 BUFFER_FREE (BUF_BEG_ADDR (b
));
798 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
799 we do this each time BUF is selected visibly, the more recently
800 selected buffers are always closer to the front of the list. This
801 means that other_buffer is more likely to choose a relevant buffer. */
806 register Lisp_Object link
, prev
;
809 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
811 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
816 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
817 we cannot use Fdelq itself here because it allows quitting. */
820 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
822 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
824 XCONS(link
)->cdr
= Vbuffer_alist
;
825 Vbuffer_alist
= link
;
828 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
829 "Select buffer BUFFER in the current window.\n\
830 BUFFER may be a buffer or a buffer name.\n\
831 Optional second arg NORECORD non-nil means\n\
832 do not put this buffer at the front of the list of recently selected ones.\n\
834 WARNING: This is NOT the way to work on another buffer temporarily\n\
835 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
836 the window-buffer correspondences.")
838 Lisp_Object bufname
, norecord
;
840 register Lisp_Object buf
;
843 if (EQ (minibuf_window
, selected_window
))
844 error ("Cannot switch buffers in minibuffer window");
845 tem
= Fwindow_dedicated_p (selected_window
);
847 error ("Cannot switch buffers in a dedicated window");
850 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
852 buf
= Fget_buffer_create (bufname
);
857 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
858 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
865 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
866 "Select buffer BUFFER in some window, preferably a different one.\n\
867 If BUFFER is nil, then some other buffer is chosen.\n\
868 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
869 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
870 window even if BUFFER is already visible in the selected window.")
872 Lisp_Object bufname
, other
;
874 register Lisp_Object buf
;
876 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
878 buf
= Fget_buffer_create (bufname
);
881 Fselect_window (Fdisplay_buffer (buf
, other
));
885 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
886 "Return the current buffer as a Lisp object.")
889 register Lisp_Object buf
;
890 XSET (buf
, Lisp_Buffer
, current_buffer
);
894 /* Set the current buffer to b */
897 set_buffer_internal (b
)
898 register struct buffer
*b
;
900 register struct buffer
*old_buf
;
901 register Lisp_Object tail
, valcontents
;
904 if (current_buffer
== b
)
907 windows_or_buffers_changed
= 1;
908 old_buf
= current_buffer
;
910 last_known_column_point
= -1; /* invalidate indentation cache */
912 /* Look down buffer's list of local Lisp variables
913 to find and update any that forward into C variables. */
915 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
917 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
918 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
919 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
920 && (tem
= XTYPE (XCONS (valcontents
)->car
),
921 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
922 || tem
== Lisp_Objfwd
)))
923 /* Just reference the variable
924 to cause it to become set for this buffer. */
925 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
928 /* Do the same with any others that were local to the previous buffer */
931 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
933 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
934 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
935 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
936 && (tem
= XTYPE (XCONS (valcontents
)->car
),
937 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
938 || tem
== Lisp_Objfwd
)))
939 /* Just reference the variable
940 to cause it to become set for this buffer. */
941 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
945 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
946 "Make the buffer BUFFER current for editing operations.\n\
947 BUFFER may be a buffer or the name of an existing buffer.\n\
948 See also `save-excursion' when you want to make a buffer current temporarily.\n\
949 This function does not display the buffer, so its effect ends\n\
950 when the current command terminates.\n\
951 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
953 register Lisp_Object bufname
;
955 register Lisp_Object buffer
;
956 buffer
= Fget_buffer (bufname
);
959 if (NILP (XBUFFER (buffer
)->name
))
960 error ("Selecting deleted buffer");
961 set_buffer_internal (XBUFFER (buffer
));
965 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
966 Sbarf_if_buffer_read_only
, 0, 0, 0,
967 "Signal a `buffer-read-only' error if the current buffer is read-only.")
970 if (!NILP (current_buffer
->read_only
)
971 && NILP (Vinhibit_read_only
))
972 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
976 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
977 "Put BUFFER at the end of the list of all buffers.\n\
978 There it is the least likely candidate for `other-buffer' to return;\n\
979 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
980 If BUFFER is nil or omitted, bury the current buffer.\n\
981 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
982 selected window if it is displayed there.")
984 register Lisp_Object buf
;
986 /* Figure out what buffer we're going to bury. */
989 XSET (buf
, Lisp_Buffer
, current_buffer
);
991 /* If we're burying the current buffer, unshow it. */
992 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
998 buf1
= Fget_buffer (buf
);
1004 /* Move buf to the end of the buffer list. */
1006 register Lisp_Object aelt
, link
;
1008 aelt
= Frassq (buf
, Vbuffer_alist
);
1009 link
= Fmemq (aelt
, Vbuffer_alist
);
1010 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1011 XCONS (link
)->cdr
= Qnil
;
1012 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1018 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1019 "Delete the entire contents of the current buffer.\n\
1020 Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1021 so the buffer is truly empty after this.")
1026 current_buffer
->last_window_start
= 1;
1027 /* Prevent warnings, or suspension of auto saving, that would happen
1028 if future size is less than past size. Use of erase-buffer
1029 implies that the future text is not really related to the past text. */
1030 XFASTINT (current_buffer
->save_length
) = 0;
1034 validate_region (b
, e
)
1035 register Lisp_Object
*b
, *e
;
1039 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1040 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1042 if (XINT (*b
) > XINT (*e
))
1044 i
= XFASTINT (*b
); /* This is legit even if *b is < 0 */
1046 XFASTINT (*e
) = i
; /* because this is all we do with i. */
1049 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1050 && XINT (*e
) <= ZV
))
1051 args_out_of_range (*b
, *e
);
1055 list_buffers_1 (files
)
1058 register Lisp_Object tail
, tem
, buf
;
1059 Lisp_Object col1
, col2
, col3
, minspace
;
1060 register struct buffer
*old
= current_buffer
, *b
;
1061 Lisp_Object desired_point
;
1062 Lisp_Object other_file_symbol
;
1064 desired_point
= Qnil
;
1065 other_file_symbol
= intern ("list-buffers-directory");
1067 XFASTINT (col1
) = 19;
1068 XFASTINT (col2
) = 25;
1069 XFASTINT (col3
) = 40;
1070 XFASTINT (minspace
) = 1;
1072 Fset_buffer (Vstandard_output
);
1074 tail
= intern ("Buffer-menu-mode");
1075 if (!EQ (tail
, current_buffer
->major_mode
)
1076 && (tem
= Ffboundp (tail
), !NILP (tem
)))
1078 Fbuffer_disable_undo (Vstandard_output
);
1079 current_buffer
->read_only
= Qnil
;
1082 MR Buffer Size Mode File\n\
1083 -- ------ ---- ---- ----\n", -1);
1085 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
1087 buf
= Fcdr (Fcar (tail
));
1089 /* Don't mention the minibuffers. */
1090 if (XSTRING (b
->name
)->data
[0] == ' ')
1092 /* Optionally don't mention buffers that lack files. */
1093 if (!NILP (files
) && NILP (b
->filename
))
1095 /* Identify the current buffer. */
1097 XFASTINT (desired_point
) = point
;
1098 write_string (b
== old
? "." : " ", -1);
1099 /* Identify modified buffers */
1100 write_string (BUF_MODIFF (b
) > b
->save_modified
? "*" : " ", -1);
1101 write_string (NILP (b
->read_only
) ? " " : "% ", -1);
1102 Fprinc (b
->name
, Qnil
);
1103 Findent_to (col1
, make_number (2));
1104 XFASTINT (tem
) = BUF_Z (b
) - BUF_BEG (b
);
1106 Findent_to (col2
, minspace
);
1107 Fprinc (b
->mode_name
, Qnil
);
1108 Findent_to (col3
, minspace
);
1110 if (!NILP (b
->filename
))
1111 Fprinc (b
->filename
, Qnil
);
1114 /* No visited file; check local value of list-buffers-directory. */
1116 set_buffer_internal (b
);
1117 tem
= Fboundp (other_file_symbol
);
1120 tem
= Fsymbol_value (other_file_symbol
);
1121 Fset_buffer (Vstandard_output
);
1122 if (XTYPE (tem
) == Lisp_String
)
1126 Fset_buffer (Vstandard_output
);
1128 write_string ("\n", -1);
1131 current_buffer
->read_only
= Qt
;
1132 set_buffer_internal (old
);
1133 return desired_point
;
1136 DEFUN ("list-buffers", Flist_buffers
, Slist_buffers
, 0, 1, "P",
1137 "Display a list of names of existing buffers.\n\
1138 The list is displayed in a buffer named `*Buffer List*'.\n\
1139 Note that buffers with names starting with spaces are omitted.\n\
1140 Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1142 The M column contains a * for buffers that are modified.\n\
1143 The R column contains a % for buffers that are read-only.")
1147 Lisp_Object desired_point
;
1150 = internal_with_output_to_temp_buffer ("*Buffer List*",
1151 list_buffers_1
, files
);
1153 if (NUMBERP (desired_point
))
1155 int count
= specpdl_ptr
- specpdl
;
1156 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
1157 Fset_buffer (build_string ("*Buffer List*"));
1158 SET_PT (XINT (desired_point
));
1159 return unbind_to (count
, Qnil
);
1164 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1166 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1167 Most local variable bindings are eliminated so that the default values\n\
1168 become effective once more. Also, the syntax table is set from\n\
1169 `standard-syntax-table', the local keymap is set to nil,\n\
1170 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1171 This function also forces redisplay of the mode line.\n\
1173 Every function to select a new major mode starts by\n\
1174 calling this function.\n\n\
1175 As a special exception, local variables whose names have\n\
1176 a non-nil `permanent-local' property are not eliminated by this function.")
1179 register Lisp_Object alist
, sym
, tem
;
1181 oalist
= current_buffer
->local_var_alist
;
1183 /* Make sure no local variables remain set up with this buffer
1184 for their current values. */
1186 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1188 sym
= XCONS (XCONS (alist
)->car
)->car
;
1190 /* Need not do anything if some other buffer's binding is now encached. */
1191 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
;
1192 if (XBUFFER (tem
) == current_buffer
)
1194 /* Symbol is set up for this buffer's old local value.
1195 Set it up for the current buffer with the default value. */
1197 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1198 /* Store the symbol's current value into the alist entry
1199 it is currently set up for. This is so that, if the
1200 local is marked permanent, and we make it local again below,
1201 we don't lose the value. */
1202 XCONS (XCONS (tem
)->car
)->cdr
= XCONS (XSYMBOL (sym
)->value
)->car
;
1203 /* Switch to the symbol's default-value alist entry. */
1204 XCONS (tem
)->car
= tem
;
1205 /* Mark it as current for the current buffer. */
1206 XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
= Fcurrent_buffer ();
1207 /* Store the current value into any forwarding in the symbol. */
1208 store_symval_forwarding (sym
, XCONS (XSYMBOL (sym
)->value
)->car
,
1213 /* Actually eliminate all local bindings of this buffer. */
1215 reset_buffer_local_variables (current_buffer
);
1217 /* Redisplay mode lines; we are changing major mode. */
1219 update_mode_lines
++;
1221 /* Any which are supposed to be permanent,
1222 make local again, with the same values they had. */
1224 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1226 sym
= XCONS (XCONS (alist
)->car
)->car
;
1227 tem
= Fget (sym
, Qpermanent_local
);
1230 Fmake_local_variable (sym
);
1231 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1235 /* Force mode-line redisplay. Useful here because all major mode
1236 commands call this function. */
1237 update_mode_lines
++;
1242 /* Find all the overlays in the current buffer that contain position POS.
1243 Return the number found, and store them in a vector in *VEC_PTR.
1244 Store in *LEN_PTR the size allocated for the vector.
1245 Store in *NEXT_PTR the next position after POS where an overlay starts,
1246 or ZV if there are no more overlays.
1248 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1249 when this function is called.
1251 If EXTEND is non-zero, we make the vector bigger if necessary.
1252 If EXTEND is zero, we never extend the vector,
1253 and we store only as many overlays as will fit.
1254 But we still return the total number of overlays. */
1257 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
)
1260 Lisp_Object
**vec_ptr
;
1264 Lisp_Object tail
, overlay
, start
, end
, result
;
1267 Lisp_Object
*vec
= *vec_ptr
;
1269 int inhibit_storing
= 0;
1271 for (tail
= current_buffer
->overlays_before
;
1273 tail
= XCONS (tail
)->cdr
)
1277 overlay
= XCONS (tail
)->car
;
1278 if (! OVERLAY_VALID (overlay
))
1281 start
= OVERLAY_START (overlay
);
1282 end
= OVERLAY_END (overlay
);
1283 if (OVERLAY_POSITION (end
) <= pos
)
1285 startpos
= OVERLAY_POSITION (start
);
1286 if (startpos
<= pos
)
1290 /* The supplied vector is full.
1291 Either make it bigger, or don't store any more in it. */
1294 *len_ptr
= len
*= 2;
1295 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1299 inhibit_storing
= 1;
1302 if (!inhibit_storing
)
1304 /* Keep counting overlays even if we can't return them all. */
1307 else if (startpos
< next
)
1311 for (tail
= current_buffer
->overlays_after
;
1313 tail
= XCONS (tail
)->cdr
)
1317 overlay
= XCONS (tail
)->car
;
1318 if (! OVERLAY_VALID (overlay
))
1321 start
= OVERLAY_START (overlay
);
1322 end
= OVERLAY_END (overlay
);
1323 startpos
= OVERLAY_POSITION (start
);
1326 if (startpos
< next
)
1330 if (pos
< OVERLAY_POSITION (end
))
1336 *len_ptr
= len
*= 2;
1337 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1341 inhibit_storing
= 1;
1344 if (!inhibit_storing
)
1354 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1357 recenter_overlay_lists (buf
, pos
)
1361 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1363 /* See if anything in overlays_before should move to overlays_after. */
1365 /* We don't strictly need prev in this loop; it should always be nil.
1366 But we use it for symmetry and in case that should cease to be true
1367 with some future change. */
1369 for (tail
= buf
->overlays_before
;
1371 prev
= tail
, tail
= next
)
1373 next
= XCONS (tail
)->cdr
;
1374 overlay
= XCONS (tail
)->car
;
1376 /* If the overlay is not valid, get rid of it. */
1377 if (!OVERLAY_VALID (overlay
))
1382 /* Splice the cons cell TAIL out of overlays_before. */
1384 XCONS (prev
)->cdr
= next
;
1386 buf
->overlays_before
= next
;
1392 beg
= OVERLAY_START (overlay
);
1393 end
= OVERLAY_END (overlay
);
1395 if (OVERLAY_POSITION (end
) > pos
)
1397 /* OVERLAY needs to be moved. */
1398 int where
= OVERLAY_POSITION (beg
);
1399 Lisp_Object other
, other_prev
;
1401 /* Splice the cons cell TAIL out of overlays_before. */
1403 XCONS (prev
)->cdr
= next
;
1405 buf
->overlays_before
= next
;
1407 /* Search thru overlays_after for where to put it. */
1409 for (other
= buf
->overlays_after
;
1411 other_prev
= other
, other
= XCONS (other
)->cdr
)
1413 Lisp_Object otherbeg
, otheroverlay
, follower
;
1416 otheroverlay
= XCONS (other
)->car
;
1417 if (! OVERLAY_VALID (otheroverlay
))
1420 otherbeg
= OVERLAY_START (otheroverlay
);
1421 if (OVERLAY_POSITION (otherbeg
) >= where
)
1425 /* Add TAIL to overlays_after before OTHER. */
1426 XCONS (tail
)->cdr
= other
;
1427 if (!NILP (other_prev
))
1428 XCONS (other_prev
)->cdr
= tail
;
1430 buf
->overlays_after
= tail
;
1434 /* We've reached the things that should stay in overlays_before.
1435 All the rest of overlays_before must end even earlier,
1440 /* See if anything in overlays_after should be in overlays_before. */
1442 for (tail
= buf
->overlays_after
;
1444 prev
= tail
, tail
= next
)
1446 next
= XCONS (tail
)->cdr
;
1447 overlay
= XCONS (tail
)->car
;
1449 /* If the overlay is not valid, get rid of it. */
1450 if (!OVERLAY_VALID (overlay
))
1455 /* Splice the cons cell TAIL out of overlays_after. */
1457 XCONS (prev
)->cdr
= next
;
1459 buf
->overlays_after
= next
;
1465 beg
= OVERLAY_START (overlay
);
1466 end
= OVERLAY_END (overlay
);
1468 /* Stop looking, when we know that nothing further
1469 can possibly end before POS. */
1470 if (OVERLAY_POSITION (beg
) > pos
)
1473 if (OVERLAY_POSITION (end
) <= pos
)
1475 /* OVERLAY needs to be moved. */
1476 int where
= OVERLAY_POSITION (end
);
1477 Lisp_Object other
, other_prev
;
1479 /* Splice the cons cell TAIL out of overlays_after. */
1481 XCONS (prev
)->cdr
= next
;
1483 buf
->overlays_after
= next
;
1485 /* Search thru overlays_before for where to put it. */
1487 for (other
= buf
->overlays_before
;
1489 other_prev
= other
, other
= XCONS (other
)->cdr
)
1491 Lisp_Object otherend
, otheroverlay
;
1494 otheroverlay
= XCONS (other
)->car
;
1495 if (! OVERLAY_VALID (otheroverlay
))
1498 otherend
= OVERLAY_END (otheroverlay
);
1499 if (OVERLAY_POSITION (otherend
) <= where
)
1503 /* Add TAIL to overlays_before before OTHER. */
1504 XCONS (tail
)->cdr
= other
;
1505 if (!NILP (other_prev
))
1506 XCONS (other_prev
)->cdr
= tail
;
1508 buf
->overlays_before
= tail
;
1513 XFASTINT (buf
->overlay_center
) = pos
;
1516 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1517 "Return t if OBJECT is an overlay.")
1521 return (OVERLAYP (object
) ? Qt
: Qnil
);
1524 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1525 "Create a new overlay with range BEG to END in BUFFER.\n\
1526 If omitted, BUFFER defaults to the current buffer.\n\
1527 BEG and END may be integers or markers.")
1529 Lisp_Object beg
, end
, buffer
;
1531 Lisp_Object overlay
;
1535 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1537 CHECK_BUFFER (buffer
, 2);
1539 && ! EQ (Fmarker_buffer (beg
), buffer
))
1540 error ("Marker points into wrong buffer");
1542 && ! EQ (Fmarker_buffer (end
), buffer
))
1543 error ("Marker points into wrong buffer");
1545 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1546 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1548 if (XINT (beg
) > XINT (end
))
1550 Lisp_Object temp
= beg
;
1551 beg
= end
; end
= temp
;
1554 b
= XBUFFER (buffer
);
1556 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1557 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1559 overlay
= Fcons (Fcons (beg
, end
), Qnil
);
1560 XSETTYPE (overlay
, Lisp_Overlay
);
1562 /* Put the new overlay on the wrong list. */
1563 end
= OVERLAY_END (overlay
);
1564 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1565 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1567 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1569 /* This puts it in the right list, and in the right order. */
1570 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1572 /* We don't need to redisplay the region covered by the overlay, because
1573 the overlay has no properties at the moment. */
1578 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
1579 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1580 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1581 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1583 (overlay
, beg
, end
, buffer
)
1584 Lisp_Object overlay
, beg
, end
, buffer
;
1586 struct buffer
*b
, *ob
;
1587 Lisp_Object obuffer
;
1588 int count
= specpdl_ptr
- specpdl
;
1590 CHECK_OVERLAY (overlay
, 0);
1592 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1594 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1595 CHECK_BUFFER (buffer
, 3);
1598 && ! EQ (Fmarker_buffer (beg
), buffer
))
1599 error ("Marker points into wrong buffer");
1601 && ! EQ (Fmarker_buffer (end
), buffer
))
1602 error ("Marker points into wrong buffer");
1604 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1605 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1607 specbind (Qinhibit_quit
, Qt
);
1609 if (XINT (beg
) > XINT (end
))
1611 Lisp_Object temp
= beg
;
1612 beg
= end
; end
= temp
;
1615 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1616 b
= XBUFFER (buffer
);
1617 ob
= XBUFFER (obuffer
);
1619 /* If the overlay has changed buffers, do a thorough redisplay. */
1620 if (!EQ (buffer
, obuffer
))
1621 windows_or_buffers_changed
= 1;
1623 /* Redisplay the area the overlay has just left, or just enclosed. */
1627 int change_beg
, change_end
;
1629 o_beg
= OVERLAY_START (overlay
);
1630 o_end
= OVERLAY_END (overlay
);
1631 o_beg
= OVERLAY_POSITION (o_beg
);
1632 o_end
= OVERLAY_POSITION (o_end
);
1634 if (XINT (o_beg
) == XINT (beg
))
1635 redisplay_region (b
, XINT (o_end
), XINT (end
));
1636 else if (XINT (o_end
) == XINT (end
))
1637 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
1640 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
1641 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
1642 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
1646 if (!NILP (obuffer
))
1648 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
1649 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
1652 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
1653 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
1655 /* Put the overlay on the wrong list. */
1656 end
= OVERLAY_END (overlay
);
1657 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1658 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1660 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1662 /* This puts it in the right list, and in the right order. */
1663 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1665 return unbind_to (count
, overlay
);
1668 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
1669 "Delete the overlay OVERLAY from its buffer.")
1671 Lisp_Object overlay
;
1675 int count
= specpdl_ptr
- specpdl
;
1677 CHECK_OVERLAY (overlay
, 0);
1679 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1683 b
= XBUFFER (buffer
);
1685 specbind (Qinhibit_quit
, Qt
);
1687 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
1688 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
1690 redisplay_region (b
,
1691 marker_position (OVERLAY_START (overlay
)),
1692 marker_position (OVERLAY_END (overlay
)));
1694 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
1695 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
1697 return unbind_to (count
, Qnil
);
1700 /* Overlay dissection functions. */
1702 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
1703 "Return the position at which OVERLAY starts.")
1705 Lisp_Object overlay
;
1707 CHECK_OVERLAY (overlay
, 0);
1709 return (Fmarker_position (OVERLAY_START (overlay
)));
1712 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
1713 "Return the position at which OVERLAY ends.")
1715 Lisp_Object overlay
;
1717 CHECK_OVERLAY (overlay
, 0);
1719 return (Fmarker_position (OVERLAY_END (overlay
)));
1722 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
1723 "Return the buffer OVERLAY belongs to.")
1725 Lisp_Object overlay
;
1727 CHECK_OVERLAY (overlay
, 0);
1729 return Fmarker_buffer (OVERLAY_START (overlay
));
1732 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
1733 "Return a list of the properties on OVERLAY.\n\
1734 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
1737 Lisp_Object overlay
;
1739 CHECK_OVERLAY (overlay
, 0);
1741 return Fcopy_sequence (Fcdr_safe (XCONS (overlay
)->cdr
));
1745 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
1746 "Return a list of the overlays that contain position POS.")
1752 Lisp_Object
*overlay_vec
;
1756 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1759 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1761 /* Put all the overlays we want in a vector in overlay_vec.
1762 Store the length in len. */
1763 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1765 /* Make a list of them all. */
1766 result
= Flist (noverlays
, overlay_vec
);
1768 xfree (overlay_vec
);
1772 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
1774 "Return the next position after POS where an overlay starts or ends.")
1780 Lisp_Object
*overlay_vec
;
1785 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1788 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1790 /* Put all the overlays we want in a vector in overlay_vec.
1791 Store the length in len.
1792 endpos gets the position where the next overlay starts. */
1793 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1795 /* If any of these overlays ends before endpos,
1796 use its ending point instead. */
1797 for (i
= 0; i
< noverlays
; i
++)
1802 oend
= OVERLAY_END (overlay_vec
[i
]);
1803 oendpos
= OVERLAY_POSITION (oend
);
1804 if (oendpos
< endpos
)
1808 xfree (overlay_vec
);
1809 return make_number (endpos
);
1812 /* These functions are for debugging overlays. */
1814 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
1815 "Return a pair of lists giving all the overlays of the current buffer.\n\
1816 The car has all the overlays before the overlay center;\n\
1817 the cdr has all the overlays before the overlay center.\n\
1818 Recentering overlays moves overlays between these lists.\n\
1819 The lists you get are copies, so that changing them has no effect.\n\
1820 However, the overlays you get are the real objects that the buffer uses.")
1823 Lisp_Object before
, after
;
1824 before
= current_buffer
->overlays_before
;
1826 before
= Fcopy_sequence (before
);
1827 after
= current_buffer
->overlays_after
;
1829 after
= Fcopy_sequence (after
);
1831 return Fcons (before
, after
);
1834 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
1835 "Recenter the overlays of the current buffer around position POS.")
1839 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1841 recenter_overlay_lists (current_buffer
, XINT (pos
));
1845 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
1846 "Get the property of overlay OVERLAY with property name NAME.")
1848 Lisp_Object overlay
, prop
;
1852 CHECK_OVERLAY (overlay
, 0);
1854 for (plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1855 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
1856 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
1858 if (EQ (XCONS (plist
)->car
, prop
))
1859 return XCONS (XCONS (plist
)->cdr
)->car
;
1865 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
1866 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
1867 (overlay
, prop
, value
)
1868 Lisp_Object overlay
, prop
, value
;
1870 Lisp_Object plist
, tail
;
1872 CHECK_OVERLAY (overlay
, 0);
1874 tail
= Fmarker_buffer (OVERLAY_START (overlay
));
1876 redisplay_region (XMARKER (OVERLAY_START (overlay
))->buffer
,
1877 marker_position (OVERLAY_START (overlay
)),
1878 marker_position (OVERLAY_END (overlay
)));
1880 plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1883 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
1884 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
1886 if (EQ (XCONS (tail
)->car
, prop
))
1887 return XCONS (XCONS (tail
)->cdr
)->car
= value
;
1890 if (! CONSP (XCONS (overlay
)->cdr
))
1891 XCONS (overlay
)->cdr
= Fcons (Qnil
, Qnil
);
1893 XCONS (XCONS (overlay
)->cdr
)->cdr
1894 = Fcons (prop
, Fcons (value
, plist
));
1899 /* Run the modification-hooks of overlays that include
1900 any part of the text in START to END.
1901 Run the insert-before-hooks of overlay starting at END,
1902 and the insert-after-hooks of overlay ending at START. */
1905 verify_overlay_modification (start
, end
)
1906 Lisp_Object start
, end
;
1908 Lisp_Object prop
, overlay
, tail
;
1909 int insertion
= EQ (start
, end
);
1911 for (tail
= current_buffer
->overlays_before
;
1913 tail
= XCONS (tail
)->cdr
)
1915 int startpos
, endpos
;
1916 Lisp_Object ostart
, oend
;
1918 overlay
= XCONS (tail
)->car
;
1920 ostart
= OVERLAY_START (overlay
);
1921 oend
= OVERLAY_END (overlay
);
1922 endpos
= OVERLAY_POSITION (oend
);
1923 if (XFASTINT (start
) > endpos
)
1925 startpos
= OVERLAY_POSITION (ostart
);
1926 if (XFASTINT (end
) == startpos
&& insertion
)
1928 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1929 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1931 if (XFASTINT (start
) == endpos
&& insertion
)
1933 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1934 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1937 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1938 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1940 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1941 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1945 for (tail
= current_buffer
->overlays_after
;
1947 tail
= XCONS (tail
)->cdr
)
1949 int startpos
, endpos
;
1950 Lisp_Object ostart
, oend
;
1952 overlay
= XCONS (tail
)->car
;
1954 ostart
= OVERLAY_START (overlay
);
1955 oend
= OVERLAY_END (overlay
);
1956 startpos
= OVERLAY_POSITION (ostart
);
1957 endpos
= OVERLAY_POSITION (oend
);
1958 if (XFASTINT (end
) < startpos
)
1960 if (XFASTINT (end
) == startpos
&& insertion
)
1962 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1963 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1965 if (XFASTINT (start
) == endpos
&& insertion
)
1967 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1968 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1971 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1972 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1974 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1975 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1981 call_overlay_mod_hooks (list
, overlay
, start
, end
)
1982 Lisp_Object list
, overlay
, start
, end
;
1984 struct gcpro gcpro1
;
1986 while (!NILP (list
))
1988 call3 (Fcar (list
), overlay
, start
, end
);
1994 /* Somebody has tried to store NEWVAL into the buffer-local slot with
1995 offset XUINT (valcontents), and NEWVAL has an unacceptable type. */
1997 buffer_slot_type_mismatch (valcontents
, newval
)
1998 Lisp_Object valcontents
, newval
;
2000 unsigned int offset
= XUINT (valcontents
);
2001 unsigned char *symbol_name
=
2002 (XSYMBOL (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
))
2006 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
2008 case Lisp_Int
: type_name
= "integers"; break;
2009 case Lisp_String
: type_name
= "strings"; break;
2010 case Lisp_Marker
: type_name
= "markers"; break;
2011 case Lisp_Symbol
: type_name
= "symbols"; break;
2012 case Lisp_Cons
: type_name
= "lists"; break;
2013 case Lisp_Vector
: type_name
= "vectors"; break;
2018 error ("only %s should be stored in the buffer-local variable %s",
2019 type_name
, symbol_name
);
2024 register Lisp_Object tem
;
2026 /* Make sure all markable slots in buffer_defaults
2027 are initialized reasonably, so mark_buffer won't choke. */
2028 reset_buffer (&buffer_defaults
);
2029 reset_buffer (&buffer_local_symbols
);
2030 XSET (Vbuffer_defaults
, Lisp_Buffer
, &buffer_defaults
);
2031 XSET (Vbuffer_local_symbols
, Lisp_Buffer
, &buffer_local_symbols
);
2033 /* Set up the default values of various buffer slots. */
2034 /* Must do these before making the first buffer! */
2036 /* real setup is done in loaddefs.el */
2037 buffer_defaults
.mode_line_format
= build_string ("%-");
2038 buffer_defaults
.abbrev_mode
= Qnil
;
2039 buffer_defaults
.overwrite_mode
= Qnil
;
2040 buffer_defaults
.case_fold_search
= Qt
;
2041 buffer_defaults
.auto_fill_function
= Qnil
;
2042 buffer_defaults
.selective_display
= Qnil
;
2044 buffer_defaults
.selective_display_ellipses
= Qt
;
2046 buffer_defaults
.abbrev_table
= Qnil
;
2047 buffer_defaults
.display_table
= Qnil
;
2048 buffer_defaults
.undo_list
= Qnil
;
2049 buffer_defaults
.mark_active
= Qnil
;
2050 buffer_defaults
.overlays_before
= Qnil
;
2051 buffer_defaults
.overlays_after
= Qnil
;
2052 XFASTINT (buffer_defaults
.overlay_center
) = 1;
2054 XFASTINT (buffer_defaults
.tab_width
) = 8;
2055 buffer_defaults
.truncate_lines
= Qnil
;
2056 buffer_defaults
.ctl_arrow
= Qt
;
2058 XFASTINT (buffer_defaults
.fill_column
) = 70;
2059 XFASTINT (buffer_defaults
.left_margin
) = 0;
2061 /* Assign the local-flags to the slots that have default values.
2062 The local flag is a bit that is used in the buffer
2063 to say that it has its own local value for the slot.
2064 The local flag bits are in the local_var_flags slot of the buffer. */
2066 /* Nothing can work if this isn't true */
2067 if (sizeof (int) != sizeof (Lisp_Object
)) abort ();
2069 /* 0 means not a lisp var, -1 means always local, else mask */
2070 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2071 XFASTINT (buffer_local_flags
.filename
) = -1;
2072 XFASTINT (buffer_local_flags
.directory
) = -1;
2073 XFASTINT (buffer_local_flags
.backed_up
) = -1;
2074 XFASTINT (buffer_local_flags
.save_length
) = -1;
2075 XFASTINT (buffer_local_flags
.auto_save_file_name
) = -1;
2076 XFASTINT (buffer_local_flags
.read_only
) = -1;
2077 XFASTINT (buffer_local_flags
.major_mode
) = -1;
2078 XFASTINT (buffer_local_flags
.mode_name
) = -1;
2079 XFASTINT (buffer_local_flags
.undo_list
) = -1;
2080 XFASTINT (buffer_local_flags
.mark_active
) = -1;
2082 XFASTINT (buffer_local_flags
.mode_line_format
) = 1;
2083 XFASTINT (buffer_local_flags
.abbrev_mode
) = 2;
2084 XFASTINT (buffer_local_flags
.overwrite_mode
) = 4;
2085 XFASTINT (buffer_local_flags
.case_fold_search
) = 8;
2086 XFASTINT (buffer_local_flags
.auto_fill_function
) = 0x10;
2087 XFASTINT (buffer_local_flags
.selective_display
) = 0x20;
2089 XFASTINT (buffer_local_flags
.selective_display_ellipses
) = 0x40;
2091 XFASTINT (buffer_local_flags
.tab_width
) = 0x80;
2092 XFASTINT (buffer_local_flags
.truncate_lines
) = 0x100;
2093 XFASTINT (buffer_local_flags
.ctl_arrow
) = 0x200;
2094 XFASTINT (buffer_local_flags
.fill_column
) = 0x400;
2095 XFASTINT (buffer_local_flags
.left_margin
) = 0x800;
2096 XFASTINT (buffer_local_flags
.abbrev_table
) = 0x1000;
2097 XFASTINT (buffer_local_flags
.display_table
) = 0x2000;
2098 XFASTINT (buffer_local_flags
.syntax_table
) = 0x8000;
2100 Vbuffer_alist
= Qnil
;
2104 QSFundamental
= build_string ("Fundamental");
2106 Qfundamental_mode
= intern ("fundamental-mode");
2107 buffer_defaults
.major_mode
= Qfundamental_mode
;
2109 Qmode_class
= intern ("mode-class");
2111 Qprotected_field
= intern ("protected-field");
2113 Qpermanent_local
= intern ("permanent-local");
2115 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2117 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2118 /* super-magic invisible buffer */
2119 Vbuffer_alist
= Qnil
;
2121 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2126 char buf
[MAXPATHLEN
+1];
2128 struct stat dotstat
, pwdstat
;
2131 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2133 /* If PWD is accurate, use it instead of calling getwd. This is faster
2134 when PWD is right, and may avoid a fatal error. */
2135 if ((pwd
= getenv ("PWD")) != 0 && *pwd
== '/'
2136 && stat (pwd
, &pwdstat
) == 0
2137 && stat (".", &dotstat
) == 0
2138 && dotstat
.st_ino
== pwdstat
.st_ino
2139 && dotstat
.st_dev
== pwdstat
.st_dev
2140 && strlen (pwd
) < MAXPATHLEN
)
2142 else if (getwd (buf
) == 0)
2143 fatal ("`getwd' failed: %s.\n", buf
);
2146 /* Maybe this should really use some standard subroutine
2147 whose definition is filename syntax dependent. */
2148 if (buf
[strlen (buf
) - 1] != '/')
2150 #endif /* not VMS */
2151 current_buffer
->directory
= build_string (buf
);
2153 temp
= get_minibuffer (0);
2154 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2157 /* initialize the buffer routines */
2160 extern Lisp_Object Qdisabled
;
2162 staticpro (&Vbuffer_defaults
);
2163 staticpro (&Vbuffer_local_symbols
);
2164 staticpro (&Qfundamental_mode
);
2165 staticpro (&Qmode_class
);
2166 staticpro (&QSFundamental
);
2167 staticpro (&Vbuffer_alist
);
2168 staticpro (&Qprotected_field
);
2169 staticpro (&Qpermanent_local
);
2170 staticpro (&Qkill_buffer_hook
);
2171 staticpro (&Qoverlayp
);
2172 staticpro (&Qmodification_hooks
);
2173 Qmodification_hooks
= intern ("modification-hooks");
2174 staticpro (&Qinsert_in_front_hooks
);
2175 Qinsert_in_front_hooks
= intern ("insert-in-front-hooks");
2176 staticpro (&Qinsert_behind_hooks
);
2177 Qinsert_behind_hooks
= intern ("insert-behind-hooks");
2179 Qoverlayp
= intern ("overlayp");
2181 Fput (Qprotected_field
, Qerror_conditions
,
2182 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2183 Fput (Qprotected_field
, Qerror_message
,
2184 build_string ("Attempt to modify a protected field"));
2186 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);
2188 /* All these use DEFVAR_LISP_NOPRO because the slots in
2189 buffer_defaults will all be marked via Vbuffer_defaults. */
2191 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2192 &buffer_defaults
.mode_line_format
,
2193 "Default value of `mode-line-format' for buffers that don't override it.\n\
2194 This is the same as (default-value 'mode-line-format).");
2196 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2197 &buffer_defaults
.abbrev_mode
,
2198 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2199 This is the same as (default-value 'abbrev-mode).");
2201 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2202 &buffer_defaults
.ctl_arrow
,
2203 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2204 This is the same as (default-value 'ctl-arrow).");
2206 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2207 &buffer_defaults
.truncate_lines
,
2208 "Default value of `truncate-lines' for buffers that do not override it.\n\
2209 This is the same as (default-value 'truncate-lines).");
2211 DEFVAR_LISP_NOPRO ("default-fill-column",
2212 &buffer_defaults
.fill_column
,
2213 "Default value of `fill-column' for buffers that do not override it.\n\
2214 This is the same as (default-value 'fill-column).");
2216 DEFVAR_LISP_NOPRO ("default-left-margin",
2217 &buffer_defaults
.left_margin
,
2218 "Default value of `left-margin' for buffers that do not override it.\n\
2219 This is the same as (default-value 'left-margin).");
2221 DEFVAR_LISP_NOPRO ("default-tab-width",
2222 &buffer_defaults
.tab_width
,
2223 "Default value of `tab-width' for buffers that do not override it.\n\
2224 This is the same as (default-value 'tab-width).");
2226 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2227 &buffer_defaults
.case_fold_search
,
2228 "Default value of `case-fold-search' for buffers that don't override it.\n\
2229 This is the same as (default-value 'case-fold-search).");
2231 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2234 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2235 But make-docfile finds it!
2236 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2238 "Template for displaying mode line for current buffer.\n\
2239 Each buffer has its own value of this variable.\n\
2240 Value may be a string, a symbol or a list or cons cell.\n\
2241 For a symbol, its value is used (but it is ignored if t or nil).\n\
2242 A string appearing directly as the value of a symbol is processed verbatim\n\
2243 in that the %-constructs below are not recognized.\n\
2244 For a list whose car is a symbol, the symbol's value is taken,\n\
2245 and if that is non-nil, the cadr of the list is processed recursively.\n\
2246 Otherwise, the caddr of the list (if there is one) is processed.\n\
2247 For a list whose car is a string or list, each element is processed\n\
2248 recursively and the results are effectively concatenated.\n\
2249 For a list whose car is an integer, the cdr of the list is processed\n\
2250 and padded (if the number is positive) or truncated (if negative)\n\
2251 to the width specified by that number.\n\
2252 A string is printed verbatim in the mode line except for %-constructs:\n\
2253 (%-constructs are allowed when the string is the entire mode-line-format\n\
2254 or when it is found in a cons-cell or a list)\n\
2255 %b -- print buffer name. %f -- print visited file name.\n\
2256 %* -- print *, % or hyphen. %m -- print value of mode-name (obsolete).\n\
2257 %s -- print process status. %l -- print the current line number.\n\
2258 %p -- print percent of buffer above top of window, or top, bot or all.\n\
2259 %n -- print Narrow if appropriate.\n\
2260 %[ -- print one [ for each recursive editing level. %] similar.\n\
2261 %% -- print %. %- -- print infinitely many dashes.\n\
2262 Decimal digits after the % specify field width to which to pad.");
2265 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2266 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2267 nil here means use current buffer's major mode.");
2269 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2270 make_number (Lisp_Symbol
),
2271 "Symbol for current buffer's major mode.");
2273 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2274 make_number (Lisp_String
),
2275 "Pretty name of current buffer's major mode (a string).");
2277 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2278 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2279 Automatically becomes buffer-local when set in any fashion.");
2281 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2283 "*Non-nil if searches should ignore case.\n\
2284 Automatically becomes buffer-local when set in any fashion.");
2286 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2287 make_number (Lisp_Int
),
2288 "*Column beyond which automatic line-wrapping should happen.\n\
2289 Automatically becomes buffer-local when set in any fashion.");
2291 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2292 make_number (Lisp_Int
),
2293 "*Column for the default indent-line-function to indent to.\n\
2294 Linefeed indents to this column in Fundamental mode.\n\
2295 Automatically becomes buffer-local when set in any fashion.");
2297 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2298 make_number (Lisp_Int
),
2299 "*Distance between tab stops (for display of tab characters), in columns.\n\
2300 Automatically becomes buffer-local when set in any fashion.");
2302 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2303 "*Non-nil means display control chars with uparrow.\n\
2304 Nil means use backslash and octal digits.\n\
2305 Automatically becomes buffer-local when set in any fashion.\n\
2306 This variable does not apply to characters whose display is specified\n\
2307 in the current display table (if there is one).");
2309 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2310 "*Non-nil means do not display continuation lines;\n\
2311 give each line of text one screen line.\n\
2312 Automatically becomes buffer-local when set in any fashion.\n\
2314 Note that this is overridden by the variable\n\
2315 `truncate-partial-width-windows' if that variable is non-nil\n\
2316 and this buffer is not full-frame width.");
2318 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2319 make_number (Lisp_String
),
2320 "Name of default directory of current buffer. Should end with slash.\n\
2321 Each buffer has its own value of this variable.");
2323 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2325 "Function called (if non-nil) to perform auto-fill.\n\
2326 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2327 Each buffer has its own value of this variable.\n\
2328 NOTE: This variable is not an ordinary hook;\n\
2329 It may not be a list of functions.");
2331 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2332 make_number (Lisp_String
),
2333 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2334 Each buffer has its own value of this variable.");
2336 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2337 ¤t_buffer
->auto_save_file_name
,
2338 make_number (Lisp_String
),
2339 "Name of file for auto-saving current buffer,\n\
2340 or nil if buffer should not be auto-saved.\n\
2341 Each buffer has its own value of this variable.");
2343 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2344 "Non-nil if this buffer is read-only.\n\
2345 Each buffer has its own value of this variable.");
2347 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2348 "Non-nil if this buffer's file has been backed up.\n\
2349 Backing up is done before the first time the file is saved.\n\
2350 Each buffer has its own value of this variable.");
2352 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2353 make_number (Lisp_Int
),
2354 "Length of current buffer when last read in, saved or auto-saved.\n\
2356 Each buffer has its own value of this variable.");
2358 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2360 "Non-nil enables selective display:\n\
2361 Integer N as value means display only lines\n\
2362 that start with less than n columns of space.\n\
2363 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2364 Then ^M's in the file are written into files as newlines.\n\n\
2365 Automatically becomes buffer-local when set in any fashion.");
2368 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2369 ¤t_buffer
->selective_display_ellipses
,
2371 "t means display ... on previous line when a line is invisible.\n\
2372 Automatically becomes buffer-local when set in any fashion.");
2375 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2376 "Non-nil if self-insertion should replace existing text.\n\
2377 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2378 inserts at the end of a line, and inserts when point is before a tab,\n\
2379 until the tab is filled in.\n\
2380 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2381 Automatically becomes buffer-local when set in any fashion.");
2383 #if 0 /* The doc string is too long for some compilers,
2384 but make-docfile can find it in this comment. */
2385 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2387 "Display table that controls display of the contents of current buffer.\n\
2388 Automatically becomes buffer-local when set in any fashion.\n\
2389 The display table is a vector created with `make-display-table'.\n\
2390 The first 256 elements control how to display each possible text character.\n\
2391 Each value should be a vector of characters or nil;\n\
2392 nil means display the character in the default fashion.\n\
2393 The remaining five elements control the display of\n\
2394 the end of a truncated screen line (element 256, a single character);\n\
2395 the end of a continued line (element 257, a single character);\n\
2396 the escape character used to display character codes in octal\n\
2397 (element 258, a single character);\n\
2398 the character used as an arrow for control characters (element 259,\n\
2399 a single character);\n\
2400 the decoration indicating the presence of invisible lines (element 260,\n\
2401 a vector of characters).\n\
2402 If this variable is nil, the value of `standard-display-table' is used.\n\
2403 Each window can have its own, overriding display table.");
2405 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2408 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2411 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2412 "Function to call before each text change.\n\
2413 Two arguments are passed to the function: the positions of\n\
2414 the beginning and end of the range of old text to be changed.\n\
2415 \(For an insertion, the beginning and end are at the same place.)\n\
2416 No information is given about the length of the text after the change.\n\
2417 position of the change\n\
2419 While executing the `before-change-function', changes to buffers do not\n\
2420 cause calls to any `before-change-function' or `after-change-function'.");
2421 Vbefore_change_function
= Qnil
;
2423 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2424 "Function to call after each text change.\n\
2425 Three arguments are passed to the function: the positions of\n\
2426 the beginning and end of the range of changed text,\n\
2427 and the length of the pre-change text replaced by that range.\n\
2428 \(For an insertion, the pre-change length is zero;\n\
2429 for a deletion, that length is the number of characters deleted,\n\
2430 and the post-change beginning and end are at the same place.)\n\
2432 While executing the `after-change-function', changes to buffers do not\n\
2433 cause calls to any `before-change-function' or `after-change-function'.");
2434 Vafter_change_function
= Qnil
;
2436 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2437 "A list of functions to call before changing a buffer which is unmodified.\n\
2438 The functions are run using the `run-hooks' function.");
2439 Vfirst_change_hook
= Qnil
;
2440 Qfirst_change_hook
= intern ("first-change-hook");
2441 staticpro (&Qfirst_change_hook
);
2443 #if 0 /* The doc string is too long for some compilers,
2444 but make-docfile can find it in this comment. */
2445 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2446 "List of undo entries in current buffer.\n\
2447 Recent changes come first; older changes follow newer.\n\
2449 An entry (START . END) represents an insertion which begins at\n\
2450 position START and ends at position END.\n\
2452 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2453 from (abs POSITION). If POSITION is positive, point was at the front\n\
2454 of the text being deleted; if negative, point was at the end.\n\
2456 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2457 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
2458 16-bit words of the buffer's modification count at the time. If the\n\
2459 modification count of the most recent save is different, this entry is\n\
2462 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2463 was modified between BEG and END. PROP is the property name,\n\
2464 and VAL is the old value.\n\
2466 An entry of the form POSITION indicates that point was at the buffer\n\
2467 location given by the integer. Undoing an entry of this form places\n\
2468 point at POSITION.\n\
2470 nil marks undo boundaries. The undo command treats the changes\n\
2471 between two undo boundaries as a single step to be undone.\n\
2473 If the value of the variable is t, undo information is not recorded.");
2475 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2478 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
2479 "Non-nil means the mark and region are currently active in this buffer.\n\
2480 Automatically local in all buffers.");
2482 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
2483 "*Non-nil means deactivate the mark when the buffer contents change.");
2484 Vtransient_mark_mode
= Qnil
;
2486 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
2487 "*Non-nil means disregard read-only status of buffers or characters.\n\
2488 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
2489 text properties. If the value is a list, disregard `buffer-read-only'\n\
2490 and disregard a `read-only' text property if the property value\n\
2491 is a member of the list.");
2492 Vinhibit_read_only
= Qnil
;
2494 defsubr (&Sbuffer_list
);
2495 defsubr (&Sget_buffer
);
2496 defsubr (&Sget_file_buffer
);
2497 defsubr (&Sget_buffer_create
);
2498 defsubr (&Sgenerate_new_buffer_name
);
2499 defsubr (&Sbuffer_name
);
2500 /*defsubr (&Sbuffer_number);*/
2501 defsubr (&Sbuffer_file_name
);
2502 defsubr (&Sbuffer_local_variables
);
2503 defsubr (&Sbuffer_modified_p
);
2504 defsubr (&Sset_buffer_modified_p
);
2505 defsubr (&Sbuffer_modified_tick
);
2506 defsubr (&Srename_buffer
);
2507 defsubr (&Sother_buffer
);
2508 defsubr (&Sbuffer_disable_undo
);
2509 defsubr (&Sbuffer_enable_undo
);
2510 defsubr (&Skill_buffer
);
2511 defsubr (&Serase_buffer
);
2512 defsubr (&Sswitch_to_buffer
);
2513 defsubr (&Spop_to_buffer
);
2514 defsubr (&Scurrent_buffer
);
2515 defsubr (&Sset_buffer
);
2516 defsubr (&Sbarf_if_buffer_read_only
);
2517 defsubr (&Sbury_buffer
);
2518 defsubr (&Slist_buffers
);
2519 defsubr (&Skill_all_local_variables
);
2521 defsubr (&Soverlayp
);
2522 defsubr (&Smake_overlay
);
2523 defsubr (&Sdelete_overlay
);
2524 defsubr (&Smove_overlay
);
2525 defsubr (&Soverlay_start
);
2526 defsubr (&Soverlay_end
);
2527 defsubr (&Soverlay_buffer
);
2528 defsubr (&Soverlay_properties
);
2529 defsubr (&Soverlays_at
);
2530 defsubr (&Snext_overlay_change
);
2531 defsubr (&Soverlay_recenter
);
2532 defsubr (&Soverlay_lists
);
2533 defsubr (&Soverlay_get
);
2534 defsubr (&Soverlay_put
);
2539 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
2540 initial_define_key (control_x_map
, 'k', "kill-buffer");
2541 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");