Promote SSDATA macro from gtkutil.c and xsmfns.c to lisp.h.
[bpt/emacs.git] / src / lisp.h
CommitLineData
3cfe6dfd 1/* Fundamental definitions for GNU Emacs Lisp interpreter.
ddf9883e 2 Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 1998, 1999, 2000,
66b7b0fe 3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
8cabe764 4 Free Software Foundation, Inc.
3cfe6dfd
JB
5
6This file is part of GNU Emacs.
7
b9b1cc14 8GNU Emacs is free software: you can redistribute it and/or modify
3cfe6dfd 9it under the terms of the GNU General Public License as published by
b9b1cc14
GM
10the Free Software Foundation, either version 3 of the License, or
11(at your option) any later version.
3cfe6dfd
JB
12
13GNU Emacs is distributed in the hope that it will be useful,
14but WITHOUT ANY WARRANTY; without even the implied warranty of
15MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16GNU General Public License for more details.
17
18You should have received a copy of the GNU General Public License
b9b1cc14 19along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
3cfe6dfd 20
6b61353c
KH
21#ifndef EMACS_LISP_H
22#define EMACS_LISP_H
23
6a8033e1 24#include <stdarg.h>
89887d67 25#include <stddef.h>
6a8033e1 26
7b3a82d7
DN
27/* Use the configure flag --enable-checking[=LIST] to enable various
28 types of run time checks for Lisp objects. */
35f464a7 29
cdf61d83
RS
30#ifdef GC_CHECK_CONS_LIST
31#define CHECK_CONS_LIST() check_cons_list()
32#else
5bb7dfee 33#define CHECK_CONS_LIST() ((void)0)
cdf61d83 34#endif
3cfe6dfd 35
ce99fd65 36/* These are default choices for the types to use. */
68c45bf0
PE
37#ifdef _LP64
38#ifndef EMACS_INT
39#define EMACS_INT long
40#define BITS_PER_EMACS_INT BITS_PER_LONG
41#endif
42#ifndef EMACS_UINT
43#define EMACS_UINT unsigned long
44#endif
45#else /* not _LP64 */
ce99fd65
RS
46#ifndef EMACS_INT
47#define EMACS_INT int
1747fb16 48#define BITS_PER_EMACS_INT BITS_PER_INT
ce99fd65
RS
49#endif
50#ifndef EMACS_UINT
51#define EMACS_UINT unsigned int
52#endif
68c45bf0 53#endif
ce99fd65 54
e0b8c689
KR
55/* Extra internal type checking? */
56extern int suppress_checking;
383e0970 57extern void die (const char *, const char *, int) NO_RETURN;
c6129d7e
KR
58
59#ifdef ENABLE_CHECKING
60
383b707e
KR
61/* The suppress_checking variable is initialized to 0 in alloc.c. Set
62 it to 1 using a debugger to temporarily disable aborting on
63 detected internal inconsistencies or error conditions.
64
65 Testing suppress_checking after the supplied condition ensures that
66 the side effects produced by CHECK will be consistent, independent
67 of whether ENABLE_CHECKING is defined, or whether the checks are
68 suppressed at run time.
69
70 In some cases, a good compiler may be able to optimize away the
71 CHECK macro altogether, e.g., if XSTRING (x) uses CHECK to test
72 STRINGP (x), but a particular use of XSTRING is invoked only after
73 testing that STRINGP (x) is true, making the test redundant. */
74
6cbe2e28 75#define CHECK(check,msg) (((check) || suppress_checking \
7eb9e30d 76 ? (void) 0 \
6cbe2e28 77 : die ((msg), __FILE__, __LINE__)), \
c6129d7e 78 0)
e0b8c689 79#else
c6129d7e 80
e0b8c689
KR
81/* Produce same side effects and result, but don't complain. */
82#define CHECK(check,msg) ((check),0)
c6129d7e 83
e0b8c689 84#endif
c6129d7e 85
e0b8c689
KR
86/* Define an Emacs version of "assert", since some system ones are
87 flaky. */
3694b4ab
GM
88#ifndef ENABLE_CHECKING
89#define eassert(X) (void) 0
90#else /* ENABLE_CHECKING */
e0b8c689
KR
91#if defined (__GNUC__) && __GNUC__ >= 2 && defined (__STDC__)
92#define eassert(cond) CHECK(cond,"assertion failed: " #cond)
93#else
94#define eassert(cond) CHECK(cond,"assertion failed")
95#endif
3694b4ab 96#endif /* ENABLE_CHECKING */
b9466edb 97\f
d9170db5
DN
98/* Use the configure flag --enable-use-lisp-union-type to make
99 Lisp_Object use a union type instead of the default int. The flag
100 causes USE_LISP_UNION_TYPE to be defined. */
b86cfd28 101
b9466edb
SM
102/***** Select the tagging scheme. *****/
103/* There are basically two options that control the tagging scheme:
b86cfd28
EZ
104 - USE_LISP_UNION_TYPE says that Lisp_Object should be a union instead
105 of an integer.
b9466edb
SM
106 - USE_LSB_TAG means that we can assume the least 3 bits of pointers are
107 always 0, and we can thus use them to hold tag bits, without
108 restricting our addressing space.
109
110 If USE_LSB_TAG is not set, then we use the top 3 bits for tagging, thus
111 restricting our possible address range. Currently USE_LSB_TAG is not
112 allowed together with a union. This is not due to any fundamental
113 technical (or political ;-) problem: nobody wrote the code to do it yet.
114
115 USE_LSB_TAG not only requires the least 3 bits of pointers returned by
116 malloc to be 0 but also needs to be able to impose a mult-of-8 alignment
117 on the few static Lisp_Objects used: all the defsubr as well
118 as the two special buffers buffer_defaults and buffer_local_symbols. */
119
120/* First, try and define DECL_ALIGN(type,var) which declares a static
121 variable VAR of type TYPE with the added requirement that it be
122 TYPEBITS-aligned. */
123#ifndef NO_DECL_ALIGN
124# ifndef DECL_ALIGN
7cae64b4 125# if HAVE_ATTRIBUTE_ALIGNED
b9466edb
SM
126# define DECL_ALIGN(type, var) \
127 type __attribute__ ((__aligned__ (1 << GCTYPEBITS))) var
7cae64b4
PE
128# else
129 /* What directives do other compilers use? */
b9466edb
SM
130# endif
131# endif
132#endif
133
134/* Let's USE_LSB_TAG on systems where we know malloc returns mult-of-8. */
7cae64b4
PE
135#if (defined GNU_MALLOC || defined DOUG_LEA_MALLOC || defined __GLIBC__ \
136 || defined DARWIN_OS || defined __sun)
b9466edb
SM
137/* We also need to be able to specify mult-of-8 alignment on static vars. */
138# if defined DECL_ALIGN
b349d111 139# define USE_LSB_TAG
b9466edb
SM
140# endif
141#endif
142
143/* If we cannot use 8-byte alignment, make DECL_ALIGN a no-op. */
144#ifndef DECL_ALIGN
145# ifdef USE_LSB_TAG
146# error "USE_LSB_TAG used without defining DECL_ALIGN"
147# endif
148# define DECL_ALIGN(type, var) type var
149#endif
150
e0b8c689 151
99a3d506 152/* Define the fundamental Lisp data structures. */
3cfe6dfd 153
2de9f71c
SM
154/* If USE_2_TAGBITS_FOR_INTS is defined, then Lisp integers use
155 2 tags, to give them one extra bit, thus extending their range from
156 e.g -2^28..2^28-1 to -2^29..2^29-1. */
157#define USE_2_TAGS_FOR_INTS
158
159/* Making it work for the union case is too much trouble. */
160#ifdef USE_LISP_UNION_TYPE
161# undef USE_2_TAGS_FOR_INTS
162#endif
163
99a3d506 164/* This is the set of Lisp data types. */
3cfe6dfd 165
2de9f71c
SM
166#if !defined USE_2_TAGS_FOR_INTS
167# define LISP_INT_TAG Lisp_Int
168# define case_Lisp_Int case Lisp_Int
169# define LISP_STRING_TAG 4
170# define LISP_INT_TAG_P(x) ((x) == Lisp_Int)
171#else
172# define LISP_INT_TAG Lisp_Int0
173# define case_Lisp_Int case Lisp_Int0: case Lisp_Int1
174# ifdef USE_LSB_TAG
175# define LISP_INT1_TAG 4
176# define LISP_STRING_TAG 1
177# define LISP_INT_TAG_P(x) (((x) & 3) == 0)
178# else
179# define LISP_INT1_TAG 1
180# define LISP_STRING_TAG 4
181# define LISP_INT_TAG_P(x) (((x) & 6) == 0)
182# endif
183#endif
184
3cfe6dfd
JB
185enum Lisp_Type
186 {
99a3d506 187 /* Integer. XINT (obj) is the integer value. */
2de9f71c
SM
188#ifdef USE_2_TAGS_FOR_INTS
189 Lisp_Int0 = 0,
190 Lisp_Int1 = LISP_INT1_TAG,
191#else
192 Lisp_Int = 0,
193#endif
3cfe6dfd 194
99a3d506 195 /* Symbol. XSYMBOL (object) points to a struct Lisp_Symbol. */
2de9f71c 196 Lisp_Symbol = 2,
3cfe6dfd 197
84d1833e
KH
198 /* Miscellaneous. XMISC (object) points to a union Lisp_Misc,
199 whose first member indicates the subtype. */
2de9f71c 200 Lisp_Misc = 3,
3cfe6dfd
JB
201
202 /* String. XSTRING (object) points to a struct Lisp_String.
99a3d506 203 The length of the string, and its contents, are stored therein. */
2de9f71c 204 Lisp_String = LISP_STRING_TAG,
3cfe6dfd 205
b5088f80 206 /* Vector of Lisp objects, or something resembling it.
7c06ac2b 207 XVECTOR (object) points to a struct Lisp_Vector, which contains
b5088f80
KH
208 the size and contents. The size field also contains the type
209 information, if it's not a real vector object. */
2de9f71c 210 Lisp_Vectorlike = 5,
3cfe6dfd 211
99a3d506 212 /* Cons. XCONS (object) points to a struct Lisp_Cons. */
2de9f71c 213 Lisp_Cons = 6,
4d1207f6 214
2de9f71c 215 Lisp_Float = 7,
3cfe6dfd
JB
216 };
217
a32fa736 218/* This is the set of data types that share a common structure.
c98adc1b
KH
219 The first member of the structure is a type code from this set.
220 The enum values are arbitrary, but we'll use large numbers to make it
221 more likely that we'll spot the error if a random word in memory is
222 mistakenly interpreted as a Lisp_Misc. */
1c4ca5a3
KH
223enum Lisp_Misc_Type
224 {
c98adc1b 225 Lisp_Misc_Free = 0x5eab,
84d1833e 226 Lisp_Misc_Marker,
99a3d506 227 Lisp_Misc_Overlay,
222151aa 228 Lisp_Misc_Save_Value,
99a3d506
RS
229 /* Currently floats are not a misc type,
230 but let's define this in case we want to change that. */
231 Lisp_Misc_Float,
232 /* This is not a type code. It is for range checking. */
233 Lisp_Misc_Limit
1c4ca5a3
KH
234 };
235
ce5b453a
SM
236/* These are the types of forwarding objects used in the value slot
237 of symbols for special built-in variables whose value is stored in
238 C variables. */
239enum Lisp_Fwd_Type
240 {
241 Lisp_Fwd_Int, /* Fwd to a C `int' variable. */
242 Lisp_Fwd_Bool, /* Fwd to a C boolean var. */
243 Lisp_Fwd_Obj, /* Fwd to a C Lisp_Object variable. */
244 Lisp_Fwd_Buffer_Obj, /* Fwd to a Lisp_Object field of buffers. */
245 Lisp_Fwd_Kboard_Obj, /* Fwd to a Lisp_Object field of kboards. */
246 };
247
e2ba196c
KH
248#ifndef GCTYPEBITS
249#define GCTYPEBITS 3
250#endif
251
5f6bf5fe
SM
252/* These values are overridden by the m- file on some machines. */
253#ifndef VALBITS
6b61353c 254#define VALBITS (BITS_PER_EMACS_INT - GCTYPEBITS)
5f6bf5fe
SM
255#endif
256
b86cfd28 257#ifdef USE_LISP_UNION_TYPE
3cfe6dfd 258
671d409f 259#ifndef WORDS_BIGENDIAN
3cfe6dfd
JB
260
261/* Definition of Lisp_Object for little-endian machines. */
262
263typedef
264union Lisp_Object
265 {
266 /* Used for comparing two Lisp_Objects;
99a3d506 267 also, positive integers can be accessed fast this way. */
b9466edb 268 EMACS_UINT i;
3cfe6dfd
JB
269
270 struct
271 {
201ef780
AS
272 /* Use explict signed, the signedness of a bit-field of type
273 int is implementation defined. */
274 signed EMACS_INT val : VALBITS;
6b61353c 275 enum Lisp_Type type : GCTYPEBITS;
3cfe6dfd
JB
276 } s;
277 struct
278 {
5c20a7bf 279 EMACS_UINT val : VALBITS;
6b61353c 280 enum Lisp_Type type : GCTYPEBITS;
3cfe6dfd 281 } u;
3cfe6dfd
JB
282 }
283Lisp_Object;
284
671d409f 285#else /* If WORDS_BIGENDIAN */
3cfe6dfd
JB
286
287typedef
288union Lisp_Object
289 {
290 /* Used for comparing two Lisp_Objects;
99a3d506 291 also, positive integers can be accessed fast this way. */
b9466edb 292 EMACS_UINT i;
3cfe6dfd
JB
293
294 struct
295 {
6b61353c 296 enum Lisp_Type type : GCTYPEBITS;
201ef780
AS
297 /* Use explict signed, the signedness of a bit-field of type
298 int is implementation defined. */
299 signed EMACS_INT val : VALBITS;
3cfe6dfd
JB
300 } s;
301 struct
302 {
6b61353c 303 enum Lisp_Type type : GCTYPEBITS;
5c20a7bf 304 EMACS_UINT val : VALBITS;
3cfe6dfd 305 } u;
3cfe6dfd
JB
306 }
307Lisp_Object;
308
671d409f 309#endif /* WORDS_BIGENDIAN */
3cfe6dfd 310
f3fbd155
KR
311#ifdef __GNUC__
312static __inline__ Lisp_Object
313LISP_MAKE_RVALUE (Lisp_Object o)
314{
315 return o;
316}
317#else
52766425
KR
318/* This is more portable to pre-C99 non-GCC compilers, but for
319 backwards compatibility GCC still accepts an old GNU extension
320 which caused this to only generate a warning. */
321#define LISP_MAKE_RVALUE(o) (0 ? (o) : (o))
f3fbd155
KR
322#endif
323
b86cfd28 324#else /* USE_LISP_UNION_TYPE */
3cfe6dfd 325
1c5ca8b6 326/* If union type is not wanted, define Lisp_Object as just a number. */
3cfe6dfd 327
c003141f 328typedef EMACS_INT Lisp_Object;
f3fbd155 329#define LISP_MAKE_RVALUE(o) (0+(o))
b86cfd28 330#endif /* USE_LISP_UNION_TYPE */
3cfe6dfd 331
6df4097e
PE
332/* In the size word of a vector, this bit means the vector has been marked.
333 (Shift -1 left, not 1, to avoid provoking overflow diagnostics.) */
846d69ac 334
6df4097e 335#define ARRAY_MARK_FLAG ((EMACS_INT) -1 << (BITS_PER_EMACS_INT - 1))
846d69ac 336
b5088f80
KH
337/* In the size word of a struct Lisp_Vector, this bit means it's really
338 some other vector-like object. */
6df4097e 339#define PSEUDOVECTOR_FLAG ((EMACS_INT) 1 << (BITS_PER_EMACS_INT - 2))
b5088f80 340
303a5c93 341/* In a pseudovector, the size field actually contains a word with one
b5088f80 342 PSEUDOVECTOR_FLAG bit set, and exactly one of the following bits to
49e49fb5 343 indicate the actual type.
539b8c1c
SM
344 We use a bitset, even tho only one of the bits can be set at any
345 particular time just so as to be able to use micro-optimizations such as
346 testing membership of a particular subset of pseudovectors in Fequal.
347 It is not crucial, but there are plenty of bits here, so why not do it? */
99a3d506
RS
348enum pvec_type
349{
350 PVEC_NORMAL_VECTOR = 0,
99a3d506
RS
351 PVEC_PROCESS = 0x200,
352 PVEC_FRAME = 0x400,
353 PVEC_COMPILED = 0x800,
354 PVEC_WINDOW = 0x1000,
355 PVEC_WINDOW_CONFIGURATION = 0x2000,
356 PVEC_SUBR = 0x4000,
608ff985
RS
357 PVEC_CHAR_TABLE = 0x8000,
358 PVEC_BOOL_VECTOR = 0x10000,
359 PVEC_BUFFER = 0x20000,
5010d3b8 360 PVEC_HASH_TABLE = 0x40000,
49e49fb5 361 PVEC_TERMINAL = 0x80000,
c73bd236 362 PVEC_SUB_CHAR_TABLE = 0x100000,
f85064bd
KH
363 PVEC_FONT = 0x200000,
364 PVEC_OTHER = 0x400000,
365 PVEC_TYPE_MASK = 0x7ffe00
e2c0561e 366
cee971ad
GM
367#if 0 /* This is used to make the value of PSEUDOVECTOR_FLAG available to
368 GDB. It doesn't work on OS Alpha. Moved to a variable in
369 emacs.c. */
e3d48049 370 PVEC_FLAG = PSEUDOVECTOR_FLAG
cee971ad 371#endif
99a3d506 372};
b5088f80 373
df631196
SM
374/* For convenience, we also store the number of elements in these bits.
375 Note that this size is not necessarily the memory-footprint size, but
376 only the number of Lisp_Object fields (that need to be traced by the GC).
377 The distinction is used e.g. by Lisp_Process which places extra
378 non-Lisp_Object fields at the end of the structure. */
608ff985 379#define PSEUDOVECTOR_SIZE_MASK 0x1ff
4435a68a
AS
380
381/* Number of bits to put in each character in the internal representation
382 of bool vectors. This should not vary across implementations. */
383#define BOOL_VECTOR_BITS_PER_CHAR 8
3cfe6dfd
JB
384\f
385/* These macros extract various sorts of values from a Lisp_Object.
386 For example, if tem is a Lisp_Object whose type is Lisp_Cons,
99a3d506 387 XCONS (tem) is the struct Lisp_Cons * pointing to the memory for that cons. */
3cfe6dfd 388
b86cfd28 389#ifndef USE_LISP_UNION_TYPE
3cfe6dfd 390
b9466edb
SM
391/* Return a perfect hash of the Lisp_Object representation. */
392#define XHASH(a) (a)
393
6b61353c
KH
394#ifdef USE_LSB_TAG
395
396#define TYPEMASK ((((EMACS_INT) 1) << GCTYPEBITS) - 1)
397#define XTYPE(a) ((enum Lisp_Type) (((EMACS_UINT) (a)) & TYPEMASK))
2de9f71c
SM
398#ifdef USE_2_TAGS_FOR_INTS
399# define XINT(a) (((EMACS_INT) (a)) >> (GCTYPEBITS - 1))
400# define XUINT(a) (((EMACS_UINT) (a)) >> (GCTYPEBITS - 1))
401# define make_number(N) (((EMACS_INT) (N)) << (GCTYPEBITS - 1))
402#else
403# define XINT(a) (((EMACS_INT) (a)) >> GCTYPEBITS)
404# define XUINT(a) (((EMACS_UINT) (a)) >> GCTYPEBITS)
405# define make_number(N) (((EMACS_INT) (N)) << GCTYPEBITS)
406#endif
6b61353c
KH
407#define XSET(var, type, ptr) \
408 (eassert (XTYPE (ptr) == 0), /* Check alignment. */ \
409 (var) = ((EMACS_INT) (type)) | ((EMACS_INT) (ptr)))
6b61353c 410
6b61353c
KH
411#define XPNTR(a) ((EMACS_INT) ((a) & ~TYPEMASK))
412
413#else /* not USE_LSB_TAG */
414
415#define VALMASK ((((EMACS_INT) 1) << VALBITS) - 1)
416
3cfe6dfd
JB
417/* One need to override this if there must be high bits set in data space
418 (doing the result of the below & ((1 << (GCTYPE + 1)) - 1) would work
a32fa736 419 on all machines, but would penalize machines which don't need it)
3cfe6dfd 420 */
6b61353c 421#define XTYPE(a) ((enum Lisp_Type) (((EMACS_UINT) (a)) >> VALBITS))
3cfe6dfd 422
221f4ef3
KH
423/* For integers known to be positive, XFASTINT provides fast retrieval
424 and XSETFASTINT provides fast storage. This takes advantage of the
6b61353c 425 fact that Lisp_Int is 0. */
e43ec785 426#define XFASTINT(a) ((a) + 0)
221f4ef3 427#define XSETFASTINT(a, b) ((a) = (b))
3cfe6dfd 428
2de9f71c 429/* Extract the value of a Lisp_Object as a (un)signed integer. */
3cfe6dfd 430
2de9f71c
SM
431#ifdef USE_2_TAGS_FOR_INTS
432# define XINT(a) ((((EMACS_INT) (a)) << (GCTYPEBITS - 1)) >> (GCTYPEBITS - 1))
433# define XUINT(a) ((EMACS_UINT) ((a) & (1 + (VALMASK << 1))))
434# define make_number(N) ((((EMACS_INT) (N)) & (1 + (VALMASK << 1))))
435#else
436# define XINT(a) ((((EMACS_INT) (a)) << (BITS_PER_EMACS_INT - VALBITS)) \
6b61353c 437 >> (BITS_PER_EMACS_INT - VALBITS))
2de9f71c
SM
438# define XUINT(a) ((EMACS_UINT) ((a) & VALMASK))
439# define make_number(N) \
440 ((((EMACS_INT) (N)) & VALMASK) | ((EMACS_INT) Lisp_Int) << VALBITS)
3cfe6dfd
JB
441#endif
442
6df4097e
PE
443#define XSET(var, type, ptr) \
444 ((var) = ((EMACS_INT) ((EMACS_UINT) (type) << VALBITS) \
445 + ((EMACS_INT) (ptr) & VALMASK)))
b7acde90 446
2de9f71c 447#define XPNTR(a) ((EMACS_UINT) ((a) & VALMASK))
b7acde90 448
6b61353c 449#endif /* not USE_LSB_TAG */
3cfe6dfd 450
b86cfd28 451#else /* USE_LISP_UNION_TYPE */
3cfe6dfd 452
2de9f71c
SM
453#ifdef USE_2_TAGS_FOR_INTS
454# error "USE_2_TAGS_FOR_INTS is not supported with USE_LISP_UNION_TYPE"
455#endif
456
b9466edb 457#define XHASH(a) ((a).i)
3cfe6dfd 458#define XTYPE(a) ((enum Lisp_Type) (a).u.type)
3cfe6dfd 459#define XINT(a) ((a).s.val)
3cfe6dfd 460#define XUINT(a) ((a).u.val)
3cfe6dfd 461
b349d111
SM
462#ifdef USE_LSB_TAG
463
464# define XSET(var, vartype, ptr) \
465 (eassert ((((EMACS_UINT) (ptr)) & ((1 << GCTYPEBITS) - 1)) == 0), \
466 (var).u.val = ((EMACS_UINT) (ptr)) >> GCTYPEBITS, \
467 (var).u.type = ((char) (vartype)))
468
524420d2
SM
469/* Some versions of gcc seem to consider the bitfield width when issuing
470 the "cast to pointer from integer of different size" warning, so the
471 cast is here to widen the value back to its natural size. */
472# define XPNTR(v) ((EMACS_INT)((v).s.val) << GCTYPEBITS)
b349d111
SM
473
474#else /* !USE_LSB_TAG */
475
476/* For integers known to be positive, XFASTINT provides fast retrieval
477 and XSETFASTINT provides fast storage. This takes advantage of the
478 fact that Lisp_Int is 0. */
479# define XFASTINT(a) ((a).i + 0)
480# define XSETFASTINT(a, b) ((a).i = (b))
481
482# define XSET(var, vartype, ptr) \
5c20a7bf 483 (((var).s.val = ((EMACS_INT) (ptr))), ((var).s.type = ((char) (vartype))))
3cfe6dfd 484
b349d111
SM
485#endif /* !USE_LSB_TAG */
486
74e49b38
KR
487#if __GNUC__ >= 2 && defined (__OPTIMIZE__)
488#define make_number(N) \
489 (__extension__ ({ Lisp_Object _l; _l.s.val = (N); _l.s.type = Lisp_Int; _l; }))
490#else
383e0970 491extern Lisp_Object make_number (EMACS_INT);
74e49b38 492#endif
e98227af 493
b86cfd28 494#endif /* USE_LISP_UNION_TYPE */
6b61353c 495
b349d111
SM
496/* For integers known to be positive, XFASTINT sometimes provides
497 faster retrieval and XSETFASTINT provides faster storage.
498 If not, fallback on the non-accelerated path. */
499#ifndef XFASTINT
500# define XFASTINT(a) (XINT (a))
501# define XSETFASTINT(a, b) (XSETINT (a, b))
502#endif
503
b9466edb
SM
504#define EQ(x, y) (XHASH (x) == XHASH (y))
505
8febed74 506#ifndef XPNTR
8febed74
KR
507#ifdef DATA_SEG_BITS
508/* This case is used for the rt-pc.
509 In the diffs I was given, it checked for ptr = 0
510 and did not adjust it in that case.
511 But I don't think that zero should ever be found
512 in a Lisp object whose data type says it points to something. */
513#define XPNTR(a) (XUINT (a) | DATA_SEG_BITS)
514#else
98950fd6
KR
515/* Some versions of gcc seem to consider the bitfield width when
516 issuing the "cast to pointer from integer of different size"
517 warning, so the cast is here to widen the value back to its natural
518 size. */
519#define XPNTR(a) ((EMACS_INT) XUINT (a))
8febed74 520#endif
8febed74
KR
521#endif /* no XPNTR */
522
d9eb1c3d
GM
523/* Largest and smallest representable fixnum values. These are the C
524 values. */
dc8e8b07 525
2de9f71c
SM
526#ifdef USE_2_TAGS_FOR_INTS
527# define MOST_NEGATIVE_FIXNUM - ((EMACS_INT) 1 << VALBITS)
528# define MOST_POSITIVE_FIXNUM (((EMACS_INT) 1 << VALBITS) - 1)
6b61353c
KH
529/* Mask indicating the significant bits of a Lisp_Int.
530 I.e. (x & INTMASK) == XUINT (make_number (x)). */
2de9f71c
SM
531# define INTMASK ((((EMACS_INT) 1) << (VALBITS + 1)) - 1)
532#else
533# define MOST_NEGATIVE_FIXNUM - ((EMACS_INT) 1 << (VALBITS - 1))
534# define MOST_POSITIVE_FIXNUM (((EMACS_INT) 1 << (VALBITS - 1)) - 1)
535/* Mask indicating the significant bits of a Lisp_Int.
536 I.e. (x & INTMASK) == XUINT (make_number (x)). */
537# define INTMASK ((((EMACS_INT) 1) << VALBITS) - 1)
538#endif
dc8e8b07 539
987c9327
AS
540/* Value is non-zero if I doesn't fit into a Lisp fixnum. It is
541 written this way so that it also works if I is of unsigned
542 type. */
dc8e8b07
GM
543
544#define FIXNUM_OVERFLOW_P(i) \
7b792fc9 545 ((i) > MOST_POSITIVE_FIXNUM \
987c9327 546 || ((i) < 0 && (i) < MOST_NEGATIVE_FIXNUM))
dc8e8b07 547
99a3d506 548/* Extract a value or address from a Lisp_Object. */
3cfe6dfd 549
2706ceb6
SM
550#define XCONS(a) (eassert (CONSP(a)),(struct Lisp_Cons *) XPNTR(a))
551#define XVECTOR(a) (eassert (VECTORLIKEP(a)),(struct Lisp_Vector *) XPNTR(a))
552#define XSTRING(a) (eassert (STRINGP(a)),(struct Lisp_String *) XPNTR(a))
553#define XSYMBOL(a) (eassert (SYMBOLP(a)),(struct Lisp_Symbol *) XPNTR(a))
554#define XFLOAT(a) (eassert (FLOATP(a)),(struct Lisp_Float *) XPNTR(a))
7c06ac2b
RS
555
556/* Misc types. */
c9f6631c 557
7c06ac2b 558#define XMISC(a) ((union Lisp_Misc *) XPNTR(a))
19fa82b9 559#define XMISCANY(a) (eassert (MISCP (a)), &(XMISC(a)->u_any))
67ee9f6e 560#define XMISCTYPE(a) (XMISCANY (a)->type)
19fa82b9 561#define XMARKER(a) (eassert (MARKERP (a)), &(XMISC(a)->u_marker))
19fa82b9
SM
562#define XOVERLAY(a) (eassert (OVERLAYP (a)), &(XMISC(a)->u_overlay))
563#define XSAVE_VALUE(a) (eassert (SAVE_VALUEP (a)), &(XMISC(a)->u_save_value))
ce5b453a
SM
564
565/* Forwarding object types. */
566
567#define XFWDTYPE(a) (a->u_intfwd.type)
568#define XINTFWD(a) (eassert (INTFWDP (a)), &((a)->u_intfwd))
569#define XBOOLFWD(a) (eassert (BOOLFWDP (a)), &((a)->u_boolfwd))
570#define XOBJFWD(a) (eassert (OBJFWDP (a)), &((a)->u_objfwd))
19fa82b9 571#define XBUFFER_OBJFWD(a) \
ce5b453a 572 (eassert (BUFFER_OBJFWDP (a)), &((a)->u_buffer_objfwd))
19fa82b9 573#define XKBOARD_OBJFWD(a) \
ce5b453a 574 (eassert (KBOARD_OBJFWDP (a)), &((a)->u_kboard_objfwd))
3cfe6dfd 575
7c06ac2b 576/* Pseudovector types. */
c9f6631c 577
2706ceb6
SM
578#define XPROCESS(a) (eassert (PROCESSP(a)),(struct Lisp_Process *) XPNTR(a))
579#define XWINDOW(a) (eassert (WINDOWP(a)),(struct window *) XPNTR(a))
c73bd236 580#define XTERMINAL(a) (eassert (TERMINALP(a)),(struct terminal *) XPNTR(a))
2706ceb6
SM
581#define XSUBR(a) (eassert (SUBRP(a)),(struct Lisp_Subr *) XPNTR(a))
582#define XBUFFER(a) (eassert (BUFFERP(a)),(struct buffer *) XPNTR(a))
c73bd236
MB
583#define XCHAR_TABLE(a) (eassert (CHAR_TABLE_P (a)), (struct Lisp_Char_Table *) XPNTR(a))
584#define XSUB_CHAR_TABLE(a) (eassert (SUB_CHAR_TABLE_P (a)), (struct Lisp_Sub_Char_Table *) XPNTR(a))
585#define XBOOL_VECTOR(a) (eassert (BOOL_VECTOR_P (a)), (struct Lisp_Bool_Vector *) XPNTR(a))
99a3d506 586
99a3d506 587/* Construct a Lisp_Object from a value or address. */
7c06ac2b 588
a84f89d5 589#define XSETINT(a, b) (a) = make_number (b)
a94ef819 590#define XSETCONS(a, b) XSET (a, Lisp_Cons, b)
b5088f80 591#define XSETVECTOR(a, b) XSET (a, Lisp_Vectorlike, b)
a94ef819
KH
592#define XSETSTRING(a, b) XSET (a, Lisp_String, b)
593#define XSETSYMBOL(a, b) XSET (a, Lisp_Symbol, b)
a94ef819 594#define XSETFLOAT(a, b) XSET (a, Lisp_Float, b)
7c06ac2b
RS
595
596/* Misc types. */
c9f6631c 597
7c06ac2b 598#define XSETMISC(a, b) XSET (a, Lisp_Misc, b)
a7aa28f6 599#define XSETMARKER(a, b) (XSETMISC (a, b), XMISCTYPE (a) = Lisp_Misc_Marker)
7c06ac2b
RS
600
601/* Pseudovector types. */
c9f6631c 602
539b8c1c 603#define XSETPVECTYPE(v,code) ((v)->size |= PSEUDOVECTOR_FLAG | (code))
7c06ac2b 604#define XSETPSEUDOVECTOR(a, b, code) \
beb9f745
SM
605 (XSETVECTOR (a, b), \
606 eassert ((XVECTOR (a)->size & (PSEUDOVECTOR_FLAG | PVEC_TYPE_MASK)) \
607 == (PSEUDOVECTOR_FLAG | (code))))
7c06ac2b
RS
608#define XSETWINDOW_CONFIGURATION(a, b) \
609 (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW_CONFIGURATION))
610#define XSETPROCESS(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_PROCESS))
611#define XSETWINDOW(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW))
49e49fb5 612#define XSETTERMINAL(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_TERMINAL))
7c06ac2b
RS
613#define XSETSUBR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUBR))
614#define XSETCOMPILED(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_COMPILED))
99a3d506 615#define XSETBUFFER(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BUFFER))
608ff985
RS
616#define XSETCHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_CHAR_TABLE))
617#define XSETBOOL_VECTOR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BOOL_VECTOR))
1842abb2 618#define XSETSUB_CHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUB_CHAR_TABLE))
c9f6631c
GM
619
620/* Convenience macros for dealing with Lisp arrays. */
621
915b2a6a 622#define AREF(ARRAY, IDX) XVECTOR ((ARRAY))->contents[IDX]
c9f6631c 623#define ASIZE(ARRAY) XVECTOR ((ARRAY))->size
915b2a6a 624/* The IDX==IDX tries to detect when the macro argument is side-effecting. */
4b75ffab
SM
625#define ASET(ARRAY, IDX, VAL) \
626 (eassert ((IDX) == (IDX)), \
627 eassert ((IDX) >= 0 && (IDX) < ASIZE (ARRAY)), \
915b2a6a 628 AREF ((ARRAY), (IDX)) = (VAL))
c9f6631c 629
d90a14e0
GM
630/* Convenience macros for dealing with Lisp strings. */
631
674537ea 632#define SDATA(string) (XSTRING (string)->data + 0)
b9466edb
SM
633#define SREF(string, index) (SDATA (string)[index] + 0)
634#define SSET(string, index, new) (SDATA (string)[index] = (new))
7412b6fd
KR
635#define SCHARS(string) (XSTRING (string)->size + 0)
636#define SBYTES(string) (STRING_BYTES (XSTRING (string)) + 0)
637
51b59d79
PE
638/* Avoid "differ in sign" warnings. */
639#define SSDATA(x) ((char *) SDATA (x))
640
7412b6fd
KR
641#define STRING_SET_CHARS(string, newsize) \
642 (XSTRING (string)->size = (newsize))
d90a14e0 643
101d50c8 644#define STRING_COPYIN(string, index, new, count) \
72af86bd 645 memcpy (SDATA (string) + index, new, count)
101d50c8 646
c8a39089
KS
647/* Type checking. */
648
649#define CHECK_TYPE(ok, Qxxxp, x) \
650 do { if (!(ok)) wrong_type_argument (Qxxxp, (x)); } while (0)
651
652
3cfe6dfd 653\f
5f6bf5fe 654/* See the macros in intervals.h. */
e221eae3
JA
655
656typedef struct interval *INTERVAL;
657
658/* Complain if object is not string or buffer type */
874cc80e 659#define CHECK_STRING_OR_BUFFER(x) \
c8a39089
KS
660 CHECK_TYPE (STRINGP (x) || BUFFERP (x), Qbuffer_or_string_p, x)
661
e221eae3 662\f
3cfe6dfd
JB
663/* In a cons, the markbit of the car is the gc mark bit */
664
665struct Lisp_Cons
666 {
8f34f70a
KR
667 /* Please do not use the names of these elements in code other
668 than the core lisp implementation. Use XCAR and XCDR below. */
669#ifdef HIDE_LISP_IMPLEMENTATION
3a623fee
AS
670 Lisp_Object car_;
671 union
672 {
673 Lisp_Object cdr_;
674 struct Lisp_Cons *chain;
675 } u;
8f34f70a 676#else
3a623fee
AS
677 Lisp_Object car;
678 union
679 {
680 Lisp_Object cdr;
681 struct Lisp_Cons *chain;
682 } u;
8f34f70a 683#endif
3cfe6dfd
JB
684 };
685
b7acde90 686/* Take the car or cdr of something known to be a cons cell. */
f3fbd155
KR
687/* The _AS_LVALUE macros shouldn't be used outside of the minimal set
688 of code that has to know what a cons cell looks like. Other code not
689 part of the basic lisp implementation should assume that the car and cdr
690 fields are not accessible as lvalues. (What if we want to switch to
691 a copying collector someday? Cached cons cell field addresses may be
692 invalidated at arbitrary points.) */
8f34f70a 693#ifdef HIDE_LISP_IMPLEMENTATION
f3fbd155 694#define XCAR_AS_LVALUE(c) (XCONS ((c))->car_)
3a623fee 695#define XCDR_AS_LVALUE(c) (XCONS ((c))->u.cdr_)
8f34f70a 696#else
f3fbd155 697#define XCAR_AS_LVALUE(c) (XCONS ((c))->car)
3a623fee 698#define XCDR_AS_LVALUE(c) (XCONS ((c))->u.cdr)
8f34f70a 699#endif
b7acde90 700
f3fbd155
KR
701/* Use these from normal code. */
702#define XCAR(c) LISP_MAKE_RVALUE(XCAR_AS_LVALUE(c))
703#define XCDR(c) LISP_MAKE_RVALUE(XCDR_AS_LVALUE(c))
704
705/* Use these to set the fields of a cons cell.
706
707 Note that both arguments may refer to the same object, so 'n'
708 should not be read after 'c' is first modified. Also, neither
709 argument should be evaluated more than once; side effects are
710 especially common in the second argument. */
711#define XSETCAR(c,n) (XCAR_AS_LVALUE(c) = (n))
712#define XSETCDR(c,n) (XCDR_AS_LVALUE(c) = (n))
713
b7acde90
KH
714/* Take the car or cdr of something whose type is not known. */
715#define CAR(c) \
716 (CONSP ((c)) ? XCAR ((c)) \
717 : NILP ((c)) ? Qnil \
915b2a6a 718 : wrong_type_argument (Qlistp, (c)))
b7acde90
KH
719
720#define CDR(c) \
721 (CONSP ((c)) ? XCDR ((c)) \
722 : NILP ((c)) ? Qnil \
915b2a6a 723 : wrong_type_argument (Qlistp, (c)))
b7acde90 724
c8a39089
KS
725/* Take the car or cdr of something whose type is not known. */
726#define CAR_SAFE(c) \
727 (CONSP ((c)) ? XCAR ((c)) : Qnil)
728
729#define CDR_SAFE(c) \
730 (CONSP ((c)) ? XCDR ((c)) : Qnil)
731
d8fc7ce4
KH
732/* Nonzero if STR is a multibyte string. */
733#define STRING_MULTIBYTE(STR) \
734 (XSTRING (STR)->size_byte >= 0)
735
736/* Return the length in bytes of STR. */
35f464a7
GM
737
738#ifdef GC_CHECK_STRING_BYTES
739
740struct Lisp_String;
14162469 741extern EMACS_INT string_bytes (struct Lisp_String *);
35f464a7
GM
742#define STRING_BYTES(S) string_bytes ((S))
743
744#else /* not GC_CHECK_STRING_BYTES */
745
d8fc7ce4
KH
746#define STRING_BYTES(STR) \
747 ((STR)->size_byte < 0 ? (STR)->size : (STR)->size_byte)
748
35f464a7
GM
749#endif /* not GC_CHECK_STRING_BYTES */
750
491c2516 751/* Mark STR as a unibyte string. */
2c668b9a
JB
752#define STRING_SET_UNIBYTE(STR) \
753 do { if (EQ (STR, empty_multibyte_string)) \
754 (STR) = empty_unibyte_string; \
755 else XSTRING (STR)->size_byte = -1; } while (0)
491c2516 756
94ef4d69
KH
757/* Mark STR as a multibyte string. Assure that STR contains only
758 ASCII characters in advance. */
759#define STRING_SET_MULTIBYTE(STR) \
760 do { if (EQ (STR, empty_unibyte_string)) \
761 (STR) = empty_multibyte_string; \
762 else XSTRING (STR)->size_byte = XSTRING (STR)->size; } while (0)
763
491c2516 764/* Get text properties. */
90b81429
KR
765#define STRING_INTERVALS(STR) (XSTRING (STR)->intervals + 0)
766
767/* Set text properties. */
768#define STRING_SET_INTERVALS(STR, INT) (XSTRING (STR)->intervals = (INT))
d8fc7ce4 769
3cfe6dfd
JB
770/* In a string or vector, the sign bit of the `size' is the gc mark bit */
771
772struct Lisp_String
773 {
627a9502 774 EMACS_INT size;
a1b5012f 775 EMACS_INT size_byte;
4618074a 776 INTERVAL intervals; /* text properties in this string */
f05d7ea2 777 unsigned char *data;
3cfe6dfd
JB
778 };
779
780struct Lisp_Vector
781 {
d0fdb6da 782 EMACS_UINT size;
3cfe6dfd
JB
783 struct Lisp_Vector *next;
784 Lisp_Object contents[1];
785 };
786
94225242 787/* If a struct is made to look like a vector, this macro returns the length
4115d3f7 788 of the shortest vector that would hold that struct. */
4bb7141c 789#define VECSIZE(type) ((sizeof (type) \
89887d67 790 - offsetof (struct Lisp_Vector, contents[0]) \
4bb7141c 791 + sizeof(Lisp_Object) - 1) /* round up */ \
94225242
KH
792 / sizeof (Lisp_Object))
793
d0ebe33a
SM
794/* Like VECSIZE, but used when the pseudo-vector has non-Lisp_Object fields
795 at the end and we need to compute the number of Lisp_Object fields (the
796 ones that the GC needs to trace). */
797#define PSEUDOVECSIZE(type, nonlispfield) \
89887d67 798 ((offsetof(type, nonlispfield) - offsetof(struct Lisp_Vector, contents[0])) \
d0ebe33a
SM
799 / sizeof (Lisp_Object))
800
1842abb2 801/* A char-table is a kind of vectorlike, with contents are like a
ea724a01 802 vector but with a few other slots. For some purposes, it makes
1842abb2 803 sense to handle a char-table with type struct Lisp_Vector. An
ea724a01
KH
804 element of a char table can be any Lisp objects, but if it is a sub
805 char-table, we treat it a table that contains information of a
1842abb2
KH
806 specific range of characters. A sub char-table has the same
807 structure as a vector. A sub char table appears only in an element
808 of a char-table, and there's no way to access it directly from
809 Emacs Lisp program. */
608ff985 810
ea724a01
KH
811/* This is the number of slots that every char table must have. This
812 counts the ordinary slots and the top, defalt, parent, and purpose
813 slots. */
1842abb2 814#define CHAR_TABLE_STANDARD_SLOTS (VECSIZE (struct Lisp_Char_Table) - 1)
608ff985
RS
815
816/* Return the number of "extra" slots in the char table CT. */
817
818#define CHAR_TABLE_EXTRA_SLOTS(CT) \
819 (((CT)->size & PSEUDOVECTOR_SIZE_MASK) - CHAR_TABLE_STANDARD_SLOTS)
820
d9da2f45
KH
821#ifdef __GNUC__
822
823#define CHAR_TABLE_REF_ASCII(CT, IDX) \
824 ({struct Lisp_Char_Table *_tbl = NULL; \
825 Lisp_Object _val; \
826 do { \
827 _tbl = _tbl ? XCHAR_TABLE (_tbl->parent) : XCHAR_TABLE (CT); \
828 _val = (! SUB_CHAR_TABLE_P (_tbl->ascii) ? _tbl->ascii \
829 : XSUB_CHAR_TABLE (_tbl->ascii)->contents[IDX]); \
830 if (NILP (_val)) \
831 _val = _tbl->defalt; \
832 } while (NILP (_val) && ! NILP (_tbl->parent)); \
833 _val; })
c5c21b70 834
d9da2f45
KH
835#else /* not __GNUC__ */
836
837#define CHAR_TABLE_REF_ASCII(CT, IDX) \
838 (! NILP (XCHAR_TABLE (CT)->ascii) \
839 ? (! SUB_CHAR_TABLE_P (XCHAR_TABLE (CT)->ascii) \
840 ? XCHAR_TABLE (CT)->ascii \
841 : ! NILP (XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX]) \
842 ? XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX] \
843 : char_table_ref ((CT), (IDX))) \
844 : char_table_ref ((CT), (IDX)))
845
846#endif /* not __GNUC__ */
847
b96656ce 848/* Almost equivalent to Faref (CT, IDX) with optimization for ASCII
1842abb2 849 characters. Do not check validity of CT. */
d9da2f45
KH
850#define CHAR_TABLE_REF(CT, IDX) \
851 (ASCII_CHAR_P (IDX) ? CHAR_TABLE_REF_ASCII ((CT), (IDX)) \
1842abb2 852 : char_table_ref ((CT), (IDX)))
b96656ce 853
dcafe1c7
KH
854/* Almost equivalent to Faref (CT, IDX). However, if the result is
855 not a character, return IDX.
29b7163f
RS
856
857 For these characters, do not check validity of CT
858 and do not follow parent. */
1842abb2
KH
859#define CHAR_TABLE_TRANSLATE(CT, IDX) \
860 char_table_translate (CT, IDX)
29b7163f 861
b96656ce 862/* Equivalent to Faset (CT, IDX, VAL) with optimization for ASCII and
c497dce4 863 8-bit European characters. Do not check validity of CT. */
1842abb2
KH
864#define CHAR_TABLE_SET(CT, IDX, VAL) \
865 (((IDX) >= 0 && ASCII_CHAR_P (IDX) \
866 && SUB_CHAR_TABLE_P (XCHAR_TABLE (CT)->ascii)) \
867 ? XSUB_CHAR_TABLE (XCHAR_TABLE (CT)->ascii)->contents[IDX] = VAL \
868 : char_table_set (CT, IDX, VAL))
869
1842abb2
KH
870#define CHARTAB_SIZE_BITS_0 6
871#define CHARTAB_SIZE_BITS_1 4
872#define CHARTAB_SIZE_BITS_2 5
873#define CHARTAB_SIZE_BITS_3 7
874
875extern const int chartab_size[4];
876
877struct Lisp_Sub_Char_Table;
b96656ce 878
608ff985
RS
879struct Lisp_Char_Table
880 {
881 /* This is the vector's size field, which also holds the
882 pseudovector type information. It holds the size, too.
c73bd236
MB
883 The size counts the defalt, parent, purpose, ascii,
884 contents, and extras slots. */
d0fdb6da 885 EMACS_UINT size;
608ff985 886 struct Lisp_Vector *next;
1842abb2 887
608ff985
RS
888 /* This holds a default value,
889 which is used whenever the value for a specific character is nil. */
890 Lisp_Object defalt;
ea724a01 891
8f924df7
KH
892 /* This points to another char table, which we inherit from when the
893 value for a specific character is nil. The `defalt' slot takes
894 precedence over this. */
608ff985 895 Lisp_Object parent;
1842abb2 896
8f924df7
KH
897 /* This is a symbol which says what kind of use this char-table is
898 meant for. */
7f73dc9d 899 Lisp_Object purpose;
1842abb2 900
8f924df7
KH
901 /* The bottom sub char-table for characters of the range 0..127. It
902 is nil if none of ASCII character has a specific value. */
903 Lisp_Object ascii;
1842abb2 904
8f924df7 905 Lisp_Object contents[(1 << CHARTAB_SIZE_BITS_0)];
1842abb2 906
8f924df7 907 /* These hold additional data. It is a vector. */
608ff985
RS
908 Lisp_Object extras[1];
909 };
910
1842abb2 911struct Lisp_Sub_Char_Table
8f924df7
KH
912 {
913 /* This is the vector's size field, which also holds the
914 pseudovector type information. It holds the size, too. */
915 EMACS_INT size;
916 struct Lisp_Vector *next;
1842abb2 917
8f924df7 918 /* Depth of this sub char-table. It should be 1, 2, or 3. A sub
78edd3b7 919 char-table of depth 1 contains 16 elements, and each element
8f924df7
KH
920 covers 4096 (128*32) characters. A sub char-table of depth 2
921 contains 32 elements, and each element covers 128 characters. A
922 sub char-table of depth 3 contains 128 elements, and each element
923 is for one character. */
924 Lisp_Object depth;
1842abb2 925
8f924df7
KH
926 /* Minimum character covered by the sub char-table. */
927 Lisp_Object min_char;
1842abb2 928
8f924df7
KH
929 Lisp_Object contents[1];
930 };
608ff985
RS
931
932/* A boolvector is a kind of vectorlike, with contents are like a string. */
933struct Lisp_Bool_Vector
934 {
935 /* This is the vector's size field. It doesn't have the real size,
936 just the subtype information. */
d0fdb6da 937 EMACS_UINT vector_size;
608ff985
RS
938 struct Lisp_Vector *next;
939 /* This is the size in bits. */
d0fdb6da 940 EMACS_UINT size;
608ff985
RS
941 /* This contains the actual bits, packed into bytes. */
942 unsigned char data[1];
943 };
944
7c06ac2b
RS
945/* This structure describes a built-in function.
946 It is generated by the DEFUN macro only.
947 defsubr makes it into a Lisp object.
948
949 This type is treated in most respects as a pseudovector,
950 but since we never dynamically allocate or free them,
951 we don't need a next-vector field. */
e98227af 952
3cfe6dfd
JB
953struct Lisp_Subr
954 {
d0fdb6da 955 EMACS_UINT size;
c0f2f16b
DN
956 union {
957 Lisp_Object (*a0) (void);
958 Lisp_Object (*a1) (Lisp_Object);
959 Lisp_Object (*a2) (Lisp_Object, Lisp_Object);
960 Lisp_Object (*a3) (Lisp_Object, Lisp_Object, Lisp_Object);
961 Lisp_Object (*a4) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
962 Lisp_Object (*a5) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
963 Lisp_Object (*a6) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
964 Lisp_Object (*a7) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
965 Lisp_Object (*a8) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
d5273788
SM
966 Lisp_Object (*aUNEVALLED) (Lisp_Object args);
967 Lisp_Object (*aMANY) (int, Lisp_Object *);
c0f2f16b 968 } function;
3cfe6dfd 969 short min_args, max_args;
5e2327cf 970 const char *symbol_name;
89dc303e
DN
971 const char *intspec;
972 const char *doc;
3cfe6dfd 973 };
5010d3b8
GM
974
975\f
a32fa736
GM
976/***********************************************************************
977 Symbols
978 ***********************************************************************/
979
980/* Interned state of a symbol. */
981
982enum symbol_interned
983{
984 SYMBOL_UNINTERNED = 0,
985 SYMBOL_INTERNED = 1,
986 SYMBOL_INTERNED_IN_INITIAL_OBARRAY = 2
987};
988
ce5b453a
SM
989enum symbol_redirect
990{
991 SYMBOL_PLAINVAL = 4,
992 SYMBOL_VARALIAS = 1,
993 SYMBOL_LOCALIZED = 2,
994 SYMBOL_FORWARDED = 3
995};
996
a32fa736
GM
997/* In a symbol, the markbit of the plist is used as the gc mark bit */
998
999struct Lisp_Symbol
1000{
a84f89d5
SM
1001 unsigned gcmarkbit : 1;
1002
ce5b453a
SM
1003 /* Indicates where the value can be found:
1004 0 : it's a plain var, the value is in the `value' field.
1005 1 : it's a varalias, the value is really in the `alias' symbol.
1006 2 : it's a localized var, the value is in the `blv' object.
1007 3 : it's a forwarding variable, the value is in `forward'.
1008 */
1009 enum symbol_redirect redirect : 3;
a32fa736
GM
1010
1011 /* Non-zero means symbol is constant, i.e. changing its value
ce5b453a
SM
1012 should signal an error. If the value is 3, then the var
1013 can be changed, but only by `defconst'. */
1014 unsigned constant : 2;
a32fa736
GM
1015
1016 /* Interned state of the symbol. This is an enumerator from
1017 enum symbol_interned. */
1018 unsigned interned : 2;
1019
74d70085
KR
1020 /* The symbol's name, as a Lisp string.
1021
1022 The name "xname" is used to intentionally break code referring to
1023 the old field "name" of type pointer to struct Lisp_String. */
1024 Lisp_Object xname;
a32fa736
GM
1025
1026 /* Value of the symbol or Qunbound if unbound. If this symbol is a
ce5b453a 1027 defvaralias, `alias' contains the symbol for which it is an
a32fa736
GM
1028 alias. Use the SYMBOL_VALUE and SET_SYMBOL_VALUE macros to get
1029 and set a symbol's value, to take defvaralias into account. */
ce5b453a
SM
1030 union {
1031 Lisp_Object value;
1032 struct Lisp_Symbol *alias;
1033 struct Lisp_Buffer_Local_Value *blv;
1034 union Lisp_Fwd *fwd;
1035 } val;
a32fa736 1036
d28981c9 1037 /* Function value of the symbol or Qunbound if not fboundp. */
a32fa736
GM
1038 Lisp_Object function;
1039
1040 /* The symbol's property list. */
1041 Lisp_Object plist;
e2c0561e 1042
a32fa736
GM
1043 /* Next symbol in obarray bucket, if the symbol is interned. */
1044 struct Lisp_Symbol *next;
1045};
1046
74d70085
KR
1047/* Value is name of symbol. */
1048
ce5b453a
SM
1049#define SYMBOL_VAL(sym) \
1050 (eassert ((sym)->redirect == SYMBOL_PLAINVAL), (sym)->val.value)
1051#define SYMBOL_ALIAS(sym) \
1052 (eassert ((sym)->redirect == SYMBOL_VARALIAS), (sym)->val.alias)
1053#define SYMBOL_BLV(sym) \
1054 (eassert ((sym)->redirect == SYMBOL_LOCALIZED), (sym)->val.blv)
1055#define SYMBOL_FWD(sym) \
1056 (eassert ((sym)->redirect == SYMBOL_FORWARDED), (sym)->val.fwd)
1057#define SET_SYMBOL_VAL(sym, v) \
1058 (eassert ((sym)->redirect == SYMBOL_PLAINVAL), (sym)->val.value = (v))
1059#define SET_SYMBOL_ALIAS(sym, v) \
1060 (eassert ((sym)->redirect == SYMBOL_VARALIAS), (sym)->val.alias = (v))
1061#define SET_SYMBOL_BLV(sym, v) \
1062 (eassert ((sym)->redirect == SYMBOL_LOCALIZED), (sym)->val.blv = (v))
1063#define SET_SYMBOL_FWD(sym, v) \
1064 (eassert ((sym)->redirect == SYMBOL_FORWARDED), (sym)->val.fwd = (v))
1065
74d70085
KR
1066#define SYMBOL_NAME(sym) \
1067 LISP_MAKE_RVALUE (XSYMBOL (sym)->xname)
1068
a32fa736
GM
1069/* Value is non-zero if SYM is an interned symbol. */
1070
1071#define SYMBOL_INTERNED_P(sym) \
1072 (XSYMBOL (sym)->interned != SYMBOL_UNINTERNED)
1073
1074/* Value is non-zero if SYM is interned in initial_obarray. */
1075
1076#define SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P(sym) \
1077 (XSYMBOL (sym)->interned == SYMBOL_INTERNED_IN_INITIAL_OBARRAY)
1078
1079/* Value is non-zero if symbol is considered a constant, i.e. its
1080 value cannot be changed (there is an exception for keyword symbols,
1081 whose value can be set to the keyword symbol itself). */
1082
1083#define SYMBOL_CONSTANT_P(sym) XSYMBOL (sym)->constant
1084
a32fa736 1085\f
5010d3b8
GM
1086/***********************************************************************
1087 Hash Tables
1088 ***********************************************************************/
1089
1090/* The structure of a Lisp hash table. */
1091
1092struct Lisp_Hash_Table
1093{
1094 /* Vector fields. The hash table code doesn't refer to these. */
d0fdb6da 1095 EMACS_UINT size;
5010d3b8 1096 struct Lisp_Vector *vec_next;
e2c0561e 1097
5010d3b8
GM
1098 /* Function used to compare keys. */
1099 Lisp_Object test;
1100
1101 /* Nil if table is non-weak. Otherwise a symbol describing the
1102 weakness of the table. */
1103 Lisp_Object weak;
e2c0561e 1104
5010d3b8
GM
1105 /* When the table is resized, and this is an integer, compute the
1106 new size by adding this to the old size. If a float, compute the
1107 new size by multiplying the old size with this factor. */
1108 Lisp_Object rehash_size;
1109
1110 /* Resize hash table when number of entries/ table size is >= this
1111 ratio, a float. */
1112 Lisp_Object rehash_threshold;
1113
5010d3b8
GM
1114 /* Vector of hash codes.. If hash[I] is nil, this means that that
1115 entry I is unused. */
1116 Lisp_Object hash;
1117
1118 /* Vector used to chain entries. If entry I is free, next[I] is the
1119 entry number of the next free item. If entry I is non-free,
1120 next[I] is the index of the next entry in the collision chain. */
1121 Lisp_Object next;
1122
1123 /* Index of first free entry in free list. */
1124 Lisp_Object next_free;
1125
1126 /* Bucket vector. A non-nil entry is the index of the first item in
1127 a collision chain. This vector's size can be larger than the
1128 hash table size to reduce collisions. */
1129 Lisp_Object index;
1130
5010d3b8
GM
1131 /* User-supplied hash function, or nil. */
1132 Lisp_Object user_hash_function;
1133
1134 /* User-supplied key comparison function, or nil. */
1135 Lisp_Object user_cmp_function;
1136
878f97ff 1137 /* Only the fields above are traced normally by the GC. The ones below
78edd3b7 1138 `count' are special and are either ignored by the GC or traced in
878f97ff
SM
1139 a special way (e.g. because of weakness). */
1140
1141 /* Number of key/value entries in the table. */
1142 unsigned int count;
1143
1144 /* Vector of keys and values. The key of item I is found at index
1145 2 * I, the value is found at index 2 * I + 1.
1146 This is gc_marked specially if the table is weak. */
1147 Lisp_Object key_and_value;
1148
6c661ec9
SM
1149 /* Next weak hash table if this is a weak hash table. The head
1150 of the list is in weak_hash_tables. */
1151 struct Lisp_Hash_Table *next_weak;
1152
5010d3b8 1153 /* C function to compare two keys. */
383e0970
J
1154 int (* cmpfn) (struct Lisp_Hash_Table *, Lisp_Object,
1155 unsigned, Lisp_Object, unsigned);
5010d3b8
GM
1156
1157 /* C function to compute hash code. */
383e0970 1158 unsigned (* hashfn) (struct Lisp_Hash_Table *, Lisp_Object);
5010d3b8
GM
1159};
1160
1161
1162#define XHASH_TABLE(OBJ) \
1163 ((struct Lisp_Hash_Table *) XPNTR (OBJ))
1164
1165#define XSET_HASH_TABLE(VAR, PTR) \
1166 (XSETPSEUDOVECTOR (VAR, PTR, PVEC_HASH_TABLE))
1167
1168#define HASH_TABLE_P(OBJ) PSEUDOVECTORP (OBJ, PVEC_HASH_TABLE)
5010d3b8 1169
c8a39089
KS
1170#define CHECK_HASH_TABLE(x) \
1171 CHECK_TYPE (HASH_TABLE_P (x), Qhash_table_p, x)
5010d3b8 1172
141788b5
SM
1173/* Value is the key part of entry IDX in hash table H. */
1174
915b2a6a 1175#define HASH_KEY(H, IDX) AREF ((H)->key_and_value, 2 * (IDX))
141788b5
SM
1176
1177/* Value is the value part of entry IDX in hash table H. */
1178
915b2a6a 1179#define HASH_VALUE(H, IDX) AREF ((H)->key_and_value, 2 * (IDX) + 1)
141788b5
SM
1180
1181/* Value is the index of the next entry following the one at IDX
1182 in hash table H. */
1183
915b2a6a 1184#define HASH_NEXT(H, IDX) AREF ((H)->next, (IDX))
141788b5
SM
1185
1186/* Value is the hash code computed for entry IDX in hash table H. */
1187
915b2a6a 1188#define HASH_HASH(H, IDX) AREF ((H)->hash, (IDX))
141788b5
SM
1189
1190/* Value is the index of the element in hash table H that is the
1191 start of the collision list at index IDX in the index vector of H. */
1192
915b2a6a 1193#define HASH_INDEX(H, IDX) AREF ((H)->index, (IDX))
141788b5
SM
1194
1195/* Value is the size of hash table H. */
1196
1197#define HASH_TABLE_SIZE(H) XVECTOR ((H)->next)->size
1198
5010d3b8
GM
1199/* Default size for hash tables if not specified. */
1200
1201#define DEFAULT_HASH_SIZE 65
1202
1203/* Default threshold specifying when to resize a hash table. The
1204 value gives the ratio of current entries in the hash table and the
1205 size of the hash table. */
1206
1207#define DEFAULT_REHASH_THRESHOLD 0.8
1208
1209/* Default factor by which to increase the size of a hash table. */
1210
1211#define DEFAULT_REHASH_SIZE 1.5
1212
ee4c9ce4 1213\f
7c06ac2b
RS
1214/* These structures are used for various misc types. */
1215
67ee9f6e
SM
1216struct Lisp_Misc_Any /* Supertype of all Misc types. */
1217{
ce5b453a 1218 enum Lisp_Misc_Type type : 16; /* = Lisp_Misc_??? */
67ee9f6e
SM
1219 unsigned gcmarkbit : 1;
1220 int spacer : 15;
ce5b453a
SM
1221 /* Make it as long as "Lisp_Free without padding". */
1222 void *fill;
67ee9f6e
SM
1223};
1224
3cfe6dfd 1225struct Lisp_Marker
308e97d0 1226{
eac1939a 1227 enum Lisp_Misc_Type type : 16; /* = Lisp_Misc_Marker */
a84f89d5 1228 unsigned gcmarkbit : 1;
9bb13d08
KH
1229 int spacer : 13;
1230 /* This flag is temporarily used in the functions
1231 decode/encode_coding_object to record that the marker position
1232 must be adjusted after the conversion. */
1233 unsigned int need_adjustment : 1;
308e97d0
RS
1234 /* 1 means normal insertion at the marker's position
1235 leaves the marker after the inserted text. */
1236 unsigned int insertion_type : 1;
b9466edb
SM
1237 /* This is the buffer that the marker points into, or 0 if it points nowhere.
1238 Note: a chain of markers can contain markers pointing into different
1239 buffers (the chain is per buffer_text rather than per buffer, so it's
1240 shared between indirect buffers). */
1241 /* This is used for (other than NULL-checking):
1242 - Fmarker_buffer
1243 - Fset_marker: check eq(oldbuf, newbuf) to avoid unchain+rechain.
1244 - unchain_marker: to find the list from which to unchain.
ce5b453a 1245 - Fkill_buffer: to only unchain the markers of current indirect buffer.
b9466edb 1246 */
308e97d0 1247 struct buffer *buffer;
4ed24bf3
RS
1248
1249 /* The remaining fields are meaningless in a marker that
1250 does not point anywhere. */
1251
1252 /* For markers that point somewhere,
1253 this is used to chain of all the markers in a given buffer. */
d6aa1876
SM
1254 /* We could remove it and use an array in buffer_text instead.
1255 That would also allow to preserve it ordered. */
c0ac2f4a 1256 struct Lisp_Marker *next;
4ed24bf3 1257 /* This is the char position where the marker points. */
5f6bf5fe 1258 EMACS_INT charpos;
ce5b453a
SM
1259 /* This is the byte position.
1260 It's mostly used as a charpos<->bytepos cache (i.e. it's not directly
1261 used to implement the functionality of markers, but rather to (ab)use
1262 markers as a cache for char<->byte mappings). */
5f6bf5fe 1263 EMACS_INT bytepos;
308e97d0 1264};
3cfe6dfd 1265
ee4c9ce4
KH
1266/* Forwarding pointer to an int variable.
1267 This is allowed only in the value cell of a symbol,
1268 and it means that the symbol's value really lives in the
1269 specified int variable. */
1270struct Lisp_Intfwd
84d1833e 1271 {
ce5b453a 1272 enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Int */
31ade731 1273 EMACS_INT *intvar;
ee4c9ce4
KH
1274 };
1275
1276/* Boolean forwarding pointer to an int variable.
1277 This is like Lisp_Intfwd except that the ostensible
1278 "value" of the symbol is t if the int variable is nonzero,
1279 nil if it is zero. */
1280struct Lisp_Boolfwd
1281 {
ce5b453a 1282 enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Bool */
ee4c9ce4
KH
1283 int *boolvar;
1284 };
1285
1286/* Forwarding pointer to a Lisp_Object variable.
1287 This is allowed only in the value cell of a symbol,
1288 and it means that the symbol's value really lives in the
1289 specified variable. */
1290struct Lisp_Objfwd
1291 {
ce5b453a 1292 enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Obj */
ee4c9ce4
KH
1293 Lisp_Object *objvar;
1294 };
1295
1296/* Like Lisp_Objfwd except that value lives in a slot in the
1297 current buffer. Value is byte index of slot within buffer. */
1298struct Lisp_Buffer_Objfwd
1299 {
ce5b453a 1300 enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Buffer_Obj */
ee4c9ce4 1301 int offset;
ce5b453a 1302 Lisp_Object slottype; /* Qnil, Lisp_Int, Lisp_Symbol, or Lisp_String. */
84d1833e
KH
1303 };
1304
65d0110b
RS
1305/* struct Lisp_Buffer_Local_Value is used in a symbol value cell when
1306 the symbol has buffer-local or frame-local bindings. (Exception:
1307 some buffer-local variables are built-in, with their values stored
1308 in the buffer structure itself. They are handled differently,
1309 using struct Lisp_Buffer_Objfwd.)
1310
1311 The `realvalue' slot holds the variable's current value, or a
1312 forwarding pointer to where that value is kept. This value is the
1313 one that corresponds to the loaded binding. To read or set the
1314 variable, you must first make sure the right binding is loaded;
1315 then you can access the value in (or through) `realvalue'.
e2c0561e 1316
65d0110b
RS
1317 `buffer' and `frame' are the buffer and frame for which the loaded
1318 binding was found. If those have changed, to make sure the right
1319 binding is loaded it is necessary to find which binding goes with
1320 the current buffer and selected frame, then load it. To load it,
1321 first unload the previous binding, then copy the value of the new
1322 binding into `realvalue' (or through it). Also update
1323 LOADED-BINDING to point to the newly loaded binding.
7d65f1c2 1324
78edd3b7
JB
1325 `local_if_set' indicates that merely setting the variable creates a
1326 local binding for the current buffer. Otherwise the latter, setting
1327 the variable does not do that; only make-local-variable does that. */
65d0110b 1328
7d65f1c2
KH
1329struct Lisp_Buffer_Local_Value
1330 {
67ee9f6e
SM
1331 /* 1 means that merely setting the variable creates a local
1332 binding for the current buffer */
1333 unsigned int local_if_set : 1;
ce5b453a
SM
1334 /* 1 means this variable can have frame-local bindings, otherwise, it is
1335 can have buffer-local bindings. The two cannot be combined. */
1336 unsigned int frame_local : 1;
1337 /* 1 means that the binding now loaded was found.
1338 Presumably equivalent to (defcell!=valcell) */
1339 unsigned int found : 1;
1340 /* If non-NULL, a forwarding to the C var where it should also be set. */
1341 union Lisp_Fwd *fwd; /* Should never be (Buffer|Kboard)_Objfwd. */
1342 /* The buffer or frame for which the loaded binding was found. */
1343 Lisp_Object where;
1344 /* A cons cell that holds the default value. It has the form
1345 (SYMBOL . DEFAULT-VALUE). */
1346 Lisp_Object defcell;
1347 /* The cons cell from `where's parameter alist.
1348 It always has the form (SYMBOL . VALUE)
1349 Note that if `forward' is non-nil, VALUE may be out of date.
1350 Also if the currently loaded binding is the default binding, then
1351 this is `eq'ual to defcell. */
1352 Lisp_Object valcell;
7d65f1c2
KH
1353 };
1354
ce5b453a
SM
1355#define BLV_FOUND(blv) \
1356 (eassert ((blv)->found == !EQ ((blv)->defcell, (blv)->valcell)), (blv)->found)
1357#define SET_BLV_FOUND(blv, v) \
1358 (eassert ((v) == !EQ ((blv)->defcell, (blv)->valcell)), (blv)->found = (v))
1359
1360#define BLV_VALUE(blv) (XCDR ((blv)->valcell))
1361#define SET_BLV_VALUE(blv, v) (XSETCDR ((blv)->valcell, v))
1362
5f6bf5fe 1363/* START and END are markers in the overlay's buffer, and
ce7d8eec
KH
1364 PLIST is the overlay's property list. */
1365struct Lisp_Overlay
ce5b453a
SM
1366/* An overlay's real data content is:
1367 - plist
1368 - buffer
1369 - insertion type of both ends
1370 - start & start_byte
1371 - end & end_byte
1372 - next (singly linked list of overlays).
1373 - start_next and end_next (singly linked list of markers).
1374 I.e. 9words plus 2 bits, 3words of which are for external linked lists.
1375*/
ce7d8eec 1376 {
eac1939a 1377 enum Lisp_Misc_Type type : 16; /* = Lisp_Misc_Overlay */
a84f89d5
SM
1378 unsigned gcmarkbit : 1;
1379 int spacer : 15;
b01ecbc6 1380 struct Lisp_Overlay *next;
ce7d8eec
KH
1381 Lisp_Object start, end, plist;
1382 };
5bfac5a9 1383
f334de0e 1384/* Like Lisp_Objfwd except that value lives in a slot in the
32462604
KH
1385 current kboard. */
1386struct Lisp_Kboard_Objfwd
f334de0e 1387 {
ce5b453a 1388 enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Kboard_Obj */
f334de0e
KH
1389 int offset;
1390 };
1391
222151aa
RS
1392/* Hold a C pointer for later use.
1393 This type of object is used in the arg to record_unwind_protect. */
1394struct Lisp_Save_Value
1395 {
eac1939a 1396 enum Lisp_Misc_Type type : 16; /* = Lisp_Misc_Save_Value */
a84f89d5 1397 unsigned gcmarkbit : 1;
5f5d6c62
KS
1398 int spacer : 14;
1399 /* If DOGC is set, POINTER is the address of a memory
1400 area containing INTEGER potential Lisp_Objects. */
1401 unsigned int dogc : 1;
222151aa
RS
1402 void *pointer;
1403 int integer;
1404 };
1405
5bfac5a9 1406
6b61353c
KH
1407/* A miscellaneous object, when it's on the free list. */
1408struct Lisp_Free
1409 {
eac1939a 1410 enum Lisp_Misc_Type type : 16; /* = Lisp_Misc_Free */
6b61353c
KH
1411 unsigned gcmarkbit : 1;
1412 int spacer : 15;
1413 union Lisp_Misc *chain;
1414#ifdef USE_LSB_TAG
1415 /* Try to make sure that sizeof(Lisp_Misc) preserves TYPEBITS-alignment.
1416 This assumes that Lisp_Marker is the largest of the alternatives and
ce5b453a 1417 that Lisp_Misc_Any has the same size as "Lisp_Free w/o padding". */
6b61353c 1418 char padding[((((sizeof (struct Lisp_Marker) - 1) >> GCTYPEBITS) + 1)
ce5b453a 1419 << GCTYPEBITS) - sizeof (struct Lisp_Misc_Any)];
6b61353c
KH
1420#endif
1421 };
1422
a7aa28f6
RS
1423/* To get the type field of a union Lisp_Misc, use XMISCTYPE.
1424 It uses one of these struct subtypes to get the type field. */
1425
84d1833e
KH
1426union Lisp_Misc
1427 {
67ee9f6e
SM
1428 struct Lisp_Misc_Any u_any; /* Supertype of all Misc types. */
1429 struct Lisp_Free u_free; /* Includes padding to force alignment. */
ce5b453a
SM
1430 struct Lisp_Marker u_marker; /* 5 */
1431 struct Lisp_Overlay u_overlay; /* 5 */
1432 struct Lisp_Save_Value u_save_value; /* 3 */
1433 };
1434
1435union Lisp_Fwd
1436 {
1437 struct Lisp_Intfwd u_intfwd; /* 2 */
1438 struct Lisp_Boolfwd u_boolfwd; /* 2 */
1439 struct Lisp_Objfwd u_objfwd; /* 2 */
1440 struct Lisp_Buffer_Objfwd u_buffer_objfwd; /* 2 */
1441 struct Lisp_Kboard_Objfwd u_kboard_objfwd; /* 2 */
84d1833e 1442 };
7c06ac2b 1443\f
cc94f3b2 1444/* Lisp floating point type */
3cfe6dfd
JB
1445struct Lisp_Float
1446 {
3a623fee
AS
1447 union
1448 {
8f34f70a 1449#ifdef HIDE_LISP_IMPLEMENTATION
3a623fee 1450 double data_;
8f34f70a 1451#else
3a623fee 1452 double data;
8f34f70a 1453#endif
3a623fee
AS
1454 struct Lisp_Float *chain;
1455 } u;
3cfe6dfd 1456 };
8f34f70a
KR
1457
1458#ifdef HIDE_LISP_IMPLEMENTATION
52766425 1459#define XFLOAT_DATA(f) (0 ? XFLOAT (f)->u.data_ : XFLOAT (f)->u.data_)
8f34f70a 1460#else
52766425 1461#define XFLOAT_DATA(f) (0 ? XFLOAT (f)->u.data : XFLOAT (f)->u.data)
f601cdf3
KR
1462/* This should be used only in alloc.c, which always disables
1463 HIDE_LISP_IMPLEMENTATION. */
1464#define XFLOAT_INIT(f,n) (XFLOAT (f)->u.data = (n))
8f34f70a 1465#endif
3cfe6dfd
JB
1466
1467/* A character, declared with the following typedef, is a member
99a3d506 1468 of some character set associated with the current buffer. */
b2ba7b00
RS
1469#ifndef _UCHAR_T /* Protect against something in ctab.h on AIX. */
1470#define _UCHAR_T
3cfe6dfd 1471typedef unsigned char UCHAR;
b2ba7b00 1472#endif
3cfe6dfd
JB
1473
1474/* Meanings of slots in a Lisp_Compiled: */
1475
1476#define COMPILED_ARGLIST 0
1477#define COMPILED_BYTECODE 1
1478#define COMPILED_CONSTANTS 2
1479#define COMPILED_STACK_DEPTH 3
1480#define COMPILED_DOC_STRING 4
1481#define COMPILED_INTERACTIVE 5
88dbfee5 1482
d03f79ef
JB
1483/* Flag bits in a character. These also get used in termhooks.h.
1484 Richard Stallman <rms@gnu.ai.mit.edu> thinks that MULE
7c06ac2b
RS
1485 (MUlti-Lingual Emacs) might need 22 bits for the character value
1486 itself, so we probably shouldn't use any bits lower than 0x0400000. */
1487#define CHAR_ALT (0x0400000)
1488#define CHAR_SUPER (0x0800000)
1489#define CHAR_HYPER (0x1000000)
1490#define CHAR_SHIFT (0x2000000)
1491#define CHAR_CTL (0x4000000)
1492#define CHAR_META (0x8000000)
703f2808 1493
048151c1
KH
1494#define CHAR_MODIFIER_MASK \
1495 (CHAR_ALT | CHAR_SUPER | CHAR_HYPER | CHAR_SHIFT | CHAR_CTL | CHAR_META)
1496
1497
1842abb2 1498/* Actually, the current Emacs uses 22 bits for the character value
6b768554 1499 itself. */
13ac3ac9 1500#define CHARACTERBITS 22
6b768554 1501
b0ca4f56
KH
1502/* The maximum byte size consumed by push_key_description.
1503 All callers should assure that at least this size of memory is
1504 allocated at the place pointed by the second argument.
1505
944df511 1506 There are 6 modifiers, each consumes 2 chars.
b0ca4f56
KH
1507 The octal form of a character code consumes
1508 (1 + CHARACTERBITS / 3 + 1) chars (including backslash at the head).
1509 We need one more byte for string terminator `\0'. */
1510#define KEY_DESCRIPTION_SIZE ((2 * 6) + 1 + (CHARACTERBITS / 3) + 1 + 1)
1511
703f2808 1512\f
ec9ed378
KS
1513/* The glyph datatype, used to represent characters on the display.
1514 It consists of a char code and a face id. */
1515
1516typedef struct {
1517 int ch;
1518 int face_id;
1519} GLYPH;
703f2808
JB
1520
1521/* Return a glyph's character code. */
ec9ed378 1522#define GLYPH_CHAR(glyph) ((glyph).ch)
703f2808
JB
1523
1524/* Return a glyph's face ID. */
ec9ed378 1525#define GLYPH_FACE(glyph) ((glyph).face_id)
49b0dd75 1526
ec9ed378
KS
1527#define SET_GLYPH_CHAR(glyph, char) ((glyph).ch = (char))
1528#define SET_GLYPH_FACE(glyph, face) ((glyph).face_id = (face))
1529#define SET_GLYPH(glyph, char, face) ((glyph).ch = (char), (glyph).face_id = (face))
703f2808 1530
e0f24100 1531/* Return 1 if GLYPH contains valid character code. */
ec9ed378
KS
1532#define GLYPH_CHAR_VALID_P(glyph) CHAR_VALID_P (GLYPH_CHAR (glyph), 1)
1533
1534
1535/* Glyph Code from a display vector may either be an integer which
1536 encodes a char code in the lower CHARACTERBITS bits and a (very small)
1537 face-id in the upper bits, or it may be a cons (CHAR . FACE-ID). */
1538
1539#define GLYPH_CODE_CHAR(gc) \
1540 (CONSP (gc) ? XINT (XCAR (gc)) : INTEGERP (gc) ? (XINT (gc) & ((1 << CHARACTERBITS)-1)) : 0)
1541
1542#define GLYPH_CODE_FACE(gc) \
1543 (CONSP (gc) ? XINT (XCDR (gc)) : INTEGERP (gc) ? (XINT (gc) >> CHARACTERBITS) : DEFAULT_FACE_ID)
1544
1545/* Return 1 if glyph code from display vector contains valid character code. */
1546#define GLYPH_CODE_CHAR_VALID_P(gc) CHAR_VALID_P (GLYPH_CODE_CHAR (gc), 1)
1547
1548#define GLYPH_CODE_P(gc) ((CONSP (gc) && INTEGERP (XCAR (gc)) && INTEGERP (XCDR (gc))) || INTEGERP (gc))
1549
1550/* Only called when GLYPH_CODE_P (gc) is true. */
1551#define SET_GLYPH_FROM_GLYPH_CODE(glyph, gc) \
1552 do \
1553 { \
1554 if (CONSP (gc)) \
1555 SET_GLYPH (glyph, XINT (XCAR (gc)), XINT (XCDR (gc))); \
1556 else \
1557 SET_GLYPH (glyph, (XINT (gc) & ((1 << CHARACTERBITS)-1)), \
1558 (XINT (gc) >> CHARACTERBITS)); \
1559 } \
1560 while (0)
b96656ce 1561
4606cc9d
RS
1562/* The ID of the mode line highlighting face. */
1563#define GLYPH_MODE_LINE_FACE 1
3cfe6dfd 1564\f
7ea692f6
EZ
1565/* Structure to hold mouse highlight data. This is here because other
1566 header files need it for defining struct x_output etc. */
1567typedef struct {
1568 /* These variables describe the range of text currently shown in its
1569 mouse-face, together with the window they apply to. As long as
1570 the mouse stays within this range, we need not redraw anything on
1571 its account. Rows and columns are glyph matrix positions in
1572 MOUSE_FACE_WINDOW. */
1573 int mouse_face_beg_row, mouse_face_beg_col;
1574 int mouse_face_beg_x, mouse_face_beg_y;
1575 int mouse_face_end_row, mouse_face_end_col;
1576 int mouse_face_end_x, mouse_face_end_y;
1577 int mouse_face_past_end;
1578 Lisp_Object mouse_face_window;
1579 int mouse_face_face_id;
1580 Lisp_Object mouse_face_overlay;
1581
1582 /* 1 if a mouse motion event came and we didn't handle it right away because
1583 gc was in progress. */
1584 int mouse_face_deferred_gc;
1585
1586 /* FRAME and X, Y position of mouse when last checked for
1587 highlighting. X and Y can be negative or out of range for the frame. */
1588 struct frame *mouse_face_mouse_frame;
1589 int mouse_face_mouse_x, mouse_face_mouse_y;
1590
1591 /* Nonzero means defer mouse-motion highlighting. */
1592 int mouse_face_defer;
1593
1594 /* Nonzero means that the mouse highlight should not be shown. */
1595 int mouse_face_hidden;
1596
1597 int mouse_face_image_state;
1598} Mouse_HLInfo;
1599\f
3cfe6dfd
JB
1600/* Data type checking */
1601
3c7a4fa3 1602#define NILP(x) EQ (x, Qnil)
3cfe6dfd 1603
c5af3bb9 1604#define NUMBERP(x) (INTEGERP (x) || FLOATP (x))
a4a9f09f 1605#define NATNUMP(x) (INTEGERP (x) && XINT (x) >= 0)
4746118a 1606
2de9f71c 1607#define INTEGERP(x) (LISP_INT_TAG_P (XTYPE ((x))))
edfa9106 1608#define SYMBOLP(x) (XTYPE ((x)) == Lisp_Symbol)
84d1833e 1609#define MISCP(x) (XTYPE ((x)) == Lisp_Misc)
b5088f80 1610#define VECTORLIKEP(x) (XTYPE ((x)) == Lisp_Vectorlike)
edfa9106 1611#define STRINGP(x) (XTYPE ((x)) == Lisp_String)
3cfe6dfd 1612#define CONSP(x) (XTYPE ((x)) == Lisp_Cons)
7c06ac2b 1613
edfa9106 1614#define FLOATP(x) (XTYPE ((x)) == Lisp_Float)
2706ceb6 1615#define VECTORP(x) (VECTORLIKEP (x) && !(XVECTOR (x)->size & PSEUDOVECTOR_FLAG))
a7aa28f6 1616#define OVERLAYP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Overlay)
a7aa28f6 1617#define MARKERP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Marker)
19fa82b9 1618#define SAVE_VALUEP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Save_Value)
edfa9106 1619
ce5b453a
SM
1620#define INTFWDP(x) (XFWDTYPE (x) == Lisp_Fwd_Int)
1621#define BOOLFWDP(x) (XFWDTYPE (x) == Lisp_Fwd_Bool)
1622#define OBJFWDP(x) (XFWDTYPE (x) == Lisp_Fwd_Obj)
1623#define BUFFER_OBJFWDP(x) (XFWDTYPE (x) == Lisp_Fwd_Buffer_Obj)
1624#define KBOARD_OBJFWDP(x) (XFWDTYPE (x) == Lisp_Fwd_Kboard_Obj)
7c06ac2b 1625
303a5c93 1626/* True if object X is a pseudovector whose code is CODE. */
7c06ac2b
RS
1627#define PSEUDOVECTORP(x, code) \
1628 (VECTORLIKEP (x) \
1629 && (((XVECTOR (x)->size & (PSEUDOVECTOR_FLAG | (code)))) \
1630 == (PSEUDOVECTOR_FLAG | (code))))
1631
7c06ac2b
RS
1632/* Test for specific pseudovector types. */
1633#define WINDOW_CONFIGURATIONP(x) PSEUDOVECTORP (x, PVEC_WINDOW_CONFIGURATION)
7c06ac2b 1634#define PROCESSP(x) PSEUDOVECTORP (x, PVEC_PROCESS)
7c06ac2b 1635#define WINDOWP(x) PSEUDOVECTORP (x, PVEC_WINDOW)
49e49fb5 1636#define TERMINALP(x) PSEUDOVECTORP (x, PVEC_TERMINAL)
7c06ac2b 1637#define SUBRP(x) PSEUDOVECTORP (x, PVEC_SUBR)
7c06ac2b 1638#define COMPILEDP(x) PSEUDOVECTORP (x, PVEC_COMPILED)
99a3d506 1639#define BUFFERP(x) PSEUDOVECTORP (x, PVEC_BUFFER)
608ff985 1640#define CHAR_TABLE_P(x) PSEUDOVECTORP (x, PVEC_CHAR_TABLE)
1842abb2 1641#define SUB_CHAR_TABLE_P(x) PSEUDOVECTORP (x, PVEC_SUB_CHAR_TABLE)
608ff985 1642#define BOOL_VECTOR_P(x) PSEUDOVECTORP (x, PVEC_BOOL_VECTOR)
7c06ac2b 1643#define FRAMEP(x) PSEUDOVECTORP (x, PVEC_FRAME)
ea724a01 1644
6b61353c
KH
1645/* Test for image (image . spec) */
1646#define IMAGEP(x) (CONSP (x) && EQ (XCAR (x), Qimage))
1647
c8a39089
KS
1648/* Array types. */
1649
1650#define ARRAYP(x) \
1651 (VECTORP (x) || STRINGP (x) || CHAR_TABLE_P (x) || BOOL_VECTOR_P (x))
7c06ac2b 1652\f
874cc80e 1653#define CHECK_LIST(x) \
c8a39089
KS
1654 CHECK_TYPE (CONSP (x) || NILP (x), Qlistp, x)
1655
1656#define CHECK_LIST_CONS(x, y) \
1657 CHECK_TYPE (CONSP (x), Qlistp, y)
1658
1659#define CHECK_LIST_END(x, y) \
1660 CHECK_TYPE (NILP (x), Qlistp, y)
3cfe6dfd 1661
874cc80e 1662#define CHECK_STRING(x) \
c8a39089 1663 CHECK_TYPE (STRINGP (x), Qstringp, x)
3cfe6dfd 1664
57ddb5d0 1665#define CHECK_STRING_CAR(x) \
c8a39089 1666 CHECK_TYPE (STRINGP (XCAR (x)), Qstringp, XCAR (x))
57ddb5d0 1667
874cc80e 1668#define CHECK_CONS(x) \
c8a39089 1669 CHECK_TYPE (CONSP (x), Qconsp, x)
3cfe6dfd 1670
874cc80e 1671#define CHECK_SYMBOL(x) \
c8a39089 1672 CHECK_TYPE (SYMBOLP (x), Qsymbolp, x)
3cfe6dfd 1673
874cc80e 1674#define CHECK_CHAR_TABLE(x) \
c8a39089 1675 CHECK_TYPE (CHAR_TABLE_P (x), Qchar_table_p, x)
608ff985 1676
874cc80e 1677#define CHECK_VECTOR(x) \
c8a39089 1678 CHECK_TYPE (VECTORP (x), Qvectorp, x)
3cfe6dfd 1679
c8a39089
KS
1680#define CHECK_VECTOR_OR_STRING(x) \
1681 CHECK_TYPE (VECTORP (x) || STRINGP (x), Qarrayp, x)
1682
78edd3b7 1683#define CHECK_ARRAY(x, Qxxxp) \
c8a39089
KS
1684 CHECK_TYPE (ARRAYP (x), Qxxxp, x)
1685
1686#define CHECK_VECTOR_OR_CHAR_TABLE(x) \
1687 CHECK_TYPE (VECTORP (x) || CHAR_TABLE_P (x), Qvector_or_char_table_p, x)
7f73dc9d 1688
874cc80e 1689#define CHECK_BUFFER(x) \
c8a39089 1690 CHECK_TYPE (BUFFERP (x), Qbufferp, x)
3cfe6dfd 1691
874cc80e 1692#define CHECK_WINDOW(x) \
c8a39089
KS
1693 CHECK_TYPE (WINDOWP (x), Qwindowp, x)
1694
1695#define CHECK_WINDOW_CONFIGURATION(x) \
1696 CHECK_TYPE (WINDOW_CONFIGURATIONP (x), Qwindow_configuration_p, x)
3cfe6dfd 1697
03273ec5 1698/* This macro rejects windows on the interior of the window tree as
e98227af 1699 "dead", which is what we want; this is an argument-checking macro, and
03273ec5
JB
1700 the user should never get access to interior windows.
1701
e0f24100 1702 A window of any sort, leaf or interior, is dead if the buffer,
03273ec5
JB
1703 vchild, and hchild members are all nil. */
1704
c8a39089
KS
1705#define CHECK_LIVE_WINDOW(x) \
1706 CHECK_TYPE (WINDOWP (x) && !NILP (XWINDOW (x)->buffer), Qwindow_live_p, x)
03273ec5 1707
874cc80e 1708#define CHECK_PROCESS(x) \
c8a39089
KS
1709 CHECK_TYPE (PROCESSP (x), Qprocessp, x)
1710
1711#define CHECK_SUBR(x) \
1712 CHECK_TYPE (SUBRP (x), Qsubrp, x)
3cfe6dfd 1713
874cc80e 1714#define CHECK_NUMBER(x) \
c8a39089 1715 CHECK_TYPE (INTEGERP (x), Qintegerp, x)
3cfe6dfd 1716
874cc80e 1717#define CHECK_NATNUM(x) \
c8a39089 1718 CHECK_TYPE (NATNUMP (x), Qwholenump, x)
3cfe6dfd 1719
874cc80e 1720#define CHECK_MARKER(x) \
c8a39089 1721 CHECK_TYPE (MARKERP (x), Qmarkerp, x)
3cfe6dfd 1722
874cc80e 1723#define CHECK_NUMBER_COERCE_MARKER(x) \
221f4ef3 1724 do { if (MARKERP ((x))) XSETFASTINT (x, marker_position (x)); \
c8a39089 1725 else CHECK_TYPE (INTEGERP (x), Qinteger_or_marker_p, x); } while (0)
3cfe6dfd 1726
3cfe6dfd
JB
1727#define XFLOATINT(n) extract_float((n))
1728
78edd3b7 1729#define CHECK_FLOAT(x) \
c8a39089 1730 CHECK_TYPE (FLOATP (x), Qfloatp, x)
3cfe6dfd 1731
78edd3b7 1732#define CHECK_NUMBER_OR_FLOAT(x) \
c8a39089 1733 CHECK_TYPE (FLOATP (x) || INTEGERP (x), Qnumberp, x)
3cfe6dfd 1734
874cc80e 1735#define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER(x) \
78edd3b7 1736 do { if (MARKERP (x)) XSETFASTINT (x, marker_position (x)); \
c8a39089 1737 else CHECK_TYPE (INTEGERP (x) || FLOATP (x), Qnumber_or_marker_p, x); } while (0)
3cfe6dfd 1738
874cc80e 1739#define CHECK_OVERLAY(x) \
c8a39089 1740 CHECK_TYPE (OVERLAYP (x), Qoverlayp, x)
20280af7 1741
f3fbd155
KR
1742/* Since we can't assign directly to the CAR or CDR fields of a cons
1743 cell, use these when checking that those fields contain numbers. */
874cc80e 1744#define CHECK_NUMBER_CAR(x) \
f3fbd155
KR
1745 do { \
1746 Lisp_Object tmp = XCAR (x); \
874cc80e 1747 CHECK_NUMBER (tmp); \
f3fbd155
KR
1748 XSETCAR ((x), tmp); \
1749 } while (0)
1750
874cc80e 1751#define CHECK_NUMBER_CDR(x) \
f3fbd155
KR
1752 do { \
1753 Lisp_Object tmp = XCDR (x); \
874cc80e 1754 CHECK_NUMBER (tmp); \
f3fbd155
KR
1755 XSETCDR ((x), tmp); \
1756 } while (0)
1757
8f924df7
KH
1758#define CHECK_NATNUM_CAR(x) \
1759 do { \
1760 Lisp_Object tmp = XCAR (x); \
1761 CHECK_NATNUM (tmp); \
1762 XSETCAR ((x), tmp); \
1763 } while (0)
1764
1765#define CHECK_NATNUM_CDR(x) \
1766 do { \
1767 Lisp_Object tmp = XCDR (x); \
1768 CHECK_NATNUM (tmp); \
1769 XSETCDR ((x), tmp); \
1770 } while (0)
1771
3cfe6dfd 1772/* Cast pointers to this type to compare them. Some machines want int. */
68c45bf0 1773#define PNTR_COMPARISON_TYPE EMACS_UINT
3cfe6dfd
JB
1774\f
1775/* Define a built-in function for calling from Lisp.
1776 `lname' should be the name to give the function in Lisp,
1777 as a null-terminated C string.
1778 `fnname' should be the name of the function in C.
1779 By convention, it starts with F.
1780 `sname' should be the name for the C constant structure
1781 that records information on this function for internal use.
1782 By convention, it should be the same as `fnname' but with S instead of F.
1783 It's too bad that C macros can't compute this from `fnname'.
1784 `minargs' should be a number, the minimum number of arguments allowed.
1785 `maxargs' should be a number, the maximum number of arguments allowed,
1786 or else MANY or UNEVALLED.
1787 MANY means pass a vector of evaluated arguments,
1788 in the form of an integer number-of-arguments
1789 followed by the address of a vector of Lisp_Objects
1790 which contains the argument values.
1791 UNEVALLED means pass the list of unevaluated arguments
4bca9161
MC
1792 `intspec' says how interactive arguments are to be fetched.
1793 If the string starts with a `(', `intspec' is evaluated and the resulting
1794 list is the list of arguments.
1795 If it's a string that doesn't start with `(', the value should follow
1796 the one of the doc string for `interactive'.
3cfe6dfd 1797 A null string means call interactively with no arguments.
eab9d423 1798 `doc' is documentation for the user. */
3cfe6dfd 1799
c451d7b1 1800/* This version of DEFUN declares a function prototype with the right
99a3d506 1801 arguments, so we can catch errors with maxargs at compile-time. */
4bca9161 1802#define DEFUN(lname, fnname, sname, minargs, maxargs, intspec, doc) \
7c06ac2b 1803 Lisp_Object fnname DEFUN_ARGS_ ## maxargs ; \
6b61353c 1804 DECL_ALIGN (struct Lisp_Subr, sname) = \
7c06ac2b 1805 { PVEC_SUBR | (sizeof (struct Lisp_Subr) / sizeof (EMACS_INT)), \
d5273788
SM
1806 { .a ## maxargs = fnname }, \
1807 minargs, maxargs, lname, intspec, 0}; \
c451d7b1
RS
1808 Lisp_Object fnname
1809
1810/* Note that the weird token-substitution semantics of ANSI C makes
99a3d506 1811 this work for MANY and UNEVALLED. */
c451d7b1
RS
1812#define DEFUN_ARGS_MANY (int, Lisp_Object *)
1813#define DEFUN_ARGS_UNEVALLED (Lisp_Object)
1814#define DEFUN_ARGS_0 (void)
1815#define DEFUN_ARGS_1 (Lisp_Object)
1816#define DEFUN_ARGS_2 (Lisp_Object, Lisp_Object)
1817#define DEFUN_ARGS_3 (Lisp_Object, Lisp_Object, Lisp_Object)
1818#define DEFUN_ARGS_4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object)
1819#define DEFUN_ARGS_5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1820 Lisp_Object)
1821#define DEFUN_ARGS_6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1822 Lisp_Object, Lisp_Object)
1823#define DEFUN_ARGS_7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1824 Lisp_Object, Lisp_Object, Lisp_Object)
5593f7e3
KH
1825#define DEFUN_ARGS_8 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \
1826 Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object)
276680c4 1827
78edd3b7 1828/* Non-zero if OBJ is a Lisp function. */
276680c4
GM
1829#define FUNCTIONP(OBJ) \
1830 ((CONSP (OBJ) && EQ (XCAR (OBJ), Qlambda)) \
1831 || (SYMBOLP (OBJ) && !NILP (Ffboundp (OBJ))) \
1832 || COMPILEDP (OBJ) \
1833 || SUBRP (OBJ))
e2c0561e 1834
3cfe6dfd 1835/* defsubr (Sname);
d19b9aa8 1836 is how we define the symbol for function `name' at start-up time. */
383e0970 1837extern void defsubr (struct Lisp_Subr *);
3cfe6dfd
JB
1838
1839#define MANY -2
1840#define UNEVALLED -1
1841
ce5b453a
SM
1842extern void defvar_lisp (struct Lisp_Objfwd *, const char *, Lisp_Object *);
1843extern void defvar_lisp_nopro (struct Lisp_Objfwd *, const char *, Lisp_Object *);
1844extern void defvar_bool (struct Lisp_Boolfwd *, const char *, int *);
1845extern void defvar_int (struct Lisp_Intfwd *, const char *, EMACS_INT *);
1846extern void defvar_kboard (struct Lisp_Kboard_Objfwd *, const char *, int);
3cfe6dfd
JB
1847
1848/* Macros we use to define forwarded Lisp variables.
29208e82 1849 These are used in the syms_of_FILENAME functions.
51b59d79 1850
29208e82
TT
1851 An ordinary (not in buffer_defaults, per-buffer, or per-keyboard)
1852 lisp variable is actually a field in `struct emacs_globals'. The
1853 field's name begins with "f_", which is a convention enforced by
1854 these macros. Each such global has a corresponding #define in
1855 globals.h; the plain name should be used in the code.
1856
1857 E.g., the global "cons_cells_consed" is declared as "int
1858 f_cons_cells_consed" in globals.h, but there is a define:
1859
1860 #define cons_cells_consed globals.f_cons_cells_consed
1861
1862 All C code uses the `cons_cells_consed' name. This is all done
1863 this way to support indirection for multi-threaded Emacs. */
3cfe6dfd 1864
ce5b453a
SM
1865#define DEFVAR_LISP(lname, vname, doc) \
1866 do { \
1867 static struct Lisp_Objfwd o_fwd; \
29208e82 1868 defvar_lisp (&o_fwd, lname, &globals.f_ ## vname); \
ce5b453a
SM
1869 } while (0)
1870#define DEFVAR_LISP_NOPRO(lname, vname, doc) \
1871 do { \
1872 static struct Lisp_Objfwd o_fwd; \
29208e82 1873 defvar_lisp_nopro (&o_fwd, lname, &globals.f_ ## vname); \
ce5b453a
SM
1874 } while (0)
1875#define DEFVAR_BOOL(lname, vname, doc) \
1876 do { \
1877 static struct Lisp_Boolfwd b_fwd; \
29208e82 1878 defvar_bool (&b_fwd, lname, &globals.f_ ## vname); \
ce5b453a
SM
1879 } while (0)
1880#define DEFVAR_INT(lname, vname, doc) \
1881 do { \
1882 static struct Lisp_Intfwd i_fwd; \
29208e82 1883 defvar_int (&i_fwd, lname, &globals.f_ ## vname); \
ce5b453a 1884 } while (0)
92d2947b 1885
422745d0
TT
1886#define DEFVAR_BUFFER_DEFAULTS(lname, vname, doc) \
1887 do { \
1888 static struct Lisp_Objfwd o_fwd; \
1889 defvar_lisp_nopro (&o_fwd, lname, &buffer_defaults.vname); \
1890 } while (0)
1891
ce5b453a
SM
1892#define DEFVAR_KBOARD(lname, vname, doc) \
1893 do { \
1894 static struct Lisp_Kboard_Objfwd ko_fwd; \
1895 defvar_kboard (&ko_fwd, \
1896 lname, \
1897 (int)((char *)(&current_kboard->vname) \
1898 - (char *)current_kboard)); \
1899 } while (0)
df7cd53b 1900
df7cd53b 1901
3cfe6dfd 1902\f
78ca380c
JB
1903/* Structure for recording Lisp call stack for backtrace purposes. */
1904
1905/* The special binding stack holds the outer values of variables while
1906 they are bound by a function application or a let form, stores the
1907 code to be executed for Lisp unwind-protect forms, and stores the C
1908 functions to be called for record_unwind_protect.
1909
1910 If func is non-zero, undoing this binding applies func to old_value;
1911 This implements record_unwind_protect.
5fd6e274
RS
1912
1913 Otherwise, the element is a variable binding.
e2c0561e 1914
5fd6e274 1915 If the symbol field is a symbol, it is an ordinary variable binding.
e2c0561e 1916
78edd3b7
JB
1917 Otherwise, it should be a structure (SYMBOL WHERE . CURRENT-BUFFER),
1918 which means having bound a local value while CURRENT-BUFFER was active.
1919 If WHERE is nil this means we saw the default value when binding SYMBOL.
1920 WHERE being a buffer or frame means we saw a buffer-local or frame-local
1921 value. Other values of WHERE mean an internal error. */
5fd6e274 1922
383e0970 1923typedef Lisp_Object (*specbinding_func) (Lisp_Object);
07c9ebd6 1924
3cfe6dfd
JB
1925struct specbinding
1926 {
a7af5886
SM
1927 Lisp_Object symbol, old_value;
1928 specbinding_func func;
3cfe6dfd
JB
1929 Lisp_Object unused; /* Dividing by 16 is faster than by 12 */
1930 };
1931
1932extern struct specbinding *specpdl;
a7af5886 1933extern struct specbinding *specpdl_ptr;
5816888b 1934extern EMACS_INT specpdl_size;
3cfe6dfd 1935
faf8b5bc 1936#define SPECPDL_INDEX() ((int) (specpdl_ptr - specpdl))
acb8dc44 1937
78ca380c 1938/* Everything needed to describe an active condition case. */
3cfe6dfd
JB
1939struct handler
1940 {
78ca380c 1941 /* The handler clauses and variable from the condition-case form. */
992dd91a
RS
1942 /* For a handler set up in Lisp code, this is always a list.
1943 For an internal handler set up by internal_condition_case*,
1944 this can instead be the symbol t or `error'.
1945 t: handle all conditions.
1946 error: handle all conditions, and errors can run the debugger
1947 or display a backtrace. */
3cfe6dfd
JB
1948 Lisp_Object handler;
1949 Lisp_Object var;
22bbbd42
RS
1950 /* Fsignal stores here the condition-case clause that applies,
1951 and Fcondition_case thus knows which clause to run. */
1952 Lisp_Object chosen_clause;
78ca380c
JB
1953
1954 /* Used to effect the longjump out to the handler. */
3cfe6dfd 1955 struct catchtag *tag;
78ca380c
JB
1956
1957 /* The next enclosing handler. */
3cfe6dfd
JB
1958 struct handler *next;
1959 };
1960
1961extern struct handler *handlerlist;
1962
d7306fe6
DN
1963/* This structure helps implement the `catch' and `throw' control
1964 structure. A struct catchtag contains all the information needed
1965 to restore the state of the interpreter after a non-local jump.
1966
1967 Handlers for error conditions (represented by `struct handler'
1968 structures) just point to a catch tag to do the cleanup required
1969 for their jumps.
1970
1971 catchtag structures are chained together in the C calling stack;
1972 the `next' member points to the next outer catchtag.
1973
1974 A call like (throw TAG VAL) searches for a catchtag whose `tag'
1975 member is TAG, and then unbinds to it. The `val' member is used to
1976 hold VAL while the stack is unwound; `val' is returned as the value
1977 of the catch form.
1978
1979 All the other members are concerned with restoring the interpreter
1980 state. */
1981
1982struct catchtag
1983{
1984 Lisp_Object tag;
1985 Lisp_Object val;
1986 struct catchtag *next;
1987 struct gcpro *gcpro;
1988 jmp_buf jmp;
1989 struct backtrace *backlist;
1990 struct handler *handlerlist;
1991 int lisp_eval_depth;
1992 int pdlcount;
1993 int poll_suppress_count;
1994 int interrupt_input_blocked;
1995 struct byte_stack *byte_stack;
1996};
1997
3cfe6dfd
JB
1998extern struct catchtag *catchlist;
1999extern struct backtrace *backtrace_list;
2000
22bbbd42
RS
2001extern Lisp_Object memory_signal_data;
2002
3cfe6dfd
JB
2003/* An address near the bottom of the stack.
2004 Tells GC how to save a copy of the stack. */
2005extern char *stack_bottom;
2006
4742f524
RS
2007/* Check quit-flag and quit if it is non-nil.
2008 Typing C-g does not directly cause a quit; it only sets Vquit_flag.
2009 So the program needs to do QUIT at times when it is safe to quit.
2010 Every loop that might run for a long time or might not exit
2011 ought to do QUIT at least once, at a safe place.
2012 Unless that is impossible, of course.
2013 But it is very desirable to avoid creating loops where QUIT is impossible.
2014
2015 Exception: if you set immediate_quit to nonzero,
2016 then the handler that responds to the C-g does the quit itself.
2017 This is a good thing to do around a loop that has no side effects
2018 and (in particular) cannot call arbitrary Lisp code. */
3cfe6dfd 2019
6b61353c 2020#ifdef SYNC_INPUT
383e0970 2021extern void process_pending_signals (void);
26f1ab24 2022extern int pending_signals;
c0335e02
SM
2023#define ELSE_PENDING_SIGNALS \
2024 else if (pending_signals) \
2025 process_pending_signals ();
6b61353c 2026#else /* not SYNC_INPUT */
c0335e02
SM
2027#define ELSE_PENDING_SIGNALS
2028#endif /* not SYNC_INPUT */
6b61353c 2029
a69a6e61
GM
2030#define QUIT \
2031 do { \
2032 if (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) \
2033 { \
08fdede6 2034 Lisp_Object flag = Vquit_flag; \
a69a6e61 2035 Vquit_flag = Qnil; \
08fdede6 2036 if (EQ (Vthrow_on_input, flag)) \
85c9ff2c 2037 Fthrow (Vthrow_on_input, Qt); \
a69a6e61
GM
2038 Fsignal (Qquit, Qnil); \
2039 } \
c0335e02 2040 ELSE_PENDING_SIGNALS \
a69a6e61 2041 } while (0)
3cfe6dfd 2042
6b61353c 2043
3cfe6dfd
JB
2044/* Nonzero if ought to quit now. */
2045
efb859b4 2046#define QUITP (!NILP (Vquit_flag) && NILP (Vinhibit_quit))
3cfe6dfd 2047\f
8ac90470 2048/* Variables used locally in the following case handling macros. */
2e34157c
RS
2049extern int case_temp1;
2050extern Lisp_Object case_temp2;
8ac90470 2051
e98227af 2052/* Current buffer's map from characters to lower-case characters. */
3cfe6dfd 2053
8ac90470 2054#define DOWNCASE_TABLE current_buffer->downcase_table
3cfe6dfd 2055
e98227af 2056/* Current buffer's map from characters to upper-case characters. */
3cfe6dfd 2057
8ac90470 2058#define UPCASE_TABLE current_buffer->upcase_table
3cfe6dfd 2059
e98227af 2060/* Downcase a character, or make no change if that cannot be done. */
3cfe6dfd 2061
8ac90470
KH
2062#define DOWNCASE(CH) \
2063 ((case_temp1 = (CH), \
2064 case_temp2 = CHAR_TABLE_REF (DOWNCASE_TABLE, case_temp1), \
2065 NATNUMP (case_temp2)) \
2066 ? XFASTINT (case_temp2) : case_temp1)
3cfe6dfd 2067
e98227af 2068/* 1 if CH is upper case. */
3cfe6dfd 2069
476d47ce 2070#define UPPERCASEP(CH) (DOWNCASE (CH) != (CH))
3cfe6dfd 2071
e98227af 2072/* 1 if CH is neither upper nor lower case. */
3cfe6dfd 2073
8ac90470 2074#define NOCASEP(CH) (UPCASE1 (CH) == (CH))
3cfe6dfd 2075
e98227af 2076/* 1 if CH is lower case. */
3cfe6dfd 2077
e98227af 2078#define LOWERCASEP(CH) (!UPPERCASEP (CH) && !NOCASEP(CH))
3cfe6dfd 2079
e98227af 2080/* Upcase a character, or make no change if that cannot be done. */
3cfe6dfd 2081
e98227af
KH
2082#define UPCASE(CH) (!UPPERCASEP (CH) ? UPCASE1 (CH) : (CH))
2083
2084/* Upcase a character known to be not upper case. */
2085
8ac90470
KH
2086#define UPCASE1(CH) \
2087 ((case_temp1 = (CH), \
2088 case_temp2 = CHAR_TABLE_REF (UPCASE_TABLE, case_temp1), \
2089 NATNUMP (case_temp2)) \
2090 ? XFASTINT (case_temp2) : case_temp1)
3cfe6dfd 2091
b80785d3
KH
2092extern Lisp_Object Vascii_downcase_table, Vascii_upcase_table;
2093extern Lisp_Object Vascii_canon_table, Vascii_eqv_table;
3cfe6dfd 2094\f
99a3d506 2095/* Number of bytes of structure consed since last GC. */
3cfe6dfd
JB
2096
2097extern int consing_since_gc;
2098
9bd32d8c 2099extern EMACS_INT gc_relative_threshold;
3cfe6dfd 2100
eb3fe174
RS
2101extern EMACS_INT memory_full_cons_threshold;
2102
99a3d506 2103/* Structure for recording stack slots that need marking. */
3cfe6dfd 2104
78edd3b7
JB
2105/* This is a chain of structures, each of which points at a Lisp_Object
2106 variable whose value should be marked in garbage collection.
2107 Normally every link of the chain is an automatic variable of a function,
2108 and its `val' points to some argument or local variable of the function.
2109 On exit to the function, the chain is set back to the value it had on entry.
2110 This way, no link remains in the chain when the stack frame containing the
2111 link disappears.
3cfe6dfd 2112
78edd3b7
JB
2113 Every function that can call Feval must protect in this fashion all
2114 Lisp_Object variables whose contents will be used again. */
3cfe6dfd
JB
2115
2116extern struct gcpro *gcprolist;
2117
2118struct gcpro
834168ef
GM
2119{
2120 struct gcpro *next;
e2c0561e 2121
834168ef
GM
2122 /* Address of first protected variable. */
2123 volatile Lisp_Object *var;
e2c0561e 2124
834168ef
GM
2125 /* Number of consecutive protected variables. */
2126 int nvars;
e2c0561e 2127
4742f524 2128#ifdef DEBUG_GCPRO
834168ef 2129 int level;
4742f524 2130#endif
834168ef 2131};
3cfe6dfd 2132
1216f5e4
GM
2133/* Values of GC_MARK_STACK during compilation:
2134
2135 0 Use GCPRO as before
2136 1 Do the real thing, make GCPROs and UNGCPRO no-ops.
2137 2 Mark the stack, and check that everything GCPRO'd is
2138 marked.
2139 3 Mark using GCPRO's, mark stack last, and count how many
2140 dead objects are kept alive. */
2141
2142
2143#define GC_USE_GCPROS_AS_BEFORE 0
2144#define GC_MAKE_GCPROS_NOOPS 1
2145#define GC_MARK_STACK_CHECK_GCPROS 2
2146#define GC_USE_GCPROS_CHECK_ZOMBIES 3
2147
2148#ifndef GC_MARK_STACK
2149#define GC_MARK_STACK GC_USE_GCPROS_AS_BEFORE
2150#endif
2151
2152#if GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS
2153
9f0443f9 2154/* Do something silly with gcproN vars just so gcc shuts up. */
656c33dc 2155/* You get warnings from MIPSPro... */
9f0443f9
SM
2156
2157#define GCPRO1(varname) ((void) gcpro1)
e2c0561e 2158#define GCPRO2(varname1, varname2)(((void) gcpro2, (void) gcpro1))
9f0443f9
SM
2159#define GCPRO3(varname1, varname2, varname3) \
2160 (((void) gcpro3, (void) gcpro2, (void) gcpro1))
2161#define GCPRO4(varname1, varname2, varname3, varname4) \
2162 (((void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
2163#define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
2164 (((void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
b7301bff
KS
2165#define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
2166 (((void) gcpro6, (void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1))
1216f5e4
GM
2167#define UNGCPRO ((void) 0)
2168
2169#else /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */
2170
4742f524
RS
2171#ifndef DEBUG_GCPRO
2172
3cfe6dfd
JB
2173#define GCPRO1(varname) \
2174 {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \
2175 gcprolist = &gcpro1; }
2176
2177#define GCPRO2(varname1, varname2) \
2178 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2179 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2180 gcprolist = &gcpro2; }
2181
2182#define GCPRO3(varname1, varname2, varname3) \
2183 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2184 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2185 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2186 gcprolist = &gcpro3; }
2187
2188#define GCPRO4(varname1, varname2, varname3, varname4) \
2189 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2190 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2191 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2192 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2193 gcprolist = &gcpro4; }
2194
c47b8d02
RS
2195#define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
2196 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2197 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2198 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2199 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2200 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2201 gcprolist = &gcpro5; }
2202
b7301bff
KS
2203#define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
2204 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2205 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2206 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2207 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2208 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2209 gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \
2210 gcprolist = &gcpro6; }
2211
4742f524 2212#define UNGCPRO (gcprolist = gcpro1.next)
3cfe6dfd 2213
4742f524 2214#else
e98227af 2215
4742f524
RS
2216extern int gcpro_level;
2217
2218#define GCPRO1(varname) \
2219 {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \
2220 gcpro1.level = gcpro_level++; \
2221 gcprolist = &gcpro1; }
2222
2223#define GCPRO2(varname1, varname2) \
2224 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2225 gcpro1.level = gcpro_level; \
2226 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2227 gcpro2.level = gcpro_level++; \
2228 gcprolist = &gcpro2; }
2229
2230#define GCPRO3(varname1, varname2, varname3) \
2231 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2232 gcpro1.level = gcpro_level; \
2233 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2234 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2235 gcpro3.level = gcpro_level++; \
2236 gcprolist = &gcpro3; }
2237
2238#define GCPRO4(varname1, varname2, varname3, varname4) \
2239 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2240 gcpro1.level = gcpro_level; \
2241 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2242 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2243 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2244 gcpro4.level = gcpro_level++; \
2245 gcprolist = &gcpro4; }
2246
2247#define GCPRO5(varname1, varname2, varname3, varname4, varname5) \
2248 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2249 gcpro1.level = gcpro_level; \
2250 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2251 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2252 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2253 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2254 gcpro5.level = gcpro_level++; \
2255 gcprolist = &gcpro5; }
2256
b7301bff
KS
2257#define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \
2258 {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \
2259 gcpro1.level = gcpro_level; \
2260 gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \
2261 gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \
2262 gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \
2263 gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \
2264 gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \
2265 gcpro6.level = gcpro_level++; \
2266 gcprolist = &gcpro6; }
2267
4742f524
RS
2268#define UNGCPRO \
2269 ((--gcpro_level != gcpro1.level) \
2270 ? (abort (), 0) \
2271 : ((gcprolist = gcpro1.next), 0))
2272
2273#endif /* DEBUG_GCPRO */
1216f5e4
GM
2274#endif /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */
2275
3cfe6dfd 2276
5db82c9d 2277/* Evaluate expr, UNGCPRO, and then return the value of expr. */
c47b8d02 2278#define RETURN_UNGCPRO(expr) \
0868e74e 2279do \
c47b8d02
RS
2280 { \
2281 Lisp_Object ret_ungc_val; \
2282 ret_ungc_val = (expr); \
2283 UNGCPRO; \
2284 return ret_ungc_val; \
2285 } \
0868e74e 2286while (0)
4742f524
RS
2287
2288/* Call staticpro (&var) to protect static variable `var'. */
2289
383e0970 2290void staticpro (Lisp_Object *);
3cfe6dfd 2291\f
2f69f2ec
RS
2292/* Declare a Lisp-callable function. The MAXARGS parameter has the same
2293 meaning as in the DEFUN macro, and is used to construct a prototype. */
2f69f2ec
RS
2294/* We can use the same trick as in the DEFUN macro to generate the
2295 appropriate prototype. */
2296#define EXFUN(fnname, maxargs) \
2297 extern Lisp_Object fnname DEFUN_ARGS_ ## maxargs
2f69f2ec 2298
526a2be7
AS
2299/* Forward declarations for prototypes. */
2300struct window;
2301struct frame;
2f69f2ec 2302
3cfe6dfd
JB
2303/* Defined in data.c */
2304extern Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
2305extern Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
2306extern Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
2307extern Lisp_Object Qvoid_variable, Qvoid_function;
2308extern Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
2309extern Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
6b61353c 2310extern Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
3cfe6dfd 2311extern Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
6b61353c 2312extern Lisp_Object Qtext_read_only;
e6cba650 2313extern Lisp_Object Qinteractive_form;
99f3388e 2314extern Lisp_Object Qcircular_list;
6b61353c 2315extern Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
3cfe6dfd 2316extern Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
6b61353c 2317extern Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
cde20f41 2318extern Lisp_Object Qbuffer_or_string_p;
6b61353c
KH
2319extern Lisp_Object Qboundp, Qfboundp;
2320extern Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
2321
3cfe6dfd
JB
2322extern Lisp_Object Qcdr;
2323
6b61353c
KH
2324extern Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
2325extern Lisp_Object Qoverflow_error, Qunderflow_error;
3cfe6dfd 2326
6b61353c
KH
2327extern Lisp_Object Qfloatp;
2328extern Lisp_Object Qnumberp, Qnumber_or_marker_p;
2329
2330extern Lisp_Object Qinteger;
3cfe6dfd 2331
a35ebb81
CY
2332extern Lisp_Object Qfont_spec, Qfont_entity, Qfont_object;
2333
383e0970 2334extern void circular_list_error (Lisp_Object) NO_RETURN;
6b61353c 2335EXFUN (Finteractive_form, 1);
9370c1d8 2336EXFUN (Fbyteorder, 0);
6b61353c
KH
2337
2338/* Defined in frame.c */
2339extern Lisp_Object Qframep;
7436b0a9 2340
2f7c71a1 2341/* Defined in data.c */
2f69f2ec
RS
2342EXFUN (Fcar, 1);
2343EXFUN (Fcar_safe, 1);
2344EXFUN (Fcdr, 1);
2345EXFUN (Fcdr_safe, 1);
2346EXFUN (Fsetcar, 2);
2347EXFUN (Fsetcdr, 2);
2348EXFUN (Fboundp, 1);
2349EXFUN (Ffboundp, 1);
2f69f2ec 2350EXFUN (Fsymbol_function, 1);
2f69f2ec 2351EXFUN (Fsymbol_name, 1);
383e0970 2352extern Lisp_Object indirect_function (Lisp_Object);
a7f96a35 2353EXFUN (Findirect_function, 2);
2f69f2ec 2354EXFUN (Ffset, 2);
2f69f2ec 2355EXFUN (Fsymbol_value, 1);
383e0970 2356extern Lisp_Object find_symbol_value (Lisp_Object);
2f69f2ec
RS
2357EXFUN (Fset, 2);
2358EXFUN (Fdefault_value, 1);
2359EXFUN (Fset_default, 2);
2360EXFUN (Fdefault_boundp, 1);
2361EXFUN (Fmake_local_variable, 1);
a154f406 2362EXFUN (Flocal_variable_p, 2);
2f69f2ec
RS
2363
2364EXFUN (Faref, 2);
2365EXFUN (Faset, 3);
2366
2367EXFUN (Fstring_to_number, 2);
2368EXFUN (Fnumber_to_string, 1);
2f69f2ec
RS
2369EXFUN (Fgtr, 2);
2370EXFUN (Flss, 2);
2371EXFUN (Fgeq, 2);
2372EXFUN (Fleq, 2);
2f69f2ec
RS
2373EXFUN (Fzerop, 1);
2374EXFUN (Fplus, MANY);
2375EXFUN (Fminus, MANY);
2376EXFUN (Ftimes, MANY);
2377EXFUN (Fquo, MANY);
2378EXFUN (Frem, 2);
2379EXFUN (Fmax, MANY);
2380EXFUN (Fmin, MANY);
2f69f2ec
RS
2381
2382EXFUN (Fadd1, 1);
2383EXFUN (Fsub1, 1);
d7935eb6 2384EXFUN (Fmake_variable_buffer_local, 1);
2f69f2ec 2385
ad97b375 2386extern struct Lisp_Symbol *indirect_variable (struct Lisp_Symbol *);
383e0970
J
2387extern Lisp_Object long_to_cons (unsigned long);
2388extern unsigned long cons_to_long (Lisp_Object);
2389extern void args_out_of_range (Lisp_Object, Lisp_Object) NO_RETURN;
2390extern void args_out_of_range_3 (Lisp_Object, Lisp_Object,
2391 Lisp_Object) NO_RETURN;
2392extern Lisp_Object wrong_type_argument (Lisp_Object, Lisp_Object) NO_RETURN;
ce5b453a 2393extern Lisp_Object do_symval_forwarding (union Lisp_Fwd *);
94b612ad 2394extern void set_internal (Lisp_Object, Lisp_Object, Lisp_Object, int);
383e0970
J
2395extern void syms_of_data (void);
2396extern void init_data (void);
2397extern void swap_in_global_binding (struct Lisp_Symbol *);
3cfe6dfd 2398
a37e10f9 2399/* Defined in cmds.c */
2f69f2ec
RS
2400EXFUN (Fend_of_line, 1);
2401EXFUN (Fforward_char, 1);
2402EXFUN (Fforward_line, 1);
383e0970
J
2403extern void syms_of_cmds (void);
2404extern void keys_of_cmds (void);
a37e10f9 2405
6b768554 2406/* Defined in coding.c */
2f7c71a1 2407extern Lisp_Object Qcharset;
2f69f2ec 2408EXFUN (Fcoding_system_p, 1);
a6392022
KH
2409EXFUN (Fcoding_system_base, 1);
2410EXFUN (Fcoding_system_eol_type, 1);
2411EXFUN (Fcheck_coding_system, 1);
34ba1f2e 2412EXFUN (Fread_coding_system, 2);
2f69f2ec 2413EXFUN (Fread_non_nil_coding_system, 1);
a154f406 2414EXFUN (Ffind_operation_coding_system, MANY);
1842abb2 2415EXFUN (Fdecode_coding_string, 4);
383e0970
J
2416extern Lisp_Object detect_coding_system (const unsigned char *, EMACS_INT,
2417 EMACS_INT, int, int, Lisp_Object);
2418extern void init_coding (void);
2419extern void init_coding_once (void);
2420extern void syms_of_coding (void);
1842abb2
KH
2421
2422/* Defined in character.c */
e3432aa4 2423EXFUN (Funibyte_char_to_multibyte, 1);
ec5d8db7 2424EXFUN (Fchar_width, 1);
4516715a 2425EXFUN (Fstring, MANY);
383e0970
J
2426extern EMACS_INT chars_in_text (const unsigned char *, EMACS_INT);
2427extern EMACS_INT multibyte_chars_in_text (const unsigned char *, EMACS_INT);
2428extern int multibyte_char_to_unibyte (int, Lisp_Object);
2429extern int multibyte_char_to_unibyte_safe (int);
2f7c71a1
AS
2430extern void init_character_once (void);
2431extern void syms_of_character (void);
2432
2433/* Defined in charset.c */
383e0970
J
2434extern void init_charset (void);
2435extern void init_charset_once (void);
2436extern void syms_of_charset (void);
8f924df7
KH
2437/* Structure forward declarations. */
2438struct charset;
5e741a41 2439
1842abb2 2440/* Defined in composite.c */
383e0970 2441extern void syms_of_composite (void);
5e741a41 2442
a37e10f9 2443/* Defined in syntax.c */
2f69f2ec
RS
2444EXFUN (Fforward_word, 1);
2445EXFUN (Fskip_chars_forward, 2);
2446EXFUN (Fskip_chars_backward, 2);
526a2be7 2447EXFUN (Fsyntax_table_p, 1);
383e0970
J
2448extern void init_syntax_once (void);
2449extern void syms_of_syntax (void);
a37e10f9 2450
3cfe6dfd 2451/* Defined in fns.c */
99f3388e 2452extern Lisp_Object QCrehash_size, QCrehash_threshold;
383e0970
J
2453extern int next_almost_prime (int);
2454extern Lisp_Object larger_vector (Lisp_Object, int, Lisp_Object);
2455extern void sweep_weak_hash_tables (void);
e6cba650 2456extern Lisp_Object Qcursor_in_echo_area;
3cfe6dfd 2457extern Lisp_Object Qstring_lessp;
99f3388e 2458extern Lisp_Object QCsize, QCtest, QCweakness, Qequal, Qeq, Qeql;
383e0970
J
2459unsigned sxhash (Lisp_Object, int);
2460Lisp_Object make_hash_table (Lisp_Object, Lisp_Object, Lisp_Object,
2461 Lisp_Object, Lisp_Object, Lisp_Object,
2462 Lisp_Object);
383e0970
J
2463int hash_lookup (struct Lisp_Hash_Table *, Lisp_Object, unsigned *);
2464int hash_put (struct Lisp_Hash_Table *, Lisp_Object, Lisp_Object,
2465 unsigned);
383e0970
J
2466void init_weak_hash_tables (void);
2467extern void init_fns (void);
5010d3b8 2468EXFUN (Fmake_hash_table, MANY);
5010d3b8
GM
2469EXFUN (Fgethash, 3);
2470EXFUN (Fputhash, 3);
2471EXFUN (Fremhash, 2);
5010d3b8 2472
2f69f2ec 2473EXFUN (Fidentity, 1);
2f69f2ec 2474EXFUN (Flength, 1);
2f69f2ec
RS
2475EXFUN (Fappend, MANY);
2476EXFUN (Fconcat, MANY);
2477EXFUN (Fvconcat, MANY);
2478EXFUN (Fcopy_sequence, 1);
b4e187e2
RS
2479EXFUN (Fstring_make_multibyte, 1);
2480EXFUN (Fstring_make_unibyte, 1);
2481EXFUN (Fstring_as_multibyte, 1);
2482EXFUN (Fstring_as_unibyte, 1);
35e36092 2483EXFUN (Fstring_to_multibyte, 1);
2f69f2ec 2484EXFUN (Fsubstring, 3);
e6d4aefa
EZ
2485extern Lisp_Object substring_both (Lisp_Object, EMACS_INT, EMACS_INT,
2486 EMACS_INT, EMACS_INT);
2f69f2ec
RS
2487EXFUN (Fnth, 2);
2488EXFUN (Fnthcdr, 2);
2489EXFUN (Fmemq, 2);
2490EXFUN (Fassq, 2);
2491EXFUN (Fassoc, 2);
2492EXFUN (Felt, 2);
2493EXFUN (Fmember, 2);
2494EXFUN (Frassq, 2);
2495EXFUN (Fdelq, 2);
e870dd89 2496EXFUN (Fdelete, 2);
2f69f2ec
RS
2497EXFUN (Fsort, 2);
2498EXFUN (Freverse, 1);
2499EXFUN (Fnreverse, 1);
2500EXFUN (Fget, 2);
2501EXFUN (Fput, 3);
2502EXFUN (Fequal, 2);
2f69f2ec
RS
2503EXFUN (Fnconc, MANY);
2504EXFUN (Fmapcar, 2);
2505EXFUN (Fmapconcat, 3);
383e0970 2506extern Lisp_Object do_yes_or_no_p (Lisp_Object);
13598ab4 2507EXFUN (Fprovide, 2);
383e0970
J
2508extern Lisp_Object concat2 (Lisp_Object, Lisp_Object);
2509extern Lisp_Object concat3 (Lisp_Object, Lisp_Object, Lisp_Object);
2510extern Lisp_Object nconc2 (Lisp_Object, Lisp_Object);
2511extern Lisp_Object assq_no_quit (Lisp_Object, Lisp_Object);
2512extern Lisp_Object assoc_no_quit (Lisp_Object, Lisp_Object);
2513extern void clear_string_char_byte_cache (void);
2514extern EMACS_INT string_char_to_byte (Lisp_Object, EMACS_INT);
2515extern EMACS_INT string_byte_to_char (Lisp_Object, EMACS_INT);
383e0970
J
2516extern Lisp_Object string_to_multibyte (Lisp_Object);
2517extern Lisp_Object string_make_unibyte (Lisp_Object);
2f69f2ec
RS
2518EXFUN (Fcopy_alist, 1);
2519EXFUN (Fplist_get, 2);
5010d3b8 2520EXFUN (Fplist_put, 3);
99982883 2521EXFUN (Fplist_member, 2);
2f69f2ec
RS
2522EXFUN (Frassoc, 2);
2523EXFUN (Fstring_equal, 2);
42d65b5f 2524EXFUN (Fcompare_strings, 7);
2f69f2ec 2525EXFUN (Fstring_lessp, 2);
383e0970 2526extern void syms_of_fns (void);
2f69f2ec
RS
2527
2528/* Defined in floatfns.c */
383e0970 2529extern double extract_float (Lisp_Object);
2f69f2ec 2530EXFUN (Ffloat, 1);
2f69f2ec 2531EXFUN (Ftruncate, 2);
383e0970
J
2532extern void init_floatfns (void);
2533extern void syms_of_floatfns (void);
3d608a86 2534extern Lisp_Object fmod_float (Lisp_Object x, Lisp_Object y);
3cfe6dfd 2535
6b61353c 2536/* Defined in fringe.c */
383e0970
J
2537extern void syms_of_fringe (void);
2538extern void init_fringe (void);
2539extern void init_fringe_once (void);
6b61353c
KH
2540
2541/* Defined in image.c */
e6cba650
DN
2542extern Lisp_Object QCascent, QCmargin, QCrelief, Qcount, Qextension_data;
2543extern Lisp_Object QCconversion, QCcolor_symbols, QCheuristic_mask;
2544extern Lisp_Object QCindex, QCmatrix, QCcolor_adjustment, QCmask;
f81b59a3 2545EXFUN (Finit_image_library, 2);
2f7c71a1 2546extern int x_bitmap_mask (struct frame *, int);
383e0970
J
2547extern void syms_of_image (void);
2548extern void init_image (void);
6b61353c 2549
c98adc1b 2550/* Defined in insdel.c */
b8b31967 2551extern Lisp_Object Qinhibit_modification_hooks;
ae19ba7c
SM
2552extern void move_gap (EMACS_INT);
2553extern void move_gap_both (EMACS_INT, EMACS_INT);
2554extern void make_gap (EMACS_INT);
9628fed7
SM
2555extern EMACS_INT copy_text (const unsigned char *, unsigned char *,
2556 EMACS_INT, int, int);
2557extern EMACS_INT count_size_as_multibyte (const unsigned char *, EMACS_INT);
ae19ba7c
SM
2558extern int count_combining_before (const unsigned char *,
2559 EMACS_INT, EMACS_INT, EMACS_INT);
2560extern int count_combining_after (const unsigned char *,
2561 EMACS_INT, EMACS_INT, EMACS_INT);
2562extern void insert (const unsigned char *, EMACS_INT);
2563extern void insert_and_inherit (const unsigned char *, EMACS_INT);
2564extern void insert_1 (const unsigned char *, EMACS_INT, int, int, int);
2565extern void insert_1_both (const unsigned char *, EMACS_INT, EMACS_INT,
2566 int, int, int);
2567extern void insert_from_gap (EMACS_INT, EMACS_INT);
2568extern void insert_from_string (Lisp_Object, EMACS_INT, EMACS_INT,
2569 EMACS_INT, EMACS_INT, int);
2570extern void insert_from_buffer (struct buffer *, EMACS_INT, EMACS_INT, int);
2571extern void insert_char (int);
2572extern void insert_string (const char *);
2573extern void insert_before_markers (const unsigned char *, EMACS_INT);
2574extern void insert_before_markers_and_inherit (const unsigned char *,
2575 EMACS_INT);
2576extern void insert_from_string_before_markers (Lisp_Object, EMACS_INT,
2577 EMACS_INT, EMACS_INT,
2578 EMACS_INT, int);
2579extern void del_range (EMACS_INT, EMACS_INT);
2580extern Lisp_Object del_range_1 (EMACS_INT, EMACS_INT, int, int);
2581extern void del_range_byte (EMACS_INT, EMACS_INT, int);
2582extern void del_range_both (EMACS_INT, EMACS_INT, EMACS_INT, EMACS_INT, int);
2583extern Lisp_Object del_range_2 (EMACS_INT, EMACS_INT,
2584 EMACS_INT, EMACS_INT, int);
2585extern void modify_region (struct buffer *, EMACS_INT, EMACS_INT, int);
9628fed7
SM
2586extern void prepare_to_modify_buffer (EMACS_INT, EMACS_INT, EMACS_INT *);
2587extern void signal_before_change (EMACS_INT, EMACS_INT, EMACS_INT *);
ae19ba7c
SM
2588extern void signal_after_change (EMACS_INT, EMACS_INT, EMACS_INT);
2589extern void adjust_after_replace (EMACS_INT, EMACS_INT, Lisp_Object,
2590 EMACS_INT, EMACS_INT);
2591extern void adjust_after_replace_noundo (EMACS_INT, EMACS_INT, EMACS_INT,
2592 EMACS_INT, EMACS_INT, EMACS_INT);
2593extern void adjust_after_insert (EMACS_INT, EMACS_INT, EMACS_INT,
2594 EMACS_INT, EMACS_INT);
2595extern void adjust_markers_for_delete (EMACS_INT, EMACS_INT,
2596 EMACS_INT, EMACS_INT);
2597extern void replace_range (EMACS_INT, EMACS_INT, Lisp_Object, int, int, int);
2598extern void replace_range_2 (EMACS_INT, EMACS_INT, EMACS_INT, EMACS_INT,
a8fe7202 2599 const char *, EMACS_INT, EMACS_INT, int);
ae19ba7c 2600extern void syms_of_insdel (void);
c98adc1b 2601
1747fb16 2602/* Defined in dispnew.c */
37b793e6 2603extern Lisp_Object selected_frame;
2f69f2ec 2604EXFUN (Fding, 1);
f5969ae9 2605EXFUN (Fredraw_frame, 1);
2f69f2ec 2606EXFUN (Fsleep_for, 2);
ab9b1db5 2607EXFUN (Fredisplay, 1);
383e0970
J
2608extern Lisp_Object sit_for (Lisp_Object, int, int);
2609extern void init_display (void);
2610extern void syms_of_display (void);
1747fb16 2611
c98adc1b 2612/* Defined in xdisp.c */
c6ae41f3 2613extern Lisp_Object Qinhibit_point_motion_hooks;
016c7a15 2614extern Lisp_Object Qinhibit_redisplay, Qdisplay;
04b80c65 2615extern Lisp_Object Qinhibit_eval_during_redisplay;
25e38168 2616extern Lisp_Object Qmessage_truncate_lines;
99f3388e 2617extern Lisp_Object Qmenu_bar_update_hook;
29208e82 2618extern Lisp_Object Qwindow_scroll_functions;
99f3388e 2619extern Lisp_Object Qoverriding_local_map, Qoverriding_terminal_local_map;
8a52f00a 2620extern Lisp_Object Qimage, Qtext, Qboth, Qboth_horiz, Qtext_image_horiz;
89dc303e 2621extern Lisp_Object Qspace, Qcenter, QCalign_to;
99f3388e
DN
2622extern Lisp_Object Qbar, Qhbar, Qbox, Qhollow;
2623extern Lisp_Object Qleft_margin, Qright_margin;
b932f8b1 2624extern Lisp_Object Qglyphless_char;
89dc303e 2625extern Lisp_Object QCdata, QCfile;
99f3388e 2626extern Lisp_Object QCmap;
e6cba650 2627extern Lisp_Object Qrisky_local_variable;
b932f8b1
DN
2628extern struct frame *last_glyphless_glyph_frame;
2629extern unsigned last_glyphless_glyph_face_id;
2630extern int last_glyphless_glyph_merged_face_id;
a1b5012f 2631extern int message_enable_multibyte;
99f3388e 2632extern int noninteractive_need_newline;
986113df 2633extern Lisp_Object echo_area_buffer[2];
89dc303e 2634extern void add_to_log (const char *, Lisp_Object, Lisp_Object);
383e0970
J
2635extern void check_message_stack (void);
2636extern void setup_echo_area_for_printing (int);
2637extern int push_message (void);
2638extern Lisp_Object pop_message_unwind (Lisp_Object);
2639extern Lisp_Object restore_message_unwind (Lisp_Object);
2640extern void pop_message (void);
2641extern void restore_message (void);
2642extern Lisp_Object current_message (void);
d585695f 2643extern void set_message (const char *s, Lisp_Object, EMACS_INT, int);
383e0970 2644extern void clear_message (int, int);
a8fe7202
AS
2645extern void message (const char *, ...);
2646extern void message_nolog (const char *, ...);
2647extern void message1 (const char *);
2648extern void message1_nolog (const char *);
d585695f
EZ
2649extern void message2 (const char *, EMACS_INT, int);
2650extern void message2_nolog (const char *, EMACS_INT, int);
2651extern void message3 (Lisp_Object, EMACS_INT, int);
2652extern void message3_nolog (Lisp_Object, EMACS_INT, int);
db063399 2653extern void message_dolog (const char *, EMACS_INT, int, int);
a8fe7202 2654extern void message_with_string (const char *, Lisp_Object, int);
383e0970
J
2655extern void message_log_maybe_newline (void);
2656extern void update_echo_area (void);
41118bd3 2657extern void truncate_echo_area (EMACS_INT);
383e0970 2658extern void redisplay (void);
19481752 2659extern int check_point_in_composition
579c18d0 2660 (struct buffer *, EMACS_INT, struct buffer *, EMACS_INT);
383e0970
J
2661extern void redisplay_preserve_echo_area (int);
2662extern void prepare_menu_bars (void);
c4bf5bc3 2663
383e0970
J
2664void set_frame_cursor_types (struct frame *, Lisp_Object);
2665extern void syms_of_xdisp (void);
2666extern void init_xdisp (void);
2667extern Lisp_Object safe_eval (Lisp_Object);
d585695f 2668extern int pos_visible_p (struct window *, EMACS_INT, int *,
383e0970 2669 int *, int *, int *, int *, int *);
c98adc1b 2670
637fa988 2671/* Defined in xsettings.c */
383e0970 2672extern void syms_of_xsettings (void);
637fa988 2673
15b0ced5 2674/* Defined in vm-limit.c. */
a8fe7202 2675extern void memory_warnings (POINTER_TYPE *, void (*warnfun) (const char *));
9043c90a 2676
3cfe6dfd 2677/* Defined in alloc.c */
383e0970 2678extern void check_pure_size (void);
413d18e7 2679extern void allocate_string_data (struct Lisp_String *, EMACS_INT, EMACS_INT);
383e0970
J
2680extern void reset_malloc_hooks (void);
2681extern void uninterrupt_malloc (void);
a8fe7202 2682extern void malloc_warning (const char *);
383e0970
J
2683extern void memory_full (void) NO_RETURN;
2684extern void buffer_memory_full (void) NO_RETURN;
2685extern int survives_gc_p (Lisp_Object);
2686extern void mark_object (Lisp_Object);
84dfc8a7 2687extern void refill_memory_reserve (void);
50c77428 2688extern const char *pending_malloc_warning;
89dc303e 2689extern Lisp_Object *stack_base;
2f69f2ec 2690EXFUN (Fcons, 2);
2f7c71a1
AS
2691extern Lisp_Object list1 (Lisp_Object);
2692extern Lisp_Object list2 (Lisp_Object, Lisp_Object);
2693extern Lisp_Object list3 (Lisp_Object, Lisp_Object, Lisp_Object);
2694extern Lisp_Object list4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2695extern Lisp_Object list5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object,
2696 Lisp_Object);
2f69f2ec
RS
2697EXFUN (Flist, MANY);
2698EXFUN (Fmake_list, 2);
383e0970 2699extern Lisp_Object allocate_misc (void);
2f69f2ec
RS
2700EXFUN (Fmake_vector, 2);
2701EXFUN (Fvector, MANY);
2702EXFUN (Fmake_symbol, 1);
2703EXFUN (Fmake_marker, 0);
2704EXFUN (Fmake_string, 2);
383e0970 2705extern Lisp_Object build_string (const char *);
14162469
EZ
2706extern Lisp_Object make_string (const char *, EMACS_INT);
2707extern Lisp_Object make_unibyte_string (const char *, EMACS_INT);
2708extern Lisp_Object make_multibyte_string (const char *, EMACS_INT, EMACS_INT);
383e0970 2709extern Lisp_Object make_event_array (int, Lisp_Object *);
413d18e7
EZ
2710extern Lisp_Object make_uninit_string (EMACS_INT);
2711extern Lisp_Object make_uninit_multibyte_string (EMACS_INT, EMACS_INT);
14162469
EZ
2712extern Lisp_Object make_string_from_bytes (const char *, EMACS_INT, EMACS_INT);
2713extern Lisp_Object make_specified_string (const char *,
2714 EMACS_INT, EMACS_INT, int);
2f69f2ec 2715EXFUN (Fpurecopy, 1);
14162469 2716extern Lisp_Object make_pure_string (const char *, EMACS_INT, EMACS_INT, int);
5e2327cf 2717extern Lisp_Object make_pure_c_string (const char *data);
383e0970
J
2718extern Lisp_Object pure_cons (Lisp_Object, Lisp_Object);
2719extern Lisp_Object make_pure_vector (EMACS_INT);
2f69f2ec
RS
2720EXFUN (Fgarbage_collect, 0);
2721EXFUN (Fmake_byte_code, MANY);
2722EXFUN (Fmake_bool_vector, 2);
7f73dc9d 2723extern Lisp_Object Qchar_table_extra_slots;
383e0970
J
2724extern struct Lisp_Vector *allocate_vector (EMACS_INT);
2725extern struct Lisp_Vector *allocate_pseudovector (int memlen, int lisplen, EMACS_INT tag);
30f95089
SM
2726#define ALLOCATE_PSEUDOVECTOR(typ,field,tag) \
2727 ((typ*) \
2728 allocate_pseudovector \
2729 (VECSIZE (typ), PSEUDOVECSIZE (typ, field), tag))
383e0970
J
2730extern struct Lisp_Hash_Table *allocate_hash_table (void);
2731extern struct window *allocate_window (void);
2732extern struct frame *allocate_frame (void);
2733extern struct Lisp_Process *allocate_process (void);
2734extern struct terminal *allocate_terminal (void);
4d57802e 2735extern int gc_in_progress;
95684592 2736extern int abort_on_gc;
383e0970
J
2737extern Lisp_Object make_float (double);
2738extern void display_malloc_warning (void);
2739extern int inhibit_garbage_collection (void);
2740extern Lisp_Object make_save_value (void *, int);
2741extern void free_misc (Lisp_Object);
2742extern void free_marker (Lisp_Object);
2743extern void free_cons (struct Lisp_Cons *);
2744extern void init_alloc_once (void);
2745extern void init_alloc (void);
2746extern void syms_of_alloc (void);
2747extern struct buffer * allocate_buffer (void);
2748extern int valid_lisp_object_p (Lisp_Object);
3cfe6dfd 2749
1842abb2
KH
2750/* Defined in chartab.c */
2751EXFUN (Fmake_char_table, 2);
1842abb2
KH
2752EXFUN (Fset_char_table_parent, 2);
2753EXFUN (Fchar_table_extra_slot, 2);
2754EXFUN (Fset_char_table_extra_slot, 3);
1842abb2 2755EXFUN (Fset_char_table_range, 3);
d0827857 2756EXFUN (Foptimize_char_table, 2);
383e0970 2757extern Lisp_Object copy_char_table (Lisp_Object);
383e0970
J
2758extern Lisp_Object char_table_ref (Lisp_Object, int);
2759extern Lisp_Object char_table_ref_and_range (Lisp_Object, int,
2760 int *, int *);
2761extern Lisp_Object char_table_set (Lisp_Object, int, Lisp_Object);
2762extern Lisp_Object char_table_set_range (Lisp_Object, int, int,
2763 Lisp_Object);
2764extern int char_table_translate (Lisp_Object, int);
2765extern void map_char_table (void (*) (Lisp_Object, Lisp_Object,
2766 Lisp_Object),
2767 Lisp_Object, Lisp_Object, Lisp_Object);
e6cba650
DN
2768extern void map_char_table_for_charset (void (*c_function) (Lisp_Object, Lisp_Object),
2769 Lisp_Object, Lisp_Object,
2770 Lisp_Object, struct charset *,
2771 unsigned, unsigned);
383e0970 2772extern void syms_of_chartab (void);
1842abb2 2773
3cfe6dfd
JB
2774/* Defined in print.c */
2775extern Lisp_Object Vprin1_to_string_buffer;
42c8bc9b
DN
2776extern void debug_print (Lisp_Object) EXTERNALLY_VISIBLE;
2777extern void safe_debug_print (Lisp_Object) EXTERNALLY_VISIBLE;
2f69f2ec
RS
2778EXFUN (Fprin1, 2);
2779EXFUN (Fprin1_to_string, 2);
2780EXFUN (Fprinc, 2);
2781EXFUN (Fterpri, 1);
2782EXFUN (Fprint, 2);
2783EXFUN (Ferror_message_string, 1);
29208e82 2784extern Lisp_Object Qstandard_output;
9453ea7b 2785extern Lisp_Object Qexternal_debugging_output;
383e0970 2786extern void temp_output_buffer_setup (const char *);
29208e82 2787extern int print_level;
3cfe6dfd 2788extern Lisp_Object Qprint_escape_newlines;
a8fe7202 2789extern void write_string (const char *, int);
a8fe7202
AS
2790extern void print_error_message (Lisp_Object, Lisp_Object, const char *,
2791 Lisp_Object);
526a2be7 2792extern Lisp_Object internal_with_output_to_temp_buffer
383e0970 2793 (const char *, Lisp_Object (*) (Lisp_Object), Lisp_Object);
6e8e6bf2 2794#define FLOAT_TO_STRING_BUFSIZE 350
383e0970
J
2795extern void float_to_string (unsigned char *, double);
2796extern void syms_of_print (void);
526a2be7
AS
2797
2798/* Defined in doprnt.c */
84c9ce05 2799extern EMACS_INT doprnt (char *, int, const char *, const char *, va_list);
3cfe6dfd 2800
3cfe6dfd 2801extern Lisp_Object Qvariable_documentation, Qstandard_input;
99f3388e 2802extern Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
29208e82 2803extern Lisp_Object initial_obarray;
2f69f2ec
RS
2804EXFUN (Fread, 1);
2805EXFUN (Fread_from_string, 3);
2806EXFUN (Fintern, 2);
2807EXFUN (Fintern_soft, 2);
5d8c7983 2808EXFUN (Fload, 5);
3ceb69d9 2809EXFUN (Fget_load_suffixes, 0);
0601ad0f
CY
2810EXFUN (Fread_char, 3);
2811EXFUN (Fread_event, 3);
eb542c51 2812EXFUN (Feval_region, 4);
383e0970
J
2813extern Lisp_Object check_obarray (Lisp_Object);
2814extern Lisp_Object intern (const char *);
5e2327cf 2815extern Lisp_Object intern_c_string (const char *);
a8fe7202 2816extern Lisp_Object make_symbol (const char *);
40283062 2817extern Lisp_Object oblookup (Lisp_Object, const char *, EMACS_INT, EMACS_INT);
c5e3de70 2818#define LOADHIST_ATTACH(x) \
d6d23852
SM
2819 do { \
2820 if (initialized) Vcurrent_load_list = Fcons (x, Vcurrent_load_list); \
2821 } while (0)
383e0970
J
2822extern int openp (Lisp_Object, Lisp_Object, Lisp_Object,
2823 Lisp_Object *, Lisp_Object);
a8fe7202 2824extern int isfloat_string (const char *, int);
383e0970
J
2825extern void map_obarray (Lisp_Object, void (*) (Lisp_Object, Lisp_Object),
2826 Lisp_Object);
a8fe7202 2827extern void dir_warning (const char *, Lisp_Object);
383e0970
J
2828extern void close_load_descs (void);
2829extern void init_obarray (void);
2830extern void init_lread (void);
2831extern void syms_of_lread (void);
3cfe6dfd
JB
2832
2833/* Defined in eval.c */
2834extern Lisp_Object Qautoload, Qexit, Qinteractive, Qcommandp, Qdefun, Qmacro;
29208e82 2835extern Lisp_Object Qinhibit_quit;
3cfe6dfd 2836extern Lisp_Object Vautoload_queue;
fab88cb7 2837extern Lisp_Object Vsignaling_function;
21c5a64e 2838extern int handling_signal;
f1b6e5fc
SM
2839/* To run a normal hook, use the appropriate function from the list below.
2840 The calling convention:
2841
846d69ac 2842 if (!NILP (Vrun_hooks))
f1b6e5fc
SM
2843 call1 (Vrun_hooks, Qmy_funny_hook);
2844
2845 should no longer be used. */
3cfe6dfd 2846extern Lisp_Object Vrun_hooks;
2f69f2ec
RS
2847EXFUN (Frun_hooks, MANY);
2848EXFUN (Frun_hook_with_args, MANY);
2f69f2ec 2849EXFUN (Frun_hook_with_args_until_failure, MANY);
383e0970 2850extern void run_hook_with_args_2 (Lisp_Object, Lisp_Object, Lisp_Object);
2f69f2ec 2851EXFUN (Fprogn, UNEVALLED);
2f69f2ec 2852EXFUN (Finteractive_p, 0);
fca99116 2853EXFUN (Fthrow, 2) NO_RETURN;
834168ef 2854EXFUN (Fsignal, 2);
383e0970
J
2855extern void xsignal (Lisp_Object, Lisp_Object) NO_RETURN;
2856extern void xsignal0 (Lisp_Object) NO_RETURN;
2857extern void xsignal1 (Lisp_Object, Lisp_Object) NO_RETURN;
2858extern void xsignal2 (Lisp_Object, Lisp_Object, Lisp_Object) NO_RETURN;
2859extern void xsignal3 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object) NO_RETURN;
a8fe7202 2860extern void signal_error (const char *, Lisp_Object) NO_RETURN;
2a4d03b8 2861EXFUN (Fcommandp, 2);
2f69f2ec
RS
2862EXFUN (Feval, 1);
2863EXFUN (Fapply, MANY);
2864EXFUN (Ffuncall, MANY);
2865EXFUN (Fbacktrace, 0);
383e0970
J
2866extern Lisp_Object apply1 (Lisp_Object, Lisp_Object);
2867extern Lisp_Object call0 (Lisp_Object);
2868extern Lisp_Object call1 (Lisp_Object, Lisp_Object);
2869extern Lisp_Object call2 (Lisp_Object, Lisp_Object, Lisp_Object);
2870extern Lisp_Object call3 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2871extern Lisp_Object call4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2872extern Lisp_Object call5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2873extern Lisp_Object call6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2874extern Lisp_Object call7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object);
2f69f2ec 2875EXFUN (Fdo_auto_save, 2);
383e0970
J
2876extern Lisp_Object internal_catch (Lisp_Object, Lisp_Object (*) (Lisp_Object), Lisp_Object);
2877extern Lisp_Object internal_lisp_condition_case (Lisp_Object, Lisp_Object, Lisp_Object);
2878extern Lisp_Object internal_condition_case (Lisp_Object (*) (void), Lisp_Object, Lisp_Object (*) (Lisp_Object));
2879extern Lisp_Object internal_condition_case_1 (Lisp_Object (*) (Lisp_Object), Lisp_Object, Lisp_Object, Lisp_Object (*) (Lisp_Object));
2880extern Lisp_Object internal_condition_case_2 (Lisp_Object (*) (Lisp_Object, Lisp_Object), Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object (*) (Lisp_Object));
2881extern Lisp_Object internal_condition_case_n (Lisp_Object (*) (int, Lisp_Object *), int, Lisp_Object *, Lisp_Object, Lisp_Object (*) (Lisp_Object));
2882extern void specbind (Lisp_Object, Lisp_Object);
2883extern void record_unwind_protect (Lisp_Object (*) (Lisp_Object), Lisp_Object);
2884extern Lisp_Object unbind_to (int, Lisp_Object);
a8fe7202 2885extern void error (const char *, ...) NO_RETURN;
b3ffc17c 2886extern void verror (const char *, va_list) NO_RETURN;
383e0970
J
2887extern void do_autoload (Lisp_Object, Lisp_Object);
2888extern Lisp_Object un_autoload (Lisp_Object);
2f69f2ec 2889EXFUN (Ffetch_bytecode, 1);
383e0970
J
2890extern void init_eval_once (void);
2891extern Lisp_Object safe_call (int, Lisp_Object *);
2892extern Lisp_Object safe_call1 (Lisp_Object, Lisp_Object);
58555d81 2893extern Lisp_Object safe_call2 (Lisp_Object, Lisp_Object, Lisp_Object);
383e0970
J
2894extern void init_eval (void);
2895extern void syms_of_eval (void);
3cfe6dfd 2896
e6cba650 2897extern Lisp_Object Qfield;
986113df 2898EXFUN (Fcurrent_message, 0);
2f69f2ec 2899EXFUN (Fgoto_char, 1);
2f69f2ec 2900EXFUN (Fpoint_max_marker, 0);
2f69f2ec
RS
2901EXFUN (Fpoint, 0);
2902EXFUN (Fpoint_marker, 0);
2f69f2ec
RS
2903EXFUN (Fline_beginning_position, 1);
2904EXFUN (Fline_end_position, 1);
2905EXFUN (Ffollowing_char, 0);
2906EXFUN (Fprevious_char, 0);
2907EXFUN (Fchar_after, 1);
2908EXFUN (Finsert, MANY);
2f69f2ec 2909EXFUN (Finsert_char, 3);
383e0970 2910extern void insert1 (Lisp_Object);
2f69f2ec
RS
2911EXFUN (Feolp, 0);
2912EXFUN (Feobp, 0);
2913EXFUN (Fbolp, 0);
2914EXFUN (Fbobp, 0);
2915EXFUN (Fformat, MANY);
5010d3b8 2916EXFUN (Fmessage, MANY);
a8fe7202 2917extern Lisp_Object format2 (const char *, Lisp_Object, Lisp_Object);
2f69f2ec
RS
2918EXFUN (Fbuffer_substring, 2);
2919EXFUN (Fbuffer_string, 0);
383e0970
J
2920extern Lisp_Object save_excursion_save (void);
2921extern Lisp_Object save_restriction_save (void);
2922extern Lisp_Object save_excursion_restore (Lisp_Object);
2923extern Lisp_Object save_restriction_restore (Lisp_Object);
2f69f2ec
RS
2924EXFUN (Fchar_to_string, 1);
2925EXFUN (Fdelete_region, 2);
2926EXFUN (Fnarrow_to_region, 2);
2927EXFUN (Fwiden, 0);
2928EXFUN (Fuser_login_name, 1);
2929EXFUN (Fsystem_name, 0);
f5969ae9 2930EXFUN (Fcurrent_time, 0);
fe3537c3 2931extern EMACS_INT clip_to_bounds (EMACS_INT, EMACS_INT, EMACS_INT);
413d18e7
EZ
2932extern Lisp_Object make_buffer_string (EMACS_INT, EMACS_INT, int);
2933extern Lisp_Object make_buffer_string_both (EMACS_INT, EMACS_INT, EMACS_INT,
2934 EMACS_INT, int);
383e0970
J
2935extern void init_editfns (void);
2936extern void syms_of_editfns (void);
8d0941fa 2937EXFUN (Fconstrain_to_field, 5);
89512fcd 2938EXFUN (Ffield_end, 3);
a8fe7202 2939extern void set_time_zone_rule (const char *);
3cfe6dfd 2940
78edd3b7 2941/* Defined in buffer.c */
383e0970
J
2942extern int mouse_face_overlay_overlaps (Lisp_Object);
2943extern void nsberror (Lisp_Object) NO_RETURN;
986113df 2944EXFUN (Fset_buffer_multibyte, 1);
2f69f2ec
RS
2945EXFUN (Foverlay_start, 1);
2946EXFUN (Foverlay_end, 1);
383e0970
J
2947extern void adjust_overlays_for_insert (EMACS_INT, EMACS_INT);
2948extern void adjust_overlays_for_delete (EMACS_INT, EMACS_INT);
145582a0 2949extern void fix_start_end_in_overlays (EMACS_INT, EMACS_INT);
383e0970
J
2950extern void report_overlay_modification (Lisp_Object, Lisp_Object, int,
2951 Lisp_Object, Lisp_Object, Lisp_Object);
145582a0 2952extern int overlay_touches_p (EMACS_INT);
29208e82 2953extern Lisp_Object Vbuffer_alist;
2f69f2ec
RS
2954EXFUN (Fget_buffer, 1);
2955EXFUN (Fget_buffer_create, 1);
941caafe 2956EXFUN (Fgenerate_new_buffer_name, 2);
2f69f2ec 2957EXFUN (Fset_buffer, 1);
2f7c71a1 2958extern Lisp_Object set_buffer_if_live (Lisp_Object);
2f69f2ec
RS
2959EXFUN (Fbarf_if_buffer_read_only, 0);
2960EXFUN (Fcurrent_buffer, 0);
2961EXFUN (Fswitch_to_buffer, 2);
dbe7f1ef 2962EXFUN (Fother_buffer, 3);
2f69f2ec
RS
2963EXFUN (Foverlay_get, 2);
2964EXFUN (Fbuffer_modified_p, 1);
2965EXFUN (Fset_buffer_modified_p, 1);
2966EXFUN (Fkill_buffer, 1);
2967EXFUN (Fkill_all_local_variables, 0);
2f69f2ec
RS
2968EXFUN (Fbuffer_enable_undo, 1);
2969EXFUN (Ferase_buffer, 0);
20280af7 2970extern Lisp_Object Qoverlayp;
e6cba650 2971extern Lisp_Object Qpriority, Qwindow, Qevaporate, Qbefore_string, Qafter_string;
383e0970 2972extern Lisp_Object get_truename_buffer (Lisp_Object);
3cfe6dfd 2973extern struct buffer *all_buffers;
2f69f2ec 2974EXFUN (Fprevious_overlay_change, 1);
d7935eb6 2975EXFUN (Fbuffer_file_name, 1);
383e0970
J
2976extern void init_buffer_once (void);
2977extern void init_buffer (void);
2978extern void syms_of_buffer (void);
2979extern void keys_of_buffer (void);
3cfe6dfd 2980
78edd3b7 2981/* Defined in marker.c */
3cfe6dfd 2982
2f69f2ec
RS
2983EXFUN (Fmarker_position, 1);
2984EXFUN (Fmarker_buffer, 1);
2985EXFUN (Fcopy_marker, 2);
2986EXFUN (Fset_marker, 3);
0350982f
LMI
2987extern EMACS_INT marker_position (Lisp_Object);
2988extern EMACS_INT marker_byte_position (Lisp_Object);
383e0970 2989extern void clear_charpos_cache (struct buffer *);
0350982f
LMI
2990extern EMACS_INT charpos_to_bytepos (EMACS_INT);
2991extern EMACS_INT buf_charpos_to_bytepos (struct buffer *, EMACS_INT);
2992extern EMACS_INT buf_bytepos_to_charpos (struct buffer *, EMACS_INT);
383e0970
J
2993extern void unchain_marker (struct Lisp_Marker *marker);
2994extern Lisp_Object set_marker_restricted (Lisp_Object, Lisp_Object, Lisp_Object);
0350982f 2995extern Lisp_Object set_marker_both (Lisp_Object, Lisp_Object, EMACS_INT, EMACS_INT);
383e0970 2996extern Lisp_Object set_marker_restricted_both (Lisp_Object, Lisp_Object,
0350982f 2997 EMACS_INT, EMACS_INT);
383e0970 2998extern void syms_of_marker (void);
3cfe6dfd
JB
2999
3000/* Defined in fileio.c */
3001
3002extern Lisp_Object Qfile_error;
99f3388e 3003extern Lisp_Object Qfile_exists_p;
e6cba650
DN
3004extern Lisp_Object Qfile_directory_p;
3005extern Lisp_Object Qinsert_file_contents;
2f69f2ec
RS
3006EXFUN (Ffind_file_name_handler, 2);
3007EXFUN (Ffile_name_as_directory, 1);
3008EXFUN (Fexpand_file_name, 2);
3009EXFUN (Ffile_name_nondirectory, 1);
3010EXFUN (Fsubstitute_in_file_name, 1);
3011EXFUN (Ffile_symlink_p, 1);
3012EXFUN (Fverify_visited_file_modtime, 1);
3013EXFUN (Ffile_exists_p, 1);
3014EXFUN (Ffile_name_absolute_p, 1);
3015EXFUN (Fdirectory_file_name, 1);
3016EXFUN (Ffile_name_directory, 1);
383e0970 3017extern Lisp_Object expand_and_dir_to_file (Lisp_Object, Lisp_Object);
2f69f2ec
RS
3018EXFUN (Ffile_accessible_directory_p, 1);
3019EXFUN (Funhandled_file_name_directory, 1);
3020EXFUN (Ffile_directory_p, 1);
b4e187e2 3021EXFUN (Fwrite_region, 7);
2f69f2ec
RS
3022EXFUN (Ffile_readable_p, 1);
3023EXFUN (Ffile_executable_p, 1);
fda1acc5 3024EXFUN (Fread_file_name, 6);
383e0970
J
3025extern Lisp_Object close_file_unwind (Lisp_Object);
3026extern Lisp_Object restore_point_unwind (Lisp_Object);
3027extern void report_file_error (const char *, Lisp_Object) NO_RETURN;
3028extern int internal_delete_file (Lisp_Object);
3029extern void syms_of_fileio (void);
3030extern Lisp_Object make_temp_name (Lisp_Object, int);
453d8ee9 3031EXFUN (Fmake_symbolic_link, 3);
b86cfd28 3032extern Lisp_Object Qdelete_file;
3cfe6dfd
JB
3033
3034/* Defined in abbrev.c */
3035
383e0970 3036extern void syms_of_abbrev (void);
3cfe6dfd 3037
78edd3b7 3038/* Defined in search.c */
383e0970 3039extern void shrink_regexp_cache (void);
2f69f2ec 3040EXFUN (Fstring_match, 3);
383e0970 3041extern void restore_search_regs (void);
5fe2b5a5
KS
3042EXFUN (Fmatch_data, 3);
3043EXFUN (Fset_match_data, 2);
2f69f2ec
RS
3044EXFUN (Fmatch_beginning, 1);
3045EXFUN (Fmatch_end, 1);
383e0970 3046extern void record_unwind_save_match_data (void);
383e0970
J
3047extern int fast_string_match (Lisp_Object, Lisp_Object);
3048extern int fast_c_string_match_ignore_case (Lisp_Object, const char *);
3049extern int fast_string_match_ignore_case (Lisp_Object, Lisp_Object);
3050extern EMACS_INT fast_looking_at (Lisp_Object, EMACS_INT, EMACS_INT,
3051 EMACS_INT, EMACS_INT, Lisp_Object);
c098fdb8
EZ
3052extern EMACS_INT scan_buffer (int, EMACS_INT, EMACS_INT, EMACS_INT,
3053 int *, int);
3054extern EMACS_INT scan_newline (EMACS_INT, EMACS_INT, EMACS_INT, EMACS_INT,
3055 EMACS_INT, int);
3056extern EMACS_INT find_next_newline (EMACS_INT, int);
3057extern EMACS_INT find_next_newline_no_quit (EMACS_INT, EMACS_INT);
3058extern EMACS_INT find_before_next_newline (EMACS_INT, EMACS_INT, EMACS_INT);
383e0970
J
3059extern void syms_of_search (void);
3060extern void clear_regexp_cache (void);
3cfe6dfd 3061
78edd3b7 3062/* Defined in minibuf.c */
3cfe6dfd 3063
e6cba650 3064extern Lisp_Object Qcompletion_ignore_case;
99f3388e 3065extern Lisp_Object Vminibuffer_list;
3cfe6dfd 3066extern Lisp_Object last_minibuf_string;
383e0970 3067extern void choose_minibuf_frame (void);
5593f7e3 3068EXFUN (Fcompleting_read, 8);
2c960667 3069EXFUN (Fread_from_minibuffer, 7);
2f69f2ec
RS
3070EXFUN (Fread_variable, 2);
3071EXFUN (Fread_buffer, 3);
3072EXFUN (Fread_minibuffer, 2);
3073EXFUN (Feval_minibuffer, 2);
5593f7e3 3074EXFUN (Fread_string, 5);
f85064bd 3075EXFUN (Fassoc_string, 3);
383e0970 3076extern Lisp_Object get_minibuffer (int);
383e0970
J
3077extern void init_minibuf_once (void);
3078extern void syms_of_minibuf (void);
3cfe6dfd
JB
3079
3080/* Defined in callint.c */
3081
29208e82 3082extern Lisp_Object Qminus, Qplus;
99f3388e 3083extern Lisp_Object Qwhen;
7fd61057 3084extern Lisp_Object Qcall_interactively, Qmouse_leave_buffer_hook;
2f69f2ec 3085EXFUN (Fprefix_numeric_value, 1);
383e0970 3086extern void syms_of_callint (void);
3cfe6dfd 3087
78edd3b7 3088/* Defined in casefiddle.c */
3cfe6dfd 3089
99f3388e 3090extern Lisp_Object Qidentity;
2f69f2ec
RS
3091EXFUN (Fdowncase, 1);
3092EXFUN (Fupcase, 1);
2f69f2ec
RS
3093EXFUN (Fupcase_region, 2);
3094EXFUN (Fupcase_initials, 1);
3095EXFUN (Fupcase_initials_region, 2);
383e0970
J
3096extern void syms_of_casefiddle (void);
3097extern void keys_of_casefiddle (void);
3cfe6dfd 3098
78edd3b7 3099/* Defined in casetab.c */
1747fb16 3100
2f69f2ec
RS
3101EXFUN (Fset_case_table, 1);
3102EXFUN (Fset_standard_case_table, 1);
383e0970
J
3103extern void init_casetab_once (void);
3104extern void syms_of_casetab (void);
1747fb16 3105
78edd3b7 3106/* Defined in keyboard.c */
3cfe6dfd 3107
54cd1651
GM
3108extern int echoing;
3109extern Lisp_Object echo_message_buffer;
417750de 3110extern struct kboard *echo_kboard;
383e0970 3111extern void cancel_echoing (void);
1425dcb6 3112extern Lisp_Object Qdisabled, QCfilter;
99f3388e
DN
3113extern Lisp_Object Qabove_handle, Qhandle, Qbelow_handle;
3114extern Lisp_Object Qup, Qdown, Qbottom, Qend_scroll;
3115extern Lisp_Object Qtop, Qratio;
8e7bd231 3116extern int input_pending;
2f69f2ec
RS
3117EXFUN (Fdiscard_input, 0);
3118EXFUN (Frecursive_edit, 0);
ccaf0336 3119EXFUN (Ftop_level, 0) NO_RETURN;
2f69f2ec 3120EXFUN (Fcommand_execute, 4);
383e0970
J
3121extern Lisp_Object menu_bar_items (Lisp_Object);
3122extern Lisp_Object tool_bar_items (Lisp_Object, int *);
f498e3b2 3123extern Lisp_Object Qvertical_scroll_bar;
383e0970 3124extern void discard_mouse_events (void);
2f69f2ec 3125EXFUN (Fevent_convert_list, 1);
e271fdb3 3126EXFUN (Fread_key_sequence, 5);
a712a8c3 3127EXFUN (Fset_input_interrupt_mode, 1);
526a2be7 3128EXFUN (Fset_input_mode, 4);
58555d81 3129extern Lisp_Object pending_funcalls;
383e0970
J
3130extern int detect_input_pending (void);
3131extern int detect_input_pending_ignore_squeezables (void);
3132extern int detect_input_pending_run_timers (int);
3133extern void safe_run_hooks (Lisp_Object);
a8fe7202 3134extern void cmd_error_internal (Lisp_Object, const char *);
383e0970
J
3135extern Lisp_Object command_loop_1 (void);
3136extern Lisp_Object recursive_edit_1 (void);
3137extern void record_auto_save (void);
3138extern void init_keyboard (void);
3139extern void syms_of_keyboard (void);
3140extern void keys_of_keyboard (void);
3141extern char *push_key_description (unsigned int, char *, int);
3cfe6dfd 3142
3cfe6dfd 3143
78edd3b7 3144/* Defined in indent.c */
2f69f2ec
RS
3145EXFUN (Fvertical_motion, 2);
3146EXFUN (Findent_to, 2);
2f69f2ec 3147EXFUN (Fmove_to_column, 2);
383e0970
J
3148extern double current_column (void);
3149extern void invalidate_current_column (void);
5816888b 3150extern int indented_beyond_p (EMACS_INT, EMACS_INT, double);
383e0970 3151extern void syms_of_indent (void);
3cfe6dfd 3152
78edd3b7 3153/* Defined in frame.c */
a433994a 3154#ifdef HAVE_WINDOW_SYSTEM
a433994a 3155#endif /* HAVE_WINDOW_SYSTEM */
e6cba650 3156extern Lisp_Object Qonly;
362fb47a 3157extern Lisp_Object Qvisible;
383e0970
J
3158extern void store_frame_param (struct frame *, Lisp_Object, Lisp_Object);
3159extern void store_in_alist (Lisp_Object *, Lisp_Object, Lisp_Object);
3160extern Lisp_Object do_switch_frame (Lisp_Object, int, int, Lisp_Object);
3161extern Lisp_Object get_frame_param (struct frame *, Lisp_Object);
3162extern Lisp_Object frame_buffer_predicate (Lisp_Object);
9e61f0d7 3163EXFUN (Fselect_frame, 2);
2f69f2ec
RS
3164EXFUN (Fselected_frame, 0);
3165EXFUN (Fwindow_frame, 1);
3166EXFUN (Fframe_root_window, 1);
3167EXFUN (Fframe_first_window, 1);
2f69f2ec 3168EXFUN (Fmake_frame_visible, 1);
2f69f2ec 3169EXFUN (Ficonify_frame, 1);
4560730a 3170EXFUN (Fframe_parameter, 2);
2f69f2ec 3171EXFUN (Fmodify_frame_parameters, 2);
2f69f2ec
RS
3172EXFUN (Fraise_frame, 1);
3173EXFUN (Fredirect_frame_focus, 2);
9e61f0d7 3174EXFUN (Fset_frame_selected_window, 3);
383e0970
J
3175extern Lisp_Object frame_buffer_list (Lisp_Object);
3176extern void frames_discard_buffer (Lisp_Object);
3177extern void set_frame_buffer_list (Lisp_Object, Lisp_Object);
383e0970 3178extern void syms_of_frame (void);
3cfe6dfd 3179
78edd3b7 3180/* Defined in emacs.c */
99f3388e
DN
3181extern char **initial_argv;
3182extern int initial_argc;
89dc303e
DN
3183#if defined(HAVE_X_WINDOWS) || defined(HAVE_NS)
3184extern int display_arg;
3185#endif
a8fe7202 3186extern Lisp_Object decode_env_path (const char *, const char *);
2c668b9a 3187extern Lisp_Object empty_unibyte_string, empty_multibyte_string;
e6cba650 3188extern Lisp_Object Qfile_name_handler_alist;
36e053eb 3189extern void (*fatal_error_signal_hook) (void);
89dc303e 3190EXFUN (Fkill_emacs, 1) NO_RETURN;
68c45bf0 3191#if HAVE_SETLOCALE
383e0970
J
3192void fixup_locale (void);
3193void synchronize_system_messages_locale (void);
3194void synchronize_system_time_locale (void);
68c45bf0
PE
3195#else
3196#define setlocale(category, locale)
3197#define fixup_locale()
ca9c0567
PE
3198#define synchronize_system_messages_locale()
3199#define synchronize_system_time_locale()
68c45bf0 3200#endif
383e0970 3201void shut_down_emacs (int, int, Lisp_Object);
78edd3b7 3202/* Nonzero means don't do interactive redisplay and don't change tty modes. */
3cfe6dfd 3203extern int noninteractive;
ff808935 3204
66b7b0fe
GM
3205/* Nonzero means remove site-lisp directories from load-path. */
3206extern int no_site_lisp;
3207
ff808935
DN
3208/* Pipe used to send exit notification to the daemon parent at
3209 startup. */
3210extern int daemon_pipe[2];
3211#define IS_DAEMON (daemon_pipe[1] != 0)
3212
78edd3b7 3213/* Nonzero means don't do use window-system-specific display code. */
3cfe6dfd 3214extern int inhibit_window_system;
99a3d506 3215/* Nonzero means that a filter or a sentinel is running. */
7074fde6 3216extern int running_asynch_code;
3cfe6dfd 3217
78edd3b7 3218/* Defined in process.c */
89dc303e 3219extern Lisp_Object QCtype, Qlocal;
2f69f2ec
RS
3220EXFUN (Fget_process, 1);
3221EXFUN (Fget_buffer_process, 1);
2f69f2ec
RS
3222EXFUN (Fprocess_status, 1);
3223EXFUN (Fkill_process, 2);
2f69f2ec 3224EXFUN (Fwaiting_for_user_input_p, 0);
6efad63b 3225extern Lisp_Object Qprocessp;
383e0970
J
3226extern void kill_buffer_processes (Lisp_Object);
3227extern int wait_reading_process_output (int, int, int, int,
3228 Lisp_Object,
3229 struct Lisp_Process *,
3230 int);
3231extern void add_keyboard_wait_descriptor (int);
3232extern void delete_keyboard_wait_descriptor (int);
3233extern void add_gpm_wait_descriptor (int);
3234extern void delete_gpm_wait_descriptor (int);
3235extern void close_process_descs (void);
3236extern void init_process (void);
3237extern void syms_of_process (void);
3238extern void setup_process_coding_systems (Lisp_Object);
3cfe6dfd 3239
f5969ae9 3240EXFUN (Fcall_process, MANY);
383e0970
J
3241extern int child_setup (int, int, int, char **, int, Lisp_Object);
3242extern void init_callproc_1 (void);
3243extern void init_callproc (void);
3244extern void set_initial_environment (void);
3245extern void syms_of_callproc (void);
3cfe6dfd 3246
78edd3b7 3247/* Defined in doc.c */
99f3388e 3248extern Lisp_Object Qfunction_documentation;
2f69f2ec 3249EXFUN (Fsubstitute_command_keys, 1);
2f69f2ec 3250EXFUN (Fdocumentation_property, 3);
383e0970
J
3251extern Lisp_Object read_doc_string (Lisp_Object);
3252extern Lisp_Object get_doc_string (Lisp_Object, int, int);
3253extern void syms_of_doc (void);
3254extern int read_bytecode_char (int);
3cfe6dfd 3255
78edd3b7 3256/* Defined in bytecode.c */
3cfe6dfd 3257extern Lisp_Object Qbytecode;
2f69f2ec 3258EXFUN (Fbyte_code, 3);
383e0970 3259extern void syms_of_bytecode (void);
35c7a974 3260extern struct byte_stack *byte_stack_list;
383e0970
J
3261extern void mark_byte_stack (void);
3262extern void unmark_byte_stack (void);
3cfe6dfd 3263
78edd3b7 3264/* Defined in macros.c */
3cfe6dfd 3265extern Lisp_Object Qexecute_kbd_macro;
a361276f 3266EXFUN (Fexecute_kbd_macro, 3);
35e36092 3267EXFUN (Fcancel_kbd_macro_events, 0);
383e0970
J
3268extern void init_macros (void);
3269extern void syms_of_macros (void);
3cfe6dfd 3270
78edd3b7 3271/* Defined in undo.c */
89dc303e 3272extern Lisp_Object Qapply;
a387611b 3273extern Lisp_Object Qinhibit_read_only;
2f69f2ec 3274EXFUN (Fundo_boundary, 0);
383e0970 3275extern void truncate_undo_list (struct buffer *);
c8a66ab8
EZ
3276extern void record_marker_adjustment (Lisp_Object, EMACS_INT);
3277extern void record_insert (EMACS_INT, EMACS_INT);
3278extern void record_delete (EMACS_INT, Lisp_Object);
383e0970 3279extern void record_first_change (void);
c8a66ab8
EZ
3280extern void record_change (EMACS_INT, EMACS_INT);
3281extern void record_property_change (EMACS_INT, EMACS_INT,
3282 Lisp_Object, Lisp_Object,
383e0970
J
3283 Lisp_Object);
3284extern void syms_of_undo (void);
78edd3b7 3285/* Defined in textprop.c */
5f6bf5fe 3286extern Lisp_Object Qfont, Qmouse_face;
c2d8811c 3287extern Lisp_Object Qinsert_in_front_hooks, Qinsert_behind_hooks;
e6cba650
DN
3288extern Lisp_Object Qfront_sticky, Qrear_nonsticky;
3289extern Lisp_Object Qminibuffer_prompt;
3290
2f69f2ec 3291EXFUN (Fnext_single_property_change, 4);
5433ffa5 3292EXFUN (Fnext_single_char_property_change, 4);
2f69f2ec
RS
3293EXFUN (Fprevious_single_property_change, 4);
3294EXFUN (Fget_text_property, 3);
3295EXFUN (Fput_text_property, 5);
2f69f2ec
RS
3296EXFUN (Fprevious_char_property_change, 2);
3297EXFUN (Fnext_char_property_change, 2);
383e0970 3298extern void report_interval_modification (Lisp_Object, Lisp_Object);
8537f1cb 3299
78edd3b7 3300/* Defined in menu.c */
383e0970 3301extern void syms_of_menu (void);
febcacdd 3302
78edd3b7 3303/* Defined in xmenu.c */
2f69f2ec 3304EXFUN (Fx_popup_menu, 2);
897001fe 3305EXFUN (Fx_popup_dialog, 3);
383e0970 3306extern void syms_of_xmenu (void);
526a2be7 3307
78edd3b7 3308/* Defined in termchar.h */
28d7d09f
KL
3309struct tty_display_info;
3310
78edd3b7 3311/* Defined in termhooks.h */
6ed8eeff 3312struct terminal;
28d440ab 3313
78edd3b7 3314/* Defined in sysdep.c */
2412f586 3315#ifndef HAVE_GET_CURRENT_DIR_NAME
383e0970 3316extern char *get_current_dir_name (void);
2b94e598 3317#endif
383e0970
J
3318extern void stuff_char (char c);
3319extern void init_sigio (int);
3320extern void sys_subshell (void);
3321extern void sys_suspend (void);
3322extern void discard_tty_input (void);
3323extern void init_sys_modes (struct tty_display_info *);
3324extern void reset_sys_modes (struct tty_display_info *);
3325extern void init_all_sys_modes (void);
3326extern void reset_all_sys_modes (void);
3327extern void wait_for_termination (int);
3328extern void flush_pending_output (int);
3329extern void child_setup_tty (int);
3330extern void setup_pty (int);
3331extern int set_window_size (int, int, int);
3332extern void create_process (Lisp_Object, char **, Lisp_Object);
3333extern int emacs_open (const char *, int, int);
3334extern int emacs_close (int);
3335extern int emacs_read (int, char *, unsigned int);
3336extern int emacs_write (int, const char *, unsigned int);
72af86bd 3337#ifndef HAVE_MEMSET
6a0d6611 3338extern void *memset (void *, int, size_t);
72af86bd
AS
3339#endif
3340#ifndef HAVE_MEMCPY
6a0d6611 3341extern void *memcpy (void *, void *, size_t);
72af86bd
AS
3342#endif
3343#ifndef HAVE_MEMMOVE
6a0d6611 3344extern void *memmove (void *, void *, size_t);
72af86bd
AS
3345#endif
3346#ifndef HAVE_MEMCMP
6a0d6611 3347extern int memcmp (void *, void *, size_t);
72af86bd 3348#endif
526a2be7 3349
526a2be7 3350EXFUN (Funlock_buffer, 0);
383e0970
J
3351extern void unlock_all_files (void);
3352extern void lock_file (Lisp_Object);
3353extern void unlock_file (Lisp_Object);
3354extern void unlock_buffer (struct buffer *);
3355extern void syms_of_filelock (void);
3356extern void init_filelock (void);
15b0ced5
GM
3357
3358/* Defined in sound.c */
383e0970
J
3359extern void syms_of_sound (void);
3360extern void init_sound (void);
46abf440
AS
3361
3362/* Defined in category.c */
383e0970
J
3363extern void init_category_once (void);
3364extern Lisp_Object char_category_set (int);
3365extern void syms_of_category (void);
46abf440
AS
3366
3367/* Defined in ccl.c */
383e0970 3368extern void syms_of_ccl (void);
46abf440
AS
3369
3370/* Defined in dired.c */
6b61353c 3371EXFUN (Ffile_attributes, 2);
383e0970
J
3372extern void syms_of_dired (void);
3373extern Lisp_Object directory_files_internal (Lisp_Object, Lisp_Object,
3374 Lisp_Object, Lisp_Object,
3375 int, Lisp_Object);
46abf440 3376
46abf440 3377/* Defined in term.c */
e6cba650 3378extern int *char_ins_del_vector;
383e0970
J
3379extern void syms_of_term (void);
3380extern void fatal (const char *msgid, ...) NO_RETURN;
46abf440 3381
ed8dad6b 3382/* Defined in terminal.c */
ce5b453a 3383EXFUN (Fframe_terminal, 1);
c2e42690 3384EXFUN (Fdelete_terminal, 2);
383e0970 3385extern void syms_of_terminal (void);
ed8dad6b 3386
b86cfd28 3387/* Defined in font.c */
383e0970
J
3388extern void syms_of_font (void);
3389extern void init_font (void);
b86cfd28 3390
4f48f1ab 3391#ifdef HAVE_WINDOW_SYSTEM
46abf440 3392/* Defined in fontset.c */
383e0970 3393extern void syms_of_fontset (void);
4f48f1ab
YM
3394
3395/* Defined in xfns.c, w32fns.c, or macfns.c */
99f3388e 3396extern Lisp_Object Qfont_param;
4f48f1ab 3397EXFUN (Fxw_display_color_p, 1);
c95a5008 3398EXFUN (Fx_focus_frame, 1);
46abf440
AS
3399#endif
3400
3401/* Defined in xfaces.c */
99f3388e
DN
3402extern Lisp_Object Qdefault, Qtool_bar, Qregion, Qfringe;
3403extern Lisp_Object Qheader_line, Qscroll_bar, Qcursor, Qborder, Qmouse, Qmenu;
3404extern Lisp_Object Qmode_line_inactive, Qvertical_border;
e6cba650 3405extern Lisp_Object Qface;
89dc303e 3406extern Lisp_Object Qnormal;
0e9c8657
JB
3407extern Lisp_Object QCfamily, QCweight, QCslant;
3408extern Lisp_Object QCheight, QCname, QCwidth, QCforeground, QCbackground;
99f3388e 3409extern Lisp_Object Vface_alternative_font_family_alist;
99f3388e 3410extern Lisp_Object Vface_alternative_font_registry_alist;
8071c00f 3411EXFUN (Fclear_face_cache, 1);
86fa089e 3412EXFUN (Fx_load_color_file, 1);
383e0970 3413extern void syms_of_xfaces (void);
46abf440 3414
8890220d 3415#ifndef HAVE_GETLOADAVG
7de6c766 3416/* Defined in getloadavg.c */
383e0970 3417extern int getloadavg (double *, int);
8890220d 3418#endif
7de6c766 3419
46abf440
AS
3420#ifdef HAVE_X_WINDOWS
3421/* Defined in xfns.c */
383e0970 3422extern void syms_of_xfns (void);
46abf440 3423
e02207d4 3424/* Defined in xsmfns.c */
383e0970 3425extern void syms_of_xsmfns (void);
e02207d4 3426
46abf440 3427/* Defined in xselect.c */
383e0970 3428extern void syms_of_xselect (void);
46abf440
AS
3429
3430/* Defined in xterm.c */
383e0970 3431extern void syms_of_xterm (void);
4f48f1ab 3432#endif /* HAVE_X_WINDOWS */
4baa6f88 3433
7af07b96
AS
3434#ifdef HAVE_WINDOW_SYSTEM
3435/* Defined in xterm.c, nsterm.m, w32term.c */
3436extern char *x_get_keysym_name (int);
3437#endif /* HAVE_WINDOW_SYSTEM */
3438
b7f34997
AS
3439#ifdef MSDOS
3440/* Defined in msdos.c */
3441EXFUN (Fmsdos_downcase_filename, 1);
3442#endif
4f48f1ab 3443
381408e2
LMI
3444#ifdef HAVE_LIBXML2
3445/* Defined in xml.c */
3446extern void syms_of_xml (void);
3447#endif
3448
4d0ac3d7 3449#ifdef HAVE_MENUS
07b87a10 3450/* Defined in (x|w32)fns.c, nsfns.m... */
383e0970 3451extern int have_menus_p (void);
4d0ac3d7 3452#endif
b86cfd28
EZ
3453
3454#ifdef HAVE_DBUS
3455/* Defined in dbusbind.c */
383e0970 3456void syms_of_dbusbind (void);
b86cfd28 3457#endif
36e053eb
DN
3458
3459#ifdef DOS_NT
3460/* Defined in msdos.c, w32.c */
3461extern char *emacs_root_dir (void);
3462#endif /* DOS_NT */
83925baa 3463\f
3cfe6dfd
JB
3464/* Nonzero means Emacs has already been initialized.
3465 Used during startup to detect startup of dumped Emacs. */
3466extern int initialized;
3467
3468extern int immediate_quit; /* Nonzero means ^G can quit instantly */
3469
383e0970
J
3470extern POINTER_TYPE *xmalloc (size_t);
3471extern POINTER_TYPE *xrealloc (POINTER_TYPE *, size_t);
3472extern void xfree (POINTER_TYPE *);
074b6efe 3473
383e0970 3474extern char *xstrdup (const char *);
3cfe6dfd 3475
a8fe7202 3476extern char *egetenv (const char *);
e98227af 3477
5d6be39f 3478/* Set up the name of the machine we're running on. */
383e0970 3479extern void init_system_name (void);
881a5a80
RS
3480
3481/* Some systems (e.g., NT) use a different path separator than Unix,
087fc47a 3482 in addition to a device separator. Set the path separator
881a5a80
RS
3483 to '/', and don't test for a device separator in IS_ANY_SEP. */
3484
881a5a80 3485#define DIRECTORY_SEP '/'
881a5a80
RS
3486#ifndef IS_DIRECTORY_SEP
3487#define IS_DIRECTORY_SEP(_c_) ((_c_) == DIRECTORY_SEP)
3488#endif
3489#ifndef IS_DEVICE_SEP
3490#ifndef DEVICE_SEP
3491#define IS_DEVICE_SEP(_c_) 0
3492#else
3493#define IS_DEVICE_SEP(_c_) ((_c_) == DEVICE_SEP)
3494#endif
3495#endif
3496#ifndef IS_ANY_SEP
3497#define IS_ANY_SEP(_c_) (IS_DIRECTORY_SEP (_c_))
3498#endif
51bd4610 3499
51bd4610 3500#define SWITCH_ENUM_CAST(x) (x)
a32fa736
GM
3501
3502/* Loop over Lisp list LIST. Signal an error if LIST is not a proper
3503 list, or if it contains circles.
e2c0561e 3504
a32fa736
GM
3505 HARE and TORTOISE should be the names of Lisp_Object variables, and
3506 N should be the name of an EMACS_INT variable declared in the
3507 function where the macro is used. Each nested loop should use
3508 its own variables.
3509
3510 In the loop body, HARE is set to each cons of LIST, and N is the
3511 length of the list processed so far. */
3512
3513#define LIST_END_P(list, obj) \
3514 (NILP (obj) \
3515 ? 1 \
3516 : (CONSP (obj) \
3517 ? 0 \
d28981c9 3518 : (wrong_type_argument (Qlistp, (list))), 1))
a32fa736
GM
3519
3520#define FOREACH(hare, list, tortoise, n) \
3521 for (tortoise = hare = (list), n = 0; \
3522 !LIST_END_P (list, hare); \
3523 (hare = XCDR (hare), ++n, \
3524 ((n & 1) != 0 \
3525 ? (tortoise = XCDR (tortoise), \
3526 (EQ (hare, tortoise) \
3527 && (circular_list_error ((list)), 1))) \
3528 : 0)))
8a226de7
GM
3529
3530/* The ubiquitous min and max macros. */
3531
152180e3
AI
3532#ifdef max
3533#undef max
3534#undef min
3535#endif
8a226de7
GM
3536#define min(a, b) ((a) < (b) ? (a) : (b))
3537#define max(a, b) ((a) > (b) ? (a) : (b))
53ede3f4 3538
555b10b0
EZ
3539/* We used to use `abs', but that clashes with system headers on some
3540 platforms, and using a name reserved by Standard C is a bad idea
3541 anyway. */
3542#if !defined(eabs)
3543#define eabs(x) ((x) < 0 ? -(x) : (x))
096e8667
GM
3544#endif
3545
53ede3f4
GM
3546/* Return a fixnum or float, depending on whether VAL fits in a Lisp
3547 fixnum. */
3548
3549#define make_fixnum_or_float(val) \
d28981c9
SM
3550 (FIXNUM_OVERFLOW_P (val) \
3551 ? make_float (val) \
3552 : make_number ((EMACS_INT)(val)))
6b61353c 3553
e32d9872
MB
3554
3555/* Checks the `cycle check' variable CHECK to see if it indicates that
3556 EL is part of a cycle; CHECK must be either Qnil or a value returned
3557 by an earlier use of CYCLE_CHECK. SUSPICIOUS is the number of
3558 elements after which a cycle might be suspected; after that many
3559 elements, this macro begins consing in order to keep more precise
3560 track of elements.
3561
3562 Returns nil if a cycle was detected, otherwise a new value for CHECK
3563 that includes EL.
3564
3565 CHECK is evaluated multiple times, EL and SUSPICIOUS 0 or 1 times, so
3566 the caller should make sure that's ok. */
3567
3568#define CYCLE_CHECK(check, el, suspicious) \
3569 (NILP (check) \
3570 ? make_number (0) \
3571 : (INTEGERP (check) \
3572 ? (XFASTINT (check) < (suspicious) \
3573 ? make_number (XFASTINT (check) + 1) \
3574 : Fcons (el, Qnil)) \
3575 : (!NILP (Fmemq ((el), (check))) \
3576 ? Qnil \
3577 : Fcons ((el), (check)))))
3578
3579
79518a8d
KS
3580/* SAFE_ALLOCA normally allocates memory on the stack, but if size is
3581 larger than MAX_ALLOCA, use xmalloc to avoid overflowing the stack. */
3582
3583#define MAX_ALLOCA 16*1024
3584
3585extern Lisp_Object safe_alloca_unwind (Lisp_Object);
3586
3587#define USE_SAFE_ALLOCA \
40283062 3588 int sa_count = (int) SPECPDL_INDEX (), sa_must_free = 0
79518a8d 3589
a9e6bacc
KS
3590/* SAFE_ALLOCA allocates a simple buffer. */
3591
79518a8d
KS
3592#define SAFE_ALLOCA(buf, type, size) \
3593 do { \
3594 if ((size) < MAX_ALLOCA) \
3595 buf = (type) alloca (size); \
3596 else \
3597 { \
3598 buf = (type) xmalloc (size); \
c33188d9 3599 sa_must_free++; \
79518a8d
KS
3600 record_unwind_protect (safe_alloca_unwind, \
3601 make_save_value (buf, 0)); \
3602 } \
3603 } while (0)
3604
a9e6bacc
KS
3605/* SAFE_FREE frees xmalloced memory and enables GC as needed. */
3606
c33188d9 3607#define SAFE_FREE() \
79518a8d 3608 do { \
c33188d9
KS
3609 if (sa_must_free) { \
3610 sa_must_free = 0; \
79518a8d 3611 unbind_to (sa_count, Qnil); \
c33188d9 3612 } \
79518a8d
KS
3613 } while (0)
3614
3615
5f5d6c62
KS
3616/* SAFE_ALLOCA_LISP allocates an array of Lisp_Objects. */
3617
3618#define SAFE_ALLOCA_LISP(buf, nelt) \
3619 do { \
3620 int size_ = (nelt) * sizeof (Lisp_Object); \
3621 if (size_ < MAX_ALLOCA) \
3622 buf = (Lisp_Object *) alloca (size_); \
3623 else \
3624 { \
3625 Lisp_Object arg_; \
3626 buf = (Lisp_Object *) xmalloc (size_); \
3627 arg_ = make_save_value (buf, nelt); \
3628 XSAVE_VALUE (arg_)->dogc = 1; \
c33188d9 3629 sa_must_free++; \
5f5d6c62
KS
3630 record_unwind_protect (safe_alloca_unwind, arg_); \
3631 } \
3632 } while (0)
3633
79518a8d 3634
29208e82
TT
3635#include "globals.h"
3636
6b61353c 3637#endif /* EMACS_LISP_H */