mtx-context.man /size: 5743 b    last modification: 2025-02-21 11:03
1.TH "mtx-context" "1" "01-01-2025" "version 1.05" "ConTeXt Process Management"
2.SH NAME
3 mtx-context - ConTeXt Process Management
4.SH SYNOPSIS
5.B mtxrun --script context [
6.I OPTIONS ...
7.B ] [
8.I FILENAMES
9.B ]
10.SH DESCRIPTION
11.B ConTeXt Process Management
12.SH OPTIONS: BASIC
13.TP
14.B --run
15process (one or more) files (default action)
16.TP
17.B --make
18create context formats
19.TP
20.B --ctx=name
21use ctx file (process management specification)
22.TP
23.B --noctx
24ignore ctx directives and flags
25.TP
26.B --interface
27use specified user interface (default: en)
28.TP
29.B --autopdf
30close pdf file in viewer and start pdf viewer afterwards
31.TP
32.B --purge
33purge files either or not after a run (--pattern=...)
34.TP
35.B --purgeall
36purge all files either or not after a run (--pattern=...)
37.TP
38.B --usemodule=list
39load the given module or style, normally part of the distribution
40.TP
41.B --environment=list
42load the given environment file first (document styles)
43.TP
44.B --mode=list
45enable given the modes (conditional processing in styles)
46.TP
47.B --path=list
48also consult the given paths when files are looked for
49.TP
50.B --arguments=list
51set variables that can be consulted during a run (key/value pairs)
52.TP
53.B --randomseed=number
54set the randomseed
55.TP
56.B --result=name
57rename the resulting output to the given name
58.TP
59.B --trackers=list
60set tracker variables (show list with --showtrackers)
61.TP
62.B --directives=list
63set directive variables (show list with --showdirectives)
64.TP
65.B --silent=list
66disable logcategories (show list with --showlogcategories)
67.TP
68.B --strip
69strip Lua code (only meant for production where no errors are expected)
70.TP
71.B --errors=list
72show errors at the end of a run, quit when in list (also when --silent)
73.TP
74.B --htmlerrorpage
75generate html error page instead (optional: =scite)
76.TP
77.B --noconsole
78disable logging to the console (logfile only)
79.TP
80.B --nodummy
81don't create a dummy file (can confuse pdf viewers that keep file in view)
82.TP
83.B --purgeresult
84purge result file before run
85.TP
86.B --find=string
87search for the given pattern in the documentation sources
88.TP
89.B --forcexml
90force xml stub
91.TP
92.B --forcecld
93force cld (context lua document) stub
94.TP
95.B --forcelua
96force lua stub (like texlua)
97.TP
98.B --forcemp
99force mp stub
100.TP
101.B --arrange
102run extra imposition pass, given that the style sets up imposition
103.TP
104.B --noarrange
105ignore imposition specifications in the style
106.TP
107.B --pages
108report pagenumbers of names pages and list references (--page=... or --page=...)
109.TP
110.B --jit
111use luajittex with jit turned off (only use the faster virtual machine)
112.TP
113.B --jiton
114use luajittex with jit turned on (in most cases not faster, even slower)
115.TP
116.B --once
117only run once (no multipass data file is produced)
118.TP
119.B --runs
120process at most this many times
121.TP
122.B --forcedruns
123process this many times (permits for optimization trial runs)
124.TP
125.B --batchmode
126run without stopping and do not show messages on the console
127.TP
128.B --nonstopmode
129run without stopping
130.TP
131.B --nocompactfonts
132revert to less efficient (traditional) font scaling
133.TP
134.B --nosynctex
135never initializes synctex (for production runs)
136.TP
137.B --synctex
138run with synctex enabled (better use \setupsynctex[state=start])
139.TP
140.B --nodates
141omit runtime dates in pdf file (optional value: a number (1970 offset) or string "YYYY-MM-DD HH:MM")
142.TP
143.B --nocompression
144forcefully turns off compression in the backend
145.TP
146.B --trailerid
147alternative trailer id (or constant one)
148.TP
149.B --generate
150generate file database etc. (as luatools does)
151.TP
152.B --paranoid
153do not descend to .. and ../..
154.TP
155.B --version
156report installed context version
157.TP
158.B --global
159assume given file present elsewhere
160.TP
161.B --nofile
162use dummy file as jobname
163.TP
164.B --forceinput
165use this file as input file instead of the given one
166.TP
167.B --expert
168show some more options
169.SH OPTIONS: EXPERT
170.TP
171.B --touch
172update context version number (also provide --expert, optionally provide --basepath)
173.TP
174.B --nostatistics
175omit runtime statistics at the end of the run
176.TP
177.B --profile
178profile job (use: mtxrun --script profile --analyze)
179.TP
180.B --timing
181generate timing and statistics overview
182.TP
183.B --keeptuc
184keep previous tuc files (jobname-tuc-[run].tmp)
185.TP
186.B --keeppdf
187keep previous pdf files (jobname-pdf-keep.tmp)
188.TP
189.B --keeplog
190keep previous log files (jobname-log-[run].tmp)
191.TP
192.B --notuc
193don't write a tuc file
194.TP
195.B --lmtx
196force lmtx mode (when available)
197.TP
198.B --overloadmode=error|warning|0--6|255
199enable csname overload checking
200.TP
201.B --extra=name
202process extra (mtx-context-... in distribution)
203.TP
204.B --extras
205show extras
206.TP
207.B --ownerpassword
208encrypt the (pdf) file using this master password
209.TP
210.B --userpassword
211use an additional password for opening the document
212.TP
213.B --permissions
214list of: print, modify, extract, add, fillin, assemble, quality
215.TP
216.B --wtpdf
217add an wtpdf conformance blob but best check first if it applies
218.SH OPTIONS: SPECIAL
219.TP
220.B --pdftex
221process file with texexec using pdftex
222.TP
223.B --xetex
224process file with texexec using xetex
225.TP
226.B --mkii
227process file with texexec
228.TP
229.B --pipe
230do not check for file and enter scroll mode (--dummyfile=whatever.tmp)
231.TP
232.B --parallel
233process multiple files at the same time (you can specify a number of processes, default: 8)
234.TP
235.B --parallellist
236process commands in this file (lines that start with 'context')
237.TP
238.B --sandbox
239process file in a limited environment
240.TP
241.B --addbinarypath
242prepend the (found) binarypath to runners
243.SH AUTHOR
244More information about ConTeXt and the tools that come with it can be found at:
245
246
247.B "maillist:"
248ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
249
250.B "webpage:"
251http://www.pragma-ade.nl / http://tex.aanhet.net
252
253.B "wiki:"
254http://contextgarden.net
255