Mercurial > emacs
changeset 302:7c3ce5b350b8
Initial revision
author | Jim Blandy <jimb@redhat.com> |
---|---|
date | Wed, 26 Jun 1991 21:34:53 +0000 |
parents | 2fb0312f83c9 |
children | f7330c156716 |
files | src/lisp.h |
diffstat | 1 files changed, 1140 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/lisp.h Wed Jun 26 21:34:53 1991 +0000 @@ -0,0 +1,1140 @@ +/* Fundamental definitions for GNU Emacs Lisp interpreter. + Copyright (C) 1985, 1986, 1987 Free Software Foundation, Inc. + +This file is part of GNU Emacs. + +GNU Emacs is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 1, or (at your option) +any later version. + +GNU Emacs is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Emacs; see the file COPYING. If not, write to +the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ + + +/* Define the fundamental Lisp data structures */ + +/* This is the set of Lisp data types */ + +enum Lisp_Type + { + /* Integer. XINT(obj) is the integer value. */ + Lisp_Int, + + /* Symbol. XSYMBOL (object) points to a struct Lisp_Symbol. */ + Lisp_Symbol, + + /* Marker (buffer ptr). XMARKER(object) points to a struct Lisp_Marker. */ + Lisp_Marker, + + /* String. XSTRING (object) points to a struct Lisp_String. + The length of the string, and its contents, are stored therein. */ + Lisp_String, + + /* Vector of Lisp objects. XVECTOR(object) points to a struct Lisp_Vector. + The length of the vector, and its contents, are stored therein. */ + Lisp_Vector, + + /* Cons. XCONS (object) points to a struct Lisp_Cons. */ + Lisp_Cons, + + /* Byte-compiled function. A vector of 4 to 6 elements which are the + arglist, bytecode-string, constant vector, stack size, + (optional) doc string, and (optional) interactive spec. */ + Lisp_Compiled, + + /* Editor buffer. XBUFFER(obj) points to a struct buffer. */ + Lisp_Buffer, + + /* Built-in function. XSUBR(obj) points to a struct Lisp_Subr + which describes how to call the function, and its documentation, + as well as pointing to the code. */ + Lisp_Subr, + + /* Internal value return by subroutines of read. + The user never sees this data type. + Its value is just a number. */ + Lisp_Internal, + + /* Forwarding pointer to an int variable. + This is allowed only in the value cell of a symbol, + and it means that the symbol's value really lives in the + specified int variable. + XINTPTR(obj) points to the int variable. */ + Lisp_Intfwd, + + /* Boolean forwarding pointer to an int variable. + This is like Lisp_Intfwd except that the ostensible + "value" of the symbol is t if the int variable is nonzero, + nil if it is zero. XINTPTR(obj) points to the int variable. */ + Lisp_Boolfwd, + + /* Object describing a connection to a subprocess. + It points to storage of type struct Lisp_Process */ + Lisp_Process, + + /* Forwarding pointer to a Lisp_Object variable. + This is allowed only in the value cell of a symbol, + and it means that the symbol's value really lives in the + specified variable. + XOBJFWD(obj) points to the Lisp_Object variable. */ + Lisp_Objfwd, + + /* Pointer to a vector-like object describing a display screen + on which Emacs can display a window hierarchy. */ + Lisp_Screen, + + /* Used when a FILE * value needs to be passed + in an argument of type Lisp_Object. + You must do *(FILE **) XPNTR(obj) to get the value. + The user will never see this data type. */ + Lisp_Internal_Stream, + + /* Used in a symbol value cell when the symbol's value is per-buffer. + The actual contents are a cons cell which starts a list like this: + (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)). + + BUFFER is the last buffer for which this symbol's value was + made up to date. + + CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's + b_local_var_alist, that being the element whose car is this variable. + Or it can be a pointer to the (CURRENT-ALIST-ELEMENT . DEFAULT-VALUE), if BUFFER + does not have an element in its alist for this variable + (that is, if BUFFER sees the default value of this variable). + + If we want to examine or set the value and BUFFER is current, + we just examine or set REALVALUE. + If BUFFER is not current, we store the current REALVALUE value into + CURRENT-ALIST-ELEMENT, then find the appropriate alist element for + the buffer now current and set up CURRENT-ALIST-ELEMENT. + Then we set REALVALUE out of that element, and store into BUFFER. + + If we are setting the variable and the current buffer does not have + an alist entry for this variable, an alist entry is created. + + Note that REALVALUE can be a forwarding pointer. + Each time it is examined or set, forwarding must be done. */ + Lisp_Buffer_Local_Value, + + /* Like Lisp_Buffer_Local_Value with one difference: + merely setting the variable while some buffer is current + does not cause that buffer to have its own local value of this variable. + Only make-local-variable does that. */ + Lisp_Some_Buffer_Local_Value, + + + /* Like Lisp_Objfwd except that value lives in a slot + in the current buffer. Value is byte index of slot within buffer */ + Lisp_Buffer_Objfwd, + + /* In symbol value cell, means var is unbound. + In symbol function cell, means function name is undefined. */ + Lisp_Void, + + /* Window used for Emacs display. + Data inside looks like a Lisp_Vector. */ + Lisp_Window, + + /* Used by save,set,restore-window-configuration */ + Lisp_Window_Configuration + +#ifdef LISP_FLOAT_TYPE + , + Lisp_Float +#endif /* LISP_FLOAT_TYPE */ + }; + +#ifndef NO_UNION_TYPE + +#ifndef BIG_ENDIAN + +/* Definition of Lisp_Object for little-endian machines. */ + +typedef +union Lisp_Object + { + /* Used for comparing two Lisp_Objects; + also, positive integers can be accessed fast this way. */ + int i; + + struct + { + int val: 24; + char type; + } s; + struct + { + unsigned int val: 24; + char type; + } u; + struct + { + unsigned int val: 24; + enum Lisp_Type type: 7; + /* The markbit is not really part of the value of a Lisp_Object, + and is always zero except during garbage collection. */ + unsigned int markbit: 1; + } gu; + } +Lisp_Object; + +#else /* If BIG_ENDIAN */ + +typedef +union Lisp_Object + { + /* Used for comparing two Lisp_Objects; + also, positive integers can be accessed fast this way. */ + int i; + + struct + { + char type; + int val: 24; + } s; + struct + { + char type; + unsigned int val: 24; + } u; + struct + { + /* The markbit is not really part of the value of a Lisp_Object, + and is always zero except during garbage collection. */ + unsigned int markbit: 1; + enum Lisp_Type type: 7; + unsigned int val: 24; + } gu; + } +Lisp_Object; + +#endif /* BIG_ENDIAN */ + +#endif /* NO_UNION_TYPE */ + + +/* If union type is not wanted, define Lisp_Object as just a number + and define the macros below to extract fields by shifting */ + +#ifdef NO_UNION_TYPE + +#define Lisp_Object int + +/* These values are overridden by the m- file on some machines. */ +#ifndef VALBITS +#define VALBITS 24 +#endif + +#ifndef GCTYPEBITS +#define GCTYPEBITS 7 +#endif + +#ifndef VALMASK +#define VALMASK ((1<<VALBITS) - 1) +#endif +#define GCTYPEMASK ((1<<GCTYPEBITS) - 1) +#define MARKBIT (1 << (VALBITS + GCTYPEBITS)) + +#endif /* NO_UNION_TYPE */ + +/* These macros extract various sorts of values from a Lisp_Object. + For example, if tem is a Lisp_Object whose type is Lisp_Cons, + XCONS (tem) is the struct Lisp_Cons * pointing to the memory for that cons. */ + +#ifdef NO_UNION_TYPE + +/* One need to override this if there must be high bits set in data space + (doing the result of the below & ((1 << (GCTYPE + 1)) - 1) would work + on all machines, but would penalise machines which don't need it) + */ +#ifndef XTYPE +#define XTYPE(a) ((enum Lisp_Type) ((a) >> VALBITS)) +#endif + +#ifndef XSETTYPE +#define XSETTYPE(a, b) ((a) = XUINT (a) | ((int)(b) << VALBITS)) +#endif + +/* Use XFASTINT for fast retrieval and storage of integers known + to be positive. This takes advantage of the fact that Lisp_Int is 0. */ +#define XFASTINT(a) (a) + +/* Extract the value of a Lisp_Object as a signed integer. */ + +#ifndef XINT /* Some machines need to do this differently. */ +#define XINT(a) (((a) << INTBITS-VALBITS) >> INTBITS-VALBITS) +#endif + +/* Extract the value as an unsigned integer. This is a basis + for extracting it as a pointer to a structure in storage. */ + +#ifndef XUINT +#define XUINT(a) ((a) & VALMASK) +#endif + +#ifndef XPNTR +#ifdef HAVE_SHM +/* In this representation, data is found in two widely separated segments. */ +#define XPNTR(a) \ + (XUINT (a) | (XUINT (a) > PURESIZE ? DATA_SEG_BITS : PURE_SEG_BITS)) +#else /* not HAVE_SHM */ +#ifdef DATA_SEG_BITS +/* This case is used for the rt-pc. + In the diffs I was given, it checked for ptr = 0 + and did not adjust it in that case. + But I don't think that zero should ever be found + in a Lisp object whose data type says it points to something. */ +#define XPNTR(a) (XUINT (a) | DATA_SEG_BITS) +#else +#define XPNTR(a) XUINT (a) +#endif +#endif /* not HAVE_SHM */ +#endif /* no XPNTR */ + +#ifndef XSETINT +#define XSETINT(a, b) ((a) = ((a) & ~VALMASK) | ((b) & VALMASK)) +#endif + +#ifndef XSETUINT +#define XSETUINT(a, b) XSETINT (a, b) +#endif + +#ifndef XSETPNTR +#define XSETPNTR(a, b) XSETINT (a, b) +#endif + +#ifndef XSET +#define XSET(var, type, ptr) \ + ((var) = ((int)(type) << VALBITS) + ((int) (ptr) & VALMASK)) +#endif + +/* During garbage collection, XGCTYPE must be used for extracting types + so that the mark bit is ignored. XMARKBIT accesses the markbit. + Markbits are used only in particular slots of particular structure types. + Other markbits are always zero. + Outside of garbage collection, all mark bits are always zero. */ + +#ifndef XGCTYPE +#define XGCTYPE(a) ((enum Lisp_Type) (((a) >> VALBITS) & GCTYPEMASK)) +#endif + +#if VALBITS + GCTYPEBITS == INTBITS - 1 +/* Make XMARKBIT faster if mark bit is sign bit. */ +#ifndef XMARKBIT +#define XMARKBIT(a) ((a) < 0) +#endif +#endif /* markbit is sign bit */ + +#ifndef XMARKBIT +#define XMARKBIT(a) ((a) & MARKBIT) +#endif + +#ifndef XSETMARKBIT +#define XSETMARKBIT(a,b) ((a) = ((a) & ~MARKBIT) | ((b) ? MARKBIT : 0)) +#endif + +#ifndef XMARK +#define XMARK(a) ((a) |= MARKBIT) +#endif + +#ifndef XUNMARK +#define XUNMARK(a) ((a) &= ~MARKBIT) +#endif + +#endif /* NO_UNION_TYPE */ + +#ifndef NO_UNION_TYPE + +#define XTYPE(a) ((enum Lisp_Type) (a).u.type) +#define XSETTYPE(a, b) ((a).u.type = (char) (b)) + +/* Use XFASTINT for fast retrieval and storage of integers known + to be positive. This takes advantage of the fact that Lisp_Int is 0. */ +#define XFASTINT(a) ((a).i) + +#ifdef EXPLICIT_SIGN_EXTEND +/* Make sure we sign-extend; compilers have been known to fail to do so. */ +#define XINT(a) (((a).i << 8) >> 8) +#else +#define XINT(a) ((a).s.val) +#endif /* EXPLICIT_SIGN_EXTEND */ + +#define XUINT(a) ((a).u.val) +#define XPNTR(a) ((a).u.val) +#define XSETINT(a, b) ((a).s.val = (int) (b)) +#define XSETUINT(a, b) ((a).s.val = (int) (b)) +#define XSETPNTR(a, b) ((a).s.val = (int) (b)) + +#define XSET(var, vartype, ptr) \ + (((var).s.type = ((char) (vartype))), ((var).s.val = ((int) (ptr)))) + +/* During garbage collection, XGCTYPE must be used for extracting types + so that the mark bit is ignored. XMARKBIT access the markbit. + Markbits are used only in particular slots of particular structure types. + Other markbits are always zero. + Outside of garbage collection, all mark bits are always zero. */ + +#define XGCTYPE(a) ((a).gu.type) +#define XMARKBIT(a) ((a).gu.markbit) +#define XSETMARKBIT(a,b) (XMARKBIT(a) = (b)) +#define XMARK(a) (XMARKBIT(a) = 1) +#define XUNMARK(a) (XMARKBIT(a) = 0) + +#endif /* NO_UNION_TYPE */ + + +#define XCONS(a) ((struct Lisp_Cons *) XPNTR(a)) +#define XBUFFER(a) ((struct buffer *) XPNTR(a)) +#define XVECTOR(a) ((struct Lisp_Vector *) XPNTR(a)) +#define XSUBR(a) ((struct Lisp_Subr *) XPNTR(a)) +#define XSTRING(a) ((struct Lisp_String *) XPNTR(a)) +#define XSYMBOL(a) ((struct Lisp_Symbol *) XPNTR(a)) +#define XFUNCTION(a) ((Lisp_Object (*)()) XPNTR(a)) +#define XMARKER(a) ((struct Lisp_Marker *) XPNTR(a)) +#define XOBJFWD(a) ((Lisp_Object *) XPNTR(a)) +#define XINTPTR(a) ((int *) XPNTR(a)) +#define XWINDOW(a) ((struct window *) XPNTR(a)) +#define XPROCESS(a) ((struct Lisp_Process *) XPNTR(a)) +#define XFLOAT(a) ((struct Lisp_Float *) XPNTR(a)) + +#define XSETCONS(a, b) XSETPNTR(a, (int) (b)) +#define XSETBUFFER(a, b) XSETPNTR(a, (int) (b)) +#define XSETVECTOR(a, b) XSETPNTR(a, (int) (b)) +#define XSETSUBR(a, b) XSETPNTR(a, (int) (b)) +#define XSETSTRING(a, b) XSETPNTR(a, (int) (b)) +#define XSETSYMBOL(a, b) XSETPNTR(a, (int) (b)) +#define XSETFUNCTION(a, b) XSETPNTR(a, (int) (b)) +#define XSETMARKER(a, b) XSETPNTR(a, (int) (b)) +#define XSETOBJFWD(a, b) XSETPNTR(a, (int) (b)) +#define XSETINTPTR(a, b) XSETPNTR(a, (int) (b)) +#define XSETWINDOW(a, b) XSETPNTR(a, (int) (b)) +#define XSETPROCESS(a, b) XSETPNTR(a, (int) (b)) +#define XSETFLOAT(a, b) XSETPNTR(a, (int) (b)) + +/* In a cons, the markbit of the car is the gc mark bit */ + +struct Lisp_Cons + { + Lisp_Object car, cdr; + }; + +/* Like a cons, but records info on where the text lives that it was read from */ +/* This is not really in use now */ + +struct Lisp_Buffer_Cons + { + Lisp_Object car, cdr; + struct buffer *buffer; + int bufpos; + }; + +/* In a string or vector, the sign bit of the `size' is the gc mark bit */ + +struct Lisp_String + { + int size; + unsigned char data[1]; + }; + +struct Lisp_Vector + { + int size; + struct Lisp_Vector *next; + Lisp_Object contents[1]; + }; + +/* In a symbol, the markbit of the plist is used as the gc mark bit */ + +struct Lisp_Symbol + { + struct Lisp_String *name; + Lisp_Object value; + Lisp_Object function; + Lisp_Object plist; + struct Lisp_Symbol *next; /* -> next symbol in this obarray bucket */ + }; + +struct Lisp_Subr + { + Lisp_Object (*function) (); + short min_args, max_args; + char *symbol_name; + char *prompt; + char *doc; + }; + +/* In a marker, the markbit of the chain field is used as the gc mark bit */ + +struct Lisp_Marker + { + struct buffer *buffer; + Lisp_Object chain; + int bufpos; + int modified; + }; + +#ifdef LISP_FLOAT_TYPE +/* Optional Lisp floating point type */ +struct Lisp_Float + { + Lisp_Object type; /* essentially used for mark-bit + and chaining when on free-list */ + double data; + }; +#endif /* LISP_FLOAT_TYPE */ + +/* A character, declared with the following typedef, is a member + of some character set associated with the current buffer. */ +typedef unsigned char UCHAR; + +/* Meanings of slots in a Lisp_Compiled: */ + +#define COMPILED_ARGLIST 0 +#define COMPILED_BYTECODE 1 +#define COMPILED_CONSTANTS 2 +#define COMPILED_STACK_DEPTH 3 +#define COMPILED_DOC_STRING 4 +#define COMPILED_INTERACTIVE 5 + +/* Data type checking */ + +#ifdef NULL +#undef NULL +#endif +#define NULL(x) (XFASTINT (x) == XFASTINT (Qnil)) + +/* #define LISTP(x) (XTYPE ((x)) == Lisp_Cons)*/ +#define CONSP(x) (XTYPE ((x)) == Lisp_Cons) +#define EQ(x, y) (XFASTINT (x) == XFASTINT (y)) + +#define CHECK_LIST(x, i) \ + { if ((XTYPE ((x)) != Lisp_Cons) && !NULL (x)) x = wrong_type_argument (Qlistp, (x)); } + +#define CHECK_STRING(x, i) \ + { if (XTYPE ((x)) != Lisp_String) x = wrong_type_argument (Qstringp, (x)); } + +#define CHECK_CONS(x, i) \ + { if (XTYPE ((x)) != Lisp_Cons) x = wrong_type_argument (Qconsp, (x)); } + +#define CHECK_SYMBOL(x, i) \ + { if (XTYPE ((x)) != Lisp_Symbol) x = wrong_type_argument (Qsymbolp, (x)); } + +#define CHECK_VECTOR(x, i) \ + { if (XTYPE ((x)) != Lisp_Vector) x = wrong_type_argument (Qvectorp, (x)); } + +#define CHECK_BUFFER(x, i) \ + { if (XTYPE ((x)) != Lisp_Buffer) x = wrong_type_argument (Qbufferp, (x)); } + +#define CHECK_WINDOW(x, i) \ + { if (XTYPE ((x)) != Lisp_Window) x = wrong_type_argument (Qwindowp, (x)); } + +#define CHECK_PROCESS(x, i) \ + { if (XTYPE ((x)) != Lisp_Process) x = wrong_type_argument (Qprocessp, (x)); } + +#define CHECK_NUMBER(x, i) \ + { if (XTYPE ((x)) != Lisp_Int) x = wrong_type_argument (Qintegerp, (x)); } + +#define CHECK_NATNUM(x, i) \ + { if (XTYPE ((x)) != Lisp_Int || XINT ((x)) < 0) \ + x = wrong_type_argument (Qnatnump, (x)); } + +#define CHECK_MARKER(x, i) \ + { if (XTYPE ((x)) != Lisp_Marker) x = wrong_type_argument (Qmarkerp, (x)); } + +#define CHECK_NUMBER_COERCE_MARKER(x, i) \ + { if (XTYPE ((x)) == Lisp_Marker) XFASTINT (x) = marker_position (x); \ + else if (XTYPE ((x)) != Lisp_Int) x = wrong_type_argument (Qinteger_or_marker_p, (x)); } + +#ifdef LISP_FLOAT_TYPE + +#ifndef DBL_DIG +#define DBL_DIG 20 +#endif + +#define XFLOATINT(n) extract_float((n)) + +#define CHECK_FLOAT(x, i) \ +{ if (XTYPE (x) != Lisp_Float) \ + x = wrong_type_argument (Qfloatp, (x)); } + +#define CHECK_NUMBER_OR_FLOAT(x, i) \ +{ if (XTYPE (x) != Lisp_Float && XTYPE (x) != Lisp_Int) \ + x = wrong_type_argument (Qinteger_or_floatp, (x)); } + +#define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER(x, i) \ +{ if (XTYPE (x) == Lisp_Marker) XFASTINT (x) = marker_position (x); \ + else if (XTYPE (x) != Lisp_Int && XTYPE (x) != Lisp_Float) \ + x = wrong_type_argument (Qinteger_or_float_or_marker_p, (x)); } + +#else /* Not LISP_FLOAT_TYPE */ + +#define CHECK_NUMBER_OR_FLOAT CHECK_NUMBER + +#define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER CHECK_NUMBER_COERCE_MARKER + +#define XFLOATINT(n) XINT((n)) +#endif /* LISP_FLOAT_TYPE */ + +#ifdef VIRT_ADDR_VARIES + +/* For machines like APOLLO where text and data can go anywhere + in virtual memory. */ +#define CHECK_IMPURE(obj) \ + { extern int pure[]; \ + if ((PNTR_COMPARISON_TYPE) XPNTR (obj) < (PNTR_COMPARISON_TYPE) ((char *) pure + PURESIZE) \ + && (PNTR_COMPARISON_TYPE) XPNTR (obj) >= (PNTR_COMPARISON_TYPE) pure) \ + pure_write_error (); } + +#else /* not VIRT_ADDR_VARIES */ +#ifdef PNTR_COMPARISON_TYPE + +/* when PNTR_COMPARISON_TYPE is not the default (unsigned int) */ +#define CHECK_IMPURE(obj) \ + { extern int my_edata; \ + if ((PNTR_COMPARISON_TYPE) XPNTR (obj) < (PNTR_COMPARISON_TYPE) &my_edata) \ + pure_write_error (); } + +#else /* not VIRT_ADDRESS_VARIES, not PNTR_COMPARISON_TYPE */ + +#define CHECK_IMPURE(obj) \ + { extern int my_edata; \ + if (XPNTR (obj) < (unsigned int) &my_edata) \ + pure_write_error (); } + +#endif /* PNTR_COMPARISON_TYPE */ +#endif /* VIRT_ADDRESS_VARIES */ + +/* Cast pointers to this type to compare them. Some machines want int. */ +#ifndef PNTR_COMPARISON_TYPE +#define PNTR_COMPARISON_TYPE unsigned int +#endif + +/* Define a built-in function for calling from Lisp. + `lname' should be the name to give the function in Lisp, + as a null-terminated C string. + `fnname' should be the name of the function in C. + By convention, it starts with F. + `sname' should be the name for the C constant structure + that records information on this function for internal use. + By convention, it should be the same as `fnname' but with S instead of F. + It's too bad that C macros can't compute this from `fnname'. + `minargs' should be a number, the minimum number of arguments allowed. + `maxargs' should be a number, the maximum number of arguments allowed, + or else MANY or UNEVALLED. + MANY means pass a vector of evaluated arguments, + in the form of an integer number-of-arguments + followed by the address of a vector of Lisp_Objects + which contains the argument values. + UNEVALLED means pass the list of unevaluated arguments + `prompt' says how to read arguments for an interactive call. + This can be zero or a C string. + Zero means that interactive calls are not allowed. + A string is interpreted in a hairy way: + it should contain one line for each argument to be read, terminated by \n. + The first character of the line controls the type of parsing: + s -- read a string. + S -- read a symbol. + k -- read a key sequence and return it as a string. + a -- read a function name (symbol) with completion. + C -- read a command name (symbol) with completion. + v -- read a variable name (symbol) with completion. + b -- read a buffer name (a string) with completion. + B -- buffer name, may be existing buffer or may not be. + f -- read a file name, file must exist. + F -- read a file name, file need not exist. + n -- read a number. + c -- read a character and return it as a number. + p -- use the numeric value of the prefix argument. + P -- use raw value of prefix - can be nil, -, (NUMBER) or NUMBER. + x -- read a Lisp object from the minibuffer. + X -- read a Lisp form from the minibuffer and use its value. + A null string means call interactively with no arguments. + `doc' is documentation for the user. +*/ + +#define DEFUN(lname, fnname, sname, minargs, maxargs, prompt, doc) \ + Lisp_Object fnname (); \ + struct Lisp_Subr sname = {fnname, minargs, maxargs, lname, prompt, 0}; \ + Lisp_Object fnname + +/* defsubr (Sname); + is how we define the symbol for function `name' at start-up time. */ +extern void defsubr (); + +#define MANY -2 +#define UNEVALLED -1 + +extern void defvar_lisp (); +extern void defvar_bool (); +extern void defvar_int (); + +/* Macros we use to define forwarded Lisp variables. + These are used in the syms_of_FILENAME functions. */ + +#define DEFVARLISP(lname, vname, doc) defvar_lisp (lname, vname) +#define DEFVARBOOL(lname, vname, doc) defvar_bool (lname, vname) +#define DEFVARINT(lname, vname, doc) defvar_int (lname, vname) +#define DEFVARPERBUFFER(lname, vname, doc) \ + defvar_per_buffer (lname, vname) + +#define DEFVAR_LISP(lname, vname, doc) defvar_lisp (lname, vname) +#define DEFVAR_LISP_NOPRO(lname, vname, doc) defvar_lisp_nopro (lname, vname) +#define DEFVAR_BOOL(lname, vname, doc) defvar_bool (lname, vname) +#define DEFVAR_INT(lname, vname, doc) defvar_int (lname, vname) +#define DEFVAR_PER_BUFFER(lname, vname, doc) \ + defvar_per_buffer (lname, vname) + +/* Structure for recording Lisp call stack for backtrace purposes */ + +struct specbinding + { + Lisp_Object symbol, old_value; + Lisp_Object (*func) (); + Lisp_Object unused; /* Dividing by 16 is faster than by 12 */ + }; + +extern struct specbinding *specpdl; +extern struct specbinding *specpdl_ptr; +extern int specpdl_size; + +struct handler + { + Lisp_Object handler; + Lisp_Object var; + int poll_suppress_count; /* No error should exit a piece of code + in which polling is suppressed. */ + struct catchtag *tag; + struct handler *next; + }; + +extern struct handler *handlerlist; + +extern struct catchtag *catchlist; +extern struct backtrace *backtrace_list; + +/* An address near the bottom of the stack. + Tells GC how to save a copy of the stack. */ +extern char *stack_bottom; + +/* Check quit-flag and quit if it is non-nil. */ + +#define QUIT \ + if (!NULL (Vquit_flag) && NULL (Vinhibit_quit)) \ + { Vquit_flag = Qnil; Fsignal (Qquit, Qnil); } + +/* Nonzero if ought to quit now. */ + +#define QUITP (!NULL (Vquit_flag) && NULL (Vinhibit_quit)) + +/* 1 if CH is upper case. */ + +#define UPPERCASEP(CH) (XSTRING (current_buffer->downcase_table)->data[CH] != (CH)) + +/* 1 if CH is lower case. */ + +#define LOWERCASEP(CH) \ + (!UPPERCASEP (CH) && XSTRING (current_buffer->upcase_table)->data[CH] != (CH)) + +/* 1 if CH is neither upper nor lower case. */ + +#define NOCASEP(CH) (XSTRING (current_buffer->upcase_table)->data[CH] == (CH)) + +/* Upcase a character, or make no change if that cannot be done. */ + +#define UPCASE(CH) (XSTRING (current_buffer->downcase_table)->data[CH] == (CH) \ + ? UPCASE1 (CH) : (CH)) + +/* Upcase a character known to be not upper case. */ + +#define UPCASE1(CH) (XSTRING (current_buffer->upcase_table)->data[CH]) + +/* Downcase a character, or make no change if that cannot be done. */ + +#define DOWNCASE(CH) (XSTRING (current_buffer->downcase_table)->data[CH]) + +/* Current buffer's map from characters to lower-case characters. */ + +#define DOWNCASE_TABLE XSTRING (current_buffer->downcase_table)->data + +/* Table mapping each char to the next char with the same lowercase version. + This mapping is a no-op only for characters that don't have case. */ +#define UPCASE_TABLE XSTRING (current_buffer->upcase_table)->data + +extern Lisp_Object Vascii_downcase_table, Vascii_upcase_table; + +/* number of bytes of structure consed since last GC */ + +extern int consing_since_gc; + +/* threshold for doing another gc */ + +extern int gc_cons_threshold; + +/* Structure for recording stack slots that need marking */ + +/* This is a chain of structures, each of which points at a Lisp_Object variable + whose value should be marked in garbage collection. + Normally every link of the chain is an automatic variable of a function, + and its `val' points to some argument or local variable of the function. + On exit to the function, the chain is set back to the value it had on entry. + This way, no link remains in the chain when the stack frame containing the link disappears. + + Every function that can call Feval must protect in this fashion all + Lisp_Object variables whose contents will be used again. */ + +extern struct gcpro *gcprolist; + +struct gcpro + { + struct gcpro *next; + Lisp_Object *var; /* Address of first protected variable */ + int nvars; /* Number of consecutive protected variables */ + }; + +#define GCPRO1(varname) \ + {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \ + gcprolist = &gcpro1; } + +#define GCPRO2(varname1, varname2) \ + {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ + gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ + gcprolist = &gcpro2; } + +#define GCPRO3(varname1, varname2, varname3) \ + {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ + gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ + gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ + gcprolist = &gcpro3; } + +#define GCPRO4(varname1, varname2, varname3, varname4) \ + {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ + gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ + gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ + gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ + gcprolist = &gcpro4; } + +/* Call staticpro (&var) to protect static variable `var'. */ + +void staticpro(); + +#define UNGCPRO (gcprolist = gcpro1.next) + +/* Evaluate expr, UNGCPRO, and then return the value of expr. */ +#define RETURN_UNGCPRO(expr) \ + do \ + { \ + Lisp_Object ret_ungc_val; \ + ret_ungc_val = (expr); \ + UNGCPRO; \ + return ret_ungc_val; \ + } \ + while (0) + +/* Defined in data.c */ +extern Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound; +extern Lisp_Object Qerror_conditions, Qerror_message, Qtop_level; +extern Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range; +extern Lisp_Object Qvoid_variable, Qvoid_function; +extern Lisp_Object Qsetting_constant, Qinvalid_read_syntax; +extern Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch; +extern Lisp_Object Qend_of_file, Qarith_error; +extern Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only; + +extern Lisp_Object Qintegerp, Qnatnump, Qsymbolp, Qlistp, Qconsp; +extern Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp; +extern Lisp_Object Qchar_or_string_p, Qmarkerp, Qvectorp; +extern Lisp_Object Qinteger_or_marker_p, Qboundp, Qfboundp; +extern Lisp_Object Qcdr; + +#ifdef LISP_FLOAT_TYPE +extern Lisp_Object Qfloatp, Qinteger_or_floatp, Qinteger_or_float_or_marker_p; +#endif /* LISP_FLOAT_TYPE */ + +extern Lisp_Object Qscreenp; + +extern Lisp_Object Feq (), Fnull (), Flistp (), Fconsp (), Fatom (), Fnlistp (); +extern Lisp_Object Fintegerp (), Fnatnump (), Fsymbolp (); +extern Lisp_Object Fvectorp (), Fstringp (), Farrayp (), Fsequencep (); +extern Lisp_Object Fbufferp (), Fmarkerp (), Fsubrp (), Fchar_or_string_p (); +extern Lisp_Object Finteger_or_marker_p (); +#ifdef LISP_FLOAT_TYPE +extern Lisp_Object Ffloatp(), Finteger_or_floatp(); +extern Lisp_Object Finteger_or_float_or_marker_p(), Ftruncate(); +#endif /* LISP_FLOAT_TYPE */ + +extern Lisp_Object Fcar (), Fcar_safe(), Fcdr (), Fcdr_safe(); +extern Lisp_Object Fsetcar (), Fsetcdr (); +extern Lisp_Object Fboundp (), Ffboundp (), Fmakunbound (), Ffmakunbound (); +extern Lisp_Object Fsymbol_function (), Fsymbol_plist (), Fsymbol_name (); +extern Lisp_Object Ffset (), Fsetplist (); +extern Lisp_Object Fsymbol_value (), Fset (); +extern Lisp_Object Fdefault_value (), Fset_default (); + +extern Lisp_Object Faref (), Faset (), Farray_length (); + +extern Lisp_Object Fstring_to_int (), Fint_to_string (); +extern Lisp_Object Feqlsign (), Fgtr (), Flss (), Fgeq (), Fleq (), Fneq (), Fzerop (); +extern Lisp_Object Fplus (), Fminus (), Ftimes (), Fquo (), Frem (), Fmax (), Fmin (); +extern Lisp_Object Flogand (), Flogior (), Flogxor (), Flognot (), Flsh (), Fash (); +extern Lisp_Object Fadd1 (), Fsub1 (); + +extern Lisp_Object make_number (); +extern void args_out_of_range (); +extern void args_out_of_range_3 (); +extern Lisp_Object wrong_type_argument (); +#ifdef LISP_FLOAT_TYPE +extern Lisp_Object Ffloat_to_int(), Fint_to_float(); +extern double extract_float(); +#endif /* LISP_FLOAT_TYPE */ + +/* Defined in fns.c */ +extern Lisp_Object Qstring_lessp; +extern Lisp_Object Vfeatures; +extern Lisp_Object Fidentity (), Frandom (); +extern Lisp_Object Flength (); +extern Lisp_Object Fappend (), Fconcat (), Fvconcat (), Fcopy_sequence (); +extern Lisp_Object Fsubstring (); +extern Lisp_Object Fnthcdr (), Fmemq (), Fassq (), Fassoc (); +extern Lisp_Object Frassq (), Fdelq (), Fsort (); +extern Lisp_Object Freverse (), Fnreverse (), Fget (), Fput (), Fequal (); +extern Lisp_Object Ffillarray (), Fnconc (), Fmapcar (), Fmapconcat (); +extern Lisp_Object Fy_or_n_p (), do_yes_or_no_p (); +extern Lisp_Object Ffeaturep (), Frequire () , Fprovide (); +extern Lisp_Object concat2 (), nconc2 (); +extern Lisp_Object assq_no_quit (); + +/* Defined in alloc.c */ +extern Lisp_Object Vpurify_flag; +extern Lisp_Object Fcons (), Flist(), Fmake_list (); +extern Lisp_Object Fmake_vector (), Fvector (), Fmake_symbol (), Fmake_marker (); +extern Lisp_Object Fmake_string (), build_string (), make_string (); +extern Lisp_Object make_uninit_string (); +extern Lisp_Object Fpurecopy (), make_pure_string (); +extern Lisp_Object pure_cons (), make_pure_vector (); +extern Lisp_Object Fgarbage_collect (); + +/* Defined in print.c */ +extern Lisp_Object Vprin1_to_string_buffer; +extern Lisp_Object Fprin1 (), Fprin1_to_string (), Fprinc (); +extern Lisp_Object Fterpri (), Fprint (); +extern Lisp_Object Vstandard_output, Qstandard_output; +extern void temp_output_buffer_setup (), temp_output_buffer_show (); +extern int print_level, print_escape_newlines; +extern Lisp_Object Qprint_escape_newlines; + +/* Defined in lread.c */ +extern Lisp_Object Qvariable_documentation, Qstandard_input; +extern Lisp_Object Vobarray, Vstandard_input; +extern Lisp_Object Fread (), Fread_from_string (); +extern Lisp_Object Fintern (), Fintern_soft (), Fload (); +extern Lisp_Object Fget_file_char (), Fread_char (); +extern Lisp_Object Feval_current_buffer (), Feval_region (); +extern Lisp_Object intern (), oblookup (); + +/* Defined in eval.c */ +extern Lisp_Object Qautoload, Qexit, Qinteractive, Qcommandp, Qdefun, Qmacro; +extern Lisp_Object Vinhibit_quit, Vquit_flag; +extern Lisp_Object Vmocklisp_arguments, Qmocklisp, Qmocklisp_arguments; +extern Lisp_Object Vautoload_queue; +extern Lisp_Object Vrun_hooks; +extern Lisp_Object Fand (), For (), Fif (), Fprogn (), Fprog1 (), Fprog2 (); +extern Lisp_Object Fsetq (), Fquote (); +extern Lisp_Object Fuser_variable_p (), Finteractive_p (); +extern Lisp_Object Fdefun (), Flet (), FletX (), Fwhile (); +extern Lisp_Object Fcatch (), Fthrow (), Funwind_protect (); +extern Lisp_Object Fcondition_case (), Fsignal (); +extern Lisp_Object Ffunction_type (), Fautoload (), Fcommandp (); +extern Lisp_Object Feval (), Fapply (), Ffuncall (); +extern Lisp_Object Fglobal_set (), Fglobal_value (), Fbacktrace (); +extern Lisp_Object apply1 (), call0 (), call1 (), call2 (), call3 (); +extern Lisp_Object apply_lambda (); +extern Lisp_Object internal_catch (); +extern Lisp_Object internal_condition_case (); +extern Lisp_Object unbind_to (); +extern void error (); +extern Lisp_Object un_autoload (); + +/* Defined in editfns.c */ +extern Lisp_Object Vprefix_arg, Qminus, Vcurrent_prefix_arg; +extern Lisp_Object Fgoto_char (); +extern Lisp_Object Fpoint_min_marker (), Fpoint_max_marker (); +extern Lisp_Object Fpoint_min (), Fpoint_max (); +extern Lisp_Object Fpoint (), Fpoint_marker (), Fmark_marker (); +extern Lisp_Object Ffollchar (), Fprevchar (), Fchar_after (), Finsert (); +extern Lisp_Object Feolp (), Feobp (), Fbolp (), Fbobp (); +extern Lisp_Object Fformat (), format1 (); +extern Lisp_Object Fbuffer_substring (), Fbuffer_string (); +extern Lisp_Object Fstring_equal (), Fstring_lessp (), Fbuffer_substring_lessp (); +extern Lisp_Object save_excursion_save (), save_restriction_save (); +extern Lisp_Object save_excursion_restore (), save_restriction_restore (); +extern Lisp_Object Fchar_to_string (); + +/* defined in buffer.c */ +extern Lisp_Object Vbuffer_alist; +extern Lisp_Object Fget_buffer (), Fget_buffer_create (), Fset_buffer (); +extern Lisp_Object Fbarf_if_buffer_read_only (); +extern Lisp_Object Fcurrent_buffer (), Fswitch_to_buffer (), Fpop_to_buffer (); +extern Lisp_Object Fother_buffer (); +extern struct buffer *all_buffers; + +/* defined in marker.c */ + +extern Lisp_Object Fmarker_position (), Fmarker_buffer (); +extern Lisp_Object Fcopy_marker (); + +/* Defined in fileio.c */ + +extern Lisp_Object Qfile_error; +extern Lisp_Object Ffile_name_as_directory (); +extern Lisp_Object Fexpand_file_name (), Ffile_name_nondirectory (); +extern Lisp_Object Fsubstitute_in_file_name (); +extern Lisp_Object Ffile_symlink_p (); + +/* Defined in abbrev.c */ + +extern Lisp_Object Vfundamental_mode_abbrev_table; + +/* defined in search.c */ +extern Lisp_Object Fstring_match (); +extern Lisp_Object Fscan_buffer (); + +/* defined in minibuf.c */ + +extern Lisp_Object last_minibuf_string; +extern Lisp_Object read_minibuf (), Fcompleting_read (); +extern Lisp_Object Fread_from_minibuffer (); +extern Lisp_Object Fread_variable (), Fread_buffer (), Fread_key_sequence (); +extern Lisp_Object Fread_minibuffer (), Feval_minibuffer (); +extern Lisp_Object Fread_string (), Fread_file_name (); +extern Lisp_Object Fread_no_blanks_input (); + +/* Defined in callint.c */ + +extern Lisp_Object Vcommand_history; +extern Lisp_Object Qcall_interactively; +extern Lisp_Object Fcall_interactively (); +extern Lisp_Object Fprefix_numeric_value (); + +/* defined in casefiddle.c */ + +extern Lisp_Object Fdowncase (), Fupcase (), Fcapitalize (); + +/* defined in keyboard.c */ + +extern Lisp_Object Qdisabled; +extern Lisp_Object Vhelp_form, Vtop_level; +extern Lisp_Object Fdiscard_input (), Frecursive_edit (); +extern Lisp_Object Fcommand_execute (), Finput_pending_p (); +extern int num_input_chars; +extern int poll_suppress_count; + +/* defined in keymap.c */ + +extern Lisp_Object Qkeymap; +extern Lisp_Object current_global_map; +extern Lisp_Object Fkey_description (), Fsingle_key_description (); +extern Lisp_Object Fwhere_is_internal (); +extern Lisp_Object access_keymap (), store_in_keymap (); +extern Lisp_Object get_keyelt (), get_keymap(); + +/* defined in indent.c */ +extern Lisp_Object Fvertical_motion (), Findent_to (), Fcurrent_column (); + +/* defined in window.c */ +extern Lisp_Object Qwindowp; +extern Lisp_Object Fget_buffer_window (); +extern Lisp_Object Fsave_window_excursion (); +extern Lisp_Object Fset_window_configuration (), Fcurrent_window_configuration (); + +/* defined in screen.c */ +extern Lisp_Object Fscreenp (); +extern Lisp_Object Fselect_screen (); +extern Lisp_Object Ffocus_screen (); +extern Lisp_Object Funfocus_screen (); +extern Lisp_Object Fselected_screen (); +extern Lisp_Object Fwindow_screen (); +extern Lisp_Object Fscreen_root_window (); +extern Lisp_Object Fscreen_selected_window (); +extern Lisp_Object Fscreen_list (); +extern Lisp_Object Fnext_screen (); +extern Lisp_Object Fdelete_screen (); +extern Lisp_Object Fread_mouse_position (); +extern Lisp_Object Fset_mouse_position (); +extern Lisp_Object Fmake_screen_visible (); +extern Lisp_Object Fmake_screen_invisible (); +extern Lisp_Object Ficonify_screen (); +extern Lisp_Object Fdeiconify_screen (); +extern Lisp_Object Fscreen_visible_p (); +extern Lisp_Object Fvisible_screen_list (); +extern Lisp_Object Fscreen_parameters (); +extern Lisp_Object Fmodify_screen_parameters (); +extern Lisp_Object Fscreen_pixel_size (); +extern Lisp_Object Fscreen_height (); +extern Lisp_Object Fscreen_width (); +extern Lisp_Object Fset_screen_height (); +extern Lisp_Object Fset_screen_width (); +extern Lisp_Object Fset_screen_size (); +extern Lisp_Object Fset_screen_position (); +extern Lisp_Object Fcoordinates_in_window_p (); +extern Lisp_Object Flocate_window_from_coordinates (); +#ifndef HAVE_X11 +extern Lisp_Object Frubber_band_rectangle (); +#endif /* HAVE_X11 */ + +/* defined in emacs.c */ +extern Lisp_Object decode_env_path (); +/* Nonzero means don't do interactive redisplay and don't change tty modes */ +extern int noninteractive; +/* Nonzero means don't do use window-system-specific display code */ +extern int inhibit_window_system; + +/* defined in process.c */ +extern Lisp_Object Fget_process (), Fget_buffer_process (), Fprocessp (); +extern Lisp_Object Fprocess_status (), Fkill_process (); + +/* defined in callproc.c */ +extern Lisp_Object Vexec_path, Vexec_directory; + +#ifdef MAINTAIN_ENVIRONMENT +/* defined in environ.c */ +extern int size_of_current_environ (); +extern void get_current_environ (); +/* extern void current_environ (); */ +extern Lisp_Object Fgetenv (); +#endif /* MAINTAIN_ENVIRONMENT */ + +/* defined in doc.c */ +extern Lisp_Object Vdoc_file_name; +extern Lisp_Object Fsubstitute_command_keys (); +extern Lisp_Object Fdocumentation (), Fdocumentation_property (); + +/* defined in bytecode.c */ +extern Lisp_Object Qbytecode; + +/* defined in macros.c */ +extern Lisp_Object Qexecute_kbd_macro; +extern Lisp_Object Fexecute_kbd_macro (); + +/* Nonzero means Emacs has already been initialized. + Used during startup to detect startup of dumped Emacs. */ +extern int initialized; + +extern int immediate_quit; /* Nonzero means ^G can quit instantly */ + +extern void debugger (); + +extern char *malloc (), *realloc (), *getenv (), *ctime (), *getwd (); +extern long *xmalloc (), *xrealloc (); + +#ifdef MAINTAIN_ENVIRONMENT +extern unsigned char *egetenv (); +#else +#define egetenv getenv +#endif