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