aboutsummaryrefslogtreecommitdiff
path: root/man/pandoc-lua.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/pandoc-lua.1')
-rw-r--r--man/pandoc-lua.130
1 files changed, 25 insertions, 5 deletions
diff --git a/man/pandoc-lua.1 b/man/pandoc-lua.1
index 6388fb27f..ce21b6647 100644
--- a/man/pandoc-lua.1
+++ b/man/pandoc-lua.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 3.0
+.\" Automatically generated by Pandoc 3.0.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
@@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
-.TH "pandoc-lua" "1" "September 22, 2022" "pandoc-lua 3.0.1" ""
+.TH "pandoc-lua" "1" "September 22, 2022" "pandoc-lua 3.1.1" ""
.hy
.SH SYNOPSIS
.PP
@@ -33,7 +33,11 @@ startup.
.PP
If no script argument is given, then the script is assumed to be passed
in via \f[I]stdin\f[R].
-Interactive mode is not supported at this time.
+When called without arguments, \f[V]pandoc-lua\f[R] behaves as
+\f[V]pandoc-lua -v -i\f[R] when the standard input (\f[V]stdin\f[R]) is
+a terminal, and as \f[V]pandoc-lua -\f[R] otherwise.
+On Windows the program will always behave as if it was connected to a
+terminal.
.PP
When called without the option \f[V]-E\f[R], the interpreter checks for
an environment variable \f[V]LUA_INIT\f[R] before running any argument.
@@ -55,7 +59,7 @@ global \f[V]mod\f[R].
Show version information.
.TP
\f[V]-i\f[R]
-Not supported yet; print a warning to that effect.
+Enter interactive mode after running \f[I]script\f[R].
.TP
\f[V]-E\f[R]
Ignore environment variables.
@@ -66,9 +70,25 @@ Other variables like \f[V]LUA_PATH\f[R] and \f[V]LUA_CPATH\f[R] are
.TP
\f[V]-W\f[R]
Turn warnings on.
+.SH INTERACTIVE MODE
+.PP
+In interactive mode, the Lua interpreter repeatedly prompts and waits
+for a line.
+After reading a line, Lua first tries to interpret the line as an
+expression.
+If it succeeds, it prints its value.
+Otherwise, it interprets the line as a statement.
+If you write an incomplete statement, the interpreter waits for its
+completion by issuing a different prompt.
+.PP
+Exit the interactive mode by pressing \f[V]Ctrl-D\f[R] or
+\f[V]Ctrl-C\f[R], or by typing \f[V]os.exit()\f[R].
+The \f[I]Isocline\f[R] library is used for line editing.
+Press \f[V]F1\f[R] to get a list of available keybindings; the
+\f[V]ctrl\f[R] key is abbreviated as \f[V]\[ha]\f[R] in that list.
.SH AUTHORS
.PP
-Copyright 2022 John MacFarlane (jgm\[at]berkeley.edu) and contributors.
+Copyright 2023 John MacFarlane (jgm\[at]berkeley.edu) and contributors.
Released under the GPL, version 2 or later.
This software carries no warranty of any kind.
(See COPYRIGHT for full copyright and warranty notices.)