mtx-context.man /size: 5479 b    last modification: 2024-01-16 09:02
1.TH "mtx-context" "1" "01-01-2024" "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 --forcexml
87force xml stub
88.TP
89.B --forcecld
90force cld (context lua document) stub
91.TP
92.B --forcelua
93force lua stub (like texlua)
94.TP
95.B --forcemp
96force mp stub
97.TP
98.B --arrange
99run extra imposition pass, given that the style sets up imposition
100.TP
101.B --noarrange
102ignore imposition specifications in the style
103.TP
104.B --pages
105report pagenumbers of names pages and list references (--page=... or --page=...)
106.TP
107.B --jit
108use luajittex with jit turned off (only use the faster virtual machine)
109.TP
110.B --jiton
111use luajittex with jit turned on (in most cases not faster, even slower)
112.TP
113.B --once
114only run once (no multipass data file is produced)
115.TP
116.B --runs
117process at most this many times
118.TP
119.B --forcedruns
120process this many times (permits for optimization trial runs)
121.TP
122.B --batchmode
123run without stopping and do not show messages on the console
124.TP
125.B --nonstopmode
126run without stopping
127.TP
128.B --nosynctex
129never initializes synctex (for production runs)
130.TP
131.B --synctex
132run with synctex enabled (better use \setupsynctex[state=start])
133.TP
134.B --nodates
135omit runtime dates in pdf file (optional value: a number (this 1970 offset time) or string "YYYY-MM-DD HH:MM")
136.TP
137.B --nocompression
138forcefully turns off compression in the backend
139.TP
140.B --trailerid
141alternative trailer id (or constant one)
142.TP
143.B --generate
144generate file database etc. (as luatools does)
145.TP
146.B --paranoid
147do not descend to .. and ../..
148.TP
149.B --version
150report installed context version
151.TP
152.B --global
153assume given file present elsewhere
154.TP
155.B --nofile
156use dummy file as jobname
157.TP
158.B --forceinput
159use this file as input file instead of the given one
160.SH OPTIONS: EXPERT
161.TP
162.B --touch
163update context version number (also provide --expert, optionally provide --basepath)
164.TP
165.B --nostatistics
166omit runtime statistics at the end of the run
167.TP
168.B --profile
169profile job (use: mtxrun --script profile --analyze)
170.TP
171.B --timing
172generate timing and statistics overview
173.TP
174.B --keeptuc
175keep previous tuc files (jobname-tuc-[run].tmp)
176.TP
177.B --keeppdf
178keep previous pdf files (jobname-pdf-keep.tmp)
179.TP
180.B --keeplog
181keep previous log files (jobname-log-[run].tmp)
182.TP
183.B --notuc
184don't write a tuc file
185.TP
186.B --lmtx
187force lmtx mode (when available)
188.TP
189.B --overloadmode=error|warning|0--6|255
190enable csname overload checking
191.TP
192.B --extra=name
193process extra (mtx-context-... in distribution)
194.TP
195.B --extras
196show extras
197.TP
198.B --ownerpassword
199encrypt the (pdf) file using this master password
200.TP
201.B --userpassword
202use an additional password for opening the document
203.TP
204.B --permissions
205list of: print, modify, extract, add, fillin, assemble, quality
206.SH OPTIONS: SPECIAL
207.TP
208.B --pdftex
209process file with texexec using pdftex
210.TP
211.B --xetex
212process file with texexec using xetex
213.TP
214.B --mkii
215process file with texexec
216.TP
217.B --pipe
218do not check for file and enter scroll mode (--dummyfile=whatever.tmp)
219.TP
220.B --parallel
221process multiple files at the same time (you can specify a number of processes, default: 8)
222.TP
223.B --parallellist
224process commands in this file (lines that start with 'context')
225.TP
226.B --sandbox
227process file in a limited environment
228.TP
229.B --addbinarypath
230prepend the (found) binarypath to runners
231.SH AUTHOR
232More information about ConTeXt and the tools that come with it can be found at:
233
234
235.B "maillist:"
236ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
237
238.B "webpage:"
239http://www.pragma-ade.nl / http://tex.aanhet.net
240
241.B "wiki:"
242http://contextgarden.net
243