summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2018-05-24 06:57:28 -0700
committerKaz Kylheku <kaz@kylheku.com>2018-05-24 06:57:28 -0700
commitec26de31457ee1626495eb2e42382d8642296ddf (patch)
tree60c9a945ca0636456491ffe2d4c0a00c54e26b4c /txr.1
parent5cd8a31d61289594cb582c7e82b60a3911fe085a (diff)
downloadtxr-ec26de31457ee1626495eb2e42382d8642296ddf.tar.gz
txr-ec26de31457ee1626495eb2e42382d8642296ddf.tar.bz2
txr-ec26de31457ee1626495eb2e42382d8642296ddf.zip
doc: document the --compiled option.
* txr.1: Fold --compiled with --lisp into the same description.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.146
1 files changed, 26 insertions, 20 deletions
diff --git a/txr.1 b/txr.1
index 206cdd16..58c43f99 100644
--- a/txr.1
+++ b/txr.1
@@ -779,36 +779,42 @@ among the arguments expanded from the
syntax.
.coIP --lisp
-This option influences the treatment of query files which do not have
-a suffix indicating their type: they are treated as \*(TL source.
+.coIP --compiled
+These options influences the treatment of query files which do not have
+a suffix indicating their type. The
+.code --lisp
+option causes an unsuffixed file to be treated as Lisp source; and
+.code --compiled
+causes it to be treated as a compile file.
+
Moreover, if
.code --lisp
is specified, and an unsuffixed file does not exist, then \*(TX
will add the
.str .tl
-suffix and try the file again. In the same situation, if
+suffix and try the file again; and
+.code --compiled
+will similarly add the
+.str .tlo
+suffix and try opening the file again.
+In the same situation, if neither
.code --lisp
-is not present, \*(TX will first try adding the
+nor
+.code --compiled
+has been specified, \*(TX will first try adding the
.str .txr
suffix. If that fails,
-then
-.str .tl
-suffix will be tried. Note that
+then the
+.str .tlo
+suffix will be tried and finally
+.strn .tl .
+Note that
.code --lisp
-influences how the argument of the
+and
+.code --compiled
+influence how the argument of the
.code -f
-option is treated, but only if it precedes that option.
-It has no effect on the
-.code -c
-option. The argument of
-.code -c
-is always \*(TX pattern language code. Lisp code can be evaluated using
-the
-.codn -e ,
-.codn -p ,
-or
-.code -P
-options.
+option is treated, but only they precedes that option.
.coIP --reexec
On platforms which support the POSIX