]> code.delx.au - gnu-emacs/blob - src/lisp.h
Revision: miles@gnu.org--gnu-2004/emacs--unicode--0--patch-78
[gnu-emacs] / src / lisp.h
1 /* Fundamental definitions for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985,86,87,93,94,95,97,98,1999,2000,01,02,03,2004
3 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
21
22 #ifndef EMACS_LISP_H
23 #define EMACS_LISP_H
24
25 /* Declare the prototype for a general external function. */
26 #if defined (PROTOTYPES) || defined (WINDOWSNT)
27 #define P_(proto) proto
28 #else
29 #define P_(proto) ()
30 #endif
31
32 #if 0
33 /* Define this temporarily to hunt a bug. If defined, the size of
34 strings is redundantly recorded in sdata structures so that it can
35 be compared to the sizes recorded in Lisp strings. */
36
37 #define GC_CHECK_STRING_BYTES 1
38
39 /* Define this to check for short string overrun. */
40
41 #define GC_CHECK_STRING_OVERRUN 1
42
43 /* Define this to check the string free list. */
44
45 #define GC_CHECK_STRING_FREE_LIST 1
46
47 /* Define this to check for malloc buffer overrun. */
48
49 #define XMALLOC_OVERRUN_CHECK 1
50
51 /* Define this to check for errors in cons list. */
52 /* #define GC_CHECK_CONS_LIST 1 */
53
54 #endif /* 0 */
55
56
57 /* These are default choices for the types to use. */
58 #ifdef _LP64
59 #ifndef EMACS_INT
60 #define EMACS_INT long
61 #define BITS_PER_EMACS_INT BITS_PER_LONG
62 #endif
63 #ifndef EMACS_UINT
64 #define EMACS_UINT unsigned long
65 #endif
66 #else /* not _LP64 */
67 #ifndef EMACS_INT
68 #define EMACS_INT int
69 #define BITS_PER_EMACS_INT BITS_PER_INT
70 #endif
71 #ifndef EMACS_UINT
72 #define EMACS_UINT unsigned int
73 #endif
74 #endif
75
76 /* Extra internal type checking? */
77 extern int suppress_checking;
78 extern void die P_((const char *, const char *, int));
79
80 #ifdef ENABLE_CHECKING
81
82 #define CHECK(check,msg) (((check) || suppress_checking \
83 ? (void) 0 \
84 : die ((msg), __FILE__, __LINE__)), \
85 0)
86 #else
87
88 /* Produce same side effects and result, but don't complain. */
89 #define CHECK(check,msg) ((check),0)
90
91 #endif
92
93 /* Used for making sure that Emacs is compilable in all
94 configurations. */
95
96 #ifdef USE_LISP_UNION_TYPE
97 #undef NO_UNION_TYPE
98 #endif
99
100 /* Define an Emacs version of "assert", since some system ones are
101 flaky. */
102 #ifndef ENABLE_CHECKING
103 #define eassert(X) (void) 0
104 #else /* ENABLE_CHECKING */
105 #if defined (__GNUC__) && __GNUC__ >= 2 && defined (__STDC__)
106 #define eassert(cond) CHECK(cond,"assertion failed: " #cond)
107 #else
108 #define eassert(cond) CHECK(cond,"assertion failed")
109 #endif
110 #endif /* ENABLE_CHECKING */
111
112 /* Define the fundamental Lisp data structures. */
113
114 /* This is the set of Lisp data types. */
115
116 enum Lisp_Type
117 {
118 /* Integer. XINT (obj) is the integer value. */
119 Lisp_Int,
120
121 /* Symbol. XSYMBOL (object) points to a struct Lisp_Symbol. */
122 Lisp_Symbol,
123
124 /* Miscellaneous. XMISC (object) points to a union Lisp_Misc,
125 whose first member indicates the subtype. */
126 Lisp_Misc,
127
128 /* String. XSTRING (object) points to a struct Lisp_String.
129 The length of the string, and its contents, are stored therein. */
130 Lisp_String,
131
132 /* Vector of Lisp objects, or something resembling it.
133 XVECTOR (object) points to a struct Lisp_Vector, which contains
134 the size and contents. The size field also contains the type
135 information, if it's not a real vector object. */
136 Lisp_Vectorlike,
137
138 /* Cons. XCONS (object) points to a struct Lisp_Cons. */
139 Lisp_Cons,
140
141 Lisp_Float,
142
143 /* This is not a type code. It is for range checking. */
144 Lisp_Type_Limit
145 };
146
147 /* This is the set of data types that share a common structure.
148 The first member of the structure is a type code from this set.
149 The enum values are arbitrary, but we'll use large numbers to make it
150 more likely that we'll spot the error if a random word in memory is
151 mistakenly interpreted as a Lisp_Misc. */
152 enum Lisp_Misc_Type
153 {
154 Lisp_Misc_Free = 0x5eab,
155 Lisp_Misc_Marker,
156 Lisp_Misc_Intfwd,
157 Lisp_Misc_Boolfwd,
158 Lisp_Misc_Objfwd,
159 Lisp_Misc_Buffer_Objfwd,
160 Lisp_Misc_Buffer_Local_Value,
161 Lisp_Misc_Some_Buffer_Local_Value,
162 Lisp_Misc_Overlay,
163 Lisp_Misc_Kboard_Objfwd,
164 Lisp_Misc_Save_Value,
165 /* Currently floats are not a misc type,
166 but let's define this in case we want to change that. */
167 Lisp_Misc_Float,
168 /* This is not a type code. It is for range checking. */
169 Lisp_Misc_Limit
170 };
171
172 #ifndef GCTYPEBITS
173 #define GCTYPEBITS 3
174 #endif
175
176 /* These values are overridden by the m- file on some machines. */
177 #ifndef VALBITS
178 #define VALBITS (BITS_PER_EMACS_INT - GCTYPEBITS)
179 #endif
180
181 #ifndef NO_UNION_TYPE
182
183 #ifndef WORDS_BIG_ENDIAN
184
185 /* Definition of Lisp_Object for little-endian machines. */
186
187 typedef
188 union Lisp_Object
189 {
190 /* Used for comparing two Lisp_Objects;
191 also, positive integers can be accessed fast this way. */
192 EMACS_INT i;
193
194 struct
195 {
196 EMACS_INT val : VALBITS;
197 enum Lisp_Type type : GCTYPEBITS;
198 } s;
199 struct
200 {
201 EMACS_UINT val : VALBITS;
202 enum Lisp_Type type : GCTYPEBITS;
203 } u;
204 }
205 Lisp_Object;
206
207 #else /* If WORDS_BIG_ENDIAN */
208
209 typedef
210 union Lisp_Object
211 {
212 /* Used for comparing two Lisp_Objects;
213 also, positive integers can be accessed fast this way. */
214 EMACS_INT i;
215
216 struct
217 {
218 enum Lisp_Type type : GCTYPEBITS;
219 EMACS_INT val : VALBITS;
220 } s;
221 struct
222 {
223 enum Lisp_Type type : GCTYPEBITS;
224 EMACS_UINT val : VALBITS;
225 } u;
226 }
227 Lisp_Object;
228
229 #endif /* WORDS_BIG_ENDIAN */
230
231 #ifdef __GNUC__
232 static __inline__ Lisp_Object
233 LISP_MAKE_RVALUE (Lisp_Object o)
234 {
235 return o;
236 }
237 #else
238 /* This isn't quite right - it keeps the argument as an lvalue.
239 Making it const via casting would help avoid code actually
240 modifying the location in question, but the casting could cover
241 other type-related bugs. */
242 #define LISP_MAKE_RVALUE(o) (o)
243 #endif
244
245 #endif /* NO_UNION_TYPE */
246
247
248 /* If union type is not wanted, define Lisp_Object as just a number. */
249
250 #ifdef NO_UNION_TYPE
251 #define Lisp_Object EMACS_INT
252 #define LISP_MAKE_RVALUE(o) (0+(o))
253 #endif /* NO_UNION_TYPE */
254
255 /* Two flags that are set during GC. On some machines, these flags
256 are defined differently by the m- file. */
257
258 /* In the size word of a vector, this bit means the vector has been marked. */
259
260 #ifndef ARRAY_MARK_FLAG
261 #define ARRAY_MARK_FLAG ((EMACS_INT) ((EMACS_UINT) 1 << (VALBITS + GCTYPEBITS - 1)))
262 #endif /* no ARRAY_MARK_FLAG */
263
264 /* In the size word of a struct Lisp_Vector, this bit means it's really
265 some other vector-like object. */
266 #ifndef PSEUDOVECTOR_FLAG
267 #define PSEUDOVECTOR_FLAG ((ARRAY_MARK_FLAG >> 1) & ~ARRAY_MARK_FLAG)
268 #endif
269
270 /* In a pseudovector, the size field actually contains a word with one
271 PSEUDOVECTOR_FLAG bit set, and exactly one of the following bits to
272 indicate the actual type. */
273 enum pvec_type
274 {
275 PVEC_NORMAL_VECTOR = 0,
276 PVEC_PROCESS = 0x200,
277 PVEC_FRAME = 0x400,
278 PVEC_COMPILED = 0x800,
279 PVEC_WINDOW = 0x1000,
280 PVEC_WINDOW_CONFIGURATION = 0x2000,
281 PVEC_SUBR = 0x4000,
282 PVEC_CHAR_TABLE = 0x8000,
283 PVEC_BOOL_VECTOR = 0x10000,
284 PVEC_BUFFER = 0x20000,
285 PVEC_HASH_TABLE = 0x40000,
286 PVEC_SUB_CHAR_TABLE = 0x80000,
287 PVEC_TYPE_MASK = 0x0ffe00
288
289 #if 0 /* This is used to make the value of PSEUDOVECTOR_FLAG available to
290 GDB. It doesn't work on OS Alpha. Moved to a variable in
291 emacs.c. */
292 PVEC_FLAG = PSEUDOVECTOR_FLAG
293 #endif
294 };
295
296 /* For convenience, we also store the number of elements in these bits. */
297 #define PSEUDOVECTOR_SIZE_MASK 0x1ff
298
299 /* Number of bits to put in each character in the internal representation
300 of bool vectors. This should not vary across implementations. */
301 #define BOOL_VECTOR_BITS_PER_CHAR 8
302 \f
303 /***** Select the tagging scheme. *****/
304 /* There are basically two options that control the tagging scheme:
305 - NO_UNION_TYPE says that Lisp_Object should be an integer instead
306 of a union.
307 - USE_LSB_TAG means that we can assume the least 3 bits of pointers are
308 always 0, and we can thus use them to hold tag bits, without
309 restricting our addressing space.
310
311 If USE_LSB_TAG is not set, then we use the top 3 bits for tagging, thus
312 restricting our possible address range. Currently USE_LSB_TAG is not
313 allowed together with a union. This is not due to any fundamental
314 technical (or political ;-) problem: nobody wrote the code to do it yet.
315
316 USE_LSB_TAG not only requires the least 3 bits of pointers returned by
317 malloc to be 0 but also needs to be able to impose a mult-of-8 alignment
318 on the few static Lisp_Objects used: all the defsubr as well
319 as the two special buffers buffer_defaults and buffer_local_symbols. */
320
321 /* First, try and define DECL_ALIGN(type,var) which declares a static
322 variable VAR of type TYPE with the added requirement that it be
323 TYPEBITS-aligned. */
324 #ifndef NO_DECL_ALIGN
325 # ifndef DECL_ALIGN
326 /* What compiler directive should we use for non-gcc compilers? -stef */
327 # if defined (__GNUC__)
328 # define DECL_ALIGN(type, var) \
329 type __attribute__ ((__aligned__ (1 << GCTYPEBITS))) var
330 # endif
331 # endif
332 #endif
333
334 /* Let's USE_LSB_TAG on systems where we know malloc returns mult-of-8. */
335 #if defined GNU_MALLOC || defined DOUG_LEA_MALLOC || defined __GLIBC__ || defined MAC_OSX
336 /* We also need to be able to specify mult-of-8 alignment on static vars. */
337 # if defined DECL_ALIGN
338 /* We currently do not support USE_LSB_TAG with a union Lisp_Object. */
339 # if defined NO_UNION_TYPE
340 # define USE_LSB_TAG
341 # endif
342 # endif
343 #endif
344
345 /* If we cannot use 8-byte alignment, make DECL_ALIGN a no-op. */
346 #ifndef DECL_ALIGN
347 # ifdef USE_LSB_TAG
348 # error "USE_LSB_TAG used without defining DECL_ALIGN"
349 # endif
350 # define DECL_ALIGN(type, var) type var
351 #endif
352
353 \f
354 /* These macros extract various sorts of values from a Lisp_Object.
355 For example, if tem is a Lisp_Object whose type is Lisp_Cons,
356 XCONS (tem) is the struct Lisp_Cons * pointing to the memory for that cons. */
357
358 #ifdef NO_UNION_TYPE
359
360 #ifdef USE_LSB_TAG
361
362 #define TYPEMASK ((((EMACS_INT) 1) << GCTYPEBITS) - 1)
363 #define XTYPE(a) ((enum Lisp_Type) (((EMACS_UINT) (a)) & TYPEMASK))
364 #define XINT(a) (((EMACS_INT) (a)) >> GCTYPEBITS)
365 #define XUINT(a) (((EMACS_UINT) (a)) >> GCTYPEBITS)
366 #define XSET(var, type, ptr) \
367 (eassert (XTYPE (ptr) == 0), /* Check alignment. */ \
368 (var) = ((EMACS_INT) (type)) | ((EMACS_INT) (ptr)))
369 #define make_number(N) (((EMACS_INT) (N)) << GCTYPEBITS)
370
371 /* XFASTINT and XSETFASTINT are for use when the integer is known to be
372 positive, in which case the implementation can sometimes be faster
373 depending on the tagging scheme. With USE_LSB_TAG, there's no benefit. */
374 #define XFASTINT(a) XINT (a)
375 #define XSETFASTINT(a, b) ((a) = make_number (b))
376
377 #define XPNTR(a) ((EMACS_INT) ((a) & ~TYPEMASK))
378
379 #else /* not USE_LSB_TAG */
380
381 #define VALMASK ((((EMACS_INT) 1) << VALBITS) - 1)
382
383 /* One need to override this if there must be high bits set in data space
384 (doing the result of the below & ((1 << (GCTYPE + 1)) - 1) would work
385 on all machines, but would penalize machines which don't need it)
386 */
387 #define XTYPE(a) ((enum Lisp_Type) (((EMACS_UINT) (a)) >> VALBITS))
388
389 /* For integers known to be positive, XFASTINT provides fast retrieval
390 and XSETFASTINT provides fast storage. This takes advantage of the
391 fact that Lisp_Int is 0. */
392 #define XFASTINT(a) ((a) + 0)
393 #define XSETFASTINT(a, b) ((a) = (b))
394
395 /* Extract the value of a Lisp_Object as a signed integer. */
396
397 #ifndef XINT /* Some machines need to do this differently. */
398 #define XINT(a) ((((EMACS_INT) (a)) << (BITS_PER_EMACS_INT - VALBITS)) \
399 >> (BITS_PER_EMACS_INT - VALBITS))
400 #endif
401
402 /* Extract the value as an unsigned integer. This is a basis
403 for extracting it as a pointer to a structure in storage. */
404
405 #ifndef XUINT
406 #define XUINT(a) ((EMACS_UINT) ((a) & VALMASK))
407 #endif
408
409 #ifndef XSET
410 #define XSET(var, type, ptr) \
411 ((var) = ((EMACS_INT)(type) << VALBITS) + ((EMACS_INT) (ptr) & VALMASK))
412 #endif
413
414 /* Convert a C integer into a Lisp_Object integer. */
415
416 #define make_number(N) \
417 ((((EMACS_INT) (N)) & VALMASK) | ((EMACS_INT) Lisp_Int) << VALBITS)
418
419 #endif /* not USE_LSB_TAG */
420
421 #define EQ(x, y) ((x) == (y))
422
423 #else /* not NO_UNION_TYPE */
424
425 #define XTYPE(a) ((enum Lisp_Type) (a).u.type)
426
427 /* For integers known to be positive, XFASTINT provides fast retrieval
428 and XSETFASTINT provides fast storage. This takes advantage of the
429 fact that Lisp_Int is 0. */
430 #define XFASTINT(a) ((a).i + 0)
431 #define XSETFASTINT(a, b) ((a).i = (b))
432
433 #ifdef EXPLICIT_SIGN_EXTEND
434 /* Make sure we sign-extend; compilers have been known to fail to do so. */
435 #define XINT(a) (((a).s.val << (BITS_PER_EMACS_INT - VALBITS)) \
436 >> (BITS_PER_EMACS_INT - VALBITS))
437 #else
438 #define XINT(a) ((a).s.val)
439 #endif /* EXPLICIT_SIGN_EXTEND */
440
441 #define XUINT(a) ((a).u.val)
442
443 #define XSET(var, vartype, ptr) \
444 (((var).s.val = ((EMACS_INT) (ptr))), ((var).s.type = ((char) (vartype))))
445
446 #if __GNUC__ >= 2 && defined (__OPTIMIZE__)
447 #define make_number(N) \
448 (__extension__ ({ Lisp_Object _l; _l.s.val = (N); _l.s.type = Lisp_Int; _l; }))
449 #else
450 extern Lisp_Object make_number ();
451 #endif
452
453 #define EQ(x, y) ((x).s.val == (y).s.val && (x).s.type == (y).s.type)
454
455 #endif /* NO_UNION_TYPE */
456
457 /* During garbage collection, XGCTYPE must be used for extracting types
458 so that the mark bit is ignored. XMARKBIT accesses the markbit.
459 Markbits are used only in particular slots of particular structure types.
460 Other markbits are always zero.
461 Outside of garbage collection, all mark bits are always zero. */
462
463 #ifndef XGCTYPE
464 /* The distinction does not exist now that the MARKBIT has been eliminated. */
465 #define XGCTYPE(a) XTYPE (a)
466 #endif
467
468 #ifndef XPNTR
469 #ifdef HAVE_SHM
470 /* In this representation, data is found in two widely separated segments. */
471 extern size_t pure_size;
472 #define XPNTR(a) \
473 (XUINT (a) | (XUINT (a) > pure_size ? DATA_SEG_BITS : PURE_SEG_BITS))
474 #else /* not HAVE_SHM */
475 #ifdef DATA_SEG_BITS
476 /* This case is used for the rt-pc.
477 In the diffs I was given, it checked for ptr = 0
478 and did not adjust it in that case.
479 But I don't think that zero should ever be found
480 in a Lisp object whose data type says it points to something. */
481 #define XPNTR(a) (XUINT (a) | DATA_SEG_BITS)
482 #else
483 #define XPNTR(a) XUINT (a)
484 #endif
485 #endif /* not HAVE_SHM */
486 #endif /* no XPNTR */
487
488 /* Largest and smallest representable fixnum values. These are the C
489 values. */
490
491 #define MOST_NEGATIVE_FIXNUM - ((EMACS_INT) 1 << (VALBITS - 1))
492 #define MOST_POSITIVE_FIXNUM (((EMACS_INT) 1 << (VALBITS - 1)) - 1)
493 /* Mask indicating the significant bits of a Lisp_Int.
494 I.e. (x & INTMASK) == XUINT (make_number (x)). */
495 #define INTMASK ((((EMACS_INT) 1) << VALBITS) - 1)
496
497 /* Value is non-zero if C integer I doesn't fit into a Lisp fixnum. */
498
499 #define FIXNUM_OVERFLOW_P(i) \
500 ((EMACS_INT)(i) > MOST_POSITIVE_FIXNUM \
501 || (EMACS_INT) (i) < MOST_NEGATIVE_FIXNUM)
502
503 /* Extract a value or address from a Lisp_Object. */
504
505 #define XCONS(a) (eassert (GC_CONSP(a)),(struct Lisp_Cons *) XPNTR(a))
506 #define XVECTOR(a) (eassert (GC_VECTORLIKEP(a)),(struct Lisp_Vector *) XPNTR(a))
507 #define XSTRING(a) (eassert (GC_STRINGP(a)),(struct Lisp_String *) XPNTR(a))
508 #define XSYMBOL(a) (eassert (GC_SYMBOLP(a)),(struct Lisp_Symbol *) XPNTR(a))
509 #define XFLOAT(a) (eassert (GC_FLOATP(a)),(struct Lisp_Float *) XPNTR(a))
510
511 /* Misc types. */
512
513 #define XMISC(a) ((union Lisp_Misc *) XPNTR(a))
514 #define XMISCTYPE(a) (XMARKER (a)->type)
515 #define XMARKER(a) (&(XMISC(a)->u_marker))
516 #define XINTFWD(a) (&(XMISC(a)->u_intfwd))
517 #define XBOOLFWD(a) (&(XMISC(a)->u_boolfwd))
518 #define XOBJFWD(a) (&(XMISC(a)->u_objfwd))
519 #define XBUFFER_OBJFWD(a) (&(XMISC(a)->u_buffer_objfwd))
520 #define XBUFFER_LOCAL_VALUE(a) (&(XMISC(a)->u_buffer_local_value))
521 #define XOVERLAY(a) (&(XMISC(a)->u_overlay))
522 #define XKBOARD_OBJFWD(a) (&(XMISC(a)->u_kboard_objfwd))
523 #define XSAVE_VALUE(a) (&(XMISC(a)->u_save_value))
524
525 /* Pseudovector types. */
526
527 #define XPROCESS(a) (eassert (GC_PROCESSP(a)),(struct Lisp_Process *) XPNTR(a))
528 #define XWINDOW(a) (eassert (GC_WINDOWP(a)),(struct window *) XPNTR(a))
529 #define XSUBR(a) (eassert (GC_SUBRP(a)),(struct Lisp_Subr *) XPNTR(a))
530 #define XBUFFER(a) (eassert (GC_BUFFERP(a)),(struct buffer *) XPNTR(a))
531 #define XCHAR_TABLE(a) ((struct Lisp_Char_Table *) XPNTR(a))
532 #define XSUB_CHAR_TABLE(a) ((struct Lisp_Sub_Char_Table *) XPNTR(a))
533 #define XBOOL_VECTOR(a) ((struct Lisp_Bool_Vector *) XPNTR(a))
534
535 /* Construct a Lisp_Object from a value or address. */
536
537 #define XSETINT(a, b) (a) = make_number (b)
538 #define XSETCONS(a, b) XSET (a, Lisp_Cons, b)
539 #define XSETVECTOR(a, b) XSET (a, Lisp_Vectorlike, b)
540 #define XSETSTRING(a, b) XSET (a, Lisp_String, b)
541 #define XSETSYMBOL(a, b) XSET (a, Lisp_Symbol, b)
542 #define XSETFLOAT(a, b) XSET (a, Lisp_Float, b)
543
544 /* Misc types. */
545
546 #define XSETMISC(a, b) XSET (a, Lisp_Misc, b)
547 #define XSETMARKER(a, b) (XSETMISC (a, b), XMISCTYPE (a) = Lisp_Misc_Marker)
548
549 /* Pseudovector types. */
550
551 #define XSETPSEUDOVECTOR(a, b, code) \
552 (XSETVECTOR (a, b), XVECTOR (a)->size |= PSEUDOVECTOR_FLAG | (code))
553 #define XSETWINDOW_CONFIGURATION(a, b) \
554 (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW_CONFIGURATION))
555 #define XSETPROCESS(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_PROCESS))
556 #define XSETWINDOW(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW))
557 #define XSETSUBR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUBR))
558 #define XSETCOMPILED(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_COMPILED))
559 #define XSETBUFFER(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BUFFER))
560 #define XSETCHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_CHAR_TABLE))
561 #define XSETBOOL_VECTOR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BOOL_VECTOR))
562 #define XSETSUB_CHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUB_CHAR_TABLE))
563
564 /* Convenience macros for dealing with Lisp arrays. */
565
566 #define AREF(ARRAY, IDX) XVECTOR ((ARRAY))->contents[IDX]
567 #define ASET(ARRAY, IDX, VAL) (AREF ((ARRAY), (IDX)) = (VAL))
568 #define ASIZE(ARRAY) XVECTOR ((ARRAY))->size
569
570 /* Convenience macros for dealing with Lisp strings. */
571
572 #define SREF(string, index) (XSTRING (string)->data[index] + 0)
573 #define SSET(string, index, new) (XSTRING (string)->data[index] = (new))
574 #define SDATA(string) (XSTRING (string)->data + 0)
575 #define SCHARS(string) (XSTRING (string)->size + 0)
576 #define SBYTES(string) (STRING_BYTES (XSTRING (string)) + 0)
577
578 #define STRING_SET_CHARS(string, newsize) \
579 (XSTRING (string)->size = (newsize))
580
581 #define STRING_COPYIN(string, index, new, count) \
582 bcopy (new, XSTRING (string)->data + index, count)
583
584 \f
585 /* See the macros in intervals.h. */
586
587 typedef struct interval *INTERVAL;
588
589 /* Complain if object is not string or buffer type */
590 #define CHECK_STRING_OR_BUFFER(x) \
591 { if (!STRINGP ((x)) && !BUFFERP ((x))) \
592 x = wrong_type_argument (Qbuffer_or_string_p, (x)); }
593 \f
594 /* In a cons, the markbit of the car is the gc mark bit */
595
596 struct Lisp_Cons
597 {
598 /* Please do not use the names of these elements in code other
599 than the core lisp implementation. Use XCAR and XCDR below. */
600 #ifdef HIDE_LISP_IMPLEMENTATION
601 Lisp_Object car_, cdr_;
602 #else
603 Lisp_Object car, cdr;
604 #endif
605 };
606
607 /* Take the car or cdr of something known to be a cons cell. */
608 /* The _AS_LVALUE macros shouldn't be used outside of the minimal set
609 of code that has to know what a cons cell looks like. Other code not
610 part of the basic lisp implementation should assume that the car and cdr
611 fields are not accessible as lvalues. (What if we want to switch to
612 a copying collector someday? Cached cons cell field addresses may be
613 invalidated at arbitrary points.) */
614 #ifdef HIDE_LISP_IMPLEMENTATION
615 #define XCAR_AS_LVALUE(c) (XCONS ((c))->car_)
616 #define XCDR_AS_LVALUE(c) (XCONS ((c))->cdr_)
617 #else
618 #define XCAR_AS_LVALUE(c) (XCONS ((c))->car)
619 #define XCDR_AS_LVALUE(c) (XCONS ((c))->cdr)
620 #endif
621
622 /* Use these from normal code. */
623 #define XCAR(c) LISP_MAKE_RVALUE(XCAR_AS_LVALUE(c))
624 #define XCDR(c) LISP_MAKE_RVALUE(XCDR_AS_LVALUE(c))
625
626 /* Use these to set the fields of a cons cell.
627
628 Note that both arguments may refer to the same object, so 'n'
629 should not be read after 'c' is first modified. Also, neither
630 argument should be evaluated more than once; side effects are
631 especially common in the second argument. */
632 #define XSETCAR(c,n) (XCAR_AS_LVALUE(c) = (n))
633 #define XSETCDR(c,n) (XCDR_AS_LVALUE(c) = (n))
634
635 /* For performance: Fast storage of positive integers into the
636 fields of a cons cell. See above caveats. */
637 #define XSETCARFASTINT(c,n) XSETFASTINT(XCAR_AS_LVALUE(c),(n))
638 #define XSETCDRFASTINT(c,n) XSETFASTINT(XCDR_AS_LVALUE(c),(n))
639
640 /* Take the car or cdr of something whose type is not known. */
641 #define CAR(c) \
642 (CONSP ((c)) ? XCAR ((c)) \
643 : NILP ((c)) ? Qnil \
644 : wrong_type_argument (Qlistp, (c)))
645
646 #define CDR(c) \
647 (CONSP ((c)) ? XCDR ((c)) \
648 : NILP ((c)) ? Qnil \
649 : wrong_type_argument (Qlistp, (c)))
650
651 /* Nonzero if STR is a multibyte string. */
652 #define STRING_MULTIBYTE(STR) \
653 (XSTRING (STR)->size_byte >= 0)
654
655 /* Return the length in bytes of STR. */
656
657 #ifdef GC_CHECK_STRING_BYTES
658
659 struct Lisp_String;
660 extern int string_bytes P_ ((struct Lisp_String *));
661 #define STRING_BYTES(S) string_bytes ((S))
662
663 #else /* not GC_CHECK_STRING_BYTES */
664
665 #define STRING_BYTES(STR) \
666 ((STR)->size_byte < 0 ? (STR)->size : (STR)->size_byte)
667
668 #endif /* not GC_CHECK_STRING_BYTES */
669
670 /* Mark STR as a unibyte string. */
671 #define STRING_SET_UNIBYTE(STR) (XSTRING (STR)->size_byte = -1)
672
673 /* Get text properties. */
674 #define STRING_INTERVALS(STR) (XSTRING (STR)->intervals + 0)
675
676 /* Set text properties. */
677 #define STRING_SET_INTERVALS(STR, INT) (XSTRING (STR)->intervals = (INT))
678
679 /* In a string or vector, the sign bit of the `size' is the gc mark bit */
680
681 struct Lisp_String
682 {
683 EMACS_INT size;
684 EMACS_INT size_byte;
685 INTERVAL intervals; /* text properties in this string */
686 unsigned char *data;
687 };
688
689 /* If a struct is made to look like a vector, this macro returns the length
690 of the shortest vector that would hold that struct. */
691 #define VECSIZE(type) ((sizeof (type) - (sizeof (struct Lisp_Vector) \
692 - sizeof (Lisp_Object)) \
693 + sizeof(Lisp_Object) - 1) /* round up */ \
694 / sizeof (Lisp_Object))
695
696 struct Lisp_Vector
697 {
698 EMACS_INT size;
699 struct Lisp_Vector *next;
700 Lisp_Object contents[1];
701 };
702
703 /* A char-table is a kind of vectorlike, with contents are like a
704 vector but with a few other slots. For some purposes, it makes
705 sense to handle a char-table with type struct Lisp_Vector. An
706 element of a char table can be any Lisp objects, but if it is a sub
707 char-table, we treat it a table that contains information of a
708 specific range of characters. A sub char-table has the same
709 structure as a vector. A sub char table appears only in an element
710 of a char-table, and there's no way to access it directly from
711 Emacs Lisp program. */
712
713 /* This is the number of slots that every char table must have. This
714 counts the ordinary slots and the top, defalt, parent, and purpose
715 slots. */
716 #define CHAR_TABLE_STANDARD_SLOTS (VECSIZE (struct Lisp_Char_Table) - 1)
717
718 /* Return the number of "extra" slots in the char table CT. */
719
720 #define CHAR_TABLE_EXTRA_SLOTS(CT) \
721 (((CT)->size & PSEUDOVECTOR_SIZE_MASK) - CHAR_TABLE_STANDARD_SLOTS)
722
723 /* Almost equivalent to Faref (CT, IDX) with optimization for ASCII
724 characters. Do not check validity of CT. */
725 #define CHAR_TABLE_REF(CT, IDX) \
726 ((ASCII_CHAR_P (IDX) \
727 && SUB_CHAR_TABLE_P (XCHAR_TABLE (CT)->ascii) \
728 && !NILP (XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX])) \
729 ? XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX] \
730 : char_table_ref ((CT), (IDX)))
731
732 /* Almost equivalent to Faref (CT, IDX). However, if the result is
733 not a character, return IDX.
734
735 For these characters, do not check validity of CT
736 and do not follow parent. */
737 #define CHAR_TABLE_TRANSLATE(CT, IDX) \
738 char_table_translate (CT, IDX)
739
740 /* Equivalent to Faset (CT, IDX, VAL) with optimization for ASCII and
741 8-bit European characters. Do not check validity of CT. */
742 #define CHAR_TABLE_SET(CT, IDX, VAL) \
743 (((IDX) >= 0 && ASCII_CHAR_P (IDX) \
744 && SUB_CHAR_TABLE_P (XCHAR_TABLE (CT)->ascii)) \
745 ? XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX] = VAL \
746 : char_table_set (CT, IDX, VAL))
747
748 #define CHARTAB_SIZE_BITS_0 6
749 #define CHARTAB_SIZE_BITS_1 4
750 #define CHARTAB_SIZE_BITS_2 5
751 #define CHARTAB_SIZE_BITS_3 7
752
753 extern const int chartab_size[4];
754
755 struct Lisp_Sub_Char_Table;
756
757 struct Lisp_Char_Table
758 {
759 /* This is the vector's size field, which also holds the
760 pseudovector type information. It holds the size, too. The size
761 counts the defalt, parent, purpose, ascii, contents, and extras
762 slots. */
763 EMACS_INT size;
764 struct Lisp_Vector *next;
765
766 /* This holds a default value,
767 which is used whenever the value for a specific character is nil. */
768 Lisp_Object defalt;
769
770 /* This points to another char table, which we inherit from when the
771 value for a specific character is nil. The `defalt' slot takes
772 precedence over this. */
773 Lisp_Object parent;
774
775 /* This is a symbol which says what kind of use this char-table is
776 meant for. */
777 Lisp_Object purpose;
778
779 /* The bottom sub char-table for characters of the range 0..127. It
780 is nil if none of ASCII character has a specific value. */
781 Lisp_Object ascii;
782
783 Lisp_Object contents[(1 << CHARTAB_SIZE_BITS_0)];
784
785 /* These hold additional data. It is a vector. */
786 Lisp_Object extras[1];
787 };
788
789 struct Lisp_Sub_Char_Table
790 {
791 /* This is the vector's size field, which also holds the
792 pseudovector type information. It holds the size, too. */
793 EMACS_INT size;
794 struct Lisp_Vector *next;
795
796 /* Depth of this sub char-table. It should be 1, 2, or 3. A sub
797 char-table of depth 1 contains 16 elments, and each element
798 covers 4096 (128*32) characters. A sub char-table of depth 2
799 contains 32 elements, and each element covers 128 characters. A
800 sub char-table of depth 3 contains 128 elements, and each element
801 is for one character. */
802 Lisp_Object depth;
803
804 /* Minimum character covered by the sub char-table. */
805 Lisp_Object min_char;
806
807 Lisp_Object contents[1];
808 };
809
810 /* A boolvector is a kind of vectorlike, with contents are like a string. */
811 struct Lisp_Bool_Vector
812 {
813 /* This is the vector's size field. It doesn't have the real size,
814 just the subtype information. */
815 EMACS_INT vector_size;
816 struct Lisp_Vector *next;
817 /* This is the size in bits. */
818 EMACS_INT size;
819 /* This contains the actual bits, packed into bytes. */
820 unsigned char data[1];
821 };
822
823 /* This structure describes a built-in function.
824 It is generated by the DEFUN macro only.
825 defsubr makes it into a Lisp object.
826
827 This type is treated in most respects as a pseudovector,
828 but since we never dynamically allocate or free them,
829 we don't need a next-vector field. */
830
831 struct Lisp_Subr
832 {
833 EMACS_INT size;
834 Lisp_Object (*function) ();
835 short min_args, max_args;
836 char *symbol_name;
837 char *prompt;
838 char *doc;
839 };
840
841 \f
842 /***********************************************************************
843 Symbols
844 ***********************************************************************/
845
846 /* Interned state of a symbol. */
847
848 enum symbol_interned
849 {
850 SYMBOL_UNINTERNED = 0,
851 SYMBOL_INTERNED = 1,
852 SYMBOL_INTERNED_IN_INITIAL_OBARRAY = 2
853 };
854
855 /* In a symbol, the markbit of the plist is used as the gc mark bit */
856
857 struct Lisp_Symbol
858 {
859 unsigned gcmarkbit : 1;
860
861 /* Non-zero means symbol serves as a variable alias. The symbol
862 holding the real value is found in the value slot. */
863 unsigned indirect_variable : 1;
864
865 /* Non-zero means symbol is constant, i.e. changing its value
866 should signal an error. */
867 unsigned constant : 1;
868
869 /* Interned state of the symbol. This is an enumerator from
870 enum symbol_interned. */
871 unsigned interned : 2;
872
873 /* The symbol's name, as a Lisp string.
874
875 The name "xname" is used to intentionally break code referring to
876 the old field "name" of type pointer to struct Lisp_String. */
877 Lisp_Object xname;
878
879 /* Value of the symbol or Qunbound if unbound. If this symbol is a
880 defvaralias, `value' contains the symbol for which it is an
881 alias. Use the SYMBOL_VALUE and SET_SYMBOL_VALUE macros to get
882 and set a symbol's value, to take defvaralias into account. */
883 Lisp_Object value;
884
885 /* Function value of the symbol or Qunbound if not fboundp. */
886 Lisp_Object function;
887
888 /* The symbol's property list. */
889 Lisp_Object plist;
890
891 /* Next symbol in obarray bucket, if the symbol is interned. */
892 struct Lisp_Symbol *next;
893 };
894
895 /* Value is name of symbol. */
896
897 #define SYMBOL_NAME(sym) \
898 LISP_MAKE_RVALUE (XSYMBOL (sym)->xname)
899
900 /* Value is non-zero if SYM is an interned symbol. */
901
902 #define SYMBOL_INTERNED_P(sym) \
903 (XSYMBOL (sym)->interned != SYMBOL_UNINTERNED)
904
905 /* Value is non-zero if SYM is interned in initial_obarray. */
906
907 #define SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P(sym) \
908 (XSYMBOL (sym)->interned == SYMBOL_INTERNED_IN_INITIAL_OBARRAY)
909
910 /* Value is non-zero if symbol is considered a constant, i.e. its
911 value cannot be changed (there is an exception for keyword symbols,
912 whose value can be set to the keyword symbol itself). */
913
914 #define SYMBOL_CONSTANT_P(sym) XSYMBOL (sym)->constant
915
916 /* Value is the value of SYM, with defvaralias taken into
917 account. */
918
919 #define SYMBOL_VALUE(sym) \
920 (XSYMBOL (sym)->indirect_variable \
921 ? XSYMBOL (indirect_variable (sym))->value \
922 : XSYMBOL (sym)->value)
923
924 /* Set SYM's value to VAL, taking defvaralias into account. */
925
926 #define SET_SYMBOL_VALUE(sym, val) \
927 do { \
928 if (XSYMBOL (sym)->indirect_variable) \
929 XSYMBOL (indirect_variable ((sym)))->value = (val); \
930 else \
931 XSYMBOL (sym)->value = (val); \
932 } while (0)
933
934 \f
935 /***********************************************************************
936 Hash Tables
937 ***********************************************************************/
938
939 /* The structure of a Lisp hash table. */
940
941 struct Lisp_Hash_Table
942 {
943 /* Vector fields. The hash table code doesn't refer to these. */
944 EMACS_INT size;
945 struct Lisp_Vector *vec_next;
946
947 /* Function used to compare keys. */
948 Lisp_Object test;
949
950 /* Nil if table is non-weak. Otherwise a symbol describing the
951 weakness of the table. */
952 Lisp_Object weak;
953
954 /* When the table is resized, and this is an integer, compute the
955 new size by adding this to the old size. If a float, compute the
956 new size by multiplying the old size with this factor. */
957 Lisp_Object rehash_size;
958
959 /* Resize hash table when number of entries/ table size is >= this
960 ratio, a float. */
961 Lisp_Object rehash_threshold;
962
963 /* Number of key/value entries in the table. */
964 Lisp_Object count;
965
966 /* Vector of keys and values. The key of item I is found at index
967 2 * I, the value is found at index 2 * I + 1. */
968 Lisp_Object key_and_value;
969
970 /* Vector of hash codes.. If hash[I] is nil, this means that that
971 entry I is unused. */
972 Lisp_Object hash;
973
974 /* Vector used to chain entries. If entry I is free, next[I] is the
975 entry number of the next free item. If entry I is non-free,
976 next[I] is the index of the next entry in the collision chain. */
977 Lisp_Object next;
978
979 /* Index of first free entry in free list. */
980 Lisp_Object next_free;
981
982 /* Bucket vector. A non-nil entry is the index of the first item in
983 a collision chain. This vector's size can be larger than the
984 hash table size to reduce collisions. */
985 Lisp_Object index;
986
987 /* Next weak hash table if this is a weak hash table. The head
988 of the list is in Vweak_hash_tables. */
989 Lisp_Object next_weak;
990
991 /* User-supplied hash function, or nil. */
992 Lisp_Object user_hash_function;
993
994 /* User-supplied key comparison function, or nil. */
995 Lisp_Object user_cmp_function;
996
997 /* C function to compare two keys. */
998 int (* cmpfn) P_ ((struct Lisp_Hash_Table *, Lisp_Object,
999 unsigned, Lisp_Object, unsigned));
1000
1001 /* C function to compute hash code. */
1002 unsigned (* hashfn) P_ ((struct Lisp_Hash_Table *, Lisp_Object));
1003 };
1004
1005
1006 #define XHASH_TABLE(OBJ) \
1007 ((struct Lisp_Hash_Table *) XPNTR (OBJ))
1008
1009 #define XSET_HASH_TABLE(VAR, PTR) \
1010 (XSETPSEUDOVECTOR (VAR, PTR, PVEC_HASH_TABLE))
1011
1012 #define HASH_TABLE_P(OBJ) PSEUDOVECTORP (OBJ, PVEC_HASH_TABLE)
1013 #define GC_HASH_TABLE_P(x) GC_PSEUDOVECTORP (x, PVEC_HASH_TABLE)
1014
1015 #define CHECK_HASH_TABLE(x) \
1016 do \
1017 { \
1018 if (!HASH_TABLE_P ((x))) \
1019 x = wrong_type_argument (Qhash_table_p, (x)); \
1020 } \
1021 while (0)
1022
1023 /* Value is the key part of entry IDX in hash table H. */
1024
1025 #define HASH_KEY(H, IDX) AREF ((H)->key_and_value, 2 * (IDX))
1026
1027 /* Value is the value part of entry IDX in hash table H. */
1028
1029 #define HASH_VALUE(H, IDX) AREF ((H)->key_and_value, 2 * (IDX) + 1)
1030
1031 /* Value is the index of the next entry following the one at IDX
1032 in hash table H. */
1033
1034 #define HASH_NEXT(H, IDX) AREF ((H)->next, (IDX))
1035
1036 /* Value is the hash code computed for entry IDX in hash table H. */
1037
1038 #define HASH_HASH(H, IDX) AREF ((H)->hash, (IDX))
1039
1040 /* Value is the index of the element in hash table H that is the
1041 start of the collision list at index IDX in the index vector of H. */
1042
1043 #define HASH_INDEX(H, IDX) AREF ((H)->index, (IDX))
1044
1045 /* Value is the size of hash table H. */
1046
1047 #define HASH_TABLE_SIZE(H) XVECTOR ((H)->next)->size
1048
1049 /* Default size for hash tables if not specified. */
1050
1051 #define DEFAULT_HASH_SIZE 65
1052
1053 /* Default threshold specifying when to resize a hash table. The
1054 value gives the ratio of current entries in the hash table and the
1055 size of the hash table. */
1056
1057 #define DEFAULT_REHASH_THRESHOLD 0.8
1058
1059 /* Default factor by which to increase the size of a hash table. */
1060
1061 #define DEFAULT_REHASH_SIZE 1.5
1062
1063 \f
1064 /* These structures are used for various misc types. */
1065
1066 struct Lisp_Marker
1067 {
1068 int type : 16; /* = Lisp_Misc_Marker */
1069 unsigned gcmarkbit : 1;
1070 int spacer : 14;
1071 /* 1 means normal insertion at the marker's position
1072 leaves the marker after the inserted text. */
1073 unsigned int insertion_type : 1;
1074 /* This is the buffer that the marker points into,
1075 or 0 if it points nowhere. */
1076 struct buffer *buffer;
1077
1078 /* The remaining fields are meaningless in a marker that
1079 does not point anywhere. */
1080
1081 /* For markers that point somewhere,
1082 this is used to chain of all the markers in a given buffer. */
1083 struct Lisp_Marker *next;
1084 /* This is the char position where the marker points. */
1085 EMACS_INT charpos;
1086 /* This is the byte position. */
1087 EMACS_INT bytepos;
1088 };
1089
1090 /* Forwarding pointer to an int variable.
1091 This is allowed only in the value cell of a symbol,
1092 and it means that the symbol's value really lives in the
1093 specified int variable. */
1094 struct Lisp_Intfwd
1095 {
1096 int type : 16; /* = Lisp_Misc_Intfwd */
1097 unsigned gcmarkbit : 1;
1098 int spacer : 15;
1099 EMACS_INT *intvar;
1100 };
1101
1102 /* Boolean forwarding pointer to an int variable.
1103 This is like Lisp_Intfwd except that the ostensible
1104 "value" of the symbol is t if the int variable is nonzero,
1105 nil if it is zero. */
1106 struct Lisp_Boolfwd
1107 {
1108 int type : 16; /* = Lisp_Misc_Boolfwd */
1109 unsigned gcmarkbit : 1;
1110 int spacer : 15;
1111 int *boolvar;
1112 };
1113
1114 /* Forwarding pointer to a Lisp_Object variable.
1115 This is allowed only in the value cell of a symbol,
1116 and it means that the symbol's value really lives in the
1117 specified variable. */
1118 struct Lisp_Objfwd
1119 {
1120 int type : 16; /* = Lisp_Misc_Objfwd */
1121 unsigned gcmarkbit : 1;
1122 int spacer : 15;
1123 Lisp_Object *objvar;
1124 };
1125
1126 /* Like Lisp_Objfwd except that value lives in a slot in the
1127 current buffer. Value is byte index of slot within buffer. */
1128 struct Lisp_Buffer_Objfwd
1129 {
1130 int type : 16; /* = Lisp_Misc_Buffer_Objfwd */
1131 unsigned gcmarkbit : 1;
1132 int spacer : 15;
1133 int offset;
1134 };
1135
1136 /* struct Lisp_Buffer_Local_Value is used in a symbol value cell when
1137 the symbol has buffer-local or frame-local bindings. (Exception:
1138 some buffer-local variables are built-in, with their values stored
1139 in the buffer structure itself. They are handled differently,
1140 using struct Lisp_Buffer_Objfwd.)
1141
1142 The `realvalue' slot holds the variable's current value, or a
1143 forwarding pointer to where that value is kept. This value is the
1144 one that corresponds to the loaded binding. To read or set the
1145 variable, you must first make sure the right binding is loaded;
1146 then you can access the value in (or through) `realvalue'.
1147
1148 `buffer' and `frame' are the buffer and frame for which the loaded
1149 binding was found. If those have changed, to make sure the right
1150 binding is loaded it is necessary to find which binding goes with
1151 the current buffer and selected frame, then load it. To load it,
1152 first unload the previous binding, then copy the value of the new
1153 binding into `realvalue' (or through it). Also update
1154 LOADED-BINDING to point to the newly loaded binding.
1155
1156 Lisp_Misc_Buffer_Local_Value and Lisp_Misc_Some_Buffer_Local_Value
1157 both use this kind of structure. With the former, merely setting
1158 the variable creates a local binding for the current buffer. With
1159 the latter, setting the variable does not do that; only
1160 make-local-variable does that. */
1161
1162 struct Lisp_Buffer_Local_Value
1163 {
1164 int type : 16; /* = Lisp_Misc_Buffer_Local_Value
1165 or Lisp_Misc_Some_Buffer_Local_Value */
1166 unsigned gcmarkbit : 1;
1167 int spacer : 12;
1168
1169 /* 1 means this variable is allowed to have frame-local bindings,
1170 so check for them when looking for the proper binding. */
1171 unsigned int check_frame : 1;
1172 /* 1 means that the binding now loaded was found
1173 as a local binding for the buffer in the `buffer' slot. */
1174 unsigned int found_for_buffer : 1;
1175 /* 1 means that the binding now loaded was found
1176 as a local binding for the frame in the `frame' slot. */
1177 unsigned int found_for_frame : 1;
1178 Lisp_Object realvalue;
1179 /* The buffer and frame for which the loaded binding was found. */
1180 Lisp_Object buffer, frame;
1181
1182 /* A cons cell, (LOADED-BINDING . DEFAULT-VALUE).
1183
1184 LOADED-BINDING is the binding now loaded. It is a cons cell
1185 whose cdr is the binding's value. The cons cell may be an
1186 element of a buffer's local-variable alist, or an element of a
1187 frame's parameter alist, or it may be this cons cell.
1188
1189 DEFAULT-VALUE is the variable's default value, seen when the
1190 current buffer and selected frame do not have their own
1191 bindings for the variable. When the default binding is loaded,
1192 LOADED-BINDING is actually this very cons cell; thus, its car
1193 points to itself. */
1194 Lisp_Object cdr;
1195 };
1196
1197 /* START and END are markers in the overlay's buffer, and
1198 PLIST is the overlay's property list. */
1199 struct Lisp_Overlay
1200 {
1201 int type : 16; /* = Lisp_Misc_Overlay */
1202 unsigned gcmarkbit : 1;
1203 int spacer : 15;
1204 struct Lisp_Overlay *next;
1205 Lisp_Object start, end, plist;
1206 };
1207
1208 /* Like Lisp_Objfwd except that value lives in a slot in the
1209 current kboard. */
1210 struct Lisp_Kboard_Objfwd
1211 {
1212 int type : 16; /* = Lisp_Misc_Kboard_Objfwd */
1213 unsigned gcmarkbit : 1;
1214 int spacer : 15;
1215 int offset;
1216 };
1217
1218 /* Hold a C pointer for later use.
1219 This type of object is used in the arg to record_unwind_protect. */
1220 struct Lisp_Save_Value
1221 {
1222 int type : 16; /* = Lisp_Misc_Save_Value */
1223 unsigned gcmarkbit : 1;
1224 int spacer : 14;
1225 /* If DOGC is set, POINTER is the address of a memory
1226 area containing INTEGER potential Lisp_Objects. */
1227 unsigned int dogc : 1;
1228 void *pointer;
1229 int integer;
1230 };
1231
1232
1233 /* A miscellaneous object, when it's on the free list. */
1234 struct Lisp_Free
1235 {
1236 int type : 16; /* = Lisp_Misc_Free */
1237 unsigned gcmarkbit : 1;
1238 int spacer : 15;
1239 union Lisp_Misc *chain;
1240 #ifdef USE_LSB_TAG
1241 /* Try to make sure that sizeof(Lisp_Misc) preserves TYPEBITS-alignment.
1242 This assumes that Lisp_Marker is the largest of the alternatives and
1243 that Lisp_Intfwd has the same size as "Lisp_Free w/o padding". */
1244 char padding[((((sizeof (struct Lisp_Marker) - 1) >> GCTYPEBITS) + 1)
1245 << GCTYPEBITS) - sizeof (struct Lisp_Intfwd)];
1246 #endif
1247 };
1248
1249 /* To get the type field of a union Lisp_Misc, use XMISCTYPE.
1250 It uses one of these struct subtypes to get the type field. */
1251
1252 union Lisp_Misc
1253 {
1254 struct Lisp_Free u_free;
1255 struct Lisp_Marker u_marker;
1256 struct Lisp_Intfwd u_intfwd;
1257 struct Lisp_Boolfwd u_boolfwd;
1258 struct Lisp_Objfwd u_objfwd;
1259 struct Lisp_Buffer_Objfwd u_buffer_objfwd;
1260 struct Lisp_Buffer_Local_Value u_buffer_local_value;
1261 struct Lisp_Overlay u_overlay;
1262 struct Lisp_Kboard_Objfwd u_kboard_objfwd;
1263 struct Lisp_Save_Value u_save_value;
1264 };
1265 \f
1266 /* Lisp floating point type */
1267 struct Lisp_Float
1268 {
1269 #ifdef HIDE_LISP_IMPLEMENTATION
1270 double data_;
1271 #else
1272 double data;
1273 #endif
1274 };
1275
1276 #ifdef HIDE_LISP_IMPLEMENTATION
1277 #define XFLOAT_DATA(f) (XFLOAT (f)->data_)
1278 #else
1279 #define XFLOAT_DATA(f) (XFLOAT (f)->data)
1280 #endif
1281
1282 /* A character, declared with the following typedef, is a member
1283 of some character set associated with the current buffer. */
1284 #ifndef _UCHAR_T /* Protect against something in ctab.h on AIX. */
1285 #define _UCHAR_T
1286 typedef unsigned char UCHAR;
1287 #endif
1288
1289 /* Meanings of slots in a Lisp_Compiled: */
1290
1291 #define COMPILED_ARGLIST 0
1292 #define COMPILED_BYTECODE 1
1293 #define COMPILED_CONSTANTS 2
1294 #define COMPILED_STACK_DEPTH 3
1295 #define COMPILED_DOC_STRING 4
1296 #define COMPILED_INTERACTIVE 5
1297
1298 /* Flag bits in a character. These also get used in termhooks.h.
1299 Richard Stallman <rms@gnu.ai.mit.edu> thinks that MULE
1300 (MUlti-Lingual Emacs) might need 22 bits for the character value
1301 itself, so we probably shouldn't use any bits lower than 0x0400000. */
1302 #define CHAR_ALT (0x0400000)
1303 #define CHAR_SUPER (0x0800000)
1304 #define CHAR_HYPER (0x1000000)
1305 #define CHAR_SHIFT (0x2000000)
1306 #define CHAR_CTL (0x4000000)
1307 #define CHAR_META (0x8000000)
1308
1309 #define CHAR_MODIFIER_MASK \
1310 (CHAR_ALT | CHAR_SUPER | CHAR_HYPER | CHAR_SHIFT | CHAR_CTL | CHAR_META)
1311
1312
1313 /* Actually, the current Emacs uses 22 bits for the character value
1314 itself. */
1315 #define CHARACTERBITS 22
1316
1317 /* The maximum byte size consumed by push_key_description.
1318 All callers should assure that at least this size of memory is
1319 allocated at the place pointed by the second argument.
1320
1321 Thers are 6 modifiers, each consumes 2 chars.
1322 The octal form of a character code consumes
1323 (1 + CHARACTERBITS / 3 + 1) chars (including backslash at the head).
1324 We need one more byte for string terminator `\0'. */
1325 #define KEY_DESCRIPTION_SIZE ((2 * 6) + 1 + (CHARACTERBITS / 3) + 1 + 1)
1326
1327 #ifdef USE_X_TOOLKIT
1328 #ifdef NO_UNION_TYPE
1329 /* Use this for turning a (void *) into a Lisp_Object, as when the
1330 Lisp_Object is passed into a toolkit callback function. */
1331 #define VOID_TO_LISP(larg,varg) \
1332 do { ((larg) = ((Lisp_Object) (varg))); } while (0)
1333 #define CVOID_TO_LISP VOID_TO_LISP
1334
1335 /* Use this for turning a Lisp_Object into a (void *), as when the
1336 Lisp_Object is passed into a toolkit callback function. */
1337 #define LISP_TO_VOID(larg) ((void *) (larg))
1338 #define LISP_TO_CVOID(varg) ((const void *) (larg))
1339
1340 #else /* not NO_UNION_TYPE */
1341 /* Use this for turning a (void *) into a Lisp_Object, as when the
1342 Lisp_Object is passed into a toolkit callback function. */
1343 #define VOID_TO_LISP(larg,varg) \
1344 do { ((larg).v = (void *) (varg)); } while (0)
1345 #define CVOID_TO_LISP(larg,varg) \
1346 do { ((larg).cv = (const void *) (varg)); } while (0)
1347
1348 /* Use this for turning a Lisp_Object into a (void *), as when the
1349 Lisp_Object is passed into a toolkit callback function. */
1350 #define LISP_TO_VOID(larg) ((larg).v)
1351 #define LISP_TO_CVOID(larg) ((larg).cv)
1352 #endif /* not NO_UNION_TYPE */
1353 #endif /* USE_X_TOOLKIT */
1354
1355 \f
1356 /* The glyph datatype, used to represent characters on the display. */
1357
1358 /* Glyph code to use as an index to the glyph table. If it is out of
1359 range for the glyph table, or the corresonding element in the table
1360 is nil, the low 8 bits are the single byte character code, and the
1361 bits above are the numeric face ID. If FID is the face ID of a
1362 glyph on a frame F, then F->display.x->faces[FID] contains the
1363 description of that face. This is an int instead of a short, so we
1364 can support a good bunch of face ID's (2^(31 - 8)); given that we
1365 have no mechanism for tossing unused frame face ID's yet, we'll
1366 probably run out of 255 pretty quickly.
1367 This is always -1 for a multibyte character. */
1368 #define GLYPH int
1369
1370 /* Mask bits for face. */
1371 #define GLYPH_MASK_FACE 0x7FC00000
1372 /* Mask bits for character code. */
1373 #define GLYPH_MASK_CHAR 0x003FFFFF /* The lowest 22 bits */
1374
1375 /* The FAST macros assume that we already know we're in an X window. */
1376
1377 /* Set a character code and a face ID in a glyph G. */
1378 #define FAST_MAKE_GLYPH(char, face) ((char) | ((face) << CHARACTERBITS))
1379
1380 /* Return a glyph's character code. */
1381 #define FAST_GLYPH_CHAR(glyph) ((glyph) & GLYPH_MASK_CHAR)
1382
1383 /* Return a glyph's face ID. */
1384 #define FAST_GLYPH_FACE(glyph) (((glyph) & GLYPH_MASK_FACE) >> CHARACTERBITS)
1385
1386 /* Slower versions that test the frame type first. */
1387 #define MAKE_GLYPH(f, char, face) (FAST_MAKE_GLYPH (char, face))
1388 #define GLYPH_CHAR(f, g) (FAST_GLYPH_CHAR (g))
1389 #define GLYPH_FACE(f, g) (FAST_GLYPH_FACE (g))
1390
1391 /* Return 1 iff GLYPH contains valid character code. */
1392 #define GLYPH_CHAR_VALID_P(glyph) CHAR_VALID_P (FAST_GLYPH_CHAR (glyph), 1)
1393
1394 /* The ID of the mode line highlighting face. */
1395 #define GLYPH_MODE_LINE_FACE 1
1396 \f
1397 /* Data type checking */
1398
1399 #define NILP(x) EQ (x, Qnil)
1400 #define GC_NILP(x) GC_EQ (x, Qnil)
1401
1402 #define NUMBERP(x) (INTEGERP (x) || FLOATP (x))
1403 #define GC_NUMBERP(x) (GC_INTEGERP (x) || GC_FLOATP (x))
1404 #define NATNUMP(x) (INTEGERP (x) && XINT (x) >= 0)
1405 #define GC_NATNUMP(x) (GC_INTEGERP (x) && XINT (x) >= 0)
1406
1407 #define INTEGERP(x) (XTYPE ((x)) == Lisp_Int)
1408 #define GC_INTEGERP(x) INTEGERP (x)
1409 #define SYMBOLP(x) (XTYPE ((x)) == Lisp_Symbol)
1410 #define GC_SYMBOLP(x) (XGCTYPE ((x)) == Lisp_Symbol)
1411 #define MISCP(x) (XTYPE ((x)) == Lisp_Misc)
1412 #define GC_MISCP(x) (XGCTYPE ((x)) == Lisp_Misc)
1413 #define VECTORLIKEP(x) (XTYPE ((x)) == Lisp_Vectorlike)
1414 #define GC_VECTORLIKEP(x) (XGCTYPE ((x)) == Lisp_Vectorlike)
1415 #define STRINGP(x) (XTYPE ((x)) == Lisp_String)
1416 #define GC_STRINGP(x) (XGCTYPE ((x)) == Lisp_String)
1417 #define CONSP(x) (XTYPE ((x)) == Lisp_Cons)
1418 #define GC_CONSP(x) (XGCTYPE ((x)) == Lisp_Cons)
1419
1420 #define FLOATP(x) (XTYPE ((x)) == Lisp_Float)
1421 #define GC_FLOATP(x) (XGCTYPE ((x)) == Lisp_Float)
1422 #define VECTORP(x) (VECTORLIKEP (x) && !(XVECTOR (x)->size & PSEUDOVECTOR_FLAG))
1423 #define GC_VECTORP(x) (GC_VECTORLIKEP (x) && !(XVECTOR (x)->size & PSEUDOVECTOR_FLAG))
1424 #define OVERLAYP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Overlay)
1425 #define GC_OVERLAYP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Overlay)
1426 #define MARKERP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Marker)
1427 #define GC_MARKERP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Marker)
1428 #define INTFWDP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Intfwd)
1429 #define GC_INTFWDP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Intfwd)
1430 #define BOOLFWDP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Boolfwd)
1431 #define GC_BOOLFWDP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Boolfwd)
1432 #define OBJFWDP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Objfwd)
1433 #define GC_OBJFWDP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Objfwd)
1434 #define BUFFER_OBJFWDP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Buffer_Objfwd)
1435 #define GC_BUFFER_OBJFWDP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Buffer_Objfwd)
1436 #define BUFFER_LOCAL_VALUEP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Buffer_Local_Value)
1437 #define GC_BUFFER_LOCAL_VALUEP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Buffer_Local_Value)
1438 #define SOME_BUFFER_LOCAL_VALUEP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Some_Buffer_Local_Value)
1439 #define GC_SOME_BUFFER_LOCAL_VALUEP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Some_Buffer_Local_Value)
1440 #define KBOARD_OBJFWDP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Kboard_Objfwd)
1441 #define GC_KBOARD_OBJFWDP(x) (GC_MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Kboard_Objfwd)
1442
1443
1444 /* True if object X is a pseudovector whose code is CODE. */
1445 #define PSEUDOVECTORP(x, code) \
1446 (VECTORLIKEP (x) \
1447 && (((XVECTOR (x)->size & (PSEUDOVECTOR_FLAG | (code)))) \
1448 == (PSEUDOVECTOR_FLAG | (code))))
1449
1450 /* True if object X is a pseudovector whose code is CODE.
1451 This one works during GC. */
1452 #define GC_PSEUDOVECTORP(x, code) \
1453 (GC_VECTORLIKEP (x) \
1454 && (((XVECTOR (x)->size & (PSEUDOVECTOR_FLAG | (code)))) \
1455 == (PSEUDOVECTOR_FLAG | (code))))
1456
1457 /* Test for specific pseudovector types. */
1458 #define WINDOW_CONFIGURATIONP(x) PSEUDOVECTORP (x, PVEC_WINDOW_CONFIGURATION)
1459 #define GC_WINDOW_CONFIGURATIONP(x) GC_PSEUDOVECTORP (x, PVEC_WINDOW_CONFIGURATION)
1460 #define PROCESSP(x) PSEUDOVECTORP (x, PVEC_PROCESS)
1461 #define GC_PROCESSP(x) GC_PSEUDOVECTORP (x, PVEC_PROCESS)
1462 #define WINDOWP(x) PSEUDOVECTORP (x, PVEC_WINDOW)
1463 #define GC_WINDOWP(x) GC_PSEUDOVECTORP (x, PVEC_WINDOW)
1464 #define SUBRP(x) PSEUDOVECTORP (x, PVEC_SUBR)
1465 #define GC_SUBRP(x) GC_PSEUDOVECTORP (x, PVEC_SUBR)
1466 #define COMPILEDP(x) PSEUDOVECTORP (x, PVEC_COMPILED)
1467 #define GC_COMPILEDP(x) GC_PSEUDOVECTORP (x, PVEC_COMPILED)
1468 #define BUFFERP(x) PSEUDOVECTORP (x, PVEC_BUFFER)
1469 #define GC_BUFFERP(x) GC_PSEUDOVECTORP (x, PVEC_BUFFER)
1470 #define CHAR_TABLE_P(x) PSEUDOVECTORP (x, PVEC_CHAR_TABLE)
1471 #define SUB_CHAR_TABLE_P(x) PSEUDOVECTORP (x, PVEC_SUB_CHAR_TABLE)
1472 #define GC_SUB_CHAR_TABLE_P(x) GC_PSEUDOVECTORP (x, PVEC_SUB_CHAR_TABLE)
1473 #define GC_CHAR_TABLE_P(x) GC_PSEUDOVECTORP (x, PVEC_CHAR_TABLE)
1474 #define BOOL_VECTOR_P(x) PSEUDOVECTORP (x, PVEC_BOOL_VECTOR)
1475 #define GC_BOOL_VECTOR_P(x) GC_PSEUDOVECTORP (x, PVEC_BOOL_VECTOR)
1476 #define FRAMEP(x) PSEUDOVECTORP (x, PVEC_FRAME)
1477 #define GC_FRAMEP(x) GC_PSEUDOVECTORP (x, PVEC_FRAME)
1478
1479 /* Test for image (image . spec) */
1480 #define IMAGEP(x) (CONSP (x) && EQ (XCAR (x), Qimage))
1481
1482 \f
1483 #define GC_EQ(x, y) EQ (x, y)
1484
1485 #define CHECK_LIST(x) \
1486 do { if (!CONSP ((x)) && !NILP (x)) x = wrong_type_argument (Qlistp, (x)); } while (0)
1487
1488 #define CHECK_STRING(x) \
1489 do { if (!STRINGP ((x))) x = wrong_type_argument (Qstringp, (x)); } while (0)
1490
1491 #define CHECK_STRING_CAR(x) \
1492 do { if (!STRINGP (XCAR (x))) XSETCAR (x, wrong_type_argument (Qstringp, XCAR (x))); } while (0)
1493
1494 #define CHECK_CONS(x) \
1495 do { if (!CONSP ((x))) x = wrong_type_argument (Qconsp, (x)); } while (0)
1496
1497 #define CHECK_SYMBOL(x) \
1498 do { if (!SYMBOLP ((x))) x = wrong_type_argument (Qsymbolp, (x)); } while (0)
1499
1500 #define CHECK_CHAR_TABLE(x) \
1501 do { if (!CHAR_TABLE_P ((x))) \
1502 x = wrong_type_argument (Qchar_table_p, (x)); } while (0)
1503
1504 #define CHECK_VECTOR(x) \
1505 do { if (!VECTORP ((x))) x = wrong_type_argument (Qvectorp, (x)); } while (0)
1506
1507 #define CHECK_VECTOR_OR_CHAR_TABLE(x) \
1508 do { if (!VECTORP ((x)) && !CHAR_TABLE_P ((x))) \
1509 x = wrong_type_argument (Qvector_or_char_table_p, (x)); \
1510 } while (0)
1511
1512 #define CHECK_BUFFER(x) \
1513 do { if (!BUFFERP ((x))) x = wrong_type_argument (Qbufferp, (x)); } while (0)
1514
1515 #define CHECK_WINDOW(x) \
1516 do { if (!WINDOWP ((x))) x = wrong_type_argument (Qwindowp, (x)); } while (0)
1517
1518 /* This macro rejects windows on the interior of the window tree as
1519 "dead", which is what we want; this is an argument-checking macro, and
1520 the user should never get access to interior windows.
1521
1522 A window of any sort, leaf or interior, is dead iff the buffer,
1523 vchild, and hchild members are all nil. */
1524
1525 #define CHECK_LIVE_WINDOW(x) \
1526 do { \
1527 if (!WINDOWP ((x)) \
1528 || NILP (XWINDOW ((x))->buffer)) \
1529 x = wrong_type_argument (Qwindow_live_p, (x)); \
1530 } while (0)
1531
1532 #define CHECK_PROCESS(x) \
1533 do { if (!PROCESSP ((x))) x = wrong_type_argument (Qprocessp, (x)); } while (0)
1534
1535 #define CHECK_NUMBER(x) \
1536 do { if (!INTEGERP ((x))) x = wrong_type_argument (Qintegerp, (x)); } while (0)
1537
1538 #define CHECK_NATNUM(x) \
1539 do { if (!NATNUMP (x)) x = wrong_type_argument (Qwholenump, (x)); } while (0)
1540
1541 #define CHECK_MARKER(x) \
1542 do { if (!MARKERP ((x))) x = wrong_type_argument (Qmarkerp, (x)); } while (0)
1543
1544 #define CHECK_NUMBER_COERCE_MARKER(x) \
1545 do { if (MARKERP ((x))) XSETFASTINT (x, marker_position (x)); \
1546 else if (!INTEGERP ((x))) x = wrong_type_argument (Qinteger_or_marker_p, (x)); } while (0)
1547
1548 #define XFLOATINT(n) extract_float((n))
1549
1550 #define CHECK_FLOAT(x) \
1551 do { if (!FLOATP (x)) \
1552 x = wrong_type_argument (Qfloatp, (x)); } while (0)
1553
1554 #define CHECK_NUMBER_OR_FLOAT(x) \
1555 do { if (!FLOATP (x) && !INTEGERP (x)) \
1556 x = wrong_type_argument (Qnumberp, (x)); } while (0)
1557
1558 #define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER(x) \
1559 do { if (MARKERP (x)) XSETFASTINT (x, marker_position (x)); \
1560 else if (!INTEGERP (x) && !FLOATP (x)) \
1561 x = wrong_type_argument (Qnumber_or_marker_p, (x)); } while (0)
1562
1563 #define CHECK_OVERLAY(x) \
1564 do { if (!OVERLAYP ((x))) x = wrong_type_argument (Qoverlayp, (x));} while (0)
1565
1566 /* Since we can't assign directly to the CAR or CDR fields of a cons
1567 cell, use these when checking that those fields contain numbers. */
1568 #define CHECK_NUMBER_CAR(x) \
1569 do { \
1570 Lisp_Object tmp = XCAR (x); \
1571 CHECK_NUMBER (tmp); \
1572 XSETCAR ((x), tmp); \
1573 } while (0)
1574
1575 #define CHECK_NUMBER_CDR(x) \
1576 do { \
1577 Lisp_Object tmp = XCDR (x); \
1578 CHECK_NUMBER (tmp); \
1579 XSETCDR ((x), tmp); \
1580 } while (0)
1581
1582 #define CHECK_NATNUM_CAR(x) \
1583 do { \
1584 Lisp_Object tmp = XCAR (x); \
1585 CHECK_NATNUM (tmp); \
1586 XSETCAR ((x), tmp); \
1587 } while (0)
1588
1589 #define CHECK_NATNUM_CDR(x) \
1590 do { \
1591 Lisp_Object tmp = XCDR (x); \
1592 CHECK_NATNUM (tmp); \
1593 XSETCDR ((x), tmp); \
1594 } while (0)
1595
1596 /* Cast pointers to this type to compare them. Some machines want int. */
1597 #ifndef PNTR_COMPARISON_TYPE
1598 #define PNTR_COMPARISON_TYPE EMACS_UINT
1599 #endif
1600 \f
1601 /* Define a built-in function for calling from Lisp.
1602 `lname' should be the name to give the function in Lisp,
1603 as a null-terminated C string.
1604 `fnname' should be the name of the function in C.
1605 By convention, it starts with F.
1606 `sname' should be the name for the C constant structure
1607 that records information on this function for internal use.
1608 By convention, it should be the same as `fnname' but with S instead of F.
1609 It's too bad that C macros can't compute this from `fnname'.
1610 `minargs' should be a number, the minimum number of arguments allowed.
1611 `maxargs' should be a number, the maximum number of arguments allowed,
1612 or else MANY or UNEVALLED.
1613 MANY means pass a vector of evaluated arguments,
1614 in the form of an integer number-of-arguments
1615 followed by the address of a vector of Lisp_Objects
1616 which contains the argument values.
1617 UNEVALLED means pass the list of unevaluated arguments
1618 `prompt' says how to read arguments for an interactive call.
1619 See the doc string for `interactive'.
1620 A null string means call interactively with no arguments.
1621 `doc' is documentation for the user. */
1622
1623 #if (!defined (__STDC__) && !defined (PROTOTYPES)) \
1624 || defined (USE_NONANSI_DEFUN)
1625
1626 #define DEFUN(lname, fnname, sname, minargs, maxargs, prompt, doc) \
1627 Lisp_Object fnname (); \
1628 DECL_ALIGN (struct Lisp_Subr, sname) = \
1629 { PVEC_SUBR | (sizeof (struct Lisp_Subr) / sizeof (EMACS_INT)), \
1630 fnname, minargs, maxargs, lname, prompt, 0}; \
1631 Lisp_Object fnname
1632
1633 #else
1634
1635 /* This version of DEFUN declares a function prototype with the right
1636 arguments, so we can catch errors with maxargs at compile-time. */
1637 #define DEFUN(lname, fnname, sname, minargs, maxargs, prompt, doc) \
1638 Lisp_Object fnname DEFUN_ARGS_ ## maxargs ; \
1639 DECL_ALIGN (struct Lisp_Subr, sname) = \
1640 { PVEC_SUBR | (sizeof (struct Lisp_Subr) / sizeof (EMACS_INT)), \
1641 fnname, minargs, maxargs, lname, prompt, 0}; \
1642 Lisp_Object fnname
1643
1644 /* Note that the weird token-substitution semantics of ANSI C makes
1645 this work for MANY and UNEVALLED. */
1646 #define DEFUN_ARGS_MANY (int, Lisp_Object *)
1647 #define DEFUN_ARGS_UNEVALLED (Lisp_Object)
1648 #define DEFUN_ARGS_0 (void)
1649 #define DEFUN_ARGS_1 (Lisp_Object)
1650 #define DEFUN_ARGS_2 (Lisp_Object, Lisp_Object)
1651 #define DEFUN_ARGS_3 (Lisp_Object, Lisp_Object, Lisp_Object)
1652 #define DEFUN_ARGS_4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object)
1653 #define DEFUN_ARGS_5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1654 Lisp_Object)
1655 #define DEFUN_ARGS_6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1656 Lisp_Object, Lisp_Object)
1657 #define DEFUN_ARGS_7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1658 Lisp_Object, Lisp_Object, Lisp_Object)
1659 #define DEFUN_ARGS_8 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1660 Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object)
1661 #endif
1662
1663 /* Non-zero if OBJ is a Lisp function. */
1664
1665 #define FUNCTIONP(OBJ) \
1666 ((CONSP (OBJ) && EQ (XCAR (OBJ), Qlambda)) \
1667 || (SYMBOLP (OBJ) && !NILP (Ffboundp (OBJ))) \
1668 || COMPILEDP (OBJ) \
1669 || SUBRP (OBJ))
1670
1671 /* defsubr (Sname);
1672 is how we define the symbol for function `name' at start-up time. */
1673 extern void defsubr P_ ((struct Lisp_Subr *));
1674
1675 #define MANY -2
1676 #define UNEVALLED -1
1677
1678 extern void defvar_lisp P_ ((char *, Lisp_Object *));
1679 extern void defvar_lisp_nopro P_ ((char *, Lisp_Object *));
1680 extern void defvar_bool P_ ((char *, int *));
1681 extern void defvar_int P_ ((char *, EMACS_INT *));
1682 extern void defvar_per_buffer P_ ((char *, Lisp_Object *, Lisp_Object, char *));
1683 extern void defvar_kboard P_ ((char *, int));
1684
1685 /* Macros we use to define forwarded Lisp variables.
1686 These are used in the syms_of_FILENAME functions. */
1687
1688 #define DEFVAR_LISP(lname, vname, doc) defvar_lisp (lname, vname)
1689 #define DEFVAR_LISP_NOPRO(lname, vname, doc) defvar_lisp_nopro (lname, vname)
1690 #define DEFVAR_BOOL(lname, vname, doc) defvar_bool (lname, vname)
1691 #define DEFVAR_INT(lname, vname, doc) defvar_int (lname, vname)
1692 #define DEFVAR_PER_BUFFER(lname, vname, type, doc) \
1693 defvar_per_buffer (lname, vname, type, 0)
1694 #define DEFVAR_KBOARD(lname, vname, doc) \
1695 defvar_kboard (lname, \
1696 (int)((char *)(&current_kboard->vname) \
1697 - (char *)current_kboard))
1698
1699
1700 \f
1701 /* Structure for recording Lisp call stack for backtrace purposes. */
1702
1703 /* The special binding stack holds the outer values of variables while
1704 they are bound by a function application or a let form, stores the
1705 code to be executed for Lisp unwind-protect forms, and stores the C
1706 functions to be called for record_unwind_protect.
1707
1708 If func is non-zero, undoing this binding applies func to old_value;
1709 This implements record_unwind_protect.
1710
1711 Otherwise, the element is a variable binding.
1712
1713 If the symbol field is a symbol, it is an ordinary variable binding.
1714
1715 Otherwise, it should be a structure (SYMBOL WHERE
1716 . CURRENT-BUFFER), which means having bound a local value while
1717 CURRENT-BUFFER was active. If WHERE is nil this means we saw the
1718 default value when binding SYMBOL. WHERE being a buffer or frame
1719 means we saw a buffer-local or frame-local value. Other values of
1720 WHERE mean an internal error. */
1721
1722 typedef Lisp_Object (*specbinding_func) P_ ((Lisp_Object));
1723
1724 struct specbinding
1725 {
1726 volatile Lisp_Object symbol, old_value;
1727 volatile specbinding_func func;
1728 Lisp_Object unused; /* Dividing by 16 is faster than by 12 */
1729 };
1730
1731 extern struct specbinding *specpdl;
1732 extern volatile struct specbinding *specpdl_ptr;
1733 extern int specpdl_size;
1734
1735 extern EMACS_INT max_specpdl_size;
1736
1737 #define SPECPDL_INDEX() (specpdl_ptr - specpdl)
1738
1739 /* Everything needed to describe an active condition case. */
1740 struct handler
1741 {
1742 /* The handler clauses and variable from the condition-case form. */
1743 /* For a handler set up in Lisp code, this is always a list.
1744 For an internal handler set up by internal_condition_case*,
1745 this can instead be the symbol t or `error'.
1746 t: handle all conditions.
1747 error: handle all conditions, and errors can run the debugger
1748 or display a backtrace. */
1749 Lisp_Object handler;
1750 Lisp_Object var;
1751 /* Fsignal stores here the condition-case clause that applies,
1752 and Fcondition_case thus knows which clause to run. */
1753 Lisp_Object chosen_clause;
1754
1755 /* Used to effect the longjump out to the handler. */
1756 struct catchtag *tag;
1757
1758 /* The next enclosing handler. */
1759 struct handler *next;
1760 };
1761
1762 extern struct handler *handlerlist;
1763
1764 extern struct catchtag *catchlist;
1765 extern struct backtrace *backtrace_list;
1766
1767 extern Lisp_Object memory_signal_data;
1768
1769 /* An address near the bottom of the stack.
1770 Tells GC how to save a copy of the stack. */
1771 extern char *stack_bottom;
1772
1773 /* Check quit-flag and quit if it is non-nil.
1774 Typing C-g does not directly cause a quit; it only sets Vquit_flag.
1775 So the program needs to do QUIT at times when it is safe to quit.
1776 Every loop that might run for a long time or might not exit
1777 ought to do QUIT at least once, at a safe place.
1778 Unless that is impossible, of course.
1779 But it is very desirable to avoid creating loops where QUIT is impossible.
1780
1781 Exception: if you set immediate_quit to nonzero,
1782 then the handler that responds to the C-g does the quit itself.
1783 This is a good thing to do around a loop that has no side effects
1784 and (in particular) cannot call arbitrary Lisp code. */
1785
1786 #ifdef SYNC_INPUT
1787 extern void handle_async_input P_ ((void));
1788 extern int interrupt_input_pending;
1789
1790 #define QUIT \
1791 do { \
1792 if (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) \
1793 { \
1794 Lisp_Object flag = Vquit_flag; \
1795 Vquit_flag = Qnil; \
1796 if (EQ (Vthrow_on_input, flag)) \
1797 Fthrow (Vthrow_on_input, Qnil); \
1798 Fsignal (Qquit, Qnil); \
1799 } \
1800 else if (interrupt_input_pending) \
1801 handle_async_input (); \
1802 } while (0)
1803
1804 #else /* not SYNC_INPUT */
1805
1806 #define QUIT \
1807 do { \
1808 if (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) \
1809 { \
1810 Lisp_Object flag = Vquit_flag; \
1811 Vquit_flag = Qnil; \
1812 if (EQ (Vthrow_on_input, flag)) \
1813 Fthrow (Vthrow_on_input, Qnil); \
1814 Fsignal (Qquit, Qnil); \
1815 } \
1816 } while (0)
1817
1818 #endif /* not SYNC_INPUT */
1819
1820
1821 /* Nonzero if ought to quit now. */
1822
1823 #define QUITP (!NILP (Vquit_flag) && NILP (Vinhibit_quit))
1824 \f
1825 /* Variables used locally in the following case handling macros. */
1826 extern int case_temp1;
1827 extern Lisp_Object case_temp2;
1828
1829 /* Current buffer's map from characters to lower-case characters. */
1830
1831 #define DOWNCASE_TABLE current_buffer->downcase_table
1832
1833 /* Current buffer's map from characters to upper-case characters. */
1834
1835 #define UPCASE_TABLE current_buffer->upcase_table
1836
1837 /* Downcase a character, or make no change if that cannot be done. */
1838
1839 #define DOWNCASE(CH) \
1840 ((case_temp1 = (CH), \
1841 case_temp2 = CHAR_TABLE_REF (DOWNCASE_TABLE, case_temp1), \
1842 NATNUMP (case_temp2)) \
1843 ? XFASTINT (case_temp2) : case_temp1)
1844
1845 /* 1 if CH is upper case. */
1846
1847 #define UPPERCASEP(CH) (DOWNCASE (CH) != (CH))
1848
1849 /* 1 if CH is neither upper nor lower case. */
1850
1851 #define NOCASEP(CH) (UPCASE1 (CH) == (CH))
1852
1853 /* 1 if CH is lower case. */
1854
1855 #define LOWERCASEP(CH) (!UPPERCASEP (CH) && !NOCASEP(CH))
1856
1857 /* Upcase a character, or make no change if that cannot be done. */
1858
1859 #define UPCASE(CH) (!UPPERCASEP (CH) ? UPCASE1 (CH) : (CH))
1860
1861 /* Upcase a character known to be not upper case. */
1862
1863 #define UPCASE1(CH) \
1864 ((case_temp1 = (CH), \
1865 case_temp2 = CHAR_TABLE_REF (UPCASE_TABLE, case_temp1), \
1866 NATNUMP (case_temp2)) \
1867 ? XFASTINT (case_temp2) : case_temp1)
1868
1869 extern Lisp_Object Vascii_downcase_table;
1870 \f
1871 /* Number of bytes of structure consed since last GC. */
1872
1873 extern int consing_since_gc;
1874
1875 /* Threshold for doing another gc. */
1876
1877 extern EMACS_INT gc_cons_threshold;
1878
1879 /* Structure for recording stack slots that need marking. */
1880
1881 /* This is a chain of structures, each of which points at a Lisp_Object variable
1882 whose value should be marked in garbage collection.
1883 Normally every link of the chain is an automatic variable of a function,
1884 and its `val' points to some argument or local variable of the function.
1885 On exit to the function, the chain is set back to the value it had on entry.
1886 This way, no link remains in the chain when the stack frame containing the
1887 link disappears.
1888
1889 Every function that can call Feval must protect in this fashion all
1890 Lisp_Object variables whose contents will be used again. */
1891
1892 extern struct gcpro *gcprolist;
1893
1894 struct gcpro
1895 {
1896 struct gcpro *next;
1897
1898 /* Address of first protected variable. */
1899 volatile Lisp_Object *var;
1900
1901 /* Number of consecutive protected variables. */
1902 int nvars;
1903
1904 #ifdef DEBUG_GCPRO
1905 int level;
1906 #endif
1907 };
1908
1909 /* Values of GC_MARK_STACK during compilation:
1910
1911 0 Use GCPRO as before
1912 1 Do the real thing, make GCPROs and UNGCPRO no-ops.
1913 2 Mark the stack, and check that everything GCPRO'd is
1914 marked.
1915 3 Mark using GCPRO's, mark stack last, and count how many
1916 dead objects are kept alive. */
1917
1918
1919 #define GC_USE_GCPROS_AS_BEFORE 0
1920 #define GC_MAKE_GCPROS_NOOPS 1
1921 #define GC_MARK_STACK_CHECK_GCPROS 2
1922 #define GC_USE_GCPROS_CHECK_ZOMBIES 3
1923
1924 #ifndef GC_MARK_STACK
1925 #define GC_MARK_STACK GC_USE_GCPROS_AS_BEFORE
1926 #endif
1927
1928 #if GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS
1929
1930 /* Do something silly with gcproN vars just so gcc shuts up. */
1931 /* You get warnings from MIPSPro... */
1932
1933 #define GCPRO1(varname) ((void) gcpro1)
1934 #define GCPRO2(varname1, varname2)(((void) gcpro2, (void) gcpro1))
1935 #define GCPRO3(varname1, varname2, varname3) \
1936 (((void) gcpro3, (void) gcpro2, (void) gcpro1))
1937 #define GCPRO4(varname1, varname2, varname3, varname4) \
1938 (((void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
1939 #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
1940 (((void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
1941 #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
1942 (((void) gcpro6, (void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
1943 #define UNGCPRO ((void) 0)
1944
1945 #else /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */
1946
1947 #ifndef DEBUG_GCPRO
1948
1949 #define GCPRO1(varname) \
1950 {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \
1951 gcprolist = &gcpro1; }
1952
1953 #define GCPRO2(varname1, varname2) \
1954 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1955 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1956 gcprolist = &gcpro2; }
1957
1958 #define GCPRO3(varname1, varname2, varname3) \
1959 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1960 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1961 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1962 gcprolist = &gcpro3; }
1963
1964 #define GCPRO4(varname1, varname2, varname3, varname4) \
1965 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1966 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1967 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1968 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
1969 gcprolist = &gcpro4; }
1970
1971 #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
1972 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1973 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1974 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1975 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
1976 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
1977 gcprolist = &gcpro5; }
1978
1979 #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
1980 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
1981 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
1982 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
1983 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
1984 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
1985 gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \
1986 gcprolist = &gcpro6; }
1987
1988 #define UNGCPRO (gcprolist = gcpro1.next)
1989
1990 #else
1991
1992 extern int gcpro_level;
1993
1994 #define GCPRO1(varname) \
1995 {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \
1996 gcpro1.level = gcpro_level++; \
1997 gcprolist = &gcpro1; }
1998
1999 #define GCPRO2(varname1, varname2) \
2000 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2001 gcpro1.level = gcpro_level; \
2002 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2003 gcpro2.level = gcpro_level++; \
2004 gcprolist = &gcpro2; }
2005
2006 #define GCPRO3(varname1, varname2, varname3) \
2007 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2008 gcpro1.level = gcpro_level; \
2009 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2010 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2011 gcpro3.level = gcpro_level++; \
2012 gcprolist = &gcpro3; }
2013
2014 #define GCPRO4(varname1, varname2, varname3, varname4) \
2015 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2016 gcpro1.level = gcpro_level; \
2017 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2018 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2019 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2020 gcpro4.level = gcpro_level++; \
2021 gcprolist = &gcpro4; }
2022
2023 #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
2024 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2025 gcpro1.level = gcpro_level; \
2026 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2027 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2028 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2029 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2030 gcpro5.level = gcpro_level++; \
2031 gcprolist = &gcpro5; }
2032
2033 #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
2034 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2035 gcpro1.level = gcpro_level; \
2036 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2037 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2038 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2039 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2040 gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \
2041 gcpro6.level = gcpro_level++; \
2042 gcprolist = &gcpro6; }
2043
2044 #define UNGCPRO \
2045 ((--gcpro_level != gcpro1.level) \
2046 ? (abort (), 0) \
2047 : ((gcprolist = gcpro1.next), 0))
2048
2049 #endif /* DEBUG_GCPRO */
2050 #endif /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */
2051
2052
2053 /* Evaluate expr, UNGCPRO, and then return the value of expr. */
2054 #define RETURN_UNGCPRO(expr) \
2055 do \
2056 { \
2057 Lisp_Object ret_ungc_val; \
2058 ret_ungc_val = (expr); \
2059 UNGCPRO; \
2060 return ret_ungc_val; \
2061 } \
2062 while (0)
2063
2064 /* Call staticpro (&var) to protect static variable `var'. */
2065
2066 void staticpro P_ ((Lisp_Object *));
2067 \f
2068 /* Declare a Lisp-callable function. The MAXARGS parameter has the same
2069 meaning as in the DEFUN macro, and is used to construct a prototype. */
2070 #if (!defined (__STDC__) && !defined (PROTOTYPES)) \
2071 || defined (USE_NONANSI_DEFUN)
2072 #define EXFUN(fnname, maxargs) \
2073 extern Lisp_Object fnname ()
2074 #else
2075 /* We can use the same trick as in the DEFUN macro to generate the
2076 appropriate prototype. */
2077 #define EXFUN(fnname, maxargs) \
2078 extern Lisp_Object fnname DEFUN_ARGS_ ## maxargs
2079 #endif
2080
2081 /* Forward declarations for prototypes. */
2082 struct window;
2083 struct frame;
2084
2085 /* Defined in data.c */
2086 extern Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
2087 extern Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
2088 extern Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
2089 extern Lisp_Object Qvoid_variable, Qvoid_function;
2090 extern Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
2091 extern Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
2092 extern Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
2093 extern Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
2094 extern Lisp_Object Qtext_read_only;
2095
2096 extern Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
2097 extern Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
2098 extern Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
2099 extern Lisp_Object Qbuffer_or_string_p;
2100 extern Lisp_Object Qboundp, Qfboundp;
2101 extern Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
2102
2103 extern Lisp_Object Qcdr;
2104
2105 extern Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
2106 extern Lisp_Object Qoverflow_error, Qunderflow_error;
2107
2108 extern Lisp_Object Qfloatp;
2109 extern Lisp_Object Qnumberp, Qnumber_or_marker_p;
2110
2111 extern Lisp_Object Qinteger;
2112
2113 extern void circular_list_error P_ ((Lisp_Object));
2114 EXFUN (Finteractive_form, 1);
2115
2116 /* Defined in frame.c */
2117 extern Lisp_Object Qframep;
2118
2119 EXFUN (Feq, 2);
2120 EXFUN (Fnull, 1);
2121 EXFUN (Flistp, 1);
2122 EXFUN (Fconsp, 1);
2123 EXFUN (Fatom, 1);
2124 EXFUN (Fnlistp, 1);
2125 EXFUN (Fintegerp, 1);
2126 EXFUN (Fnatnump, 1);
2127 EXFUN (Fsymbolp, 1);
2128 EXFUN (Fvectorp, 1);
2129 EXFUN (Fstringp, 1);
2130 EXFUN (Fmultibyte_string_p, 1);
2131 EXFUN (Farrayp, 1);
2132 EXFUN (Fsequencep, 1);
2133 EXFUN (Fbufferp, 1);
2134 EXFUN (Fmarkerp, 1);
2135 EXFUN (Fsubrp, 1);
2136 EXFUN (Fchar_or_string_p, 1);
2137 EXFUN (Finteger_or_marker_p, 1);
2138 EXFUN (Ffloatp, 1);
2139 EXFUN (Finteger_or_floatp, 1);
2140 EXFUN (Finteger_or_float_or_marker_p, 1);
2141
2142 EXFUN (Fcar, 1);
2143 EXFUN (Fcar_safe, 1);
2144 EXFUN (Fcdr, 1);
2145 EXFUN (Fcdr_safe, 1);
2146 EXFUN (Fsetcar, 2);
2147 EXFUN (Fsetcdr, 2);
2148 EXFUN (Fboundp, 1);
2149 EXFUN (Ffboundp, 1);
2150 EXFUN (Fmakunbound, 1);
2151 EXFUN (Ffmakunbound, 1);
2152 EXFUN (Fsymbol_function, 1);
2153 EXFUN (Fsymbol_plist, 1);
2154 EXFUN (Fsymbol_name, 1);
2155 extern Lisp_Object indirect_function P_ ((Lisp_Object));
2156 EXFUN (Findirect_function, 1);
2157 EXFUN (Ffset, 2);
2158 EXFUN (Fsetplist, 2);
2159 EXFUN (Fsymbol_value, 1);
2160 extern Lisp_Object find_symbol_value P_ ((Lisp_Object));
2161 EXFUN (Fset, 2);
2162 EXFUN (Fdefault_value, 1);
2163 EXFUN (Fset_default, 2);
2164 EXFUN (Fdefault_boundp, 1);
2165 EXFUN (Fmake_local_variable, 1);
2166 EXFUN (Flocal_variable_p, 2);
2167 EXFUN (Flocal_variable_if_set_p, 2);
2168
2169 EXFUN (Faref, 2);
2170 EXFUN (Faset, 3);
2171
2172 EXFUN (Fstring_to_number, 2);
2173 EXFUN (Fnumber_to_string, 1);
2174 EXFUN (Feqlsign, 2);
2175 EXFUN (Fgtr, 2);
2176 EXFUN (Flss, 2);
2177 EXFUN (Fgeq, 2);
2178 EXFUN (Fleq, 2);
2179 EXFUN (Fneq, 2);
2180 EXFUN (Fzerop, 1);
2181 EXFUN (Fplus, MANY);
2182 EXFUN (Fminus, MANY);
2183 EXFUN (Ftimes, MANY);
2184 EXFUN (Fquo, MANY);
2185 EXFUN (Frem, 2);
2186 EXFUN (Fmax, MANY);
2187 EXFUN (Fmin, MANY);
2188 EXFUN (Flogand, MANY);
2189 EXFUN (Flogior, MANY);
2190 EXFUN (Flogxor, MANY);
2191 EXFUN (Flognot, 1);
2192 EXFUN (Flsh, 2);
2193 EXFUN (Fash, 2);
2194
2195 EXFUN (Fadd1, 1);
2196 EXFUN (Fsub1, 1);
2197 EXFUN (Fmake_variable_buffer_local, 1);
2198
2199 extern Lisp_Object indirect_variable P_ ((Lisp_Object));
2200 extern Lisp_Object long_to_cons P_ ((unsigned long));
2201 extern unsigned long cons_to_long P_ ((Lisp_Object));
2202 extern void args_out_of_range P_ ((Lisp_Object, Lisp_Object));
2203 extern void args_out_of_range_3 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
2204 extern Lisp_Object wrong_type_argument P_ ((Lisp_Object, Lisp_Object));
2205 extern void store_symval_forwarding P_ ((Lisp_Object, Lisp_Object,
2206 Lisp_Object, struct buffer *));
2207 extern Lisp_Object do_symval_forwarding P_ ((Lisp_Object));
2208 extern Lisp_Object set_internal P_ ((Lisp_Object, Lisp_Object, struct buffer *, int));
2209 extern void syms_of_data P_ ((void));
2210 extern void init_data P_ ((void));
2211 extern void swap_in_global_binding P_ ((Lisp_Object));
2212
2213 /* Defined in cmds.c */
2214 EXFUN (Fend_of_line, 1);
2215 EXFUN (Fforward_char, 1);
2216 EXFUN (Fforward_line, 1);
2217 extern int internal_self_insert P_ ((int, int));
2218 extern void syms_of_cmds P_ ((void));
2219 extern void keys_of_cmds P_ ((void));
2220
2221 /* Defined in coding.c */
2222 EXFUN (Fcoding_system_p, 1);
2223 EXFUN (Fcheck_coding_system, 1);
2224 EXFUN (Fread_coding_system, 2);
2225 EXFUN (Fread_non_nil_coding_system, 1);
2226 EXFUN (Ffind_operation_coding_system, MANY);
2227 EXFUN (Fupdate_coding_systems_internal, 0);
2228 EXFUN (Fencode_coding_string, 4);
2229 EXFUN (Fdecode_coding_string, 4);
2230 extern Lisp_Object detect_coding_system P_ ((const unsigned char *, int,
2231 int, int, int, Lisp_Object));
2232 extern void init_coding P_ ((void));
2233 extern void init_coding_once P_ ((void));
2234 extern void syms_of_coding P_ ((void));
2235
2236 /* Defined in character.c */
2237 extern void init_character_once P_ ((void));
2238 extern void syms_of_character P_ ((void));
2239 EXFUN (Funibyte_char_to_multibyte, 1);
2240
2241 /* Defined in charset.c */
2242 EXFUN (Fchar_bytes, 1);
2243 EXFUN (Fchar_width, 1);
2244 EXFUN (Fstring, MANY);
2245 extern int chars_in_text P_ ((const unsigned char *, int));
2246 extern int multibyte_chars_in_text P_ ((const unsigned char *, int));
2247 extern int multibyte_char_to_unibyte P_ ((int, Lisp_Object));
2248 extern Lisp_Object Qcharset;
2249 extern void init_charset P_ ((void));
2250 extern void init_charset_once P_ ((void));
2251 extern void syms_of_charset P_ ((void));
2252 /* Structure forward declarations. */
2253 struct charset;
2254
2255 /* Defined in composite.c */
2256 extern void syms_of_composite P_ ((void));
2257
2258 /* Defined in syntax.c */
2259 EXFUN (Fforward_word, 1);
2260 EXFUN (Fskip_chars_forward, 2);
2261 EXFUN (Fskip_chars_backward, 2);
2262 EXFUN (Fsyntax_table_p, 1);
2263 EXFUN (Fsyntax_table, 0);
2264 EXFUN (Fset_syntax_table, 1);
2265 extern void init_syntax_once P_ ((void));
2266 extern void syms_of_syntax P_ ((void));
2267
2268 /* Defined in fns.c */
2269 extern int use_dialog_box;
2270 extern int next_almost_prime P_ ((int));
2271 extern Lisp_Object larger_vector P_ ((Lisp_Object, int, Lisp_Object));
2272 extern void sweep_weak_hash_tables P_ ((void));
2273 extern Lisp_Object Qstring_lessp;
2274 extern Lisp_Object Vfeatures;
2275 extern Lisp_Object QCtest, QCweakness, Qequal, Qeq;
2276 unsigned sxhash P_ ((Lisp_Object, int));
2277 Lisp_Object make_hash_table P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
2278 Lisp_Object, Lisp_Object, Lisp_Object,
2279 Lisp_Object));
2280 Lisp_Object copy_hash_table P_ ((struct Lisp_Hash_Table *));
2281 int hash_lookup P_ ((struct Lisp_Hash_Table *, Lisp_Object, unsigned *));
2282 int hash_put P_ ((struct Lisp_Hash_Table *, Lisp_Object, Lisp_Object,
2283 unsigned));
2284 void hash_remove P_ ((struct Lisp_Hash_Table *, Lisp_Object));
2285 void hash_clear P_ ((struct Lisp_Hash_Table *));
2286 void remove_hash_entry P_ ((struct Lisp_Hash_Table *, int));
2287 extern void init_fns P_ ((void));
2288 EXFUN (Fsxhash, 1);
2289 EXFUN (Fmake_hash_table, MANY);
2290 EXFUN (Fmakehash, 1);
2291 EXFUN (Fcopy_hash_table, 1);
2292 EXFUN (Fhash_table_count, 1);
2293 EXFUN (Fhash_table_rehash_size, 1);
2294 EXFUN (Fhash_table_rehash_threshold, 1);
2295 EXFUN (Fhash_table_size, 1);
2296 EXFUN (Fhash_table_test, 1);
2297 EXFUN (Fhash_table_weak, 1);
2298 EXFUN (Fhash_table_p, 1);
2299 EXFUN (Fclrhash, 1);
2300 EXFUN (Fgethash, 3);
2301 EXFUN (Fputhash, 3);
2302 EXFUN (Fremhash, 2);
2303 EXFUN (Fmaphash, 2);
2304 EXFUN (Fdefine_hash_table_test, 3);
2305
2306 EXFUN (Fidentity, 1);
2307 EXFUN (Frandom, 1);
2308 EXFUN (Flength, 1);
2309 EXFUN (Fsafe_length, 1);
2310 EXFUN (Fappend, MANY);
2311 EXFUN (Fconcat, MANY);
2312 EXFUN (Fvconcat, MANY);
2313 EXFUN (Fcopy_sequence, 1);
2314 EXFUN (Fstring_make_multibyte, 1);
2315 EXFUN (Fstring_make_unibyte, 1);
2316 EXFUN (Fstring_as_multibyte, 1);
2317 EXFUN (Fstring_as_unibyte, 1);
2318 EXFUN (Fstring_to_multibyte, 1);
2319 EXFUN (Fsubstring, 3);
2320 extern Lisp_Object substring_both P_ ((Lisp_Object, int, int, int, int));
2321 EXFUN (Fnth, 2);
2322 EXFUN (Fnthcdr, 2);
2323 EXFUN (Fmemq, 2);
2324 EXFUN (Fassq, 2);
2325 EXFUN (Fassoc, 2);
2326 EXFUN (Felt, 2);
2327 EXFUN (Fmember, 2);
2328 EXFUN (Frassq, 2);
2329 EXFUN (Fdelq, 2);
2330 EXFUN (Fdelete, 2);
2331 EXFUN (Fsort, 2);
2332 EXFUN (Freverse, 1);
2333 EXFUN (Fnreverse, 1);
2334 EXFUN (Fget, 2);
2335 EXFUN (Fput, 3);
2336 EXFUN (Fequal, 2);
2337 EXFUN (Ffillarray, 2);
2338 EXFUN (Fnconc, MANY);
2339 EXFUN (Fmapcar, 2);
2340 EXFUN (Fmapconcat, 3);
2341 EXFUN (Fy_or_n_p, 1);
2342 extern Lisp_Object do_yes_or_no_p P_ ((Lisp_Object));
2343 EXFUN (Frequire, 3);
2344 EXFUN (Fprovide, 2);
2345 extern Lisp_Object concat2 P_ ((Lisp_Object, Lisp_Object));
2346 extern Lisp_Object concat3 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
2347 extern Lisp_Object nconc2 P_ ((Lisp_Object, Lisp_Object));
2348 extern Lisp_Object assq_no_quit P_ ((Lisp_Object, Lisp_Object));
2349 extern void clear_string_char_byte_cache P_ ((void));
2350 extern int string_char_to_byte P_ ((Lisp_Object, int));
2351 extern int string_byte_to_char P_ ((Lisp_Object, int));
2352 extern Lisp_Object string_make_multibyte P_ ((Lisp_Object));
2353 extern Lisp_Object string_to_multibyte P_ ((Lisp_Object));
2354 extern Lisp_Object string_make_unibyte P_ ((Lisp_Object));
2355 EXFUN (Fcopy_alist, 1);
2356 EXFUN (Fplist_get, 2);
2357 EXFUN (Fsafe_plist_get, 2);
2358 EXFUN (Fplist_put, 3);
2359 EXFUN (Fplist_member, 2);
2360 EXFUN (Frassoc, 2);
2361 EXFUN (Fstring_equal, 2);
2362 EXFUN (Fcompare_strings, 7);
2363 EXFUN (Fstring_lessp, 2);
2364 extern void syms_of_fns P_ ((void));
2365
2366 /* Defined in floatfns.c */
2367 extern double extract_float P_ ((Lisp_Object));
2368 EXFUN (Ffloat, 1);
2369 EXFUN (Ftruncate, 2);
2370 extern void init_floatfns P_ ((void));
2371 extern void syms_of_floatfns P_ ((void));
2372
2373 /* Defined in fringe.c */
2374 extern void syms_of_fringe P_ ((void));
2375 extern void init_fringe P_ ((void));
2376 extern void init_fringe_once P_ ((void));
2377
2378 /* Defined in image.c */
2379 EXFUN (Finit_image_library, 2);
2380 extern void syms_of_image P_ ((void));
2381 extern void init_image P_ ((void));
2382
2383 /* Defined in insdel.c */
2384 extern Lisp_Object Qinhibit_modification_hooks;
2385 extern void move_gap P_ ((int));
2386 extern void move_gap_both P_ ((int, int));
2387 extern void make_gap P_ ((int));
2388 extern int copy_text P_ ((const unsigned char *, unsigned char *, int, int, int));
2389 extern int count_size_as_multibyte P_ ((const unsigned char *, int));
2390 extern int count_combining_before P_ ((const unsigned char *, int, int, int));
2391 extern int count_combining_after P_ ((const unsigned char *, int, int, int));
2392 extern void insert P_ ((const unsigned char *, int));
2393 extern void insert_and_inherit P_ ((const unsigned char *, int));
2394 extern void insert_1 P_ ((const unsigned char *, int, int, int, int));
2395 extern void insert_1_both P_ ((const unsigned char *, int, int, int, int, int));
2396 extern void insert_from_gap P_ ((int, int));
2397 extern void insert_from_string P_ ((Lisp_Object, int, int, int, int, int));
2398 extern void insert_from_buffer P_ ((struct buffer *, int, int, int));
2399 extern void insert_char P_ ((int));
2400 extern void insert_string P_ ((const char *));
2401 extern void insert_before_markers P_ ((const unsigned char *, int));
2402 extern void insert_before_markers_and_inherit P_ ((const unsigned char *, int));
2403 extern void insert_from_string_before_markers P_ ((Lisp_Object, int, int, int, int, int));
2404 extern void del_range P_ ((int, int));
2405 extern Lisp_Object del_range_1 P_ ((int, int, int, int));
2406 extern void del_range_byte P_ ((int, int, int));
2407 extern void del_range_both P_ ((int, int, int, int, int));
2408 extern Lisp_Object del_range_2 P_ ((int, int, int, int, int));
2409 extern void modify_region P_ ((struct buffer *, int, int));
2410 extern void prepare_to_modify_buffer P_ ((int, int, int *));
2411 extern void signal_before_change P_ ((int, int, int *));
2412 extern void signal_after_change P_ ((int, int, int));
2413 extern void adjust_after_replace P_ ((int, int, Lisp_Object, int, int));
2414 extern void adjust_after_replace_noundo P_ ((int, int, int, int, int, int));
2415 extern void adjust_after_insert P_ ((int, int, int, int, int));
2416 extern void replace_range P_ ((int, int, Lisp_Object, int, int, int));
2417 extern void replace_range_2 P_ ((int, int, int, int, char *, int, int, int));
2418 extern void syms_of_insdel P_ ((void));
2419
2420 /* Defined in dispnew.c */
2421 extern Lisp_Object selected_frame;
2422 extern EMACS_INT baud_rate;
2423 EXFUN (Fding, 1);
2424 EXFUN (Fredraw_frame, 1);
2425 EXFUN (Fredraw_display, 0);
2426 EXFUN (Fsleep_for, 2);
2427 EXFUN (Fsit_for, 3);
2428 extern Lisp_Object sit_for P_ ((int, int, int, int, int));
2429 extern void init_display P_ ((void));
2430 extern void syms_of_display P_ ((void));
2431 extern void safe_bcopy P_ ((const char *, char *, int));
2432
2433 /* Defined in xdisp.c */
2434 extern Lisp_Object Qinhibit_point_motion_hooks;
2435 extern Lisp_Object Qinhibit_redisplay, Qdisplay;
2436 extern Lisp_Object Qinhibit_eval_during_redisplay;
2437 extern Lisp_Object Qmessage_truncate_lines;
2438 extern Lisp_Object Qimage;
2439 extern Lisp_Object Vmessage_log_max;
2440 extern int message_enable_multibyte;
2441 extern Lisp_Object echo_area_buffer[2];
2442 extern void check_message_stack P_ ((void));
2443 extern void setup_echo_area_for_printing P_ ((int));
2444 extern int push_message P_ ((void));
2445 extern Lisp_Object pop_message_unwind P_ ((Lisp_Object));
2446 extern Lisp_Object restore_message_unwind P_ ((Lisp_Object));
2447 extern void pop_message P_ ((void));
2448 extern void restore_message P_ ((void));
2449 extern Lisp_Object current_message P_ ((void));
2450 extern void set_message P_ ((const char *s, Lisp_Object, int, int));
2451 extern void clear_message P_ ((int, int));
2452 extern void message P_ ((/* char *, ... */));
2453 extern void message_nolog P_ ((/* char *, ... */));
2454 extern void message1 P_ ((char *));
2455 extern void message1_nolog P_ ((char *));
2456 extern void message2 P_ ((const char *, int, int));
2457 extern void message2_nolog P_ ((const char *, int, int));
2458 extern void message3 P_ ((Lisp_Object, int, int));
2459 extern void message3_nolog P_ ((Lisp_Object, int, int));
2460 extern void message_dolog P_ ((const char *, int, int, int));
2461 extern void message_with_string P_ ((char *, Lisp_Object, int));
2462 extern void message_log_maybe_newline P_ ((void));
2463 extern void update_echo_area P_ ((void));
2464 extern void truncate_echo_area P_ ((int));
2465 extern void redisplay P_ ((void));
2466 extern int check_point_in_composition
2467 P_ ((struct buffer *, int, struct buffer *, int));
2468 extern void redisplay_preserve_echo_area P_ ((int));
2469 extern void prepare_menu_bars P_ ((void));
2470
2471 void set_frame_cursor_types P_ ((struct frame *, Lisp_Object));
2472 extern void syms_of_xdisp P_ ((void));
2473 extern void init_xdisp P_ ((void));
2474 extern Lisp_Object safe_eval P_ ((Lisp_Object));
2475 extern int pos_visible_p P_ ((struct window *, int, int *,
2476 int *, int *, int));
2477
2478 /* Defined in vm-limit.c. */
2479 extern void memory_warnings P_ ((POINTER_TYPE *, void (*warnfun) ()));
2480
2481 /* Defined in alloc.c */
2482 extern void check_pure_size P_ ((void));
2483 extern void allocate_string_data P_ ((struct Lisp_String *, int, int));
2484 extern void reset_malloc_hooks P_ ((void));
2485 extern void uninterrupt_malloc P_ ((void));
2486 extern void malloc_warning P_ ((char *));
2487 extern void memory_full P_ ((void));
2488 extern void buffer_memory_full P_ ((void));
2489 extern int survives_gc_p P_ ((Lisp_Object));
2490 extern void mark_object P_ ((Lisp_Object));
2491 extern Lisp_Object Vpurify_flag;
2492 extern Lisp_Object Vmemory_full;
2493 EXFUN (Fcons, 2);
2494 EXFUN (list2, 2);
2495 EXFUN (list3, 3);
2496 EXFUN (list4, 4);
2497 EXFUN (list5, 5);
2498 EXFUN (Flist, MANY);
2499 EXFUN (Fmake_list, 2);
2500 extern Lisp_Object allocate_misc P_ ((void));
2501 EXFUN (Fmake_vector, 2);
2502 EXFUN (Fvector, MANY);
2503 EXFUN (Fmake_symbol, 1);
2504 EXFUN (Fmake_marker, 0);
2505 EXFUN (Fmake_string, 2);
2506 extern Lisp_Object build_string P_ ((const char *));
2507 extern Lisp_Object make_string P_ ((const char *, int));
2508 extern Lisp_Object make_unibyte_string P_ ((const char *, int));
2509 extern Lisp_Object make_multibyte_string P_ ((const char *, int, int));
2510 extern Lisp_Object make_event_array P_ ((int, Lisp_Object *));
2511 extern Lisp_Object make_uninit_string P_ ((int));
2512 extern Lisp_Object make_uninit_multibyte_string P_ ((int, int));
2513 extern Lisp_Object make_string_from_bytes P_ ((const char *, int, int));
2514 extern Lisp_Object make_specified_string P_ ((const char *, int, int, int));
2515 EXFUN (Fpurecopy, 1);
2516 extern Lisp_Object make_pure_string P_ ((char *, int, int, int));
2517 extern Lisp_Object pure_cons P_ ((Lisp_Object, Lisp_Object));
2518 extern Lisp_Object make_pure_vector P_ ((EMACS_INT));
2519 EXFUN (Fgarbage_collect, 0);
2520 EXFUN (Fmake_byte_code, MANY);
2521 EXFUN (Fmake_bool_vector, 2);
2522 extern Lisp_Object Qchar_table_extra_slots;
2523 extern struct Lisp_Vector *allocate_vector P_ ((EMACS_INT));
2524 extern struct Lisp_Vector *allocate_other_vector P_ ((EMACS_INT));
2525 extern struct Lisp_Hash_Table *allocate_hash_table P_ ((void));
2526 extern struct window *allocate_window P_ ((void));
2527 extern struct frame *allocate_frame P_ ((void));
2528 extern struct Lisp_Process *allocate_process P_ ((void));
2529 extern int gc_in_progress;
2530 extern int abort_on_gc;
2531 extern Lisp_Object make_float P_ ((double));
2532 extern void display_malloc_warning P_ ((void));
2533 extern int inhibit_garbage_collection P_ ((void));
2534 extern Lisp_Object make_save_value P_ ((void *, int));
2535 extern void free_misc P_ ((Lisp_Object));
2536 extern void free_marker P_ ((Lisp_Object));
2537 extern void free_cons P_ ((struct Lisp_Cons *));
2538 extern void init_alloc_once P_ ((void));
2539 extern void init_alloc P_ ((void));
2540 extern void syms_of_alloc P_ ((void));
2541 extern struct buffer * allocate_buffer P_ ((void));
2542
2543 /* Defined in chartab.c */
2544 EXFUN (Fmake_char_table, 2);
2545 EXFUN (Fchar_table_parent, 1);
2546 EXFUN (Fset_char_table_parent, 2);
2547 EXFUN (Fchar_table_extra_slot, 2);
2548 EXFUN (Fset_char_table_extra_slot, 3);
2549 EXFUN (Fchar_table_range, 2);
2550 EXFUN (Fset_char_table_range, 3);
2551 EXFUN (Fset_char_table_default, 3);
2552 EXFUN (Foptimize_char_table, 1);
2553 EXFUN (Fmap_char_table, 2);
2554 extern Lisp_Object copy_char_table P_ ((Lisp_Object));
2555 extern Lisp_Object sub_char_table_ref P_ ((Lisp_Object, int));
2556 extern Lisp_Object char_table_ref P_ ((Lisp_Object, int));
2557 extern Lisp_Object char_table_ref_and_range P_ ((Lisp_Object, int,
2558 int *, int *));
2559 extern Lisp_Object char_table_set P_ ((Lisp_Object, int, Lisp_Object));
2560 extern Lisp_Object char_table_set_range P_ ((Lisp_Object, int, int,
2561 Lisp_Object));
2562 extern int char_table_translate P_ ((Lisp_Object, int));
2563 extern void map_char_table P_ ((void (*) (Lisp_Object, Lisp_Object,
2564 Lisp_Object),
2565 Lisp_Object, Lisp_Object, Lisp_Object));
2566 extern void syms_of_chartab P_ ((void));
2567
2568 /* Defined in print.c */
2569 extern Lisp_Object Vprin1_to_string_buffer;
2570 extern void debug_print P_ ((Lisp_Object));
2571 EXFUN (Fprin1, 2);
2572 EXFUN (Fprin1_to_string, 2);
2573 EXFUN (Fprinc, 2);
2574 EXFUN (Fterpri, 1);
2575 EXFUN (Fprint, 2);
2576 EXFUN (Ferror_message_string, 1);
2577 extern Lisp_Object Vstandard_output, Qstandard_output;
2578 extern Lisp_Object Qexternal_debugging_output;
2579 extern void temp_output_buffer_setup P_ ((const char *));
2580 extern int print_level, print_escape_newlines;
2581 extern Lisp_Object Qprint_escape_newlines;
2582 extern void write_string P_ ((char *, int));
2583 extern void write_string_1 P_ ((char *, int, Lisp_Object));
2584 extern void print_error_message P_ ((Lisp_Object, Lisp_Object, char *, Lisp_Object));
2585 extern Lisp_Object internal_with_output_to_temp_buffer
2586 P_ ((const char *, Lisp_Object (*) (Lisp_Object), Lisp_Object));
2587 extern void float_to_string P_ ((unsigned char *, double));
2588 extern void syms_of_print P_ ((void));
2589
2590 /* Defined in doprnt.c */
2591 extern int doprnt P_ ((char *, int, char *, char *, int, char **));
2592 extern int doprnt_lisp P_ ((char *, int, char *, char *, int, char **));
2593
2594 /* Defined in lread.c */
2595 extern Lisp_Object Qvariable_documentation, Qstandard_input;
2596 extern Lisp_Object Vobarray, initial_obarray, Vstandard_input;
2597 EXFUN (Fread, 1);
2598 EXFUN (Fread_from_string, 3);
2599 EXFUN (Fintern, 2);
2600 EXFUN (Fintern_soft, 2);
2601 EXFUN (Fload, 5);
2602 EXFUN (Fget_file_char, 0);
2603 EXFUN (Fread_char, 2);
2604 EXFUN (Fread_event, 2);
2605 extern Lisp_Object read_filtered_event P_ ((int, int, int, int));
2606 EXFUN (Feval_region, 4);
2607 extern Lisp_Object intern P_ ((const char *));
2608 extern Lisp_Object make_symbol P_ ((char *));
2609 extern Lisp_Object oblookup P_ ((Lisp_Object, const char *, int, int));
2610 #define LOADHIST_ATTACH(x) \
2611 if (initialized) Vcurrent_load_list = Fcons (x, Vcurrent_load_list)
2612 extern Lisp_Object Vcurrent_load_list;
2613 extern Lisp_Object Vload_history, Vload_suffixes;
2614 extern int openp P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
2615 Lisp_Object *, Lisp_Object));
2616 extern int isfloat_string P_ ((char *));
2617 extern void map_obarray P_ ((Lisp_Object, void (*) (Lisp_Object, Lisp_Object),
2618 Lisp_Object));
2619 extern void dir_warning P_ ((char *, Lisp_Object));
2620 extern void close_load_descs P_ ((void));
2621 extern void init_obarray P_ ((void));
2622 extern void init_lread P_ ((void));
2623 extern void syms_of_lread P_ ((void));
2624
2625 /* Defined in eval.c */
2626 extern Lisp_Object Qautoload, Qexit, Qinteractive, Qcommandp, Qdefun, Qmacro;
2627 extern Lisp_Object Vinhibit_quit, Qinhibit_quit, Vquit_flag;
2628 extern Lisp_Object Vautoload_queue;
2629 extern Lisp_Object Vdebug_on_error;
2630 extern Lisp_Object Vsignaling_function;
2631 extern int handling_signal;
2632 extern int interactive_p P_ ((int));
2633
2634 /* To run a normal hook, use the appropriate function from the list below.
2635 The calling convention:
2636
2637 if (!NILP (Vrun_hooks))
2638 call1 (Vrun_hooks, Qmy_funny_hook);
2639
2640 should no longer be used. */
2641 extern Lisp_Object Vrun_hooks;
2642 EXFUN (Frun_hooks, MANY);
2643 EXFUN (Frun_hook_with_args, MANY);
2644 EXFUN (Frun_hook_with_args_until_success, MANY);
2645 EXFUN (Frun_hook_with_args_until_failure, MANY);
2646 extern Lisp_Object run_hook_list_with_args P_ ((Lisp_Object, int, Lisp_Object *));
2647 extern void run_hook_with_args_2 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
2648 EXFUN (Fand, UNEVALLED);
2649 EXFUN (For, UNEVALLED);
2650 EXFUN (Fif, UNEVALLED);
2651 EXFUN (Fprogn, UNEVALLED);
2652 EXFUN (Fprog1, UNEVALLED);
2653 EXFUN (Fprog2, UNEVALLED);
2654 EXFUN (Fsetq, UNEVALLED);
2655 EXFUN (Fquote, UNEVALLED);
2656 EXFUN (Fuser_variable_p, 1);
2657 EXFUN (Finteractive_p, 0);
2658 EXFUN (Fdefun, UNEVALLED);
2659 EXFUN (Flet, UNEVALLED);
2660 EXFUN (FletX, UNEVALLED);
2661 EXFUN (Fwhile, UNEVALLED);
2662 EXFUN (Fcatch, UNEVALLED);
2663 EXFUN (Fthrow, 2) NO_RETURN;
2664 EXFUN (Funwind_protect, UNEVALLED);
2665 EXFUN (Fcondition_case, UNEVALLED);
2666 EXFUN (Fsignal, 2);
2667 EXFUN (Fautoload, 5);
2668 EXFUN (Fcommandp, 2);
2669 EXFUN (Feval, 1);
2670 EXFUN (Fapply, MANY);
2671 EXFUN (Ffuncall, MANY);
2672 EXFUN (Fbacktrace, 0);
2673 extern Lisp_Object apply1 P_ ((Lisp_Object, Lisp_Object));
2674 extern Lisp_Object call0 P_ ((Lisp_Object));
2675 extern Lisp_Object call1 P_ ((Lisp_Object, Lisp_Object));
2676 extern Lisp_Object call2 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
2677 extern Lisp_Object call3 P_ ((Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object));
2678 extern Lisp_Object call4 P_ ((Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object));
2679 extern Lisp_Object call5 P_ ((Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object));
2680 extern Lisp_Object call6 P_ ((Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object));
2681 EXFUN (Fdo_auto_save, 2);
2682 extern Lisp_Object apply_lambda P_ ((Lisp_Object, Lisp_Object, int));
2683 extern Lisp_Object internal_catch P_ ((Lisp_Object, Lisp_Object (*) (Lisp_Object), Lisp_Object));
2684 extern Lisp_Object internal_condition_case P_ ((Lisp_Object (*) (void), Lisp_Object, Lisp_Object (*) (Lisp_Object)));
2685 extern Lisp_Object internal_condition_case_1 P_ ((Lisp_Object (*) (Lisp_Object), Lisp_Object, Lisp_Object, Lisp_Object (*) (Lisp_Object)));
2686 extern Lisp_Object internal_condition_case_2 P_ ((Lisp_Object (*) (int, Lisp_Object *), int, Lisp_Object *, Lisp_Object, Lisp_Object (*) (Lisp_Object)));
2687 extern void specbind P_ ((Lisp_Object, Lisp_Object));
2688 extern void record_unwind_protect P_ ((Lisp_Object (*) (Lisp_Object), Lisp_Object));
2689 extern Lisp_Object unbind_to P_ ((int, Lisp_Object));
2690 extern void error P_ ((/* char *, ... */)) NO_RETURN;
2691 extern void do_autoload P_ ((Lisp_Object, Lisp_Object));
2692 extern Lisp_Object un_autoload P_ ((Lisp_Object));
2693 EXFUN (Ffetch_bytecode, 1);
2694 extern void init_eval_once P_ ((void));
2695 extern Lisp_Object safe_call P_ ((int, Lisp_Object *));
2696 extern Lisp_Object safe_call1 P_ ((Lisp_Object, Lisp_Object));
2697 extern void init_eval P_ ((void));
2698 extern void syms_of_eval P_ ((void));
2699
2700 /* Defined in editfns.c */
2701 EXFUN (Fpropertize, MANY);
2702 EXFUN (Fcurrent_message, 0);
2703 EXFUN (Fgoto_char, 1);
2704 EXFUN (Fpoint_min_marker, 0);
2705 EXFUN (Fpoint_max_marker, 0);
2706 EXFUN (Fpoint_min, 0);
2707 EXFUN (Fpoint_max, 0);
2708 EXFUN (Fpoint, 0);
2709 EXFUN (Fpoint_marker, 0);
2710 EXFUN (Fmark_marker, 0);
2711 EXFUN (Fline_beginning_position, 1);
2712 EXFUN (Fline_end_position, 1);
2713 EXFUN (Ffollowing_char, 0);
2714 EXFUN (Fprevious_char, 0);
2715 EXFUN (Fchar_after, 1);
2716 EXFUN (Finsert, MANY);
2717 EXFUN (Finsert_and_inherit, MANY);
2718 EXFUN (Finsert_before_markers, MANY);
2719 EXFUN (Finsert_buffer_substring, 3);
2720 EXFUN (Finsert_char, 3);
2721 extern void insert1 P_ ((Lisp_Object));
2722 EXFUN (Feolp, 0);
2723 EXFUN (Feobp, 0);
2724 EXFUN (Fbolp, 0);
2725 EXFUN (Fbobp, 0);
2726 EXFUN (Fformat, MANY);
2727 EXFUN (Fmessage, MANY);
2728 extern Lisp_Object format2 P_ ((char *, Lisp_Object, Lisp_Object));
2729 extern Lisp_Object make_buffer_string P_ ((int, int, int));
2730 EXFUN (Fbuffer_substring, 2);
2731 EXFUN (Fbuffer_string, 0);
2732 extern Lisp_Object save_excursion_save P_ ((void));
2733 extern Lisp_Object save_restriction_save P_ ((void));
2734 extern Lisp_Object save_excursion_restore P_ ((Lisp_Object));
2735 extern Lisp_Object save_restriction_restore P_ ((Lisp_Object));
2736 EXFUN (Fchar_to_string, 1);
2737 EXFUN (Fdelete_region, 2);
2738 EXFUN (Fnarrow_to_region, 2);
2739 EXFUN (Fwiden, 0);
2740 EXFUN (Fuser_login_name, 1);
2741 EXFUN (Fsystem_name, 0);
2742 EXFUN (Fcurrent_time, 0);
2743 extern int clip_to_bounds P_ ((int, int, int));
2744 extern Lisp_Object make_buffer_string P_ ((int, int, int));
2745 extern Lisp_Object make_buffer_string_both P_ ((int, int, int, int, int));
2746 extern void init_editfns P_ ((void));
2747 extern void syms_of_editfns P_ ((void));
2748 EXFUN (Fcurrent_message, 0);
2749 extern Lisp_Object Vinhibit_field_text_motion;
2750 EXFUN (Fconstrain_to_field, 5);
2751 EXFUN (Ffield_string, 1);
2752 EXFUN (Fdelete_field, 1);
2753 EXFUN (Ffield_beginning, 3);
2754 EXFUN (Ffield_end, 3);
2755 EXFUN (Ffield_string_no_properties, 1);
2756 extern void set_time_zone_rule P_ ((char *));
2757
2758 /* defined in buffer.c */
2759 extern int mouse_face_overlay_overlaps P_ ((Lisp_Object));
2760 extern void nsberror P_ ((Lisp_Object));
2761 extern char *no_switch_window P_ ((Lisp_Object window));
2762 EXFUN (Fset_buffer_multibyte, 1);
2763 EXFUN (Foverlay_start, 1);
2764 EXFUN (Foverlay_end, 1);
2765 extern void adjust_overlays_for_insert P_ ((EMACS_INT, EMACS_INT));
2766 extern void adjust_overlays_for_delete P_ ((EMACS_INT, EMACS_INT));
2767 extern void fix_start_end_in_overlays P_ ((int, int));
2768 extern void report_overlay_modification P_ ((Lisp_Object, Lisp_Object, int,
2769 Lisp_Object, Lisp_Object, Lisp_Object));
2770 extern int overlay_touches_p P_ ((int));
2771 extern Lisp_Object Vbuffer_alist, Vinhibit_read_only;
2772 EXFUN (Fget_buffer, 1);
2773 EXFUN (Fget_buffer_create, 1);
2774 EXFUN (Fgenerate_new_buffer_name, 2);
2775 EXFUN (Fset_buffer, 1);
2776 EXFUN (set_buffer_if_live, 1);
2777 EXFUN (Fbarf_if_buffer_read_only, 0);
2778 EXFUN (Fcurrent_buffer, 0);
2779 EXFUN (Fswitch_to_buffer, 2);
2780 EXFUN (Fpop_to_buffer, 3);
2781 EXFUN (Fother_buffer, 3);
2782 EXFUN (Foverlay_get, 2);
2783 EXFUN (Fbuffer_modified_p, 1);
2784 EXFUN (Fset_buffer_modified_p, 1);
2785 EXFUN (Fkill_buffer, 1);
2786 EXFUN (Fkill_all_local_variables, 0);
2787 EXFUN (Fbuffer_disable_undo, 1);
2788 EXFUN (Fbuffer_enable_undo, 1);
2789 EXFUN (Ferase_buffer, 0);
2790 extern Lisp_Object Qoverlayp;
2791 extern Lisp_Object get_truename_buffer P_ ((Lisp_Object));
2792 extern struct buffer *all_buffers;
2793 EXFUN (Fprevious_overlay_change, 1);
2794 EXFUN (Fbuffer_file_name, 1);
2795 extern void init_buffer_once P_ ((void));
2796 extern void init_buffer P_ ((void));
2797 extern void syms_of_buffer P_ ((void));
2798 extern void keys_of_buffer P_ ((void));
2799
2800 /* defined in marker.c */
2801
2802 EXFUN (Fmarker_position, 1);
2803 EXFUN (Fmarker_buffer, 1);
2804 EXFUN (Fcopy_marker, 2);
2805 EXFUN (Fset_marker, 3);
2806 extern int marker_position P_ ((Lisp_Object));
2807 extern int marker_byte_position P_ ((Lisp_Object));
2808 extern void clear_charpos_cache P_ ((struct buffer *));
2809 extern int charpos_to_bytepos P_ ((int));
2810 extern int buf_charpos_to_bytepos P_ ((struct buffer *, int));
2811 extern int buf_bytepos_to_charpos P_ ((struct buffer *, int));
2812 extern void unchain_marker P_ ((struct Lisp_Marker *marker));
2813 extern Lisp_Object set_marker_restricted P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
2814 extern Lisp_Object set_marker_both P_ ((Lisp_Object, Lisp_Object, int, int));
2815 extern Lisp_Object set_marker_restricted_both P_ ((Lisp_Object, Lisp_Object,
2816 int, int));
2817 extern void syms_of_marker P_ ((void));
2818
2819 /* Defined in fileio.c */
2820
2821 extern Lisp_Object Qfile_error;
2822 EXFUN (Ffind_file_name_handler, 2);
2823 EXFUN (Ffile_name_as_directory, 1);
2824 EXFUN (Fmake_temp_name, 1);
2825 EXFUN (Fexpand_file_name, 2);
2826 EXFUN (Ffile_name_nondirectory, 1);
2827 EXFUN (Fsubstitute_in_file_name, 1);
2828 EXFUN (Ffile_symlink_p, 1);
2829 EXFUN (Fverify_visited_file_modtime, 1);
2830 EXFUN (Ffile_exists_p, 1);
2831 EXFUN (Ffile_name_absolute_p, 1);
2832 EXFUN (Fdirectory_file_name, 1);
2833 EXFUN (Ffile_name_directory, 1);
2834 extern Lisp_Object expand_and_dir_to_file P_ ((Lisp_Object, Lisp_Object));
2835 EXFUN (Ffile_accessible_directory_p, 1);
2836 EXFUN (Funhandled_file_name_directory, 1);
2837 EXFUN (Ffile_directory_p, 1);
2838 EXFUN (Fwrite_region, 7);
2839 EXFUN (Ffile_readable_p, 1);
2840 EXFUN (Ffile_executable_p, 1);
2841 EXFUN (Fread_file_name, 6);
2842 extern Lisp_Object close_file_unwind P_ ((Lisp_Object));
2843 extern void report_file_error P_ ((const char *, Lisp_Object));
2844 extern int internal_delete_file P_ ((Lisp_Object));
2845 extern void syms_of_fileio P_ ((void));
2846 EXFUN (Fmake_temp_name, 1);
2847 extern void init_fileio_once P_ ((void));
2848 extern Lisp_Object make_temp_name P_ ((Lisp_Object, int));
2849 EXFUN (Fmake_symbolic_link, 3);
2850
2851 /* Defined in abbrev.c */
2852
2853 extern void syms_of_abbrev P_ ((void));
2854
2855 /* defined in search.c */
2856 extern void shrink_regexp_cache P_ ((void));
2857 EXFUN (Fstring_match, 3);
2858 extern void restore_match_data P_ ((void));
2859 EXFUN (Fmatch_data, 2);
2860 EXFUN (Fset_match_data, 1);
2861 EXFUN (Fmatch_beginning, 1);
2862 EXFUN (Fmatch_end, 1);
2863 EXFUN (Flooking_at, 1);
2864 extern int fast_string_match P_ ((Lisp_Object, Lisp_Object));
2865 extern int fast_c_string_match_ignore_case P_ ((Lisp_Object, const char *));
2866 extern int fast_string_match_ignore_case P_ ((Lisp_Object, Lisp_Object));
2867 extern int scan_buffer P_ ((int, int, int, int, int *, int));
2868 extern int scan_newline P_ ((int, int, int, int, int, int));
2869 extern int find_next_newline P_ ((int, int));
2870 extern int find_next_newline_no_quit P_ ((int, int));
2871 extern int find_before_next_newline P_ ((int, int, int));
2872 extern void syms_of_search P_ ((void));
2873
2874 /* defined in minibuf.c */
2875
2876 extern Lisp_Object last_minibuf_string;
2877 extern void choose_minibuf_frame P_ ((void));
2878 EXFUN (Fcompleting_read, 8);
2879 EXFUN (Fread_from_minibuffer, 8);
2880 EXFUN (Fread_variable, 2);
2881 EXFUN (Fread_buffer, 3);
2882 EXFUN (Fread_minibuffer, 2);
2883 EXFUN (Feval_minibuffer, 2);
2884 EXFUN (Fread_string, 5);
2885 EXFUN (Fread_no_blanks_input, 3);
2886 extern Lisp_Object get_minibuffer P_ ((int));
2887 extern void temp_echo_area_glyphs P_ ((Lisp_Object));
2888 extern void init_minibuf_once P_ ((void));
2889 extern void syms_of_minibuf P_ ((void));
2890 extern void keys_of_minibuf P_ ((void));
2891
2892 /* Defined in callint.c */
2893
2894 extern Lisp_Object Qminus, Qplus, Vcurrent_prefix_arg;
2895 extern Lisp_Object Vcommand_history;
2896 extern Lisp_Object Qcall_interactively, Qmouse_leave_buffer_hook;
2897 EXFUN (Fcall_interactively, 3);
2898 EXFUN (Fprefix_numeric_value, 1);
2899 extern void syms_of_callint P_ ((void));
2900
2901 /* defined in casefiddle.c */
2902
2903 EXFUN (Fdowncase, 1);
2904 EXFUN (Fupcase, 1);
2905 EXFUN (Fcapitalize, 1);
2906 EXFUN (Fupcase_region, 2);
2907 EXFUN (Fupcase_initials, 1);
2908 EXFUN (Fupcase_initials_region, 2);
2909 extern void syms_of_casefiddle P_ ((void));
2910 extern void keys_of_casefiddle P_ ((void));
2911
2912 /* defined in casetab.c */
2913
2914 EXFUN (Fset_case_table, 1);
2915 EXFUN (Fset_standard_case_table, 1);
2916 extern void init_casetab_once P_ ((void));
2917 extern void syms_of_casetab P_ ((void));
2918
2919 /* defined in keyboard.c */
2920
2921 extern int echoing;
2922 extern Lisp_Object echo_message_buffer;
2923 extern struct kboard *echo_kboard;
2924 extern void cancel_echoing P_ ((void));
2925 extern Lisp_Object Qdisabled, QCfilter;
2926 extern Lisp_Object Vtty_erase_char, Vhelp_form, Vtop_level;
2927 extern Lisp_Object Vthrow_on_input;
2928 extern int input_pending;
2929 EXFUN (Fdiscard_input, 0);
2930 EXFUN (Frecursive_edit, 0);
2931 EXFUN (Ftop_level, 0);
2932 EXFUN (Fcommand_execute, 4);
2933 EXFUN (Finput_pending_p, 0);
2934 extern Lisp_Object menu_bar_items P_ ((Lisp_Object));
2935 extern Lisp_Object tool_bar_items P_ ((Lisp_Object, int *));
2936 extern Lisp_Object Qvertical_scroll_bar;
2937 extern void discard_mouse_events P_ ((void));
2938 EXFUN (Fevent_convert_list, 1);
2939 EXFUN (Fread_key_sequence, 5);
2940 EXFUN (Fset_input_mode, 4);
2941 extern int detect_input_pending P_ ((void));
2942 extern int detect_input_pending_run_timers P_ ((int));
2943 extern void safe_run_hooks P_ ((Lisp_Object));
2944 extern void cmd_error_internal P_ ((Lisp_Object, char *));
2945 extern Lisp_Object command_loop_1 P_ ((void));
2946 extern Lisp_Object recursive_edit_1 P_ ((void));
2947 extern void record_auto_save P_ ((void));
2948 extern void init_keyboard P_ ((void));
2949 extern void syms_of_keyboard P_ ((void));
2950 extern void keys_of_keyboard P_ ((void));
2951 extern char *push_key_description P_ ((unsigned int, char *, int));
2952
2953
2954 /* defined in indent.c */
2955 EXFUN (Fvertical_motion, 2);
2956 EXFUN (Findent_to, 2);
2957 EXFUN (Fcurrent_column, 0);
2958 EXFUN (Fmove_to_column, 2);
2959 extern double current_column P_ ((void));
2960 extern void invalidate_current_column P_ ((void));
2961 extern int indented_beyond_p P_ ((int, int, double));
2962 extern void syms_of_indent P_ ((void));
2963
2964 /* defined in frame.c */
2965 #ifdef HAVE_WINDOW_SYSTEM
2966 extern Lisp_Object Vx_resource_name;
2967 extern Lisp_Object Vx_resource_class;
2968 #endif /* HAVE_WINDOW_SYSTEM */
2969 extern Lisp_Object Qvisible;
2970 extern void store_frame_param P_ ((struct frame *, Lisp_Object, Lisp_Object));
2971 extern void store_in_alist P_ ((Lisp_Object *, Lisp_Object, Lisp_Object));
2972 extern Lisp_Object do_switch_frame P_ ((Lisp_Object, int, int));
2973 extern Lisp_Object get_frame_param P_ ((struct frame *, Lisp_Object));
2974 extern Lisp_Object frame_buffer_predicate P_ ((Lisp_Object));
2975 EXFUN (Fframep, 1);
2976 EXFUN (Fselect_frame, 2);
2977 EXFUN (Fselected_frame, 0);
2978 EXFUN (Fwindow_frame, 1);
2979 EXFUN (Fframe_root_window, 1);
2980 EXFUN (Fframe_first_window, 1);
2981 EXFUN (Fframe_selected_window, 1);
2982 EXFUN (Fframe_list, 0);
2983 EXFUN (Fnext_frame, 2);
2984 EXFUN (Fdelete_frame, 2);
2985 EXFUN (Fset_mouse_position, 3);
2986 EXFUN (Fmake_frame_visible, 1);
2987 EXFUN (Fmake_frame_invisible, 2);
2988 EXFUN (Ficonify_frame, 1);
2989 EXFUN (Fframe_visible_p, 1);
2990 EXFUN (Fvisible_frame_list, 0);
2991 EXFUN (Fframe_parameter, 2);
2992 EXFUN (Fframe_parameters, 1);
2993 EXFUN (Fmodify_frame_parameters, 2);
2994 EXFUN (Fset_frame_height, 3);
2995 EXFUN (Fset_frame_width, 3);
2996 EXFUN (Fset_frame_size, 3);
2997 EXFUN (Fset_frame_position, 3);
2998 EXFUN (Fraise_frame, 1);
2999 EXFUN (Fredirect_frame_focus, 2);
3000 EXFUN (Fset_frame_selected_window, 2);
3001 extern Lisp_Object frame_buffer_list P_ ((Lisp_Object));
3002 extern void frames_discard_buffer P_ ((Lisp_Object));
3003 extern void set_frame_buffer_list P_ ((Lisp_Object, Lisp_Object));
3004 extern void frames_bury_buffer P_ ((Lisp_Object));
3005 extern void syms_of_frame P_ ((void));
3006
3007 /* defined in emacs.c */
3008 extern Lisp_Object decode_env_path P_ ((char *, char *));
3009 extern Lisp_Object Vinvocation_name, Vinvocation_directory;
3010 extern Lisp_Object Vinstallation_directory, empty_string;
3011 EXFUN (Fkill_emacs, 1);
3012 #if HAVE_SETLOCALE
3013 void fixup_locale P_ ((void));
3014 void synchronize_system_messages_locale P_ ((void));
3015 void synchronize_system_time_locale P_ ((void));
3016 #else
3017 #define setlocale(category, locale)
3018 #define fixup_locale()
3019 #define synchronize_system_messages_locale()
3020 #define synchronize_system_time_locale()
3021 #endif
3022 void shut_down_emacs P_ ((int, int, Lisp_Object));
3023 /* Nonzero means don't do interactive redisplay and don't change tty modes */
3024 extern int noninteractive;
3025 /* Nonzero means don't do use window-system-specific display code */
3026 extern int inhibit_window_system;
3027 /* Nonzero means that a filter or a sentinel is running. */
3028 extern int running_asynch_code;
3029
3030 /* defined in process.c */
3031 EXFUN (Fget_process, 1);
3032 EXFUN (Fget_buffer_process, 1);
3033 EXFUN (Fprocessp, 1);
3034 EXFUN (Fprocess_status, 1);
3035 EXFUN (Fkill_process, 2);
3036 EXFUN (Fprocess_send_eof, 1);
3037 EXFUN (Fwaiting_for_user_input_p, 0);
3038 extern Lisp_Object Qprocessp;
3039 extern void kill_buffer_processes P_ ((Lisp_Object));
3040 extern int wait_reading_process_output P_ ((int, int, int, int,
3041 Lisp_Object,
3042 struct Lisp_Process *,
3043 int));
3044 extern void deactivate_process P_ ((Lisp_Object));
3045 extern void add_keyboard_wait_descriptor P_ ((int));
3046 extern void delete_keyboard_wait_descriptor P_ ((int));
3047 extern void close_process_descs P_ ((void));
3048 extern void status_notify P_ ((void));
3049 extern int read_process_output P_ ((Lisp_Object, int));
3050 extern void init_process P_ ((void));
3051 extern void syms_of_process P_ ((void));
3052 extern void setup_process_coding_systems P_ ((Lisp_Object));
3053
3054 /* defined in callproc.c */
3055 extern Lisp_Object Vexec_path, Vexec_suffixes,
3056 Vexec_directory, Vdata_directory;
3057 extern Lisp_Object Vdoc_directory;
3058 EXFUN (Fcall_process, MANY);
3059 extern int child_setup P_ ((int, int, int, char **, int, Lisp_Object));
3060 extern void init_callproc_1 P_ ((void));
3061 extern void init_callproc P_ ((void));
3062 extern void set_process_environment P_ ((void));
3063 extern void syms_of_callproc P_ ((void));
3064
3065 /* defined in doc.c */
3066 extern Lisp_Object Vdoc_file_name;
3067 EXFUN (Fsubstitute_command_keys, 1);
3068 EXFUN (Fdocumentation, 2);
3069 EXFUN (Fdocumentation_property, 3);
3070 extern Lisp_Object read_doc_string P_ ((Lisp_Object));
3071 extern Lisp_Object get_doc_string P_ ((Lisp_Object, int, int));
3072 extern void syms_of_doc P_ ((void));
3073 extern int read_bytecode_char P_ ((int));
3074
3075 /* defined in bytecode.c */
3076 extern Lisp_Object Qbytecode;
3077 EXFUN (Fbyte_code, 3);
3078 extern void syms_of_bytecode P_ ((void));
3079 extern struct byte_stack *byte_stack_list;
3080 extern void mark_byte_stack P_ ((void));
3081 extern void unmark_byte_stack P_ ((void));
3082
3083 /* defined in macros.c */
3084 extern Lisp_Object Qexecute_kbd_macro;
3085 EXFUN (Fexecute_kbd_macro, 3);
3086 EXFUN (Fcancel_kbd_macro_events, 0);
3087 extern void init_macros P_ ((void));
3088 extern void syms_of_macros P_ ((void));
3089
3090 /* defined in undo.c */
3091 extern Lisp_Object Qinhibit_read_only;
3092 EXFUN (Fundo_boundary, 0);
3093 extern Lisp_Object truncate_undo_list P_ ((Lisp_Object, int, int, int));
3094 extern void record_marker_adjustment P_ ((Lisp_Object, int));
3095 extern void record_insert P_ ((int, int));
3096 extern void record_delete P_ ((int, Lisp_Object));
3097 extern void record_first_change P_ ((void));
3098 extern void record_change P_ ((int, int));
3099 extern void record_property_change P_ ((int, int, Lisp_Object, Lisp_Object,
3100 Lisp_Object));
3101 extern void syms_of_undo P_ ((void));
3102
3103 /* defined in textprop.c */
3104 extern Lisp_Object Qfont, Qmouse_face;
3105 extern Lisp_Object Qinsert_in_front_hooks, Qinsert_behind_hooks;
3106 EXFUN (Fnext_single_property_change, 4);
3107 EXFUN (Fnext_single_char_property_change, 4);
3108 EXFUN (Fprevious_single_property_change, 4);
3109 EXFUN (Fget_text_property, 3);
3110 EXFUN (Fput_text_property, 5);
3111 EXFUN (Fprevious_char_property_change, 2);
3112 EXFUN (Fnext_char_property_change, 2);
3113 extern void report_interval_modification P_ ((Lisp_Object, Lisp_Object));
3114 extern Lisp_Object next_single_char_property_change P_ ((Lisp_Object,
3115 Lisp_Object,
3116 Lisp_Object,
3117 Lisp_Object));
3118
3119 /* defined in xmenu.c */
3120 EXFUN (Fx_popup_menu, 2);
3121 EXFUN (Fx_popup_dialog, 2);
3122 extern void syms_of_xmenu P_ ((void));
3123
3124 /* defined in sysdep.c */
3125 extern void stuff_char P_ ((char c));
3126 extern void init_sigio P_ ((int));
3127 extern void request_sigio P_ ((void));
3128 extern void unrequest_sigio P_ ((void));
3129 extern void reset_sys_modes P_ ((void));
3130 extern void sys_subshell P_ ((void));
3131 extern void sys_suspend P_ ((void));
3132 extern void discard_tty_input P_ ((void));
3133 extern void init_sys_modes P_ ((void));
3134 extern void reset_sys_modes P_ ((void));
3135 extern void get_frame_size P_ ((int *, int *));
3136 extern void wait_for_termination P_ ((int));
3137 extern void flush_pending_output P_ ((int));
3138 extern void child_setup_tty P_ ((int));
3139 extern void setup_pty P_ ((int));
3140 extern int set_window_size P_ ((int, int, int));
3141 extern void create_process P_ ((Lisp_Object, char **, Lisp_Object));
3142 extern int tabs_safe_p P_ ((void));
3143 extern void init_baud_rate P_ ((void));
3144 extern int emacs_open P_ ((const char *, int, int));
3145 extern int emacs_close P_ ((int));
3146 extern int emacs_read P_ ((int, char *, unsigned int));
3147 extern int emacs_write P_ ((int, const char *, unsigned int));
3148
3149 /* defined in filelock.c */
3150 EXFUN (Funlock_buffer, 0);
3151 EXFUN (Ffile_locked_p, 1);
3152 extern void unlock_all_files P_ ((void));
3153 extern void lock_file P_ ((Lisp_Object));
3154 extern void unlock_file P_ ((Lisp_Object));
3155 extern void unlock_buffer P_ ((struct buffer *));
3156 extern void syms_of_filelock P_ ((void));
3157 extern void init_filelock P_ ((void));
3158
3159 /* Defined in sound.c */
3160 extern void syms_of_sound P_ ((void));
3161 extern void init_sound P_ ((void));
3162
3163 /* Defined in category.c */
3164 extern void init_category_once P_ ((void));
3165 extern Lisp_Object char_category_set P_ ((int));
3166 extern void syms_of_category P_ ((void));
3167
3168 /* Defined in ccl.c */
3169 extern void syms_of_ccl P_ ((void));
3170
3171 /* Defined in dired.c */
3172 EXFUN (Ffile_attributes, 2);
3173 extern void syms_of_dired P_ ((void));
3174
3175 /* Defined in term.c */
3176 extern void syms_of_term P_ ((void));
3177 extern void fatal () NO_RETURN;
3178
3179 #ifdef HAVE_X_WINDOWS
3180 /* Defined in fontset.c */
3181 extern void syms_of_fontset P_ ((void));
3182 EXFUN (Fset_fontset_font, 5);
3183 EXFUN (Fnew_fontset, 2);
3184 #endif
3185
3186 /* Defined in xfaces.c */
3187 extern void syms_of_xfaces P_ ((void));
3188
3189 /* Defined in getloadavg.c */
3190 extern int getloadavg P_ ((double *, int));
3191
3192 #ifdef HAVE_X_WINDOWS
3193 /* Defined in xfns.c */
3194 extern void syms_of_xfns P_ ((void));
3195 #endif /* HAVE_X_WINDOWS */
3196 #ifdef HAVE_WINDOW_SYSTEM
3197 /* Defined in xfns.c, w32fns.c, or macfns.c */
3198 EXFUN (Fxw_display_color_p, 1);
3199 EXFUN (Fx_file_dialog, 5);
3200 #endif /* HAVE_WINDOW_SYSTEM */
3201
3202 /* Defined in xsmfns.c */
3203 extern void syms_of_xsmfns P_ ((void));
3204
3205 /* Defined in xselect.c */
3206 extern void syms_of_xselect P_ ((void));
3207
3208 /* Defined in xterm.c */
3209 extern void syms_of_xterm P_ ((void));
3210
3211 /* Defined in getloadavg.c */
3212 extern int getloadavg P_ ((double [], int));
3213
3214 #ifdef MSDOS
3215 /* Defined in msdos.c */
3216 EXFUN (Fmsdos_downcase_filename, 1);
3217 #endif
3218 \f
3219 /* Nonzero means Emacs has already been initialized.
3220 Used during startup to detect startup of dumped Emacs. */
3221 extern int initialized;
3222
3223 extern int immediate_quit; /* Nonzero means ^G can quit instantly */
3224
3225 extern POINTER_TYPE *xmalloc P_ ((size_t));
3226 extern POINTER_TYPE *xrealloc P_ ((POINTER_TYPE *, size_t));
3227 extern void xfree P_ ((POINTER_TYPE *));
3228
3229 extern char *xstrdup P_ ((const char *));
3230
3231 extern char *egetenv P_ ((char *));
3232
3233 /* Set up the name of the machine we're running on. */
3234 extern void init_system_name P_ ((void));
3235
3236 /* Some systems (e.g., NT) use a different path separator than Unix,
3237 in addition to a device separator. Default the path separator
3238 to '/', and don't test for a device separator in IS_ANY_SEP. */
3239
3240 #ifdef WINDOWSNT
3241 extern Lisp_Object Vdirectory_sep_char;
3242 #endif
3243
3244 #ifndef DIRECTORY_SEP
3245 #define DIRECTORY_SEP '/'
3246 #endif
3247 #ifndef IS_DIRECTORY_SEP
3248 #define IS_DIRECTORY_SEP(_c_) ((_c_) == DIRECTORY_SEP)
3249 #endif
3250 #ifndef IS_DEVICE_SEP
3251 #ifndef DEVICE_SEP
3252 #define IS_DEVICE_SEP(_c_) 0
3253 #else
3254 #define IS_DEVICE_SEP(_c_) ((_c_) == DEVICE_SEP)
3255 #endif
3256 #endif
3257 #ifndef IS_ANY_SEP
3258 #define IS_ANY_SEP(_c_) (IS_DIRECTORY_SEP (_c_))
3259 #endif
3260
3261 #ifdef SWITCH_ENUM_BUG
3262 #define SWITCH_ENUM_CAST(x) ((int)(x))
3263 #else
3264 #define SWITCH_ENUM_CAST(x) (x)
3265 #endif
3266
3267 /* Loop over Lisp list LIST. Signal an error if LIST is not a proper
3268 list, or if it contains circles.
3269
3270 HARE and TORTOISE should be the names of Lisp_Object variables, and
3271 N should be the name of an EMACS_INT variable declared in the
3272 function where the macro is used. Each nested loop should use
3273 its own variables.
3274
3275 In the loop body, HARE is set to each cons of LIST, and N is the
3276 length of the list processed so far. */
3277
3278 #define LIST_END_P(list, obj) \
3279 (NILP (obj) \
3280 ? 1 \
3281 : (CONSP (obj) \
3282 ? 0 \
3283 : (wrong_type_argument (Qlistp, (list))), 1))
3284
3285 #define FOREACH(hare, list, tortoise, n) \
3286 for (tortoise = hare = (list), n = 0; \
3287 !LIST_END_P (list, hare); \
3288 (hare = XCDR (hare), ++n, \
3289 ((n & 1) != 0 \
3290 ? (tortoise = XCDR (tortoise), \
3291 (EQ (hare, tortoise) \
3292 && (circular_list_error ((list)), 1))) \
3293 : 0)))
3294
3295 /* The ubiquitous min and max macros. */
3296
3297 #ifdef max
3298 #undef max
3299 #undef min
3300 #endif
3301 #define min(a, b) ((a) < (b) ? (a) : (b))
3302 #define max(a, b) ((a) > (b) ? (a) : (b))
3303
3304 /* Return a fixnum or float, depending on whether VAL fits in a Lisp
3305 fixnum. */
3306
3307 #define make_fixnum_or_float(val) \
3308 (FIXNUM_OVERFLOW_P (val) \
3309 ? make_float (val) \
3310 : make_number ((EMACS_INT)(val)))
3311
3312
3313 /* Checks the `cycle check' variable CHECK to see if it indicates that
3314 EL is part of a cycle; CHECK must be either Qnil or a value returned
3315 by an earlier use of CYCLE_CHECK. SUSPICIOUS is the number of
3316 elements after which a cycle might be suspected; after that many
3317 elements, this macro begins consing in order to keep more precise
3318 track of elements.
3319
3320 Returns nil if a cycle was detected, otherwise a new value for CHECK
3321 that includes EL.
3322
3323 CHECK is evaluated multiple times, EL and SUSPICIOUS 0 or 1 times, so
3324 the caller should make sure that's ok. */
3325
3326 #define CYCLE_CHECK(check, el, suspicious) \
3327 (NILP (check) \
3328 ? make_number (0) \
3329 : (INTEGERP (check) \
3330 ? (XFASTINT (check) < (suspicious) \
3331 ? make_number (XFASTINT (check) + 1) \
3332 : Fcons (el, Qnil)) \
3333 : (!NILP (Fmemq ((el), (check))) \
3334 ? Qnil \
3335 : Fcons ((el), (check)))))
3336
3337
3338 /* SAFE_ALLOCA normally allocates memory on the stack, but if size is
3339 larger than MAX_ALLOCA, use xmalloc to avoid overflowing the stack. */
3340
3341 #define MAX_ALLOCA 16*1024
3342
3343 extern Lisp_Object safe_alloca_unwind (Lisp_Object);
3344
3345 #define USE_SAFE_ALLOCA \
3346 int sa_count = SPECPDL_INDEX (), sa_must_free = 0
3347
3348 /* SAFE_ALLOCA allocates a simple buffer. */
3349
3350 #define SAFE_ALLOCA(buf, type, size) \
3351 do { \
3352 if ((size) < MAX_ALLOCA) \
3353 buf = (type) alloca (size); \
3354 else \
3355 { \
3356 buf = (type) xmalloc (size); \
3357 sa_must_free++; \
3358 record_unwind_protect (safe_alloca_unwind, \
3359 make_save_value (buf, 0)); \
3360 } \
3361 } while (0)
3362
3363 /* SAFE_FREE frees xmalloced memory and enables GC as needed. */
3364
3365 #define SAFE_FREE() \
3366 do { \
3367 if (sa_must_free) { \
3368 sa_must_free = 0; \
3369 unbind_to (sa_count, Qnil); \
3370 } \
3371 } while (0)
3372
3373
3374 /* SAFE_ALLOCA_LISP allocates an array of Lisp_Objects. */
3375
3376 #define SAFE_ALLOCA_LISP(buf, nelt) \
3377 do { \
3378 int size_ = (nelt) * sizeof (Lisp_Object); \
3379 if (size_ < MAX_ALLOCA) \
3380 buf = (Lisp_Object *) alloca (size_); \
3381 else \
3382 { \
3383 Lisp_Object arg_; \
3384 buf = (Lisp_Object *) xmalloc (size_); \
3385 arg_ = make_save_value (buf, nelt); \
3386 XSAVE_VALUE (arg_)->dogc = 1; \
3387 sa_must_free++; \
3388 record_unwind_protect (safe_alloca_unwind, arg_); \
3389 } \
3390 } while (0)
3391
3392
3393 #endif /* EMACS_LISP_H */
3394
3395 /* arch-tag: 9b2ed020-70eb-47ac-94ee-e1c2a5107d5e
3396 (do not change this comment) */