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