diff options
| author | Karl Berry <karl@freefriends.org> | 2010-10-17 22:09:23 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2010-10-17 22:09:23 +0000 |
| commit | 0d000ff9063f3ae834d65897e15c67a4bfc84198 (patch) | |
| tree | 132e083da6f25428f53007f8b185038b00c476f2 /Master/texmf-dist/doc/context | |
| parent | 87c6a6ef44e21718b0eaf4e1e03a27806f6d750d (diff) | |
context-filter (17oct10)
git-svn-id: svn://tug.org/texlive/trunk@20128 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/context')
| -rw-r--r-- | Master/texmf-dist/doc/context/third/filter/filter.txt | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/context/third/filter/filter.txt b/Master/texmf-dist/doc/context/third/filter/filter.txt index e6654c83c15..5cb0f7d5da7 100644 --- a/Master/texmf-dist/doc/context/third/filter/filter.txt +++ b/Master/texmf-dist/doc/context/third/filter/filter.txt @@ -371,6 +371,45 @@ Limitations MTXrun | +Messages and Tracing +------------------- + +The filter module outputs some diagnostic information on the console output to +indicate what is happening. Loading of the module is indicated by: + + loading : ConTeXt User Module / Filter + +Whenever a filter is executed, the expanded name of the command is displayed. +For example, for the markdown filter we get: + + t-filter : command : pandoc -w context -o markdown-externalfilter-markdown.tex markdown-externalfilter-markdown.tmp + +If, for some reason, the output file is not generated, or not found, a message +similar to + + t-filter : file markdown-externalfilter-markdown.tex cannot be found + +is displayed on the console. At the same time, the string + + [[output file missing]] + +is displayed in the PDF output. To debug what went wrong, add + + \traceexternalfilters + +in your tex file. This shows the name of all input and output files on the +console: + + t-filter : current filter : markdown + t-filter : base file : markdown-externalfilter-markdown + t-filter : input file : markdown-externalfilter-markdown.tmp + t-filter : output file : markdown-externalfilter-markdown.tex + +This data, along with the name of the filter command, is useful for debugging +what went wrong. + + + Version History -------------- @@ -380,3 +419,8 @@ Version History - Added `\inline<filter>{...}` macro - Changed the syntax of `\process<filter>file`. The filename is now specified in curly brackets rather than square brackets. +- **2010.10.16**: + - Added `\traceexternalfilters` for tracing + - Added a message that shows filter command on console + - A message is shown on console when output file is not found. + |