diff options
| -rw-r--r-- | Master/texmf/doc/man/man1/texexec.1 | 1466 |
1 files changed, 916 insertions, 550 deletions
diff --git a/Master/texmf/doc/man/man1/texexec.1 b/Master/texmf/doc/man/man1/texexec.1 index 2d8593b674c..296f4646631 100644 --- a/Master/texmf/doc/man/man1/texexec.1 +++ b/Master/texmf/doc/man/man1/texexec.1 @@ -1,574 +1,940 @@ +.\" texexec.1 +.\" +.\" Revised 2006-Jul-02 by Werner Lemberg <wl@gnu.org>. +. .de EX -.sp -.in +5 -.nf -.ft CW +. RS +. IP +. nf +. ft CW .. +. .de EE -.in -5 -.ft R -.sp -.fi +. ft R +. fi +. RE .. -.TH "texexec" "1" "October 2000" "ConTeXt" "ConTeXt" -.PP -.SH "NAME" +. +.TH texexec 1 "October 2000" ConTeXt ConTeXt +. +. +.SH NAME +. texexec \- ConTeXt and PDF auxiliary program and batch processor -.PP -.SH "SYNOPSIS" -\fBtexexec\fP [ \fIOPTION\fP \&.\&.\&. ] \fIFILE\fP [ \&.\&.\&. ] -.PP -.SH "DESCRIPTION" -.PP -\fBtexexec\fP is a Perl script that provides several functions: -.IP o -Process a TeX file\&. This includes performing as many runs as -necessary of \fBtex\fP(1), \fBtexutil\fP(1), and -\fBmetapost\fP(1)\&. Options allow you to select the output -format, the pages to process, paper size, and so forth\&. -.IP o -Create new ConTeXt formats (with \fB--format\fP)\&. -.IP o -Post-process existing PDF files, including merging multiple -files, and extracting and rearranging pages within a file -(similar to the functions provided by \fBpsnup\fP(1) and -\fBpdfmerge\fP(1))\&. -.IP o -Extract or strip documentation from com{ConTeXt} source files -(using \fBtexutil\fP(1))\&. -.IP o -Run METAPOST (\fBmpost\fP(1)) to generate figures from METAPOST -source\&. -.IP o -Produce ``proof sheets\'\' of figures used in a \fBConTeXt\fP source -file\&. -.IP -.PP -.SH "OPTIONS" -.PP -All switches are specified in full, but can be abbreviated to the -shortest unique string\&. Thus, \fB--ver\fP works the same as -\fB--verbose\fP\&. -.PP -.SH "General Options" -.PP -.IP "\fB--alone\fP" -Avoid calling other programs when possible\&. For -example, \fB--alone\fP will prevent \fBtexexec\fP from -using \fBfmtutil\fP(1) to generate formats (which can -be handy when tracing installation problems)\&. -.IP "\fB--environment=\fP\fIENVIRONMENT\fP" +. +. +.SH SYNOPSIS +. +\fBtexexec\fP [\ \fIOPTION\fP .\|.\|.\ ] \fIFILE\fP [\ .\|.\|.\ ] +. +. +.SH DESCRIPTION +. +.B \%texexec +is a Perl script that provides several functions: +. +.IP o +Process a TeX file. +This includes performing as many runs as necessary of +.BR tex (1), +.BR texutil (1), +and +.BR metapost (1). +Options allow you to select the output format, the pages to process, paper +size, and so forth. +. +.IP o +Create new ConTeXt formats (with +.BR \-\-format ). +. +.IP o +Post-process existing PDF files, including merging multiple files, and +extracting and rearranging pages within a file, similar to the functions +provided by +.BR psnup (1) +and +.BR pdfmerge (1). +. +.IP o +Extract or strip documentation from ConTeXt source files, using +.BR texutil (1). +. +.IP o +Run METAPOST to generate figures from METAPOST source files. +Note that the METAPOST binary is normally called +.BR mpost (1). +. +.IP o +Produce `proof sheets' of figures used in a +.B ConTeXt +source file. +. +. +.SH OPTIONS +. +In this man page, all switches are specified in full, but they can be +abbreviated to the shortest unique string. +Thus, +.B \-\-ver +works the same as +.BR \-\-verbose . +. +.SS "General Options" +. +.TP +.B \-\-alone +Avoid calling other programs if possible. +For example, +.B \-\-alone +prevents +.B \%texexec +from using +.BR fmtutil (1) +to generate formats (which can be handy while tracing installation +problems). +. +.TP +.BI \-\-environment= ENVIRONMENT Specify a ConTeXt -\fIENVIRONMENT\fP to use when processing the file\&. -This option can be useful when converting from -non-ConTeXt file formats where no environment or layout -settings are present in the file\&. -.IP "\fB--help\fP [ \fISWITCH\fP ]" -Produce a summary of switches -and arguments\&. Many switches have additional -information that can be seen by typing ``\f(CWtexexec ---help optvar(SWITCH)\fP\'\'\&. -.IP "\fB--interface=\fP\fILANGUAGE\fP" +.I ENVIRONMENT +to use when processing the file. +This option can be useful when converting from non-ConTeXt file formats +where no environment or layout settings are present in the file. +. +.TP +\fB\-\-help\fP [\ \fISWITCH\fP\ ] +Produce a summary of switches and arguments. +Many switches have additional information that can be seen by typing +. +.EX +\f(CWtexexec \-\-help optvar(SWITCH)\fP +.EE +. +.TP +.B \-\-interface= LANGUAGE Specify the language -\fBConTeXt\fP should use to communicate with you\&. +.B ConTeXt +should use to communicate with you. Options are -.IP -.RS -.IP "\fBen\fP" +. +.RS +.TP +.B en US English -.IP "\fBnl\fP" +.TP +.B nl Dutch -.IP "\fBde\fP" +.TP +.B de German -.IP "\fBuk\fP" +.TP +.B uk British English -.IP "\fBcz\fP" +.TP +.B cz Czech -.IP "\fBit\fP" +.TP +.B it Italian -.RE -.IP "\fB--once\fP" -Process a file once and only once\&. (By default, -\fBtexexec\fP processes the file as many times as -necessary to sort out all references, typeset -\fBMETAPOST\fP code, and so forth\&.) -.IP "\fB--output=\fP\fIDRIVER\fP" -Specify the output \fIDRIVER\fP -for use with \f(CW\especial\fP primitives\&. Defaults to the setting in -the local \fIcont-sys\&.tex\fP file, but can be set to one of -.IP -.RS -.IP "\fBpdftex\fP" -Native \fBpdftex\fP(1) code -.IP "\fBdvips\fP" -For \fBdvips\fP(1) (the default) -.IP "\fBdvipsone\fP" -For \fBdvipsone\fP -.IP "\fBdviwindo\fP" -For \fBdviwindo\fP, the oldest -\fBConTeXt\fP drivers -.IP "\fBdviview\fP" -For \fBdviview\fP (experimental) -.IP -.RE -.IP -There may be other supported drivers -- check the most -recent \fBConTeXt\fP documentation\&. -.IP "\fB--pages=\fP\fIPAGENUMBERLIST\fP" -Specify the pages or page -range to appear in the output file\&. -\fIPAGENUMBERLIST\fP may be the keyword \fBodd\fP -or \fBeven\fP; one or more pages separated by commas -(\f(CWx,y\fP); or a page range in the form \f(CW:z\fP\&. -.IP "\fB--passon=\fP\fISTRING\fP" -Pass additional command-line -switches and arguments to the \fBtex\fP(1) process -run by \fBtexexec\fP\&. -.IP -For example, the \fBMikTeX\fP TeX system (for -DOS/Windows) can embed information in the DVI file that -will allow you to find the line in a source code file -corresponding to the line in the typeset output\&. It -uses a switch called ``--src\'\' to activate this -functionality, and can be used from \fBtexexec\fP as -.IP -.EX -\f(CWtexexec --passon="--src" somefile\fP -.EE -.IP +.RE +. +.TP +.B \-\-once +Process a file once and only once. +By default, +.B \%texexec +processes the file as many times as necessary to sort out all references, +to typeset +.B METAPOST +code, and so forth. +. +.TP +.BI \-\-output= DRIVER +Specify the output +.I DRIVER +for use with \f(CW\especial\fP primitives. +Defaults to the setting in the local +.I cont-sys.tex +file, but can be set to one of +. +.RS +.TP +.B pdftex +Native +.BR pdftex (1) +code. +.TP +.B dvips +For +.BR dvips (1). +This is the default. +.TP +.B dvipsone +For +.B dvipsone. +.TP +.B dviwindo +For +.BR dviwindo , +the oldest +.B ConTeXt +drivers. +.TP +.B dviview +For +.B dviview +(experimental). +.RE +. +.IP +There may be other supported drivers \(en check the most recent +.B ConTeXt +documentation. +. +.TP +.BI \-\-pages= PAGENUMBERLIST +Specify the pages or page range to appear in the output file. +.I PAGENUMBERLIST +may be the keyword +.B odd +or +.BR even , +one or more pages separated by commas (\f(CWx,y\fP), +or a page range in the form \f(CW:z\fP. +. +.TP +.BI \-\-passon= STRING +Pass additional command-line switches and arguments to the +.BR tex (1) +process run by +.BR \%texexec . +. +.IP +For example, the +.B MikTeX +TeX system (for DOS/Windows) can embed information in the DVI file +that allows you to find the line in a source code file corresponding +to the line in the typeset output. +It uses a switch called `\-\-src' to activate this functionality, +and can be used from +.B \%texexec +as +. +.EX +\f(CWtexexec \-\-passon="\-\-src" somefile\fP +.EE +. +.IP The double quotes (\f(CW"\fP) are required to prevent -\fBtexexec\fP from using the switch itself\&. -.IP "\fB--program\fP" +.B \%texexec +from using the switch itself. +. +.TP +.B \-\-program The name of the TeX program to use -(\fBtex\fP(1), by default)\&. -.IP "\fB--result=\fP\fIFILENAME\fP" -Allows you to change the -basename of the output file\&. See -\fB--mode\fP for an example\&. -.IP "\fB--runs=\fP\fINUMBER\fP" -Specify the number of runs to -perform on a file\&. Overrides -\fBtexexec\fP\'s calculations\&. -.IP "\fB--silent\fP" -Suppress diagnostic and progress messages\&. -.IP "\fB--suffix=\fP\fISUFFIX\fP" -Specify the suffix of the output file\&. -.IP "\fB--tex=\fP\fIPROGRAMNAME\fP" -Allows you specify the program -to use instead of \fBtex\fP(1)\&. Useful for trying -different versions of \fBtex\fP(1) installed on the -same machine\&. -.IP "\fB--texutil\fP" -Force a run of \fBtexutil\fP(1)\&. -.IP "\fB--verbose\fP" -Output diagnostic information, including the -contents of \fItexexec\&.ini\fP\&. -.IP -.PP -.SH "Processing \fBConTeXt\fP Source Files" -.PP -Including specifying paper sizes, formats, and so forth\&. -.PP -.IP "\fB--arrange\fP" -Don\'t perform page rearrangements (e\&.g\&., for -producing a booklet) until the last run\&. -.IP "\fB--batch\fP" -Process the file in batch mode -- continue to -typeset the document after finding errors\&. More -imformation about batch mode can be found in Donald -E\&. Knuth\'s \fITeXbook\fP\&. -.IP "\fB--bodyfont\fP" -The name of a font to preload for use in -setting the body of the text\&. -.IP "\fB--centerpage\fP" -Center the document image on the page\&. -.IP "\fB--color\fP" -Turn on color mode\&. Color mode can also be set by -commands embedded in the document\&. These commands -override the \fB--color\fP option\&. -.IP "\fB--convert=\fP\fIFORMAT\fP" -Convert the input file to -ConTeXt format from \fIFORMAT\fP before -processing\&. In most cases, this conversion will result -in a TeX file\&. Currently supported input -\fIFORMAT\fPs are \fBxml\fP and -\fBsgml\fP\&. -.IP "\fB--dvi\fP" -Shortcut for \fB--output=dvi\fP\&. -.IP "\fB--fast\fP" -Typeset the document(s) as fast as possible without -causing problems\&. -.IP "\fB--final\fP" -Perform a final run without skipping anything\&. -This option is typically used with \fB--fast\fP\&. -.IP "\fB--language=\fP\fILANGUAGE\fP" -Set the language for -hyphenation\&. Can be specified in your source file\&. -Options are the same as those for \fB--interface\fP\&. -.IP "\fB--mode=\fP\fIMODELIST\fP" -Allows you to change the mode -(page size and resolution) of the output file\&. -.IP -.EX -\f(CWtexexec --pdf --mode=A4 --result=pdftex-a pdftex-t\fP -\f(CWtexexec --pdf --mode=letter --result=pdftex-l pdftex-t\fP -\f(CWtexexec --pdf --mode=screen --result=pdftex-s pdftex-t\fP -.EE -.IP -Here the mode switch tells \fBConTeXt\fP to obey -the mode directives in the layout specifications\&. The -\fB--result\fP flag allows you to -rename the output file\&. -.IP "\fB--noarrange\fP" -Ignore arrangement commands in the source -file\&. -.IP "\fB--paper=\fP\fIKEY\fP" -For typesetting multiple pages on a -single piece of paper\&. \fIKEY\fP can be \fBa4a3\fP -(for printing A4 pages on A3 paper) or \fBa5a4\fP -(for printing A5 pages on A4 paper)\&. The actual layout -of the pages is specified with the -\fB--print\fP switch\&. -.IP "\fB--pdf\fP" -Shorthand for \fB--output=pdftex\fP\&. -.IP "\fB--print=\fP\fIKEY\fP" -Specify the layout of the final -output\&. \fIKEY\fP can be \fBup\fP, resulting in 2 -pages per sheet, double sided, or \fBdown\fP, resulting -in 2 rotated pages per sheet, double sided\&. Use the ---paper switch to specify the original page -and sheet size\&. -.IP -.PP -.SH "Creating \fBConTeXt\fP Format Files" -.PP -.IP "\fB--format=\fP\fIFORMATFILE\fP" -Specify a \fIFORMATFILE\fP -to use when typesetting\&. \fBtexexec\fP will prepend the -string \f(CWcont- \fP to the name you give, so you can -type \f(CWplain\fP instead of \f(CWcont-plain\fP, as in -.IP -.EX -\f(CWtexexec --format=plain --program=pdftex somefile\fP -.EE -.IP "\fB--make\fP" -Generate a \fBConTeXt\fP format file\&. -.PP -.SH "Postprocess PDF Files" -.PP -.IP "\fB--combination=\fP\fIROWS\fP\fB*\fP\fICOLS\fP" -Specify -the number of pages to show on a single page\&. Use with -\fB--pdfcombine\fP\&. -.IP "\fB--pdfarrange\fP" -For rearranging pages in PDF files\&. -.IP +.RB ( tex (1), +by default). +. +.TP +.BI \-\-result= FILENAME +Allows you to change the basename of the output file. +See +.B \-\-mode +for an example. +. +.TP +.BI \-\-runs= NUMBER +Specify the number of runs to perform on a file. +Overrides +.BR \%texexec 's +calculations. +. +.TP +.B \-\-silent +Suppress diagnostic and progress messages. +. +.TP +.BI \-\-suffix= SUFFIX +Specify the suffix of the output file. +. +.TP +.BI \-\-tex= PROGRAMNAME +Specify the program to use instead of +.BR tex (1). +Useful for trying different versions of +.BR tex (1) +installed on the same machine. +. +.TP +.B \-\-texutil +Force a run of +.BR \%texutil (1). +. +.TP +.B \-\-verbose +Output diagnostic information, including the contents of +.IR \%texexec.ini . +. +. +.SS "Processing \fBConTeXt\fP Source Files" +. +This subsection also covers option for the selection of paper sizes, +formats, and so forth. +. +.TP +.B \-\-arrange +Don't perform page rearrangements (e.g., for producing a booklet) until the +last run. +. +.TP +.B \-\-batch +Process the file in batch mode \(en continue to typeset the document after +finding errors. +More information about batch mode can be found in Donald E.\& Knuth's +.IR TeXbook . +. +.TP +.B \-\-bodyfont +The name of a font to preload for use in setting the body of the text. +. +.TP +.B \-\-centerpage +Center the document image on the page. +. +.TP +.B \-\-color +Turn on color mode. +Color mode can also be set by commands embedded in the document. +These commands override the +.B \-\-color +option. +. +.TP +.BI \-\-convert= FORMAT +Convert the input file to ConTeXt format from +.I FORMAT +before processing. +In most cases, this conversion results in a TeX file. +Currently supported input formats are +.B xml +and +.BR sgml . +. +.TP +.B \-\-dvi +Shortcut for +.RB ` \-\-output=dvi '. +. +.TP +.B \-\-fast +Typeset the document(s) as fast as possible without causing problems. +. +.TP +.B \-\-final +Perform a final run without skipping anything. +This option is typically used with +.BR \-\-fast . +. +.TP +.BI \-\-language= LANGUAGE +Set the language for hyphenation. +Can be specified in your source file. +Options are the same as those for +.BR \-\-interface . +. +.TP +.BI \-\-mode= MODELIST +Allows you to change the mode (page size and resolution) of the output file. +Examples: +. .EX -\f(CWtexexec --pdfarrange --paper=a5a4 --print=up foo\&.pdf\fP -.EE -.IP +texexec --pdf --mode=A4 --result=pdftex-a pdftex-t +texexec --pdf --mode=letter --result=pdftex-l pdftex-t +texexec --pdf --mode=screen --result=pdftex-s pdftex-t +.EE +. +.IP +Here the mode switch tells +.B ConTeXt +to obey the mode directives in the layout specifications. +The +.B \-\-result +flag allows you to rename the output file. +. +.TP +.B \-\-noarrange +Ignore arrangement commands in the source file. +. +.TP +.BI \-\-paper= KEY +For typesetting multiple pages on a single piece of paper. +.I KEY +can be +.B a4a3 +(for printing A4 pages on A3 paper) or +.B a5a4 +(for printing A5 pages on A4 paper). +The actual layout of the pages is specified with the +.B \-\-print +switch. +. +.TP +.B \-\-pdf +Shorthand for +.RB ` \-\-output=pdftex '. +. +.TP +.BI \-\-print= KEY +Specify the layout of the final output. +.I KEY +can be +.BR up , +resulting in two pages per sheet, double sided, or +.BR down , +resulting in two rotated pages per sheet, double sided. +Use the +.B \-\-paper +switch to specify the original page and sheet size. +. +. +.SS "Creating \fBConTeXt\fP Format Files" +. +.TP +.BI \-\-format= FORMATFILE +Specify a format file for typesetting. +.B \%texexec +prepends the string `\f(CWcont\-\fP' to the name you give, so you can type +`\f(CWplain\fP' instead of `\f(CWcont\-plain\fP', as in +. +.EX +texexec --format=plain --program=pdftex somefile +.EE +. +.TP +.B \-\-make +Generate a +.B ConTeXt +format file. +. +. +.SS "Postprocess PDF Files" +. +.TP +.BI \-\-combination= ROWS * COLS +Specify the number of pages to show on a single page. +Use with +.BR \-\-pdfcombine . +. +.TP +.B \-\-pdfarrange +For rearranging pages in PDF files. +Example: +. +.EX +texexec --pdfarrange --paper=a5a4 --print=up foo.pdf +.EE +. +.IP This command creates an A5 booklet from a PDF file -\fIfoo\&.pdf\fP\&. \fB--pdfarrange\fP is used in -conjunction with the following switches: -.IP "\fB--paperoffset\fP" -Adjust the space between the -edge of the pages and the beginning of the text block\&. -.IP "\fB--backspace\fP" -Adjust the inside (``gutter\'\') -margins\&. -.IP "\fB--topspace\fP" -Adjust the top and bottom -margin\&. -.IP "\fB--markings\fP" -Add crop marks\&. -.IP "\fB--addempty=\fP\fIPAGES\fP" -Add empty pages -after the pages specified in \fIPAGES\fP\&. (Useful -for, among other things, adding blank pages after a -table of contents\&.) -.IP "\fB--textwidth=\fP\fIWIDTH\fP" -Set the width of -the original text\&. Specifying this parameter with a -single-sided original will allow \fBConTeXt\fP to adjust -the page layout for double-sided output, producing much -more attractive results\&. -.IP -With the \fB--pdfarrange\fP flag, specifying more -than one file will result in all of the files being -combined in the final result, allowing you to add title -pages, decorated part separators, and so forth\&. -.IP -You can also do more complex manipulations, such as -adding additional text to the page by setting up a -small file with layout definitions and a simple figure -insertion loop\&. -.IP "\fB--pdfcombine\fP" -Combine multiple pages\&. Requires you to -specify the -\fB--combination\fP -switch\&. -.IP "\fB--pdfselect\fP" -Extract pages from a file\&. Use in combination with -the \fB--selection\fP switch, as -in -.IP -.RS -\f(CWtexexec --pdfselect --paper=S6 ---selection=1,9,14 file-1\fP -.RE -.IP +.IR foo.pdf . +.B \%\-\-pdfarrange +is intended to be used in conjunction with the other switches of this +subsection. +. +.TP +.B \-\-paperoffset +Adjust the space between the edge of the pages and the beginning of the text +block. +. +.TP +.B \-\-backspace +Adjust the inside (`gutter') margins. +. +.TP +.B \-\-topspace +Adjust the top and bottom margin. +. +.TP +.B \-\-markings +Add crop marks. +. +.TP +.BI \-\-addempty= PAGES +Add empty pages after the pages specified in +.IR PAGES . +Useful for, among other things, adding blank pages after a table of +contents. +. +.TP +.BI \-\-textwidth= WIDTH +Set the width of the original text. +Specifying this parameter with a single-sided original allows +.B ConTeXt +to adjust the page layout for double-sided output, producing much more +attractive results. +. +.IP +With the +.B \%\-\-pdfarrange +flag, specifying more than one file results in all of the files being +combined in the final result, allowing you to add title pages, decorated +part separators, and so forth. +.IP +You can also do more complex manipulations, such as adding additional text +to the page by setting up a small file with layout definitions and a simple +figure insertion loop. +. +.TP +.B \-\-pdfcombine +Combine multiple pages. +Requires you to specify the +.B \%\-\-combination +switch. +. +.TP +.B \-\-pdfselect +Extract pages from a file. +Used in combination with the +.B \%\-\-selection +switch, as in +. +.EX +texexec --pdfselect --paper=S6 --selection=1,9,14 file-1 +.EE +. +.IP which extracts pages 1, 9, and 14 from -\fIfile-1\&.pdf\fP, and places them in -\fItexexec\&.pdf\fP (the default output filename if -an output file isn\'t specified)\&. -.IP -See \fB--pdfarrange\fP for other -options\&. -.IP "\fB--selection=\fP\fIPAGES\fP" -Specify pages to be affected by -another option\&. See \fB--pdfarrange\fP and -\fB--pdfselect\fP for examples\&. -.PP -.SH "Extract or Strip Out Documentation" -.PP -.IP "\fB--listing\fP" +.IR \%file-1.pdf , +and places them in +.I \%texexec.pdf +(which is the default output filename if no output file is specified). +. +.IP +See +.B \%\-\-pdfarrange +for other options. +. +.TP +.BI \-\-selection= PAGES +Specify pages to be affected by another option. +See +.B \%\-\-pdfarrange +and +.B \%\-\-pdfselect +for examples. +. +. +.SS "Extract or Strip Out Documentation" +. +.TP +.B \-\-listing Produce a typeset version of the source code in -\fIFILE\fP\&. You can specify the form of the output -file, as in -.RS -\f(CWtexexec --listing --pdf readme\&.now\fP -.RE -.IP -which will produce a PDF file called -\fItexexec\&.pdf\fP\&. Without the -\fB--pdf\fP flag, \fBtexexec\fP will -produce a DVI file\&. -.IP -See also \fB--backspace\fP and -\fB--topspace\fP\&. -.IP "\fB--module\fP" -Create documentation for \fBConTeXt\fP, -\fBMetaPost\fP (see \fBmpost\fP(1)), and Perl modules\&. -Converts the documentation to \fBConTeXt\fP format and -then typesets that documentation\&. See -\fBtexutil\fP(1) for more information about the -format of the documentation strings\&. -.PP -.SH "Process METAPOST Figures" -.PP -.IP "\fB--mpformat\fP" -The name of a \fBMetaPost\fP format file\&. -.IP "\fB--mptex\fP" -Strips out and typesets TeX code embedded in a -\fBMetaPost\fP file\&. -.IP "\fB--nomp\fP" -Do not run \fBMetaPost\fP, even if needed\&. -.IP "\fB--nomprun\fP" -Do not run \fBmpost\fP(1) on embedded -\fBMetaPost\fP code\&. -.PP -.SH "Producing Proof Sheets of Figures" -.PP -.IP "\fB--figures=\fP\fIALTERNATIVE\fP" -Specify one of three -options to produce a document containing the images +.IR FILE . +You can specify the form of the output file, as in +. +.EX +texexec --listing --pdf readme.now +.EE +. +.IP +which produces a PDF file called +.IR \%texexec.pdf . +Without the +.B \-\-pdf +flag, +.B \%texexec +produces a DVI file. +. +.IP +See also +.B \%\-\-backspace +and +.BR \%\-\-topspace . +. +.TP +.B \-\-module +Create documentation for +.BR ConTeXt , +.B MetaPost +(see +.BR mpost (1)), +and Perl modules. +Converts the documentation to +.B ConTeXt +format and then typesets that documentation. +See +.BR \%texutil (1) +for more information about the format of the documentation strings. +. +. +.SS "Process METAPOST Figures" +. +.TP +.B \-\-mpformat +The name of a +.B MetaPost +format file. +. +.TP +.B \-\-mptex +Strip out and typeset TeX code embedded in a +.B MetaPost +file. +. +.TP +.B \-\-nomp +Do not run +.BR MetaPost , +even if needed. +. +.TP +.B \-\-nomprun +Do not run +.BR mpost (1) +on embedded +.B MetaPost +code. +. +. +.SS "Producing Proof Sheets of Figures" +. +.TP +.BI \-\-figures= ALTERNATIVE +Specify one of three options to produce a document containing the images used in the source file: -.IP -.RS -.IP "\fBa\fP" -A proof sheet with additional -information provided for each figure -.IP "\fBb\fP" -A proof sheet with the graphics only -.IP "\fBc\fP" -One figure per page, with the page -clipped to the bounding box of the -figure -.IP -See also \fB--paperoffset\fP, -which allows you to specify an offset to be added to -the page, as in -.IP -.EX -\f(CWtexexec --figures=c --paperoffset=\&.5cm *\&.pdf -*\&.png *\&.jpg\fP -.EE -.IP -.RE -.IP -\fBtexexec\fP uses \fBtexutil\fP(1) to obtain the list -of figures to process\&. -.PP -.SH "USAGE" -.PP -.IP o -Each \fBConTeXt\fP user interface (language) has its own format\&. The -following command generates two formats, one using the English -interface for typesetting in English, and one for Dutch: -.IP -.EX -\f(CWtexexec --make en nl\fP -.EE -.IP -By default, the language used for typesetting matches the -user-interface language (set with -\fB--interface\fP\&. It\'s possible to use one -language for typesetting and another for messages by changing the -relevant settings in \fIcont-usr\&.tex\fP, but these languages can -also be changed on the command line with a command such as -.IP -.RS -\f(CWtexexec --make --language=pl,cz,sk --bodyfont=plr en\fP -.RE -.IP -That command generates a \fBConTeXt\fP format file with an English user -interface, and the main language set to Polish (\fBpl\fP)\&. The -default body font is the Polish version of Computer Modern Roman -(\fBplr\fP)\&. Czech and Slovak hyphenation patterns are also loaded -so that Czech and Slovak text included in a source file will be -typeset properly (\fBcz\fP and \fBsk\fP)\&. -.IP o -When the appropriate formats are present, a file can be typeset -by typing -.IP -.EX -\f(CWtexexec test\fP -.EE -.IP -\fBtexexec\fP tries to determine what interface it should use to -typeset \fItest\&.tex\fP by looking for a line such as -.IP -.EX -\f(CW% interface=en tex=pdfetex output=pdftex\fP -.EE -.IP -at the top of the file (i\&.e\&., on the very first line)\&. This line is -equivalent to \fBTeX\fP\'s format line, ``&\fIFORMAT\fP\'\')\&. -.IP -By default, \fBtexexec\fP will produce a DVI file\&. The -\fB--pdf\fP flag tells \fBtexexec\fP to produce a PDF -file, instead (by running \fBpdftex\fP(1))\&. You can also be more -specific about what drivers \fBtexexec\fP should use, by specifying a -command line such as -.IP -.EX -\f(CWtexexec --output=dvips,acrobat test\fP -.EE -.IP -which specifies the use of the \fBdvips\fP driver (which is the -default), combined with the use of Acrobat-specific PDF instructions\&. -.IP -After an error-free run, \fBtexexec\fP will run \fBtexutil\fP(1) to -determine whether additional runs of \fBtex\fP(1) (or -\fBpdftex\fP(1)) or any utility programs (e\&.g\&., \fBbibtex\fP(1), -\fBmakeindex\fP(1)) are necessary\&. You can suppress these -additional runs by specifying the \fB--once\fP or -\fB--runs\fP flags: -.IP -.EX -\f(CWtexexec --once test\fP -\f(CWtexexec --runs=2 test\fP -.EE -.IP -.SH "INITIALIZATION" -.IP -When starting, \fBtexexec\fP first looks for the file -\fItexexec\&.ini\fP, which specifies the location of various -programs and configuration files, and specifies the programs to use\&. -The \fB--verbose\fP flag causes \fBtexexec\fP to print -the information in \fItexexec\&.ini\fP to the terminal and the log -file\&. -.IP -\fBtexexec\fP requires Perl\&. On Unix and Unix-like systems, no special -steps have to be taken to get \fBtexexec\fP to work beyond installing -Perl and having the \fBperl\fP(1) binary in your path\&. On Windows -systems, however, you may need to run Perl by typing commands such as -``\f(CWperl texexec\&.pl optvar(ARGS)\fP\'\'\&. -.IP -The \fBfpTeX\fP distribution comes with a program called -\fBrunperl\&.exe\fP that can be copied and renamed to \fBtexexec\&.exe\fP\&. -You will also have to rename a copy to \fBtexutil\&.exe\fP (see -\fBtexutil\fP(1))\&. The \fBteTeX\fP and \fBfpTeX\fP distributions, at -least, should perform the necessary steps as part of their -installation sequence -- if you have problems, however, you may need -to follow the advice given here\&. -.IP -The file \fItexexec\&.rme\fP contains default configuration -information\&. If no file \fItexexec\&.ini\fP exists (in -\fITEXMF/context/config/\fP, you should copy \fItexexec\&.rme\fP -to that directory and rename it to \fItexexec\&.ini\fP\&. Make any -necessary changes to this file to reflect the layout of programs and -directories on your system\&. -.SH "ENCODINGS" -.IP +. +.RS +.TP +.B a +A proof sheet with additional information provided for each figure. +.TP +.B b +A proof sheet with the graphics only. +.TP +.B c +One figure per page, with the page clipped to the bounding box of the +figure. +.IP +See also +.BR \%\-\-paperoffset , +which allows you to specify an offset to be added to the page, as in +. +.EX +texexec \-\-figures=c \-\-paperoffset=.5cm *.pdf \e + *.png *.jpg +.EE +. +.RE +.IP +.B \%texexec +uses +.BR \%texutil (1) +to obtain the list of figures to process. +. +. +.SH "USAGE" +. +.IP o +Each +.B ConTeXt +user interface (language) has its own format. +The following command generates two formats, one using the English interface +for typesetting in English, and one for Dutch: +. +.EX +texexec --make en nl +.EE +. +.IP +By default, the language used for typesetting matches the user-interface +language (set with +.BR \%\-\-interface ). +It is possible to use one language for typesetting and another for messages +by changing the relevant settings in +.IR \%cont\-usr.tex , +but these languages can also be changed on the command line with a command +such as +. +.EX +texexec --make --language=pl,cz,sk --bodyfont=plr en +.EE +. +.IP +That command generates a +.B ConTeXt +format file with an English user interface, and the main language set to +Polish +.RB ( pl ). +The default body font is the Polish version of Computer Modern Roman +.RB ( plr ). +Czech and Slovak hyphenation patterns are also loaded so that Czech and +Slovak text included in a source file are typeset properly +.RB ( cz +and +.BR sk ). +. +.IP o +When the appropriate formats are present, a file can be typeset by typing +. +.EX +texexec test +.EE +. +.IP +.B \%texexec +tries to determine what interface it should use to typeset +.I \%test.tex +by looking for a line such as +. +.EX +% interface=en tex=pdfetex output=pdftex +.EE +. +.IP +at the top of the file (i.e., on the very first line). +This line is equivalent to +.BR TeX 's +format line, +.RI ` FORMAT '). +. +.IP +By default, +.B \%texexec +produces a DVI file. +The +.B \-\-pdf +flag tells +.B \%texexec +to produce a PDF file instead (by running +.BR pdftex (1)). +You can also be more specific about what drivers +.B \%texexec +should use, by specifying a command line such as +. +.EX +texexec --output=dvips,acrobat test +.EE +. +.IP +which specifies the use of the +.B dvips +driver (which is the default), combined with the use of Acrobat-specific PDF +instructions. +.IP +After an error-free run, +.B \%texexec +executes +.BR \%texutil (1) +to determine whether additional runs of +.BR tex (1) +(or +.BR \%pdftex (1)) +or any utility programs (e.g., +.BR \%bibtex (1) +or +.BR \%makeindex (1)) +are necessary. +You can suppress these additional runs by specifying the +.B \-\-once +or +.B \-\-runs +flags: +. +.EX +texexec --once test +texexec --runs=2 test +.EE +. +. +.SH INITIALIZATION +. +When starting, +.B \%texexec +first looks for the file +.IR \%texexec.ini , +which specifies the location of various programs and configuration files, +and specifies the programs to use. +The +.B \%\-\-verbose +flag causes +.B \%texexec +to print the information in +.I \%texexec.ini +to the terminal and the log file. +. +.P +.B \%texexec +requires Perl. +On Unix and Unix-like systems, no special steps have to be taken to get +.B \%texexec +to work beyond installing Perl and having the +.BR perl (1) +binary in your path. +On Windows systems, however, you may need to run Perl by typing commands such as +. +.EX +perl texexec.pl optvar(ARGS)... +.EE +. +.P +The +.B fpTeX +distribution comes with a program called +.B \%runperl.exe +that can be copied and renamed to +.BR \%texexec.exe . +You also have to rename a copy to +.B \%texutil.exe +(see +.BR texutil (1)). +The +.B teTeX +and +.B fpTeX +distributions, at least, should perform the necessary steps as part of their +installation sequence \(en if you have problems, however, you may need to +follow the advice given here. +. +.P +The file +.I \%texexec.rme +contains default configuration information. +If no file +.I \%texexec.ini +exists (in +.IR TEXMF/context/config/ , +you should copy +.I \%texexec.rme +to that directory and rename it to +.IR \%texexec.ini . +Make any necessary changes to this file to reflect the layout of programs +and directories on your system. +. +. +.SH ENCODINGS +. Some languages require specific character encodings to represent their -alphabets (beyond the basic ASCII encoding)\&. Although you can use TeX -commands to represent these characters, such as ``\f(CW\e\&.z\fP\'\', it\'s -easier to use a text editor that includes direct support for these -characters and let \fBConTeXt\fP translate them to the necessary TeX -commands\&. For some languages, this approach can also improve the -performance of TeX\'s hyphenation algorithms\&. -.IP -\fBConTeXt\fP supports several of the most commonly used encodings\&. -Check the files beginning with \fIenco-\fP, \fIlang-\fP, and -\fIfont-\fP in the \fBConTeXt\fP distribution for more information\&. -.IP -\fBweb2c\fP distributions (such as \fBteTeX\fP) support a mechanism to -map document encodings to \fBConTeXt\fP\'s internal encoding, font -encodings, and hyphenation patterns\&. \fBtexexec\fP provides a document -option and a command-line flag to pass the necessary information to -\fBtex\fP(1) or \fBpdftex\fP(1)\&. You can add lines such as -.IP -.EX -\f(CW%& --translate-file=cp1250pl\fP -.EE +alphabets (beyond the basic ASCII encoding). +Although you can use TeX commands to represent these characters, such as +`\f(CW\e.z\fP', it is easier to use a text editor that includes direct +support for these characters and let +.B ConTeXt +translate them to the necessary TeX commands. +For some languages, this approach can also improve the performance of TeX's +hyphenation algorithms. +. +.P +.B ConTeXt +supports several of the most commonly used encodings. +Check the files beginning with +.IR enco\- , +.IR lang\- , +and +.I font\- +in the +.B ConTeXt +distribution for more information. +. +.P +.B web2c +distributions (such as +.BR teTeX ) +support a mechanism to map document encodings to +.BR ConTeXt 's +internal encoding, font encodings, and hyphenation patterns. +.B \%texexec +provides a document option and a command-line flag to pass the necessary +information to +.BR tex (1) +or +.BR \%pdftex (1). +You can add lines such as +. +.EX +%& \-\-translate\-file=cp1250pl +.EE +. +.P or -.IP -.EX -\f(CW% --translate=cp1250pl\fP -.EE -.IP -to the beginning of your document, or specify the \fB--translate\fP -flag on the command line, as -.IP -.EX -\f(CWtexexec --translate=il2pl somefile\fP -.EE -.IP -Note that using language-specific encodings will make your file less -portable than using ASCII\&. It may not be possible for other people to -typeset your documents on their systems\&. -.SH "FILES" -.IP -.IP "\fITEXMF/context/config/texexec\&.ini\fP" -TeXExec configuration file -.IP "\fITEXMF/context/config/texexec\&.rme\fP" -TeXExec configuration file defaults -.IP -.SH "SEE ALSO" -.IP -\fBbibtex\fP(1), \fBdvips\fP(1), \fBfmtutil\fP(1), -\fBmakeindex\fP(1), \fBmetapost\fP(1), \fBmpost\fP(1), -\fBpdfetex\fP(1), \fBpdfmerge\fP(1), \fBpdftex\fP(1), -\fBperl\fP(1), \fBpsnup\fP(1), \fBtex\fP(1), \fBtexshow\fP(1), -\fBtexutil\fP(1)\&. -.IP -The TeXExec manual, \fImtexexec\&.pdf\fP\&. -.IP +. +.EX +% \-\-translate=cp1250pl +.EE +. +.P +to the beginning of your document, or specify the +.B \%\-\-translate +flag on the command line, as in +. +.EX +texexec \-\-translate=il2pl somefile +.EE +. +.P +Note that using language-specific encodings makes your file less portable +than using ASCII. +It may not be possible for other people to typeset your documents on their +systems. +. +. +.SH FILES +. +.TP +.I TEXMF/context/config/texexec.ini +TeXExec configuration file. +.TP +.I TEXMF/context/config/texexec.rme +TeXExec configuration file defaults. +. +. +. +.SH "SEE ALSO" +. +.BR \%bibtex (1), +.BR dvips (1), +.BR \%fmtutil (1), +.BR \%makeindex (1), +.BR \%metapost (1), +.BR mpost (1), +.BR \%pdfetex (1), +.BR \%pdfmerge (1), +.BR \%pdftex (1), +.BR perl (1), +.BR psnup (1), +.BR tex (1), +.BR \%texshow (1), +.BR \%texutil (1). +. +.P +The TeXExec manual, +.IR mtexexec.pdf . +. +.P The TeXExec configuration README files: -.IP o -\fITEXMF/context/config/texexec\&.rme\fP -.IP o -\fITEXMF/context/perltk/texexec\&.rme\fP -.IP -Donald E\&. Knuth\'s \fIThe TeXbook\fP\&. -.SH "AUTHOR" -.IP -This manpage was written by Tobias Burnus -<burnus@gmx\&.de> and C\&.M\&. Connelly -<c@eskimo\&.com>\&. It is based on -the \fBTeXExec\fP manual written by Hans Hagen -<pragma@wxs\&.nl>\&. -.IP -The PDF manual and \fBtexexec\fP itself can be obtained from -<http://www\&.pragma-ade\&.com/pragma-ade/texexec\&.htm> +.IP o +.I TEXMF/context/config/texexec.rme +.IP o +.I TEXMF/context/perltk/texexec.rme +. +.P +Donald E.\& Knuth's +.IR "The TeXbook" . +. +. +.SH AUTHOR +. +This manpage was written by Tobias Burnus <burnus@gmx.de> and C.M.\& +Connelly <c@eskimo\&.com>, revised by Werner Lemberg <wl@gnu.org>. +It is based on the +.B TeXExec +manual written by Hans Hagen <pragma@wxs.nl>. It is in the public domain. +. +.P +The PDF manual and +.B \%texexec +itself can be obtained from +.RS +.P +http://www.pragma-ade.com/pragma-ade/texexec.htm +. +.\" end of mptopdf.1 |