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 /* For debugging; temporary. See set_buffer_internal. */
136 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
141 if (XTYPE (spec
) == Lisp_String
)
142 error ("No buffer named %s", XSTRING (spec
)->data
);
143 error ("Invalid buffer argument");
146 DEFUN ("buffer-list", Fbuffer_list
, Sbuffer_list
, 0, 0, 0,
147 "Return a list of all existing live buffers.")
150 return Fmapcar (Qcdr
, Vbuffer_alist
);
153 DEFUN ("get-buffer", Fget_buffer
, Sget_buffer
, 1, 1, 0,
154 "Return the buffer named NAME (a string).\n\
155 If there is no live buffer named NAME, return nil.\n\
156 NAME may also be a buffer; if so, the value is that buffer.")
158 register Lisp_Object name
;
160 if (XTYPE (name
) == Lisp_Buffer
)
162 CHECK_STRING (name
, 0);
164 return Fcdr (Fassoc (name
, Vbuffer_alist
));
167 DEFUN ("get-file-buffer", Fget_file_buffer
, Sget_file_buffer
, 1, 1, 0,
168 "Return the buffer visiting file FILENAME (a string).\n\
169 If there is no such live buffer, return nil.")
171 register Lisp_Object filename
;
173 register Lisp_Object tail
, buf
, tem
;
174 CHECK_STRING (filename
, 0);
175 filename
= Fexpand_file_name (filename
, Qnil
);
177 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
179 buf
= Fcdr (XCONS (tail
)->car
);
180 if (XTYPE (buf
) != Lisp_Buffer
) continue;
181 if (XTYPE (XBUFFER (buf
)->filename
) != Lisp_String
) continue;
182 tem
= Fstring_equal (XBUFFER (buf
)->filename
, filename
);
189 /* Incremented for each buffer created, to assign the buffer number. */
192 DEFUN ("get-buffer-create", Fget_buffer_create
, Sget_buffer_create
, 1, 1, 0,
193 "Return the buffer named NAME, or create such a buffer and return it.\n\
194 A new buffer is created if there is no live buffer named NAME.\n\
195 If NAME starts with a space, the new buffer does not keep undo information.\n\
196 If NAME is a buffer instead of a string, then it is the value returned.\n\
197 The value is never nil.")
199 register Lisp_Object name
;
201 register Lisp_Object buf
, function
, tem
;
202 int count
= specpdl_ptr
- specpdl
;
203 register struct buffer
*b
;
205 buf
= Fget_buffer (name
);
209 b
= (struct buffer
*) xmalloc (sizeof (struct buffer
));
211 BUF_GAP_SIZE (b
) = 20;
213 BUFFER_ALLOC (BUF_BEG_ADDR (b
), BUF_GAP_SIZE (b
));
215 if (! BUF_BEG_ADDR (b
))
225 /* Put this on the chain of all buffers including killed ones. */
226 b
->next
= all_buffers
;
229 b
->mark
= Fmake_marker ();
230 /*b->number = make_number (++buffer_count);*/
232 if (XSTRING (name
)->data
[0] != ' ')
239 /* Put this in the alist of all live buffers. */
240 XSET (buf
, Lisp_Buffer
, b
);
241 Vbuffer_alist
= nconc2 (Vbuffer_alist
, Fcons (Fcons (name
, buf
), Qnil
));
243 b
->mark
= Fmake_marker ();
247 function
= buffer_defaults
.major_mode
;
250 tem
= Fget (current_buffer
->major_mode
, Qmode_class
);
252 function
= current_buffer
->major_mode
;
255 if (NILP (function
) || EQ (function
, Qfundamental_mode
))
258 /* To select a nonfundamental mode,
259 select the buffer temporarily and then call the mode function. */
261 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
266 return unbind_to (count
, buf
);
269 /* Reinitialize everything about a buffer except its name and contents. */
273 register struct buffer
*b
;
276 b
->directory
= (current_buffer
) ? current_buffer
->directory
: Qnil
;
278 b
->save_modified
= 1;
279 XFASTINT (b
->save_length
) = 0;
280 b
->last_window_start
= 1;
282 b
->auto_save_modified
= 0;
283 b
->auto_save_file_name
= Qnil
;
285 b
->overlays_before
= Qnil
;
286 b
->overlays_after
= Qnil
;
287 XFASTINT (b
->overlay_center
) = 1;
288 b
->mark_active
= Qnil
;
290 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
291 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
293 reset_buffer_local_variables(b
);
296 reset_buffer_local_variables (b
)
297 register struct buffer
*b
;
301 /* Reset the major mode to Fundamental, together with all the
302 things that depend on the major mode.
303 default-major-mode is handled at a higher level.
304 We ignore it here. */
305 b
->major_mode
= Qfundamental_mode
;
307 b
->abbrev_table
= Vfundamental_mode_abbrev_table
;
308 b
->mode_name
= QSFundamental
;
309 b
->minor_modes
= Qnil
;
310 b
->downcase_table
= Vascii_downcase_table
;
311 b
->upcase_table
= Vascii_upcase_table
;
312 b
->case_canon_table
= Vascii_downcase_table
;
313 b
->case_eqv_table
= Vascii_upcase_table
;
315 b
->sort_table
= XSTRING (Vascii_sort_table
);
316 b
->folding_sort_table
= XSTRING (Vascii_folding_sort_table
);
319 /* Reset all per-buffer variables to their defaults. */
320 b
->local_var_alist
= Qnil
;
321 b
->local_var_flags
= 0;
323 /* For each slot that has a default value,
324 copy that into the slot. */
326 for (offset
= (char *)&buffer_local_flags
.name
- (char *)&buffer_local_flags
;
327 offset
< sizeof (struct buffer
);
328 offset
+= sizeof (Lisp_Object
)) /* sizeof int == sizeof Lisp_Object */
329 if (*(int *)(offset
+ (char *) &buffer_local_flags
) > 0
330 || *(int *)(offset
+ (char *) &buffer_local_flags
) == -2)
331 *(Lisp_Object
*)(offset
+ (char *)b
) =
332 *(Lisp_Object
*)(offset
+ (char *)&buffer_defaults
);
335 /* We split this away from generate-new-buffer, because rename-buffer
336 and set-visited-file-name ought to be able to use this to really
337 rename the buffer properly. */
339 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name
, Sgenerate_new_buffer_name
,
341 "Return a string that is the name of no existing buffer based on NAME.\n\
342 If there is no live buffer named NAME, then return NAME.\n\
343 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
344 until an unused name is found, and then return that name.\n\
345 Optional second argument IGNORE specifies a name that is okay to use\n\
346 \(if it is in the sequence to be tried)\n\
347 even if a buffer with that name exists.")
349 register Lisp_Object name
, ignore
;
351 register Lisp_Object gentemp
, tem
;
355 CHECK_STRING (name
, 0);
357 tem
= Fget_buffer (name
);
364 sprintf (number
, "<%d>", ++count
);
365 gentemp
= concat2 (name
, build_string (number
));
366 tem
= Fstring_equal (gentemp
, ignore
);
369 tem
= Fget_buffer (gentemp
);
376 DEFUN ("buffer-name", Fbuffer_name
, Sbuffer_name
, 0, 1, 0,
377 "Return the name of BUFFER, as a string.\n\
378 With no argument or nil as argument, return the name of the current buffer.")
380 register Lisp_Object buffer
;
383 return current_buffer
->name
;
384 CHECK_BUFFER (buffer
, 0);
385 return XBUFFER (buffer
)->name
;
388 DEFUN ("buffer-file-name", Fbuffer_file_name
, Sbuffer_file_name
, 0, 1, 0,
389 "Return name of file BUFFER is visiting, or nil if none.\n\
390 No argument or nil as argument means use the current buffer.")
392 register Lisp_Object buffer
;
395 return current_buffer
->filename
;
396 CHECK_BUFFER (buffer
, 0);
397 return XBUFFER (buffer
)->filename
;
400 DEFUN ("buffer-local-variables", Fbuffer_local_variables
,
401 Sbuffer_local_variables
, 0, 1, 0,
402 "Return an alist of variables that are buffer-local in BUFFER.\n\
403 Most elements look like (SYMBOL . VALUE), describing one variable.\n\
404 For a symbol that is locally unbound, just the symbol appears in the value.\n\
405 Note that storing new VALUEs in these elements doesn't change the variables.\n\
406 No argument or nil as argument means use current buffer as BUFFER.")
408 register Lisp_Object buffer
;
410 register struct buffer
*buf
;
411 register Lisp_Object result
;
414 buf
= current_buffer
;
417 CHECK_BUFFER (buffer
, 0);
418 buf
= XBUFFER (buffer
);
424 /* Reference each variable in the alist in our current buffer.
425 If inquiring about the current buffer, this gets the current values,
426 so store them into the alist so the alist is up to date.
427 If inquiring about some other buffer, this swaps out any values
428 for that buffer, making the alist up to date automatically. */
429 register Lisp_Object tail
;
430 for (tail
= buf
->local_var_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
432 Lisp_Object val
, elt
;
434 elt
= XCONS (tail
)->car
;
436 if (buf
== current_buffer
)
437 val
= find_symbol_value (XCONS (elt
)->car
);
439 val
= XCONS (elt
)->cdr
;
441 /* If symbol is unbound, put just the symbol in the list. */
442 if (EQ (val
, Qunbound
))
443 result
= Fcons (XCONS (elt
)->car
, result
);
444 /* Otherwise, put (symbol . value) in the list. */
446 result
= Fcons (Fcons (XCONS (elt
)->car
, val
), result
);
450 /* Add on all the variables stored in special slots. */
452 register int offset
, mask
;
454 for (offset
= (char *)&buffer_local_symbols
.name
- (char *)&buffer_local_symbols
;
455 offset
< sizeof (struct buffer
);
456 offset
+= (sizeof (int))) /* sizeof int == sizeof Lisp_Object */
458 mask
= *(int *)(offset
+ (char *) &buffer_local_flags
);
459 if (mask
== -1 || (buf
->local_var_flags
& mask
))
460 if (XTYPE (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
))
462 result
= Fcons (Fcons (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
),
463 *(Lisp_Object
*)(offset
+ (char *)buf
)),
472 DEFUN ("buffer-modified-p", Fbuffer_modified_p
, Sbuffer_modified_p
,
474 "Return t if BUFFER was modified since its file was last read or saved.\n\
475 No argument or nil as argument means use current buffer as BUFFER.")
477 register Lisp_Object buffer
;
479 register struct buffer
*buf
;
481 buf
= current_buffer
;
484 CHECK_BUFFER (buffer
, 0);
485 buf
= XBUFFER (buffer
);
488 return buf
->save_modified
< BUF_MODIFF (buf
) ? Qt
: Qnil
;
491 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p
, Sset_buffer_modified_p
,
493 "Mark current buffer as modified or unmodified according to FLAG.\n\
494 A non-nil FLAG means mark the buffer modified.")
496 register Lisp_Object flag
;
498 register int already
;
499 register Lisp_Object fn
;
501 #ifdef CLASH_DETECTION
502 /* If buffer becoming modified, lock the file.
503 If buffer becoming unmodified, unlock the file. */
505 fn
= current_buffer
->filename
;
508 already
= current_buffer
->save_modified
< MODIFF
;
509 if (!already
&& !NILP (flag
))
511 else if (already
&& NILP (flag
))
514 #endif /* CLASH_DETECTION */
516 current_buffer
->save_modified
= NILP (flag
) ? MODIFF
: 0;
521 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick
, Sbuffer_modified_tick
,
523 "Return BUFFER's tick counter, incremented for each change in text.\n\
524 Each buffer has a tick counter which is incremented each time the text in\n\
525 that buffer is changed. It wraps around occasionally.\n\
526 No argument or nil as argument means use current buffer as BUFFER.")
528 register Lisp_Object buffer
;
530 register struct buffer
*buf
;
532 buf
= current_buffer
;
535 CHECK_BUFFER (buffer
, 0);
536 buf
= XBUFFER (buffer
);
539 return make_number (BUF_MODIFF (buf
));
542 DEFUN ("rename-buffer", Frename_buffer
, Srename_buffer
, 1, 2,
543 "sRename buffer (to new name): \nP",
544 "Change current buffer's name to NEWNAME (a string).\n\
545 If second arg UNIQUE is nil or omitted, it is an error if a\n\
546 buffer named NEWNAME already exists.\n\
547 If UNIQUE is non-nil, come up with a new name using\n\
548 `generate-new-buffer-name'.\n\
549 Interactively, you can set UNIQUE with a prefix argument.\n\
550 We return the name we actually gave the buffer.\n\
551 This does not change the name of the visited file (if any).")
553 register Lisp_Object name
, unique
;
555 register Lisp_Object tem
, buf
;
557 CHECK_STRING (name
, 0);
558 tem
= Fget_buffer (name
);
559 if (XBUFFER (tem
) == current_buffer
)
560 return current_buffer
->name
;
564 name
= Fgenerate_new_buffer_name (name
, current_buffer
->name
);
566 error ("Buffer name \"%s\" is in use", XSTRING (name
)->data
);
569 current_buffer
->name
= name
;
571 /* Catch redisplay's attention. Unless we do this, the mode lines for
572 any windows displaying current_buffer will stay unchanged. */
575 XSET (buf
, Lisp_Buffer
, current_buffer
);
576 Fsetcar (Frassq (buf
, Vbuffer_alist
), name
);
577 if (NILP (current_buffer
->filename
) && !NILP (current_buffer
->auto_save_file_name
))
578 call0 (intern ("rename-auto-save-file"));
582 DEFUN ("other-buffer", Fother_buffer
, Sother_buffer
, 0, 2, 0,
583 "Return most recently selected buffer other than BUFFER.\n\
584 Buffers not visible in windows are preferred to visible buffers,\n\
585 unless optional second argument VISIBLE-OK is non-nil.\n\
586 If no other buffer exists, the buffer `*scratch*' is returned.\n\
587 If BUFFER is omitted or nil, some interesting buffer is returned.")
589 register Lisp_Object buffer
, visible_ok
;
591 register Lisp_Object tail
, buf
, notsogood
, tem
;
594 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
596 buf
= Fcdr (Fcar (tail
));
597 if (EQ (buf
, buffer
))
599 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
601 if (NILP (visible_ok
))
602 tem
= Fget_buffer_window (buf
, Qt
);
607 if (NILP (notsogood
))
610 if (!NILP (notsogood
))
612 return Fget_buffer_create (build_string ("*scratch*"));
615 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo
, Sbuffer_disable_undo
, 1,1,
617 "Make BUFFER stop keeping undo information.")
619 register Lisp_Object buffer
;
621 Lisp_Object real_buffer
;
624 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
627 real_buffer
= Fget_buffer (buffer
);
628 if (NILP (real_buffer
))
632 XBUFFER (real_buffer
)->undo_list
= Qt
;
637 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo
, Sbuffer_enable_undo
,
639 "Start keeping undo information for buffer BUFFER.\n\
640 No argument or nil as argument means do this for the current buffer.")
642 register Lisp_Object buffer
;
644 Lisp_Object real_buffer
;
647 XSET (real_buffer
, Lisp_Buffer
, current_buffer
);
650 real_buffer
= Fget_buffer (buffer
);
651 if (NILP (real_buffer
))
655 if (EQ (XBUFFER (real_buffer
)->undo_list
, Qt
))
656 XBUFFER (real_buffer
)->undo_list
= Qnil
;
662 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
663 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
664 The buffer being killed will be current while the hook is running.\n\
667 DEFUN ("kill-buffer", Fkill_buffer
, Skill_buffer
, 1, 1, "bKill buffer: ",
668 "Kill the buffer BUFFER.\n\
669 The argument may be a buffer or may be the name of a buffer.\n\
670 An argument of nil means kill the current buffer.\n\n\
671 Value is t if the buffer is actually killed, nil if user says no.\n\n\
672 The value of `kill-buffer-hook' (which may be local to that buffer),\n\
673 if not void, is a list of functions to be called, with no arguments,\n\
674 before the buffer is actually killed. The buffer to be killed is current\n\
675 when the hook functions are called.\n\n\
676 Any processes that have this buffer as the `process-buffer' are killed\n\
677 with `delete-process'.")
682 register struct buffer
*b
;
683 register Lisp_Object tem
;
684 register struct Lisp_Marker
*m
;
685 struct gcpro gcpro1
, gcpro2
;
688 buf
= Fcurrent_buffer ();
690 buf
= Fget_buffer (bufname
);
696 /* Query if the buffer is still modified. */
697 if (INTERACTIVE
&& !NILP (b
->filename
)
698 && BUF_MODIFF (b
) > b
->save_modified
)
700 GCPRO2 (buf
, bufname
);
701 tem
= do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
702 XSTRING (b
->name
)->data
));
708 /* Run kill-buffer hook with the buffer to be killed the current buffer. */
710 register Lisp_Object val
;
711 int count
= specpdl_ptr
- specpdl
;
713 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
714 set_buffer_internal (b
);
715 call1 (Vrun_hooks
, Qkill_buffer_hook
);
716 unbind_to (count
, Qnil
);
719 /* We have no more questions to ask. Verify that it is valid
720 to kill the buffer. This must be done after the questions
721 since anything can happen within do_yes_or_no_p. */
723 /* Don't kill the minibuffer now current. */
724 if (EQ (buf
, XWINDOW (minibuf_window
)->buffer
))
730 /* Make this buffer not be current.
731 In the process, notice if this is the sole visible buffer
732 and give up if so. */
733 if (b
== current_buffer
)
735 tem
= Fother_buffer (buf
, Qnil
);
737 if (b
== current_buffer
)
741 /* Now there is no question: we can kill the buffer. */
743 #ifdef CLASH_DETECTION
744 /* Unlock this buffer's file, if it is locked. */
746 #endif /* CLASH_DETECTION */
748 kill_buffer_processes (buf
);
752 Vbuffer_alist
= Fdelq (Frassq (buf
, Vbuffer_alist
), Vbuffer_alist
);
753 Freplace_buffer_in_windows (buf
);
756 /* Delete any auto-save file. */
757 if (XTYPE (b
->auto_save_file_name
) == Lisp_String
)
760 tem
= Fsymbol_value (intern ("delete-auto-save-files"));
762 unlink (XSTRING (b
->auto_save_file_name
)->data
);
765 /* Unchain all markers of this buffer
766 and leave them pointing nowhere. */
767 for (tem
= b
->markers
; !EQ (tem
, Qnil
); )
776 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
777 INITIALIZE_INTERVAL (b
, NULL_INTERVAL
);
778 /* Perhaps we should explicitly free the interval tree here... */
782 BUFFER_FREE (BUF_BEG_ADDR (b
));
789 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
790 we do this each time BUF is selected visibly, the more recently
791 selected buffers are always closer to the front of the list. This
792 means that other_buffer is more likely to choose a relevant buffer. */
797 register Lisp_Object link
, prev
;
800 for (link
= Vbuffer_alist
; CONSP (link
); link
= XCONS (link
)->cdr
)
802 if (EQ (XCONS (XCONS (link
)->car
)->cdr
, buf
))
807 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
808 we cannot use Fdelq itself here because it allows quitting. */
811 Vbuffer_alist
= XCONS (Vbuffer_alist
)->cdr
;
813 XCONS (prev
)->cdr
= XCONS (XCONS (prev
)->cdr
)->cdr
;
815 XCONS(link
)->cdr
= Vbuffer_alist
;
816 Vbuffer_alist
= link
;
819 DEFUN ("switch-to-buffer", Fswitch_to_buffer
, Sswitch_to_buffer
, 1, 2, "BSwitch to buffer: ",
820 "Select buffer BUFFER in the current window.\n\
821 BUFFER may be a buffer or a buffer name.\n\
822 Optional second arg NORECORD non-nil means\n\
823 do not put this buffer at the front of the list of recently selected ones.\n\
825 WARNING: This is NOT the way to work on another buffer temporarily\n\
826 within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
827 the window-buffer correspondences.")
829 Lisp_Object bufname
, norecord
;
831 register Lisp_Object buf
;
834 if (EQ (minibuf_window
, selected_window
))
835 error ("Cannot switch buffers in minibuffer window");
836 tem
= Fwindow_dedicated_p (selected_window
);
838 error ("Cannot switch buffers in a dedicated window");
841 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
843 buf
= Fget_buffer_create (bufname
);
848 Fset_window_buffer (EQ (selected_window
, minibuf_window
)
849 ? Fnext_window (minibuf_window
, Qnil
, Qnil
)
856 DEFUN ("pop-to-buffer", Fpop_to_buffer
, Spop_to_buffer
, 1, 2, 0,
857 "Select buffer BUFFER in some window, preferably a different one.\n\
858 If BUFFER is nil, then some other buffer is chosen.\n\
859 If `pop-up-windows' is non-nil, windows can be split to do this.\n\
860 If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
861 window even if BUFFER is already visible in the selected window.")
863 Lisp_Object bufname
, other
;
865 register Lisp_Object buf
;
867 buf
= Fother_buffer (Fcurrent_buffer (), Qnil
);
869 buf
= Fget_buffer_create (bufname
);
872 Fselect_window (Fdisplay_buffer (buf
, other
));
876 DEFUN ("current-buffer", Fcurrent_buffer
, Scurrent_buffer
, 0, 0, 0,
877 "Return the current buffer as a Lisp object.")
880 register Lisp_Object buf
;
881 XSET (buf
, Lisp_Buffer
, current_buffer
);
885 /* Set the current buffer to b */
888 set_buffer_internal (b
)
889 register struct buffer
*b
;
891 register struct buffer
*old_buf
;
892 register Lisp_Object tail
, valcontents
;
895 if (current_buffer
== b
)
898 windows_or_buffers_changed
= 1;
899 old_buf
= current_buffer
;
901 last_known_column_point
= -1; /* invalidate indentation cache */
903 /* Look down buffer's list of local Lisp variables
904 to find and update any that forward into C variables. */
906 for (tail
= b
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
908 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
909 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
910 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
911 && (tem
= XTYPE (XCONS (valcontents
)->car
),
912 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
913 || tem
== Lisp_Objfwd
)))
914 /* Just reference the variable
915 to cause it to become set for this buffer. */
916 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
919 /* Do the same with any others that were local to the previous buffer */
922 for (tail
= old_buf
->local_var_alist
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
924 valcontents
= XSYMBOL (XCONS (XCONS (tail
)->car
)->car
)->value
;
925 if ((XTYPE (valcontents
) == Lisp_Buffer_Local_Value
926 || XTYPE (valcontents
) == Lisp_Some_Buffer_Local_Value
)
927 && (tem
= XTYPE (XCONS (valcontents
)->car
),
928 (tem
== Lisp_Boolfwd
|| tem
== Lisp_Intfwd
929 || tem
== Lisp_Objfwd
)))
930 /* Just reference the variable
931 to cause it to become set for this buffer. */
932 Fsymbol_value (XCONS (XCONS (tail
)->car
)->car
);
936 DEFUN ("set-buffer", Fset_buffer
, Sset_buffer
, 1, 1, 0,
937 "Make the buffer BUFFER current for editing operations.\n\
938 BUFFER may be a buffer or the name of an existing buffer.\n\
939 See also `save-excursion' when you want to make a buffer current temporarily.\n\
940 This function does not display the buffer, so its effect ends\n\
941 when the current command terminates.\n\
942 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
944 register Lisp_Object bufname
;
946 register Lisp_Object buffer
;
947 buffer
= Fget_buffer (bufname
);
950 if (NILP (XBUFFER (buffer
)->name
))
951 error ("Selecting deleted buffer");
952 set_buffer_internal (XBUFFER (buffer
));
956 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only
,
957 Sbarf_if_buffer_read_only
, 0, 0, 0,
958 "Signal a `buffer-read-only' error if the current buffer is read-only.")
961 if (!NILP (current_buffer
->read_only
)
962 && NILP (Vinhibit_read_only
))
963 Fsignal (Qbuffer_read_only
, (Fcons (Fcurrent_buffer (), Qnil
)));
967 DEFUN ("bury-buffer", Fbury_buffer
, Sbury_buffer
, 0, 1, "",
968 "Put BUFFER at the end of the list of all buffers.\n\
969 There it is the least likely candidate for `other-buffer' to return;\n\
970 thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
971 If BUFFER is nil or omitted, bury the current buffer.\n\
972 Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
973 selected window if it is displayed there.")
975 register Lisp_Object buf
;
977 /* Figure out what buffer we're going to bury. */
980 XSET (buf
, Lisp_Buffer
, current_buffer
);
982 /* If we're burying the current buffer, unshow it. */
983 Fswitch_to_buffer (Fother_buffer (buf
, Qnil
), Qnil
);
989 buf1
= Fget_buffer (buf
);
995 /* Move buf to the end of the buffer list. */
997 register Lisp_Object aelt
, link
;
999 aelt
= Frassq (buf
, Vbuffer_alist
);
1000 link
= Fmemq (aelt
, Vbuffer_alist
);
1001 Vbuffer_alist
= Fdelq (aelt
, Vbuffer_alist
);
1002 XCONS (link
)->cdr
= Qnil
;
1003 Vbuffer_alist
= nconc2 (Vbuffer_alist
, link
);
1009 DEFUN ("erase-buffer", Ferase_buffer
, Serase_buffer
, 0, 0, "*",
1010 "Delete the entire contents of the current buffer.\n\
1011 Any clipping restriction in effect (see `narrow-to-region') is removed,\n\
1012 so the buffer is truly empty after this.")
1017 current_buffer
->last_window_start
= 1;
1018 /* Prevent warnings, or suspension of auto saving, that would happen
1019 if future size is less than past size. Use of erase-buffer
1020 implies that the future text is not really related to the past text. */
1021 XFASTINT (current_buffer
->save_length
) = 0;
1025 validate_region (b
, e
)
1026 register Lisp_Object
*b
, *e
;
1030 CHECK_NUMBER_COERCE_MARKER (*b
, 0);
1031 CHECK_NUMBER_COERCE_MARKER (*e
, 1);
1033 if (XINT (*b
) > XINT (*e
))
1035 i
= XFASTINT (*b
); /* This is legit even if *b is < 0 */
1037 XFASTINT (*e
) = i
; /* because this is all we do with i. */
1040 if (!(BEGV
<= XINT (*b
) && XINT (*b
) <= XINT (*e
)
1041 && XINT (*e
) <= ZV
))
1042 args_out_of_range (*b
, *e
);
1046 list_buffers_1 (files
)
1049 register Lisp_Object tail
, tem
, buf
;
1050 Lisp_Object col1
, col2
, col3
, minspace
;
1051 register struct buffer
*old
= current_buffer
, *b
;
1052 Lisp_Object desired_point
;
1053 Lisp_Object other_file_symbol
;
1055 desired_point
= Qnil
;
1056 other_file_symbol
= intern ("list-buffers-directory");
1058 XFASTINT (col1
) = 19;
1059 XFASTINT (col2
) = 25;
1060 XFASTINT (col3
) = 40;
1061 XFASTINT (minspace
) = 1;
1063 Fset_buffer (Vstandard_output
);
1065 tail
= intern ("Buffer-menu-mode");
1066 if (!EQ (tail
, current_buffer
->major_mode
)
1067 && (tem
= Ffboundp (tail
), !NILP (tem
)))
1069 Fbuffer_disable_undo (Vstandard_output
);
1070 current_buffer
->read_only
= Qnil
;
1073 MR Buffer Size Mode File\n\
1074 -- ------ ---- ---- ----\n", -1);
1076 for (tail
= Vbuffer_alist
; !NILP (tail
); tail
= Fcdr (tail
))
1078 buf
= Fcdr (Fcar (tail
));
1080 /* Don't mention the minibuffers. */
1081 if (XSTRING (b
->name
)->data
[0] == ' ')
1083 /* Optionally don't mention buffers that lack files. */
1084 if (!NILP (files
) && NILP (b
->filename
))
1086 /* Identify the current buffer. */
1088 XFASTINT (desired_point
) = point
;
1089 write_string (b
== old
? "." : " ", -1);
1090 /* Identify modified buffers */
1091 write_string (BUF_MODIFF (b
) > b
->save_modified
? "*" : " ", -1);
1092 write_string (NILP (b
->read_only
) ? " " : "% ", -1);
1093 Fprinc (b
->name
, Qnil
);
1094 Findent_to (col1
, make_number (2));
1095 XFASTINT (tem
) = BUF_Z (b
) - BUF_BEG (b
);
1097 Findent_to (col2
, minspace
);
1098 Fprinc (b
->mode_name
, Qnil
);
1099 Findent_to (col3
, minspace
);
1101 if (!NILP (b
->filename
))
1102 Fprinc (b
->filename
, Qnil
);
1105 /* No visited file; check local value of list-buffers-directory. */
1107 set_buffer_internal (b
);
1108 tem
= Fboundp (other_file_symbol
);
1111 tem
= Fsymbol_value (other_file_symbol
);
1112 Fset_buffer (Vstandard_output
);
1113 if (XTYPE (tem
) == Lisp_String
)
1117 Fset_buffer (Vstandard_output
);
1119 write_string ("\n", -1);
1122 current_buffer
->read_only
= Qt
;
1123 set_buffer_internal (old
);
1124 return desired_point
;
1127 DEFUN ("list-buffers", Flist_buffers
, Slist_buffers
, 0, 1, "P",
1128 "Display a list of names of existing buffers.\n\
1129 The list is displayed in a buffer named `*Buffer List*'.\n\
1130 Note that buffers with names starting with spaces are omitted.\n\
1131 Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1133 The M column contains a * for buffers that are modified.\n\
1134 The R column contains a % for buffers that are read-only.")
1138 Lisp_Object desired_point
;
1141 internal_with_output_to_temp_buffer ("*Buffer List*",
1142 list_buffers_1
, files
);
1144 if (NUMBERP (desired_point
))
1146 int count
= specpdl_ptr
- specpdl
;
1147 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
1148 Fset_buffer (build_string ("*Buffer List*"));
1149 SET_PT (XINT (desired_point
));
1150 return unbind_to (count
, Qnil
);
1154 DEFUN ("kill-all-local-variables", Fkill_all_local_variables
, Skill_all_local_variables
,
1156 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1157 Most local variable bindings are eliminated so that the default values\n\
1158 become effective once more. Also, the syntax table is set from\n\
1159 `standard-syntax-table', the local keymap is set to nil,\n\
1160 and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1161 This function also forces redisplay of the mode line.\n\
1163 Every function to select a new major mode starts by\n\
1164 calling this function.\n\n\
1165 As a special exception, local variables whose names have\n\
1166 a non-nil `permanent-local' property are not eliminated by this function.")
1169 register Lisp_Object alist
, sym
, tem
;
1171 oalist
= current_buffer
->local_var_alist
;
1173 /* Make sure no local variables remain set up with this buffer
1174 for their current values. */
1176 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1178 sym
= XCONS (XCONS (alist
)->car
)->car
;
1180 /* Need not do anything if some other buffer's binding is now encached. */
1181 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
;
1182 if (XBUFFER (tem
) == current_buffer
)
1184 /* Symbol is set up for this buffer's old local value.
1185 Set it up for the current buffer with the default value. */
1187 tem
= XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->cdr
;
1188 /* Store the symbol's current value into the alist entry
1189 it is currently set up for. This is so that, if the
1190 local is marked permanent, and we make it local again below,
1191 we don't lose the value. */
1192 XCONS (XCONS (tem
)->car
)->cdr
= XCONS (XSYMBOL (sym
)->value
)->car
;
1193 /* Switch to the symbol's default-value alist entry. */
1194 XCONS (tem
)->car
= tem
;
1195 /* Mark it as current for the current buffer. */
1196 XCONS (XCONS (XSYMBOL (sym
)->value
)->cdr
)->car
= Fcurrent_buffer ();
1197 /* Store the current value into any forwarding in the symbol. */
1198 store_symval_forwarding (sym
, XCONS (XSYMBOL (sym
)->value
)->car
,
1203 /* Actually eliminate all local bindings of this buffer. */
1205 reset_buffer_local_variables (current_buffer
);
1207 /* Redisplay mode lines; we are changing major mode. */
1209 update_mode_lines
++;
1211 /* Any which are supposed to be permanent,
1212 make local again, with the same values they had. */
1214 for (alist
= oalist
; !NILP (alist
); alist
= XCONS (alist
)->cdr
)
1216 sym
= XCONS (XCONS (alist
)->car
)->car
;
1217 tem
= Fget (sym
, Qpermanent_local
);
1220 Fmake_local_variable (sym
);
1221 Fset (sym
, XCONS (XCONS (alist
)->car
)->cdr
);
1225 /* Force mode-line redisplay. Useful here because all major mode
1226 commands call this function. */
1227 update_mode_lines
++;
1232 /* Find all the overlays in the current buffer that contain position POS.
1233 Return the number found, and store them in a vector in *VEC_PTR.
1234 Store in *LEN_PTR the size allocated for the vector.
1235 Store in *NEXT_PTR the next position after POS where an overlay starts,
1236 or ZV if there are no more overlays.
1238 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1239 when this function is called.
1241 If EXTEND is non-zero, we make the vector bigger if necessary.
1242 If EXTEND is zero, we never extend the vector,
1243 and we store only as many overlays as will fit.
1244 But we still return the total number of overlays. */
1247 overlays_at (pos
, extend
, vec_ptr
, len_ptr
, next_ptr
)
1250 Lisp_Object
**vec_ptr
;
1254 Lisp_Object tail
, overlay
, start
, end
, result
;
1257 Lisp_Object
*vec
= *vec_ptr
;
1259 int inhibit_storing
= 0;
1261 for (tail
= current_buffer
->overlays_before
;
1263 tail
= XCONS (tail
)->cdr
)
1267 overlay
= XCONS (tail
)->car
;
1268 if (! OVERLAY_VALID (overlay
))
1271 start
= OVERLAY_START (overlay
);
1272 end
= OVERLAY_END (overlay
);
1273 if (OVERLAY_POSITION (end
) <= pos
)
1275 startpos
= OVERLAY_POSITION (start
);
1276 if (startpos
<= pos
)
1280 /* The supplied vector is full.
1281 Either make it bigger, or don't store any more in it. */
1284 *len_ptr
= len
*= 2;
1285 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1289 inhibit_storing
= 1;
1292 if (!inhibit_storing
)
1294 /* Keep counting overlays even if we can't return them all. */
1297 else if (startpos
< next
)
1301 for (tail
= current_buffer
->overlays_after
;
1303 tail
= XCONS (tail
)->cdr
)
1307 overlay
= XCONS (tail
)->car
;
1308 if (! OVERLAY_VALID (overlay
))
1311 start
= OVERLAY_START (overlay
);
1312 end
= OVERLAY_END (overlay
);
1313 startpos
= OVERLAY_POSITION (start
);
1316 if (startpos
< next
)
1320 if (pos
< OVERLAY_POSITION (end
))
1326 *len_ptr
= len
*= 2;
1327 vec
= (Lisp_Object
*) xrealloc (vec
, len
* sizeof (Lisp_Object
));
1331 inhibit_storing
= 1;
1334 if (!inhibit_storing
)
1344 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1347 recenter_overlay_lists (buf
, pos
)
1351 Lisp_Object overlay
, tail
, next
, prev
, beg
, end
;
1353 /* See if anything in overlays_before should move to overlays_after. */
1355 /* We don't strictly need prev in this loop; it should always be nil.
1356 But we use it for symmetry and in case that should cease to be true
1357 with some future change. */
1359 for (tail
= buf
->overlays_before
;
1361 prev
= tail
, tail
= next
)
1363 next
= XCONS (tail
)->cdr
;
1364 overlay
= XCONS (tail
)->car
;
1366 /* If the overlay is not valid, get rid of it. */
1367 if (!OVERLAY_VALID (overlay
))
1372 /* Splice the cons cell TAIL out of overlays_before. */
1374 XCONS (prev
)->cdr
= next
;
1376 buf
->overlays_before
= next
;
1382 beg
= OVERLAY_START (overlay
);
1383 end
= OVERLAY_END (overlay
);
1385 if (OVERLAY_POSITION (end
) > pos
)
1387 /* OVERLAY needs to be moved. */
1388 int where
= OVERLAY_POSITION (beg
);
1389 Lisp_Object other
, other_prev
;
1391 /* Splice the cons cell TAIL out of overlays_before. */
1393 XCONS (prev
)->cdr
= next
;
1395 buf
->overlays_before
= next
;
1397 /* Search thru overlays_after for where to put it. */
1399 for (other
= buf
->overlays_after
;
1401 other_prev
= other
, other
= XCONS (other
)->cdr
)
1403 Lisp_Object otherbeg
, otheroverlay
, follower
;
1406 otheroverlay
= XCONS (other
)->car
;
1407 if (! OVERLAY_VALID (otheroverlay
))
1410 otherbeg
= OVERLAY_START (otheroverlay
);
1411 if (OVERLAY_POSITION (otherbeg
) >= where
)
1415 /* Add TAIL to overlays_after before OTHER. */
1416 XCONS (tail
)->cdr
= other
;
1417 if (!NILP (other_prev
))
1418 XCONS (other_prev
)->cdr
= tail
;
1420 buf
->overlays_after
= tail
;
1424 /* We've reached the things that should stay in overlays_before.
1425 All the rest of overlays_before must end even earlier,
1430 /* See if anything in overlays_after should be in overlays_before. */
1432 for (tail
= buf
->overlays_after
;
1434 prev
= tail
, tail
= next
)
1436 next
= XCONS (tail
)->cdr
;
1437 overlay
= XCONS (tail
)->car
;
1439 /* If the overlay is not valid, get rid of it. */
1440 if (!OVERLAY_VALID (overlay
))
1445 /* Splice the cons cell TAIL out of overlays_after. */
1447 XCONS (prev
)->cdr
= next
;
1449 buf
->overlays_after
= next
;
1455 beg
= OVERLAY_START (overlay
);
1456 end
= OVERLAY_END (overlay
);
1458 /* Stop looking, when we know that nothing further
1459 can possibly end before POS. */
1460 if (OVERLAY_POSITION (beg
) > pos
)
1463 if (OVERLAY_POSITION (end
) <= pos
)
1465 /* OVERLAY needs to be moved. */
1466 int where
= OVERLAY_POSITION (end
);
1467 Lisp_Object other
, other_prev
;
1469 /* Splice the cons cell TAIL out of overlays_after. */
1471 XCONS (prev
)->cdr
= next
;
1473 buf
->overlays_after
= next
;
1475 /* Search thru overlays_before for where to put it. */
1477 for (other
= buf
->overlays_before
;
1479 other_prev
= other
, other
= XCONS (other
)->cdr
)
1481 Lisp_Object otherend
, otheroverlay
;
1484 otheroverlay
= XCONS (other
)->car
;
1485 if (! OVERLAY_VALID (otheroverlay
))
1488 otherend
= OVERLAY_END (otheroverlay
);
1489 if (OVERLAY_POSITION (otherend
) <= where
)
1493 /* Add TAIL to overlays_before before OTHER. */
1494 XCONS (tail
)->cdr
= other
;
1495 if (!NILP (other_prev
))
1496 XCONS (other_prev
)->cdr
= tail
;
1498 buf
->overlays_before
= tail
;
1503 XFASTINT (buf
->overlay_center
) = pos
;
1506 DEFUN ("overlayp", Foverlayp
, Soverlayp
, 1, 1, 0,
1507 "Return t if OBJECT is an overlay.")
1511 return (OVERLAYP (object
) ? Qt
: Qnil
);
1514 DEFUN ("make-overlay", Fmake_overlay
, Smake_overlay
, 2, 3, 0,
1515 "Create a new overlay with range BEG to END in BUFFER.\n\
1516 If omitted, BUFFER defaults to the current buffer.\n\
1517 BEG and END may be integers or markers.")
1519 Lisp_Object beg
, end
, buffer
;
1521 Lisp_Object overlay
;
1525 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1527 CHECK_BUFFER (buffer
, 2);
1529 && ! EQ (Fmarker_buffer (beg
), buffer
))
1530 error ("Marker points into wrong buffer");
1532 && ! EQ (Fmarker_buffer (end
), buffer
))
1533 error ("Marker points into wrong buffer");
1535 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1536 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1538 if (XINT (beg
) > XINT (end
))
1540 Lisp_Object temp
= beg
;
1541 beg
= end
; end
= temp
;
1544 b
= XBUFFER (buffer
);
1546 beg
= Fset_marker (Fmake_marker (), beg
, buffer
);
1547 end
= Fset_marker (Fmake_marker (), end
, buffer
);
1549 overlay
= Fcons (Fcons (beg
, end
), Qnil
);
1550 XSETTYPE (overlay
, Lisp_Overlay
);
1552 /* Put the new overlay on the wrong list. */
1553 end
= OVERLAY_END (overlay
);
1554 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1555 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1557 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1559 /* This puts it in the right list, and in the right order. */
1560 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1562 /* We don't need to redisplay the region covered by the overlay, because
1563 the overlay has no properties at the moment. */
1568 DEFUN ("move-overlay", Fmove_overlay
, Smove_overlay
, 3, 4, 0,
1569 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1570 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1571 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1573 (overlay
, beg
, end
, buffer
)
1574 Lisp_Object overlay
, beg
, end
, buffer
;
1576 struct buffer
*b
, *ob
;
1577 Lisp_Object obuffer
;
1578 int count
= specpdl_ptr
- specpdl
;
1580 CHECK_OVERLAY (overlay
, 0);
1582 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1584 XSET (buffer
, Lisp_Buffer
, current_buffer
);
1585 CHECK_BUFFER (buffer
, 3);
1588 && ! EQ (Fmarker_buffer (beg
), buffer
))
1589 error ("Marker points into wrong buffer");
1591 && ! EQ (Fmarker_buffer (end
), buffer
))
1592 error ("Marker points into wrong buffer");
1594 CHECK_NUMBER_COERCE_MARKER (beg
, 1);
1595 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1597 specbind (Qinhibit_quit
, Qt
);
1599 if (XINT (beg
) > XINT (end
))
1601 Lisp_Object temp
= beg
;
1602 beg
= end
; end
= temp
;
1605 obuffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1606 b
= XBUFFER (buffer
);
1607 ob
= XBUFFER (obuffer
);
1609 /* If the overlay has changed buffers, do a thorough redisplay. */
1610 if (!EQ (buffer
, obuffer
))
1611 windows_or_buffers_changed
= 1;
1613 /* Redisplay the area the overlay has just left, or just enclosed. */
1615 Lisp_Object o_beg
= OVERLAY_START (overlay
);
1616 Lisp_Object o_end
= OVERLAY_END (overlay
);
1617 int change_beg
, change_end
;
1619 o_beg
= OVERLAY_POSITION (o_beg
);
1620 o_end
= OVERLAY_POSITION (o_end
);
1622 if (XINT (o_beg
) == XINT (beg
))
1623 redisplay_region (b
, XINT (o_end
), XINT (end
));
1624 else if (XINT (o_end
) == XINT (end
))
1625 redisplay_region (b
, XINT (o_beg
), XINT (beg
));
1628 if (XINT (beg
) < XINT (o_beg
)) o_beg
= beg
;
1629 if (XINT (end
) > XINT (o_end
)) o_end
= end
;
1630 redisplay_region (b
, XINT (o_beg
), XINT (o_end
));
1634 if (!NILP (obuffer
))
1636 ob
->overlays_before
= Fdelq (overlay
, ob
->overlays_before
);
1637 ob
->overlays_after
= Fdelq (overlay
, ob
->overlays_after
);
1640 Fset_marker (OVERLAY_START (overlay
), beg
, buffer
);
1641 Fset_marker (OVERLAY_END (overlay
), end
, buffer
);
1643 /* Put the overlay on the wrong list. */
1644 end
= OVERLAY_END (overlay
);
1645 if (OVERLAY_POSITION (end
) < XINT (b
->overlay_center
))
1646 b
->overlays_after
= Fcons (overlay
, b
->overlays_after
);
1648 b
->overlays_before
= Fcons (overlay
, b
->overlays_before
);
1650 /* This puts it in the right list, and in the right order. */
1651 recenter_overlay_lists (b
, XINT (b
->overlay_center
));
1653 return unbind_to (count
, overlay
);
1656 DEFUN ("delete-overlay", Fdelete_overlay
, Sdelete_overlay
, 1, 1, 0,
1657 "Delete the overlay OVERLAY from its buffer.")
1659 Lisp_Object overlay
;
1663 int count
= specpdl_ptr
- specpdl
;
1665 CHECK_OVERLAY (overlay
, 0);
1667 buffer
= Fmarker_buffer (OVERLAY_START (overlay
));
1671 b
= XBUFFER (buffer
);
1673 specbind (Qinhibit_quit
, Qt
);
1675 b
->overlays_before
= Fdelq (overlay
, b
->overlays_before
);
1676 b
->overlays_after
= Fdelq (overlay
, b
->overlays_after
);
1678 redisplay_region (b
,
1679 OVERLAY_POSITION (OVERLAY_START (overlay
)),
1680 OVERLAY_POSITION (OVERLAY_END (overlay
)));
1682 Fset_marker (OVERLAY_START (overlay
), Qnil
, Qnil
);
1683 Fset_marker (OVERLAY_END (overlay
), Qnil
, Qnil
);
1685 return unbind_to (count
, Qnil
);
1688 /* Overlay dissection functions. */
1690 DEFUN ("overlay-start", Foverlay_start
, Soverlay_start
, 1, 1, 0,
1691 "Return the position at which OVERLAY starts.")
1693 Lisp_Object overlay
;
1695 CHECK_OVERLAY (overlay
, 0);
1697 return (Fmarker_position (OVERLAY_START (overlay
)));
1700 DEFUN ("overlay-end", Foverlay_end
, Soverlay_end
, 1, 1, 0,
1701 "Return the position at which OVERLAY ends.")
1703 Lisp_Object overlay
;
1705 CHECK_OVERLAY (overlay
, 0);
1707 return (Fmarker_position (OVERLAY_END (overlay
)));
1710 DEFUN ("overlay-buffer", Foverlay_buffer
, Soverlay_buffer
, 1, 1, 0,
1711 "Return the buffer OVERLAY belongs to.")
1713 Lisp_Object overlay
;
1715 CHECK_OVERLAY (overlay
, 0);
1717 return Fmarker_buffer (OVERLAY_START (overlay
));
1720 DEFUN ("overlay-properties", Foverlay_properties
, Soverlay_properties
, 1, 1, 0,
1721 "Return a list of the properties on OVERLAY.\n\
1722 This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
1725 Lisp_Object overlay
;
1727 CHECK_OVERLAY (overlay
, 0);
1729 return Fcopy_sequence (Fcdr_safe (XCONS (overlay
)->cdr
));
1733 DEFUN ("overlays-at", Foverlays_at
, Soverlays_at
, 1, 1, 0,
1734 "Return a list of the overlays that contain position POS.")
1740 Lisp_Object
*overlay_vec
;
1744 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1747 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1749 /* Put all the overlays we want in a vector in overlay_vec.
1750 Store the length in len. */
1751 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1753 /* Make a list of them all. */
1754 result
= Flist (noverlays
, overlay_vec
);
1756 xfree (overlay_vec
);
1760 DEFUN ("next-overlay-change", Fnext_overlay_change
, Snext_overlay_change
,
1762 "Return the next position after POS where an overlay starts or ends.")
1768 Lisp_Object
*overlay_vec
;
1773 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1776 overlay_vec
= (Lisp_Object
*) xmalloc (len
* sizeof (Lisp_Object
));
1778 /* Put all the overlays we want in a vector in overlay_vec.
1779 Store the length in len.
1780 endpos gets the position where the next overlay starts. */
1781 noverlays
= overlays_at (XINT (pos
), 1, &overlay_vec
, &len
, &endpos
);
1783 /* If any of these overlays ends before endpos,
1784 use its ending point instead. */
1785 for (i
= 0; i
< noverlays
; i
++)
1790 oend
= OVERLAY_END (overlay_vec
[i
]);
1791 oendpos
= OVERLAY_POSITION (oend
);
1792 if (oendpos
< endpos
)
1796 xfree (overlay_vec
);
1797 return make_number (endpos
);
1800 /* These functions are for debugging overlays. */
1802 DEFUN ("overlay-lists", Foverlay_lists
, Soverlay_lists
, 0, 0, 0,
1803 "Return a pair of lists giving all the overlays of the current buffer.\n\
1804 The car has all the overlays before the overlay center;\n\
1805 the cdr has all the overlays before the overlay center.\n\
1806 Recentering overlays moves overlays between these lists.\n\
1807 The lists you get are copies, so that changing them has no effect.\n\
1808 However, the overlays you get are the real objects that the buffer uses.")
1811 Lisp_Object before
, after
;
1812 before
= current_buffer
->overlays_before
;
1814 before
= Fcopy_sequence (before
);
1815 after
= current_buffer
->overlays_after
;
1817 after
= Fcopy_sequence (after
);
1819 return Fcons (before
, after
);
1822 DEFUN ("overlay-recenter", Foverlay_recenter
, Soverlay_recenter
, 1, 1, 0,
1823 "Recenter the overlays of the current buffer around position POS.")
1827 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
1829 recenter_overlay_lists (current_buffer
, XINT (pos
));
1833 DEFUN ("overlay-get", Foverlay_get
, Soverlay_get
, 2, 2, 0,
1834 "Get the property of overlay OVERLAY with property name NAME.")
1836 Lisp_Object overlay
, prop
;
1840 CHECK_OVERLAY (overlay
, 0);
1842 for (plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1843 CONSP (plist
) && CONSP (XCONS (plist
)->cdr
);
1844 plist
= XCONS (XCONS (plist
)->cdr
)->cdr
)
1846 if (EQ (XCONS (plist
)->car
, prop
))
1847 return XCONS (XCONS (plist
)->cdr
)->car
;
1853 DEFUN ("overlay-put", Foverlay_put
, Soverlay_put
, 3, 3, 0,
1854 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
1855 (overlay
, prop
, value
)
1856 Lisp_Object overlay
, prop
, value
;
1858 Lisp_Object plist
, tail
;
1860 CHECK_OVERLAY (overlay
, 0);
1862 redisplay_region (XMARKER (OVERLAY_START (overlay
))->buffer
,
1863 OVERLAY_POSITION (OVERLAY_START (overlay
)),
1864 OVERLAY_POSITION (OVERLAY_END (overlay
)));
1866 plist
= Fcdr_safe (XCONS (overlay
)->cdr
);
1869 CONSP (tail
) && CONSP (XCONS (tail
)->cdr
);
1870 tail
= XCONS (XCONS (tail
)->cdr
)->cdr
)
1872 if (EQ (XCONS (tail
)->car
, prop
))
1873 return XCONS (XCONS (tail
)->cdr
)->car
= value
;
1876 if (! CONSP (XCONS (overlay
)->cdr
))
1877 XCONS (overlay
)->cdr
= Fcons (Qnil
, Qnil
);
1879 XCONS (XCONS (overlay
)->cdr
)->cdr
1880 = Fcons (prop
, Fcons (value
, plist
));
1885 /* Run the modification-hooks of overlays that include
1886 any part of the text in START to END.
1887 Run the insert-before-hooks of overlay starting at END,
1888 and the insert-after-hooks of overlay ending at START. */
1891 verify_overlay_modification (start
, end
)
1892 Lisp_Object start
, end
;
1894 Lisp_Object prop
, overlay
, tail
;
1895 int insertion
= EQ (start
, end
);
1897 for (tail
= current_buffer
->overlays_before
;
1899 tail
= XCONS (tail
)->cdr
)
1901 int startpos
, endpos
;
1904 overlay
= XCONS (tail
)->car
;
1906 ostart
= OVERLAY_START (overlay
);
1907 oend
= OVERLAY_END (overlay
);
1908 endpos
= OVERLAY_POSITION (oend
);
1909 if (XFASTINT (start
) > endpos
)
1911 startpos
= OVERLAY_POSITION (ostart
);
1912 if (XFASTINT (end
) == startpos
&& insertion
)
1914 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1915 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1917 if (XFASTINT (start
) == endpos
&& insertion
)
1919 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1920 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1923 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1924 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1926 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1927 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1931 for (tail
= current_buffer
->overlays_after
;
1933 tail
= XCONS (tail
)->cdr
)
1935 int startpos
, endpos
;
1938 overlay
= XCONS (tail
)->car
;
1940 ostart
= OVERLAY_START (overlay
);
1941 oend
= OVERLAY_END (overlay
);
1942 startpos
= OVERLAY_POSITION (ostart
);
1943 if (XFASTINT (end
) < startpos
)
1945 if (XFASTINT (end
) == startpos
&& insertion
)
1947 prop
= Foverlay_get (overlay
, Qinsert_in_front_hooks
);
1948 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1950 if (XFASTINT (start
) == endpos
&& insertion
)
1952 prop
= Foverlay_get (overlay
, Qinsert_behind_hooks
);
1953 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1956 ? (XFASTINT (start
) > startpos
&& XFASTINT (end
) < endpos
)
1957 : (XFASTINT (start
) >= startpos
&& XFASTINT (end
) <= endpos
))
1959 prop
= Foverlay_get (overlay
, Qmodification_hooks
);
1960 call_overlay_mod_hooks (prop
, overlay
, start
, end
);
1966 call_overlay_mod_hooks (list
, overlay
, start
, end
)
1967 Lisp_Object list
, overlay
, start
, end
;
1969 struct gcpro gcpro1
;
1971 while (!NILP (list
))
1973 call3 (Fcar (list
), overlay
, start
, end
);
1979 /* Somebody has tried to store NEWVAL into the buffer-local slot with
1980 offset XUINT (valcontents), and NEWVAL has an unacceptable type. */
1982 buffer_slot_type_mismatch (valcontents
, newval
)
1983 Lisp_Object valcontents
, newval
;
1985 unsigned int offset
= XUINT (valcontents
);
1986 unsigned char *symbol_name
=
1987 (XSYMBOL (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
))
1991 switch (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
)))
1993 case Lisp_Int
: type_name
= "integers"; break;
1994 case Lisp_String
: type_name
= "strings"; break;
1995 case Lisp_Marker
: type_name
= "markers"; break;
1996 case Lisp_Symbol
: type_name
= "symbols"; break;
1997 case Lisp_Cons
: type_name
= "lists"; break;
1998 case Lisp_Vector
: type_name
= "vectors"; break;
2003 error ("only %s should be stored in the buffer-local variable %s",
2004 type_name
, symbol_name
);
2009 register Lisp_Object tem
;
2011 /* Make sure all markable slots in buffer_defaults
2012 are initialized reasonably, so mark_buffer won't choke. */
2013 reset_buffer (&buffer_defaults
);
2014 reset_buffer (&buffer_local_symbols
);
2015 XSET (Vbuffer_defaults
, Lisp_Buffer
, &buffer_defaults
);
2016 XSET (Vbuffer_local_symbols
, Lisp_Buffer
, &buffer_local_symbols
);
2018 /* Set up the default values of various buffer slots. */
2019 /* Must do these before making the first buffer! */
2021 /* real setup is done in loaddefs.el */
2022 buffer_defaults
.mode_line_format
= build_string ("%-");
2023 buffer_defaults
.abbrev_mode
= Qnil
;
2024 buffer_defaults
.overwrite_mode
= Qnil
;
2025 buffer_defaults
.case_fold_search
= Qt
;
2026 buffer_defaults
.auto_fill_function
= Qnil
;
2027 buffer_defaults
.selective_display
= Qnil
;
2029 buffer_defaults
.selective_display_ellipses
= Qt
;
2031 buffer_defaults
.abbrev_table
= Qnil
;
2032 buffer_defaults
.display_table
= Qnil
;
2033 buffer_defaults
.undo_list
= Qnil
;
2034 buffer_defaults
.mark_active
= Qnil
;
2035 buffer_defaults
.overlays_before
= Qnil
;
2036 buffer_defaults
.overlays_after
= Qnil
;
2037 XFASTINT (buffer_defaults
.overlay_center
) = 1;
2039 XFASTINT (buffer_defaults
.tab_width
) = 8;
2040 buffer_defaults
.truncate_lines
= Qnil
;
2041 buffer_defaults
.ctl_arrow
= Qt
;
2043 XFASTINT (buffer_defaults
.fill_column
) = 70;
2044 XFASTINT (buffer_defaults
.left_margin
) = 0;
2046 /* Assign the local-flags to the slots that have default values.
2047 The local flag is a bit that is used in the buffer
2048 to say that it has its own local value for the slot.
2049 The local flag bits are in the local_var_flags slot of the buffer. */
2051 /* Nothing can work if this isn't true */
2052 if (sizeof (int) != sizeof (Lisp_Object
)) abort ();
2054 /* 0 means not a lisp var, -1 means always local, else mask */
2055 bzero (&buffer_local_flags
, sizeof buffer_local_flags
);
2056 XFASTINT (buffer_local_flags
.filename
) = -1;
2057 XFASTINT (buffer_local_flags
.directory
) = -1;
2058 XFASTINT (buffer_local_flags
.backed_up
) = -1;
2059 XFASTINT (buffer_local_flags
.save_length
) = -1;
2060 XFASTINT (buffer_local_flags
.auto_save_file_name
) = -1;
2061 XFASTINT (buffer_local_flags
.read_only
) = -1;
2062 XFASTINT (buffer_local_flags
.major_mode
) = -1;
2063 XFASTINT (buffer_local_flags
.mode_name
) = -1;
2064 XFASTINT (buffer_local_flags
.undo_list
) = -1;
2065 XFASTINT (buffer_local_flags
.mark_active
) = -1;
2067 XFASTINT (buffer_local_flags
.mode_line_format
) = 1;
2068 XFASTINT (buffer_local_flags
.abbrev_mode
) = 2;
2069 XFASTINT (buffer_local_flags
.overwrite_mode
) = 4;
2070 XFASTINT (buffer_local_flags
.case_fold_search
) = 8;
2071 XFASTINT (buffer_local_flags
.auto_fill_function
) = 0x10;
2072 XFASTINT (buffer_local_flags
.selective_display
) = 0x20;
2074 XFASTINT (buffer_local_flags
.selective_display_ellipses
) = 0x40;
2076 XFASTINT (buffer_local_flags
.tab_width
) = 0x80;
2077 XFASTINT (buffer_local_flags
.truncate_lines
) = 0x100;
2078 XFASTINT (buffer_local_flags
.ctl_arrow
) = 0x200;
2079 XFASTINT (buffer_local_flags
.fill_column
) = 0x400;
2080 XFASTINT (buffer_local_flags
.left_margin
) = 0x800;
2081 XFASTINT (buffer_local_flags
.abbrev_table
) = 0x1000;
2082 XFASTINT (buffer_local_flags
.display_table
) = 0x2000;
2083 XFASTINT (buffer_local_flags
.syntax_table
) = 0x8000;
2085 Vbuffer_alist
= Qnil
;
2089 QSFundamental
= build_string ("Fundamental");
2091 Qfundamental_mode
= intern ("fundamental-mode");
2092 buffer_defaults
.major_mode
= Qfundamental_mode
;
2094 Qmode_class
= intern ("mode-class");
2096 Qprotected_field
= intern ("protected-field");
2098 Qpermanent_local
= intern ("permanent-local");
2100 Qkill_buffer_hook
= intern ("kill-buffer-hook");
2102 Vprin1_to_string_buffer
= Fget_buffer_create (build_string (" prin1"));
2103 /* super-magic invisible buffer */
2104 Vbuffer_alist
= Qnil
;
2106 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2111 char buf
[MAXPATHLEN
+1];
2113 struct stat dotstat
, pwdstat
;
2116 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2118 /* If PWD is accurate, use it instead of calling getwd. This is faster
2119 when PWD is right, and may avoid a fatal error. */
2120 if ((pwd
= getenv ("PWD")) != 0 && *pwd
== '/'
2121 && stat (pwd
, &pwdstat
) == 0
2122 && stat (".", &dotstat
) == 0
2123 && dotstat
.st_ino
== pwdstat
.st_ino
2124 && dotstat
.st_dev
== pwdstat
.st_dev
2125 && strlen (pwd
) < MAXPATHLEN
)
2127 else if (getwd (buf
) == 0)
2128 fatal ("`getwd' failed: %s.\n", buf
);
2131 /* Maybe this should really use some standard subroutine
2132 whose definition is filename syntax dependent. */
2133 if (buf
[strlen (buf
) - 1] != '/')
2135 #endif /* not VMS */
2136 current_buffer
->directory
= build_string (buf
);
2138 temp
= get_minibuffer (0);
2139 XBUFFER (temp
)->directory
= current_buffer
->directory
;
2142 /* initialize the buffer routines */
2145 extern Lisp_Object Qdisabled
;
2147 staticpro (&Vbuffer_defaults
);
2148 staticpro (&Vbuffer_local_symbols
);
2149 staticpro (&Qfundamental_mode
);
2150 staticpro (&Qmode_class
);
2151 staticpro (&QSFundamental
);
2152 staticpro (&Vbuffer_alist
);
2153 staticpro (&Qprotected_field
);
2154 staticpro (&Qpermanent_local
);
2155 staticpro (&Qkill_buffer_hook
);
2156 staticpro (&Qoverlayp
);
2158 Qoverlayp
= intern ("overlayp");
2160 Fput (Qprotected_field
, Qerror_conditions
,
2161 Fcons (Qprotected_field
, Fcons (Qerror
, Qnil
)));
2162 Fput (Qprotected_field
, Qerror_message
,
2163 build_string ("Attempt to modify a protected field"));
2165 Fput (intern ("erase-buffer"), Qdisabled
, Qt
);
2167 /* All these use DEFVAR_LISP_NOPRO because the slots in
2168 buffer_defaults will all be marked via Vbuffer_defaults. */
2170 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2171 &buffer_defaults
.mode_line_format
,
2172 "Default value of `mode-line-format' for buffers that don't override it.\n\
2173 This is the same as (default-value 'mode-line-format).");
2175 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2176 &buffer_defaults
.abbrev_mode
,
2177 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2178 This is the same as (default-value 'abbrev-mode).");
2180 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2181 &buffer_defaults
.ctl_arrow
,
2182 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2183 This is the same as (default-value 'ctl-arrow).");
2185 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2186 &buffer_defaults
.truncate_lines
,
2187 "Default value of `truncate-lines' for buffers that do not override it.\n\
2188 This is the same as (default-value 'truncate-lines).");
2190 DEFVAR_LISP_NOPRO ("default-fill-column",
2191 &buffer_defaults
.fill_column
,
2192 "Default value of `fill-column' for buffers that do not override it.\n\
2193 This is the same as (default-value 'fill-column).");
2195 DEFVAR_LISP_NOPRO ("default-left-margin",
2196 &buffer_defaults
.left_margin
,
2197 "Default value of `left-margin' for buffers that do not override it.\n\
2198 This is the same as (default-value 'left-margin).");
2200 DEFVAR_LISP_NOPRO ("default-tab-width",
2201 &buffer_defaults
.tab_width
,
2202 "Default value of `tab-width' for buffers that do not override it.\n\
2203 This is the same as (default-value 'tab-width).");
2205 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2206 &buffer_defaults
.case_fold_search
,
2207 "Default value of `case-fold-search' for buffers that don't override it.\n\
2208 This is the same as (default-value 'case-fold-search).");
2210 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer
->mode_line_format
,
2213 /* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2214 But make-docfile finds it!
2215 DEFVAR_PER_BUFFER ("mode-line-format", ¤t_buffer->mode_line_format,
2217 "Template for displaying mode line for current buffer.\n\
2218 Each buffer has its own value of this variable.\n\
2219 Value may be a string, a symbol or a list or cons cell.\n\
2220 For a symbol, its value is used (but it is ignored if t or nil).\n\
2221 A string appearing directly as the value of a symbol is processed verbatim\n\
2222 in that the %-constructs below are not recognized.\n\
2223 For a list whose car is a symbol, the symbol's value is taken,\n\
2224 and if that is non-nil, the cadr of the list is processed recursively.\n\
2225 Otherwise, the caddr of the list (if there is one) is processed.\n\
2226 For a list whose car is a string or list, each element is processed\n\
2227 recursively and the results are effectively concatenated.\n\
2228 For a list whose car is an integer, the cdr of the list is processed\n\
2229 and padded (if the number is positive) or truncated (if negative)\n\
2230 to the width specified by that number.\n\
2231 A string is printed verbatim in the mode line except for %-constructs:\n\
2232 (%-constructs are allowed when the string is the entire mode-line-format\n\
2233 or when it is found in a cons-cell or a list)\n\
2234 %b -- print buffer name. %f -- print visited file name.\n\
2235 %* -- print *, % or hyphen. %m -- print value of mode-name (obsolete).\n\
2236 %s -- print process status. %l -- print the current line number.\n\
2237 %p -- print percent of buffer above top of window, or top, bot or all.\n\
2238 %n -- print Narrow if appropriate.\n\
2239 %[ -- print one [ for each recursive editing level. %] similar.\n\
2240 %% -- print %. %- -- print infinitely many dashes.\n\
2241 Decimal digits after the % specify field width to which to pad.");
2244 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults
.major_mode
,
2245 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2246 nil here means use current buffer's major mode.");
2248 DEFVAR_PER_BUFFER ("major-mode", ¤t_buffer
->major_mode
,
2249 make_number (Lisp_Symbol
),
2250 "Symbol for current buffer's major mode.");
2252 DEFVAR_PER_BUFFER ("mode-name", ¤t_buffer
->mode_name
,
2253 make_number (Lisp_String
),
2254 "Pretty name of current buffer's major mode (a string).");
2256 DEFVAR_PER_BUFFER ("abbrev-mode", ¤t_buffer
->abbrev_mode
, Qnil
,
2257 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2258 Automatically becomes buffer-local when set in any fashion.");
2260 DEFVAR_PER_BUFFER ("case-fold-search", ¤t_buffer
->case_fold_search
,
2262 "*Non-nil if searches should ignore case.\n\
2263 Automatically becomes buffer-local when set in any fashion.");
2265 DEFVAR_PER_BUFFER ("fill-column", ¤t_buffer
->fill_column
,
2266 make_number (Lisp_Int
),
2267 "*Column beyond which automatic line-wrapping should happen.\n\
2268 Automatically becomes buffer-local when set in any fashion.");
2270 DEFVAR_PER_BUFFER ("left-margin", ¤t_buffer
->left_margin
,
2271 make_number (Lisp_Int
),
2272 "*Column for the default indent-line-function to indent to.\n\
2273 Linefeed indents to this column in Fundamental mode.\n\
2274 Automatically becomes buffer-local when set in any fashion.");
2276 DEFVAR_PER_BUFFER ("tab-width", ¤t_buffer
->tab_width
,
2277 make_number (Lisp_Int
),
2278 "*Distance between tab stops (for display of tab characters), in columns.\n\
2279 Automatically becomes buffer-local when set in any fashion.");
2281 DEFVAR_PER_BUFFER ("ctl-arrow", ¤t_buffer
->ctl_arrow
, Qnil
,
2282 "*Non-nil means display control chars with uparrow.\n\
2283 Nil means use backslash and octal digits.\n\
2284 Automatically becomes buffer-local when set in any fashion.\n\
2285 This variable does not apply to characters whose display is specified\n\
2286 in the current display table (if there is one).");
2288 DEFVAR_PER_BUFFER ("truncate-lines", ¤t_buffer
->truncate_lines
, Qnil
,
2289 "*Non-nil means do not display continuation lines;\n\
2290 give each line of text one screen line.\n\
2291 Automatically becomes buffer-local when set in any fashion.\n\
2293 Note that this is overridden by the variable\n\
2294 `truncate-partial-width-windows' if that variable is non-nil\n\
2295 and this buffer is not full-frame width.");
2297 DEFVAR_PER_BUFFER ("default-directory", ¤t_buffer
->directory
,
2298 make_number (Lisp_String
),
2299 "Name of default directory of current buffer. Should end with slash.\n\
2300 Each buffer has its own value of this variable.");
2302 DEFVAR_PER_BUFFER ("auto-fill-function", ¤t_buffer
->auto_fill_function
,
2304 "Function called (if non-nil) to perform auto-fill.\n\
2305 It is called after self-inserting a space at a column beyond `fill-column'.\n\
2306 Each buffer has its own value of this variable.\n\
2307 NOTE: This variable is not an ordinary hook;\n\
2308 It may not be a list of functions.");
2310 DEFVAR_PER_BUFFER ("buffer-file-name", ¤t_buffer
->filename
,
2311 make_number (Lisp_String
),
2312 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2313 Each buffer has its own value of this variable.");
2315 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2316 ¤t_buffer
->auto_save_file_name
,
2317 make_number (Lisp_String
),
2318 "Name of file for auto-saving current buffer,\n\
2319 or nil if buffer should not be auto-saved.\n\
2320 Each buffer has its own value of this variable.");
2322 DEFVAR_PER_BUFFER ("buffer-read-only", ¤t_buffer
->read_only
, Qnil
,
2323 "Non-nil if this buffer is read-only.\n\
2324 Each buffer has its own value of this variable.");
2326 DEFVAR_PER_BUFFER ("buffer-backed-up", ¤t_buffer
->backed_up
, Qnil
,
2327 "Non-nil if this buffer's file has been backed up.\n\
2328 Backing up is done before the first time the file is saved.\n\
2329 Each buffer has its own value of this variable.");
2331 DEFVAR_PER_BUFFER ("buffer-saved-size", ¤t_buffer
->save_length
,
2332 make_number (Lisp_Int
),
2333 "Length of current buffer when last read in, saved or auto-saved.\n\
2335 Each buffer has its own value of this variable.");
2337 DEFVAR_PER_BUFFER ("selective-display", ¤t_buffer
->selective_display
,
2339 "Non-nil enables selective display:\n\
2340 Integer N as value means display only lines\n\
2341 that start with less than n columns of space.\n\
2342 A value of t means, after a ^M, all the rest of the line is invisible.\n\
2343 Then ^M's in the file are written into files as newlines.\n\n\
2344 Automatically becomes buffer-local when set in any fashion.");
2347 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2348 ¤t_buffer
->selective_display_ellipses
,
2350 "t means display ... on previous line when a line is invisible.\n\
2351 Automatically becomes buffer-local when set in any fashion.");
2354 DEFVAR_PER_BUFFER ("overwrite-mode", ¤t_buffer
->overwrite_mode
, Qnil
,
2355 "Non-nil if self-insertion should replace existing text.\n\
2356 If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2357 inserts at the end of a line, and inserts when point is before a tab,\n\
2358 until the tab is filled in.\n\
2359 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2360 Automatically becomes buffer-local when set in any fashion.");
2362 DEFVAR_PER_BUFFER ("buffer-display-table", ¤t_buffer
->display_table
,
2364 "Display table that controls display of the contents of current buffer.\n\
2365 Automatically becomes buffer-local when set in any fashion.\n\
2366 The display table is a vector created with `make-display-table'.\n\
2367 The first 256 elements control how to display each possible text character.\n\
2368 Each value should be a vector of characters or nil;\n\
2369 nil means display the character in the default fashion.\n\
2370 The remaining five elements control the display of\n\
2371 the end of a truncated screen line (element 256, a single character);\n\
2372 the end of a continued line (element 257, a single character);\n\
2373 the escape character used to display character codes in octal\n\
2374 (element 258, a single character);\n\
2375 the character used as an arrow for control characters (element 259,\n\
2376 a single character);\n\
2377 the decoration indicating the presence of invisible lines (element 260,\n\
2378 a vector of characters).\n\
2379 If this variable is nil, the value of `standard-display-table' is used.\n\
2380 Each window can have its own, overriding display table.");
2382 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2385 DEFVAR_LISP ("before-change-function", &Vbefore_change_function
,
2386 "Function to call before each text change.\n\
2387 Two arguments are passed to the function: the positions of\n\
2388 the beginning and end of the range of old text to be changed.\n\
2389 \(For an insertion, the beginning and end are at the same place.)\n\
2390 No information is given about the length of the text after the change.\n\
2391 position of the change\n\
2393 While executing the `before-change-function', changes to buffers do not\n\
2394 cause calls to any `before-change-function' or `after-change-function'.");
2395 Vbefore_change_function
= Qnil
;
2397 DEFVAR_LISP ("after-change-function", &Vafter_change_function
,
2398 "Function to call after each text change.\n\
2399 Three arguments are passed to the function: the positions of\n\
2400 the beginning and end of the range of changed text,\n\
2401 and the length of the pre-change text replaced by that range.\n\
2402 \(For an insertion, the pre-change length is zero;\n\
2403 for a deletion, that length is the number of characters deleted,\n\
2404 and the post-change beginning and end are at the same place.)\n\
2406 While executing the `after-change-function', changes to buffers do not\n\
2407 cause calls to any `before-change-function' or `after-change-function'.");
2408 Vafter_change_function
= Qnil
;
2410 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook
,
2411 "A list of functions to call before changing a buffer which is unmodified.\n\
2412 The functions are run using the `run-hooks' function.");
2413 Vfirst_change_hook
= Qnil
;
2414 Qfirst_change_hook
= intern ("first-change-hook");
2415 staticpro (&Qfirst_change_hook
);
2417 DEFVAR_PER_BUFFER ("buffer-undo-list", ¤t_buffer
->undo_list
, Qnil
,
2418 "List of undo entries in current buffer.\n\
2419 Recent changes come first; older changes follow newer.\n\
2421 An entry (START . END) represents an insertion which begins at\n\
2422 position START and ends at position END.\n\
2424 An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2425 from (abs POSITION). If POSITION is positive, point was at the front\n\
2426 of the text being deleted; if negative, point was at the end.\n\
2428 An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2429 previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
2430 16-bit words of the buffer's modification count at the time. If the\n\
2431 modification count of the most recent save is different, this entry is\n\
2434 An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2435 was modified between BEG and END. PROP is the property name,\n\
2436 and VAL is the old value.\n\
2438 An entry of the form POSITION indicates that point was at the buffer\n\
2439 location given by the integer. Undoing an entry of this form places\n\
2440 point at POSITION.\n\
2442 nil marks undo boundaries. The undo command treats the changes\n\
2443 between two undo boundaries as a single step to be undone.\n\
2445 If the value of the variable is t, undo information is not recorded.");
2447 DEFVAR_PER_BUFFER ("mark-active", ¤t_buffer
->mark_active
, Qnil
,
2448 "Non-nil means the mark and region are currently active in this buffer.\n\
2449 Automatically local in all buffers.");
2451 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode
,
2452 "*Non-nil means deactivate the mark when the buffer contents change.");
2453 Vtransient_mark_mode
= Qnil
;
2455 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only
,
2456 "*Non-nil means disregard read-only status of buffers or characters.\n\
2457 If the value is t, disregard `buffer-read-only' and all `read-only'\n\
2458 text properties. If the value is a list, disregard `buffer-read-only'\n\
2459 and disregard a `read-only' text property if the property value\n\
2460 is a member of the list.");
2461 Vinhibit_read_only
= Qnil
;
2463 defsubr (&Sbuffer_list
);
2464 defsubr (&Sget_buffer
);
2465 defsubr (&Sget_file_buffer
);
2466 defsubr (&Sget_buffer_create
);
2467 defsubr (&Sgenerate_new_buffer_name
);
2468 defsubr (&Sbuffer_name
);
2469 /*defsubr (&Sbuffer_number);*/
2470 defsubr (&Sbuffer_file_name
);
2471 defsubr (&Sbuffer_local_variables
);
2472 defsubr (&Sbuffer_modified_p
);
2473 defsubr (&Sset_buffer_modified_p
);
2474 defsubr (&Sbuffer_modified_tick
);
2475 defsubr (&Srename_buffer
);
2476 defsubr (&Sother_buffer
);
2477 defsubr (&Sbuffer_disable_undo
);
2478 defsubr (&Sbuffer_enable_undo
);
2479 defsubr (&Skill_buffer
);
2480 defsubr (&Serase_buffer
);
2481 defsubr (&Sswitch_to_buffer
);
2482 defsubr (&Spop_to_buffer
);
2483 defsubr (&Scurrent_buffer
);
2484 defsubr (&Sset_buffer
);
2485 defsubr (&Sbarf_if_buffer_read_only
);
2486 defsubr (&Sbury_buffer
);
2487 defsubr (&Slist_buffers
);
2488 defsubr (&Skill_all_local_variables
);
2490 defsubr (&Soverlayp
);
2491 defsubr (&Smake_overlay
);
2492 defsubr (&Sdelete_overlay
);
2493 defsubr (&Smove_overlay
);
2494 defsubr (&Soverlay_start
);
2495 defsubr (&Soverlay_end
);
2496 defsubr (&Soverlay_buffer
);
2497 defsubr (&Soverlay_properties
);
2498 defsubr (&Soverlays_at
);
2499 defsubr (&Snext_overlay_change
);
2500 defsubr (&Soverlay_recenter
);
2501 defsubr (&Soverlay_lists
);
2502 defsubr (&Soverlay_get
);
2503 defsubr (&Soverlay_put
);
2508 initial_define_key (control_x_map
, 'b', "switch-to-buffer");
2509 initial_define_key (control_x_map
, 'k', "kill-buffer");
2510 initial_define_key (control_x_map
, Ctl ('B'), "list-buffers");