diff options
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/context.1')
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/context.1 | 261 |
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 |