texmfstart1
Context tds runner tool
Part of mtxrun(1).
Usage
mtxrun [OPTIONS ...]
[FILENAMES]
Overview
ConTeXt TDS Runner Tool
Options
-
--script -
run an mtx script (lua prefered method) (--noquotes), no script gives list
-
--evaluate -
run code passed on the commandline (between quotes) (=loop) (exit|quit aborts)
-
--execute -
run a script or program (texmfstart method) (--noquotes)
-
--direct -
run a program
-
--resolve -
resolve prefixed arguments
-
--ctxlua -
run internally (using preloaded libs)
-
--internal -
run script using built in libraries (same as --ctxlua)
-
--locate -
locate given filename in database (default) or system (--first --all --detail)
-
--tree=pathtotree -
use given texmf tree (default file: setuptex.tmf)
-
--path=runpath -
go to given path before execution
-
--ifchanged=filename -
only execute when given file has changed (md checksum)
-
--iftouched=old,new -
only execute when given file has changed (time stamp)
-
--makestubs -
create stubs for (context related) scripts
-
--removestubs -
remove stubs (context related) scripts
-
--stubpath=binpath -
paths where stubs wil be written
-
--windows -
create windows (mswin) stubs
-
--unix -
create unix (linux) stubs
-
--addbinarypath -
prepend the (found) binarypath to runners
-
--verbose -
give a bit more info
-
--trackers=list -
enable given trackers
-
--progname=str -
format or backend
-
--platform=str -
show platform as seen by script
-
--systeminfo=str -
show current operating system, processor, etc
-
--edit -
launch editor with found file
-
--launch -
launch files like manuals, assumes os support (--all,--list)
-
--associate -
launch files like manuals, assumes os support via suffix association
-
--timedrun -
run a script and time its run
-
--autogenerate -
regenerate databases if needed (handy when used to run context in an editor)
-
--usekpse -
use kpse as fallback (when no mkiv and cache installed, often slower)
-
--forcekpse -
force using kpse (handy when no mkiv and cache installed but less functionality)
-
--prefixes -
show supported prefixes
-
--generate -
generate file database
-
--variables -
show configuration variables
-
--configurations -
show configuration order
-
--directives -
show (known) directives
-
--trackers -
show (known) trackers
-
--experiments -
show (known) experiments
-
--expand-braces -
expand complex variable
-
--resolve-path -
expand variable (completely resolve paths)
-
--expand-path -
expand variable (resolve paths)
-
--expand-var -
expand variable (resolve references)
-
--show-path -
show path expansion of ...
-
--show-details -
show details of configuration
-
--var-value -
report value of variable
-
--find-file -
report file location
-
--find-path -
report path of file
-
--format-path -
report path where format files end up
-
--pattern=string -
filter variables
-
--all=string -
report all (when applicable)
-
--format=string -
filter by file format (when applicable)
-
--selfclean=string -
remove libraries (maintainance)
-
--selfmerge=string -
embed libraries (maintainance)
-
--selfupdate=string -
move to bin path (maintainance)
-
--help=string -
show help info
-
--version=string -
show version info
-
--gethelp=string -
launch the given help info (--url)
Releases
9 releases since Debian 5.0 (Lenny); the text changed 7 times.
--addbinarypath since Debian 11 (Bullseye);
--all since Arch Linux 2026-11-01;
--associate since Arch Linux 2026-11-01;
--autogenerate since Debian 8 (Jessie);
--configurations since Debian 8 (Jessie);
--ctxlua since Debian 8 (Jessie);
--direct since Arch Linux 2026-11-01;
--directives since Debian 8 (Jessie);
--evaluate since Debian 9 (Stretch);
--expand-braces since Debian 8 (Jessie);
--expand-path since Debian 8 (Jessie);
--expand-var since Debian 8 (Jessie);
--experiments since Debian 8 (Jessie);
--find-file since Debian 8 (Jessie);
--find-path since Debian 8 (Jessie);
--forcekpse since Debian 8 (Jessie);
--format since Arch Linux 2026-11-01;
--format-path since Arch Linux 2026-11-01;
--generate since Debian 8 (Jessie);
--gethelp since Arch Linux 2026-11-01;
--help since Arch Linux 2026-11-01;
--internal since Debian 8 (Jessie);
--launch since Debian 8 (Jessie);
--makestubs since Debian 8 (Jessie);
--pattern since Debian 8 (Jessie);
--platform since Arch Linux 2026-11-01;
--prefixes since Debian 8 (Jessie);
--progname since Debian 8 (Jessie);
--removestubs since Debian 8 (Jessie);
--resolve since Debian 8 (Jessie);
--resolve-path since Debian 10 (Buster);
--script since Debian 8 (Jessie);
--selfclean since Arch Linux 2026-11-01;
--selfmerge since Arch Linux 2026-11-01;
--selfupdate since Arch Linux 2026-11-01;
--show-details since Arch Linux 2026-11-01;
--show-path since Debian 8 (Jessie);
--systeminfo since Debian 9 (Stretch);
--timedrun since Debian 8 (Jessie);
--trackers since Debian 8 (Jessie);
--unix since Debian 8 (Jessie);
--usekpse since Debian 8 (Jessie);
--var-value since Debian 8 (Jessie);
--variables since Debian 8 (Jessie);
--version since Arch Linux 2026-11-01.
--arguments until Debian 7 (Wheezy);
--autotree until Debian 10 (Buster);
--browser until Debian 7 (Wheezy);
--clear until Debian 7 (Wheezy);
--environment until Debian 10 (Buster);
--file until Debian 7 (Wheezy);
--indirect until Debian 7 (Wheezy);
--linux until Debian 7 (Wheezy);
--make until Debian 7 (Wheezy);
--page until Debian 7 (Wheezy);
--program until Debian 7 (Wheezy);
--report until Debian 7 (Wheezy);
--showenv until Debian 7 (Wheezy).