Document --trace option.

Closes #7873.
This commit is contained in:
John MacFarlane 2022-01-29 21:57:46 -08:00
parent 5e42189ddb
commit 148cf8a064

View file

@ -701,6 +701,12 @@ header when requesting a document from a URL:
space, and the period will not produce sentence-ending space space, and the period will not produce sentence-ending space
in formats like LaTeX. The strings may not contain spaces. in formats like LaTeX. The strings may not contain spaces.
`--trace`
: Print diagnostic output tracing parser progress to stderr.
This option is intended for use by developers in diagnosing
performance issues.
[`pandocfilters`]: https://github.com/jgm/pandocfilters [`pandocfilters`]: https://github.com/jgm/pandocfilters
[PHP]: https://github.com/vinai/pandocfilters-php [PHP]: https://github.com/vinai/pandocfilters-php
[perl]: https://metacpan.org/pod/Pandoc::Filter [perl]: https://metacpan.org/pod/Pandoc::Filter
@ -1722,6 +1728,10 @@ those in another file included with a `defaults:` entry.
| --abbreviations abbrevs.txt | abbreviations: abbrevs.txt | | --abbreviations abbrevs.txt | abbreviations: abbrevs.txt |
| ``` | ``` | | ``` | ``` |
+----------------------------------+-----------------------------------+ +----------------------------------+-----------------------------------+
| ``` | ``` yaml |
| --trace | trace: true |
| ``` | ``` |
+----------------------------------+-----------------------------------+
Metadata values specified in a defaults file are parsed as literal Metadata values specified in a defaults file are parsed as literal
string text, not Markdown. string text, not Markdown.
@ -2031,10 +2041,6 @@ be added to `html-math-method:`.
| command line | defaults file | | command line | defaults file |
+:=================================+:==================================+ +:=================================+:==================================+
| ``` | ``` yaml | | ``` | ``` yaml |
| --trace | trace: true |
| ``` | ``` |
+----------------------------------+-----------------------------------+
| ``` | ``` yaml |
| --dump-args | dump-args: true | | --dump-args | dump-args: true |
| ``` | ``` | | ``` | ``` |
+----------------------------------+-----------------------------------+ +----------------------------------+-----------------------------------+