diff options
| author | Karl Berry <karl@freefriends.org> | 2007-01-14 18:01:06 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2007-01-14 18:01:06 +0000 |
| commit | ac3f914804a6959e3b6a304d275a0376337083d7 (patch) | |
| tree | 8898610cb087af149d880b48a7b5615b8b432d7b /Master/texmf/doc/man | |
| parent | 5b0f67e0123dc2452238e374c3538c76651c20aa (diff) | |
man page update
git-svn-id: svn://tug.org/texlive/trunk@3467 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
71 files changed, 2535 insertions, 2092 deletions
diff --git a/Master/texmf/doc/man/man1/amstex.1 b/Master/texmf/doc/man/man1/amstex.1 index 68697a02901..2c0e4f37122 100644 --- a/Master/texmf/doc/man/man1/amstex.1 +++ b/Master/texmf/doc/man/man1/amstex.1 @@ -1,4 +1,4 @@ -.TH AMSTEX 1 "27 December 1992" "Web2C 7.5.5" +.TH AMSTEX 1 "27 December 1992" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/bibtex.1 b/Master/texmf/doc/man/man1/bibtex.1 index 4be5efd8bb5..e75b55d90b2 100644 --- a/Master/texmf/doc/man/man1/bibtex.1 +++ b/Master/texmf/doc/man/man1/bibtex.1 @@ -1,4 +1,4 @@ -.TH BIBTEX 1 "24 November 1994" "Web2C 7.5.5" +.TH BIBTEX 1 "8 January 2007" "bibtex 0.99c" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/cfftot1.1 b/Master/texmf/doc/man/man1/cfftot1.1 index dbe0512c1da..0917c946fb3 100644 --- a/Master/texmf/doc/man/man1/cfftot1.1 +++ b/Master/texmf/doc/man/man1/cfftot1.1 @@ -1,4 +1,4 @@ -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -84,4 +84,4 @@ and #5177, Version 1.4 ' .SH AUTHOR -Eddie Kohler (kohler@icir.org) +Eddie Kohler (kohler@cs.ucla.edu) diff --git a/Master/texmf/doc/man/man1/ctxtools.1 b/Master/texmf/doc/man/man1/ctxtools.1 new file mode 100644 index 00000000000..eb6d703a544 --- /dev/null +++ b/Master/texmf/doc/man/man1/ctxtools.1 @@ -0,0 +1,89 @@ +.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 +.. +.TH CTXTOOLS "1" "January 2007" "ctxtools 1.3.3" "ConTeXt" + +.SH NAME +ctxtools \- clean up temporary ConTeXt files, install latest ConTeXt + +.SH "SYNOPSIS" +\fBctxtools\fP [ \fIOPTION\fP ... ] + +.SH DESCRIPTION +\fBctxtools\fP is useful for dealing with ConTeXt source and generated +files and for installing new versions of ConTeXt. + +.SH "OPTIONS" +.TP +.B --help +Print the available options. +.TP +.B --purgefiles +Get rid of many temporary files generated by ConTeXt. You can give the +.B --all +option to remove a larger fraction of those files, +and the +.B --recurse +option to remove these files also in subdirectories. +.TP +.B --contextversion +Show the date of the ConTeXt macros and the format file. Useful after +upgrading ConTeXt (perhaps using \fB--updatecontext\fP) to check +whether the new formats and macros are visible to the TeX path +searches (see +.BR kpsewhich (1). +.TP +.B --updatecontext +Download the latest ConTeXt distribution and install it in the +TEXMFLOCAL tree (see +.BR kpsewhich (1) +for information on +TeX path searching). TEXMFLOCAL usually points to a system-wide +location. If you want to install the new ConTeXt in your home +directory (i.e. an install for one user), then set the TEXMFLOCAL +environment variable while running +.BR ctxtools . +For example, using the syntax of the Bourne shell +.BR sh (1): +.EX +TEXMFLOCAL=$HOME/texmf ctxtools --updatecontext +.EE +.TP +.B --documentation +Generate a \fI.ted\fP file from the source file. See also the +\fB--module\fP option to +.BR texexec (1). +.TP +\fB--patternfiles\fP [languagecode] +Generate pattern files. You can also give the +\fB--all\fP, \fB--xml\fP, and \fB--utf8\fP options. + +.SH "ENVIRONMENT" +.TP +TEXMFLOCAL +Used by \f(CW--updatecontext\fP to decide where to install the distribution. + +.SH "SEE ALSO" +.IP \(bu +.BR texexec (1), +.BR texmfstart (1). +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH BUGS +This manual page is not complete. + +.SH "AUTHOR" +This manual page was written by Sanjoy Mahajan <sanjoy@mit.edu>. It is in +the public domain. diff --git a/Master/texmf/doc/man/man1/cweb.1 b/Master/texmf/doc/man/man1/cweb.1 index ad41c427ead..295ceafbf1e 100644 --- a/Master/texmf/doc/man/man1/cweb.1 +++ b/Master/texmf/doc/man/man1/cweb.1 @@ -1,4 +1,4 @@ -.TH CWEB 1L 2002-Apr-13 +.TH CWEB 1 "19 December 2004" "Web2C 7.5.6" . .SH NAME ctangle, cweave \- translate CWEB to C and/or TeX @@ -99,21 +99,16 @@ and similar programs. means omit the index and table of contents. . .SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. .TP -/usr/local/lib/tex/inputs/cwebmac.tex +.I cwebmac.tex TeX macros used by cweave output. .TP -/usr/local/src/cweb/cwebman.tex +.I cwebman.tex The user manual. -.TP -/usr/local/src/cweb/examples/wc.w -An introductory example. -.TP -/usr/local/src/cweb/examples/wmerge.w -Patch program based on CWEB-style change files. -.TP -/usr/local/lib/cweb -Directory for cweb "include" files. . .SH "SEE ALSO" .TP diff --git a/Master/texmf/doc/man/man1/dmp.1 b/Master/texmf/doc/man/man1/dmp.1 index 69f54d4040b..a3c9900cfb2 100644 --- a/Master/texmf/doc/man/man1/dmp.1 +++ b/Master/texmf/doc/man/man1/dmp.1 @@ -1,4 +1,4 @@ -.TH DMP 1 "4 January 1998" "Web2C 7.5.5" +.TH DMP 1 "4 January 1998" "Web2C 7.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/dvicopy.1 b/Master/texmf/doc/man/man1/dvicopy.1 index cd62db37463..3ae24bfeba3 100644 --- a/Master/texmf/doc/man/man1/dvicopy.1 +++ b/Master/texmf/doc/man/man1/dvicopy.1 @@ -1,4 +1,4 @@ -.TH DVICOPY 1 TeX "24 January 1999" "Web2C 7.5.5" +.TH DVICOPY 1 TeX "24 January 1999" "Web2C 7.5.6" .SH NAME dvicopy \- produce modified copy of DVI file .SH SYNOPSIS diff --git a/Master/texmf/doc/man/man1/dvipng.1 b/Master/texmf/doc/man/man1/dvipng.1 index a0862bd5abe..bac4c46d888 100644 --- a/Master/texmf/doc/man/man1/dvipng.1 +++ b/Master/texmf/doc/man/man1/dvipng.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -25,11 +25,11 @@ .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2005-04-04" "dvipng 1.6" "User commands" +.TH DVIPNG 1 "2006-11-07" "dvipng 1.9" "User commands" .SH "NAME" dvipng \- A DVI\-to\-PNG translator .SH "SYNOPSIS" @@ -147,23 +147,22 @@ If \s-1GIF\s0 support is enabled, \s-1GIF\s0 output is chosen by using the .PP The benefits of \fBdvipng\fR/\fBdvigif\fR include .IP "\(bu" 4 -Speed. It is a very fast bitmap-rendering code for \s-1DVI\s0 files. On a -fairly low-end laptop, it takes less than a second to generate 150 -one-formula images. This makes dvipng suitable for generating large -amounts of images on\-the\-fly, as needed in preview\-latex, WeBWorK and -others. +Speed. It is a very fast bitmap-rendering code for \s-1DVI\s0 files, which +makes it suitable for generating large amounts of images on\-the\-fly, +as needed in preview\-latex, WeBWorK and others. .IP "\(bu" 4 It does not read the postamble, so it can be started before TeX -finishes. There is a \-\-follow switch that makes dvipng wait at \s-1EOF\s0 for -further output, unless it finds the \s-1POST\s0 marker that indicates the end -of the \s-1DVI\s0. +finishes. There is a \fB\-\-follow\fR switch that makes dvipng wait at +end-of-file for further output, unless it finds the \s-1POST\s0 marker that +indicates the end of the \s-1DVI\s0. .IP "\(bu" 4 Interactive query of options. dvipng can read options interactively through stdin, and all options are usable. It is even possible to change the input file through this interface. .IP "\(bu" 4 -Supports \s-1PK\s0, \s-1VF\s0, PostScript Type1, and TrueType fonts, color specials -and simple PostScript inclusion specials. +Supports \s-1PK\s0, \s-1VF\s0, PostScript Type1, and TrueType fonts, subfonts (i.e., +as used in CJK\-LaTeX), color specials, and inclusion of PostScript, +\&\s-1PNG\s0, \s-1JPEG\s0 or \s-1GIF\s0 images. .IP "\(bu" 4 and more... .SH "OPTIONS" @@ -218,7 +217,7 @@ both variants will use the latter behaviour. .IP "\fB\-d\fR \fInum\fR" 4 .IX Item "-d num" Set the debug flags, showing what dvipng (thinks it) is doing. This will -work unless dvipng has been compiled without the \fB\s-1DEBUG\s0\fR option +work unless dvipng has been compiled without the \f(CW\*(C`DEBUG\*(C'\fR option (not recommended). Set the flags as you need them, use \fB\-d \-1\fR as the first option for maximum output. .IP "\fB\-D\fR \fInum\fR" 4 @@ -231,7 +230,7 @@ a web page), and for a text font height of \fIfont_px\fR pixels (in Mozilla) the correct formula is .Sp .Vb 1 -\& <dpi> = <font_px> * 72.27 / 10 [px * TeXpt/in / TeXpt] +\& <dpi> = <font_px> * 72.27 / 10 [px * TeXpt/in / TeXpt] .Ve .Sp The last division by ten is due to the standard font height 10pt in @@ -241,21 +240,21 @@ have to rescale that to pixels, using the screen resolution (default is usually 96 dpi) which means the formula is .Sp .Vb 1 -\& <font_px> = <font_pt> * 96 / 72 [pt * px/in / (pt/in)] +\& <font_px> = <font_pt> * 96 / 72 [pt * px/in / (pt/in)] .Ve .Sp On some high-res screens, the value is instead 120 dpi. Good luck! .IP "\fB\-\-depth*\fR" 4 .IX Item "--depth*" Report the depth of the image. This only works reliably when the -LaTeX style \fBpreview.sty\fR from preview-latex is used. It +LaTeX style \fIpreview.sty\fR from preview-latex is used. It reports the number of pixels from the bottom of the image to the baseline of the image. This can be used for vertical positioning of the image in, e.g., web documents, where one would use (Cascading StyleSheets 1) .Sp .Vb 1 -\& <IMG SRC="<filename.png>" STYLE="vertical\-align: \-<depth>px"> +\& <IMG SRC="<filename.png>" STYLE="vertical\-align: \-<depth>px"> .Ve .Sp The depth is a negative offset in this case, so the minus sign is @@ -271,11 +270,11 @@ there is a foreground color \especial in the \s-1DVI\s0. The color spec should be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. .IP "\fB\-\-follow*\fR" 4 .IX Item "--follow*" -Enable follow mode. One of the benefits of dvipng is that it does not -read the postamble, so it can be started before TeX finishes. This -switch makes dvipng wait at \s-1EOF\s0 for further output, unless it finds the -\&\s-1POST\s0 marker that indicates the end of the \s-1DVI\s0. This is similar to -\&\fBtail \-f\fR but for DVI-to-PNG conversion. +Wait for data at end\-of\-file. One of the benefits of dvipng is that it +does not read the postamble, so it can be started before TeX +finishes. This switch makes dvipng wait at end-of-file for further +output, unless it finds the \s-1POST\s0 marker that indicates the end of the +\&\s-1DVI\s0. This is similar to \fBtail \-f\fR but for DVI-to-PNG conversion. .IP "\fB\-\-freetype*\fR" 4 .IX Item "--freetype*" Enable/disable FreeType font rendering (default on). This option is @@ -297,17 +296,19 @@ fonts will be lighter (more like the background), and for \fInum\fR > 1, the fonts will be darker (more like the foreground). .IP "\fB\-\-gif*\fR" 4 .IX Item "--gif*" -The images are output in the \s-1GIF\s0 format, if \s-1GIF\s0 support is -enabled. This is the default for the \fBdvigif\fR binary, which only -will be available when \s-1GIF\s0 support is enabled. See also the -\&\fB\-\-png\fR option. +The images are output in the \s-1GIF\s0 format, if \s-1GIF\s0 support is enabled. +This is the default for the \fBdvigif\fR binary, which only will be +available when \s-1GIF\s0 support is enabled. \s-1GIF\s0 images are palette images +(see the \fB\-\-palette\fR option) and does not support true alpha +channels (see the \fB\-\-bg\fR option). See also the \fB\-\-png\fR +option. .IP "\fB\-\-height*\fR" 4 .IX Item "--height*" Report the height of the image. This only works reliably when the -LaTeX style \fBpreview.sty\fR from preview-latex is used. It +LaTeX style \fIpreview.sty\fR from preview-latex is used. It reports the number of pixels from the top of the image to the baseline of the image. The total height of the image is obtained as the -sum of the values reported from \-\-height and the \-\-depth. +sum of the values reported from \fB\-\-height\fR and \fB\-\-depth\fR. .IP "\fB\-l [=]\fR\fInum\fR" 4 .IX Item "-l [=]num" The last page printed will be the first one numbered \fInum\fR. Default @@ -337,7 +338,7 @@ PostScript specials. \fB\-\-noghostscript0\fR turns the call back on. .IX Item "--nogssafer*" Normally, if GhostScript is used to render PostScript specials, the GhostScript interpreter is run with the option \fB\-dSAFER\fR. The -\&\fB\-nogssafer\fR option runs GhostScript without \fB\-dSAFER\fR. The +\&\fB\-\-nogssafer\fR option runs GhostScript without \fB\-dSAFER\fR. The \&\fB\-dSAFER\fR option in Ghostscript disables PostScript operators such as deletefile, to prevent possibly malicious PostScript programs from having any effect. @@ -364,6 +365,16 @@ specified) is treated as a physical (absolute) page number, rather than a value to compare with the TeX \fB\ecount0\fR values stored in the \&\s-1DVI\s0 file. Thus, using \fB\-p =3\fR will start with the third page of the document, no matter what the pages are actually numbered. +.IP "\fB\-\-palette*\fR" 4 +.IX Item "--palette*" +Starting from \fBdvipng\fR 1.8, the output \s-1PNG\s0 will be a truecolor +png when an external image is included, to avoid unnecessary delay and +quality reduction, and enable the \s-1EPS\s0 translator to draw on a +transparent background and outside of the boundingbox. This switch +will force palette (256\-color) output and make \fBdvipng\fR revert to +the old behaviour, where included images were opaque and always +clipped to the boundingbox. This will also override the +\&\fB\-\-truecolor\fR switch if present. .IP "\fB\-\-picky*\fR" 4 .IX Item "--picky*" No images are output when a warning occurs. Normally, dvipng will @@ -403,14 +414,21 @@ output; report no warnings (only errors) to standard error. .IP "\fB\-Q\fR \fInum\fR" 4 .IX Item "-Q num" Set the quality to \fInum\fR. That is, choose the number of antialiasing -levels for \s-1PK\s0 and T1lib rendering to be \fInum\fR*\fInum\fR. The default -value is 4 which gives 16 levels of antialiasing for antialiased fonts +levels for \s-1PK\s0 and T1lib rendering to be \fInum\fR*\fInum\fR+1. The default +value is 4 which gives 17 levels of antialiasing for antialiased fonts from these two. If FreeType is available, its rendering is unaffected by this option. .IP "\fB\-r*\fR" 4 .IX Item "-r*" Toggle output of pages in reverse/forward order. By default, the first page in the \s-1DVI\s0 is output first. +.IP "\fB\-\-strict*\fR" 4 +.IX Item "--strict*" +The program exits when a warning occurs. Normally, dvipng will output +an image in spite of a warning, but there may be something missing in +this image. One reason to use this option would be if you have a more +complete but slower fallback converter. See the \fB\-\-picky\fR option +above for a list of when warnings occur. .IP "\fB\-T\fR \fIimage_size\fR" 4 .IX Item "-T image_size" Set the image size to \fIimage_size\fR which can be either of @@ -421,7 +439,6 @@ and in addition the \s-1DVI\s0 origin, located 1in from the top and 1in from the left edge of the paper. This usually gives whitespace above and to the left in the produced image. The value \fBtight\fR will make dvipng only include all ink put on the page, producing neat images. -This option overrides any papersize special in the \s-1DVI\s0 file. .IP "\fB\-\-t1lib*\fR" 4 .IX Item "--t1lib*" Enable/disable T1lib font rendering (default on). This option is @@ -437,11 +454,11 @@ preferred by dvipng, and if you for some reason rather want to use T1lib, give the option \fB\-\-freetype0\fR (see above). .IP "\fB\-\-truecolor*\fR" 4 .IX Item "--truecolor*" -On systems with a fairly new \fBlibgd\fR, one can choose to generate -truecolor output. This will not be necessary in general unless you -include truecolor images via a PostScript special (i.e., the -\&\fBgraphics\fR or \fBgraphicx\fR package). It will lead to longer -execution time, mostly because more data is written to disk. +This will make \fBdvipng\fR generate truecolor output. Note that +truecolor output is automatic if you include an external image in your +\&\s-1DVI\s0, e.g., via a PostScript special (i.e., the \fBgraphics\fR or +\&\fBgraphicx\fR package). This switch is overridden by the +\&\fB\-\-palette\fR switch. .IP "\fB\-v*\fR" 4 .IX Item "-v*" Enable verbose operation. This will currently indicate what fonts is @@ -461,18 +478,18 @@ your \fBlibgd\fR is new enough. The default compression level is 1, which selects maximum speed at the price of slightly larger PNGs. For an older \fBlibgd\fR, the hard-soldered value 5 is used. The include file \&\fBpng.h\fR says -``Currently, valid values range from 0 \- 9, corresponding directly to -the zlib compression levels 0 \- 9 (0 \- no compression, 9 \- \*(L"maximal\*(R" +\&\*(L"Currently, valid values range from 0 \- 9, corresponding directly to +the zlib compression levels 0 \- 9 (0 \- no compression, 9 \- \*(R"maximal\*(L" compression). Note that tests have shown that zlib compression levels 3\-6 usually perform as well as level 9 for \s-1PNG\s0 images, and do considerably fewer calculations. In the future, these values may not -correspond directly to the zlib compression levels.'' +correspond directly to the zlib compression levels.\*(R" .SH "NOTES" .IX Header "NOTES" The full manual is accessible in the info format, on most systems by typing .PP .Vb 1 -\& info dvipng +\& info dvipng .Ve .SH "COPYRIGHT" .IX Header "COPYRIGHT" @@ -480,4 +497,4 @@ This program is released under the \s-1GNU\s0 General Public License, see the \&\s-1COPYING\s0 file in the dvipng distribution or <\fBhttp://www.gnu.org/licenses/gpl.html\fR>. .PP -Copyright (c) 2002\-2005 Jan\-Ake Larsson +Copyright (c) 2002\-2006 Jan-AAke Larsson diff --git a/Master/texmf/doc/man/man1/dvips.1 b/Master/texmf/doc/man/man1/dvips.1 index 1ff6e3f0e64..f95a933a95a 100644 --- a/Master/texmf/doc/man/man1/dvips.1 +++ b/Master/texmf/doc/man/man1/dvips.1 @@ -272,7 +272,8 @@ section below). .B -o name The output will be sent to file .I name -If no file name is given, the default name is +If no file name is given (i.e., -o is last on the command line), the +default name is .I file.ps where the .dvi file was called .IR file.dvi ; diff --git a/Master/texmf/doc/man/man1/dvitype.1 b/Master/texmf/doc/man/man1/dvitype.1 index a68e4f34ec3..d2172d13b64 100644 --- a/Master/texmf/doc/man/man1/dvitype.1 +++ b/Master/texmf/doc/man/man1/dvitype.1 @@ -1,4 +1,4 @@ -.TH DVITYPE 1 "19 December 1994" "Web2C 7.5.5" +.TH DVITYPE 1 "19 December 1994" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/eplain.1 b/Master/texmf/doc/man/man1/eplain.1 index ec798867b6d..90176f53dfc 100644 --- a/Master/texmf/doc/man/man1/eplain.1 +++ b/Master/texmf/doc/man/man1/eplain.1 @@ -1,4 +1,4 @@ -.TH EPLAIN 1 "14 December 1993" "Web2C 7.5.5" +.TH EPLAIN 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/etex.1 b/Master/texmf/doc/man/man1/etex.1 index 16277a606cc..0306184dd38 100644 --- a/Master/texmf/doc/man/man1/etex.1 +++ b/Master/texmf/doc/man/man1/etex.1 @@ -1,4 +1,4 @@ -.TH ETEX 1 "21 August 2004" "Web2C 7.5.5" +.TH ETEX 1 "7 January 2007" "pdftex 1.40" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 @@ -390,6 +390,10 @@ Predigested e-\*(TX format (.\|fmt) files. .br .\"===================================================================== .SH NOTES +Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX +extensions, so in this installation e\*(TX is just a symbolic link to +pdf\*(TX. See +.BR pdftex (1). This manual page is not meant to be exhaustive. The complete documentation for this version of e-\*(TX can be found in the info manual @@ -411,6 +415,7 @@ but when it does the generated file will be invalid. .\"===================================================================== .SH "SEE ALSO" +.BR pdftex (1), .BR tex (1), .BR mf (1). .\"===================================================================== diff --git a/Master/texmf/doc/man/man1/fdf2tex.1 b/Master/texmf/doc/man/man1/fdf2tex.1 index d306652f34a..5183aba95cb 100644 --- a/Master/texmf/doc/man/man1/fdf2tex.1 +++ b/Master/texmf/doc/man/man1/fdf2tex.1 @@ -1,4 +1,19 @@ -.TH FDF2TEX "1" "May 2004" "teTeX " "ConTeXt" +.TH FDF2TEX "1" "December 2006" "fdf2tex 1.02" "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 fdf2tex \- Convert PDF formular data (FDF) into something (Con)TeX(t) can handle @@ -11,21 +26,27 @@ handle .SH DESCRIPTION .PP Converts PDF formular data (FDF) into something (Con)TeX(t) can -handle. These commands are usually called indirectly during ConTeXt -file processing. +handle. This command is usually called indirectly during ConTeXt +file processing, so most users do not need to worry about it. .HP .SH "BUGS" .PP -Probably none - all errors are in this manpage +Probably none -- all errors are in this manpage .PP .SH "SEE ALSO" -.PP -\fBtexexec\fP(1)\&. -.PP -The TeXExec manual, \fImtexexec\&.pdf\fP\&. -.PP +.IP \(bu +\fBtexexec\fP(1). +.IP \(bu +The TeXExec manual, \fImtexexec.pdf\fP. +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + .SH "AUTHOR" -.IP -This manual page was written by Frank Küster <frank@kuesterei\&.ch>, -for the Debian GNU/Linux system\&. It may be used and modified by -others without contacting the author\&. + +This manual page was written by Frank Küster <frank@kuesterei.ch>, +for the Debian GNU/Linux system, and modified by Sanjoy Mahajan +<sanjoy@mit.edu>. It may be used and modified by others without +contacting the authors. + diff --git a/Master/texmf/doc/man/man1/getnonfreefonts-sys.1 b/Master/texmf/doc/man/man1/getnonfreefonts-sys.1 new file mode 100644 index 00000000000..b402933bfce --- /dev/null +++ b/Master/texmf/doc/man/man1/getnonfreefonts-sys.1 @@ -0,0 +1 @@ +.so man1/getnonfreefonts.1 diff --git a/Master/texmf/doc/man/man1/getnonfreefonts.1 b/Master/texmf/doc/man/man1/getnonfreefonts.1 index c7506d616d1..b15235f8524 100644 --- a/Master/texmf/doc/man/man1/getnonfreefonts.1 +++ b/Master/texmf/doc/man/man1/getnonfreefonts.1 @@ -1,182 +1,129 @@ -.TH getnonfreefonts 1 "October 2005" "TeXLive" "TeXLive" +.TH getnonfreefonts 1 "January 2007" "TeXLive" "TeXLive" .SH NAME getnonfreefonts \- download and install fonts which cannot be distributed on a CD .LP getnonfreefonts-sys \- download and install fonts system\-wide which cannot be distributed on a CD + .SH SYNOPSIS -.B getnonfreefonts -.RI -[options] [font] -.LP -.B getnonfreefonts-sys -.RI -[options] [font] + +.BI "getnonfreefonts [" options "] [" fontlist ] +.sp +.BI "getnonfreefonts-sys [" options "] [" fontlist ] + .SH DESCRIPTION Some font suppliers provided fonts which can be used freely but they disallow that money is charged for the distribution. Hence, for distributions on CD or DVD it is usually impossible to include these fonts. -.BI getnonfreefonts +.B "getnonfreefonts" is a script which downloads and installs these fonts. Actually, it first downloads the program -.BI getfont -from CTAN which is then executed. -.BI getfont +.BI "getfont"<year> +from tug.org which is then executed. +.BI "getfont"<year> does the real work. It will be updated occasionally to support more -fonts. +fonts. +.I <year> +denotes the TeXLive release. -.BI getnonfreefonts +.B getnonfreefonts and -.BI getnonfreefonts-sys +.B getnonfreefonts-sys are identical except that -.BI getnonfreefonts -installs files to -.RI $TEXMFHOME +.B getnonfreefonts +installs files to $TEXMFHOME while -.BI getnonfreefonts-sys -installs files to -.RI $TEXMFLOCAL -\. +.B getnonfreefonts-sys +installs files to $TEXMFLOCAL. -.BI getfont +.BI "getfont"<year> will not be installed permanently on your system. It only -exists while -.BI getnonfreefonts -is running. +exists in a temporary directory while .BI getnonfreefonts -passes all arguments to -.BI getfont. +is running. -If a font is specified, only this font will be installed, otherwise -all supported fonts will be installed. - -To get a list of supported fonts, run -.BI getnonfreefonts -.BI --lsfonts +Run +.B getnonfreefonts --lsfonts +to get a list of supported fonts. .SH OPTIONS -Only the options evaluated by -.BI getnonfreefonts -are described here. Run -.BI getnonfreefonts -.BI --help -to get a complete list. .TP -.B --ctan=<CTAN-node> +.BR "-a" , " --all" .rg -.B <CTAN-node> -can be either -.B -de -for ftp://ftp.dante.de (Hamburg, Germany), -.B -uk -for ftp://tex.ac.uk (Cambridge, UK), -or -.B us -for ftp://ctan.tug.org (Colchester, VT, US) - -The default is ftp://tex.ac.uk. +Install all fonts. .TP -.B --afm +.BR "-d" , " --debug" .rg -Install AFM files as well. They are not installed by default. You do -not need them if you don't know what they are good for. +Provide additional messages for debugging. These messages are sent to +STDERR. .TP -.B -n, --noinstall +.BR "-f" , " --force" .rg -Do not install anything. Useful to check whether fonts are available -which are not installed yet. - +Install fonts even if they are installed already. .TP -.B --shell +.BR "-h" , " --help" .rg -Run -.BI getnonfreefonts -in a shell. -.BI getfont -can be called directly and will exist on your system until you leave -the shell. If your internet connection is very slow, you can save some time. -Run -.BI getfont --help -first. - +Print a help message. Nothing is installed but the directories where +the fonts will be installed and the temporary directory are shown. +.BI "<" PID ">" +will be replaced by the process ID of the current +process. .TP -.B -h, --help +.BR "-l" , " --lsfonts" .rg -Get a complete list of options. This list will be more complete and -more up-to-date than this manual page. +List all available fonts and tell whether they are installed already. -.SH ENVIRONMENT -If the environt variable -.BI CTAN -is set to -.B ftp://<CTAN-node> -then this will be the default. The argument is an URL. - -.BI Example: -If your -.BI ~/.profile -contains the line -.BI CTAN=ftp://ftp.dante.de -then this will be the default. -If you are at a university which mirrors CTAN, you can set -.BI CTAN -to this mirror. It will work only if the mirror has the same -directory structure as CTAN, i.e if the directory -.BI tex-archive -is not omitted. - -.SH EXAMPLES .TP -.B getnonfreefonts --help +.B --sys .rg -Display all options and a list of supported fonts. Note that the -program -.B getfont -is installed temporarily and executed. You get more information than -this manual page can provide. - -.TP +If you call .B getnonfreefonts -.rg -Install all supported fonts which are not installed yet. +with the +.B --sys +option it behaves exactly like +.BR "getnonfreefonts-sys". .TP -.B getnonfreefonts utopia +.BR "-v" , " --verbose" .rg -Install Adobe Utopia if it is not installed yet. +Be more verbose. This option is only needed for debugging. .TP -.B getnonfreefonts --force --afm utopia +.BR "--version" .rg -Install Adobe Utopia and the corresponding AFM files even if Utopia is -already installed. - -.TP -.B getnonfreefonts --noinstall -.rg -No fonts will be installed. Instead you are told which fonts are -available and which of them are already installed. - -.TP -.B getnonfreefonts --shell -.rg -No fonts are installed. You'll get an interactive shell where you can -invoke -.BI getfont -manually. Run -.B getfont --help -first. +Print version number. +.SH ENVIRONMENT +One of the environment variables +.BR "TMP" , " TEMP" , +or +.B TMPDIR +must exist. They are used to determine where to put the temporary +files. The directory must exist and must be writable. +.B /tmp +will be used if none of the variables is defined. + +.SH REQUIREMENTS +Though this program is supposed to be used with +.B TeXLive +it might work with other TeX distributions too. The programs +.BR "wget" , +.BR "unzip" , +and +.B kpsewhich +have to be installed and a recent version of +.B updmap +is required which supports the +.B --enable +option. .SH BUGS Please send bug reports to Reinhard Kotucha <reinhard.kotucha@web.de>. diff --git a/Master/texmf/doc/man/man1/gftodvi.1 b/Master/texmf/doc/man/man1/gftodvi.1 index ae7f4c0e3b5..e5b750b4255 100644 --- a/Master/texmf/doc/man/man1/gftodvi.1 +++ b/Master/texmf/doc/man/man1/gftodvi.1 @@ -1,4 +1,4 @@ -.TH GFTODVI 1 "14 December 1993" "Web2C 7.5.5" +.TH GFTODVI 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/gftopk.1 b/Master/texmf/doc/man/man1/gftopk.1 index 38b2d1084d1..7afc50ea83a 100644 --- a/Master/texmf/doc/man/man1/gftopk.1 +++ b/Master/texmf/doc/man/man1/gftopk.1 @@ -1,4 +1,4 @@ -.TH GFTOPK 1 "14 December 1993" "Web2C 7.5.5" +.TH GFTOPK 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/gftype.1 b/Master/texmf/doc/man/man1/gftype.1 index 41a203badd1..fabc074d9b5 100644 --- a/Master/texmf/doc/man/man1/gftype.1 +++ b/Master/texmf/doc/man/man1/gftype.1 @@ -1,4 +1,4 @@ -.TH GFTYPE 1 "14 December 1993" "Web2C 7.5.5" +.TH GFTYPE 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/hbf2gf.1 b/Master/texmf/doc/man/man1/hbf2gf.1 index f36ae3c7cea..1fdff00cee1 100644 --- a/Master/texmf/doc/man/man1/hbf2gf.1 +++ b/Master/texmf/doc/man/man1/hbf2gf.1 @@ -1,6 +1,24 @@ .\" man page for hbf2gf -. -.TH HBF2GF 1 11-Aug-2005 "CJK Version 4.6.0" +.\" +.\" Copyright (C) 1994-2006 Werner Lemberg <wl@gnu.org> +.\" +.\" This program is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program in doc/COPYING; if not, write to the Free +.\" Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, +.\" MA 02110-1301 USA +.\" +. +.TH HBF2GF 1 17-Oct-2006 "CJK Version 4.7.0" .SH NAME hbf2gf \- convert a CJK bitmap font into subfonts usable by TeX and Omega. . @@ -157,7 +175,7 @@ file (which are all identical). .in +5m If .B ofm_file -is set to `yes' in the configuration file, +is set to \(oqyes\(cq in the configuration file, .C OFM and .C OVF @@ -200,8 +218,8 @@ the parameter of the configuration file. The last two characters (which are interpreted as the subfont number) are stripped to get the name for the configuration file (which must end with -`\c -.C \&.cfg '). +\(oq\c +.C \&.cfg \(cq). No job file will be created. If option .B -p @@ -215,12 +233,12 @@ is set, no file is created. The extension can be controlled with .BR -n ; -if set, the extension is `\c -.C \&.gf ', -otherwise `\c +if set, the extension is \(oq\c +.C \&.gf \(cq, +otherwise \(oq\c .C \&. <\c .IR resolution >\c -.C gf '. +.C gf \(cq. .B -q makes .B hbf2gf @@ -317,7 +335,7 @@ A keyword must start a line, otherwise the whole line will be ignored. If the word starting a line is not a keyword, the line will be ignored too. Empty lines will also be skipped. The search for keywords is case insensitive; in contrast, the arguments will -be taken exactly as given (except `yes' and `no' which can be written with +be taken exactly as given (except \(oqyes\(cq and \(oqno\(cq which can be written with uppercase or lowercase letters). Each keyword has one argument which must be separated by whitespace (blanks or tabs) from the keyword and must be on the same line. @@ -325,8 +343,8 @@ Each line must not be longer than 256 characters. .PP You can use environment variables in the configuration file. The escape character starting an environment variable in the configuration -file is always `\c -.C $ ', +file is always \(oq\c +.C $ \(cq, even for operating systems like DOS which has other conventions. .B hbf2gf recognizes only environment variable names which start with a letter or an @@ -334,14 +352,14 @@ underscore, followed by alphanumeric characters or underscores. You can surround the variable with braces to indicate where the variable name ends, for example .C ${FOO} . -To get a dollar sign you must write `\c -.C $$ '. +To get a dollar sign you must write \(oq\c +.C $$ \(cq. The expansion of environment variables in hbf2gf itself (without the help of either kpathsea, emtexdir, or MiKTeX searching routines) is very limited; this feature has been carried over from previous versions. It can't expand variables set in texmf.cnf; it also can't handle more than one directory as the variable's value. -.B Don't use it except for the `pk_directory' and `tfm_directory' +.B Don't use it except for the \(oqpk_directory\(cq and \(oqtfm_directory\(cq .B parameters! .PP This is the list of all necessary keywords: @@ -354,8 +372,8 @@ this file. .TP .B output_name The name stem of the output files. -A running two digit decimal number starting with `\c -.C 01 ' +A running two digit decimal number starting with \(oq\c +.C 01 \(cq will be appended. For Unicode fonts see the keyword .B unicode @@ -396,10 +414,10 @@ Only values in the range 0\ \(<=\ \fBslant\fP\ \(<=\ 1 are allowed. Default is\ 0.0. .TP .B rotation -If set to `yes', all glyphs will be rotated 90\ degrees counter-clockwise. +If set to \(oqyes\(cq, all glyphs will be rotated 90\ degrees counter-clockwise. The default offsets as given in the HBF header will be ignored (and set to\ 0). -Default is `no'. +Default is \(oqno\(cq. .TP .B mag_x .TQ @@ -424,9 +442,9 @@ The number of subfonts to create. Default value is -1 for creating all fonts. .TP .B unicode -If `yes', a two digit hexadecimal number will be used as a running number, +If \(oqyes\(cq, a two digit hexadecimal number will be used as a running number, starting with the value of the first byte of the first code range. -Default is `no'. +Default is \(oqno\(cq. .TP .B min_char The minimum value of the encoding. @@ -470,17 +488,17 @@ The batch file will not check whether this directory exists. .B pk_files Whether to create .C PK -files or not; default is `yes'. +files or not; default is \(oqyes\(cq. .TP .B tfm_files Whether to create .C TFM -files or not; default is `yes'. +files or not; default is \(oqyes\(cq. .TP .B ofm_file Whether to create an .C OPL -file or not; default is `no'. +file or not; default is \(oqno\(cq. The batch file will then use .B ovp2ovf of the Omega distribution to convert it into an @@ -493,17 +511,17 @@ The file simply maps all subfonts back to a single Omega font. .TP .B long_extension -If `yes', +If \(oqyes\(cq, .C PK files will include the resolution in the extension (e.g. .C gsso1201.300pk ). -This affects the batch file only (default is `yes'). +This affects the batch file only (default is \(oqyes\(cq). .TP .B rm_command -The shell command to remove files; default: `rm'. +The shell command to remove files; default: \(oqrm\(cq. .TP .B cp_command -The shell command to copy files; default: `cp'. +The shell command to copy files; default: \(oqcp\(cq. .TP .B job_extension The extension of the batch file which calls @@ -624,8 +642,8 @@ A similar but not identical method is to say .in +2m .C "kpsewhich -progname=hbf2gf -show-path='misc fonts'" .PP -[A full list of format types can be obtained by saying `\c -.C "kpsewhich --help" ' +[A full list of format types can be obtained by saying \(oq\c +.C "kpsewhich --help" \(cq on the command line prompt.] This is exactly the how .B hbf2gf @@ -657,8 +675,8 @@ Example: .in +2m .C HBFONTS=c:\\\\fonts\\\\hbf!!;d:\\\\myfonts\\\\hbf! .PP -Constructions like `\c -.C c:\\\\fonts!!\\\\hbf ' +Constructions like \(oq\c +.C c:\\\\fonts!!\\\\hbf \(cq aren't possible. . .SS MikTeX diff --git a/Master/texmf/doc/man/man1/kpseaccess.1 b/Master/texmf/doc/man/man1/kpseaccess.1 index 3ef9af6b2aa..a2111b4619b 100644 --- a/Master/texmf/doc/man/man1/kpseaccess.1 +++ b/Master/texmf/doc/man/man1/kpseaccess.1 @@ -1,4 +1,4 @@ -.TH KPSEACCESS 1 "4 January 1998" "Kpathsea 3.5.5" +.TH KPSEACCESS 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/kpsereadlink.1 b/Master/texmf/doc/man/man1/kpsereadlink.1 index 3a2e65ea0dc..882d87e8ccb 100644 --- a/Master/texmf/doc/man/man1/kpsereadlink.1 +++ b/Master/texmf/doc/man/man1/kpsereadlink.1 @@ -1,4 +1,4 @@ -.TH KPSEREADLINK 1 "4 January 1998" "Kpathsea 3.5.5" +.TH KPSEREADLINK 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .SH NAME kpsereadlink \- print contents of symbolic link diff --git a/Master/texmf/doc/man/man1/kpsestat.1 b/Master/texmf/doc/man/man1/kpsestat.1 index 5d4c7a2a54c..41f120f783a 100644 --- a/Master/texmf/doc/man/man1/kpsestat.1 +++ b/Master/texmf/doc/man/man1/kpsestat.1 @@ -1,4 +1,4 @@ -.TH KPSESTAT 1 "4 January 1998" "Kpathsea 3.5.5" +.TH KPSESTAT 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/kpsewhich.1 b/Master/texmf/doc/man/man1/kpsewhich.1 index 86ac0357676..29eb74ace0d 100644 --- a/Master/texmf/doc/man/man1/kpsewhich.1 +++ b/Master/texmf/doc/man/man1/kpsewhich.1 @@ -1,4 +1,4 @@ -.TH KPSEWHICH 1 "4 January 1998" "Kpathsea 3.5.5" +.TH KPSEWHICH 1 "7 January 2007" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost @@ -149,6 +149,7 @@ option to print the list. .rb Print the expansion of .IR variable . +.TP .B -version .rb Print version information and exit. diff --git a/Master/texmf/doc/man/man1/lacheck.1 b/Master/texmf/doc/man/man1/lacheck.1 index 9679e294e60..ace75e38f65 100644 --- a/Master/texmf/doc/man/man1/lacheck.1 +++ b/Master/texmf/doc/man/man1/lacheck.1 @@ -1,4 +1,4 @@ -.TH "LaCheck" "1" "10/26/05" "Release 1.26" +.TH "LaCheck" "1" "01/11/07" "Release 1.26" .SH NAME lacheck - A consistency checker for LaTeX documents. .SH SYNOPSIS diff --git a/Master/texmf/doc/man/man1/lambda.1 b/Master/texmf/doc/man/man1/lambda.1 index 29d0bbb1c10..8c6873db673 100644..120000 --- a/Master/texmf/doc/man/man1/lambda.1 +++ b/Master/texmf/doc/man/man1/lambda.1 @@ -1,292 +1 @@ -.TH OMEGA 1 "27 December 1997" "Web2C 7.5.5" -.\"===================================================================== -.if n .ds MF Metafont -.if t .ds MF M\s-2ETAFONT\s0 -.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP -.if n .ds TX TeX -.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff -.el .ds OX TeX for nroff -.\" the same but obliqued -.\" BX definition must follow TX so BX can use TX -.if t .ds BX \fRB\s-2IB\s0\fP\*(TX -.if n .ds BX BibTeX -.\" LX definition must follow TX so LX can use TX -.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX -.if n .ds LX LaTeX -.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX -.if n .ds AX AmSTeX -.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX -.if n .ds AY AmSLaTeX -.\"===================================================================== -.SH NAME -omega, iniomega, viromega \- extended unicode TeX -.SH SYNOPSIS -.B omega -.RI [ options ] -[\fB&\fR \fIformat\fR ] -[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] -.\"===================================================================== -.SH DESCRIPTION -Run the Omega typesetter on -.IR file , -usually creating -.IR file.dvi . -If the file argument has no extension, ".tex" will be appended to it. -Instead of a filename, a set of Omega commands can be given, the first -of which must start with a backslash. -With a -.BI & format -argument Omega uses a different set of precompiled commands, -contained in -.IR format.fmt ; -it is usually better to use the -.B -fmt -.I format -option instead. -.PP -Omega is a version of the \*(TX program modified for multilingual -typesetting. It uses unicode, and has additional primitives for -(among other things) bidirectional typesetting. -.PP -The -.B iniomega -and -.B viromega -commands are Omega's analogues to the -.B initex -and -.B virtex -commands. In this installation, they are symlinks to the -.B omega -executable. -.PP -Omega's command line options are similar to those of \*(TX. -.PP -Omega is experimental software. -.\"===================================================================== -.SH OPTIONS -This version of Omega understands the following command line options. -.TP -.BI --oft \ format -.rb -Use -.I format -as the name of the format to be used, instead of the name by which -Omega was called or a -.I %& -line. -.TP -.B -halt-on-error -.rb -Exit with an error code when an error is encountered during processing. -.TP -.B --help -.rb -Print help message and exit. -.TP -.B --ini -.rb -Be -.BR iniomega , -for dumping formats; this is implicitly true if the program is called -as -.BR iniomega . -.TP -.BI --interaction \ mode -.rb -Sets the interaction mode. The mode can be one of -.IR batchmode , -.IR nonstopmode , -.IR scrollmode , -and -.IR errorstopmode . -The meaning of these modes is the same as that of the corresponding -\ecommands. -.TP -.B --ipc -.rb -Send DVI output to a socket as well as the usual output file. Whether -this option is available is the choice of the installer. -.TP -.B --ipc-start -.rb -As -.BR --ipc , -and starts the server at the other end as well. Whether this option -is available is the choice of the installer. -.TP -.BI --kpathsea-debug \ bitmask -.rb -Sets path searching debugging flags according to the bitmask. See the -.I Kpathsea -manual for details. -.TP -.BI --maketex \ fmt -.rb -Enable -.RI mktex fmt , -where -.I fmt -must be one of -.I tex -or -.IR tfm . -.TP -.BI --no-maketex \ fmt -.rb -Disable -.RI mktex fmt , -where -.I fmt -must be one of -.I tex -or -.IR tfm . -.TP -.BI --output-comment \ string -.rb -Use -.I string -for the DVI file comment instead of the date. -.TP -.BI -output-directory \ directory -.rb Write output files in -.I directory -instead of the current directory. Look up input files in -.I directory -first, the along the normal search path. -.TP -.B --parse-first-line -.rb -If the first line of the main input file begins with -.I %& -parse it to look for a dump name. -.TP -.BI --progname \ name -.rb -Pretend to be program -.IR name . -This affects both the format used and the search paths. -.TP -.B --recorder -.rb -Enable the filename recorder. This leaves a trace of the files opened -for input and output in a file with extension -.IR .ofl . -(This option is always on.) -.TP -.B --shell-escape -.rb -Enable the -.BI \ewrite18{ command } -construct. The -.I command -can be any Bourne shell command. This construct is normally -disallowed for security reasons. -.TP -.B --version -.rb -Print version information and exit. -.\"===================================================================== -.SH ENVIRONMENT -See the Kpathsearch library documentation (the `Path specifications' -node) for precise details of how the environment variables are used. -The -.B kpsewhich -utility can be used to query the values of the variables. -.PP -One caveat: In most Omega formats, you cannot use ~ in a filename you -give directly to Omega, because ~ is an active character, and hence is -expanded, not taken as part of the filename. Other programs, such as -\*(MF, do not have this problem. -.PP -.TP -TEXMFOUTPUT -Normally, Omega puts its output files in the current directory. If -any output file cannot be opened there, it tries to open it in the -directory specified in the environment variable TEXMFOUTPUT. -There is no default value for that variable. For example, if you say -.I tex paper -and the current directory is not writable, if TEXMFOUTPUT has -the value -.IR /tmp , -Omega attempts to create -.I /tmp/paper.log -(and -.IR /tmp/paper.dvi , -if any output is produced.) -.TP -TEXINPUTS -Search path for -.I \einput -and -.I \eopenin -files. -This should probably start with ``.'', so -that user files are found before system files. An empty path -component will be replaced with the paths defined in the -.I texmf.cnf -file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the -current direcory and ``/home/user/tex'' to the standard search path. -.TP -TEXEDIT -Command template for switching to editor. The default, usually -.BR vi , -is set when Omega is compiled. -.\"===================================================================== -.SH FILES -The location of the files mentioned below varies from system to -system. Use the -.B kpsewhich -utility to find their locations. -.TP -.I omega.pool -Encoded text of Omega's messages. -.TP -.I *.oft -Predigested Omega format (.\|oft) files. -.br -.\"===================================================================== -.SH NOTES -This manual page is not meant to be exhaustive. The complete -documentation for this version of Omega can be found in the info -manual -.IR "Web2C: A TeX implementation" . -.\"===================================================================== -.SH BUGS -This version of Omega implements a number of optional extensions. -In fact, many of these extensions conflict to a greater or lesser -extent with the definition of Omega. When such extensions are -enabled, the banner printed when Omega starts is changed to print -.B Omegak -instead of -.BR Omega . -.PP -This version of Omega fails to trap arithmetic overflow when -dimensions are added or subtracted. Cases where this occurs are rare, -but when it does the generated -.I DVI -file will be invalid. -.PP -The -.I DVI -files produced by Omega may use extensions which make them incompatible -with most software designed to handle -.I DVI -files. In order to print or preview them, you should use -.B odvips -to generate a PostScript file. -.PP -Omega is experimental software, and if you are an active user it is -strongly recommended that you subscribe to the Omega mailing list. -Visit the Omega website -.B http://omega.cse.unsw.edu.au -for information on how to subscribe. -.\"===================================================================== -.SH "SEE ALSO" -.BR tex (1), -.BR mf (1), -.RB odvips (1), -.\"===================================================================== -.SH AUTHORS -The primary authors of Omega are John Plaice and Yannis Haralambous. +omega.1
\ No newline at end of file diff --git a/Master/texmf/doc/man/man1/latex.1 b/Master/texmf/doc/man/man1/latex.1 index 89d63058631..52bbac44000 100644 --- a/Master/texmf/doc/man/man1/latex.1 +++ b/Master/texmf/doc/man/man1/latex.1 @@ -1,4 +1,4 @@ -.TH LATEX 1 "29 March 1999" "Web2C 7.5.5" +.TH LATEX 1 "7 January 2007" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX @@ -68,3 +68,8 @@ should not be used for new texts. Leslie Lamport, .IR "\*(LX \- A Document Preparation System" , Addison-Wesley, 1985, ISBN 0-201-15790-X. + +LaTeX Companion + +LaTeX Graphics Companion + diff --git a/Master/texmf/doc/man/man1/makempx.1 b/Master/texmf/doc/man/man1/makempx.1 index fe968665fb3..e0303101ccc 100644 --- a/Master/texmf/doc/man/man1/makempx.1 +++ b/Master/texmf/doc/man/man1/makempx.1 @@ -1,4 +1,4 @@ -.TH MAKEMPX 1 "4 January 1998" "Web2C 7.5.5" +.TH MAKEMPX 1 "4 January 1998" "Web2C 7.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/makempy.1 b/Master/texmf/doc/man/man1/makempy.1 index 02cae248c54..98af35224a4 100644 --- a/Master/texmf/doc/man/man1/makempy.1 +++ b/Master/texmf/doc/man/man1/makempy.1 @@ -1,60 +1,72 @@ -.TH makempy "1" "May 2004" "teTeX " "ConTeXt" +.TH MAKEMPY "1" "December 2006" "makempy 1.1" "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 -makempy \- Helper script for conversion of (PDF or PostScript) text to -\fBMetapost\fP graphics -.PP +makempy \- convert PDF or PostScript text to MetaPost graphics + .SH "SYNOPSIS" \fBmakempy\fP \fIfilenam\fP -.PP + .SH DESCRIPTION -.PP -\fBmakempy\fP takes \fBMetapost\fP output files (*\&.mpo) and -translates them to *\&.mpy files. In order to include text as a + +\fBmakempy\fP takes MetaPost output files (\fI*.mpo\fP) and +translates them to \fI*.mpy\fP files. In order to include text as a graphic into a file typeset with (Con)TeX(t), you extract the text -from Postscript of PDF files using \fBpdftops\fP and \fBpstoedit\fP, +from Postscript of PDF files using \fBpdftops\fP(1) and \fBpstoedit\fP(1), creating a Metapost input file. -.PP + This file can then be processed by \fBmakempy\fP. The \fBmakempy\fP script does its work without user intervention. When it deduces that -there are no changes, it will not run at all, otherwise it will report -its steps and/or encountered error. +there are no changes, it does not do anything; otherwise it reports +its steps and any errors. .SH "OPTIONS" -.IP .IP "\fB--help\fP" -returns some basic help information -.IP +print basic usage information .IP "\fB--silent\fP" -don t report status messages -.IP +don't report status messages .IP "\fB--force\fP" always process the file (no checksum test) -.IP .IP "\fB--noclean\fP" -don t remove temporary files when finished -.IP -.IP "\fB--acrobat\fP" -use ACROBAT for conversion (only unix) -.IP +don't remove temporary files when finished .IP "\fB--pdftops\fP" -use PDFTOPS for conversion -.IP +use \fBpdftops\fP(1), part of the \fBxpdf\fP(1) programs, +to convert PDF to PostScript .IP "\fB--ghostscript\fP" -use GHOSTSCRIPT for conversion -.IP +use GhostScript (see \fBpdf2ps\fP(1)) to convert PDF to PostScript + .SH "VARIABLES" .PP When set, the environment variables GS and GS_PROG will be used to -identify GHOSTSCRIPT. If needed, the names of the other programs that -are used can be set with PDFTOPS, ACROREAD and PSTOEDIT. +identify GHOSTSCRIPT. The names of the other programs that +are used can be set with PDFTOPS and PSTOEDIT. .HP + .SH "SEE ALSO" -.PP -\fBtexexec\fP(1)\&. -.PP -The makempy manual, \fImmakempy\&.pdf\fP\&. -.PP + +.IP \(bu +\fBmpost\fP(1), \fBpstoedit\fP(1), \fBtexexec\fP(1). +.IP \(bu +The makempy manual, \fImmakempy.pdf\fP, +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + .SH "AUTHOR" -.IP -This manual page was written by Frank Küster <frank@kuesterei\&.ch>, -for the Debian GNU/Linux system\&. It may be used and modified by -others without contacting the author\&. + +This manual page was written by Frank Küster <frank@kuesterei.ch>, +for the Debian GNU/Linux system. It may be used and modified by +others without contacting the author. diff --git a/Master/texmf/doc/man/man1/mf.1 b/Master/texmf/doc/man/man1/mf.1 index 9909f89db14..b444de89a61 100644 --- a/Master/texmf/doc/man/man1/mf.1 +++ b/Master/texmf/doc/man/man1/mf.1 @@ -1,5 +1,5 @@ .\" t -.TH MF 1 "10 November 2001" "Web2C 7.5.5" +.TH MF 1 "10 November 2001" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/mft.1 b/Master/texmf/doc/man/man1/mft.1 index db552fa1c4e..5461047e0c5 100644 --- a/Master/texmf/doc/man/man1/mft.1 +++ b/Master/texmf/doc/man/man1/mft.1 @@ -1,4 +1,4 @@ -.TH MFT 1 "14 December 1993" "Web2C 7.5.5" +.TH MFT 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/mktexlsr.1 b/Master/texmf/doc/man/man1/mktexlsr.1 index ececa268140..4d2f59b28de 100644 --- a/Master/texmf/doc/man/man1/mktexlsr.1 +++ b/Master/texmf/doc/man/man1/mktexlsr.1 @@ -1,4 +1,4 @@ -.TH MKTEXLSR 1 "4 January 1998" "Kpathsea 3.5.5" +.TH MKTEXLSR 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktexmf.1 b/Master/texmf/doc/man/man1/mktexmf.1 index 502a41ac325..338053f55ba 100644 --- a/Master/texmf/doc/man/man1/mktexmf.1 +++ b/Master/texmf/doc/man/man1/mktexmf.1 @@ -1,4 +1,4 @@ -.TH MKTEXMF 1 "4 January 1998" "Kpathsea 3.5.5" +.TH MKTEXMF 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktexpk.1 b/Master/texmf/doc/man/man1/mktexpk.1 index 99a5a71cd3a..6e5ae98f101 100644 --- a/Master/texmf/doc/man/man1/mktexpk.1 +++ b/Master/texmf/doc/man/man1/mktexpk.1 @@ -1,4 +1,4 @@ -.TH MKTEXPK 1 "4 January 1998" "Kpathsea 3.5.5" +.TH MKTEXPK 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktextfm.1 b/Master/texmf/doc/man/man1/mktextfm.1 index e8566899004..0408897d2d1 100644 --- a/Master/texmf/doc/man/man1/mktextfm.1 +++ b/Master/texmf/doc/man/man1/mktextfm.1 @@ -1,4 +1,4 @@ -.TH MKTEXTFM 1 "4 January 1998" "Kpathsea 3.5.5" +.TH MKTEXTFM 1 "4 January 1998" "Kpathsea 3.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mmafm.1 b/Master/texmf/doc/man/man1/mmafm.1 index a837a4fa3c8..db1f3264fd3 100644 --- a/Master/texmf/doc/man/man1/mmafm.1 +++ b/Master/texmf/doc/man/man1/mmafm.1 @@ -1,5 +1,5 @@ .\" -*-nroff-*- -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -168,9 +168,7 @@ You haven't yet created an AMCP file for \fIFont\fR. ' .SH AUTHOR .na -Eddie Kohler, kohler@icir.org -.br -http://www.pdos.lcs.mit.edu/~eddietwo/ +Eddie Kohler, kohler@cs.ucla.edu .PP The latest version is available from: .br diff --git a/Master/texmf/doc/man/man1/mmpfb.1 b/Master/texmf/doc/man/man1/mmpfb.1 index 23bac8dd967..dc13d53aa9d 100644 --- a/Master/texmf/doc/man/man1/mmpfb.1 +++ b/Master/texmf/doc/man/man1/mmpfb.1 @@ -1,5 +1,5 @@ .\" -*-nroff-*- -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -199,9 +199,7 @@ will have \fIN\fR subroutines. ' .SH AUTHOR .na -Eddie Kohler, kohler@icir.org -.br -http://www.pdos.lcs.mit.edu/~eddietwo/ +Eddie Kohler, kohler@cs.ucla.edu .PP The latest version is available from: .br diff --git a/Master/texmf/doc/man/man1/mpost.1 b/Master/texmf/doc/man/man1/mpost.1 index b784a64df5a..59fcb7c1a16 100644 --- a/Master/texmf/doc/man/man1/mpost.1 +++ b/Master/texmf/doc/man/man1/mpost.1 @@ -1,4 +1,4 @@ -.TH MPOST 1 "10 November 2001" "Web2C 7.5.5" +.TH MPOST 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost @@ -432,6 +432,15 @@ in a little more detail. This manual page is not meant to be exhaustive. The complete documentation for this version of \*(MP can be found in the info manual .IR "Web2C: A TeX implementation" . +See also +.IR mpman.pdf , +the manual written by John Hobby (it lives in the documentation +directory). +.PP +.B MetaPost +is the native graphics language for ConTeXt, a typesetting system +built on top of the \*(TX family. See +.BR texexec (1). .\"===================================================================== .SH "SUGGESTED READING" Donald E. Knuth, @@ -453,6 +462,7 @@ CSTR 164, AT&T Bell Labs, .\"===================================================================== .SH "SEE ALSO" .BR tex (1), +.BR texexec (1), .BR mf (1), .BR dvips (1). .\"===================================================================== @@ -468,6 +478,8 @@ searching features in more recent versions of .B web2c and worked towards fully integrating \*(MP into the canonical Unix \*(TX distribution. He also updated and extended this manual page. +.PP +The current maintainer of MetaPost is Taco Hoekwater. .\"===================================================================== .SH TRIVIA Unlike \*(TX and \*(MF, \*(MP originally didn't use any fancy logo. diff --git a/Master/texmf/doc/man/man1/mpto.1 b/Master/texmf/doc/man/man1/mpto.1 index 8c7e5fe58fa..954f47f9428 100644 --- a/Master/texmf/doc/man/man1/mpto.1 +++ b/Master/texmf/doc/man/man1/mpto.1 @@ -1,4 +1,4 @@ -.TH MPTO 1 "4 January 1998" "Web2C 7.5.5" +.TH MPTO 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mptopdf.1 b/Master/texmf/doc/man/man1/mptopdf.1 new file mode 100644 index 00000000000..6977b078da0 --- /dev/null +++ b/Master/texmf/doc/man/man1/mptopdf.1 @@ -0,0 +1,103 @@ +.TH "MPTOPDF" "1" "January 2007" "mptopdf 1.3.2" "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" +mptopdf \- convert MetaPost to PDF + +.SH "SYNOPSIS" +\fBmptopdf\fP \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBmptopdf\fP can convert MetaPost-generated EPS files to PDF, or it +can process a MetaPost source file directly (see +.BR mpost (1)) +and convert the generated EPS files to PDF. + +.SH "OPTIONS" +All switches are specified in full here but can be abbreviated to the +shortest unique prefix. Thus, \fB--metaf\fP works the same as +\fB--metafun\fP. +.IP \fB--help\fP +Print a terse help message. +.IP "\fB--metafun\fP" +Use the metafun pre-compiled format to process the MetaPost source +file. You usually don't need this option, since metafun input is +usually produced and processed as part of a +.BR texexec (1) +run. Needs the \fB--rawmp\fP switch to take effect. +.IP \fB--rawmp\fP +Process the source file with +.BR mpost (1) +directly, rather than with +.BR texexec (1). +This option is needed if you want to specify \fB--metafun\fP. +.IP \fB--latex\fP +Typeseting labels using +.BR latex (1) +rather than plain +.BR tex (1). + +.SH "USAGE" + +To convert \fImanfig.20\fP to \fImanfig-20.pdf\fI: +.EX +mptopdf manfig.20 +.EE + +You can convert more than one EPS file at once: +.EX +mptopdf manfig.20 otherfig.17 finalfig.8 +.EE + +Or you can give +.BR mptopdf (1) +a pattern that it will expand: +.EX +mptopdf 'manfig.*' +.EE +Note the single quotes to protect the * from the shell. Of course, +usually you can let the shell do the wildcard expansion and therefore +leave off the quotes. + +To convert +.I figs.mp +to \fIfigs-1.pdf\fP, \fIfigs-2.pdf\fP, ... +.EX +mptopdf figs.mp +.EE + +If the labels are typeset with +.BR latex (1): +.EX +mptopdf --latex figs.mp +.EE + +.SH "SEE ALSO" +.IP \(bu +.BR tex (1), +.BR latex (1), +.BR mpost (1), +.BR texexec (1). +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +.BR mptopdf (1) +is part of the ConTeXt package available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +This manpage was written by Sanjoy Mahajan <sanjoy@mit.edu> and is in +the public domain. diff --git a/Master/texmf/doc/man/man1/newer.1 b/Master/texmf/doc/man/man1/newer.1 index 0a5b1c2f375..313b8db4b8c 100644 --- a/Master/texmf/doc/man/man1/newer.1 +++ b/Master/texmf/doc/man/man1/newer.1 @@ -1,4 +1,4 @@ -.TH NEWER 1 "21 June 2005" "Web2C 7.5.5" +.TH NEWER 1 "21 June 2005" "Web2C 7.5.6" .\"===================================================================== .SH NAME newer \- compare file modification times diff --git a/Master/texmf/doc/man/man1/omega.1 b/Master/texmf/doc/man/man1/omega.1 index 29d0bbb1c10..d13c6a11ccd 100644 --- a/Master/texmf/doc/man/man1/omega.1 +++ b/Master/texmf/doc/man/man1/omega.1 @@ -1,4 +1,4 @@ -.TH OMEGA 1 "27 December 1997" "Web2C 7.5.5" +.TH OMEGA 1 "27 December 1997" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/otfinfo.1 b/Master/texmf/doc/man/man1/otfinfo.1 index e0bbcd10886..d4ebd306406 100644 --- a/Master/texmf/doc/man/man1/otfinfo.1 +++ b/Master/texmf/doc/man/man1/otfinfo.1 @@ -1,5 +1,5 @@ '\"t -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -12,7 +12,7 @@ otfinfo \- report information about OpenType fonts .SH SYNOPSIS .B otfinfo -\%[\fB-sfzpg\fR] +\%[\fB-sfzpvag\fR] \%[\fIFILE...\fR] ' .SH DESCRIPTION @@ -79,6 +79,41 @@ Print each font's PostScript name. For example: ' .Sp .TP 5 +.BR \-a ", " \-\-family +Print each font's family name. For example: +.nf + Minion Pro +.fi +' +.Sp +.TP 5 +.BR \-v ", " \-\-font\-version +Print font version information, if available. For example: +.nf + OTF 1.013;PS 001.000;Core 1.0.27;makeotf.lib(1.11) +.fi +' +.Sp +.TP 5 +.BR \-i ", " \-\-info +Print each font's name, version, designer, vendor, copyright, and license +information. For example: +.nf + Family: Minion Pro + Subfamily: Regular + Full name: Minion Pro + PostScript name: MinionPro-Regular + Version: OTF 1.011;PS 001.000;Core 1.0.27;makeotf.lib1.3.1 + Unique ID: 1.011;ADBE;MinionPro-Regular + Designer: Robert Slimbach + Vendor URL: http://www.adobe.com/type/ + Trademark: Minion is either a registered trademark or a trademark of Adobe Systems Incorporated in the United States and/or other countries. + Copyright: \(co 2000 Adobe Systems Incorporated. All Rights Reserved. U.S. Patent Des. 337,604. Other patents pending. + License URL: http://www.adobe.com/type/legal.html +.fi +' +.Sp +.TP 5 .BR \-g ", " \-\-glyphs Print the name of every glyph in each font, one per line. For example: .nf @@ -91,6 +126,18 @@ Print the name of every glyph in each font, one per line. For example: .fi Works for PostScript-flavored OpenType fonts only. ' +.Sp +.TP 5 +.BR \-t ", " \-\-tables +Print the size and name of every OpenType table in the font. For example: +.nf + 52 BASE + 87723 CFF + 4940 DSIG + 21366 GPOS + \&... +.fi +' .PD ' ' @@ -140,4 +187,4 @@ Print the version number and some short non-warranty information and exit. Version 1.4 ' .SH AUTHOR -Eddie Kohler (kohler@icir.org) +Eddie Kohler (kohler@cs.ucla.edu) diff --git a/Master/texmf/doc/man/man1/otftotfm.1 b/Master/texmf/doc/man/man1/otftotfm.1 index a5450d3e290..feae43f9740 100644 --- a/Master/texmf/doc/man/man1/otftotfm.1 +++ b/Master/texmf/doc/man/man1/otftotfm.1 @@ -1,5 +1,5 @@ '\"t -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -12,23 +12,25 @@ .. .TH OTFTOTFM 1 "LCDF Typetools" "Version \*V" .SH NAME -otftotfm \- create TeX font metrics from PostScript OpenType fonts +otftotfm \- create TeX font metrics from OpenType fonts .SH SYNOPSIS .B otftotfm \%[\fB\-a\fR] \%[\fBoptions\fR] -\%\fIfontfile\fR.otf [\fItexname\fR] +\%\fIfontfile\fR [\fItexname\fR] ' .SH DESCRIPTION .BR Otftotfm creates the font metric and encoding files required to use an OpenType font -with TeX. You supply an OpenType ".otf" font file, a base ".enc" encoding, +with TeX. You supply an OpenType ".otf" or ".ttf" font file, +a base ".enc" encoding, and a TeX name "\fItexname\fR" for the resulting font, and say which OpenType features should be turned on. Then .B otftotfm -generates and installs the corresponding TeX-related metric files -(".tfm" TeX font metrics, ".vf" virtual fonts, and ".enc" -encoding files). It only works on PostScript-flavored OpenType fonts. +generates and installs the corresponding TeX-related metric files (".tfm" +TeX font metrics, ".vf" virtual fonts, and ".enc" encoding files). It +works on both PostScript-flavored and TrueType-flavored OpenType fonts, +although TrueType-flavor support will only work easily with pdftex. .LP The easiest way to use .B otftotfm @@ -39,7 +41,7 @@ option; see Automatic Mode below. Without .B otftotfm writes all its output files to the current directory. .LP -After running "\fBotftotfm\fR \fIfontfile\fR.otf \fItexname\fR" and +After running "\fBotftotfm\fR \fIfontfile\fR \fItexname\fR" and installing the results (manually or with .BR \-a ), you can use the OpenType font in plain TeX with a command like this: @@ -74,7 +76,7 @@ capitals; "\fB\-f\fRswsh", for swash variants; and "\fB\-f\fRcswh", for contextual swash. See the FEATURE DIRECTORY section below for more. The .M otfinfo 1 program will report which features a font supports; run "\fBotfinfo\fR -\fB\-f\fR \fIfontfile\fR.otf". +\fB\-f\fR \fIfontfile\fR". ' .PP Feature options can also apply a feature to a subset of characters in the @@ -110,7 +112,7 @@ and run .M mktexlsr 1 .) You can then run "\fBotftotfm\fR .B \-a -.IR file .otf +.IR fontfile .IR texname \&" and immediately refer to the font in TeX using the .I texname @@ -127,13 +129,12 @@ installs files under that directory tree as follows: .TS l l l . \fBFile type\fR \fBDirectory\fR \fBFilename\fR -TFM TEXMF/fonts/tfm/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR[--base].tfm +TFM TEXMF/fonts/tfm/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR[\-\-base].tfm VF TEXMF/fonts/vf/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR.vf -PL TEXMF/fonts/pl/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR[--base].pl +PL TEXMF/fonts/pl/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR[\-\-base].pl VPL TEXMF/fonts/vpl/\fIvendor\fR/\fItypeface\fR/ \fItexname\fR.vpl encoding TEXMF/fonts/enc/dvips/\fIvendor\fR/ a_\fIsignature\fR.enc or TEXMF/dvips/\fIvendor\fR/ -PFB font TEXMF/fonts/type1/\fIvendor\fR/\fItypeface\fR/ \fIPStexname\fR.pfb font map TEXMF/fonts/map/dvips/\fIvendor\fR/ \fIvendor\fR.map or TEXMF/dvips/\fIvendor\fR/ .TE @@ -141,15 +142,28 @@ font map TEXMF/fonts/map/dvips/\fIvendor\fR/ \fIvendor\fR.map "TEXMF" stands for the writable TEXMF directory. \fITexname\fR is the font name supplied as .BR otftotfm 's -second argument, and \fIPStexname\fR is the PostScript name of the input -font. The \fIvendor\fR and \fItypeface\fR strings are required by TDS; -they default to "lcdftools" and the font's family name, respectively, but -see the +second argument. The \fIvendor\fR and \fItypeface\fR strings are required +by TDS; they default to "lcdftools" and the font's family name, +respectively, but see the .B \-\-vendor and .B \-\-typeface options. \fISignature\fR is an opaque 6-character encoding signature. .PP +.B Otftotfm +also installs a font file suitable for printing. +PostScript-flavored OpenType fonts are translated to Type 1 format and +installed as PFB fonts; TrueType-flavored fonts are installed as is (pdftex +and pdflatex can read TrueType directly). However, +.B otftotfm +will not install a font file if one already exists. The installation paths +are as follows, where \fIPSname\fR is the font's PostScript name. +.TS +l l l . +PFB TEXMF/fonts/type1/\fIvendor\fR/\fItypeface\fR/ \fIPSname\fR.pfb +TrueType TEXMF/fonts/truetype/\fIvendor\fR/\fItypeface\fR/ \fIfontfile\fR +.TE +.PP You can override these directories with environment variables and options as follows. Options take precedence over environment variables. ' @@ -161,7 +175,8 @@ VF VFDESTDIR \-\-vf\-directory PL PLDESTDIR \-\-pl\-directory VPL VPLDESTDIR \-\-vpl\-directory encoding ENCODINGDESTDIR \-\-encoding\-directory -PFB font T1DESTDIR \-\-type1\-directory +PFB T1DESTDIR \-\-type1\-directory +TrueType TRUETYPEDESTDIR \-\-truetype\-directory font map \- \-\-map\-file .TE .PP @@ -207,37 +222,37 @@ for the first set of fonts. Note the "\fB\-f\fRkern \fB\-f\fRliga" options, which access pair kerns and the default "f" ligatures. .Sp .nf - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Regular.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-Regular - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-It.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-It - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Semibold.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-Semibold - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-SemiboldIt.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-SemiboldIt - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Bold.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-Bold - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-BoldIt.otf \e - \fB\-f\fRkern \fB\-f\fRliga LY1--MinionPro-BoldIt + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Regular.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-Regular + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-It.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-It + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Semibold.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-Semibold + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-SemiboldIt.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-SemiboldIt + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Bold.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-Bold + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-BoldIt.otf \e + \fB\-f\fRkern \fB\-f\fRliga LY1\-\-MinionPro\-BoldIt .fi .Sp The small-caps fonts are generated with an additional "\fB\-f\fRsmcp" -option. We append "--fsmcp" to the font metric names as well, +option. We append "\-\-fsmcp" to the font metric names as well, differentiating them from the regular fonts. Although MinionPro's italic fonts support small-caps, the LaTeX font selection scheme can't access them easily, so we've left them off. .Sp .nf - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Regular.otf \e - \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1--MinionPro-Regular--fsmcp - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Semibold.otf \e - \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1--MinionPro-Semibold--fsmcp - \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro-Bold.otf \e - \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1--MinionPro-Bold--fsmcp + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Regular.otf \e + \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1\-\-MinionPro-Regular\-\-fsmcp + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Semibold.otf \e + \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1\-\-MinionPro\-Semibold\-\-fsmcp + \fBotftotfm\fR \fB\-a\fR \fB\-e\fR texnansx MinionPro\-Bold.otf \e + \fB\-f\fRkern \fB\-f\fRliga \fB\-f\fRsmcp LY1\-\-MinionPro\-Bold\-\-fsmcp .fi .Sp To get old-style numerals, just add the "\fB\-f\fRonum" option to each -invocation -- and, to reduce confusion, append "--fonum" to the font metric +invocation -- and, to reduce confusion, append "\-\-fonum" to the font metric names. .PP At this point, all our font metric files are installed, and it's finally @@ -249,21 +264,21 @@ Let's call the LaTeX font family "MinionPro". Then the ".fd" file is .nf \eDeclareFontFamily{LY1}{MinionPro}{} \eDeclareFontShape{LY1}{MinionPro}{m}{n}% - { <\-> LY1--MinionPro-Regular }{} - \eDeclareFontShape{LY1}{MinionPro}{m}{it}{ <\-> LY1--MinionPro-It }{} + { <\-> LY1\-\-MinionPro\-Regular }{} + \eDeclareFontShape{LY1}{MinionPro}{m}{it}{ <\-> LY1\-\-MinionPro\-It }{} \eDeclareFontShape{LY1}{MinionPro}{m}{sc}% - { <\-> LY1--MinionPro-Regular--fsmcp }{} + { <\-> LY1\-\-MinionPro\-Regular\-\-fsmcp }{} \eDeclareFontShape{LY1}{MinionPro}{sb}{n}% - { <\-> LY1--MinionPro-Semibold }{} + { <\-> LY1\-\-MinionPro\-Semibold }{} \eDeclareFontShape{LY1}{MinionPro}{sb}{it}% - { <\-> LY1--MinionPro-SemiboldIt }{} + { <\-> LY1\-\-MinionPro\-SemiboldIt }{} \eDeclareFontShape{LY1}{MinionPro}{sb}{sc}% - { <\-> LY1--MinionPro-Semibold--fsmcp }{} - \eDeclareFontShape{LY1}{MinionPro}{b}{n}{ <\-> LY1--MinionPro-Bold }{} + { <\-> LY1\-\-MinionPro\-Semibold\-\-fsmcp }{} + \eDeclareFontShape{LY1}{MinionPro}{b}{n}{ <\-> LY1\-\-MinionPro-Bold }{} \eDeclareFontShape{LY1}{MinionPro}{b}{it}% - { <\-> LY1--MinionPro-BoldIt }{} + { <\-> LY1\-\-MinionPro\-BoldIt }{} \eDeclareFontShape{LY1}{MinionPro}{b}{sc}% - { <\-> LY1--MinionPro-Bold--fsmcp }{} + { <\-> LY1\-\-MinionPro\-Bold\-\-fsmcp }{} \eDeclareFontShape{LY1}{MinionPro}{bx}{n}% { <\-> ssub * MinionPro/b/n }{} \eDeclareFontShape{LY1}{MinionPro}{bx}{it}% @@ -357,13 +372,13 @@ option acts like .B \-\-clear\-subs followed by .BI \-\-include\-subs " pattern\fR. " -For pattern syntax, see CHARACTER PATTERNS, below. +For pattern syntax, see GLYPH PATTERNS, below. .Sp -In the command line below, the '<Number>' pattern will force the "onum" +In the command line below, the \&'<Number>' pattern will force the "onum" feature to substitute only numbers (and not, for example, punctuation). The "salt" feature can still substitute any character. .nf - \fBotftotfm\fR \fB\-f\fRsalt \fB\-\-include\-subs\fR='<Number>' \fB\-f\fRonum \.\.\. + \fBotftotfm\fR \fB\-f\fRsalt \fB\-\-include\-subs\fR="<Number>" \fB\-f\fRonum \.\.\. .fi ' .Sp @@ -464,71 +479,6 @@ for more information. ' .Sp .TP 5 -.BI \-\-literal\-encoding= encoding -Select the -.M dvips 1 -encoding used for the font. No glyph substitutions will be permitted, so -the output encoding will equal the input encoding (and -.B otftotfm -will not generate an output encoding). -' -.Sp -.TP 5 -.BI \-\-ligkern= command -Execute the specified LIGKERN -.IR command -in addition to any in the encoding. For example, "\fB\-\-ligkern\fR 'T {L} -h'" suppresses any T_h ligature in the font. You can supply multiple -.B \-\-ligkern -options. See ENCODINGS, below. -' -.Sp -.TP 5 -.BI \-\-position= command -Execute the specified POSITION -.IR command -in addition to any in the encoding. For example, "\fB\-\-position\fR 'T 10 -0 20'" adds ten units of space to either side of the "T" character. You -can supply multiple -.B \-\-position -options. See ENCODINGS, below. -' -.Sp -.TP 5 -.BI \-\-unicoding= command -Execute the specified UNICODING -.IR command -in addition to any in the encoding. For example, "\fB\-\-unicoding\fR 'pi1 -=: uni03D6'" tells -.B otftotfm -to encode "/pi1" as U+03D6 GREEK PI SYMBOL. You can supply multiple -.B \-\-unicoding -options. See ENCODINGS, below. -' -.Sp -.TP 5 -.BI \-\-no\-encoding\-commands -Ignore any LIGKERN and/or UNICODING commands in the encoding file. -' -.Sp -.TP 5 -.BI \-\-no\-default\-ligkern -Don't include -.BR otftotfm 's -default LIGKERN commands. -' -.Sp -.TP 5 -.BI \-\-coding\-scheme= scheme -Set the font's TFM coding scheme to -.IR scheme , -which must be a string less than 40 characters long containing no -parentheses. The default is the encoding's PostScript name. Most tools -ignore the coding scheme, so you probably don't need to worry about this -command unless you are using fontinst. -' -.Sp -.TP 5 .BI \-\-boundary\-char= char Set the font's boundary character to .IR char , @@ -546,12 +496,10 @@ versions of a character from within a TeX file. For instance, say that your font provides three versions of "A". If you want to access them all, pick a character to be your alternate selector -- say "*". Then give .B otftotfm -the -.BR \-\-altselector\-char= '*' +the \&'\-\-altselector\-char="*"' option. In TeX, "A" will produce the normal version, "A*" will produce the first alternate, and "A**" will produce the second alternate. Furthermore, -"s*t" will activate any discretionary "s_t" ligature in the font. The -default alternate-selector character is taken from the encoding. +"s*t" will activate any discretionary "s_t" ligature in the font. .Sp The .B \-\-altselector\-char @@ -560,8 +508,9 @@ mechanism uses the features specified by options. You don't need to turn on those features if you use .BR \-\-altselector . .Sp -See Sivan Toledo's article cited in the SEE ALSO section for more -information. +The alternate-selector character may also be specified in the encoding; see +ENCODINGS, below. See Sivan Toledo's article cited in the SEE ALSO section +for more information. ' .Sp .TP 5 @@ -604,7 +553,7 @@ option acts like .B \-\-clear\-alternates followed by .BI \-\-include\-alternates " pattern\fR. " -For pattern syntax, see CHARACTER PATTERNS, below. +For pattern syntax, see GLYPH PATTERNS, below. .Sp OpenType fonts can have many alternates per character, most of which aren't interesting. For example, the character "a" in WarnockPro-Regular has five @@ -614,15 +563,80 @@ alternates, "ordfeminine", "Asmall", "asuperior", "a.end", and option lets you cycle through these alternates, but it's better to leave out the ones you don't want, to avoid overfull encodings. Thus, if you were only interested in ".end" variants, you might supply an -.BR \-\-include\-alternates= "'*.end'" +\&'\-\-include\-alternates="*.end"' option. .Sp -In the command line below, the '*.end' pattern will apply to "aalt" +In the command line below, the \&'*.end' pattern will apply to "aalt" alternates, but not to "salt" alternates. .nf - \fBotftotfm\fR \fB\-f\fRsalt \fB\-\-include\-alternates\fR='*.end' \fB\-f\fRaalt \.\.\. + \fBotftotfm\fR \fB\-f\fRsalt \fB\-\-include\-alternates\fR="*.end" \fB\-f\fRaalt \.\.\. .fi ' +.Sp +.TP 5 +.BI \-\-ligkern= command +Add a LIGKERN +.IR command +to the encoding. For example, \&'\fB\-\-ligkern\fR "T {L} h"' suppresses any +T_h ligature in the font. You can supply multiple +.B \-\-ligkern +options. See ENCODINGS, below. +' +.Sp +.TP 5 +.BI \-\-position= command +Add a POSITION +.IR command +to the encoding. For example, \&'\fB\-\-position\fR "T 10 0 20"' adds ten +units of space to either side of the "T" character. You can supply +multiple +.B \-\-position +options. See ENCODINGS, below. +' +.Sp +.TP 5 +.BI \-\-unicoding= command +Add a UNICODING +.IR command +to the encoding. For example, \&'\fB\-\-unicoding\fR "pi1 =: uni03D6"' tells +.B otftotfm +to encode "/pi1" as U+03D6 GREEK PI SYMBOL. You can supply multiple +.B \-\-unicoding +options. See ENCODINGS, below. +' +.Sp +.TP 5 +.BI \-\-no\-encoding\-commands +Ignore any LIGKERN and/or UNICODING commands in the encoding file. +' +.Sp +.TP 5 +.BI \-\-no\-default\-ligkern +Don't include +.BR otftotfm 's +default LIGKERN commands. +' +.Sp +.TP 5 +.BI \-\-coding\-scheme= scheme +Add a CODINGSCHEME to the encoding. See ENCODINGS, below. +' +.Sp +.TP 5 +.BI \-\-warn\-missing +Warn about encoded characters not supported by the font. See the +WARNMISSING command in ENCODINGS, below. +' +.Sp +.TP 5 +.BI \-\-literal\-encoding= encoding +Select the +.M dvips 1 +encoding used for the font. No glyph substitutions will be permitted, so +the output encoding will equal the input encoding (and +.B otftotfm +will not generate an output encoding). +' .PD ' ' @@ -673,6 +687,11 @@ program. This can be useful if you're installing a bunch of fonts; it is much faster to run .B updmap once, at the end, than to run it once per font. +' +.Sp +.TP 5 +.BI \-\-no\-truetype +Do not install TrueType-flavored OpenType fonts. .PD ' ' @@ -724,6 +743,20 @@ argument is supplied. .TP 5 .BI \-\-no\-map Do not generate a font map line for the font. +' +.\" .Sp +.\" .TP 5 +.\" .BI \-\-base\-name name +.\" Experts only: Set the TeX name of the "base" output font. When +.\" .B otftotfm +.\" needs to make a virtual font (because of font features and/or +.\" letterspacing), it must generate at least two TFM metrics files, one for +.\" the base font and one for the virtual font. In some cases, multiple +.\" virtual fonts can share the same base metrics, reducing the number of +.\" installed metrics files. This option lets you explicitly set the name of +.\" the base output font independently from the main output font, and thus +.\" force fonts to share base metrics. The default base name is derived from +.\" the TeX name, with "\f(CW\-\-base\fR" appended. .PD ' ' @@ -809,28 +842,33 @@ Print the version number and some short non-warranty information and exit. ' .SH ENCODINGS .B Otftotfm -interprets encoding files as Unicode. For example, if an input encoding -has "/dotlessi" at position 10, then -.B otftotfm -detects that the user wants to encode Unicode character U+0131 LATIN SMALL -LETTER DOTLESS I at position 10. The output encoding will use whatever -glyph the font suggests for that Unicode character, given the collection of -features you chose. +interprets encoding files as Unicode. For example, say an input encoding +has "/dotlessi" at position 10. +.B Otftotfm +detects that position 10 should contain Unicode character U+0131 LATIN +SMALL LETTER DOTLESS I, and uses the font's glyph for that character +(possibly modified by any active features). The selected glyph might not +be named "dotlessi"; only the Unicode value matters. .PP -You can control this process with "UNICODING" comments in the input -encoding file. UNICODING comments have the following format: +.B Otftotfm +assigns Unicode values to glyph names using a table published by Adobe (SEE +ALSO has a reference), with extensions for TeX. For more fine-grained +control, add UNICODING commands to the input encoding file. These commands +have the following format: .nf % UNICODING \fIglyph\fR =: \fIchoice1\fR [\fIchoice2\fR ...] ; .fi -\fIGlyph\fR and the -.IR choice s -are PostScript glyph names. This comment tells +This tells .B otftotfm that the glyph named .I glyph translates into the first Unicode value in the .I choice -list that has a character in the font. For example, +list that has a character in the font. \fIGlyph\fR and the +.IR choice s +are PostScript glyph names; the initial "%" sign is required; and each +UNICODING line can contain multiple commands, separated by spaced +semicolons. For example, .nf % UNICODING pi1 =: uni03D6 ; .fi @@ -845,34 +883,22 @@ glyph names: .nf % UNICODING Delta =: Deltagreek Delta ; .fi -.B Otftotfm -uses Adobe's -.I glyphlist.txt -file to translate glyph names to Unicode; see -.IR http://partners.adobe.com/asn/developer/type/unicodegn.html . -.LP -You can map a glyph to nothing to remove that glyph from the input -encoding. This is useful to remove optional characters; for instance: +Supply zero choices to remove a glyph from the input encoding. For +instance: .nf % UNICODING ff =: ; fi =: ; fl =: ; ffi =: ; ffl =: ; .fi The f-ligatures will be added back to the encoding, preferably at their -original locations, if some font feature requires them. -.LP -Map a glyph to 'emptyslot' if you don't want +original locations, if some font feature requires them. Finally, map a +glyph to \&'emptyslot' if you don't want .B otftotfm -to use the slot for a ligature character. For example, given this -UNICODING, +to use the slot for a ligature character. For example, this will leave the +\&'ff' slot unused if the font has no \&'ff' glyph: .nf - % UNICODING ff =: ff emptyslot ; + % UNICODING ff =: ff emptyslot ; .fi -.B otftotfm -will leave the 'ff' encoding slot unused if the font has no 'ff' glyph. (Note that most OpenType fonts provide a visible representation for unused encoding slots, namely a box with an X inside.) -.LP -Each UNICODING line can contain multiple commands, separated by spaced -semicolons. .PP LIGKERN comments in the encoding can add ligatures and inhibit kerns, as in .M afm2tfm 1 . @@ -885,8 +911,8 @@ are removed and replaced by .IR result . To preserve the left-hand glyph, for an effect like "\fIglyph1\fR \fIglyph2\fR =: \fIglyph1\fR \fIresult\fR", use "|=:" instead; to preserve -the right-hand glyph, use "=:|". The other five ligature operators are not -yet supported. +the right-hand glyph, use "=:|". +.\" The other five ligature operators are not yet supported. To remove all kerns between two characters, say: .nf % LIGKERN \fIglyph1\fR {} \fIglyph2\fR ; @@ -929,6 +955,21 @@ from an encoding file with commands like this: As with UNICODING, each LIGKERN or LIGKERNX line can contain multiple commands, separated by spaced semicolons. .PP +.B Otftotfm +has a default set of eight ligatures, namely: +.nf + space l =: lslash ; space L =: Lslash ; + question quoteleft =: questiondown ; exclam quoteleft =: exclamdown ; + hyphen hyphen =: endash ; endash hyphen =: emdash ; + quoteleft quoteleft =: quotedblleft ; + quoteright quoteright =: quotedblright +.fi +LIGKERN commands in the encoding file and +.B \-\-ligkern +options can override these defaults, or supply the +.B \-\-no\-default\-ligkern +option to turn them off. +.PP The POSITION command shifts a glyph within its bounding box. The syntax is .nf % POSITION \fIglyph\fR \fIpdx\fR \fIpdy\fR \fIadx\fR ; @@ -951,45 +992,44 @@ To move the "degree" symbol up by 20 units, supply % POSITION degree 0 20 0 .fi .PP -Finally, the CODINGSCHEME command specifies a default -.B \-\-coding\-scheme -for the encoding; for example: +The CODINGSCHEME command specifies the coding scheme for fonts using this +encoding. This is a string, less than 40 characters long and containing no +parentheses, that classifies the encoding for TeX's purposes. Sample +coding schemes include "TEX TEXT", "TEX MATH ITALIC", and "EXTENDED TEX +FONT ENCODING - LATIN". For example: .nf - % CODINGSCHEME EXTENDED TEX FONT ENCODING + % CODINGSCHEME EXTENDED TEX FONT ENCODING - LATIN +.fi +Most tools ignore the coding scheme; fontinst is an exception. +.B Otftotfm +uses the encoding's PostScript name for the default coding scheme. +.PP +Finally, the WARNMISSING command makes any glyphs not supported by the +input font appear as black boxes. The +.M dvips 1 +processor will also print a warning when encountering these glyphs. For +example: +.nf + % WARNMISSING yes .fi .PP The .BR \-\-unicoding , .BR \-\-ligkern , +.BR \-\-position , +.BR \-\-coding\-scheme , and -.B \-\-position -options let you add virtual UNICODING, LIGKERN/LIGKERNX, and POSITION -comments to an encoding. -.PP -.B Otftotfm -has a default set of eight ligatures, namely: -.nf - space l =: lslash ; space L =: Lslash ; - question quoteleft =: questiondown ; exclam quoteleft =: exclamdown ; - hyphen hyphen =: endash ; endash hyphen =: emdash ; - quoteleft quoteleft =: quotedblleft ; - quoteright quoteright =: quotedblright -.fi -LIGKERN commands in the encoding file and -.B \-\-ligkern -options can override these defaults, or supply the -.B \-\-no\-default\-ligkern -option to turn them off. -.PP -Some common encoding files have commands that are inappropriate for -OpenType fonts. For example, "t1.enc" hard-codes f-ligatures, which can -cause problems with small-cap fonts. Supply the +.B \-\-warn\-missing +options add UNICODING, LIGKERN/LIGKERNX, POSITION, CODINGSCHEME, and +WARNMISSING commands to an encoding, and can override commands in the +encoding itself. Some common encoding files have commands that are +inappropriate for OpenType fonts; for example, "t1.enc" hard-codes +f-ligatures, which can cause problems with small-cap fonts. Supply the .B \-\-no\-encoding\-commands -option to ignore all commands from the encoding file. Explicit +option to ignore all commands from the encoding file. Commands from +options like .B \-\-ligkern -and -.B \-\-unicoding -options are processed in any case. +are processed in any case. ' .SS New Glyphs .PP @@ -1034,6 +1074,9 @@ The parallel symbol "||" asteriskmath Vertically-centered "*" .TP +ringfitted +Ring accent centered on the width of "A" +.TP twelveudash 2/3-em-wide dash .TP @@ -1089,9 +1132,11 @@ and .BR \-\-include\-alternates options, and their .B \-\-exclude +and +.B \-\-*\-filter variants, accept the following types of pattern. .BUP -Glyph names. Example: "Aacute". Use +Glyph names. Example: "Aacute". For PostScript-flavored fonts, use .M otfinfo 1 's .B \-g option to see a font's glyph names, and "\fBcfftot1\fR \fIfont\fR.otf | @@ -1184,13 +1229,12 @@ Lets the user choose between context-appropriate swash forms for each character. For example, in the words "Ab AC", the first "A" might be translated to a swash form, while the second might not. There may be more than one choice for a given letter, in which case the user should be able -to select among them. TeX can't support complex contextual swashes, or -alternate selection, but -.B otftotfm +to select among them. +.B Otftotfm supports some fonts quite well. The input encoding should have lots of empty space for swash variants, and it should specify a boundary character. See also -.IR calt . +.IR calt " and " swsh . .TP 5 .IR dlig ", Discretionary Ligatures" Activates uncommon ligatures, such as "c_t", "s_p", and "s_t". Supported. @@ -1289,7 +1333,8 @@ for TeX, since it refers exclusively to stylistic alternates. .TP 5 .IR sinf ", Scientific Inferiors" Replaces digits and some punctuation marks with smaller, lowered forms -intended for subscripts. Supported. +intended for subscripts. Supported. Compare +.IR subs . .TP 5 .IR size ", Optical Size" This feature stores information about the range of optical sizes for which @@ -1310,6 +1355,15 @@ in that a Stylistic Set is uniform: an feature should never involve selection from a set of possible alternate characters. Supported. .TP 5 +.IR subs ", Subscript" +Replaces characters with smaller, lowered forms intended for subscripts. +Supported. Compare +.IR sinf ; +some fonts support +.I sinf +but not +.IR subs . +.TP 5 .IR sups ", Superscript" Replaces digits, some punctuation marks, and some lower-case letters with smaller, raised forms intended for superscripts. Supported. @@ -1319,7 +1373,10 @@ Activates all swash forms for each character. There may be more than one swash form, in which case .B otftotfm will pick the first one listed. Supported, except that swash variants -other than the first are inaccessible. +other than the first are inaccessible. Note that some fonts with swash +variants support the +.I cswh +feature exclusively. .TP 5 .IR tnum ", Tabular Figures" All digits will have the same width, so that tables and the like will align @@ -1347,7 +1404,7 @@ or .I $HOME/texmf directory? If so, run the command "kpsewhich \-\-expand\-path='$TEXMF'" to verify that directory is not being found. You may need to set your TEXMF -environment variable, to '{!!'"$HOME"'/texmf,!!$TEXMFMAIN}', for instance +environment variable, to \&'{!!'"$HOME"'/texmf,!!$TEXMFMAIN}', for instance (note the different kinds of quotes; on my machine, this expands to \&'{!!/home/kohler/texmf,!!$TEXMFMAIN}'). ' @@ -1365,7 +1422,7 @@ file, or it might be an oversight. Either fix the encoding file or ignore the warning. ' .TP 5 -can't map '\fIchar\fR' to Unicode +can't map \&'\fIchar\fR' to Unicode ' Another encoding file problem: One of the glyph names in an UNICODING block could not be converted to Unicode. This is problematic since UNICODING @@ -1386,7 +1443,7 @@ encoding distributed with .TP 5 How can I get a small-caps "SS" in place of the German sharp-S? ' -Supply the option "\fB\-\-unicoding\fR 'germandbls =: SSsmall'". +Supply the option \&'\fB\-\-unicoding\fR "germandbls =: SSsmall"'. ' .TP 5 How can I prevent f-ligatures from forming in a small-caps font? @@ -1410,6 +1467,26 @@ option and run .B updmap manually when you're done. ' +.TP 5 +How can I refer to the different forms of phi? +' +\fBOtftotfm\fR follows TeX practice and widely-distributed TeX encoding +vectors, so "/phi" in an input encoding vector should map to a "straight" +phi and "/phi1" should map to a "loopy" phi. Note that TeX practice +differs from the PostScript standard naming conventions, in which "/phi" is +"loopy" and "/phi1" is "straight"; this means that \fBotftotfm\fR may map +"/phi" in an input encoding vector to a font's "/phi1" glyph, and vice +versa. Perhaps most unambiguously, you can use "/uni03D5" for the +"straight" form and "/uni03C6" for the "loopy" form. +' +.TP 5 +How can I get lining figures (that is, normal line-height digits) with small caps ('\fB\-f\fRsmcp')? +' +Many fonts use old-style figures by default with small caps. Since the +default is not specified, it's wise to explicitly supply \&'\fB\-f\fRlnum' or +\&'\fB-f\fRonum'. + +' .SH "BUGS" .\" .LP .\" Presumably some context-sensitive positionings and ligatures could be @@ -1461,7 +1538,11 @@ http://www.tug.org/TUGboat/Articles/tb21-2/tb67tole.pdf .LP Michel Goossens, Frank Mittelbach, and Alexander Samarin, .IR "The LaTeX Companion" -(for information on the .fd file format). +(for information on the .fd file format) +.LP +Adobe Systems, "Unicode and Glyph Names". Refers to the glyphlist.txt file +used to translate glyph names to Unicode code points. +http://partners.adobe.com/public/developer/opentype/index_glyph.html ' .SH AUTHOR Eddie Kohler (kohler@cs.ucla.edu) @@ -1470,4 +1551,3 @@ Thanks to Karl Berry, Marco Kuhlmann, Adam Lindsay, Bruce D'Arcus, Thomas Esser, Claire Connelly, Nelson H.F. Beebe, and Ryuji Suzuki for suggestions, bug reports, and help. Particular thanks to Achim Blumensath and Michael Zedler for suggestions and patches, some of them extensive. - diff --git a/Master/texmf/doc/man/man1/patgen.1 b/Master/texmf/doc/man/man1/patgen.1 index ac33a0852e5..18ab210d8fd 100644 --- a/Master/texmf/doc/man/man1/patgen.1 +++ b/Master/texmf/doc/man/man1/patgen.1 @@ -1,4 +1,4 @@ -.TH PATGEN 1 "23 August 2004" "Web2C 7.5.5" +.TH PATGEN 1 "23 August 2004" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/pdfetex.1 b/Master/texmf/doc/man/man1/pdfetex.1 index fb532c5e01e..ee65eaa6a99 100644 --- a/Master/texmf/doc/man/man1/pdfetex.1 +++ b/Master/texmf/doc/man/man1/pdfetex.1 @@ -1,4 +1,4 @@ -.TH PDFETEX 1 "21 August 2004" "Web2C 7.5.5" +.TH PDFETEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 @@ -95,20 +95,27 @@ implementation. .SH OPTIONS This version of pdfe\*(TX understands the following command line options. .TP +.B -draftmode +.rb +Sets \epdfdraftmode so pdf\*(TX doesn't write a PDF and doesn't read any +included images, thus speeding up execution. +.TP .B -enc .rb Enable the enc\*(TX extensions. This option is only effective in combination with -.BR -ini . -For documentation of the enc\*(TX extensions see -.BR http://www.olsak.net/enctex.html . .TP .B -etex .rb Enable the e-\*(TX extensions. This option is only effective in combination with .BR -ini . +See +.BR etex (1). .TP +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . .B -file-line-error .rb Print error messages in the form @@ -417,9 +424,13 @@ Predigested pdfe\*(TX format (.\|fmt) files. .br .\"===================================================================== .SH NOTES +Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX +extensions, and pdfe\*(TX is just a copy of pdf\*(TX. See +.BR pdftex (1). This manual page is not meant to be exhaustive. The complete -documentation for this version of pdfe\*(TX can be found in the info -manual +documentation for this version of pdfe\*(TX can be found in the +.IR "pdf\*(TX manual" +and the info manual .IR "Web2C: A TeX implementation" . .\"===================================================================== .SH BUGS @@ -446,14 +457,11 @@ pdfe\*(TX is part of all major \*(TX distributions. .P Information on how to get pdfe\*(TX and related information is available at the -.BI "http://tug.org" \ TUG +.B http://www.pdftex.org +.IR "pdf\*(TX" website. -The most recent version of pdfe\*(TX is available for anonymous -ftp at the -.B http://www.pdftex.org/ -.IR "pdfe\*(TX development site" . .P -The following pdfe\*(TX related mailing list is available: +The following pdf\*(TX related mailing list is available: .BR pdftex@tug.org . This is a mailman list; to subscribe send a message containing @@ -472,8 +480,8 @@ website. .BR pdftex (1). .\"===================================================================== .SH AUTHORS -The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and -Jiri Zlatuska. +The primary authors of pdfe\*(TX are Han The Thanh, Petr Sojka, +Jiri Zlatuska, and Peter Breitenlohner (e\*TX). .PP \*(TX was designed by Donald E. Knuth, who implemented it using his \*(WB system for Pascal programs. @@ -485,3 +493,4 @@ generated by the \*(WB to C system originally written by Tomas Rokicki and Tim Morgan. .PP The enc\*(TX extensions were written by Petr Olsak. +.\" vim: syntax=nroff diff --git a/Master/texmf/doc/man/man1/pdflatex.1 b/Master/texmf/doc/man/man1/pdflatex.1 index 8237fbd3a07..833e7b5bd66 120000 --- a/Master/texmf/doc/man/man1/pdflatex.1 +++ b/Master/texmf/doc/man/man1/pdflatex.1 @@ -1 +1 @@ -pdfetex.1
\ No newline at end of file +pdftex.1
\ No newline at end of file diff --git a/Master/texmf/doc/man/man1/pdftex.1 b/Master/texmf/doc/man/man1/pdftex.1 index 56ca5798215..3477e27dd02 100644 --- a/Master/texmf/doc/man/man1/pdftex.1 +++ b/Master/texmf/doc/man/man1/pdftex.1 @@ -1,4 +1,4 @@ -.TH PDFTEX 1 "25 March 2004" "Web2C 7.5.5" +.TH PDFTEX 1 "8 Jan 2007" "pdftex 1.40" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 @@ -46,7 +46,7 @@ it is usually better to use the .I format option instead. .PP -pdf\*(TX is a version of \*(TX that can create +pdf\*(TX is a version of \*(TX, with the e-\*(TX extensions, that can create .I PDF files as well as .I DVI @@ -54,7 +54,7 @@ files. .PP In .I DVI -mode, pdf\*(TX can be used as a complete replacement of the \*(TX +mode, pdf\*(TX can be used as a complete replacement for the \*(TX engine. .PP The typical use of pdf\*(TX is with a pregenerated formats for which @@ -75,15 +75,17 @@ commands are pdf\*(TX's analogues to the .B initex and .B virtex -commands. In this installation, they are symbolic links to the +commands. In this installation, if the links exist, they are symbolic +links to the .B pdftex -executable. These symbolic links may not exist at all. +executable. .PP In .I PDF mode, pdf\*(TX can natively handle the .IR PDF , .IR JPG , +.IR JBIG2 , and .I PNG graphics formats. @@ -95,6 +97,11 @@ implementation. .SH OPTIONS This version of pdf\*(TX understands the following command line options. .TP +.B -draftmode +.rb +Sets \epdfdraftmode so pdf\*(TX doesn't write a PDF and doesn't read any +included images, thus speeding up execution. +.TP .B -enc .rb Enable the enc\*(TX extensions. This option is only effective in @@ -103,6 +110,14 @@ combination with For documentation of the enc\*(TX extensions see .BR http://www.olsak.net/enctex.html . .TP +.B -etex +.rb +Enable the e-\*(TX extensions. This option is only effective in +combination with +.BR -ini . +See +.BR etex (1). +.TP .B -file-line-error .rb Print error messages in the form @@ -411,9 +426,13 @@ Predigested pdf\*(TX format (.\|fmt) files. .br .\"===================================================================== .SH NOTES +Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX +extensions, and pdfe\*(TX is just a copy of pdf\*(TX. See +.BR etex (1). This manual page is not meant to be exhaustive. The complete -documentation for this version of pdf\*(TX can be found in the info -manual +documentation for this version of pdf\*(TX can be found in the +.IR "pdf\*(TX manual" +and the info manual .IR "Web2C: A TeX implementation" . .\"===================================================================== .SH BUGS @@ -438,14 +457,11 @@ pdf\*(TX is available for a large variety of machine architectures and operation systems. pdf\*(TX is part of all major \*(TX distributions. .P -Information on how to get pdfe\*(TX and related information +Information on how to get pdf\*(TX and related information is available at the -.BI "http://tug.org" \ TUG +.B http://www.pdftex.org +.IR "pdf\*(TX" website. -The most recent version of pdf\*(TX is available for anonymous -ftp at the -.B http://www.pdftex.org/ -.IR "pdf\*(TX development site" . .P The following pdfe\*(TX related mailing list is available: .BR pdftex@tug.org . @@ -461,11 +477,12 @@ website. .\"===================================================================== .SH "SEE ALSO" .BR tex (1), +.BR etex (1), .BR mf (1). .\"===================================================================== .SH AUTHORS -The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and -Jiri Zlatuska. +The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, +Jiri Zlatuska, and Peter Breitenlohner (e\*TX). .PP \*(TX was designed by Donald E. Knuth, who implemented it using his \*(WB system for Pascal programs. @@ -477,3 +494,4 @@ generated by the \*(WB to C system originally written by Tomas Rokicki and Tim Morgan. .PP The enc\*(TX extensions were written by Petr Olsak. +.\" vim: syntax=nroff diff --git a/Master/texmf/doc/man/man1/pdftools.1 b/Master/texmf/doc/man/man1/pdftools.1 new file mode 100644 index 00000000000..f028b1ffb91 --- /dev/null +++ b/Master/texmf/doc/man/man1/pdftools.1 @@ -0,0 +1,59 @@ +.TH PDFTOOLS "1" "December 2006" "pdftools 1.2" "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 +pdftools \- analyze PDF files, change image colors +.PP +.SH "SYNOPSIS" +\fBpdftools\fP [ \fIOPTION\fP ... ] <file> [ <file> ... ] + +.SH DESCRIPTION + +\fBpdftools\fP analyzes PDF files and changes image colors. +It is used by the ConTeXt programs. The image-processing features are +not documented here (since I don't understand what they do). +.PP +.SH "OPTIONS" +.PP +.IP "\fB--help\fP" +Print the available options. +.IP "\fB--analyzefile\fP" +Print statistics about each PDF file, including +size, number of xforms, annotations, links, etc. +.IP "\fB--info\fP" +Print, in XML format, information about the PDF files. +It gives the number of pages, producer, author, subject, creation date, +bounding boxes, ... See also \fBpdfinfo\fP(1). +.IP "\fB--countpages\fP" +Print the number of pages in each PDF file. + +.SH "SEE ALSO" + +.IP \(bu +\fBtexexec\fP(1), \fBpdfinfo\fP(1), \fBpdftk\fP(1) +.IP \(bu +The pdftools manual \f(CWmpdftools.pdf\fP +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . +.IP \(bu +The PDF specification <http://www.adobe.com/devnet/pdf/pdf_reference.html> + +.SH "AUTHOR" + +This (incomplete) manual page was written by Sanjoy Mahajan +<sanjoy@mit.edu>. It is in the public domain. diff --git a/Master/texmf/doc/man/man1/pdftosrc.1 b/Master/texmf/doc/man/man1/pdftosrc.1 new file mode 100644 index 00000000000..1a4e1332053 --- /dev/null +++ b/Master/texmf/doc/man/man1/pdftosrc.1 @@ -0,0 +1,239 @@ +.\" Process this file with +.\" groff -man -Tascii pdftosrc.1 +.\" +.\" $Id: pdftosrc.1,v 1.5 2006/12/22 23:46:23 hhenkel Exp $ +.\" +.TH pdftosrc 1 "23 December 2006" "User Manuals" +.SH NAME +pdftosrc \- extract source file or stream from PDF file +.SH SYNOPSIS +.B pdftosrc +.I PDF-file +.R [ +.I stream-object-number +.R ] +.SH DESCRIPTION +If only +.I PDF-file +is given as argument, +.B pdftosrc +extracts the embedded source file +from the first found stream object +with /Type /SourceFile within the +.I PDF-file +and writes it to a file with the name /SourceName +as defined in that PDF stream object +(see application example below). + +If both +.I PDF-file +and +.I stream-object-number +are given as arguments, and +.I stream-object-number +is positive, +.B pdftosrc +extracts and uncompresses the PDF stream of the object +given by its +.I stream-object-number +from the +.I PDF-file +and writes it to a file named +.IR PDF-file . stream-object-number +with the ending +.I .pdf +or +.I .PDF +stripped from the original +.I PDF-file +name. + +A special case is related to XRef object streams that are part +of the PDF standard from PDF-1.5 onward: +If +.I stream-object-number +equals -1, +then +.B pdftosrc +decompresses the XRef stream from the PDF file and writes it +in human-readable PDF cross-reference table format to a file named +.IR PDF-file .xref +(these XRef streams can not be extracted just by giving their object number). + +In any case +an existing file with the output file name will be overwritten. +.SH OPTIONS +None. +.SH FILES +Just the executable +.BR pdftosrc . +.SH ENVIRONMENT +None. +.SH DIAGNOSTICS +At success the exit code of +.B pdftosrc +is 0, else 1. + +All messages go to stderr. +At program invocation, +.B pdftosrc +issues the current version number of the program +.BR xpdf , +on which +.B pdftosrc +is based: + +.RS +pdftosrc version 3.01 + +.RE +When +.B pdftosrc +was successful with the output file writing, +one of the following messages will be issued: + +.RS +Source file extracted to +.I source-file-name + +.RE +or + +.RS +Stream object extracted to +.IR PDF-file . stream-object-number + +.RE +or + +.RS +Cross-reference table extracted to +.IR PDF-file .xref + +.RE + +.RE +When the object given by the +.I stream-object-number +does not contain a stream, +.B pdftosrc +issues the following error message: + +.RS +Not a Stream object + +.RE +When the +.I PDF-file +can't be opened, the error message is: + +.RS +Error: Couldn't open file +.RI ' PDF-file '. + +.RE +When +.B pdftosrc +encounters an invalid PDF file, +the error message (several lines) is: + +.RS +Error: May not be a PDF file (continuing anyway) +.RE +.RS +(more lines) +.RE +.RS +Invalid PDF file + +.RE +There are also more error messages from +.B pdftosrc +for various kinds of broken PDF files. +.SH NOTES +An embedded source file will be written out unchanged, +i. e. it will not be uncompressed in this process. + +Only the stream of the object will be written, +i. e. not the dictionary of that object. + +Knowing which +.I stream-object-number +to query requires information about the PDF file +that has to be gained elsewhere, +e. g. by looking into the PDF file with an editor. + +The stream extraction capabilities of +.B pdftosrc +(e. g. regarding understood PDF versions and filter types) +follow the capabilities of the underlying +.B xpdf +program version. + +Currently the generation number of the stream object +is not supported. +The default value 0 (zero) is taken. + +The wording +.I stream-object-number +has nothing to do with the `object streams' introduced +by the Adobe PDF Reference, +5th edition, version 1.6. +.SH EXAMPLES +When using pdftex, +a source file can be embedded into some +.I PDF-file +by using pdftex primitives, +as illustrated by the following example: + +\\immediate\\pdfobj +.RE + stream attr {/Type /SourceFile /SourceName (myfile.zip)} +.RS +.RE + file{myfile.zip} +.RS +.RE +\\pdfcatalog{/SourceObject \\the\\pdflastobj\\space 0 R} + +Then this zip file can be extracted from the +.I PDF-file +by calling +.B pdftosrc +.IR PDF-file . +.SH BUGS +Not all embedded source files will be extracted, +only the first found one. + +Email bug reports to +.B pdftex@tug.org. +.SH SEE ALSO +.BR xpdf (1), +.BR pdfimages (1), +.BR pdftotext (1), +.BR pdftex (1), +.SH AUTHORS +.B pdftosrc +written by Han The Thanh, using +.B xpdf +functionality from Derek Noonburg. + +Man page written by Hartmut Henkel. +.SH COPYRIGHT +Copyright (c) 1996-2006 Han The Thanh, <thanh@pdftex.org> + +This file is part of pdfTeX. + +pdfTeX is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +pdfTeX is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with pdfTeX; if not, write to the Free Software +Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA diff --git a/Master/texmf/doc/man/man1/pktogf.1 b/Master/texmf/doc/man/man1/pktogf.1 index f341a3a2c8e..35ea0f1cd88 100644 --- a/Master/texmf/doc/man/man1/pktogf.1 +++ b/Master/texmf/doc/man/man1/pktogf.1 @@ -1,4 +1,4 @@ -.TH PKTOGF 1 "14 December 1993" "Web2C 7.5.5" +.TH PKTOGF 1 "14 December 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/pktype.1 b/Master/texmf/doc/man/man1/pktype.1 index 60bb34540aa..9851433f778 100644 --- a/Master/texmf/doc/man/man1/pktype.1 +++ b/Master/texmf/doc/man/man1/pktype.1 @@ -1,4 +1,4 @@ -.TH PKTYPE 1 "13 March 1996" "Web2C 7.5.5" +.TH PKTYPE 1 "13 March 1996" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/pltotf.1 b/Master/texmf/doc/man/man1/pltotf.1 index 497f565770f..498704375ed 100644 --- a/Master/texmf/doc/man/man1/pltotf.1 +++ b/Master/texmf/doc/man/man1/pltotf.1 @@ -1,4 +1,4 @@ -.TH PLTOTF 1 "27 December 1992" "Web2C 7.5.5" +.TH PLTOTF 1 "27 December 1992" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/pooltype.1 b/Master/texmf/doc/man/man1/pooltype.1 index 2f50fdbc582..a02050efeb2 100644 --- a/Master/texmf/doc/man/man1/pooltype.1 +++ b/Master/texmf/doc/man/man1/pooltype.1 @@ -1,4 +1,4 @@ -.TH POOLTYPE 1 "27 December 1992" "Web2C 7.5.5" +.TH POOLTYPE 1 "27 December 1992" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/pstopdf.1 b/Master/texmf/doc/man/man1/pstopdf.1 new file mode 100644 index 00000000000..24b3fe68c74 --- /dev/null +++ b/Master/texmf/doc/man/man1/pstopdf.1 @@ -0,0 +1,74 @@ +.TH "PSTOPDF" "1" "December 2006" "pstopdf 2.0" "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" +pstopdf \- convert EPS to PDF + +.SH "SYNOPSIS" +\fBpstopdf\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBpstopdf\fP converts EPS (encapsulated PostScript) to PDF. + +.SH OPTIONS +.TP +.B --help +Print usage and version information. +.TP +.B --convert +Convert EPS to PDF. This option is assumed if none is given. +.TP +.BI --method= string +What method to use for bounding boxes when converting to PDF. +Specify one of \fBcrop\fP, \fBbounded\fP (the default), or \fBraw\fP. +Older versions of ConTeXt used numerical methods (1, 2, or 3). +.TP +.BI --resolution= string +The resolution to use when when converting to pdf. +Specify one of \fBlow\fP, \fBnormal\fP, \fBmedium\fP, \fBhigh\fP, +\fBprinter\fP, \fBprint\fP, \fBscreen\fP, \fBebook\fP, or +\fBdefault\fP. +.TP +.B --request +Handle exa request file. +.TP +.B --watch +Watch folders for conversions (\fIuntested\fP). + +.SH EXAMPLES + +To make \fIcow.pdf\fP: +.EX +pstopdf cow.eps +.EE +or (one of several equivalences): +.EX +pstopdf --convert cow.eps cow.pdf +.EE + + +.SH "SEE ALSO" +.IP \(bu +.BR epstopdf (1), +.BR mptopdf (1), +.BR texexec (1). +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +This (incomplete) manual page was written by Sanjoy Mahajan +<sanjoy@mit.edu>. It is in the public domain. diff --git a/Master/texmf/doc/man/man1/t1dotlessj.1 b/Master/texmf/doc/man/man1/t1dotlessj.1 index fd5778f88a3..e06e3ed922d 100644 --- a/Master/texmf/doc/man/man1/t1dotlessj.1 +++ b/Master/texmf/doc/man/man1/t1dotlessj.1 @@ -1,4 +1,4 @@ -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -93,4 +93,4 @@ An error occurred. .I "Adobe Type 1 Font Format" ' .SH AUTHOR -Eddie Kohler (kohler@icir.org) +Eddie Kohler (kohler@cs.ucla.edu) diff --git a/Master/texmf/doc/man/man1/t1lint.1 b/Master/texmf/doc/man/man1/t1lint.1 index 54077ee6728..ffed5e8337b 100644 --- a/Master/texmf/doc/man/man1/t1lint.1 +++ b/Master/texmf/doc/man/man1/t1lint.1 @@ -1,4 +1,4 @@ -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -45,4 +45,4 @@ Print the version number and some short non-warranty information and exit. .I "Adobe Type 1 Font Format" ' .SH AUTHOR -Eddie Kohler (kohler@icir.org) +Eddie Kohler (kohler@cs.ucla.edu) diff --git a/Master/texmf/doc/man/man1/t1reencode.1 b/Master/texmf/doc/man/man1/t1reencode.1 index 784a329a0e9..170eddcb06f 100644 --- a/Master/texmf/doc/man/man1/t1reencode.1 +++ b/Master/texmf/doc/man/man1/t1reencode.1 @@ -1,4 +1,4 @@ -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -34,9 +34,65 @@ which must contain an encoding in .M dvips 1 format. Alternatively, .I file -can be one of "StandardEncoding", "ISOLatin1Encoding", "ExpertEncoding", -"ExpertSubsetEncoding", or "SymbolEncoding", in which case the -corresponding standard encoding is used. +can be one of the following special names, in which case the corresponding +standard encoding is used. +.Sp +.RS +.TP 23 +.B Name +.B Source +.TP +StandardEncoding +Adobe +.TP +ISOLatin1Encoding +Adobe/ISO (synonym: ISO_8859_1_Encoding) +.TP +ExpertEncoding +Adobe +.TP +ExpertSubsetEncoding +Adobe +.TP +SymbolEncoding +Adobe +.TP +ISOLatin2Encoding +ISO (synonym: ISO_8859_2_Encoding) +.TP +ISOLatin3Encoding +ISO (synonym: ISO_8859_3_Encoding) +.TP +ISOLatin4Encoding +ISO (synonym: ISO_8859_4_Encoding) +.TP +ISOCyrillicEncoding +ISO (synonym: ISO_8859_5_Encoding) +.TP +ISOGreekEncoding +ISO (synonym: ISO_8859_7_Encoding) +.TP +ISOLatin5Encoding +ISO (synonym: ISO_8859_9_Encoding) +.TP +ISOLatin6Encoding +ISO (synonym: ISO_8859_10_Encoding) +.TP +ISOThaiEncoding +ISO (synonym: ISO_8859_11_Encoding) +.TP +ISOLatin7Encoding +ISO (synonym: ISO_8859_13_Encoding) +.TP +ISOLatin8Encoding +ISO (synonym: ISO_8859_14_Encoding) +.TP +ISOLatin9Encoding +ISO (synonym: ISO_8859_15_Encoding) +.TP +KOI8REncoding +- +.RE ' .Sp .TP 5 diff --git a/Master/texmf/doc/man/man1/t1testpage.1 b/Master/texmf/doc/man/man1/t1testpage.1 index 87816fe364f..d3436e0fae9 100644 --- a/Master/texmf/doc/man/man1/t1testpage.1 +++ b/Master/texmf/doc/man/man1/t1testpage.1 @@ -1,4 +1,4 @@ -.ds V 2.34 +.ds V 2.48 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -59,4 +59,4 @@ Print the version number and some short non-warranty information and exit. .PD ' .SH AUTHOR -Eddie Kohler (kohler@icir.org) +Eddie Kohler (kohler@cs.ucla.edu) diff --git a/Master/texmf/doc/man/man1/tangle.1 b/Master/texmf/doc/man/man1/tangle.1 index 43a5da6f3e8..f6b352ee489 100644 --- a/Master/texmf/doc/man/man1/tangle.1 +++ b/Master/texmf/doc/man/man1/tangle.1 @@ -1,4 +1,4 @@ -.TH TANGLE 1 "20 October 2002" "Web2C 7.5.5" +.TH TANGLE 1 "20 October 2002" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/tex.1 b/Master/texmf/doc/man/man1/tex.1 index e13fecc48b3..fcb704e06b5 100644 --- a/Master/texmf/doc/man/man1/tex.1 +++ b/Master/texmf/doc/man/man1/tex.1 @@ -1,4 +1,4 @@ -.TH TEX 1 "21 August 2004" "Web2C 7.5.5" +.TH TEX 1 "6 December 2006" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 @@ -308,11 +308,13 @@ for the file comment instead of the date. .TP .BI -output-directory \ directory -.rb Write output files in +.rb +Write output files in .I directory instead of the current directory. Look up input files in .I directory -first, the along the normal search path. +first, then along the normal search path. See also description of the +TEXMFOUTPUT environment variable. .TP .B -parse-first-line .rb diff --git a/Master/texmf/doc/man/man1/texexec.1 b/Master/texmf/doc/man/man1/texexec.1 index 296f4646631..2cb3e94ca5f 100644 --- a/Master/texmf/doc/man/man1/texexec.1 +++ b/Master/texmf/doc/man/man1/texexec.1 @@ -1,940 +1,640 @@ -.\" texexec.1 -.\" -.\" Revised 2006-Jul-02 by Werner Lemberg <wl@gnu.org>. -. +.TH "TEXEXEC" "1" "December 2006" "texexec 6.2" "ConTeXt" +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac .de EX -. RS -. IP -. nf -. ft CW +.in +3 +.nf +.ft CW .. -. .de EE -. ft R -. fi -. RE +.in -3 +.ft R +.fi .. -. -.TH texexec 1 "October 2000" ConTeXt ConTeXt -. -. -.SH NAME -. -texexec \- ConTeXt and PDF auxiliary program and batch processor -. -. -.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 -.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 + +.SH "NAME" +texexec \- front end to the ConTeXt typesetting system + +.SH "SYNOPSIS" +\fBtexexec\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBtexexec\fP, a \fBruby\fP(1) script, +is the command-line front end to the ConTeXt typesetting +system, an extensive macro package +built on the \fBtex\fP(1) family of typesetting programs. +\fBtexexec\fP provides several facilties: +.IP \(bu +Process a ConTeXt source file, +performing as many runs as +necessary of \fBtex\fP(1), \fBtexutil\fP(1), and +MetaPost (\fBmpost\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 \(bu +Extract or strip documentation from ConTeXt source files +using \fBtexutil\fP(1). +.IP \(bu +Run MetaPost (\fBmpost\fP(1)) to generate figures from MetaPost source. +.IP \(bu +Produce proof sheets of figures used in a ConTeXt source file. +.IP +.SH "OPTIONS" + +All switches are specified in full here but can be abbreviated to the +shortest unique prefix. Thus, \fB--env\fP works the same as +\fB--environment\fP. With no options, \fBtexexec\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. + +.SS "General Options" + +.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 (this prevention can +be handy when tracing installation problems). +.IP "\fB--environments\fP\fI=\fP\fIfile[,file[,...]]\fP" +Specify ConTeXt environment file(s), separated by commas, to use when +processing the source file. This option is useful when converting +from non-ConTeXt file formats without environment or layout settings. +.IP "\fB--help\fP" +Produce a summary of switches +and arguments. A more detailed help is produced by including +\fB--all\fP. +.IP "\fB--interface=\fP\fIlanguage\fP" Specify the language -.B ConTeXt -should use to communicate with you. +ConTeXt should use to communicate with you. Options are -. -.RS -.TP -.B en +.IP +.RS +.IP "\fBen\fP" US English -.TP -.B nl +.IP "\fBnl\fP" Dutch -.TP -.B de +.IP "\fBde\fP" German -.TP -.B uk +.IP "\fBuk\fP" British English -.TP -.B cz +.IP "\fBcz\fP" Czech -.TP -.B it +.IP "\fBit\fP" Italian -.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 -. +.RE +.IP "\fB--keep\fP" +Preserve a few of the temporary files generated while processing by +appending \fI.keep\fP to their name. For example, after .EX -\f(CWtexexec \-\-passon="\-\-src" somefile\fP +texexec --keep document.tex .EE -. -.IP -The double quotes (\f(CW"\fP) are required to prevent -.B \%texexec -from using the switch itself. -. -.TP -.B \-\-program -The name of the TeX program to use -.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: -. +you will find (besides \fIdocument.pdf\fP) \fIdocument.log.keep\fP +and \fIdocument.top.keep\fP. The \fIdocument.top\fP file is where +\fBtexexec\fP wraps \fIdocument.tex\fP with the proper ConTeXt macro +commands to set the output format, etc. +.IP "\fB--once\fP" +Process a file exactly 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--purge\fP" +Get rid of most temporary files generated while processing the source +file. For example, .EX -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 +texexec --purge somefile.tex .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 -. +will generate \fIsomefile.pdf\fP, cleaning up after itself and leaving +only one extra file, \fIsomefile.tuo\fP. See also the \fB--purge\fP +option of +.BR ctxtools (1) +.IP "\fB--purgeall\fP" +Get rid of all temporary files generated while processing the source +file, including the \fIfilename.tuo\fP file. See also the \fB--purge +--all\fP option combination of +.BR ctxtools (1) +.IP "\fB--randomseed=\fP\fINNNN\fP" +Set the random seed. +.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--separation\fP" +Perform color separations. +.IP "\fB--silent\fP" +Suppress a few diagnostic and progress messages. +.IP "\fB--timeout=\fP\fINNN\fP" +Abort the run if a subprocess waits for more than \fINNN\fP seconds; +e.g. while waiting for user input when \fBtex\fP reports an undefined +control sequence. Useful for automated testing scripts, to make sure +the runs finish. +.IP "\fB--usemodules=\fP\fImodule1[,module2,[...]]\fP +Use the comma-separated list of modules. For example, to typeset +\fIdocument.tex\fP using the \fIbib\fP and \fIunits\fP modules: .EX -texexec --format=plain --program=pdftex somefile +texexec --usemodules=bib,units document.tex .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: -. +.IP "\fB--verbose\fP" +Output extra diagnostic information. +.IP "\fB--version\fP" +Print the version number. +.IP + +.SS "Processing ConTeXt Source Files" + +Including specifying paper sizes, formats, and so forth. + +.IP "\fB--arrange\fP" +Perform page rearrangements, which are used to produce booklets. This +option tells ConTeXt to the first \fIn\fP-1 runs without taking +account of arrangements, then on the last run to pay attention to +the arrangement commands in the source file. +.IP "\fB--batchmode\fP" +Process the file in batchmode, which means +to typeset the whole document even if there are errors. More +imformation about \f(CWbatchmode\fP can be found in Donald +E. Knuth's \fITeXbook\fP. +.IP "\fB--nonstopmode\fP" +Process the file in nonstopmode, which means +to typeset the document and report errors, but not to stop at any +error. It is similar to batchmode but more verbose. More +imformation about \f(CWnonstopmode\fP can be found in Donald +E. Knuth's \fITeXbook\fP. +.IP "\fB--bodyfont=\fP\fIfont\fP" +The name of a font to preload for use in +setting the body of the text (OBSOLETE). +.IP "\fB--centerpage\fP" +Center the document 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--dvipdfmx, --dvipdfm, --dpx, --dpm\fP" +Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) +to make a DVI file and \fBdvipdfmx\fP(1) to turn it +into PDF. +.IP "\fB--dvi, --ps, --dvips\fP" +Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) +to make a DVI file and \fBdvips\fP(1) to turn it +into PostScript. It's counterintuitive that \fB--dvi\fP produces +a PostScript file in addition to the DVI file. But that's because +\fB--dvi\fP is shorthand for \fB--dvips\fP; adding the \fB--nobackend\fP +option prevents \fBtexexec\fP's running \fBdvips\fP(1). See also the +\fB--engine\fP option. +.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, \fB--modes=\fP\fIMODELIST\fP" +Allows you to change the mode used while typesetting the +source file. The \fIMODELIST\fP is a comma separated list of modes. +Modes are a conditional-compilation facility +like \f(CW#ifdef\fP in C. So one source file can be used to produce +several typeset documents: one for A4 paper, one for +screen display in full color, one for letter paper, etc. For +example: +.IP +.EX +\f(CWtexexec --pdf --mode=A4 --result=manual-a manual-t.tex\fP +\f(CWtexexec --pdf --mode=letter --result=manual-l manual-t.tex\fP +\f(CWtexexec --pdf --mode=screen --result=manual-s manual-t.tex\fP +.EE +.IP +Here the \fB--mode\fP tells ConTeXt which +mode directives to use when typesetting the source file. The +\fB--result\fP option tells ConTeXt +where to put the output file. +.IP "\fB--modefile=\fP\fIfile\fP" +Load this file before most of the usual processing; usually used for +mode-related material. +.IP "\fB--noarrange\fP" +Ignore arrangement commands in the source file. +.IP "\fB--nobackend\fP" +Do not run the backend, e.g. \fBdvips\fP(1) or \fBdvipdfmx\fP(1). See +the \fB--dvips\fP or \fB--dvipdfmx\fP options. Why would you give one +of those options to choose a backend, yet tell \fBtexexec\fP not to +run the backend? Because each backend has its own syntax for +\f(CW\\special\fP calls. Specifying the backend allows the ConTeXt +macros to use the correct syntax so that when you later run the +backend to produce PostScript or PDF, the specials will be interpreted +correctly. +.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; or one or more pages or page ranges separated by commas. +For example, .EX -texexec --pdfarrange --paper=a5a4 --print=up foo.pdf +\f(CWtexexec --pages=1,7,8-11,14 somefile.tex\fP .EE -. -.IP -This command creates an A5 booklet from a PDF file -.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 -. +.IP "\fB--paperformat=\fP\fIKEY\fP" +For typesetting multiple pages on a +single piece of paper. \fIKEY\fP has the form \fBa4a3\fP +(for printing A4 pages on A3 paper), \fBa5a4\fP +(for printing A5 pages on A4 paper), or in general \fBaMaN\fP. +The actual layout of the pages is specified with the +\fB--printformat\fP option. +.IP "\fB--pdf, --pdftex\fP" +Use \fBpdftex\fP(1) to produce a pdf document (the default). +.IP "\fB--printformat=\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 +\fB--paperformat\fP option to specify the original page +and sheet size. +.IP "\fB--utfbom\fP" +Turn on UTF-8 encoding. +.IP "\fB--xetex, --xtx\fP" +Use \fBxetex\fP(1) to produce a pdf document. +.IP + +.SS "Creating ConTeXt Format Files" + +.IP "\fB--make\fP" +Generate a ConTeXt format file. For example, to make +\fIcont-en.fmt\fP and have it placed in a default format directory: .EX -texexec --pdfselect --paper=S6 --selection=1,9,14 file-1 +texexec --make de .EE -. -.IP -which extracts pages 1, 9, and 14 from -.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 -.IR FILE . -You can specify the form of the output file, as in -. +The most common invocation, which is used by scripts that install a new version +of ConTeXt (see \fBctxtools\fP(1)), uses \fB--all\fP +so that \fBtexexec\fP makes the usual formats: .EX -texexec --listing --pdf readme.now +texexec --make --all .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: -. -.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 -. +.IP "\fB--local\fP" +When searching for TeX or MetaPost formats, look in the current directory +rather than in the location set by the kpse library. See +.BR kpathsea (1) +for more information on path searching. +.IP "\fB--check\fP" +Check and report information about the ConTeXt version, the +distribution, the TeX engine, and the language interfaces/formats. + +.SS "Expert options" + +You should know what you're doing if you use these options! +.IP "\fB--alpha" +Use the TEXMFALPHA environment variable to find and +run an alpha release of ConTeXt. +.IP "\fB--beta" +Use the TEXMFBETA environment variable to find and +run a beta release of ConTeXt. +.IP "\fB--distribution\fP\fI=dist\fP" +Usually one of \fBstandard\fP, \fBweb2c\fP, or \fBmiktex\fP. +\fBtexexec\fP should figure it out automatically, and you shouldn't +need to use this option. +.IP "\fB--engine\fP\fI=texengine\fP" +Specify the program to do the hard work of typesetting. Currently +either \fBpdftex\fP (the default), \fBxetex\fP, or \fBaleph\fP. +The \fBluatex\fP value is experimental. The \fB--engine\fP +option is not usually needed. Instead, let +\fBtexexec\fP figure out the setting based on other command-line +information. See for example the \fB--xetex\fP or \fB--pdf\fP +switches. + +.SS "Postprocess PDF Files" + +.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. .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: -. +\f(CWtexexec --pdfarrange --paperformat=a5a4 --printformat=up foo.pdf\fP +.EE +This command creates an A5 booklet from a PDF file +\fIfoo.pdf\fP. \fB--pdfarrange\fP is used in +conjunction with the following options. +.IP "\fB--pdfcopy\fP" +Copy and perhaps process pages from the pdf file. +The resulting file is \fItexexec.pdf\fP by default, but you can change +that using \fB--result\fP. Use the \fB--scale\fP option to magnify or +demagnify the original pages and the \fB--pages\fP option to select +the pages to copy. Here is an example using all these options: .EX -texexec --make en nl +texexec --pages=4-7 --pdfcopy --scale=750 --result=one images.pdf .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 -. +It takes pages 4-7 from \fIimages.pdf\fP, scales them by 75%, +and copies them to \fIone.pdf\fP. +.IP "\fB--scale=\fP\fIinteger\fP" +If the integer is less than 10, then it is taken as an (integer) +magnification factor. Otherwise, it is taken as a magnification +factor in TeX terms, i.e. with 1000 meaning full scale. +.IP "\fB--paperoffset=\fP\fIdimen\fP" +Specify the space between the +edge of the pages and the beginning of the text block. +.IP "\fB--backspace=\fP\fIdimen\fP" +Specify the inside (gutter) margins. +.IP "\fB--topspace=\fP\fIdimen\fP" +Specify 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 ConTeXt to adjust +the page layout for double-sided output, producing much +more attractive results. + +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. + +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 the \fB--combination\fP option. +.IP "\fB--pdfselect\fP" +Extract pages from a file. Use in combination with the +\fB--selection\fP switch, as in .EX -texexec --make --language=pl,cz,sk --bodyfont=plr en +\f(CWtexexec --pdfselect --paperformat=S6 +--selection=1,9,14 file-1\fP .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 +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). + +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. + +.SS "XML handling" +.IP "\fB--filters=\fP\fIfilter1[,filter2[,...]]\fP +Specify XML filters to use. + +.SS "Extract or Strip Out Documentation" + +.IP "\fB--listing\fP" +Produce a typeset version of the source code in +\fIFILE\fP. You can specify the format of the output +file. For example, use +.EX +\f(CWtexexec --ps --listing readme.now\fP +.EE +to produce a PostScript file called +\fItexexec.ps\fP. + +See also \fB--backspace\fP, \fB--topspace\fP, and \fB--result\fP. +.IP "\fB--module\fP" +Create documentation for ConTeXt, +MetaPost (see \fBmpost\fP(1)), +.BR perl (1), 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: -. +.BR ruby (1) +modules. +Converts the documentation to ConTeXt format and +then typesets a documentated version of the source file. + +Documentation lines in ConTeXt source files are +specified by beginning lines with these strings: + +\f(CW%C\fP : Copyright information + +\f(CW%D\fP : Documentation lines + +\f(CW%I\fP : TeXEdit information lines (mostly in Dutch) + +\f(CW%M\fP : Macro code needed to processs the documentation + +\f(CW%S\fP : Suppressed lines + +The same forms can be used for Perl or ruby scripts, except that the \f(CW%\fP +character (the TeX comment character) is replaced by \f(CW#\fP (the +Perl comment character). + +See also the \fB--documentation\fP option to +.BR ctxtools (1). + +.SS "Process MetaPost Figures" + +.IP "\fB--mpsformats=\fP\fIname\fP" +The name of a MetaPost format file, e.g. \fBmetafun\fP (the default). +.IP "\fB--mptex\fP" +Strips out and typesets TeX code embedded in a +MetaPost file. +.IP "\fB--nomp\fP" +Do not run \fBmpost\fP(1), even if needed. +.IP "\fB--nomprun\fP" +Do not run \fBmpost\fP(1) on embedded +MetaPost code. + +.SS "Producing Proof Sheets of Figures" + +Generate information and proof sheets of one or more (non-EPS) +graphics files. For example, .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 -. +texexec --figures *.png *.jpg +.EE +scans the current directory for PNG and JPG files +and extracts useful information about their sizes and types. By +default, this information is stored in +.IR rlxtools.rli . +Then the given figures are made into a proof sheet (by default +\fItexexec.pdf\fP) according to the method specified by the +\fB--method\fP option. Note that newer versions of +.BR pdftex (1) +do not support TIFF inclusion. +.IP "\fB--method=\fP\fIALTERNATIVE\fP" +Specify one of three options to produce the document containing the images +used in the source file: + +\fBa\fP : A proof sheet with additional +information provided for each figure (the default) + +\fBb\fP : A proof sheet with the graphics only + +\fBc\fP : One figure per page, with the page +clipped to the bounding box of the +figure + +See also \fB--paperoffset\fP, +which allows you to specify an offset to be added to +the page, as in +.EX +texexec --figures --method=c --paperoffset=.5cm *.pdf *.png *.jpg +.EE + +.SH "USAGE" + +Each 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 +\f(CWtexexec --make en nl\fP +.EE + +By default, the language used for typesetting matches the +user-interface language (set with +\fB--interface\fP. It is possible to use one +language for typesetting and another for messages by changing the +relevant settings in \fIcont-usr.tex\fP. These languages can +also be changed on the command line with a command such as +.IP +.RS +\f(CWtexexec --make --language=pl,cz,sk en\fP +.RE +.IP +That command generates a ConTeXt format file with an English user +interface, and the main language set to Polish (\fBpl\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 +.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=pdftex 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 PDF file using \fBpdftex\fP(1). The +\fB--dvips\fP flag tells \fBtexexec\fP to produce a PostScript +file instead. +.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 EXAMPLES +.TP +Produce PDF from ConTeXt source (the .tex extension is optional): +\f(CWtexexec file.tex\fP +.TP +Same as the above but without rerunning for crossreferences, etc.: +\f(CWtexexec --once file.tex\fP +.TP +Produce PostScript from ConTeXt source: +\f(CWtexexec --ps file.tex\fP +.TP +Produce file-a4.pdf using conditional compilation (modes): +\f(CWtexexec --mode=a4 --result=file-a4 file.tex\fP +.TP +Generate format (.fmt) files used by ConTeXt (used during installation): +\f(CWtexexec --make --all\fP + + +.SH "INITIALIZATION" +.IP +\fBtexexec\fP requires ruby. On Unix and Unix-like systems, no special +steps have to be taken to get \fBtexexec\fP to work beyond installing +ruby and having the \fBruby\fP(1) binary in your path. + +.SH "ENCODINGS" +.IP 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 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) +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 ConTeXt translate them to the necessary TeX +commands. For some languages, this approach can also improve the +performance of TeX's hyphenation algorithms. +.IP +ConTeXt supports several of the most commonly used encodings. +Check the files beginning with \fIenco-\fP, \fIlang-\fP, and +\fIfont-\fP in the ConTeXt distribution for more information. +.IP +\fBweb2c\fP distributions (such as \fBteTeX\fP) support a mechanism to +map document encodings to ConTeXt'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 +.EX +\f(CW%& --translate-file=cp1250pl\fP +.EE + or -.BR \%pdftex (1). -You can add lines such as -. -.EX -%& \-\-translate\-file=cp1250pl -.EE -. -.P -or -. -.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 -.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>. + +.EX +\f(CW% --translate=cp1250pl\fP +.EE + +to the beginning of your document, or you can specify the \fB--translate\fP +flag on the command line, as +.EX +\f(CWtexexec --translate=il2pl somefile\fP +.EE + +Using language-specific encodings will make your file less +portable than using ASCII. It may then not be possible for other people to +typeset your documents on their systems. + +.SH "SEE ALSO" +.IP \(bu +\fBbibtex\fP(1), \fBdvipdfmx\fP(1), \fBdvips\fP(1), \fBfmtutil\fP(1), +\fBmakeindex\fP(1), \fBmpost\fP(1), +\fBpdftex\fP(1), \fBpdftk\fP(1), \fBxetex\fP(1), +\fBruby\fP(1), \fBpsnup\fP(1), \fBtex\fP(1), \fBtexshow\fP(1), +\fBtexutil\fP(1). +.IP \(bu +The texexec manual +.IR mtexexec.pdf , +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.IP \(bu +Donald E. Knuth's \fIThe TeXbook\fP. +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +This manpage was written by Tobias Burnus +<burnus@gmx.de> and C.M. Connelly +<c@eskimo.com> and updated by Sanjoy Mahajan <sanjoy@mit.edu>. 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 +.I mtexexec.pdf +manual written by Hans Hagen <pragma@wxs.nl>. diff --git a/Master/texmf/doc/man/man1/texfind.1 b/Master/texmf/doc/man/man1/texfind.1 index d9e88940cdf..ca39d87599b 100644 --- a/Master/texmf/doc/man/man1/texfind.1 +++ b/Master/texmf/doc/man/man1/texfind.1 @@ -1,34 +1,48 @@ -.TH "texfind" "1" "April 2004" "ConTeXt" "teTeX" -.PP +.TH "TEXFIND" "1" "December 2006" "texfind" "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" texfind \- graphical tool to search for text in TeX input files -.PP + .SH "SYNOPSIS" .PP -\fBtexfind\fP [ \fIOPTION\fP \&.\&.\&. ] -.PP +\fBtexfind\fP [ \fIOPTION\fP ... ] + .SH "DESCRIPTION" .PP \fBtexfind\fP is a graphical, interactive tool that helps you searching through TeX input files, including subdirectories, and -allows you to do search/replace tasks using Perl regular +allows you to do search/replace tasks using \fBperl\fP(1) regular expressions. It opens two windows: One displays the directory hierarchy and allows to select different search directories. The second window is used to enter the query and display the results. -.PP + .SH "SEARCHING" -.PP + Enter a search string in the input box at the top, choose the file -extension (*tex by default) and hit ENTER to start the search. The -results will be displayed below. -.PP -The search string is actually a perl regular expression. This gives -you lots of flexibility. The search-and-replace function also uses -Perl regex syntax, but you can also just use simple strings. Currently -there is no way to save changed files. -.PP +extension (\fItex\fP by default) and hit ENTER to start the search. The +results will be displayed in the rest of the window. + +The search string is a perl regular expression (see \fBperlre\fP(1)), +which gives you lots of flexibility. The search-and-replace function +also uses perl regex syntax, but you can also just use simple +strings. Currently there is no way to save changed files. + .SH "MENU" -.PP + Use the right mouse button to open a menu. .HP \fBFile\fP : Currently only used to exit the program @@ -42,31 +56,32 @@ possible to change the file. .PP \fBView\fP : Select specific lines, and adjust word or character wrapping. -.PP + .SH "OPTIONS" .HP \fB\-\-font\fR : specify the font used for the menu. Default is courier. .HP -Other options probably exist - I appreciate input by the program -authors, experienced users or perl geeks. +Other options probably exist. I appreciate input by the program +authors, experienced users, or Perl geeks. .HP .SH "SEE ALSO" -.IP -\fBperlre\fP(1) -.PP + +.IP \(bu +\fBperl\fP(1), \fBperlre\fP(1). +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + .SH "BUGS" -.PP -None known\&. Well - the replace function isn't the most useful one. -.PP + +None known. However, the replace function isn't the most useful one. + .SH "AUTHOR" -.PP + \fBtexfind\fP was written for the ConTeXt package by Hans Hagen and -Ton Otten, PRAGMA\&. -.PP -This manual page was written by Frank Küster <frank@kuesterei\&.ch>, -for the Debian GNU/Linux system\&. It may be used and modified by -others without contacting the author\&. Any mistakes or omissions in -the manual page are my fault; inquiries about or corrections to this -manual page should be directed to me (and not to the primary -author)\&. +Ton Otten, PRAGMA. + +This manual page was written by Frank Küster <frank@kuesterei.ch> +for the Debian GNU/Linux system, and modified by Sanjoy Mahajan +<sanjoy@mit.edu>. It may be used and modified by +others without contacting the authors. diff --git a/Master/texmf/doc/man/man1/texfont.1 b/Master/texmf/doc/man/man1/texfont.1 index 692d5bcf3d9..07071d1cc2f 100644 --- a/Master/texmf/doc/man/man1/texfont.1 +++ b/Master/texmf/doc/man/man1/texfont.1 @@ -1,19 +1,36 @@ -.TH TEXFONT "1" "May 2004" "teTeX " "texfont.pdf" +.TH TEXFONT "1" "December 2006" "texfont 2.2" "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 texfont \- font installation tool for ConTeXt -.PP + .SH "SYNOPSIS" -\fBtexfont\fP [ \fIOPTION\fP \&.\&.\&. ] -.PP +\fBtexfont\fP [ \fIOPTION\fP ... ] + .SH DESCRIPTION -.PP -TeXFont is a perl script that helps to set up and install TeX fonts. + +TeXFont is a +.BR perl (1) +script that helps to set up and install TeX fonts. It was designed for use with ConTeXt, but may also be helpful for users of other formats, like plain TeX or LaTeX. Its use is described -in detail in the files mtexfont.pdf and mfont.pdf. -.PP +in detail in the files \fImtexfont.pdf\fP and \fImfont.pdf\fP. + .SH "OPTIONS" -.PP + .HP \fB\-\-fontroot\fR=\fIpath\fR : texmf font root (automatically determined) .HP @@ -59,26 +76,24 @@ directory) \fB\-\-help\fR : show some more info .HP .SH "SEE ALSO" -.PP -\fBtexexec\fP(1), \fBfontinst\fP(1), \fBtexshow\fP(1), -\fBtexutil\fP(1)\&. -.PP -The TeXFont manual, \fImtexfont\&.pdf\fP\& -.PP -The ConTeXt Font manual, \fImfonts\&.pdf\fP\& -.PP -The TeXExec manual, \fImtexexec\&.pdf\fP\&. -.PP -Donald E\&. Knuth\'s \fIThe TeXbook\fP\&. -.PP +.IP \(bu +\fBtexexec\fP(1), \fBfontinst\fP(1), \fBperl\fP(1), \fBtexshow\fP(1). +.IP \(bu +The ConTeXt Font manual, \fImfonts.pdf\fP +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.IP \(bu +The TeXFont manual, \fImtexfont.pdf\fP +.IP \(bu +The TeXExec manual, \fImtexexec.pdf\fP. +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . +.IP \(bu +Donald E. Knuth\'s \fIThe TeXbook\fP. + .SH "AUTHOR" -.IP -This manual page was written by Frank Küster <frank@kuesterei\&.ch>, -for the Debian GNU/Linux system\&. It may be used and modified by -others without contacting the author\&. Any mistakes or omissions in -the manual page are my fault; inquiries about or corrections to this -manual page should be directed to me (and not to the primary -author)\&. -.IP -The PDF manual and \fBtexfont\fP itself can be obtained from -<http://www\&.pragma-ade\&.com> + +This manual page was written by Frank Küster <frank@kuesterei.ch>, +for the Debian GNU/Linux system, and modified by Sanjoy Mahajan +<sanjoy@mit.edu>. It may be used and modified by others without +contacting the authors. diff --git a/Master/texmf/doc/man/man1/texi2html.1 b/Master/texmf/doc/man/man1/texi2html.1 index d5f080f0301..da6a8a99c78 100644 --- a/Master/texmf/doc/man/man1/texi2html.1 +++ b/Master/texmf/doc/man/man1/texi2html.1 @@ -1,4 +1,4 @@ -.TH TEXI2HTML 1 "4 February 2005" +.TH TEXI2HTML 1 "17 January 2006" .AT 3 .SH NAME texi2html \- a Texinfo to HTML converter @@ -128,7 +128,7 @@ file contains the Top element. Otherwise it creates only one file: .B foo.html .SH VERSION -This is \fItexi2html\fP version 1.76, 4 February 2005. +This is \fItexi2html\fP version 1.76, 17 January 2006. .SH AUTHOR Texi2html was originally written by is Lionel Cons, CERN IT/DIS/OSE, Lionel.Cons@cern.ch. Over time, many other people around the net diff --git a/Master/texmf/doc/man/man1/texmfstart.1 b/Master/texmf/doc/man/man1/texmfstart.1 new file mode 100644 index 00000000000..75240d8afe6 --- /dev/null +++ b/Master/texmf/doc/man/man1/texmfstart.1 @@ -0,0 +1,363 @@ +.TH "TEXMFSTART" "1" "December 2006" "texmfstart 2.0" "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" +texmfstart \- run ConTeXt scripts, make ConTeXt wrapper scripts, view documents + +.SH "SYNOPSIS" +\fB texmfstart\fP [ \fIoptions ...\fP ] [ \fIfilename\fP ] [ \fIarguments ...\fP ] + +.SH "DESCRIPTION" +ConTeXt is a typesetting system based on +the .BR tex (1) +family of programs. +.B texmfstart +is a ConTeXt meta-script that can run subordinate +scripts (subscripts?) such +as +.BR texexec (1), +.BR ctxtools (1), +or +.BR pdftools (1). +It can also generate short wrapper scripts to simplify common uses. +These scripts are often called +.I stubs +in the ConTeXt documentation. The options control +.BR texmfstart 's +behaviour, and the arguments are passed +to the program identified by +.IR filename . + +If the filename is a document, then +.B texmfstart +will start a viewer for that document. For example: +.EX +texmfstart showcase.pdf +.EE +will start an appropriate viewer for +.IR showcase.pdf . +See the +.B EXAMPLES +section. + +.SH OPTIONS + +.SS General: +.TP +.B --help, --version +print version information, usage, and examples. +.TP +.B --verbose +print status and progress information, for example what commands are +being executed. +.TP +.B --clear +don't pass info about locations to child processes. + +.SS Running a program: +.TP +.B --arguments=\fIstr\fP +an alternative for providing the arguments to be passed. For example, +.EX +texmfstart --arguments=b.tex texexec +.EE +will pass +.I b.tex +as the argument to +.BR texexec . +.TP +.B --report +dry run: report what command would be run, but do not run it +.TP +.B --locate +dry run: like \f(CW--report\fP but doesn't print the trailing newline. +.TP +.B --browser +view the document in a web browser (for Windows). +.TP +.B --file=\fIfilename\fP +an alternative way to specify the file (the program to run or document +to open). +.TP +.B --direct +run a program without searching for its location (assumes that the +program is on the PATH). +.TP +.B --execute +use the +.BR ruby (1) +.I exec +function instead of its +.I system +function. +.TP +.B --program=\fIstr\fP +the program space where +.BR kpsewhich (1) +will search (default: context). This information is given to +.B kpsewhich +as its \f(CW-progname\fP option. Usually you don't need this option. + +.SS Creating startup scripts: +.TP +.B --make +create a wrapper script or batch file to run the given file. +The wrapper scripts are put in the current path, which usually means +the current directory. If +\fIall\fP is given as the file, e.g. +.EX +texmfstart --make all +.EE +then make all the ConTeXt wrapper scripts (the stubs). +.TP +.B --windows +when making a wrapper script (stub), create a Windows batch (.bat) file. +Usually you +do not need to specify this option, as +.B texmfstart +will figure out what operating system you are using. +.TP +.B --linux +when making a wrapper script, create a Unix shell script. Usually you +do not need to specify this option, as +.B texmfstart +will figure out what operating system you are using. +.TP +.B --stubpath=\fIpath\fP +specify where to put the wrapper scripts (stubs). +.TP +.B --indirect +always use +.I texmfstart +in the wrapper script (stub). + +.SS Document viewing: +.TP +.B --page=\fInumber\fP +open the document at this page. + +.SS Environments and paths: +.TP +.B --path=\fIstr\fP +change to the specified path. +.TP +.B --tree=\fIstr\fP +use the given TEXMF tree. +.TP +.B --autotree +automatically determine the TEXMF tree to use (the default). +.TP +.B --environment=\fIstr\fP +use the given environment file. Its syntax is given in the +.I mtexmfstart.pdf +manual. +.TP +.B --showenv +print the environment variables known at runtime + +.SS Conditional execution: +.TP +.B --iftouched=\fIfile1,file2\fP +run only when the given files have different timestamps. +.TP +.B --ifchanged=\fIstr\fP +run only when the given file has changed (based on its last-computed MD5 +checksum). + +.SS Special features: +.TP +.B --edit +open the given file in an editor. + +.SH "FILENAME PREFIXES" +.SS +Optional prefixes determine the method used to search for the specified file: +.TP +.I bin:filename +expanded name based on the PATH environment variable +.TP +.I kpse:filename +expanded name based on +.BR kpsewhich (1) +result +.TP +.I rel:filename +expanded name relative to the current directory +.TP +.I env:name +expanded pathname based on environment variable +.I name +.TP +.I path:filename +path part of filename as located by +.BR kpsewhich (1) + +.SH EXAMPLES +.TP +\f(CWtexmfstart texexec.rb file.tex\fP +Locate the +.I texexec.rb +script and run it with +.I file.tex +as its argument. In other words, make +.I file.pdf +from +.IR file.tex . +If +.BR texexec (1) +is properly installed on your system, +this common invocation can be shortened to +.EX +\f(CWtexexec file.tex\fP +.EE +.TP +\f(CWtexmfstart texexec file.tex\fP +Locate the +.BR texexec (1) +program (currently a +.BR ruby (1) +script, +.IR texexec.rb ) +and run it with +.I file.tex +as its argument, producing +.I file.pdf. +This invocation can be shortened to +.EX +texexec file.tex +.EE +.TP +\f(CWtexmfstart ctxtools --updatecontext\fP +Run the +.BR ctxtools (1) +script, updating the ConTeXt installation. This +invocation is equivalent to +.EX +ctxtools --updatecontext +.EE +.TP +\f(CWtexmfstart pstopdf --method=3 cow.eps\fP +Convert +.I cow.eps +to PDF using method 3 of +.BR pstopdf (1). +This invocation is equivalent to +.EX +pstopdf --method=3 cow.eps +.EE +.TP +\f(CWtexmfstart --make --stubpath=/usr/local/bin texexec\fP +Make a wrapper script (stub), either a shell script +.I /usr/local/bin/texexec +on Unix, or a batch file \fI\\usr\\local\\bin\\texexec.bat\fP +on Windows. On Unix (and maybe on Windows?), you need to make +the script executable; see +.BR chmod (1). +.TP +\f(CWtexmfstart --edit kpse:cont-sys.tex\fP +Locate and edit the \fIcont-sys.tex\fP configuration file. +.TP +\f(CWtexmfstart --ifchanged=whatever.mp texexec --mpgraphic whatever.mp\fP +Rerun +.B texexec +if +.I whatever.mp +has changed since the last use of +.IR --ifchanged . +.TP +\f(CWtexmfstart --ifchanged=whatever.mp bin:echo rerun MetaPost\fP +If the +.I whatever.mp +source file has changed since the last use of +.IR --ifchanged , +then use the +.BR echo (1) +command to tell the user to rerun MetaPost +.RB "(see " mpost (1)). +This example shows that +.B texmfstart +can be used to run any script, not just ConTeXt scripts. The +\f(CWbin:\fP prefix tells +.B texmfstart +not to search for +.I echo +in the TEXMF tree(s), but to assume that it's an executable somewhere +on the PATH. +.TP +\f(CWtexmfstart --ifchanged=whatever.mp --direct echo rerun MetaPost\fP +This invocation has the same effect as the preceding example, but +using \f(CW--direct\fP instead of the \f(CWbin:\fP prefix, again to tell +.B texmfstart +not to search for the +.I echo +command. + +.SH FILES +.TP +.I file.md5 +MD5 checksum file used for the \f(CW--ifchanged\fP option. + +.SH ENVIRONMENT +.TP +PATH +For expanding filenames given with a +.I bin +prefix. +.TP +TEXMFSTART_EDITOR, EDITOR, editor +Editor to use with +.IR --edit . +The environment variables are looked up in that order, with the first +setting found taking priority. + +.SH "SEE ALSO" +.IP \(bu +.BR ctxtools (1), +.BR kpsewhich (1), +.BR makempy (1), +.BR mpost (1), +.BR pdftools (1), +.BR pstopdf (1), +.BR texexec (1), +.BR texfont (1), +.BR texutil (1). +.IP \(bu +.URL "http://www.contextgarden.net" "ConTeXt wiki" . +.IP \(bu +The +.B texmfstart +manual, +.IR mtexmfstart.pdf , +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . + +.SH BUGS +On Unix, opening a PDF document first tries +.B pdfopen +then +.BR acroread , +neither of which may be present on your system. + +The \f(CW--report\fP option doesn't work if you specify a filename +prefix (i.e. it does a real run instead of a dry run). + +.SH "AUTHOR" +ConTeXt is written and maintained by +.URL "http://www.pragma-ade.com" "Hans Hagen" . +This man page, which is in the public domain, was written by Sanjoy +Mahajan based on the +.I mtexmfstart.pdf +manual. diff --git a/Master/texmf/doc/man/man1/texutil.1 b/Master/texmf/doc/man/man1/texutil.1 index 5a6ea8d365e..51ac904d503 100644 --- a/Master/texmf/doc/man/man1/texutil.1 +++ b/Master/texmf/doc/man/man1/texutil.1 @@ -1,266 +1,22 @@ -.TH TEXUTIL 1 UMFT -.de EX -.sp -.in +5 -.nf -.ft CW -.. -.de EE -.in -5 -.ft R -.sp -.fi -.. -.TH "texutil" "1" "October 2000" "ConTeXt" "CONTEXT" -.PP +.TH "TEXUTIL" "1" "December 2006" "texutil 9.1" "ConTeXt" + .SH "NAME" -texutil \- ConTeXt auxiliary program -.PP +texutil \- ConTeXt utility program + .SH "SYNOPSIS" -\fBtexutil\fP [ \fIOPTION\fP\&.\&.\&. ] \fIFILENAME\fP[\&.\&.\&.] -.PP +\fBtexutil\fP [ \fIOPTION\fP... ] \fIFILENAME\fP[...] + .SH "DESCRIPTION" -.PP -When processing a source file, \fBConTeXt\fP (via \fBtexexec\fP(1)) -saves information (including table of contents, tables of figures and -tables, index entries, cross-references) in a ``utility file\'\' called -\fIFILENAME\fP\fI\&.tui\fP\&. After each successful run, this -utility file is postprocessed by \fBtexutil\fP to organize the -information for the next run\&. -.PP -\fBtexutil\fP performs a number of useful functions: -.PP -.IP o -Postprocessing references, including sorting index and list -entries (with \fB--references\fP) -.IP o -Extracting documentation and other types of information from -\fBConTeXt\fP source files (with -\fB--documents\fP) -.IP o -Logfile analysis (with \fB--logfile\fP) -.IP o -Collecting information about graphic files to help with -typesetting (with \fB--figures\fP) -.IP o -Converting EPS files to a PDF format suitable for inclusion in -PDF files generated with \fBpdftex\fP(1) (with ---\fB--epspage\fP and -\fB--epstopdf\fP) -.PP -.SH "OPTIONS" -.PP -All switches are specified here in full, but can be abbreviated to the -shortest unique string\&. Thus, \fB--ver\fP works the same as -\fB--verbose\fP provided that there is no other flag beginning with -``\f(CWver\fP\'\'\&. -.PP -.SH "General Options" -.PP -.IP "\fB--help\fP" -Print a usage summary to stdout\&. -.IP "\fB--interface=\fP\fILANGUAGECODE\fP" -Specify the language for -messages\&. One of \fBen\fP (English), \fBde\fP (German), or -\fBnl\fP (Dutch)\&. The default language is English\&. -.IP "\fB--outputfile=\fP\fIFILENAME\fP" -Specify the name of the -output file\&. -.IP "\fB--purge\fP [ \fIBASENAME\fP ]" -Delete temporary files\&. -Specifying an optional \fIBASENAME\fP will only -affect the temporary files that begin with that -\fIBASENAME\fP\&. -.IP "\fB--silent\fP" -Redirects stdout to the \fIlog\fP file -(\fItexutil\&.log\fP, by default)\&. When used with -\fB--verbose\fP, a summary is printed to stdout, while -any other output is written to the \fIlog\fP file\&. -.IP -For example, -.IP -.EX -\f(CWtexutil --figures --silent --verbose somefile\&.png\fP -.EE -.IP -will output something like -.IP -.EX -\f(CWn=somefile\&.png t=png x=0bp y=0bp w=443bp h=591bp\fP -.EE -.IP -to stdout, placing other output into -\fItexutil\&.log\fP\&. This information can be piped -into another program for further processing\&. -.IP "\fB--type=\fP\fISUFFIX\fP" -Specify the \fISUFFIX\fP of the -file you want \fBtexutil\fP to process\&. -.IP "\fB--verbose\fP" -Print diagnostic messages to the screen\&. -.PP -.SH "Postprocessing References" -.PP -The \fB--references\fP flag instructs \fBtexutil\fP to process -information about cross-references, index entries, and other data -requiring more than one pass to process in the \fBConTeXt\fP utility -file\&. -.PP -Index and sorted list entries are sorted before being written out; -redundant index entries are removed\&. -.PP -\fBtexutil\fP is called automatically by \fBtexexec\fP(1) during its -processing runs unless you specify otherwise\&. \fBtexutil\fP can also -be run by hand, using the form -.PP -.EX -\f(CWtexutil --references\fP \fIFILENAME\fP -.EE -.PP -This command would cause \fBtexutil\fP to load the utility file -\fIFILENAME\fP\fI\&.tui\fP, sort and convert the contents of that -file, and write the results to \fIFILENAME\fP\fI\&.tuo\fP\&. -.PP -Options specific to this mode are: -.IP "\fB--ij\fP" -Sort ``\f(CWIJ\fP\'\' as ``\f(CWY\fP\'\'\&. Often used when -processing files written in Dutch\&. -.IP "\fB--high\fP" -Convert ``high\'\' ASCII values into equivalent TeX -commands\&. This switch is provided for backward -compatibility\&. -.IP "\fB--quotes\fP" -Take \fBtex\fP(1) accent commands into -consideration when sorting\&. (Otherwise, quotes are -considered to be boundary characters for strings\&.) -.IP "\fB--tcxpath=\fP\fIPATH\fP" -Specify path to \fItcx\fP -filter files for translating -between encodings\&. -.PP -.SH "Extracting Information from ConTeXt Source Files" -.PP -\fBConTeXt\fP source files often contain documentation (see -USAGE for more information about the format) or other -information that can be extracted by \fBtexutil\fP when called with the -\fB--documents\fP flag: -.PP -.EX -\f(CWtexutil --documents\fP \fIFILENAME\fP -.EE -.PP -This command produces a file called \fIFILENAME\fP\fI\&.ted\fP -from a ConTeXt file called \fIFILENAME\fP\fI\&.tex\fP\&. -.PP -The \fB--sources\fP flag does the opposite: Documentation lines are -stripped out of the output, which is written to a file called -\fIFILENAME\fP\fI\&.tes\fP\&. -.PP -Historically, \fBConTeXt\fP source files included other forms of -information -- such as syntax definitions, macro definitions, and -editor templates -- that can be extracted with the following flags: -.PP -.IP "\fB--infos\fP" -Extract TeXEdit macro information -(\fItex\fP->\fItud\fP -- see -USAGE) -.IP "\fB--setups\fP" -Extract \fBConTeXt\fP syntax definitions -(\fItex\fP->\fItexutil\&.tus\fP) -.IP "\fB--templates\fP" -Extract TeXEdit editor templates -(\fItex\fP->\fItud\fP) -.PP -.SH "Analyzing Log Files" -.PP -Calling \fBtexutil\fP with the \fB--logfile\fP option allows you to -extract information about problems with your \fBConTeXt\fP source file -from the log file produced during a \fBtexexec\fP(1) run\&. -.PP -You can specify what information \fBtexutil\fP should report with the -following options: -.IP "\fB--box\fP" -Extract information about overfull boxes\&. By -default, this flag will cause \fBtexedit\fP to report both -horizontal and vertical overfull boxes\&. If you\'re only -interested in one kind, you can specify \fB--hbox\fP or -\fB--vbox\fP instead\&. -.IP "\fB--criterium=\fP\fISIZE\fP" -Exclude reports about boxes that -are less than \fISIZE\fP points too large\&. -.IP "\fB--unknown\fP" -Extract messages about missing references or -figures\&. -.PP -.SH "Gathering Information about Figures" -.PP -The \fB--figures\fP flag tells \fBtexutil\fP to generate information -about one or more (non-EPS) graphics files for use in typesetting\&. -Called as, for example, -.PP -.EX -\f(CWtexutil --figures *\&.png *\&.tif\fP -.EE -.PP -\fBtexutil\fP will scan the current directory for PNG and TIFF files -and extract some useful information about their sizes and types\&. By -default, this information is stored in a file called -\fItexutil\&.tuf\fP, which is consulted by \fBConTeXt\fP when -typesetting a page with a non-EPS image file -- see the example given -for the \fB--silent\fP flag for an alternative\&. -.PP -This flag is especially useful when you plan to typeset a file of -previews of graphic files -- see the discussion of the -\fB--figures\fP flag in the \fBtexexec\fP(1) manpage\&. -.PP -.SH "Converting EPS Files for PDF Inclusion" -.PP -\fBtexutil\fP can also convert EPS files to PDF format for inclusion in -PDF files generated with \fBpdftex\fP(1) or \fBpdfetex\fP(1)\&. -.PP -.IP "\fB--epspage\fP" -Adjust the bounding box of an EPS file to the -dimensions of the output page\&. This option also removes some -redundant information and marks files as converted so that they -will not be affected by subsequent runs\&. -.IP "\fB--epstopdf\fP" -Calls \fBgs\fP(1) to convert the specified -EPS graphic files into PDF format\&. -.PP -.SH "USAGE" -.PP -.SH "Embedded Documentation Format" -.PP -Documentation lines included in \fBConTeXt\fP source files can be -specified by beginning lines with the following strings: -.IP "\f(CW%C\fP" -Copyright information -.IP "\f(CW%D\fP" -Documentation lines -.IP "\f(CW%I\fP" -TeXEdit information lines (mostly in Dutch) -.IP "\f(CW%M\fP" -Macro code needed to processs the documentation -.IP "\f(CW%S\fP" -``Suppressed\'\' lines -.PP -The same forms can be used for Perl scripts, except that the -``\f(CW%\fP\'\' characters are replaced by ``\f(CW#\fP\'\' characters\&. See -the source for \fBtexutil\fP for an example\&. -.PP -.SH "SEE ALSO" -.PP -\fBgs\fP(1), \fBpdfetex\fP(1), \fBpdftex\fP(1), -\fBtexexec\fP(1), \fBtexshow\fP(1)\&. -.PP -Web page: <http://www\&.pragma-ade\&.com/> -.PP + +This program, whether as a Perl or the newer ruby script, is +deprecated and many of its features are available in +\fBctxtools\fP(1), \fBgs\fP(1), \fBpdftools\fP(1), and +\fBtexexec\fP(1). + +.SH SEE ALSO + +\fBctxtools\fP(1), \fBgs\fP(1), \fBpdftools\fP(1), \fBtexexec\fP(1) + .SH "AUTHOR" -.PP -This manpage was written by C\&.M\&. Connelly -<c@eskimo\&.com> and Tobias Burnus -<burnus@gmx\&.de>\&. It is based on -the \fBtexutil\fP manual written by Hans Hagen -<pragma@wxs\&.nl>\&. -.PP -The PDF manual and \fBtexutil\fP itself can be obtained at -<http://www\&.pragma-ade\&.com/pragma-ade/texutil\&.htm>\&. + +This skeleton man page was written by Sanjoy Mahajan <sanjoy@mit.edu>. diff --git a/Master/texmf/doc/man/man1/tftopl.1 b/Master/texmf/doc/man/man1/tftopl.1 index 8f66a461e1b..b4188f09b39 100644 --- a/Master/texmf/doc/man/man1/tftopl.1 +++ b/Master/texmf/doc/man/man1/tftopl.1 @@ -1,4 +1,4 @@ -.TH TFTOPL 1 "17 December 1994" "Web2C 7.5.5" +.TH TFTOPL 1 "17 December 1994" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/ttftotype42.1 b/Master/texmf/doc/man/man1/ttftotype42.1 new file mode 100644 index 00000000000..02b7d428b1f --- /dev/null +++ b/Master/texmf/doc/man/man1/ttftotype42.1 @@ -0,0 +1,78 @@ +.ds V 2.48 +.de M +.BR "\\$1" "(\\$2)\\$3" +.. +.de Sp +.if n .sp +.if t .sp 0.4 +.. +.TH TTFTOTYPE42 1 "LCDF Typetools" "Version \*V" +.SH NAME +ttftotype42 \- create PostScript Type 42 wrapper of TrueType font +.SH SYNOPSIS +.B ttftotype42 +\%[\fIinput\fR [\fIoutput\fR]] +.SH DESCRIPTION +.BR Ttftotype42 +converts TrueType or TrueType-flavored OpenType font programs into +PostScript Type 42 format, which is a wrapper for the TrueType outlines. +This conversion preserves all outlines and hint information from the +original TrueType font. The Type 42 wrapper uses glyph names identical to +those expected by +.M pdflatex 1 +or +.M otftotfm 1 , +so encoding files suitable for TrueType fonts and +.B pdflatex +will also work for the Type 42 fonts and +.M dvips 1 . +If the file +.I output +is not specified output goes to the standard output. +If the file +.I input +is not specified input comes from the standard input. +' +.SH OPTIONS +.PD 0 +.TP 5 +.BI \-o " file\fR, " \-\-output " file" +Write output font to +.IR file +instead of the standard output. +' +.Sp +.TP 5 +.BR \-q ", " \-\-quiet +Do not generate any error messages. +' +.Sp +.TP 5 +.BR \-h ", " \-\-help +Print usage information and exit. +' +.Sp +.TP 5 +.BR \-v ", " \-\-version +Print the version number and some short non-warranty information and exit. +.PD +' +.SH "SEE ALSO" +.LP +.M cfftot1 1 , +.M otftotfm 1 , +.M pdftex 1 , +.M dvips 1 +.LP +Adobe Technical Note #5012, +.IR "The Type 42 Font Format Specification" +.LP +.IR "OpenType Specification" , +Version 1.4 +' +.SH AUTHOR +Eddie Kohler (kohler@cs.ucla.edu) +.PP +The latest version is available from: +.br +http://www.lcdf.org/type/ diff --git a/Master/texmf/doc/man/man1/vftovp.1 b/Master/texmf/doc/man/man1/vftovp.1 index 3306e1d8c66..6a323fc718f 100644 --- a/Master/texmf/doc/man/man1/vftovp.1 +++ b/Master/texmf/doc/man/man1/vftovp.1 @@ -1,4 +1,4 @@ -.TH VFTOVP 1 "19 December 1994" "Web2C 7.5.5" +.TH VFTOVP 1 "19 December 1994" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/vptovf.1 b/Master/texmf/doc/man/man1/vptovf.1 index 3d85680e9ba..ac78f8393fa 100644 --- a/Master/texmf/doc/man/man1/vptovf.1 +++ b/Master/texmf/doc/man/man1/vptovf.1 @@ -1,4 +1,4 @@ -.TH VPTOVF 1 "16 December 1994" "Web2C 7.5.5" +.TH VPTOVF 1 "16 December 1994" "Web2C 7.5.6" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf/doc/man/man1/weave.1 b/Master/texmf/doc/man/man1/weave.1 index 5837755e54d..3a958824d41 100644 --- a/Master/texmf/doc/man/man1/weave.1 +++ b/Master/texmf/doc/man/man1/weave.1 @@ -1,4 +1,4 @@ -.TH WEAVE 1 "4 May 1993" "Web2C 7.5.5" +.TH WEAVE 1 "4 May 1993" "Web2C 7.5.6" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 |