]> code.delx.au - gnu-emacs/blob - src/buffer.c
(MARKBIT): Update comment.
[gnu-emacs] / src / buffer.c
1 /* Buffer manipulation primitives for GNU Emacs.
2 Copyright (C) 1985,86,87,88,89,93,94,95,97,98, 1999, 2000, 2001, 02, 2003
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, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
21
22 #include <config.h>
23
24 #include <sys/types.h>
25 #include <sys/stat.h>
26 #include <sys/param.h>
27 #include <errno.h>
28 #include <stdio.h>
29
30 #ifndef USE_CRT_DLL
31 extern int errno;
32 #endif
33
34 #ifndef MAXPATHLEN
35 /* in 4.1, param.h fails to define this. */
36 #define MAXPATHLEN 1024
37 #endif /* not MAXPATHLEN */
38
39 #ifdef HAVE_UNISTD_H
40 #include <unistd.h>
41 #endif
42
43 #include "lisp.h"
44 #include "intervals.h"
45 #include "window.h"
46 #include "commands.h"
47 #include "buffer.h"
48 #include "charset.h"
49 #include "region-cache.h"
50 #include "indent.h"
51 #include "blockinput.h"
52 #include "keyboard.h"
53 #include "keymap.h"
54 #include "frame.h"
55
56 struct buffer *current_buffer; /* the current buffer */
57
58 /* First buffer in chain of all buffers (in reverse order of creation).
59 Threaded through ->next. */
60
61 struct buffer *all_buffers;
62
63 /* This structure holds the default values of the buffer-local variables
64 defined with DEFVAR_PER_BUFFER, that have special slots in each buffer.
65 The default value occupies the same slot in this structure
66 as an individual buffer's value occupies in that buffer.
67 Setting the default value also goes through the alist of buffers
68 and stores into each buffer that does not say it has a local value. */
69
70 struct buffer buffer_defaults;
71
72 /* A Lisp_Object pointer to the above, used for staticpro */
73
74 static Lisp_Object Vbuffer_defaults;
75
76 /* This structure marks which slots in a buffer have corresponding
77 default values in buffer_defaults.
78 Each such slot has a nonzero value in this structure.
79 The value has only one nonzero bit.
80
81 When a buffer has its own local value for a slot,
82 the entry for that slot (found in the same slot in this structure)
83 is turned on in the buffer's local_flags array.
84
85 If a slot in this structure is -1, then even though there may
86 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
87 and the corresponding slot in buffer_defaults is not used.
88
89 If a slot is -2, then there is no DEFVAR_PER_BUFFER for it,
90 but there is a default value which is copied into each buffer.
91
92 If a slot in this structure is negative, then even though there may
93 be a DEFVAR_PER_BUFFER for the slot, there is no default value for it;
94 and the corresponding slot in buffer_defaults is not used.
95
96 If a slot in this structure corresponding to a DEFVAR_PER_BUFFER is
97 zero, that is a bug */
98
99 struct buffer buffer_local_flags;
100
101 /* This structure holds the names of symbols whose values may be
102 buffer-local. It is indexed and accessed in the same way as the above. */
103
104 struct buffer buffer_local_symbols;
105 /* A Lisp_Object pointer to the above, used for staticpro */
106 static Lisp_Object Vbuffer_local_symbols;
107
108 /* This structure holds the required types for the values in the
109 buffer-local slots. If a slot contains Qnil, then the
110 corresponding buffer slot may contain a value of any type. If a
111 slot contains an integer, then prospective values' tags must be
112 equal to that integer (except nil is always allowed).
113 When a tag does not match, the function
114 buffer_slot_type_mismatch will signal an error.
115
116 If a slot here contains -1, the corresponding variable is read-only. */
117 struct buffer buffer_local_types;
118
119 /* Flags indicating which built-in buffer-local variables
120 are permanent locals. */
121 static char buffer_permanent_local_flags[MAX_PER_BUFFER_VARS];
122
123 /* Number of per-buffer variables used. */
124
125 int last_per_buffer_idx;
126
127 Lisp_Object Fset_buffer ();
128 void set_buffer_internal ();
129 void set_buffer_internal_1 ();
130 static void call_overlay_mod_hooks ();
131 static void swap_out_buffer_local_variables ();
132 static void reset_buffer_local_variables ();
133
134 /* Alist of all buffer names vs the buffers. */
135 /* This used to be a variable, but is no longer,
136 to prevent lossage due to user rplac'ing this alist or its elements. */
137 Lisp_Object Vbuffer_alist;
138
139 /* Functions to call before and after each text change. */
140 Lisp_Object Vbefore_change_functions;
141 Lisp_Object Vafter_change_functions;
142
143 Lisp_Object Vtransient_mark_mode;
144
145 /* t means ignore all read-only text properties.
146 A list means ignore such a property if its value is a member of the list.
147 Any non-nil value means ignore buffer-read-only. */
148 Lisp_Object Vinhibit_read_only;
149
150 /* List of functions to call that can query about killing a buffer.
151 If any of these functions returns nil, we don't kill it. */
152 Lisp_Object Vkill_buffer_query_functions;
153 Lisp_Object Qkill_buffer_query_functions;
154
155 /* List of functions to call before changing an unmodified buffer. */
156 Lisp_Object Vfirst_change_hook;
157
158 Lisp_Object Qfirst_change_hook;
159 Lisp_Object Qbefore_change_functions;
160 Lisp_Object Qafter_change_functions;
161 Lisp_Object Qucs_set_table_for_input;
162
163 /* If nonzero, all modification hooks are suppressed. */
164 int inhibit_modification_hooks;
165
166 Lisp_Object Qfundamental_mode, Qmode_class, Qpermanent_local;
167
168 Lisp_Object Qprotected_field;
169
170 Lisp_Object QSFundamental; /* A string "Fundamental" */
171
172 Lisp_Object Qkill_buffer_hook;
173
174 Lisp_Object Qget_file_buffer;
175
176 Lisp_Object Qoverlayp;
177
178 Lisp_Object Qpriority, Qwindow, Qevaporate, Qbefore_string, Qafter_string;
179
180 Lisp_Object Qmodification_hooks;
181 Lisp_Object Qinsert_in_front_hooks;
182 Lisp_Object Qinsert_behind_hooks;
183
184 static void alloc_buffer_text P_ ((struct buffer *, size_t));
185 static void free_buffer_text P_ ((struct buffer *b));
186 static Lisp_Object copy_overlays P_ ((struct buffer *, Lisp_Object));
187 static void modify_overlay P_ ((struct buffer *, int, int));
188
189
190 /* For debugging; temporary. See set_buffer_internal. */
191 /* Lisp_Object Qlisp_mode, Vcheck_symbol; */
192
193 void
194 nsberror (spec)
195 Lisp_Object spec;
196 {
197 if (STRINGP (spec))
198 error ("No buffer named %s", SDATA (spec));
199 error ("Invalid buffer argument");
200 }
201 \f
202 DEFUN ("buffer-live-p", Fbuffer_live_p, Sbuffer_live_p, 1, 1, 0,
203 doc: /* Return non-nil if OBJECT is a buffer which has not been killed.
204 Value is nil if OBJECT is not a buffer or if it has been killed. */)
205 (object)
206 Lisp_Object object;
207 {
208 return ((BUFFERP (object) && ! NILP (XBUFFER (object)->name))
209 ? Qt : Qnil);
210 }
211
212 DEFUN ("buffer-list", Fbuffer_list, Sbuffer_list, 0, 1, 0,
213 doc: /* Return a list of all existing live buffers.
214 If the optional arg FRAME is a frame, we return the buffer list
215 in the proper order for that frame: the buffers in FRAME's `buffer-list'
216 frame parameter come first, followed by the rest of the buffers. */)
217 (frame)
218 Lisp_Object frame;
219 {
220 Lisp_Object framelist, general;
221 general = Fmapcar (Qcdr, Vbuffer_alist);
222
223 if (FRAMEP (frame))
224 {
225 Lisp_Object tail;
226
227 CHECK_FRAME (frame);
228
229 framelist = Fcopy_sequence (XFRAME (frame)->buffer_list);
230
231 /* Remove from GENERAL any buffer that duplicates one in FRAMELIST. */
232 tail = framelist;
233 while (! NILP (tail))
234 {
235 general = Fdelq (XCAR (tail), general);
236 tail = XCDR (tail);
237 }
238 return nconc2 (framelist, general);
239 }
240
241 return general;
242 }
243
244 /* Like Fassoc, but use Fstring_equal to compare
245 (which ignores text properties),
246 and don't ever QUIT. */
247
248 static Lisp_Object
249 assoc_ignore_text_properties (key, list)
250 register Lisp_Object key;
251 Lisp_Object list;
252 {
253 register Lisp_Object tail;
254 for (tail = list; CONSP (tail); tail = XCDR (tail))
255 {
256 register Lisp_Object elt, tem;
257 elt = XCAR (tail);
258 tem = Fstring_equal (Fcar (elt), key);
259 if (!NILP (tem))
260 return elt;
261 }
262 return Qnil;
263 }
264
265 DEFUN ("get-buffer", Fget_buffer, Sget_buffer, 1, 1, 0,
266 doc: /* Return the buffer named NAME (a string).
267 If there is no live buffer named NAME, return nil.
268 NAME may also be a buffer; if so, the value is that buffer. */)
269 (name)
270 register Lisp_Object name;
271 {
272 if (BUFFERP (name))
273 return name;
274 CHECK_STRING (name);
275
276 return Fcdr (assoc_ignore_text_properties (name, Vbuffer_alist));
277 }
278
279 DEFUN ("get-file-buffer", Fget_file_buffer, Sget_file_buffer, 1, 1, 0,
280 doc: /* Return the buffer visiting file FILENAME (a string).
281 The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.
282 If there is no such live buffer, return nil.
283 See also `find-buffer-visiting'. */)
284 (filename)
285 register Lisp_Object filename;
286 {
287 register Lisp_Object tail, buf, tem;
288 Lisp_Object handler;
289
290 CHECK_STRING (filename);
291 filename = Fexpand_file_name (filename, Qnil);
292
293 /* If the file name has special constructs in it,
294 call the corresponding file handler. */
295 handler = Ffind_file_name_handler (filename, Qget_file_buffer);
296 if (!NILP (handler))
297 return call2 (handler, Qget_file_buffer, filename);
298
299 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
300 {
301 buf = Fcdr (XCAR (tail));
302 if (!BUFFERP (buf)) continue;
303 if (!STRINGP (XBUFFER (buf)->filename)) continue;
304 tem = Fstring_equal (XBUFFER (buf)->filename, filename);
305 if (!NILP (tem))
306 return buf;
307 }
308 return Qnil;
309 }
310
311 Lisp_Object
312 get_truename_buffer (filename)
313 register Lisp_Object filename;
314 {
315 register Lisp_Object tail, buf, tem;
316
317 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
318 {
319 buf = Fcdr (XCAR (tail));
320 if (!BUFFERP (buf)) continue;
321 if (!STRINGP (XBUFFER (buf)->file_truename)) continue;
322 tem = Fstring_equal (XBUFFER (buf)->file_truename, filename);
323 if (!NILP (tem))
324 return buf;
325 }
326 return Qnil;
327 }
328
329 /* Incremented for each buffer created, to assign the buffer number. */
330 int buffer_count;
331
332 DEFUN ("get-buffer-create", Fget_buffer_create, Sget_buffer_create, 1, 1, 0,
333 doc: /* Return the buffer named NAME, or create such a buffer and return it.
334 A new buffer is created if there is no live buffer named NAME.
335 If NAME starts with a space, the new buffer does not keep undo information.
336 If NAME is a buffer instead of a string, then it is the value returned.
337 The value is never nil. */)
338 (name)
339 register Lisp_Object name;
340 {
341 register Lisp_Object buf;
342 register struct buffer *b;
343
344 buf = Fget_buffer (name);
345 if (!NILP (buf))
346 return buf;
347
348 if (SCHARS (name) == 0)
349 error ("Empty string for buffer name is not allowed");
350
351 b = (struct buffer *) allocate_buffer ();
352
353 b->size = sizeof (struct buffer) / sizeof (EMACS_INT);
354
355 /* An ordinary buffer uses its own struct buffer_text. */
356 b->text = &b->own_text;
357 b->base_buffer = 0;
358
359 BUF_GAP_SIZE (b) = 20;
360 BLOCK_INPUT;
361 /* We allocate extra 1-byte at the tail and keep it always '\0' for
362 anchoring a search. */
363 alloc_buffer_text (b, BUF_GAP_SIZE (b) + 1);
364 UNBLOCK_INPUT;
365 if (! BUF_BEG_ADDR (b))
366 buffer_memory_full ();
367
368 BUF_PT (b) = BEG;
369 BUF_GPT (b) = BEG;
370 BUF_BEGV (b) = BEG;
371 BUF_ZV (b) = BEG;
372 BUF_Z (b) = BEG;
373 BUF_PT_BYTE (b) = BEG_BYTE;
374 BUF_GPT_BYTE (b) = BEG_BYTE;
375 BUF_BEGV_BYTE (b) = BEG_BYTE;
376 BUF_ZV_BYTE (b) = BEG_BYTE;
377 BUF_Z_BYTE (b) = BEG_BYTE;
378 BUF_MODIFF (b) = 1;
379 BUF_OVERLAY_MODIFF (b) = 1;
380 BUF_SAVE_MODIFF (b) = 1;
381 BUF_INTERVALS (b) = 0;
382 BUF_UNCHANGED_MODIFIED (b) = 1;
383 BUF_OVERLAY_UNCHANGED_MODIFIED (b) = 1;
384 BUF_END_UNCHANGED (b) = 0;
385 BUF_BEG_UNCHANGED (b) = 0;
386 *(BUF_GPT_ADDR (b)) = *(BUF_Z_ADDR (b)) = 0; /* Put an anchor '\0'. */
387
388 b->newline_cache = 0;
389 b->width_run_cache = 0;
390 b->width_table = Qnil;
391 b->prevent_redisplay_optimizations_p = 1;
392
393 /* Put this on the chain of all buffers including killed ones. */
394 b->next = all_buffers;
395 all_buffers = b;
396
397 /* An ordinary buffer normally doesn't need markers
398 to handle BEGV and ZV. */
399 b->pt_marker = Qnil;
400 b->begv_marker = Qnil;
401 b->zv_marker = Qnil;
402
403 name = Fcopy_sequence (name);
404 STRING_SET_INTERVALS (name, NULL_INTERVAL);
405 b->name = name;
406
407 if (SREF (name, 0) != ' ')
408 b->undo_list = Qnil;
409 else
410 b->undo_list = Qt;
411
412 reset_buffer (b);
413 reset_buffer_local_variables (b, 1);
414
415 b->mark = Fmake_marker ();
416 BUF_MARKERS (b) = NULL;
417 b->name = name;
418
419 /* Put this in the alist of all live buffers. */
420 XSETBUFFER (buf, b);
421 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
422
423 /* An error in calling the function here (should someone redfine it)
424 can lead to infinite regress until you run out of stack. rms
425 says that's not worth protecting against. */
426 if (!NILP (Ffboundp (Qucs_set_table_for_input)))
427 /* buf is on buffer-alist, so no gcpro. */
428 call1 (Qucs_set_table_for_input, buf);
429
430 return buf;
431 }
432
433
434 /* Return a list of overlays which is a copy of the overlay list
435 LIST, but for buffer B. */
436
437 static Lisp_Object
438 copy_overlays (b, list)
439 struct buffer *b;
440 Lisp_Object list;
441 {
442 Lisp_Object result, buffer;
443
444 XSETBUFFER (buffer, b);
445
446 for (result = Qnil; CONSP (list); list = XCDR (list))
447 {
448 Lisp_Object overlay, start, end, old_overlay;
449 int charpos;
450
451 old_overlay = XCAR (list);
452 charpos = marker_position (OVERLAY_START (old_overlay));
453 start = Fmake_marker ();
454 Fset_marker (start, make_number (charpos), buffer);
455 XMARKER (start)->insertion_type
456 = XMARKER (OVERLAY_START (old_overlay))->insertion_type;
457
458 charpos = marker_position (OVERLAY_END (old_overlay));
459 end = Fmake_marker ();
460 Fset_marker (end, make_number (charpos), buffer);
461 XMARKER (end)->insertion_type
462 = XMARKER (OVERLAY_END (old_overlay))->insertion_type;
463
464 overlay = allocate_misc ();
465 XMISCTYPE (overlay) = Lisp_Misc_Overlay;
466 OVERLAY_START (overlay) = start;
467 OVERLAY_END (overlay) = end;
468 OVERLAY_PLIST (overlay) = Fcopy_sequence (OVERLAY_PLIST (old_overlay));
469
470 result = Fcons (overlay, result);
471 }
472
473 return Fnreverse (result);
474 }
475
476
477 /* Clone per-buffer values of buffer FROM.
478
479 Buffer TO gets the same per-buffer values as FROM, with the
480 following exceptions: (1) TO's name is left untouched, (2) markers
481 are copied and made to refer to TO, and (3) overlay lists are
482 copied. */
483
484 static void
485 clone_per_buffer_values (from, to)
486 struct buffer *from, *to;
487 {
488 Lisp_Object to_buffer;
489 int offset;
490
491 XSETBUFFER (to_buffer, to);
492
493 for (offset = PER_BUFFER_VAR_OFFSET (name) + sizeof (Lisp_Object);
494 offset < sizeof *to;
495 offset += sizeof (Lisp_Object))
496 {
497 Lisp_Object obj;
498
499 obj = PER_BUFFER_VALUE (from, offset);
500 if (MARKERP (obj))
501 {
502 struct Lisp_Marker *m = XMARKER (obj);
503 obj = Fmake_marker ();
504 XMARKER (obj)->insertion_type = m->insertion_type;
505 set_marker_both (obj, to_buffer, m->charpos, m->bytepos);
506 }
507
508 PER_BUFFER_VALUE (to, offset) = obj;
509 }
510
511 bcopy (from->local_flags, to->local_flags, sizeof to->local_flags);
512
513 to->overlays_before = copy_overlays (to, from->overlays_before);
514 to->overlays_after = copy_overlays (to, from->overlays_after);
515 }
516
517
518 DEFUN ("make-indirect-buffer", Fmake_indirect_buffer, Smake_indirect_buffer,
519 2, 3,
520 "bMake indirect buffer (to buffer): \nBName of indirect buffer: ",
521 doc: /* Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.
522 BASE-BUFFER should be an existing buffer (or buffer name).
523 NAME should be a string which is not the name of an existing buffer.
524 Optional argument CLONE non-nil means preserve BASE-BUFFER's state,
525 such as major and minor modes, in the indirect buffer.
526 CLONE nil means the indirect buffer's state is reset to default values. */)
527 (base_buffer, name, clone)
528 Lisp_Object base_buffer, name, clone;
529 {
530 Lisp_Object buf;
531 struct buffer *b;
532
533 buf = Fget_buffer (name);
534 if (!NILP (buf))
535 error ("Buffer name `%s' is in use", SDATA (name));
536
537 base_buffer = Fget_buffer (base_buffer);
538 if (NILP (base_buffer))
539 error ("No such buffer: `%s'", SDATA (name));
540
541 if (SCHARS (name) == 0)
542 error ("Empty string for buffer name is not allowed");
543
544 b = (struct buffer *) allocate_buffer ();
545 b->size = sizeof (struct buffer) / sizeof (EMACS_INT);
546
547 if (XBUFFER (base_buffer)->base_buffer)
548 b->base_buffer = XBUFFER (base_buffer)->base_buffer;
549 else
550 b->base_buffer = XBUFFER (base_buffer);
551
552 /* Use the base buffer's text object. */
553 b->text = b->base_buffer->text;
554
555 BUF_BEGV (b) = BUF_BEGV (b->base_buffer);
556 BUF_ZV (b) = BUF_ZV (b->base_buffer);
557 BUF_PT (b) = BUF_PT (b->base_buffer);
558 BUF_BEGV_BYTE (b) = BUF_BEGV_BYTE (b->base_buffer);
559 BUF_ZV_BYTE (b) = BUF_ZV_BYTE (b->base_buffer);
560 BUF_PT_BYTE (b) = BUF_PT_BYTE (b->base_buffer);
561
562 b->newline_cache = 0;
563 b->width_run_cache = 0;
564 b->width_table = Qnil;
565
566 /* Put this on the chain of all buffers including killed ones. */
567 b->next = all_buffers;
568 all_buffers = b;
569
570 name = Fcopy_sequence (name);
571 STRING_SET_INTERVALS (name, NULL_INTERVAL);
572 b->name = name;
573
574 reset_buffer (b);
575 reset_buffer_local_variables (b, 1);
576
577 /* Put this in the alist of all live buffers. */
578 XSETBUFFER (buf, b);
579 Vbuffer_alist = nconc2 (Vbuffer_alist, Fcons (Fcons (name, buf), Qnil));
580
581 b->mark = Fmake_marker ();
582 b->name = name;
583
584 /* The multibyte status belongs to the base buffer. */
585 b->enable_multibyte_characters = b->base_buffer->enable_multibyte_characters;
586
587 /* Make sure the base buffer has markers for its narrowing. */
588 if (NILP (b->base_buffer->pt_marker))
589 {
590 b->base_buffer->pt_marker = Fmake_marker ();
591 set_marker_both (b->base_buffer->pt_marker, base_buffer,
592 BUF_PT (b->base_buffer),
593 BUF_PT_BYTE (b->base_buffer));
594 }
595 if (NILP (b->base_buffer->begv_marker))
596 {
597 b->base_buffer->begv_marker = Fmake_marker ();
598 set_marker_both (b->base_buffer->begv_marker, base_buffer,
599 BUF_BEGV (b->base_buffer),
600 BUF_BEGV_BYTE (b->base_buffer));
601 }
602 if (NILP (b->base_buffer->zv_marker))
603 {
604 b->base_buffer->zv_marker = Fmake_marker ();
605 set_marker_both (b->base_buffer->zv_marker, base_buffer,
606 BUF_ZV (b->base_buffer),
607 BUF_ZV_BYTE (b->base_buffer));
608 XMARKER (b->base_buffer->zv_marker)->insertion_type = 1;
609 }
610
611 if (NILP (clone))
612 {
613 /* Give the indirect buffer markers for its narrowing. */
614 b->pt_marker = Fmake_marker ();
615 set_marker_both (b->pt_marker, buf, BUF_PT (b), BUF_PT_BYTE (b));
616 b->begv_marker = Fmake_marker ();
617 set_marker_both (b->begv_marker, buf, BUF_BEGV (b), BUF_BEGV_BYTE (b));
618 b->zv_marker = Fmake_marker ();
619 set_marker_both (b->zv_marker, buf, BUF_ZV (b), BUF_ZV_BYTE (b));
620 XMARKER (b->zv_marker)->insertion_type = 1;
621 }
622 else
623 clone_per_buffer_values (b->base_buffer, b);
624
625 return buf;
626 }
627
628 /* Reinitialize everything about a buffer except its name and contents
629 and local variables. */
630
631 void
632 reset_buffer (b)
633 register struct buffer *b;
634 {
635 b->filename = Qnil;
636 b->file_truename = Qnil;
637 b->directory = (current_buffer) ? current_buffer->directory : Qnil;
638 b->modtime = 0;
639 XSETFASTINT (b->save_length, 0);
640 b->last_window_start = 1;
641 /* It is more conservative to start out "changed" than "unchanged". */
642 b->clip_changed = 0;
643 b->prevent_redisplay_optimizations_p = 1;
644 b->backed_up = Qnil;
645 b->auto_save_modified = 0;
646 b->auto_save_failure_time = -1;
647 b->auto_save_file_name = Qnil;
648 b->read_only = Qnil;
649 b->overlays_before = Qnil;
650 b->overlays_after = Qnil;
651 XSETFASTINT (b->overlay_center, 1);
652 b->mark_active = Qnil;
653 b->point_before_scroll = Qnil;
654 b->file_format = Qnil;
655 b->last_selected_window = Qnil;
656 XSETINT (b->display_count, 0);
657 b->display_time = Qnil;
658 b->enable_multibyte_characters = buffer_defaults.enable_multibyte_characters;
659 b->cursor_type = buffer_defaults.cursor_type;
660 b->extra_line_spacing = buffer_defaults.extra_line_spacing;
661
662 b->display_error_modiff = 0;
663 }
664
665 /* Reset buffer B's local variables info.
666 Don't use this on a buffer that has already been in use;
667 it does not treat permanent locals consistently.
668 Instead, use Fkill_all_local_variables.
669
670 If PERMANENT_TOO is 1, then we reset permanent built-in
671 buffer-local variables. If PERMANENT_TOO is 0,
672 we preserve those. */
673
674 static void
675 reset_buffer_local_variables (b, permanent_too)
676 register struct buffer *b;
677 int permanent_too;
678 {
679 register int offset;
680 int i;
681
682 /* Reset the major mode to Fundamental, together with all the
683 things that depend on the major mode.
684 default-major-mode is handled at a higher level.
685 We ignore it here. */
686 b->major_mode = Qfundamental_mode;
687 b->keymap = Qnil;
688 b->mode_name = QSFundamental;
689 b->minor_modes = Qnil;
690
691 /* If the standard case table has been altered and invalidated,
692 fix up its insides first. */
693 if (! (CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[0])
694 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[1])
695 && CHAR_TABLE_P (XCHAR_TABLE (Vascii_downcase_table)->extras[2])))
696 Fset_standard_case_table (Vascii_downcase_table);
697
698 b->downcase_table = Vascii_downcase_table;
699 b->upcase_table = XCHAR_TABLE (Vascii_downcase_table)->extras[0];
700 b->case_canon_table = XCHAR_TABLE (Vascii_downcase_table)->extras[1];
701 b->case_eqv_table = XCHAR_TABLE (Vascii_downcase_table)->extras[2];
702 b->invisibility_spec = Qt;
703 #ifndef DOS_NT
704 b->buffer_file_type = Qnil;
705 #endif
706
707 /* Reset all (or most) per-buffer variables to their defaults. */
708 b->local_var_alist = Qnil;
709 for (i = 0; i < last_per_buffer_idx; ++i)
710 if (permanent_too || buffer_permanent_local_flags[i] == 0)
711 SET_PER_BUFFER_VALUE_P (b, i, 0);
712
713 /* For each slot that has a default value,
714 copy that into the slot. */
715
716 for (offset = PER_BUFFER_VAR_OFFSET (name);
717 offset < sizeof *b;
718 offset += sizeof (Lisp_Object))
719 {
720 int idx = PER_BUFFER_IDX (offset);
721 if ((idx > 0
722 && (permanent_too
723 || buffer_permanent_local_flags[idx] == 0))
724 /* Is -2 used anywhere? */
725 || idx == -2)
726 PER_BUFFER_VALUE (b, offset) = PER_BUFFER_DEFAULT (offset);
727 }
728 }
729
730 /* We split this away from generate-new-buffer, because rename-buffer
731 and set-visited-file-name ought to be able to use this to really
732 rename the buffer properly. */
733
734 DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name, Sgenerate_new_buffer_name,
735 1, 2, 0,
736 doc: /* Return a string that is the name of no existing buffer based on NAME.
737 If there is no live buffer named NAME, then return NAME.
738 Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
739 until an unused name is found, and then return that name.
740 Optional second argument IGNORE specifies a name that is okay to use
741 \(if it is in the sequence to be tried)
742 even if a buffer with that name exists. */)
743 (name, ignore)
744 register Lisp_Object name, ignore;
745 {
746 register Lisp_Object gentemp, tem;
747 int count;
748 char number[10];
749
750 CHECK_STRING (name);
751
752 tem = Fget_buffer (name);
753 if (NILP (tem))
754 return name;
755
756 count = 1;
757 while (1)
758 {
759 sprintf (number, "<%d>", ++count);
760 gentemp = concat2 (name, build_string (number));
761 tem = Fstring_equal (gentemp, ignore);
762 if (!NILP (tem))
763 return gentemp;
764 tem = Fget_buffer (gentemp);
765 if (NILP (tem))
766 return gentemp;
767 }
768 }
769
770 \f
771 DEFUN ("buffer-name", Fbuffer_name, Sbuffer_name, 0, 1, 0,
772 doc: /* Return the name of BUFFER, as a string.
773 With no argument or nil as argument, return the name of the current buffer. */)
774 (buffer)
775 register Lisp_Object buffer;
776 {
777 if (NILP (buffer))
778 return current_buffer->name;
779 CHECK_BUFFER (buffer);
780 return XBUFFER (buffer)->name;
781 }
782
783 DEFUN ("buffer-file-name", Fbuffer_file_name, Sbuffer_file_name, 0, 1, 0,
784 doc: /* Return name of file BUFFER is visiting, or nil if none.
785 No argument or nil as argument means use the current buffer. */)
786 (buffer)
787 register Lisp_Object buffer;
788 {
789 if (NILP (buffer))
790 return current_buffer->filename;
791 CHECK_BUFFER (buffer);
792 return XBUFFER (buffer)->filename;
793 }
794
795 DEFUN ("buffer-base-buffer", Fbuffer_base_buffer, Sbuffer_base_buffer,
796 0, 1, 0,
797 doc: /* Return the base buffer of indirect buffer BUFFER.
798 If BUFFER is not indirect, return nil. */)
799 (buffer)
800 register Lisp_Object buffer;
801 {
802 struct buffer *base;
803 Lisp_Object base_buffer;
804
805 if (NILP (buffer))
806 base = current_buffer->base_buffer;
807 else
808 {
809 CHECK_BUFFER (buffer);
810 base = XBUFFER (buffer)->base_buffer;
811 }
812
813 if (! base)
814 return Qnil;
815 XSETBUFFER (base_buffer, base);
816 return base_buffer;
817 }
818
819 DEFUN ("buffer-local-value", Fbuffer_local_value,
820 Sbuffer_local_value, 2, 2, 0,
821 doc: /* Return the value of VARIABLE in BUFFER.
822 If VARIABLE does not have a buffer-local binding in BUFFER, the value
823 is the default binding of variable. */)
824 (symbol, buffer)
825 register Lisp_Object symbol;
826 register Lisp_Object buffer;
827 {
828 register struct buffer *buf;
829 register Lisp_Object result;
830
831 CHECK_SYMBOL (symbol);
832 CHECK_BUFFER (buffer);
833 buf = XBUFFER (buffer);
834
835 /* Look in local_var_list */
836 result = Fassoc (symbol, buf->local_var_alist);
837 if (NILP (result))
838 {
839 int offset, idx;
840 int found = 0;
841
842 /* Look in special slots */
843 for (offset = PER_BUFFER_VAR_OFFSET (name);
844 offset < sizeof (struct buffer);
845 /* sizeof EMACS_INT == sizeof Lisp_Object */
846 offset += (sizeof (EMACS_INT)))
847 {
848 idx = PER_BUFFER_IDX (offset);
849 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
850 && SYMBOLP (PER_BUFFER_SYMBOL (offset))
851 && EQ (PER_BUFFER_SYMBOL (offset), symbol))
852 {
853 result = PER_BUFFER_VALUE (buf, offset);
854 found = 1;
855 break;
856 }
857 }
858
859 if (!found)
860 result = Fdefault_value (symbol);
861 }
862 else
863 {
864 Lisp_Object valcontents;
865 Lisp_Object current_alist_element;
866
867 /* What binding is loaded right now? */
868 valcontents = SYMBOL_VALUE (symbol);
869 current_alist_element
870 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
871
872 /* The value of the currently loaded binding is not
873 stored in it, but rather in the realvalue slot.
874 Store that value into the binding it belongs to
875 in case that is the one we are about to use. */
876
877 Fsetcdr (current_alist_element,
878 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
879
880 /* Now get the (perhaps updated) value out of the binding. */
881 result = XCDR (result);
882 }
883
884 if (EQ (result, Qunbound))
885 return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
886
887 return result;
888 }
889
890 DEFUN ("buffer-local-variables", Fbuffer_local_variables,
891 Sbuffer_local_variables, 0, 1, 0,
892 doc: /* Return an alist of variables that are buffer-local in BUFFER.
893 Most elements look like (SYMBOL . VALUE), describing one variable.
894 For a symbol that is locally unbound, just the symbol appears in the value.
895 Note that storing new VALUEs in these elements doesn't change the variables.
896 No argument or nil as argument means use current buffer as BUFFER. */)
897 (buffer)
898 register Lisp_Object buffer;
899 {
900 register struct buffer *buf;
901 register Lisp_Object result;
902
903 if (NILP (buffer))
904 buf = current_buffer;
905 else
906 {
907 CHECK_BUFFER (buffer);
908 buf = XBUFFER (buffer);
909 }
910
911 result = Qnil;
912
913 {
914 register Lisp_Object tail;
915 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
916 {
917 Lisp_Object val, elt;
918
919 elt = XCAR (tail);
920
921 /* Reference each variable in the alist in buf.
922 If inquiring about the current buffer, this gets the current values,
923 so store them into the alist so the alist is up to date.
924 If inquiring about some other buffer, this swaps out any values
925 for that buffer, making the alist up to date automatically. */
926 val = find_symbol_value (XCAR (elt));
927 /* Use the current buffer value only if buf is the current buffer. */
928 if (buf != current_buffer)
929 val = XCDR (elt);
930
931 /* If symbol is unbound, put just the symbol in the list. */
932 if (EQ (val, Qunbound))
933 result = Fcons (XCAR (elt), result);
934 /* Otherwise, put (symbol . value) in the list. */
935 else
936 result = Fcons (Fcons (XCAR (elt), val), result);
937 }
938 }
939
940 /* Add on all the variables stored in special slots. */
941 {
942 int offset, idx;
943
944 for (offset = PER_BUFFER_VAR_OFFSET (name);
945 offset < sizeof (struct buffer);
946 /* sizeof EMACS_INT == sizeof Lisp_Object */
947 offset += (sizeof (EMACS_INT)))
948 {
949 idx = PER_BUFFER_IDX (offset);
950 if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
951 && SYMBOLP (PER_BUFFER_SYMBOL (offset)))
952 result = Fcons (Fcons (PER_BUFFER_SYMBOL (offset),
953 PER_BUFFER_VALUE (buf, offset)),
954 result);
955 }
956 }
957
958 return result;
959 }
960
961 \f
962 DEFUN ("buffer-modified-p", Fbuffer_modified_p, Sbuffer_modified_p,
963 0, 1, 0,
964 doc: /* Return t if BUFFER was modified since its file was last read or saved.
965 No argument or nil as argument means use current buffer as BUFFER. */)
966 (buffer)
967 register Lisp_Object buffer;
968 {
969 register struct buffer *buf;
970 if (NILP (buffer))
971 buf = current_buffer;
972 else
973 {
974 CHECK_BUFFER (buffer);
975 buf = XBUFFER (buffer);
976 }
977
978 return BUF_SAVE_MODIFF (buf) < BUF_MODIFF (buf) ? Qt : Qnil;
979 }
980
981 DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
982 1, 1, 0,
983 doc: /* Mark current buffer as modified or unmodified according to FLAG.
984 A non-nil FLAG means mark the buffer modified. */)
985 (flag)
986 register Lisp_Object flag;
987 {
988 register int already;
989 register Lisp_Object fn;
990 Lisp_Object buffer, window;
991
992 #ifdef CLASH_DETECTION
993 /* If buffer becoming modified, lock the file.
994 If buffer becoming unmodified, unlock the file. */
995
996 fn = current_buffer->file_truename;
997 /* Test buffer-file-name so that binding it to nil is effective. */
998 if (!NILP (fn) && ! NILP (current_buffer->filename))
999 {
1000 already = SAVE_MODIFF < MODIFF;
1001 if (!already && !NILP (flag))
1002 lock_file (fn);
1003 else if (already && NILP (flag))
1004 unlock_file (fn);
1005 }
1006 #endif /* CLASH_DETECTION */
1007
1008 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1009
1010 /* Set update_mode_lines only if buffer is displayed in some window.
1011 Packages like jit-lock or lazy-lock preserve a buffer's modified
1012 state by recording/restoring the state around blocks of code.
1013 Setting update_mode_lines makes redisplay consider all windows
1014 (on all frames). Stealth fontification of buffers not displayed
1015 would incur additional redisplay costs if we'd set
1016 update_modes_lines unconditionally.
1017
1018 Ideally, I think there should be another mechanism for fontifying
1019 buffers without "modifying" buffers, or redisplay should be
1020 smarter about updating the `*' in mode lines. --gerd */
1021 XSETBUFFER (buffer, current_buffer);
1022 window = Fget_buffer_window (buffer, Qt);
1023 if (WINDOWP (window))
1024 {
1025 ++update_mode_lines;
1026 current_buffer->prevent_redisplay_optimizations_p = 1;
1027 }
1028
1029 return flag;
1030 }
1031
1032 DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p,
1033 Srestore_buffer_modified_p, 1, 1, 0,
1034 doc: /* Like `set-buffer-modified-p', with a differences concerning redisplay.
1035 It is not ensured that mode lines will be updated to show the modified
1036 state of the current buffer. Use with care. */)
1037 (flag)
1038 Lisp_Object flag;
1039 {
1040 #ifdef CLASH_DETECTION
1041 Lisp_Object fn;
1042
1043 /* If buffer becoming modified, lock the file.
1044 If buffer becoming unmodified, unlock the file. */
1045
1046 fn = current_buffer->file_truename;
1047 /* Test buffer-file-name so that binding it to nil is effective. */
1048 if (!NILP (fn) && ! NILP (current_buffer->filename))
1049 {
1050 int already = SAVE_MODIFF < MODIFF;
1051 if (!already && !NILP (flag))
1052 lock_file (fn);
1053 else if (already && NILP (flag))
1054 unlock_file (fn);
1055 }
1056 #endif /* CLASH_DETECTION */
1057
1058 SAVE_MODIFF = NILP (flag) ? MODIFF : 0;
1059 return flag;
1060 }
1061
1062 DEFUN ("buffer-modified-tick", Fbuffer_modified_tick, Sbuffer_modified_tick,
1063 0, 1, 0,
1064 doc: /* Return BUFFER's tick counter, incremented for each change in text.
1065 Each buffer has a tick counter which is incremented each time the text in
1066 that buffer is changed. It wraps around occasionally.
1067 No argument or nil as argument means use current buffer as BUFFER. */)
1068 (buffer)
1069 register Lisp_Object buffer;
1070 {
1071 register struct buffer *buf;
1072 if (NILP (buffer))
1073 buf = current_buffer;
1074 else
1075 {
1076 CHECK_BUFFER (buffer);
1077 buf = XBUFFER (buffer);
1078 }
1079
1080 return make_number (BUF_MODIFF (buf));
1081 }
1082 \f
1083 DEFUN ("rename-buffer", Frename_buffer, Srename_buffer, 1, 2,
1084 "sRename buffer (to new name): \nP",
1085 doc: /* Change current buffer's name to NEWNAME (a string).
1086 If second arg UNIQUE is nil or omitted, it is an error if a
1087 buffer named NEWNAME already exists.
1088 If UNIQUE is non-nil, come up with a new name using
1089 `generate-new-buffer-name'.
1090 Interactively, you can set UNIQUE with a prefix argument.
1091 We return the name we actually gave the buffer.
1092 This does not change the name of the visited file (if any). */)
1093 (newname, unique)
1094 register Lisp_Object newname, unique;
1095 {
1096 register Lisp_Object tem, buf;
1097
1098 CHECK_STRING (newname);
1099
1100 if (SCHARS (newname) == 0)
1101 error ("Empty string is invalid as a buffer name");
1102
1103 tem = Fget_buffer (newname);
1104 if (!NILP (tem))
1105 {
1106 /* Don't short-circuit if UNIQUE is t. That is a useful way to
1107 rename the buffer automatically so you can create another
1108 with the original name. It makes UNIQUE equivalent to
1109 (rename-buffer (generate-new-buffer-name NEWNAME)). */
1110 if (NILP (unique) && XBUFFER (tem) == current_buffer)
1111 return current_buffer->name;
1112 if (!NILP (unique))
1113 newname = Fgenerate_new_buffer_name (newname, current_buffer->name);
1114 else
1115 error ("Buffer name `%s' is in use", SDATA (newname));
1116 }
1117
1118 current_buffer->name = newname;
1119
1120 /* Catch redisplay's attention. Unless we do this, the mode lines for
1121 any windows displaying current_buffer will stay unchanged. */
1122 update_mode_lines++;
1123
1124 XSETBUFFER (buf, current_buffer);
1125 Fsetcar (Frassq (buf, Vbuffer_alist), newname);
1126 if (NILP (current_buffer->filename)
1127 && !NILP (current_buffer->auto_save_file_name))
1128 call0 (intern ("rename-auto-save-file"));
1129 /* Refetch since that last call may have done GC. */
1130 return current_buffer->name;
1131 }
1132
1133 DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 3, 0,
1134 doc: /* Return most recently selected buffer other than BUFFER.
1135 Buffers not visible in windows are preferred to visible buffers,
1136 unless optional second argument VISIBLE-OK is non-nil.
1137 If the optional third argument FRAME is non-nil, use that frame's
1138 buffer list instead of the selected frame's buffer list.
1139 If no other buffer exists, the buffer `*scratch*' is returned.
1140 If BUFFER is omitted or nil, some interesting buffer is returned. */)
1141 (buffer, visible_ok, frame)
1142 register Lisp_Object buffer, visible_ok, frame;
1143 {
1144 Lisp_Object Fset_buffer_major_mode ();
1145 register Lisp_Object tail, buf, notsogood, tem, pred, add_ons;
1146 notsogood = Qnil;
1147
1148 if (NILP (frame))
1149 frame = selected_frame;
1150
1151 tail = Vbuffer_alist;
1152 pred = frame_buffer_predicate (frame);
1153
1154 /* Consider buffers that have been seen in the selected frame
1155 before other buffers. */
1156
1157 tem = frame_buffer_list (frame);
1158 add_ons = Qnil;
1159 while (CONSP (tem))
1160 {
1161 if (BUFFERP (XCAR (tem)))
1162 add_ons = Fcons (Fcons (Qnil, XCAR (tem)), add_ons);
1163 tem = XCDR (tem);
1164 }
1165 tail = nconc2 (Fnreverse (add_ons), tail);
1166
1167 for (; CONSP (tail); tail = XCDR (tail))
1168 {
1169 buf = Fcdr (XCAR (tail));
1170 if (EQ (buf, buffer))
1171 continue;
1172 if (SREF (XBUFFER (buf)->name, 0) == ' ')
1173 continue;
1174 /* If the selected frame has a buffer_predicate,
1175 disregard buffers that don't fit the predicate. */
1176 if (!NILP (pred))
1177 {
1178 tem = call1 (pred, buf);
1179 if (NILP (tem))
1180 continue;
1181 }
1182
1183 if (NILP (visible_ok))
1184 tem = Fget_buffer_window (buf, Qvisible);
1185 else
1186 tem = Qnil;
1187 if (NILP (tem))
1188 return buf;
1189 if (NILP (notsogood))
1190 notsogood = buf;
1191 }
1192 if (!NILP (notsogood))
1193 return notsogood;
1194 buf = Fget_buffer (build_string ("*scratch*"));
1195 if (NILP (buf))
1196 {
1197 buf = Fget_buffer_create (build_string ("*scratch*"));
1198 Fset_buffer_major_mode (buf);
1199 }
1200 return buf;
1201 }
1202 \f
1203 DEFUN ("buffer-disable-undo", Fbuffer_disable_undo, Sbuffer_disable_undo,
1204 0, 1, "",
1205 doc: /* Make BUFFER stop keeping undo information.
1206 No argument or nil as argument means do this for the current buffer. */)
1207 (buffer)
1208 register Lisp_Object buffer;
1209 {
1210 Lisp_Object real_buffer;
1211
1212 if (NILP (buffer))
1213 XSETBUFFER (real_buffer, current_buffer);
1214 else
1215 {
1216 real_buffer = Fget_buffer (buffer);
1217 if (NILP (real_buffer))
1218 nsberror (buffer);
1219 }
1220
1221 XBUFFER (real_buffer)->undo_list = Qt;
1222
1223 return Qnil;
1224 }
1225
1226 DEFUN ("buffer-enable-undo", Fbuffer_enable_undo, Sbuffer_enable_undo,
1227 0, 1, "",
1228 doc: /* Start keeping undo information for buffer BUFFER.
1229 No argument or nil as argument means do this for the current buffer. */)
1230 (buffer)
1231 register Lisp_Object buffer;
1232 {
1233 Lisp_Object real_buffer;
1234
1235 if (NILP (buffer))
1236 XSETBUFFER (real_buffer, current_buffer);
1237 else
1238 {
1239 real_buffer = Fget_buffer (buffer);
1240 if (NILP (real_buffer))
1241 nsberror (buffer);
1242 }
1243
1244 if (EQ (XBUFFER (real_buffer)->undo_list, Qt))
1245 XBUFFER (real_buffer)->undo_list = Qnil;
1246
1247 return Qnil;
1248 }
1249
1250 /*
1251 DEFVAR_LISP ("kill-buffer-hook", no_cell, "\
1252 Hook to be run (by `run-hooks', which see) when a buffer is killed.\n\
1253 The buffer being killed will be current while the hook is running.\n\
1254 See `kill-buffer'."
1255 */
1256 DEFUN ("kill-buffer", Fkill_buffer, Skill_buffer, 1, 1, "bKill buffer: ",
1257 doc: /* Kill the buffer BUFFER.
1258 The argument may be a buffer or may be the name of a buffer.
1259 An argument of nil means kill the current buffer.
1260
1261 Value is t if the buffer is actually killed, nil if user says no.
1262
1263 The value of `kill-buffer-hook' (which may be local to that buffer),
1264 if not void, is a list of functions to be called, with no arguments,
1265 before the buffer is actually killed. The buffer to be killed is current
1266 when the hook functions are called.
1267
1268 Any processes that have this buffer as the `process-buffer' are killed
1269 with SIGHUP. */)
1270 (buffer)
1271 Lisp_Object buffer;
1272 {
1273 Lisp_Object buf;
1274 register struct buffer *b;
1275 register Lisp_Object tem;
1276 register struct Lisp_Marker *m;
1277 struct gcpro gcpro1;
1278
1279 if (NILP (buffer))
1280 buf = Fcurrent_buffer ();
1281 else
1282 buf = Fget_buffer (buffer);
1283 if (NILP (buf))
1284 nsberror (buffer);
1285
1286 b = XBUFFER (buf);
1287
1288 /* Avoid trouble for buffer already dead. */
1289 if (NILP (b->name))
1290 return Qnil;
1291
1292 /* Query if the buffer is still modified. */
1293 if (INTERACTIVE && !NILP (b->filename)
1294 && BUF_MODIFF (b) > BUF_SAVE_MODIFF (b))
1295 {
1296 GCPRO1 (buf);
1297 tem = do_yes_or_no_p (format2 ("Buffer %s modified; kill anyway? ",
1298 b->name, make_number (0)));
1299 UNGCPRO;
1300 if (NILP (tem))
1301 return Qnil;
1302 }
1303
1304 /* Run hooks with the buffer to be killed the current buffer. */
1305 {
1306 int count = SPECPDL_INDEX ();
1307 Lisp_Object arglist[1];
1308
1309 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1310 set_buffer_internal (b);
1311
1312 /* First run the query functions; if any query is answered no,
1313 don't kill the buffer. */
1314 arglist[0] = Qkill_buffer_query_functions;
1315 if (NILP (Frun_hook_with_args_until_failure (1, arglist)))
1316 return unbind_to (count, Qnil);
1317
1318 /* Then run the hooks. */
1319 Frun_hooks (1, &Qkill_buffer_hook);
1320 unbind_to (count, Qnil);
1321 }
1322
1323 /* We have no more questions to ask. Verify that it is valid
1324 to kill the buffer. This must be done after the questions
1325 since anything can happen within do_yes_or_no_p. */
1326
1327 /* Don't kill the minibuffer now current. */
1328 if (EQ (buf, XWINDOW (minibuf_window)->buffer))
1329 return Qnil;
1330
1331 if (NILP (b->name))
1332 return Qnil;
1333
1334 /* When we kill a base buffer, kill all its indirect buffers.
1335 We do it at this stage so nothing terrible happens if they
1336 ask questions or their hooks get errors. */
1337 if (! b->base_buffer)
1338 {
1339 struct buffer *other;
1340
1341 GCPRO1 (buf);
1342
1343 for (other = all_buffers; other; other = other->next)
1344 /* all_buffers contains dead buffers too;
1345 don't re-kill them. */
1346 if (other->base_buffer == b && !NILP (other->name))
1347 {
1348 Lisp_Object buf;
1349 XSETBUFFER (buf, other);
1350 Fkill_buffer (buf);
1351 }
1352
1353 UNGCPRO;
1354 }
1355
1356 /* Make this buffer not be current.
1357 In the process, notice if this is the sole visible buffer
1358 and give up if so. */
1359 if (b == current_buffer)
1360 {
1361 tem = Fother_buffer (buf, Qnil, Qnil);
1362 Fset_buffer (tem);
1363 if (b == current_buffer)
1364 return Qnil;
1365 }
1366
1367 /* Notice if the buffer to kill is the sole visible buffer
1368 when we're currently in the mini-buffer, and give up if so. */
1369 XSETBUFFER (tem, current_buffer);
1370 if (EQ (tem, XWINDOW (minibuf_window)->buffer))
1371 {
1372 tem = Fother_buffer (buf, Qnil, Qnil);
1373 if (EQ (buf, tem))
1374 return Qnil;
1375 }
1376
1377 /* Now there is no question: we can kill the buffer. */
1378
1379 #ifdef CLASH_DETECTION
1380 /* Unlock this buffer's file, if it is locked. */
1381 unlock_buffer (b);
1382 #endif /* CLASH_DETECTION */
1383
1384 kill_buffer_processes (buf);
1385
1386 tem = Vinhibit_quit;
1387 Vinhibit_quit = Qt;
1388 replace_buffer_in_all_windows (buf);
1389 Vbuffer_alist = Fdelq (Frassq (buf, Vbuffer_alist), Vbuffer_alist);
1390 frames_discard_buffer (buf);
1391 Vinhibit_quit = tem;
1392
1393 /* Delete any auto-save file, if we saved it in this session.
1394 But not if the buffer is modified. */
1395 if (STRINGP (b->auto_save_file_name)
1396 && b->auto_save_modified != 0
1397 && BUF_SAVE_MODIFF (b) < b->auto_save_modified
1398 && BUF_SAVE_MODIFF (b) < BUF_MODIFF (b))
1399 {
1400 Lisp_Object tem;
1401 tem = Fsymbol_value (intern ("delete-auto-save-files"));
1402 if (! NILP (tem))
1403 internal_delete_file (b->auto_save_file_name);
1404 }
1405
1406 if (b->base_buffer)
1407 {
1408 /* Unchain all markers that belong to this indirect buffer.
1409 Don't unchain the markers that belong to the base buffer
1410 or its other indirect buffers. */
1411 for (m = BUF_MARKERS (b); m; )
1412 {
1413 struct Lisp_Marker *next = m->next;
1414 if (m->buffer == b)
1415 unchain_marker (m);
1416 m = next;
1417 }
1418 }
1419 else
1420 {
1421 /* Unchain all markers of this buffer and its indirect buffers.
1422 and leave them pointing nowhere. */
1423 for (m = BUF_MARKERS (b); m; )
1424 {
1425 struct Lisp_Marker *next = m->next;
1426 m->buffer = 0;
1427 m->next = NULL;
1428 m = next;
1429 }
1430 BUF_MARKERS (b) = NULL;
1431 BUF_INTERVALS (b) = NULL_INTERVAL;
1432
1433 /* Perhaps we should explicitly free the interval tree here... */
1434 }
1435
1436 /* Reset the local variables, so that this buffer's local values
1437 won't be protected from GC. They would be protected
1438 if they happened to remain encached in their symbols.
1439 This gets rid of them for certain. */
1440 swap_out_buffer_local_variables (b);
1441 reset_buffer_local_variables (b, 1);
1442
1443 b->name = Qnil;
1444
1445 BLOCK_INPUT;
1446 if (! b->base_buffer)
1447 free_buffer_text (b);
1448
1449 if (b->newline_cache)
1450 {
1451 free_region_cache (b->newline_cache);
1452 b->newline_cache = 0;
1453 }
1454 if (b->width_run_cache)
1455 {
1456 free_region_cache (b->width_run_cache);
1457 b->width_run_cache = 0;
1458 }
1459 b->width_table = Qnil;
1460 UNBLOCK_INPUT;
1461 b->undo_list = Qnil;
1462
1463 return Qt;
1464 }
1465 \f
1466 /* Move the assoc for buffer BUF to the front of buffer-alist. Since
1467 we do this each time BUF is selected visibly, the more recently
1468 selected buffers are always closer to the front of the list. This
1469 means that other_buffer is more likely to choose a relevant buffer. */
1470
1471 void
1472 record_buffer (buf)
1473 Lisp_Object buf;
1474 {
1475 register Lisp_Object link, prev;
1476 Lisp_Object frame;
1477 frame = selected_frame;
1478
1479 prev = Qnil;
1480 for (link = Vbuffer_alist; CONSP (link); link = XCDR (link))
1481 {
1482 if (EQ (XCDR (XCAR (link)), buf))
1483 break;
1484 prev = link;
1485 }
1486
1487 /* Effectively do Vbuffer_alist = Fdelq (link, Vbuffer_alist);
1488 we cannot use Fdelq itself here because it allows quitting. */
1489
1490 if (NILP (prev))
1491 Vbuffer_alist = XCDR (Vbuffer_alist);
1492 else
1493 XSETCDR (prev, XCDR (XCDR (prev)));
1494
1495 XSETCDR (link, Vbuffer_alist);
1496 Vbuffer_alist = link;
1497
1498 /* Now move this buffer to the front of frame_buffer_list also. */
1499
1500 prev = Qnil;
1501 for (link = frame_buffer_list (frame); CONSP (link);
1502 link = XCDR (link))
1503 {
1504 if (EQ (XCAR (link), buf))
1505 break;
1506 prev = link;
1507 }
1508
1509 /* Effectively do delq. */
1510
1511 if (CONSP (link))
1512 {
1513 if (NILP (prev))
1514 set_frame_buffer_list (frame,
1515 XCDR (frame_buffer_list (frame)));
1516 else
1517 XSETCDR (prev, XCDR (XCDR (prev)));
1518
1519 XSETCDR (link, frame_buffer_list (frame));
1520 set_frame_buffer_list (frame, link);
1521 }
1522 else
1523 set_frame_buffer_list (frame, Fcons (buf, frame_buffer_list (frame)));
1524 }
1525
1526 DEFUN ("set-buffer-major-mode", Fset_buffer_major_mode, Sset_buffer_major_mode, 1, 1, 0,
1527 doc: /* Set an appropriate major mode for BUFFER.
1528 For the *scratch* buffer, use `initial-major-mode', otherwise choose a mode
1529 according to `default-major-mode'.
1530 Use this function before selecting the buffer, since it may need to inspect
1531 the current buffer's major mode. */)
1532 (buffer)
1533 Lisp_Object buffer;
1534 {
1535 int count;
1536 Lisp_Object function;
1537
1538 if (STRINGP (XBUFFER (buffer)->name)
1539 && strcmp (SDATA (XBUFFER (buffer)->name), "*scratch*") == 0)
1540 function = find_symbol_value (intern ("initial-major-mode"));
1541 else
1542 {
1543 function = buffer_defaults.major_mode;
1544 if (NILP (function)
1545 && NILP (Fget (current_buffer->major_mode, Qmode_class)))
1546 function = current_buffer->major_mode;
1547 }
1548
1549 if (NILP (function) || EQ (function, Qfundamental_mode))
1550 return Qnil;
1551
1552 count = SPECPDL_INDEX ();
1553
1554 /* To select a nonfundamental mode,
1555 select the buffer temporarily and then call the mode function. */
1556
1557 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1558
1559 Fset_buffer (buffer);
1560 call0 (function);
1561
1562 return unbind_to (count, Qnil);
1563 }
1564
1565 /* If switching buffers in WINDOW would be an error, return
1566 a C string saying what the error would be. */
1567
1568 char *
1569 no_switch_window (window)
1570 Lisp_Object window;
1571 {
1572 Lisp_Object tem;
1573 if (EQ (minibuf_window, window))
1574 return "Cannot switch buffers in minibuffer window";
1575 tem = Fwindow_dedicated_p (window);
1576 if (EQ (tem, Qt))
1577 return "Cannot switch buffers in a dedicated window";
1578 return NULL;
1579 }
1580
1581 /* Switch to buffer BUFFER in the selected window.
1582 If NORECORD is non-nil, don't call record_buffer. */
1583
1584 Lisp_Object
1585 switch_to_buffer_1 (buffer, norecord)
1586 Lisp_Object buffer, norecord;
1587 {
1588 register Lisp_Object buf;
1589
1590 if (NILP (buffer))
1591 buf = Fother_buffer (Fcurrent_buffer (), Qnil, Qnil);
1592 else
1593 {
1594 buf = Fget_buffer (buffer);
1595 if (NILP (buf))
1596 {
1597 buf = Fget_buffer_create (buffer);
1598 Fset_buffer_major_mode (buf);
1599 }
1600 }
1601 Fset_buffer (buf);
1602 if (NILP (norecord))
1603 record_buffer (buf);
1604
1605 Fset_window_buffer (EQ (selected_window, minibuf_window)
1606 ? Fnext_window (minibuf_window, Qnil, Qnil)
1607 : selected_window,
1608 buf, Qnil);
1609
1610 return buf;
1611 }
1612
1613 DEFUN ("switch-to-buffer", Fswitch_to_buffer, Sswitch_to_buffer, 1, 2, "BSwitch to buffer: ",
1614 doc: /* Select buffer BUFFER in the current window.
1615 BUFFER may be a buffer or a buffer name.
1616 Optional second arg NORECORD non-nil means
1617 do not put this buffer at the front of the list of recently selected ones.
1618
1619 WARNING: This is NOT the way to work on another buffer temporarily
1620 within a Lisp program! Use `set-buffer' instead. That avoids messing with
1621 the window-buffer correspondences. */)
1622 (buffer, norecord)
1623 Lisp_Object buffer, norecord;
1624 {
1625 char *err;
1626
1627 err = no_switch_window (selected_window);
1628 if (err) error (err);
1629
1630 return switch_to_buffer_1 (buffer, norecord);
1631 }
1632
1633 DEFUN ("pop-to-buffer", Fpop_to_buffer, Spop_to_buffer, 1, 3, 0,
1634 doc: /* Select buffer BUFFER in some window, preferably a different one.
1635 If BUFFER is nil, then some other buffer is chosen.
1636 If `pop-up-windows' is non-nil, windows can be split to do this.
1637 If optional second arg OTHER-WINDOW is non-nil, insist on finding another
1638 window even if BUFFER is already visible in the selected window.
1639 This uses the function `display-buffer' as a subroutine; see the documentation
1640 of `display-buffer' for additional customization information.
1641
1642 Optional third arg NORECORD non-nil means
1643 do not put this buffer at the front of the list of recently selected ones. */)
1644 (buffer, other_window, norecord)
1645 Lisp_Object buffer, other_window, norecord;
1646 {
1647 register Lisp_Object buf;
1648 if (NILP (buffer))
1649 buf = Fother_buffer (Fcurrent_buffer (), Qnil, Qnil);
1650 else
1651 {
1652 buf = Fget_buffer (buffer);
1653 if (NILP (buf))
1654 {
1655 buf = Fget_buffer_create (buffer);
1656 Fset_buffer_major_mode (buf);
1657 }
1658 }
1659 Fset_buffer (buf);
1660 if (NILP (norecord))
1661 /* Why bother ? Fselect_window will do it for us anyway. -stef */
1662 record_buffer (buf);
1663 Fselect_window (Fdisplay_buffer (buf, other_window, Qnil), norecord);
1664 return buf;
1665 }
1666
1667 DEFUN ("current-buffer", Fcurrent_buffer, Scurrent_buffer, 0, 0, 0,
1668 doc: /* Return the current buffer as a Lisp object. */)
1669 ()
1670 {
1671 register Lisp_Object buf;
1672 XSETBUFFER (buf, current_buffer);
1673 return buf;
1674 }
1675 \f
1676 /* Set the current buffer to B.
1677
1678 We previously set windows_or_buffers_changed here to invalidate
1679 global unchanged information in beg_unchanged and end_unchanged.
1680 This is no longer necessary because we now compute unchanged
1681 information on a buffer-basis. Every action affecting other
1682 windows than the selected one requires a select_window at some
1683 time, and that increments windows_or_buffers_changed. */
1684
1685 void
1686 set_buffer_internal (b)
1687 register struct buffer *b;
1688 {
1689 if (current_buffer != b)
1690 set_buffer_internal_1 (b);
1691 }
1692
1693 /* Set the current buffer to B, and do not set windows_or_buffers_changed.
1694 This is used by redisplay. */
1695
1696 void
1697 set_buffer_internal_1 (b)
1698 register struct buffer *b;
1699 {
1700 register struct buffer *old_buf;
1701 register Lisp_Object tail, valcontents;
1702 Lisp_Object tem;
1703
1704 #ifdef USE_MMAP_FOR_BUFFERS
1705 if (b->text->beg == NULL)
1706 enlarge_buffer_text (b, 0);
1707 #endif /* USE_MMAP_FOR_BUFFERS */
1708
1709 if (current_buffer == b)
1710 return;
1711
1712 old_buf = current_buffer;
1713 current_buffer = b;
1714 last_known_column_point = -1; /* invalidate indentation cache */
1715
1716 if (old_buf)
1717 {
1718 /* Put the undo list back in the base buffer, so that it appears
1719 that an indirect buffer shares the undo list of its base. */
1720 if (old_buf->base_buffer)
1721 old_buf->base_buffer->undo_list = old_buf->undo_list;
1722
1723 /* If the old current buffer has markers to record PT, BEGV and ZV
1724 when it is not current, update them now. */
1725 if (! NILP (old_buf->pt_marker))
1726 {
1727 Lisp_Object obuf;
1728 XSETBUFFER (obuf, old_buf);
1729 set_marker_both (old_buf->pt_marker, obuf,
1730 BUF_PT (old_buf), BUF_PT_BYTE (old_buf));
1731 }
1732 if (! NILP (old_buf->begv_marker))
1733 {
1734 Lisp_Object obuf;
1735 XSETBUFFER (obuf, old_buf);
1736 set_marker_both (old_buf->begv_marker, obuf,
1737 BUF_BEGV (old_buf), BUF_BEGV_BYTE (old_buf));
1738 }
1739 if (! NILP (old_buf->zv_marker))
1740 {
1741 Lisp_Object obuf;
1742 XSETBUFFER (obuf, old_buf);
1743 set_marker_both (old_buf->zv_marker, obuf,
1744 BUF_ZV (old_buf), BUF_ZV_BYTE (old_buf));
1745 }
1746 }
1747
1748 /* Get the undo list from the base buffer, so that it appears
1749 that an indirect buffer shares the undo list of its base. */
1750 if (b->base_buffer)
1751 b->undo_list = b->base_buffer->undo_list;
1752
1753 /* If the new current buffer has markers to record PT, BEGV and ZV
1754 when it is not current, fetch them now. */
1755 if (! NILP (b->pt_marker))
1756 {
1757 BUF_PT (b) = marker_position (b->pt_marker);
1758 BUF_PT_BYTE (b) = marker_byte_position (b->pt_marker);
1759 }
1760 if (! NILP (b->begv_marker))
1761 {
1762 BUF_BEGV (b) = marker_position (b->begv_marker);
1763 BUF_BEGV_BYTE (b) = marker_byte_position (b->begv_marker);
1764 }
1765 if (! NILP (b->zv_marker))
1766 {
1767 BUF_ZV (b) = marker_position (b->zv_marker);
1768 BUF_ZV_BYTE (b) = marker_byte_position (b->zv_marker);
1769 }
1770
1771 /* Look down buffer's list of local Lisp variables
1772 to find and update any that forward into C variables. */
1773
1774 for (tail = b->local_var_alist; CONSP (tail); tail = XCDR (tail))
1775 {
1776 valcontents = SYMBOL_VALUE (XCAR (XCAR (tail)));
1777 if ((BUFFER_LOCAL_VALUEP (valcontents)
1778 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1779 && (tem = XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1780 (BOOLFWDP (tem) || INTFWDP (tem) || OBJFWDP (tem))))
1781 /* Just reference the variable
1782 to cause it to become set for this buffer. */
1783 Fsymbol_value (XCAR (XCAR (tail)));
1784 }
1785
1786 /* Do the same with any others that were local to the previous buffer */
1787
1788 if (old_buf)
1789 for (tail = old_buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1790 {
1791 valcontents = SYMBOL_VALUE (XCAR (XCAR (tail)));
1792 if ((BUFFER_LOCAL_VALUEP (valcontents)
1793 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1794 && (tem = XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1795 (BOOLFWDP (tem) || INTFWDP (tem) || OBJFWDP (tem))))
1796 /* Just reference the variable
1797 to cause it to become set for this buffer. */
1798 Fsymbol_value (XCAR (XCAR (tail)));
1799 }
1800 }
1801
1802 /* Switch to buffer B temporarily for redisplay purposes.
1803 This avoids certain things that don't need to be done within redisplay. */
1804
1805 void
1806 set_buffer_temp (b)
1807 struct buffer *b;
1808 {
1809 register struct buffer *old_buf;
1810
1811 if (current_buffer == b)
1812 return;
1813
1814 old_buf = current_buffer;
1815 current_buffer = b;
1816
1817 if (old_buf)
1818 {
1819 /* If the old current buffer has markers to record PT, BEGV and ZV
1820 when it is not current, update them now. */
1821 if (! NILP (old_buf->pt_marker))
1822 {
1823 Lisp_Object obuf;
1824 XSETBUFFER (obuf, old_buf);
1825 set_marker_both (old_buf->pt_marker, obuf,
1826 BUF_PT (old_buf), BUF_PT_BYTE (old_buf));
1827 }
1828 if (! NILP (old_buf->begv_marker))
1829 {
1830 Lisp_Object obuf;
1831 XSETBUFFER (obuf, old_buf);
1832 set_marker_both (old_buf->begv_marker, obuf,
1833 BUF_BEGV (old_buf), BUF_BEGV_BYTE (old_buf));
1834 }
1835 if (! NILP (old_buf->zv_marker))
1836 {
1837 Lisp_Object obuf;
1838 XSETBUFFER (obuf, old_buf);
1839 set_marker_both (old_buf->zv_marker, obuf,
1840 BUF_ZV (old_buf), BUF_ZV_BYTE (old_buf));
1841 }
1842 }
1843
1844 /* If the new current buffer has markers to record PT, BEGV and ZV
1845 when it is not current, fetch them now. */
1846 if (! NILP (b->pt_marker))
1847 {
1848 BUF_PT (b) = marker_position (b->pt_marker);
1849 BUF_PT_BYTE (b) = marker_byte_position (b->pt_marker);
1850 }
1851 if (! NILP (b->begv_marker))
1852 {
1853 BUF_BEGV (b) = marker_position (b->begv_marker);
1854 BUF_BEGV_BYTE (b) = marker_byte_position (b->begv_marker);
1855 }
1856 if (! NILP (b->zv_marker))
1857 {
1858 BUF_ZV (b) = marker_position (b->zv_marker);
1859 BUF_ZV_BYTE (b) = marker_byte_position (b->zv_marker);
1860 }
1861 }
1862
1863 DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
1864 doc: /* Make the buffer BUFFER current for editing operations.
1865 BUFFER may be a buffer or the name of an existing buffer.
1866 See also `save-excursion' when you want to make a buffer current temporarily.
1867 This function does not display the buffer, so its effect ends
1868 when the current command terminates.
1869 Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently. */)
1870 (buffer)
1871 register Lisp_Object buffer;
1872 {
1873 register Lisp_Object buf;
1874 buf = Fget_buffer (buffer);
1875 if (NILP (buf))
1876 nsberror (buffer);
1877 if (NILP (XBUFFER (buf)->name))
1878 error ("Selecting deleted buffer");
1879 set_buffer_internal (XBUFFER (buf));
1880 return buf;
1881 }
1882
1883 /* Set the current buffer to BUFFER provided it is alive. */
1884
1885 Lisp_Object
1886 set_buffer_if_live (buffer)
1887 Lisp_Object buffer;
1888 {
1889 if (! NILP (XBUFFER (buffer)->name))
1890 Fset_buffer (buffer);
1891 return Qnil;
1892 }
1893 \f
1894 DEFUN ("barf-if-buffer-read-only", Fbarf_if_buffer_read_only,
1895 Sbarf_if_buffer_read_only, 0, 0, 0,
1896 doc: /* Signal a `buffer-read-only' error if the current buffer is read-only. */)
1897 ()
1898 {
1899 if (!NILP (current_buffer->read_only)
1900 && NILP (Vinhibit_read_only))
1901 Fsignal (Qbuffer_read_only, (Fcons (Fcurrent_buffer (), Qnil)));
1902 return Qnil;
1903 }
1904
1905 DEFUN ("bury-buffer", Fbury_buffer, Sbury_buffer, 0, 1, "",
1906 doc: /* Put BUFFER at the end of the list of all buffers.
1907 There it is the least likely candidate for `other-buffer' to return;
1908 thus, the least likely buffer for \\[switch-to-buffer] to select by default.
1909 If BUFFER is nil or omitted, bury the current buffer.
1910 Also, if BUFFER is nil or omitted, remove the current buffer from the
1911 selected window if it is displayed there. */)
1912 (buffer)
1913 register Lisp_Object buffer;
1914 {
1915 /* Figure out what buffer we're going to bury. */
1916 if (NILP (buffer))
1917 {
1918 Lisp_Object tem;
1919 XSETBUFFER (buffer, current_buffer);
1920
1921 tem = Fwindow_buffer (selected_window);
1922 /* If we're burying the current buffer, unshow it. */
1923 if (EQ (buffer, tem))
1924 {
1925 if (NILP (Fwindow_dedicated_p (selected_window)))
1926 Fswitch_to_buffer (Fother_buffer (buffer, Qnil, Qnil), Qnil);
1927 else if (NILP (XWINDOW (selected_window)->parent))
1928 Ficonify_frame (Fwindow_frame (selected_window));
1929 else
1930 Fdelete_window (selected_window);
1931 }
1932 }
1933 else
1934 {
1935 Lisp_Object buf1;
1936
1937 buf1 = Fget_buffer (buffer);
1938 if (NILP (buf1))
1939 nsberror (buffer);
1940 buffer = buf1;
1941 }
1942
1943 /* Move buffer to the end of the buffer list. Do nothing if the
1944 buffer is killed. */
1945 if (!NILP (XBUFFER (buffer)->name))
1946 {
1947 Lisp_Object aelt, link;
1948
1949 aelt = Frassq (buffer, Vbuffer_alist);
1950 link = Fmemq (aelt, Vbuffer_alist);
1951 Vbuffer_alist = Fdelq (aelt, Vbuffer_alist);
1952 XSETCDR (link, Qnil);
1953 Vbuffer_alist = nconc2 (Vbuffer_alist, link);
1954
1955 /* Removing BUFFER from frame-specific lists
1956 has the effect of putting BUFFER at the end
1957 of the combined list in each frame. */
1958 frames_discard_buffer (buffer);
1959 }
1960
1961 return Qnil;
1962 }
1963 \f
1964 DEFUN ("erase-buffer", Ferase_buffer, Serase_buffer, 0, 0, "*",
1965 doc: /* Delete the entire contents of the current buffer.
1966 Any narrowing restriction in effect (see `narrow-to-region') is removed,
1967 so the buffer is truly empty after this. */)
1968 ()
1969 {
1970 Fwiden ();
1971
1972 del_range (BEG, Z);
1973
1974 current_buffer->last_window_start = 1;
1975 /* Prevent warnings, or suspension of auto saving, that would happen
1976 if future size is less than past size. Use of erase-buffer
1977 implies that the future text is not really related to the past text. */
1978 XSETFASTINT (current_buffer->save_length, 0);
1979 return Qnil;
1980 }
1981
1982 void
1983 validate_region (b, e)
1984 register Lisp_Object *b, *e;
1985 {
1986 CHECK_NUMBER_COERCE_MARKER (*b);
1987 CHECK_NUMBER_COERCE_MARKER (*e);
1988
1989 if (XINT (*b) > XINT (*e))
1990 {
1991 Lisp_Object tem;
1992 tem = *b; *b = *e; *e = tem;
1993 }
1994
1995 if (!(BEGV <= XINT (*b) && XINT (*b) <= XINT (*e)
1996 && XINT (*e) <= ZV))
1997 args_out_of_range (*b, *e);
1998 }
1999 \f
2000 /* Advance BYTE_POS up to a character boundary
2001 and return the adjusted position. */
2002
2003 static int
2004 advance_to_char_boundary (byte_pos)
2005 int byte_pos;
2006 {
2007 int c;
2008
2009 if (byte_pos == BEG)
2010 /* Beginning of buffer is always a character boundary. */
2011 return BEG;
2012
2013 c = FETCH_BYTE (byte_pos);
2014 if (! CHAR_HEAD_P (c))
2015 {
2016 /* We should advance BYTE_POS only when C is a constituent of a
2017 multibyte sequence. */
2018 int orig_byte_pos = byte_pos;
2019
2020 do
2021 {
2022 byte_pos--;
2023 c = FETCH_BYTE (byte_pos);
2024 }
2025 while (! CHAR_HEAD_P (c) && byte_pos > BEG);
2026 INC_POS (byte_pos);
2027 if (byte_pos < orig_byte_pos)
2028 byte_pos = orig_byte_pos;
2029 /* If C is a constituent of a multibyte sequence, BYTE_POS was
2030 surely advance to the correct character boundary. If C is
2031 not, BYTE_POS was unchanged. */
2032 }
2033
2034 return byte_pos;
2035 }
2036
2037 DEFUN ("set-buffer-multibyte", Fset_buffer_multibyte, Sset_buffer_multibyte,
2038 1, 1, 0,
2039 doc: /* Set the multibyte flag of the current buffer to FLAG.
2040 If FLAG is t, this makes the buffer a multibyte buffer.
2041 If FLAG is nil, this makes the buffer a single-byte buffer.
2042 The buffer contents remain unchanged as a sequence of bytes
2043 but the contents viewed as characters do change. */)
2044 (flag)
2045 Lisp_Object flag;
2046 {
2047 struct Lisp_Marker *tail, *markers;
2048 struct buffer *other;
2049 int undo_enabled_p = !EQ (current_buffer->undo_list, Qt);
2050 int begv, zv;
2051 int narrowed = (BEG != BEGV || Z != ZV);
2052 int modified_p = !NILP (Fbuffer_modified_p (Qnil));
2053
2054 if (current_buffer->base_buffer)
2055 error ("Cannot do `set-buffer-multibyte' on an indirect buffer");
2056
2057 /* Do nothing if nothing actually changes. */
2058 if (NILP (flag) == NILP (current_buffer->enable_multibyte_characters))
2059 return flag;
2060
2061 /* It would be better to update the list,
2062 but this is good enough for now. */
2063 if (undo_enabled_p)
2064 current_buffer->undo_list = Qt;
2065
2066 /* If the cached position is for this buffer, clear it out. */
2067 clear_charpos_cache (current_buffer);
2068
2069 if (NILP (flag))
2070 begv = BEGV_BYTE, zv = ZV_BYTE;
2071 else
2072 begv = BEGV, zv = ZV;
2073
2074 if (narrowed)
2075 Fwiden ();
2076
2077 if (NILP (flag))
2078 {
2079 int pos, stop;
2080 unsigned char *p;
2081
2082 /* Do this first, so it can use CHAR_TO_BYTE
2083 to calculate the old correspondences. */
2084 set_intervals_multibyte (0);
2085
2086 current_buffer->enable_multibyte_characters = Qnil;
2087
2088 Z = Z_BYTE;
2089 BEGV = BEGV_BYTE;
2090 ZV = ZV_BYTE;
2091 GPT = GPT_BYTE;
2092 TEMP_SET_PT_BOTH (PT_BYTE, PT_BYTE);
2093
2094
2095 for (tail = BUF_MARKERS (current_buffer); tail; tail = tail->next)
2096 tail->charpos = tail->bytepos;
2097
2098 /* Convert multibyte form of 8-bit characters to unibyte. */
2099 pos = BEG;
2100 stop = GPT;
2101 p = BEG_ADDR;
2102 while (1)
2103 {
2104 int c, bytes;
2105
2106 if (pos == stop)
2107 {
2108 if (pos == Z)
2109 break;
2110 p = GAP_END_ADDR;
2111 stop = Z;
2112 }
2113 if (MULTIBYTE_STR_AS_UNIBYTE_P (p, bytes))
2114 p += bytes, pos += bytes;
2115 else
2116 {
2117 c = STRING_CHAR (p, stop - pos);
2118 /* Delete all bytes for this 8-bit character but the
2119 last one, and change the last one to the charcter
2120 code. */
2121 bytes--;
2122 del_range_2 (pos, pos, pos + bytes, pos + bytes, 0);
2123 p = GAP_END_ADDR;
2124 *p++ = c;
2125 pos++;
2126 if (begv > pos)
2127 begv -= bytes;
2128 if (zv > pos)
2129 zv -= bytes;
2130 stop = Z;
2131 }
2132 }
2133 if (narrowed)
2134 Fnarrow_to_region (make_number (begv), make_number (zv));
2135 }
2136 else
2137 {
2138 int pt = PT;
2139 int pos, stop;
2140 unsigned char *p;
2141
2142 /* Be sure not to have a multibyte sequence striding over the GAP.
2143 Ex: We change this: "...abc\201 _GAP_ \241def..."
2144 to: "...abc _GAP_ \201\241def..." */
2145
2146 if (GPT_BYTE > 1 && GPT_BYTE < Z_BYTE
2147 && ! CHAR_HEAD_P (*(GAP_END_ADDR)))
2148 {
2149 unsigned char *p = GPT_ADDR - 1;
2150
2151 while (! CHAR_HEAD_P (*p) && p > BEG_ADDR) p--;
2152 if (BASE_LEADING_CODE_P (*p))
2153 {
2154 int new_gpt = GPT_BYTE - (GPT_ADDR - p);
2155
2156 move_gap_both (new_gpt, new_gpt);
2157 }
2158 }
2159
2160 /* Make the buffer contents valid as multibyte by converting
2161 8-bit characters to multibyte form. */
2162 pos = BEG;
2163 stop = GPT;
2164 p = BEG_ADDR;
2165 while (1)
2166 {
2167 int bytes;
2168
2169 if (pos == stop)
2170 {
2171 if (pos == Z)
2172 break;
2173 p = GAP_END_ADDR;
2174 stop = Z;
2175 }
2176
2177 if (UNIBYTE_STR_AS_MULTIBYTE_P (p, stop - pos, bytes))
2178 p += bytes, pos += bytes;
2179 else
2180 {
2181 unsigned char tmp[MAX_MULTIBYTE_LENGTH];
2182
2183 bytes = CHAR_STRING (*p, tmp);
2184 *p = tmp[0];
2185 TEMP_SET_PT_BOTH (pos + 1, pos + 1);
2186 bytes--;
2187 insert_1_both (tmp + 1, bytes, bytes, 1, 0, 0);
2188 /* Now the gap is after the just inserted data. */
2189 pos = GPT;
2190 p = GAP_END_ADDR;
2191 if (pos <= begv)
2192 begv += bytes;
2193 if (pos <= zv)
2194 zv += bytes;
2195 if (pos <= pt)
2196 pt += bytes;
2197 stop = Z;
2198 }
2199 }
2200
2201 if (pt != PT)
2202 TEMP_SET_PT (pt);
2203
2204 if (narrowed)
2205 Fnarrow_to_region (make_number (begv), make_number (zv));
2206
2207 /* Do this first, so that chars_in_text asks the right question.
2208 set_intervals_multibyte needs it too. */
2209 current_buffer->enable_multibyte_characters = Qt;
2210
2211 GPT_BYTE = advance_to_char_boundary (GPT_BYTE);
2212 GPT = chars_in_text (BEG_ADDR, GPT_BYTE - BEG_BYTE) + BEG;
2213
2214 Z = chars_in_text (GAP_END_ADDR, Z_BYTE - GPT_BYTE) + GPT;
2215
2216 BEGV_BYTE = advance_to_char_boundary (BEGV_BYTE);
2217 if (BEGV_BYTE > GPT_BYTE)
2218 BEGV = chars_in_text (GAP_END_ADDR, BEGV_BYTE - GPT_BYTE) + GPT;
2219 else
2220 BEGV = chars_in_text (BEG_ADDR, BEGV_BYTE - BEG_BYTE) + BEG;
2221
2222 ZV_BYTE = advance_to_char_boundary (ZV_BYTE);
2223 if (ZV_BYTE > GPT_BYTE)
2224 ZV = chars_in_text (GAP_END_ADDR, ZV_BYTE - GPT_BYTE) + GPT;
2225 else
2226 ZV = chars_in_text (BEG_ADDR, ZV_BYTE - BEG_BYTE) + BEG;
2227
2228 {
2229 int pt_byte = advance_to_char_boundary (PT_BYTE);
2230 int pt;
2231
2232 if (pt_byte > GPT_BYTE)
2233 pt = chars_in_text (GAP_END_ADDR, pt_byte - GPT_BYTE) + GPT;
2234 else
2235 pt = chars_in_text (BEG_ADDR, pt_byte - BEG_BYTE) + BEG;
2236 TEMP_SET_PT_BOTH (pt, pt_byte);
2237 }
2238
2239 tail = markers = BUF_MARKERS (current_buffer);
2240
2241 /* This prevents BYTE_TO_CHAR (that is, buf_bytepos_to_charpos) from
2242 getting confused by the markers that have not yet been updated.
2243 It is also a signal that it should never create a marker. */
2244 BUF_MARKERS (current_buffer) = NULL;
2245
2246 for (; tail; tail = tail->next)
2247 {
2248 tail->bytepos = advance_to_char_boundary (tail->bytepos);
2249 tail->charpos = BYTE_TO_CHAR (tail->bytepos);
2250 }
2251
2252 /* Make sure no markers were put on the chain
2253 while the chain value was incorrect. */
2254 if (BUF_MARKERS (current_buffer))
2255 abort ();
2256
2257 BUF_MARKERS (current_buffer) = markers;
2258
2259 /* Do this last, so it can calculate the new correspondences
2260 between chars and bytes. */
2261 set_intervals_multibyte (1);
2262 }
2263
2264 if (undo_enabled_p)
2265 current_buffer->undo_list = Qnil;
2266
2267 /* Changing the multibyteness of a buffer means that all windows
2268 showing that buffer must be updated thoroughly. */
2269 current_buffer->prevent_redisplay_optimizations_p = 1;
2270 ++windows_or_buffers_changed;
2271
2272 /* Copy this buffer's new multibyte status
2273 into all of its indirect buffers. */
2274 for (other = all_buffers; other; other = other->next)
2275 if (other->base_buffer == current_buffer && !NILP (other->name))
2276 {
2277 other->enable_multibyte_characters
2278 = current_buffer->enable_multibyte_characters;
2279 other->prevent_redisplay_optimizations_p = 1;
2280 }
2281
2282 /* Restore the modifiedness of the buffer. */
2283 if (!modified_p && !NILP (Fbuffer_modified_p (Qnil)))
2284 Fset_buffer_modified_p (Qnil);
2285
2286 #ifdef subprocesses
2287 /* Update coding systems of this buffer's process (if any). */
2288 {
2289 Lisp_Object process;
2290
2291 process = Fget_buffer_process (Fcurrent_buffer ());
2292 if (PROCESSP (process))
2293 setup_process_coding_systems (process);
2294 }
2295 #endif /* subprocesses */
2296
2297 return flag;
2298 }
2299 \f
2300 DEFUN ("kill-all-local-variables", Fkill_all_local_variables, Skill_all_local_variables,
2301 0, 0, 0,
2302 doc: /* Switch to Fundamental mode by killing current buffer's local variables.
2303 Most local variable bindings are eliminated so that the default values
2304 become effective once more. Also, the syntax table is set from
2305 `standard-syntax-table', the local keymap is set to nil,
2306 and the abbrev table from `fundamental-mode-abbrev-table'.
2307 This function also forces redisplay of the mode line.
2308
2309 Every function to select a new major mode starts by
2310 calling this function.
2311
2312 As a special exception, local variables whose names have
2313 a non-nil `permanent-local' property are not eliminated by this function.
2314
2315 The first thing this function does is run
2316 the normal hook `change-major-mode-hook'. */)
2317 ()
2318 {
2319 register Lisp_Object alist, sym, tem;
2320 Lisp_Object oalist;
2321
2322 if (!NILP (Vrun_hooks))
2323 call1 (Vrun_hooks, intern ("change-major-mode-hook"));
2324 oalist = current_buffer->local_var_alist;
2325
2326 /* Make sure none of the bindings in oalist
2327 remain swapped in, in their symbols. */
2328
2329 swap_out_buffer_local_variables (current_buffer);
2330
2331 /* Actually eliminate all local bindings of this buffer. */
2332
2333 reset_buffer_local_variables (current_buffer, 0);
2334
2335 /* Any which are supposed to be permanent,
2336 make local again, with the same values they had. */
2337
2338 for (alist = oalist; !NILP (alist); alist = XCDR (alist))
2339 {
2340 sym = XCAR (XCAR (alist));
2341 tem = Fget (sym, Qpermanent_local);
2342 if (! NILP (tem))
2343 {
2344 Fmake_local_variable (sym);
2345 Fset (sym, XCDR (XCAR (alist)));
2346 }
2347 }
2348
2349 /* Force mode-line redisplay. Useful here because all major mode
2350 commands call this function. */
2351 update_mode_lines++;
2352
2353 return Qnil;
2354 }
2355
2356 /* Make sure no local variables remain set up with buffer B
2357 for their current values. */
2358
2359 static void
2360 swap_out_buffer_local_variables (b)
2361 struct buffer *b;
2362 {
2363 Lisp_Object oalist, alist, sym, tem, buffer;
2364
2365 XSETBUFFER (buffer, b);
2366 oalist = b->local_var_alist;
2367
2368 for (alist = oalist; !NILP (alist); alist = XCDR (alist))
2369 {
2370 sym = XCAR (XCAR (alist));
2371
2372 /* Need not do anything if some other buffer's binding is now encached. */
2373 tem = XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->buffer;
2374 if (BUFFERP (tem) && XBUFFER (tem) == current_buffer)
2375 {
2376 /* Symbol is set up for this buffer's old local value.
2377 Set it up for the current buffer with the default value. */
2378
2379 tem = XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->cdr;
2380 /* Store the symbol's current value into the alist entry
2381 it is currently set up for. This is so that, if the
2382 local is marked permanent, and we make it local again
2383 later in Fkill_all_local_variables, we don't lose the value. */
2384 XSETCDR (XCAR (tem),
2385 do_symval_forwarding (XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->realvalue));
2386 /* Switch to the symbol's default-value alist entry. */
2387 XSETCAR (tem, tem);
2388 /* Mark it as current for buffer B. */
2389 XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->buffer = buffer;
2390 /* Store the current value into any forwarding in the symbol. */
2391 store_symval_forwarding (sym,
2392 XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (sym))->realvalue,
2393 XCDR (tem), NULL);
2394 }
2395 }
2396 }
2397 \f
2398 /* Find all the overlays in the current buffer that contain position POS.
2399 Return the number found, and store them in a vector in *VEC_PTR.
2400 Store in *LEN_PTR the size allocated for the vector.
2401 Store in *NEXT_PTR the next position after POS where an overlay starts,
2402 or ZV if there are no more overlays.
2403 Store in *PREV_PTR the previous position before POS where an overlay ends,
2404 or where an overlay starts which ends at or after POS;
2405 or BEGV if there are no such overlays.
2406 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2407
2408 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2409 when this function is called.
2410
2411 If EXTEND is non-zero, we make the vector bigger if necessary.
2412 If EXTEND is zero, we never extend the vector,
2413 and we store only as many overlays as will fit.
2414 But we still return the total number of overlays.
2415
2416 If CHANGE_REQ is true, then any position written into *PREV_PTR or
2417 *NEXT_PTR is guaranteed to be not equal to POS, unless it is the
2418 default (BEGV or ZV). */
2419
2420 int
2421 overlays_at (pos, extend, vec_ptr, len_ptr, next_ptr, prev_ptr, change_req)
2422 int pos;
2423 int extend;
2424 Lisp_Object **vec_ptr;
2425 int *len_ptr;
2426 int *next_ptr;
2427 int *prev_ptr;
2428 int change_req;
2429 {
2430 Lisp_Object tail, overlay, start, end;
2431 int idx = 0;
2432 int len = *len_ptr;
2433 Lisp_Object *vec = *vec_ptr;
2434 int next = ZV;
2435 int prev = BEGV;
2436 int inhibit_storing = 0;
2437
2438 for (tail = current_buffer->overlays_before;
2439 GC_CONSP (tail);
2440 tail = XCDR (tail))
2441 {
2442 int startpos, endpos;
2443
2444 overlay = XCAR (tail);
2445
2446 start = OVERLAY_START (overlay);
2447 end = OVERLAY_END (overlay);
2448 endpos = OVERLAY_POSITION (end);
2449 if (endpos < pos)
2450 {
2451 if (prev < endpos)
2452 prev = endpos;
2453 break;
2454 }
2455 startpos = OVERLAY_POSITION (start);
2456 /* This one ends at or after POS
2457 so its start counts for PREV_PTR if it's before POS. */
2458 if (prev < startpos && startpos < pos)
2459 prev = startpos;
2460 if (endpos == pos)
2461 continue;
2462 if (startpos <= pos)
2463 {
2464 if (idx == len)
2465 {
2466 /* The supplied vector is full.
2467 Either make it bigger, or don't store any more in it. */
2468 if (extend)
2469 {
2470 /* Make it work with an initial len == 0. */
2471 len *= 2;
2472 if (len == 0)
2473 len = 4;
2474 *len_ptr = len;
2475 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2476 *vec_ptr = vec;
2477 }
2478 else
2479 inhibit_storing = 1;
2480 }
2481
2482 if (!inhibit_storing)
2483 vec[idx] = overlay;
2484 /* Keep counting overlays even if we can't return them all. */
2485 idx++;
2486 }
2487 else if (startpos < next)
2488 next = startpos;
2489 }
2490
2491 for (tail = current_buffer->overlays_after;
2492 GC_CONSP (tail);
2493 tail = XCDR (tail))
2494 {
2495 int startpos, endpos;
2496
2497 overlay = XCAR (tail);
2498
2499 start = OVERLAY_START (overlay);
2500 end = OVERLAY_END (overlay);
2501 startpos = OVERLAY_POSITION (start);
2502 if (pos < startpos)
2503 {
2504 if (startpos < next)
2505 next = startpos;
2506 break;
2507 }
2508 endpos = OVERLAY_POSITION (end);
2509 if (pos < endpos)
2510 {
2511 if (idx == len)
2512 {
2513 if (extend)
2514 {
2515 /* Make it work with an initial len == 0. */
2516 len *= 2;
2517 if (len == 0)
2518 len = 4;
2519 *len_ptr = len;
2520 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2521 *vec_ptr = vec;
2522 }
2523 else
2524 inhibit_storing = 1;
2525 }
2526
2527 if (!inhibit_storing)
2528 vec[idx] = overlay;
2529 idx++;
2530
2531 if (startpos < pos && startpos > prev)
2532 prev = startpos;
2533 }
2534 else if (endpos < pos && endpos > prev)
2535 prev = endpos;
2536 else if (endpos == pos && startpos > prev
2537 && (!change_req || startpos < pos))
2538 prev = startpos;
2539 }
2540
2541 if (next_ptr)
2542 *next_ptr = next;
2543 if (prev_ptr)
2544 *prev_ptr = prev;
2545 return idx;
2546 }
2547 \f
2548 /* Find all the overlays in the current buffer that overlap the range BEG-END
2549 or are empty at BEG.
2550
2551 Return the number found, and store them in a vector in *VEC_PTR.
2552 Store in *LEN_PTR the size allocated for the vector.
2553 Store in *NEXT_PTR the next position after POS where an overlay starts,
2554 or ZV if there are no more overlays.
2555 Store in *PREV_PTR the previous position before POS where an overlay ends,
2556 or BEGV if there are no previous overlays.
2557 NEXT_PTR and/or PREV_PTR may be 0, meaning don't store that info.
2558
2559 *VEC_PTR and *LEN_PTR should contain a valid vector and size
2560 when this function is called.
2561
2562 If EXTEND is non-zero, we make the vector bigger if necessary.
2563 If EXTEND is zero, we never extend the vector,
2564 and we store only as many overlays as will fit.
2565 But we still return the total number of overlays. */
2566
2567 static int
2568 overlays_in (beg, end, extend, vec_ptr, len_ptr, next_ptr, prev_ptr)
2569 int beg, end;
2570 int extend;
2571 Lisp_Object **vec_ptr;
2572 int *len_ptr;
2573 int *next_ptr;
2574 int *prev_ptr;
2575 {
2576 Lisp_Object tail, overlay, ostart, oend;
2577 int idx = 0;
2578 int len = *len_ptr;
2579 Lisp_Object *vec = *vec_ptr;
2580 int next = ZV;
2581 int prev = BEGV;
2582 int inhibit_storing = 0;
2583
2584 for (tail = current_buffer->overlays_before;
2585 GC_CONSP (tail);
2586 tail = XCDR (tail))
2587 {
2588 int startpos, endpos;
2589
2590 overlay = XCAR (tail);
2591
2592 ostart = OVERLAY_START (overlay);
2593 oend = OVERLAY_END (overlay);
2594 endpos = OVERLAY_POSITION (oend);
2595 if (endpos < beg)
2596 {
2597 if (prev < endpos)
2598 prev = endpos;
2599 break;
2600 }
2601 startpos = OVERLAY_POSITION (ostart);
2602 /* Count an interval if it either overlaps the range
2603 or is empty at the start of the range. */
2604 if ((beg < endpos && startpos < end)
2605 || (startpos == endpos && beg == endpos))
2606 {
2607 if (idx == len)
2608 {
2609 /* The supplied vector is full.
2610 Either make it bigger, or don't store any more in it. */
2611 if (extend)
2612 {
2613 /* Make it work with an initial len == 0. */
2614 len *= 2;
2615 if (len == 0)
2616 len = 4;
2617 *len_ptr = len;
2618 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2619 *vec_ptr = vec;
2620 }
2621 else
2622 inhibit_storing = 1;
2623 }
2624
2625 if (!inhibit_storing)
2626 vec[idx] = overlay;
2627 /* Keep counting overlays even if we can't return them all. */
2628 idx++;
2629 }
2630 else if (startpos < next)
2631 next = startpos;
2632 }
2633
2634 for (tail = current_buffer->overlays_after;
2635 GC_CONSP (tail);
2636 tail = XCDR (tail))
2637 {
2638 int startpos, endpos;
2639
2640 overlay = XCAR (tail);
2641
2642 ostart = OVERLAY_START (overlay);
2643 oend = OVERLAY_END (overlay);
2644 startpos = OVERLAY_POSITION (ostart);
2645 if (end < startpos)
2646 {
2647 if (startpos < next)
2648 next = startpos;
2649 break;
2650 }
2651 endpos = OVERLAY_POSITION (oend);
2652 /* Count an interval if it either overlaps the range
2653 or is empty at the start of the range. */
2654 if ((beg < endpos && startpos < end)
2655 || (startpos == endpos && beg == endpos))
2656 {
2657 if (idx == len)
2658 {
2659 if (extend)
2660 {
2661 /* Make it work with an initial len == 0. */
2662 len *= 2;
2663 if (len == 0)
2664 len = 4;
2665 *len_ptr = len;
2666 vec = (Lisp_Object *) xrealloc (vec, len * sizeof (Lisp_Object));
2667 *vec_ptr = vec;
2668 }
2669 else
2670 inhibit_storing = 1;
2671 }
2672
2673 if (!inhibit_storing)
2674 vec[idx] = overlay;
2675 idx++;
2676 }
2677 else if (endpos < beg && endpos > prev)
2678 prev = endpos;
2679 }
2680
2681 if (next_ptr)
2682 *next_ptr = next;
2683 if (prev_ptr)
2684 *prev_ptr = prev;
2685 return idx;
2686 }
2687
2688
2689 /* Return non-zero if there exists an overlay with a non-nil
2690 `mouse-face' property overlapping OVERLAY. */
2691
2692 int
2693 mouse_face_overlay_overlaps (overlay)
2694 Lisp_Object overlay;
2695 {
2696 int start = OVERLAY_POSITION (OVERLAY_START (overlay));
2697 int end = OVERLAY_POSITION (OVERLAY_END (overlay));
2698 int n, i, size;
2699 Lisp_Object *v, tem;
2700
2701 size = 10;
2702 v = (Lisp_Object *) alloca (size * sizeof *v);
2703 n = overlays_in (start, end, 0, &v, &size, NULL, NULL);
2704 if (n > size)
2705 {
2706 v = (Lisp_Object *) alloca (n * sizeof *v);
2707 overlays_in (start, end, 0, &v, &n, NULL, NULL);
2708 }
2709
2710 for (i = 0; i < n; ++i)
2711 if (!EQ (v[i], overlay)
2712 && (tem = Foverlay_get (overlay, Qmouse_face),
2713 !NILP (tem)))
2714 break;
2715
2716 return i < n;
2717 }
2718
2719
2720 \f
2721 /* Fast function to just test if we're at an overlay boundary. */
2722 int
2723 overlay_touches_p (pos)
2724 int pos;
2725 {
2726 Lisp_Object tail, overlay;
2727
2728 for (tail = current_buffer->overlays_before; GC_CONSP (tail);
2729 tail = XCDR (tail))
2730 {
2731 int endpos;
2732
2733 overlay = XCAR (tail);
2734 if (!GC_OVERLAYP (overlay))
2735 abort ();
2736
2737 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
2738 if (endpos < pos)
2739 break;
2740 if (endpos == pos || OVERLAY_POSITION (OVERLAY_START (overlay)) == pos)
2741 return 1;
2742 }
2743
2744 for (tail = current_buffer->overlays_after; GC_CONSP (tail);
2745 tail = XCDR (tail))
2746 {
2747 int startpos;
2748
2749 overlay = XCAR (tail);
2750 if (!GC_OVERLAYP (overlay))
2751 abort ();
2752
2753 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
2754 if (pos < startpos)
2755 break;
2756 if (startpos == pos || OVERLAY_POSITION (OVERLAY_END (overlay)) == pos)
2757 return 1;
2758 }
2759 return 0;
2760 }
2761 \f
2762 struct sortvec
2763 {
2764 Lisp_Object overlay;
2765 int beg, end;
2766 int priority;
2767 };
2768
2769 static int
2770 compare_overlays (v1, v2)
2771 const void *v1, *v2;
2772 {
2773 const struct sortvec *s1 = (const struct sortvec *) v1;
2774 const struct sortvec *s2 = (const struct sortvec *) v2;
2775 if (s1->priority != s2->priority)
2776 return s1->priority - s2->priority;
2777 if (s1->beg != s2->beg)
2778 return s1->beg - s2->beg;
2779 if (s1->end != s2->end)
2780 return s2->end - s1->end;
2781 return 0;
2782 }
2783
2784 /* Sort an array of overlays by priority. The array is modified in place.
2785 The return value is the new size; this may be smaller than the original
2786 size if some of the overlays were invalid or were window-specific. */
2787 int
2788 sort_overlays (overlay_vec, noverlays, w)
2789 Lisp_Object *overlay_vec;
2790 int noverlays;
2791 struct window *w;
2792 {
2793 int i, j;
2794 struct sortvec *sortvec;
2795 sortvec = (struct sortvec *) alloca (noverlays * sizeof (struct sortvec));
2796
2797 /* Put the valid and relevant overlays into sortvec. */
2798
2799 for (i = 0, j = 0; i < noverlays; i++)
2800 {
2801 Lisp_Object tem;
2802 Lisp_Object overlay;
2803
2804 overlay = overlay_vec[i];
2805 if (OVERLAY_VALID (overlay)
2806 && OVERLAY_POSITION (OVERLAY_START (overlay)) > 0
2807 && OVERLAY_POSITION (OVERLAY_END (overlay)) > 0)
2808 {
2809 /* If we're interested in a specific window, then ignore
2810 overlays that are limited to some other window. */
2811 if (w)
2812 {
2813 Lisp_Object window;
2814
2815 window = Foverlay_get (overlay, Qwindow);
2816 if (WINDOWP (window) && XWINDOW (window) != w)
2817 continue;
2818 }
2819
2820 /* This overlay is good and counts: put it into sortvec. */
2821 sortvec[j].overlay = overlay;
2822 sortvec[j].beg = OVERLAY_POSITION (OVERLAY_START (overlay));
2823 sortvec[j].end = OVERLAY_POSITION (OVERLAY_END (overlay));
2824 tem = Foverlay_get (overlay, Qpriority);
2825 if (INTEGERP (tem))
2826 sortvec[j].priority = XINT (tem);
2827 else
2828 sortvec[j].priority = 0;
2829 j++;
2830 }
2831 }
2832 noverlays = j;
2833
2834 /* Sort the overlays into the proper order: increasing priority. */
2835
2836 if (noverlays > 1)
2837 qsort (sortvec, noverlays, sizeof (struct sortvec), compare_overlays);
2838
2839 for (i = 0; i < noverlays; i++)
2840 overlay_vec[i] = sortvec[i].overlay;
2841 return (noverlays);
2842 }
2843 \f
2844 struct sortstr
2845 {
2846 Lisp_Object string, string2;
2847 int size;
2848 int priority;
2849 };
2850
2851 struct sortstrlist
2852 {
2853 struct sortstr *buf; /* An array that expands as needed; never freed. */
2854 int size; /* Allocated length of that array. */
2855 int used; /* How much of the array is currently in use. */
2856 int bytes; /* Total length of the strings in buf. */
2857 };
2858
2859 /* Buffers for storing information about the overlays touching a given
2860 position. These could be automatic variables in overlay_strings, but
2861 it's more efficient to hold onto the memory instead of repeatedly
2862 allocating and freeing it. */
2863 static struct sortstrlist overlay_heads, overlay_tails;
2864 static unsigned char *overlay_str_buf;
2865
2866 /* Allocated length of overlay_str_buf. */
2867 static int overlay_str_len;
2868
2869 /* A comparison function suitable for passing to qsort. */
2870 static int
2871 cmp_for_strings (as1, as2)
2872 char *as1, *as2;
2873 {
2874 struct sortstr *s1 = (struct sortstr *)as1;
2875 struct sortstr *s2 = (struct sortstr *)as2;
2876 if (s1->size != s2->size)
2877 return s2->size - s1->size;
2878 if (s1->priority != s2->priority)
2879 return s1->priority - s2->priority;
2880 return 0;
2881 }
2882
2883 static void
2884 record_overlay_string (ssl, str, str2, pri, size)
2885 struct sortstrlist *ssl;
2886 Lisp_Object str, str2, pri;
2887 int size;
2888 {
2889 int nbytes;
2890
2891 if (ssl->used == ssl->size)
2892 {
2893 if (ssl->buf)
2894 ssl->size *= 2;
2895 else
2896 ssl->size = 5;
2897 ssl->buf = ((struct sortstr *)
2898 xrealloc (ssl->buf, ssl->size * sizeof (struct sortstr)));
2899 }
2900 ssl->buf[ssl->used].string = str;
2901 ssl->buf[ssl->used].string2 = str2;
2902 ssl->buf[ssl->used].size = size;
2903 ssl->buf[ssl->used].priority = (INTEGERP (pri) ? XINT (pri) : 0);
2904 ssl->used++;
2905
2906 if (NILP (current_buffer->enable_multibyte_characters))
2907 nbytes = SCHARS (str);
2908 else if (! STRING_MULTIBYTE (str))
2909 nbytes = count_size_as_multibyte (SDATA (str),
2910 SBYTES (str));
2911 else
2912 nbytes = SBYTES (str);
2913
2914 ssl->bytes += nbytes;
2915
2916 if (STRINGP (str2))
2917 {
2918 if (NILP (current_buffer->enable_multibyte_characters))
2919 nbytes = SCHARS (str2);
2920 else if (! STRING_MULTIBYTE (str2))
2921 nbytes = count_size_as_multibyte (SDATA (str2),
2922 SBYTES (str2));
2923 else
2924 nbytes = SBYTES (str2);
2925
2926 ssl->bytes += nbytes;
2927 }
2928 }
2929
2930 /* Return the concatenation of the strings associated with overlays that
2931 begin or end at POS, ignoring overlays that are specific to a window
2932 other than W. The strings are concatenated in the appropriate order:
2933 shorter overlays nest inside longer ones, and higher priority inside
2934 lower. Normally all of the after-strings come first, but zero-sized
2935 overlays have their after-strings ride along with the before-strings
2936 because it would look strange to print them inside-out.
2937
2938 Returns the string length, and stores the contents indirectly through
2939 PSTR, if that variable is non-null. The string may be overwritten by
2940 subsequent calls. */
2941
2942 int
2943 overlay_strings (pos, w, pstr)
2944 int pos;
2945 struct window *w;
2946 unsigned char **pstr;
2947 {
2948 Lisp_Object ov, overlay, window, str;
2949 int startpos, endpos;
2950 int multibyte = ! NILP (current_buffer->enable_multibyte_characters);
2951
2952 overlay_heads.used = overlay_heads.bytes = 0;
2953 overlay_tails.used = overlay_tails.bytes = 0;
2954 for (ov = current_buffer->overlays_before; CONSP (ov); ov = XCDR (ov))
2955 {
2956 overlay = XCAR (ov);
2957 if (!OVERLAYP (overlay))
2958 abort ();
2959
2960 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
2961 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
2962 if (endpos < pos)
2963 break;
2964 if (endpos != pos && startpos != pos)
2965 continue;
2966 window = Foverlay_get (overlay, Qwindow);
2967 if (WINDOWP (window) && XWINDOW (window) != w)
2968 continue;
2969 if (startpos == pos
2970 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
2971 record_overlay_string (&overlay_heads, str,
2972 (startpos == endpos
2973 ? Foverlay_get (overlay, Qafter_string)
2974 : Qnil),
2975 Foverlay_get (overlay, Qpriority),
2976 endpos - startpos);
2977 else if (endpos == pos
2978 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
2979 record_overlay_string (&overlay_tails, str, Qnil,
2980 Foverlay_get (overlay, Qpriority),
2981 endpos - startpos);
2982 }
2983 for (ov = current_buffer->overlays_after; CONSP (ov); ov = XCDR (ov))
2984 {
2985 overlay = XCAR (ov);
2986 if (!OVERLAYP (overlay))
2987 abort ();
2988
2989 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
2990 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
2991 if (startpos > pos)
2992 break;
2993 if (endpos != pos && startpos != pos)
2994 continue;
2995 window = Foverlay_get (overlay, Qwindow);
2996 if (WINDOWP (window) && XWINDOW (window) != w)
2997 continue;
2998 if (startpos == pos
2999 && (str = Foverlay_get (overlay, Qbefore_string), STRINGP (str)))
3000 record_overlay_string (&overlay_heads, str,
3001 (startpos == endpos
3002 ? Foverlay_get (overlay, Qafter_string)
3003 : Qnil),
3004 Foverlay_get (overlay, Qpriority),
3005 endpos - startpos);
3006 else if (endpos == pos
3007 && (str = Foverlay_get (overlay, Qafter_string), STRINGP (str)))
3008 record_overlay_string (&overlay_tails, str, Qnil,
3009 Foverlay_get (overlay, Qpriority),
3010 endpos - startpos);
3011 }
3012 if (overlay_tails.used > 1)
3013 qsort (overlay_tails.buf, overlay_tails.used, sizeof (struct sortstr),
3014 cmp_for_strings);
3015 if (overlay_heads.used > 1)
3016 qsort (overlay_heads.buf, overlay_heads.used, sizeof (struct sortstr),
3017 cmp_for_strings);
3018 if (overlay_heads.bytes || overlay_tails.bytes)
3019 {
3020 Lisp_Object tem;
3021 int i;
3022 unsigned char *p;
3023 int total = overlay_heads.bytes + overlay_tails.bytes;
3024
3025 if (total > overlay_str_len)
3026 {
3027 overlay_str_len = total;
3028 overlay_str_buf = (unsigned char *)xrealloc (overlay_str_buf,
3029 total);
3030 }
3031 p = overlay_str_buf;
3032 for (i = overlay_tails.used; --i >= 0;)
3033 {
3034 int nbytes;
3035 tem = overlay_tails.buf[i].string;
3036 nbytes = copy_text (SDATA (tem), p,
3037 SBYTES (tem),
3038 STRING_MULTIBYTE (tem), multibyte);
3039 p += nbytes;
3040 }
3041 for (i = 0; i < overlay_heads.used; ++i)
3042 {
3043 int nbytes;
3044 tem = overlay_heads.buf[i].string;
3045 nbytes = copy_text (SDATA (tem), p,
3046 SBYTES (tem),
3047 STRING_MULTIBYTE (tem), multibyte);
3048 p += nbytes;
3049 tem = overlay_heads.buf[i].string2;
3050 if (STRINGP (tem))
3051 {
3052 nbytes = copy_text (SDATA (tem), p,
3053 SBYTES (tem),
3054 STRING_MULTIBYTE (tem), multibyte);
3055 p += nbytes;
3056 }
3057 }
3058 if (p != overlay_str_buf + total)
3059 abort ();
3060 if (pstr)
3061 *pstr = overlay_str_buf;
3062 return total;
3063 }
3064 return 0;
3065 }
3066 \f
3067 /* Shift overlays in BUF's overlay lists, to center the lists at POS. */
3068
3069 void
3070 recenter_overlay_lists (buf, pos)
3071 struct buffer *buf;
3072 int pos;
3073 {
3074 Lisp_Object overlay, tail, next, prev, beg, end;
3075
3076 /* See if anything in overlays_before should move to overlays_after. */
3077
3078 /* We don't strictly need prev in this loop; it should always be nil.
3079 But we use it for symmetry and in case that should cease to be true
3080 with some future change. */
3081 prev = Qnil;
3082 for (tail = buf->overlays_before;
3083 CONSP (tail);
3084 prev = tail, tail = next)
3085 {
3086 next = XCDR (tail);
3087 overlay = XCAR (tail);
3088
3089 /* If the overlay is not valid, get rid of it. */
3090 if (!OVERLAY_VALID (overlay))
3091 #if 1
3092 abort ();
3093 #else
3094 {
3095 /* Splice the cons cell TAIL out of overlays_before. */
3096 if (!NILP (prev))
3097 XCDR (prev) = next;
3098 else
3099 buf->overlays_before = next;
3100 tail = prev;
3101 continue;
3102 }
3103 #endif
3104
3105 beg = OVERLAY_START (overlay);
3106 end = OVERLAY_END (overlay);
3107
3108 if (OVERLAY_POSITION (end) > pos)
3109 {
3110 /* OVERLAY needs to be moved. */
3111 int where = OVERLAY_POSITION (beg);
3112 Lisp_Object other, other_prev;
3113
3114 /* Splice the cons cell TAIL out of overlays_before. */
3115 if (!NILP (prev))
3116 XSETCDR (prev, next);
3117 else
3118 buf->overlays_before = next;
3119
3120 /* Search thru overlays_after for where to put it. */
3121 other_prev = Qnil;
3122 for (other = buf->overlays_after;
3123 CONSP (other);
3124 other_prev = other, other = XCDR (other))
3125 {
3126 Lisp_Object otherbeg, otheroverlay;
3127
3128 otheroverlay = XCAR (other);
3129 if (! OVERLAY_VALID (otheroverlay))
3130 abort ();
3131
3132 otherbeg = OVERLAY_START (otheroverlay);
3133 if (OVERLAY_POSITION (otherbeg) >= where)
3134 break;
3135 }
3136
3137 /* Add TAIL to overlays_after before OTHER. */
3138 XSETCDR (tail, other);
3139 if (!NILP (other_prev))
3140 XSETCDR (other_prev, tail);
3141 else
3142 buf->overlays_after = tail;
3143 tail = prev;
3144 }
3145 else
3146 /* We've reached the things that should stay in overlays_before.
3147 All the rest of overlays_before must end even earlier,
3148 so stop now. */
3149 break;
3150 }
3151
3152 /* See if anything in overlays_after should be in overlays_before. */
3153 prev = Qnil;
3154 for (tail = buf->overlays_after;
3155 CONSP (tail);
3156 prev = tail, tail = next)
3157 {
3158 next = XCDR (tail);
3159 overlay = XCAR (tail);
3160
3161 /* If the overlay is not valid, get rid of it. */
3162 if (!OVERLAY_VALID (overlay))
3163 #if 1
3164 abort ();
3165 #else
3166 {
3167 /* Splice the cons cell TAIL out of overlays_after. */
3168 if (!NILP (prev))
3169 XCDR (prev) = next;
3170 else
3171 buf->overlays_after = next;
3172 tail = prev;
3173 continue;
3174 }
3175 #endif
3176
3177 beg = OVERLAY_START (overlay);
3178 end = OVERLAY_END (overlay);
3179
3180 /* Stop looking, when we know that nothing further
3181 can possibly end before POS. */
3182 if (OVERLAY_POSITION (beg) > pos)
3183 break;
3184
3185 if (OVERLAY_POSITION (end) <= pos)
3186 {
3187 /* OVERLAY needs to be moved. */
3188 int where = OVERLAY_POSITION (end);
3189 Lisp_Object other, other_prev;
3190
3191 /* Splice the cons cell TAIL out of overlays_after. */
3192 if (!NILP (prev))
3193 XSETCDR (prev, next);
3194 else
3195 buf->overlays_after = next;
3196
3197 /* Search thru overlays_before for where to put it. */
3198 other_prev = Qnil;
3199 for (other = buf->overlays_before;
3200 CONSP (other);
3201 other_prev = other, other = XCDR (other))
3202 {
3203 Lisp_Object otherend, otheroverlay;
3204
3205 otheroverlay = XCAR (other);
3206 if (! OVERLAY_VALID (otheroverlay))
3207 abort ();
3208
3209 otherend = OVERLAY_END (otheroverlay);
3210 if (OVERLAY_POSITION (otherend) <= where)
3211 break;
3212 }
3213
3214 /* Add TAIL to overlays_before before OTHER. */
3215 XSETCDR (tail, other);
3216 if (!NILP (other_prev))
3217 XSETCDR (other_prev, tail);
3218 else
3219 buf->overlays_before = tail;
3220 tail = prev;
3221 }
3222 }
3223
3224 XSETFASTINT (buf->overlay_center, pos);
3225 }
3226
3227 void
3228 adjust_overlays_for_insert (pos, length)
3229 int pos;
3230 int length;
3231 {
3232 /* After an insertion, the lists are still sorted properly,
3233 but we may need to update the value of the overlay center. */
3234 if (XFASTINT (current_buffer->overlay_center) >= pos)
3235 XSETFASTINT (current_buffer->overlay_center,
3236 XFASTINT (current_buffer->overlay_center) + length);
3237 }
3238
3239 void
3240 adjust_overlays_for_delete (pos, length)
3241 int pos;
3242 int length;
3243 {
3244 if (XFASTINT (current_buffer->overlay_center) < pos)
3245 /* The deletion was to our right. No change needed; the before- and
3246 after-lists are still consistent. */
3247 ;
3248 else if (XFASTINT (current_buffer->overlay_center) > pos + length)
3249 /* The deletion was to our left. We need to adjust the center value
3250 to account for the change in position, but the lists are consistent
3251 given the new value. */
3252 XSETFASTINT (current_buffer->overlay_center,
3253 XFASTINT (current_buffer->overlay_center) - length);
3254 else
3255 /* We're right in the middle. There might be things on the after-list
3256 that now belong on the before-list. Recentering will move them,
3257 and also update the center point. */
3258 recenter_overlay_lists (current_buffer, pos);
3259 }
3260
3261 /* Fix up overlays that were garbled as a result of permuting markers
3262 in the range START through END. Any overlay with at least one
3263 endpoint in this range will need to be unlinked from the overlay
3264 list and reinserted in its proper place.
3265 Such an overlay might even have negative size at this point.
3266 If so, we'll reverse the endpoints. Can you think of anything
3267 better to do in this situation? */
3268 void
3269 fix_overlays_in_range (start, end)
3270 register int start, end;
3271 {
3272 Lisp_Object overlay;
3273 Lisp_Object before_list, after_list;
3274 /* These are either nil, indicating that before_list or after_list
3275 should be assigned, or the cons cell the cdr of which should be
3276 assigned. */
3277 Lisp_Object beforep = Qnil, afterp = Qnil;
3278 /* 'Parent', likewise, indicates a cons cell or
3279 current_buffer->overlays_before or overlays_after, depending
3280 which loop we're in. */
3281 Lisp_Object tail, parent;
3282 int startpos, endpos;
3283
3284 /* This algorithm shifts links around instead of consing and GCing.
3285 The loop invariant is that before_list (resp. after_list) is a
3286 well-formed list except that its last element, the CDR of beforep
3287 (resp. afterp) if beforep (afterp) isn't nil or before_list
3288 (after_list) if it is, is still uninitialized. So it's not a bug
3289 that before_list isn't initialized, although it may look
3290 strange. */
3291 for (parent = Qnil, tail = current_buffer->overlays_before; CONSP (tail);)
3292 {
3293 overlay = XCAR (tail);
3294 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3295 if (endpos < start)
3296 break;
3297 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3298 if (endpos < end
3299 || (startpos >= start && startpos < end))
3300 {
3301 /* If the overlay is backwards, fix that now. */
3302 if (startpos > endpos)
3303 {
3304 int tem;
3305 Fset_marker (OVERLAY_START (overlay), make_number (endpos),
3306 Qnil);
3307 Fset_marker (OVERLAY_END (overlay), make_number (startpos),
3308 Qnil);
3309 tem = startpos; startpos = endpos; endpos = tem;
3310 }
3311 /* Add it to the end of the wrong list. Later on,
3312 recenter_overlay_lists will move it to the right place. */
3313 if (endpos < XINT (current_buffer->overlay_center))
3314 {
3315 if (NILP (afterp))
3316 after_list = tail;
3317 else
3318 XSETCDR (afterp, tail);
3319 afterp = tail;
3320 }
3321 else
3322 {
3323 if (NILP (beforep))
3324 before_list = tail;
3325 else
3326 XSETCDR (beforep, tail);
3327 beforep = tail;
3328 }
3329 if (NILP (parent))
3330 current_buffer->overlays_before = XCDR (tail);
3331 else
3332 XSETCDR (parent, XCDR (tail));
3333 tail = XCDR (tail);
3334 }
3335 else
3336 parent = tail, tail = XCDR (parent);
3337 }
3338 for (parent = Qnil, tail = current_buffer->overlays_after; CONSP (tail);)
3339 {
3340 overlay = XCAR (tail);
3341 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
3342 if (startpos >= end)
3343 break;
3344 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
3345 if (startpos >= start
3346 || (endpos >= start && endpos < end))
3347 {
3348 if (startpos > endpos)
3349 {
3350 int tem;
3351 Fset_marker (OVERLAY_START (overlay), make_number (endpos),
3352 Qnil);
3353 Fset_marker (OVERLAY_END (overlay), make_number (startpos),
3354 Qnil);
3355 tem = startpos; startpos = endpos; endpos = tem;
3356 }
3357 if (endpos < XINT (current_buffer->overlay_center))
3358 {
3359 if (NILP (afterp))
3360 after_list = tail;
3361 else
3362 XSETCDR (afterp, tail);
3363 afterp = tail;
3364 }
3365 else
3366 {
3367 if (NILP (beforep))
3368 before_list = tail;
3369 else
3370 XSETCDR (beforep, tail);
3371 beforep = tail;
3372 }
3373 if (NILP (parent))
3374 current_buffer->overlays_after = XCDR (tail);
3375 else
3376 XSETCDR (parent, XCDR (tail));
3377 tail = XCDR (tail);
3378 }
3379 else
3380 parent = tail, tail = XCDR (parent);
3381 }
3382
3383 /* Splice the constructed (wrong) lists into the buffer's lists,
3384 and let the recenter function make it sane again. */
3385 if (!NILP (beforep))
3386 {
3387 XSETCDR (beforep, current_buffer->overlays_before);
3388 current_buffer->overlays_before = before_list;
3389 }
3390 recenter_overlay_lists (current_buffer,
3391 XINT (current_buffer->overlay_center));
3392
3393 if (!NILP (afterp))
3394 {
3395 XSETCDR (afterp, current_buffer->overlays_after);
3396 current_buffer->overlays_after = after_list;
3397 }
3398 recenter_overlay_lists (current_buffer,
3399 XINT (current_buffer->overlay_center));
3400 }
3401
3402 /* We have two types of overlay: the one whose ending marker is
3403 after-insertion-marker (this is the usual case) and the one whose
3404 ending marker is before-insertion-marker. When `overlays_before'
3405 contains overlays of the latter type and the former type in this
3406 order and both overlays end at inserting position, inserting a text
3407 increases only the ending marker of the latter type, which results
3408 in incorrect ordering of `overlays_before'.
3409
3410 This function fixes ordering of overlays in the slot
3411 `overlays_before' of the buffer *BP. Before the insertion, `point'
3412 was at PREV, and now is at POS. */
3413
3414 void
3415 fix_overlays_before (bp, prev, pos)
3416 struct buffer *bp;
3417 int prev, pos;
3418 {
3419 /* If parent is nil, replace overlays_before; otherwise, XCDR(parent). */
3420 Lisp_Object tail = bp->overlays_before, parent = Qnil;
3421 Lisp_Object right_pair;
3422 int end;
3423
3424 /* After the insertion, the several overlays may be in incorrect
3425 order. The possibility is that, in the list `overlays_before',
3426 an overlay which ends at POS appears after an overlay which ends
3427 at PREV. Since POS is greater than PREV, we must fix the
3428 ordering of these overlays, by moving overlays ends at POS before
3429 the overlays ends at PREV. */
3430
3431 /* At first, find a place where disordered overlays should be linked
3432 in. It is where an overlay which end before POS exists. (i.e. an
3433 overlay whose ending marker is after-insertion-marker if disorder
3434 exists). */
3435 while (!NILP (tail)
3436 && ((end = OVERLAY_POSITION (OVERLAY_END (XCAR (tail))))
3437 >= pos))
3438 {
3439 parent = tail;
3440 tail = XCDR (tail);
3441 }
3442
3443 /* If we don't find such an overlay,
3444 or the found one ends before PREV,
3445 or the found one is the last one in the list,
3446 we don't have to fix anything. */
3447 if (NILP (tail)
3448 || end < prev
3449 || NILP (XCDR (tail)))
3450 return;
3451
3452 right_pair = parent;
3453 parent = tail;
3454 tail = XCDR (tail);
3455
3456 /* Now, end position of overlays in the list TAIL should be before
3457 or equal to PREV. In the loop, an overlay which ends at POS is
3458 moved ahead to the place indicated by the CDR of RIGHT_PAIR. If
3459 we found an overlay which ends before PREV, the remaining
3460 overlays are in correct order. */
3461 while (!NILP (tail))
3462 {
3463 end = OVERLAY_POSITION (OVERLAY_END (XCAR (tail)));
3464
3465 if (end == pos)
3466 { /* This overlay is disordered. */
3467 Lisp_Object found = tail;
3468
3469 /* Unlink the found overlay. */
3470 tail = XCDR (found);
3471 XSETCDR (parent, tail);
3472 /* Move an overlay at RIGHT_PLACE to the next of the found one,
3473 and link it into the right place. */
3474 if (NILP (right_pair))
3475 {
3476 XSETCDR (found, bp->overlays_before);
3477 bp->overlays_before = found;
3478 }
3479 else
3480 {
3481 XSETCDR (found, XCDR (right_pair));
3482 XSETCDR (right_pair, found);
3483 }
3484 }
3485 else if (end == prev)
3486 {
3487 parent = tail;
3488 tail = XCDR (tail);
3489 }
3490 else /* No more disordered overlay. */
3491 break;
3492 }
3493 }
3494 \f
3495 DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
3496 doc: /* Return t if OBJECT is an overlay. */)
3497 (object)
3498 Lisp_Object object;
3499 {
3500 return (OVERLAYP (object) ? Qt : Qnil);
3501 }
3502
3503 DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 5, 0,
3504 doc: /* Create a new overlay with range BEG to END in BUFFER.
3505 If omitted, BUFFER defaults to the current buffer.
3506 BEG and END may be integers or markers.
3507 The fourth arg FRONT-ADVANCE, if non-nil, makes the
3508 front delimiter advance when text is inserted there.
3509 The fifth arg REAR-ADVANCE, if non-nil, makes the
3510 rear delimiter advance when text is inserted there. */)
3511 (beg, end, buffer, front_advance, rear_advance)
3512 Lisp_Object beg, end, buffer;
3513 Lisp_Object front_advance, rear_advance;
3514 {
3515 Lisp_Object overlay;
3516 struct buffer *b;
3517
3518 if (NILP (buffer))
3519 XSETBUFFER (buffer, current_buffer);
3520 else
3521 CHECK_BUFFER (buffer);
3522 if (MARKERP (beg)
3523 && ! EQ (Fmarker_buffer (beg), buffer))
3524 error ("Marker points into wrong buffer");
3525 if (MARKERP (end)
3526 && ! EQ (Fmarker_buffer (end), buffer))
3527 error ("Marker points into wrong buffer");
3528
3529 CHECK_NUMBER_COERCE_MARKER (beg);
3530 CHECK_NUMBER_COERCE_MARKER (end);
3531
3532 if (XINT (beg) > XINT (end))
3533 {
3534 Lisp_Object temp;
3535 temp = beg; beg = end; end = temp;
3536 }
3537
3538 b = XBUFFER (buffer);
3539
3540 beg = Fset_marker (Fmake_marker (), beg, buffer);
3541 end = Fset_marker (Fmake_marker (), end, buffer);
3542
3543 if (!NILP (front_advance))
3544 XMARKER (beg)->insertion_type = 1;
3545 if (!NILP (rear_advance))
3546 XMARKER (end)->insertion_type = 1;
3547
3548 overlay = allocate_misc ();
3549 XMISCTYPE (overlay) = Lisp_Misc_Overlay;
3550 XOVERLAY (overlay)->start = beg;
3551 XOVERLAY (overlay)->end = end;
3552 XOVERLAY (overlay)->plist = Qnil;
3553
3554 /* Put the new overlay on the wrong list. */
3555 end = OVERLAY_END (overlay);
3556 if (OVERLAY_POSITION (end) < XINT (b->overlay_center))
3557 b->overlays_after = Fcons (overlay, b->overlays_after);
3558 else
3559 b->overlays_before = Fcons (overlay, b->overlays_before);
3560
3561 /* This puts it in the right list, and in the right order. */
3562 recenter_overlay_lists (b, XINT (b->overlay_center));
3563
3564 /* We don't need to redisplay the region covered by the overlay, because
3565 the overlay has no properties at the moment. */
3566
3567 return overlay;
3568 }
3569 \f
3570 /* Mark a section of BUF as needing redisplay because of overlays changes. */
3571
3572 static void
3573 modify_overlay (buf, start, end)
3574 struct buffer *buf;
3575 int start, end;
3576 {
3577 if (start > end)
3578 {
3579 int temp = start;
3580 start = end;
3581 end = temp;
3582 }
3583
3584 BUF_COMPUTE_UNCHANGED (buf, start, end);
3585
3586 /* If this is a buffer not in the selected window,
3587 we must do other windows. */
3588 if (buf != XBUFFER (XWINDOW (selected_window)->buffer))
3589 windows_or_buffers_changed = 1;
3590 /* If multiple windows show this buffer, we must do other windows. */
3591 else if (buffer_shared > 1)
3592 windows_or_buffers_changed = 1;
3593
3594 ++BUF_OVERLAY_MODIFF (buf);
3595 }
3596
3597 \f
3598 Lisp_Object Fdelete_overlay ();
3599
3600 DEFUN ("move-overlay", Fmove_overlay, Smove_overlay, 3, 4, 0,
3601 doc: /* Set the endpoints of OVERLAY to BEG and END in BUFFER.
3602 If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
3603 If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
3604 buffer. */)
3605 (overlay, beg, end, buffer)
3606 Lisp_Object overlay, beg, end, buffer;
3607 {
3608 struct buffer *b, *ob;
3609 Lisp_Object obuffer;
3610 int count = SPECPDL_INDEX ();
3611
3612 CHECK_OVERLAY (overlay);
3613 if (NILP (buffer))
3614 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3615 if (NILP (buffer))
3616 XSETBUFFER (buffer, current_buffer);
3617 CHECK_BUFFER (buffer);
3618
3619 if (MARKERP (beg)
3620 && ! EQ (Fmarker_buffer (beg), buffer))
3621 error ("Marker points into wrong buffer");
3622 if (MARKERP (end)
3623 && ! EQ (Fmarker_buffer (end), buffer))
3624 error ("Marker points into wrong buffer");
3625
3626 CHECK_NUMBER_COERCE_MARKER (beg);
3627 CHECK_NUMBER_COERCE_MARKER (end);
3628
3629 if (XINT (beg) == XINT (end) && ! NILP (Foverlay_get (overlay, Qevaporate)))
3630 return Fdelete_overlay (overlay);
3631
3632 if (XINT (beg) > XINT (end))
3633 {
3634 Lisp_Object temp;
3635 temp = beg; beg = end; end = temp;
3636 }
3637
3638 specbind (Qinhibit_quit, Qt);
3639
3640 obuffer = Fmarker_buffer (OVERLAY_START (overlay));
3641 b = XBUFFER (buffer);
3642 ob = BUFFERP (obuffer) ? XBUFFER (obuffer) : (struct buffer *) 0;
3643
3644 /* If the overlay has changed buffers, do a thorough redisplay. */
3645 if (!EQ (buffer, obuffer))
3646 {
3647 /* Redisplay where the overlay was. */
3648 if (!NILP (obuffer))
3649 {
3650 int o_beg;
3651 int o_end;
3652
3653 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3654 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3655
3656 modify_overlay (ob, o_beg, o_end);
3657 }
3658
3659 /* Redisplay where the overlay is going to be. */
3660 modify_overlay (b, XINT (beg), XINT (end));
3661 }
3662 else
3663 /* Redisplay the area the overlay has just left, or just enclosed. */
3664 {
3665 int o_beg, o_end;
3666
3667 o_beg = OVERLAY_POSITION (OVERLAY_START (overlay));
3668 o_end = OVERLAY_POSITION (OVERLAY_END (overlay));
3669
3670 if (o_beg == XINT (beg))
3671 modify_overlay (b, o_end, XINT (end));
3672 else if (o_end == XINT (end))
3673 modify_overlay (b, o_beg, XINT (beg));
3674 else
3675 {
3676 if (XINT (beg) < o_beg) o_beg = XINT (beg);
3677 if (XINT (end) > o_end) o_end = XINT (end);
3678 modify_overlay (b, o_beg, o_end);
3679 }
3680 }
3681
3682 if (!NILP (obuffer))
3683 {
3684 ob->overlays_before = Fdelq (overlay, ob->overlays_before);
3685 ob->overlays_after = Fdelq (overlay, ob->overlays_after);
3686 }
3687
3688 Fset_marker (OVERLAY_START (overlay), beg, buffer);
3689 Fset_marker (OVERLAY_END (overlay), end, buffer);
3690
3691 /* Put the overlay on the wrong list. */
3692 end = OVERLAY_END (overlay);
3693 if (OVERLAY_POSITION (end) < XINT (b->overlay_center))
3694 b->overlays_after = Fcons (overlay, b->overlays_after);
3695 else
3696 b->overlays_before = Fcons (overlay, b->overlays_before);
3697
3698 /* This puts it in the right list, and in the right order. */
3699 recenter_overlay_lists (b, XINT (b->overlay_center));
3700
3701 return unbind_to (count, overlay);
3702 }
3703
3704 DEFUN ("delete-overlay", Fdelete_overlay, Sdelete_overlay, 1, 1, 0,
3705 doc: /* Delete the overlay OVERLAY from its buffer. */)
3706 (overlay)
3707 Lisp_Object overlay;
3708 {
3709 Lisp_Object buffer;
3710 struct buffer *b;
3711 int count = SPECPDL_INDEX ();
3712
3713 CHECK_OVERLAY (overlay);
3714
3715 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3716 if (NILP (buffer))
3717 return Qnil;
3718
3719 b = XBUFFER (buffer);
3720 specbind (Qinhibit_quit, Qt);
3721
3722 b->overlays_before = Fdelq (overlay, b->overlays_before);
3723 b->overlays_after = Fdelq (overlay, b->overlays_after);
3724 modify_overlay (b,
3725 marker_position (OVERLAY_START (overlay)),
3726 marker_position (OVERLAY_END (overlay)));
3727 Fset_marker (OVERLAY_START (overlay), Qnil, Qnil);
3728 Fset_marker (OVERLAY_END (overlay), Qnil, Qnil);
3729
3730 /* When deleting an overlay with before or after strings, turn off
3731 display optimizations for the affected buffer, on the basis that
3732 these strings may contain newlines. This is easier to do than to
3733 check for that situation during redisplay. */
3734 if (!windows_or_buffers_changed
3735 && (!NILP (Foverlay_get (overlay, Qbefore_string))
3736 || !NILP (Foverlay_get (overlay, Qafter_string))))
3737 b->prevent_redisplay_optimizations_p = 1;
3738
3739 return unbind_to (count, Qnil);
3740 }
3741 \f
3742 /* Overlay dissection functions. */
3743
3744 DEFUN ("overlay-start", Foverlay_start, Soverlay_start, 1, 1, 0,
3745 doc: /* Return the position at which OVERLAY starts. */)
3746 (overlay)
3747 Lisp_Object overlay;
3748 {
3749 CHECK_OVERLAY (overlay);
3750
3751 return (Fmarker_position (OVERLAY_START (overlay)));
3752 }
3753
3754 DEFUN ("overlay-end", Foverlay_end, Soverlay_end, 1, 1, 0,
3755 doc: /* Return the position at which OVERLAY ends. */)
3756 (overlay)
3757 Lisp_Object overlay;
3758 {
3759 CHECK_OVERLAY (overlay);
3760
3761 return (Fmarker_position (OVERLAY_END (overlay)));
3762 }
3763
3764 DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
3765 doc: /* Return the buffer OVERLAY belongs to. */)
3766 (overlay)
3767 Lisp_Object overlay;
3768 {
3769 CHECK_OVERLAY (overlay);
3770
3771 return Fmarker_buffer (OVERLAY_START (overlay));
3772 }
3773
3774 DEFUN ("overlay-properties", Foverlay_properties, Soverlay_properties, 1, 1, 0,
3775 doc: /* Return a list of the properties on OVERLAY.
3776 This is a copy of OVERLAY's plist; modifying its conses has no effect on
3777 OVERLAY. */)
3778 (overlay)
3779 Lisp_Object overlay;
3780 {
3781 CHECK_OVERLAY (overlay);
3782
3783 return Fcopy_sequence (XOVERLAY (overlay)->plist);
3784 }
3785
3786 \f
3787 DEFUN ("overlays-at", Foverlays_at, Soverlays_at, 1, 1, 0,
3788 doc: /* Return a list of the overlays that contain position POS. */)
3789 (pos)
3790 Lisp_Object pos;
3791 {
3792 int noverlays;
3793 Lisp_Object *overlay_vec;
3794 int len;
3795 Lisp_Object result;
3796
3797 CHECK_NUMBER_COERCE_MARKER (pos);
3798
3799 len = 10;
3800 /* We can't use alloca here because overlays_at can call xrealloc. */
3801 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
3802
3803 /* Put all the overlays we want in a vector in overlay_vec.
3804 Store the length in len. */
3805 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
3806 (int *) 0, (int *) 0, 0);
3807
3808 /* Make a list of them all. */
3809 result = Flist (noverlays, overlay_vec);
3810
3811 xfree (overlay_vec);
3812 return result;
3813 }
3814
3815 DEFUN ("overlays-in", Foverlays_in, Soverlays_in, 2, 2, 0,
3816 doc: /* Return a list of the overlays that overlap the region BEG ... END.
3817 Overlap means that at least one character is contained within the overlay
3818 and also contained within the specified region.
3819 Empty overlays are included in the result if they are located at BEG
3820 or between BEG and END. */)
3821 (beg, end)
3822 Lisp_Object beg, end;
3823 {
3824 int noverlays;
3825 Lisp_Object *overlay_vec;
3826 int len;
3827 Lisp_Object result;
3828
3829 CHECK_NUMBER_COERCE_MARKER (beg);
3830 CHECK_NUMBER_COERCE_MARKER (end);
3831
3832 len = 10;
3833 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
3834
3835 /* Put all the overlays we want in a vector in overlay_vec.
3836 Store the length in len. */
3837 noverlays = overlays_in (XINT (beg), XINT (end), 1, &overlay_vec, &len,
3838 (int *) 0, (int *) 0);
3839
3840 /* Make a list of them all. */
3841 result = Flist (noverlays, overlay_vec);
3842
3843 xfree (overlay_vec);
3844 return result;
3845 }
3846
3847 DEFUN ("next-overlay-change", Fnext_overlay_change, Snext_overlay_change,
3848 1, 1, 0,
3849 doc: /* Return the next position after POS where an overlay starts or ends.
3850 If there are no more overlay boundaries after POS, return (point-max). */)
3851 (pos)
3852 Lisp_Object pos;
3853 {
3854 int noverlays;
3855 int endpos;
3856 Lisp_Object *overlay_vec;
3857 int len;
3858 int i;
3859
3860 CHECK_NUMBER_COERCE_MARKER (pos);
3861
3862 len = 10;
3863 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
3864
3865 /* Put all the overlays we want in a vector in overlay_vec.
3866 Store the length in len.
3867 endpos gets the position where the next overlay starts. */
3868 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
3869 &endpos, (int *) 0, 1);
3870
3871 /* If any of these overlays ends before endpos,
3872 use its ending point instead. */
3873 for (i = 0; i < noverlays; i++)
3874 {
3875 Lisp_Object oend;
3876 int oendpos;
3877
3878 oend = OVERLAY_END (overlay_vec[i]);
3879 oendpos = OVERLAY_POSITION (oend);
3880 if (oendpos < endpos)
3881 endpos = oendpos;
3882 }
3883
3884 xfree (overlay_vec);
3885 return make_number (endpos);
3886 }
3887
3888 DEFUN ("previous-overlay-change", Fprevious_overlay_change,
3889 Sprevious_overlay_change, 1, 1, 0,
3890 doc: /* Return the previous position before POS where an overlay starts or ends.
3891 If there are no more overlay boundaries before POS, return (point-min). */)
3892 (pos)
3893 Lisp_Object pos;
3894 {
3895 int noverlays;
3896 int prevpos;
3897 Lisp_Object *overlay_vec;
3898 int len;
3899
3900 CHECK_NUMBER_COERCE_MARKER (pos);
3901
3902 /* At beginning of buffer, we know the answer;
3903 avoid bug subtracting 1 below. */
3904 if (XINT (pos) == BEGV)
3905 return pos;
3906
3907 len = 10;
3908 overlay_vec = (Lisp_Object *) xmalloc (len * sizeof (Lisp_Object));
3909
3910 /* Put all the overlays we want in a vector in overlay_vec.
3911 Store the length in len.
3912 prevpos gets the position of the previous change. */
3913 noverlays = overlays_at (XINT (pos), 1, &overlay_vec, &len,
3914 (int *) 0, &prevpos, 1);
3915
3916 xfree (overlay_vec);
3917 return make_number (prevpos);
3918 }
3919 \f
3920 /* These functions are for debugging overlays. */
3921
3922 DEFUN ("overlay-lists", Foverlay_lists, Soverlay_lists, 0, 0, 0,
3923 doc: /* Return a pair of lists giving all the overlays of the current buffer.
3924 The car has all the overlays before the overlay center;
3925 the cdr has all the overlays after the overlay center.
3926 Recentering overlays moves overlays between these lists.
3927 The lists you get are copies, so that changing them has no effect.
3928 However, the overlays you get are the real objects that the buffer uses. */)
3929 ()
3930 {
3931 Lisp_Object before, after;
3932 before = current_buffer->overlays_before;
3933 if (CONSP (before))
3934 before = Fcopy_sequence (before);
3935 after = current_buffer->overlays_after;
3936 if (CONSP (after))
3937 after = Fcopy_sequence (after);
3938
3939 return Fcons (before, after);
3940 }
3941
3942 DEFUN ("overlay-recenter", Foverlay_recenter, Soverlay_recenter, 1, 1, 0,
3943 doc: /* Recenter the overlays of the current buffer around position POS.
3944 That makes overlay lookup faster for positions near POS (but perhaps slower
3945 for positions far away from POS). */)
3946 (pos)
3947 Lisp_Object pos;
3948 {
3949 CHECK_NUMBER_COERCE_MARKER (pos);
3950
3951 recenter_overlay_lists (current_buffer, XINT (pos));
3952 return Qnil;
3953 }
3954 \f
3955 DEFUN ("overlay-get", Foverlay_get, Soverlay_get, 2, 2, 0,
3956 doc: /* Get the property of overlay OVERLAY with property name PROP. */)
3957 (overlay, prop)
3958 Lisp_Object overlay, prop;
3959 {
3960 CHECK_OVERLAY (overlay);
3961 return lookup_char_property (XOVERLAY (overlay)->plist, prop, 0);
3962 }
3963
3964 DEFUN ("overlay-put", Foverlay_put, Soverlay_put, 3, 3, 0,
3965 doc: /* Set one property of overlay OVERLAY: give property PROP value VALUE. */)
3966 (overlay, prop, value)
3967 Lisp_Object overlay, prop, value;
3968 {
3969 Lisp_Object tail, buffer;
3970 int changed;
3971
3972 CHECK_OVERLAY (overlay);
3973
3974 buffer = Fmarker_buffer (OVERLAY_START (overlay));
3975
3976 for (tail = XOVERLAY (overlay)->plist;
3977 CONSP (tail) && CONSP (XCDR (tail));
3978 tail = XCDR (XCDR (tail)))
3979 if (EQ (XCAR (tail), prop))
3980 {
3981 changed = !EQ (XCAR (XCDR (tail)), value);
3982 XSETCAR (XCDR (tail), value);
3983 goto found;
3984 }
3985 /* It wasn't in the list, so add it to the front. */
3986 changed = !NILP (value);
3987 XOVERLAY (overlay)->plist
3988 = Fcons (prop, Fcons (value, XOVERLAY (overlay)->plist));
3989 found:
3990 if (! NILP (buffer))
3991 {
3992 if (changed)
3993 modify_overlay (XBUFFER (buffer),
3994 marker_position (OVERLAY_START (overlay)),
3995 marker_position (OVERLAY_END (overlay)));
3996 if (EQ (prop, Qevaporate) && ! NILP (value)
3997 && (OVERLAY_POSITION (OVERLAY_START (overlay))
3998 == OVERLAY_POSITION (OVERLAY_END (overlay))))
3999 Fdelete_overlay (overlay);
4000 }
4001 return value;
4002 }
4003 \f
4004 /* Subroutine of report_overlay_modification. */
4005
4006 /* Lisp vector holding overlay hook functions to call.
4007 Vector elements come in pairs.
4008 Each even-index element is a list of hook functions.
4009 The following odd-index element is the overlay they came from.
4010
4011 Before the buffer change, we fill in this vector
4012 as we call overlay hook functions.
4013 After the buffer change, we get the functions to call from this vector.
4014 This way we always call the same functions before and after the change. */
4015 static Lisp_Object last_overlay_modification_hooks;
4016
4017 /* Number of elements actually used in last_overlay_modification_hooks. */
4018 static int last_overlay_modification_hooks_used;
4019
4020 /* Add one functionlist/overlay pair
4021 to the end of last_overlay_modification_hooks. */
4022
4023 static void
4024 add_overlay_mod_hooklist (functionlist, overlay)
4025 Lisp_Object functionlist, overlay;
4026 {
4027 int oldsize = XVECTOR (last_overlay_modification_hooks)->size;
4028
4029 if (last_overlay_modification_hooks_used == oldsize)
4030 {
4031 Lisp_Object old;
4032 old = last_overlay_modification_hooks;
4033 last_overlay_modification_hooks
4034 = Fmake_vector (make_number (oldsize * 2), Qnil);
4035 bcopy (XVECTOR (old)->contents,
4036 XVECTOR (last_overlay_modification_hooks)->contents,
4037 sizeof (Lisp_Object) * oldsize);
4038 }
4039 XVECTOR (last_overlay_modification_hooks)->contents[last_overlay_modification_hooks_used++] = functionlist;
4040 XVECTOR (last_overlay_modification_hooks)->contents[last_overlay_modification_hooks_used++] = overlay;
4041 }
4042 \f
4043 /* Run the modification-hooks of overlays that include
4044 any part of the text in START to END.
4045 If this change is an insertion, also
4046 run the insert-before-hooks of overlay starting at END,
4047 and the insert-after-hooks of overlay ending at START.
4048
4049 This is called both before and after the modification.
4050 AFTER is nonzero when we call after the modification.
4051
4052 ARG1, ARG2, ARG3 are arguments to pass to the hook functions.
4053 When AFTER is nonzero, they are the start position,
4054 the position after the inserted new text,
4055 and the length of deleted or replaced old text. */
4056
4057 void
4058 report_overlay_modification (start, end, after, arg1, arg2, arg3)
4059 Lisp_Object start, end;
4060 int after;
4061 Lisp_Object arg1, arg2, arg3;
4062 {
4063 Lisp_Object prop, overlay, tail;
4064 /* 1 if this change is an insertion. */
4065 int insertion = (after ? XFASTINT (arg3) == 0 : EQ (start, end));
4066 int tail_copied;
4067 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
4068
4069 overlay = Qnil;
4070 tail = Qnil;
4071 GCPRO5 (overlay, tail, arg1, arg2, arg3);
4072
4073 if (after)
4074 {
4075 /* Call the functions recorded in last_overlay_modification_hooks
4076 rather than scanning the overlays again.
4077 First copy the vector contents, in case some of these hooks
4078 do subsequent modification of the buffer. */
4079 int size = last_overlay_modification_hooks_used;
4080 Lisp_Object *copy = (Lisp_Object *) alloca (size * sizeof (Lisp_Object));
4081 int i;
4082
4083 bcopy (XVECTOR (last_overlay_modification_hooks)->contents,
4084 copy, size * sizeof (Lisp_Object));
4085 gcpro1.var = copy;
4086 gcpro1.nvars = size;
4087
4088 for (i = 0; i < size;)
4089 {
4090 Lisp_Object prop, overlay;
4091 prop = copy[i++];
4092 overlay = copy[i++];
4093 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4094 }
4095 UNGCPRO;
4096 return;
4097 }
4098
4099 /* We are being called before a change.
4100 Scan the overlays to find the functions to call. */
4101 last_overlay_modification_hooks_used = 0;
4102 tail_copied = 0;
4103 for (tail = current_buffer->overlays_before;
4104 CONSP (tail);
4105 tail = XCDR (tail))
4106 {
4107 int startpos, endpos;
4108 Lisp_Object ostart, oend;
4109
4110 overlay = XCAR (tail);
4111
4112 ostart = OVERLAY_START (overlay);
4113 oend = OVERLAY_END (overlay);
4114 endpos = OVERLAY_POSITION (oend);
4115 if (XFASTINT (start) > endpos)
4116 break;
4117 startpos = OVERLAY_POSITION (ostart);
4118 if (insertion && (XFASTINT (start) == startpos
4119 || XFASTINT (end) == startpos))
4120 {
4121 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4122 if (!NILP (prop))
4123 {
4124 /* Copy TAIL in case the hook recenters the overlay lists. */
4125 if (!tail_copied)
4126 tail = Fcopy_sequence (tail);
4127 tail_copied = 1;
4128 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4129 }
4130 }
4131 if (insertion && (XFASTINT (start) == endpos
4132 || XFASTINT (end) == endpos))
4133 {
4134 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4135 if (!NILP (prop))
4136 {
4137 if (!tail_copied)
4138 tail = Fcopy_sequence (tail);
4139 tail_copied = 1;
4140 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4141 }
4142 }
4143 /* Test for intersecting intervals. This does the right thing
4144 for both insertion and deletion. */
4145 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4146 {
4147 prop = Foverlay_get (overlay, Qmodification_hooks);
4148 if (!NILP (prop))
4149 {
4150 if (!tail_copied)
4151 tail = Fcopy_sequence (tail);
4152 tail_copied = 1;
4153 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4154 }
4155 }
4156 }
4157
4158 tail_copied = 0;
4159 for (tail = current_buffer->overlays_after;
4160 CONSP (tail);
4161 tail = XCDR (tail))
4162 {
4163 int startpos, endpos;
4164 Lisp_Object ostart, oend;
4165
4166 overlay = XCAR (tail);
4167
4168 ostart = OVERLAY_START (overlay);
4169 oend = OVERLAY_END (overlay);
4170 startpos = OVERLAY_POSITION (ostart);
4171 endpos = OVERLAY_POSITION (oend);
4172 if (XFASTINT (end) < startpos)
4173 break;
4174 if (insertion && (XFASTINT (start) == startpos
4175 || XFASTINT (end) == startpos))
4176 {
4177 prop = Foverlay_get (overlay, Qinsert_in_front_hooks);
4178 if (!NILP (prop))
4179 {
4180 if (!tail_copied)
4181 tail = Fcopy_sequence (tail);
4182 tail_copied = 1;
4183 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4184 }
4185 }
4186 if (insertion && (XFASTINT (start) == endpos
4187 || XFASTINT (end) == endpos))
4188 {
4189 prop = Foverlay_get (overlay, Qinsert_behind_hooks);
4190 if (!NILP (prop))
4191 {
4192 if (!tail_copied)
4193 tail = Fcopy_sequence (tail);
4194 tail_copied = 1;
4195 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4196 }
4197 }
4198 /* Test for intersecting intervals. This does the right thing
4199 for both insertion and deletion. */
4200 if (XFASTINT (end) > startpos && XFASTINT (start) < endpos)
4201 {
4202 prop = Foverlay_get (overlay, Qmodification_hooks);
4203 if (!NILP (prop))
4204 {
4205 if (!tail_copied)
4206 tail = Fcopy_sequence (tail);
4207 tail_copied = 1;
4208 call_overlay_mod_hooks (prop, overlay, after, arg1, arg2, arg3);
4209 }
4210 }
4211 }
4212
4213 UNGCPRO;
4214 }
4215
4216 static void
4217 call_overlay_mod_hooks (list, overlay, after, arg1, arg2, arg3)
4218 Lisp_Object list, overlay;
4219 int after;
4220 Lisp_Object arg1, arg2, arg3;
4221 {
4222 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4223
4224 GCPRO4 (list, arg1, arg2, arg3);
4225 if (! after)
4226 add_overlay_mod_hooklist (list, overlay);
4227
4228 while (CONSP (list))
4229 {
4230 if (NILP (arg3))
4231 call4 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2);
4232 else
4233 call5 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2, arg3);
4234 list = XCDR (list);
4235 }
4236 UNGCPRO;
4237 }
4238
4239 /* Delete any zero-sized overlays at position POS, if the `evaporate'
4240 property is set. */
4241 void
4242 evaporate_overlays (pos)
4243 int pos;
4244 {
4245 Lisp_Object tail, overlay, hit_list;
4246
4247 hit_list = Qnil;
4248 if (pos <= XFASTINT (current_buffer->overlay_center))
4249 for (tail = current_buffer->overlays_before; CONSP (tail);
4250 tail = XCDR (tail))
4251 {
4252 int endpos;
4253 overlay = XCAR (tail);
4254 endpos = OVERLAY_POSITION (OVERLAY_END (overlay));
4255 if (endpos < pos)
4256 break;
4257 if (endpos == pos && OVERLAY_POSITION (OVERLAY_START (overlay)) == pos
4258 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4259 hit_list = Fcons (overlay, hit_list);
4260 }
4261 else
4262 for (tail = current_buffer->overlays_after; CONSP (tail);
4263 tail = XCDR (tail))
4264 {
4265 int startpos;
4266 overlay = XCAR (tail);
4267 startpos = OVERLAY_POSITION (OVERLAY_START (overlay));
4268 if (startpos > pos)
4269 break;
4270 if (startpos == pos && OVERLAY_POSITION (OVERLAY_END (overlay)) == pos
4271 && ! NILP (Foverlay_get (overlay, Qevaporate)))
4272 hit_list = Fcons (overlay, hit_list);
4273 }
4274 for (; CONSP (hit_list); hit_list = XCDR (hit_list))
4275 Fdelete_overlay (XCAR (hit_list));
4276 }
4277 \f
4278 /* Somebody has tried to store a value with an unacceptable type
4279 in the slot with offset OFFSET. */
4280
4281 void
4282 buffer_slot_type_mismatch (offset)
4283 int offset;
4284 {
4285 Lisp_Object sym;
4286 char *type_name;
4287
4288 switch (XINT (PER_BUFFER_TYPE (offset)))
4289 {
4290 case Lisp_Int:
4291 type_name = "integers";
4292 break;
4293
4294 case Lisp_String:
4295 type_name = "strings";
4296 break;
4297
4298 case Lisp_Symbol:
4299 type_name = "symbols";
4300 break;
4301
4302 default:
4303 abort ();
4304 }
4305
4306 sym = PER_BUFFER_SYMBOL (offset);
4307 error ("Only %s should be stored in the buffer-local variable %s",
4308 type_name, SDATA (SYMBOL_NAME (sym)));
4309 }
4310
4311 \f
4312 /***********************************************************************
4313 Allocation with mmap
4314 ***********************************************************************/
4315
4316 #ifdef USE_MMAP_FOR_BUFFERS
4317
4318 #include <sys/types.h>
4319 #include <sys/mman.h>
4320
4321 #ifndef MAP_ANON
4322 #ifdef MAP_ANONYMOUS
4323 #define MAP_ANON MAP_ANONYMOUS
4324 #else
4325 #define MAP_ANON 0
4326 #endif
4327 #endif
4328
4329 #ifndef MAP_FAILED
4330 #define MAP_FAILED ((void *) -1)
4331 #endif
4332
4333 #include <stdio.h>
4334 #include <errno.h>
4335
4336 #if MAP_ANON == 0
4337 #include <fcntl.h>
4338 #endif
4339
4340 #include "coding.h"
4341
4342
4343 /* Memory is allocated in regions which are mapped using mmap(2).
4344 The current implementation lets the system select mapped
4345 addresses; we're not using MAP_FIXED in general, except when
4346 trying to enlarge regions.
4347
4348 Each mapped region starts with a mmap_region structure, the user
4349 area starts after that structure, aligned to MEM_ALIGN.
4350
4351 +-----------------------+
4352 | struct mmap_info + |
4353 | padding |
4354 +-----------------------+
4355 | user data |
4356 | |
4357 | |
4358 +-----------------------+ */
4359
4360 struct mmap_region
4361 {
4362 /* User-specified size. */
4363 size_t nbytes_specified;
4364
4365 /* Number of bytes mapped */
4366 size_t nbytes_mapped;
4367
4368 /* Pointer to the location holding the address of the memory
4369 allocated with the mmap'd block. The variable actually points
4370 after this structure. */
4371 POINTER_TYPE **var;
4372
4373 /* Next and previous in list of all mmap'd regions. */
4374 struct mmap_region *next, *prev;
4375 };
4376
4377 /* Doubly-linked list of mmap'd regions. */
4378
4379 static struct mmap_region *mmap_regions;
4380
4381 /* File descriptor for mmap. If we don't have anonymous mapping,
4382 /dev/zero will be opened on it. */
4383
4384 static int mmap_fd;
4385
4386 /* Temporary storage for mmap_set_vars, see there. */
4387
4388 static struct mmap_region *mmap_regions_1;
4389 static int mmap_fd_1;
4390
4391 /* Page size on this system. */
4392
4393 static int mmap_page_size;
4394
4395 /* 1 means mmap has been intialized. */
4396
4397 static int mmap_initialized_p;
4398
4399 /* Value is X rounded up to the next multiple of N. */
4400
4401 #define ROUND(X, N) (((X) + (N) - 1) / (N) * (N))
4402
4403 /* Size of mmap_region structure plus padding. */
4404
4405 #define MMAP_REGION_STRUCT_SIZE \
4406 ROUND (sizeof (struct mmap_region), MEM_ALIGN)
4407
4408 /* Given a pointer P to the start of the user-visible part of a mapped
4409 region, return a pointer to the start of the region. */
4410
4411 #define MMAP_REGION(P) \
4412 ((struct mmap_region *) ((char *) (P) - MMAP_REGION_STRUCT_SIZE))
4413
4414 /* Given a pointer P to the start of a mapped region, return a pointer
4415 to the start of the user-visible part of the region. */
4416
4417 #define MMAP_USER_AREA(P) \
4418 ((POINTER_TYPE *) ((char *) (P) + MMAP_REGION_STRUCT_SIZE))
4419
4420 #define MEM_ALIGN sizeof (double)
4421
4422 /* Predicate returning true if part of the address range [START .. END]
4423 is currently mapped. Used to prevent overwriting an existing
4424 memory mapping.
4425
4426 Default is to conservativly assume the address range is occupied by
4427 something else. This can be overridden by system configuration
4428 files if system-specific means to determine this exists. */
4429
4430 #ifndef MMAP_ALLOCATED_P
4431 #define MMAP_ALLOCATED_P(start, end) 1
4432 #endif
4433
4434 /* Function prototypes. */
4435
4436 static int mmap_free_1 P_ ((struct mmap_region *));
4437 static int mmap_enlarge P_ ((struct mmap_region *, int));
4438 static struct mmap_region *mmap_find P_ ((POINTER_TYPE *, POINTER_TYPE *));
4439 static POINTER_TYPE *mmap_alloc P_ ((POINTER_TYPE **, size_t));
4440 static POINTER_TYPE *mmap_realloc P_ ((POINTER_TYPE **, size_t));
4441 static void mmap_free P_ ((POINTER_TYPE **ptr));
4442 static void mmap_init P_ ((void));
4443
4444
4445 /* Return a region overlapping address range START...END, or null if
4446 none. END is not including, i.e. the last byte in the range
4447 is at END - 1. */
4448
4449 static struct mmap_region *
4450 mmap_find (start, end)
4451 POINTER_TYPE *start, *end;
4452 {
4453 struct mmap_region *r;
4454 char *s = (char *) start, *e = (char *) end;
4455
4456 for (r = mmap_regions; r; r = r->next)
4457 {
4458 char *rstart = (char *) r;
4459 char *rend = rstart + r->nbytes_mapped;
4460
4461 if (/* First byte of range, i.e. START, in this region? */
4462 (s >= rstart && s < rend)
4463 /* Last byte of range, i.e. END - 1, in this region? */
4464 || (e > rstart && e <= rend)
4465 /* First byte of this region in the range? */
4466 || (rstart >= s && rstart < e)
4467 /* Last byte of this region in the range? */
4468 || (rend > s && rend <= e))
4469 break;
4470 }
4471
4472 return r;
4473 }
4474
4475
4476 /* Unmap a region. P is a pointer to the start of the user-araa of
4477 the region. Value is non-zero if successful. */
4478
4479 static int
4480 mmap_free_1 (r)
4481 struct mmap_region *r;
4482 {
4483 if (r->next)
4484 r->next->prev = r->prev;
4485 if (r->prev)
4486 r->prev->next = r->next;
4487 else
4488 mmap_regions = r->next;
4489
4490 if (munmap ((POINTER_TYPE *) r, r->nbytes_mapped) == -1)
4491 {
4492 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4493 return 0;
4494 }
4495
4496 return 1;
4497 }
4498
4499
4500 /* Enlarge region R by NPAGES pages. NPAGES < 0 means shrink R.
4501 Value is non-zero if successful. */
4502
4503 static int
4504 mmap_enlarge (r, npages)
4505 struct mmap_region *r;
4506 int npages;
4507 {
4508 char *region_end = (char *) r + r->nbytes_mapped;
4509 size_t nbytes;
4510 int success = 0;
4511
4512 if (npages < 0)
4513 {
4514 /* Unmap pages at the end of the region. */
4515 nbytes = - npages * mmap_page_size;
4516 if (munmap (region_end - nbytes, nbytes) == -1)
4517 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4518 else
4519 {
4520 r->nbytes_mapped -= nbytes;
4521 success = 1;
4522 }
4523 }
4524 else if (npages > 0)
4525 {
4526 nbytes = npages * mmap_page_size;
4527
4528 /* Try to map additional pages at the end of the region. We
4529 cannot do this if the address range is already occupied by
4530 something else because mmap deletes any previous mapping.
4531 I'm not sure this is worth doing, let's see. */
4532 if (!MMAP_ALLOCATED_P (region_end, region_end + nbytes))
4533 {
4534 POINTER_TYPE *p;
4535
4536 p = mmap (region_end, nbytes, PROT_READ | PROT_WRITE,
4537 MAP_ANON | MAP_PRIVATE | MAP_FIXED, mmap_fd, 0);
4538 if (p == MAP_FAILED)
4539 ; /* fprintf (stderr, "mmap: %s\n", emacs_strerror (errno)); */
4540 else if (p != (POINTER_TYPE *) region_end)
4541 {
4542 /* Kernels are free to choose a different address. In
4543 that case, unmap what we've mapped above; we have
4544 no use for it. */
4545 if (munmap (p, nbytes) == -1)
4546 fprintf (stderr, "munmap: %s\n", emacs_strerror (errno));
4547 }
4548 else
4549 {
4550 r->nbytes_mapped += nbytes;
4551 success = 1;
4552 }
4553 }
4554 }
4555
4556 return success;
4557 }
4558
4559
4560 /* Set or reset variables holding references to mapped regions. If
4561 RESTORE_P is zero, set all variables to null. If RESTORE_P is
4562 non-zero, set all variables to the start of the user-areas
4563 of mapped regions.
4564
4565 This function is called from Fdump_emacs to ensure that the dumped
4566 Emacs doesn't contain references to memory that won't be mapped
4567 when Emacs starts. */
4568
4569 void
4570 mmap_set_vars (restore_p)
4571 int restore_p;
4572 {
4573 struct mmap_region *r;
4574
4575 if (restore_p)
4576 {
4577 mmap_regions = mmap_regions_1;
4578 mmap_fd = mmap_fd_1;
4579 for (r = mmap_regions; r; r = r->next)
4580 *r->var = MMAP_USER_AREA (r);
4581 }
4582 else
4583 {
4584 for (r = mmap_regions; r; r = r->next)
4585 *r->var = NULL;
4586 mmap_regions_1 = mmap_regions;
4587 mmap_regions = NULL;
4588 mmap_fd_1 = mmap_fd;
4589 mmap_fd = -1;
4590 }
4591 }
4592
4593
4594 /* Allocate a block of storage large enough to hold NBYTES bytes of
4595 data. A pointer to the data is returned in *VAR. VAR is thus the
4596 address of some variable which will use the data area.
4597
4598 The allocation of 0 bytes is valid.
4599
4600 If we can't allocate the necessary memory, set *VAR to null, and
4601 return null. */
4602
4603 static POINTER_TYPE *
4604 mmap_alloc (var, nbytes)
4605 POINTER_TYPE **var;
4606 size_t nbytes;
4607 {
4608 void *p;
4609 size_t map;
4610
4611 mmap_init ();
4612
4613 map = ROUND (nbytes + MMAP_REGION_STRUCT_SIZE, mmap_page_size);
4614 p = mmap (NULL, map, PROT_READ | PROT_WRITE, MAP_ANON | MAP_PRIVATE,
4615 mmap_fd, 0);
4616
4617 if (p == MAP_FAILED)
4618 {
4619 if (errno != ENOMEM)
4620 fprintf (stderr, "mmap: %s\n", emacs_strerror (errno));
4621 p = NULL;
4622 }
4623 else
4624 {
4625 struct mmap_region *r = (struct mmap_region *) p;
4626
4627 r->nbytes_specified = nbytes;
4628 r->nbytes_mapped = map;
4629 r->var = var;
4630 r->prev = NULL;
4631 r->next = mmap_regions;
4632 if (r->next)
4633 r->next->prev = r;
4634 mmap_regions = r;
4635
4636 p = MMAP_USER_AREA (p);
4637 }
4638
4639 return *var = p;
4640 }
4641
4642
4643 /* Given a pointer at address VAR to data allocated with mmap_alloc,
4644 resize it to size NBYTES. Change *VAR to reflect the new block,
4645 and return this value. If more memory cannot be allocated, then
4646 leave *VAR unchanged, and return null. */
4647
4648 static POINTER_TYPE *
4649 mmap_realloc (var, nbytes)
4650 POINTER_TYPE **var;
4651 size_t nbytes;
4652 {
4653 POINTER_TYPE *result;
4654
4655 mmap_init ();
4656
4657 if (*var == NULL)
4658 result = mmap_alloc (var, nbytes);
4659 else if (nbytes == 0)
4660 {
4661 mmap_free (var);
4662 result = mmap_alloc (var, nbytes);
4663 }
4664 else
4665 {
4666 struct mmap_region *r = MMAP_REGION (*var);
4667 size_t room = r->nbytes_mapped - MMAP_REGION_STRUCT_SIZE;
4668
4669 if (room < nbytes)
4670 {
4671 /* Must enlarge. */
4672 POINTER_TYPE *old_ptr = *var;
4673
4674 /* Try to map additional pages at the end of the region.
4675 If that fails, allocate a new region, copy data
4676 from the old region, then free it. */
4677 if (mmap_enlarge (r, (ROUND (nbytes - room, mmap_page_size)
4678 / mmap_page_size)))
4679 {
4680 r->nbytes_specified = nbytes;
4681 *var = result = old_ptr;
4682 }
4683 else if (mmap_alloc (var, nbytes))
4684 {
4685 bcopy (old_ptr, *var, r->nbytes_specified);
4686 mmap_free_1 (MMAP_REGION (old_ptr));
4687 result = *var;
4688 r = MMAP_REGION (result);
4689 r->nbytes_specified = nbytes;
4690 }
4691 else
4692 {
4693 *var = old_ptr;
4694 result = NULL;
4695 }
4696 }
4697 else if (room - nbytes >= mmap_page_size)
4698 {
4699 /* Shrinking by at least a page. Let's give some
4700 memory back to the system.
4701
4702 The extra parens are to make the division happens first,
4703 on positive values, so we know it will round towards
4704 zero. */
4705 mmap_enlarge (r, - ((room - nbytes) / mmap_page_size));
4706 result = *var;
4707 r->nbytes_specified = nbytes;
4708 }
4709 else
4710 {
4711 /* Leave it alone. */
4712 result = *var;
4713 r->nbytes_specified = nbytes;
4714 }
4715 }
4716
4717 return result;
4718 }
4719
4720
4721 /* Free a block of relocatable storage whose data is pointed to by
4722 PTR. Store 0 in *PTR to show there's no block allocated. */
4723
4724 static void
4725 mmap_free (var)
4726 POINTER_TYPE **var;
4727 {
4728 mmap_init ();
4729
4730 if (*var)
4731 {
4732 mmap_free_1 (MMAP_REGION (*var));
4733 *var = NULL;
4734 }
4735 }
4736
4737
4738 /* Perform necessary intializations for the use of mmap. */
4739
4740 static void
4741 mmap_init ()
4742 {
4743 #if MAP_ANON == 0
4744 /* The value of mmap_fd is initially 0 in temacs, and -1
4745 in a dumped Emacs. */
4746 if (mmap_fd <= 0)
4747 {
4748 /* No anonymous mmap -- we need the file descriptor. */
4749 mmap_fd = open ("/dev/zero", O_RDONLY);
4750 if (mmap_fd == -1)
4751 fatal ("Cannot open /dev/zero: %s", emacs_strerror (errno));
4752 }
4753 #endif /* MAP_ANON == 0 */
4754
4755 if (mmap_initialized_p)
4756 return;
4757 mmap_initialized_p = 1;
4758
4759 #if MAP_ANON != 0
4760 mmap_fd = -1;
4761 #endif
4762
4763 mmap_page_size = getpagesize ();
4764 }
4765
4766 #endif /* USE_MMAP_FOR_BUFFERS */
4767
4768
4769 \f
4770 /***********************************************************************
4771 Buffer-text Allocation
4772 ***********************************************************************/
4773
4774 #ifdef REL_ALLOC
4775 extern POINTER_TYPE *r_alloc P_ ((POINTER_TYPE **, size_t));
4776 extern POINTER_TYPE *r_re_alloc P_ ((POINTER_TYPE **, size_t));
4777 extern void r_alloc_free P_ ((POINTER_TYPE **ptr));
4778 #endif /* REL_ALLOC */
4779
4780
4781 /* Allocate NBYTES bytes for buffer B's text buffer. */
4782
4783 static void
4784 alloc_buffer_text (b, nbytes)
4785 struct buffer *b;
4786 size_t nbytes;
4787 {
4788 POINTER_TYPE *p;
4789
4790 BLOCK_INPUT;
4791 #if defined USE_MMAP_FOR_BUFFERS
4792 p = mmap_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
4793 #elif defined REL_ALLOC
4794 p = r_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
4795 #else
4796 p = xmalloc (nbytes);
4797 #endif
4798
4799 if (p == NULL)
4800 {
4801 UNBLOCK_INPUT;
4802 memory_full ();
4803 }
4804
4805 b->text->beg = (unsigned char *) p;
4806 UNBLOCK_INPUT;
4807 }
4808
4809 /* Enlarge buffer B's text buffer by DELTA bytes. DELTA < 0 means
4810 shrink it. */
4811
4812 void
4813 enlarge_buffer_text (b, delta)
4814 struct buffer *b;
4815 int delta;
4816 {
4817 POINTER_TYPE *p;
4818 size_t nbytes = (BUF_Z_BYTE (b) - BUF_BEG_BYTE (b) + BUF_GAP_SIZE (b) + 1
4819 + delta);
4820 BLOCK_INPUT;
4821 #if defined USE_MMAP_FOR_BUFFERS
4822 p = mmap_realloc ((POINTER_TYPE **) &b->text->beg, nbytes);
4823 #elif defined REL_ALLOC
4824 p = r_re_alloc ((POINTER_TYPE **) &b->text->beg, nbytes);
4825 #else
4826 p = xrealloc (b->text->beg, nbytes);
4827 #endif
4828
4829 if (p == NULL)
4830 {
4831 UNBLOCK_INPUT;
4832 memory_full ();
4833 }
4834
4835 BUF_BEG_ADDR (b) = (unsigned char *) p;
4836 UNBLOCK_INPUT;
4837 }
4838
4839
4840 /* Free buffer B's text buffer. */
4841
4842 static void
4843 free_buffer_text (b)
4844 struct buffer *b;
4845 {
4846 BLOCK_INPUT;
4847
4848 #if defined USE_MMAP_FOR_BUFFERS
4849 mmap_free ((POINTER_TYPE **) &b->text->beg);
4850 #elif defined REL_ALLOC
4851 r_alloc_free ((POINTER_TYPE **) &b->text->beg);
4852 #else
4853 xfree (b->text->beg);
4854 #endif
4855
4856 BUF_BEG_ADDR (b) = NULL;
4857 UNBLOCK_INPUT;
4858 }
4859
4860
4861 \f
4862 /***********************************************************************
4863 Initialization
4864 ***********************************************************************/
4865
4866 void
4867 init_buffer_once ()
4868 {
4869 int idx;
4870
4871 bzero (buffer_permanent_local_flags, sizeof buffer_permanent_local_flags);
4872
4873 /* Make sure all markable slots in buffer_defaults
4874 are initialized reasonably, so mark_buffer won't choke. */
4875 reset_buffer (&buffer_defaults);
4876 reset_buffer_local_variables (&buffer_defaults, 1);
4877 reset_buffer (&buffer_local_symbols);
4878 reset_buffer_local_variables (&buffer_local_symbols, 1);
4879 /* Prevent GC from getting confused. */
4880 buffer_defaults.text = &buffer_defaults.own_text;
4881 buffer_local_symbols.text = &buffer_local_symbols.own_text;
4882 BUF_INTERVALS (&buffer_defaults) = 0;
4883 BUF_INTERVALS (&buffer_local_symbols) = 0;
4884 XSETBUFFER (Vbuffer_defaults, &buffer_defaults);
4885 XSETBUFFER (Vbuffer_local_symbols, &buffer_local_symbols);
4886
4887 /* Set up the default values of various buffer slots. */
4888 /* Must do these before making the first buffer! */
4889
4890 /* real setup is done in bindings.el */
4891 buffer_defaults.mode_line_format = build_string ("%-");
4892 buffer_defaults.header_line_format = Qnil;
4893 buffer_defaults.abbrev_mode = Qnil;
4894 buffer_defaults.overwrite_mode = Qnil;
4895 buffer_defaults.case_fold_search = Qt;
4896 buffer_defaults.auto_fill_function = Qnil;
4897 buffer_defaults.selective_display = Qnil;
4898 #ifndef old
4899 buffer_defaults.selective_display_ellipses = Qt;
4900 #endif
4901 buffer_defaults.abbrev_table = Qnil;
4902 buffer_defaults.display_table = Qnil;
4903 buffer_defaults.undo_list = Qnil;
4904 buffer_defaults.mark_active = Qnil;
4905 buffer_defaults.file_format = Qnil;
4906 buffer_defaults.overlays_before = Qnil;
4907 buffer_defaults.overlays_after = Qnil;
4908 XSETFASTINT (buffer_defaults.overlay_center, BEG);
4909
4910 XSETFASTINT (buffer_defaults.tab_width, 8);
4911 buffer_defaults.truncate_lines = Qnil;
4912 buffer_defaults.ctl_arrow = Qt;
4913 buffer_defaults.direction_reversed = Qnil;
4914 buffer_defaults.cursor_type = Qt;
4915 buffer_defaults.extra_line_spacing = Qnil;
4916
4917 #ifdef DOS_NT
4918 buffer_defaults.buffer_file_type = Qnil; /* TEXT */
4919 #endif
4920 buffer_defaults.enable_multibyte_characters = Qt;
4921 buffer_defaults.buffer_file_coding_system = Qnil;
4922 XSETFASTINT (buffer_defaults.fill_column, 70);
4923 XSETFASTINT (buffer_defaults.left_margin, 0);
4924 buffer_defaults.cache_long_line_scans = Qnil;
4925 buffer_defaults.file_truename = Qnil;
4926 XSETFASTINT (buffer_defaults.display_count, 0);
4927 XSETFASTINT (buffer_defaults.left_margin_cols, 0);
4928 XSETFASTINT (buffer_defaults.right_margin_cols, 0);
4929 buffer_defaults.left_fringe_width = Qnil;
4930 buffer_defaults.right_fringe_width = Qnil;
4931 buffer_defaults.fringes_outside_margins = Qnil;
4932 buffer_defaults.scroll_bar_width = Qnil;
4933 buffer_defaults.vertical_scroll_bar_type = Qt;
4934 buffer_defaults.indicate_empty_lines = Qnil;
4935 buffer_defaults.scroll_up_aggressively = Qnil;
4936 buffer_defaults.scroll_down_aggressively = Qnil;
4937 buffer_defaults.display_time = Qnil;
4938
4939 /* Assign the local-flags to the slots that have default values.
4940 The local flag is a bit that is used in the buffer
4941 to say that it has its own local value for the slot.
4942 The local flag bits are in the local_var_flags slot of the buffer. */
4943
4944 /* Nothing can work if this isn't true */
4945 if (sizeof (EMACS_INT) != sizeof (Lisp_Object)) abort ();
4946
4947 /* 0 means not a lisp var, -1 means always local, else mask */
4948 bzero (&buffer_local_flags, sizeof buffer_local_flags);
4949 XSETINT (buffer_local_flags.filename, -1);
4950 XSETINT (buffer_local_flags.directory, -1);
4951 XSETINT (buffer_local_flags.backed_up, -1);
4952 XSETINT (buffer_local_flags.save_length, -1);
4953 XSETINT (buffer_local_flags.auto_save_file_name, -1);
4954 XSETINT (buffer_local_flags.read_only, -1);
4955 XSETINT (buffer_local_flags.major_mode, -1);
4956 XSETINT (buffer_local_flags.mode_name, -1);
4957 XSETINT (buffer_local_flags.undo_list, -1);
4958 XSETINT (buffer_local_flags.mark_active, -1);
4959 XSETINT (buffer_local_flags.point_before_scroll, -1);
4960 XSETINT (buffer_local_flags.file_truename, -1);
4961 XSETINT (buffer_local_flags.invisibility_spec, -1);
4962 XSETINT (buffer_local_flags.file_format, -1);
4963 XSETINT (buffer_local_flags.display_count, -1);
4964 XSETINT (buffer_local_flags.display_time, -1);
4965 XSETINT (buffer_local_flags.enable_multibyte_characters, -1);
4966
4967 idx = 1;
4968 XSETFASTINT (buffer_local_flags.mode_line_format, idx); ++idx;
4969 XSETFASTINT (buffer_local_flags.abbrev_mode, idx); ++idx;
4970 XSETFASTINT (buffer_local_flags.overwrite_mode, idx); ++idx;
4971 XSETFASTINT (buffer_local_flags.case_fold_search, idx); ++idx;
4972 XSETFASTINT (buffer_local_flags.auto_fill_function, idx); ++idx;
4973 XSETFASTINT (buffer_local_flags.selective_display, idx); ++idx;
4974 #ifndef old
4975 XSETFASTINT (buffer_local_flags.selective_display_ellipses, idx); ++idx;
4976 #endif
4977 XSETFASTINT (buffer_local_flags.tab_width, idx); ++idx;
4978 XSETFASTINT (buffer_local_flags.truncate_lines, idx); ++idx;
4979 XSETFASTINT (buffer_local_flags.ctl_arrow, idx); ++idx;
4980 XSETFASTINT (buffer_local_flags.fill_column, idx); ++idx;
4981 XSETFASTINT (buffer_local_flags.left_margin, idx); ++idx;
4982 XSETFASTINT (buffer_local_flags.abbrev_table, idx); ++idx;
4983 XSETFASTINT (buffer_local_flags.display_table, idx); ++idx;
4984 #ifdef DOS_NT
4985 XSETFASTINT (buffer_local_flags.buffer_file_type, idx);
4986 /* Make this one a permanent local. */
4987 buffer_permanent_local_flags[idx++] = 1;
4988 #endif
4989 XSETFASTINT (buffer_local_flags.syntax_table, idx); ++idx;
4990 XSETFASTINT (buffer_local_flags.cache_long_line_scans, idx); ++idx;
4991 XSETFASTINT (buffer_local_flags.category_table, idx); ++idx;
4992 XSETFASTINT (buffer_local_flags.direction_reversed, idx); ++idx;
4993 XSETFASTINT (buffer_local_flags.buffer_file_coding_system, idx);
4994 /* Make this one a permanent local. */
4995 buffer_permanent_local_flags[idx++] = 1;
4996 XSETFASTINT (buffer_local_flags.left_margin_cols, idx); ++idx;
4997 XSETFASTINT (buffer_local_flags.right_margin_cols, idx); ++idx;
4998 XSETFASTINT (buffer_local_flags.left_fringe_width, idx); ++idx;
4999 XSETFASTINT (buffer_local_flags.right_fringe_width, idx); ++idx;
5000 XSETFASTINT (buffer_local_flags.fringes_outside_margins, idx); ++idx;
5001 XSETFASTINT (buffer_local_flags.scroll_bar_width, idx); ++idx;
5002 XSETFASTINT (buffer_local_flags.vertical_scroll_bar_type, idx); ++idx;
5003 XSETFASTINT (buffer_local_flags.indicate_empty_lines, idx); ++idx;
5004 XSETFASTINT (buffer_local_flags.scroll_up_aggressively, idx); ++idx;
5005 XSETFASTINT (buffer_local_flags.scroll_down_aggressively, idx); ++idx;
5006 XSETFASTINT (buffer_local_flags.header_line_format, idx); ++idx;
5007 XSETFASTINT (buffer_local_flags.cursor_type, idx); ++idx;
5008 XSETFASTINT (buffer_local_flags.extra_line_spacing, idx); ++idx;
5009
5010 /* Need more room? */
5011 if (idx >= MAX_PER_BUFFER_VARS)
5012 abort ();
5013 last_per_buffer_idx = idx;
5014
5015 Vbuffer_alist = Qnil;
5016 current_buffer = 0;
5017 all_buffers = 0;
5018
5019 QSFundamental = build_string ("Fundamental");
5020
5021 Qfundamental_mode = intern ("fundamental-mode");
5022 buffer_defaults.major_mode = Qfundamental_mode;
5023
5024 Qmode_class = intern ("mode-class");
5025
5026 Qprotected_field = intern ("protected-field");
5027
5028 Qpermanent_local = intern ("permanent-local");
5029
5030 Qkill_buffer_hook = intern ("kill-buffer-hook");
5031 Fput (Qkill_buffer_hook, Qpermanent_local, Qt);
5032
5033 Qucs_set_table_for_input = intern ("ucs-set-table-for-input");
5034
5035 Vprin1_to_string_buffer = Fget_buffer_create (build_string (" prin1"));
5036
5037 /* super-magic invisible buffer */
5038 Vbuffer_alist = Qnil;
5039
5040 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5041
5042 inhibit_modification_hooks = 0;
5043 }
5044
5045 void
5046 init_buffer ()
5047 {
5048 char buf[MAXPATHLEN + 1];
5049 char *pwd;
5050 struct stat dotstat, pwdstat;
5051 Lisp_Object temp;
5052 int rc;
5053
5054 #ifdef USE_MMAP_FOR_BUFFERS
5055 {
5056 /* When using the ralloc implementation based on mmap(2), buffer
5057 text pointers will have been set to null in the dumped Emacs.
5058 Map new memory. */
5059 struct buffer *b;
5060
5061 for (b = all_buffers; b; b = b->next)
5062 if (b->text->beg == NULL)
5063 enlarge_buffer_text (b, 0);
5064 }
5065 #endif /* USE_MMAP_FOR_BUFFERS */
5066
5067 Fset_buffer (Fget_buffer_create (build_string ("*scratch*")));
5068 if (NILP (buffer_defaults.enable_multibyte_characters))
5069 Fset_buffer_multibyte (Qnil);
5070
5071 /* If PWD is accurate, use it instead of calling getwd. PWD is
5072 sometimes a nicer name, and using it may avoid a fatal error if a
5073 parent directory is searchable but not readable. */
5074 if ((pwd = getenv ("PWD")) != 0
5075 && (IS_DIRECTORY_SEP (*pwd) || (*pwd && IS_DEVICE_SEP (pwd[1])))
5076 && stat (pwd, &pwdstat) == 0
5077 && stat (".", &dotstat) == 0
5078 && dotstat.st_ino == pwdstat.st_ino
5079 && dotstat.st_dev == pwdstat.st_dev
5080 && strlen (pwd) < MAXPATHLEN)
5081 strcpy (buf, pwd);
5082 #ifdef HAVE_GETCWD
5083 else if (getcwd (buf, MAXPATHLEN+1) == 0)
5084 fatal ("`getcwd' failed: %s\n", strerror (errno));
5085 #else
5086 else if (getwd (buf) == 0)
5087 fatal ("`getwd' failed: %s\n", buf);
5088 #endif
5089
5090 #ifndef VMS
5091 /* Maybe this should really use some standard subroutine
5092 whose definition is filename syntax dependent. */
5093 rc = strlen (buf);
5094 if (!(IS_DIRECTORY_SEP (buf[rc - 1])))
5095 {
5096 buf[rc] = DIRECTORY_SEP;
5097 buf[rc + 1] = '\0';
5098 }
5099 #endif /* not VMS */
5100
5101 current_buffer->directory = build_string (buf);
5102
5103 /* Add /: to the front of the name
5104 if it would otherwise be treated as magic. */
5105 temp = Ffind_file_name_handler (current_buffer->directory, Qt);
5106 if (! NILP (temp)
5107 /* If the default dir is just /, TEMP is non-nil
5108 because of the ange-ftp completion handler.
5109 However, it is not necessary to turn / into /:/.
5110 So avoid doing that. */
5111 && strcmp ("/", SDATA (current_buffer->directory)))
5112 current_buffer->directory
5113 = concat2 (build_string ("/:"), current_buffer->directory);
5114
5115 temp = get_minibuffer (0);
5116 XBUFFER (temp)->directory = current_buffer->directory;
5117 }
5118
5119 /* initialize the buffer routines */
5120 void
5121 syms_of_buffer ()
5122 {
5123 staticpro (&last_overlay_modification_hooks);
5124 last_overlay_modification_hooks
5125 = Fmake_vector (make_number (10), Qnil);
5126
5127 staticpro (&Vbuffer_defaults);
5128 staticpro (&Vbuffer_local_symbols);
5129 staticpro (&Qfundamental_mode);
5130 staticpro (&Qmode_class);
5131 staticpro (&QSFundamental);
5132 staticpro (&Vbuffer_alist);
5133 staticpro (&Qprotected_field);
5134 staticpro (&Qpermanent_local);
5135 staticpro (&Qkill_buffer_hook);
5136 Qoverlayp = intern ("overlayp");
5137 staticpro (&Qoverlayp);
5138 Qevaporate = intern ("evaporate");
5139 staticpro (&Qevaporate);
5140 Qmodification_hooks = intern ("modification-hooks");
5141 staticpro (&Qmodification_hooks);
5142 Qinsert_in_front_hooks = intern ("insert-in-front-hooks");
5143 staticpro (&Qinsert_in_front_hooks);
5144 Qinsert_behind_hooks = intern ("insert-behind-hooks");
5145 staticpro (&Qinsert_behind_hooks);
5146 Qget_file_buffer = intern ("get-file-buffer");
5147 staticpro (&Qget_file_buffer);
5148 Qpriority = intern ("priority");
5149 staticpro (&Qpriority);
5150 Qwindow = intern ("window");
5151 staticpro (&Qwindow);
5152 Qbefore_string = intern ("before-string");
5153 staticpro (&Qbefore_string);
5154 Qafter_string = intern ("after-string");
5155 staticpro (&Qafter_string);
5156 Qfirst_change_hook = intern ("first-change-hook");
5157 staticpro (&Qfirst_change_hook);
5158 Qbefore_change_functions = intern ("before-change-functions");
5159 staticpro (&Qbefore_change_functions);
5160 Qafter_change_functions = intern ("after-change-functions");
5161 staticpro (&Qafter_change_functions);
5162 staticpro (&Qucs_set_table_for_input);
5163
5164 Qkill_buffer_query_functions = intern ("kill-buffer-query-functions");
5165 staticpro (&Qkill_buffer_query_functions);
5166
5167 Fput (Qprotected_field, Qerror_conditions,
5168 Fcons (Qprotected_field, Fcons (Qerror, Qnil)));
5169 Fput (Qprotected_field, Qerror_message,
5170 build_string ("Attempt to modify a protected field"));
5171
5172 /* All these use DEFVAR_LISP_NOPRO because the slots in
5173 buffer_defaults will all be marked via Vbuffer_defaults. */
5174
5175 DEFVAR_LISP_NOPRO ("default-mode-line-format",
5176 &buffer_defaults.mode_line_format,
5177 doc: /* Default value of `mode-line-format' for buffers that don't override it.
5178 This is the same as (default-value 'mode-line-format). */);
5179
5180 DEFVAR_LISP_NOPRO ("default-header-line-format",
5181 &buffer_defaults.header_line_format,
5182 doc: /* Default value of `header-line-format' for buffers that don't override it.
5183 This is the same as (default-value 'header-line-format). */);
5184
5185 DEFVAR_LISP_NOPRO ("default-cursor-type", &buffer_defaults.cursor_type,
5186 doc: /* Default value of `cursor-type' for buffers that don't override it.
5187 This is the same as (default-value 'cursor-type). */);
5188
5189 DEFVAR_LISP_NOPRO ("default-line-spacing",
5190 &buffer_defaults.extra_line_spacing,
5191 doc: /* Default value of `line-spacing' for buffers that don't override it.
5192 This is the same as (default-value 'line-spacing). */);
5193
5194 DEFVAR_LISP_NOPRO ("default-abbrev-mode",
5195 &buffer_defaults.abbrev_mode,
5196 doc: /* Default value of `abbrev-mode' for buffers that do not override it.
5197 This is the same as (default-value 'abbrev-mode). */);
5198
5199 DEFVAR_LISP_NOPRO ("default-ctl-arrow",
5200 &buffer_defaults.ctl_arrow,
5201 doc: /* Default value of `ctl-arrow' for buffers that do not override it.
5202 This is the same as (default-value 'ctl-arrow). */);
5203
5204 DEFVAR_LISP_NOPRO ("default-direction-reversed",
5205 &buffer_defaults.direction_reversed,
5206 doc: /* Default value of `direction-reversed' for buffers that do not override it.
5207 This is the same as (default-value 'direction-reversed). */);
5208
5209 DEFVAR_LISP_NOPRO ("default-enable-multibyte-characters",
5210 &buffer_defaults.enable_multibyte_characters,
5211 doc: /* *Default value of `enable-multibyte-characters' for buffers not overriding it.
5212 This is the same as (default-value 'enable-multibyte-characters). */);
5213
5214 DEFVAR_LISP_NOPRO ("default-buffer-file-coding-system",
5215 &buffer_defaults.buffer_file_coding_system,
5216 doc: /* Default value of `buffer-file-coding-system' for buffers not overriding it.
5217 This is the same as (default-value 'buffer-file-coding-system). */);
5218
5219 DEFVAR_LISP_NOPRO ("default-truncate-lines",
5220 &buffer_defaults.truncate_lines,
5221 doc: /* Default value of `truncate-lines' for buffers that do not override it.
5222 This is the same as (default-value 'truncate-lines). */);
5223
5224 DEFVAR_LISP_NOPRO ("default-fill-column",
5225 &buffer_defaults.fill_column,
5226 doc: /* Default value of `fill-column' for buffers that do not override it.
5227 This is the same as (default-value 'fill-column). */);
5228
5229 DEFVAR_LISP_NOPRO ("default-left-margin",
5230 &buffer_defaults.left_margin,
5231 doc: /* Default value of `left-margin' for buffers that do not override it.
5232 This is the same as (default-value 'left-margin). */);
5233
5234 DEFVAR_LISP_NOPRO ("default-tab-width",
5235 &buffer_defaults.tab_width,
5236 doc: /* Default value of `tab-width' for buffers that do not override it.
5237 This is the same as (default-value 'tab-width). */);
5238
5239 DEFVAR_LISP_NOPRO ("default-case-fold-search",
5240 &buffer_defaults.case_fold_search,
5241 doc: /* Default value of `case-fold-search' for buffers that don't override it.
5242 This is the same as (default-value 'case-fold-search). */);
5243
5244 #ifdef DOS_NT
5245 DEFVAR_LISP_NOPRO ("default-buffer-file-type",
5246 &buffer_defaults.buffer_file_type,
5247 doc: /* Default file type for buffers that do not override it.
5248 This is the same as (default-value 'buffer-file-type).
5249 The file type is nil for text, t for binary. */);
5250 #endif
5251
5252 DEFVAR_LISP_NOPRO ("default-left-margin-width",
5253 &buffer_defaults.left_margin_cols,
5254 doc: /* Default value of `left-margin-width' for buffers that don't override it.
5255 This is the same as (default-value 'left-margin-width). */);
5256
5257 DEFVAR_LISP_NOPRO ("default-right-margin-width",
5258 &buffer_defaults.right_margin_cols,
5259 doc: /* Default value of `right-margin-width' for buffers that don't override it.
5260 This is the same as (default-value 'right-margin-width). */);
5261
5262 DEFVAR_LISP_NOPRO ("default-left-fringe-width",
5263 &buffer_defaults.left_fringe_width,
5264 doc: /* Default value of `left-fringe-width' for buffers that don't override it.
5265 This is the same as (default-value 'left-fringe-width). */);
5266
5267 DEFVAR_LISP_NOPRO ("default-right-fringe-width",
5268 &buffer_defaults.right_fringe_width,
5269 doc: /* Default value of `right-fringe-width' for buffers that don't override it.
5270 This is the same as (default-value 'right-fringe-width). */);
5271
5272 DEFVAR_LISP_NOPRO ("default-fringes-outside-margins",
5273 &buffer_defaults.fringes_outside_margins,
5274 doc: /* Default value of `fringes-outside-margins' for buffers that don't override it.
5275 This is the same as (default-value 'fringes-outside-margins). */);
5276
5277 DEFVAR_LISP_NOPRO ("default-scroll-bar-width",
5278 &buffer_defaults.scroll_bar_width,
5279 doc: /* Default value of `scroll-bar-width' for buffers that don't override it.
5280 This is the same as (default-value 'scroll-bar-width). */);
5281
5282 DEFVAR_LISP_NOPRO ("default-vertical-scroll-bar",
5283 &buffer_defaults.vertical_scroll_bar_type,
5284 doc: /* Default value of `vertical-scroll-bar' for buffers that don't override it.
5285 This is the same as (default-value 'vertical-scroll-bar). */);
5286
5287 DEFVAR_LISP_NOPRO ("default-indicate-empty-lines",
5288 &buffer_defaults.indicate_empty_lines,
5289 doc: /* Default value of `indicate-empty-lines' for buffers that don't override it.
5290 This is the same as (default-value 'indicate-empty-lines). */);
5291
5292 DEFVAR_LISP_NOPRO ("default-scroll-up-aggressively",
5293 &buffer_defaults.scroll_up_aggressively,
5294 doc: /* Default value of `scroll-up-aggressively'.
5295 This value applies in buffers that don't have their own local values.
5296 This variable is an alias for (default-value 'scroll-up-aggressively). */);
5297
5298 DEFVAR_LISP_NOPRO ("default-scroll-down-aggressively",
5299 &buffer_defaults.scroll_down_aggressively,
5300 doc: /* Default value of `scroll-down-aggressively'.
5301 This value applies in buffers that don't have their own local values.
5302 This variable is an alias for (default-value 'scroll-down-aggressively). */);
5303
5304 DEFVAR_PER_BUFFER ("header-line-format",
5305 &current_buffer->header_line_format,
5306 Qnil,
5307 doc: /* Analogous to `mode-line-format', but controls the header line.
5308 The header line appears, optionally, at the top of a window;
5309 the mode line appears at the bottom. */);
5310
5311 DEFVAR_PER_BUFFER ("mode-line-format", &current_buffer->mode_line_format,
5312 Qnil,
5313 doc: /* Template for displaying mode line for current buffer.
5314 Each buffer has its own value of this variable.
5315 Value may be nil, a string, a symbol or a list or cons cell.
5316 A value of nil means don't display a mode line.
5317 For a symbol, its value is used (but it is ignored if t or nil).
5318 A string appearing directly as the value of a symbol is processed verbatim
5319 in that the %-constructs below are not recognized.
5320 Note that unless the symbol is marked as a `risky-local-variable', all
5321 properties in any strings, as well as all :eval and :propertize forms
5322 in the value of that symbol will be ignored.
5323 For a list of the form `(:eval FORM)', FORM is evaluated and the result
5324 is used as a mode line element. Be careful--FORM should not load any files,
5325 because that can cause an infinite recursion.
5326 For a list of the form `(:propertize ELT PROPS...)', ELT is displayed
5327 with the specified properties PROPS applied.
5328 For a list whose car is a symbol, the symbol's value is taken,
5329 and if that is non-nil, the cadr of the list is processed recursively.
5330 Otherwise, the caddr of the list (if there is one) is processed.
5331 For a list whose car is a string or list, each element is processed
5332 recursively and the results are effectively concatenated.
5333 For a list whose car is an integer, the cdr of the list is processed
5334 and padded (if the number is positive) or truncated (if negative)
5335 to the width specified by that number.
5336 A string is printed verbatim in the mode line except for %-constructs:
5337 (%-constructs are allowed when the string is the entire mode-line-format
5338 or when it is found in a cons-cell or a list)
5339 %b -- print buffer name. %f -- print visited file name.
5340 %F -- print frame name.
5341 %* -- print %, * or hyphen. %+ -- print *, % or hyphen.
5342 %& is like %*, but ignore read-only-ness.
5343 % means buffer is read-only and * means it is modified.
5344 For a modified read-only buffer, %* gives % and %+ gives *.
5345 %s -- print process status. %l -- print the current line number.
5346 %c -- print the current column number (this makes editing slower).
5347 To make the column number update correctly in all cases,
5348 `column-number-mode' must be non-nil.
5349 %p -- print percent of buffer above top of window, or Top, Bot or All.
5350 %P -- print percent of buffer above bottom of window, perhaps plus Top,
5351 or print Bottom or All.
5352 %m -- print the mode name.
5353 %n -- print Narrow if appropriate.
5354 %z -- print mnemonics of buffer, terminal, and keyboard coding systems.
5355 %Z -- like %z, but including the end-of-line format.
5356 %[ -- print one [ for each recursive editing level. %] similar.
5357 %% -- print %. %- -- print infinitely many dashes.
5358 Decimal digits after the % specify field width to which to pad. */);
5359
5360 DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults.major_mode,
5361 doc: /* *Major mode for new buffers. Defaults to `fundamental-mode'.
5362 nil here means use current buffer's major mode. */);
5363
5364 DEFVAR_PER_BUFFER ("major-mode", &current_buffer->major_mode,
5365 make_number (Lisp_Symbol),
5366 doc: /* Symbol for current buffer's major mode. */);
5367
5368 DEFVAR_PER_BUFFER ("mode-name", &current_buffer->mode_name,
5369 Qnil,
5370 doc: /* Pretty name of current buffer's major mode (a string). */);
5371
5372 DEFVAR_PER_BUFFER ("abbrev-mode", &current_buffer->abbrev_mode, Qnil,
5373 doc: /* Non-nil turns on automatic expansion of abbrevs as they are inserted. */);
5374
5375 DEFVAR_PER_BUFFER ("case-fold-search", &current_buffer->case_fold_search,
5376 Qnil,
5377 doc: /* *Non-nil if searches and matches should ignore case. */);
5378
5379 DEFVAR_PER_BUFFER ("fill-column", &current_buffer->fill_column,
5380 make_number (Lisp_Int),
5381 doc: /* *Column beyond which automatic line-wrapping should happen.
5382 Interactively, you can set this using \\[set-fill-column]. */);
5383
5384 DEFVAR_PER_BUFFER ("left-margin", &current_buffer->left_margin,
5385 make_number (Lisp_Int),
5386 doc: /* *Column for the default indent-line-function to indent to.
5387 Linefeed indents to this column in Fundamental mode. */);
5388
5389 DEFVAR_PER_BUFFER ("tab-width", &current_buffer->tab_width,
5390 make_number (Lisp_Int),
5391 doc: /* *Distance between tab stops (for display of tab characters), in columns. */);
5392
5393 DEFVAR_PER_BUFFER ("ctl-arrow", &current_buffer->ctl_arrow, Qnil,
5394 doc: /* *Non-nil means display control chars with uparrow.
5395 A value of nil means use backslash and octal digits.
5396 This variable does not apply to characters whose display is specified
5397 in the current display table (if there is one). */);
5398
5399 DEFVAR_PER_BUFFER ("enable-multibyte-characters",
5400 &current_buffer->enable_multibyte_characters,
5401 Qnil,
5402 doc: /* Non-nil means the buffer contents are regarded as multi-byte characters.
5403 Otherwise they are regarded as unibyte. This affects the display,
5404 file I/O and the behavior of various editing commands.
5405
5406 This variable is buffer-local but you cannot set it directly;
5407 use the function `set-buffer-multibyte' to change a buffer's representation.
5408 Changing its default value with `setq-default' is supported.
5409 See also variable `default-enable-multibyte-characters' and Info node
5410 `(elisp)Text Representations'. */);
5411 XSYMBOL (intern ("enable-multibyte-characters"))->constant = 1;
5412
5413 DEFVAR_PER_BUFFER ("buffer-file-coding-system",
5414 &current_buffer->buffer_file_coding_system, Qnil,
5415 doc: /* Coding system to be used for encoding the buffer contents on saving.
5416 This variable applies to saving the buffer, and also to `write-region'
5417 and other functions that use `write-region'.
5418 It does not apply to sending output to subprocesses, however.
5419
5420 If this is nil, the buffer is saved without any code conversion
5421 unless some coding system is specified in `file-coding-system-alist'
5422 for the buffer file.
5423
5424 If the text to be saved cannot be encoded as specified by this variable,
5425 an alternative encoding is selected by `select-safe-coding-system', which see.
5426
5427 The variable `coding-system-for-write', if non-nil, overrides this variable.
5428
5429 This variable is never applied to a way of decoding a file while reading it. */);
5430
5431 DEFVAR_PER_BUFFER ("direction-reversed", &current_buffer->direction_reversed,
5432 Qnil,
5433 doc: /* *Non-nil means lines in the buffer are displayed right to left. */);
5434
5435 DEFVAR_PER_BUFFER ("truncate-lines", &current_buffer->truncate_lines, Qnil,
5436 doc: /* *Non-nil means do not display continuation lines.
5437 Instead, give each line of text just one screen line.
5438
5439 Note that this is overridden by the variable
5440 `truncate-partial-width-windows' if that variable is non-nil
5441 and this buffer is not full-frame width. */);
5442
5443 #ifdef DOS_NT
5444 DEFVAR_PER_BUFFER ("buffer-file-type", &current_buffer->buffer_file_type,
5445 Qnil,
5446 doc: /* Non-nil if the visited file is a binary file.
5447 This variable is meaningful on MS-DOG and Windows NT.
5448 On those systems, it is automatically local in every buffer.
5449 On other systems, this variable is normally always nil. */);
5450 #endif
5451
5452 DEFVAR_PER_BUFFER ("default-directory", &current_buffer->directory,
5453 make_number (Lisp_String),
5454 doc: /* Name of default directory of current buffer. Should end with slash.
5455 To interactively change the default directory, use command `cd'. */);
5456
5457 DEFVAR_PER_BUFFER ("auto-fill-function", &current_buffer->auto_fill_function,
5458 Qnil,
5459 doc: /* Function called (if non-nil) to perform auto-fill.
5460 It is called after self-inserting any character specified in
5461 the `auto-fill-chars' table.
5462 NOTE: This variable is not a hook;
5463 its value may not be a list of functions. */);
5464
5465 DEFVAR_PER_BUFFER ("buffer-file-name", &current_buffer->filename,
5466 make_number (Lisp_String),
5467 doc: /* Name of file visited in current buffer, or nil if not visiting a file. */);
5468
5469 DEFVAR_PER_BUFFER ("buffer-file-truename", &current_buffer->file_truename,
5470 make_number (Lisp_String),
5471 doc: /* Abbreviated truename of file visited in current buffer, or nil if none.
5472 The truename of a file is calculated by `file-truename'
5473 and then abbreviated with `abbreviate-file-name'. */);
5474
5475 DEFVAR_PER_BUFFER ("buffer-auto-save-file-name",
5476 &current_buffer->auto_save_file_name,
5477 make_number (Lisp_String),
5478 doc: /* Name of file for auto-saving current buffer.
5479 If it is nil, that means don't auto-save this buffer. */);
5480
5481 DEFVAR_PER_BUFFER ("buffer-read-only", &current_buffer->read_only, Qnil,
5482 doc: /* Non-nil if this buffer is read-only. */);
5483
5484 DEFVAR_PER_BUFFER ("buffer-backed-up", &current_buffer->backed_up, Qnil,
5485 doc: /* Non-nil if this buffer's file has been backed up.
5486 Backing up is done before the first time the file is saved. */);
5487
5488 DEFVAR_PER_BUFFER ("buffer-saved-size", &current_buffer->save_length,
5489 make_number (Lisp_Int),
5490 doc: /* Length of current buffer when last read in, saved or auto-saved.
5491 0 initially. */);
5492
5493 DEFVAR_PER_BUFFER ("selective-display", &current_buffer->selective_display,
5494 Qnil,
5495 doc: /* Non-nil enables selective display.
5496 An Integer N as value means display only lines
5497 that start with less than n columns of space.
5498 A value of t means that the character ^M makes itself and
5499 all the rest of the line invisible; also, when saving the buffer
5500 in a file, save the ^M as a newline. */);
5501
5502 #ifndef old
5503 DEFVAR_PER_BUFFER ("selective-display-ellipses",
5504 &current_buffer->selective_display_ellipses,
5505 Qnil,
5506 doc: /* Non-nil means display ... on previous line when a line is invisible. */);
5507 #endif
5508
5509 DEFVAR_PER_BUFFER ("overwrite-mode", &current_buffer->overwrite_mode, Qnil,
5510 doc: /* Non-nil if self-insertion should replace existing text.
5511 The value should be one of `overwrite-mode-textual',
5512 `overwrite-mode-binary', or nil.
5513 If it is `overwrite-mode-textual', self-insertion still
5514 inserts at the end of a line, and inserts when point is before a tab,
5515 until the tab is filled in.
5516 If `overwrite-mode-binary', self-insertion replaces newlines and tabs too. */);
5517
5518 DEFVAR_PER_BUFFER ("buffer-display-table", &current_buffer->display_table,
5519 Qnil,
5520 doc: /* Display table that controls display of the contents of current buffer.
5521
5522 If this variable is nil, the value of `standard-display-table' is used.
5523 Each window can have its own, overriding display table, see
5524 `set-window-display-table' and `window-display-table'.
5525
5526 The display table is a char-table created with `make-display-table'.
5527 A char-table is an array indexed by character codes. Normal array
5528 primitives `aref' and `aset' can be used to access elements of a char-table.
5529
5530 Each of the char-table elements control how to display the corresponding
5531 text character: the element at index C in the table says how to display
5532 the character whose code is C. Each element should be a vector of
5533 characters or nil. nil means display the character in the default fashion;
5534 otherwise, the characters from the vector are delivered to the screen
5535 instead of the original character.
5536
5537 For example, (aset buffer-display-table ?X ?Y) will cause Emacs to display
5538 a capital Y instead of each X character.
5539
5540 In addition, a char-table has six extra slots to control the display of:
5541
5542 the end of a truncated screen line (extra-slot 0, a single character);
5543 the end of a continued line (extra-slot 1, a single character);
5544 the escape character used to display character codes in octal
5545 (extra-slot 2, a single character);
5546 the character used as an arrow for control characters (extra-slot 3,
5547 a single character);
5548 the decoration indicating the presence of invisible lines (extra-slot 4,
5549 a vector of characters);
5550 the character used to draw the border between side-by-side windows
5551 (extra-slot 5, a single character).
5552
5553 See also the functions `display-table-slot' and `set-display-table-slot'. */);
5554
5555 DEFVAR_PER_BUFFER ("left-margin-width", &current_buffer->left_margin_cols,
5556 Qnil,
5557 doc: /* *Width of left marginal area for display of a buffer.
5558 A value of nil means no marginal area. */);
5559
5560 DEFVAR_PER_BUFFER ("right-margin-width", &current_buffer->right_margin_cols,
5561 Qnil,
5562 doc: /* *Width of right marginal area for display of a buffer.
5563 A value of nil means no marginal area. */);
5564
5565 DEFVAR_PER_BUFFER ("left-fringe-width", &current_buffer->left_fringe_width,
5566 Qnil,
5567 doc: /* *Width of this buffer's left fringe (in pixels).
5568 A value of 0 means no left fringe is shown in this buffer's window.
5569 A value of nil means to use the left fringe width from the window's frame. */);
5570
5571 DEFVAR_PER_BUFFER ("right-fringe-width", &current_buffer->right_fringe_width,
5572 Qnil,
5573 doc: /* *Width of this buffer's right fringe (in pixels).
5574 A value of 0 means no right fringe is shown in this buffer's window.
5575 A value of nil means to use the right fringe width from the window's frame. */);
5576
5577 DEFVAR_PER_BUFFER ("fringes-outside-margins", &current_buffer->fringes_outside_margins,
5578 Qnil,
5579 doc: /* *Non-nil means to display fringes outside display margins.
5580 A value of nil means to display fringes between margins and buffer text. */);
5581
5582 DEFVAR_PER_BUFFER ("scroll-bar-width", &current_buffer->scroll_bar_width,
5583 Qnil,
5584 doc: /* *Width of this buffer's scroll bars in pixels.
5585 A value of nil means to use the scroll bar width from the window's frame. */);
5586
5587 DEFVAR_PER_BUFFER ("vertical-scroll-bar", &current_buffer->vertical_scroll_bar_type,
5588 Qnil,
5589 doc: /* *Position of this buffer's vertical scroll bar.
5590 A value of left or right means to place the vertical scroll bar at that side
5591 of the window; a value of nil means that this window has no vertical scroll bar.
5592 A value of t means to use the vertical scroll bar type from the window's frame. */);
5593
5594 DEFVAR_PER_BUFFER ("indicate-empty-lines",
5595 &current_buffer->indicate_empty_lines, Qnil,
5596 doc: /* *Visually indicate empty lines after the buffer end.
5597 If non-nil, a bitmap is displayed in the left fringe of a window on
5598 window-systems. */);
5599
5600 DEFVAR_PER_BUFFER ("scroll-up-aggressively",
5601 &current_buffer->scroll_up_aggressively, Qnil,
5602 doc: /* How far to scroll windows upward.
5603 If you move point off the bottom, the window scrolls automatically.
5604 This variable controls how far it scrolls. nil, the default,
5605 means scroll to center point. A fraction means scroll to put point
5606 that fraction of the window's height from the bottom of the window.
5607 When the value is 0.0, point goes at the bottom line, which in the simple
5608 case that you moved off with C-f means scrolling just one line. 1.0 means
5609 point goes at the top, so that in that simple case, the window
5610 window scrolls by a full window height. Meaningful values are
5611 between 0.0 and 1.0, inclusive. */);
5612
5613 DEFVAR_PER_BUFFER ("scroll-down-aggressively",
5614 &current_buffer->scroll_down_aggressively, Qnil,
5615 doc: /* How far to scroll windows downward.
5616 If you move point off the top, the window scrolls automatically.
5617 This variable controls how far it scrolls. nil, the default,
5618 means scroll to center point. A fraction means scroll to put point
5619 that fraction of the window's height from the top of the window.
5620 When the value is 0.0, point goes at the top line, which in the simple
5621 case that you moved off with C-b means scrolling just one line. 1.0 means
5622 point goes at the bottom, so that in that simple case, the window
5623 window scrolls by a full window height. Meaningful values are
5624 between 0.0 and 1.0, inclusive. */);
5625
5626 /*DEFVAR_LISP ("debug-check-symbol", &Vcheck_symbol,
5627 "Don't ask.");
5628 */
5629
5630 DEFVAR_LISP ("before-change-functions", &Vbefore_change_functions,
5631 doc: /* List of functions to call before each text change.
5632 Two arguments are passed to each function: the positions of
5633 the beginning and end of the range of old text to be changed.
5634 \(For an insertion, the beginning and end are at the same place.)
5635 No information is given about the length of the text after the change.
5636
5637 Buffer changes made while executing the `before-change-functions'
5638 don't call any before-change or after-change functions.
5639 That's because these variables are temporarily set to nil.
5640 As a result, a hook function cannot straightforwardly alter the value of
5641 these variables. See the Emacs Lisp manual for a way of
5642 accomplishing an equivalent result by using other variables.
5643
5644 If an unhandled error happens in running these functions,
5645 the variable's value remains nil. That prevents the error
5646 from happening repeatedly and making Emacs nonfunctional. */);
5647 Vbefore_change_functions = Qnil;
5648
5649 DEFVAR_LISP ("after-change-functions", &Vafter_change_functions,
5650 doc: /* List of functions to call after each text change.
5651 Three arguments are passed to each function: the positions of
5652 the beginning and end of the range of changed text,
5653 and the length in bytes of the pre-change text replaced by that range.
5654 \(For an insertion, the pre-change length is zero;
5655 for a deletion, that length is the number of bytes deleted,
5656 and the post-change beginning and end are at the same place.)
5657
5658 Buffer changes made while executing the `after-change-functions'
5659 don't call any before-change or after-change functions.
5660 That's because these variables are temporarily set to nil.
5661 As a result, a hook function cannot straightforwardly alter the value of
5662 these variables. See the Emacs Lisp manual for a way of
5663 accomplishing an equivalent result by using other variables.
5664
5665 If an unhandled error happens in running these functions,
5666 the variable's value remains nil. That prevents the error
5667 from happening repeatedly and making Emacs nonfunctional. */);
5668 Vafter_change_functions = Qnil;
5669
5670 DEFVAR_LISP ("first-change-hook", &Vfirst_change_hook,
5671 doc: /* A list of functions to call before changing a buffer which is unmodified.
5672 The functions are run using the `run-hooks' function. */);
5673 Vfirst_change_hook = Qnil;
5674
5675 DEFVAR_PER_BUFFER ("buffer-undo-list", &current_buffer->undo_list, Qnil,
5676 doc: /* List of undo entries in current buffer.
5677 Recent changes come first; older changes follow newer.
5678
5679 An entry (BEG . END) represents an insertion which begins at
5680 position BEG and ends at position END.
5681
5682 An entry (TEXT . POSITION) represents the deletion of the string TEXT
5683 from (abs POSITION). If POSITION is positive, point was at the front
5684 of the text being deleted; if negative, point was at the end.
5685
5686 An entry (t HIGH . LOW) indicates that the buffer previously had
5687 \"unmodified\" status. HIGH and LOW are the high and low 16-bit portions
5688 of the visited file's modification time, as of that time. If the
5689 modification time of the most recent save is different, this entry is
5690 obsolete.
5691
5692 An entry (nil PROPERTY VALUE BEG . END) indicates that a text property
5693 was modified between BEG and END. PROPERTY is the property name,
5694 and VALUE is the old value.
5695
5696 An entry (MARKER . DISTANCE) indicates that the marker MARKER
5697 was adjusted in position by the offset DISTANCE (an integer).
5698
5699 An entry of the form POSITION indicates that point was at the buffer
5700 location given by the integer. Undoing an entry of this form places
5701 point at POSITION.
5702
5703 nil marks undo boundaries. The undo command treats the changes
5704 between two undo boundaries as a single step to be undone.
5705
5706 If the value of the variable is t, undo information is not recorded. */);
5707
5708 DEFVAR_PER_BUFFER ("mark-active", &current_buffer->mark_active, Qnil,
5709 doc: /* Non-nil means the mark and region are currently active in this buffer. */);
5710
5711 DEFVAR_PER_BUFFER ("cache-long-line-scans", &current_buffer->cache_long_line_scans, Qnil,
5712 doc: /* Non-nil means that Emacs should use caches to handle long lines more quickly.
5713
5714 Normally, the line-motion functions work by scanning the buffer for
5715 newlines. Columnar operations (like move-to-column and
5716 compute-motion) also work by scanning the buffer, summing character
5717 widths as they go. This works well for ordinary text, but if the
5718 buffer's lines are very long (say, more than 500 characters), these
5719 motion functions will take longer to execute. Emacs may also take
5720 longer to update the display.
5721
5722 If cache-long-line-scans is non-nil, these motion functions cache the
5723 results of their scans, and consult the cache to avoid rescanning
5724 regions of the buffer until the text is modified. The caches are most
5725 beneficial when they prevent the most searching---that is, when the
5726 buffer contains long lines and large regions of characters with the
5727 same, fixed screen width.
5728
5729 When cache-long-line-scans is non-nil, processing short lines will
5730 become slightly slower (because of the overhead of consulting the
5731 cache), and the caches will use memory roughly proportional to the
5732 number of newlines and characters whose screen width varies.
5733
5734 The caches require no explicit maintenance; their accuracy is
5735 maintained internally by the Emacs primitives. Enabling or disabling
5736 the cache should not affect the behavior of any of the motion
5737 functions; it should only affect their performance. */);
5738
5739 DEFVAR_PER_BUFFER ("point-before-scroll", &current_buffer->point_before_scroll, Qnil,
5740 doc: /* Value of point before the last series of scroll operations, or nil. */);
5741
5742 DEFVAR_PER_BUFFER ("buffer-file-format", &current_buffer->file_format, Qnil,
5743 doc: /* List of formats to use when saving this buffer.
5744 Formats are defined by `format-alist'. This variable is
5745 set when a file is visited. */);
5746
5747 DEFVAR_PER_BUFFER ("buffer-invisibility-spec",
5748 &current_buffer->invisibility_spec, Qnil,
5749 doc: /* Invisibility spec of this buffer.
5750 The default is t, which means that text is invisible
5751 if it has a non-nil `invisible' property.
5752 If the value is a list, a text character is invisible if its `invisible'
5753 property is an element in that list.
5754 If an element is a cons cell of the form (PROP . ELLIPSIS),
5755 then characters with property value PROP are invisible,
5756 and they have an ellipsis as well if ELLIPSIS is non-nil. */);
5757
5758 DEFVAR_PER_BUFFER ("buffer-display-count",
5759 &current_buffer->display_count, Qnil,
5760 doc: /* A number incremented each time this buffer is displayed in a window.
5761 The function `set-window-buffer' increments it. */);
5762
5763 DEFVAR_PER_BUFFER ("buffer-display-time",
5764 &current_buffer->display_time, Qnil,
5765 doc: /* Time stamp updated each time this buffer is displayed in a window.
5766 The function `set-window-buffer' updates this variable
5767 to the value obtained by calling `current-time'.
5768 If the buffer has never been shown in a window, the value is nil. */);
5769
5770 DEFVAR_LISP ("transient-mark-mode", &Vtransient_mark_mode,
5771 doc: /* *Non-nil means deactivate the mark when the buffer contents change.
5772 Non-nil also enables highlighting of the region whenever the mark is active.
5773 The variable `highlight-nonselected-windows' controls whether to highlight
5774 all windows or just the selected window. */);
5775 Vtransient_mark_mode = Qnil;
5776
5777 DEFVAR_LISP ("inhibit-read-only", &Vinhibit_read_only,
5778 doc: /* *Non-nil means disregard read-only status of buffers or characters.
5779 If the value is t, disregard `buffer-read-only' and all `read-only'
5780 text properties. If the value is a list, disregard `buffer-read-only'
5781 and disregard a `read-only' text property if the property value
5782 is a member of the list. */);
5783 Vinhibit_read_only = Qnil;
5784
5785 DEFVAR_PER_BUFFER ("cursor-type", &current_buffer->cursor_type, Qnil,
5786 doc: /* Cursor to use when this buffer is in the selected window.
5787 Values are interpreted as follows:
5788
5789 t use the cursor specified for the frame
5790 nil don't display a cursor
5791 bar display a bar cursor with default width
5792 (bar . WIDTH) display a bar cursor with width WIDTH
5793 ANYTHING ELSE display a box cursor.
5794
5795 When the buffer is displayed in a nonselected window,
5796 this variable has no effect; the cursor appears as a hollow box. */);
5797
5798 DEFVAR_PER_BUFFER ("line-spacing",
5799 &current_buffer->extra_line_spacing, Qnil,
5800 doc: /* Additional space to put between lines when displaying a buffer.
5801 The space is measured in pixels, and put below lines on window systems. */);
5802
5803 DEFVAR_LISP ("kill-buffer-query-functions", &Vkill_buffer_query_functions,
5804 doc: /* List of functions called with no args to query before killing a buffer. */);
5805 Vkill_buffer_query_functions = Qnil;
5806
5807 defsubr (&Sbuffer_live_p);
5808 defsubr (&Sbuffer_list);
5809 defsubr (&Sget_buffer);
5810 defsubr (&Sget_file_buffer);
5811 defsubr (&Sget_buffer_create);
5812 defsubr (&Smake_indirect_buffer);
5813 defsubr (&Sgenerate_new_buffer_name);
5814 defsubr (&Sbuffer_name);
5815 /*defsubr (&Sbuffer_number);*/
5816 defsubr (&Sbuffer_file_name);
5817 defsubr (&Sbuffer_base_buffer);
5818 defsubr (&Sbuffer_local_value);
5819 defsubr (&Sbuffer_local_variables);
5820 defsubr (&Sbuffer_modified_p);
5821 defsubr (&Sset_buffer_modified_p);
5822 defsubr (&Sbuffer_modified_tick);
5823 defsubr (&Srename_buffer);
5824 defsubr (&Sother_buffer);
5825 defsubr (&Sbuffer_disable_undo);
5826 defsubr (&Sbuffer_enable_undo);
5827 defsubr (&Skill_buffer);
5828 defsubr (&Sset_buffer_major_mode);
5829 defsubr (&Sswitch_to_buffer);
5830 defsubr (&Spop_to_buffer);
5831 defsubr (&Scurrent_buffer);
5832 defsubr (&Sset_buffer);
5833 defsubr (&Sbarf_if_buffer_read_only);
5834 defsubr (&Sbury_buffer);
5835 defsubr (&Serase_buffer);
5836 defsubr (&Sset_buffer_multibyte);
5837 defsubr (&Skill_all_local_variables);
5838
5839 defsubr (&Soverlayp);
5840 defsubr (&Smake_overlay);
5841 defsubr (&Sdelete_overlay);
5842 defsubr (&Smove_overlay);
5843 defsubr (&Soverlay_start);
5844 defsubr (&Soverlay_end);
5845 defsubr (&Soverlay_buffer);
5846 defsubr (&Soverlay_properties);
5847 defsubr (&Soverlays_at);
5848 defsubr (&Soverlays_in);
5849 defsubr (&Snext_overlay_change);
5850 defsubr (&Sprevious_overlay_change);
5851 defsubr (&Soverlay_recenter);
5852 defsubr (&Soverlay_lists);
5853 defsubr (&Soverlay_get);
5854 defsubr (&Soverlay_put);
5855 defsubr (&Srestore_buffer_modified_p);
5856 }
5857
5858 void
5859 keys_of_buffer ()
5860 {
5861 initial_define_key (control_x_map, 'b', "switch-to-buffer");
5862 initial_define_key (control_x_map, 'k', "kill-buffer");
5863
5864 /* This must not be in syms_of_buffer, because Qdisabled is not
5865 initialized when that function gets called. */
5866 Fput (intern ("erase-buffer"), Qdisabled, Qt);
5867 }