]> code.delx.au - gnu-emacs/blob - src/lisp.h
(GC_INTEGERP, etc): New type-test macros for use during GC.
[gnu-emacs] / src / lisp.h
1 /* Fundamental definitions for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985, 1986, 1987, 1993, 1994 Free Software Foundation, Inc.
3
4 This file is part of GNU Emacs.
5
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
10
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
19
20
21 /* These are default choices for the types to use. */
22 #ifndef EMACS_INT
23 #define EMACS_INT int
24 #endif
25 #ifndef EMACS_UINT
26 #define EMACS_UINT unsigned int
27 #endif
28
29 /* Define the fundamental Lisp data structures */
30
31 /* This is the set of Lisp data types */
32
33 enum Lisp_Type
34 {
35 /* Integer. XINT(obj) is the integer value. */
36 Lisp_Int,
37
38 /* Symbol. XSYMBOL (object) points to a struct Lisp_Symbol. */
39 Lisp_Symbol,
40
41 /* Miscellaneous. XMISC (object) points to a union Lisp_Misc,
42 whose first member indicates the subtype. */
43 Lisp_Misc,
44
45 /* String. XSTRING (object) points to a struct Lisp_String.
46 The length of the string, and its contents, are stored therein. */
47 Lisp_String,
48
49 /* Vector of Lisp objects. XVECTOR(object) points to a struct Lisp_Vector.
50 The length of the vector, and its contents, are stored therein. */
51 Lisp_Vector,
52
53 /* Cons. XCONS (object) points to a struct Lisp_Cons. */
54 Lisp_Cons,
55
56 /* Byte-compiled function. A vector of 4 to 6 elements which are the
57 arglist, bytecode-string, constant vector, stack size,
58 (optional) doc string, and (optional) interactive spec. */
59 Lisp_Compiled,
60
61 /* Editor buffer. XBUFFER(obj) points to a struct buffer. */
62 Lisp_Buffer,
63
64 /* Built-in function. XSUBR(obj) points to a struct Lisp_Subr
65 which describes how to call the function, and its documentation,
66 as well as pointing to the code. */
67 Lisp_Subr,
68
69 /* Object describing a connection to a subprocess.
70 It points to storage of type struct Lisp_Process */
71 Lisp_Process,
72
73 #ifdef MULTI_FRAME
74 /* Pointer to a vector-like object describing a display frame
75 on which Emacs can display a window hierarchy. We don't define
76 this unless MULTI_FRAME is defined; this helps the compiler catch
77 code that won't work on a non-MULTI_FRAME configuration. */
78 Lisp_Frame,
79 #endif
80
81 /* Window used for Emacs display.
82 Data inside looks like a Lisp_Vector. */
83 Lisp_Window,
84
85 /* Used by save,set,restore-window-configuration */
86 Lisp_Window_Configuration,
87
88 #ifdef LISP_FLOAT_TYPE
89 Lisp_Float,
90 #endif /* LISP_FLOAT_TYPE */
91 };
92
93 /* This is the set of datatypes that share a common structure.
94 The first member of the structure is a type code from this set. */
95 enum Lisp_Misc_Type
96 {
97 Lisp_Misc_Free,
98 Lisp_Misc_Marker,
99 Lisp_Misc_Intfwd,
100 Lisp_Misc_Boolfwd,
101 Lisp_Misc_Objfwd,
102 Lisp_Misc_Buffer_Objfwd,
103 Lisp_Misc_Buffer_Local_Value,
104 Lisp_Misc_Some_Buffer_Local_Value,
105 Lisp_Misc_Overlay
106 };
107
108 #ifndef NO_UNION_TYPE
109
110 #ifndef WORDS_BIG_ENDIAN
111
112 /* Definition of Lisp_Object for little-endian machines. */
113
114 typedef
115 union Lisp_Object
116 {
117 /* Used for comparing two Lisp_Objects;
118 also, positive integers can be accessed fast this way. */
119 int i;
120
121 struct
122 {
123 int val: 24;
124 char type;
125 } s;
126 struct
127 {
128 unsigned int val: 24;
129 char type;
130 } u;
131 struct
132 {
133 unsigned int val: 24;
134 enum Lisp_Type type: 7;
135 /* The markbit is not really part of the value of a Lisp_Object,
136 and is always zero except during garbage collection. */
137 unsigned int markbit: 1;
138 } gu;
139 }
140 Lisp_Object;
141
142 #else /* If WORDS_BIG_ENDIAN */
143
144 typedef
145 union Lisp_Object
146 {
147 /* Used for comparing two Lisp_Objects;
148 also, positive integers can be accessed fast this way. */
149 int i;
150
151 struct
152 {
153 char type;
154 int val: 24;
155 } s;
156 struct
157 {
158 char type;
159 unsigned int val: 24;
160 } u;
161 struct
162 {
163 /* The markbit is not really part of the value of a Lisp_Object,
164 and is always zero except during garbage collection. */
165 unsigned int markbit: 1;
166 enum Lisp_Type type: 7;
167 unsigned int val: 24;
168 } gu;
169 }
170 Lisp_Object;
171
172 #endif /* WORDS_BIG_ENDIAN */
173
174 #endif /* NO_UNION_TYPE */
175
176
177 /* If union type is not wanted, define Lisp_Object as just a number
178 and define the macros below to extract fields by shifting */
179
180 #ifdef NO_UNION_TYPE
181
182 #define Lisp_Object EMACS_INT
183
184 /* These values are overridden by the m- file on some machines. */
185 #ifndef VALBITS
186 #define VALBITS 24
187 #endif
188
189 #ifndef GCTYPEBITS
190 #define GCTYPEBITS 7
191 #endif
192
193 #ifndef VALMASK
194 #define VALMASK ((((EMACS_INT) 1)<<VALBITS) - 1)
195 #endif
196 #define GCTYPEMASK ((((EMACS_INT) 1)<<GCTYPEBITS) - 1)
197
198 /* Two flags that are set during GC. On some machines, these flags
199 are defined differently by the m- file. */
200
201 /* This is set in the car of a cons and in the plist slot of a symbol
202 to indicate it is marked. Likewise in the plist slot of an interval,
203 the chain slot of a marker, the type slot of a float, and the name
204 slot of a buffer.
205
206 In strings, this bit in the size field indicates that the string
207 is a "large" one, one which was separately malloc'd
208 rather than being part of a string block. */
209
210 #ifndef MARKBIT
211 #define MARKBIT (1 << (VALBITS + GCTYPEBITS))
212 #endif /*MARKBIT */
213
214 /* In the size word of a vector, this bit means the vector has been marked.
215 In the size word of a large string, likewise. */
216
217 #ifndef ARRAY_MARK_FLAG
218 #define ARRAY_MARK_FLAG ((MARKBIT >> 1) & ~MARKBIT)
219 #endif /* no ARRAY_MARK_FLAG */
220
221 #if ARRAY_MARK_FLAG == MARKBIT
222 you lose
223 #endif
224
225 #endif /* NO_UNION_TYPE */
226 \f
227 /* These macros extract various sorts of values from a Lisp_Object.
228 For example, if tem is a Lisp_Object whose type is Lisp_Cons,
229 XCONS (tem) is the struct Lisp_Cons * pointing to the memory for that cons. */
230
231 #ifdef NO_UNION_TYPE
232
233 /* One need to override this if there must be high bits set in data space
234 (doing the result of the below & ((1 << (GCTYPE + 1)) - 1) would work
235 on all machines, but would penalise machines which don't need it)
236 */
237 #ifndef XTYPE
238 #define XTYPE(a) ((enum Lisp_Type) ((a) >> VALBITS))
239 #endif
240
241 #ifndef XSETTYPE
242 #define XSETTYPE(a, b) ((a) = XUINT (a) | ((EMACS_INT)(b) << VALBITS))
243 #endif
244
245 /* For integers known to be positive, XFASTINT provides fast retrieval
246 and XSETFASTINT provides fast storage. This takes advantage of the
247 fact that Lisp_Int is 0. */
248 #define XFASTINT(a) ((a) + 0)
249 #define XSETFASTINT(a, b) ((a) = (b))
250
251 /* Extract the value of a Lisp_Object as a signed integer. */
252
253 #ifndef XINT /* Some machines need to do this differently. */
254 #define XINT(a) (((a) << (INTBITS-VALBITS)) >> (INTBITS-VALBITS))
255 #endif
256
257 /* Extract the value as an unsigned integer. This is a basis
258 for extracting it as a pointer to a structure in storage. */
259
260 #ifndef XUINT
261 #define XUINT(a) ((a) & VALMASK)
262 #endif
263
264 #ifndef XPNTR
265 #ifdef HAVE_SHM
266 /* In this representation, data is found in two widely separated segments. */
267 extern int pure_size;
268 #define XPNTR(a) \
269 (XUINT (a) | (XUINT (a) > pure_size ? DATA_SEG_BITS : PURE_SEG_BITS))
270 #else /* not HAVE_SHM */
271 #ifdef DATA_SEG_BITS
272 /* This case is used for the rt-pc.
273 In the diffs I was given, it checked for ptr = 0
274 and did not adjust it in that case.
275 But I don't think that zero should ever be found
276 in a Lisp object whose data type says it points to something. */
277 #define XPNTR(a) (XUINT (a) | DATA_SEG_BITS)
278 #else
279 #define XPNTR(a) XUINT (a)
280 #endif
281 #endif /* not HAVE_SHM */
282 #endif /* no XPNTR */
283
284 #ifndef XSET
285 #define XSET(var, type, ptr) \
286 ((var) = ((EMACS_INT)(type) << VALBITS) + ((EMACS_INT) (ptr) & VALMASK))
287 #endif
288
289 /* During garbage collection, XGCTYPE must be used for extracting types
290 so that the mark bit is ignored. XMARKBIT accesses the markbit.
291 Markbits are used only in particular slots of particular structure types.
292 Other markbits are always zero.
293 Outside of garbage collection, all mark bits are always zero. */
294
295 #ifndef XGCTYPE
296 #define XGCTYPE(a) ((enum Lisp_Type) (((a) >> VALBITS) & GCTYPEMASK))
297 #endif
298
299 #if VALBITS + GCTYPEBITS == INTBITS - 1
300 /* Make XMARKBIT faster if mark bit is sign bit. */
301 #ifndef XMARKBIT
302 #define XMARKBIT(a) ((a) < 0)
303 #endif
304 #endif /* markbit is sign bit */
305
306 #ifndef XMARKBIT
307 #define XMARKBIT(a) ((a) & MARKBIT)
308 #endif
309
310 #ifndef XSETMARKBIT
311 #define XSETMARKBIT(a,b) ((a) = ((a) & ~MARKBIT) | ((b) ? MARKBIT : 0))
312 #endif
313
314 #ifndef XMARK
315 #define XMARK(a) ((a) |= MARKBIT)
316 #endif
317
318 #ifndef XUNMARK
319 #define XUNMARK(a) ((a) &= ~MARKBIT)
320 #endif
321
322 #endif /* NO_UNION_TYPE */
323
324 #ifndef NO_UNION_TYPE
325
326 #define XTYPE(a) ((enum Lisp_Type) (a).u.type)
327 #define XSETTYPE(a, b) ((a).u.type = (char) (b))
328
329 /* For integers known to be positive, XFASTINT provides fast retrieval
330 and XSETFASTINT provides fast storage. This takes advantage of the
331 fact that Lisp_Int is 0. */
332 #define XFASTINT(a) ((a).i + 0)
333 #define XSETFASTINT(a, b) ((a).i = (b))
334
335 #ifdef EXPLICIT_SIGN_EXTEND
336 /* Make sure we sign-extend; compilers have been known to fail to do so. */
337 #define XINT(a) (((a).i << 8) >> 8)
338 #else
339 #define XINT(a) ((a).s.val)
340 #endif /* EXPLICIT_SIGN_EXTEND */
341
342 #define XUINT(a) ((a).u.val)
343 #define XPNTR(a) ((a).u.val)
344
345 #define XSET(var, vartype, ptr) \
346 (((var).s.type = ((char) (vartype))), ((var).s.val = ((int) (ptr))))
347
348 /* During garbage collection, XGCTYPE must be used for extracting types
349 so that the mark bit is ignored. XMARKBIT access the markbit.
350 Markbits are used only in particular slots of particular structure types.
351 Other markbits are always zero.
352 Outside of garbage collection, all mark bits are always zero. */
353
354 #define XGCTYPE(a) ((a).gu.type)
355 #define XMARKBIT(a) ((a).gu.markbit)
356 #define XSETMARKBIT(a,b) (XMARKBIT(a) = (b))
357 #define XMARK(a) (XMARKBIT(a) = 1)
358 #define XUNMARK(a) (XMARKBIT(a) = 0)
359
360 #endif /* NO_UNION_TYPE */
361
362
363 #define XCONS(a) ((struct Lisp_Cons *) XPNTR(a))
364 #define XBUFFER(a) ((struct buffer *) XPNTR(a))
365 #define XVECTOR(a) ((struct Lisp_Vector *) XPNTR(a))
366 #define XSUBR(a) ((struct Lisp_Subr *) XPNTR(a))
367 #define XSTRING(a) ((struct Lisp_String *) XPNTR(a))
368 #define XSYMBOL(a) ((struct Lisp_Symbol *) XPNTR(a))
369 #define XMISC(a) ((union Lisp_Misc *) XPNTR(a))
370 #define XWINDOW(a) ((struct window *) XPNTR(a))
371 #define XPROCESS(a) ((struct Lisp_Process *) XPNTR(a))
372 #define XFLOAT(a) ((struct Lisp_Float *) XPNTR(a))
373 #define XMARKER(a) (&(XMISC(a)->u_marker))
374 #define XINTFWD(a) (&(XMISC(a)->u_intfwd))
375 #define XBOOLFWD(a) (&(XMISC(a)->u_boolfwd))
376 #define XOBJFWD(a) (&(XMISC(a)->u_objfwd))
377 #define XBUFFER_OBJFWD(a) (&(XMISC(a)->u_buffer_objfwd))
378 #define XBUFFER_LOCAL_VALUE(a) (&(XMISC(a)->u_buffer_local_value))
379 #define XOVERLAY(a) (&(XMISC(a)->u_overlay))
380
381 #define XSETINT(a, b) XSET (a, Lisp_Int, b)
382 #define XSETCONS(a, b) XSET (a, Lisp_Cons, b)
383 #define XSETBUFFER(a, b) XSET (a, Lisp_Buffer, b)
384 #define XSETVECTOR(a, b) XSET (a, Lisp_Vector, b)
385 #define XSETSUBR(a, b) XSET (a, Lisp_Subr, b)
386 #define XSETSTRING(a, b) XSET (a, Lisp_String, b)
387 #define XSETSYMBOL(a, b) XSET (a, Lisp_Symbol, b)
388 #define XSETMISC(a, b) XSET (a, Lisp_Misc, b)
389 #define XSETWINDOW(a, b) XSET (a, Lisp_Window, b)
390 #define XSETPROCESS(a, b) XSET (a, Lisp_Process, b)
391 #define XSETFLOAT(a, b) XSET (a, Lisp_Float, b)
392 #define XSETWINDOW_CONFIGURATION(a, b) XSET (a, Lisp_Window_Configuration, b)
393 #define XSETMARKER(a, b) (XSETMISC (a, b), XMISC (a)->type = Lisp_Misc_Marker)
394 \f
395 #ifdef USE_TEXT_PROPERTIES
396 /* Basic data type for use of intervals. See the macros in intervals.h */
397
398 struct interval
399 {
400 /* The first group of entries deal with the tree structure. */
401
402 unsigned int total_length; /* Length of myself and both children. */
403 unsigned int position; /* Cache of interval's character position */
404 struct interval *left; /* Intervals which precede me. */
405 struct interval *right; /* Intervals which succeed me. */
406
407 /* Parent in the tree, or the Lisp_Object containing this interval tree.
408
409 The mark bit on the root interval of an interval tree says
410 whether we have started (and possibly finished) marking the
411 tree. If GC comes across an interval tree whose root's parent
412 field has its markbit set, it leaves the tree alone.
413
414 You'd think we could store this information in the parent object
415 somewhere (after all, that should be visited once and then
416 ignored too, right?), but strings are GC'd strangely. */
417 struct interval *parent;
418
419 /* The remaining components are `properties' of the interval.
420 The first four are duplicates for things which can be on the list,
421 for purposes of speed. */
422
423 unsigned char write_protect; /* Non-zero means can't modify. */
424 unsigned char visible; /* Zero means don't display. */
425 unsigned char front_sticky; /* Non-zero means text inserted just
426 before this interval goes into it. */
427 unsigned char rear_sticky; /* Likewise for just after it. */
428
429 /* Properties of this interval.
430 The mark bit on this field says whether this particular interval
431 tree node has been visited. Since intervals should never be
432 shared, GC aborts if it seems to have visited an interval twice. */
433 Lisp_Object plist;
434 };
435
436 typedef struct interval *INTERVAL;
437
438 /* Complain if object is not string or buffer type */
439 #define CHECK_STRING_OR_BUFFER(x, i) \
440 { if (!STRINGP ((x)) && !BUFFERP ((x))) \
441 x = wrong_type_argument (Qbuffer_or_string_p, (x)); }
442
443 /* Macro used to conditionally compile intervals into certain data
444 structures. See, e.g., struct Lisp_String below. */
445 #define DECLARE_INTERVALS INTERVAL intervals;
446
447 /* Macro used to conditionally compile interval initialization into
448 certain code. See, e.g., alloc.c. */
449 #define INITIALIZE_INTERVAL(ptr,val) ptr->intervals = val
450
451 #else /* No text properties */
452
453 /* If no intervals are used, make the above definitions go away. */
454
455 #define CHECK_STRING_OR_BUFFER(x, i)
456
457 #define INTERVAL
458 #define DECLARE_INTERVALS
459 #define INITIALIZE_INTERVAL(ptr,val)
460
461 #endif /* USE_TEXT_PROPERTIES */
462 \f
463 /* In a cons, the markbit of the car is the gc mark bit */
464
465 struct Lisp_Cons
466 {
467 Lisp_Object car, cdr;
468 };
469
470 /* Like a cons, but records info on where the text lives that it was read from */
471 /* This is not really in use now */
472
473 struct Lisp_Buffer_Cons
474 {
475 Lisp_Object car, cdr;
476 struct buffer *buffer;
477 int bufpos;
478 };
479
480 /* In a string or vector, the sign bit of the `size' is the gc mark bit */
481
482 struct Lisp_String
483 {
484 EMACS_INT size;
485 DECLARE_INTERVALS /* `data' field must be last. */
486 unsigned char data[1];
487 };
488
489 struct Lisp_Vector
490 {
491 EMACS_INT size;
492 struct Lisp_Vector *next;
493 Lisp_Object contents[1];
494 };
495
496 /* In a symbol, the markbit of the plist is used as the gc mark bit */
497
498 struct Lisp_Symbol
499 {
500 struct Lisp_String *name;
501 Lisp_Object value;
502 Lisp_Object function;
503 Lisp_Object plist;
504 struct Lisp_Symbol *next; /* -> next symbol in this obarray bucket */
505 };
506
507 struct Lisp_Subr
508 {
509 Lisp_Object (*function) ();
510 short min_args, max_args;
511 char *symbol_name;
512 char *prompt;
513 char *doc;
514 };
515 \f
516 /* A miscellaneous object, when it's on the free list. */
517 struct Lisp_Free
518 {
519 enum Lisp_Misc_Type type; /* = Lisp_Misc_Free */
520 union Lisp_Misc *chain;
521 };
522
523 /* In a marker, the markbit of the chain field is used as the gc mark bit */
524 struct Lisp_Marker
525 {
526 enum Lisp_Misc_Type type; /* = Lisp_Misc_Marker */
527 struct buffer *buffer;
528 Lisp_Object chain;
529 int bufpos;
530 };
531
532 /* Forwarding pointer to an int variable.
533 This is allowed only in the value cell of a symbol,
534 and it means that the symbol's value really lives in the
535 specified int variable. */
536 struct Lisp_Intfwd
537 {
538 enum Lisp_Misc_Type type; /* = Lisp_Misc_Intfwd */
539 int *intvar;
540 };
541
542 /* Boolean forwarding pointer to an int variable.
543 This is like Lisp_Intfwd except that the ostensible
544 "value" of the symbol is t if the int variable is nonzero,
545 nil if it is zero. */
546 struct Lisp_Boolfwd
547 {
548 enum Lisp_Misc_Type type; /* = Lisp_Misc_Boolfwd */
549 int *boolvar;
550 };
551
552 /* Forwarding pointer to a Lisp_Object variable.
553 This is allowed only in the value cell of a symbol,
554 and it means that the symbol's value really lives in the
555 specified variable. */
556 struct Lisp_Objfwd
557 {
558 enum Lisp_Misc_Type type; /* = Lisp_Misc_Objfwd */
559 Lisp_Object *objvar;
560 };
561
562 /* Like Lisp_Objfwd except that value lives in a slot in the
563 current buffer. Value is byte index of slot within buffer. */
564 struct Lisp_Buffer_Objfwd
565 {
566 enum Lisp_Misc_Type type; /* = Lisp_Misc_Buffer_Objfwd */
567 int offset;
568 };
569
570 /* Used in a symbol value cell when the symbol's value is per-buffer.
571 The actual contents resemble a cons cell which starts a list like this:
572 (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE).
573
574 The cons-like structure is for historical reasons; it might be better
575 to just put these elements into the struct, now.
576
577 BUFFER is the last buffer for which this symbol's value was
578 made up to date.
579
580 CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
581 local_var_alist, that being the element whose car is this
582 variable. Or it can be a pointer to the
583 (CURRENT-ALIST-ELEMENT . DEFAULT-VALUE),
584 if BUFFER does not have an element in its alist for this
585 variable (that is, if BUFFER sees the default value of this
586 variable).
587
588 If we want to examine or set the value and BUFFER is current,
589 we just examine or set REALVALUE. If BUFFER is not current, we
590 store the current REALVALUE value into CURRENT-ALIST-ELEMENT,
591 then find the appropriate alist element for the buffer now
592 current and set up CURRENT-ALIST-ELEMENT. Then we set
593 REALVALUE out of that element, and store into BUFFER.
594
595 If we are setting the variable and the current buffer does not
596 have an alist entry for this variable, an alist entry is
597 created.
598
599 Note that REALVALUE can be a forwarding pointer. Each time it
600 is examined or set, forwarding must be done. Each time we
601 switch buffers, buffer-local variables which forward into C
602 variables are swapped immediately, so the C code can assume
603 that they are always up to date.
604
605 Lisp_Misc_Buffer_Local_Value and Lisp_Misc_Some_Buffer_Local_Value
606 use the same substructure. The difference is that with the latter,
607 merely setting the variable while some buffer is current
608 does not cause that buffer to have its own local value of this variable.
609 Only make-local-variable does that. */
610 struct Lisp_Buffer_Local_Value
611 {
612 enum Lisp_Misc_Type type; /* = Lisp_Misc_Buffer_Local_Value
613 or Lisp_Misc_Some_Buffer_Local_Value */
614 Lisp_Object car, cdr;
615 };
616
617 /* In an overlay object, the mark bit of the plist is used as the GC mark.
618 START and END are markers in the overlay's buffer, and
619 PLIST is the overlay's property list. */
620 struct Lisp_Overlay
621 {
622 enum Lisp_Misc_Type type; /* = Lisp_Misc_Overlay */
623 Lisp_Object start, end, plist;
624 };
625 union Lisp_Misc
626 {
627 enum Lisp_Misc_Type type;
628 struct Lisp_Free u_free;
629 struct Lisp_Marker u_marker;
630 struct Lisp_Intfwd u_intfwd;
631 struct Lisp_Boolfwd u_boolfwd;
632 struct Lisp_Objfwd u_objfwd;
633 struct Lisp_Buffer_Objfwd u_buffer_objfwd;
634 struct Lisp_Buffer_Local_Value u_buffer_local_value;
635 struct Lisp_Overlay u_overlay;
636 };
637
638 #ifdef LISP_FLOAT_TYPE
639 /* Optional Lisp floating point type */
640 struct Lisp_Float
641 {
642 Lisp_Object type; /* essentially used for mark-bit
643 and chaining when on free-list */
644 double data;
645 };
646 #endif /* LISP_FLOAT_TYPE */
647
648 /* A character, declared with the following typedef, is a member
649 of some character set associated with the current buffer. */
650 #ifndef _UCHAR_T /* Protect against something in ctab.h on AIX. */
651 #define _UCHAR_T
652 typedef unsigned char UCHAR;
653 #endif
654
655 /* Meanings of slots in a Lisp_Compiled: */
656
657 #define COMPILED_ARGLIST 0
658 #define COMPILED_BYTECODE 1
659 #define COMPILED_CONSTANTS 2
660 #define COMPILED_STACK_DEPTH 3
661 #define COMPILED_DOC_STRING 4
662 #define COMPILED_INTERACTIVE 5
663
664 /* Flag bits in a character. These also get used in termhooks.h.
665 Richard Stallman <rms@gnu.ai.mit.edu> thinks that MULE
666 (MUlti-Lingual Emacs) might need 18 bits for the character value
667 itself, so we probably shouldn't use any bits lower than 0x040000. */
668 #define CHAR_ALT (0x040000)
669 #define CHAR_SUPER (0x080000)
670 #define CHAR_HYPER (0x100000)
671 #define CHAR_SHIFT (0x200000)
672 #define CHAR_CTL (0x400000)
673 #define CHAR_META (0x800000)
674
675 #ifdef USE_X_TOOLKIT
676 #ifdef NO_UNION_TYPE
677 /* Use this for turning a (void *) into a Lisp_Object, as when the
678 Lisp_Object is passed into a toolkit callback function. */
679 #define VOID_TO_LISP(larg,varg) \
680 do { ((larg) = ((Lisp_Object) (varg))); } while (0)
681 #define CVOID_TO_LISP VOID_TO_LISP
682
683 /* Use this for turning a Lisp_Object into a (void *), as when the
684 Lisp_Object is passed into a toolkit callback function. */
685 #define LISP_TO_VOID(larg) ((void *) (larg))
686 #define LISP_TO_CVOID(varg) ((const void *) (larg))
687
688 #else /* not NO_UNION_TYPE */
689 /* Use this for turning a (void *) into a Lisp_Object, as when the
690 Lisp_Object is passed into a toolkit callback function. */
691 #define VOID_TO_LISP(larg,varg) \
692 do { ((larg).v = (void *) (varg)); } while (0)
693 #define CVOID_TO_LISP(larg,varg) \
694 do { ((larg).cv = (const void *) (varg)); } while (0)
695
696 /* Use this for turning a Lisp_Object into a (void *), as when the
697 Lisp_Object is passed into a toolkit callback function. */
698 #define LISP_TO_VOID(larg) ((larg).v)
699 #define LISP_TO_CVOID(larg) ((larg).cv)
700 #endif /* not NO_UNION_TYPE */
701 #endif /* USE_X_TOOLKIT */
702
703 \f
704 /* The glyph datatype, used to represent characters on the display. */
705
706 /* The low eight bits are the character code, and the bits above them
707 are the numeric face ID. If FID is the face ID of a glyph on a
708 frame F, then F->display.x->faces[FID] contains the description of
709 that face. This is an int instead of a short, so we can support a
710 good bunch of face ID's; given that we have no mechanism for
711 tossing unused frame face ID's yet, we'll probably run out of 255
712 pretty quickly. */
713 #define GLYPH unsigned int
714
715 #ifdef HAVE_FACES
716 /* The FAST macros assume that we already know we're in an X window. */
717
718 /* Given a character code and a face ID, return the appropriate glyph. */
719 #define FAST_MAKE_GLYPH(char, face) ((char) | ((face) << 8))
720
721 /* Return a glyph's character code. */
722 #define FAST_GLYPH_CHAR(glyph) ((glyph) & 0xff)
723
724 /* Return a glyph's face ID. */
725 #define FAST_GLYPH_FACE(glyph) (((glyph) >> 8) & ((1 << 24) - 1))
726
727 /* Slower versions that test the frame type first. */
728 #define MAKE_GLYPH(f, char, face) (FRAME_TERMCAP_P (f) ? (char) \
729 : FAST_MAKE_GLYPH (char, face))
730 #define GLYPH_CHAR(f, g) (FRAME_TERMCAP_P (f) ? (g) : FAST_GLYPH_CHAR (g))
731 #define GLYPH_FACE(f, g) (FRAME_TERMCAP_P (f) ? (0) : FAST_GLYPH_FACE (g))
732 #else /* not HAVE_FACES */
733 #define MAKE_GLYPH(f, char, face) (char)
734 #define GLYPH_CHAR(f, g) (g)
735 #define GLYPH_FACE(f, g) (g)
736 #endif /* not HAVE_FACES */
737
738 /* The ID of the mode line highlighting face. */
739 #define GLYPH_MODE_LINE_FACE 1
740 \f
741 /* Data type checking */
742
743 #define NILP(x) (XFASTINT (x) == XFASTINT (Qnil))
744 #define GC_NILP(x) GC_EQ (x, Qnil)
745
746 #ifdef LISP_FLOAT_TYPE
747 #define NUMBERP(x) (INTEGERP (x) || FLOATP (x))
748 #define GC_NUMBERP(x) (GC_INTEGERP (x) || GC_FLOATP (x))
749 #else
750 #define NUMBERP(x) (INTEGERP (x))
751 #define GC_NUMBERP(x) (GC_INTEGERP (x))
752 #endif
753 #define NATNUMP(x) (INTEGERP (x) && XINT (x) >= 0)
754 #define GC_NATNUMP(x) (GC_INTEGERP (x) && XINT (x) >= 0)
755
756 #define INTEGERP(x) (XTYPE ((x)) == Lisp_Int)
757 #define GC_INTEGERP(x) (XGCTYPE ((x)) == Lisp_Int)
758 #define SYMBOLP(x) (XTYPE ((x)) == Lisp_Symbol)
759 #define GC_SYMBOLP(x) (XGCTYPE ((x)) == Lisp_Symbol)
760 #define MISCP(x) (XTYPE ((x)) == Lisp_Misc)
761 #define GC_MISCP(x) (XGCTYPE ((x)) == Lisp_Misc)
762 #define STRINGP(x) (XTYPE ((x)) == Lisp_String)
763 #define GC_STRINGP(x) (XGCTYPE ((x)) == Lisp_String)
764 #define VECTORP(x) (XTYPE ((x)) == Lisp_Vector)
765 #define GC_VECTORP(x) (XGCTYPE ((x)) == Lisp_Vector)
766 #define CONSP(x) (XTYPE ((x)) == Lisp_Cons)
767 #define GC_CONSP(x) (XGCTYPE ((x)) == Lisp_Cons)
768 #define COMPILEDP(x) (XTYPE ((x)) == Lisp_Compiled)
769 #define GC_COMPILEDP(x) (XGCTYPE ((x)) == Lisp_Compiled)
770 #define BUFFERP(x) (XTYPE ((x)) == Lisp_Buffer)
771 #define GC_BUFFERP(x) (XGCTYPE ((x)) == Lisp_Buffer)
772 #define SUBRP(x) (XTYPE ((x)) == Lisp_Subr)
773 #define GC_SUBRP(x) (XGCTYPE ((x)) == Lisp_Subr)
774 #define PROCESSP(x) (XTYPE ((x)) == Lisp_Process)
775 #define GC_PROCESSP(x) (XGCTYPE ((x)) == Lisp_Process)
776 #ifdef MULTI_FRAME
777 #define FRAMEP(x) (XTYPE ((x)) == Lisp_Frame)
778 #define GC_FRAMEP(x) (XGCTYPE ((x)) == Lisp_Frame)
779 #else
780 #ifdef HAVE_MOUSE
781 /* We could use this in the !HAVE_MOUSE case also, but we prefer a compile-time
782 error message in case FRAMEP is used. */
783 #define FRAMEP(x) (EQ (x, Fselected_frame ()))
784 #define GC_FRAMEP(x) (GC_EQ (x, Fselected_frame ()))
785 #endif
786 #endif
787 #define WINDOWP(x) (XTYPE ((x)) == Lisp_Window)
788 #define GC_WINDOWP(x) (XGCTYPE ((x)) == Lisp_Window)
789 #define WINDOW_CONFIGURATIONP(x) (XTYPE ((x)) == Lisp_Window_Configuration)
790 #define GC_WINDOW_CONFIGURATIONP(x) (XGCTYPE ((x)) == Lisp_Window_Configuration)
791 #ifdef LISP_FLOAT_TYPE
792 #define FLOATP(x) (XTYPE ((x)) == Lisp_Float)
793 #define GC_FLOATP(x) (XGCTYPE ((x)) == Lisp_Float)
794 #else
795 #define FLOATP(x) (0)
796 #define GC_FLOATP(x) (0)
797 #endif
798 #define OVERLAYP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Overlay)
799 #define GC_OVERLAYP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Overlay)
800 #define MARKERP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Marker)
801 #define GC_MARKERP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Marker)
802 #define INTFWDP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Intfwd)
803 #define GC_INTFWDP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Intfwd)
804 #define BOOLFWDP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Boolfwd)
805 #define GC_BOOLFWDP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Boolfwd)
806 #define OBJFWDP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Objfwd)
807 #define GC_OBJFWDP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Objfwd)
808 #define BUFFER_OBJFWDP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Buffer_Objfwd)
809 #define GC_BUFFER_OBJFWDP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Buffer_Objfwd)
810 #define BUFFER_LOCAL_VALUEP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Buffer_Local_Value)
811 #define GC_BUFFER_LOCAL_VALUEP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Buffer_Local_Value)
812 #define SOME_BUFFER_LOCAL_VALUEP(x) (MISCP (x) && XMISC (x)->type == Lisp_Misc_Some_Buffer_Local_Value)
813 #define GC_SOME_BUFFER_LOCAL_VALUEP(x) (GC_MISCP (x) && XMISC (x)->type == Lisp_Misc_Some_Buffer_Local_Value)
814
815 #define EQ(x, y) (XFASTINT (x) == XFASTINT (y))
816 #define GC_EQ(x, y) (XGCTYPE (x) == XGCTYPE (y) && XPNTR (x) == XPNTR (y))
817
818 #define CHECK_LIST(x, i) \
819 do { if (!CONSP ((x)) && !NILP (x)) x = wrong_type_argument (Qlistp, (x)); } while (0)
820
821 #define CHECK_STRING(x, i) \
822 do { if (!STRINGP ((x))) x = wrong_type_argument (Qstringp, (x)); } while (0)
823
824 #define CHECK_CONS(x, i) \
825 do { if (!CONSP ((x))) x = wrong_type_argument (Qconsp, (x)); } while (0)
826
827 #define CHECK_SYMBOL(x, i) \
828 do { if (!SYMBOLP ((x))) x = wrong_type_argument (Qsymbolp, (x)); } while (0)
829
830 #define CHECK_VECTOR(x, i) \
831 do { if (!VECTORP ((x))) x = wrong_type_argument (Qvectorp, (x)); } while (0)
832
833 #define CHECK_BUFFER(x, i) \
834 do { if (!BUFFERP ((x))) x = wrong_type_argument (Qbufferp, (x)); } while (0)
835
836 #define CHECK_WINDOW(x, i) \
837 do { if (!WINDOWP ((x))) x = wrong_type_argument (Qwindowp, (x)); } while (0)
838
839 /* This macro rejects windows on the interior of the window tree as
840 "dead", which is what we want; this is an argument-checking macro, and
841 the user should never get access to interior windows.
842
843 A window of any sort, leaf or interior, is dead iff the buffer,
844 vchild, and hchild members are all nil. */
845
846 #define CHECK_LIVE_WINDOW(x, i) \
847 do { \
848 if (!WINDOWP ((x)) \
849 || NILP (XWINDOW ((x))->buffer)) \
850 x = wrong_type_argument (Qwindow_live_p, (x)); \
851 } while (0)
852
853 #define CHECK_PROCESS(x, i) \
854 do { if (!PROCESSP ((x))) x = wrong_type_argument (Qprocessp, (x)); } while (0)
855
856 #define CHECK_NUMBER(x, i) \
857 do { if (!INTEGERP ((x))) x = wrong_type_argument (Qintegerp, (x)); } while (0)
858
859 #define CHECK_NATNUM(x, i) \
860 do { if (!NATNUMP (x)) x = wrong_type_argument (Qwholenump, (x)); } while (0)
861
862 #define CHECK_MARKER(x, i) \
863 do { if (!MARKERP ((x))) x = wrong_type_argument (Qmarkerp, (x)); } while (0)
864
865 #define CHECK_NUMBER_COERCE_MARKER(x, i) \
866 do { if (MARKERP ((x))) XSETFASTINT (x, marker_position (x)); \
867 else if (!INTEGERP ((x))) x = wrong_type_argument (Qinteger_or_marker_p, (x)); } while (0)
868
869 #ifdef LISP_FLOAT_TYPE
870
871 #ifndef DBL_DIG
872 #define DBL_DIG 20
873 #endif
874
875 #define XFLOATINT(n) extract_float((n))
876
877 #define CHECK_FLOAT(x, i) \
878 do { if (!FLOATP (x)) \
879 x = wrong_type_argument (Qfloatp, (x)); } while (0)
880
881 #define CHECK_NUMBER_OR_FLOAT(x, i) \
882 do { if (!FLOATP (x) && !INTEGERP (x)) \
883 x = wrong_type_argument (Qnumberp, (x)); } while (0)
884
885 #define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER(x, i) \
886 do { if (MARKERP (x)) XSETFASTINT (x, marker_position (x)); \
887 else if (!INTEGERP (x) && !FLOATP (x)) \
888 x = wrong_type_argument (Qnumber_or_marker_p, (x)); } while (0)
889
890 #else /* Not LISP_FLOAT_TYPE */
891
892 #define CHECK_NUMBER_OR_FLOAT CHECK_NUMBER
893
894 #define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER CHECK_NUMBER_COERCE_MARKER
895
896 #define XFLOATINT(n) XINT((n))
897 #endif /* LISP_FLOAT_TYPE */
898
899 #define CHECK_OVERLAY(x, i) \
900 do { if (!OVERLAYP ((x))) x = wrong_type_argument (Qoverlayp, (x));} while (0)
901
902 /* Cast pointers to this type to compare them. Some machines want int. */
903 #ifndef PNTR_COMPARISON_TYPE
904 #define PNTR_COMPARISON_TYPE unsigned int
905 #endif
906 \f
907 /* Define a built-in function for calling from Lisp.
908 `lname' should be the name to give the function in Lisp,
909 as a null-terminated C string.
910 `fnname' should be the name of the function in C.
911 By convention, it starts with F.
912 `sname' should be the name for the C constant structure
913 that records information on this function for internal use.
914 By convention, it should be the same as `fnname' but with S instead of F.
915 It's too bad that C macros can't compute this from `fnname'.
916 `minargs' should be a number, the minimum number of arguments allowed.
917 `maxargs' should be a number, the maximum number of arguments allowed,
918 or else MANY or UNEVALLED.
919 MANY means pass a vector of evaluated arguments,
920 in the form of an integer number-of-arguments
921 followed by the address of a vector of Lisp_Objects
922 which contains the argument values.
923 UNEVALLED means pass the list of unevaluated arguments
924 `prompt' says how to read arguments for an interactive call.
925 See the doc string for `interactive'.
926 A null string means call interactively with no arguments.
927 `doc' is documentation for the user. */
928
929 #if !defined (__STDC__) || defined (USE_NONANSI_DEFUN)
930 #define DEFUN(lname, fnname, sname, minargs, maxargs, prompt, doc) \
931 Lisp_Object fnname (); \
932 struct Lisp_Subr sname = {fnname, minargs, maxargs, lname, prompt, 0}; \
933 Lisp_Object fnname
934
935 #else
936
937 /* This version of DEFUN declares a function prototype with the right
938 arguments, so we can catch errors with maxargs at compile-time. */
939 #define DEFUN(lname, fnname, sname, minargs, maxargs, prompt, doc) \
940 Lisp_Object fnname DEFUN_ARGS_ ## maxargs ; \
941 struct Lisp_Subr sname = {fnname, minargs, maxargs, lname, prompt, 0}; \
942 Lisp_Object fnname
943
944 /* Note that the weird token-substitution semantics of ANSI C makes
945 this work for MANY and UNEVALLED. */
946 #define DEFUN_ARGS_MANY (int, Lisp_Object *)
947 #define DEFUN_ARGS_UNEVALLED (Lisp_Object)
948 #define DEFUN_ARGS_0 (void)
949 #define DEFUN_ARGS_1 (Lisp_Object)
950 #define DEFUN_ARGS_2 (Lisp_Object, Lisp_Object)
951 #define DEFUN_ARGS_3 (Lisp_Object, Lisp_Object, Lisp_Object)
952 #define DEFUN_ARGS_4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object)
953 #define DEFUN_ARGS_5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
954 Lisp_Object)
955 #define DEFUN_ARGS_6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
956 Lisp_Object, Lisp_Object)
957 #define DEFUN_ARGS_7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
958 Lisp_Object, Lisp_Object, Lisp_Object)
959 #endif
960
961 /* defsubr (Sname);
962 is how we define the symbol for function `name' at start-up time. */
963 extern void defsubr ();
964
965 #define MANY -2
966 #define UNEVALLED -1
967
968 extern void defvar_lisp ();
969 extern void defvar_bool ();
970 extern void defvar_int ();
971
972 /* Macros we use to define forwarded Lisp variables.
973 These are used in the syms_of_FILENAME functions. */
974
975 #define DEFVAR_LISP(lname, vname, doc) defvar_lisp (lname, vname)
976 #define DEFVAR_LISP_NOPRO(lname, vname, doc) defvar_lisp_nopro (lname, vname)
977 #define DEFVAR_BOOL(lname, vname, doc) defvar_bool (lname, vname)
978 #define DEFVAR_INT(lname, vname, doc) defvar_int (lname, vname)
979 #define DEFVAR_PER_BUFFER(lname, vname, type, doc) \
980 defvar_per_buffer (lname, vname, type, 0)
981 \f
982 /* Structure for recording Lisp call stack for backtrace purposes. */
983
984 /* The special binding stack holds the outer values of variables while
985 they are bound by a function application or a let form, stores the
986 code to be executed for Lisp unwind-protect forms, and stores the C
987 functions to be called for record_unwind_protect.
988
989 If func is non-zero, undoing this binding applies func to old_value;
990 This implements record_unwind_protect.
991 If func is zero and symbol is nil, undoing this binding evaluates
992 the list of forms in old_value; this implements Lisp's unwind-protect
993 form.
994 Otherwise, undoing this binding stores old_value as symbol's value; this
995 undoes the bindings made by a let form or function call. */
996 struct specbinding
997 {
998 Lisp_Object symbol, old_value;
999 Lisp_Object (*func) ();
1000 Lisp_Object unused; /* Dividing by 16 is faster than by 12 */
1001 };
1002
1003 extern struct specbinding *specpdl;
1004 extern struct specbinding *specpdl_ptr;
1005 extern int specpdl_size;
1006
1007 /* Everything needed to describe an active condition case. */
1008 struct handler
1009 {
1010 /* The handler clauses and variable from the condition-case form. */
1011 Lisp_Object handler;
1012 Lisp_Object var;
1013 /* Fsignal stores here the condition-case clause that applies,
1014 and Fcondition_case thus knows which clause to run. */
1015 Lisp_Object chosen_clause;
1016
1017 /* Used to effect the longjump out to the handler. */
1018 struct catchtag *tag;
1019
1020 /* The next enclosing handler. */
1021 struct handler *next;
1022 };
1023
1024 extern struct handler *handlerlist;
1025
1026 extern struct catchtag *catchlist;
1027 extern struct backtrace *backtrace_list;
1028
1029 extern Lisp_Object memory_signal_data;
1030
1031 /* An address near the bottom of the stack.
1032 Tells GC how to save a copy of the stack. */
1033 extern char *stack_bottom;
1034
1035 /* Check quit-flag and quit if it is non-nil. */
1036
1037 #define QUIT \
1038 if (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) \
1039 { Vquit_flag = Qnil; Fsignal (Qquit, Qnil); }
1040
1041 /* Nonzero if ought to quit now. */
1042
1043 #define QUITP (!NILP (Vquit_flag) && NILP (Vinhibit_quit))
1044 \f
1045 /* 1 if CH is upper case. */
1046
1047 #define UPPERCASEP(CH) \
1048 (XSTRING (current_buffer->downcase_table)->data[CH] != (CH))
1049
1050 /* 1 if CH is lower case. */
1051
1052 #define LOWERCASEP(CH) \
1053 (!UPPERCASEP (CH) \
1054 && XSTRING (current_buffer->upcase_table)->data[CH] != (CH))
1055
1056 /* 1 if CH is neither upper nor lower case. */
1057
1058 #define NOCASEP(CH) (XSTRING (current_buffer->upcase_table)->data[CH] == (CH))
1059
1060 /* Upcase a character, or make no change if that cannot be done. */
1061
1062 #define UPCASE(CH) \
1063 (XSTRING (current_buffer->downcase_table)->data[CH] == (CH) \
1064 ? UPCASE1 (CH) : (CH))
1065
1066 /* Upcase a character known to be not upper case. */
1067
1068 #define UPCASE1(CH) (XSTRING (current_buffer->upcase_table)->data[CH])
1069
1070 /* Downcase a character, or make no change if that cannot be done. */
1071
1072 #define DOWNCASE(CH) (XSTRING (current_buffer->downcase_table)->data[CH])
1073
1074 /* Current buffer's map from characters to lower-case characters. */
1075
1076 #define DOWNCASE_TABLE XSTRING (current_buffer->downcase_table)->data
1077
1078 /* Table mapping each char to the next char with the same lowercase version.
1079 This mapping is a no-op only for characters that don't have case. */
1080 #define UPCASE_TABLE XSTRING (current_buffer->upcase_table)->data
1081
1082 extern Lisp_Object Vascii_downcase_table, Vascii_upcase_table;
1083 extern Lisp_Object Vascii_canon_table, Vascii_eqv_table;
1084 \f
1085 /* number of bytes of structure consed since last GC */
1086
1087 extern int consing_since_gc;
1088
1089 /* threshold for doing another gc */
1090
1091 extern int gc_cons_threshold;
1092
1093 /* Structure for recording stack slots that need marking */
1094
1095 /* This is a chain of structures, each of which points at a Lisp_Object variable
1096 whose value should be marked in garbage collection.
1097 Normally every link of the chain is an automatic variable of a function,
1098 and its `val' points to some argument or local variable of the function.
1099 On exit to the function, the chain is set back to the value it had on entry.
1100 This way, no link remains in the chain when the stack frame containing the
1101 link disappears.
1102
1103 Every function that can call Feval must protect in this fashion all
1104 Lisp_Object variables whose contents will be used again. */
1105
1106 extern struct gcpro *gcprolist;
1107
1108 struct gcpro
1109 {
1110 struct gcpro *next;
1111 Lisp_Object *var; /* Address of first protected variable */
1112 int nvars; /* Number of consecutive protected variables */
1113 };
1114
1115 #define GCPRO1(varname) \
1116 {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \
1117 gcprolist = &gcpro1; }
1118
1119 #define GCPRO2(varname1, varname2) \
1120 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1121 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1122 gcprolist = &gcpro2; }
1123
1124 #define GCPRO3(varname1, varname2, varname3) \
1125 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1126 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1127 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1128 gcprolist = &gcpro3; }
1129
1130 #define GCPRO4(varname1, varname2, varname3, varname4) \
1131 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1132 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1133 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1134 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
1135 gcprolist = &gcpro4; }
1136
1137 #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
1138 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1139 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1140 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1141 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
1142 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
1143 gcprolist = &gcpro5; }
1144
1145 /* Call staticpro (&var) to protect static variable `var'. */
1146
1147 void staticpro();
1148
1149 #define UNGCPRO (gcprolist = gcpro1.next)
1150
1151 /* Evaluate expr, UNGCPRO, and then return the value of expr. */
1152 #define RETURN_UNGCPRO(expr) \
1153 if (1) \
1154 { \
1155 Lisp_Object ret_ungc_val; \
1156 ret_ungc_val = (expr); \
1157 UNGCPRO; \
1158 return ret_ungc_val; \
1159 } \
1160 else
1161 \f
1162 /* Defined in data.c */
1163 extern Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
1164 extern Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
1165 extern Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
1166 extern Lisp_Object Qvoid_variable, Qvoid_function;
1167 extern Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
1168 extern Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
1169 extern Lisp_Object Qend_of_file, Qarith_error;
1170 extern Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
1171 extern Lisp_Object Qmark_inactive;
1172
1173 extern Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
1174 extern Lisp_Object Qoverflow_error, Qunderflow_error;
1175
1176 extern Lisp_Object Qintegerp, Qnumberp, Qnatnump, Qwholenump;
1177 extern Lisp_Object Qsymbolp, Qlistp, Qconsp;
1178 extern Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
1179 extern Lisp_Object Qchar_or_string_p, Qmarkerp, Qvectorp;
1180 extern Lisp_Object Qinteger_or_marker_p, Qnumber_or_marker_p;
1181 extern Lisp_Object Qboundp, Qfboundp;
1182 extern Lisp_Object Qbuffer_or_string_p;
1183 extern Lisp_Object Qcdr;
1184
1185 #ifdef LISP_FLOAT_TYPE
1186 extern Lisp_Object Qfloatp, Qinteger_or_floatp, Qinteger_or_float_or_marker_p;
1187 #endif /* LISP_FLOAT_TYPE */
1188
1189 extern Lisp_Object Qframep;
1190
1191 extern Lisp_Object Feq (), Fnull (), Flistp (), Fconsp (), Fatom (), Fnlistp ();
1192 extern Lisp_Object Fintegerp (), Fnatnump (), Fsymbolp ();
1193 extern Lisp_Object Fvectorp (), Fstringp (), Farrayp (), Fsequencep ();
1194 extern Lisp_Object Fbufferp (), Fmarkerp (), Fsubrp (), Fchar_or_string_p ();
1195 extern Lisp_Object Finteger_or_marker_p ();
1196 #ifdef LISP_FLOAT_TYPE
1197 extern Lisp_Object Ffloatp(), Finteger_or_floatp();
1198 extern Lisp_Object Finteger_or_float_or_marker_p(), Ftruncate();
1199 #endif /* LISP_FLOAT_TYPE */
1200
1201 extern Lisp_Object Fcar (), Fcar_safe(), Fcdr (), Fcdr_safe();
1202 extern Lisp_Object Fsetcar (), Fsetcdr ();
1203 extern Lisp_Object Fboundp (), Ffboundp (), Fmakunbound (), Ffmakunbound ();
1204 extern Lisp_Object Fsymbol_function (), Fsymbol_plist (), Fsymbol_name ();
1205 extern Lisp_Object indirect_function (), Findirect_function ();
1206 extern Lisp_Object Ffset (), Fsetplist ();
1207 extern Lisp_Object Fsymbol_value (), find_symbol_value (), Fset ();
1208 extern Lisp_Object Fdefault_value (), Fset_default (), Fdefault_boundp ();
1209
1210 extern Lisp_Object Faref (), Faset (), Farray_length ();
1211
1212 extern Lisp_Object Fstring_to_number (), Fnumber_to_string ();
1213 extern Lisp_Object Feqlsign (), Fgtr (), Flss (), Fgeq (), Fleq ();
1214 extern Lisp_Object Fneq (), Fzerop ();
1215 extern Lisp_Object Fplus (), Fminus (), Ftimes (), Fquo (), Frem ();
1216 extern Lisp_Object Fmax (), Fmin ();
1217 extern Lisp_Object Flogand (), Flogior (), Flogxor (), Flognot ();
1218 extern Lisp_Object Flsh (), Fash ();
1219
1220 extern Lisp_Object Fadd1 (), Fsub1 ();
1221
1222 extern Lisp_Object make_number ();
1223 extern Lisp_Object long_to_cons ();
1224 extern unsigned long cons_to_long ();
1225 extern void args_out_of_range ();
1226 extern void args_out_of_range_3 ();
1227 extern Lisp_Object wrong_type_argument ();
1228 #ifdef LISP_FLOAT_TYPE
1229 extern Lisp_Object Ffloat_to_int(), Fint_to_float();
1230 extern double extract_float();
1231 extern Lisp_Object make_float ();
1232 extern Lisp_Object Ffloat ();
1233 #endif /* LISP_FLOAT_TYPE */
1234
1235 /* Defined in fns.c */
1236 extern Lisp_Object Qstring_lessp;
1237 extern Lisp_Object Vfeatures;
1238 extern Lisp_Object Fidentity (), Frandom ();
1239 extern Lisp_Object Flength ();
1240 extern Lisp_Object Fappend (), Fconcat (), Fvconcat (), Fcopy_sequence ();
1241 extern Lisp_Object Fsubstring ();
1242 extern Lisp_Object Fnth (), Fnthcdr (), Fmemq (), Fassq (), Fassoc ();
1243 extern Lisp_Object Fmember (), Frassq (), Fdelq (), Fsort ();
1244 extern Lisp_Object Freverse (), Fnreverse (), Fget (), Fput (), Fequal ();
1245 extern Lisp_Object Ffillarray (), Fnconc (), Fmapcar (), Fmapconcat ();
1246 extern Lisp_Object Fy_or_n_p (), do_yes_or_no_p ();
1247 extern Lisp_Object Ffeaturep (), Frequire () , Fprovide ();
1248 extern Lisp_Object concat2 (), nconc2 ();
1249 extern Lisp_Object assq_no_quit ();
1250 extern Lisp_Object Fcopy_alist ();
1251
1252 /* Defined in alloc.c */
1253 extern Lisp_Object Vpurify_flag;
1254 extern Lisp_Object Fcons (), Flist(), Fmake_list (), allocate_misc ();
1255 extern Lisp_Object Fmake_vector (), Fvector (), Fmake_symbol (), Fmake_marker ();
1256 extern Lisp_Object Fmake_string (), build_string (), make_string ();
1257 extern Lisp_Object make_event_array (), make_uninit_string ();
1258 extern Lisp_Object Fpurecopy (), make_pure_string ();
1259 extern Lisp_Object pure_cons (), make_pure_vector ();
1260 extern Lisp_Object Fgarbage_collect ();
1261 extern Lisp_Object Fmake_byte_code ();
1262 extern int gc_in_progress;
1263
1264 /* Defined in print.c */
1265 extern Lisp_Object Vprin1_to_string_buffer;
1266 extern Lisp_Object Fprin1 (), Fprin1_to_string (), Fprinc ();
1267 extern Lisp_Object Fterpri (), Fprint ();
1268 extern Lisp_Object Vstandard_output, Qstandard_output;
1269 extern Lisp_Object Qexternal_debugging_output;
1270 extern void temp_output_buffer_setup (), temp_output_buffer_show ();
1271 extern int print_level, print_escape_newlines;
1272 extern Lisp_Object Qprint_escape_newlines;
1273
1274 /* Defined in lread.c */
1275 extern Lisp_Object Qvariable_documentation, Qstandard_input;
1276 extern Lisp_Object Vobarray, Vstandard_input;
1277 extern Lisp_Object Fread (), Fread_from_string ();
1278 extern Lisp_Object Fintern (), Fintern_soft (), Fload ();
1279 extern Lisp_Object Fget_file_char (), Fread_char ();
1280 extern Lisp_Object read_filtered_event ();
1281 extern Lisp_Object Feval_current_buffer (), Feval_region ();
1282 extern Lisp_Object intern (), oblookup ();
1283 #define LOADHIST_ATTACH(x) \
1284 if (initialized) Vcurrent_load_list = Fcons (x, Vcurrent_load_list)
1285 extern Lisp_Object Vcurrent_load_list;
1286 extern Lisp_Object Vload_history;
1287
1288 /* Defined in eval.c */
1289 extern Lisp_Object Qautoload, Qexit, Qinteractive, Qcommandp, Qdefun, Qmacro;
1290 extern Lisp_Object Vinhibit_quit, Qinhibit_quit, Vquit_flag;
1291 extern Lisp_Object Vmocklisp_arguments, Qmocklisp, Qmocklisp_arguments;
1292 extern Lisp_Object Vautoload_queue;
1293 extern Lisp_Object Vdebug_on_error;
1294 /* To run a normal hook, do
1295 if (!NILP (Vrun_hooks))
1296 call1 (Vrun_hooks, Qmy_funny_hook); */
1297 extern Lisp_Object Vrun_hooks;
1298 extern Lisp_Object Fand (), For (), Fif (), Fprogn (), Fprog1 (), Fprog2 ();
1299 extern Lisp_Object Fsetq (), Fquote ();
1300 extern Lisp_Object Fuser_variable_p (), Finteractive_p ();
1301 extern Lisp_Object Fdefun (), Flet (), FletX (), Fwhile ();
1302 extern Lisp_Object Fcatch (), Fthrow (), Funwind_protect ();
1303 extern Lisp_Object Fcondition_case (), Fsignal ();
1304 extern Lisp_Object Ffunction_type (), Fautoload (), Fcommandp ();
1305 extern Lisp_Object Feval (), Fapply (), Ffuncall ();
1306 extern Lisp_Object Fglobal_set (), Fglobal_value (), Fbacktrace ();
1307 extern Lisp_Object apply1 (), call0 (), call1 (), call2 (), call3 ();
1308 extern Lisp_Object call4 (), call5 (), call6 ();
1309 extern Lisp_Object Fkill_emacs (), Fkey_binding (), Fsit_for ();
1310 extern Lisp_Object Fdo_auto_save (), Fset_marker ();
1311 extern Lisp_Object apply_lambda ();
1312 extern Lisp_Object internal_catch ();
1313 extern Lisp_Object internal_condition_case ();
1314 extern Lisp_Object internal_condition_case_1 ();
1315 extern Lisp_Object unbind_to ();
1316 extern void error ();
1317 extern Lisp_Object un_autoload ();
1318
1319 /* Defined in editfns.c */
1320 extern Lisp_Object Fgoto_char ();
1321 extern Lisp_Object Fpoint_min_marker (), Fpoint_max_marker ();
1322 extern Lisp_Object Fpoint_min (), Fpoint_max ();
1323 extern Lisp_Object Fpoint (), Fpoint_marker (), Fmark_marker ();
1324 extern Lisp_Object Ffollowing_char (), Fprevious_char (), Fchar_after ();
1325 extern Lisp_Object Finsert ();
1326 extern Lisp_Object Feolp (), Feobp (), Fbolp (), Fbobp ();
1327 extern Lisp_Object Fformat (), format1 ();
1328 extern Lisp_Object make_buffer_string (), Fbuffer_substring ();
1329 extern Lisp_Object Fbuffer_string ();
1330 extern Lisp_Object Fstring_equal (), Fstring_lessp (), Fbuffer_substring_lessp ();
1331 extern Lisp_Object save_excursion_save (), save_restriction_save ();
1332 extern Lisp_Object save_excursion_restore (), save_restriction_restore ();
1333 extern Lisp_Object Fchar_to_string ();
1334
1335 /* defined in buffer.c */
1336 extern Lisp_Object Vbuffer_alist, Vinhibit_read_only;
1337 extern Lisp_Object Fget_buffer (), Fget_buffer_create (), Fset_buffer ();
1338 extern Lisp_Object Fbarf_if_buffer_read_only ();
1339 extern Lisp_Object Fcurrent_buffer (), Fswitch_to_buffer (), Fpop_to_buffer ();
1340 extern Lisp_Object Fother_buffer ();
1341 extern Lisp_Object Foverlay_get ();
1342 extern Lisp_Object Qoverlayp;
1343 extern struct buffer *all_buffers;
1344
1345 /* defined in marker.c */
1346
1347 extern Lisp_Object Fmarker_position (), Fmarker_buffer ();
1348 extern Lisp_Object Fcopy_marker ();
1349
1350 /* Defined in fileio.c */
1351
1352 extern Lisp_Object Qfile_error;
1353 extern Lisp_Object Ffind_file_name_handler ();
1354 extern Lisp_Object Ffile_name_as_directory ();
1355 extern Lisp_Object Fexpand_file_name (), Ffile_name_nondirectory ();
1356 extern Lisp_Object Fsubstitute_in_file_name ();
1357 extern Lisp_Object Ffile_symlink_p ();
1358 extern Lisp_Object Fverify_visited_file_modtime ();
1359 extern Lisp_Object Ffile_exists_p ();
1360 extern Lisp_Object Fdirectory_file_name ();
1361 extern Lisp_Object Ffile_name_directory ();
1362 extern Lisp_Object expand_and_dir_to_file ();
1363 extern Lisp_Object Ffile_accessible_directory_p ();
1364 extern Lisp_Object Funhandled_file_name_directory ();
1365
1366 /* Defined in abbrev.c */
1367
1368 extern Lisp_Object Vfundamental_mode_abbrev_table;
1369
1370 /* defined in search.c */
1371 extern Lisp_Object Fstring_match ();
1372 extern Lisp_Object Fscan_buffer ();
1373
1374 /* defined in minibuf.c */
1375
1376 extern Lisp_Object last_minibuf_string;
1377 extern Lisp_Object read_minibuf (), Fcompleting_read ();
1378 extern Lisp_Object Fread_from_minibuffer ();
1379 extern Lisp_Object Fread_variable (), Fread_buffer (), Fread_key_sequence ();
1380 extern Lisp_Object Fread_minibuffer (), Feval_minibuffer ();
1381 extern Lisp_Object Fread_string (), Fread_file_name ();
1382 extern Lisp_Object Fread_no_blanks_input ();
1383
1384 /* Defined in callint.c */
1385
1386 extern Lisp_Object Vprefix_arg, Qminus, Qplus, Vcurrent_prefix_arg;
1387 extern Lisp_Object Vcommand_history;
1388 extern Lisp_Object Qcall_interactively;
1389 extern Lisp_Object Fcall_interactively ();
1390 extern Lisp_Object Fprefix_numeric_value ();
1391
1392 /* defined in casefiddle.c */
1393
1394 extern Lisp_Object Fdowncase (), Fupcase (), Fcapitalize ();
1395
1396 /* defined in keyboard.c */
1397
1398 extern Lisp_Object Qdisabled;
1399 extern Lisp_Object Vhelp_form, Vtop_level;
1400 extern Lisp_Object Fdiscard_input (), Frecursive_edit ();
1401 extern Lisp_Object Fcommand_execute (), Finput_pending_p ();
1402 extern Lisp_Object Qvertical_scroll_bar;
1403
1404 /* defined in keymap.c */
1405
1406 extern Lisp_Object Qkeymap, Qmenu_bar;
1407 extern Lisp_Object current_global_map;
1408 extern Lisp_Object Fkey_description (), Fsingle_key_description ();
1409 extern Lisp_Object Fwhere_is_internal ();
1410 extern Lisp_Object access_keymap (), store_in_keymap ();
1411 extern Lisp_Object get_keyelt (), get_keymap();
1412
1413 /* defined in indent.c */
1414 extern Lisp_Object Fvertical_motion (), Findent_to (), Fcurrent_column ();
1415
1416 /* defined in window.c */
1417 extern Lisp_Object Qwindowp, Qwindow_live_p;
1418 extern Lisp_Object Fget_buffer_window ();
1419 extern Lisp_Object Fsave_window_excursion ();
1420 extern Lisp_Object Fset_window_configuration (), Fcurrent_window_configuration ();
1421 extern Lisp_Object Fcoordinates_in_window_p ();
1422 extern Lisp_Object Fwindow_at ();
1423 extern int window_internal_height (), window_internal_width ();
1424
1425 /* defined in frame.c */
1426 extern Lisp_Object Qvisible;
1427 extern Lisp_Object Fframep ();
1428 extern Lisp_Object Fselect_frame ();
1429 extern Lisp_Object Ffocus_frame ();
1430 extern Lisp_Object Funfocus_frame ();
1431 extern Lisp_Object Fselected_frame ();
1432 extern Lisp_Object Fwindow_frame ();
1433 extern Lisp_Object Fframe_root_window ();
1434 extern Lisp_Object Fframe_selected_window ();
1435 extern Lisp_Object Fframe_list ();
1436 extern Lisp_Object Fnext_frame ();
1437 extern Lisp_Object Fdelete_frame ();
1438 extern Lisp_Object Fread_mouse_position ();
1439 extern Lisp_Object Fset_mouse_position ();
1440 extern Lisp_Object Fmake_frame_visible ();
1441 extern Lisp_Object Fmake_frame_invisible ();
1442 extern Lisp_Object Ficonify_frame ();
1443 extern Lisp_Object Fdeiconify_frame ();
1444 extern Lisp_Object Fframe_visible_p ();
1445 extern Lisp_Object Fvisible_frame_list ();
1446 extern Lisp_Object Fframe_parameters ();
1447 extern Lisp_Object Fmodify_frame_parameters ();
1448 extern Lisp_Object Fframe_pixel_size ();
1449 extern Lisp_Object Fframe_height ();
1450 extern Lisp_Object Fframe_width ();
1451 extern Lisp_Object Fset_frame_height ();
1452 extern Lisp_Object Fset_frame_width ();
1453 extern Lisp_Object Fset_frame_size ();
1454 extern Lisp_Object Fset_frame_position ();
1455 #ifndef HAVE_X11
1456 extern Lisp_Object Frubber_band_rectangle ();
1457 #endif /* HAVE_X11 */
1458
1459 /* defined in emacs.c */
1460 extern Lisp_Object decode_env_path ();
1461 extern Lisp_Object Vinvocation_name, Vinvocation_directory;
1462 extern Lisp_Object Vinstallation_directory;
1463 void shut_down_emacs ( /* int signal, int no_x, Lisp_Object stuff */ );
1464 /* Nonzero means don't do interactive redisplay and don't change tty modes */
1465 extern int noninteractive;
1466 /* Nonzero means don't do use window-system-specific display code */
1467 extern int inhibit_window_system;
1468
1469 /* defined in process.c */
1470 extern Lisp_Object Fget_process (), Fget_buffer_process (), Fprocessp ();
1471 extern Lisp_Object Fprocess_status (), Fkill_process ();
1472 extern Lisp_Object Fprocess_send_eof ();
1473
1474 /* defined in callproc.c */
1475 extern Lisp_Object Vexec_path, Vexec_directory, Vdata_directory;
1476 extern Lisp_Object Vdoc_directory;
1477
1478 /* defined in doc.c */
1479 extern Lisp_Object Vdoc_file_name;
1480 extern Lisp_Object Fsubstitute_command_keys ();
1481 extern Lisp_Object Fdocumentation (), Fdocumentation_property ();
1482
1483 /* defined in bytecode.c */
1484 extern Lisp_Object Qbytecode;
1485 extern Lisp_Object Fbyte_code ();
1486
1487 /* defined in macros.c */
1488 extern Lisp_Object Qexecute_kbd_macro;
1489 extern Lisp_Object Fexecute_kbd_macro ();
1490
1491 /* defined in undo.c */
1492 extern Lisp_Object Fundo_boundary ();
1493 extern Lisp_Object truncate_undo_list ();
1494
1495 /* defined in textprop.c */
1496 extern Lisp_Object Qmodification_hooks;
1497 extern Lisp_Object Qinsert_in_front_hooks, Qinsert_behind_hooks;
1498 extern Lisp_Object Fnext_property_change ();
1499 extern Lisp_Object Fnext_single_property_change ();
1500
1501 /* Nonzero means Emacs has already been initialized.
1502 Used during startup to detect startup of dumped Emacs. */
1503 extern int initialized;
1504
1505 extern int immediate_quit; /* Nonzero means ^G can quit instantly */
1506
1507 extern void debugger ();
1508
1509 extern char *getenv (), *ctime (), *getwd ();
1510 extern long *xmalloc (), *xrealloc ();
1511 extern void xfree ();
1512
1513 extern char *egetenv ();
1514
1515 /* Set up the name of the machine we're running on. */
1516 extern void init_system_name ();
1517
1518 /* Some systems (e.g., NT) use a different path separator than Unix,
1519 in addition to a device separator. Default the path separator
1520 to '/', and don't test for a device separator in IS_ANY_SEP. */
1521
1522 #ifndef DIRECTORY_SEP
1523 #define DIRECTORY_SEP '/'
1524 #endif
1525 #ifndef IS_DIRECTORY_SEP
1526 #define IS_DIRECTORY_SEP(_c_) ((_c_) == DIRECTORY_SEP)
1527 #endif
1528 #ifndef IS_DEVICE_SEP
1529 #ifndef DEVICE_SEP
1530 #define IS_DEVICE_SEP(_c_) 0
1531 #else
1532 #define IS_DEVICE_SEP(_c_) ((_c_) == DEVICE_SEP)
1533 #endif
1534 #endif
1535 #ifndef IS_ANY_SEP
1536 #define IS_ANY_SEP(_c_) (IS_DIRECTORY_SEP (_c_))
1537 #endif