aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2023-03-26 11:11:05 -0700
committerJohn MacFarlane <[email protected]>2023-03-26 11:11:05 -0700
commit0cba767bd6a8d36f85bcd65ac07aba2771073e18 (patch)
tree54d2863d5ec2b9eb2b59c7559d0d39445fa2c7f8 /man
parent9919d62df234a76edd11e7e0f64cdc7539c0e1d6 (diff)
Update manual date and man page
Diffstat (limited to 'man')
-rw-r--r--man/pandoc-lua.130
-rw-r--r--man/pandoc.126
2 files changed, 48 insertions, 8 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.)
diff --git a/man/pandoc.1 b/man/pandoc.1
index 6b1bf81d1..bb7f6ccf3 100644
--- a/man/pandoc.1
+++ b/man/pandoc.1
@@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
-.TH "Pandoc User\[cq]s Guide" "" "March 5, 2023" "pandoc 3.1.1" ""
+.TH "Pandoc User\[cq]s Guide" "" "March 26, 2023" "pandoc 3.1.1" ""
.hy
.SH NAME
pandoc - general markup converter
@@ -452,6 +452,8 @@ markup)
.IP \[bu] 2
\f[V]tei\f[R] (TEI Simple)
.IP \[bu] 2
+\f[V]typst\f[R] (typst)
+.IP \[bu] 2
\f[V]xwiki\f[R] (XWiki markup)
.IP \[bu] 2
\f[V]zimwiki\f[R] (ZimWiki markup)
@@ -491,7 +493,7 @@ variable).
If that directory does not exist and \f[V]$HOME/.pandoc\f[R] exists, it
will be used (for backwards compatibility).
On Windows the default user data directory is
-\f[V]C:\[rs]Users\[rs]USERNAME\[rs]AppData\[rs]Roaming\[rs]pandoc\f[R].
+\f[V]%APPDATA%\[rs]pandoc\f[R].
You can find the default user data directory on your system by looking
at the output of \f[V]pandoc --version\f[R].
Data files placed in this directory (for example,
@@ -1064,6 +1066,8 @@ Currently this option only affects the \f[V]markdown\f[R],
\f[V]muse\f[R], \f[V]html\f[R], \f[V]epub\f[R], \f[V]slidy\f[R],
\f[V]s5\f[R], \f[V]slideous\f[R], \f[V]dzslides\f[R], and
\f[V]revealjs\f[R] writers.
+In slide formats, specifying \f[V]--reference-location=section\f[R] will
+cause notes to be rendered at the bottom of a slide.
.TP
\f[V]--markdown-headings=setext\f[R]|\f[V]atx\f[R]
Specify whether to use ATX-style (\f[V]#\f[R]-prefixed) or Setext-style
@@ -1228,6 +1232,8 @@ Date
.IP \[bu] 2
Abstract
.IP \[bu] 2
+AbstractTitle
+.IP \[bu] 2
Bibliography
.IP \[bu] 2
Heading 1
@@ -1477,7 +1483,8 @@ Use the specified engine when producing PDF output.
Valid values are \f[V]pdflatex\f[R], \f[V]lualatex\f[R],
\f[V]xelatex\f[R], \f[V]latexmk\f[R], \f[V]tectonic\f[R],
\f[V]wkhtmltopdf\f[R], \f[V]weasyprint\f[R], \f[V]pagedjs-cli\f[R],
-\f[V]prince\f[R], \f[V]context\f[R], and \f[V]pdfroff\f[R].
+\f[V]prince\f[R], \f[V]context\f[R], \f[V]pdfroff\f[R], and
+\f[V]typst\f[R].
If the engine is not in your PATH, the full path of the engine may be
specified here.
If this option is not specified, pandoc uses the following defaults
@@ -1495,6 +1502,8 @@ depending on the output format specified using \f[V]-t/--to\f[R]:
print-css.rocks for a good introduction to PDF generation from HTML/CSS)
.IP \[bu] 2
\f[V]-t ms\f[R]: \f[V]pdfroff\f[R]
+.IP \[bu] 2
+\f[V]-t typst\f[R]: \f[V]typst\f[R]
.RE
.TP
\f[V]--pdf-engine-opt=\f[R]\f[I]STRING\f[R]
@@ -3029,6 +3038,17 @@ mainfontoptions:
.fi
.RE
.TP
+\f[V]babelfonts\f[R]
+a map of Babel language names (e.g.\ \f[V]chinese\f[R]) to the font to
+be used with the language:
+.RS
+.PP
+ * * * * *
+.PP
+babelfonts: chinese-hant: \[lq]Noto Serif CJK TC\[rq] russian: \[lq]Noto
+Serif\[rq] \&...
+.RE
+.TP
\f[V]microtypeoptions\f[R]
options to pass to the microtype package
.SS Links