1 /* Lisp parsing and input streams.
3 Copyright (C) 1985-1989, 1993-1995, 1997-2013 Free Software Foundation,
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
24 #include <sys/types.h>
28 #include <limits.h> /* For CHAR_BIT. */
29 #include <stat-time.h>
31 #include "intervals.h"
32 #include "character.h"
40 #include "termhooks.h"
41 #include "blockinput.h"
55 #endif /* HAVE_SETLOCALE */
60 #define file_offset off_t
61 #define file_tell ftello
63 #define file_offset long
64 #define file_tell ftell
67 /* Hash table read constants. */
68 static Lisp_Object Qhash_table
, Qdata
;
69 static Lisp_Object Qtest
, Qsize
;
70 static Lisp_Object Qweakness
;
71 static Lisp_Object Qrehash_size
;
72 static Lisp_Object Qrehash_threshold
;
74 static Lisp_Object Qread_char
, Qget_file_char
, Qcurrent_load_list
;
75 Lisp_Object Qstandard_input
;
76 Lisp_Object Qvariable_documentation
;
77 static Lisp_Object Qascii_character
, Qload
, Qload_file_name
;
78 Lisp_Object Qbackquote
, Qcomma
, Qcomma_at
, Qcomma_dot
, Qfunction
;
79 static Lisp_Object Qinhibit_file_name_operation
;
80 static Lisp_Object Qeval_buffer_list
;
81 Lisp_Object Qlexical_binding
;
82 static Lisp_Object Qfile_truename
, Qdo_after_load_evaluation
; /* ACM 2006/5/16 */
84 /* Used instead of Qget_file_char while loading *.elc files compiled
85 by Emacs 21 or older. */
86 static Lisp_Object Qget_emacs_mule_file_char
;
88 static Lisp_Object Qload_force_doc_strings
;
90 static Lisp_Object Qload_in_progress
;
92 /* The association list of objects read with the #n=object form.
93 Each member of the list has the form (n . object), and is used to
94 look up the object for the corresponding #n# construct.
95 It must be set to nil before all top-level calls to read0. */
96 static Lisp_Object read_objects
;
98 /* File for get_file_char to read from. Use by load. */
99 static FILE *instream
;
101 /* For use within read-from-string (this reader is non-reentrant!!) */
102 static ptrdiff_t read_from_string_index
;
103 static ptrdiff_t read_from_string_index_byte
;
104 static ptrdiff_t read_from_string_limit
;
106 /* Number of characters read in the current call to Fread or
107 Fread_from_string. */
108 static EMACS_INT readchar_count
;
110 /* This contains the last string skipped with #@. */
111 static char *saved_doc_string
;
112 /* Length of buffer allocated in saved_doc_string. */
113 static ptrdiff_t saved_doc_string_size
;
114 /* Length of actual data in saved_doc_string. */
115 static ptrdiff_t saved_doc_string_length
;
116 /* This is the file position that string came from. */
117 static file_offset saved_doc_string_position
;
119 /* This contains the previous string skipped with #@.
120 We copy it from saved_doc_string when a new string
121 is put in saved_doc_string. */
122 static char *prev_saved_doc_string
;
123 /* Length of buffer allocated in prev_saved_doc_string. */
124 static ptrdiff_t prev_saved_doc_string_size
;
125 /* Length of actual data in prev_saved_doc_string. */
126 static ptrdiff_t prev_saved_doc_string_length
;
127 /* This is the file position that string came from. */
128 static file_offset prev_saved_doc_string_position
;
130 /* True means inside a new-style backquote
131 with no surrounding parentheses.
132 Fread initializes this to false, so we need not specbind it
133 or worry about what happens to it when there is an error. */
134 static bool new_backquote_flag
;
135 static Lisp_Object Qold_style_backquotes
;
137 /* A list of file names for files being loaded in Fload. Used to
138 check for recursive loads. */
140 static Lisp_Object Vloads_in_progress
;
142 static int read_emacs_mule_char (int, int (*) (int, Lisp_Object
),
145 static void readevalloop (Lisp_Object
, FILE *, Lisp_Object
, bool,
146 Lisp_Object
, Lisp_Object
,
147 Lisp_Object
, Lisp_Object
);
149 /* Functions that read one byte from the current source READCHARFUN
150 or unreads one byte. If the integer argument C is -1, it returns
151 one read byte, or -1 when there's no more byte in the source. If C
152 is 0 or positive, it unreads C, and the return value is not
155 static int readbyte_for_lambda (int, Lisp_Object
);
156 static int readbyte_from_file (int, Lisp_Object
);
157 static int readbyte_from_string (int, Lisp_Object
);
159 /* Handle unreading and rereading of characters.
160 Write READCHAR to read a character,
161 UNREAD(c) to unread c to be read again.
163 These macros correctly read/unread multibyte characters. */
165 #define READCHAR readchar (readcharfun, NULL)
166 #define UNREAD(c) unreadchar (readcharfun, c)
168 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
169 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
171 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
172 Qlambda, or a cons, we use this to keep an unread character because
173 a file stream can't handle multibyte-char unreading. The value -1
174 means that there's no unread character. */
175 static int unread_char
;
178 readchar (Lisp_Object readcharfun
, bool *multibyte
)
182 int (*readbyte
) (int, Lisp_Object
);
183 unsigned char buf
[MAX_MULTIBYTE_LENGTH
];
185 bool emacs_mule_encoding
= 0;
192 if (BUFFERP (readcharfun
))
194 register struct buffer
*inbuffer
= XBUFFER (readcharfun
);
196 ptrdiff_t pt_byte
= BUF_PT_BYTE (inbuffer
);
198 if (! BUFFER_LIVE_P (inbuffer
))
201 if (pt_byte
>= BUF_ZV_BYTE (inbuffer
))
204 if (! NILP (BVAR (inbuffer
, enable_multibyte_characters
)))
206 /* Fetch the character code from the buffer. */
207 unsigned char *p
= BUF_BYTE_ADDRESS (inbuffer
, pt_byte
);
208 BUF_INC_POS (inbuffer
, pt_byte
);
215 c
= BUF_FETCH_BYTE (inbuffer
, pt_byte
);
216 if (! ASCII_BYTE_P (c
))
217 c
= BYTE8_TO_CHAR (c
);
220 SET_BUF_PT_BOTH (inbuffer
, BUF_PT (inbuffer
) + 1, pt_byte
);
224 if (MARKERP (readcharfun
))
226 register struct buffer
*inbuffer
= XMARKER (readcharfun
)->buffer
;
228 ptrdiff_t bytepos
= marker_byte_position (readcharfun
);
230 if (bytepos
>= BUF_ZV_BYTE (inbuffer
))
233 if (! NILP (BVAR (inbuffer
, enable_multibyte_characters
)))
235 /* Fetch the character code from the buffer. */
236 unsigned char *p
= BUF_BYTE_ADDRESS (inbuffer
, bytepos
);
237 BUF_INC_POS (inbuffer
, bytepos
);
244 c
= BUF_FETCH_BYTE (inbuffer
, bytepos
);
245 if (! ASCII_BYTE_P (c
))
246 c
= BYTE8_TO_CHAR (c
);
250 XMARKER (readcharfun
)->bytepos
= bytepos
;
251 XMARKER (readcharfun
)->charpos
++;
256 if (EQ (readcharfun
, Qlambda
))
258 readbyte
= readbyte_for_lambda
;
262 if (EQ (readcharfun
, Qget_file_char
))
264 readbyte
= readbyte_from_file
;
268 if (STRINGP (readcharfun
))
270 if (read_from_string_index
>= read_from_string_limit
)
272 else if (STRING_MULTIBYTE (readcharfun
))
276 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, readcharfun
,
277 read_from_string_index
,
278 read_from_string_index_byte
);
282 c
= SREF (readcharfun
, read_from_string_index_byte
);
283 read_from_string_index
++;
284 read_from_string_index_byte
++;
289 if (CONSP (readcharfun
))
291 /* This is the case that read_vector is reading from a unibyte
292 string that contains a byte sequence previously skipped
293 because of #@NUMBER. The car part of readcharfun is that
294 string, and the cdr part is a value of readcharfun given to
296 readbyte
= readbyte_from_string
;
297 if (EQ (XCDR (readcharfun
), Qget_emacs_mule_file_char
))
298 emacs_mule_encoding
= 1;
302 if (EQ (readcharfun
, Qget_emacs_mule_file_char
))
304 readbyte
= readbyte_from_file
;
305 emacs_mule_encoding
= 1;
309 tem
= call0 (readcharfun
);
316 if (unread_char
>= 0)
322 c
= (*readbyte
) (-1, readcharfun
);
327 if (ASCII_BYTE_P (c
))
329 if (emacs_mule_encoding
)
330 return read_emacs_mule_char (c
, readbyte
, readcharfun
);
333 len
= BYTES_BY_CHAR_HEAD (c
);
336 c
= (*readbyte
) (-1, readcharfun
);
337 if (c
< 0 || ! TRAILING_CODE_P (c
))
340 (*readbyte
) (buf
[i
], readcharfun
);
341 return BYTE8_TO_CHAR (buf
[0]);
345 return STRING_CHAR (buf
);
348 #define FROM_FILE_P(readcharfun) \
349 (EQ (readcharfun, Qget_file_char) \
350 || EQ (readcharfun, Qget_emacs_mule_file_char))
353 skip_dyn_bytes (Lisp_Object readcharfun
, ptrdiff_t n
)
355 if (FROM_FILE_P (readcharfun
))
357 block_input (); /* FIXME: Not sure if it's needed. */
358 fseek (instream
, n
, SEEK_CUR
);
362 { /* We're not reading directly from a file. In that case, it's difficult
363 to reliably count bytes, since these are usually meant for the file's
364 encoding, whereas we're now typically in the internal encoding.
365 But luckily, skip_dyn_bytes is used to skip over a single
366 dynamic-docstring (or dynamic byte-code) which is always quoted such
367 that \037 is the final char. */
371 } while (c
>= 0 && c
!= '\037');
376 skip_dyn_eof (Lisp_Object readcharfun
)
378 if (FROM_FILE_P (readcharfun
))
380 block_input (); /* FIXME: Not sure if it's needed. */
381 fseek (instream
, 0, SEEK_END
);
385 while (READCHAR
>= 0);
388 /* Unread the character C in the way appropriate for the stream READCHARFUN.
389 If the stream is a user function, call it with the char as argument. */
392 unreadchar (Lisp_Object readcharfun
, int c
)
396 /* Don't back up the pointer if we're unreading the end-of-input mark,
397 since readchar didn't advance it when we read it. */
399 else if (BUFFERP (readcharfun
))
401 struct buffer
*b
= XBUFFER (readcharfun
);
402 ptrdiff_t charpos
= BUF_PT (b
);
403 ptrdiff_t bytepos
= BUF_PT_BYTE (b
);
405 if (! NILP (BVAR (b
, enable_multibyte_characters
)))
406 BUF_DEC_POS (b
, bytepos
);
410 SET_BUF_PT_BOTH (b
, charpos
- 1, bytepos
);
412 else if (MARKERP (readcharfun
))
414 struct buffer
*b
= XMARKER (readcharfun
)->buffer
;
415 ptrdiff_t bytepos
= XMARKER (readcharfun
)->bytepos
;
417 XMARKER (readcharfun
)->charpos
--;
418 if (! NILP (BVAR (b
, enable_multibyte_characters
)))
419 BUF_DEC_POS (b
, bytepos
);
423 XMARKER (readcharfun
)->bytepos
= bytepos
;
425 else if (STRINGP (readcharfun
))
427 read_from_string_index
--;
428 read_from_string_index_byte
429 = string_char_to_byte (readcharfun
, read_from_string_index
);
431 else if (CONSP (readcharfun
))
435 else if (EQ (readcharfun
, Qlambda
))
439 else if (FROM_FILE_P (readcharfun
))
444 call1 (readcharfun
, make_number (c
));
448 readbyte_for_lambda (int c
, Lisp_Object readcharfun
)
450 return read_bytecode_char (c
>= 0);
455 readbyte_from_file (int c
, Lisp_Object readcharfun
)
460 ungetc (c
, instream
);
468 /* Interrupted reads have been observed while reading over the network. */
469 while (c
== EOF
&& ferror (instream
) && errno
== EINTR
)
480 return (c
== EOF
? -1 : c
);
484 readbyte_from_string (int c
, Lisp_Object readcharfun
)
486 Lisp_Object string
= XCAR (readcharfun
);
490 read_from_string_index
--;
491 read_from_string_index_byte
492 = string_char_to_byte (string
, read_from_string_index
);
495 if (read_from_string_index
>= read_from_string_limit
)
498 FETCH_STRING_CHAR_ADVANCE (c
, string
,
499 read_from_string_index
,
500 read_from_string_index_byte
);
505 /* Read one non-ASCII character from INSTREAM. The character is
506 encoded in `emacs-mule' and the first byte is already read in
510 read_emacs_mule_char (int c
, int (*readbyte
) (int, Lisp_Object
), Lisp_Object readcharfun
)
512 /* Emacs-mule coding uses at most 4-byte for one character. */
513 unsigned char buf
[4];
514 int len
= emacs_mule_bytes
[c
];
515 struct charset
*charset
;
520 /* C is not a valid leading-code of `emacs-mule'. */
521 return BYTE8_TO_CHAR (c
);
527 c
= (*readbyte
) (-1, readcharfun
);
531 (*readbyte
) (buf
[i
], readcharfun
);
532 return BYTE8_TO_CHAR (buf
[0]);
539 charset
= CHARSET_FROM_ID (emacs_mule_charset
[buf
[0]]);
540 code
= buf
[1] & 0x7F;
544 if (buf
[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
545 || buf
[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12
)
547 charset
= CHARSET_FROM_ID (emacs_mule_charset
[buf
[1]]);
548 code
= buf
[2] & 0x7F;
552 charset
= CHARSET_FROM_ID (emacs_mule_charset
[buf
[0]]);
553 code
= ((buf
[1] << 8) | buf
[2]) & 0x7F7F;
558 charset
= CHARSET_FROM_ID (emacs_mule_charset
[buf
[1]]);
559 code
= ((buf
[2] << 8) | buf
[3]) & 0x7F7F;
561 c
= DECODE_CHAR (charset
, code
);
563 Fsignal (Qinvalid_read_syntax
,
564 list1 (build_string ("invalid multibyte form")));
569 static Lisp_Object
read_internal_start (Lisp_Object
, Lisp_Object
,
571 static Lisp_Object
read0 (Lisp_Object
);
572 static Lisp_Object
read1 (Lisp_Object
, int *, bool);
574 static Lisp_Object
read_list (bool, Lisp_Object
);
575 static Lisp_Object
read_vector (Lisp_Object
, bool);
577 static Lisp_Object
substitute_object_recurse (Lisp_Object
, Lisp_Object
,
579 static void substitute_object_in_subtree (Lisp_Object
,
581 static void substitute_in_interval (INTERVAL
, Lisp_Object
);
584 /* Get a character from the tty. */
586 /* Read input events until we get one that's acceptable for our purposes.
588 If NO_SWITCH_FRAME, switch-frame events are stashed
589 until we get a character we like, and then stuffed into
592 If ASCII_REQUIRED, check function key events to see
593 if the unmodified version of the symbol has a Qascii_character
594 property, and use that character, if present.
596 If ERROR_NONASCII, signal an error if the input we
597 get isn't an ASCII character with modifiers. If it's false but
598 ASCII_REQUIRED is true, just re-read until we get an ASCII
601 If INPUT_METHOD, invoke the current input method
602 if the character warrants that.
604 If SECONDS is a number, wait that many seconds for input, and
605 return Qnil if no input arrives within that time. */
608 read_filtered_event (bool no_switch_frame
, bool ascii_required
,
609 bool error_nonascii
, bool input_method
, Lisp_Object seconds
)
611 Lisp_Object val
, delayed_switch_frame
;
614 #ifdef HAVE_WINDOW_SYSTEM
615 if (display_hourglass_p
)
619 delayed_switch_frame
= Qnil
;
621 /* Compute timeout. */
622 if (NUMBERP (seconds
))
624 double duration
= extract_float (seconds
);
625 EMACS_TIME wait_time
= EMACS_TIME_FROM_DOUBLE (duration
);
626 end_time
= add_emacs_time (current_emacs_time (), wait_time
);
629 /* Read until we get an acceptable event. */
632 val
= read_char (0, Qnil
, (input_method
? Qnil
: Qt
), 0,
633 NUMBERP (seconds
) ? &end_time
: NULL
);
634 while (INTEGERP (val
) && XINT (val
) == -2); /* wrong_kboard_jmpbuf */
639 /* `switch-frame' events are put off until after the next ASCII
640 character. This is better than signaling an error just because
641 the last characters were typed to a separate minibuffer frame,
642 for example. Eventually, some code which can deal with
643 switch-frame events will read it and process it. */
645 && EVENT_HAS_PARAMETERS (val
)
646 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val
)), Qswitch_frame
))
648 delayed_switch_frame
= val
;
652 if (ascii_required
&& !(NUMBERP (seconds
) && NILP (val
)))
654 /* Convert certain symbols to their ASCII equivalents. */
657 Lisp_Object tem
, tem1
;
658 tem
= Fget (val
, Qevent_symbol_element_mask
);
661 tem1
= Fget (Fcar (tem
), Qascii_character
);
662 /* Merge this symbol's modifier bits
663 with the ASCII equivalent of its basic code. */
665 XSETFASTINT (val
, XINT (tem1
) | XINT (Fcar (Fcdr (tem
))));
669 /* If we don't have a character now, deal with it appropriately. */
674 Vunread_command_events
= list1 (val
);
675 error ("Non-character input-event");
682 if (! NILP (delayed_switch_frame
))
683 unread_switch_frame
= delayed_switch_frame
;
687 #ifdef HAVE_WINDOW_SYSTEM
688 if (display_hourglass_p
)
697 DEFUN ("read-char", Fread_char
, Sread_char
, 0, 3, 0,
698 doc
: /* Read a character from the command input (keyboard or macro).
699 It is returned as a number.
700 If the character has modifiers, they are resolved and reflected to the
701 character code if possible (e.g. C-SPC -> 0).
703 If the user generates an event which is not a character (i.e. a mouse
704 click or function key event), `read-char' signals an error. As an
705 exception, switch-frame events are put off until non-character events
707 If you want to read non-character events, or ignore them, call
708 `read-event' or `read-char-exclusive' instead.
710 If the optional argument PROMPT is non-nil, display that as a prompt.
711 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
712 input method is turned on in the current buffer, that input method
713 is used for reading a character.
714 If the optional argument SECONDS is non-nil, it should be a number
715 specifying the maximum number of seconds to wait for input. If no
716 input arrives in that time, return nil. SECONDS may be a
717 floating-point value. */)
718 (Lisp_Object prompt
, Lisp_Object inherit_input_method
, Lisp_Object seconds
)
723 message_with_string ("%s", prompt
, 0);
724 val
= read_filtered_event (1, 1, 1, ! NILP (inherit_input_method
), seconds
);
726 return (NILP (val
) ? Qnil
727 : make_number (char_resolve_modifier_mask (XINT (val
))));
730 DEFUN ("read-event", Fread_event
, Sread_event
, 0, 3, 0,
731 doc
: /* Read an event object from the input stream.
732 If the optional argument PROMPT is non-nil, display that as a prompt.
733 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
734 input method is turned on in the current buffer, that input method
735 is used for reading a character.
736 If the optional argument SECONDS is non-nil, it should be a number
737 specifying the maximum number of seconds to wait for input. If no
738 input arrives in that time, return nil. SECONDS may be a
739 floating-point value. */)
740 (Lisp_Object prompt
, Lisp_Object inherit_input_method
, Lisp_Object seconds
)
743 message_with_string ("%s", prompt
, 0);
744 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method
), seconds
);
747 DEFUN ("read-char-exclusive", Fread_char_exclusive
, Sread_char_exclusive
, 0, 3, 0,
748 doc
: /* Read a character from the command input (keyboard or macro).
749 It is returned as a number. Non-character events are ignored.
750 If the character has modifiers, they are resolved and reflected to the
751 character code if possible (e.g. C-SPC -> 0).
753 If the optional argument PROMPT is non-nil, display that as a prompt.
754 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
755 input method is turned on in the current buffer, that input method
756 is used for reading a character.
757 If the optional argument SECONDS is non-nil, it should be a number
758 specifying the maximum number of seconds to wait for input. If no
759 input arrives in that time, return nil. SECONDS may be a
760 floating-point value. */)
761 (Lisp_Object prompt
, Lisp_Object inherit_input_method
, Lisp_Object seconds
)
766 message_with_string ("%s", prompt
, 0);
768 val
= read_filtered_event (1, 1, 0, ! NILP (inherit_input_method
), seconds
);
770 return (NILP (val
) ? Qnil
771 : make_number (char_resolve_modifier_mask (XINT (val
))));
774 DEFUN ("get-file-char", Fget_file_char
, Sget_file_char
, 0, 0, 0,
775 doc
: /* Don't use this yourself. */)
778 register Lisp_Object val
;
780 XSETINT (val
, getc (instream
));
788 /* Return true if the lisp code read using READCHARFUN defines a non-nil
789 `lexical-binding' file variable. After returning, the stream is
790 positioned following the first line, if it is a comment or #! line,
791 otherwise nothing is read. */
794 lisp_file_lexically_bound_p (Lisp_Object readcharfun
)
807 while (ch
!= '\n' && ch
!= EOF
)
809 if (ch
== '\n') ch
= READCHAR
;
810 /* It is OK to leave the position after a #! line, since
811 that is what read1 does. */
815 /* The first line isn't a comment, just give up. */
821 /* Look for an appropriate file-variable in the first line. */
825 NOMINAL
, AFTER_FIRST_DASH
, AFTER_ASTERIX
826 } beg_end_state
= NOMINAL
;
827 bool in_file_vars
= 0;
829 #define UPDATE_BEG_END_STATE(ch) \
830 if (beg_end_state == NOMINAL) \
831 beg_end_state = (ch == '-' ? AFTER_FIRST_DASH : NOMINAL); \
832 else if (beg_end_state == AFTER_FIRST_DASH) \
833 beg_end_state = (ch == '*' ? AFTER_ASTERIX : NOMINAL); \
834 else if (beg_end_state == AFTER_ASTERIX) \
837 in_file_vars = !in_file_vars; \
838 beg_end_state = NOMINAL; \
841 /* Skip until we get to the file vars, if any. */
845 UPDATE_BEG_END_STATE (ch
);
847 while (!in_file_vars
&& ch
!= '\n' && ch
!= EOF
);
851 char var
[100], val
[100];
856 /* Read a variable name. */
857 while (ch
== ' ' || ch
== '\t')
861 while (ch
!= ':' && ch
!= '\n' && ch
!= EOF
&& in_file_vars
)
863 if (i
< sizeof var
- 1)
865 UPDATE_BEG_END_STATE (ch
);
869 /* Stop scanning if no colon was found before end marker. */
870 if (!in_file_vars
|| ch
== '\n' || ch
== EOF
)
873 while (i
> 0 && (var
[i
- 1] == ' ' || var
[i
- 1] == '\t'))
879 /* Read a variable value. */
882 while (ch
== ' ' || ch
== '\t')
886 while (ch
!= ';' && ch
!= '\n' && ch
!= EOF
&& in_file_vars
)
888 if (i
< sizeof val
- 1)
890 UPDATE_BEG_END_STATE (ch
);
894 /* The value was terminated by an end-marker, which remove. */
896 while (i
> 0 && (val
[i
- 1] == ' ' || val
[i
- 1] == '\t'))
900 if (strcmp (var
, "lexical-binding") == 0)
903 rv
= (strcmp (val
, "nil") != 0);
909 while (ch
!= '\n' && ch
!= EOF
)
916 /* Value is a version number of byte compiled code if the file
917 associated with file descriptor FD is a compiled Lisp file that's
918 safe to load. Only files compiled with Emacs are safe to load.
919 Files compiled with XEmacs can lead to a crash in Fbyte_code
920 because of an incompatible change in the byte compiler. */
923 safe_to_load_version (int fd
)
929 /* Read the first few bytes from the file, and look for a line
930 specifying the byte compiler version used. */
931 nbytes
= emacs_read (fd
, buf
, sizeof buf
);
934 /* Skip to the next newline, skipping over the initial `ELC'
935 with NUL bytes following it, but note the version. */
936 for (i
= 0; i
< nbytes
&& buf
[i
] != '\n'; ++i
)
941 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp
,
942 buf
+ i
, nbytes
- i
) < 0)
946 lseek (fd
, 0, SEEK_SET
);
951 /* Callback for record_unwind_protect. Restore the old load list OLD,
952 after loading a file successfully. */
955 record_load_unwind (Lisp_Object old
)
957 Vloads_in_progress
= old
;
960 /* This handler function is used via internal_condition_case_1. */
963 load_error_handler (Lisp_Object data
)
969 load_warn_old_style_backquotes (Lisp_Object file
)
971 if (!NILP (Vold_style_backquotes
))
974 args
[0] = build_string ("Loading `%s': old-style backquotes detected!");
980 DEFUN ("get-load-suffixes", Fget_load_suffixes
, Sget_load_suffixes
, 0, 0, 0,
981 doc
: /* Return the suffixes that `load' should try if a suffix is \
983 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
986 Lisp_Object lst
= Qnil
, suffixes
= Vload_suffixes
, suffix
, ext
;
987 while (CONSP (suffixes
))
989 Lisp_Object exts
= Vload_file_rep_suffixes
;
990 suffix
= XCAR (suffixes
);
991 suffixes
= XCDR (suffixes
);
996 lst
= Fcons (concat2 (suffix
, ext
), lst
);
999 return Fnreverse (lst
);
1002 DEFUN ("load", Fload
, Sload
, 1, 5, 0,
1003 doc
: /* Execute a file of Lisp code named FILE.
1004 First try FILE with `.elc' appended, then try with `.el',
1005 then try FILE unmodified (the exact suffixes in the exact order are
1006 determined by `load-suffixes'). Environment variable references in
1007 FILE are replaced with their values by calling `substitute-in-file-name'.
1008 This function searches the directories in `load-path'.
1010 If optional second arg NOERROR is non-nil,
1011 report no error if FILE doesn't exist.
1012 Print messages at start and end of loading unless
1013 optional third arg NOMESSAGE is non-nil (but `force-load-messages'
1015 If optional fourth arg NOSUFFIX is non-nil, don't try adding
1016 suffixes `.elc' or `.el' to the specified name FILE.
1017 If optional fifth arg MUST-SUFFIX is non-nil, insist on
1018 the suffix `.elc' or `.el'; don't accept just FILE unless
1019 it ends in one of those suffixes or includes a directory name.
1021 If NOSUFFIX is nil, then if a file could not be found, try looking for
1022 a different representation of the file by adding non-empty suffixes to
1023 its name, before trying another file. Emacs uses this feature to find
1024 compressed versions of files when Auto Compression mode is enabled.
1025 If NOSUFFIX is non-nil, disable this feature.
1027 The suffixes that this function tries out, when NOSUFFIX is nil, are
1028 given by the return value of `get-load-suffixes' and the values listed
1029 in `load-file-rep-suffixes'. If MUST-SUFFIX is non-nil, only the
1030 return value of `get-load-suffixes' is used, i.e. the file name is
1031 required to have a non-empty suffix.
1033 Loading a file records its definitions, and its `provide' and
1034 `require' calls, in an element of `load-history' whose
1035 car is the file name loaded. See `load-history'.
1037 While the file is in the process of being loaded, the variable
1038 `load-in-progress' is non-nil and the variable `load-file-name'
1039 is bound to the file's name.
1041 Return t if the file exists and loads successfully. */)
1042 (Lisp_Object file
, Lisp_Object noerror
, Lisp_Object nomessage
,
1043 Lisp_Object nosuffix
, Lisp_Object must_suffix
)
1048 ptrdiff_t count
= SPECPDL_INDEX ();
1049 struct gcpro gcpro1
, gcpro2
, gcpro3
;
1050 Lisp_Object found
, efound
, hist_file_name
;
1051 /* True means we printed the ".el is newer" message. */
1053 /* True means we are loading a compiled file. */
1055 Lisp_Object handler
;
1057 const char *fmode
= "r";
1064 CHECK_STRING (file
);
1066 /* If file name is magic, call the handler. */
1067 /* This shouldn't be necessary any more now that `openp' handles it right.
1068 handler = Ffind_file_name_handler (file, Qload);
1069 if (!NILP (handler))
1070 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
1072 /* Do this after the handler to avoid
1073 the need to gcpro noerror, nomessage and nosuffix.
1074 (Below here, we care only whether they are nil or not.)
1075 The presence of this call is the result of a historical accident:
1076 it used to be in every file-operation and when it got removed
1077 everywhere, it accidentally stayed here. Since then, enough people
1078 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
1079 that it seemed risky to remove. */
1080 if (! NILP (noerror
))
1082 file
= internal_condition_case_1 (Fsubstitute_in_file_name
, file
,
1083 Qt
, load_error_handler
);
1088 file
= Fsubstitute_in_file_name (file
);
1090 /* Avoid weird lossage with null string as arg,
1091 since it would try to load a directory as a Lisp file. */
1092 if (SCHARS (file
) == 0)
1099 Lisp_Object suffixes
;
1101 GCPRO2 (file
, found
);
1103 if (! NILP (must_suffix
))
1105 /* Don't insist on adding a suffix if FILE already ends with one. */
1106 ptrdiff_t size
= SBYTES (file
);
1108 && !strcmp (SSDATA (file
) + size
- 3, ".el"))
1111 && !strcmp (SSDATA (file
) + size
- 4, ".elc"))
1113 /* Don't insist on adding a suffix
1114 if the argument includes a directory name. */
1115 else if (! NILP (Ffile_name_directory (file
)))
1119 if (!NILP (nosuffix
))
1123 suffixes
= Fget_load_suffixes ();
1124 if (NILP (must_suffix
))
1128 arg
[1] = Vload_file_rep_suffixes
;
1129 suffixes
= Fappend (2, arg
);
1133 fd
= openp (Vload_path
, file
, suffixes
, &found
, Qnil
);
1140 report_file_error ("Cannot open load file", file
);
1144 /* Tell startup.el whether or not we found the user's init file. */
1145 if (EQ (Qt
, Vuser_init_file
))
1146 Vuser_init_file
= found
;
1148 /* If FD is -2, that means openp found a magic file. */
1151 if (NILP (Fequal (found
, file
)))
1152 /* If FOUND is a different file name from FILE,
1153 find its handler even if we have already inhibited
1154 the `load' operation on FILE. */
1155 handler
= Ffind_file_name_handler (found
, Qt
);
1157 handler
= Ffind_file_name_handler (found
, Qload
);
1158 if (! NILP (handler
))
1159 return call5 (handler
, Qload
, found
, noerror
, nomessage
, Qt
);
1161 /* Tramp has to deal with semi-broken packages that prepend
1162 drive letters to remote files. For that reason, Tramp
1163 catches file operations that test for file existence, which
1164 makes openp think X:/foo.elc files are remote. However,
1165 Tramp does not catch `load' operations for such files, so we
1166 end up with a nil as the `load' handler above. If we would
1167 continue with fd = -2, we will behave wrongly, and in
1168 particular try reading a .elc file in the "rt" mode instead
1169 of "rb". See bug #9311 for the results. To work around
1170 this, we try to open the file locally, and go with that if it
1172 fd
= emacs_open (SSDATA (ENCODE_FILE (found
)), O_RDONLY
, 0);
1180 fd_index
= SPECPDL_INDEX ();
1181 record_unwind_protect_int (close_file_unwind
, fd
);
1184 /* Check if we're stuck in a recursive load cycle.
1186 2000-09-21: It's not possible to just check for the file loaded
1187 being a member of Vloads_in_progress. This fails because of the
1188 way the byte compiler currently works; `provide's are not
1189 evaluated, see font-lock.el/jit-lock.el as an example. This
1190 leads to a certain amount of ``normal'' recursion.
1192 Also, just loading a file recursively is not always an error in
1193 the general case; the second load may do something different. */
1197 for (tem
= Vloads_in_progress
; CONSP (tem
); tem
= XCDR (tem
))
1198 if (!NILP (Fequal (found
, XCAR (tem
))) && (++load_count
> 3))
1199 signal_error ("Recursive load", Fcons (found
, Vloads_in_progress
));
1200 record_unwind_protect (record_load_unwind
, Vloads_in_progress
);
1201 Vloads_in_progress
= Fcons (found
, Vloads_in_progress
);
1204 /* All loads are by default dynamic, unless the file itself specifies
1205 otherwise using a file-variable in the first line. This is bound here
1206 so that it takes effect whether or not we use
1207 Vload_source_file_function. */
1208 specbind (Qlexical_binding
, Qnil
);
1210 /* Get the name for load-history. */
1211 hist_file_name
= (! NILP (Vpurify_flag
)
1212 ? concat2 (Ffile_name_directory (file
),
1213 Ffile_name_nondirectory (found
))
1218 /* Check for the presence of old-style quotes and warn about them. */
1219 specbind (Qold_style_backquotes
, Qnil
);
1220 record_unwind_protect (load_warn_old_style_backquotes
, file
);
1222 if (!memcmp (SDATA (found
) + SBYTES (found
) - 4, ".elc", 4)
1223 || (fd
>= 0 && (version
= safe_to_load_version (fd
)) > 0))
1224 /* Load .elc files directly, but not when they are
1225 remote and have no handler! */
1232 GCPRO3 (file
, found
, hist_file_name
);
1235 && ! (version
= safe_to_load_version (fd
)))
1238 if (!load_dangerous_libraries
)
1239 error ("File `%s' was not compiled in Emacs", SDATA (found
));
1240 else if (!NILP (nomessage
) && !force_load_messages
)
1241 message_with_string ("File `%s' not compiled in Emacs", found
, 1);
1246 efound
= ENCODE_FILE (found
);
1251 result
= stat (SSDATA (efound
), &s1
);
1254 SSET (efound
, SBYTES (efound
) - 1, 0);
1255 result
= stat (SSDATA (efound
), &s2
);
1256 SSET (efound
, SBYTES (efound
) - 1, 'c');
1260 && EMACS_TIME_LT (get_stat_mtime (&s1
), get_stat_mtime (&s2
)))
1262 /* Make the progress messages mention that source is newer. */
1265 /* If we won't print another message, mention this anyway. */
1266 if (!NILP (nomessage
) && !force_load_messages
)
1268 Lisp_Object msg_file
;
1269 msg_file
= Fsubstring (found
, make_number (0), make_number (-1));
1270 message_with_string ("Source file `%s' newer than byte-compiled file",
1279 /* We are loading a source file (*.el). */
1280 if (!NILP (Vload_source_file_function
))
1287 clear_unwind_protect (fd_index
);
1289 val
= call4 (Vload_source_file_function
, found
, hist_file_name
,
1290 NILP (noerror
) ? Qnil
: Qt
,
1291 (NILP (nomessage
) || force_load_messages
) ? Qnil
: Qt
);
1292 return unbind_to (count
, val
);
1296 GCPRO3 (file
, found
, hist_file_name
);
1300 /* We somehow got here with fd == -2, meaning the file is deemed
1301 to be remote. Don't even try to reopen the file locally;
1302 just force a failure. */
1310 clear_unwind_protect (fd_index
);
1311 efound
= ENCODE_FILE (found
);
1312 stream
= emacs_fopen (SSDATA (efound
), fmode
);
1314 stream
= fdopen (fd
, fmode
);
1318 report_file_error ("Opening stdio stream", file
);
1319 set_unwind_protect_ptr (fd_index
, fclose_unwind
, stream
);
1321 if (! NILP (Vpurify_flag
))
1322 Vpreloaded_file_list
= Fcons (Fpurecopy (file
), Vpreloaded_file_list
);
1324 if (NILP (nomessage
) || force_load_messages
)
1327 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1330 message_with_string ("Loading %s (source)...", file
, 1);
1332 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1334 else /* The typical case; compiled file newer than source file. */
1335 message_with_string ("Loading %s...", file
, 1);
1338 specbind (Qload_file_name
, found
);
1339 specbind (Qinhibit_file_name_operation
, Qnil
);
1340 specbind (Qload_in_progress
, Qt
);
1343 if (lisp_file_lexically_bound_p (Qget_file_char
))
1344 Fset (Qlexical_binding
, Qt
);
1346 if (! version
|| version
>= 22)
1347 readevalloop (Qget_file_char
, stream
, hist_file_name
,
1348 0, Qnil
, Qnil
, Qnil
, Qnil
);
1351 /* We can't handle a file which was compiled with
1352 byte-compile-dynamic by older version of Emacs. */
1353 specbind (Qload_force_doc_strings
, Qt
);
1354 readevalloop (Qget_emacs_mule_file_char
, stream
, hist_file_name
,
1355 0, Qnil
, Qnil
, Qnil
, Qnil
);
1357 unbind_to (count
, Qnil
);
1359 /* Run any eval-after-load forms for this file. */
1360 if (!NILP (Ffboundp (Qdo_after_load_evaluation
)))
1361 call1 (Qdo_after_load_evaluation
, hist_file_name
) ;
1365 xfree (saved_doc_string
);
1366 saved_doc_string
= 0;
1367 saved_doc_string_size
= 0;
1369 xfree (prev_saved_doc_string
);
1370 prev_saved_doc_string
= 0;
1371 prev_saved_doc_string_size
= 0;
1373 if (!noninteractive
&& (NILP (nomessage
) || force_load_messages
))
1376 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1379 message_with_string ("Loading %s (source)...done", file
, 1);
1381 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1383 else /* The typical case; compiled file newer than source file. */
1384 message_with_string ("Loading %s...done", file
, 1);
1391 complete_filename_p (Lisp_Object pathname
)
1393 const unsigned char *s
= SDATA (pathname
);
1394 return (IS_DIRECTORY_SEP (s
[0])
1395 || (SCHARS (pathname
) > 2
1396 && IS_DEVICE_SEP (s
[1]) && IS_DIRECTORY_SEP (s
[2])));
1399 DEFUN ("locate-file-internal", Flocate_file_internal
, Slocate_file_internal
, 2, 4, 0,
1400 doc
: /* Search for FILENAME through PATH.
1401 Returns the file's name in absolute form, or nil if not found.
1402 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1403 file name when searching.
1404 If non-nil, PREDICATE is used instead of `file-readable-p'.
1405 PREDICATE can also be an integer to pass to the faccessat(2) function,
1406 in which case file-name-handlers are ignored.
1407 This function will normally skip directories, so if you want it to find
1408 directories, make sure the PREDICATE function returns `dir-ok' for them. */)
1409 (Lisp_Object filename
, Lisp_Object path
, Lisp_Object suffixes
, Lisp_Object predicate
)
1412 int fd
= openp (path
, filename
, suffixes
, &file
, predicate
);
1413 if (NILP (predicate
) && fd
>= 0)
1418 static Lisp_Object Qdir_ok
;
1420 /* Search for a file whose name is STR, looking in directories
1421 in the Lisp list PATH, and trying suffixes from SUFFIX.
1422 On success, return a file descriptor (or 1 or -2 as described below).
1423 On failure, return -1 and set errno.
1425 SUFFIXES is a list of strings containing possible suffixes.
1426 The empty suffix is automatically added if the list is empty.
1428 PREDICATE non-nil means don't open the files,
1429 just look for one that satisfies the predicate. In this case,
1430 return 1 on success. The predicate can be a lisp function or
1431 an integer to pass to `access' (in which case file-name-handlers
1434 If STOREPTR is nonzero, it points to a slot where the name of
1435 the file actually found should be stored as a Lisp string.
1436 nil is stored there on failure.
1438 If the file we find is remote, return -2
1439 but store the found remote file name in *STOREPTR. */
1442 openp (Lisp_Object path
, Lisp_Object str
, Lisp_Object suffixes
,
1443 Lisp_Object
*storeptr
, Lisp_Object predicate
)
1445 ptrdiff_t fn_size
= 100;
1449 ptrdiff_t want_length
;
1450 Lisp_Object filename
;
1451 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
, gcpro6
;
1452 Lisp_Object string
, tail
, encoded_fn
;
1453 ptrdiff_t max_suffix_len
= 0;
1454 int last_errno
= ENOENT
;
1458 for (tail
= suffixes
; CONSP (tail
); tail
= XCDR (tail
))
1460 CHECK_STRING_CAR (tail
);
1461 max_suffix_len
= max (max_suffix_len
,
1462 SBYTES (XCAR (tail
)));
1465 string
= filename
= encoded_fn
= Qnil
;
1466 GCPRO6 (str
, string
, filename
, path
, suffixes
, encoded_fn
);
1471 if (complete_filename_p (str
))
1474 for (; CONSP (path
); path
= XCDR (path
))
1476 filename
= Fexpand_file_name (str
, XCAR (path
));
1477 if (!complete_filename_p (filename
))
1478 /* If there are non-absolute elts in PATH (eg "."). */
1479 /* Of course, this could conceivably lose if luser sets
1480 default-directory to be something non-absolute... */
1482 filename
= Fexpand_file_name (filename
, BVAR (current_buffer
, directory
));
1483 if (!complete_filename_p (filename
))
1484 /* Give up on this path element! */
1488 /* Calculate maximum length of any filename made from
1489 this path element/specified file name and any possible suffix. */
1490 want_length
= max_suffix_len
+ SBYTES (filename
);
1491 if (fn_size
<= want_length
)
1492 fn
= alloca (fn_size
= 100 + want_length
);
1494 /* Loop over suffixes. */
1495 for (tail
= NILP (suffixes
) ? list1 (empty_unibyte_string
) : suffixes
;
1496 CONSP (tail
); tail
= XCDR (tail
))
1498 ptrdiff_t fnlen
, lsuffix
= SBYTES (XCAR (tail
));
1499 Lisp_Object handler
;
1501 /* Concatenate path element/specified name with the suffix.
1502 If the directory starts with /:, remove that. */
1503 int prefixlen
= ((SCHARS (filename
) > 2
1504 && SREF (filename
, 0) == '/'
1505 && SREF (filename
, 1) == ':')
1507 fnlen
= SBYTES (filename
) - prefixlen
;
1508 memcpy (fn
, SDATA (filename
) + prefixlen
, fnlen
);
1509 memcpy (fn
+ fnlen
, SDATA (XCAR (tail
)), lsuffix
+ 1);
1511 /* Check that the file exists and is not a directory. */
1512 /* We used to only check for handlers on non-absolute file names:
1516 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1517 It's not clear why that was the case and it breaks things like
1518 (load "/bar.el") where the file is actually "/bar.el.gz". */
1519 string
= make_string (fn
, fnlen
);
1520 handler
= Ffind_file_name_handler (string
, Qfile_exists_p
);
1521 if ((!NILP (handler
) || !NILP (predicate
)) && !NATNUMP (predicate
))
1524 if (NILP (predicate
))
1525 exists
= !NILP (Ffile_readable_p (string
));
1528 Lisp_Object tmp
= call1 (predicate
, string
);
1531 else if (EQ (tmp
, Qdir_ok
)
1532 || NILP (Ffile_directory_p (string
)))
1537 last_errno
= EISDIR
;
1543 /* We succeeded; return this descriptor and filename. */
1555 encoded_fn
= ENCODE_FILE (string
);
1556 pfn
= SSDATA (encoded_fn
);
1558 /* Check that we can access or open it. */
1559 if (NATNUMP (predicate
))
1562 if (INT_MAX
< XFASTINT (predicate
))
1563 last_errno
= EINVAL
;
1564 else if (faccessat (AT_FDCWD
, pfn
, XFASTINT (predicate
),
1568 if (file_directory_p (pfn
))
1569 last_errno
= EISDIR
;
1576 fd
= emacs_open (pfn
, O_RDONLY
, 0);
1579 if (errno
!= ENOENT
)
1585 int err
= (fstat (fd
, &st
) != 0 ? errno
1586 : S_ISDIR (st
.st_mode
) ? EISDIR
: 0);
1598 /* We succeeded; return this descriptor and filename. */
1616 /* Merge the list we've accumulated of globals from the current input source
1617 into the load_history variable. The details depend on whether
1618 the source has an associated file name or not.
1620 FILENAME is the file name that we are loading from.
1622 ENTIRE is true if loading that entire file, false if evaluating
1626 build_load_history (Lisp_Object filename
, bool entire
)
1628 Lisp_Object tail
, prev
, newelt
;
1629 Lisp_Object tem
, tem2
;
1632 tail
= Vload_history
;
1635 while (CONSP (tail
))
1639 /* Find the feature's previous assoc list... */
1640 if (!NILP (Fequal (filename
, Fcar (tem
))))
1644 /* If we're loading the entire file, remove old data. */
1648 Vload_history
= XCDR (tail
);
1650 Fsetcdr (prev
, XCDR (tail
));
1653 /* Otherwise, cons on new symbols that are not already members. */
1656 tem2
= Vcurrent_load_list
;
1658 while (CONSP (tem2
))
1660 newelt
= XCAR (tem2
);
1662 if (NILP (Fmember (newelt
, tem
)))
1663 Fsetcar (tail
, Fcons (XCAR (tem
),
1664 Fcons (newelt
, XCDR (tem
))));
1677 /* If we're loading an entire file, cons the new assoc onto the
1678 front of load-history, the most-recently-loaded position. Also
1679 do this if we didn't find an existing member for the file. */
1680 if (entire
|| !foundit
)
1681 Vload_history
= Fcons (Fnreverse (Vcurrent_load_list
),
1686 readevalloop_1 (int old
)
1688 load_convert_to_unibyte
= old
;
1691 /* Signal an `end-of-file' error, if possible with file name
1694 static _Noreturn
void
1695 end_of_file_error (void)
1697 if (STRINGP (Vload_file_name
))
1698 xsignal1 (Qend_of_file
, Vload_file_name
);
1700 xsignal0 (Qend_of_file
);
1703 /* UNIBYTE specifies how to set load_convert_to_unibyte
1704 for this invocation.
1705 READFUN, if non-nil, is used instead of `read'.
1707 START, END specify region to read in current buffer (from eval-region).
1708 If the input is not from a buffer, they must be nil. */
1711 readevalloop (Lisp_Object readcharfun
,
1713 Lisp_Object sourcename
,
1715 Lisp_Object unibyte
, Lisp_Object readfun
,
1716 Lisp_Object start
, Lisp_Object end
)
1719 register Lisp_Object val
;
1720 ptrdiff_t count
= SPECPDL_INDEX ();
1721 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1722 struct buffer
*b
= 0;
1723 bool continue_reading_p
;
1724 Lisp_Object lex_bound
;
1725 /* True if reading an entire buffer. */
1726 bool whole_buffer
= 0;
1727 /* True on the first time around. */
1728 bool first_sexp
= 1;
1729 Lisp_Object macroexpand
= intern ("internal-macroexpand-for-load");
1731 if (NILP (Ffboundp (macroexpand
))
1732 /* Don't macroexpand in .elc files, since it should have been done
1733 already. We actually don't know whether we're in a .elc file or not,
1734 so we use circumstantial evidence: .el files normally go through
1735 Vload_source_file_function -> load-with-code-conversion
1737 || EQ (readcharfun
, Qget_file_char
)
1738 || EQ (readcharfun
, Qget_emacs_mule_file_char
))
1741 if (MARKERP (readcharfun
))
1744 start
= readcharfun
;
1747 if (BUFFERP (readcharfun
))
1748 b
= XBUFFER (readcharfun
);
1749 else if (MARKERP (readcharfun
))
1750 b
= XMARKER (readcharfun
)->buffer
;
1752 /* We assume START is nil when input is not from a buffer. */
1753 if (! NILP (start
) && !b
)
1756 specbind (Qstandard_input
, readcharfun
); /* GCPROs readcharfun. */
1757 specbind (Qcurrent_load_list
, Qnil
);
1758 record_unwind_protect_int (readevalloop_1
, load_convert_to_unibyte
);
1759 load_convert_to_unibyte
= !NILP (unibyte
);
1761 /* If lexical binding is active (either because it was specified in
1762 the file's header, or via a buffer-local variable), create an empty
1763 lexical environment, otherwise, turn off lexical binding. */
1764 lex_bound
= find_symbol_value (Qlexical_binding
);
1765 specbind (Qinternal_interpreter_environment
,
1766 (NILP (lex_bound
) || EQ (lex_bound
, Qunbound
)
1767 ? Qnil
: list1 (Qt
)));
1769 GCPRO4 (sourcename
, readfun
, start
, end
);
1771 /* Try to ensure sourcename is a truename, except whilst preloading. */
1772 if (NILP (Vpurify_flag
)
1773 && !NILP (sourcename
) && !NILP (Ffile_name_absolute_p (sourcename
))
1774 && !NILP (Ffboundp (Qfile_truename
)))
1775 sourcename
= call1 (Qfile_truename
, sourcename
) ;
1777 LOADHIST_ATTACH (sourcename
);
1779 continue_reading_p
= 1;
1780 while (continue_reading_p
)
1782 ptrdiff_t count1
= SPECPDL_INDEX ();
1784 if (b
!= 0 && !BUFFER_LIVE_P (b
))
1785 error ("Reading from killed buffer");
1789 /* Switch to the buffer we are reading from. */
1790 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1791 set_buffer_internal (b
);
1793 /* Save point in it. */
1794 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1795 /* Save ZV in it. */
1796 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
1797 /* Those get unbound after we read one expression. */
1799 /* Set point and ZV around stuff to be read. */
1802 Fnarrow_to_region (make_number (BEGV
), end
);
1804 /* Just for cleanliness, convert END to a marker
1805 if it is an integer. */
1807 end
= Fpoint_max_marker ();
1810 /* On the first cycle, we can easily test here
1811 whether we are reading the whole buffer. */
1812 if (b
&& first_sexp
)
1813 whole_buffer
= (PT
== BEG
&& ZV
== Z
);
1820 while ((c
= READCHAR
) != '\n' && c
!= -1);
1825 unbind_to (count1
, Qnil
);
1829 /* Ignore whitespace here, so we can detect eof. */
1830 if (c
== ' ' || c
== '\t' || c
== '\n' || c
== '\f' || c
== '\r'
1831 || c
== 0xa0) /* NBSP */
1834 if (!NILP (Vpurify_flag
) && c
== '(')
1836 val
= read_list (0, readcharfun
);
1841 read_objects
= Qnil
;
1842 if (!NILP (readfun
))
1844 val
= call1 (readfun
, readcharfun
);
1846 /* If READCHARFUN has set point to ZV, we should
1847 stop reading, even if the form read sets point
1848 to a different value when evaluated. */
1849 if (BUFFERP (readcharfun
))
1851 struct buffer
*buf
= XBUFFER (readcharfun
);
1852 if (BUF_PT (buf
) == BUF_ZV (buf
))
1853 continue_reading_p
= 0;
1856 else if (! NILP (Vload_read_function
))
1857 val
= call1 (Vload_read_function
, readcharfun
);
1859 val
= read_internal_start (readcharfun
, Qnil
, Qnil
);
1862 if (!NILP (start
) && continue_reading_p
)
1863 start
= Fpoint_marker ();
1865 /* Restore saved point and BEGV. */
1866 unbind_to (count1
, Qnil
);
1868 /* Now eval what we just read. */
1869 if (!NILP (macroexpand
))
1870 val
= call1 (macroexpand
, val
);
1871 val
= eval_sub (val
);
1875 Vvalues
= Fcons (val
, Vvalues
);
1876 if (EQ (Vstandard_output
, Qt
))
1885 build_load_history (sourcename
,
1886 stream
|| whole_buffer
);
1890 unbind_to (count
, Qnil
);
1893 DEFUN ("eval-buffer", Feval_buffer
, Seval_buffer
, 0, 5, "",
1894 doc
: /* Execute the current buffer as Lisp code.
1895 When called from a Lisp program (i.e., not interactively), this
1896 function accepts up to five optional arguments:
1897 BUFFER is the buffer to evaluate (nil means use current buffer).
1898 PRINTFLAG controls printing of output:
1899 A value of nil means discard it; anything else is stream for print.
1900 FILENAME specifies the file name to use for `load-history'.
1901 UNIBYTE, if non-nil, specifies `load-convert-to-unibyte' for this
1903 DO-ALLOW-PRINT, if non-nil, specifies that `print' and related
1904 functions should work normally even if PRINTFLAG is nil.
1906 This function preserves the position of point. */)
1907 (Lisp_Object buffer
, Lisp_Object printflag
, Lisp_Object filename
, Lisp_Object unibyte
, Lisp_Object do_allow_print
)
1909 ptrdiff_t count
= SPECPDL_INDEX ();
1910 Lisp_Object tem
, buf
;
1913 buf
= Fcurrent_buffer ();
1915 buf
= Fget_buffer (buffer
);
1917 error ("No such buffer");
1919 if (NILP (printflag
) && NILP (do_allow_print
))
1924 if (NILP (filename
))
1925 filename
= BVAR (XBUFFER (buf
), filename
);
1927 specbind (Qeval_buffer_list
, Fcons (buf
, Veval_buffer_list
));
1928 specbind (Qstandard_output
, tem
);
1929 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1930 BUF_TEMP_SET_PT (XBUFFER (buf
), BUF_BEGV (XBUFFER (buf
)));
1931 specbind (Qlexical_binding
, lisp_file_lexically_bound_p (buf
) ? Qt
: Qnil
);
1932 readevalloop (buf
, 0, filename
,
1933 !NILP (printflag
), unibyte
, Qnil
, Qnil
, Qnil
);
1934 unbind_to (count
, Qnil
);
1939 DEFUN ("eval-region", Feval_region
, Seval_region
, 2, 4, "r",
1940 doc
: /* Execute the region as Lisp code.
1941 When called from programs, expects two arguments,
1942 giving starting and ending indices in the current buffer
1943 of the text to be executed.
1944 Programs can pass third argument PRINTFLAG which controls output:
1945 A value of nil means discard it; anything else is stream for printing it.
1946 Also the fourth argument READ-FUNCTION, if non-nil, is used
1947 instead of `read' to read each expression. It gets one argument
1948 which is the input stream for reading characters.
1950 This function does not move point. */)
1951 (Lisp_Object start
, Lisp_Object end
, Lisp_Object printflag
, Lisp_Object read_function
)
1953 /* FIXME: Do the eval-sexp-add-defvars dance! */
1954 ptrdiff_t count
= SPECPDL_INDEX ();
1955 Lisp_Object tem
, cbuf
;
1957 cbuf
= Fcurrent_buffer ();
1959 if (NILP (printflag
))
1963 specbind (Qstandard_output
, tem
);
1964 specbind (Qeval_buffer_list
, Fcons (cbuf
, Veval_buffer_list
));
1966 /* `readevalloop' calls functions which check the type of start and end. */
1967 readevalloop (cbuf
, 0, BVAR (XBUFFER (cbuf
), filename
),
1968 !NILP (printflag
), Qnil
, read_function
,
1971 return unbind_to (count
, Qnil
);
1975 DEFUN ("read", Fread
, Sread
, 0, 1, 0,
1976 doc
: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1977 If STREAM is nil, use the value of `standard-input' (which see).
1978 STREAM or the value of `standard-input' may be:
1979 a buffer (read from point and advance it)
1980 a marker (read from where it points and advance it)
1981 a function (call it with no arguments for each character,
1982 call it with a char as argument to push a char back)
1983 a string (takes text from string, starting at the beginning)
1984 t (read text line using minibuffer and use it, or read from
1985 standard input in batch mode). */)
1986 (Lisp_Object stream
)
1989 stream
= Vstandard_input
;
1990 if (EQ (stream
, Qt
))
1991 stream
= Qread_char
;
1992 if (EQ (stream
, Qread_char
))
1993 /* FIXME: ¿¡ When is this used !? */
1994 return call1 (intern ("read-minibuffer"),
1995 build_string ("Lisp expression: "));
1997 return read_internal_start (stream
, Qnil
, Qnil
);
2000 DEFUN ("read-from-string", Fread_from_string
, Sread_from_string
, 1, 3, 0,
2001 doc
: /* Read one Lisp expression which is represented as text by STRING.
2002 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
2003 FINAL-STRING-INDEX is an integer giving the position of the next
2004 remaining character in STRING.
2005 START and END optionally delimit a substring of STRING from which to read;
2006 they default to 0 and (length STRING) respectively. */)
2007 (Lisp_Object string
, Lisp_Object start
, Lisp_Object end
)
2010 CHECK_STRING (string
);
2011 /* `read_internal_start' sets `read_from_string_index'. */
2012 ret
= read_internal_start (string
, start
, end
);
2013 return Fcons (ret
, make_number (read_from_string_index
));
2016 /* Function to set up the global context we need in toplevel read
2019 read_internal_start (Lisp_Object stream
, Lisp_Object start
, Lisp_Object end
)
2020 /* `start', `end' only used when stream is a string. */
2025 new_backquote_flag
= 0;
2026 read_objects
= Qnil
;
2027 if (EQ (Vread_with_symbol_positions
, Qt
)
2028 || EQ (Vread_with_symbol_positions
, stream
))
2029 Vread_symbol_positions_list
= Qnil
;
2031 if (STRINGP (stream
)
2032 || ((CONSP (stream
) && STRINGP (XCAR (stream
)))))
2034 ptrdiff_t startval
, endval
;
2037 if (STRINGP (stream
))
2040 string
= XCAR (stream
);
2043 endval
= SCHARS (string
);
2047 if (! (0 <= XINT (end
) && XINT (end
) <= SCHARS (string
)))
2048 args_out_of_range (string
, end
);
2049 endval
= XINT (end
);
2056 CHECK_NUMBER (start
);
2057 if (! (0 <= XINT (start
) && XINT (start
) <= endval
))
2058 args_out_of_range (string
, start
);
2059 startval
= XINT (start
);
2061 read_from_string_index
= startval
;
2062 read_from_string_index_byte
= string_char_to_byte (string
, startval
);
2063 read_from_string_limit
= endval
;
2066 retval
= read0 (stream
);
2067 if (EQ (Vread_with_symbol_positions
, Qt
)
2068 || EQ (Vread_with_symbol_positions
, stream
))
2069 Vread_symbol_positions_list
= Fnreverse (Vread_symbol_positions_list
);
2074 /* Signal Qinvalid_read_syntax error.
2075 S is error string of length N (if > 0) */
2077 static _Noreturn
void
2078 invalid_syntax (const char *s
)
2080 xsignal1 (Qinvalid_read_syntax
, build_string (s
));
2084 /* Use this for recursive reads, in contexts where internal tokens
2088 read0 (Lisp_Object readcharfun
)
2090 register Lisp_Object val
;
2093 val
= read1 (readcharfun
, &c
, 0);
2097 xsignal1 (Qinvalid_read_syntax
,
2098 Fmake_string (make_number (1), make_number (c
)));
2101 static ptrdiff_t read_buffer_size
;
2102 static char *read_buffer
;
2104 /* Read a \-escape sequence, assuming we already read the `\'.
2105 If the escape sequence forces unibyte, return eight-bit char. */
2108 read_escape (Lisp_Object readcharfun
, bool stringp
)
2111 /* \u allows up to four hex digits, \U up to eight. Default to the
2112 behavior for \u, and change this value in the case that \U is seen. */
2113 int unicode_hex_count
= 4;
2118 end_of_file_error ();
2148 error ("Invalid escape character syntax");
2151 c
= read_escape (readcharfun
, 0);
2152 return c
| meta_modifier
;
2157 error ("Invalid escape character syntax");
2160 c
= read_escape (readcharfun
, 0);
2161 return c
| shift_modifier
;
2166 error ("Invalid escape character syntax");
2169 c
= read_escape (readcharfun
, 0);
2170 return c
| hyper_modifier
;
2175 error ("Invalid escape character syntax");
2178 c
= read_escape (readcharfun
, 0);
2179 return c
| alt_modifier
;
2183 if (stringp
|| c
!= '-')
2190 c
= read_escape (readcharfun
, 0);
2191 return c
| super_modifier
;
2196 error ("Invalid escape character syntax");
2200 c
= read_escape (readcharfun
, 0);
2201 if ((c
& ~CHAR_MODIFIER_MASK
) == '?')
2202 return 0177 | (c
& CHAR_MODIFIER_MASK
);
2203 else if (! SINGLE_BYTE_CHAR_P ((c
& ~CHAR_MODIFIER_MASK
)))
2204 return c
| ctrl_modifier
;
2205 /* ASCII control chars are made from letters (both cases),
2206 as well as the non-letters within 0100...0137. */
2207 else if ((c
& 0137) >= 0101 && (c
& 0137) <= 0132)
2208 return (c
& (037 | ~0177));
2209 else if ((c
& 0177) >= 0100 && (c
& 0177) <= 0137)
2210 return (c
& (037 | ~0177));
2212 return c
| ctrl_modifier
;
2222 /* An octal escape, as in ANSI C. */
2224 register int i
= c
- '0';
2225 register int count
= 0;
2228 if ((c
= READCHAR
) >= '0' && c
<= '7')
2240 if (i
>= 0x80 && i
< 0x100)
2241 i
= BYTE8_TO_CHAR (i
);
2246 /* A hex escape, as in ANSI C. */
2253 if (c
>= '0' && c
<= '9')
2258 else if ((c
>= 'a' && c
<= 'f')
2259 || (c
>= 'A' && c
<= 'F'))
2262 if (c
>= 'a' && c
<= 'f')
2272 /* Allow hex escapes as large as ?\xfffffff, because some
2273 packages use them to denote characters with modifiers. */
2274 if ((CHAR_META
| (CHAR_META
- 1)) < i
)
2275 error ("Hex character out of range: \\x%x...", i
);
2279 if (count
< 3 && i
>= 0x80)
2280 return BYTE8_TO_CHAR (i
);
2285 /* Post-Unicode-2.0: Up to eight hex chars. */
2286 unicode_hex_count
= 8;
2289 /* A Unicode escape. We only permit them in strings and characters,
2290 not arbitrarily in the source code, as in some other languages. */
2295 while (++count
<= unicode_hex_count
)
2298 /* `isdigit' and `isalpha' may be locale-specific, which we don't
2300 if (c
>= '0' && c
<= '9') i
= (i
<< 4) + (c
- '0');
2301 else if (c
>= 'a' && c
<= 'f') i
= (i
<< 4) + (c
- 'a') + 10;
2302 else if (c
>= 'A' && c
<= 'F') i
= (i
<< 4) + (c
- 'A') + 10;
2304 error ("Non-hex digit used for Unicode escape");
2307 error ("Non-Unicode character: 0x%x", i
);
2316 /* Return the digit that CHARACTER stands for in the given BASE.
2317 Return -1 if CHARACTER is out of range for BASE,
2318 and -2 if CHARACTER is not valid for any supported BASE. */
2320 digit_to_number (int character
, int base
)
2324 if ('0' <= character
&& character
<= '9')
2325 digit
= character
- '0';
2326 else if ('a' <= character
&& character
<= 'z')
2327 digit
= character
- 'a' + 10;
2328 else if ('A' <= character
&& character
<= 'Z')
2329 digit
= character
- 'A' + 10;
2333 return digit
< base
? digit
: -1;
2336 /* Read an integer in radix RADIX using READCHARFUN to read
2337 characters. RADIX must be in the interval [2..36]; if it isn't, a
2338 read error is signaled . Value is the integer read. Signals an
2339 error if encountering invalid read syntax or if RADIX is out of
2343 read_integer (Lisp_Object readcharfun
, EMACS_INT radix
)
2345 /* Room for sign, leading 0, other digits, trailing null byte.
2346 Also, room for invalid syntax diagnostic. */
2347 char buf
[max (1 + 1 + sizeof (uintmax_t) * CHAR_BIT
+ 1,
2348 sizeof "integer, radix " + INT_STRLEN_BOUND (EMACS_INT
))];
2350 int valid
= -1; /* 1 if valid, 0 if not, -1 if incomplete. */
2352 if (radix
< 2 || radix
> 36)
2360 if (c
== '-' || c
== '+')
2371 /* Ignore redundant leading zeros, so the buffer doesn't
2372 fill up with them. */
2378 while ((digit
= digit_to_number (c
, radix
)) >= -1)
2385 if (p
< buf
+ sizeof buf
- 1)
2399 sprintf (buf
, "integer, radix %"pI
"d", radix
);
2400 invalid_syntax (buf
);
2403 return string_to_number (buf
, radix
, 0);
2407 /* If the next token is ')' or ']' or '.', we store that character
2408 in *PCH and the return value is not interesting. Else, we store
2409 zero in *PCH and we read and return one lisp object.
2411 FIRST_IN_LIST is true if this is the first element of a list. */
2414 read1 (Lisp_Object readcharfun
, int *pch
, bool first_in_list
)
2417 bool uninterned_symbol
= 0;
2424 c
= READCHAR_REPORT_MULTIBYTE (&multibyte
);
2426 end_of_file_error ();
2431 return read_list (0, readcharfun
);
2434 return read_vector (readcharfun
, 0);
2450 /* Accept extended format for hashtables (extensible to
2452 #s(hash-table size 2 test equal data (k1 v1 k2 v2)) */
2453 Lisp_Object tmp
= read_list (0, readcharfun
);
2454 Lisp_Object head
= CAR_SAFE (tmp
);
2455 Lisp_Object data
= Qnil
;
2456 Lisp_Object val
= Qnil
;
2457 /* The size is 2 * number of allowed keywords to
2459 Lisp_Object params
[10];
2461 Lisp_Object key
= Qnil
;
2462 int param_count
= 0;
2464 if (!EQ (head
, Qhash_table
))
2465 error ("Invalid extended read marker at head of #s list "
2466 "(only hash-table allowed)");
2468 tmp
= CDR_SAFE (tmp
);
2470 /* This is repetitive but fast and simple. */
2471 params
[param_count
] = QCsize
;
2472 params
[param_count
+ 1] = Fplist_get (tmp
, Qsize
);
2473 if (!NILP (params
[param_count
+ 1]))
2476 params
[param_count
] = QCtest
;
2477 params
[param_count
+ 1] = Fplist_get (tmp
, Qtest
);
2478 if (!NILP (params
[param_count
+ 1]))
2481 params
[param_count
] = QCweakness
;
2482 params
[param_count
+ 1] = Fplist_get (tmp
, Qweakness
);
2483 if (!NILP (params
[param_count
+ 1]))
2486 params
[param_count
] = QCrehash_size
;
2487 params
[param_count
+ 1] = Fplist_get (tmp
, Qrehash_size
);
2488 if (!NILP (params
[param_count
+ 1]))
2491 params
[param_count
] = QCrehash_threshold
;
2492 params
[param_count
+ 1] = Fplist_get (tmp
, Qrehash_threshold
);
2493 if (!NILP (params
[param_count
+ 1]))
2496 /* This is the hashtable data. */
2497 data
= Fplist_get (tmp
, Qdata
);
2499 /* Now use params to make a new hashtable and fill it. */
2500 ht
= Fmake_hash_table (param_count
, params
);
2502 while (CONSP (data
))
2507 error ("Odd number of elements in hashtable data");
2510 Fputhash (key
, val
, ht
);
2516 invalid_syntax ("#");
2524 tmp
= read_vector (readcharfun
, 0);
2525 if (ASIZE (tmp
) < CHAR_TABLE_STANDARD_SLOTS
)
2526 error ("Invalid size char-table");
2527 XSETPVECTYPE (XVECTOR (tmp
), PVEC_CHAR_TABLE
);
2539 tmp
= read_vector (readcharfun
, 0);
2542 error ("Invalid size char-table");
2543 if (! RANGED_INTEGERP (1, AREF (tmp
, 0), 3))
2544 error ("Invalid depth in char-table");
2545 depth
= XINT (AREF (tmp
, 0));
2546 if (chartab_size
[depth
] != size
- 2)
2547 error ("Invalid size char-table");
2548 XSETPVECTYPE (XVECTOR (tmp
), PVEC_SUB_CHAR_TABLE
);
2551 invalid_syntax ("#^^");
2553 invalid_syntax ("#^");
2558 length
= read1 (readcharfun
, pch
, first_in_list
);
2562 Lisp_Object tmp
, val
;
2563 EMACS_INT size_in_chars
2564 = ((XFASTINT (length
) + BOOL_VECTOR_BITS_PER_CHAR
- 1)
2565 / BOOL_VECTOR_BITS_PER_CHAR
);
2568 tmp
= read1 (readcharfun
, pch
, first_in_list
);
2569 if (STRING_MULTIBYTE (tmp
)
2570 || (size_in_chars
!= SCHARS (tmp
)
2571 /* We used to print 1 char too many
2572 when the number of bits was a multiple of 8.
2573 Accept such input in case it came from an old
2575 && ! (XFASTINT (length
)
2576 == (SCHARS (tmp
) - 1) * BOOL_VECTOR_BITS_PER_CHAR
)))
2577 invalid_syntax ("#&...");
2579 val
= Fmake_bool_vector (length
, Qnil
);
2580 memcpy (XBOOL_VECTOR (val
)->data
, SDATA (tmp
), size_in_chars
);
2581 /* Clear the extraneous bits in the last byte. */
2582 if (XINT (length
) != size_in_chars
* BOOL_VECTOR_BITS_PER_CHAR
)
2583 XBOOL_VECTOR (val
)->data
[size_in_chars
- 1]
2584 &= (1 << (XINT (length
) % BOOL_VECTOR_BITS_PER_CHAR
)) - 1;
2587 invalid_syntax ("#&...");
2591 /* Accept compiled functions at read-time so that we don't have to
2592 build them using function calls. */
2594 tmp
= read_vector (readcharfun
, 1);
2595 make_byte_code (XVECTOR (tmp
));
2601 struct gcpro gcpro1
;
2604 /* Read the string itself. */
2605 tmp
= read1 (readcharfun
, &ch
, 0);
2606 if (ch
!= 0 || !STRINGP (tmp
))
2607 invalid_syntax ("#");
2609 /* Read the intervals and their properties. */
2612 Lisp_Object beg
, end
, plist
;
2614 beg
= read1 (readcharfun
, &ch
, 0);
2619 end
= read1 (readcharfun
, &ch
, 0);
2621 plist
= read1 (readcharfun
, &ch
, 0);
2623 invalid_syntax ("Invalid string property list");
2624 Fset_text_properties (beg
, end
, plist
, tmp
);
2630 /* #@NUMBER is used to skip NUMBER following bytes.
2631 That's used in .elc files to skip over doc strings
2632 and function definitions. */
2635 enum { extra
= 100 };
2636 ptrdiff_t i
, nskip
= 0, digits
= 0;
2638 /* Read a decimal integer. */
2639 while ((c
= READCHAR
) >= 0
2640 && c
>= '0' && c
<= '9')
2642 if ((STRING_BYTES_BOUND
- extra
) / 10 <= nskip
)
2647 if (digits
== 2 && nskip
== 0)
2648 { /* We've just seen #@00, which means "skip to end". */
2649 skip_dyn_eof (readcharfun
);
2654 /* We can't use UNREAD here, because in the code below we side-step
2655 READCHAR. Instead, assume the first char after #@NNN occupies
2656 a single byte, which is the case normally since it's just
2662 if (load_force_doc_strings
2663 && (FROM_FILE_P (readcharfun
)))
2665 /* If we are supposed to force doc strings into core right now,
2666 record the last string that we skipped,
2667 and record where in the file it comes from. */
2669 /* But first exchange saved_doc_string
2670 with prev_saved_doc_string, so we save two strings. */
2672 char *temp
= saved_doc_string
;
2673 ptrdiff_t temp_size
= saved_doc_string_size
;
2674 file_offset temp_pos
= saved_doc_string_position
;
2675 ptrdiff_t temp_len
= saved_doc_string_length
;
2677 saved_doc_string
= prev_saved_doc_string
;
2678 saved_doc_string_size
= prev_saved_doc_string_size
;
2679 saved_doc_string_position
= prev_saved_doc_string_position
;
2680 saved_doc_string_length
= prev_saved_doc_string_length
;
2682 prev_saved_doc_string
= temp
;
2683 prev_saved_doc_string_size
= temp_size
;
2684 prev_saved_doc_string_position
= temp_pos
;
2685 prev_saved_doc_string_length
= temp_len
;
2688 if (saved_doc_string_size
== 0)
2690 saved_doc_string
= xmalloc (nskip
+ extra
);
2691 saved_doc_string_size
= nskip
+ extra
;
2693 if (nskip
> saved_doc_string_size
)
2695 saved_doc_string
= xrealloc (saved_doc_string
, nskip
+ extra
);
2696 saved_doc_string_size
= nskip
+ extra
;
2699 saved_doc_string_position
= file_tell (instream
);
2701 /* Copy that many characters into saved_doc_string. */
2703 for (i
= 0; i
< nskip
&& c
>= 0; i
++)
2704 saved_doc_string
[i
] = c
= getc (instream
);
2707 saved_doc_string_length
= i
;
2710 /* Skip that many bytes. */
2711 skip_dyn_bytes (readcharfun
, nskip
);
2717 /* #! appears at the beginning of an executable file.
2718 Skip the first line. */
2719 while (c
!= '\n' && c
>= 0)
2724 return Vload_file_name
;
2726 return list2 (Qfunction
, read0 (readcharfun
));
2727 /* #:foo is the uninterned symbol named foo. */
2730 uninterned_symbol
= 1;
2733 && c
!= 0xa0 /* NBSP */
2735 || strchr ("\"';()[]#`,", c
) == NULL
)))
2737 /* No symbol character follows, this is the empty
2740 return Fmake_symbol (empty_unibyte_string
);
2744 /* ## is the empty symbol. */
2746 return Fintern (empty_unibyte_string
, Qnil
);
2747 /* Reader forms that can reuse previously read objects. */
2748 if (c
>= '0' && c
<= '9')
2753 /* Read a non-negative integer. */
2754 while (c
>= '0' && c
<= '9')
2756 if (MOST_POSITIVE_FIXNUM
/ 10 < n
2757 || MOST_POSITIVE_FIXNUM
< n
* 10 + c
- '0')
2758 n
= MOST_POSITIVE_FIXNUM
+ 1;
2760 n
= n
* 10 + c
- '0';
2764 if (n
<= MOST_POSITIVE_FIXNUM
)
2766 if (c
== 'r' || c
== 'R')
2767 return read_integer (readcharfun
, n
);
2769 if (! NILP (Vread_circle
))
2771 /* #n=object returns object, but associates it with
2775 /* Make a placeholder for #n# to use temporarily. */
2776 Lisp_Object placeholder
;
2779 placeholder
= Fcons (Qnil
, Qnil
);
2780 cell
= Fcons (make_number (n
), placeholder
);
2781 read_objects
= Fcons (cell
, read_objects
);
2783 /* Read the object itself. */
2784 tem
= read0 (readcharfun
);
2786 /* Now put it everywhere the placeholder was... */
2787 substitute_object_in_subtree (tem
, placeholder
);
2789 /* ...and #n# will use the real value from now on. */
2790 Fsetcdr (cell
, tem
);
2795 /* #n# returns a previously read object. */
2798 tem
= Fassq (make_number (n
), read_objects
);
2804 /* Fall through to error message. */
2806 else if (c
== 'x' || c
== 'X')
2807 return read_integer (readcharfun
, 16);
2808 else if (c
== 'o' || c
== 'O')
2809 return read_integer (readcharfun
, 8);
2810 else if (c
== 'b' || c
== 'B')
2811 return read_integer (readcharfun
, 2);
2814 invalid_syntax ("#");
2817 while ((c
= READCHAR
) >= 0 && c
!= '\n');
2821 return list2 (Qquote
, read0 (readcharfun
));
2825 int next_char
= READCHAR
;
2827 /* Transition from old-style to new-style:
2828 If we see "(`" it used to mean old-style, which usually works
2829 fine because ` should almost never appear in such a position
2830 for new-style. But occasionally we need "(`" to mean new
2831 style, so we try to distinguish the two by the fact that we
2832 can either write "( `foo" or "(` foo", where the first
2833 intends to use new-style whereas the second intends to use
2834 old-style. For Emacs-25, we should completely remove this
2835 first_in_list exception (old-style can still be obtained via
2837 if (!new_backquote_flag
&& first_in_list
&& next_char
== ' ')
2839 Vold_style_backquotes
= Qt
;
2845 bool saved_new_backquote_flag
= new_backquote_flag
;
2847 new_backquote_flag
= 1;
2848 value
= read0 (readcharfun
);
2849 new_backquote_flag
= saved_new_backquote_flag
;
2851 return list2 (Qbackquote
, value
);
2856 int next_char
= READCHAR
;
2858 /* Transition from old-style to new-style:
2859 It used to be impossible to have a new-style , other than within
2860 a new-style `. This is sufficient when ` and , are used in the
2861 normal way, but ` and , can also appear in args to macros that
2862 will not interpret them in the usual way, in which case , may be
2863 used without any ` anywhere near.
2864 So we now use the same heuristic as for backquote: old-style
2865 unquotes are only recognized when first on a list, and when
2866 followed by a space.
2867 Because it's more difficult to peek 2 chars ahead, a new-style
2868 ,@ can still not be used outside of a `, unless it's in the middle
2870 if (new_backquote_flag
2872 || (next_char
!= ' ' && next_char
!= '@'))
2874 Lisp_Object comma_type
= Qnil
;
2879 comma_type
= Qcomma_at
;
2881 comma_type
= Qcomma_dot
;
2884 if (ch
>= 0) UNREAD (ch
);
2885 comma_type
= Qcomma
;
2888 value
= read0 (readcharfun
);
2889 return list2 (comma_type
, value
);
2893 Vold_style_backquotes
= Qt
;
2905 end_of_file_error ();
2907 /* Accept `single space' syntax like (list ? x) where the
2908 whitespace character is SPC or TAB.
2909 Other literal whitespace like NL, CR, and FF are not accepted,
2910 as there are well-established escape sequences for these. */
2911 if (c
== ' ' || c
== '\t')
2912 return make_number (c
);
2915 c
= read_escape (readcharfun
, 0);
2916 modifiers
= c
& CHAR_MODIFIER_MASK
;
2917 c
&= ~CHAR_MODIFIER_MASK
;
2918 if (CHAR_BYTE8_P (c
))
2919 c
= CHAR_TO_BYTE8 (c
);
2922 next_char
= READCHAR
;
2923 ok
= (next_char
<= 040
2924 || (next_char
< 0200
2925 && strchr ("\"';()[]#?`,.", next_char
) != NULL
));
2928 return make_number (c
);
2930 invalid_syntax ("?");
2935 char *p
= read_buffer
;
2936 char *end
= read_buffer
+ read_buffer_size
;
2938 /* True if we saw an escape sequence specifying
2939 a multibyte character. */
2940 bool force_multibyte
= 0;
2941 /* True if we saw an escape sequence specifying
2942 a single-byte character. */
2943 bool force_singlebyte
= 0;
2945 ptrdiff_t nchars
= 0;
2947 while ((ch
= READCHAR
) >= 0
2950 if (end
- p
< MAX_MULTIBYTE_LENGTH
)
2952 ptrdiff_t offset
= p
- read_buffer
;
2953 if (min (PTRDIFF_MAX
, SIZE_MAX
) / 2 < read_buffer_size
)
2954 memory_full (SIZE_MAX
);
2955 read_buffer
= xrealloc (read_buffer
, read_buffer_size
* 2);
2956 read_buffer_size
*= 2;
2957 p
= read_buffer
+ offset
;
2958 end
= read_buffer
+ read_buffer_size
;
2965 ch
= read_escape (readcharfun
, 1);
2967 /* CH is -1 if \ newline has just been seen. */
2970 if (p
== read_buffer
)
2975 modifiers
= ch
& CHAR_MODIFIER_MASK
;
2976 ch
= ch
& ~CHAR_MODIFIER_MASK
;
2978 if (CHAR_BYTE8_P (ch
))
2979 force_singlebyte
= 1;
2980 else if (! ASCII_CHAR_P (ch
))
2981 force_multibyte
= 1;
2982 else /* I.e. ASCII_CHAR_P (ch). */
2984 /* Allow `\C- ' and `\C-?'. */
2985 if (modifiers
== CHAR_CTL
)
2988 ch
= 0, modifiers
= 0;
2990 ch
= 127, modifiers
= 0;
2992 if (modifiers
& CHAR_SHIFT
)
2994 /* Shift modifier is valid only with [A-Za-z]. */
2995 if (ch
>= 'A' && ch
<= 'Z')
2996 modifiers
&= ~CHAR_SHIFT
;
2997 else if (ch
>= 'a' && ch
<= 'z')
2998 ch
-= ('a' - 'A'), modifiers
&= ~CHAR_SHIFT
;
3001 if (modifiers
& CHAR_META
)
3003 /* Move the meta bit to the right place for a
3005 modifiers
&= ~CHAR_META
;
3006 ch
= BYTE8_TO_CHAR (ch
| 0x80);
3007 force_singlebyte
= 1;
3011 /* Any modifiers remaining are invalid. */
3013 error ("Invalid modifier in string");
3014 p
+= CHAR_STRING (ch
, (unsigned char *) p
);
3018 p
+= CHAR_STRING (ch
, (unsigned char *) p
);
3019 if (CHAR_BYTE8_P (ch
))
3020 force_singlebyte
= 1;
3021 else if (! ASCII_CHAR_P (ch
))
3022 force_multibyte
= 1;
3028 end_of_file_error ();
3030 /* If purifying, and string starts with \ newline,
3031 return zero instead. This is for doc strings
3032 that we are really going to find in etc/DOC.nn.nn. */
3033 if (!NILP (Vpurify_flag
) && NILP (Vdoc_file_name
) && cancel
)
3034 return make_number (0);
3036 if (! force_multibyte
&& force_singlebyte
)
3038 /* READ_BUFFER contains raw 8-bit bytes and no multibyte
3039 forms. Convert it to unibyte. */
3040 nchars
= str_as_unibyte ((unsigned char *) read_buffer
,
3042 p
= read_buffer
+ nchars
;
3045 return make_specified_string (read_buffer
, nchars
, p
- read_buffer
,
3047 || (p
- read_buffer
!= nchars
)));
3052 int next_char
= READCHAR
;
3055 if (next_char
<= 040
3056 || (next_char
< 0200
3057 && strchr ("\"';([#?`,", next_char
) != NULL
))
3063 /* Otherwise, we fall through! Note that the atom-reading loop
3064 below will now loop at least once, assuring that we will not
3065 try to UNREAD two characters in a row. */
3069 if (c
<= 040) goto retry
;
3070 if (c
== 0xa0) /* NBSP */
3075 char *p
= read_buffer
;
3077 EMACS_INT start_position
= readchar_count
- 1;
3080 char *end
= read_buffer
+ read_buffer_size
;
3084 if (end
- p
< MAX_MULTIBYTE_LENGTH
)
3086 ptrdiff_t offset
= p
- read_buffer
;
3087 if (min (PTRDIFF_MAX
, SIZE_MAX
) / 2 < read_buffer_size
)
3088 memory_full (SIZE_MAX
);
3089 read_buffer
= xrealloc (read_buffer
, read_buffer_size
* 2);
3090 read_buffer_size
*= 2;
3091 p
= read_buffer
+ offset
;
3092 end
= read_buffer
+ read_buffer_size
;
3099 end_of_file_error ();
3104 p
+= CHAR_STRING (c
, (unsigned char *) p
);
3110 && c
!= 0xa0 /* NBSP */
3112 || strchr ("\"';()[]#`,", c
) == NULL
));
3116 ptrdiff_t offset
= p
- read_buffer
;
3117 if (min (PTRDIFF_MAX
, SIZE_MAX
) / 2 < read_buffer_size
)
3118 memory_full (SIZE_MAX
);
3119 read_buffer
= xrealloc (read_buffer
, read_buffer_size
* 2);
3120 read_buffer_size
*= 2;
3121 p
= read_buffer
+ offset
;
3122 end
= read_buffer
+ read_buffer_size
;
3128 if (!quoted
&& !uninterned_symbol
)
3130 Lisp_Object result
= string_to_number (read_buffer
, 10, 0);
3131 if (! NILP (result
))
3135 Lisp_Object name
, result
;
3136 ptrdiff_t nbytes
= p
- read_buffer
;
3139 ? multibyte_chars_in_text ((unsigned char *) read_buffer
,
3143 name
= ((uninterned_symbol
&& ! NILP (Vpurify_flag
)
3144 ? make_pure_string
: make_specified_string
)
3145 (read_buffer
, nchars
, nbytes
, multibyte
));
3146 result
= (uninterned_symbol
? Fmake_symbol (name
)
3147 : Fintern (name
, Qnil
));
3149 if (EQ (Vread_with_symbol_positions
, Qt
)
3150 || EQ (Vread_with_symbol_positions
, readcharfun
))
3151 Vread_symbol_positions_list
3152 = Fcons (Fcons (result
, make_number (start_position
)),
3153 Vread_symbol_positions_list
);
3161 /* List of nodes we've seen during substitute_object_in_subtree. */
3162 static Lisp_Object seen_list
;
3165 substitute_object_in_subtree (Lisp_Object object
, Lisp_Object placeholder
)
3167 Lisp_Object check_object
;
3169 /* We haven't seen any objects when we start. */
3172 /* Make all the substitutions. */
3174 = substitute_object_recurse (object
, placeholder
, object
);
3176 /* Clear seen_list because we're done with it. */
3179 /* The returned object here is expected to always eq the
3181 if (!EQ (check_object
, object
))
3182 error ("Unexpected mutation error in reader");
3185 /* Feval doesn't get called from here, so no gc protection is needed. */
3186 #define SUBSTITUTE(get_val, set_val) \
3188 Lisp_Object old_value = get_val; \
3189 Lisp_Object true_value \
3190 = substitute_object_recurse (object, placeholder, \
3193 if (!EQ (old_value, true_value)) \
3200 substitute_object_recurse (Lisp_Object object
, Lisp_Object placeholder
, Lisp_Object subtree
)
3202 /* If we find the placeholder, return the target object. */
3203 if (EQ (placeholder
, subtree
))
3206 /* If we've been to this node before, don't explore it again. */
3207 if (!EQ (Qnil
, Fmemq (subtree
, seen_list
)))
3210 /* If this node can be the entry point to a cycle, remember that
3211 we've seen it. It can only be such an entry point if it was made
3212 by #n=, which means that we can find it as a value in
3214 if (!EQ (Qnil
, Frassq (subtree
, read_objects
)))
3215 seen_list
= Fcons (subtree
, seen_list
);
3217 /* Recurse according to subtree's type.
3218 Every branch must return a Lisp_Object. */
3219 switch (XTYPE (subtree
))
3221 case Lisp_Vectorlike
:
3223 ptrdiff_t i
, length
= 0;
3224 if (BOOL_VECTOR_P (subtree
))
3225 return subtree
; /* No sub-objects anyway. */
3226 else if (CHAR_TABLE_P (subtree
) || SUB_CHAR_TABLE_P (subtree
)
3227 || COMPILEDP (subtree
))
3228 length
= ASIZE (subtree
) & PSEUDOVECTOR_SIZE_MASK
;
3229 else if (VECTORP (subtree
))
3230 length
= ASIZE (subtree
);
3232 /* An unknown pseudovector may contain non-Lisp fields, so we
3233 can't just blindly traverse all its fields. We used to call
3234 `Flength' which signaled `sequencep', so I just preserved this
3236 wrong_type_argument (Qsequencep
, subtree
);
3238 for (i
= 0; i
< length
; i
++)
3239 SUBSTITUTE (AREF (subtree
, i
),
3240 ASET (subtree
, i
, true_value
));
3246 SUBSTITUTE (XCAR (subtree
),
3247 XSETCAR (subtree
, true_value
));
3248 SUBSTITUTE (XCDR (subtree
),
3249 XSETCDR (subtree
, true_value
));
3255 /* Check for text properties in each interval.
3256 substitute_in_interval contains part of the logic. */
3258 INTERVAL root_interval
= string_intervals (subtree
);
3259 Lisp_Object arg
= Fcons (object
, placeholder
);
3261 traverse_intervals_noorder (root_interval
,
3262 &substitute_in_interval
, arg
);
3267 /* Other types don't recurse any further. */
3273 /* Helper function for substitute_object_recurse. */
3275 substitute_in_interval (INTERVAL interval
, Lisp_Object arg
)
3277 Lisp_Object object
= Fcar (arg
);
3278 Lisp_Object placeholder
= Fcdr (arg
);
3280 SUBSTITUTE (interval
->plist
, set_interval_plist (interval
, true_value
));
3290 /* Convert STRING to a number, assuming base BASE. Return a fixnum if CP has
3291 integer syntax and fits in a fixnum, else return the nearest float if CP has
3292 either floating point or integer syntax and BASE is 10, else return nil. If
3293 IGNORE_TRAILING, consider just the longest prefix of CP that has
3294 valid floating point syntax. Signal an overflow if BASE is not 10 and the
3295 number has integer syntax but does not fit. */
3298 string_to_number (char const *string
, int base
, bool ignore_trailing
)
3301 char const *cp
= string
;
3303 bool float_syntax
= 0;
3306 /* Compute NaN and infinities using a variable, to cope with compilers that
3307 think they are smarter than we are. */
3310 /* Negate the value ourselves. This treats 0, NaNs, and infinity properly on
3311 IEEE floating point hosts, and works around a formerly-common bug where
3312 atof ("-0.0") drops the sign. */
3313 bool negative
= *cp
== '-';
3315 bool signedp
= negative
|| *cp
== '+';
3320 leading_digit
= digit_to_number (*cp
, base
);
3321 if (leading_digit
>= 0)
3326 while (digit_to_number (*cp
, base
) >= 0);
3336 if ('0' <= *cp
&& *cp
<= '9')
3341 while ('0' <= *cp
&& *cp
<= '9');
3343 if (*cp
== 'e' || *cp
== 'E')
3345 char const *ecp
= cp
;
3347 if (*cp
== '+' || *cp
== '-')
3349 if ('0' <= *cp
&& *cp
<= '9')
3354 while ('0' <= *cp
&& *cp
<= '9');
3356 else if (cp
[-1] == '+'
3357 && cp
[0] == 'I' && cp
[1] == 'N' && cp
[2] == 'F')
3363 else if (cp
[-1] == '+'
3364 && cp
[0] == 'N' && cp
[1] == 'a' && cp
[2] == 'N')
3368 value
= zero
/ zero
;
3370 /* If that made a "negative" NaN, negate it. */
3373 union { double d
; char c
[sizeof (double)]; }
3374 u_data
, u_minus_zero
;
3376 u_minus_zero
.d
= -0.0;
3377 for (i
= 0; i
< sizeof (double); i
++)
3378 if (u_data
.c
[i
] & u_minus_zero
.c
[i
])
3384 /* Now VALUE is a positive NaN. */
3390 float_syntax
= ((state
& (DOT_CHAR
|TRAIL_INT
)) == (DOT_CHAR
|TRAIL_INT
)
3391 || state
== (LEAD_INT
|E_EXP
));
3394 /* Return nil if the number uses invalid syntax. If IGNORE_TRAILING, accept
3395 any prefix that matches. Otherwise, the entire string must match. */
3396 if (! (ignore_trailing
3397 ? ((state
& LEAD_INT
) != 0 || float_syntax
)
3398 : (!*cp
&& ((state
& ~DOT_CHAR
) == LEAD_INT
|| float_syntax
))))
3401 /* If the number uses integer and not float syntax, and is in C-language
3402 range, use its value, preferably as a fixnum. */
3403 if (leading_digit
>= 0 && ! float_syntax
)
3407 /* Fast special case for single-digit integers. This also avoids a
3408 glitch when BASE is 16 and IGNORE_TRAILING, because in that
3409 case some versions of strtoumax accept numbers like "0x1" that Emacs
3411 if (digit_to_number (string
[signedp
+ 1], base
) < 0)
3412 return make_number (negative
? -leading_digit
: leading_digit
);
3415 n
= strtoumax (string
+ signedp
, NULL
, base
);
3416 if (errno
== ERANGE
)
3418 /* Unfortunately there's no simple and accurate way to convert
3419 non-base-10 numbers that are out of C-language range. */
3421 xsignal1 (Qoverflow_error
, build_string (string
));
3423 else if (n
<= (negative
? -MOST_NEGATIVE_FIXNUM
: MOST_POSITIVE_FIXNUM
))
3425 EMACS_INT signed_n
= n
;
3426 return make_number (negative
? -signed_n
: signed_n
);
3432 /* Either the number uses float syntax, or it does not fit into a fixnum.
3433 Convert it from string to floating point, unless the value is already
3434 known because it is an infinity, a NAN, or its absolute value fits in
3437 value
= atof (string
+ signedp
);
3439 return make_float (negative
? -value
: value
);
3444 read_vector (Lisp_Object readcharfun
, bool bytecodeflag
)
3448 Lisp_Object tem
, item
, vector
;
3449 struct Lisp_Cons
*otem
;
3452 tem
= read_list (1, readcharfun
);
3453 len
= Flength (tem
);
3454 vector
= Fmake_vector (len
, Qnil
);
3456 size
= ASIZE (vector
);
3457 ptr
= XVECTOR (vector
)->contents
;
3458 for (i
= 0; i
< size
; i
++)
3461 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3462 bytecode object, the docstring containing the bytecode and
3463 constants values must be treated as unibyte and passed to
3464 Fread, to get the actual bytecode string and constants vector. */
3465 if (bytecodeflag
&& load_force_doc_strings
)
3467 if (i
== COMPILED_BYTECODE
)
3469 if (!STRINGP (item
))
3470 error ("Invalid byte code");
3472 /* Delay handling the bytecode slot until we know whether
3473 it is lazily-loaded (we can tell by whether the
3474 constants slot is nil). */
3475 ASET (vector
, COMPILED_CONSTANTS
, item
);
3478 else if (i
== COMPILED_CONSTANTS
)
3480 Lisp_Object bytestr
= ptr
[COMPILED_CONSTANTS
];
3484 /* Coerce string to unibyte (like string-as-unibyte,
3485 but without generating extra garbage and
3486 guaranteeing no change in the contents). */
3487 STRING_SET_CHARS (bytestr
, SBYTES (bytestr
));
3488 STRING_SET_UNIBYTE (bytestr
);
3490 item
= Fread (Fcons (bytestr
, readcharfun
));
3492 error ("Invalid byte code");
3494 otem
= XCONS (item
);
3495 bytestr
= XCAR (item
);
3500 /* Now handle the bytecode slot. */
3501 ASET (vector
, COMPILED_BYTECODE
, bytestr
);
3503 else if (i
== COMPILED_DOC_STRING
3505 && ! STRING_MULTIBYTE (item
))
3507 if (EQ (readcharfun
, Qget_emacs_mule_file_char
))
3508 item
= Fdecode_coding_string (item
, Qemacs_mule
, Qnil
, Qnil
);
3510 item
= Fstring_as_multibyte (item
);
3513 ASET (vector
, i
, item
);
3521 /* FLAG means check for ] to terminate rather than ) and . */
3524 read_list (bool flag
, Lisp_Object readcharfun
)
3526 Lisp_Object val
, tail
;
3527 Lisp_Object elt
, tem
;
3528 struct gcpro gcpro1
, gcpro2
;
3529 /* 0 is the normal case.
3530 1 means this list is a doc reference; replace it with the number 0.
3531 2 means this list is a doc reference; replace it with the doc string. */
3532 int doc_reference
= 0;
3534 /* Initialize this to 1 if we are reading a list. */
3535 bool first_in_list
= flag
<= 0;
3544 elt
= read1 (readcharfun
, &ch
, first_in_list
);
3549 /* While building, if the list starts with #$, treat it specially. */
3550 if (EQ (elt
, Vload_file_name
)
3552 && !NILP (Vpurify_flag
))
3554 if (NILP (Vdoc_file_name
))
3555 /* We have not yet called Snarf-documentation, so assume
3556 this file is described in the DOC file
3557 and Snarf-documentation will fill in the right value later.
3558 For now, replace the whole list with 0. */
3561 /* We have already called Snarf-documentation, so make a relative
3562 file name for this file, so it can be found properly
3563 in the installed Lisp directory.
3564 We don't use Fexpand_file_name because that would make
3565 the directory absolute now. */
3566 elt
= concat2 (build_string ("../lisp/"),
3567 Ffile_name_nondirectory (elt
));
3569 else if (EQ (elt
, Vload_file_name
)
3571 && load_force_doc_strings
)
3580 invalid_syntax (") or . in a vector");
3588 XSETCDR (tail
, read0 (readcharfun
));
3590 val
= read0 (readcharfun
);
3591 read1 (readcharfun
, &ch
, 0);
3595 if (doc_reference
== 1)
3596 return make_number (0);
3597 if (doc_reference
== 2 && INTEGERP (XCDR (val
)))
3600 file_offset saved_position
;
3601 /* Get a doc string from the file we are loading.
3602 If it's in saved_doc_string, get it from there.
3604 Here, we don't know if the string is a
3605 bytecode string or a doc string. As a
3606 bytecode string must be unibyte, we always
3607 return a unibyte string. If it is actually a
3608 doc string, caller must make it
3611 /* Position is negative for user variables. */
3612 EMACS_INT pos
= eabs (XINT (XCDR (val
)));
3613 if (pos
>= saved_doc_string_position
3614 && pos
< (saved_doc_string_position
3615 + saved_doc_string_length
))
3617 saved
= saved_doc_string
;
3618 saved_position
= saved_doc_string_position
;
3620 /* Look in prev_saved_doc_string the same way. */
3621 else if (pos
>= prev_saved_doc_string_position
3622 && pos
< (prev_saved_doc_string_position
3623 + prev_saved_doc_string_length
))
3625 saved
= prev_saved_doc_string
;
3626 saved_position
= prev_saved_doc_string_position
;
3630 ptrdiff_t start
= pos
- saved_position
;
3633 /* Process quoting with ^A,
3634 and find the end of the string,
3635 which is marked with ^_ (037). */
3636 for (from
= start
, to
= start
;
3637 saved
[from
] != 037;)
3639 int c
= saved
[from
++];
3643 saved
[to
++] = (c
== 1 ? c
3652 return make_unibyte_string (saved
+ start
,
3656 return get_doc_string (val
, 1, 0);
3661 invalid_syntax (". in wrong context");
3663 invalid_syntax ("] in a list");
3667 XSETCDR (tail
, tem
);
3674 static Lisp_Object initial_obarray
;
3676 /* `oblookup' stores the bucket number here, for the sake of Funintern. */
3678 static size_t oblookup_last_bucket_number
;
3680 /* Get an error if OBARRAY is not an obarray.
3681 If it is one, return it. */
3684 check_obarray (Lisp_Object obarray
)
3686 if (!VECTORP (obarray
) || ASIZE (obarray
) == 0)
3688 /* If Vobarray is now invalid, force it to be valid. */
3689 if (EQ (Vobarray
, obarray
)) Vobarray
= initial_obarray
;
3690 wrong_type_argument (Qvectorp
, obarray
);
3695 /* Intern the C string STR: return a symbol with that name,
3696 interned in the current obarray. */
3699 intern_1 (const char *str
, ptrdiff_t len
)
3701 Lisp_Object obarray
= check_obarray (Vobarray
);
3702 Lisp_Object tem
= oblookup (obarray
, str
, len
, len
);
3704 return SYMBOLP (tem
) ? tem
: Fintern (make_string (str
, len
), obarray
);
3708 intern_c_string_1 (const char *str
, ptrdiff_t len
)
3710 Lisp_Object obarray
= check_obarray (Vobarray
);
3711 Lisp_Object tem
= oblookup (obarray
, str
, len
, len
);
3716 if (NILP (Vpurify_flag
))
3717 /* Creating a non-pure string from a string literal not
3718 implemented yet. We could just use make_string here and live
3719 with the extra copy. */
3722 return Fintern (make_pure_c_string (str
, len
), obarray
);
3725 DEFUN ("intern", Fintern
, Sintern
, 1, 2, 0,
3726 doc
: /* Return the canonical symbol whose name is STRING.
3727 If there is none, one is created by this function and returned.
3728 A second optional argument specifies the obarray to use;
3729 it defaults to the value of `obarray'. */)
3730 (Lisp_Object string
, Lisp_Object obarray
)
3732 register Lisp_Object tem
, sym
, *ptr
;
3734 if (NILP (obarray
)) obarray
= Vobarray
;
3735 obarray
= check_obarray (obarray
);
3737 CHECK_STRING (string
);
3739 tem
= oblookup (obarray
, SSDATA (string
),
3742 if (!INTEGERP (tem
))
3745 if (!NILP (Vpurify_flag
))
3746 string
= Fpurecopy (string
);
3747 sym
= Fmake_symbol (string
);
3749 if (EQ (obarray
, initial_obarray
))
3750 XSYMBOL (sym
)->interned
= SYMBOL_INTERNED_IN_INITIAL_OBARRAY
;
3752 XSYMBOL (sym
)->interned
= SYMBOL_INTERNED
;
3754 if ((SREF (string
, 0) == ':')
3755 && EQ (obarray
, initial_obarray
))
3757 XSYMBOL (sym
)->constant
= 1;
3758 XSYMBOL (sym
)->redirect
= SYMBOL_PLAINVAL
;
3759 SET_SYMBOL_VAL (XSYMBOL (sym
), sym
);
3762 ptr
= aref_addr (obarray
, XINT(tem
));
3764 set_symbol_next (sym
, XSYMBOL (*ptr
));
3766 set_symbol_next (sym
, NULL
);
3771 DEFUN ("intern-soft", Fintern_soft
, Sintern_soft
, 1, 2, 0,
3772 doc
: /* Return the canonical symbol named NAME, or nil if none exists.
3773 NAME may be a string or a symbol. If it is a symbol, that exact
3774 symbol is searched for.
3775 A second optional argument specifies the obarray to use;
3776 it defaults to the value of `obarray'. */)
3777 (Lisp_Object name
, Lisp_Object obarray
)
3779 register Lisp_Object tem
, string
;
3781 if (NILP (obarray
)) obarray
= Vobarray
;
3782 obarray
= check_obarray (obarray
);
3784 if (!SYMBOLP (name
))
3786 CHECK_STRING (name
);
3790 string
= SYMBOL_NAME (name
);
3792 tem
= oblookup (obarray
, SSDATA (string
), SCHARS (string
), SBYTES (string
));
3793 if (INTEGERP (tem
) || (SYMBOLP (name
) && !EQ (name
, tem
)))
3799 DEFUN ("unintern", Funintern
, Sunintern
, 1, 2, 0,
3800 doc
: /* Delete the symbol named NAME, if any, from OBARRAY.
3801 The value is t if a symbol was found and deleted, nil otherwise.
3802 NAME may be a string or a symbol. If it is a symbol, that symbol
3803 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3804 OBARRAY defaults to the value of the variable `obarray'. */)
3805 (Lisp_Object name
, Lisp_Object obarray
)
3807 register Lisp_Object string
, tem
;
3810 if (NILP (obarray
)) obarray
= Vobarray
;
3811 obarray
= check_obarray (obarray
);
3814 string
= SYMBOL_NAME (name
);
3817 CHECK_STRING (name
);
3821 tem
= oblookup (obarray
, SSDATA (string
),
3826 /* If arg was a symbol, don't delete anything but that symbol itself. */
3827 if (SYMBOLP (name
) && !EQ (name
, tem
))
3830 /* There are plenty of other symbols which will screw up the Emacs
3831 session if we unintern them, as well as even more ways to use
3832 `setq' or `fset' or whatnot to make the Emacs session
3833 unusable. Let's not go down this silly road. --Stef */
3834 /* if (EQ (tem, Qnil) || EQ (tem, Qt))
3835 error ("Attempt to unintern t or nil"); */
3837 XSYMBOL (tem
)->interned
= SYMBOL_UNINTERNED
;
3839 hash
= oblookup_last_bucket_number
;
3841 if (EQ (AREF (obarray
, hash
), tem
))
3843 if (XSYMBOL (tem
)->next
)
3846 XSETSYMBOL (sym
, XSYMBOL (tem
)->next
);
3847 ASET (obarray
, hash
, sym
);
3850 ASET (obarray
, hash
, make_number (0));
3854 Lisp_Object tail
, following
;
3856 for (tail
= AREF (obarray
, hash
);
3857 XSYMBOL (tail
)->next
;
3860 XSETSYMBOL (following
, XSYMBOL (tail
)->next
);
3861 if (EQ (following
, tem
))
3863 set_symbol_next (tail
, XSYMBOL (following
)->next
);
3872 /* Return the symbol in OBARRAY whose names matches the string
3873 of SIZE characters (SIZE_BYTE bytes) at PTR.
3874 If there is no such symbol in OBARRAY, return nil.
3876 Also store the bucket number in oblookup_last_bucket_number. */
3879 oblookup (Lisp_Object obarray
, register const char *ptr
, ptrdiff_t size
, ptrdiff_t size_byte
)
3883 register Lisp_Object tail
;
3884 Lisp_Object bucket
, tem
;
3886 obarray
= check_obarray (obarray
);
3887 obsize
= ASIZE (obarray
);
3889 /* This is sometimes needed in the middle of GC. */
3890 obsize
&= ~ARRAY_MARK_FLAG
;
3891 hash
= hash_string (ptr
, size_byte
) % obsize
;
3892 bucket
= AREF (obarray
, hash
);
3893 oblookup_last_bucket_number
= hash
;
3894 if (EQ (bucket
, make_number (0)))
3896 else if (!SYMBOLP (bucket
))
3897 error ("Bad data in guts of obarray"); /* Like CADR error message. */
3899 for (tail
= bucket
; ; XSETSYMBOL (tail
, XSYMBOL (tail
)->next
))
3901 if (SBYTES (SYMBOL_NAME (tail
)) == size_byte
3902 && SCHARS (SYMBOL_NAME (tail
)) == size
3903 && !memcmp (SDATA (SYMBOL_NAME (tail
)), ptr
, size_byte
))
3905 else if (XSYMBOL (tail
)->next
== 0)
3908 XSETINT (tem
, hash
);
3913 map_obarray (Lisp_Object obarray
, void (*fn
) (Lisp_Object
, Lisp_Object
), Lisp_Object arg
)
3916 register Lisp_Object tail
;
3917 CHECK_VECTOR (obarray
);
3918 for (i
= ASIZE (obarray
) - 1; i
>= 0; i
--)
3920 tail
= AREF (obarray
, i
);
3925 if (XSYMBOL (tail
)->next
== 0)
3927 XSETSYMBOL (tail
, XSYMBOL (tail
)->next
);
3933 mapatoms_1 (Lisp_Object sym
, Lisp_Object function
)
3935 call1 (function
, sym
);
3938 DEFUN ("mapatoms", Fmapatoms
, Smapatoms
, 1, 2, 0,
3939 doc
: /* Call FUNCTION on every symbol in OBARRAY.
3940 OBARRAY defaults to the value of `obarray'. */)
3941 (Lisp_Object function
, Lisp_Object obarray
)
3943 if (NILP (obarray
)) obarray
= Vobarray
;
3944 obarray
= check_obarray (obarray
);
3946 map_obarray (obarray
, mapatoms_1
, function
);
3950 #define OBARRAY_SIZE 1511
3955 Lisp_Object oblength
;
3956 ptrdiff_t size
= 100 + MAX_MULTIBYTE_LENGTH
;
3958 XSETFASTINT (oblength
, OBARRAY_SIZE
);
3960 Vobarray
= Fmake_vector (oblength
, make_number (0));
3961 initial_obarray
= Vobarray
;
3962 staticpro (&initial_obarray
);
3964 Qunbound
= Fmake_symbol (build_pure_c_string ("unbound"));
3965 /* Set temporary dummy values to Qnil and Vpurify_flag to satisfy the
3966 NILP (Vpurify_flag) check in intern_c_string. */
3967 Qnil
= make_number (-1); Vpurify_flag
= make_number (1);
3968 Qnil
= intern_c_string ("nil");
3970 /* Fmake_symbol inits fields of new symbols with Qunbound and Qnil,
3971 so those two need to be fixed manually. */
3972 SET_SYMBOL_VAL (XSYMBOL (Qunbound
), Qunbound
);
3973 set_symbol_function (Qunbound
, Qnil
);
3974 set_symbol_plist (Qunbound
, Qnil
);
3975 SET_SYMBOL_VAL (XSYMBOL (Qnil
), Qnil
);
3976 XSYMBOL (Qnil
)->constant
= 1;
3977 XSYMBOL (Qnil
)->declared_special
= 1;
3978 set_symbol_plist (Qnil
, Qnil
);
3979 set_symbol_function (Qnil
, Qnil
);
3981 Qt
= intern_c_string ("t");
3982 SET_SYMBOL_VAL (XSYMBOL (Qt
), Qt
);
3983 XSYMBOL (Qnil
)->declared_special
= 1;
3984 XSYMBOL (Qt
)->constant
= 1;
3986 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3989 DEFSYM (Qvariable_documentation
, "variable-documentation");
3991 read_buffer
= xmalloc (size
);
3992 read_buffer_size
= size
;
3996 defsubr (struct Lisp_Subr
*sname
)
3998 Lisp_Object sym
, tem
;
3999 sym
= intern_c_string (sname
->symbol_name
);
4000 XSETPVECTYPE (sname
, PVEC_SUBR
);
4001 XSETSUBR (tem
, sname
);
4002 set_symbol_function (sym
, tem
);
4005 #ifdef NOTDEF /* Use fset in subr.el now! */
4007 defalias (struct Lisp_Subr
*sname
, char *string
)
4010 sym
= intern (string
);
4011 XSETSUBR (XSYMBOL (sym
)->function
, sname
);
4015 /* Define an "integer variable"; a symbol whose value is forwarded to a
4016 C variable of type EMACS_INT. Sample call (with "xx" to fool make-docfile):
4017 DEFxxVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
4019 defvar_int (struct Lisp_Intfwd
*i_fwd
,
4020 const char *namestring
, EMACS_INT
*address
)
4023 sym
= intern_c_string (namestring
);
4024 i_fwd
->type
= Lisp_Fwd_Int
;
4025 i_fwd
->intvar
= address
;
4026 XSYMBOL (sym
)->declared_special
= 1;
4027 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4028 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)i_fwd
);
4031 /* Similar but define a variable whose value is t if address contains 1,
4032 nil if address contains 0. */
4034 defvar_bool (struct Lisp_Boolfwd
*b_fwd
,
4035 const char *namestring
, bool *address
)
4038 sym
= intern_c_string (namestring
);
4039 b_fwd
->type
= Lisp_Fwd_Bool
;
4040 b_fwd
->boolvar
= address
;
4041 XSYMBOL (sym
)->declared_special
= 1;
4042 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4043 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)b_fwd
);
4044 Vbyte_boolean_vars
= Fcons (sym
, Vbyte_boolean_vars
);
4047 /* Similar but define a variable whose value is the Lisp Object stored
4048 at address. Two versions: with and without gc-marking of the C
4049 variable. The nopro version is used when that variable will be
4050 gc-marked for some other reason, since marking the same slot twice
4051 can cause trouble with strings. */
4053 defvar_lisp_nopro (struct Lisp_Objfwd
*o_fwd
,
4054 const char *namestring
, Lisp_Object
*address
)
4057 sym
= intern_c_string (namestring
);
4058 o_fwd
->type
= Lisp_Fwd_Obj
;
4059 o_fwd
->objvar
= address
;
4060 XSYMBOL (sym
)->declared_special
= 1;
4061 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4062 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)o_fwd
);
4066 defvar_lisp (struct Lisp_Objfwd
*o_fwd
,
4067 const char *namestring
, Lisp_Object
*address
)
4069 defvar_lisp_nopro (o_fwd
, namestring
, address
);
4070 staticpro (address
);
4073 /* Similar but define a variable whose value is the Lisp Object stored
4074 at a particular offset in the current kboard object. */
4077 defvar_kboard (struct Lisp_Kboard_Objfwd
*ko_fwd
,
4078 const char *namestring
, int offset
)
4081 sym
= intern_c_string (namestring
);
4082 ko_fwd
->type
= Lisp_Fwd_Kboard_Obj
;
4083 ko_fwd
->offset
= offset
;
4084 XSYMBOL (sym
)->declared_special
= 1;
4085 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4086 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)ko_fwd
);
4089 /* Check that the elements of Vload_path exist. */
4092 load_path_check (void)
4094 Lisp_Object path_tail
;
4096 /* The only elements that might not exist are those from
4097 PATH_LOADSEARCH, EMACSLOADPATH. Anything else is only added if
4099 for (path_tail
= Vload_path
; !NILP (path_tail
); path_tail
= XCDR (path_tail
))
4101 Lisp_Object dirfile
;
4102 dirfile
= Fcar (path_tail
);
4103 if (STRINGP (dirfile
))
4105 dirfile
= Fdirectory_file_name (dirfile
);
4106 if (! file_accessible_directory_p (SSDATA (dirfile
)))
4107 dir_warning ("Lisp directory", XCAR (path_tail
));
4112 /* Record the value of load-path used at the start of dumping
4113 so we can see if the site changed it later during dumping. */
4114 static Lisp_Object dump_path
;
4116 /* Compute the default Vload_path, with the following logic:
4118 use EMACSLOADPATH env-var if set; otherwise use PATH_LOADSEARCH,
4119 prepending PATH_SITELOADSEARCH unless --no-site-lisp.
4120 The remainder is what happens when dumping works:
4121 If purify-flag (ie dumping) just use PATH_DUMPLOADSEARCH.
4122 Otherwise use EMACSLOADPATH if set, else PATH_LOADSEARCH.
4124 If !initialized, then just set both Vload_path and dump_path.
4125 If initialized, then if Vload_path != dump_path, do nothing.
4126 (Presumably the load-path has already been changed by something.
4127 This can only be from a site-load file during dumping,
4128 or because EMACSLOADPATH is set.)
4129 If Vinstallation_directory is not nil (ie, running uninstalled):
4130 If installation-dir/lisp exists and not already a member,
4131 we must be running uninstalled. Reset the load-path
4132 to just installation-dir/lisp. (The default PATH_LOADSEARCH
4133 refers to the eventual installation directories. Since we
4134 are not yet installed, we should not use them, even if they exist.)
4135 If installation-dir/lisp does not exist, just add dump_path at the
4137 Add installation-dir/leim (if exists and not already a member) at the front.
4138 Add installation-dir/site-lisp (if !no_site_lisp, and exists
4139 and not already a member) at the front.
4140 If installation-dir != source-dir (ie running an uninstalled,
4141 out-of-tree build) AND install-dir/src/Makefile exists BUT
4142 install-dir/src/Makefile.in does NOT exist (this is a sanity
4143 check), then repeat the above steps for source-dir/lisp,
4145 Finally, add the site-lisp directories at the front (if !no_site_lisp).
4155 const char *loadpath
= ns_load_path ();
4158 normal
= PATH_LOADSEARCH
;
4160 Vload_path
= decode_env_path ("EMACSLOADPATH", loadpath
? loadpath
: normal
);
4162 Vload_path
= decode_env_path ("EMACSLOADPATH", normal
);
4167 /* FIXME CANNOT_DUMP platforms should get source-dir/lisp etc added
4168 to their load-path too, AFAICS. I don't think we can tell the
4169 difference between initialized and !initialized in this case,
4170 so we'll have to do it unconditionally when Vinstallation_directory
4172 if (!no_site_lisp
&& !egetenv ("EMACSLOADPATH"))
4174 Lisp_Object sitelisp
;
4175 sitelisp
= decode_env_path (0, PATH_SITELOADSEARCH
);
4176 if (! NILP (sitelisp
)) Vload_path
= nconc2 (sitelisp
, Vload_path
);
4178 #else /* !CANNOT_DUMP */
4179 if (NILP (Vpurify_flag
))
4181 normal
= PATH_LOADSEARCH
;
4182 /* If the EMACSLOADPATH environment variable is set, use its value.
4183 This doesn't apply if we're dumping. */
4184 if (egetenv ("EMACSLOADPATH"))
4185 Vload_path
= decode_env_path ("EMACSLOADPATH", normal
);
4188 normal
= PATH_DUMPLOADSEARCH
;
4190 /* In a dumped Emacs, we normally reset the value of Vload_path using
4191 PATH_LOADSEARCH, since the value that was dumped uses lisp/ in
4192 the source directory, instead of the path of the installed elisp
4193 libraries. However, if it appears that Vload_path has already been
4194 changed from the default that was saved before dumping, don't
4195 change it further. Changes can only be due to EMACSLOADPATH, or
4196 site-lisp files that were processed during dumping. */
4199 if (NILP (Fequal (dump_path
, Vload_path
)))
4201 /* Do not make any changes, just check the elements exist. */
4202 /* Note: --no-site-lisp is ignored.
4203 I don't know what to do about this. */
4209 const char *loadpath
= ns_load_path ();
4210 Vload_path
= decode_env_path (0, loadpath
? loadpath
: normal
);
4212 Vload_path
= decode_env_path (0, normal
);
4214 if (!NILP (Vinstallation_directory
))
4216 Lisp_Object tem
, tem1
;
4218 /* Add to the path the lisp subdir of the installation
4219 dir, if it is accessible. Note: in out-of-tree builds,
4220 this directory is empty save for Makefile. */
4221 tem
= Fexpand_file_name (build_string ("lisp"),
4222 Vinstallation_directory
);
4223 tem1
= Ffile_accessible_directory_p (tem
);
4226 if (NILP (Fmember (tem
, Vload_path
)))
4228 /* We are running uninstalled. The default load-path
4229 points to the eventual installed lisp, leim
4230 directories. We should not use those now, even
4231 if they exist, so start over from a clean slate. */
4232 Vload_path
= list1 (tem
);
4236 /* That dir doesn't exist, so add the build-time
4237 Lisp dirs instead. */
4238 Vload_path
= nconc2 (Vload_path
, dump_path
);
4240 /* Add leim under the installation dir, if it is accessible. */
4241 tem
= Fexpand_file_name (build_string ("leim"),
4242 Vinstallation_directory
);
4243 tem1
= Ffile_accessible_directory_p (tem
);
4246 if (NILP (Fmember (tem
, Vload_path
)))
4247 Vload_path
= Fcons (tem
, Vload_path
);
4250 /* Add site-lisp under the installation dir, if it exists. */
4253 tem
= Fexpand_file_name (build_string ("site-lisp"),
4254 Vinstallation_directory
);
4255 tem1
= Ffile_accessible_directory_p (tem
);
4258 if (NILP (Fmember (tem
, Vload_path
)))
4259 Vload_path
= Fcons (tem
, Vload_path
);
4263 /* If Emacs was not built in the source directory,
4264 and it is run from where it was built, add to load-path
4265 the lisp, leim and site-lisp dirs under that directory. */
4267 if (NILP (Fequal (Vinstallation_directory
, Vsource_directory
)))
4271 tem
= Fexpand_file_name (build_string ("src/Makefile"),
4272 Vinstallation_directory
);
4273 tem1
= Ffile_exists_p (tem
);
4275 /* Don't be fooled if they moved the entire source tree
4276 AFTER dumping Emacs. If the build directory is indeed
4277 different from the source dir, src/Makefile.in and
4278 src/Makefile will not be found together. */
4279 tem
= Fexpand_file_name (build_string ("src/Makefile.in"),
4280 Vinstallation_directory
);
4281 tem2
= Ffile_exists_p (tem
);
4282 if (!NILP (tem1
) && NILP (tem2
))
4284 tem
= Fexpand_file_name (build_string ("lisp"),
4287 if (NILP (Fmember (tem
, Vload_path
)))
4288 Vload_path
= Fcons (tem
, Vload_path
);
4290 tem
= Fexpand_file_name (build_string ("leim"),
4293 if (NILP (Fmember (tem
, Vload_path
)))
4294 Vload_path
= Fcons (tem
, Vload_path
);
4298 tem
= Fexpand_file_name (build_string ("site-lisp"),
4300 tem1
= Ffile_accessible_directory_p (tem
);
4303 if (NILP (Fmember (tem
, Vload_path
)))
4304 Vload_path
= Fcons (tem
, Vload_path
);
4308 } /* Vinstallation_directory != Vsource_directory */
4310 } /* if Vinstallation_directory */
4312 /* Check before adding the site-lisp directories.
4313 The install should have created them, but they are not
4314 required, so no need to warn if they are absent.
4315 Or we might be running before installation. */
4318 /* Add the site-lisp directories at the front. */
4321 Lisp_Object sitelisp
;
4322 sitelisp
= decode_env_path (0, PATH_SITELOADSEARCH
);
4323 if (! NILP (sitelisp
)) Vload_path
= nconc2 (sitelisp
, Vload_path
);
4325 } /* if dump_path == Vload_path */
4327 else /* !initialized */
4329 /* NORMAL refers to PATH_DUMPLOADSEARCH, ie the lisp dir in the
4330 source directory. We used to add ../lisp (ie the lisp dir in
4331 the build directory) at the front here, but that caused trouble
4332 because it was copied from dump_path into Vload_path, above,
4333 when Vinstallation_directory was non-nil. It should not be
4334 necessary, since in out of tree builds lisp/ is empty, save
4336 Vload_path
= decode_env_path (0, normal
);
4337 dump_path
= Vload_path
;
4338 /* No point calling load_path_check; load-path only contains essential
4339 elements from the source directory at this point. They cannot
4340 be missing unless something went extremely (and improbably)
4341 wrong, in which case the build will fail in obvious ways. */
4343 #endif /* !CANNOT_DUMP */
4347 load_in_progress
= 0;
4348 Vload_file_name
= Qnil
;
4349 Vstandard_input
= Qt
;
4350 Vloads_in_progress
= Qnil
;
4353 /* Print a warning that directory intended for use USE and with name
4354 DIRNAME cannot be accessed. On entry, errno should correspond to
4355 the access failure. Print the warning on stderr and put it in
4359 dir_warning (char const *use
, Lisp_Object dirname
)
4361 static char const format
[] = "Warning: %s `%s': %s\n";
4362 int access_errno
= errno
;
4363 fprintf (stderr
, format
, use
, SSDATA (dirname
), strerror (access_errno
));
4365 /* Don't log the warning before we've initialized!! */
4368 char const *diagnostic
= emacs_strerror (access_errno
);
4370 char *buffer
= SAFE_ALLOCA (sizeof format
- 3 * (sizeof "%s" - 1)
4371 + strlen (use
) + SBYTES (dirname
)
4372 + strlen (diagnostic
));
4373 ptrdiff_t message_len
= esprintf (buffer
, format
, use
, SSDATA (dirname
),
4375 message_dolog (buffer
, message_len
, 0, STRING_MULTIBYTE (dirname
));
4381 syms_of_lread (void)
4384 defsubr (&Sread_from_string
);
4386 defsubr (&Sintern_soft
);
4387 defsubr (&Sunintern
);
4388 defsubr (&Sget_load_suffixes
);
4390 defsubr (&Seval_buffer
);
4391 defsubr (&Seval_region
);
4392 defsubr (&Sread_char
);
4393 defsubr (&Sread_char_exclusive
);
4394 defsubr (&Sread_event
);
4395 defsubr (&Sget_file_char
);
4396 defsubr (&Smapatoms
);
4397 defsubr (&Slocate_file_internal
);
4399 DEFVAR_LISP ("obarray", Vobarray
,
4400 doc
: /* Symbol table for use by `intern' and `read'.
4401 It is a vector whose length ought to be prime for best results.
4402 The vector's contents don't make sense if examined from Lisp programs;
4403 to find all the symbols in an obarray, use `mapatoms'. */);
4405 DEFVAR_LISP ("values", Vvalues
,
4406 doc
: /* List of values of all expressions which were read, evaluated and printed.
4407 Order is reverse chronological. */);
4408 XSYMBOL (intern ("values"))->declared_special
= 0;
4410 DEFVAR_LISP ("standard-input", Vstandard_input
,
4411 doc
: /* Stream for read to get input from.
4412 See documentation of `read' for possible values. */);
4413 Vstandard_input
= Qt
;
4415 DEFVAR_LISP ("read-with-symbol-positions", Vread_with_symbol_positions
,
4416 doc
: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4418 If this variable is a buffer, then only forms read from that buffer
4419 will be added to `read-symbol-positions-list'.
4420 If this variable is t, then all read forms will be added.
4421 The effect of all other values other than nil are not currently
4422 defined, although they may be in the future.
4424 The positions are relative to the last call to `read' or
4425 `read-from-string'. It is probably a bad idea to set this variable at
4426 the toplevel; bind it instead. */);
4427 Vread_with_symbol_positions
= Qnil
;
4429 DEFVAR_LISP ("read-symbol-positions-list", Vread_symbol_positions_list
,
4430 doc
: /* A list mapping read symbols to their positions.
4431 This variable is modified during calls to `read' or
4432 `read-from-string', but only when `read-with-symbol-positions' is
4435 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4436 CHAR-POSITION is an integer giving the offset of that occurrence of the
4437 symbol from the position where `read' or `read-from-string' started.
4439 Note that a symbol will appear multiple times in this list, if it was
4440 read multiple times. The list is in the same order as the symbols
4442 Vread_symbol_positions_list
= Qnil
;
4444 DEFVAR_LISP ("read-circle", Vread_circle
,
4445 doc
: /* Non-nil means read recursive structures using #N= and #N# syntax. */);
4448 DEFVAR_LISP ("load-path", Vload_path
,
4449 doc
: /* List of directories to search for files to load.
4450 Each element is a string (directory name) or nil (try default directory).
4451 Initialized based on EMACSLOADPATH environment variable, if any,
4452 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4454 DEFVAR_LISP ("load-suffixes", Vload_suffixes
,
4455 doc
: /* List of suffixes for (compiled or source) Emacs Lisp files.
4456 This list should not include the empty string.
4457 `load' and related functions try to append these suffixes, in order,
4458 to the specified file name if a Lisp suffix is allowed or required. */);
4459 Vload_suffixes
= list2 (build_pure_c_string (".elc"),
4460 build_pure_c_string (".el"));
4461 DEFVAR_LISP ("load-file-rep-suffixes", Vload_file_rep_suffixes
,
4462 doc
: /* List of suffixes that indicate representations of \
4464 This list should normally start with the empty string.
4466 Enabling Auto Compression mode appends the suffixes in
4467 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4468 mode removes them again. `load' and related functions use this list to
4469 determine whether they should look for compressed versions of a file
4470 and, if so, which suffixes they should try to append to the file name
4471 in order to do so. However, if you want to customize which suffixes
4472 the loading functions recognize as compression suffixes, you should
4473 customize `jka-compr-load-suffixes' rather than the present variable. */);
4474 Vload_file_rep_suffixes
= list1 (empty_unibyte_string
);
4476 DEFVAR_BOOL ("load-in-progress", load_in_progress
,
4477 doc
: /* Non-nil if inside of `load'. */);
4478 DEFSYM (Qload_in_progress
, "load-in-progress");
4480 DEFVAR_LISP ("after-load-alist", Vafter_load_alist
,
4481 doc
: /* An alist of functions to be evalled when particular files are loaded.
4482 Each element looks like (REGEXP-OR-FEATURE FUNCS...).
4484 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4485 a symbol \(a feature name).
4487 When `load' is run and the file-name argument matches an element's
4488 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4489 REGEXP-OR-FEATURE, the FUNCS in the element are called.
4491 An error in FORMS does not undo the load, but does prevent execution of
4492 the rest of the FORMS. */);
4493 Vafter_load_alist
= Qnil
;
4495 DEFVAR_LISP ("load-history", Vload_history
,
4496 doc
: /* Alist mapping loaded file names to symbols and features.
4497 Each alist element should be a list (FILE-NAME ENTRIES...), where
4498 FILE-NAME is the name of a file that has been loaded into Emacs.
4499 The file name is absolute and true (i.e. it doesn't contain symlinks).
4500 As an exception, one of the alist elements may have FILE-NAME nil,
4501 for symbols and features not associated with any file.
4503 The remaining ENTRIES in the alist element describe the functions and
4504 variables defined in that file, the features provided, and the
4505 features required. Each entry has the form `(provide . FEATURE)',
4506 `(require . FEATURE)', `(defun . FUNCTION)', `(autoload . SYMBOL)',
4507 `(defface . SYMBOL)', or `(t . SYMBOL)'. Entries like `(t . SYMBOL)'
4508 may precede a `(defun . FUNCTION)' entry, and means that SYMBOL was an
4509 autoload before this file redefined it as a function. In addition,
4510 entries may also be single symbols, which means that SYMBOL was
4511 defined by `defvar' or `defconst'.
4513 During preloading, the file name recorded is relative to the main Lisp
4514 directory. These file names are converted to absolute at startup. */);
4515 Vload_history
= Qnil
;
4517 DEFVAR_LISP ("load-file-name", Vload_file_name
,
4518 doc
: /* Full name of file being loaded by `load'. */);
4519 Vload_file_name
= Qnil
;
4521 DEFVAR_LISP ("user-init-file", Vuser_init_file
,
4522 doc
: /* File name, including directory, of user's initialization file.
4523 If the file loaded had extension `.elc', and the corresponding source file
4524 exists, this variable contains the name of source file, suitable for use
4525 by functions like `custom-save-all' which edit the init file.
4526 While Emacs loads and evaluates the init file, value is the real name
4527 of the file, regardless of whether or not it has the `.elc' extension. */);
4528 Vuser_init_file
= Qnil
;
4530 DEFVAR_LISP ("current-load-list", Vcurrent_load_list
,
4531 doc
: /* Used for internal purposes by `load'. */);
4532 Vcurrent_load_list
= Qnil
;
4534 DEFVAR_LISP ("load-read-function", Vload_read_function
,
4535 doc
: /* Function used by `load' and `eval-region' for reading expressions.
4536 The default is nil, which means use the function `read'. */);
4537 Vload_read_function
= Qnil
;
4539 DEFVAR_LISP ("load-source-file-function", Vload_source_file_function
,
4540 doc
: /* Function called in `load' to load an Emacs Lisp source file.
4541 The value should be a function for doing code conversion before
4542 reading a source file. It can also be nil, in which case loading is
4543 done without any code conversion.
4545 If the value is a function, it is called with four arguments,
4546 FULLNAME, FILE, NOERROR, NOMESSAGE. FULLNAME is the absolute name of
4547 the file to load, FILE is the non-absolute name (for messages etc.),
4548 and NOERROR and NOMESSAGE are the corresponding arguments passed to
4549 `load'. The function should return t if the file was loaded. */);
4550 Vload_source_file_function
= Qnil
;
4552 DEFVAR_BOOL ("load-force-doc-strings", load_force_doc_strings
,
4553 doc
: /* Non-nil means `load' should force-load all dynamic doc strings.
4554 This is useful when the file being loaded is a temporary copy. */);
4555 load_force_doc_strings
= 0;
4557 DEFVAR_BOOL ("load-convert-to-unibyte", load_convert_to_unibyte
,
4558 doc
: /* Non-nil means `read' converts strings to unibyte whenever possible.
4559 This is normally bound by `load' and `eval-buffer' to control `read',
4560 and is not meant for users to change. */);
4561 load_convert_to_unibyte
= 0;
4563 DEFVAR_LISP ("source-directory", Vsource_directory
,
4564 doc
: /* Directory in which Emacs sources were found when Emacs was built.
4565 You cannot count on them to still be there! */);
4567 = Fexpand_file_name (build_string ("../"),
4568 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH
)));
4570 DEFVAR_LISP ("preloaded-file-list", Vpreloaded_file_list
,
4571 doc
: /* List of files that were preloaded (when dumping Emacs). */);
4572 Vpreloaded_file_list
= Qnil
;
4574 DEFVAR_LISP ("byte-boolean-vars", Vbyte_boolean_vars
,
4575 doc
: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4576 Vbyte_boolean_vars
= Qnil
;
4578 DEFVAR_BOOL ("load-dangerous-libraries", load_dangerous_libraries
,
4579 doc
: /* Non-nil means load dangerous compiled Lisp files.
4580 Some versions of XEmacs use different byte codes than Emacs. These
4581 incompatible byte codes can make Emacs crash when it tries to execute
4583 load_dangerous_libraries
= 0;
4585 DEFVAR_BOOL ("force-load-messages", force_load_messages
,
4586 doc
: /* Non-nil means force printing messages when loading Lisp files.
4587 This overrides the value of the NOMESSAGE argument to `load'. */);
4588 force_load_messages
= 0;
4590 DEFVAR_LISP ("bytecomp-version-regexp", Vbytecomp_version_regexp
,
4591 doc
: /* Regular expression matching safe to load compiled Lisp files.
4592 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4593 from the file, and matches them against this regular expression.
4594 When the regular expression matches, the file is considered to be safe
4595 to load. See also `load-dangerous-libraries'. */);
4596 Vbytecomp_version_regexp
4597 = build_pure_c_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4599 DEFSYM (Qlexical_binding
, "lexical-binding");
4600 DEFVAR_LISP ("lexical-binding", Vlexical_binding
,
4601 doc
: /* Whether to use lexical binding when evaluating code.
4602 Non-nil means that the code in the current buffer should be evaluated
4603 with lexical binding.
4604 This variable is automatically set from the file variables of an
4605 interpreted Lisp file read using `load'. Unlike other file local
4606 variables, this must be set in the first line of a file. */);
4607 Vlexical_binding
= Qnil
;
4608 Fmake_variable_buffer_local (Qlexical_binding
);
4610 DEFVAR_LISP ("eval-buffer-list", Veval_buffer_list
,
4611 doc
: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4612 Veval_buffer_list
= Qnil
;
4614 DEFVAR_LISP ("old-style-backquotes", Vold_style_backquotes
,
4615 doc
: /* Set to non-nil when `read' encounters an old-style backquote. */);
4616 Vold_style_backquotes
= Qnil
;
4617 DEFSYM (Qold_style_backquotes
, "old-style-backquotes");
4619 /* Vsource_directory was initialized in init_lread. */
4621 DEFSYM (Qcurrent_load_list
, "current-load-list");
4622 DEFSYM (Qstandard_input
, "standard-input");
4623 DEFSYM (Qread_char
, "read-char");
4624 DEFSYM (Qget_file_char
, "get-file-char");
4625 DEFSYM (Qget_emacs_mule_file_char
, "get-emacs-mule-file-char");
4626 DEFSYM (Qload_force_doc_strings
, "load-force-doc-strings");
4628 DEFSYM (Qbackquote
, "`");
4629 DEFSYM (Qcomma
, ",");
4630 DEFSYM (Qcomma_at
, ",@");
4631 DEFSYM (Qcomma_dot
, ",.");
4633 DEFSYM (Qinhibit_file_name_operation
, "inhibit-file-name-operation");
4634 DEFSYM (Qascii_character
, "ascii-character");
4635 DEFSYM (Qfunction
, "function");
4636 DEFSYM (Qload
, "load");
4637 DEFSYM (Qload_file_name
, "load-file-name");
4638 DEFSYM (Qeval_buffer_list
, "eval-buffer-list");
4639 DEFSYM (Qfile_truename
, "file-truename");
4640 DEFSYM (Qdir_ok
, "dir-ok");
4641 DEFSYM (Qdo_after_load_evaluation
, "do-after-load-evaluation");
4643 staticpro (&dump_path
);
4645 staticpro (&read_objects
);
4646 read_objects
= Qnil
;
4647 staticpro (&seen_list
);
4650 Vloads_in_progress
= Qnil
;
4651 staticpro (&Vloads_in_progress
);
4653 DEFSYM (Qhash_table
, "hash-table");
4654 DEFSYM (Qdata
, "data");
4655 DEFSYM (Qtest
, "test");
4656 DEFSYM (Qsize
, "size");
4657 DEFSYM (Qweakness
, "weakness");
4658 DEFSYM (Qrehash_size
, "rehash-size");
4659 DEFSYM (Qrehash_threshold
, "rehash-threshold");