aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/lua-filters.md40
1 files changed, 38 insertions, 2 deletions
diff --git a/doc/lua-filters.md b/doc/lua-filters.md
index a5a7f2922..45abe8ac8 100644
--- a/doc/lua-filters.md
+++ b/doc/lua-filters.md
@@ -1375,11 +1375,30 @@ Comparisons are performed element-wise, i.e.
`must_be_at_least(actual, expected [, error_message])`
Raise an error message if the actual version is older than the
-expected version.
+expected version; does nothing if actual is equal to or newer
+than the expected version.
+
+Parameters:
+
+`actual`
+: actual version specifier ([Version](#type-ref-Version))
+
+`expected`
+: minimum expected version ([Version](#type-ref-Version))
+
+`error_message`
+: optional error message template. The string is used as format
+ string, with the expected and actual versions as arguments.
+ Defaults to `"expected version %s or newer, got %s"`.
Usage:
- PANDOC_VERSION:must_be_at_least('2.7.3')
+ PANDOC_VERSION:must_be_at_least '2.7.3'
+ PANDOC_API_VERSION:must_be_at_least(
+ '1.17.4',
+ 'pandoc-types is too old: expected version %s, got %s'
+ )
+
[Block]: #type-ref-Block
[List]: #module-pandoc.list
@@ -2759,3 +2778,20 @@ Returns:
# Module pandoc.types
Constructors for types which are not part of the pandoc AST.
+
+### Version {#pandoc.types.Version}
+
+`Version (version_specifier)`
+
+Creates a Version object.
+
+Parameters:
+
+`version`:
+: Version specifier: this can be a version string like
+ `'2.7.3'`, a list of integers like `{2, 7, 3}`, a single
+ integer, or a [Version](#type-ref-Version).
+
+Returns:
+
+- A new [Version](#type-ref-Version) object.