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