diff options
| author | Kaz Kylheku <kaz@kylheku.com> | 2014-01-10 20:11:38 -0800 |
|---|---|---|
| committer | Kaz Kylheku <kaz@kylheku.com> | 2014-01-10 20:11:38 -0800 |
| commit | ba9a6aade4adf32b4361aa8db8b156fdb40e2cd5 (patch) | |
| tree | 1a1d2ea421fff889e2ef6aff99c5d1ecd1846dd0 /txr.1 | |
| parent | f4bd17eab2667962090fc8a918b553badad671bc (diff) | |
| download | txr-ba9a6aade4adf32b4361aa8db8b156fdb40e2cd5.tar.gz txr-ba9a6aade4adf32b4361aa8db8b156fdb40e2cd5.tar.bz2 txr-ba9a6aade4adf32b4361aa8db8b156fdb40e2cd5.zip | |
* eval.c (eval_init): Renaming lisp-parse to read; lisp-parse
is retained as an obsolescent synonym. All arguments become optional.
* parser.l (lisp_parse): Handle nil source.
* txr.1: Updated.
Diffstat (limited to 'txr.1')
| -rw-r--r-- | txr.1 | 16 |
1 files changed, 9 insertions, 7 deletions
@@ -4972,7 +4972,7 @@ Restrictions: The notation must be enclosed in a list. For instance a..b is not an expression, but (a..b) is. This is important if Lisp data is being parsed from -a string or stream using the lisp-parse function. If the data "a..b" is +a string or stream using the read function. If the data "a..b" is parsed, the symbol "a" will be extracted, leaving "..a", which, if parsed, produces a syntax error since it consists of a "dotdot" token followed by a symbol, which is not valid syntax, akin to something like ")a" or ".a". @@ -10530,22 +10530,24 @@ the stream-real-time-p function above), and also for setting the priority at which messages are reported to syslog by the *stdlog* stream (see *stdlog* in the UNIX SYSLOG section). -.SS Function lisp-parse +.SS Function read .TP Syntax: - (lisp-parse <source> : <error-stream>) + (read : <source> <error-stream>) + (lisp-parse <source> : <error-stream>) ;; obsolescent synonym for read .TP Description: -The lisp-parse function converts text denoting TXR Lisp structure, into the +The read function converts text denoting TXR Lisp structure, into the corresponding data structure. The <source> argument may be either a character -string, or a stream. The source must provide the syntax of one complete Lisp -object. +string, or a stream. If it is omitted, then *stdin* is used as the stream. -Multiple calls to lisp-parse on the same stream will extract successive objects +The source must provide the text representation of one complete TXR Lisp object. + +Multiple calls to read on the same stream will extract successive objects from the stream. To parse successive objects from a string, it is necessary to convert it to a string stream. |