summaryrefslogtreecommitdiff
path: root/doc/context/scripts/mkiv/mtx-context.xml
blob: 916dad377b8cedf33cca31f4751f3b88933769af (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
<?xml version="1.0" ?>

<application>
    <metadata>
        <entry name="name">mtx-context</entry>
        <entry name="detail">ConTeXt Process Management</entry>
        <entry name="version">1.03</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 logcatgories (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="noconsole">
                    <short>disable logging to the console (logfile only)</short>
                </flag>
                <flag name="purgeresult">
                    <short>purge result file before run</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="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>
                <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>
                <flag name="nodates">
                    <short>omit runtime dates in pdf file (optional value: a number (this 1970 offset time) 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>
                </subcategory>
                <subcategory>
                <flag name="global">
                    <short>assume given file present elsewhere</short>
                </flag>
                    <flag name="nofile">
                    <short>use dummy file as jobname</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="keeplog">
                    <short>keep previous log files (jobname-log-[run].tmp)</short>
                </flag>
                <flag name="lmtx">
                    <short>force lmtx mode (when available)</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>
        </category>
        <category name="special">
            <subcategory>
                <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="sandbox">
                    <short>process file in a limited environment</short>
                </flag>
            </subcategory>
        </category>
    </flags>
</application>