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