summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/context/third
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-10-17 22:09:23 +0000
committerKarl Berry <karl@freefriends.org>2010-10-17 22:09:23 +0000
commit0d000ff9063f3ae834d65897e15c67a4bfc84198 (patch)
tree132e083da6f25428f53007f8b185038b00c476f2 /Master/texmf-dist/doc/context/third
parent87c6a6ef44e21718b0eaf4e1e03a27806f6d750d (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/third')
-rw-r--r--Master/texmf-dist/doc/context/third/filter/filter.txt44
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.
+