summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/context.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-08 00:43:40 +0000
committerKarl Berry <karl@freefriends.org>2013-04-08 00:43:40 +0000
commit824f7b0903de8ad7f6ee3d7656005e4c59155e06 (patch)
treeabfc8673ef9916f3ab7074e811207384c301492b /Master/texmf-dist/doc/man/man1/context.1
parent689aefb0727676ed3cddf331337b4be226495e72 (diff)
context import for TL13, from www.pragma-ade.com/context/beta/cont-tmf.zip
git-svn-id: svn://tug.org/texlive/trunk@29731 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/context.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/context.1261
1 files changed, 144 insertions, 117 deletions
diff --git a/Master/texmf-dist/doc/man/man1/context.1 b/Master/texmf-dist/doc/man/man1/context.1
index 254d9b87468..e1fb28a994e 100644
--- a/Master/texmf-dist/doc/man/man1/context.1
+++ b/Master/texmf-dist/doc/man/man1/context.1
@@ -1,140 +1,167 @@
-.TH "CONTEXT" "1" "June 2011" "context 0.52" "ConTeXt"
-.de URL
-\\$2 \(laURL: \\$1 \(ra\\$3
-..
-.if \n[.g] .mso www.tmac
-.de EX
-.in +3
-.nf
-.ft CW
-..
-.de EE
-.in -3
-.ft R
-.fi
-..
-
-.SH "NAME"
-context \- front end to the new ConTeXt typesetting system
-
-.SH "SYNOPSIS"
-\fBcontext\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ]
-
-.SH "DESCRIPTION"
-
-\fBcontext\fP, a \fBtexlua\fP(1) script,
-is the command-line front end to the new version of the
-ConTeXt typesetting system, an extensive macro package
-built on the \fBtex\fP(1) family of typesetting programs.
-\fBcontext\fP provides several facilties:
-.IP \(bu
-Process a ConTeXt source file,
-performing as many runs as
-necessary of \fBluatex\fP(1). Options control the output
-format, the pages to process, paper size, and so forth.
-.IP \(bu
-Create new ConTeXt formats, useful during installation.
-.IP \(bu
-Post-process existing PDF files, including merging multiple
-files, and extracting and rearranging pages within a file,
-similar to the facilities provided for PostScript files by
-\fBpsnup\fP(1) or for PDF files by \fBpdftk\fP(1).
-.IP
-.SH "OPTIONS"
-
-All switches should always be specified in full. With no options,
-\fBcontext\fP assumes that
-the file on the command line is a ConTeXt source file, i.e. a TeX file
-in the ConTeXt dialect, and produces a PDF file using the source file.
-
-.IP "\fB--run\fP"
+.TH "mtx-context" "1" "01-01-2013" "version 0.60" "ConTeXt Process Management"
+.SH NAME
+.B mtx-context
+.SH SYNOPSIS
+.B mtxrun --script context [
+.I OPTIONS ...
+.B ] [
+.I FILENAMES
+.B ]
+.SH DESCRIPTION
+.B ConTeXt Process Management
+.SH OPTIONS: BASIC
+.TP
+.B --run
process (one or more) files (default action)
-.IP "\fB--make\fP"
+.TP
+.B --make
create context formats
-.IP "\fB--ctx\fP\fI=\fP\fIname\fP"
+.TP
+.B --ctx=name
use ctx file (process management specification)
-.IP "\fB--interface\fP"
+.TP
+.B --interface
use specified user interface (default: en)
-.IP "\fB--autopdf\fP"
+.TP
+.B --autopdf
close pdf file in viewer and start pdf viewer afterwards
-.IP "\fB--purge(all)\fP"
-purge files either or not after a run (\fB--pattern\fP\fI=\fP\fI...\fP)
-.IP "\fB--usemodule\fP\fI=\fP\fIlist\fP"
-load the given module or style, normally part o fthe distribution
-.IP "\fB--environment\fP\fI=\fP\fIlist\fP"
+.TP
+.B --purge
+purge files either or not after a run (--pattern=...)
+.TP
+.B --purgeall
+purge all files either or not after a run (--pattern=...)
+.TP
+.B --usemodule=list
+load the given module or style, normally part of the distribution
+.TP
+.B --environment=list
load the given environment file first (document styles)
-.IP "\fB--mode\fP\fI=\fP\fIlist\fP"
+.TP
+.B --mode=list
enable given the modes (conditional processing in styles)
-.IP "\fB--path\fP\fI=\fP\fIlist\fP"
+.TP
+.B --path=list
also consult the given paths when files are looked for
-.IP "\fB--arguments\fP\fI=\fP\fIlist\fP"
+.TP
+.B --arguments=list
set variables that can be consulted during a run (key/value pairs)
-.IP "\fB--randomseed\fP\fI=\fP\fInumber\fP"
+.TP
+.B --randomseed=number
set the randomseed
-.IP "\fB--result\fP\fI=\fP\fIname\fP"
+.TP
+.B --result=name
rename the resulting output to the given name
-.IP "\fB--trackers\fP\fI=\fP\fIlist\fP"
-set tracker variables (show list with \fB--showtrackers\fP)
-.IP "\fB--directives\fP\fI=\fP\fIlist\fP"
-set directive variables (show list with \fB--showdirectives\fP)
-.IP "\fB--silent\fP\fI=\fP\fIlist\fP"
-disable logcatgories (show list with \fB--showlogcategories\fP)
-.IP "\fB--noconsole\fP"
+.TP
+.B --trackers=list
+set tracker variables (show list with --showtrackers)
+.TP
+.B --directives=list
+set directive variables (show list with --showdirectives)
+.TP
+.B --silent=list
+disable logcatgories (show list with --showlogcategories)
+.TP
+.B --noconsole
disable logging to the console (logfile only)
-.IP "\fB--purgeresult\fP"
+.TP
+.B --purgeresult
purge result file before run
-.IP "\fB--forcexml\fP"
-force xml stub (optional flag: \fB--mkii\fP)
-.IP "\fB--forcecld\fP"
+.TP
+.B --forcexml
+force xml stub
+.TP
+.B --forcecld
force cld (context lua document) stub
-.IP "\fB--arrange\fP"
+.TP
+.B --forcelua
+force lua stub (like texlua)
+.TP
+.B --forcemp
+force mp stub
+.TP
+.B --arrange
run extra imposition pass, given that the style sets up imposition
-.IP "\fB--noarrange\fP"
+.TP
+.B --noarrange
ignore imposition specifications in the style
-.IP "\fB--once\fP"
+.TP
+.B --jit
+use luajittex with jit turned off (only use the faster virtual machine)
+.TP
+.B --jiton
+use luajittex with jit turned on (in most cases not faster, even slower)
+.TP
+.B --once
only run once (no multipass data file is produced)
-.IP "\fB--batchmode\fP"
-run without stopping and don't show messages on the console
-.IP "\fB--nonstopmode\fP"
+.TP
+.B --batchmode
+run without stopping and do not show messages on the console
+.TP
+.B --nonstopmode
run without stopping
-.IP "\fB--generate\fP"
-generate file database etc. (as \fBmtxrun\fP does)
-.IP "\fB--paranoid\fP"
-don't descend to .. and ../..
-.IP "\fB--version\fP"
+.TP
+.B --synctex
+run with synctex enabled (optional value: zipped, unzipped, 1, -1)
+.TP
+.B --generate
+generate file database etc. (as luatools does)
+.TP
+.B --paranoid
+do not descend to .. and ../..
+.TP
+.B --version
report installed context version
-.IP "\fB--expert\fP"
-show expert options
-
-
-.SH "INITIALIZATION"
-
-.PP
-The \fBcontext\fP command is just a stub that runs the larger \fBmtxrun\fP
-script, which is a scripting framework written for \fBtexlua\fP(1) that
-supports loading of extra modules, of which \fBcontext\fP is one. The
-implementation actually resides in a file named \fBmtx-context.lua\fP
-deep within the TDS structure.
-
-If \fBcontext\fP complains about \fBUnknown script 'context'\fP, this
-can usually be fixed by executing \fBmtxrun --generate\fP on the
-command line: this command regenerates the database that \fBmtxrun\fP
-uses to find its extra modules.
+.TP
+.B --global
+assume given file present elsewhere
+.TP
+.B --nofile
+use dummy file as jobname
+.SH OPTIONS: EXPERT
+.TP
+.B --touch
+update context version number (remake needed afterwards, also provide --expert)
+.TP
+.B --nostatistics
+omit runtime statistics at the end of the run
+.TP
+.B --update
+update context from website (not to be confused with contextgarden)
+.TP
+.B --profile
+profile job (use: mtxrun --script profile --analyze)
+.TP
+.B --timing
+generate timing and statistics overview
+.TP
+.B --extra=name
+process extra (mtx-context-... in distribution)
+.TP
+.B --extras
+show extras
+.SH OPTIONS: SPECIAL
+.TP
+.B --pdftex
+process file with texexec using pdftex
+.TP
+.B --xetex
+process file with texexec using xetex
+.TP
+.B --mkii
+process file with texexec
+.TP
+.B --pipe
+do not check for file and enter scroll mode (--dummyfile=whatever.tmp)
+.SH AUTHOR
+More information about ConTeXt and the tools that come with it can be found at:
-.SH "SEE ALSO"
-.PP
-\fBtex\fP(1), \fBluatex\fP(1), \fBtexlua\fP(1), \fBpsnup\fP(1), \fBpdftk\fP(1).
-.PP
-.URL "http://www.contextgarden.net" "ConTeXt wiki" .
-.PP
-.URL "http://www.ntg.nl/mailman/listinfo/ntg-context" "ConTeXt mailing list home" .
-.SH "BUGS"
+.B "maillist:"
+ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
-.PP
-This manpage is horribly incomplete.
+.B "webpage:"
+http://www.pragma-ade.nl / http://tex.aanhet.net
-.SH "AUTHOR"
-This partial manpage was written by Taco Hoekwater
-<taco@metatex.org>.
-It is based on the \fB--help\fP output of \fBcontext\fP.
+.B "wiki:"
+http://contextgarden.net