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