lread.c 67.8 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Lisp parsing and input streams.
2
   Copyright (C) 1985, 1986, 1987, 1988, 1989, 
Karl Heuer's avatar
Karl Heuer committed
3
   1993, 1994, 1995 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
4 5 6 7 8

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Jim Blandy's avatar
Jim Blandy committed
9
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
10 11 12 13 14 15 16 17 18
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
19 20
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
21 22


Richard M. Stallman's avatar
Richard M. Stallman committed
23
#include <config.h>
Jim Blandy's avatar
Jim Blandy committed
24 25 26 27
#include <stdio.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/file.h>
28
#include <errno.h>
Jim Blandy's avatar
Jim Blandy committed
29 30 31 32
#include "lisp.h"

#ifndef standalone
#include "buffer.h"
33
#include <paths.h>
Jim Blandy's avatar
Jim Blandy committed
34
#include "commands.h"
Jim Blandy's avatar
Jim Blandy committed
35
#include "keyboard.h"
36
#include "termhooks.h"
Jim Blandy's avatar
Jim Blandy committed
37 38 39 40 41 42
#endif

#ifdef lint
#include <sys/inode.h>
#endif /* lint */

43 44 45 46 47 48 49
#ifdef MSDOS
#if __DJGPP__ < 2
#include <unistd.h>	/* to get X_OK */
#endif
#include "msdos.h"
#endif

Jim Blandy's avatar
Jim Blandy committed
50 51 52 53 54
#ifndef X_OK
#define X_OK 01
#endif

#ifdef LISP_FLOAT_TYPE
55 56 57
#ifdef STDC_HEADERS
#include <stdlib.h>
#endif
58

Jim Blandy's avatar
Jim Blandy committed
59 60 61
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

Richard M. Stallman's avatar
Richard M. Stallman committed
62 63 64 65
#ifdef HAVE_SETLOCALE
#include <locale.h>
#endif /* HAVE_SETLOCALE */

Richard M. Stallman's avatar
Richard M. Stallman committed
66 67 68 69
#ifndef O_RDONLY
#define O_RDONLY 0
#endif

70 71
extern int errno;

72
Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
Jim Blandy's avatar
Jim Blandy committed
73
Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
74
Lisp_Object Qascii_character, Qload, Qload_file_name;
75
Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
76
Lisp_Object Qinhibit_file_name_operation;
77 78

extern Lisp_Object Qevent_symbol_element_mask;
79
extern Lisp_Object Qfile_exists_p;
Jim Blandy's avatar
Jim Blandy committed
80 81 82 83

/* non-zero if inside `load' */
int load_in_progress;

84 85 86
/* Directory in which the sources were found.  */
Lisp_Object Vsource_directory;

Jim Blandy's avatar
Jim Blandy committed
87 88 89
/* Search path for files to be loaded. */
Lisp_Object Vload_path;

90 91 92 93
/* This is the user-visible association list that maps features to
   lists of defs in their load files. */
Lisp_Object Vload_history;

94
/* This is used to build the load history. */
95 96
Lisp_Object Vcurrent_load_list;

97 98 99
/* Name of file actually being read by `load'.  */
Lisp_Object Vload_file_name;

100 101 102
/* Function to use for reading, in `load' and friends.  */
Lisp_Object Vload_read_function;

103 104 105 106 107 108
/* The association list of objects read with the #n=object form.
   Each member of the list has the form (n . object), and is used to
   look up the object for the corresponding #n# construct.
   It must be set to nil before all top-level calls to read0.  */
Lisp_Object read_objects;

109 110 111
/* Nonzero means load should forcibly load all dynamic doc strings.  */
static int load_force_doc_strings;

112 113 114
/* List of descriptors now open for Fload.  */
static Lisp_Object load_descriptor_list;

115
/* File for get_file_char to read from.  Use by load.  */
Jim Blandy's avatar
Jim Blandy committed
116 117 118 119 120
static FILE *instream;

/* When nonzero, read conses in pure space */
static int read_pure;

121
/* For use within read-from-string (this reader is non-reentrant!!)  */
Jim Blandy's avatar
Jim Blandy committed
122 123
static int read_from_string_index;
static int read_from_string_limit;
124

125 126 127 128 129 130 131 132 133
/* This contains the last string skipped with #@.  */
static char *saved_doc_string;
/* Length of buffer allocated in saved_doc_string.  */
static int saved_doc_string_size;
/* Length of actual data in saved_doc_string.  */
static int saved_doc_string_length;
/* This is the file position that string came from.  */
static int saved_doc_string_position;

134 135 136 137 138
/* Nonzero means inside a new-style backquote
   with no surrounding parentheses.
   Fread initializes this to zero, so we need not specbind it
   or worry about what happens to it when there is an error.  */
static int new_backquote_flag;
Jim Blandy's avatar
Jim Blandy committed
139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154

/* Handle unreading and rereading of characters.
   Write READCHAR to read a character,
   UNREAD(c) to unread c to be read again. */

#define READCHAR readchar (readcharfun)
#define UNREAD(c) unreadchar (readcharfun, c)

