summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-07-21 21:26:51 +0000
committerKarl Berry <karl@freefriends.org>2006-07-21 21:26:51 +0000
commitfe0b11acdb1182a4e0a4068d1876666f270752e8 (patch)
treecbe0cbf3044975928c25721e1eba229e7aaefef4 /Master
parent4ce3a2ae374c06418c4a5d48fb8f9ff3f8d549c6 (diff)
texexec.1 man page update from Werner.
git-svn-id: svn://tug.org/texlive/trunk@1889 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf/doc/man/man1/texexec.11466
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