(Ftranspose_regions): Fix overlays after moving markers.
[bpt/emacs.git] / src / buffer.c
... / ...
CommitLineData
1/* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994
3 Free Software Foundation, Inc.
4
5This file is part of GNU Emacs.
6
7GNU Emacs is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
9the Free Software Foundation; either version 2, or (at your option)
10any later version.
11
12GNU Emacs is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
18along with GNU Emacs; see the file COPYING. If not, write to
19the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
20
21
22#include <sys/types.h>
23#include <sys/stat.h>
24#include <sys/param.h>
25
26#ifndef MAXPATHLEN
27/* in 4.1, param.h fails to define this. */
28#define MAXPATHLEN 1024
29#endif /* not MAXPATHLEN */
30
31#include <config.h>
32#include "lisp.h"
33#include "intervals.h"
34#include "window.h"
35#include "commands.h"
36#include "buffer.h"
37#include "indent.h"
38#include "blockinput.h"
39
40struct buffer *current_buffer; /* the current buffer */
41
42/* First buffer in chain of all buffers (in reverse order of creation).
43 Threaded through ->next. */
44
45struct buffer *all_buffers;
46
47/* This structure holds the default values of the buffer-local variables
48 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
49 The default value occupies the same slot in this structure
50 as an individual buffer's value occupies in that buffer.
51 Setting the default value also goes through the alist of buffers
52 and stores into each buffer that does not say it has a local value. */
53
54struct buffer buffer_defaults;
55
56/* A Lisp_Object pointer to the above, used for staticpro */
57
58static Lisp_Object Vbuffer_defaults;
59
60/* This structure marks which slots in a buffer have corresponding
61 default values in buffer_defaults.
62 Each such slot has a nonzero value in this structure.
63 The value has only one nonzero bit.
64
65 When a buffer has its own local value for a slot,
66 the bit for that slot (found in the same slot in this structure)
67 is turned on in the buffer's local_var_flags slot.
68
69 If a slot in this structure is -1, then even though there may
70 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
71 and the corresponding slot in buffer_defaults is not used.
72
73 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
74 but there is a default value which is copied into each buffer.
75
76 If a slot in this structure is negative, then even though there may
77 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
78 and the corresponding slot in buffer_defaults is not used.
79
80 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
81 zero, that is a bug */
82
83struct buffer buffer_local_flags;
84
85/* This structure holds the names of symbols whose values may be
86 buffer-local. It is indexed and accessed in the same way as the above. */
87
88struct buffer buffer_local_symbols;
89/* A Lisp_Object pointer to the above, used for staticpro */
90static Lisp_Object Vbuffer_local_symbols;
91
92/* This structure holds the required types for the values in the
93 buffer-local slots. If a slot contains Qnil, then the
94 corresponding buffer slot may contain a value of any type. If a
95 slot contains an integer, then prospective values' tags must be
96 equal to that integer. When a tag does not match, the function
97 buffer_slot_type_mismatch will signal an error. */
98struct buffer buffer_local_types;
99
100Lisp_Object Fset_buffer ();
101void set_buffer_internal ();
102static void call_overlay_mod_hooks ();
103
104/* Alist of all buffer names vs the buffers. */
105/* This used to be a variable, but is no longer,
106 to prevent lossage due to user rplac'ing this alist or its elements. */
107Lisp_Object Vbuffer_alist;
108
109/* Functions to call before and after each text change. */
110Lisp_Object Vbefore_change_function;
111Lisp_Object Vafter_change_function;
112Lisp_Object Vbefore_change_functions;
113Lisp_Object Vafter_change_functions;
114
115Lisp_Object Vtransient_mark_mode;
116
117/* t means ignore all read-only text properties.
118 A list means ignore such a property if its value is a member of the list.
119 Any non-nil value means ignore buffer-read-only. */
120Lisp_Object Vinhibit_read_only;
121
122/* List of functions to call that can query about killing a buffer.
123 If any of these functions returns nil, we don't kill it. */
124Lisp_Object Vkill_buffer_query_functions;
125
126/* List of functions to call before changing an unmodified buffer. */
127Lisp_Object Vfirst_change_hook;
128Lisp_Object Qfirst_change_hook;
129
130Lisp_Object Qfundamental_mode, Qmode_class, Qpermanent_local;
131
132Lisp_Object Qprotected_field;
133
134Lisp_Object QSFundamental; /* A string "Fundamental" */
135
136Lisp_Object Qkill_buffer_hook;
137
138Lisp_Object Qget_file_buffer;
139
140Lisp_Object Qoverlayp;
141
142Lisp_Object Qpriority, Qwindow;
143
144Lisp_Object Qmodification_hooks;
145Lisp_Object Qinsert_in_front_hooks;
146Lisp_Object Qinsert_behind_hooks;
147
148/* For debugging; temporary. See set_buffer_internal. */
149/* Lisp_Object Qlisp_mode, Vcheck_symbol; */
150
151nsberror (spec)
152 Lisp_Object spec;
153{
154 if (XTYPE (spec) == Lisp_String)
155 error ("No buffer named %s", XSTRING (spec)->data);
156 error ("Invalid buffer argument");
157}
158\f
159DEFUN ("buffer-list", Fbuffer_list, Sbuffer_list, 0, 0, 0,
160 "Return a list of all existing live buffers.")
161 ()
162{
163 return Fmapcar (Qcdr, Vbuffer_alist);
164}
165
166DEFUN ("get-buffer", Fget_buffer, Sget_buffer, 1, 1, 0,
167 "Return the buffer named NAME (a string).\n\
168If there is no live buffer named NAME, return nil.\n\
169NAME may also be a buffer; if so, the value is that buffer.")
170 (name)
171 register Lisp_Object name;
172{
173 if (XTYPE (name) == Lisp_Buffer)
174 return name;
175 CHECK_STRING (name, 0);
176
177 return Fcdr (Fassoc (name, Vbuffer_alist));
178}
179
180DEFUN ("get-file-buffer", Fget_file_buffer, Sget_file_buffer, 1, 1, 0,
181 "Return the buffer visiting file FILENAME (a string).\n\
182The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.\n\
183If there is no such live buffer, return nil.")
184 (filename)
185 register Lisp_Object filename;
186{
187 register Lisp_Object tail, buf, tem;
188 Lisp_Object handler;
189
190 CHECK_STRING (filename, 0);
191 filename = Fexpand_file_name (filename, Qnil);
192
193 /* If the file name has special constructs in it,
194 call the corresponding file handler. */
195 handler = Ffind_file_name_handler (filename, Qget_file_buffer);
196 if (!NILP (handler))
197 return call2 (handler, Qget_file_buffer, filename);
198
199 for (tail = Vbuffer_alist; CONSP (tail); tail = XCONS (tail)->cdr)
200 {
201 buf = Fcdr (XCONS (tail)->car);
202 if (XTYPE (buf) != Lisp_Buffer) continue;
203 if (XTYPE (XBUFFER (buf)->filename) != Lisp_String) continue;
204 tem = Fstring_equal (XBUFFER (buf)->filename, filename);
205 if (!NILP (tem))
206 return buf;
207 }
208 return Qnil;
209}
210
211/* Incremented for each buffer created, to assign the buffer number. */
212int buffer_count;
213
214DEFUN ("get-buffer-create", Fget_buffer_create, Sget_buffer_create, 1, 1, 0,
215 "Return the buffer named NAME, or create such a buffer and return it.\n\
216A new buffer is created if there is no live buffer named NAME.\n\
217If NAME starts with a space, the new buffer does not keep undo information.\n\
218If NAME is a buffer instead of a string, then it is the value returned.\n\
219The value is never nil.")
220 (name)
221 register Lisp_Object name;
222{
223 register Lisp_Object buf, function, tem;
224 int count = specpdl_ptr - specpdl;
225 register struct buffer *b;
226
227 buf = Fget_buffer (name);
228 if (!NILP (buf))
229 return buf;
230
231 if (XSTRING (name)->size == 0)
232 error ("Empty string for buffer name is not allowed");
233
234 b = (struct buffer *) xmalloc (sizeof (struct buffer));
235
236 BUF_GAP_SIZE (b) = 20;
237 BLOCK_INPUT;
238 BUFFER_ALLOC (BUF_BEG_ADDR (b), BUF_GAP_SIZE (b));
239 UNBLOCK_INPUT;
240 if (! BUF_BEG_ADDR (b))
241 memory_full ();
242
243 BUF_PT (b) = 1;
244 BUF_GPT (b) = 1;
245 BUF_BEGV (b) = 1;
246 BUF_ZV (b) = 1;
247 BUF_Z (b) = 1;
248 BUF_MODIFF (b) = 1;
249
250 /* Put this on the chain of all buffers including killed ones. */
251 b->next = all_buffers;
252 all_buffers = b;
253
254 b->mark = Fmake_marker ();
255 /*b->number = make_number (++buffer_count);*/
256 b->name = name;
257 if (XSTRING (name)->data[0] != ' ')
258 b->undo_list = Qnil;
259 else
260 b->undo_list = Qt;
261
262 reset_buffer (b);
263
264 /* Put this in the alist of all live buffers. */
265 XSET (buf, Lisp_Buffer, b);
266 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
267
268 b->mark = Fmake_marker ();
269 b->markers = Qnil;
270 b->name = name;
271
272 function = buffer_defaults.major_mode;
273 if (NILP (function))
274 {
275 tem = Fget (current_buffer->major_mode, Qmode_class);
276 if (EQ (tem, Qnil))
277 function = current_buffer->major_mode;
278 }
279
280 if (NILP (function) || EQ (function, Qfundamental_mode))
281 return buf;
282
283 /* To select a nonfundamental mode,
284 select the buffer temporarily and then call the mode function. */
285
286 record_unwind_protect (save_excursion_restore, save_excursion_save ());
287
288 Fset_buffer (buf);
289 call0 (function);
290
291 return unbind_to (count, buf);
292}
293
294/* Reinitialize everything about a buffer except its name and contents. */
295
296void
297reset_buffer (b)
298 register struct buffer *b;
299{
300 b->filename = Qnil;
301 b->directory = (current_buffer) ? current_buffer->directory : Qnil;
302 b->modtime = 0;
303 b->save_modified = 1;
304 XFASTINT (b->save_length) = 0;
305 b->last_window_start = 1;
306 b->backed_up = Qnil;
307 b->auto_save_modified = 0;
308 b->auto_save_failure_time = -1;
309 b->auto_save_file_name = Qnil;
310 b->read_only = Qnil;
311 b->overlays_before = Qnil;
312 b->overlays_after = Qnil;
313 XFASTINT (b->overlay_center) = 1;
314 b->mark_active = Qnil;
315
316 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
317 INITIALIZE_INTERVAL (b, NULL_INTERVAL);
318
319 reset_buffer_local_variables(b);
320}
321
322reset_buffer_local_variables (b)
323 register struct buffer *b;
324{
325 register int offset;
326
327 /* Reset the major mode to Fundamental, together with all the
328 things that depend on the major mode.
329 default-major-mode is handled at a higher level.
330 We ignore it here. */
331 b->major_mode = Qfundamental_mode;
332 b->keymap = Qnil;
333 b->abbrev_table = Vfundamental_mode_abbrev_table;
334 b->mode_name = QSFundamental;
335 b->minor_modes = Qnil;
336 b->downcase_table = Vascii_downcase_table;
337 b->upcase_table = Vascii_upcase_table;
338 b->case_canon_table = Vascii_canon_table;
339 b->case_eqv_table = Vascii_eqv_table;
340#if 0
341 b->sort_table = XSTRING (Vascii_sort_table);
342 b->folding_sort_table = XSTRING (Vascii_folding_sort_table);
343#endif /* 0 */
344
345 /* Reset all per-buffer variables to their defaults. */
346 b->local_var_alist = Qnil;
347 b->local_var_flags = 0;
348
349 /* For each slot that has a default value,
350 copy that into the slot. */
351
352 for (offset = (char *)&buffer_local_flags.name - (char *)&buffer_local_flags;
353 offset < sizeof (struct buffer);
354 offset += sizeof (Lisp_Object)) /* sizeof int == sizeof Lisp_Object */
355 if (*(int *)(offset + (char *) &buffer_local_flags) > 0
356 || *(int *)(offset + (char *) &buffer_local_flags) == -2)
357 *(Lisp_Object *)(offset + (char *)b) =
358 *(Lisp_Object *)(offset + (char *)&buffer_defaults);
359}
360
361/* We split this away from generate-new-buffer, because rename-buffer
362 and set-visited-file-name ought to be able to use this to really
363 rename the buffer properly. */
364
365DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name, Sgenerate_new_buffer_name,
366 1, 2, 0,
367 "Return a string that is the name of no existing buffer based on NAME.\n\
368If there is no live buffer named NAME, then return NAME.\n\
369Otherwise modify name by appending `<NUMBER>', incrementing NUMBER\n\
370until an unused name is found, and then return that name.\n\
371Optional second argument IGNORE specifies a name that is okay to use\n\
372\(if it is in the sequence to be tried)\n\
373even if a buffer with that name exists.")
374 (name, ignore)
375 register Lisp_Object name, ignore;
376{
377 register Lisp_Object gentemp, tem;
378 int count;
379 char number[10];
380
381 CHECK_STRING (name, 0);
382
383 tem = Fget_buffer (name);
384 if (NILP (tem))
385 return name;
386
387 count = 1;
388 while (1)
389 {
390 sprintf (number, "<%d>", ++count);
391 gentemp = concat2 (name, build_string (number));
392 tem = Fstring_equal (gentemp, ignore);
393 if (!NILP (tem))
394 return gentemp;
395 tem = Fget_buffer (gentemp);
396 if (NILP (tem))
397 return gentemp;
398 }
399}
400
401\f
402DEFUN ("buffer-name", Fbuffer_name, Sbuffer_name, 0, 1, 0,
403 "Return the name of BUFFER, as a string.\n\
404With no argument or nil as argument, return the name of the current buffer.")
405 (buffer)
406 register Lisp_Object buffer;
407{
408 if (NILP (buffer))
409 return current_buffer->name;
410 CHECK_BUFFER (buffer, 0);
411 return XBUFFER (buffer)->name;
412}
413
414DEFUN ("buffer-file-name", Fbuffer_file_name, Sbuffer_file_name, 0, 1, 0,
415 "Return name of file BUFFER is visiting, or nil if none.\n\
416No argument or nil as argument means use the current buffer.")
417 (buffer)
418 register Lisp_Object buffer;
419{
420 if (NILP (buffer))
421 return current_buffer->filename;
422 CHECK_BUFFER (buffer, 0);
423 return XBUFFER (buffer)->filename;
424}
425
426DEFUN ("buffer-local-variables", Fbuffer_local_variables,
427 Sbuffer_local_variables, 0, 1, 0,
428 "Return an alist of variables that are buffer-local in BUFFER.\n\
429Most elements look like (SYMBOL . VALUE), describing one variable.\n\
430For a symbol that is locally unbound, just the symbol appears in the value.\n\
431Note that storing new VALUEs in these elements doesn't change the variables.\n\
432No argument or nil as argument means use current buffer as BUFFER.")
433 (buffer)
434 register Lisp_Object buffer;
435{
436 register struct buffer *buf;
437 register Lisp_Object result;
438
439 if (NILP (buffer))
440 buf = current_buffer;
441 else
442 {
443 CHECK_BUFFER (buffer, 0);
444 buf = XBUFFER (buffer);
445 }
446
447 result = Qnil;
448
449 {
450 /* Reference each variable in the alist in our current buffer.
451 If inquiring about the current buffer, this gets the current values,
452 so store them into the alist so the alist is up to date.
453 If inquiring about some other buffer, this swaps out any values
454 for that buffer, making the alist up to date automatically. */
455 register Lisp_Object tail;
456 for (tail = buf->local_var_alist; CONSP (tail); tail = XCONS (tail)->cdr)
457 {
458 Lisp_Object val, elt;
459
460 elt = XCONS (tail)->car;
461
462 if (buf == current_buffer)
463 val = find_symbol_value (XCONS (elt)->car);
464 else
465 val = XCONS (elt)->cdr;
466
467 /* If symbol is unbound, put just the symbol in the list. */
468 if (EQ (val, Qunbound))
469 result = Fcons (XCONS (elt)->car, result);
470 /* Otherwise, put (symbol . value) in the list. */
471 else
472 result = Fcons (Fcons (XCONS (elt)->car, val), result);
473 }
474 }
475
476 /* Add on all the variables stored in special slots. */
477 {
478 register int offset, mask;
479
480 for (offset = (char *)&buffer_local_symbols.name - (char *)&buffer_local_symbols;
481 offset < sizeof (struct buffer);
482 offset += (sizeof (int))) /* sizeof int == sizeof Lisp_Object */
483 {
484 mask = *(int *)(offset + (char *) &buffer_local_flags);
485 if (mask == -1 || (buf->local_var_flags & mask))
486 if (XTYPE (*(Lisp_Object *)(offset + (char *)&buffer_local_symbols))
487 == Lisp_Symbol)
488 result = Fcons (Fcons (*(Lisp_Object *)(offset + (char *)&buffer_local_symbols),
489 *(Lisp_Object *)(offset + (char *)buf)),
490 result);
491 }
492 }
493
494 return result;
495}
496
497\f
498DEFUN ("buffer-modified-p", Fbuffer_modified_p, Sbuffer_modified_p,
499 0, 1, 0,
500 "Return t if BUFFER was modified since its file was last read or saved.\n\
501No argument or nil as argument means use current buffer as BUFFER.")
502 (buffer)
503 register Lisp_Object buffer;
504{
505 register struct buffer *buf;
506 if (NILP (buffer))
507 buf = current_buffer;
508 else
509 {
510 CHECK_BUFFER (buffer, 0);
511 buf = XBUFFER (buffer);
512 }
513
514 return buf->save_modified < BUF_MODIFF (buf) ? Qt : Qnil;
515}
516
517DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
518 1, 1, 0,
519 "Mark current buffer as modified or unmodified according to FLAG.\n\
520A non-nil FLAG means mark the buffer modified.")
521 (flag)
522 register Lisp_Object flag;
523{
524 register int already;
525 register Lisp_Object fn;
526
527#ifdef CLASH_DETECTION
528 /* If buffer becoming modified, lock the file.
529 If buffer becoming unmodified, unlock the file. */
530
531 fn = current_buffer->filename;
532 if (!NILP (fn))
533 {
534 already = current_buffer->save_modified < MODIFF;
535 if (!already && !NILP (flag))
536 lock_file (fn);
537 else if (already && NILP (flag))
538 unlock_file (fn);
539 }
540#endif /* CLASH_DETECTION */
541
542 current_buffer->save_modified = NILP (flag) ? MODIFF : 0;
543 update_mode_lines++;
544 return flag;
545}
546
547DEFUN ("buffer-modified-tick", Fbuffer_modified_tick, Sbuffer_modified_tick,
548 0, 1, 0,
549 "Return BUFFER's tick counter, incremented for each change in text.\n\
550Each buffer has a tick counter which is incremented each time the text in\n\
551that buffer is changed. It wraps around occasionally.\n\
552No argument or nil as argument means use current buffer as BUFFER.")
553 (buffer)
554 register Lisp_Object buffer;
555{
556 register struct buffer *buf;
557 if (NILP (buffer))
558 buf = current_buffer;
559 else
560 {
561 CHECK_BUFFER (buffer, 0);
562 buf = XBUFFER (buffer);
563 }
564
565 return make_number (BUF_MODIFF (buf));
566}
567\f
568DEFUN ("rename-buffer", Frename_buffer, Srename_buffer, 1, 2,
569 "sRename buffer (to new name): \nP",
570 "Change current buffer's name to NEWNAME (a string).\n\
571If second arg UNIQUE is nil or omitted, it is an error if a\n\
572buffer named NEWNAME already exists.\n\
573If UNIQUE is non-nil, come up with a new name using\n\
574`generate-new-buffer-name'.\n\
575Interactively, you can set UNIQUE with a prefix argument.\n\
576We return the name we actually gave the buffer.\n\
577This does not change the name of the visited file (if any).")
578 (name, unique)
579 register Lisp_Object name, unique;
580{
581 register Lisp_Object tem, buf;
582
583 CHECK_STRING (name, 0);
584
585 if (XSTRING (name)->size == 0)
586 error ("Empty string is invalid as a buffer name");
587
588 tem = Fget_buffer (name);
589 /* Don't short-circuit if UNIQUE is t. That is a useful way to rename
590 the buffer automatically so you can create another with the original name.
591 It makes UNIQUE equivalent to
592 (rename-buffer (generate-new-buffer-name NAME)). */
593 if (NILP (unique) && XBUFFER (tem) == current_buffer)
594 return current_buffer->name;
595 if (!NILP (tem))
596 {
597 if (!NILP (unique))
598 name = Fgenerate_new_buffer_name (name, current_buffer->name);
599 else
600 error ("Buffer name \"%s\" is in use", XSTRING (name)->data);
601 }
602
603 current_buffer->name = name;
604
605 /* Catch redisplay's attention. Unless we do this, the mode lines for
606 any windows displaying current_buffer will stay unchanged. */
607 update_mode_lines++;
608
609 XSET (buf, Lisp_Buffer, current_buffer);
610 Fsetcar (Frassq (buf, Vbuffer_alist), name);
611 if (NILP (current_buffer->filename) && !NILP (current_buffer->auto_save_file_name))
612 call0 (intern ("rename-auto-save-file"));
613 return name;
614}
615
616DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 2, 0,
617 "Return most recently selected buffer other than BUFFER.\n\
618Buffers not visible in windows are preferred to visible buffers,\n\
619unless optional second argument VISIBLE-OK is non-nil.\n\
620If no other buffer exists, the buffer `*scratch*' is returned.\n\
621If BUFFER is omitted or nil, some interesting buffer is returned.")
622 (buffer, visible_ok)
623 register Lisp_Object buffer, visible_ok;
624{
625 register Lisp_Object tail, buf, notsogood, tem;
626 notsogood = Qnil;
627
628 for (tail = Vbuffer_alist; !NILP (tail); tail = Fcdr (tail))
629 {
630 buf = Fcdr (Fcar (tail));
631 if (EQ (buf, buffer))
632 continue;
633 if (XSTRING (XBUFFER (buf)->name)->data[0] == ' ')
634 continue;
635 if (NILP (visible_ok))
636 tem = Fget_buffer_window (buf, Qt);
637 else
638 tem = Qnil;
639 if (NILP (tem))
640 return buf;
641 if (NILP (notsogood))
642 notsogood = buf;
643 }
644 if (!NILP (notsogood))
645 return notsogood;
646 return Fget_buffer_create (build_string ("*scratch*"));
647}
648\f
649DEFUN ("buffer-disable-undo", Fbuffer_disable_undo, Sbuffer_disable_undo, 0, 1,
6500,
651 "Make BUFFER stop keeping undo information.\n\
652No argument or nil as argument means do this for the current buffer.")
653 (buffer)
654 register Lisp_Object buffer;
655{
656 Lisp_Object real_buffer;
657
658 if (NILP (buffer))
659 XSET (real_buffer, Lisp_Buffer, current_buffer);
660 else
661 {
662 real_buffer = Fget_buffer (buffer);
663 if (NILP (real_buffer))
664 nsberror (buffer);
665 }
666
667 XBUFFER (real_buffer)->undo_list = Qt;
668
669 return Qnil;
670}
671
672DEFUN ("buffer-enable-undo", Fbuffer_enable_undo, Sbuffer_enable_undo,
673 0, 1, "",
674 "Start keeping undo information for buffer BUFFER.\n\
675No argument or nil as argument means do this for the current buffer.")
676 (buffer)
677 register Lisp_Object buffer;
678{
679 Lisp_Object real_buffer;
680
681 if (NILP (buffer))
682 XSET (real_buffer, Lisp_Buffer, current_buffer);
683 else
684 {
685 real_buffer = Fget_buffer (buffer);
686 if (NILP (real_buffer))
687 nsberror (buffer);
688 }
689
690 if (EQ (XBUFFER (real_buffer)->undo_list, Qt))
691 XBUFFER (real_buffer)->undo_list = Qnil;
692
693 return Qnil;
694}
695
696/*
697 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
698Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
699The buffer being killed will be current while the hook is running.\n\
700See `kill-buffer'."
701 */
702DEFUN ("kill-buffer", Fkill_buffer, Skill_buffer, 1, 1, "bKill buffer: ",
703 "Kill the buffer BUFFER.\n\
704The argument may be a buffer or may be the name of a buffer.\n\
705An argument of nil means kill the current buffer.\n\n\
706Value is t if the buffer is actually killed, nil if user says no.\n\n\
707The value of `kill-buffer-hook' (which may be local to that buffer),\n\
708if not void, is a list of functions to be called, with no arguments,\n\
709before the buffer is actually killed. The buffer to be killed is current\n\
710when the hook functions are called.\n\n\
711Any processes that have this buffer as the `process-buffer' are killed\n\
712with `delete-process'.")
713 (bufname)
714 Lisp_Object bufname;
715{
716 Lisp_Object buf;
717 register struct buffer *b;
718 register Lisp_Object tem;
719 register struct Lisp_Marker *m;
720 struct gcpro gcpro1, gcpro2;
721
722 if (NILP (bufname))
723 buf = Fcurrent_buffer ();
724 else
725 buf = Fget_buffer (bufname);
726 if (NILP (buf))
727 nsberror (bufname);
728
729 b = XBUFFER (buf);
730
731 /* Query if the buffer is still modified. */
732 if (INTERACTIVE && !NILP (b->filename)
733 && BUF_MODIFF (b) > b->save_modified)
734 {
735 GCPRO2 (buf, bufname);
736 tem = do_yes_or_no_p (format1 ("Buffer %s modified; kill anyway? ",
737 XSTRING (b->name)->data));
738 UNGCPRO;
739 if (NILP (tem))
740 return Qnil;
741 }
742
743 /* Run hooks with the buffer to be killed the current buffer. */
744 {
745 register Lisp_Object val;
746 int count = specpdl_ptr - specpdl;
747 Lisp_Object list;
748
749 record_unwind_protect (save_excursion_restore, save_excursion_save ());
750 set_buffer_internal (b);
751
752 /* First run the query functions; if any query is answered no,
753 don't kill the buffer. */
754 for (list = Vkill_buffer_query_functions; !NILP (list); list = Fcdr (list))
755 {
756 tem = call0 (Fcar (list));
757 if (NILP (tem))
758 return unbind_to (count, Qnil);
759 }
760
761 /* Then run the hooks. */
762 if (!NILP (Vrun_hooks))
763 call1 (Vrun_hooks, Qkill_buffer_hook);
764 unbind_to (count, Qnil);
765 }
766
767 /* We have no more questions to ask. Verify that it is valid
768 to kill the buffer. This must be done after the questions
769 since anything can happen within do_yes_or_no_p. */
770
771 /* Don't kill the minibuffer now current. */
772 if (EQ (buf, XWINDOW (minibuf_window)->buffer))
773 return Qnil;
774
775 if (NILP (b->name))
776 return Qnil;
777
778 /* Make this buffer not be current.
779 In the process, notice if this is the sole visible buffer
780 and give up if so. */
781 if (b == current_buffer)
782 {
783 tem = Fother_buffer (buf, Qnil);
784 Fset_buffer (tem);
785 if (b == current_buffer)
786 return Qnil;
787 }
788
789 /* Now there is no question: we can kill the buffer. */
790
791#ifdef CLASH_DETECTION
792 /* Unlock this buffer's file, if it is locked. */
793 unlock_buffer (b);
794#endif /* CLASH_DETECTION */
795
796 kill_buffer_processes (buf);
797
798 tem = Vinhibit_quit;
799 Vinhibit_quit = Qt;
800 Vbuffer_alist = Fdelq (Frassq (buf, Vbuffer_alist), Vbuffer_alist);
801 Freplace_buffer_in_windows (buf);
802 Vinhibit_quit = tem;
803
804 /* Delete any auto-save file. */
805 if (XTYPE (b->auto_save_file_name) == Lisp_String)
806 {
807 Lisp_Object tem;
808 tem = Fsymbol_value (intern ("delete-auto-save-files"));
809 if (! NILP (tem))
810 unlink (XSTRING (b->auto_save_file_name)->data);
811 }
812
813 /* Unchain all markers of this buffer
814 and leave them pointing nowhere. */
815 for (tem = b->markers; !EQ (tem, Qnil); )
816 {
817 m = XMARKER (tem);
818 m->buffer = 0;
819 tem = m->chain;
820 m->chain = Qnil;
821 }
822 b->markers = Qnil;
823
824 /* Only defined if Emacs is compiled with USE_TEXT_PROPERTIES */
825 INITIALIZE_INTERVAL (b, NULL_INTERVAL);
826 /* Perhaps we should explicitly free the interval tree here... */
827
828 b->name = Qnil;
829 BLOCK_INPUT;
830 BUFFER_FREE (BUF_BEG_ADDR (b));
831 UNBLOCK_INPUT;
832 b->undo_list = Qnil;
833
834 return Qt;
835}
836\f
837/* Move the assoc for buffer BUF to the front of buffer-alist. Since
838 we do this each time BUF is selected visibly, the more recently
839 selected buffers are always closer to the front of the list. This
840 means that other_buffer is more likely to choose a relevant buffer. */
841
842record_buffer (buf)
843 Lisp_Object buf;
844{
845 register Lisp_Object link, prev;
846
847 prev = Qnil;
848 for (link = Vbuffer_alist; CONSP (link); link = XCONS (link)->cdr)
849 {
850 if (EQ (XCONS (XCONS (link)->car)->cdr, buf))
851 break;
852 prev = link;
853 }
854
855 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
856 we cannot use Fdelq itself here because it allows quitting. */
857
858 if (NILP (prev))
859 Vbuffer_alist = XCONS (Vbuffer_alist)->cdr;
860 else
861 XCONS (prev)->cdr = XCONS (XCONS (prev)->cdr)->cdr;
862
863 XCONS(link)->cdr = Vbuffer_alist;
864 Vbuffer_alist = link;
865}
866
867DEFUN ("switch-to-buffer", Fswitch_to_buffer, Sswitch_to_buffer, 1, 2, "BSwitch to buffer: ",
868 "Select buffer BUFFER in the current window.\n\
869BUFFER may be a buffer or a buffer name.\n\
870Optional second arg NORECORD non-nil means\n\
871do not put this buffer at the front of the list of recently selected ones.\n\
872\n\
873WARNING: This is NOT the way to work on another buffer temporarily\n\
874within a Lisp program! Use `set-buffer' instead. That avoids messing with\n\
875the window-buffer correspondences.")
876 (bufname, norecord)
877 Lisp_Object bufname, norecord;
878{
879 register Lisp_Object buf;
880 Lisp_Object tem;
881
882 if (EQ (minibuf_window, selected_window))
883 error ("Cannot switch buffers in minibuffer window");
884 tem = Fwindow_dedicated_p (selected_window);
885 if (!NILP (tem))
886 error ("Cannot switch buffers in a dedicated window");
887
888 if (NILP (bufname))
889 buf = Fother_buffer (Fcurrent_buffer (), Qnil);
890 else
891 buf = Fget_buffer_create (bufname);
892 Fset_buffer (buf);
893 if (NILP (norecord))
894 record_buffer (buf);
895
896 Fset_window_buffer (EQ (selected_window, minibuf_window)
897 ? Fnext_window (minibuf_window, Qnil, Qnil)
898 : selected_window,
899 buf);
900
901 return buf;
902}
903
904DEFUN ("pop-to-buffer", Fpop_to_buffer, Spop_to_buffer, 1, 2, 0,
905 "Select buffer BUFFER in some window, preferably a different one.\n\
906If BUFFER is nil, then some other buffer is chosen.\n\
907If `pop-up-windows' is non-nil, windows can be split to do this.\n\
908If optional second arg OTHER-WINDOW is non-nil, insist on finding another\n\
909window even if BUFFER is already visible in the selected window.")
910 (bufname, other)
911 Lisp_Object bufname, other;
912{
913 register Lisp_Object buf;
914 if (NILP (bufname))
915 buf = Fother_buffer (Fcurrent_buffer (), Qnil);
916 else
917 buf = Fget_buffer_create (bufname);
918 Fset_buffer (buf);
919 record_buffer (buf);
920 Fselect_window (Fdisplay_buffer (buf, other));
921 return buf;
922}
923
924DEFUN ("current-buffer", Fcurrent_buffer, Scurrent_buffer, 0, 0, 0,
925 "Return the current buffer as a Lisp object.")
926 ()
927{
928 register Lisp_Object buf;
929 XSET (buf, Lisp_Buffer, current_buffer);
930 return buf;
931}
932\f
933/* Set the current buffer to b */
934
935void
936set_buffer_internal (b)
937 register struct buffer *b;
938{
939 register struct buffer *old_buf;
940 register Lisp_Object tail, valcontents;
941 enum Lisp_Type tem;
942
943 if (current_buffer == b)
944 return;
945
946 windows_or_buffers_changed = 1;
947 old_buf = current_buffer;
948 current_buffer = b;
949 last_known_column_point = -1; /* invalidate indentation cache */
950
951 /* Look down buffer's list of local Lisp variables
952 to find and update any that forward into C variables. */
953
954 for (tail = b->local_var_alist; !NILP (tail); tail = XCONS (tail)->cdr)
955 {
956 valcontents = XSYMBOL (XCONS (XCONS (tail)->car)->car)->value;
957 if ((XTYPE (valcontents) == Lisp_Buffer_Local_Value
958 || XTYPE (valcontents) == Lisp_Some_Buffer_Local_Value)
959 && (tem = XTYPE (XCONS (valcontents)->car),
960 (tem == Lisp_Boolfwd || tem == Lisp_Intfwd
961 || tem == Lisp_Objfwd)))
962 /* Just reference the variable
963 to cause it to become set for this buffer. */
964 Fsymbol_value (XCONS (XCONS (tail)->car)->car);
965 }
966
967 /* Do the same with any others that were local to the previous buffer */
968
969 if (old_buf)
970 for (tail = old_buf->local_var_alist; !NILP (tail); tail = XCONS (tail)->cdr)
971 {
972 valcontents = XSYMBOL (XCONS (XCONS (tail)->car)->car)->value;
973 if ((XTYPE (valcontents) == Lisp_Buffer_Local_Value
974 || XTYPE (valcontents) == Lisp_Some_Buffer_Local_Value)
975 && (tem = XTYPE (XCONS (valcontents)->car),
976 (tem == Lisp_Boolfwd || tem == Lisp_Intfwd
977 || tem == Lisp_Objfwd)))
978 /* Just reference the variable
979 to cause it to become set for this buffer. */
980 Fsymbol_value (XCONS (XCONS (tail)->car)->car);
981 }
982}
983
984DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
985 "Make the buffer BUFFER current for editing operations.\n\
986BUFFER may be a buffer or the name of an existing buffer.\n\
987See also `save-excursion' when you want to make a buffer current temporarily.\n\
988This function does not display the buffer, so its effect ends\n\
989when the current command terminates.\n\
990Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.")
991 (bufname)
992 register Lisp_Object bufname;
993{
994 register Lisp_Object buffer;
995 buffer = Fget_buffer (bufname);
996 if (NILP (buffer))
997 nsberror (bufname);
998 if (NILP (XBUFFER (buffer)->name))
999 error ("Selecting deleted buffer");
1000 set_buffer_internal (XBUFFER (buffer));
1001 return buffer;
1002}
1003\f
1004DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only,
1005 Sbarf_if_buffer_read_only, 0, 0, 0,
1006 "Signal a `buffer-read-only' error if the current buffer is read-only.")
1007 ()
1008{
1009 if (!NILP (current_buffer->read_only)
1010 && NILP (Vinhibit_read_only))
1011 Fsignal (Qbuffer_read_only, (Fcons (Fcurrent_buffer (), Qnil)));
1012 return Qnil;
1013}
1014
1015DEFUN ("bury-buffer", Fbury_buffer, Sbury_buffer, 0, 1, "",
1016 "Put BUFFER at the end of the list of all buffers.\n\
1017There it is the least likely candidate for `other-buffer' to return;\n\
1018thus, the least likely buffer for \\[switch-to-buffer] to select by default.\n\
1019If BUFFER is nil or omitted, bury the current buffer.\n\
1020Also, if BUFFER is nil or omitted, remove the current buffer from the\n\
1021selected window if it is displayed there.")
1022 (buf)
1023 register Lisp_Object buf;
1024{
1025 /* Figure out what buffer we're going to bury. */
1026 if (NILP (buf))
1027 {
1028 XSET (buf, Lisp_Buffer, current_buffer);
1029
1030 /* If we're burying the current buffer, unshow it. */
1031 Fswitch_to_buffer (Fother_buffer (buf, Qnil), Qnil);
1032 }
1033 else
1034 {
1035 Lisp_Object buf1;
1036
1037 buf1 = Fget_buffer (buf);
1038 if (NILP (buf1))
1039 nsberror (buf);
1040 buf = buf1;
1041 }
1042
1043 /* Move buf to the end of the buffer list. */
1044 {
1045 register Lisp_Object aelt, link;
1046
1047 aelt = Frassq (buf, Vbuffer_alist);
1048 link = Fmemq (aelt, Vbuffer_alist);
1049 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
1050 XCONS (link)->cdr = Qnil;
1051 Vbuffer_alist = nconc2 (Vbuffer_alist, link);
1052 }
1053
1054 return Qnil;
1055}
1056\f
1057DEFUN ("erase-buffer", Ferase_buffer, Serase_buffer, 0, 0, "*",
1058 "Delete the entire contents of the current buffer.\n\
1059Any narrowing restriction in effect (see `narrow-to-region') is removed,\n\
1060so the buffer is truly empty after this.")
1061 ()
1062{
1063 Fwiden ();
1064 del_range (BEG, Z);
1065 current_buffer->last_window_start = 1;
1066 /* Prevent warnings, or suspension of auto saving, that would happen
1067 if future size is less than past size. Use of erase-buffer
1068 implies that the future text is not really related to the past text. */
1069 XFASTINT (current_buffer->save_length) = 0;
1070 return Qnil;
1071}
1072
1073validate_region (b, e)
1074 register Lisp_Object *b, *e;
1075{
1076 register int i;
1077
1078 CHECK_NUMBER_COERCE_MARKER (*b, 0);
1079 CHECK_NUMBER_COERCE_MARKER (*e, 1);
1080
1081 if (XINT (*b) > XINT (*e))
1082 {
1083 i = XFASTINT (*b); /* This is legit even if *b is < 0 */
1084 *b = *e;
1085 XFASTINT (*e) = i; /* because this is all we do with i. */
1086 }
1087
1088 if (!(BEGV <= XINT (*b) && XINT (*b) <= XINT (*e)
1089 && XINT (*e) <= ZV))
1090 args_out_of_range (*b, *e);
1091}
1092\f
1093static Lisp_Object
1094list_buffers_1 (files)
1095 Lisp_Object files;
1096{
1097 register Lisp_Object tail, tem, buf;
1098 Lisp_Object col1, col2, col3, minspace;
1099 register struct buffer *old = current_buffer, *b;
1100 Lisp_Object desired_point;
1101 Lisp_Object other_file_symbol;
1102
1103 desired_point = Qnil;
1104 other_file_symbol = intern ("list-buffers-directory");
1105
1106 XFASTINT (col1) = 19;
1107 XFASTINT (col2) = 25;
1108 XFASTINT (col3) = 40;
1109 XFASTINT (minspace) = 1;
1110
1111 Fset_buffer (Vstandard_output);
1112 Fbuffer_disable_undo (Vstandard_output);
1113 current_buffer->read_only = Qnil;
1114
1115 write_string ("\
1116 MR Buffer Size Mode File\n\
1117 -- ------ ---- ---- ----\n", -1);
1118
1119 for (tail = Vbuffer_alist; !NILP (tail); tail = Fcdr (tail))
1120 {
1121 buf = Fcdr (Fcar (tail));
1122 b = XBUFFER (buf);
1123 /* Don't mention the minibuffers. */
1124 if (XSTRING (b->name)->data[0] == ' ')
1125 continue;
1126 /* Optionally don't mention buffers that lack files. */
1127 if (!NILP (files) && NILP (b->filename))
1128 continue;
1129 /* Identify the current buffer. */
1130 if (b == old)
1131 XFASTINT (desired_point) = point;
1132 write_string (b == old ? "." : " ", -1);
1133 /* Identify modified buffers */
1134 write_string (BUF_MODIFF (b) > b->save_modified ? "*" : " ", -1);
1135 write_string (NILP (b->read_only) ? " " : "% ", -1);
1136 Fprinc (b->name, Qnil);
1137 Findent_to (col1, make_number (2));
1138 XFASTINT (tem) = BUF_Z (b) - BUF_BEG (b);
1139 Fprin1 (tem, Qnil);
1140 Findent_to (col2, minspace);
1141 Fprinc (b->mode_name, Qnil);
1142 Findent_to (col3, minspace);
1143
1144 if (!NILP (b->filename))
1145 Fprinc (b->filename, Qnil);
1146 else
1147 {
1148 /* No visited file; check local value of list-buffers-directory. */
1149 Lisp_Object tem;
1150 set_buffer_internal (b);
1151 tem = Fboundp (other_file_symbol);
1152 if (!NILP (tem))
1153 {
1154 tem = Fsymbol_value (other_file_symbol);
1155 Fset_buffer (Vstandard_output);
1156 if (XTYPE (tem) == Lisp_String)
1157 Fprinc (tem, Qnil);
1158 }
1159 else
1160 Fset_buffer (Vstandard_output);
1161 }
1162 write_string ("\n", -1);
1163 }
1164
1165 tail = intern ("Buffer-menu-mode");
1166 if ((tem = Ffboundp (tail), !NILP (tem)))
1167 call0 (tail);
1168 set_buffer_internal (old);
1169 return desired_point;
1170}
1171
1172DEFUN ("list-buffers", Flist_buffers, Slist_buffers, 0, 1, "P",
1173 "Display a list of names of existing buffers.\n\
1174The list is displayed in a buffer named `*Buffer List*'.\n\
1175Note that buffers with names starting with spaces are omitted.\n\
1176Non-null optional arg FILES-ONLY means mention only file buffers.\n\
1177\n\
1178The M column contains a * for buffers that are modified.\n\
1179The R column contains a % for buffers that are read-only.")
1180 (files)
1181 Lisp_Object files;
1182{
1183 Lisp_Object desired_point;
1184
1185 desired_point
1186 = internal_with_output_to_temp_buffer ("*Buffer List*",
1187 list_buffers_1, files);
1188
1189 if (NUMBERP (desired_point))
1190 {
1191 int count = specpdl_ptr - specpdl;
1192 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
1193 Fset_buffer (build_string ("*Buffer List*"));
1194 SET_PT (XINT (desired_point));
1195 return unbind_to (count, Qnil);
1196 }
1197 return Qnil;
1198}
1199
1200DEFUN ("kill-all-local-variables", Fkill_all_local_variables, Skill_all_local_variables,
1201 0, 0, 0,
1202 "Switch to Fundamental mode by killing current buffer's local variables.\n\
1203Most local variable bindings are eliminated so that the default values\n\
1204become effective once more. Also, the syntax table is set from\n\
1205`standard-syntax-table', the local keymap is set to nil,\n\
1206and the abbrev table from `fundamental-mode-abbrev-table'.\n\
1207This function also forces redisplay of the mode line.\n\
1208\n\
1209Every function to select a new major mode starts by\n\
1210calling this function.\n\n\
1211As a special exception, local variables whose names have\n\
1212a non-nil `permanent-local' property are not eliminated by this function.\n\
1213\n\
1214The first thing this function does is run\n\
1215the normal hook `change-major-mode-hook'.")
1216 ()
1217{
1218 register Lisp_Object alist, sym, tem;
1219 Lisp_Object oalist;
1220
1221 if (!NILP (Vrun_hooks))
1222 call1 (Vrun_hooks, intern ("change-major-mode-hook"));
1223 oalist = current_buffer->local_var_alist;
1224
1225 /* Make sure no local variables remain set up with this buffer
1226 for their current values. */
1227
1228 for (alist = oalist; !NILP (alist); alist = XCONS (alist)->cdr)
1229 {
1230 sym = XCONS (XCONS (alist)->car)->car;
1231
1232 /* Need not do anything if some other buffer's binding is now encached. */
1233 tem = XCONS (XCONS (XSYMBOL (sym)->value)->cdr)->car;
1234 if (XBUFFER (tem) == current_buffer)
1235 {
1236 /* Symbol is set up for this buffer's old local value.
1237 Set it up for the current buffer with the default value. */
1238
1239 tem = XCONS (XCONS (XSYMBOL (sym)->value)->cdr)->cdr;
1240 /* Store the symbol's current value into the alist entry
1241 it is currently set up for. This is so that, if the
1242 local is marked permanent, and we make it local again below,
1243 we don't lose the value. */
1244 XCONS (XCONS (tem)->car)->cdr
1245 = do_symval_forwarding (XCONS (XSYMBOL (sym)->value)->car);
1246 /* Switch to the symbol's default-value alist entry. */
1247 XCONS (tem)->car = tem;
1248 /* Mark it as current for the current buffer. */
1249 XCONS (XCONS (XSYMBOL (sym)->value)->cdr)->car = Fcurrent_buffer ();
1250 /* Store the current value into any forwarding in the symbol. */
1251 store_symval_forwarding (sym, XCONS (XSYMBOL (sym)->value)->car,
1252 XCONS (tem)->cdr);
1253 }
1254 }
1255
1256 /* Actually eliminate all local bindings of this buffer. */
1257
1258 reset_buffer_local_variables (current_buffer);
1259
1260 /* Redisplay mode lines; we are changing major mode. */
1261
1262 update_mode_lines++;
1263
1264 /* Any which are supposed to be permanent,
1265 make local again, with the same values they had. */
1266
1267 for (alist = oalist; !NILP (alist); alist = XCONS (alist)->cdr)
1268 {
1269 sym = XCONS (XCONS (alist)->car)->car;
1270 tem = Fget (sym, Qpermanent_local);
1271 if (! NILP (tem))
1272 {
1273 Fmake_local_variable (sym);
1274 Fset (sym, XCONS (XCONS (alist)->car)->cdr);
1275 }
1276 }
1277
1278 /* Force mode-line redisplay. Useful here because all major mode
1279 commands call this function. */
1280 update_mode_lines++;
1281
1282 return Qnil;
1283}
1284\f
1285/* Find all the overlays in the current buffer that contain position POS.
1286 Return the number found, and store them in a vector in *VEC_PTR.
1287 Store in *LEN_PTR the size allocated for the vector.
1288 Store in *NEXT_PTR the next position after POS where an overlay starts,
1289 or ZV if there are no more overlays.
1290
1291 *VEC_PTR and *LEN_PTR should contain a valid vector and size
1292 when this function is called.
1293
1294 If EXTEND is non-zero, we make the vector bigger if necessary.
1295 If EXTEND is zero, we never extend the vector,
1296 and we store only as many overlays as will fit.
1297 But we still return the total number of overlays. */
1298
1299int
1300overlays_at (pos, extend, vec_ptr, len_ptr, next_ptr)
1301 int pos;
1302 int extend;
1303 Lisp_Object **vec_ptr;
1304 int *len_ptr;
1305 int *next_ptr;
1306{
1307 Lisp_Object tail, overlay, start, end, result;
1308 int idx = 0;
1309 int len = *len_ptr;
1310 Lisp_Object *vec = *vec_ptr;
1311 int next = ZV;
1312 int inhibit_storing = 0;
1313
1314 for (tail = current_buffer->overlays_before;
1315 XGCTYPE (tail) == Lisp_Cons;
1316 tail = XCONS (tail)->cdr)
1317 {
1318 int startpos;
1319
1320 overlay = XCONS (tail)->car;
1321 if (XGCTYPE (overlay) != Lisp_Overlay)
1322 abort ();
1323
1324 start = OVERLAY_START (overlay);
1325 end = OVERLAY_END (overlay);
1326 if (OVERLAY_POSITION (end) <= pos)
1327 break;
1328 startpos = OVERLAY_POSITION (start);
1329 if (startpos <= pos)
1330 {
1331 if (idx == len)
1332 {
1333 /* The supplied vector is full.
1334 Either make it bigger, or don't store any more in it. */
1335 if (extend)
1336 {
1337 *len_ptr = len *= 2;
1338 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
1339 *vec_ptr = vec;
1340 }
1341 else
1342 inhibit_storing = 1;
1343 }
1344
1345 if (!inhibit_storing)
1346 vec[idx] = overlay;
1347 /* Keep counting overlays even if we can't return them all. */
1348 idx++;
1349 }
1350 else if (startpos < next)
1351 next = startpos;
1352 }
1353
1354 for (tail = current_buffer->overlays_after;
1355 XGCTYPE (tail) == Lisp_Cons;
1356 tail = XCONS (tail)->cdr)
1357 {
1358 int startpos;
1359
1360 overlay = XCONS (tail)->car;
1361 if (XGCTYPE (overlay) != Lisp_Overlay)
1362 abort ();
1363
1364 start = OVERLAY_START (overlay);
1365 end = OVERLAY_END (overlay);
1366 startpos = OVERLAY_POSITION (start);
1367 if (pos < startpos)
1368 {
1369 if (startpos < next)
1370 next = startpos;
1371 break;
1372 }
1373 if (pos < OVERLAY_POSITION (end))
1374 {
1375 if (idx == len)
1376 {
1377 if (extend)
1378 {
1379 *len_ptr = len *= 2;
1380 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
1381 *vec_ptr = vec;
1382 }
1383 else
1384 inhibit_storing = 1;
1385 }
1386
1387 if (!inhibit_storing)
1388 vec[idx] = overlay;
1389 idx++;
1390 }
1391 }
1392
1393 *next_ptr = next;
1394 return idx;
1395}
1396\f
1397struct sortvec
1398{
1399 Lisp_Object overlay;
1400 int beg, end;
1401 int priority;
1402};
1403
1404static int
1405compare_overlays (s1, s2)
1406 struct sortvec *s1, *s2;
1407{
1408 if (s1->priority != s2->priority)
1409 return s1->priority - s2->priority;
1410 if (s1->beg != s2->beg)
1411 return s1->beg - s2->beg;
1412 if (s1->end != s2->end)
1413 return s2->end - s1->end;
1414 return 0;
1415}
1416
1417/* Sort an array of overlays by priority. The array is modified in place.
1418 The return value is the new size; this may be smaller than the original
1419 size if some of the overlays were invalid or were window-specific. */
1420int
1421sort_overlays (overlay_vec, noverlays, w)
1422 Lisp_Object *overlay_vec;
1423 int noverlays;
1424 struct window *w;
1425{
1426 int i, j;
1427 struct sortvec *sortvec;
1428 sortvec = (struct sortvec *) alloca (noverlays * sizeof (struct sortvec));
1429
1430 /* Put the valid and relevant overlays into sortvec. */
1431
1432 for (i = 0, j = 0; i < noverlays; i++)
1433 {
1434 Lisp_Object tem;
1435 Lisp_Object overlay;
1436
1437 overlay = overlay_vec[i];
1438 if (OVERLAY_VALID (overlay)
1439 && OVERLAY_POSITION (OVERLAY_START (overlay)) > 0
1440 && OVERLAY_POSITION (OVERLAY_END (overlay)) > 0)
1441 {
1442 /* If we're interested in a specific window, then ignore
1443 overlays that are limited to some other window. */
1444 if (w)
1445 {
1446 Lisp_Object window;
1447
1448 window = Foverlay_get (overlay, Qwindow);
1449 if (XTYPE (window) == Lisp_Window && XWINDOW (window) != w)
1450 continue;
1451 }
1452
1453 /* This overlay is good and counts: put it into sortvec. */
1454 sortvec[j].overlay = overlay;
1455 sortvec[j].beg = OVERLAY_POSITION (OVERLAY_START (overlay));
1456 sortvec[j].end = OVERLAY_POSITION (OVERLAY_END (overlay));
1457 tem = Foverlay_get (overlay, Qpriority);
1458 if (INTEGERP (tem))
1459 sortvec[j].priority = XINT (tem);
1460 else
1461 sortvec[j].priority = 0;
1462 j++;
1463 }
1464 }
1465 noverlays = j;
1466
1467 /* Sort the overlays into the proper order: increasing priority. */
1468
1469 if (noverlays > 1)
1470 qsort (sortvec, noverlays, sizeof (struct sortvec), compare_overlays);
1471
1472 for (i = 0; i < noverlays; i++)
1473 overlay_vec[i] = sortvec[i].overlay;
1474 return (noverlays);
1475}
1476\f
1477/* Shift overlays in BUF's overlay lists, to center the lists at POS. */
1478
1479void
1480recenter_overlay_lists (buf, pos)
1481 struct buffer *buf;
1482 int pos;
1483{
1484 Lisp_Object overlay, tail, next, prev, beg, end;
1485
1486 /* See if anything in overlays_before should move to overlays_after. */
1487
1488 /* We don't strictly need prev in this loop; it should always be nil.
1489 But we use it for symmetry and in case that should cease to be true
1490 with some future change. */
1491 prev = Qnil;
1492 for (tail = buf->overlays_before;
1493 CONSP (tail);
1494 prev = tail, tail = next)
1495 {
1496 next = XCONS (tail)->cdr;
1497 overlay = XCONS (tail)->car;
1498
1499 /* If the overlay is not valid, get rid of it. */
1500 if (!OVERLAY_VALID (overlay))
1501#if 1
1502 abort ();
1503#else
1504 {
1505 /* Splice the cons cell TAIL out of overlays_before. */
1506 if (!NILP (prev))
1507 XCONS (prev)->cdr = next;
1508 else
1509 buf->overlays_before = next;
1510 tail = prev;
1511 continue;
1512 }
1513#endif
1514
1515 beg = OVERLAY_START (overlay);
1516 end = OVERLAY_END (overlay);
1517
1518 if (OVERLAY_POSITION (end) > pos)
1519 {
1520 /* OVERLAY needs to be moved. */
1521 int where = OVERLAY_POSITION (beg);
1522 Lisp_Object other, other_prev;
1523
1524 /* Splice the cons cell TAIL out of overlays_before. */
1525 if (!NILP (prev))
1526 XCONS (prev)->cdr = next;
1527 else
1528 buf->overlays_before = next;
1529
1530 /* Search thru overlays_after for where to put it. */
1531 other_prev = Qnil;
1532 for (other = buf->overlays_after;
1533 CONSP (other);
1534 other_prev = other, other = XCONS (other)->cdr)
1535 {
1536 Lisp_Object otherbeg, otheroverlay, follower;
1537 int win;
1538
1539 otheroverlay = XCONS (other)->car;
1540 if (! OVERLAY_VALID (otheroverlay))
1541 abort ();
1542
1543 otherbeg = OVERLAY_START (otheroverlay);
1544 if (OVERLAY_POSITION (otherbeg) >= where)
1545 break;
1546 }
1547
1548 /* Add TAIL to overlays_after before OTHER. */
1549 XCONS (tail)->cdr = other;
1550 if (!NILP (other_prev))
1551 XCONS (other_prev)->cdr = tail;
1552 else
1553 buf->overlays_after = tail;
1554 tail = prev;
1555 }
1556 else
1557 /* We've reached the things that should stay in overlays_before.
1558 All the rest of overlays_before must end even earlier,
1559 so stop now. */
1560 break;
1561 }
1562
1563 /* See if anything in overlays_after should be in overlays_before. */
1564 prev = Qnil;
1565 for (tail = buf->overlays_after;
1566 CONSP (tail);
1567 prev = tail, tail = next)
1568 {
1569 next = XCONS (tail)->cdr;
1570 overlay = XCONS (tail)->car;
1571
1572 /* If the overlay is not valid, get rid of it. */
1573 if (!OVERLAY_VALID (overlay))
1574#if 1
1575 abort ();
1576#else
1577 {
1578 /* Splice the cons cell TAIL out of overlays_after. */
1579 if (!NILP (prev))
1580 XCONS (prev)->cdr = next;
1581 else
1582 buf->overlays_after = next;
1583 tail = prev;
1584 continue;
1585 }
1586#endif
1587
1588 beg = OVERLAY_START (overlay);
1589 end = OVERLAY_END (overlay);
1590
1591 /* Stop looking, when we know that nothing further
1592 can possibly end before POS. */
1593 if (OVERLAY_POSITION (beg) > pos)
1594 break;
1595
1596 if (OVERLAY_POSITION (end) <= pos)
1597 {
1598 /* OVERLAY needs to be moved. */
1599 int where = OVERLAY_POSITION (end);
1600 Lisp_Object other, other_prev;
1601
1602 /* Splice the cons cell TAIL out of overlays_after. */
1603 if (!NILP (prev))
1604 XCONS (prev)->cdr = next;
1605 else
1606 buf->overlays_after = next;
1607
1608 /* Search thru overlays_before for where to put it. */
1609 other_prev = Qnil;
1610 for (other = buf->overlays_before;
1611 CONSP (other);
1612 other_prev = other, other = XCONS (other)->cdr)
1613 {
1614 Lisp_Object otherend, otheroverlay;
1615 int win;
1616
1617 otheroverlay = XCONS (other)->car;
1618 if (! OVERLAY_VALID (otheroverlay))
1619 abort ();
1620
1621 otherend = OVERLAY_END (otheroverlay);
1622 if (OVERLAY_POSITION (otherend) <= where)
1623 break;
1624 }
1625
1626 /* Add TAIL to overlays_before before OTHER. */
1627 XCONS (tail)->cdr = other;
1628 if (!NILP (other_prev))
1629 XCONS (other_prev)->cdr = tail;
1630 else
1631 buf->overlays_before = tail;
1632 tail = prev;
1633 }
1634 }
1635
1636 XFASTINT (buf->overlay_center) = pos;
1637}
1638\f
1639DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
1640 "Return t if OBJECT is an overlay.")
1641 (object)
1642 Lisp_Object object;
1643{
1644 return (OVERLAYP (object) ? Qt : Qnil);
1645}
1646
1647DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 3, 0,
1648 "Create a new overlay with range BEG to END in BUFFER.\n\
1649If omitted, BUFFER defaults to the current buffer.\n\
1650BEG and END may be integers or markers.")
1651 (beg, end, buffer)
1652 Lisp_Object beg, end, buffer;
1653{
1654 Lisp_Object overlay;
1655 struct buffer *b;
1656
1657 if (NILP (buffer))
1658 XSET (buffer, Lisp_Buffer, current_buffer);
1659 else
1660 CHECK_BUFFER (buffer, 2);
1661 if (MARKERP (beg)
1662 && ! EQ (Fmarker_buffer (beg), buffer))
1663 error ("Marker points into wrong buffer");
1664 if (MARKERP (end)
1665 && ! EQ (Fmarker_buffer (end), buffer))
1666 error ("Marker points into wrong buffer");
1667
1668 CHECK_NUMBER_COERCE_MARKER (beg, 1);
1669 CHECK_NUMBER_COERCE_MARKER (end, 1);
1670
1671 if (XINT (beg) > XINT (end))
1672 {
1673 Lisp_Object temp;
1674 temp = beg; beg = end; end = temp;
1675 }
1676
1677 b = XBUFFER (buffer);
1678
1679 beg = Fset_marker (Fmake_marker (), beg, buffer);
1680 end = Fset_marker (Fmake_marker (), end, buffer);
1681
1682 overlay = Fcons (Fcons (beg, end), Qnil);
1683 XSETTYPE (overlay, Lisp_Overlay);
1684
1685 /* Put the new overlay on the wrong list. */
1686 end = OVERLAY_END (overlay);
1687 if (OVERLAY_POSITION (end) < XINT (b->overlay_center))
1688 b->overlays_after = Fcons (overlay, b->overlays_after);
1689 else
1690 b->overlays_before = Fcons (overlay, b->overlays_before);
1691
1692 /* This puts it in the right list, and in the right order. */
1693 recenter_overlay_lists (b, XINT (b->overlay_center));
1694
1695 /* We don't need to redisplay the region covered by the overlay, because
1696 the overlay has no properties at the moment. */
1697
1698 return overlay;
1699}
1700
1701DEFUN ("move-overlay", Fmove_overlay, Smove_overlay, 3, 4, 0,
1702 "Set the endpoints of OVERLAY to BEG and END in BUFFER.\n\
1703If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.\n\
1704If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current\n\
1705buffer.")
1706 (overlay, beg, end, buffer)
1707 Lisp_Object overlay, beg, end, buffer;
1708{
1709 struct buffer *b, *ob;
1710 Lisp_Object obuffer;
1711 int count = specpdl_ptr - specpdl;
1712
1713 CHECK_OVERLAY (overlay, 0);
1714 if (NILP (buffer))
1715 buffer = Fmarker_buffer (OVERLAY_START (overlay));
1716 if (NILP (buffer))
1717 XSET (buffer, Lisp_Buffer, current_buffer);
1718 CHECK_BUFFER (buffer, 3);
1719
1720 if (MARKERP (beg)
1721 && ! EQ (Fmarker_buffer (beg), buffer))
1722 error ("Marker points into wrong buffer");
1723 if (MARKERP (end)
1724 && ! EQ (Fmarker_buffer (end), buffer))
1725 error ("Marker points into wrong buffer");
1726
1727 CHECK_NUMBER_COERCE_MARKER (beg, 1);
1728 CHECK_NUMBER_COERCE_MARKER (end, 1);
1729
1730 specbind (Qinhibit_quit, Qt);
1731
1732 if (XINT (beg) > XINT (end))
1733 {
1734 Lisp_Object temp;
1735 temp = beg; beg = end; end = temp;
1736 }
1737
1738 obuffer = Fmarker_buffer (OVERLAY_START (overlay));
1739 b = XBUFFER (buffer);
1740 ob = XBUFFER (obuffer);
1741
1742 /* If the overlay has changed buffers, do a thorough redisplay. */
1743 if (!EQ (buffer, obuffer))
1744 windows_or_buffers_changed = 1;
1745 else
1746 /* Redisplay the area the overlay has just left, or just enclosed. */
1747 {
1748 Lisp_Object o_beg;
1749 Lisp_Object o_end;
1750 int change_beg, change_end;
1751
1752 o_beg = OVERLAY_START (overlay);
1753 o_end = OVERLAY_END (overlay);
1754 o_beg = OVERLAY_POSITION (o_beg);
1755 o_end = OVERLAY_POSITION (o_end);
1756
1757 if (XINT (o_beg) == XINT (beg))
1758 redisplay_region (b, XINT (o_end), XINT (end));
1759 else if (XINT (o_end) == XINT (end))
1760 redisplay_region (b, XINT (o_beg), XINT (beg));
1761 else
1762 {
1763 if (XINT (beg) < XINT (o_beg)) o_beg = beg;
1764 if (XINT (end) > XINT (o_end)) o_end = end;
1765 redisplay_region (b, XINT (o_beg), XINT (o_end));
1766 }
1767 }
1768
1769 if (!NILP (obuffer))
1770 {
1771 ob->overlays_before = Fdelq (overlay, ob->overlays_before);
1772 ob->overlays_after = Fdelq (overlay, ob->overlays_after);
1773 }
1774
1775 Fset_marker (OVERLAY_START (overlay), beg, buffer);
1776 Fset_marker (OVERLAY_END (overlay), end, buffer);
1777
1778 /* Put the overlay on the wrong list. */
1779 end = OVERLAY_END (overlay);
1780 if (OVERLAY_POSITION (end) < XINT (b->overlay_center))
1781 b->overlays_after = Fcons (overlay, b->overlays_after);
1782 else
1783 b->overlays_before = Fcons (overlay, b->overlays_before);
1784
1785 /* This puts it in the right list, and in the right order. */
1786 recenter_overlay_lists (b, XINT (b->overlay_center));
1787
1788 return unbind_to (count, overlay);
1789}
1790
1791DEFUN ("delete-overlay", Fdelete_overlay, Sdelete_overlay, 1, 1, 0,
1792 "Delete the overlay OVERLAY from its buffer.")
1793 (overlay)
1794 Lisp_Object overlay;
1795{
1796 Lisp_Object buffer;
1797 struct buffer *b;
1798 int count = specpdl_ptr - specpdl;
1799
1800 CHECK_OVERLAY (overlay, 0);
1801
1802 buffer = Fmarker_buffer (OVERLAY_START (overlay));
1803 if (NILP (buffer))
1804 return Qnil;
1805
1806 b = XBUFFER (buffer);
1807
1808 specbind (Qinhibit_quit, Qt);
1809
1810 b->overlays_before = Fdelq (overlay, b->overlays_before);
1811 b->overlays_after = Fdelq (overlay, b->overlays_after);
1812
1813 redisplay_region (b,
1814 marker_position (OVERLAY_START (overlay)),
1815 marker_position (OVERLAY_END (overlay)));
1816
1817 Fset_marker (OVERLAY_START (overlay), Qnil, Qnil);
1818 Fset_marker (OVERLAY_END (overlay), Qnil, Qnil);
1819
1820 return unbind_to (count, Qnil);
1821}
1822\f
1823/* Overlay dissection functions. */
1824
1825DEFUN ("overlay-start", Foverlay_start, Soverlay_start, 1, 1, 0,
1826 "Return the position at which OVERLAY starts.")
1827 (overlay)
1828 Lisp_Object overlay;
1829{
1830 CHECK_OVERLAY (overlay, 0);
1831
1832 return (Fmarker_position (OVERLAY_START (overlay)));
1833}
1834
1835DEFUN ("overlay-end", Foverlay_end, Soverlay_end, 1, 1, 0,
1836 "Return the position at which OVERLAY ends.")
1837 (overlay)
1838 Lisp_Object overlay;
1839{
1840 CHECK_OVERLAY (overlay, 0);
1841
1842 return (Fmarker_position (OVERLAY_END (overlay)));
1843}
1844
1845DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
1846 "Return the buffer OVERLAY belongs to.")
1847 (overlay)
1848 Lisp_Object overlay;
1849{
1850 CHECK_OVERLAY (overlay, 0);
1851
1852 return Fmarker_buffer (OVERLAY_START (overlay));
1853}
1854
1855DEFUN ("overlay-properties", Foverlay_properties, Soverlay_properties, 1, 1, 0,
1856 "Return a list of the properties on OVERLAY.\n\
1857This is a copy of OVERLAY's plist; modifying its conses has no effect on\n\
1858OVERLAY.")
1859 (overlay)
1860 Lisp_Object overlay;
1861{
1862 CHECK_OVERLAY (overlay, 0);
1863
1864 return Fcopy_sequence (Fcdr_safe (XCONS (overlay)->cdr));
1865}
1866
1867\f
1868DEFUN ("overlays-at", Foverlays_at, Soverlays_at, 1, 1, 0,
1869 "Return a list of the overlays that contain position POS.")
1870 (pos)
1871 Lisp_Object pos;
1872{
1873 int noverlays;
1874 int endpos;
1875 Lisp_Object *overlay_vec;
1876 int len;
1877 Lisp_Object result;
1878
1879 CHECK_NUMBER_COERCE_MARKER (pos, 0);
1880
1881 len = 10;
1882 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
1883
1884 /* Put all the overlays we want in a vector in overlay_vec.
1885 Store the length in len. */
1886 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len, &endpos);
1887
1888 /* Make a list of them all. */
1889 result = Flist (noverlays, overlay_vec);
1890
1891 xfree (overlay_vec);
1892 return result;
1893}
1894
1895DEFUN ("next-overlay-change", Fnext_overlay_change, Snext_overlay_change,
1896 1, 1, 0,
1897 "Return the next position after POS where an overlay starts or ends.\n\
1898If there are no more overlay boundaries after POS, return (point-max).")
1899 (pos)
1900 Lisp_Object pos;
1901{
1902 int noverlays;
1903 int endpos;
1904 Lisp_Object *overlay_vec;
1905 int len;
1906 Lisp_Object result;
1907 int i;
1908
1909 CHECK_NUMBER_COERCE_MARKER (pos, 0);
1910
1911 len = 10;
1912 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
1913
1914 /* Put all the overlays we want in a vector in overlay_vec.
1915 Store the length in len.
1916 endpos gets the position where the next overlay starts. */
1917 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len, &endpos);
1918
1919 /* If any of these overlays ends before endpos,
1920 use its ending point instead. */
1921 for (i = 0; i < noverlays; i++)
1922 {
1923 Lisp_Object oend;
1924 int oendpos;
1925
1926 oend = OVERLAY_END (overlay_vec[i]);
1927 oendpos = OVERLAY_POSITION (oend);
1928 if (oendpos < endpos)
1929 endpos = oendpos;
1930 }
1931
1932 xfree (overlay_vec);
1933 return make_number (endpos);
1934}
1935\f
1936/* These functions are for debugging overlays. */
1937
1938DEFUN ("overlay-lists", Foverlay_lists, Soverlay_lists, 0, 0, 0,
1939 "Return a pair of lists giving all the overlays of the current buffer.\n\
1940The car has all the overlays before the overlay center;\n\
1941the cdr has all the overlays after the overlay center.\n\
1942Recentering overlays moves overlays between these lists.\n\
1943The lists you get are copies, so that changing them has no effect.\n\
1944However, the overlays you get are the real objects that the buffer uses.")
1945 ()
1946{
1947 Lisp_Object before, after;
1948 before = current_buffer->overlays_before;
1949 if (CONSP (before))
1950 before = Fcopy_sequence (before);
1951 after = current_buffer->overlays_after;
1952 if (CONSP (after))
1953 after = Fcopy_sequence (after);
1954
1955 return Fcons (before, after);
1956}
1957
1958DEFUN ("overlay-recenter", Foverlay_recenter, Soverlay_recenter, 1, 1, 0,
1959 "Recenter the overlays of the current buffer around position POS.")
1960 (pos)
1961 Lisp_Object pos;
1962{
1963 CHECK_NUMBER_COERCE_MARKER (pos, 0);
1964
1965 recenter_overlay_lists (current_buffer, XINT (pos));
1966 return Qnil;
1967}
1968\f
1969DEFUN ("overlay-get", Foverlay_get, Soverlay_get, 2, 2, 0,
1970 "Get the property of overlay OVERLAY with property name NAME.")
1971 (overlay, prop)
1972 Lisp_Object overlay, prop;
1973{
1974 Lisp_Object plist;
1975
1976 CHECK_OVERLAY (overlay, 0);
1977
1978 for (plist = Fcdr_safe (XCONS (overlay)->cdr);
1979 CONSP (plist) && CONSP (XCONS (plist)->cdr);
1980 plist = XCONS (XCONS (plist)->cdr)->cdr)
1981 {
1982 if (EQ (XCONS (plist)->car, prop))
1983 return XCONS (XCONS (plist)->cdr)->car;
1984 }
1985
1986 return Qnil;
1987}
1988
1989DEFUN ("overlay-put", Foverlay_put, Soverlay_put, 3, 3, 0,
1990 "Set one property of overlay OVERLAY: give property PROP value VALUE.")
1991 (overlay, prop, value)
1992 Lisp_Object overlay, prop, value;
1993{
1994 Lisp_Object plist, tail;
1995
1996 CHECK_OVERLAY (overlay, 0);
1997
1998 tail = Fmarker_buffer (OVERLAY_START (overlay));
1999 if (! NILP (tail))
2000 redisplay_region (XMARKER (OVERLAY_START (overlay))->buffer,
2001 marker_position (OVERLAY_START (overlay)),
2002 marker_position (OVERLAY_END (overlay)));
2003
2004 plist = Fcdr_safe (XCONS (overlay)->cdr);
2005
2006 for (tail = plist;
2007 CONSP (tail) && CONSP (XCONS (tail)->cdr);
2008 tail = XCONS (XCONS (tail)->cdr)->cdr)
2009 {
2010 if (EQ (XCONS (tail)->car, prop))
2011 return XCONS (XCONS (tail)->cdr)->car = value;
2012 }
2013
2014 if (! CONSP (XCONS (overlay)->cdr))
2015 XCONS (overlay)->cdr = Fcons (Qnil, Qnil);
2016
2017 XCONS (XCONS (overlay)->cdr)->cdr
2018 = Fcons (prop, Fcons (value, plist));
2019
2020 return value;
2021}
2022\f
2023/* Run the modification-hooks of overlays that include
2024 any part of the text in START to END.
2025 Run the insert-before-hooks of overlay starting at END,
2026 and the insert-after-hooks of overlay ending at START. */
2027
2028void
2029verify_overlay_modification (start, end)
2030 Lisp_Object start, end;
2031{
2032 Lisp_Object prop, overlay, tail;
2033 int insertion = EQ (start, end);
2034
2035 for (tail = current_buffer->overlays_before;
2036 CONSP (tail);
2037 tail = XCONS (tail)->cdr)
2038 {
2039 int startpos, endpos;
2040 Lisp_Object ostart, oend;
2041
2042 overlay = XCONS (tail)->car;
2043
2044 ostart = OVERLAY_START (overlay);
2045 oend = OVERLAY_END (overlay);
2046 endpos = OVERLAY_POSITION (oend);
2047 if (XFASTINT (start) > endpos)
2048 break;
2049 startpos = OVERLAY_POSITION (ostart);
2050 if (XFASTINT (end) == startpos && insertion)
2051 {
2052 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
2053 if (!NILP (prop))
2054 {
2055 /* Copy TAIL in case the hook recenters the overlay lists. */
2056 tail = Fcopy_sequence (tail);
2057 call_overlay_mod_hooks (prop, overlay, start, end);
2058 }
2059 }
2060 if (XFASTINT (start) == endpos && insertion)
2061 {
2062 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
2063 if (!NILP (prop))
2064 {
2065 tail = Fcopy_sequence (tail);
2066 call_overlay_mod_hooks (prop, overlay, start, end);
2067 }
2068 }
2069 /* Test for intersecting intervals. This does the right thing
2070 for both insertion and deletion. */
2071 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
2072 {
2073 prop = Foverlay_get (overlay, Qmodification_hooks);
2074 if (!NILP (prop))
2075 {
2076 tail = Fcopy_sequence (tail);
2077 call_overlay_mod_hooks (prop, overlay, start, end);
2078 }
2079 }
2080 }
2081
2082 for (tail = current_buffer->overlays_after;
2083 CONSP (tail);
2084 tail = XCONS (tail)->cdr)
2085 {
2086 int startpos, endpos;
2087 Lisp_Object ostart, oend;
2088
2089 overlay = XCONS (tail)->car;
2090
2091 ostart = OVERLAY_START (overlay);
2092 oend = OVERLAY_END (overlay);
2093 startpos = OVERLAY_POSITION (ostart);
2094 endpos = OVERLAY_POSITION (oend);
2095 if (XFASTINT (end) < startpos)
2096 break;
2097 if (XFASTINT (end) == startpos && insertion)
2098 {
2099 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
2100 if (!NILP (prop))
2101 {
2102 tail = Fcopy_sequence (tail);
2103 call_overlay_mod_hooks (prop, overlay, start, end);
2104 }
2105 }
2106 if (XFASTINT (start) == endpos && insertion)
2107 {
2108 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
2109 if (!NILP (prop))
2110 {
2111 tail = Fcopy_sequence (tail);
2112 call_overlay_mod_hooks (prop, overlay, start, end);
2113 }
2114 }
2115 /* Test for intersecting intervals. This does the right thing
2116 for both insertion and deletion. */
2117 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
2118 {
2119 prop = Foverlay_get (overlay, Qmodification_hooks);
2120 if (!NILP (prop))
2121 {
2122 tail = Fcopy_sequence (tail);
2123 call_overlay_mod_hooks (prop, overlay, start, end);
2124 }
2125 }
2126 }
2127}
2128
2129static void
2130call_overlay_mod_hooks (list, overlay, start, end)
2131 Lisp_Object list, overlay, start, end;
2132{
2133 struct gcpro gcpro1;
2134 GCPRO1 (list);
2135 while (!NILP (list))
2136 {
2137 call3 (Fcar (list), overlay, start, end);
2138 list = Fcdr (list);
2139 }
2140 UNGCPRO;
2141}
2142\f
2143/* Somebody has tried to store NEWVAL into the buffer-local slot with
2144 offset XUINT (valcontents), and NEWVAL has an unacceptable type. */
2145void
2146buffer_slot_type_mismatch (valcontents, newval)
2147 Lisp_Object valcontents, newval;
2148{
2149 unsigned int offset = XUINT (valcontents);
2150 unsigned char *symbol_name =
2151 (XSYMBOL (*(Lisp_Object *)(offset + (char *)&buffer_local_symbols))
2152 ->name->data);
2153 char *type_name;
2154
2155 switch (XINT (*(Lisp_Object *)(offset + (char *)&buffer_local_types)))
2156 {
2157 case Lisp_Int: type_name = "integers"; break;
2158 case Lisp_String: type_name = "strings"; break;
2159 case Lisp_Marker: type_name = "markers"; break;
2160 case Lisp_Symbol: type_name = "symbols"; break;
2161 case Lisp_Cons: type_name = "lists"; break;
2162 case Lisp_Vector: type_name = "vectors"; break;
2163 default:
2164 abort ();
2165 }
2166
2167 error ("only %s should be stored in the buffer-local variable %s",
2168 type_name, symbol_name);
2169}
2170\f
2171init_buffer_once ()
2172{
2173 register Lisp_Object tem;
2174
2175 /* Make sure all markable slots in buffer_defaults
2176 are initialized reasonably, so mark_buffer won't choke. */
2177 reset_buffer (&buffer_defaults);
2178 reset_buffer (&buffer_local_symbols);
2179 XSET (Vbuffer_defaults, Lisp_Buffer, &buffer_defaults);
2180 XSET (Vbuffer_local_symbols, Lisp_Buffer, &buffer_local_symbols);
2181
2182 /* Set up the default values of various buffer slots. */
2183 /* Must do these before making the first buffer! */
2184
2185 /* real setup is done in loaddefs.el */
2186 buffer_defaults.mode_line_format = build_string ("%-");
2187 buffer_defaults.abbrev_mode = Qnil;
2188 buffer_defaults.overwrite_mode = Qnil;
2189 buffer_defaults.case_fold_search = Qt;
2190 buffer_defaults.auto_fill_function = Qnil;
2191 buffer_defaults.selective_display = Qnil;
2192#ifndef old
2193 buffer_defaults.selective_display_ellipses = Qt;
2194#endif
2195 buffer_defaults.abbrev_table = Qnil;
2196 buffer_defaults.display_table = Qnil;
2197 buffer_defaults.undo_list = Qnil;
2198 buffer_defaults.mark_active = Qnil;
2199 buffer_defaults.overlays_before = Qnil;
2200 buffer_defaults.overlays_after = Qnil;
2201 XFASTINT (buffer_defaults.overlay_center) = 1;
2202
2203 XFASTINT (buffer_defaults.tab_width) = 8;
2204 buffer_defaults.truncate_lines = Qnil;
2205 buffer_defaults.ctl_arrow = Qt;
2206
2207#ifdef MSDOS
2208 buffer_defaults.buffer_file_type = Qnil; /* TEXT */
2209#endif
2210 XFASTINT (buffer_defaults.fill_column) = 70;
2211 XFASTINT (buffer_defaults.left_margin) = 0;
2212
2213 /* Assign the local-flags to the slots that have default values.
2214 The local flag is a bit that is used in the buffer
2215 to say that it has its own local value for the slot.
2216 The local flag bits are in the local_var_flags slot of the buffer. */
2217
2218 /* Nothing can work if this isn't true */
2219 if (sizeof (int) != sizeof (Lisp_Object)) abort ();
2220
2221 /* 0 means not a lisp var, -1 means always local, else mask */
2222 bzero (&buffer_local_flags, sizeof buffer_local_flags);
2223 XFASTINT (buffer_local_flags.filename) = -1;
2224 XFASTINT (buffer_local_flags.directory) = -1;
2225 XFASTINT (buffer_local_flags.backed_up) = -1;
2226 XFASTINT (buffer_local_flags.save_length) = -1;
2227 XFASTINT (buffer_local_flags.auto_save_file_name) = -1;
2228 XFASTINT (buffer_local_flags.read_only) = -1;
2229 XFASTINT (buffer_local_flags.major_mode) = -1;
2230 XFASTINT (buffer_local_flags.mode_name) = -1;
2231 XFASTINT (buffer_local_flags.undo_list) = -1;
2232 XFASTINT (buffer_local_flags.mark_active) = -1;
2233
2234 XFASTINT (buffer_local_flags.mode_line_format) = 1;
2235 XFASTINT (buffer_local_flags.abbrev_mode) = 2;
2236 XFASTINT (buffer_local_flags.overwrite_mode) = 4;
2237 XFASTINT (buffer_local_flags.case_fold_search) = 8;
2238 XFASTINT (buffer_local_flags.auto_fill_function) = 0x10;
2239 XFASTINT (buffer_local_flags.selective_display) = 0x20;
2240#ifndef old
2241 XFASTINT (buffer_local_flags.selective_display_ellipses) = 0x40;
2242#endif
2243 XFASTINT (buffer_local_flags.tab_width) = 0x80;
2244 XFASTINT (buffer_local_flags.truncate_lines) = 0x100;
2245 XFASTINT (buffer_local_flags.ctl_arrow) = 0x200;
2246 XFASTINT (buffer_local_flags.fill_column) = 0x400;
2247 XFASTINT (buffer_local_flags.left_margin) = 0x800;
2248 XFASTINT (buffer_local_flags.abbrev_table) = 0x1000;
2249 XFASTINT (buffer_local_flags.display_table) = 0x2000;
2250 XFASTINT (buffer_local_flags.syntax_table) = 0x8000;
2251#ifdef MSDOS
2252 XFASTINT (buffer_local_flags.buffer_file_type) = 0x4000;
2253#endif
2254
2255 Vbuffer_alist = Qnil;
2256 current_buffer = 0;
2257 all_buffers = 0;
2258
2259 QSFundamental = build_string ("Fundamental");
2260
2261 Qfundamental_mode = intern ("fundamental-mode");
2262 buffer_defaults.major_mode = Qfundamental_mode;
2263
2264 Qmode_class = intern ("mode-class");
2265
2266 Qprotected_field = intern ("protected-field");
2267
2268 Qpermanent_local = intern ("permanent-local");
2269
2270 Qkill_buffer_hook = intern ("kill-buffer-hook");
2271
2272 Vprin1_to_string_buffer = Fget_buffer_create (build_string (" prin1"));
2273 /* super-magic invisible buffer */
2274 Vbuffer_alist = Qnil;
2275
2276 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2277}
2278
2279init_buffer ()
2280{
2281 char buf[MAXPATHLEN+1];
2282 char *pwd;
2283 struct stat dotstat, pwdstat;
2284 Lisp_Object temp;
2285
2286 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
2287
2288 /* If PWD is accurate, use it instead of calling getwd. This is faster
2289 when PWD is right, and may avoid a fatal error. */
2290 if ((pwd = getenv ("PWD")) != 0 && *pwd == '/'
2291 && stat (pwd, &pwdstat) == 0
2292 && stat (".", &dotstat) == 0
2293 && dotstat.st_ino == pwdstat.st_ino
2294 && dotstat.st_dev == pwdstat.st_dev
2295 && strlen (pwd) < MAXPATHLEN)
2296 strcpy (buf, pwd);
2297 else if (getwd (buf) == 0)
2298 fatal ("`getwd' failed: %s.\n", buf);
2299
2300#ifndef VMS
2301 /* Maybe this should really use some standard subroutine
2302 whose definition is filename syntax dependent. */
2303 if (buf[strlen (buf) - 1] != '/')
2304 strcat (buf, "/");
2305#endif /* not VMS */
2306 current_buffer->directory = build_string (buf);
2307
2308 temp = get_minibuffer (0);
2309 XBUFFER (temp)->directory = current_buffer->directory;
2310}
2311
2312/* initialize the buffer routines */
2313syms_of_buffer ()
2314{
2315 extern Lisp_Object Qdisabled;
2316
2317 staticpro (&Vbuffer_defaults);
2318 staticpro (&Vbuffer_local_symbols);
2319 staticpro (&Qfundamental_mode);
2320 staticpro (&Qmode_class);
2321 staticpro (&QSFundamental);
2322 staticpro (&Vbuffer_alist);
2323 staticpro (&Qprotected_field);
2324 staticpro (&Qpermanent_local);
2325 staticpro (&Qkill_buffer_hook);
2326 staticpro (&Qoverlayp);
2327 staticpro (&Qmodification_hooks);
2328 Qmodification_hooks = intern ("modification-hooks");
2329 staticpro (&Qinsert_in_front_hooks);
2330 Qinsert_in_front_hooks = intern ("insert-in-front-hooks");
2331 staticpro (&Qinsert_behind_hooks);
2332 Qinsert_behind_hooks = intern ("insert-behind-hooks");
2333 staticpro (&Qget_file_buffer);
2334 Qget_file_buffer = intern ("get-file-buffer");
2335 Qpriority = intern ("priority");
2336 staticpro (&Qpriority);
2337 Qwindow = intern ("window");
2338 staticpro (&Qwindow);
2339
2340 Qoverlayp = intern ("overlayp");
2341
2342 Fput (Qprotected_field, Qerror_conditions,
2343 Fcons (Qprotected_field, Fcons (Qerror, Qnil)));
2344 Fput (Qprotected_field, Qerror_message,
2345 build_string ("Attempt to modify a protected field"));
2346
2347 /* All these use DEFVAR_LISP_NOPRO because the slots in
2348 buffer_defaults will all be marked via Vbuffer_defaults. */
2349
2350 DEFVAR_LISP_NOPRO ("default-mode-line-format",
2351 &buffer_defaults.mode_line_format,
2352 "Default value of `mode-line-format' for buffers that don't override it.\n\
2353This is the same as (default-value 'mode-line-format).");
2354
2355 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
2356 &buffer_defaults.abbrev_mode,
2357 "Default value of `abbrev-mode' for buffers that do not override it.\n\
2358This is the same as (default-value 'abbrev-mode).");
2359
2360 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
2361 &buffer_defaults.ctl_arrow,
2362 "Default value of `ctl-arrow' for buffers that do not override it.\n\
2363This is the same as (default-value 'ctl-arrow).");
2364
2365 DEFVAR_LISP_NOPRO ("default-truncate-lines",
2366 &buffer_defaults.truncate_lines,
2367 "Default value of `truncate-lines' for buffers that do not override it.\n\
2368This is the same as (default-value 'truncate-lines).");
2369
2370 DEFVAR_LISP_NOPRO ("default-fill-column",
2371 &buffer_defaults.fill_column,
2372 "Default value of `fill-column' for buffers that do not override it.\n\
2373This is the same as (default-value 'fill-column).");
2374
2375 DEFVAR_LISP_NOPRO ("default-left-margin",
2376 &buffer_defaults.left_margin,
2377 "Default value of `left-margin' for buffers that do not override it.\n\
2378This is the same as (default-value 'left-margin).");
2379
2380 DEFVAR_LISP_NOPRO ("default-tab-width",
2381 &buffer_defaults.tab_width,
2382 "Default value of `tab-width' for buffers that do not override it.\n\
2383This is the same as (default-value 'tab-width).");
2384
2385 DEFVAR_LISP_NOPRO ("default-case-fold-search",
2386 &buffer_defaults.case_fold_search,
2387 "Default value of `case-fold-search' for buffers that don't override it.\n\
2388This is the same as (default-value 'case-fold-search).");
2389
2390#ifdef MSDOS
2391 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
2392 &buffer_defaults.buffer_file_type,
2393 "Default file type for buffers that do not override it.\n\
2394This is the same as (default-value 'buffer-file-type).\n\
2395The file type is nil for text, t for binary.");
2396#endif
2397
2398 DEFVAR_PER_BUFFER ("mode-line-format", &current_buffer->mode_line_format,
2399 Qnil, 0);
2400
2401/* This doc string is too long for cpp; cpp dies if it isn't in a comment.
2402 But make-docfile finds it!
2403 DEFVAR_PER_BUFFER ("mode-line-format", &current_buffer->mode_line_format,
2404 Qnil,
2405 "Template for displaying mode line for current buffer.\n\
2406Each buffer has its own value of this variable.\n\
2407Value may be a string, a symbol or a list or cons cell.\n\
2408For a symbol, its value is used (but it is ignored if t or nil).\n\
2409 A string appearing directly as the value of a symbol is processed verbatim\n\
2410 in that the %-constructs below are not recognized.\n\
2411For a list whose car is a symbol, the symbol's value is taken,\n\
2412 and if that is non-nil, the cadr of the list is processed recursively.\n\
2413 Otherwise, the caddr of the list (if there is one) is processed.\n\
2414For a list whose car is a string or list, each element is processed\n\
2415 recursively and the results are effectively concatenated.\n\
2416For a list whose car is an integer, the cdr of the list is processed\n\
2417 and padded (if the number is positive) or truncated (if negative)\n\
2418 to the width specified by that number.\n\
2419A string is printed verbatim in the mode line except for %-constructs:\n\
2420 (%-constructs are allowed when the string is the entire mode-line-format\n\
2421 or when it is found in a cons-cell or a list)\n\
2422 %b -- print buffer name. %f -- print visited file name.\n\
2423 %* -- print *, % or hyphen. %m -- print value of mode-name (obsolete).\n\
2424 %s -- print process status. %l -- print the current line number.\n\
2425 %p -- print percent of buffer above top of window, or Top, Bot or All.\n\
2426 %P -- print percent of buffer above bottom of window, perhaps plus Top,\n\
2427 or print Bottom or All.\n\
2428 %n -- print Narrow if appropriate.\n\
2429 %t -- print T if files is text, B if binary.\n\
2430 %[ -- print one [ for each recursive editing level. %] similar.\n\
2431 %% -- print %. %- -- print infinitely many dashes.\n\
2432Decimal digits after the % specify field width to which to pad.");
2433*/
2434
2435 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults.major_mode,
2436 "*Major mode for new buffers. Defaults to `fundamental-mode'.\n\
2437nil here means use current buffer's major mode.");
2438
2439 DEFVAR_PER_BUFFER ("major-mode", &current_buffer->major_mode,
2440 make_number (Lisp_Symbol),
2441 "Symbol for current buffer's major mode.");
2442
2443 DEFVAR_PER_BUFFER ("mode-name", &current_buffer->mode_name,
2444 make_number (Lisp_String),
2445 "Pretty name of current buffer's major mode (a string).");
2446
2447 DEFVAR_PER_BUFFER ("abbrev-mode", &current_buffer->abbrev_mode, Qnil,
2448 "Non-nil turns on automatic expansion of abbrevs as they are inserted.\n\
2449Automatically becomes buffer-local when set in any fashion.");
2450
2451 DEFVAR_PER_BUFFER ("case-fold-search", &current_buffer->case_fold_search,
2452 Qnil,
2453 "*Non-nil if searches should ignore case.\n\
2454Automatically becomes buffer-local when set in any fashion.");
2455
2456 DEFVAR_PER_BUFFER ("fill-column", &current_buffer->fill_column,
2457 make_number (Lisp_Int),
2458 "*Column beyond which automatic line-wrapping should happen.\n\
2459Automatically becomes buffer-local when set in any fashion.");
2460
2461 DEFVAR_PER_BUFFER ("left-margin", &current_buffer->left_margin,
2462 make_number (Lisp_Int),
2463 "*Column for the default indent-line-function to indent to.\n\
2464Linefeed indents to this column in Fundamental mode.\n\
2465Automatically becomes buffer-local when set in any fashion.");
2466
2467 DEFVAR_PER_BUFFER ("tab-width", &current_buffer->tab_width,
2468 make_number (Lisp_Int),
2469 "*Distance between tab stops (for display of tab characters), in columns.\n\
2470Automatically becomes buffer-local when set in any fashion.");
2471
2472 DEFVAR_PER_BUFFER ("ctl-arrow", &current_buffer->ctl_arrow, Qnil,
2473 "*Non-nil means display control chars with uparrow.\n\
2474Nil means use backslash and octal digits.\n\
2475Automatically becomes buffer-local when set in any fashion.\n\
2476This variable does not apply to characters whose display is specified\n\
2477in the current display table (if there is one).");
2478
2479 DEFVAR_PER_BUFFER ("truncate-lines", &current_buffer->truncate_lines, Qnil,
2480 "*Non-nil means do not display continuation lines;\n\
2481give each line of text one screen line.\n\
2482Automatically becomes buffer-local when set in any fashion.\n\
2483\n\
2484Note that this is overridden by the variable\n\
2485`truncate-partial-width-windows' if that variable is non-nil\n\
2486and this buffer is not full-frame width.");
2487
2488#ifdef MSDOS
2489 DEFVAR_PER_BUFFER ("buffer-file-type", &current_buffer->buffer_file_type,
2490 Qnil,
2491 "*If visited file is text, nil; otherwise, t.");
2492#endif
2493
2494 DEFVAR_PER_BUFFER ("default-directory", &current_buffer->directory,
2495 make_number (Lisp_String),
2496 "Name of default directory of current buffer. Should end with slash.\n\
2497Each buffer has its own value of this variable.");
2498
2499 DEFVAR_PER_BUFFER ("auto-fill-function", &current_buffer->auto_fill_function,
2500 Qnil,
2501 "Function called (if non-nil) to perform auto-fill.\n\
2502It is called after self-inserting a space at a column beyond `fill-column'.\n\
2503Each buffer has its own value of this variable.\n\
2504NOTE: This variable is not an ordinary hook;\n\
2505It may not be a list of functions.");
2506
2507 DEFVAR_PER_BUFFER ("buffer-file-name", &current_buffer->filename,
2508 make_number (Lisp_String),
2509 "Name of file visited in current buffer, or nil if not visiting a file.\n\
2510Each buffer has its own value of this variable.");
2511
2512 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
2513 &current_buffer->auto_save_file_name,
2514 make_number (Lisp_String),
2515 "Name of file for auto-saving current buffer,\n\
2516or nil if buffer should not be auto-saved.\n\
2517Each buffer has its own value of this variable.");
2518
2519 DEFVAR_PER_BUFFER ("buffer-read-only", &current_buffer->read_only, Qnil,
2520 "Non-nil if this buffer is read-only.\n\
2521Each buffer has its own value of this variable.");
2522
2523 DEFVAR_PER_BUFFER ("buffer-backed-up", &current_buffer->backed_up, Qnil,
2524 "Non-nil if this buffer's file has been backed up.\n\
2525Backing up is done before the first time the file is saved.\n\
2526Each buffer has its own value of this variable.");
2527
2528 DEFVAR_PER_BUFFER ("buffer-saved-size", &current_buffer->save_length,
2529 make_number (Lisp_Int),
2530 "Length of current buffer when last read in, saved or auto-saved.\n\
25310 initially.\n\
2532Each buffer has its own value of this variable.");
2533
2534 DEFVAR_PER_BUFFER ("selective-display", &current_buffer->selective_display,
2535 Qnil,
2536 "Non-nil enables selective display:\n\
2537Integer N as value means display only lines\n\
2538 that start with less than n columns of space.\n\
2539A value of t means, after a ^M, all the rest of the line is invisible.\n\
2540 Then ^M's in the file are written into files as newlines.\n\n\
2541Automatically becomes buffer-local when set in any fashion.");
2542
2543#ifndef old
2544 DEFVAR_PER_BUFFER ("selective-display-ellipses",
2545 &current_buffer->selective_display_ellipses,
2546 Qnil,
2547 "t means display ... on previous line when a line is invisible.\n\
2548Automatically becomes buffer-local when set in any fashion.");
2549#endif
2550
2551 DEFVAR_PER_BUFFER ("overwrite-mode", &current_buffer->overwrite_mode, Qnil,
2552 "Non-nil if self-insertion should replace existing text.\n\
2553If non-nil and not `overwrite-mode-binary', self-insertion still\n\
2554inserts at the end of a line, and inserts when point is before a tab,\n\
2555until the tab is filled in.\n\
2556If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.\n\
2557Automatically becomes buffer-local when set in any fashion.");
2558
2559#if 0 /* The doc string is too long for some compilers,
2560 but make-docfile can find it in this comment. */
2561 DEFVAR_PER_BUFFER ("buffer-display-table", &current_buffer->display_table,
2562 Qnil,
2563 "Display table that controls display of the contents of current buffer.\n\
2564Automatically becomes buffer-local when set in any fashion.\n\
2565The display table is a vector created with `make-display-table'.\n\
2566The first 256 elements control how to display each possible text character.\n\
2567Each value should be a vector of characters or nil;\n\
2568nil means display the character in the default fashion.\n\
2569The remaining five elements control the display of\n\
2570 the end of a truncated screen line (element 256, a single character);\n\
2571 the end of a continued line (element 257, a single character);\n\
2572 the escape character used to display character codes in octal\n\
2573 (element 258, a single character);\n\
2574 the character used as an arrow for control characters (element 259,\n\
2575 a single character);\n\
2576 the decoration indicating the presence of invisible lines (element 260,\n\
2577 a vector of characters).\n\
2578If this variable is nil, the value of `standard-display-table' is used.\n\
2579Each window can have its own, overriding display table.");
2580#endif
2581 DEFVAR_PER_BUFFER ("buffer-display-table", &current_buffer->display_table,
2582 Qnil, 0);
2583
2584/*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
2585 "Don't ask.");
2586*/
2587 DEFVAR_LISP ("before-change-function", &Vbefore_change_function,
2588 "Function to call before each text change.\n\
2589Two arguments are passed to the function: the positions of\n\
2590the beginning and end of the range of old text to be changed.\n\
2591\(For an insertion, the beginning and end are at the same place.)\n\
2592No information is given about the length of the text after the change.\n\
2593\n\
2594Buffer changes made while executing the `before-change-function'\n\
2595don't call any before-change or after-change functions.\n\
2596That's because these variables are temporarily set to nil.\n\
2597As a result, a hook function cannot straightforwardly alter the value of\n\
2598these variables. See the Emacs Lisp manual for a way of\n\
2599accomplishing an equivalent result by using other variables.");
2600 Vbefore_change_function = Qnil;
2601
2602 DEFVAR_LISP ("after-change-function", &Vafter_change_function,
2603 "Function to call after each text change.\n\
2604Three arguments are passed to the function: the positions of\n\
2605the beginning and end of the range of changed text,\n\
2606and the length of the pre-change text replaced by that range.\n\
2607\(For an insertion, the pre-change length is zero;\n\
2608for a deletion, that length is the number of characters deleted,\n\
2609and the post-change beginning and end are at the same place.)\n\
2610\n\
2611Buffer changes made while executing the `after-change-function'\n\
2612don't call any before-change or after-change functions.\n\
2613That's because these variables are temporarily set to nil.\n\
2614As a result, a hook function cannot straightforwardly alter the value of\n\
2615these variables. See the Emacs Lisp manual for a way of\n\
2616accomplishing an equivalent result by using other variables.");
2617 Vafter_change_function = Qnil;
2618
2619 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions,
2620 "List of functions to call before each text change.\n\
2621Two arguments are passed to each function: the positions of\n\
2622the beginning and end of the range of old text to be changed.\n\
2623\(For an insertion, the beginning and end are at the same place.)\n\
2624No information is given about the length of the text after the change.\n\
2625\n\
2626Buffer changes made while executing the `before-change-functions'\n\
2627don't call any before-change or after-change functions.\n\
2628That's because these variables are temporarily set to nil.\n\
2629As a result, a hook function cannot straightforwardly alter the value of\n\
2630these variables. See the Emacs Lisp manual for a way of\n\
2631accomplishing an equivalent result by using other variables.");
2632 Vbefore_change_functions = Qnil;
2633
2634 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions,
2635 "List of function to call after each text change.\n\
2636Three arguments are passed to each function: the positions of\n\
2637the beginning and end of the range of changed text,\n\
2638and the length of the pre-change text replaced by that range.\n\
2639\(For an insertion, the pre-change length is zero;\n\
2640for a deletion, that length is the number of characters deleted,\n\
2641and the post-change beginning and end are at the same place.)\n\
2642\n\
2643Buffer changes made while executing the `after-change-functions'\n\
2644don't call any before-change or after-change functions.\n\
2645That's because these variables are temporarily set to nil.\n\
2646As a result, a hook function cannot straightforwardly alter the value of\n\
2647these variables. See the Emacs Lisp manual for a way of\n\
2648accomplishing an equivalent result by using other variables.");
2649
2650 Vafter_change_functions = Qnil;
2651
2652 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook,
2653 "A list of functions to call before changing a buffer which is unmodified.\n\
2654The functions are run using the `run-hooks' function.");
2655 Vfirst_change_hook = Qnil;
2656 Qfirst_change_hook = intern ("first-change-hook");
2657 staticpro (&Qfirst_change_hook);
2658
2659#if 0 /* The doc string is too long for some compilers,
2660 but make-docfile can find it in this comment. */
2661 DEFVAR_PER_BUFFER ("buffer-undo-list", &current_buffer->undo_list, Qnil,
2662 "List of undo entries in current buffer.\n\
2663Recent changes come first; older changes follow newer.\n\
2664\n\
2665An entry (START . END) represents an insertion which begins at\n\
2666position START and ends at position END.\n\
2667\n\
2668An entry (TEXT . POSITION) represents the deletion of the string TEXT\n\
2669from (abs POSITION). If POSITION is positive, point was at the front\n\
2670of the text being deleted; if negative, point was at the end.\n\
2671\n\
2672An entry (t HIGHWORD LOWWORD) indicates that the buffer had been\n\
2673previously unmodified. HIGHWORD and LOWWORD are the high and low\n\
267416-bit words of the buffer's modification count at the time. If the\n\
2675modification count of the most recent save is different, this entry is\n\
2676obsolete.\n\
2677\n\
2678An entry (nil PROP VAL BEG . END) indicates that a text property\n\
2679was modified between BEG and END. PROP is the property name,\n\
2680and VAL is the old value.\n\
2681\n\
2682An entry of the form POSITION indicates that point was at the buffer\n\
2683location given by the integer. Undoing an entry of this form places\n\
2684point at POSITION.\n\
2685\n\
2686nil marks undo boundaries. The undo command treats the changes\n\
2687between two undo boundaries as a single step to be undone.\n\
2688\n\
2689If the value of the variable is t, undo information is not recorded.");
2690#endif
2691 DEFVAR_PER_BUFFER ("buffer-undo-list", &current_buffer->undo_list, Qnil,
2692 0);
2693
2694 DEFVAR_PER_BUFFER ("mark-active", &current_buffer->mark_active, Qnil,
2695 "Non-nil means the mark and region are currently active in this buffer.\n\
2696Automatically local in all buffers.");
2697
2698 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode,
2699 "*Non-nil means deactivate the mark when the buffer contents change.");
2700 Vtransient_mark_mode = Qnil;
2701
2702 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only,
2703 "*Non-nil means disregard read-only status of buffers or characters.\n\
2704If the value is t, disregard `buffer-read-only' and all `read-only'\n\
2705text properties. If the value is a list, disregard `buffer-read-only'\n\
2706and disregard a `read-only' text property if the property value\n\
2707is a member of the list.");
2708 Vinhibit_read_only = Qnil;
2709
2710 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions,
2711 "List of functions called with no args to query before killing a buffer.");
2712 Vkill_buffer_query_functions = Qnil;
2713
2714 defsubr (&Sbuffer_list);
2715 defsubr (&Sget_buffer);
2716 defsubr (&Sget_file_buffer);
2717 defsubr (&Sget_buffer_create);
2718 defsubr (&Sgenerate_new_buffer_name);
2719 defsubr (&Sbuffer_name);
2720/*defsubr (&Sbuffer_number);*/
2721 defsubr (&Sbuffer_file_name);
2722 defsubr (&Sbuffer_local_variables);
2723 defsubr (&Sbuffer_modified_p);
2724 defsubr (&Sset_buffer_modified_p);
2725 defsubr (&Sbuffer_modified_tick);
2726 defsubr (&Srename_buffer);
2727 defsubr (&Sother_buffer);
2728 defsubr (&Sbuffer_disable_undo);
2729 defsubr (&Sbuffer_enable_undo);
2730 defsubr (&Skill_buffer);
2731 defsubr (&Serase_buffer);
2732 defsubr (&Sswitch_to_buffer);
2733 defsubr (&Spop_to_buffer);
2734 defsubr (&Scurrent_buffer);
2735 defsubr (&Sset_buffer);
2736 defsubr (&Sbarf_if_buffer_read_only);
2737 defsubr (&Sbury_buffer);
2738 defsubr (&Slist_buffers);
2739 defsubr (&Skill_all_local_variables);
2740
2741 defsubr (&Soverlayp);
2742 defsubr (&Smake_overlay);
2743 defsubr (&Sdelete_overlay);
2744 defsubr (&Smove_overlay);
2745 defsubr (&Soverlay_start);
2746 defsubr (&Soverlay_end);
2747 defsubr (&Soverlay_buffer);
2748 defsubr (&Soverlay_properties);
2749 defsubr (&Soverlays_at);
2750 defsubr (&Snext_overlay_change);
2751 defsubr (&Soverlay_recenter);
2752 defsubr (&Soverlay_lists);
2753 defsubr (&Soverlay_get);
2754 defsubr (&Soverlay_put);
2755}
2756
2757keys_of_buffer ()
2758{
2759 initial_define_key (control_x_map, 'b', "switch-to-buffer");
2760 initial_define_key (control_x_map, 'k', "kill-buffer");
2761 initial_define_key (control_x_map, Ctl ('B'), "list-buffers");
2762
2763 /* This must not be in syms_of_buffer, because Qdisabled is not
2764 initialized when that function gets called. */
2765 Fput (intern ("erase-buffer"), Qdisabled, Qt);
2766}