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