]> code.delx.au - gnu-emacs/blob - src/lread.c
(do_app_resume, do_app_suspend): Remove functions.
[gnu-emacs] / src / lread.c
1 /* Lisp parsing and input streams.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995,
3 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 2005, 2006 Free Software Foundation, Inc.
5
6 This file is part of GNU Emacs.
7
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 2, or (at your option)
11 any later version.
12
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.
17
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
22
23
24 #include <config.h>
25 #include <stdio.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 #include <sys/file.h>
29 #include <errno.h>
30 #include "lisp.h"
31 #include "intervals.h"
32 #include "buffer.h"
33 #include "charset.h"
34 #include <epaths.h>
35 #include "commands.h"
36 #include "keyboard.h"
37 #include "termhooks.h"
38 #include "coding.h"
39
40 #ifdef lint
41 #include <sys/inode.h>
42 #endif /* lint */
43
44 #ifdef MSDOS
45 #if __DJGPP__ < 2
46 #include <unistd.h> /* to get X_OK */
47 #endif
48 #include "msdos.h"
49 #endif
50
51 #ifdef HAVE_UNISTD_H
52 #include <unistd.h>
53 #endif
54
55 #ifndef X_OK
56 #define X_OK 01
57 #endif
58
59 #include <math.h>
60
61 #ifdef HAVE_SETLOCALE
62 #include <locale.h>
63 #endif /* HAVE_SETLOCALE */
64
65 #ifdef HAVE_FCNTL_H
66 #include <fcntl.h>
67 #endif
68 #ifndef O_RDONLY
69 #define O_RDONLY 0
70 #endif
71
72 #ifdef HAVE_FSEEKO
73 #define file_offset off_t
74 #define file_tell ftello
75 #else
76 #define file_offset long
77 #define file_tell ftell
78 #endif
79
80 #ifndef USE_CRT_DLL
81 extern int errno;
82 #endif
83
84 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
85 Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
86 Lisp_Object Qascii_character, Qload, Qload_file_name;
87 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
88 Lisp_Object Qinhibit_file_name_operation;
89 Lisp_Object Qeval_buffer_list, Veval_buffer_list;
90 Lisp_Object Qfile_truename, Qdo_after_load_evaluation; /* ACM 2006/5/16 */
91
92 extern Lisp_Object Qevent_symbol_element_mask;
93 extern Lisp_Object Qfile_exists_p;
94
95 /* non-zero iff inside `load' */
96 int load_in_progress;
97
98 /* Directory in which the sources were found. */
99 Lisp_Object Vsource_directory;
100
101 /* Search path and suffixes for files to be loaded. */
102 Lisp_Object Vload_path, Vload_suffixes, Vload_file_rep_suffixes;
103
104 /* File name of user's init file. */
105 Lisp_Object Vuser_init_file;
106
107 /* This is the user-visible association list that maps features to
108 lists of defs in their load files. */
109 Lisp_Object Vload_history;
110
111 /* This is used to build the load history. */
112 Lisp_Object Vcurrent_load_list;
113
114 /* List of files that were preloaded. */
115 Lisp_Object Vpreloaded_file_list;
116
117 /* Name of file actually being read by `load'. */
118 Lisp_Object Vload_file_name;
119
120 /* Function to use for reading, in `load' and friends. */
121 Lisp_Object Vload_read_function;
122
123 /* The association list of objects read with the #n=object form.
124 Each member of the list has the form (n . object), and is used to
125 look up the object for the corresponding #n# construct.
126 It must be set to nil before all top-level calls to read0. */
127 Lisp_Object read_objects;
128
129 /* Nonzero means load should forcibly load all dynamic doc strings. */
130 static int load_force_doc_strings;
131
132 /* Nonzero means read should convert strings to unibyte. */
133 static int load_convert_to_unibyte;
134
135 /* Function to use for loading an Emacs lisp source file (not
136 compiled) instead of readevalloop. */
137 Lisp_Object Vload_source_file_function;
138
139 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
140 Lisp_Object Vbyte_boolean_vars;
141
142 /* Whether or not to add a `read-positions' property to symbols
143 read. */
144 Lisp_Object Vread_with_symbol_positions;
145
146 /* List of (SYMBOL . POSITION) accumulated so far. */
147 Lisp_Object Vread_symbol_positions_list;
148
149 /* List of descriptors now open for Fload. */
150 static Lisp_Object load_descriptor_list;
151
152 /* File for get_file_char to read from. Use by load. */
153 static FILE *instream;
154
155 /* When nonzero, read conses in pure space */
156 static int read_pure;
157
158 /* For use within read-from-string (this reader is non-reentrant!!) */
159 static int read_from_string_index;
160 static int read_from_string_index_byte;
161 static int read_from_string_limit;
162
163 /* Number of bytes left to read in the buffer character
164 that `readchar' has already advanced over. */
165 static int readchar_backlog;
166 /* Number of characters read in the current call to Fread or
167 Fread_from_string. */
168 static int readchar_count;
169
170 /* This contains the last string skipped with #@. */
171 static char *saved_doc_string;
172 /* Length of buffer allocated in saved_doc_string. */
173 static int saved_doc_string_size;
174 /* Length of actual data in saved_doc_string. */
175 static int saved_doc_string_length;
176 /* This is the file position that string came from. */
177 static file_offset saved_doc_string_position;
178
179 /* This contains the previous string skipped with #@.
180 We copy it from saved_doc_string when a new string
181 is put in saved_doc_string. */
182 static char *prev_saved_doc_string;
183 /* Length of buffer allocated in prev_saved_doc_string. */
184 static int prev_saved_doc_string_size;
185 /* Length of actual data in prev_saved_doc_string. */
186 static int prev_saved_doc_string_length;
187 /* This is the file position that string came from. */
188 static file_offset prev_saved_doc_string_position;
189
190 /* Nonzero means inside a new-style backquote
191 with no surrounding parentheses.
192 Fread initializes this to zero, so we need not specbind it
193 or worry about what happens to it when there is an error. */
194 static int new_backquote_flag;
195
196 /* A list of file names for files being loaded in Fload. Used to
197 check for recursive loads. */
198
199 static Lisp_Object Vloads_in_progress;
200
201 /* Non-zero means load dangerous compiled Lisp files. */
202
203 int load_dangerous_libraries;
204
205 /* A regular expression used to detect files compiled with Emacs. */
206
207 static Lisp_Object Vbytecomp_version_regexp;
208
209 static void to_multibyte P_ ((char **, char **, int *));
210 static void readevalloop P_ ((Lisp_Object, FILE*, Lisp_Object,
211 Lisp_Object (*) (), int,
212 Lisp_Object, Lisp_Object,
213 Lisp_Object, Lisp_Object));
214 static Lisp_Object load_unwind P_ ((Lisp_Object));
215 static Lisp_Object load_descriptor_unwind P_ ((Lisp_Object));
216
217 \f
218 /* Handle unreading and rereading of characters.
219 Write READCHAR to read a character,
220 UNREAD(c) to unread c to be read again.
221
222 The READCHAR and UNREAD macros are meant for reading/unreading a
223 byte code; they do not handle multibyte characters. The caller
224 should manage them if necessary.
225
226 [ Actually that seems to be a lie; READCHAR will definitely read
227 multibyte characters from buffer sources, at least. Is the
228 comment just out of date?
229 -- Colin Walters <walters@gnu.org>, 22 May 2002 16:36:50 -0400 ]
230 */
231
232 #define READCHAR readchar (readcharfun)
233 #define UNREAD(c) unreadchar (readcharfun, c)
234
235 static int
236 readchar (readcharfun)
237 Lisp_Object readcharfun;
238 {
239 Lisp_Object tem;
240 register int c;
241
242 readchar_count++;
243
244 if (BUFFERP (readcharfun))
245 {
246 register struct buffer *inbuffer = XBUFFER (readcharfun);
247
248 int pt_byte = BUF_PT_BYTE (inbuffer);
249 int orig_pt_byte = pt_byte;
250
251 if (readchar_backlog > 0)
252 /* We get the address of the byte just passed,
253 which is the last byte of the character.
254 The other bytes in this character are consecutive with it,
255 because the gap can't be in the middle of a character. */
256 return *(BUF_BYTE_ADDRESS (inbuffer, BUF_PT_BYTE (inbuffer) - 1)
257 - --readchar_backlog);
258
259 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
260 return -1;
261
262 readchar_backlog = -1;
263
264 if (! NILP (inbuffer->enable_multibyte_characters))
265 {
266 /* Fetch the character code from the buffer. */
267 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
268 BUF_INC_POS (inbuffer, pt_byte);
269 c = STRING_CHAR (p, pt_byte - orig_pt_byte);
270 }
271 else
272 {
273 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
274 pt_byte++;
275 }
276 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
277
278 return c;
279 }
280 if (MARKERP (readcharfun))
281 {
282 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
283
284 int bytepos = marker_byte_position (readcharfun);
285 int orig_bytepos = bytepos;
286
287 if (readchar_backlog > 0)
288 /* We get the address of the byte just passed,
289 which is the last byte of the character.
290 The other bytes in this character are consecutive with it,
291 because the gap can't be in the middle of a character. */
292 return *(BUF_BYTE_ADDRESS (inbuffer, XMARKER (readcharfun)->bytepos - 1)
293 - --readchar_backlog);
294
295 if (bytepos >= BUF_ZV_BYTE (inbuffer))
296 return -1;
297
298 readchar_backlog = -1;
299
300 if (! NILP (inbuffer->enable_multibyte_characters))
301 {
302 /* Fetch the character code from the buffer. */
303 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
304 BUF_INC_POS (inbuffer, bytepos);
305 c = STRING_CHAR (p, bytepos - orig_bytepos);
306 }
307 else
308 {
309 c = BUF_FETCH_BYTE (inbuffer, bytepos);
310 bytepos++;
311 }
312
313 XMARKER (readcharfun)->bytepos = bytepos;
314 XMARKER (readcharfun)->charpos++;
315
316 return c;
317 }
318
319 if (EQ (readcharfun, Qlambda))
320 return read_bytecode_char (0);
321
322 if (EQ (readcharfun, Qget_file_char))
323 {
324 c = getc (instream);
325 #ifdef EINTR
326 /* Interrupted reads have been observed while reading over the network */
327 while (c == EOF && ferror (instream) && errno == EINTR)
328 {
329 QUIT;
330 clearerr (instream);
331 c = getc (instream);
332 }
333 #endif
334 return c;
335 }
336
337 if (STRINGP (readcharfun))
338 {
339 if (read_from_string_index >= read_from_string_limit)
340 c = -1;
341 else
342 FETCH_STRING_CHAR_ADVANCE (c, readcharfun,
343 read_from_string_index,
344 read_from_string_index_byte);
345
346 return c;
347 }
348
349 tem = call0 (readcharfun);
350
351 if (NILP (tem))
352 return -1;
353 return XINT (tem);
354 }
355
356 /* Unread the character C in the way appropriate for the stream READCHARFUN.
357 If the stream is a user function, call it with the char as argument. */
358
359 static void
360 unreadchar (readcharfun, c)
361 Lisp_Object readcharfun;
362 int c;
363 {
364 readchar_count--;
365 if (c == -1)
366 /* Don't back up the pointer if we're unreading the end-of-input mark,
367 since readchar didn't advance it when we read it. */
368 ;
369 else if (BUFFERP (readcharfun))
370 {
371 struct buffer *b = XBUFFER (readcharfun);
372 int bytepos = BUF_PT_BYTE (b);
373
374 if (readchar_backlog >= 0)
375 readchar_backlog++;
376 else
377 {
378 BUF_PT (b)--;
379 if (! NILP (b->enable_multibyte_characters))
380 BUF_DEC_POS (b, bytepos);
381 else
382 bytepos--;
383
384 BUF_PT_BYTE (b) = bytepos;
385 }
386 }
387 else if (MARKERP (readcharfun))
388 {
389 struct buffer *b = XMARKER (readcharfun)->buffer;
390 int bytepos = XMARKER (readcharfun)->bytepos;
391
392 if (readchar_backlog >= 0)
393 readchar_backlog++;
394 else
395 {
396 XMARKER (readcharfun)->charpos--;
397 if (! NILP (b->enable_multibyte_characters))
398 BUF_DEC_POS (b, bytepos);
399 else
400 bytepos--;
401
402 XMARKER (readcharfun)->bytepos = bytepos;
403 }
404 }
405 else if (STRINGP (readcharfun))
406 {
407 read_from_string_index--;
408 read_from_string_index_byte
409 = string_char_to_byte (readcharfun, read_from_string_index);
410 }
411 else if (EQ (readcharfun, Qlambda))
412 read_bytecode_char (1);
413 else if (EQ (readcharfun, Qget_file_char))
414 ungetc (c, instream);
415 else
416 call1 (readcharfun, make_number (c));
417 }
418
419 static Lisp_Object read_internal_start P_ ((Lisp_Object, Lisp_Object,
420 Lisp_Object));
421 static Lisp_Object read0 P_ ((Lisp_Object));
422 static Lisp_Object read1 P_ ((Lisp_Object, int *, int));
423
424 static Lisp_Object read_list P_ ((int, Lisp_Object));
425 static Lisp_Object read_vector P_ ((Lisp_Object, int));
426 static int read_multibyte P_ ((int, Lisp_Object));
427
428 static Lisp_Object substitute_object_recurse P_ ((Lisp_Object, Lisp_Object,
429 Lisp_Object));
430 static void substitute_object_in_subtree P_ ((Lisp_Object,
431 Lisp_Object));
432 static void substitute_in_interval P_ ((INTERVAL, Lisp_Object));
433
434 \f
435 /* Get a character from the tty. */
436
437 extern Lisp_Object read_char ();
438
439 /* Read input events until we get one that's acceptable for our purposes.
440
441 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
442 until we get a character we like, and then stuffed into
443 unread_switch_frame.
444
445 If ASCII_REQUIRED is non-zero, we check function key events to see
446 if the unmodified version of the symbol has a Qascii_character
447 property, and use that character, if present.
448
449 If ERROR_NONASCII is non-zero, we signal an error if the input we
450 get isn't an ASCII character with modifiers. If it's zero but
451 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
452 character.
453
454 If INPUT_METHOD is nonzero, we invoke the current input method
455 if the character warrants that. */
456
457 Lisp_Object
458 read_filtered_event (no_switch_frame, ascii_required, error_nonascii,
459 input_method)
460 int no_switch_frame, ascii_required, error_nonascii, input_method;
461 {
462 register Lisp_Object val, delayed_switch_frame;
463
464 #ifdef HAVE_WINDOW_SYSTEM
465 if (display_hourglass_p)
466 cancel_hourglass ();
467 #endif
468
469 delayed_switch_frame = Qnil;
470
471 /* Read until we get an acceptable event. */
472 retry:
473 val = read_char (0, 0, 0,
474 (input_method ? Qnil : Qt),
475 0);
476
477 if (BUFFERP (val))
478 goto retry;
479
480 /* switch-frame events are put off until after the next ASCII
481 character. This is better than signaling an error just because
482 the last characters were typed to a separate minibuffer frame,
483 for example. Eventually, some code which can deal with
484 switch-frame events will read it and process it. */
485 if (no_switch_frame
486 && EVENT_HAS_PARAMETERS (val)
487 && EQ (EVENT_HEAD (val), Qswitch_frame))
488 {
489 delayed_switch_frame = val;
490 goto retry;
491 }
492
493 if (ascii_required)
494 {
495 /* Convert certain symbols to their ASCII equivalents. */
496 if (SYMBOLP (val))
497 {
498 Lisp_Object tem, tem1;
499 tem = Fget (val, Qevent_symbol_element_mask);
500 if (!NILP (tem))
501 {
502 tem1 = Fget (Fcar (tem), Qascii_character);
503 /* Merge this symbol's modifier bits
504 with the ASCII equivalent of its basic code. */
505 if (!NILP (tem1))
506 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
507 }
508 }
509
510 /* If we don't have a character now, deal with it appropriately. */
511 if (!INTEGERP (val))
512 {
513 if (error_nonascii)
514 {
515 Vunread_command_events = Fcons (val, Qnil);
516 error ("Non-character input-event");
517 }
518 else
519 goto retry;
520 }
521 }
522
523 if (! NILP (delayed_switch_frame))
524 unread_switch_frame = delayed_switch_frame;
525
526 #if 0
527
528 #ifdef HAVE_WINDOW_SYSTEM
529 if (display_hourglass_p)
530 start_hourglass ();
531 #endif
532
533 #endif
534
535 return val;
536 }
537
538 DEFUN ("read-char", Fread_char, Sread_char, 0, 2, 0,
539 doc: /* Read a character from the command input (keyboard or macro).
540 It is returned as a number.
541 If the user generates an event which is not a character (i.e. a mouse
542 click or function key event), `read-char' signals an error. As an
543 exception, switch-frame events are put off until non-ASCII events can
544 be read.
545 If you want to read non-character events, or ignore them, call
546 `read-event' or `read-char-exclusive' instead.
547
548 If the optional argument PROMPT is non-nil, display that as a prompt.
549 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
550 input method is turned on in the current buffer, that input method
551 is used for reading a character. */)
552 (prompt, inherit_input_method)
553 Lisp_Object prompt, inherit_input_method;
554 {
555 if (! NILP (prompt))
556 message_with_string ("%s", prompt, 0);
557 return read_filtered_event (1, 1, 1, ! NILP (inherit_input_method));
558 }
559
560 DEFUN ("read-event", Fread_event, Sread_event, 0, 2, 0,
561 doc: /* Read an event object from the input stream.
562 If the optional argument PROMPT is non-nil, display that as a prompt.
563 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
564 input method is turned on in the current buffer, that input method
565 is used for reading a character. */)
566 (prompt, inherit_input_method)
567 Lisp_Object prompt, inherit_input_method;
568 {
569 if (! NILP (prompt))
570 message_with_string ("%s", prompt, 0);
571 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method));
572 }
573
574 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 2, 0,
575 doc: /* Read a character from the command input (keyboard or macro).
576 It is returned as a number. Non-character events are ignored.
577
578 If the optional argument PROMPT is non-nil, display that as a prompt.
579 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
580 input method is turned on in the current buffer, that input method
581 is used for reading a character. */)
582 (prompt, inherit_input_method)
583 Lisp_Object prompt, inherit_input_method;
584 {
585 if (! NILP (prompt))
586 message_with_string ("%s", prompt, 0);
587 return read_filtered_event (1, 1, 0, ! NILP (inherit_input_method));
588 }
589
590 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
591 doc: /* Don't use this yourself. */)
592 ()
593 {
594 register Lisp_Object val;
595 XSETINT (val, getc (instream));
596 return val;
597 }
598
599
600 \f
601 /* Value is non-zero if the file asswociated with file descriptor FD
602 is a compiled Lisp file that's safe to load. Only files compiled
603 with Emacs are safe to load. Files compiled with XEmacs can lead
604 to a crash in Fbyte_code because of an incompatible change in the
605 byte compiler. */
606
607 static int
608 safe_to_load_p (fd)
609 int fd;
610 {
611 char buf[512];
612 int nbytes, i;
613 int safe_p = 1;
614
615 /* Read the first few bytes from the file, and look for a line
616 specifying the byte compiler version used. */
617 nbytes = emacs_read (fd, buf, sizeof buf - 1);
618 if (nbytes > 0)
619 {
620 buf[nbytes] = '\0';
621
622 /* Skip to the next newline, skipping over the initial `ELC'
623 with NUL bytes following it. */
624 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
625 ;
626
627 if (i < nbytes
628 && fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
629 buf + i) < 0)
630 safe_p = 0;
631 }
632
633 lseek (fd, 0, SEEK_SET);
634 return safe_p;
635 }
636
637
638 /* Callback for record_unwind_protect. Restore the old load list OLD,
639 after loading a file successfully. */
640
641 static Lisp_Object
642 record_load_unwind (old)
643 Lisp_Object old;
644 {
645 return Vloads_in_progress = old;
646 }
647
648 /* This handler function is used via internal_condition_case_1. */
649
650 static Lisp_Object
651 load_error_handler (data)
652 Lisp_Object data;
653 {
654 return Qnil;
655 }
656
657 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
658 doc: /* Return the suffixes that `load' should try if a suffix is \
659 required.
660 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
661 ()
662 {
663 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
664 while (CONSP (suffixes))
665 {
666 Lisp_Object exts = Vload_file_rep_suffixes;
667 suffix = XCAR (suffixes);
668 suffixes = XCDR (suffixes);
669 while (CONSP (exts))
670 {
671 ext = XCAR (exts);
672 exts = XCDR (exts);
673 lst = Fcons (concat2 (suffix, ext), lst);
674 }
675 }
676 return Fnreverse (lst);
677 }
678
679 DEFUN ("load", Fload, Sload, 1, 5, 0,
680 doc: /* Execute a file of Lisp code named FILE.
681 First try FILE with `.elc' appended, then try with `.el',
682 then try FILE unmodified (the exact suffixes in the exact order are
683 determined by `load-suffixes'). Environment variable references in
684 FILE are replaced with their values by calling `substitute-in-file-name'.
685 This function searches the directories in `load-path'.
686
687 If optional second arg NOERROR is non-nil,
688 report no error if FILE doesn't exist.
689 Print messages at start and end of loading unless
690 optional third arg NOMESSAGE is non-nil.
691 If optional fourth arg NOSUFFIX is non-nil, don't try adding
692 suffixes `.elc' or `.el' to the specified name FILE.
693 If optional fifth arg MUST-SUFFIX is non-nil, insist on
694 the suffix `.elc' or `.el'; don't accept just FILE unless
695 it ends in one of those suffixes or includes a directory name.
696
697 If this function fails to find a file, it may look for different
698 representations of that file before trying another file.
699 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
700 to the file name. Emacs uses this feature mainly to find compressed
701 versions of files when Auto Compression mode is enabled.
702
703 The exact suffixes that this function tries out, in the exact order,
704 are given by the value of the variable `load-file-rep-suffixes' if
705 NOSUFFIX is non-nil and by the return value of the function
706 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
707 MUST-SUFFIX are nil, this function first tries out the latter suffixes
708 and then the former.
709
710 Loading a file records its definitions, and its `provide' and
711 `require' calls, in an element of `load-history' whose
712 car is the file name loaded. See `load-history'.
713
714 Return t if the file exists and loads successfully. */)
715 (file, noerror, nomessage, nosuffix, must_suffix)
716 Lisp_Object file, noerror, nomessage, nosuffix, must_suffix;
717 {
718 register FILE *stream;
719 register int fd = -1;
720 int count = SPECPDL_INDEX ();
721 Lisp_Object temp;
722 struct gcpro gcpro1, gcpro2, gcpro3;
723 Lisp_Object found, efound, hist_file_name;
724 /* 1 means we printed the ".el is newer" message. */
725 int newer = 0;
726 /* 1 means we are loading a compiled file. */
727 int compiled = 0;
728 Lisp_Object handler;
729 int safe_p = 1;
730 char *fmode = "r";
731 Lisp_Object tmp[2];
732 #ifdef DOS_NT
733 fmode = "rt";
734 #endif /* DOS_NT */
735
736 CHECK_STRING (file);
737
738 /* If file name is magic, call the handler. */
739 /* This shouldn't be necessary any more now that `openp' handles it right.
740 handler = Ffind_file_name_handler (file, Qload);
741 if (!NILP (handler))
742 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
743
744 /* Do this after the handler to avoid
745 the need to gcpro noerror, nomessage and nosuffix.
746 (Below here, we care only whether they are nil or not.)
747 The presence of this call is the result of a historical accident:
748 it used to be in every file-operation and when it got removed
749 everywhere, it accidentally stayed here. Since then, enough people
750 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
751 that it seemed risky to remove. */
752 if (! NILP (noerror))
753 {
754 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
755 Qt, load_error_handler);
756 if (NILP (file))
757 return Qnil;
758 }
759 else
760 file = Fsubstitute_in_file_name (file);
761
762
763 /* Avoid weird lossage with null string as arg,
764 since it would try to load a directory as a Lisp file */
765 if (SCHARS (file) > 0)
766 {
767 int size = SBYTES (file);
768
769 found = Qnil;
770 GCPRO2 (file, found);
771
772 if (! NILP (must_suffix))
773 {
774 /* Don't insist on adding a suffix if FILE already ends with one. */
775 if (size > 3
776 && !strcmp (SDATA (file) + size - 3, ".el"))
777 must_suffix = Qnil;
778 else if (size > 4
779 && !strcmp (SDATA (file) + size - 4, ".elc"))
780 must_suffix = Qnil;
781 /* Don't insist on adding a suffix
782 if the argument includes a directory name. */
783 else if (! NILP (Ffile_name_directory (file)))
784 must_suffix = Qnil;
785 }
786
787 fd = openp (Vload_path, file,
788 (!NILP (nosuffix) ? Qnil
789 : !NILP (must_suffix) ? Fget_load_suffixes ()
790 : Fappend (2, (tmp[0] = Fget_load_suffixes (),
791 tmp[1] = Vload_file_rep_suffixes,
792 tmp))),
793 &found, Qnil);
794 UNGCPRO;
795 }
796
797 if (fd == -1)
798 {
799 if (NILP (noerror))
800 Fsignal (Qfile_error, Fcons (build_string ("Cannot open load file"),
801 Fcons (file, Qnil)));
802 else
803 return Qnil;
804 }
805
806 /* Tell startup.el whether or not we found the user's init file. */
807 if (EQ (Qt, Vuser_init_file))
808 Vuser_init_file = found;
809
810 /* If FD is -2, that means openp found a magic file. */
811 if (fd == -2)
812 {
813 if (NILP (Fequal (found, file)))
814 /* If FOUND is a different file name from FILE,
815 find its handler even if we have already inhibited
816 the `load' operation on FILE. */
817 handler = Ffind_file_name_handler (found, Qt);
818 else
819 handler = Ffind_file_name_handler (found, Qload);
820 if (! NILP (handler))
821 return call5 (handler, Qload, found, noerror, nomessage, Qt);
822 }
823
824 /* Check if we're stuck in a recursive load cycle.
825
826 2000-09-21: It's not possible to just check for the file loaded
827 being a member of Vloads_in_progress. This fails because of the
828 way the byte compiler currently works; `provide's are not
829 evaluted, see font-lock.el/jit-lock.el as an example. This
830 leads to a certain amount of ``normal'' recursion.
831
832 Also, just loading a file recursively is not always an error in
833 the general case; the second load may do something different. */
834 {
835 int count = 0;
836 Lisp_Object tem;
837 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
838 if (!NILP (Fequal (found, XCAR (tem))))
839 count++;
840 if (count > 3)
841 {
842 if (fd >= 0)
843 emacs_close (fd);
844 Fsignal (Qerror, Fcons (build_string ("Recursive load"),
845 Fcons (found, Vloads_in_progress)));
846 }
847 record_unwind_protect (record_load_unwind, Vloads_in_progress);
848 Vloads_in_progress = Fcons (found, Vloads_in_progress);
849 }
850
851 /* Get the name for load-history. */
852 hist_file_name = (! NILP (Vpurify_flag)
853 ? Fconcat (2, (tmp[0] = Ffile_name_directory (file),
854 tmp[1] = Ffile_name_nondirectory (found),
855 tmp))
856 : found) ;
857
858 if (!bcmp (SDATA (found) + SBYTES (found) - 4,
859 ".elc", 4))
860 /* Load .elc files directly, but not when they are
861 remote and have no handler! */
862 {
863 if (fd != -2)
864 {
865 struct stat s1, s2;
866 int result;
867
868 GCPRO3 (file, found, hist_file_name);
869
870 if (!safe_to_load_p (fd))
871 {
872 safe_p = 0;
873 if (!load_dangerous_libraries)
874 {
875 if (fd >= 0)
876 emacs_close (fd);
877 error ("File `%s' was not compiled in Emacs",
878 SDATA (found));
879 }
880 else if (!NILP (nomessage))
881 message_with_string ("File `%s' not compiled in Emacs", found, 1);
882 }
883
884 compiled = 1;
885
886 efound = ENCODE_FILE (found);
887
888 #ifdef DOS_NT
889 fmode = "rb";
890 #endif /* DOS_NT */
891 stat ((char *)SDATA (efound), &s1);
892 SSET (efound, SBYTES (efound) - 1, 0);
893 result = stat ((char *)SDATA (efound), &s2);
894 SSET (efound, SBYTES (efound) - 1, 'c');
895
896 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
897 {
898 /* Make the progress messages mention that source is newer. */
899 newer = 1;
900
901 /* If we won't print another message, mention this anyway. */
902 if (!NILP (nomessage))
903 {
904 Lisp_Object msg_file;
905 msg_file = Fsubstring (found, make_number (0), make_number (-1));
906 message_with_string ("Source file `%s' newer than byte-compiled file",
907 msg_file, 1);
908 }
909 }
910 UNGCPRO;
911 }
912 }
913 else
914 {
915 /* We are loading a source file (*.el). */
916 if (!NILP (Vload_source_file_function))
917 {
918 Lisp_Object val;
919
920 if (fd >= 0)
921 emacs_close (fd);
922 val = call4 (Vload_source_file_function, found, hist_file_name,
923 NILP (noerror) ? Qnil : Qt,
924 NILP (nomessage) ? Qnil : Qt);
925 return unbind_to (count, val);
926 }
927 }
928
929 GCPRO3 (file, found, hist_file_name);
930
931 #ifdef WINDOWSNT
932 emacs_close (fd);
933 efound = ENCODE_FILE (found);
934 stream = fopen ((char *) SDATA (efound), fmode);
935 #else /* not WINDOWSNT */
936 stream = fdopen (fd, fmode);
937 #endif /* not WINDOWSNT */
938 if (stream == 0)
939 {
940 emacs_close (fd);
941 error ("Failure to create stdio stream for %s", SDATA (file));
942 }
943
944 if (! NILP (Vpurify_flag))
945 Vpreloaded_file_list = Fcons (file, Vpreloaded_file_list);
946
947 if (NILP (nomessage))
948 {
949 if (!safe_p)
950 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
951 file, 1);
952 else if (!compiled)
953 message_with_string ("Loading %s (source)...", file, 1);
954 else if (newer)
955 message_with_string ("Loading %s (compiled; note, source file is newer)...",
956 file, 1);
957 else /* The typical case; compiled file newer than source file. */
958 message_with_string ("Loading %s...", file, 1);
959 }
960
961 record_unwind_protect (load_unwind, make_save_value (stream, 0));
962 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
963 specbind (Qload_file_name, found);
964 specbind (Qinhibit_file_name_operation, Qnil);
965 load_descriptor_list
966 = Fcons (make_number (fileno (stream)), load_descriptor_list);
967 load_in_progress++;
968 readevalloop (Qget_file_char, stream, hist_file_name,
969 Feval, 0, Qnil, Qnil, Qnil, Qnil);
970 unbind_to (count, Qnil);
971
972 /* Run any eval-after-load forms for this file */
973 if (NILP (Vpurify_flag)
974 && (!NILP (Ffboundp (Qdo_after_load_evaluation))))
975 call1 (Qdo_after_load_evaluation, hist_file_name) ;
976
977 UNGCPRO;
978
979 if (saved_doc_string)
980 free (saved_doc_string);
981 saved_doc_string = 0;
982 saved_doc_string_size = 0;
983
984 if (prev_saved_doc_string)
985 xfree (prev_saved_doc_string);
986 prev_saved_doc_string = 0;
987 prev_saved_doc_string_size = 0;
988
989 if (!noninteractive && NILP (nomessage))
990 {
991 if (!safe_p)
992 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
993 file, 1);
994 else if (!compiled)
995 message_with_string ("Loading %s (source)...done", file, 1);
996 else if (newer)
997 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
998 file, 1);
999 else /* The typical case; compiled file newer than source file. */
1000 message_with_string ("Loading %s...done", file, 1);
1001 }
1002
1003 if (!NILP (Fequal (build_string ("obsolete"),
1004 Ffile_name_nondirectory
1005 (Fdirectory_file_name (Ffile_name_directory (found))))))
1006 message_with_string ("Package %s is obsolete", file, 1);
1007
1008 return Qt;
1009 }
1010
1011 static Lisp_Object
1012 load_unwind (arg) /* used as unwind-protect function in load */
1013 Lisp_Object arg;
1014 {
1015 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
1016 if (stream != NULL)
1017 fclose (stream);
1018 if (--load_in_progress < 0) load_in_progress = 0;
1019 return Qnil;
1020 }
1021
1022 static Lisp_Object
1023 load_descriptor_unwind (oldlist)
1024 Lisp_Object oldlist;
1025 {
1026 load_descriptor_list = oldlist;
1027 return Qnil;
1028 }
1029
1030 /* Close all descriptors in use for Floads.
1031 This is used when starting a subprocess. */
1032
1033 void
1034 close_load_descs ()
1035 {
1036 #ifndef WINDOWSNT
1037 Lisp_Object tail;
1038 for (tail = load_descriptor_list; !NILP (tail); tail = XCDR (tail))
1039 emacs_close (XFASTINT (XCAR (tail)));
1040 #endif
1041 }
1042 \f
1043 static int
1044 complete_filename_p (pathname)
1045 Lisp_Object pathname;
1046 {
1047 register const unsigned char *s = SDATA (pathname);
1048 return (IS_DIRECTORY_SEP (s[0])
1049 || (SCHARS (pathname) > 2
1050 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2]))
1051 #ifdef ALTOS
1052 || *s == '@'
1053 #endif
1054 #ifdef VMS
1055 || index (s, ':')
1056 #endif /* VMS */
1057 );
1058 }
1059
1060 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1061 doc: /* Search for FILENAME through PATH.
1062 Returns the file's name in absolute form, or nil if not found.
1063 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1064 file name when searching.
1065 If non-nil, PREDICATE is used instead of `file-readable-p'.
1066 PREDICATE can also be an integer to pass to the access(2) function,
1067 in which case file-name-handlers are ignored. */)
1068 (filename, path, suffixes, predicate)
1069 Lisp_Object filename, path, suffixes, predicate;
1070 {
1071 Lisp_Object file;
1072 int fd = openp (path, filename, suffixes, &file, predicate);
1073 if (NILP (predicate) && fd > 0)
1074 close (fd);
1075 return file;
1076 }
1077
1078
1079 /* Search for a file whose name is STR, looking in directories
1080 in the Lisp list PATH, and trying suffixes from SUFFIX.
1081 On success, returns a file descriptor. On failure, returns -1.
1082
1083 SUFFIXES is a list of strings containing possible suffixes.
1084 The empty suffix is automatically added iff the list is empty.
1085
1086 PREDICATE non-nil means don't open the files,
1087 just look for one that satisfies the predicate. In this case,
1088 returns 1 on success. The predicate can be a lisp function or
1089 an integer to pass to `access' (in which case file-name-handlers
1090 are ignored).
1091
1092 If STOREPTR is nonzero, it points to a slot where the name of
1093 the file actually found should be stored as a Lisp string.
1094 nil is stored there on failure.
1095
1096 If the file we find is remote, return -2
1097 but store the found remote file name in *STOREPTR. */
1098
1099 int
1100 openp (path, str, suffixes, storeptr, predicate)
1101 Lisp_Object path, str;
1102 Lisp_Object suffixes;
1103 Lisp_Object *storeptr;
1104 Lisp_Object predicate;
1105 {
1106 register int fd;
1107 int fn_size = 100;
1108 char buf[100];
1109 register char *fn = buf;
1110 int absolute = 0;
1111 int want_size;
1112 Lisp_Object filename;
1113 struct stat st;
1114 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1115 Lisp_Object string, tail, encoded_fn;
1116 int max_suffix_len = 0;
1117
1118 CHECK_STRING (str);
1119
1120 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1121 {
1122 CHECK_STRING_CAR (tail);
1123 max_suffix_len = max (max_suffix_len,
1124 SBYTES (XCAR (tail)));
1125 }
1126
1127 string = filename = encoded_fn = Qnil;
1128 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1129
1130 if (storeptr)
1131 *storeptr = Qnil;
1132
1133 if (complete_filename_p (str))
1134 absolute = 1;
1135
1136 for (; CONSP (path); path = XCDR (path))
1137 {
1138 filename = Fexpand_file_name (str, XCAR (path));
1139 if (!complete_filename_p (filename))
1140 /* If there are non-absolute elts in PATH (eg ".") */
1141 /* Of course, this could conceivably lose if luser sets
1142 default-directory to be something non-absolute... */
1143 {
1144 filename = Fexpand_file_name (filename, current_buffer->directory);
1145 if (!complete_filename_p (filename))
1146 /* Give up on this path element! */
1147 continue;
1148 }
1149
1150 /* Calculate maximum size of any filename made from
1151 this path element/specified file name and any possible suffix. */
1152 want_size = max_suffix_len + SBYTES (filename) + 1;
1153 if (fn_size < want_size)
1154 fn = (char *) alloca (fn_size = 100 + want_size);
1155
1156 /* Loop over suffixes. */
1157 for (tail = NILP (suffixes) ? Fcons (build_string (""), Qnil) : suffixes;
1158 CONSP (tail); tail = XCDR (tail))
1159 {
1160 int lsuffix = SBYTES (XCAR (tail));
1161 Lisp_Object handler;
1162 int exists;
1163
1164 /* Concatenate path element/specified name with the suffix.
1165 If the directory starts with /:, remove that. */
1166 if (SCHARS (filename) > 2
1167 && SREF (filename, 0) == '/'
1168 && SREF (filename, 1) == ':')
1169 {
1170 strncpy (fn, SDATA (filename) + 2,
1171 SBYTES (filename) - 2);
1172 fn[SBYTES (filename) - 2] = 0;
1173 }
1174 else
1175 {
1176 strncpy (fn, SDATA (filename),
1177 SBYTES (filename));
1178 fn[SBYTES (filename)] = 0;
1179 }
1180
1181 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1182 strncat (fn, SDATA (XCAR (tail)), lsuffix);
1183
1184 /* Check that the file exists and is not a directory. */
1185 /* We used to only check for handlers on non-absolute file names:
1186 if (absolute)
1187 handler = Qnil;
1188 else
1189 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1190 It's not clear why that was the case and it breaks things like
1191 (load "/bar.el") where the file is actually "/bar.el.gz". */
1192 string = build_string (fn);
1193 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1194 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1195 {
1196 if (NILP (predicate))
1197 exists = !NILP (Ffile_readable_p (string));
1198 else
1199 exists = !NILP (call1 (predicate, string));
1200 if (exists && !NILP (Ffile_directory_p (string)))
1201 exists = 0;
1202
1203 if (exists)
1204 {
1205 /* We succeeded; return this descriptor and filename. */
1206 if (storeptr)
1207 *storeptr = string;
1208 UNGCPRO;
1209 return -2;
1210 }
1211 }
1212 else
1213 {
1214 const char *pfn;
1215
1216 encoded_fn = ENCODE_FILE (string);
1217 pfn = SDATA (encoded_fn);
1218 exists = (stat (pfn, &st) >= 0
1219 && (st.st_mode & S_IFMT) != S_IFDIR);
1220 if (exists)
1221 {
1222 /* Check that we can access or open it. */
1223 if (NATNUMP (predicate))
1224 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1225 else
1226 fd = emacs_open (pfn, O_RDONLY, 0);
1227
1228 if (fd >= 0)
1229 {
1230 /* We succeeded; return this descriptor and filename. */
1231 if (storeptr)
1232 *storeptr = string;
1233 UNGCPRO;
1234 return fd;
1235 }
1236 }
1237 }
1238 }
1239 if (absolute)
1240 break;
1241 }
1242
1243 UNGCPRO;
1244 return -1;
1245 }
1246
1247 \f
1248 /* Merge the list we've accumulated of globals from the current input source
1249 into the load_history variable. The details depend on whether
1250 the source has an associated file name or not.
1251
1252 FILENAME is the file name that we are loading from.
1253 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1254
1255 static void
1256 build_load_history (filename, entire)
1257 Lisp_Object filename;
1258 int entire;
1259 {
1260 register Lisp_Object tail, prev, newelt;
1261 register Lisp_Object tem, tem2;
1262 register int foundit = 0;
1263
1264 tail = Vload_history;
1265 prev = Qnil;
1266
1267 while (CONSP (tail))
1268 {
1269 tem = XCAR (tail);
1270
1271 /* Find the feature's previous assoc list... */
1272 if (!NILP (Fequal (filename, Fcar (tem))))
1273 {
1274 foundit = 1;
1275
1276 /* If we're loading the entire file, remove old data. */
1277 if (entire)
1278 {
1279 if (NILP (prev))
1280 Vload_history = XCDR (tail);
1281 else
1282 Fsetcdr (prev, XCDR (tail));
1283 }
1284
1285 /* Otherwise, cons on new symbols that are not already members. */
1286 else
1287 {
1288 tem2 = Vcurrent_load_list;
1289
1290 while (CONSP (tem2))
1291 {
1292 newelt = XCAR (tem2);
1293
1294 if (NILP (Fmember (newelt, tem)))
1295 Fsetcar (tail, Fcons (XCAR (tem),
1296 Fcons (newelt, XCDR (tem))));
1297
1298 tem2 = XCDR (tem2);
1299 QUIT;
1300 }
1301 }
1302 }
1303 else
1304 prev = tail;
1305 tail = XCDR (tail);
1306 QUIT;
1307 }
1308
1309 /* If we're loading an entire file, cons the new assoc onto the
1310 front of load-history, the most-recently-loaded position. Also
1311 do this if we didn't find an existing member for the file. */
1312 if (entire || !foundit)
1313 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1314 Vload_history);
1315 }
1316
1317 Lisp_Object
1318 unreadpure (junk) /* Used as unwind-protect function in readevalloop */
1319 Lisp_Object junk;
1320 {
1321 read_pure = 0;
1322 return Qnil;
1323 }
1324
1325 static Lisp_Object
1326 readevalloop_1 (old)
1327 Lisp_Object old;
1328 {
1329 load_convert_to_unibyte = ! NILP (old);
1330 return Qnil;
1331 }
1332
1333 /* Signal an `end-of-file' error, if possible with file name
1334 information. */
1335
1336 static void
1337 end_of_file_error ()
1338 {
1339 Lisp_Object data;
1340
1341 if (STRINGP (Vload_file_name))
1342 data = Fcons (Vload_file_name, Qnil);
1343 else
1344 data = Qnil;
1345
1346 Fsignal (Qend_of_file, data);
1347 }
1348
1349 /* UNIBYTE specifies how to set load_convert_to_unibyte
1350 for this invocation.
1351 READFUN, if non-nil, is used instead of `read'.
1352
1353 START, END specify region to read in current buffer (from eval-region).
1354 If the input is not from a buffer, they must be nil. */
1355
1356 static void
1357 readevalloop (readcharfun, stream, sourcename, evalfun,
1358 printflag, unibyte, readfun, start, end)
1359 Lisp_Object readcharfun;
1360 FILE *stream;
1361 Lisp_Object sourcename;
1362 Lisp_Object (*evalfun) ();
1363 int printflag;
1364 Lisp_Object unibyte, readfun;
1365 Lisp_Object start, end;
1366 {
1367 register int c;
1368 register Lisp_Object val;
1369 int count = SPECPDL_INDEX ();
1370 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1371 struct buffer *b = 0;
1372 int bpos;
1373 int continue_reading_p;
1374 /* Nonzero if reading an entire buffer. */
1375 int whole_buffer = 0;
1376 /* 1 on the first time around. */
1377 int first_sexp = 1;
1378
1379 if (MARKERP (readcharfun))
1380 {
1381 if (NILP (start))
1382 start = readcharfun;
1383 }
1384
1385 if (BUFFERP (readcharfun))
1386 b = XBUFFER (readcharfun);
1387 else if (MARKERP (readcharfun))
1388 b = XMARKER (readcharfun)->buffer;
1389
1390 /* We assume START is nil when input is not from a buffer. */
1391 if (! NILP (start) && !b)
1392 abort ();
1393
1394 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1395 specbind (Qcurrent_load_list, Qnil);
1396 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1397 load_convert_to_unibyte = !NILP (unibyte);
1398
1399 readchar_backlog = -1;
1400
1401 GCPRO4 (sourcename, readfun, start, end);
1402
1403 /* Try to ensure sourcename is a truename, except whilst preloading. */
1404 if (NILP (Vpurify_flag)
1405 && !NILP (sourcename) && Ffile_name_absolute_p (sourcename)
1406 && (!NILP (Ffboundp (Qfile_truename))))
1407 sourcename = call1 (Qfile_truename, sourcename) ;
1408
1409 LOADHIST_ATTACH (sourcename);
1410
1411 continue_reading_p = 1;
1412 while (continue_reading_p)
1413 {
1414 int count1 = SPECPDL_INDEX ();
1415
1416 if (b != 0 && NILP (b->name))
1417 error ("Reading from killed buffer");
1418
1419 if (!NILP (start))
1420 {
1421 /* Switch to the buffer we are reading from. */
1422 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1423 set_buffer_internal (b);
1424
1425 /* Save point in it. */
1426 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1427 /* Save ZV in it. */
1428 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1429 /* Those get unbound after we read one expression. */
1430
1431 /* Set point and ZV around stuff to be read. */
1432 Fgoto_char (start);
1433 if (!NILP (end))
1434 Fnarrow_to_region (make_number (BEGV), end);
1435
1436 /* Just for cleanliness, convert END to a marker
1437 if it is an integer. */
1438 if (INTEGERP (end))
1439 end = Fpoint_max_marker ();
1440 }
1441
1442 /* On the first cycle, we can easily test here
1443 whether we are reading the whole buffer. */
1444 if (b && first_sexp)
1445 whole_buffer = (PT == BEG && ZV == Z);
1446
1447 instream = stream;
1448 read_next:
1449 c = READCHAR;
1450 if (c == ';')
1451 {
1452 while ((c = READCHAR) != '\n' && c != -1);
1453 goto read_next;
1454 }
1455 if (c < 0)
1456 {
1457 unbind_to (count1, Qnil);
1458 break;
1459 }
1460
1461 /* Ignore whitespace here, so we can detect eof. */
1462 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r')
1463 goto read_next;
1464
1465 if (!NILP (Vpurify_flag) && c == '(')
1466 {
1467 record_unwind_protect (unreadpure, Qnil);
1468 val = read_list (-1, readcharfun);
1469 }
1470 else
1471 {
1472 UNREAD (c);
1473 read_objects = Qnil;
1474 if (!NILP (readfun))
1475 {
1476 val = call1 (readfun, readcharfun);
1477
1478 /* If READCHARFUN has set point to ZV, we should
1479 stop reading, even if the form read sets point
1480 to a different value when evaluated. */
1481 if (BUFFERP (readcharfun))
1482 {
1483 struct buffer *b = XBUFFER (readcharfun);
1484 if (BUF_PT (b) == BUF_ZV (b))
1485 continue_reading_p = 0;
1486 }
1487 }
1488 else if (! NILP (Vload_read_function))
1489 val = call1 (Vload_read_function, readcharfun);
1490 else
1491 val = read_internal_start (readcharfun, Qnil, Qnil);
1492 }
1493
1494 if (!NILP (start) && continue_reading_p)
1495 start = Fpoint_marker ();
1496
1497 /* Restore saved point and BEGV. */
1498 unbind_to (count1, Qnil);
1499
1500 /* Now eval what we just read. */
1501 val = (*evalfun) (val);
1502
1503 if (printflag)
1504 {
1505 Vvalues = Fcons (val, Vvalues);
1506 if (EQ (Vstandard_output, Qt))
1507 Fprin1 (val, Qnil);
1508 else
1509 Fprint (val, Qnil);
1510 }
1511
1512 first_sexp = 0;
1513 }
1514
1515 build_load_history (sourcename,
1516 stream || whole_buffer);
1517
1518 UNGCPRO;
1519
1520 unbind_to (count, Qnil);
1521 }
1522
1523 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1524 doc: /* Execute the current buffer as Lisp code.
1525 Programs can pass two arguments, BUFFER and PRINTFLAG.
1526 BUFFER is the buffer to evaluate (nil means use current buffer).
1527 PRINTFLAG controls printing of output:
1528 nil means discard it; anything else is stream for print.
1529
1530 If the optional third argument FILENAME is non-nil,
1531 it specifies the file name to use for `load-history'.
1532 The optional fourth argument UNIBYTE specifies `load-convert-to-unibyte'
1533 for this invocation.
1534
1535 The optional fifth argument DO-ALLOW-PRINT, if non-nil, specifies that
1536 `print' and related functions should work normally even if PRINTFLAG is nil.
1537
1538 This function preserves the position of point. */)
1539 (buffer, printflag, filename, unibyte, do_allow_print)
1540 Lisp_Object buffer, printflag, filename, unibyte, do_allow_print;
1541 {
1542 int count = SPECPDL_INDEX ();
1543 Lisp_Object tem, buf;
1544
1545 if (NILP (buffer))
1546 buf = Fcurrent_buffer ();
1547 else
1548 buf = Fget_buffer (buffer);
1549 if (NILP (buf))
1550 error ("No such buffer");
1551
1552 if (NILP (printflag) && NILP (do_allow_print))
1553 tem = Qsymbolp;
1554 else
1555 tem = printflag;
1556
1557 if (NILP (filename))
1558 filename = XBUFFER (buf)->filename;
1559
1560 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1561 specbind (Qstandard_output, tem);
1562 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1563 BUF_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1564 readevalloop (buf, 0, filename, Feval,
1565 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1566 unbind_to (count, Qnil);
1567
1568 return Qnil;
1569 }
1570
1571 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1572 doc: /* Execute the region as Lisp code.
1573 When called from programs, expects two arguments,
1574 giving starting and ending indices in the current buffer
1575 of the text to be executed.
1576 Programs can pass third argument PRINTFLAG which controls output:
1577 nil means discard it; anything else is stream for printing it.
1578 Also the fourth argument READ-FUNCTION, if non-nil, is used
1579 instead of `read' to read each expression. It gets one argument
1580 which is the input stream for reading characters.
1581
1582 This function does not move point. */)
1583 (start, end, printflag, read_function)
1584 Lisp_Object start, end, printflag, read_function;
1585 {
1586 int count = SPECPDL_INDEX ();
1587 Lisp_Object tem, cbuf;
1588
1589 cbuf = Fcurrent_buffer ();
1590
1591 if (NILP (printflag))
1592 tem = Qsymbolp;
1593 else
1594 tem = printflag;
1595 specbind (Qstandard_output, tem);
1596 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1597
1598 /* readevalloop calls functions which check the type of start and end. */
1599 readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval,
1600 !NILP (printflag), Qnil, read_function,
1601 start, end);
1602
1603 return unbind_to (count, Qnil);
1604 }
1605
1606 \f
1607 DEFUN ("read", Fread, Sread, 0, 1, 0,
1608 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1609 If STREAM is nil, use the value of `standard-input' (which see).
1610 STREAM or the value of `standard-input' may be:
1611 a buffer (read from point and advance it)
1612 a marker (read from where it points and advance it)
1613 a function (call it with no arguments for each character,
1614 call it with a char as argument to push a char back)
1615 a string (takes text from string, starting at the beginning)
1616 t (read text line using minibuffer and use it, or read from
1617 standard input in batch mode). */)
1618 (stream)
1619 Lisp_Object stream;
1620 {
1621 if (NILP (stream))
1622 stream = Vstandard_input;
1623 if (EQ (stream, Qt))
1624 stream = Qread_char;
1625 if (EQ (stream, Qread_char))
1626 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1627
1628 return read_internal_start (stream, Qnil, Qnil);
1629 }
1630
1631 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1632 doc: /* Read one Lisp expression which is represented as text by STRING.
1633 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1634 START and END optionally delimit a substring of STRING from which to read;
1635 they default to 0 and (length STRING) respectively. */)
1636 (string, start, end)
1637 Lisp_Object string, start, end;
1638 {
1639 Lisp_Object ret;
1640 CHECK_STRING (string);
1641 /* read_internal_start sets read_from_string_index. */
1642 ret = read_internal_start (string, start, end);
1643 return Fcons (ret, make_number (read_from_string_index));
1644 }
1645
1646 /* Function to set up the global context we need in toplevel read
1647 calls. */
1648 static Lisp_Object
1649 read_internal_start (stream, start, end)
1650 Lisp_Object stream;
1651 Lisp_Object start; /* Only used when stream is a string. */
1652 Lisp_Object end; /* Only used when stream is a string. */
1653 {
1654 Lisp_Object retval;
1655
1656 readchar_backlog = -1;
1657 readchar_count = 0;
1658 new_backquote_flag = 0;
1659 read_objects = Qnil;
1660 if (EQ (Vread_with_symbol_positions, Qt)
1661 || EQ (Vread_with_symbol_positions, stream))
1662 Vread_symbol_positions_list = Qnil;
1663
1664 if (STRINGP (stream))
1665 {
1666 int startval, endval;
1667 if (NILP (end))
1668 endval = SCHARS (stream);
1669 else
1670 {
1671 CHECK_NUMBER (end);
1672 endval = XINT (end);
1673 if (endval < 0 || endval > SCHARS (stream))
1674 args_out_of_range (stream, end);
1675 }
1676
1677 if (NILP (start))
1678 startval = 0;
1679 else
1680 {
1681 CHECK_NUMBER (start);
1682 startval = XINT (start);
1683 if (startval < 0 || startval > endval)
1684 args_out_of_range (stream, start);
1685 }
1686 read_from_string_index = startval;
1687 read_from_string_index_byte = string_char_to_byte (stream, startval);
1688 read_from_string_limit = endval;
1689 }
1690
1691 retval = read0 (stream);
1692 if (EQ (Vread_with_symbol_positions, Qt)
1693 || EQ (Vread_with_symbol_positions, stream))
1694 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1695 return retval;
1696 }
1697 \f
1698 /* Use this for recursive reads, in contexts where internal tokens
1699 are not allowed. */
1700
1701 static Lisp_Object
1702 read0 (readcharfun)
1703 Lisp_Object readcharfun;
1704 {
1705 register Lisp_Object val;
1706 int c;
1707
1708 val = read1 (readcharfun, &c, 0);
1709 if (c)
1710 Fsignal (Qinvalid_read_syntax, Fcons (Fmake_string (make_number (1),
1711 make_number (c)),
1712 Qnil));
1713
1714 return val;
1715 }
1716 \f
1717 static int read_buffer_size;
1718 static char *read_buffer;
1719
1720 /* Read multibyte form and return it as a character. C is a first
1721 byte of multibyte form, and rest of them are read from
1722 READCHARFUN. */
1723
1724 static int
1725 read_multibyte (c, readcharfun)
1726 register int c;
1727 Lisp_Object readcharfun;
1728 {
1729 /* We need the actual character code of this multibyte
1730 characters. */
1731 unsigned char str[MAX_MULTIBYTE_LENGTH];
1732 int len = 0;
1733 int bytes;
1734
1735 if (c < 0)
1736 return c;
1737
1738 str[len++] = c;
1739 while ((c = READCHAR) >= 0xA0
1740 && len < MAX_MULTIBYTE_LENGTH)
1741 {
1742 str[len++] = c;
1743 readchar_count--;
1744 }
1745 UNREAD (c);
1746 if (UNIBYTE_STR_AS_MULTIBYTE_P (str, len, bytes))
1747 return STRING_CHAR (str, len);
1748 /* The byte sequence is not valid as multibyte. Unread all bytes
1749 but the first one, and return the first byte. */
1750 while (--len > 0)
1751 UNREAD (str[len]);
1752 return str[0];
1753 }
1754
1755 /* Read a \-escape sequence, assuming we already read the `\'.
1756 If the escape sequence forces unibyte, store 1 into *BYTEREP.
1757 If the escape sequence forces multibyte, store 2 into *BYTEREP.
1758 Otherwise store 0 into *BYTEREP. */
1759
1760 static int
1761 read_escape (readcharfun, stringp, byterep)
1762 Lisp_Object readcharfun;
1763 int stringp;
1764 int *byterep;
1765 {
1766 register int c = READCHAR;
1767 /* \u allows up to four hex digits, \U up to eight. Default to the
1768 behaviour for \u, and change this value in the case that \U is seen. */
1769 int unicode_hex_count = 4;
1770
1771 *byterep = 0;
1772
1773 switch (c)
1774 {
1775 case -1:
1776 end_of_file_error ();
1777
1778 case 'a':
1779 return '\007';
1780 case 'b':
1781 return '\b';
1782 case 'd':
1783 return 0177;
1784 case 'e':
1785 return 033;
1786 case 'f':
1787 return '\f';
1788 case 'n':
1789 return '\n';
1790 case 'r':
1791 return '\r';
1792 case 't':
1793 return '\t';
1794 case 'v':
1795 return '\v';
1796 case '\n':
1797 return -1;
1798 case ' ':
1799 if (stringp)
1800 return -1;
1801 return ' ';
1802
1803 case 'M':
1804 c = READCHAR;
1805 if (c != '-')
1806 error ("Invalid escape character syntax");
1807 c = READCHAR;
1808 if (c == '\\')
1809 c = read_escape (readcharfun, 0, byterep);
1810 return c | meta_modifier;
1811
1812 case 'S':
1813 c = READCHAR;
1814 if (c != '-')
1815 error ("Invalid escape character syntax");
1816 c = READCHAR;
1817 if (c == '\\')
1818 c = read_escape (readcharfun, 0, byterep);
1819 return c | shift_modifier;
1820
1821 case 'H':
1822 c = READCHAR;
1823 if (c != '-')
1824 error ("Invalid escape character syntax");
1825 c = READCHAR;
1826 if (c == '\\')
1827 c = read_escape (readcharfun, 0, byterep);
1828 return c | hyper_modifier;
1829
1830 case 'A':
1831 c = READCHAR;
1832 if (c != '-')
1833 error ("Invalid escape character syntax");
1834 c = READCHAR;
1835 if (c == '\\')
1836 c = read_escape (readcharfun, 0, byterep);
1837 return c | alt_modifier;
1838
1839 case 's':
1840 c = READCHAR;
1841 if (c != '-')
1842 {
1843 UNREAD (c);
1844 return ' ';
1845 }
1846 c = READCHAR;
1847 if (c == '\\')
1848 c = read_escape (readcharfun, 0, byterep);
1849 return c | super_modifier;
1850
1851 case 'C':
1852 c = READCHAR;
1853 if (c != '-')
1854 error ("Invalid escape character syntax");
1855 case '^':
1856 c = READCHAR;
1857 if (c == '\\')
1858 c = read_escape (readcharfun, 0, byterep);
1859 if ((c & ~CHAR_MODIFIER_MASK) == '?')
1860 return 0177 | (c & CHAR_MODIFIER_MASK);
1861 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
1862 return c | ctrl_modifier;
1863 /* ASCII control chars are made from letters (both cases),
1864 as well as the non-letters within 0100...0137. */
1865 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
1866 return (c & (037 | ~0177));
1867 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
1868 return (c & (037 | ~0177));
1869 else
1870 return c | ctrl_modifier;
1871
1872 case '0':
1873 case '1':
1874 case '2':
1875 case '3':
1876 case '4':
1877 case '5':
1878 case '6':
1879 case '7':
1880 /* An octal escape, as in ANSI C. */
1881 {
1882 register int i = c - '0';
1883 register int count = 0;
1884 while (++count < 3)
1885 {
1886 if ((c = READCHAR) >= '0' && c <= '7')
1887 {
1888 i *= 8;
1889 i += c - '0';
1890 }
1891 else
1892 {
1893 UNREAD (c);
1894 break;
1895 }
1896 }
1897
1898 *byterep = 1;
1899 return i;
1900 }
1901
1902 case 'x':
1903 /* A hex escape, as in ANSI C. */
1904 {
1905 int i = 0;
1906 while (1)
1907 {
1908 c = READCHAR;
1909 if (c >= '0' && c <= '9')
1910 {
1911 i *= 16;
1912 i += c - '0';
1913 }
1914 else if ((c >= 'a' && c <= 'f')
1915 || (c >= 'A' && c <= 'F'))
1916 {
1917 i *= 16;
1918 if (c >= 'a' && c <= 'f')
1919 i += c - 'a' + 10;
1920 else
1921 i += c - 'A' + 10;
1922 }
1923 else
1924 {
1925 UNREAD (c);
1926 break;
1927 }
1928 }
1929
1930 *byterep = 2;
1931 return i;
1932 }
1933
1934 case 'U':
1935 /* Post-Unicode-2.0: Up to eight hex chars. */
1936 unicode_hex_count = 8;
1937 case 'u':
1938
1939 /* A Unicode escape. We only permit them in strings and characters,
1940 not arbitrarily in the source code, as in some other languages. */
1941 {
1942 int i = 0;
1943 int count = 0;
1944 Lisp_Object lisp_char;
1945 struct gcpro gcpro1;
1946
1947 while (++count <= unicode_hex_count)
1948 {
1949 c = READCHAR;
1950 /* isdigit(), isalpha() may be locale-specific, which we don't
1951 want. */
1952 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
1953 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
1954 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
1955 else
1956 {
1957 error ("Non-hex digit used for Unicode escape");
1958 break;
1959 }
1960 }
1961
1962 GCPRO1 (readcharfun);
1963 lisp_char = call2(intern("decode-char"), intern("ucs"),
1964 make_number(i));
1965 UNGCPRO;
1966
1967 if (EQ(Qnil, lisp_char))
1968 {
1969 /* This is ugly and horrible and trashes the user's data. */
1970 XSETFASTINT (i, MAKE_CHAR (charset_katakana_jisx0201,
1971 34 + 128, 46 + 128));
1972 return i;
1973 }
1974 else
1975 {
1976 return XFASTINT (lisp_char);
1977 }
1978 }
1979
1980 default:
1981 if (BASE_LEADING_CODE_P (c))
1982 c = read_multibyte (c, readcharfun);
1983 return c;
1984 }
1985 }
1986
1987
1988 /* Read an integer in radix RADIX using READCHARFUN to read
1989 characters. RADIX must be in the interval [2..36]; if it isn't, a
1990 read error is signaled . Value is the integer read. Signals an
1991 error if encountering invalid read syntax or if RADIX is out of
1992 range. */
1993
1994 static Lisp_Object
1995 read_integer (readcharfun, radix)
1996 Lisp_Object readcharfun;
1997 int radix;
1998 {
1999 int ndigits = 0, invalid_p, c, sign = 0;
2000 EMACS_INT number = 0;
2001
2002 if (radix < 2 || radix > 36)
2003 invalid_p = 1;
2004 else
2005 {
2006 number = ndigits = invalid_p = 0;
2007 sign = 1;
2008
2009 c = READCHAR;
2010 if (c == '-')
2011 {
2012 c = READCHAR;
2013 sign = -1;
2014 }
2015 else if (c == '+')
2016 c = READCHAR;
2017
2018 while (c >= 0)
2019 {
2020 int digit;
2021
2022 if (c >= '0' && c <= '9')
2023 digit = c - '0';
2024 else if (c >= 'a' && c <= 'z')
2025 digit = c - 'a' + 10;
2026 else if (c >= 'A' && c <= 'Z')
2027 digit = c - 'A' + 10;
2028 else
2029 {
2030 UNREAD (c);
2031 break;
2032 }
2033
2034 if (digit < 0 || digit >= radix)
2035 invalid_p = 1;
2036
2037 number = radix * number + digit;
2038 ++ndigits;
2039 c = READCHAR;
2040 }
2041 }
2042
2043 if (ndigits == 0 || invalid_p)
2044 {
2045 char buf[50];
2046 sprintf (buf, "integer, radix %d", radix);
2047 Fsignal (Qinvalid_read_syntax, Fcons (build_string (buf), Qnil));
2048 }
2049
2050 return make_number (sign * number);
2051 }
2052
2053
2054 /* Convert unibyte text in read_buffer to multibyte.
2055
2056 Initially, *P is a pointer after the end of the unibyte text, and
2057 the pointer *END points after the end of read_buffer.
2058
2059 If read_buffer doesn't have enough room to hold the result
2060 of the conversion, reallocate it and adjust *P and *END.
2061
2062 At the end, make *P point after the result of the conversion, and
2063 return in *NCHARS the number of characters in the converted
2064 text. */
2065
2066 static void
2067 to_multibyte (p, end, nchars)
2068 char **p, **end;
2069 int *nchars;
2070 {
2071 int nbytes;
2072
2073 parse_str_as_multibyte (read_buffer, *p - read_buffer, &nbytes, nchars);
2074 if (read_buffer_size < 2 * nbytes)
2075 {
2076 int offset = *p - read_buffer;
2077 read_buffer_size = 2 * max (read_buffer_size, nbytes);
2078 read_buffer = (char *) xrealloc (read_buffer, read_buffer_size);
2079 *p = read_buffer + offset;
2080 *end = read_buffer + read_buffer_size;
2081 }
2082
2083 if (nbytes != *nchars)
2084 nbytes = str_as_multibyte (read_buffer, read_buffer_size,
2085 *p - read_buffer, nchars);
2086
2087 *p = read_buffer + nbytes;
2088 }
2089
2090
2091 /* If the next token is ')' or ']' or '.', we store that character
2092 in *PCH and the return value is not interesting. Else, we store
2093 zero in *PCH and we read and return one lisp object.
2094
2095 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2096
2097 static Lisp_Object
2098 read1 (readcharfun, pch, first_in_list)
2099 register Lisp_Object readcharfun;
2100 int *pch;
2101 int first_in_list;
2102 {
2103 register int c;
2104 int uninterned_symbol = 0;
2105
2106 *pch = 0;
2107
2108 retry:
2109
2110 c = READCHAR;
2111 if (c < 0)
2112 end_of_file_error ();
2113
2114 switch (c)
2115 {
2116 case '(':
2117 return read_list (0, readcharfun);
2118
2119 case '[':
2120 return read_vector (readcharfun, 0);
2121
2122 case ')':
2123 case ']':
2124 {
2125 *pch = c;
2126 return Qnil;
2127 }
2128
2129 case '#':
2130 c = READCHAR;
2131 if (c == '^')
2132 {
2133 c = READCHAR;
2134 if (c == '[')
2135 {
2136 Lisp_Object tmp;
2137 tmp = read_vector (readcharfun, 0);
2138 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS
2139 || XVECTOR (tmp)->size > CHAR_TABLE_STANDARD_SLOTS + 10)
2140 error ("Invalid size char-table");
2141 XSETCHAR_TABLE (tmp, XCHAR_TABLE (tmp));
2142 XCHAR_TABLE (tmp)->top = Qt;
2143 return tmp;
2144 }
2145 else if (c == '^')
2146 {
2147 c = READCHAR;
2148 if (c == '[')
2149 {
2150 Lisp_Object tmp;
2151 tmp = read_vector (readcharfun, 0);
2152 if (XVECTOR (tmp)->size != SUB_CHAR_TABLE_STANDARD_SLOTS)
2153 error ("Invalid size char-table");
2154 XSETCHAR_TABLE (tmp, XCHAR_TABLE (tmp));
2155 XCHAR_TABLE (tmp)->top = Qnil;
2156 return tmp;
2157 }
2158 Fsignal (Qinvalid_read_syntax,
2159 Fcons (make_string ("#^^", 3), Qnil));
2160 }
2161 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#^", 2), Qnil));
2162 }
2163 if (c == '&')
2164 {
2165 Lisp_Object length;
2166 length = read1 (readcharfun, pch, first_in_list);
2167 c = READCHAR;
2168 if (c == '"')
2169 {
2170 Lisp_Object tmp, val;
2171 int size_in_chars
2172 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2173 / BOOL_VECTOR_BITS_PER_CHAR);
2174
2175 UNREAD (c);
2176 tmp = read1 (readcharfun, pch, first_in_list);
2177 if (size_in_chars != SCHARS (tmp)
2178 /* We used to print 1 char too many
2179 when the number of bits was a multiple of 8.
2180 Accept such input in case it came from an old version. */
2181 && ! (XFASTINT (length)
2182 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR))
2183 Fsignal (Qinvalid_read_syntax,
2184 Fcons (make_string ("#&...", 5), Qnil));
2185
2186 val = Fmake_bool_vector (length, Qnil);
2187 bcopy (SDATA (tmp), XBOOL_VECTOR (val)->data,
2188 size_in_chars);
2189 /* Clear the extraneous bits in the last byte. */
2190 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2191 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2192 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2193 return val;
2194 }
2195 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#&...", 5),
2196 Qnil));
2197 }
2198 if (c == '[')
2199 {
2200 /* Accept compiled functions at read-time so that we don't have to
2201 build them using function calls. */
2202 Lisp_Object tmp;
2203 tmp = read_vector (readcharfun, 1);
2204 return Fmake_byte_code (XVECTOR (tmp)->size,
2205 XVECTOR (tmp)->contents);
2206 }
2207 if (c == '(')
2208 {
2209 Lisp_Object tmp;
2210 struct gcpro gcpro1;
2211 int ch;
2212
2213 /* Read the string itself. */
2214 tmp = read1 (readcharfun, &ch, 0);
2215 if (ch != 0 || !STRINGP (tmp))
2216 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#", 1), Qnil));
2217 GCPRO1 (tmp);
2218 /* Read the intervals and their properties. */
2219 while (1)
2220 {
2221 Lisp_Object beg, end, plist;
2222
2223 beg = read1 (readcharfun, &ch, 0);
2224 end = plist = Qnil;
2225 if (ch == ')')
2226 break;
2227 if (ch == 0)
2228 end = read1 (readcharfun, &ch, 0);
2229 if (ch == 0)
2230 plist = read1 (readcharfun, &ch, 0);
2231 if (ch)
2232 Fsignal (Qinvalid_read_syntax,
2233 Fcons (build_string ("invalid string property list"),
2234 Qnil));
2235 Fset_text_properties (beg, end, plist, tmp);
2236 }
2237 UNGCPRO;
2238 return tmp;
2239 }
2240
2241 /* #@NUMBER is used to skip NUMBER following characters.
2242 That's used in .elc files to skip over doc strings
2243 and function definitions. */
2244 if (c == '@')
2245 {
2246 int i, nskip = 0;
2247
2248 /* Read a decimal integer. */
2249 while ((c = READCHAR) >= 0
2250 && c >= '0' && c <= '9')
2251 {
2252 nskip *= 10;
2253 nskip += c - '0';
2254 }
2255 if (c >= 0)
2256 UNREAD (c);
2257
2258 if (load_force_doc_strings && EQ (readcharfun, Qget_file_char))
2259 {
2260 /* If we are supposed to force doc strings into core right now,
2261 record the last string that we skipped,
2262 and record where in the file it comes from. */
2263
2264 /* But first exchange saved_doc_string
2265 with prev_saved_doc_string, so we save two strings. */
2266 {
2267 char *temp = saved_doc_string;
2268 int temp_size = saved_doc_string_size;
2269 file_offset temp_pos = saved_doc_string_position;
2270 int temp_len = saved_doc_string_length;
2271
2272 saved_doc_string = prev_saved_doc_string;
2273 saved_doc_string_size = prev_saved_doc_string_size;
2274 saved_doc_string_position = prev_saved_doc_string_position;
2275 saved_doc_string_length = prev_saved_doc_string_length;
2276
2277 prev_saved_doc_string = temp;
2278 prev_saved_doc_string_size = temp_size;
2279 prev_saved_doc_string_position = temp_pos;
2280 prev_saved_doc_string_length = temp_len;
2281 }
2282
2283 if (saved_doc_string_size == 0)
2284 {
2285 saved_doc_string_size = nskip + 100;
2286 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2287 }
2288 if (nskip > saved_doc_string_size)
2289 {
2290 saved_doc_string_size = nskip + 100;
2291 saved_doc_string = (char *) xrealloc (saved_doc_string,
2292 saved_doc_string_size);
2293 }
2294
2295 saved_doc_string_position = file_tell (instream);
2296
2297 /* Copy that many characters into saved_doc_string. */
2298 for (i = 0; i < nskip && c >= 0; i++)
2299 saved_doc_string[i] = c = READCHAR;
2300
2301 saved_doc_string_length = i;
2302 }
2303 else
2304 {
2305 /* Skip that many characters. */
2306 for (i = 0; i < nskip && c >= 0; i++)
2307 c = READCHAR;
2308 }
2309
2310 goto retry;
2311 }
2312 if (c == '!')
2313 {
2314 /* #! appears at the beginning of an executable file.
2315 Skip the first line. */
2316 while (c != '\n' && c >= 0)
2317 c = READCHAR;
2318 goto retry;
2319 }
2320 if (c == '$')
2321 return Vload_file_name;
2322 if (c == '\'')
2323 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2324 /* #:foo is the uninterned symbol named foo. */
2325 if (c == ':')
2326 {
2327 uninterned_symbol = 1;
2328 c = READCHAR;
2329 goto default_label;
2330 }
2331 /* Reader forms that can reuse previously read objects. */
2332 if (c >= '0' && c <= '9')
2333 {
2334 int n = 0;
2335 Lisp_Object tem;
2336
2337 /* Read a non-negative integer. */
2338 while (c >= '0' && c <= '9')
2339 {
2340 n *= 10;
2341 n += c - '0';
2342 c = READCHAR;
2343 }
2344 /* #n=object returns object, but associates it with n for #n#. */
2345 if (c == '=')
2346 {
2347 /* Make a placeholder for #n# to use temporarily */
2348 Lisp_Object placeholder;
2349 Lisp_Object cell;
2350
2351 placeholder = Fcons(Qnil, Qnil);
2352 cell = Fcons (make_number (n), placeholder);
2353 read_objects = Fcons (cell, read_objects);
2354
2355 /* Read the object itself. */
2356 tem = read0 (readcharfun);
2357
2358 /* Now put it everywhere the placeholder was... */
2359 substitute_object_in_subtree (tem, placeholder);
2360
2361 /* ...and #n# will use the real value from now on. */
2362 Fsetcdr (cell, tem);
2363
2364 return tem;
2365 }
2366 /* #n# returns a previously read object. */
2367 if (c == '#')
2368 {
2369 tem = Fassq (make_number (n), read_objects);
2370 if (CONSP (tem))
2371 return XCDR (tem);
2372 /* Fall through to error message. */
2373 }
2374 else if (c == 'r' || c == 'R')
2375 return read_integer (readcharfun, n);
2376
2377 /* Fall through to error message. */
2378 }
2379 else if (c == 'x' || c == 'X')
2380 return read_integer (readcharfun, 16);
2381 else if (c == 'o' || c == 'O')
2382 return read_integer (readcharfun, 8);
2383 else if (c == 'b' || c == 'B')
2384 return read_integer (readcharfun, 2);
2385
2386 UNREAD (c);
2387 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#", 1), Qnil));
2388
2389 case ';':
2390 while ((c = READCHAR) >= 0 && c != '\n');
2391 goto retry;
2392
2393 case '\'':
2394 {
2395 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2396 }
2397
2398 case '`':
2399 if (first_in_list)
2400 goto default_label;
2401 else
2402 {
2403 Lisp_Object value;
2404
2405 new_backquote_flag++;
2406 value = read0 (readcharfun);
2407 new_backquote_flag--;
2408
2409 return Fcons (Qbackquote, Fcons (value, Qnil));
2410 }
2411
2412 case ',':
2413 if (new_backquote_flag)
2414 {
2415 Lisp_Object comma_type = Qnil;
2416 Lisp_Object value;
2417 int ch = READCHAR;
2418
2419 if (ch == '@')
2420 comma_type = Qcomma_at;
2421 else if (ch == '.')
2422 comma_type = Qcomma_dot;
2423 else
2424 {
2425 if (ch >= 0) UNREAD (ch);
2426 comma_type = Qcomma;
2427 }
2428
2429 new_backquote_flag--;
2430 value = read0 (readcharfun);
2431 new_backquote_flag++;
2432 return Fcons (comma_type, Fcons (value, Qnil));
2433 }
2434 else
2435 goto default_label;
2436
2437 case '?':
2438 {
2439 int discard;
2440 int next_char;
2441 int ok;
2442
2443 c = READCHAR;
2444 if (c < 0)
2445 end_of_file_error ();
2446
2447 /* Accept `single space' syntax like (list ? x) where the
2448 whitespace character is SPC or TAB.
2449 Other literal whitespace like NL, CR, and FF are not accepted,
2450 as there are well-established escape sequences for these. */
2451 if (c == ' ' || c == '\t')
2452 return make_number (c);
2453
2454 if (c == '\\')
2455 c = read_escape (readcharfun, 0, &discard);
2456 else if (BASE_LEADING_CODE_P (c))
2457 c = read_multibyte (c, readcharfun);
2458
2459 next_char = READCHAR;
2460 if (next_char == '.')
2461 {
2462 /* Only a dotted-pair dot is valid after a char constant. */
2463 int next_next_char = READCHAR;
2464 UNREAD (next_next_char);
2465
2466 ok = (next_next_char <= 040
2467 || (next_next_char < 0200
2468 && (index ("\"';([#?", next_next_char)
2469 || (!first_in_list && next_next_char == '`')
2470 || (new_backquote_flag && next_next_char == ','))));
2471 }
2472 else
2473 {
2474 ok = (next_char <= 040
2475 || (next_char < 0200
2476 && (index ("\"';()[]#?", next_char)
2477 || (!first_in_list && next_char == '`')
2478 || (new_backquote_flag && next_char == ','))));
2479 }
2480 UNREAD (next_char);
2481 if (!ok)
2482 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("?", 1), Qnil));
2483
2484 return make_number (c);
2485 }
2486
2487 case '"':
2488 {
2489 char *p = read_buffer;
2490 char *end = read_buffer + read_buffer_size;
2491 register int c;
2492 /* 1 if we saw an escape sequence specifying
2493 a multibyte character, or a multibyte character. */
2494 int force_multibyte = 0;
2495 /* 1 if we saw an escape sequence specifying
2496 a single-byte character. */
2497 int force_singlebyte = 0;
2498 /* 1 if read_buffer contains multibyte text now. */
2499 int is_multibyte = 0;
2500 int cancel = 0;
2501 int nchars = 0;
2502
2503 while ((c = READCHAR) >= 0
2504 && c != '\"')
2505 {
2506 if (end - p < MAX_MULTIBYTE_LENGTH)
2507 {
2508 int offset = p - read_buffer;
2509 read_buffer = (char *) xrealloc (read_buffer,
2510 read_buffer_size *= 2);
2511 p = read_buffer + offset;
2512 end = read_buffer + read_buffer_size;
2513 }
2514
2515 if (c == '\\')
2516 {
2517 int byterep;
2518
2519 c = read_escape (readcharfun, 1, &byterep);
2520
2521 /* C is -1 if \ newline has just been seen */
2522 if (c == -1)
2523 {
2524 if (p == read_buffer)
2525 cancel = 1;
2526 continue;
2527 }
2528
2529 if (byterep == 1)
2530 force_singlebyte = 1;
2531 else if (byterep == 2)
2532 force_multibyte = 1;
2533 }
2534
2535 /* A character that must be multibyte forces multibyte. */
2536 if (! SINGLE_BYTE_CHAR_P (c & ~CHAR_MODIFIER_MASK))
2537 force_multibyte = 1;
2538
2539 /* If we just discovered the need to be multibyte,
2540 convert the text accumulated thus far. */
2541 if (force_multibyte && ! is_multibyte)
2542 {
2543 is_multibyte = 1;
2544 to_multibyte (&p, &end, &nchars);
2545 }
2546
2547 /* Allow `\C- ' and `\C-?'. */
2548 if (c == (CHAR_CTL | ' '))
2549 c = 0;
2550 else if (c == (CHAR_CTL | '?'))
2551 c = 127;
2552
2553 if (c & CHAR_SHIFT)
2554 {
2555 /* Shift modifier is valid only with [A-Za-z]. */
2556 if ((c & 0377) >= 'A' && (c & 0377) <= 'Z')
2557 c &= ~CHAR_SHIFT;
2558 else if ((c & 0377) >= 'a' && (c & 0377) <= 'z')
2559 c = (c & ~CHAR_SHIFT) - ('a' - 'A');
2560 }
2561
2562 if (c & CHAR_META)
2563 /* Move the meta bit to the right place for a string. */
2564 c = (c & ~CHAR_META) | 0x80;
2565 if (c & CHAR_MODIFIER_MASK)
2566 error ("Invalid modifier in string");
2567
2568 if (is_multibyte)
2569 p += CHAR_STRING (c, p);
2570 else
2571 *p++ = c;
2572
2573 nchars++;
2574 }
2575
2576 if (c < 0)
2577 end_of_file_error ();
2578
2579 /* If purifying, and string starts with \ newline,
2580 return zero instead. This is for doc strings
2581 that we are really going to find in etc/DOC.nn.nn */
2582 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2583 return make_number (0);
2584
2585 if (is_multibyte || force_singlebyte)
2586 ;
2587 else if (load_convert_to_unibyte)
2588 {
2589 Lisp_Object string;
2590 to_multibyte (&p, &end, &nchars);
2591 if (p - read_buffer != nchars)
2592 {
2593 string = make_multibyte_string (read_buffer, nchars,
2594 p - read_buffer);
2595 return Fstring_make_unibyte (string);
2596 }
2597 /* We can make a unibyte string directly. */
2598 is_multibyte = 0;
2599 }
2600 else if (EQ (readcharfun, Qget_file_char)
2601 || EQ (readcharfun, Qlambda))
2602 {
2603 /* Nowadays, reading directly from a file is used only for
2604 compiled Emacs Lisp files, and those always use the
2605 Emacs internal encoding. Meanwhile, Qlambda is used
2606 for reading dynamic byte code (compiled with
2607 byte-compile-dynamic = t). So make the string multibyte
2608 if the string contains any multibyte sequences.
2609 (to_multibyte is a no-op if not.) */
2610 to_multibyte (&p, &end, &nchars);
2611 is_multibyte = (p - read_buffer) != nchars;
2612 }
2613 else
2614 /* In all other cases, if we read these bytes as
2615 separate characters, treat them as separate characters now. */
2616 ;
2617
2618 /* We want readchar_count to be the number of characters, not
2619 bytes. Hence we adjust for multibyte characters in the
2620 string. ... But it doesn't seem to be necessary, because
2621 READCHAR *does* read multibyte characters from buffers. */
2622 /* readchar_count -= (p - read_buffer) - nchars; */
2623 if (read_pure)
2624 return make_pure_string (read_buffer, nchars, p - read_buffer,
2625 is_multibyte);
2626 return make_specified_string (read_buffer, nchars, p - read_buffer,
2627 is_multibyte);
2628 }
2629
2630 case '.':
2631 {
2632 int next_char = READCHAR;
2633 UNREAD (next_char);
2634
2635 if (next_char <= 040
2636 || (next_char < 0200
2637 && (index ("\"';([#?", next_char)
2638 || (!first_in_list && next_char == '`')
2639 || (new_backquote_flag && next_char == ','))))
2640 {
2641 *pch = c;
2642 return Qnil;
2643 }
2644
2645 /* Otherwise, we fall through! Note that the atom-reading loop
2646 below will now loop at least once, assuring that we will not
2647 try to UNREAD two characters in a row. */
2648 }
2649 default:
2650 default_label:
2651 if (c <= 040) goto retry;
2652 {
2653 char *p = read_buffer;
2654 int quoted = 0;
2655
2656 {
2657 char *end = read_buffer + read_buffer_size;
2658
2659 while (c > 040
2660 && (c >= 0200
2661 || (!index ("\"';()[]#", c)
2662 && !(!first_in_list && c == '`')
2663 && !(new_backquote_flag && c == ','))))
2664 {
2665 if (end - p < MAX_MULTIBYTE_LENGTH)
2666 {
2667 int offset = p - read_buffer;
2668 read_buffer = (char *) xrealloc (read_buffer,
2669 read_buffer_size *= 2);
2670 p = read_buffer + offset;
2671 end = read_buffer + read_buffer_size;
2672 }
2673
2674 if (c == '\\')
2675 {
2676 c = READCHAR;
2677 if (c == -1)
2678 end_of_file_error ();
2679 quoted = 1;
2680 }
2681
2682 if (! SINGLE_BYTE_CHAR_P (c))
2683 p += CHAR_STRING (c, p);
2684 else
2685 *p++ = c;
2686
2687 c = READCHAR;
2688 }
2689
2690 if (p == end)
2691 {
2692 int offset = p - read_buffer;
2693 read_buffer = (char *) xrealloc (read_buffer,
2694 read_buffer_size *= 2);
2695 p = read_buffer + offset;
2696 end = read_buffer + read_buffer_size;
2697 }
2698 *p = 0;
2699 if (c >= 0)
2700 UNREAD (c);
2701 }
2702
2703 if (!quoted && !uninterned_symbol)
2704 {
2705 register char *p1;
2706 register Lisp_Object val;
2707 p1 = read_buffer;
2708 if (*p1 == '+' || *p1 == '-') p1++;
2709 /* Is it an integer? */
2710 if (p1 != p)
2711 {
2712 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2713 /* Integers can have trailing decimal points. */
2714 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2715 if (p1 == p)
2716 /* It is an integer. */
2717 {
2718 if (p1[-1] == '.')
2719 p1[-1] = '\0';
2720 if (sizeof (int) == sizeof (EMACS_INT))
2721 XSETINT (val, atoi (read_buffer));
2722 else if (sizeof (long) == sizeof (EMACS_INT))
2723 XSETINT (val, atol (read_buffer));
2724 else
2725 abort ();
2726 return val;
2727 }
2728 }
2729 if (isfloat_string (read_buffer))
2730 {
2731 /* Compute NaN and infinities using 0.0 in a variable,
2732 to cope with compilers that think they are smarter
2733 than we are. */
2734 double zero = 0.0;
2735
2736 double value;
2737
2738 /* Negate the value ourselves. This treats 0, NaNs,
2739 and infinity properly on IEEE floating point hosts,
2740 and works around a common bug where atof ("-0.0")
2741 drops the sign. */
2742 int negative = read_buffer[0] == '-';
2743
2744 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2745 returns 1, is if the input ends in e+INF or e+NaN. */
2746 switch (p[-1])
2747 {
2748 case 'F':
2749 value = 1.0 / zero;
2750 break;
2751 case 'N':
2752 value = zero / zero;
2753
2754 /* If that made a "negative" NaN, negate it. */
2755
2756 {
2757 int i;
2758 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2759
2760 u_data.d = value;
2761 u_minus_zero.d = - 0.0;
2762 for (i = 0; i < sizeof (double); i++)
2763 if (u_data.c[i] & u_minus_zero.c[i])
2764 {
2765 value = - value;
2766 break;
2767 }
2768 }
2769 /* Now VALUE is a positive NaN. */
2770 break;
2771 default:
2772 value = atof (read_buffer + negative);
2773 break;
2774 }
2775
2776 return make_float (negative ? - value : value);
2777 }
2778 }
2779 {
2780 Lisp_Object result = uninterned_symbol ? make_symbol (read_buffer)
2781 : intern (read_buffer);
2782 if (EQ (Vread_with_symbol_positions, Qt)
2783 || EQ (Vread_with_symbol_positions, readcharfun))
2784 Vread_symbol_positions_list =
2785 /* Kind of a hack; this will probably fail if characters
2786 in the symbol name were escaped. Not really a big
2787 deal, though. */
2788 Fcons (Fcons (result,
2789 make_number (readchar_count
2790 - XFASTINT (Flength (Fsymbol_name (result))))),
2791 Vread_symbol_positions_list);
2792 return result;
2793 }
2794 }
2795 }
2796 }
2797 \f
2798
2799 /* List of nodes we've seen during substitute_object_in_subtree. */
2800 static Lisp_Object seen_list;
2801
2802 static void
2803 substitute_object_in_subtree (object, placeholder)
2804 Lisp_Object object;
2805 Lisp_Object placeholder;
2806 {
2807 Lisp_Object check_object;
2808
2809 /* We haven't seen any objects when we start. */
2810 seen_list = Qnil;
2811
2812 /* Make all the substitutions. */
2813 check_object
2814 = substitute_object_recurse (object, placeholder, object);
2815
2816 /* Clear seen_list because we're done with it. */
2817 seen_list = Qnil;
2818
2819 /* The returned object here is expected to always eq the
2820 original. */
2821 if (!EQ (check_object, object))
2822 error ("Unexpected mutation error in reader");
2823 }
2824
2825 /* Feval doesn't get called from here, so no gc protection is needed. */
2826 #define SUBSTITUTE(get_val, set_val) \
2827 { \
2828 Lisp_Object old_value = get_val; \
2829 Lisp_Object true_value \
2830 = substitute_object_recurse (object, placeholder,\
2831 old_value); \
2832 \
2833 if (!EQ (old_value, true_value)) \
2834 { \
2835 set_val; \
2836 } \
2837 }
2838
2839 static Lisp_Object
2840 substitute_object_recurse (object, placeholder, subtree)
2841 Lisp_Object object;
2842 Lisp_Object placeholder;
2843 Lisp_Object subtree;
2844 {
2845 /* If we find the placeholder, return the target object. */
2846 if (EQ (placeholder, subtree))
2847 return object;
2848
2849 /* If we've been to this node before, don't explore it again. */
2850 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
2851 return subtree;
2852
2853 /* If this node can be the entry point to a cycle, remember that
2854 we've seen it. It can only be such an entry point if it was made
2855 by #n=, which means that we can find it as a value in
2856 read_objects. */
2857 if (!EQ (Qnil, Frassq (subtree, read_objects)))
2858 seen_list = Fcons (subtree, seen_list);
2859
2860 /* Recurse according to subtree's type.
2861 Every branch must return a Lisp_Object. */
2862 switch (XTYPE (subtree))
2863 {
2864 case Lisp_Vectorlike:
2865 {
2866 int i;
2867 int length = XINT (Flength(subtree));
2868 for (i = 0; i < length; i++)
2869 {
2870 Lisp_Object idx = make_number (i);
2871 SUBSTITUTE (Faref (subtree, idx),
2872 Faset (subtree, idx, true_value));
2873 }
2874 return subtree;
2875 }
2876
2877 case Lisp_Cons:
2878 {
2879 SUBSTITUTE (Fcar_safe (subtree),
2880 Fsetcar (subtree, true_value));
2881 SUBSTITUTE (Fcdr_safe (subtree),
2882 Fsetcdr (subtree, true_value));
2883 return subtree;
2884 }
2885
2886 case Lisp_String:
2887 {
2888 /* Check for text properties in each interval.
2889 substitute_in_interval contains part of the logic. */
2890
2891 INTERVAL root_interval = STRING_INTERVALS (subtree);
2892 Lisp_Object arg = Fcons (object, placeholder);
2893
2894 traverse_intervals_noorder (root_interval,
2895 &substitute_in_interval, arg);
2896
2897 return subtree;
2898 }
2899
2900 /* Other types don't recurse any further. */
2901 default:
2902 return subtree;
2903 }
2904 }
2905
2906 /* Helper function for substitute_object_recurse. */
2907 static void
2908 substitute_in_interval (interval, arg)
2909 INTERVAL interval;
2910 Lisp_Object arg;
2911 {
2912 Lisp_Object object = Fcar (arg);
2913 Lisp_Object placeholder = Fcdr (arg);
2914
2915 SUBSTITUTE(interval->plist, interval->plist = true_value);
2916 }
2917
2918 \f
2919 #define LEAD_INT 1
2920 #define DOT_CHAR 2
2921 #define TRAIL_INT 4
2922 #define E_CHAR 8
2923 #define EXP_INT 16
2924
2925 int
2926 isfloat_string (cp)
2927 register char *cp;
2928 {
2929 register int state;
2930
2931 char *start = cp;
2932
2933 state = 0;
2934 if (*cp == '+' || *cp == '-')
2935 cp++;
2936
2937 if (*cp >= '0' && *cp <= '9')
2938 {
2939 state |= LEAD_INT;
2940 while (*cp >= '0' && *cp <= '9')
2941 cp++;
2942 }
2943 if (*cp == '.')
2944 {
2945 state |= DOT_CHAR;
2946 cp++;
2947 }
2948 if (*cp >= '0' && *cp <= '9')
2949 {
2950 state |= TRAIL_INT;
2951 while (*cp >= '0' && *cp <= '9')
2952 cp++;
2953 }
2954 if (*cp == 'e' || *cp == 'E')
2955 {
2956 state |= E_CHAR;
2957 cp++;
2958 if (*cp == '+' || *cp == '-')
2959 cp++;
2960 }
2961
2962 if (*cp >= '0' && *cp <= '9')
2963 {
2964 state |= EXP_INT;
2965 while (*cp >= '0' && *cp <= '9')
2966 cp++;
2967 }
2968 else if (cp == start)
2969 ;
2970 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
2971 {
2972 state |= EXP_INT;
2973 cp += 3;
2974 }
2975 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
2976 {
2977 state |= EXP_INT;
2978 cp += 3;
2979 }
2980
2981 return (((*cp == 0) || (*cp == ' ') || (*cp == '\t') || (*cp == '\n') || (*cp == '\r') || (*cp == '\f'))
2982 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
2983 || state == (DOT_CHAR|TRAIL_INT)
2984 || state == (LEAD_INT|E_CHAR|EXP_INT)
2985 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
2986 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
2987 }
2988
2989 \f
2990 static Lisp_Object
2991 read_vector (readcharfun, bytecodeflag)
2992 Lisp_Object readcharfun;
2993 int bytecodeflag;
2994 {
2995 register int i;
2996 register int size;
2997 register Lisp_Object *ptr;
2998 register Lisp_Object tem, item, vector;
2999 register struct Lisp_Cons *otem;
3000 Lisp_Object len;
3001
3002 tem = read_list (1, readcharfun);
3003 len = Flength (tem);
3004 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3005
3006 size = XVECTOR (vector)->size;
3007 ptr = XVECTOR (vector)->contents;
3008 for (i = 0; i < size; i++)
3009 {
3010 item = Fcar (tem);
3011 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3012 bytecode object, the docstring containing the bytecode and
3013 constants values must be treated as unibyte and passed to
3014 Fread, to get the actual bytecode string and constants vector. */
3015 if (bytecodeflag && load_force_doc_strings)
3016 {
3017 if (i == COMPILED_BYTECODE)
3018 {
3019 if (!STRINGP (item))
3020 error ("Invalid byte code");
3021
3022 /* Delay handling the bytecode slot until we know whether
3023 it is lazily-loaded (we can tell by whether the
3024 constants slot is nil). */
3025 ptr[COMPILED_CONSTANTS] = item;
3026 item = Qnil;
3027 }
3028 else if (i == COMPILED_CONSTANTS)
3029 {
3030 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3031
3032 if (NILP (item))
3033 {
3034 /* Coerce string to unibyte (like string-as-unibyte,
3035 but without generating extra garbage and
3036 guaranteeing no change in the contents). */
3037 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3038 STRING_SET_UNIBYTE (bytestr);
3039
3040 item = Fread (bytestr);
3041 if (!CONSP (item))
3042 error ("Invalid byte code");
3043
3044 otem = XCONS (item);
3045 bytestr = XCAR (item);
3046 item = XCDR (item);
3047 free_cons (otem);
3048 }
3049
3050 /* Now handle the bytecode slot. */
3051 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3052 }
3053 }
3054 ptr[i] = read_pure ? Fpurecopy (item) : item;
3055 otem = XCONS (tem);
3056 tem = Fcdr (tem);
3057 free_cons (otem);
3058 }
3059 return vector;
3060 }
3061
3062 /* FLAG = 1 means check for ] to terminate rather than ) and .
3063 FLAG = -1 means check for starting with defun
3064 and make structure pure. */
3065
3066 static Lisp_Object
3067 read_list (flag, readcharfun)
3068 int flag;
3069 register Lisp_Object readcharfun;
3070 {
3071 /* -1 means check next element for defun,
3072 0 means don't check,
3073 1 means already checked and found defun. */
3074 int defunflag = flag < 0 ? -1 : 0;
3075 Lisp_Object val, tail;
3076 register Lisp_Object elt, tem;
3077 struct gcpro gcpro1, gcpro2;
3078 /* 0 is the normal case.
3079 1 means this list is a doc reference; replace it with the number 0.
3080 2 means this list is a doc reference; replace it with the doc string. */
3081 int doc_reference = 0;
3082
3083 /* Initialize this to 1 if we are reading a list. */
3084 int first_in_list = flag <= 0;
3085
3086 val = Qnil;
3087 tail = Qnil;
3088
3089 while (1)
3090 {
3091 int ch;
3092 GCPRO2 (val, tail);
3093 elt = read1 (readcharfun, &ch, first_in_list);
3094 UNGCPRO;
3095
3096 first_in_list = 0;
3097
3098 /* While building, if the list starts with #$, treat it specially. */
3099 if (EQ (elt, Vload_file_name)
3100 && ! NILP (elt)
3101 && !NILP (Vpurify_flag))
3102 {
3103 if (NILP (Vdoc_file_name))
3104 /* We have not yet called Snarf-documentation, so assume
3105 this file is described in the DOC-MM.NN file
3106 and Snarf-documentation will fill in the right value later.
3107 For now, replace the whole list with 0. */
3108 doc_reference = 1;
3109 else
3110 /* We have already called Snarf-documentation, so make a relative
3111 file name for this file, so it can be found properly
3112 in the installed Lisp directory.
3113 We don't use Fexpand_file_name because that would make
3114 the directory absolute now. */
3115 elt = concat2 (build_string ("../lisp/"),
3116 Ffile_name_nondirectory (elt));
3117 }
3118 else if (EQ (elt, Vload_file_name)
3119 && ! NILP (elt)
3120 && load_force_doc_strings)
3121 doc_reference = 2;
3122
3123 if (ch)
3124 {
3125 if (flag > 0)
3126 {
3127 if (ch == ']')
3128 return val;
3129 Fsignal (Qinvalid_read_syntax,
3130 Fcons (make_string (") or . in a vector", 18), Qnil));
3131 }
3132 if (ch == ')')
3133 return val;
3134 if (ch == '.')
3135 {
3136 GCPRO2 (val, tail);
3137 if (!NILP (tail))
3138 XSETCDR (tail, read0 (readcharfun));
3139 else
3140 val = read0 (readcharfun);
3141 read1 (readcharfun, &ch, 0);
3142 UNGCPRO;
3143 if (ch == ')')
3144 {
3145 if (doc_reference == 1)
3146 return make_number (0);
3147 if (doc_reference == 2)
3148 {
3149 /* Get a doc string from the file we are loading.
3150 If it's in saved_doc_string, get it from there. */
3151 int pos = XINT (XCDR (val));
3152 /* Position is negative for user variables. */
3153 if (pos < 0) pos = -pos;
3154 if (pos >= saved_doc_string_position
3155 && pos < (saved_doc_string_position
3156 + saved_doc_string_length))
3157 {
3158 int start = pos - saved_doc_string_position;
3159 int from, to;
3160
3161 /* Process quoting with ^A,
3162 and find the end of the string,
3163 which is marked with ^_ (037). */
3164 for (from = start, to = start;
3165 saved_doc_string[from] != 037;)
3166 {
3167 int c = saved_doc_string[from++];
3168 if (c == 1)
3169 {
3170 c = saved_doc_string[from++];
3171 if (c == 1)
3172 saved_doc_string[to++] = c;
3173 else if (c == '0')
3174 saved_doc_string[to++] = 0;
3175 else if (c == '_')
3176 saved_doc_string[to++] = 037;
3177 }
3178 else
3179 saved_doc_string[to++] = c;
3180 }
3181
3182 return make_string (saved_doc_string + start,
3183 to - start);
3184 }
3185 /* Look in prev_saved_doc_string the same way. */
3186 else if (pos >= prev_saved_doc_string_position
3187 && pos < (prev_saved_doc_string_position
3188 + prev_saved_doc_string_length))
3189 {
3190 int start = pos - prev_saved_doc_string_position;
3191 int from, to;
3192
3193 /* Process quoting with ^A,
3194 and find the end of the string,
3195 which is marked with ^_ (037). */
3196 for (from = start, to = start;
3197 prev_saved_doc_string[from] != 037;)
3198 {
3199 int c = prev_saved_doc_string[from++];
3200 if (c == 1)
3201 {
3202 c = prev_saved_doc_string[from++];
3203 if (c == 1)
3204 prev_saved_doc_string[to++] = c;
3205 else if (c == '0')
3206 prev_saved_doc_string[to++] = 0;
3207 else if (c == '_')
3208 prev_saved_doc_string[to++] = 037;
3209 }
3210 else
3211 prev_saved_doc_string[to++] = c;
3212 }
3213
3214 return make_string (prev_saved_doc_string + start,
3215 to - start);
3216 }
3217 else
3218 return get_doc_string (val, 0, 0);
3219 }
3220
3221 return val;
3222 }
3223 return Fsignal (Qinvalid_read_syntax, Fcons (make_string (". in wrong context", 18), Qnil));
3224 }
3225 return Fsignal (Qinvalid_read_syntax, Fcons (make_string ("] in a list", 11), Qnil));
3226 }
3227 tem = (read_pure && flag <= 0
3228 ? pure_cons (elt, Qnil)
3229 : Fcons (elt, Qnil));
3230 if (!NILP (tail))
3231 XSETCDR (tail, tem);
3232 else
3233 val = tem;
3234 tail = tem;
3235 if (defunflag < 0)
3236 defunflag = EQ (elt, Qdefun);
3237 else if (defunflag > 0)
3238 read_pure = 1;
3239 }
3240 }
3241 \f
3242 Lisp_Object Vobarray;
3243 Lisp_Object initial_obarray;
3244
3245 /* oblookup stores the bucket number here, for the sake of Funintern. */
3246
3247 int oblookup_last_bucket_number;
3248
3249 static int hash_string ();
3250
3251 /* Get an error if OBARRAY is not an obarray.
3252 If it is one, return it. */
3253
3254 Lisp_Object
3255 check_obarray (obarray)
3256 Lisp_Object obarray;
3257 {
3258 while (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3259 {
3260 /* If Vobarray is now invalid, force it to be valid. */
3261 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3262
3263 obarray = wrong_type_argument (Qvectorp, obarray);
3264 }
3265 return obarray;
3266 }
3267
3268 /* Intern the C string STR: return a symbol with that name,
3269 interned in the current obarray. */
3270
3271 Lisp_Object
3272 intern (str)
3273 const char *str;
3274 {
3275 Lisp_Object tem;
3276 int len = strlen (str);
3277 Lisp_Object obarray;
3278
3279 obarray = Vobarray;
3280 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3281 obarray = check_obarray (obarray);
3282 tem = oblookup (obarray, str, len, len);
3283 if (SYMBOLP (tem))
3284 return tem;
3285 return Fintern (make_string (str, len), obarray);
3286 }
3287
3288 /* Create an uninterned symbol with name STR. */
3289
3290 Lisp_Object
3291 make_symbol (str)
3292 char *str;
3293 {
3294 int len = strlen (str);
3295
3296 return Fmake_symbol ((!NILP (Vpurify_flag)
3297 ? make_pure_string (str, len, len, 0)
3298 : make_string (str, len)));
3299 }
3300 \f
3301 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3302 doc: /* Return the canonical symbol whose name is STRING.
3303 If there is none, one is created by this function and returned.
3304 A second optional argument specifies the obarray to use;
3305 it defaults to the value of `obarray'. */)
3306 (string, obarray)
3307 Lisp_Object string, obarray;
3308 {
3309 register Lisp_Object tem, sym, *ptr;
3310
3311 if (NILP (obarray)) obarray = Vobarray;
3312 obarray = check_obarray (obarray);
3313
3314 CHECK_STRING (string);
3315
3316 tem = oblookup (obarray, SDATA (string),
3317 SCHARS (string),
3318 SBYTES (string));
3319 if (!INTEGERP (tem))
3320 return tem;
3321
3322 if (!NILP (Vpurify_flag))
3323 string = Fpurecopy (string);
3324 sym = Fmake_symbol (string);
3325
3326 if (EQ (obarray, initial_obarray))
3327 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3328 else
3329 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3330
3331 if ((SREF (string, 0) == ':')
3332 && EQ (obarray, initial_obarray))
3333 {
3334 XSYMBOL (sym)->constant = 1;
3335 XSYMBOL (sym)->value = sym;
3336 }
3337
3338 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3339 if (SYMBOLP (*ptr))
3340 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3341 else
3342 XSYMBOL (sym)->next = 0;
3343 *ptr = sym;
3344 return sym;
3345 }
3346
3347 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3348 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3349 NAME may be a string or a symbol. If it is a symbol, that exact
3350 symbol is searched for.
3351 A second optional argument specifies the obarray to use;
3352 it defaults to the value of `obarray'. */)
3353 (name, obarray)
3354 Lisp_Object name, obarray;
3355 {
3356 register Lisp_Object tem, string;
3357
3358 if (NILP (obarray)) obarray = Vobarray;
3359 obarray = check_obarray (obarray);
3360
3361 if (!SYMBOLP (name))
3362 {
3363 CHECK_STRING (name);
3364 string = name;
3365 }
3366 else
3367 string = SYMBOL_NAME (name);
3368
3369 tem = oblookup (obarray, SDATA (string), SCHARS (string), SBYTES (string));
3370 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3371 return Qnil;
3372 else
3373 return tem;
3374 }
3375 \f
3376 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3377 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3378 The value is t if a symbol was found and deleted, nil otherwise.
3379 NAME may be a string or a symbol. If it is a symbol, that symbol
3380 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3381 OBARRAY defaults to the value of the variable `obarray'. */)
3382 (name, obarray)
3383 Lisp_Object name, obarray;
3384 {
3385 register Lisp_Object string, tem;
3386 int hash;
3387
3388 if (NILP (obarray)) obarray = Vobarray;
3389 obarray = check_obarray (obarray);
3390
3391 if (SYMBOLP (name))
3392 string = SYMBOL_NAME (name);
3393 else
3394 {
3395 CHECK_STRING (name);
3396 string = name;
3397 }
3398
3399 tem = oblookup (obarray, SDATA (string),
3400 SCHARS (string),
3401 SBYTES (string));
3402 if (INTEGERP (tem))
3403 return Qnil;
3404 /* If arg was a symbol, don't delete anything but that symbol itself. */
3405 if (SYMBOLP (name) && !EQ (name, tem))
3406 return Qnil;
3407
3408 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3409 XSYMBOL (tem)->constant = 0;
3410 XSYMBOL (tem)->indirect_variable = 0;
3411
3412 hash = oblookup_last_bucket_number;
3413
3414 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3415 {
3416 if (XSYMBOL (tem)->next)
3417 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3418 else
3419 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3420 }
3421 else
3422 {
3423 Lisp_Object tail, following;
3424
3425 for (tail = XVECTOR (obarray)->contents[hash];
3426 XSYMBOL (tail)->next;
3427 tail = following)
3428 {
3429 XSETSYMBOL (following, XSYMBOL (tail)->next);
3430 if (EQ (following, tem))
3431 {
3432 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3433 break;
3434 }
3435 }
3436 }
3437
3438 return Qt;
3439 }
3440 \f
3441 /* Return the symbol in OBARRAY whose names matches the string
3442 of SIZE characters (SIZE_BYTE bytes) at PTR.
3443 If there is no such symbol in OBARRAY, return nil.
3444
3445 Also store the bucket number in oblookup_last_bucket_number. */
3446
3447 Lisp_Object
3448 oblookup (obarray, ptr, size, size_byte)
3449 Lisp_Object obarray;
3450 register const char *ptr;
3451 int size, size_byte;
3452 {
3453 int hash;
3454 int obsize;
3455 register Lisp_Object tail;
3456 Lisp_Object bucket, tem;
3457
3458 if (!VECTORP (obarray)
3459 || (obsize = XVECTOR (obarray)->size) == 0)
3460 {
3461 obarray = check_obarray (obarray);
3462 obsize = XVECTOR (obarray)->size;
3463 }
3464 /* This is sometimes needed in the middle of GC. */
3465 obsize &= ~ARRAY_MARK_FLAG;
3466 /* Combining next two lines breaks VMS C 2.3. */
3467 hash = hash_string (ptr, size_byte);
3468 hash %= obsize;
3469 bucket = XVECTOR (obarray)->contents[hash];
3470 oblookup_last_bucket_number = hash;
3471 if (EQ (bucket, make_number (0)))
3472 ;
3473 else if (!SYMBOLP (bucket))
3474 error ("Bad data in guts of obarray"); /* Like CADR error message */
3475 else
3476 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3477 {
3478 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3479 && SCHARS (SYMBOL_NAME (tail)) == size
3480 && !bcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3481 return tail;
3482 else if (XSYMBOL (tail)->next == 0)
3483 break;
3484 }
3485 XSETINT (tem, hash);
3486 return tem;
3487 }
3488
3489 static int
3490 hash_string (ptr, len)
3491 const unsigned char *ptr;
3492 int len;
3493 {
3494 register const unsigned char *p = ptr;
3495 register const unsigned char *end = p + len;
3496 register unsigned char c;
3497 register int hash = 0;
3498
3499 while (p != end)
3500 {
3501 c = *p++;
3502 if (c >= 0140) c -= 40;
3503 hash = ((hash<<3) + (hash>>28) + c);
3504 }
3505 return hash & 07777777777;
3506 }
3507 \f
3508 void
3509 map_obarray (obarray, fn, arg)
3510 Lisp_Object obarray;
3511 void (*fn) P_ ((Lisp_Object, Lisp_Object));
3512 Lisp_Object arg;
3513 {
3514 register int i;
3515 register Lisp_Object tail;
3516 CHECK_VECTOR (obarray);
3517 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3518 {
3519 tail = XVECTOR (obarray)->contents[i];
3520 if (SYMBOLP (tail))
3521 while (1)
3522 {
3523 (*fn) (tail, arg);
3524 if (XSYMBOL (tail)->next == 0)
3525 break;
3526 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3527 }
3528 }
3529 }
3530
3531 void
3532 mapatoms_1 (sym, function)
3533 Lisp_Object sym, function;
3534 {
3535 call1 (function, sym);
3536 }
3537
3538 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3539 doc: /* Call FUNCTION on every symbol in OBARRAY.
3540 OBARRAY defaults to the value of `obarray'. */)
3541 (function, obarray)
3542 Lisp_Object function, obarray;
3543 {
3544 if (NILP (obarray)) obarray = Vobarray;
3545 obarray = check_obarray (obarray);
3546
3547 map_obarray (obarray, mapatoms_1, function);
3548 return Qnil;
3549 }
3550
3551 #define OBARRAY_SIZE 1511
3552
3553 void
3554 init_obarray ()
3555 {
3556 Lisp_Object oblength;
3557 int hash;
3558 Lisp_Object *tem;
3559
3560 XSETFASTINT (oblength, OBARRAY_SIZE);
3561
3562 Qnil = Fmake_symbol (make_pure_string ("nil", 3, 3, 0));
3563 Vobarray = Fmake_vector (oblength, make_number (0));
3564 initial_obarray = Vobarray;
3565 staticpro (&initial_obarray);
3566 /* Intern nil in the obarray */
3567 XSYMBOL (Qnil)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3568 XSYMBOL (Qnil)->constant = 1;
3569
3570 /* These locals are to kludge around a pyramid compiler bug. */
3571 hash = hash_string ("nil", 3);
3572 /* Separate statement here to avoid VAXC bug. */
3573 hash %= OBARRAY_SIZE;
3574 tem = &XVECTOR (Vobarray)->contents[hash];
3575 *tem = Qnil;
3576
3577 Qunbound = Fmake_symbol (make_pure_string ("unbound", 7, 7, 0));
3578 XSYMBOL (Qnil)->function = Qunbound;
3579 XSYMBOL (Qunbound)->value = Qunbound;
3580 XSYMBOL (Qunbound)->function = Qunbound;
3581
3582 Qt = intern ("t");
3583 XSYMBOL (Qnil)->value = Qnil;
3584 XSYMBOL (Qnil)->plist = Qnil;
3585 XSYMBOL (Qt)->value = Qt;
3586 XSYMBOL (Qt)->constant = 1;
3587
3588 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3589 Vpurify_flag = Qt;
3590
3591 Qvariable_documentation = intern ("variable-documentation");
3592 staticpro (&Qvariable_documentation);
3593
3594 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3595 read_buffer = (char *) xmalloc (read_buffer_size);
3596 }
3597 \f
3598 void
3599 defsubr (sname)
3600 struct Lisp_Subr *sname;
3601 {
3602 Lisp_Object sym;
3603 sym = intern (sname->symbol_name);
3604 XSETSUBR (XSYMBOL (sym)->function, sname);
3605 }
3606
3607 #ifdef NOTDEF /* use fset in subr.el now */
3608 void
3609 defalias (sname, string)
3610 struct Lisp_Subr *sname;
3611 char *string;
3612 {
3613 Lisp_Object sym;
3614 sym = intern (string);
3615 XSETSUBR (XSYMBOL (sym)->function, sname);
3616 }
3617 #endif /* NOTDEF */
3618
3619 /* Define an "integer variable"; a symbol whose value is forwarded
3620 to a C variable of type int. Sample call: */
3621 /* DEFVAR_INT ("indent-tabs-mode", &indent_tabs_mode, "Documentation"); */
3622 void
3623 defvar_int (namestring, address)
3624 char *namestring;
3625 EMACS_INT *address;
3626 {
3627 Lisp_Object sym, val;
3628 sym = intern (namestring);
3629 val = allocate_misc ();
3630 XMISCTYPE (val) = Lisp_Misc_Intfwd;
3631 XINTFWD (val)->intvar = address;
3632 SET_SYMBOL_VALUE (sym, val);
3633 }
3634
3635 /* Similar but define a variable whose value is t if address contains 1,
3636 nil if address contains 0 */
3637 void
3638 defvar_bool (namestring, address)
3639 char *namestring;
3640 int *address;
3641 {
3642 Lisp_Object sym, val;
3643 sym = intern (namestring);
3644 val = allocate_misc ();
3645 XMISCTYPE (val) = Lisp_Misc_Boolfwd;
3646 XBOOLFWD (val)->boolvar = address;
3647 SET_SYMBOL_VALUE (sym, val);
3648 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3649 }
3650
3651 /* Similar but define a variable whose value is the Lisp Object stored
3652 at address. Two versions: with and without gc-marking of the C
3653 variable. The nopro version is used when that variable will be
3654 gc-marked for some other reason, since marking the same slot twice
3655 can cause trouble with strings. */
3656 void
3657 defvar_lisp_nopro (namestring, address)
3658 char *namestring;
3659 Lisp_Object *address;
3660 {
3661 Lisp_Object sym, val;
3662 sym = intern (namestring);
3663 val = allocate_misc ();
3664 XMISCTYPE (val) = Lisp_Misc_Objfwd;
3665 XOBJFWD (val)->objvar = address;
3666 SET_SYMBOL_VALUE (sym, val);
3667 }
3668
3669 void
3670 defvar_lisp (namestring, address)
3671 char *namestring;
3672 Lisp_Object *address;
3673 {
3674 defvar_lisp_nopro (namestring, address);
3675 staticpro (address);
3676 }
3677
3678 /* Similar but define a variable whose value is the Lisp Object stored in
3679 the current buffer. address is the address of the slot in the buffer
3680 that is current now. */
3681
3682 void
3683 defvar_per_buffer (namestring, address, type, doc)
3684 char *namestring;
3685 Lisp_Object *address;
3686 Lisp_Object type;
3687 char *doc;
3688 {
3689 Lisp_Object sym, val;
3690 int offset;
3691
3692 sym = intern (namestring);
3693 val = allocate_misc ();
3694 offset = (char *)address - (char *)current_buffer;
3695
3696 XMISCTYPE (val) = Lisp_Misc_Buffer_Objfwd;
3697 XBUFFER_OBJFWD (val)->offset = offset;
3698 SET_SYMBOL_VALUE (sym, val);
3699 PER_BUFFER_SYMBOL (offset) = sym;
3700 PER_BUFFER_TYPE (offset) = type;
3701
3702 if (PER_BUFFER_IDX (offset) == 0)
3703 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
3704 slot of buffer_local_flags */
3705 abort ();
3706 }
3707
3708
3709 /* Similar but define a variable whose value is the Lisp Object stored
3710 at a particular offset in the current kboard object. */
3711
3712 void
3713 defvar_kboard (namestring, offset)
3714 char *namestring;
3715 int offset;
3716 {
3717 Lisp_Object sym, val;
3718 sym = intern (namestring);
3719 val = allocate_misc ();
3720 XMISCTYPE (val) = Lisp_Misc_Kboard_Objfwd;
3721 XKBOARD_OBJFWD (val)->offset = offset;
3722 SET_SYMBOL_VALUE (sym, val);
3723 }
3724 \f
3725 /* Record the value of load-path used at the start of dumping
3726 so we can see if the site changed it later during dumping. */
3727 static Lisp_Object dump_path;
3728
3729 void
3730 init_lread ()
3731 {
3732 char *normal;
3733 int turn_off_warning = 0;
3734
3735 /* Compute the default load-path. */
3736 #ifdef CANNOT_DUMP
3737 normal = PATH_LOADSEARCH;
3738 Vload_path = decode_env_path (0, normal);
3739 #else
3740 if (NILP (Vpurify_flag))
3741 normal = PATH_LOADSEARCH;
3742 else
3743 normal = PATH_DUMPLOADSEARCH;
3744
3745 /* In a dumped Emacs, we normally have to reset the value of
3746 Vload_path from PATH_LOADSEARCH, since the value that was dumped
3747 uses ../lisp, instead of the path of the installed elisp
3748 libraries. However, if it appears that Vload_path was changed
3749 from the default before dumping, don't override that value. */
3750 if (initialized)
3751 {
3752 if (! NILP (Fequal (dump_path, Vload_path)))
3753 {
3754 Vload_path = decode_env_path (0, normal);
3755 if (!NILP (Vinstallation_directory))
3756 {
3757 Lisp_Object tem, tem1, sitelisp;
3758
3759 /* Remove site-lisp dirs from path temporarily and store
3760 them in sitelisp, then conc them on at the end so
3761 they're always first in path. */
3762 sitelisp = Qnil;
3763 while (1)
3764 {
3765 tem = Fcar (Vload_path);
3766 tem1 = Fstring_match (build_string ("site-lisp"),
3767 tem, Qnil);
3768 if (!NILP (tem1))
3769 {
3770 Vload_path = Fcdr (Vload_path);
3771 sitelisp = Fcons (tem, sitelisp);
3772 }
3773 else
3774 break;
3775 }
3776
3777 /* Add to the path the lisp subdir of the
3778 installation dir, if it exists. */
3779 tem = Fexpand_file_name (build_string ("lisp"),
3780 Vinstallation_directory);
3781 tem1 = Ffile_exists_p (tem);
3782 if (!NILP (tem1))
3783 {
3784 if (NILP (Fmember (tem, Vload_path)))
3785 {
3786 turn_off_warning = 1;
3787 Vload_path = Fcons (tem, Vload_path);
3788 }
3789 }
3790 else
3791 /* That dir doesn't exist, so add the build-time
3792 Lisp dirs instead. */
3793 Vload_path = nconc2 (Vload_path, dump_path);
3794
3795 /* Add leim under the installation dir, if it exists. */
3796 tem = Fexpand_file_name (build_string ("leim"),
3797 Vinstallation_directory);
3798 tem1 = Ffile_exists_p (tem);
3799 if (!NILP (tem1))
3800 {
3801 if (NILP (Fmember (tem, Vload_path)))
3802 Vload_path = Fcons (tem, Vload_path);
3803 }
3804
3805 /* Add site-list under the installation dir, if it exists. */
3806 tem = Fexpand_file_name (build_string ("site-lisp"),
3807 Vinstallation_directory);
3808 tem1 = Ffile_exists_p (tem);
3809 if (!NILP (tem1))
3810 {
3811 if (NILP (Fmember (tem, Vload_path)))
3812 Vload_path = Fcons (tem, Vload_path);
3813 }
3814
3815 /* If Emacs was not built in the source directory,
3816 and it is run from where it was built, add to load-path
3817 the lisp, leim and site-lisp dirs under that directory. */
3818
3819 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
3820 {
3821 Lisp_Object tem2;
3822
3823 tem = Fexpand_file_name (build_string ("src/Makefile"),
3824 Vinstallation_directory);
3825 tem1 = Ffile_exists_p (tem);
3826
3827 /* Don't be fooled if they moved the entire source tree
3828 AFTER dumping Emacs. If the build directory is indeed
3829 different from the source dir, src/Makefile.in and
3830 src/Makefile will not be found together. */
3831 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
3832 Vinstallation_directory);
3833 tem2 = Ffile_exists_p (tem);
3834 if (!NILP (tem1) && NILP (tem2))
3835 {
3836 tem = Fexpand_file_name (build_string ("lisp"),
3837 Vsource_directory);
3838
3839 if (NILP (Fmember (tem, Vload_path)))
3840 Vload_path = Fcons (tem, Vload_path);
3841
3842 tem = Fexpand_file_name (build_string ("leim"),
3843 Vsource_directory);
3844
3845 if (NILP (Fmember (tem, Vload_path)))
3846 Vload_path = Fcons (tem, Vload_path);
3847
3848 tem = Fexpand_file_name (build_string ("site-lisp"),
3849 Vsource_directory);
3850
3851 if (NILP (Fmember (tem, Vload_path)))
3852 Vload_path = Fcons (tem, Vload_path);
3853 }
3854 }
3855 if (!NILP (sitelisp))
3856 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
3857 }
3858 }
3859 }
3860 else
3861 {
3862 /* NORMAL refers to the lisp dir in the source directory. */
3863 /* We used to add ../lisp at the front here, but
3864 that caused trouble because it was copied from dump_path
3865 into Vload_path, aboe, when Vinstallation_directory was non-nil.
3866 It should be unnecessary. */
3867 Vload_path = decode_env_path (0, normal);
3868 dump_path = Vload_path;
3869 }
3870 #endif
3871
3872 #if (!(defined(WINDOWSNT) || (defined(HAVE_CARBON))))
3873 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
3874 almost never correct, thereby causing a warning to be printed out that
3875 confuses users. Since PATH_LOADSEARCH is always overridden by the
3876 EMACSLOADPATH environment variable below, disable the warning on NT.
3877 Also, when using the "self-contained" option for Carbon Emacs for MacOSX,
3878 the "standard" paths may not exist and would be overridden by
3879 EMACSLOADPATH as on NT. Since this depends on how the executable
3880 was build and packaged, turn off the warnings in general */
3881
3882 /* Warn if dirs in the *standard* path don't exist. */
3883 if (!turn_off_warning)
3884 {
3885 Lisp_Object path_tail;
3886
3887 for (path_tail = Vload_path;
3888 !NILP (path_tail);
3889 path_tail = XCDR (path_tail))
3890 {
3891 Lisp_Object dirfile;
3892 dirfile = Fcar (path_tail);
3893 if (STRINGP (dirfile))
3894 {
3895 dirfile = Fdirectory_file_name (dirfile);
3896 if (access (SDATA (dirfile), 0) < 0)
3897 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
3898 XCAR (path_tail));
3899 }
3900 }
3901 }
3902 #endif /* !(WINDOWSNT || HAVE_CARBON) */
3903
3904 /* If the EMACSLOADPATH environment variable is set, use its value.
3905 This doesn't apply if we're dumping. */
3906 #ifndef CANNOT_DUMP
3907 if (NILP (Vpurify_flag)
3908 && egetenv ("EMACSLOADPATH"))
3909 #endif
3910 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
3911
3912 Vvalues = Qnil;
3913
3914 load_in_progress = 0;
3915 Vload_file_name = Qnil;
3916
3917 load_descriptor_list = Qnil;
3918
3919 Vstandard_input = Qt;
3920 Vloads_in_progress = Qnil;
3921 }
3922
3923 /* Print a warning, using format string FORMAT, that directory DIRNAME
3924 does not exist. Print it on stderr and put it in *Message*. */
3925
3926 void
3927 dir_warning (format, dirname)
3928 char *format;
3929 Lisp_Object dirname;
3930 {
3931 char *buffer
3932 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
3933
3934 fprintf (stderr, format, SDATA (dirname));
3935 sprintf (buffer, format, SDATA (dirname));
3936 /* Don't log the warning before we've initialized!! */
3937 if (initialized)
3938 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
3939 }
3940
3941 void
3942 syms_of_lread ()
3943 {
3944 defsubr (&Sread);
3945 defsubr (&Sread_from_string);
3946 defsubr (&Sintern);
3947 defsubr (&Sintern_soft);
3948 defsubr (&Sunintern);
3949 defsubr (&Sget_load_suffixes);
3950 defsubr (&Sload);
3951 defsubr (&Seval_buffer);
3952 defsubr (&Seval_region);
3953 defsubr (&Sread_char);
3954 defsubr (&Sread_char_exclusive);
3955 defsubr (&Sread_event);
3956 defsubr (&Sget_file_char);
3957 defsubr (&Smapatoms);
3958 defsubr (&Slocate_file_internal);
3959
3960 DEFVAR_LISP ("obarray", &Vobarray,
3961 doc: /* Symbol table for use by `intern' and `read'.
3962 It is a vector whose length ought to be prime for best results.
3963 The vector's contents don't make sense if examined from Lisp programs;
3964 to find all the symbols in an obarray, use `mapatoms'. */);
3965
3966 DEFVAR_LISP ("values", &Vvalues,
3967 doc: /* List of values of all expressions which were read, evaluated and printed.
3968 Order is reverse chronological. */);
3969
3970 DEFVAR_LISP ("standard-input", &Vstandard_input,
3971 doc: /* Stream for read to get input from.
3972 See documentation of `read' for possible values. */);
3973 Vstandard_input = Qt;
3974
3975 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions,
3976 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
3977
3978 If this variable is a buffer, then only forms read from that buffer
3979 will be added to `read-symbol-positions-list'.
3980 If this variable is t, then all read forms will be added.
3981 The effect of all other values other than nil are not currently
3982 defined, although they may be in the future.
3983
3984 The positions are relative to the last call to `read' or
3985 `read-from-string'. It is probably a bad idea to set this variable at
3986 the toplevel; bind it instead. */);
3987 Vread_with_symbol_positions = Qnil;
3988
3989 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list,
3990 doc: /* A list mapping read symbols to their positions.
3991 This variable is modified during calls to `read' or
3992 `read-from-string', but only when `read-with-symbol-positions' is
3993 non-nil.
3994
3995 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
3996 CHAR-POSITION is an integer giving the offset of that occurrence of the
3997 symbol from the position where `read' or `read-from-string' started.
3998
3999 Note that a symbol will appear multiple times in this list, if it was
4000 read multiple times. The list is in the same order as the symbols
4001 were read in. */);
4002 Vread_symbol_positions_list = Qnil;
4003
4004 DEFVAR_LISP ("load-path", &Vload_path,
4005 doc: /* *List of directories to search for files to load.
4006 Each element is a string (directory name) or nil (try default directory).
4007 Initialized based on EMACSLOADPATH environment variable, if any,
4008 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4009
4010 DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
4011 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4012 This list should not include the empty string.
4013 `load' and related functions try to append these suffixes, in order,
4014 to the specified file name if a Lisp suffix is allowed or required. */);
4015 Vload_suffixes = Fcons (build_string (".elc"),
4016 Fcons (build_string (".el"), Qnil));
4017 DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes,
4018 doc: /* List of suffixes that indicate representations of \
4019 the same file.
4020 This list should normally start with the empty string.
4021
4022 Enabling Auto Compression mode appends the suffixes in
4023 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4024 mode removes them again. `load' and related functions use this list to
4025 determine whether they should look for compressed versions of a file
4026 and, if so, which suffixes they should try to append to the file name
4027 in order to do so. However, if you want to customize which suffixes
4028 the loading functions recognize as compression suffixes, you should
4029 customize `jka-compr-load-suffixes' rather than the present variable. */);
4030 /* We don't use empty_string because it's not initialized yet. */
4031 Vload_file_rep_suffixes = Fcons (build_string (""), Qnil);
4032
4033 DEFVAR_BOOL ("load-in-progress", &load_in_progress,
4034 doc: /* Non-nil iff inside of `load'. */);
4035
4036 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist,
4037 doc: /* An alist of expressions to be evalled when particular files are loaded.
4038 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4039
4040 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4041 a symbol \(a feature name).
4042
4043 When `load' is run and the file-name argument matches an element's
4044 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4045 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4046
4047 An error in FORMS does not undo the load, but does prevent execution of
4048 the rest of the FORMS. */);
4049 Vafter_load_alist = Qnil;
4050
4051 DEFVAR_LISP ("load-history", &Vload_history,
4052 doc: /* Alist mapping file names to symbols and features.
4053 Each alist element is a list that starts with a file name,
4054 except for one element (optional) that starts with nil and describes
4055 definitions evaluated from buffers not visiting files.
4056
4057 The file name is absolute and is the true file name (i.e. it doesn't
4058 contain symbolic links) of the loaded file.
4059
4060 The remaining elements of each list are symbols defined as variables
4061 and cons cells of the form `(provide . FEATURE)', `(require . FEATURE)',
4062 `(defun . FUNCTION)', `(autoload . SYMBOL)', and `(t . SYMBOL)'.
4063 An element `(t . SYMBOL)' precedes an entry `(defun . FUNCTION)',
4064 and means that SYMBOL was an autoload before this file redefined it
4065 as a function.
4066
4067 During preloading, the file name recorded is relative to the main Lisp
4068 directory. These file names are converted to absolute at startup. */);
4069 Vload_history = Qnil;
4070
4071 DEFVAR_LISP ("load-file-name", &Vload_file_name,
4072 doc: /* Full name of file being loaded by `load'. */);
4073 Vload_file_name = Qnil;
4074
4075 DEFVAR_LISP ("user-init-file", &Vuser_init_file,
4076 doc: /* File name, including directory, of user's initialization file.
4077 If the file loaded had extension `.elc', and the corresponding source file
4078 exists, this variable contains the name of source file, suitable for use
4079 by functions like `custom-save-all' which edit the init file. */);
4080 Vuser_init_file = Qnil;
4081
4082 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list,
4083 doc: /* Used for internal purposes by `load'. */);
4084 Vcurrent_load_list = Qnil;
4085
4086 DEFVAR_LISP ("load-read-function", &Vload_read_function,
4087 doc: /* Function used by `load' and `eval-region' for reading expressions.
4088 The default is nil, which means use the function `read'. */);
4089 Vload_read_function = Qnil;
4090
4091 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function,
4092 doc: /* Function called in `load' for loading an Emacs lisp source file.
4093 This function is for doing code conversion before reading the source file.
4094 If nil, loading is done without any code conversion.
4095 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4096 FULLNAME is the full name of FILE.
4097 See `load' for the meaning of the remaining arguments. */);
4098 Vload_source_file_function = Qnil;
4099
4100 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings,
4101 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4102 This is useful when the file being loaded is a temporary copy. */);
4103 load_force_doc_strings = 0;
4104
4105 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte,
4106 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4107 This is normally bound by `load' and `eval-buffer' to control `read',
4108 and is not meant for users to change. */);
4109 load_convert_to_unibyte = 0;
4110
4111 DEFVAR_LISP ("source-directory", &Vsource_directory,
4112 doc: /* Directory in which Emacs sources were found when Emacs was built.
4113 You cannot count on them to still be there! */);
4114 Vsource_directory
4115 = Fexpand_file_name (build_string ("../"),
4116 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4117
4118 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list,
4119 doc: /* List of files that were preloaded (when dumping Emacs). */);
4120 Vpreloaded_file_list = Qnil;
4121
4122 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars,
4123 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4124 Vbyte_boolean_vars = Qnil;
4125
4126 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries,
4127 doc: /* Non-nil means load dangerous compiled Lisp files.
4128 Some versions of XEmacs use different byte codes than Emacs. These
4129 incompatible byte codes can make Emacs crash when it tries to execute
4130 them. */);
4131 load_dangerous_libraries = 0;
4132
4133 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp,
4134 doc: /* Regular expression matching safe to load compiled Lisp files.
4135 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4136 from the file, and matches them against this regular expression.
4137 When the regular expression matches, the file is considered to be safe
4138 to load. See also `load-dangerous-libraries'. */);
4139 Vbytecomp_version_regexp
4140 = build_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4141
4142 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list,
4143 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4144 Veval_buffer_list = Qnil;
4145
4146 /* Vsource_directory was initialized in init_lread. */
4147
4148 load_descriptor_list = Qnil;
4149 staticpro (&load_descriptor_list);
4150
4151 Qcurrent_load_list = intern ("current-load-list");
4152 staticpro (&Qcurrent_load_list);
4153
4154 Qstandard_input = intern ("standard-input");
4155 staticpro (&Qstandard_input);
4156
4157 Qread_char = intern ("read-char");
4158 staticpro (&Qread_char);
4159
4160 Qget_file_char = intern ("get-file-char");
4161 staticpro (&Qget_file_char);
4162
4163 Qbackquote = intern ("`");
4164 staticpro (&Qbackquote);
4165 Qcomma = intern (",");
4166 staticpro (&Qcomma);
4167 Qcomma_at = intern (",@");
4168 staticpro (&Qcomma_at);
4169 Qcomma_dot = intern (",.");
4170 staticpro (&Qcomma_dot);
4171
4172 Qinhibit_file_name_operation = intern ("inhibit-file-name-operation");
4173 staticpro (&Qinhibit_file_name_operation);
4174
4175 Qascii_character = intern ("ascii-character");
4176 staticpro (&Qascii_character);
4177
4178 Qfunction = intern ("function");
4179 staticpro (&Qfunction);
4180
4181 Qload = intern ("load");
4182 staticpro (&Qload);
4183
4184 Qload_file_name = intern ("load-file-name");
4185 staticpro (&Qload_file_name);
4186
4187 Qeval_buffer_list = intern ("eval-buffer-list");
4188 staticpro (&Qeval_buffer_list);
4189
4190 Qfile_truename = intern ("file-truename");
4191 staticpro (&Qfile_truename) ;
4192
4193 Qdo_after_load_evaluation = intern ("do-after-load-evaluation");
4194 staticpro (&Qdo_after_load_evaluation) ;
4195
4196 staticpro (&dump_path);
4197
4198 staticpro (&read_objects);
4199 read_objects = Qnil;
4200 staticpro (&seen_list);
4201 seen_list = Qnil;
4202
4203 Vloads_in_progress = Qnil;
4204 staticpro (&Vloads_in_progress);
4205 }
4206
4207 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4208 (do not change this comment) */