<?xml version="1.0" ?>

<application>
    <metadata>
        <entry name="name">mtx-context</entry>
        <entry name="detail">ConTeXt Process Management</entry>
        <entry name="version">1.05</entry>
        <entry name="comment">external helpinfo file</entry>
    </metadata>
    <flags>
        <category name="basic">
            <subcategory>
                <flag name="run">
                    <short>process (one or more) files (default action)</short>
                </flag>
                <flag name="make">
                    <short>create context formats</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="ctx=name">
                    <short>use ctx file (process management specification)</short>
                </flag>
                <flag name="noctx">
                    <short>ignore ctx directives and flags</short>
                </flag>
                <flag name="interface">
                    <short>use specified user interface (default: en)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="autopdf">
                    <short>close pdf file in viewer and start pdf viewer afterwards</short>
                </flag>
                <flag name="purge">
                    <short>purge files either or not after a run (<ref name="pattern"/>=...)</short>
                </flag>
                <flag name="purgeall">
                    <short>purge all files either or not after a run (<ref name="pattern"/>=...)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="usemodule" value="list">
                    <short>load the given module or style, normally part of the distribution</short>
                </flag>
                <flag name="environment" value="list">
                    <short>load the given environment file first (document styles)</short>
                </flag>
                <flag name="mode" value="list">
                    <short>enable given the modes (conditional processing in styles)</short>
                </flag>
                    <flag name="path" value="list">
                <short>also consult the given paths when files are looked for</short>
                </flag>
                    <flag name="arguments" value="list">
                <short>set variables that can be consulted during a run (key/value pairs)</short>
                </flag>
                    <flag name="randomseed" value="number">
                <short>set the randomseed</short>
                </flag>
                    <flag name="result" value="name">
                <short>rename the resulting output to the given name</short>
                </flag>
                    <flag name="trackers" value="list">
                <short>set tracker variables (show list with <ref name="showtrackers"/>)</short>
                </flag>
                <flag name="directives" value="list">
                    <short>set directive variables (show list with <ref name="showdirectives"/>)</short>
                </flag>
                <flag name="silent" value="list">
                    <short>disable logcategories (show list with <ref name="showlogcategories"/>)</short>
                </flag>
                <flag name="strip">
                    <short>strip Lua code (only meant for production where no errors are expected)</short>
                </flag>
                <flag name="errors" value="list">
                    <short>show errors at the end of a run, quit when in list (also when <ref name="silent"/>)</short>
                </flag>
                <flag name="htmlerrorpage">
                    <short>generate html error page instead (optional: =scite)</short>
                </flag>
                <flag name="noconsole">
                    <short>disable logging to the console (logfile only)</short>
                </flag>
                <flag name="nodummy">
                    <short>don't create a dummy file (can confuse pdf viewers that keep file in view)</short>
                </flag>
                <flag name="purgeresult">
                    <short>purge result file before run</short>
                </flag>
                <flag name="find" value="string">
                    <short>search for the given pattern in the documentation sources</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="forcexml">
                    <short>force xml stub</short>
                </flag>
                <flag name="forcecld">
                    <short>force cld (context lua document) stub</short>
                </flag>
                <flag name="forcelua">
                    <short>force lua stub (like texlua)</short>
                </flag>
                <flag name="forcemp">
                    <short>force mp stub</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="arrange">
                    <short>run extra imposition pass, given that the style sets up imposition</short>
                </flag>
                <flag name="noarrange">
                    <short>ignore imposition specifications in the style</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="pages">
                    <short>report pagenumbers of names pages and list references (<ref name="page"/>=... or <ref name="page"/>=...)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="jit">
                    <short>use luajittex with jit turned off (only use the faster virtual machine)</short>
                </flag>
                <flag name="jiton">
                    <short>use luajittex with jit turned on (in most cases not faster, even slower)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="once">
                    <short>only run once (no multipass data file is produced)</short>
                </flag>
                <flag name="runs">
                    <short>process at most this many times</short>
                </flag>
                <flag name="forcedruns">
                    <short>process this many times (permits for optimization trial runs)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="batchmode">
                    <short>run without stopping and do not show messages on the console</short>
                </flag>
                <flag name="nonstopmode">
                    <short>run without stopping</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="nocompactfonts">
                    <short>revert to less efficient (traditional) font scaling</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="nosynctex">
                    <short>never initializes synctex (for production runs)</short>
                </flag>
                <flag name="synctex">
                    <short>run with synctex enabled (better use \setupsynctex[state=start])</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="nodates">
                    <short>omit runtime dates in pdf file (optional value: a number (1970 offset) or string "YYYY-MM-DD HH:MM")</short>
                </flag>
                <flag name="nocompression">
                    <short>forcefully turns off compression in the backend</short>
                </flag>
                <flag name="trailerid">
                    <short>alternative trailer id (or constant one)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="generate">
                    <short>generate file database etc. (as luatools does)</short>
                </flag>
                <flag name="paranoid">
                    <short>do not descend to .. and ../..</short>
                </flag>
                <flag name="version">
                    <short>report installed context version</short>
                </flag>
                <flag name="integrity">
                    <short>report mismatch between binary and expectations</short>
                </flag>
                </subcategory>
                <subcategory>
                <flag name="global">
                    <short>assume given file present elsewhere</short>
                </flag>
                <flag name="nofile">
                    <short>use dummy file as jobname</short>
                </flag>
                <flag name="forceinput">
                    <short>use this file as input file instead of the given one</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="expert">
                    <short>show some more options</short>
                </flag>
            </subcategory>
        </category>
        <category name="expert">
            <subcategory>
                <flag name="touch">
                    <short>update context version number (also provide <ref name="expert"/>, optionally provide <ref name="basepath"/>)</short>
                </flag>
                <flag name="nostatistics">
                    <short>omit runtime statistics at the end of the run</short>
                </flag>
                <!-- flag name="update">
                    <short>update context from website (not to be confused with contextgarden)</short>
                </flag -->
                <flag name="profile">
                    <short>profile job (use: mtxrun <ref name="script"/> profile <ref name="analyze"/>)</short>
                </flag>
                <flag name="timing">
                    <short>generate timing and statistics overview</short>
                </flag>
                <flag name="keeptuc">
                    <short>keep previous tuc files (jobname-tuc-[run].tmp)</short>
                </flag>
                <flag name="keeppdf">
                    <short>keep previous pdf files (jobname-pdf-keep.tmp)</short>
                </flag>
                <flag name="keeplog">
                    <short>keep previous log files (jobname-log-[run].tmp)</short>
                </flag>
                <flag name="notuc">
                    <short>don't write a tuc file</short>
                </flag>
                <flag name="lmtx">
                    <short>force lmtx mode (when available)</short>
                </flag>
                <flag name="overloadmode=error|warning|0--6|255">
                    <short>enable csname overload checking</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="extra=name">
                    <short>process extra (mtx-context-... in distribution)</short>
                </flag>
                <flag name="extras">
                    <short>show extras</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="ownerpassword">
                    <short>encrypt the (pdf) file using this master password</short>
                </flag>
                <flag name="userpassword">
                    <short>use an additional password for opening the document</short>
                </flag>
                <flag name="permissions">
                    <short>list of: print, modify, extract, add, fillin, assemble, quality</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="wtpdf">
                    <short>add an wtpdf conformance blob but best check first if it applies</short>
                </flag>
            </subcategory>
        </category>
        <category name="special">
            <subcategory>
                <flag name="luatex">
                    <short>process file with luatex instead of luametatex</short>
                </flag>
                <flag name="pdftex">
                    <short>process file with texexec using pdftex</short>
                </flag>
                <flag name="xetex">
                    <short>process file with texexec using xetex</short>
                </flag>
                <flag name="mkii">
                    <short>process file with texexec</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="pipe">
                    <short>do not check for file and enter scroll mode (<ref name="dummyfile"/>=whatever.tmp)</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="parallel">
                    <short>process multiple files at the same time (you can specify a number of processes, default: 8)</short>
                </flag>
                <flag name="parallellist">
                    <short>process commands in this file (lines that start with 'context')</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="sandbox">
                    <short>process file in a limited environment</short>
                </flag>
            </subcategory>
            <subcategory>
                <flag name="addbinarypath">
                    <short>prepend the (found) binarypath to runners</short>
                </flag>
            </subcategory>
        </category>
    </flags>
</application>
