Update MANUAL.txt for new filter behavior.

This commit is contained in:
Jesse Rosenthal 2016-09-27 12:25:21 -04:00
parent ec6d0638be
commit cc5c5c1037

View file

@ -421,12 +421,23 @@ Reader options
exports `toJSONFilter` to facilitate writing filters in Haskell.
Those who would prefer to write filters in python can use the
module [`pandocfilters`], installable from PyPI. There are also
pandoc filter libraries in [PHP], [perl], and [javascript/node.js].
pandoc filter libraries in [PHP], [perl], and
[javascript/node.js].
Note that the *EXECUTABLE* will be sought in the user's
`PATH`, and not in the working directory, if no directory is
provided. If you want to run a script in the working directory,
preface the filename with `./`.
If no directory is provided pandoc will look for executable or
non-executable filters in the director `$DATADIR/filters`, and
then for executable filters in the user's `PATH`. If you want to
run a script in the working directory, preface the filename with
`./`.
In order of preference, pandoc will look for filters in
1. a specified full or relative path (executable or
non-executable)
2. `$DATADIR/filters` (executable or non-executable)
3. `$PATH` (executable only)
`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]