static int
readchar (readcharfun)
     Lisp_Object readcharfun;
{
  Lisp_Object tem;
  register struct buffer *inbuffer;
  register int c, mpos;

155
  if (BUFFERP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
156 157 158 159 160 161 162 163 164 165
    {
      inbuffer = XBUFFER (readcharfun);

      if (BUF_PT (inbuffer) >= BUF_ZV (inbuffer))
	return -1;
      c = *(unsigned char *) BUF_CHAR_ADDRESS (inbuffer, BUF_PT (inbuffer));
      SET_BUF_PT (inbuffer, BUF_PT (inbuffer) + 1);

      return c;
    }
166
  if (MARKERP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182
    {
      inbuffer = XMARKER (readcharfun)->buffer;

      mpos = marker_position (readcharfun);

      if (mpos > BUF_ZV (inbuffer) - 1)
	return -1;
      c = *(unsigned char *) BUF_CHAR_ADDRESS (inbuffer, mpos);
      if (mpos != BUF_GPT (inbuffer))
	XMARKER (readcharfun)->bufpos++;
      else
	Fset_marker (readcharfun, make_number (mpos + 1),
		     Fmarker_buffer (readcharfun));
      return c;
    }
  if (EQ (readcharfun, Qget_file_char))
183 184 185 186 187 188 189 190 191 192 193 194
    {
      c = getc (instream);
#ifdef EINTR
      /* Interrupted reads have been observed while reading over the network */
      while (c == EOF && ferror (instream) && errno == EINTR)
	{
	  clearerr (instream);
	  c = getc (instream);
	}
#endif
      return c;
    }
Jim Blandy's avatar
Jim Blandy committed
195

196
  if (STRINGP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
197 198 199 200 201 202 203 204 205 206 207 208 209
    {
      register int c;
      /* This used to be return of a conditional expression,
	 but that truncated -1 to a char on VMS.  */
      if (read_from_string_index < read_from_string_limit)
	c = XSTRING (readcharfun)->data[read_from_string_index++];
      else
	c = -1;
      return c;
    }

  tem = call0 (readcharfun);

Jim Blandy's avatar
Jim Blandy committed
210
  if (NILP (tem))
Jim Blandy's avatar
Jim Blandy committed
211 212 213 214 215 216 217 218 219 220 221 222
    return -1;
  return XINT (tem);
}

/* Unread the character C in the way appropriate for the stream READCHARFUN.
   If the stream is a user function, call it with the char as argument.  */

static void
unreadchar (readcharfun, c)
     Lisp_Object readcharfun;
     int c;
{
223 224 225 226
  if (c == -1)
    /* Don't back up the pointer if we're unreading the end-of-input mark,
       since readchar didn't advance it when we read it.  */
    ;
227
  else if (BUFFERP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
228 229
    {
      if (XBUFFER (readcharfun) == current_buffer)
230
	SET_PT (PT - 1);
Jim Blandy's avatar
Jim Blandy committed
231 232 233
      else
	SET_BUF_PT (XBUFFER (readcharfun), BUF_PT (XBUFFER (readcharfun)) - 1);
    }
234
  else if (MARKERP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
235
    XMARKER (readcharfun)->bufpos--;
236
  else if (STRINGP (readcharfun))
Jim Blandy's avatar
Jim Blandy committed
237 238 239 240 241 242 243 244 245 246 247
    read_from_string_index--;
  else if (EQ (readcharfun, Qget_file_char))
    ungetc (c, instream);
  else
    call1 (readcharfun, make_number (c));
}

static Lisp_Object read0 (), read1 (), read_list (), read_vector ();

/* get a character from the tty */

248 249
extern Lisp_Object read_char ();

250 251 252 253 254 255 256 257 258 259 260 261 262 263
/* Read input events until we get one that's acceptable for our purposes.

   If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
   until we get a character we like, and then stuffed into
   unread_switch_frame.

   If ASCII_REQUIRED is non-zero, we check function key events to see
   if the unmodified version of the symbol has a Qascii_character
   property, and use that character, if present.

   If ERROR_NONASCII is non-zero, we signal an error if the input we
   get isn't an ASCII character with modifiers.  If it's zero but
   ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
   character.  */
264

265 266 267 268 269 270 271
Lisp_Object
read_filtered_event (no_switch_frame, ascii_required, error_nonascii)
     int no_switch_frame, ascii_required, error_nonascii;
{
#ifdef standalone
  return make_number (getchar ());
#else
272 273 274
  register Lisp_Object val, delayed_switch_frame;

  delayed_switch_frame = Qnil;
275 276 277 278 279

  /* Read until we get an acceptable event.  */
 retry:
  val = read_char (0, 0, 0, Qnil, 0);

280
  if (BUFFERP (val))
281 282
    goto retry;

283
  /* switch-frame events are put off until after the next ASCII
Karl Heuer's avatar
Karl Heuer committed
284
     character.  This is better than signaling an error just because
285 286 287 288 289 290 291 292 293 294 295 296 297 298
     the last characters were typed to a separate minibuffer frame,
     for example.  Eventually, some code which can deal with
     switch-frame events will read it and process it.  */
  if (no_switch_frame
      && EVENT_HAS_PARAMETERS (val)
      && EQ (EVENT_HEAD (val), Qswitch_frame))
    {
      delayed_switch_frame = val;
      goto retry;
    }

  if (ascii_required)
    {
      /* Convert certain symbols to their ASCII equivalents.  */
299
      if (SYMBOLP (val))
300 301 302 303 304 305 306 307 308
	{
	  Lisp_Object tem, tem1, tem2;
	  tem = Fget (val, Qevent_symbol_element_mask);
	  if (!NILP (tem))
	    {
	      tem1 = Fget (Fcar (tem), Qascii_character);
	      /* Merge this symbol's modifier bits
		 with the ASCII equivalent of its basic code.  */
	      if (!NILP (tem1))
309
		XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
310 311 312 313
	    }
	}
	  
      /* If we don't have a character now, deal with it appropriately.  */
314
      if (!INTEGERP (val))
315 316 317
	{
	  if (error_nonascii)
	    {
318
	      Vunread_command_events = Fcons (val, Qnil);
319 320 321 322 323 324 325 326 327 328 329 330 331 332
	      error ("Non-character input-event");
	    }
	  else
	    goto retry;
	}
    }

  if (! NILP (delayed_switch_frame))
    unread_switch_frame = delayed_switch_frame;

  return val;
#endif
}

Jim Blandy's avatar
Jim Blandy committed
333 334
DEFUN ("read-char", Fread_char, Sread_char, 0, 0, 0,
  "Read a character from the command input (keyboard or macro).\n\
Jim Blandy's avatar
Jim Blandy committed
335 336
It is returned as a number.\n\
If the user generates an event which is not a character (i.e. a mouse\n\
Jim Blandy's avatar
Jim Blandy committed
337 338 339 340 341
click or function key event), `read-char' signals an error.  As an\n\
exception, switch-frame events are put off until non-ASCII events can\n\
be read.\n\
If you want to read non-character events, or ignore them, call\n\
`read-event' or `read-char-exclusive' instead.")
Jim Blandy's avatar
Jim Blandy committed
342 343
  ()
{
344
  return read_filtered_event (1, 1, 1);
Jim Blandy's avatar
Jim Blandy committed
345 346 347 348 349 350
}

DEFUN ("read-event", Fread_event, Sread_event, 0, 0, 0,
  "Read an event object from the input stream.")
  ()
{
351
  return read_filtered_event (0, 0, 0);
Jim Blandy's avatar
Jim Blandy committed
352 353 354 355
}

DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 0, 0,
  "Read a character from the command input (keyboard or macro).\n\
356
It is returned as a number.  Non-character events are ignored.")
Jim Blandy's avatar
Jim Blandy committed
357 358
  ()
{
359
  return read_filtered_event (1, 1, 0);
Jim Blandy's avatar
Jim Blandy committed
360 361 362 363 364 365 366
}

DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
  "Don't use this yourself.")
  ()
{
  register Lisp_Object val;
367
  XSETINT (val, getc (instream));
Jim Blandy's avatar
Jim Blandy committed
368 369 370 371 372
  return val;
}

static void readevalloop ();
static Lisp_Object load_unwind ();
373
static Lisp_Object load_descriptor_unwind ();
Jim Blandy's avatar
Jim Blandy committed
374 375 376 377 378 379 380 381 382 383 384 385 386

DEFUN ("load", Fload, Sload, 1, 4, 0,
  "Execute a file of Lisp code named FILE.\n\
First try FILE with `.elc' appended, then try with `.el',\n\
 then try FILE unmodified.\n\
This function searches the directories in `load-path'.\n\
If optional second arg NOERROR is non-nil,\n\
 report no error if FILE doesn't exist.\n\
Print messages at start and end of loading unless\n\
 optional third arg NOMESSAGE is non-nil.\n\
If optional fourth arg NOSUFFIX is non-nil, don't try adding\n\
 suffixes `.elc' or `.el' to the specified name FILE.\n\
Return t if file exists.")
387 388
  (file, noerror, nomessage, nosuffix)
     Lisp_Object file, noerror, nomessage, nosuffix;
Jim Blandy's avatar
Jim Blandy committed
389 390 391 392 393 394 395 396
{
  register FILE *stream;
  register int fd = -1;
  register Lisp_Object lispstream;
  int count = specpdl_ptr - specpdl;
  Lisp_Object temp;
  struct gcpro gcpro1;
  Lisp_Object found;
397 398 399 400
  /* 1 means we printed the ".el is newer" message.  */
  int newer = 0;
  /* 1 means we are loading a compiled file.  */
  int compiled = 0;
401
  Lisp_Object handler;
402
#ifdef DOS_NT
403
  char *dosmode = "rt";
404
#endif /* DOS_NT */
Jim Blandy's avatar
Jim Blandy committed
405

406
  CHECK_STRING (file, 0);
Jim Blandy's avatar
Jim Blandy committed
407

408
  /* If file name is magic, call the handler.  */
409
  handler = Ffind_file_name_handler (file, Qload);
410
  if (!NILP (handler))
411
    return call5 (handler, Qload, file, noerror, nomessage, nosuffix);
412

413 414 415
  /* Do this after the handler to avoid
     the need to gcpro noerror, nomessage and nosuffix.
     (Below here, we care only whether they are nil or not.)  */
416
  file = Fsubstitute_in_file_name (file);
417

Jim Blandy's avatar
Jim Blandy committed
418 419
  /* Avoid weird lossage with null string as arg,
     since it would try to load a directory as a Lisp file */
420
  if (XSTRING (file)->size > 0)
Jim Blandy's avatar
Jim Blandy committed
421
    {
422 423
      GCPRO1 (file);
      fd = openp (Vload_path, file, !NILP (nosuffix) ? "" : ".elc:.el:",
Jim Blandy's avatar
Jim Blandy committed
424
		  &found, 0);
425
      UNGCPRO;
Jim Blandy's avatar
Jim Blandy committed
426 427 428 429
    }

  if (fd < 0)
    {
Jim Blandy's avatar
Jim Blandy committed
430
      if (NILP (noerror))
Jim Blandy's avatar
Jim Blandy committed
431 432
	while (1)
	  Fsignal (Qfile_error, Fcons (build_string ("Cannot open load file"),
433
				       Fcons (file, Qnil)));
Jim Blandy's avatar
Jim Blandy committed
434 435 436 437
      else
	return Qnil;
    }

438 439 440 441 442 443 444
  /* If FD is 0, that means openp found a remote file.  */
  if (fd == 0)
    {
      handler = Ffind_file_name_handler (found, Qload);
      return call5 (handler, Qload, found, noerror, nomessage, Qt);
    }

Jim Blandy's avatar
Jim Blandy committed
445 446 447 448 449 450
  if (!bcmp (&(XSTRING (found)->data[XSTRING (found)->size - 4]),
	     ".elc", 4))
    {
      struct stat s1, s2;
      int result;

451 452
      compiled = 1;

453
#ifdef DOS_NT
454
      dosmode = "rb";
455
#endif /* DOS_NT */
456
      stat ((char *)XSTRING (found)->data, &s1);
Jim Blandy's avatar
Jim Blandy committed
457
      XSTRING (found)->data[XSTRING (found)->size - 1] = 0;
458
      result = stat ((char *)XSTRING (found)->data, &s2);
Jim Blandy's avatar
Jim Blandy committed
459
      if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
460
	{
461 462 463 464 465 466 467
	  /* Make the progress messages mention that source is newer.  */
	  newer = 1;

	  /* If we won't print another message, mention this anyway.  */
	  if (! NILP (nomessage))
	    message ("Source file `%s' newer than byte-compiled file",
		     XSTRING (found)->data);
468
	}
Jim Blandy's avatar
Jim Blandy committed
469 470 471
      XSTRING (found)->data[XSTRING (found)->size - 1] = 'c';
    }

472
#ifdef DOS_NT
473 474
  close (fd);
  stream = fopen ((char *) XSTRING (found)->data, dosmode);
475
#else  /* not DOS_NT */
Jim Blandy's avatar
Jim Blandy committed
476
  stream = fdopen (fd, "r");
477
#endif /* not DOS_NT */
Jim Blandy's avatar
Jim Blandy committed
478 479 480
  if (stream == 0)
    {
      close (fd);
481
      error ("Failure to create stdio stream for %s", XSTRING (file)->data);
Jim Blandy's avatar
Jim Blandy committed
482 483
    }

484 485 486
  if (NILP (nomessage))
    {
      if (newer)
487
	message ("Loading %s (compiled; note, source file is newer)...",
488 489
		 XSTRING (file)->data);
      else if (compiled)
490
	message ("Loading %s (compiled)...", XSTRING (file)->data);
491 492 493
      else
	message ("Loading %s...", XSTRING (file)->data);
    }
Jim Blandy's avatar
Jim Blandy committed
494

495
  GCPRO1 (file);
496 497 498
  lispstream = Fcons (Qnil, Qnil);
  XSETFASTINT (XCONS (lispstream)->car, (EMACS_UINT)stream >> 16);
  XSETFASTINT (XCONS (lispstream)->cdr, (EMACS_UINT)stream & 0xffff);
Jim Blandy's avatar
Jim Blandy committed
499
  record_unwind_protect (load_unwind, lispstream);
500
  record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
501
  specbind (Qload_file_name, found);
502
  specbind (Qinhibit_file_name_operation, Qnil);
503 504
  load_descriptor_list
    = Fcons (make_number (fileno (stream)), load_descriptor_list);
Jim Blandy's avatar
Jim Blandy committed
505
  load_in_progress++;
506
  readevalloop (Qget_file_char, stream, file, Feval, 0);
Jim Blandy's avatar
Jim Blandy committed
507 508 509
  unbind_to (count, Qnil);

  /* Run any load-hooks for this file.  */
510
  temp = Fassoc (file, Vafter_load_alist);
Jim Blandy's avatar
Jim Blandy committed
511
  if (!NILP (temp))
Jim Blandy's avatar
Jim Blandy committed
512 513 514
    Fprogn (Fcdr (temp));
  UNGCPRO;

515 516 517 518 519
  if (saved_doc_string)
    free (saved_doc_string);
  saved_doc_string = 0;
  saved_doc_string_size = 0;

Jim Blandy's avatar
Jim Blandy committed
520
  if (!noninteractive && NILP (nomessage))
521 522
    {
      if (newer)
523
	message ("Loading %s (compiled; note, source file is newer)...done",
524 525
		 XSTRING (file)->data);
      else if (compiled)
526
	message ("Loading %s (compiled)...done", XSTRING (file)->data);
527 528 529
      else
	message ("Loading %s...done", XSTRING (file)->data);
    }
Jim Blandy's avatar
Jim Blandy committed
530 531 532 533 534 535 536
  return Qt;
}

static Lisp_Object
load_unwind (stream)  /* used as unwind-protect function in load */
     Lisp_Object stream;
{
537 538
  fclose ((FILE *) (XFASTINT (XCONS (stream)->car) << 16
		    | XFASTINT (XCONS (stream)->cdr)));
Jim Blandy's avatar
Jim Blandy committed
539 540 541 542
  if (--load_in_progress < 0) load_in_progress = 0;
  return Qnil;
}

543 544 545 546 547
static Lisp_Object
load_descriptor_unwind (oldlist)
     Lisp_Object oldlist;
{
  load_descriptor_list = oldlist;
548
  return Qnil;
549 550 551 552 553 554 555 556
}

/* Close all descriptors in use for Floads.
   This is used when starting a subprocess.  */

void
close_load_descs ()
{
557
#ifndef WINDOWSNT
558 559 560
  Lisp_Object tail;
  for (tail = load_descriptor_list; !NILP (tail); tail = XCONS (tail)->cdr)
    close (XFASTINT (XCONS (tail)->car));
561
#endif
562
}
Jim Blandy's avatar
Jim Blandy committed
563 564 565 566 567 568

static int
complete_filename_p (pathname)
     Lisp_Object pathname;
{
  register unsigned char *s = XSTRING (pathname)->data;
569 570 571
  return (IS_DIRECTORY_SEP (s[0])
	  || (XSTRING (pathname)->size > 2
	      && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2]))
Jim Blandy's avatar
Jim Blandy committed
572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591
#ifdef ALTOS
	  || *s == '@'
#endif
#ifdef VMS
	  || index (s, ':')
#endif /* VMS */
	  );
}

/* Search for a file whose name is STR, looking in directories
   in the Lisp list PATH, and trying suffixes from SUFFIX.
   SUFFIX is a string containing possible suffixes separated by colons.
   On success, returns a file descriptor.  On failure, returns -1.

   EXEC_ONLY nonzero means don't open the files,
   just look for one that is executable.  In this case,
   returns 1 on success.

   If STOREPTR is nonzero, it points to a slot where the name of
   the file actually found should be stored as a Lisp string.
592 593 594 595 596
   nil is stored there on failure.

   If the file we find is remote, return 0
   but store the found remote file name in *STOREPTR.
   We do not check for remote files if EXEC_ONLY is nonzero.  */
Jim Blandy's avatar
Jim Blandy committed
597 598 599 600 601 602 603 604 605 606 607 608 609 610

int
openp (path, str, suffix, storeptr, exec_only)
     Lisp_Object path, str;
     char *suffix;
     Lisp_Object *storeptr;
     int exec_only;
{
  register int fd;
  int fn_size = 100;
  char buf[100];
  register char *fn = buf;
  int absolute = 0;
  int want_size;
611
  Lisp_Object filename;
Jim Blandy's avatar
Jim Blandy committed
612
  struct stat st;
613
  struct gcpro gcpro1;
Jim Blandy's avatar
Jim Blandy committed
614

615
  GCPRO1 (str);
Jim Blandy's avatar
Jim Blandy committed
616 617 618 619 620 621
  if (storeptr)
    *storeptr = Qnil;

  if (complete_filename_p (str))
    absolute = 1;

Jim Blandy's avatar
Jim Blandy committed
622
  for (; !NILP (path); path = Fcdr (path))
Jim Blandy's avatar
Jim Blandy committed
623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650
    {
      char *nsuffix;

      filename = Fexpand_file_name (str, Fcar (path));
      if (!complete_filename_p (filename))
	/* If there are non-absolute elts in PATH (eg ".") */
	/* Of course, this could conceivably lose if luser sets
	   default-directory to be something non-absolute... */
	{
	  filename = Fexpand_file_name (filename, current_buffer->directory);
	  if (!complete_filename_p (filename))
	    /* Give up on this path element! */
	    continue;
	}

      /* Calculate maximum size of any filename made from
	 this path element/specified file name and any possible suffix.  */
      want_size = strlen (suffix) + XSTRING (filename)->size + 1;
      if (fn_size < want_size)
	fn = (char *) alloca (fn_size = 100 + want_size);

      nsuffix = suffix;

      /* Loop over suffixes.  */
      while (1)
	{
	  char *esuffix = (char *) index (nsuffix, ':');
	  int lsuffix = esuffix ? esuffix - nsuffix : strlen (nsuffix);
651
	  Lisp_Object handler;
Jim Blandy's avatar
Jim Blandy committed
652

653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668
	  /* Concatenate path element/specified name with the suffix.
	     If the directory starts with /:, remove that.  */
	  if (XSTRING (filename)->size > 2
	      && XSTRING (filename)->data[0] == '/'
	      && XSTRING (filename)->data[1] == ':')
	    {
	      strncpy (fn, XSTRING (filename)->data + 2,
		       XSTRING (filename)->size - 2);
	      fn[XSTRING (filename)->size - 2] = 0;
	    }
	  else
	    {
	      strncpy (fn, XSTRING (filename)->data, XSTRING (filename)->size);
	      fn[XSTRING (filename)->size] = 0;
	    }

Jim Blandy's avatar
Jim Blandy committed
669 670 671
	  if (lsuffix != 0)  /* Bug happens on CCI if lsuffix is 0.  */
	    strncat (fn, nsuffix, lsuffix);

672 673 674 675 676 677
	  /* Check that the file exists and is not a directory.  */
	  if (absolute)
	    handler = Qnil;
	  else
	    handler = Ffind_file_name_handler (filename, Qfile_exists_p);
	  if (! NILP (handler) && ! exec_only)
Jim Blandy's avatar
Jim Blandy committed
678
	    {
679 680
	      Lisp_Object string;
	      int exists;
Jim Blandy's avatar
Jim Blandy committed
681

682 683 684 685 686 687 688 689
	      string = build_string (fn);
	      exists = ! NILP (exec_only ? Ffile_executable_p (string)
			       : Ffile_readable_p (string));
	      if (exists
		  && ! NILP (Ffile_directory_p (build_string (fn))))
		exists = 0;

	      if (exists)
Jim Blandy's avatar
Jim Blandy committed
690 691 692 693
		{
		  /* We succeeded; return this descriptor and filename.  */
		  if (storeptr)
		    *storeptr = build_string (fn);
694
		  UNGCPRO;
695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717
		  return 0;
		}
	    }
	  else
	    {
	      int exists = (stat (fn, &st) >= 0
			    && (st.st_mode & S_IFMT) != S_IFDIR);
	      if (exists)
		{
		  /* Check that we can access or open it.  */
		  if (exec_only)
		    fd = (access (fn, X_OK) == 0) ? 1 : -1;
		  else
		    fd = open (fn, O_RDONLY, 0);

		  if (fd >= 0)
		    {
		      /* We succeeded; return this descriptor and filename.  */
		      if (storeptr)
			*storeptr = build_string (fn);
		      UNGCPRO;
		      return fd;
		    }
Jim Blandy's avatar
Jim Blandy committed
718 719 720 721 722 723 724 725
		}
	    }

	  /* Advance to next suffix.  */
	  if (esuffix == 0)
	    break;
	  nsuffix += lsuffix + 1;
	}
726
      if (absolute)
727
	break;
Jim Blandy's avatar
Jim Blandy committed
728 729
    }

730 731
  UNGCPRO;
  return -1;
Jim Blandy's avatar
Jim Blandy committed
732 733 734
}


735 736 737 738 739 740 741 742 743 744 745 746 747
/* Merge the list we've accumulated of globals from the current input source
   into the load_history variable.  The details depend on whether
   the source has an associated file name or not. */

static void
build_load_history (stream, source)
     FILE *stream;
     Lisp_Object source;
{
  register Lisp_Object tail, prev, newelt;
  register Lisp_Object tem, tem2;
  register int foundit, loading;

748 749 750 751
  /* Don't bother recording anything for preloaded files.  */
  if (!NILP (Vpurify_flag))
    return;

752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798
  loading = stream || !NARROWED;

  tail = Vload_history;
  prev = Qnil;
  foundit = 0;
  while (!NILP (tail))
    {
      tem = Fcar (tail);

      /* Find the feature's previous assoc list... */
      if (!NILP (Fequal (source, Fcar (tem))))
	{
	  foundit = 1;

	  /*  If we're loading, remove it. */
	  if (loading)
	    {	  
	      if (NILP (prev))
		Vload_history = Fcdr (tail);
	      else
		Fsetcdr (prev, Fcdr (tail));
	    }

	  /*  Otherwise, cons on new symbols that are not already members.  */
	  else
	    {
	      tem2 = Vcurrent_load_list;

	      while (CONSP (tem2))
		{
		  newelt = Fcar (tem2);

		  if (NILP (Fmemq (newelt, tem)))
		    Fsetcar (tail, Fcons (Fcar (tem),
					  Fcons (newelt, Fcdr (tem))));

		  tem2 = Fcdr (tem2);
		  QUIT;
		}
	    }
	}
      else
	prev = tail;
      tail = Fcdr (tail);
      QUIT;
    }

799 800 801 802 803 804
  /* If we're loading, cons the new assoc onto the front of load-history,
     the most-recently-loaded position.  Also do this if we didn't find
     an existing member for the current source.  */
  if (loading || !foundit)
    Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
			   Vload_history);
805 806
}

Jim Blandy's avatar
Jim Blandy committed
807 808 809 810 811 812 813 814
Lisp_Object
unreadpure ()	/* Used as unwind-protect function in readevalloop */
{
  read_pure = 0;
  return Qnil;
}

static void
815
readevalloop (readcharfun, stream, sourcename, evalfun, printflag)
Jim Blandy's avatar
Jim Blandy committed
816
     Lisp_Object readcharfun;
817 818
     FILE *stream;
     Lisp_Object sourcename;
Jim Blandy's avatar
Jim Blandy committed
819 820 821 822 823 824
     Lisp_Object (*evalfun) ();
     int printflag;
{
  register int c;
  register Lisp_Object val;
  int count = specpdl_ptr - specpdl;
825
  struct gcpro gcpro1;
826 827 828 829 830 831
  struct buffer *b = 0;

  if (BUFFERP (readcharfun))
    b = XBUFFER (readcharfun);
  else if (MARKERP (readcharfun))
    b = XMARKER (readcharfun)->buffer;
Jim Blandy's avatar
Jim Blandy committed
832 833

  specbind (Qstandard_input, readcharfun);
834
  specbind (Qcurrent_load_list, Qnil);
Jim Blandy's avatar
Jim Blandy committed
835

836
  GCPRO1 (sourcename);
837 838 839

  LOADHIST_ATTACH (sourcename);

Jim Blandy's avatar
Jim Blandy committed
840 841
  while (1)
    {
842 843 844
      if (b != 0 && NILP (b->name))
	error ("Reading from killed buffer");

Jim Blandy's avatar
Jim Blandy committed
845 846 847 848 849 850 851 852
      instream = stream;
      c = READCHAR;
      if (c == ';')
	{
	  while ((c = READCHAR) != '\n' && c != -1);
	  continue;
	}
      if (c < 0) break;
853 854 855 856

      /* Ignore whitespace here, so we can detect eof.  */
      if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r')
	continue;
Jim Blandy's avatar
Jim Blandy committed
857

Jim Blandy's avatar
Jim Blandy committed
858
      if (!NILP (Vpurify_flag) && c == '(')
Jim Blandy's avatar
Jim Blandy committed
859
	{
860
	  int count1 = specpdl_ptr - specpdl;
Jim Blandy's avatar
Jim Blandy committed
861 862
	  record_unwind_protect (unreadpure, Qnil);
	  val = read_list (-1, readcharfun);
863
	  unbind_to (count1, Qnil);
Jim Blandy's avatar
Jim Blandy committed
864 865 866 867
	}
      else
	{
	  UNREAD (c);
868
	  read_objects = Qnil;
869 870 871 872
	  if (NILP (Vload_read_function))
	    val = read0 (readcharfun);
	  else
	    val = call1 (Vload_read_function, readcharfun);
Jim Blandy's avatar
Jim Blandy committed
873 874 875 876 877 878 879 880 881 882 883 884 885
	}

      val = (*evalfun) (val);
      if (printflag)
	{
	  Vvalues = Fcons (val, Vvalues);
	  if (EQ (Vstandard_output, Qt))
	    Fprin1 (val, Qnil);
	  else
	    Fprint (val, Qnil);
	}
    }

886 887 888
  build_load_history (stream, sourcename);
  UNGCPRO;

Jim Blandy's avatar
Jim Blandy committed
889 890 891 892 893
  unbind_to (count, Qnil);
}

#ifndef standalone

Jim Blandy's avatar
Jim Blandy committed
894
DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 2, "",
895 896 897 898
  "Execute the current buffer as Lisp code.\n\
Programs can pass two arguments, BUFFER and PRINTFLAG.\n\
BUFFER is the buffer to evaluate (nil means use current buffer).\n\
PRINTFLAG controls printing of output:\n\
Joseph Arceneaux's avatar
Joseph Arceneaux committed
899 900
nil means discard it; anything else is stream for print.\n\
\n\
Richard M. Stallman's avatar
Richard M. Stallman committed
901
This function preserves the position of point.")
902 903
  (buffer, printflag)
     Lisp_Object buffer, printflag;
Joseph Arceneaux's avatar
Joseph Arceneaux committed
904 905 906 907
{
  int count = specpdl_ptr - specpdl;
  Lisp_Object tem, buf;

908
  if (NILP (buffer))
Joseph Arceneaux's avatar
Joseph Arceneaux committed
909 910
    buf = Fcurrent_buffer ();
  else
911
    buf = Fget_buffer (buffer);
Jim Blandy's avatar
Jim Blandy committed
912
  if (NILP (buf))
Joseph Arceneaux's avatar
Joseph Arceneaux committed
913 914
    error ("No such buffer.");

Jim Blandy's avatar
Jim Blandy committed
915
  if (NILP (printflag))
Joseph Arceneaux's avatar
Joseph Arceneaux committed
916 917 918 919 920 921
    tem = Qsymbolp;
  else
    tem = printflag;
  specbind (Qstandard_output, tem);
  record_unwind_protect (save_excursion_restore, save_excursion_save ());
  BUF_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
922
  readevalloop (buf, 0, XBUFFER (buf)->filename, Feval, !NILP (printflag));
923
  unbind_to (count, Qnil);
Joseph Arceneaux's avatar
Joseph Arceneaux committed
924 925 926 927 928

  return Qnil;
}

#if 0
Jim Blandy's avatar
Jim Blandy committed
929 930 931 932 933 934 935 936 937 938 939
DEFUN ("eval-current-buffer", Feval_current_buffer, Seval_current_buffer, 0, 1, "",
  "Execute the current buffer as Lisp code.\n\
Programs can pass argument PRINTFLAG which controls printing of output:\n\
nil means discard it; anything else is stream for print.\n\
\n\
If there is no error, point does not move.  If there is an error,\n\
point remains at the end of the last character read from the buffer.")
  (printflag)
     Lisp_Object printflag;
{
  int count = specpdl_ptr - specpdl;
940 941 942
  Lisp_Object tem, cbuf;

  cbuf = Fcurrent_buffer ()
Jim Blandy's avatar
Jim Blandy committed
943

Jim Blandy's avatar
Jim Blandy committed
944
  if (NILP (printflag))
Jim Blandy's avatar
Jim Blandy committed
945 946 947 948 949 950
    tem = Qsymbolp;
  else
    tem = printflag;
  specbind (Qstandard_output, tem);
  record_unwind_protect (save_excursion_restore, save_excursion_save ());
  SET_PT (BEGV);
951
  readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval, !NILP (printflag));
Jim Blandy's avatar
Jim Blandy committed
952 953
  return unbind_to (count, Qnil);
}
Joseph Arceneaux's avatar
Joseph Arceneaux committed
954
#endif
Jim Blandy's avatar
Jim Blandy committed
955 956 957 958 959 960 961 962 963 964 965

DEFUN ("eval-region", Feval_region, Seval_region, 2, 3, "r",
  "Execute the region as Lisp code.\n\
When called from programs, expects two arguments,\n\
giving starting and ending indices in the current buffer\n\
of the text to be executed.\n\
Programs can pass third argument PRINTFLAG which controls output:\n\
nil means discard it; anything else is stream for printing it.\n\
\n\
If there is no error, point does not move.  If there is an error,\n\
point remains at the end of the last character read from the buffer.")
966 967
  (start, end, printflag)
     Lisp_Object start, end, printflag;
Jim Blandy's avatar
Jim Blandy committed
968 969
{
  int count = specpdl_ptr - specpdl;
970 971 972
  Lisp_Object tem, cbuf;

  cbuf = Fcurrent_buffer ();
Jim Blandy's avatar
Jim Blandy committed
973

Jim Blandy's avatar
Jim Blandy committed
974
  if (NILP (printflag))
Jim Blandy's avatar
Jim Blandy committed
975 976 977 978 979
    tem = Qsymbolp;
  else
    tem = printflag;
  specbind (Qstandard_output, tem);

Jim Blandy's avatar
Jim Blandy committed
980
  if (NILP (printflag))
Jim Blandy's avatar
Jim Blandy committed
981 982 983
    record_unwind_protect (save_excursion_restore, save_excursion_save ());
  record_unwind_protect (save_restriction_restore, save_restriction_save ());

984 985 986
  /* This both uses start and checks its type.  */
  Fgoto_char (start);
  Fnarrow_to_region (make_number (BEGV), end);
987
  readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval, !NILP (printflag));
Jim Blandy's avatar
Jim Blandy committed
988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003

  return unbind_to (count, Qnil);
}

