summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2016-05-23 16:01:41 -0700
committerKaz Kylheku <kaz@kylheku.com>2016-05-23 16:01:41 -0700
commitbd941bfb7f479d4a35f6be040702b714982a553a (patch)
tree4bc998dd9e63868d744e32e4df155bb56979aa16
parent59a7720d999f51a99706f2d6d06c74e77b8f0495 (diff)
downloadtxr-bd941bfb7f479d4a35f6be040702b714982a553a.tar.gz
txr-bd941bfb7f479d4a35f6be040702b714982a553a.tar.bz2
txr-bd941bfb7f479d4a35f6be040702b714982a553a.zip
Neglected documentation about @(next).
txr.1: It wasn't documented that expr in @(next expr) can produce a stream.
-rw-r--r--txr.111
1 files changed, 8 insertions, 3 deletions
diff --git a/txr.1 b/txr.1
index a33d036a..89f8d115 100644
--- a/txr.1
+++ b/txr.1
@@ -3200,9 +3200,9 @@ to \*(TX on the command line.
If
.meta source
-is given, it must be string-valued Lisp expression which denotes an
-input source; it may be a string literal, quasiliteral or a string-valued
-variable. For instance, if variable
+is given, it must be a \*(TL expression which denotes an
+input source. Its value may be a string or an input stream.
+For instance, if variable
.code A
contains the text
.strn "data" ,
@@ -3214,6 +3214,11 @@ and
.code "@(next `@A.txt`)"
means to switch to the file
.strn "data.txt" .
+The directive
+.code "@(next (open-command `git log`))"
+switches to the input stream connected to the output of the
+.code "git log"
+command.
If the input source cannot be opened for whatever reason,
\*(TX throws an exception (see EXCEPTIONS below). An unhandled exception will