#endif /* standalone */

DEFUN ("read", Fread, Sread, 0, 1, 0,
  "Read one Lisp expression as text from STREAM, return as Lisp object.\n\
If STREAM is nil, use the value of `standard-input' (which see).\n\
STREAM or the value of `standard-input' may be:\n\
 a buffer (read from point and advance it)\n\
 a marker (read from where it points and advance it)\n\
 a function (call it with no arguments for each character,\n\
     call it with a char as argument to push a char back)\n\
 a string (takes text from string, starting at the beginning)\n\
 t (read text line using minibuffer and use it).")
1004 1005
  (stream)
     Lisp_Object stream;
Jim Blandy's avatar
Jim Blandy committed
1006 1007 1008
{
  extern Lisp_Object Fread_minibuffer ();

1009 1010 1011 1012
  if (NILP (stream))
    stream = Vstandard_input;
  if (EQ (stream, Qt))
    stream = Qread_char;
Jim Blandy's avatar
Jim Blandy committed
1013

1014
  new_backquote_flag = 0;
1015
  read_objects = Qnil;
1016

Jim Blandy's avatar
Jim Blandy committed
1017
#ifndef standalone
1018
  if (EQ (stream, Qread_char))
Jim Blandy's avatar
Jim Blandy committed
1019 1020 1021
    return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
#endif

1022 1023
  if (STRINGP (stream))
    return Fcar (Fread_from_string (stream, Qnil, Qnil));
Jim Blandy's avatar
Jim Blandy committed
1024

1025
  return read0 (stream);
Jim Blandy's avatar
Jim Blandy committed
1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040
}

DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
  "Read one Lisp expression which is represented as text by STRING.\n\
Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).\n\
START and END optionally delimit a substring of STRING from which to read;\n\
 they default to 0 and (length STRING) respectively.")
  (string, start, end)
     Lisp_Object string, start, end;
{
  int startval, endval;
  Lisp_Object tem;

  CHECK_STRING (string,0);

Jim Blandy's avatar
Jim Blandy committed
1041
  if (NILP (end))
Jim Blandy's avatar
Jim Blandy committed
1042 1043 1044 1045 1046 1047 1048 1049
    endval = XSTRING (string)->size;
  else
    { CHECK_NUMBER (end,2);
      endval = XINT (end);
      if (endval < 0 || endval > XSTRING (string)->size)
	args_out_of_range (string, end);
    }

Jim Blandy's avatar
Jim Blandy committed
1050
  if (NILP (start))
Jim Blandy's avatar
Jim Blandy committed
1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061
    startval = 0;
  else
    { CHECK_NUMBER (start,1);
      startval = XINT (start);
      if (startval < 0 || startval > endval)
	args_out_of_range (string, start);
    }

  read_from_string_index = startval;
  read_from_string_limit = endval;

1062
  new_backquote_flag = 0;
1063
  read_objects = Qnil;
1064

Jim Blandy's avatar
Jim Blandy committed
1065 1066 1067 1068
  tem = read0 (string);
  return Fcons (tem, make_number (read_from_string_index));
}

1069 1070
/* Use this for recursive reads, in contexts where internal tokens
   are not allowed. */
Jim Blandy's avatar
Jim Blandy committed
1071 1072 1073 1074 1075 1076 1077
static Lisp_Object
read0 (readcharfun)
     Lisp_Object readcharfun;
{
  register Lisp_Object val;
  char c;

1078
  val = read1 (readcharfun, &c, 0);
1079 1080
  if (c)
    Fsignal (Qinvalid_read_syntax, Fcons (make_string (&c, 1), Qnil));
Jim Blandy's avatar
Jim Blandy committed
1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094

  return val;
}

static int read_buffer_size;
static char *read_buffer;

static int
read_escape (readcharfun)
     Lisp_Object readcharfun;
{
  register int c = READCHAR;
  switch (c)
    {
1095 1096 1097
    case -1:
      error ("End of file");

Jim Blandy's avatar
Jim Blandy committed
1098
    case 'a':
Jim Blandy's avatar
Jim Blandy committed
1099
      return '\007';
Jim Blandy's avatar
Jim Blandy committed
1100 1101
    case 'b':
      return '\b';
1102 1103
    case 'd':
      return 0177;
Jim Blandy's avatar
Jim Blandy committed
1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125
    case 'e':
      return 033;
    case 'f':
      return '\f';
    case 'n':
      return '\n';
    case 'r':
      return '\r';
    case 't':
      return '\t';
    case 'v':
      return '\v';
    case '\n':
      return -1;

    case 'M':
      c = READCHAR;
      if (c != '-')
	error ("Invalid escape character syntax");
      c = READCHAR;
      if (c == '\\')
	c = read_escape (readcharfun);
1126
      return c | meta_modifier;
1127 1128 1129 1130 1131 1132 1133 1134

    case 'S':
      c = READCHAR;
      if (c != '-')
	error ("Invalid escape character syntax");
      c = READCHAR;
      if (c == '\\')
	c = read_escape (readcharfun);
1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162