diff options
82 files changed, 2280 insertions, 744 deletions
diff --git a/Master/texmf/doc/man/man1/amstex.1 b/Master/texmf/doc/man/man1/amstex.1 index 2c0e4f37122..34a1424a828 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.6" +.TH AMSTEX 1 "27 December 1992" "Web2C 7.5.7" .\"===================================================================== .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/bbox.1 b/Master/texmf/doc/man/man1/bbox.1 new file mode 100644 index 00000000000..9efc9e05c2d --- /dev/null +++ b/Master/texmf/doc/man/man1/bbox.1 @@ -0,0 +1,67 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "BBOX" "1" "21 April 2004" "" "" +.SH NAME +bbox \- prints out the bounding box of a rawppm or rawpbm image +.SH SYNOPSIS + +\fBbbox\fR [ \fB-l\fR] [ \fB-r\fR] [ \fB-h\fR] [ \fB-V\fR] [ \fB\fIrawpbmfile\fB\fR] + +.SH "DESCRIPTION" +.PP +\fBbbox\fR reads a rawppm or rawpbm file +and prints out the bounding box of the image (as postscript comment and +in postscript points, i.e. 1/72dpi) as well as the high resolution +bounding box. Input is read from standard input if no filename is +specified. +Example output: + +.nf + %%BoundingBox: 12 253 829 837 + %%HiResBoundingBox: 12.500000 253.000000 828.500000 837.00000 + +.fi +.PP +\fBbbox\fR has only very limited memory requirements +as it reads the input line by line and thus needs to store only one picture +line in memory. +.SH "OPTIONS" +.TP +\fB-h | --help \fR +Show summary of options. +.TP +\fB-V \fR +Show version of program. +.TP +\fB-r \fR +resolution of picture in dpi +.TP +\fB-l \fR +loose bounding box (integer bounding box is expanded by 1 +point, hires bounding box is not widened) +.SH "SEE ALSO" +.PP +ps2eps (1) +.SH "AUTHOR" +.PP +\fBbbox\fR was written by Roland Bless. +.SS "ACKNOWLEDGMENTS" +.PP +An earlier version of this manual page was originally written by +Rafael Laboissiere <rafael@debian.org> for +the Debian system. Thank you Rafael! Permission is +granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation +License, Version 1.1 or any later version published by the Free +Software Foundation; with no Invariant Sections, no Front-Cover +Texts and no Back-Cover Texts. +.SH "BUGS" +.PP +Though the code is quite small and the probability for bugs +is now small, there may be some left somewhere between the lines. +In case you find one, please send a short description with +\fBbbox\fR version number to <roland@bless.de> (please allow some time +to reply). diff --git a/Master/texmf/doc/man/man1/bibtex.1 b/Master/texmf/doc/man/man1/bibtex.1 index e75b55d90b2..350c213d7d9 100644 --- a/Master/texmf/doc/man/man1/bibtex.1 +++ b/Master/texmf/doc/man/man1/bibtex.1 @@ -1,4 +1,4 @@ -.TH BIBTEX 1 "8 January 2007" "bibtex 0.99c" "Web2C 7.5.6" +.TH BIBTEX 1 "8 January 2007" "bibtex 0.99c" "Web2C 7.5.7" .\"===================================================================== .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 0917c946fb3..f3a257af747 100644 --- a/Master/texmf/doc/man/man1/cfftot1.1 +++ b/Master/texmf/doc/man/man1/cfftot1.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/cweb.1 b/Master/texmf/doc/man/man1/cweb.1 index 295ceafbf1e..1b0bf155150 100644 --- a/Master/texmf/doc/man/man1/cweb.1 +++ b/Master/texmf/doc/man/man1/cweb.1 @@ -1,4 +1,4 @@ -.TH CWEB 1 "19 December 2004" "Web2C 7.5.6" +.TH CWEB 1 "19 December 2004" "Web2C 7.5.7" . .SH NAME ctangle, cweave \- translate CWEB to C and/or TeX diff --git a/Master/texmf/doc/man/man1/dmp.1 b/Master/texmf/doc/man/man1/dmp.1 index a3c9900cfb2..40d99e601b2 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.6" +.TH DMP 1 "4 January 1998" "Web2C 7.5.7" .\"===================================================================== .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 3ae24bfeba3..d6ccc81aa28 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.6" +.TH DVICOPY 1 TeX "24 January 1999" "Web2C 7.5.7" .SH NAME dvicopy \- produce modified copy of DVI file .SH SYNOPSIS diff --git a/Master/texmf/doc/man/man1/dvilj.1 b/Master/texmf/doc/man/man1/dvilj.1 index 40de4732e83..7edcf5f8836 100644 --- a/Master/texmf/doc/man/man1/dvilj.1 +++ b/Master/texmf/doc/man/man1/dvilj.1 @@ -1,275 +1,682 @@ -.TH DVILJK 1 "10 June 1996" -.ad b -.SH NAME +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sh \" Subsection heading +.br +.if t .Sp +.ne 5 +.PP +\fB\\$1\fR +.PP +.. +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" 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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.\" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.hy 0 +.if n .na +.\" +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). +.\" Fear. Run. Save yourself. No user-serviceable parts. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "DVILJ 1" +.TH DVILJ 1 "2007-07-05" "Version 2.6p4" "TeX-Live" +.SH "NAME" dvilj4, dvilj4l, dvilj2p, dvilj \- convert a TeX DVI file to PCL, for HP LaserJet printers -.SH SYNOPSIS -\f3dvilj\f1 -[\f3\-\-D\f2number\f1] -[\f3\-c\f2copies\f1] -[\f3\-d\f2mode\f1] -[\f3\-D\f1] -[\f3\-E\f1] -[\f3\-e\f2outputfile\f1] -[\f3\-f\f2frompage\f1] -[\f3\-g\f1] -[\f3\-h\f2headerfile\f1] -[\f3\-l\f1] -[\f3\-M\f2flag\f1] -[\f3\-m\f2mag\f1] -[\f3\-p\f2pages\f1] -[\f3\-q\f1] -[\f3\-r\f1] -[\f3\-t\f2topage\f1] -[\f3\-s\f2pagesize\f1] -[\f3\-v\f1] -[\f3\-V\f2mode\f1] -[\f3\-w\f1] -[\f3\-x\f2xoff(mm)\f1] -[\f3\-y\f2yoff(mm)\f1] -[\f3\-X\f2xoff(dots)\f1] -[\f3\-Y\f2yoff(dots)\f1] -[\f3\-z\f1] -[\f3\-\f1] -[\f2filename\f1] -.SH DESCRIPTION -Dvilj and siblings convert TeX-output .dvi files into PCL (the -Hewlett-Packard Printer Control Language) commands suitable for printing -on a HP LaserJet+, HP LaserJet IIP (using dvilj2p), HP LaserJet 4 (using -dvilj4), and fully compatible printers. +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +.Vb 4 +\& dvilj [--Dnumber] [-ccopies] [-dmode] [-D] [-E] [-eoutputfile] +\& [-ffrompage] [-g] [-hheaderfile] [-l] [-Mflag] [-mmag] [-ppages] +\& [-q] [-r] [-ttopage] [-spagesize] [-v] [-Vmode] [-w] [-xxoff(mm)] +\& [-yyoff(mm)] [-Xxoff(dots)] [-Yyoff(dots)] [-z] [filename] +.Ve +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +\&\fBdvilj\fR and siblings convert TeX-output \f(CW\*(C`.dvi\*(C'\fR files into \s-1PCL\s0 (the +Hewlett-Packard Printer Control Language) commands suitable for +printing on a \s-1HP\s0 LaserJet+, \s-1HP\s0 LaserJet \s-1IIP\s0 (using \fBdvilj2p\fR), \s-1HP\s0 +LaserJet 4 (using \fBdvilj4\fR), and fully compatible printers. .PP -Dvilj4 also provides support for the builtin Intellifont and TrueType -fonts; TFM and VF files are provided in the distribution. -Virtual fonts are not supported directly by Dvilj, so you must run -.BR dvicopy (1) -first, or otherwise expand the virtual fonts +\&\fBdvilj4\fR also provides support for the builtin Intellifont and +TrueType fonts; \s-1TFM\s0 and \s-1VF\s0 files are provided in the distribution. +Virtual fonts are not supported directly by \fBdvilj\fR, so you must run +\&\fIdvicopy\fR\|(1) first, or otherwise expand the virtual fonts .PP -All programs are generated from one source file dvi2xx.c. -They are usually called via a shell script or as a line printer -filter. One such script, dvihp, is included in the distribution. It -provides command-line options similar to those of dvips(1). -.SH OPTIONS -.TP \w'-Dnumber'u+2n -\f3--D\f2number\f1 -Debug according to the bits of \f2number\f1; see the Kpathsea manual for -values. Also turns on general verbosity. -.TP -\f3-c\f2number\f1 -print each page \f2number\f1 times (including original) -.TP -\f3-d\f2number\f1 -print in duplex mode. The option -d\f21\f1 means long edge binding, --d\f22\f1 stands for short edge binding. This option is only -selectable from \fIdvilj2p\fP, and is known to work on the LaserJet IId, -LaserJet IIId, and LaserJet 4. -.TP -\f3-D\f1[-] -Double-sided printing - see below; -D\f21\f1 prints odd sides only, --D\f22\f1 is for even pages, a trailing \f2-\f1 suppresses printing of -empty padding pages. -.TP -\f3-E\f1 -Switch printer into econo mode (dvilj4 only). -.TP -\f3-e\f2outfile\f1 -Send output to \f2outfile\f1 instead of the basename of dvi file -extended with `.lj'. -If \f2outfile\f1 is `-' (as in `-e-') the output is directed +All programs are generated from one source file \fIdvi2xx.c\fR. They are +usually called via a shell script or as a line printer filter. One +such script, \fIdvihp\fR\|(1), is included in the distribution. It provides +command-line options similar to those of \fIdvips\fR\|(1). +.SH "OPTIONS" +.IX Header "OPTIONS" +.IP "\fB\-\-D\fR\fInumber\fR" 4 +.IX Item "--Dnumber" +Debug according to the bits of \fInumber\fR; see the \fIkpathsea\fR\|(3) manual +for values. Also turns on general verbosity. +.IP "\fB\-c\fR\fInumber\fR" 4 +.IX Item "-cnumber" +Print each page \fInumber\fR times (including original) +.IP "\fB\-d\fR\fInumber\fR" 4 +.IX Item "-dnumber" +print in duplex mode. The option \fB\-d1\fR means long edge binding, +\&\fB\-d2\fR stands for short edge binding. This option is only selectable +in \fBdvilj4\fR and \fBdvilj2p\fR. +.IP "\fB\-D\fR\fI[\-12]\fR" 4 +.IX Item "-D[-12]" +Double-sided printing \- see below; \fB\-D1\fR prints odd sides only, +\&\fB\-D2\fR is for even pages, a trailing \fB\-\fR suppresses printing of empty +padding pages. +.IP "\fB\-E\fR" 4 +.IX Item "-E" +Switch printer into econo mode (\fBdvilj4\fR only). +.IP "\fB\-e\fR\fIoutfile\fR" 4 +.IX Item "-eoutfile" +Send output to \fIoutfile\fR instead of the basename of dvi file extended +with \f(CW\*(C`.lj\*(C'\fR. If outfile is \fB\-\fR (as in \f(CW\*(C`\-e\-\*(C'\fR) the output is directed to standard output and can be directly piped into a spooler. -.TP -\f3-f\f2pagenum\f1 -Print pages with TeX page numbers greater than or equal to \f2pagenum\f1. -.TP -\f3-g\f1 -``go'' mode: do not reset printer at start of job. -.TP -\f3-h\f2headerfile\f1 -Copy \f2headerfile\f1 to output before translation of the DVI file. -Used to send arbitrary commands to the laserprinter. -.TP -\f3-l\f1 -print output in landscape mode; supported -only by dvilj2p and dvilj4. -.TP -\f3-M\f2flag\f1 -Do (not) call mktexpk to generate fonts on demand. \f3-M\f21\f1 and -\f3-M\f1 are equivalent. \f3-M\f20\f1 enables invoking mktexpk. (This -is the same as dvips.) The default behavior (i.e., if no -\f3-M\f1 option is given) is chosen at compile-time; as distributed, -mktexpk is enabled. \f3-M\f1 is only valid if -dvi2xx was compiled with support for mktexpk. -.TP -\f3-m\f2magnification\f1 +.IP "\fB\-f\fR\fIpagenum\fR" 4 +.IX Item "-fpagenum" +Print pages with TeX page numbers greater than or equal to \fIpagenum\fR. +.IP "\fB\-g\fR" 4 +.IX Item "-g" +\&\fIGo\fR mode: do not reset printer at start of job. +.IP "\fB\-h\fR\fIheaderfile\fR" 4 +.IX Item "-hheaderfile" +Copy \fIheaderfile\fR to output before translation of the \s-1DVI\s0 file. Used +to send arbitrary commands to the laserprinter. +.IP "\fB\-l\fR" 4 +.IX Item "-l" +Print output in landscape mode; supported only by \fBdvilj2p\fR and +\&\fBdvilj4\fR. +.IP "\fB\-M\fR\fIflag\fR" 4 +.IX Item "-Mflag" +Do (not) call \fImktexpk\fR\|(1) to generate fonts on demand. \fB\-M1\fR and \fB\-M\fR +are equivalent. \fB\-M0\fR enables invoking \fImktexpk\fR\|(1). (This is the same +as in \fIdvips\fR\|(1).) The default behavior (i.e., if no \fB\-M\fR option is +given) is chosen at compile\-time; as distributed, mktexpk is enabled. +.IP "\fB\-m\fR\fImagnification\fR" 4 +.IX Item "-mmagnification" Specify the magnification to use. The following are available: -.br -\f3-m#\f2usermag\f1 e.g., \f3#900\f1 -.br -\f3-m0\f1 equivalent to \f3-m#1000\f1 -.br -\f3-mh\f1 equivalent to \f3-m#1095\f1 -.br -\f3-m1\f1 equivalent to \f3-m#1200\f1 -.br -\f3-mq\f1 equivalent to \f3-m#1250\f1 -.br -\f3-m2\f1 equivalent to \f3-m#1440\f1 -.br -\f3-m3\f1 equivalent to \f3-m#1728\f1 -.br -\f3-m4\f1 equivalent to \f3-m#2074\f1 -.br -\f3-m5\f1 equivalent to \f3-m#2488\f1 -.TP -\f3-p\f2pagecount\f1 -print \f2pagecount\f1 pages after the starting page. -.TP -\f3-q\f1 +.Sp +.Vb 9 +\& -m#usermag e.g., #900 +\& -m0 equivalent to -m#1000 +\& -mh equivalent to -m#1095 +\& -m1 equivalent to -m#1200 +\& -mq equivalent to -m#1250 +\& -m2 equivalent to -m#1440 +\& -m3 equivalent to -m#1728 +\& -m4 equivalent to -m#2074 +\& -m5 equivalent to -m#2488 +.Ve +.IP "\fB\-p\fR\fIpagecount\fR" 4 +.IX Item "-ppagecount" +Print \fIpagecount\fR pages after the starting page. +.IP "\fB\-q\fR" 4 +.IX Item "-q" Quiet operation: omit final statistics, etc. -.TP -\f3-r\f1 -toggle page reversal; by default, pages are reversed. -.TP -\f3-s\f2pagesize \f1 +.IP "\fB\-r\fR" 4 +.IX Item "-r" +Toggle page reversal. +.IP "\fB\-s\fR\fIpagesize\fR" 4 +.IX Item "-spagesize" Specify the page size: -.br -\f3-s1\f1: executive (7.25in x 10.5in) -.br -\f3-s2\f1: letter (8.5in x 11in) -.br -\f3-s3\f1: legal (8.5in x 14in) -.br -\f3-s26\f1: A4 (210mm x 297mm) -.br -\f3-s80\f1: monarch (3.875in x 7.5in) -.br -\f3-s81\f1: commercial-10 (4.125in x 9.5in) -.br -\f3-s90\f1: international DL (110mm x 220mm) -.br -\f3-s91\f1: international C5 (162mm x 229mm) -.br -All values are from the LJ II technical reference manual. -If the -s commandline option is omitted, no clipping is performed -at the bottom of the page. -.TP -\f3-t\f2pagenum\f1 -Print pages with TeX page numbers less than or equal to \f2pagenum\f1. -.TP -\f3-v\f1 +.Sp +.Vb 16 +\& -s1: Executive (7.25" x 10.5") +\& -s2: Letter (8.5" x 11") +\& -s3: Legal (8.5" x 14") +\& -s6: Ledger (11" x 17") +\& -s25: A5 paper (148mm x 210mm) +\& -s26: A4 paper (210mm x 297mm) +\& -s27: A3 (297mm x 420mm) +\& -s45: JIS B5 paper (182mm x 257mm) +\& -s46: JIS B4 paper (250mm x 354mm) +\& -s71: Hagaki postcard (100mm x 148mm) +\& -s72: Oufuku-Hagaki postcard (200mm x 148mm) +\& -s80: Monarch Envelope (3 7/8" x 7 1/2") +\& -s81: Commercial Envelope 10 (4 1/8" x 9 1/2") +\& -s90: International DL (110mm x 220mm) +\& -s91: International C5 (162mm x 229mm) +\& -s100: International B5 (176mm x 250mm) +.Ve +.Sp +These values are from the \s-1PCL\s0 5 technical reference manual. If the +\&\fB\-s\fR commandline option is omitted, no clipping is performed at the +bottom of the page. (But printing below the paper bottom should not +disturb any correctly behaving \s-1PCL\s0 printer.) Please remember that the +correct paper tray must be installed for selected paper size, so use +this option only if you have full control over your print destination. +.IP "\fB\-t\fR\fIpagenum\fR" 4 +.IX Item "-tpagenum" +Print pages with TeX page numbers less than or equal to \fIpagenum\fR. +.IP "\fB\-v\fR" 4 +.IX Item "-v" Verbose mode: list fonts used, etc. -.TP -\f3-V\f2mode\f1 -compatibility mode. Use \f2K\f1 for Kyocera, \f2B\f1 for Brother, -\f26\f1 for LJ6 printers. -.TP -\f3-w\f1 +.IP "\fB\-V\fR\fImode\fR" 4 +.IX Item "-Vmode" +Compatibility mode. As \fImode\fR, use \f(CW\*(C`K\*(C'\fR for Kyocera, \f(CW\*(C`B\*(C'\fR for +Brother, \f(CW6\fR for \s-1LJ6\s0 printers. +.IP "\fB\-w\fR" 4 +.IX Item "-w" Omit warnings. -.TP -\f3-x\f2offset\f1 -global x-offset in mm on output page -relative to 1 inch/1 inch origin -.TP -\f3-y\f2offset\f1 -global y-offset in mm on output page -relative to 1 inch/1 inch origin -.TP -\f3-X\f2offset\f1 -global x-offset in dots on output page -(overrides 1 inch/1 inch origin) -.TP -\f3-Y\f2offset\f1 -global y-offset in dots on output page -(overrides 1 inch/1 inch origin) -.TP -\f3-z\f1 -print a test page with the page counter at end of job -.TP -\f3-\f1 -Take input from standard input (must be seekable), write to standard output. +.IP "\fB\-x\fR\fIoffset\fR" 4 +.IX Item "-xoffset" +Global x\-offset in mm on output page relative to 1 inch/1 inch origin. +.IP "\fB\-y\fR\fIoffset\fR" 4 +.IX Item "-yoffset" +Global y\-offset in mm on output page relative to 1 inch/1 inch origin. +.IP "\fB\-X\fR\fIoffset\fR" 4 +.IX Item "-Xoffset" +Global x\-offset in dots on output page (overrides 1 inch/1 inch +origin). +.IP "\fB\-Y\fR\fIoffset\fR" 4 +.IX Item "-Yoffset" +Global y\-offset in dots on output page (overrides 1 inch/1 +inch origin). +.IP "\fB\-z\fR" 4 +.IX Item "-z" +Print a test page with the page counter at end of job. +.SH "OPERANDS" +.IX Header "OPERANDS" +If no operands are specified a brief usage message is displayed. +.IP "\fIfilename\fR" 4 +.IX Item "filename" +The \s-1DVI\s0 file name that shall be converted by \fBdvilj\fR. It must always +be seekable. +.Sp +The output file name is constructed from \fIfilename\fR. Either an +extension \f(CW\*(C`.dvi\*(C'\fR is replaced by \f(CW\*(C`.lj\*(C'\fR, or the extension \f(CW\*(C`.lj\*(C'\fR is +appended. +.Sp +If \fIfilename\fR is \fB\-\fR, the \s-1DVI\s0 file is read from standard input and +the resulting \s-1PCL\s0 document is written to standard output. (Please +remember that thhe \s-1DVI\s0 file must be seekable, even if it's stdin.) +.SH "SUPPORTED TeX \especial COMMANDS" +.IX Header "SUPPORTED TeX special COMMANDS" +\&\f(CW\*(C`\especial\*(C'\fR commands supported by \fBdvilj\fR have the generic syntax .PP -If no arguments are specified a brief usage message is displayed. -.SH \especial COMMANDS -TeX `\especial' commands that are implemented: -.TP \w'\f3\especial{hpfile=<filename>}\f1'u+2n -\f3\especial{file=<filename>}\f1 -copy specified file to the printer; either vector- or bitmap-graphics PMP -commands -.TP -\f3\especial{hpfile=<filename>}\f1 -Same as `file'. -.TP 0 -others: -There are a few other special commands implented for the LJ-series, -which should only be used in connection with the distributed style -files (e.g., graybox.sty). They may change in forthcoming versions. +.Vb 2 +\& \especial{key1=value key1="value with space"} +\& \especial{key3 = value key4 = 'note optional spaces around equal sign'} +.Ve .PP -You can include Encapsulated PostScript (EPS) files in the PCL files output -by dvilj if you convert them to PCL first. The distribution includes a -script `epspcl' to do this (using Ghostscript, so your Ghostscript must -have the necessary LaserJet driver(s) compiled in). -.SH DOUBLE PAGE PRINTING -The command line option -D causes the printer to print -in doublepage mode, that is, roughly speaking, printing first -the even pages and then the odd pages of a document. -If -D is used to print both even and odd pages (-D is used -without the optional \f21\f1 or \f22\f1) -the following will happen after -half of the pages is printed: -\f3LJ:\f1 -the printer stops, shows message "FEED" and switches -on manual feed led. The printer continues when either -the printed pages are fed into the manual page feeder, -or the operator pushes the continue button (after placing first -the printed pages into the paper tray). +I.e., specials are a sequence of key/value pairs, separated by an +equal sign. Spaces around the equal sign are ignored. The value is +either a space separated word, or a quoted string. Both double and +single quotes can be used, alternatively. There is no support for +quoting quote characters in values; if you want both double and single +quotes in one value, you're out of luck. .PP -If -D1 was specified only odd pages will be printed, -D2 can be used -for even pages. A trailing `-' (as in -D-, -D1- or -D2-) supresses -printing of empty pages which are generated for padding otherwise. +The following key/value combinations are valid: +.IP "\fBhpfile\fR=\fIfile\fR" 4 +.IX Item "hpfile=file" +Insert \fIfile\fR at the current position. \fIfile\fR is searched with +\&\fIkpathsea\fR\|(3), see below. +.Sp +The file content must be valid for this printer, i.e., it should +contain \s-1PCL\s0 escape sequences or \s-1HP\-GL/2\s0 commands. If the file is a +graphics file, this typically means that the upper left corner of the +graphics is placed at the current position. +.Sp +\&\s-1PCL\s0 absolute positioning escape sequences in \fIfile\fR are rewritten to +be relative positioning commands; the lowest appearing coordinate is +used as reference. +.IP "\fBhpfile_verbatim\fR=\fIfile\fR" 4 +.IX Item "hpfile_verbatim=file" +Insert \fIfile\fR verbatim at the current position, without any changes +of the file content. \fIfile\fR is searched with \fIkpathsea\fR\|(3), see below. +.Sp +This is mostly used to keep absolute positions in \s-1PCL\s0 files. +.IP "\fBpsfile\fR=\fIfile\fR \fBllx\fR=\fIx0\fR \fBlly\fR=\fIy0\fR \fBurx\fR=\fIx1\fR \fBury\fR=\fIy1\fR \fBrwi\fR=\fIs\fR" 4 +.IX Item "psfile=file llx=x0 lly=y0 urx=x1 ury=y1 rwi=s" +Convert Postscript file \fIfile\fR to \s-1HP\s0 \s-1PCL\s0, by Ghostscript with device +\&\f(CW\*(C`ljetplus\*(C'\fR, and insert the resulting graphics file at the current +position, rewriting absolute position escape sequences. \fIfile\fR is +searched with \fIkpathsea\fR\|(3), see below. +.Sp +The accompanying key/value pairs are mandatory, they can be specified +in an arbitrary order. Values \fIx0\fR, \fIx1\fR, \fIy0\fR, \fIy1\fR, and \fIs\fR are +integers. (\fIx0\fR,\fIy0\fR) is the lower left corner, (\fIx1\fR,\fIy1\fR) the +upper right corner of the image. +.Sp +\&\fBPlease note: The specific semantics of this special is not known.\fR +In particular, the \fBrwi\fR parameter is some scale factor; but even +looking at the source code it is not quite clear what the special's +author intended to implement here. In addition, it is unclear what +dimensions are used to specify the corners, Postscript points or \s-1PCL\s0 +dots. +.Sp +\&\fIIf you happen to know the psfile semantics, or if you spent the work +analyzing them, please inform us at tex\-k@tug.org, so that we can +update this man page with the relevant information.\fR +.IP "\fBdvilj-psfile-syntax\fR=\fIsyntax\fR" 4 +.IX Item "dvilj-psfile-syntax=syntax" +where \fIsyntax\fR is either \f(CW\*(C`dvilj\*(C'\fR or \f(CW\*(C`ignore\*(C'\fR. This is a very crude +way to tell the driver what to do with \fBpsfile\fR specials. +.Sp +If the value is \f(CW\*(C`ignore\*(C'\fR, all \fBpsfile\fR specials that are processed +afterwards are ignored, until the next \fBdvilj-psfile-syntax\fR special is +processed. +.Sp +If the value is \f(CW\*(C`dvilj\*(C'\fR, \fBpsfiles\fR specials are processed as +explained above, until the next \fBdvilj-psfile-syntax\fR special is +processed. +.Sp +An obvious, planned, extension is the value \f(CW\*(C`dvips\*(C'\fR, but this has not +been implemented yet. +.Sp +That special is not as simple as it sounds at first. Since its +semantics is defined by processing order, it is only of use if it is +placed on the same page as the \fBpsfile\fR special. Having it once in a +file (e.g., on the first page) does not help if you print just one +page of the document \*(-- \fBdvilj\fR does not do prescanning of first-page +specials like some other drivers do. (Patches would be welcome, of +course.) +.IP "\fBcomment\fR=\fIarbitrary text\fR" 4 +.IX Item "comment=arbitrary text" +.PD 0 +.IP "\fBcomment\fR \fIarbitrary text\fR" 4 +.IX Item "comment arbitrary text" +.PD +This causes the rest of the special to be ignored; it may be used to +add meta-information to a \s-1DVI\s0 file. +.Sp +With the first form, the comment may appear anywhere in the special. +When it appears first, the processing of this special is terminated +and all other text behind is ignored. +.Sp +The second form is a speciality that has been introduced for +compatibility with other drivers. If the first keyword of the special +is \fBcomment\fR and has no value, it is taken as a valid comment syntax, +too; the rest of the special is ignored. +.IP "\fBorientation\fR=\fIpo\fR" 4 +.IX Item "orientation=po" +Position the page on the physical paper. The value \fIpo\fR may be one of +the following values: +.Sp +.Vb 4 +\& 0 for portrait +\& 1 for landscape +\& 2 for reverse portrait +\& 3 for reverse landscape +.Ve +.IP "\fBdefpoint\fR=\fIn(x,y)\fR" 4 +.IX Item "defpoint=n(x,y)" +Define the point number \fIn\fR. This point can be referred to later in +other special commands to specify areas that shall be filled with some +pattern. \fIn\fR must be between 0 and 79. +.Sp +\&\fIx\fR and \fIy\fR are the position of that point and have the form \f(CW\*(C`?pt\*(C'\fR +where \f(CW\*(C`?\*(C'\fR is a floating point number. The positions are relative to +the \s-1DVI\s0 page origin; i.e., coordinates increase moving right and down, +the point of origin is (1in,1in) in the upper left corner, altered by +options \fB\-x\fR, \fB\-y\fR, \fB\-X\fR, and \fB\-Y\fR, but not by \ehoffset and +\&\evoffset. +.Sp +\&\fIx\fR and \fIy\fR can be omitted, i.e., the values \f(CW3\fR or \f(CW\*(C`4(,)\*(C'\fR are +valid. Then the current page position is used as position for point +\&\fIn\fR. +.ie n .IP "\fBresetpoints\fR=""all""" 4 +.el .IP "\fBresetpoints\fR=\f(CWall\fR" 4 +.IX Item "resetpoints=all" +This undefines all points again. +.IP "\fBgray\fR=\fIgray_scale\fR" 4 +.IX Item "gray=gray_scale" +.PD 0 +.IP "\fBgrey\fR=\fIgray_scale\fR" 4 +.IX Item "grey=gray_scale" +.PD +This sets the fill mode for the next \fBfill\fR special, the area will be +filled with gray color. (\fBgrey\fR is an alias for \fBgray\fR.) Any pattern +specification is reset. +.Sp +\&\fIgray_scale\fR is the percentage of gray that shall be used here; with +\&\f(CW0\fR meaning white and \f(CW100\fR meaning black. +.Sp +Caveat: That special is actually a misnomer. \s-1PCL\s0 names these gray +scales \fIshading patterns\fR and they are created by placing dots in the +area. The gray scale selects how far spread the dots are. In the lower +ranges, this doesn't look very gray on close sight, but more like a +dotted background. Furthermore, the gray scales are not as +fine-grained as the value range 0..100 might make you believe. In +reality, there are only 8 different gray patterns available: +.Sp +.Vb 8 +\& 1 - 2% +\& 3 - 10% +\& 11 - 20% +\& 21 - 35% +\& 36 - 55% +\& 56 - 80% +\& 81 - 99% +\& 100% +.Ve +.Sp +One of these patterns is selected according to the \fIgray_scale\fR value. +.IP "\fBpattern\fR=\fIpat\fR" 4 +.IX Item "pattern=pat" +This sets the fill mode for the next \fBfill\fR special, the area will be +filled with a pattern. Any gray color specification is reset. +.Sp +\&\fIpat\fR is one of the following values: +.Sp +.Vb 6 +\& 1 horizontal lines +\& 2 vertical lines +\& 3 diagonal lines, from lower left corner to upper right corner +\& 4 diagonal lines, from upper right corner to lower left corner +\& 5 crossed lines, vertically +\& 6 crossed lines, diagonally +.Ve +.IP "\fBfill\fR=\fIa/b\fR" 4 +.IX Item "fill=a/b" +Fill the area between the points \fIa\fR and \fIb\fR, according to the +current fill mode. +.Sp +Point \fIa\fR \fBmust\fR be the upper left corner and point \fIb\fR \fBmust\fR be the +lower left corner of the rectangle. Otherwise the result is garbage. +.Sp +The default fill mode is 10% gray color filling. +.IP "\fIfilename\fR" 4 +.IX Item "filename" +This is a legacy special, its use is depreciated. If the special is +just one word that names an existing file, that file is verbatim +included. Contrary to other file inclusion means, the file is not +searched with \fIkpathsea\fR\|(3). \fIYou are not supposed to use this special +and we won't fix any problems with it.\fR .PP -The driver allows the -D option for both print-directions (front-to-back -or back-to-front printing). It tries to be clever in certain cases: -when a document has an odd number of pages it inserts in the -right place an empty page -when a document starts with page 0 the driver inserts an empty -page after the 0-page -when a piece of a document is printed that starts with -an even page-number it prints this page at the backside -of the first page to ensure that the odd sides are always -on the frontside. The 0-page is treated like an odd page. +It should be noted that the special parser does sometimes accept +constructs that are not valid as in the documentation above. Then, the +output is most often damaged in some way. +.Sh "Searching for Included Files" +.IX Subsection "Searching for Included Files" +Proper file include specials search the file with \fIkpathsea\fR\|(3). The +search path is configured by variable \f(CW\*(C`DVILJINPUTS\*(C'\fR and, if the file +is not found in that search path, by variable \f(CW\*(C`TEXINPUTS\*(C'\fR. .PP -The doubleside option works for all LJs, not only for the -new D model with does doubleside-printing (actually, I don't -know whether it makes much sense on the new LJ II D at all). +Search via \f(CW\*(C`DVILJINPUTS\*(C'\fR covers the use case that one has common +site-wide graphics that shall be included in documents, e.g., scanned +signatures. Search via \f(CW\*(C`TEXINPUTS\*(C'\fR covers the use case that one has +graphics as part of ones current document. .PP -Caveat on the doubleside-option: When it is used frequently -or on very large files, it might become necessary to clean -the printer much more frequently. +\&\f(CW\*(C`dvilj\*(C'\fR is used as the \f(CW\*(C`.PROGRAM\*(C'\fR name in \fItexmf.cnf\fR, for all +driver variants, independent of the actual program name. +.ie n .Sh "Unknown Specials and ""TEX_HUSH"" configuration" +.el .Sh "Unknown Specials and \f(CWTEX_HUSH\fP configuration" +.IX Subsection "Unknown Specials and TEX_HUSH configuration" +\&\fIKpathsea\fR\|(3) has the concept of warning suppression with the +configuration variable \f(CW\*(C`TEX_HUSH\*(C'\fR, please refer to its Info node +\&\fITeX support / Suppressing warnings\fR. That variable holds a +colon-separated identifiers that specifies the to-be-suppressed +warnings. .PP -The command line option -pX can be used to abort printing -after the output of X pages (can lead to strange results together -with -D). I personally dislike this option. The secure way of -printing a part of a document is using -f (from) and -t (to). -.SH ENVIRONMENT -Dviljk uses the same environment variables and algorithms for finding -font files as TeX and its friends do. See the documentation for the -Kpathsea library for details. (Repeating it here is too cumbersome.) +If \f(CW\*(C`special\*(C'\fR is among the listed values, \fBdvilj\fR does not output +warnings any more about specials that it doesn't know about. But if +there is a recognized special and if that special has an invalid +parameter, then a warning is output nevertheless, independent of the +content of \f(CW\*(C`TEX_HUSH\*(C'\fR. +.SH "DOUBLE PAGE PRINTING" +.IX Header "DOUBLE PAGE PRINTING" +If the printer has a duplex unit installed, duplex printing can be +demanded with the \fB\-d\fR option. .PP -DVILJFONTS, if set, overrides all other font paths. +Otherwise, the command line option \fB\-D\fR causes the printer to print +in doublepage mode, that is, roughly speaking, printing first the even +pages and then the odd pages of a document. If \fB\-D\fR is used to print +both even and odd pages (\fB\-D\fR is used without the optional 1 or 2) +the following will happen after half of the pages is printed: \s-1LJ:\s0 the +printer stops, shows message \*(L"\s-1FEED\s0\*(R" and switches on manual feed led. +The printer continues when either the printed pages are fed into the +manual page feeder, or the operator pushes the continue button (after +placing first the printed pages into the paper tray). .PP -DVILJMAKEPK, if set, overrides `mktexpk' as the name of the command to -execute to create a PK file if one isn't found. +If \fB\-D1\fR was specified only odd pages will be printed, \fB\-D2\fR can be +used for even pages. A trailing \f(CW\*(C`\-\*(C'\fR (as in \fB\-D\-\fR, \fB\-D1\-\fR or +\&\fB\-D2\-\fR) supresses printing of empty pages which are generated for +padding otherwise. .PP -The DVILJSIZES variable may be set to indicate which sizes of fonts are -available. It should consist of a list of numbers separated by colons. If -the list begins with a colon, the system default sizes are used, as well. -Sizes are expressed in dots per inch; decimals may be used for ``pxl'' files: -for example, a 300 dots per inch file magnified by half a step comes out to -1643 dots per five inches, which should be encoded as 328.6. \fIdvilj\fR -tries the actual size of the font before trying any of the given sizes. +The driver allows the \fB\-D\fR option for both print-directions +(front\-to\-back or back-to-front printing). It tries to be clever in +certain cases: when a document has an odd number of pages it inserts +in the right place an empty page when a document starts with page 0 +the driver inserts an empty page after the 0\-page when a piece of a +document is printed that starts with an even page-number it prints +this page at the backside of the first page to ensure that the odd +sides are always on the frontside. The 0\-page is treated like an odd +page. .PP -KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for complete tracing. -.SH AUTHOR -Gustaf Neumann, Wirtschaftsuniversitaet Wien -.br -neumann@wu-wien.ac.at +The doubleside option works for all LJs, not only for the new D model +with does doubleside-printing (actually, I don't know whether it makes +much sense on the new \s-1LJ\s0 \s-1II\s0 D at all). +.PP +Caveat on the doubleside\-option: When it is used frequently or on very +large files, it might become necessary to clean the printer much more +frequently. +.PP +The command line option \fB\-p\fR\fIX\fR can be used to abort printing after +the output of \fIX\fR pages (can lead to strange results together with +\&\fB\-D\fR). I personally dislike this option. The secure way of printing a +part of a document is using \fB\-f\fR (from) and \fB\-t\fR (to). +.SH "ENVIRONMENT" +.IX Header "ENVIRONMENT" +\&\fBdvilj\fR uses the same environment variables and algorithms for finding +font files as TeX and its friends do. See the documentation for the +\&\fIkpathsea\fR\|(3) library for details. (Repeating it here is too cumbersome.) +.ie n .IP """DVILJFONTS""" 4 +.el .IP "\f(CWDVILJFONTS\fR" 4 +.IX Item "DVILJFONTS" +If set, overrides all other font paths. +.ie n .IP """DVILJMAKEPK""" 4 +.el .IP "\f(CWDVILJMAKEPK\fR" 4 +.IX Item "DVILJMAKEPK" +If set, overrides \fImktexpk\fR\|(1) as the name of the command to execute to +create a \s-1PK\s0 file if one isn't found. +.ie n .IP """DVILJSIZES""" 4 +.el .IP "\f(CWDVILJSIZES\fR" 4 +.IX Item "DVILJSIZES" +May be set to indicate which sizes of fonts are available. It should +consist of a list of numbers separated by colons. If the list begins +with a colon, the system default sizes are used, as well. Sizes are +expressed in dots per inch; decimals may be used for \f(CW\*(C`pxl\*(C'\fR files: for +example, a 300 dots per inch file magnified by half a step comes out +to 1643 dots per five inches, which should be encoded as 328.6. +\&\fBdvilj\fR tries the actual size of the font before trying any of the +given sizes. +.ie n .IP """DVILJINPUTS""" 4 +.el .IP "\f(CWDVILJINPUTS\fR" 4 +.IX Item "DVILJINPUTS" +Primary search path for include files. +.ie n .IP """TEXINPUTS""" 4 +.el .IP "\f(CWTEXINPUTS\fR" 4 +.IX Item "TEXINPUTS" +Secondary search path for include files. +.ie n .IP """TEX_HUSH""" 4 +.el .IP "\f(CWTEX_HUSH\fR" 4 +.IX Item "TEX_HUSH" +Colon separated list of identifiers that name situations where no +warning shall be output. The following identifiers are used: +.Sp +.Vb 5 +\& checksum suppress mismatched font checksum warnings +\& readable suppress warnings about unreadable files +\& special suppress warnings about unknown specials +\& all suppress all warning classes above +\& none suppress no warnings +.Ve +.ie n .IP """KPATHSEA_DEBUG""" 4 +.el .IP "\f(CWKPATHSEA_DEBUG\fR" 4 +.IX Item "KPATHSEA_DEBUG" +Trace \fIkpathsea\fR\|(3) lookups; set to \-1 for complete tracing. +.ie n .IP """GS_PATH""" 4 +.el .IP "\f(CWGS_PATH\fR" 4 +.IX Item "GS_PATH" +On Windows, this may be the path to Ghostscript; there the default is +\&\fIgswin32c.exe\fR. +.Sp +On Unix, this environment variable is not used. Ghostscript is called +as \fIgs\fR\|(1) and must be found over \f(CW$PATH\fR. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIdvihp\fR\|(1), \fIdvicopy\fR\|(1), \fIdvips\fR\|(1), \fIxdvi\fR\|(1), \fImktexpk\fR\|(1), \fIgs\fR\|(1), +\&\fIkpathsea\fR\|(3) +.PP +Email bug reports to tex\-k@tug.org. +.PP +Source is at <http://mirror.ctan.org/dviware/dviljk/>; but for +compilation the texk build environment is needed, from +<svn://tug.org/texlive/*/Build/source>. +.PP +As of July 2007, \s-1PCL\s0 reference documentation is found at \s-1HP\s0's Web site +at +<http://h20000.www2.hp.com/bizsupport/TechSupport/Document.jsp?objectID=bpl04568>. +At the end of that page are links to reference manuals for \s-1PCL\s0 and \s-1PJL\s0. .PP -dviljk changes by kb@mail.tug.org; email bug reports to tex\-k@mail.tug.org. +In case that page is changed, here are the URLs of these documents. +All have the form +<http://h20000.www2.hp.com/bc/docs/support/SupportManual/bpl<\s-1ID\s0>/bpl<\s-1ID\s0>.pdf>, +where \f(CW\*(C`<ID>\*(C'\fR is the following document \s-1ID:\s0 +.IP "\fB13205\fR" 4 +.IX Item "13205" +\&\s-1PCL\s0 5 Technical Quick Reference Guide. This is the 1st thing to look up +if you have questions about \s-1PCL\s0 escape sequences. +.IP "\fB13210\fR and \fB13211\fR" 4 +.IX Item "13210 and 13211" +\&\s-1PCL\s0 5 Technical Reference Manual (part I and \s-1II\s0). This is the +full-detailled explanation that you need to look up if you don't +understand how the printer works. Part I is the actual manual, part \s-1II\s0 +explains \s-1HP\-GL/2\s0 and has overall tips. +.IP "\fB13208\fR and \fB13207\fR" 4 +.IX Item "13208 and 13207" +\&\s-1PJL\s0 Technical Reference Manual (and addendum) +.IP "\fB13212\fR" 4 +.IX Item "13212" +\&\s-1PCL\s0 5 Color Manual. This explains color specials for the newer \s-1HP\s0 +printers. (Not of much use today; for practical purposes we would need +to add color specials to \fBdvilj\fR first.) +.IP "\fB13206\fR and \fB13209\fR" 4 +.IX Item "13206 and 13209" +Comparison Guide (and addendum) that documents which \s-1PCL\s0 escape +sequences are supported on which \s-1HP\s0 printers. +.SH "AUTHOR" +.IX Header "AUTHOR" +dvi2xx by Gustaf Neumann <neumann@wu\-wien.ac.at>, +Wirtschaftsuniversitaet Wien +.Sp +dviljk fork by kb@mail.tug.org +.Sp +Joachim Schrod <jschrod@acm.org> supplied security fixes and updated +this man page. +.SH "LICENSE" +.IX Header "LICENSE" +dvi2xx is public domain software. dviljk changes are covered by the +\&\s-1GNU\s0 General Public License. diff --git a/Master/texmf/doc/man/man1/dvipng.1 b/Master/texmf/doc/man/man1/dvipng.1 index bac4c46d888..d0107a35785 100644 --- a/Master/texmf/doc/man/man1/dvipng.1 +++ b/Master/texmf/doc/man/man1/dvipng.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2006-11-07" "dvipng 1.9" "User commands" +.TH DVIPNG 1 "2008-05-14" "dvipng 1.11" "User commands" .SH "NAME" dvipng \- A DVI\-to\-PNG translator .SH "SYNOPSIS" @@ -247,11 +247,11 @@ 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 \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) +LaTeX style \fIpreview.sty\fR from preview-latex is used with +the \fBactive\fR option. 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"> @@ -305,10 +305,11 @@ option. .IP "\fB\-\-height*\fR" 4 .IX Item "--height*" Report the height of the image. This only works reliably when the -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 \fB\-\-height\fR and \fB\-\-depth\fR. +LaTeX style \fIpreview.sty\fR from preview-latex is used with +the \fBactive\fR option. 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 +\&\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 @@ -493,8 +494,8 @@ The full manual is accessible in the info format, on most systems by typing .Ve .SH "COPYRIGHT" .IX Header "COPYRIGHT" -This program is released under the \s-1GNU\s0 General Public License, see the -\&\s-1COPYING\s0 file in the dvipng distribution or +This program is released under the \s-1GNU\s0 Lesser General Public License +version 3, see the \s-1COPYING\s0 file in the dvipng distribution or <\fBhttp://www.gnu.org/licenses/gpl.html\fR>. .PP -Copyright (c) 2002\-2006 Jan-AAke Larsson +Copyright (c) 2002\-2008 Jan-AAke Larsson diff --git a/Master/texmf/doc/man/man1/dvips.1 b/Master/texmf/doc/man/man1/dvips.1 index f95a933a95a..09170168cd8 100644 --- a/Master/texmf/doc/man/man1/dvips.1 +++ b/Master/texmf/doc/man/man1/dvips.1 @@ -360,16 +360,21 @@ nothing but errors to standard error. .B -r Stack pages in reverse order. Normally, page 1 will be printed first. .TP -.B -R -Run in secure mode. This means that ``backtick'' commands from a -.I \especial{} -or -.I \epsffile{} -macro in the (La)TeX source like -.I \especial{psfile="`zcat foo.ps.Z"} -or -.I \epsffile[72 72 540 720]{"`zcat screendump.ps.gz"} -are not executed. +.B -R[0|1|2] +Run securely. +.BR -R2 +disables both shell command execution in +.I \especial'{} +(via backticks +.BR ` +) and config files (via the +.I E +option), and opening of any absolute filenames. +.BR -R1 +, the default, forbids shell escapes but allows absolute filenames. +.BR -R0 +allows both. The config file option is +.I z .TP .B -s Causes the entire global output to be enclosed in a save/restore pair. diff --git a/Master/texmf/doc/man/man1/dvitomp.1 b/Master/texmf/doc/man/man1/dvitomp.1 index 78125eb11cc..abd4db95e41 100644 --- a/Master/texmf/doc/man/man1/dvitomp.1 +++ b/Master/texmf/doc/man/man1/dvitomp.1 @@ -1,4 +1,4 @@ -.TH DVITOMP 1 "30 October 1999" "Web2C 7.5.6" +.TH DVITOMP 1 "30 October 1999" "Web2C 7.5.7" .\" man page by Jim Van Zandt <jrv@vanzandt.mv.com> -*- nroff -*- .SH NAME dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE diff --git a/Master/texmf/doc/man/man1/dvitype.1 b/Master/texmf/doc/man/man1/dvitype.1 index d2172d13b64..29c465546e5 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.6" +.TH DVITYPE 1 "19 December 1994" "Web2C 7.5.7" .\"===================================================================== .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 90176f53dfc..01653abb1ca 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.6" +.TH EPLAIN 1 "14 December 1993" "Web2C 7.5.7" .\"===================================================================== .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/epstopdf.1 b/Master/texmf/doc/man/man1/epstopdf.1 index 451e5a3ca1e..ca7c16b9018 100644 --- a/Master/texmf/doc/man/man1/epstopdf.1 +++ b/Master/texmf/doc/man/man1/epstopdf.1 @@ -1,5 +1,5 @@ -.TH EPSTOPDF 1 "October 30, 1999" -.\" man page by Jim Van Zandt <jrv@vanzandt.mv.com> -*- nroff -*- +.TH EPSTOPDF 1 "4 March 2008" +.\" man page originally by Jim Van Zandt .SH NAME epstopdf \- convert an EPS file to PDF .SH SYNOPSIS @@ -12,7 +12,7 @@ This means that when Ghostscript renders it, the result needs no cropping, and the PDF MediaBox is correct. The result is piped to Ghostscript and a PDF version written. .P -If the bounding box is not right, of course, you have problems... +If the bounding box is not right, of course, you have problems. .SH OPTIONS .IP "\fB--outfile\fP=\fIfile\fP" write result to \fIfile\fP instead of standard output. @@ -45,10 +45,17 @@ Example: look for HiresBoundingBox and produce corrected PostScript: epstopdf -d --nogs -hires test.ps>testcorr.ps .fi .SH BUGS -The only thing I have not allowed for is the case of -"%%BoundingBox: (atend)", which is more complicated. +The case of "%%BoundingBox: (atend)" is not supported. +.PP +Please send reports regarding the program or this man page +to tex-k@tug.org. .SH SEE ALSO \fBgs\fP(1). .SH AUTHOR -Sebastian Rahtz, for Elsevier Science. -Now with extra tricks from Hans Hagen's texutil. +The script was originally written by Sebastian Rahtz, for Elsevier +Science, with subsequent contributions from many others. Currently +maintained by Gerben Wierda. +.PP +Man page originally written by Jim Van Zandt. +.PP +You may freely use, modify and/or distribute this file. diff --git a/Master/texmf/doc/man/man1/etex.1 b/Master/texmf/doc/man/man1/etex.1 index 0306184dd38..dbecf3291ff 100644 --- a/Master/texmf/doc/man/man1/etex.1 +++ b/Master/texmf/doc/man/man1/etex.1 @@ -1,4 +1,4 @@ -.TH ETEX 1 "7 January 2007" "pdftex 1.40" "Web2C 7.5.6" +.TH ETEX 1 "7 January 2007" "pdftex 1.40" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/getnonfreefonts.1 b/Master/texmf/doc/man/man1/getnonfreefonts.1 index b15235f8524..655d9a71584 100644 --- a/Master/texmf/doc/man/man1/getnonfreefonts.1 +++ b/Master/texmf/doc/man/man1/getnonfreefonts.1 @@ -113,9 +113,11 @@ will be used if none of the variables is defined. .SH REQUIREMENTS Though this program is supposed to be used with -.B TeXLive +.B TeX Live it might work with other TeX distributions too. The programs -.BR "wget" , +.BR "wget" +or +.BR "curl" , .BR "unzip" , and .B kpsewhich diff --git a/Master/texmf/doc/man/man1/gftodvi.1 b/Master/texmf/doc/man/man1/gftodvi.1 index e5b750b4255..deb59b87d12 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.6" +.TH GFTODVI 1 "20 April 2007" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 @@ -102,7 +102,7 @@ on the command line must be complete. (The program prompts you for it if you don't give it.) Because the resolution is part of the extension, it would not make sense to append a default extension as is done with \*(TX or -DVI-reading software. The output file name defaults to the same +DVI-reading software. The output file name uses the same root as the .I gf file, with the diff --git a/Master/texmf/doc/man/man1/gftopk.1 b/Master/texmf/doc/man/man1/gftopk.1 index 7afc50ea83a..06ec49aa2c9 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.6" +.TH GFTOPK 1 "14 December 1993" "Web2C 7.5.7" .\"===================================================================== .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 fabc074d9b5..539e3d85225 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.6" +.TH GFTYPE 1 "14 December 1993" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/info.1 b/Master/texmf/doc/man/man1/info.1 index 39ca1d32ac3..aadae61022c 100644 --- a/Master/texmf/doc/man/man1/info.1 +++ b/Master/texmf/doc/man/man1/info.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.34. -.TH INFO "1" "December 2004" "info 4.8" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH INFO "1" "April 2008" "info 4.12" "User Commands" .SH NAME info \- read Info documents .SH SYNOPSIS @@ -9,7 +9,7 @@ info \- read Info documents Read documentation in Info format. .SH OPTIONS .TP -\fB\-\-apropos\fR=\fISTRING\fR +\fB\-k\fR, \fB\-\-apropos\fR=\fISTRING\fR look up STRING in all indices of all manuals. .TP \fB\-d\fR, \fB\-\-directory\fR=\fIDIR\fR @@ -48,14 +48,14 @@ go to command\-line options node. \fB\-\-subnodes\fR recursively output menu items. .TP -\fB\-w\fR, \fB\-\-where\fR, \fB\-\-location\fR -print physical location of Info file. -.TP \fB\-\-vi\-keys\fR use vi\-like and less\-like key bindings. .TP \fB\-\-version\fR display version information and exit. +.TP +\fB\-w\fR, \fB\-\-where\fR, \fB\-\-location\fR +print physical location of Info file. .PP The first non\-option argument, if present, is the menu entry to start from; it is searched for in all `dir' files along INFOPATH. @@ -76,6 +76,9 @@ start at buffers node within emacs manual info \fB\-\-show\-options\fR emacs start at node with emacs' command line options .TP +info \fB\-\-subnodes\fR \fB\-o\fR out.txt emacs +dump entire manual to out.txt +.TP info \fB\-f\fR ./foo.info show file ./foo.info, not searching dir .SH "REPORTING BUGS" @@ -83,7 +86,8 @@ Email bug reports to bug\-texinfo@gnu.org, general questions and discussion to help\-texinfo@gnu.org. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2004 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. diff --git a/Master/texmf/doc/man/man1/infokey.1 b/Master/texmf/doc/man/man1/infokey.1 index fb8f4634f40..f18df20d548 100644 --- a/Master/texmf/doc/man/man1/infokey.1 +++ b/Master/texmf/doc/man/man1/infokey.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.34. -.TH INFOKEY "1" "December 2004" "infokey 4.8" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH INFOKEY "1" "April 2008" "infokey 4.12" "User Commands" .SH NAME infokey \- compile customizations for Info .SH SYNOPSIS @@ -23,10 +23,11 @@ Email bug reports to bug\-texinfo@gnu.org, general questions and discussion to help\-texinfo@gnu.org. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2003 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B infokey diff --git a/Master/texmf/doc/man/man1/install-info.1 b/Master/texmf/doc/man/man1/install-info.1 index 004d5d0f97d..c0592b183d0 100644 --- a/Master/texmf/doc/man/man1/install-info.1 +++ b/Master/texmf/doc/man/man1/install-info.1 @@ -1,58 +1,108 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.34. -.TH INSTALL-INFO "1" "December 2004" "install-info 4.8" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH INSTALL-INFO "1" "April 2008" "install-info 4.12" "User Commands" .SH NAME install-info \- update info/dir entries .SH SYNOPSIS .B install-info [\fIOPTION\fR]... [\fIINFO-FILE \fR[\fIDIR-FILE\fR]] .SH DESCRIPTION -Install or delete dir entries from INFO\-FILE in the Info directory file -DIR\-FILE. +Add or remove entries in INFO\-FILE from the Info directory DIR\-FILE. .SH OPTIONS .TP +\fB\-\-debug\fR +report what is being done. +.TP \fB\-\-delete\fR delete existing entries for INFO\-FILE from DIR\-FILE; don't insert any new entries. .TP +\fB\-\-description\fR=\fITEXT\fR +the description of the entry is TEXT; used with +the \fB\-\-name\fR option to become synonymous with the +\fB\-\-entry\fR option. +.TP \fB\-\-dir\-file\fR=\fINAME\fR -specify file name of Info directory file. -This is equivalent to using the DIR\-FILE argument. +specify file name of Info directory file; +equivalent to using the DIR\-FILE argument. +.TP +\fB\-\-dry\-run\fR +same as \fB\-\-test\fR. .TP \fB\-\-entry\fR=\fITEXT\fR insert TEXT as an Info directory entry. -TEXT should have the form of an Info menu item line -plus zero or more extra lines starting with whitespace. -If you specify more than one entry, they are all added. +TEXT is written as an Info menu item line followed +.IP +by zero or more extra lines starting with whitespace. +.IP +If you specify more than one entry, all are added. If you don't specify any entries, they are determined +.IP from information in the Info file itself. +.IP +When removing, TEXT specifies the entry to remove. +TEXT is only removed as a last resort, if the +entry as determined from the Info file is not present, +and the basename of the Info file isn't found either. .TP \fB\-\-help\fR display this help and exit. .TP -\fB\-\-info\-file\fR=\fIFILE\fR -specify Info file to install in the directory. -This is equivalent to using the INFO\-FILE argument. -.TP \fB\-\-info\-dir\fR=\fIDIR\fR same as \fB\-\-dir\-file\fR=\fIDIR\fR/dir. .TP +\fB\-\-info\-file\fR=\fIFILE\fR +specify Info file to install in the directory; +equivalent to using the INFO\-FILE argument. +.TP \fB\-\-item\fR=\fITEXT\fR -same as \fB\-\-entry\fR TEXT. -An Info directory entry is actually a menu item. +same as \fB\-\-entry\fR=\fITEXT\fR. +.TP +\fB\-\-keep\-old\fR +do not replace entries, or remove empty sections. +.TP +\fB\-\-menuentry\fR=\fITEXT\fR +same as \fB\-\-name\fR=\fITEXT\fR. +.TP +\fB\-\-name\fR=\fITEXT\fR +the name of the entry is TEXT; used with \fB\-\-description\fR +to become synonymous with the \fB\-\-entry\fR option. +.TP +\fB\-\-no\-indent\fR +do not format new entries in the DIR file. .TP \fB\-\-quiet\fR suppress warnings. .TP +\fB\-\-regex\fR=\fIR\fR +put this file's entries in all sections that match the +regular expression R (ignoring case). +.TP \fB\-\-remove\fR same as \fB\-\-delete\fR. .TP +\fB\-\-remove\-exactly\fR +only remove if the info file name matches exactly; +suffixes such as .info and .gz are not ignored. +.TP \fB\-\-section\fR=\fISEC\fR -put this file's entries in section SEC of the directory. +put entries in section SEC of the directory. If you specify more than one section, all the entries +.IP are added in each of the sections. +.IP If you don't specify any sections, they are determined +.IP from information in the Info file itself. .TP +\fB\-\-section\fR R SEC +equivalent to \fB\-\-regex\fR=\fIR\fR \fB\-\-section\fR=\fISEC\fR \fB\-\-add\-once\fR. +.TP +\fB\-\-silent\fR +suppress warnings. +.TP +\fB\-\-test\fR +suppress updating of DIR\-FILE. +.TP \fB\-\-version\fR display version information and exit. .SH "REPORTING BUGS" @@ -60,10 +110,11 @@ Email bug reports to bug\-texinfo@gnu.org, general questions and discussion to help\-texinfo@gnu.org. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2004 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B install-info diff --git a/Master/texmf/doc/man/man1/kpseaccess.1 b/Master/texmf/doc/man/man1/kpseaccess.1 index a2111b4619b..3e5ad086e94 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.6" +.TH KPSEACCESS 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 882d87e8ccb..702d434c2db 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.6" +.TH KPSEREADLINK 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 41f120f783a..ed167462d3c 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.6" +.TH KPSESTAT 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 29eb74ace0d..0dfd5dd252d 100644 --- a/Master/texmf/doc/man/man1/kpsewhich.1 +++ b/Master/texmf/doc/man/man1/kpsewhich.1 @@ -1,4 +1,4 @@ -.TH KPSEWHICH 1 "7 January 2007" "Kpathsea 3.5.6" +.TH KPSEWHICH 1 "7 January 2007" "Kpathsea 3.5.7" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/lacheck.1 b/Master/texmf/doc/man/man1/lacheck.1 index 03999fe9fe9..6a3154e9288 100644 --- a/Master/texmf/doc/man/man1/lacheck.1 +++ b/Master/texmf/doc/man/man1/lacheck.1 @@ -1,4 +1,4 @@ -.TH "LaCheck" "1" "01/20/07" "Release 1.26" +.TH "LaCheck" "1" "07/17/08" "Release 1.26" .SH NAME lacheck - A consistency checker for LaTeX documents. .SH SYNOPSIS diff --git a/Master/texmf/doc/man/man1/latex.1 b/Master/texmf/doc/man/man1/latex.1 index 2e552728ed7..7e862ffd3d4 100644 --- a/Master/texmf/doc/man/man1/latex.1 +++ b/Master/texmf/doc/man/man1/latex.1 @@ -1,4 +1,4 @@ -.TH LATEX 1 "7 January 2007" "Web2C 7.5.6" +.TH LATEX 1 "7 January 2007" "Web2C 7.5.7" .\"===================================================================== .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/makeindex.1 b/Master/texmf/doc/man/man1/makeindex.1 index 1404df6cf74..9476aebc58d 100644 --- a/Master/texmf/doc/man/man1/makeindex.1 +++ b/Master/texmf/doc/man/man1/makeindex.1 @@ -284,6 +284,13 @@ that its argument is an index entry. Delimiter denoting a new level of subitem. .RE .TP +.BR page_compositor " <string>" +"-" +.RS +Delimiter separating parts of a composite page number (see +\s-2SPECIAL EFFECTS\s+2 below). +.RE +.TP .BR quote " <char>" \'"\' .RS @@ -990,7 +997,7 @@ will be turned into with a warning message in the transcript file complaining about an illegal range formation. .LP -Finally, every special symbol mentioned in this section may be +Every special symbol mentioned in this section may be escaped by the .B quote operator (`"'). Thus @@ -1026,8 +1033,14 @@ becomes .LP which represents an umlaut-accented `u' to the \*(TX family of processors. +.LP +A page number can be a composite of one or more fields +separated by the delimiter bound to +.B page_compositor +(`-'), e.g., II-12 for page 12 of Chapter II. Page numbers may +contain up to ten fields. .PP -From version 2.11 of +Since version 2.11 of .IR makeindex , the .B quote diff --git a/Master/texmf/doc/man/man1/makeinfo.1 b/Master/texmf/doc/man/man1/makeinfo.1 index 7b46491e0a6..0850e5f1b99 100644 --- a/Master/texmf/doc/man/man1/makeinfo.1 +++ b/Master/texmf/doc/man/man1/makeinfo.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.34. -.TH MAKEINFO "1" "December 2004" "makeinfo 4.8" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH MAKEINFO "1" "April 2008" "makeinfo 4.12" "User Commands" .SH NAME makeinfo \- translate Texinfo documents .SH SYNOPSIS @@ -13,6 +13,9 @@ Info files suitable for reading online with Emacs or standalone GNU Info. \fB\-\-error\-limit\fR=\fINUM\fR quit after NUM errors (default 100). .TP +\fB\-\-document\-language\fR=\fISTR\fR locale to use in translating Texinfo keywords +for the output document (default C). +.TP \fB\-\-force\fR preserve output even if errors. .TP @@ -25,9 +28,6 @@ suppress node cross\-reference validation. \fB\-\-no\-warn\fR suppress warnings (but not errors). .TP -\fB\-\-reference\-limit\fR=\fINUM\fR -warn about at most NUM references (default 1000). -.TP \fB\-v\fR, \fB\-\-verbose\fR explain what is being done. .TP @@ -48,8 +48,8 @@ output Texinfo XML rather than Info. output plain text rather than Info. .SS "General output options:" .TP -\fB\-E\fR, \fB\-\-macro\-expand\fR FILE -output macro\-expanded source to FILE. +\fB\-E\fR, \fB\-\-macro\-expand\fR=\fIFILE\fR +output macro\-expanded source to FILE, ignoring any @setfilename. .TP \fB\-\-no\-headers\fR @@ -59,19 +59,22 @@ or from HTML (thus producing shorter output); also, write to standard output by default. .TP \fB\-\-no\-split\fR -suppress splitting of Info or HTML output, +suppress the splitting of Info or HTML output, generate only one output file. .TP \fB\-\-number\-sections\fR output chapter and sectioning numbers. .TP \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR -output to FILE (directory if split HTML), +output to FILE (or directory if split HTML). .SS "Options for Info and plain text:" .TP +\fB\-\-disable\-encoding\fR +do not output accented and special characters +in Info output based on @documentencoding. +.TP \fB\-\-enable\-encoding\fR -output accented and special characters in -Info output based on @documentencoding. +override \fB\-\-disable\-encoding\fR (default). .TP \fB\-\-fill\-column\fR=\fINUM\fR break Info lines at NUM characters (default 72). @@ -79,9 +82,8 @@ break Info lines at NUM characters (default 72). \fB\-\-footnote\-style\fR=\fISTYLE\fR output footnotes in Info according to STYLE: `separate' to put them in their own node; -`end' to put them at the end of the node -.IP -in which they are defined (default). +`end' to put them at the end of the node, in +which they are defined (this is the default). .TP \fB\-\-paragraph\-indent\fR=\fIVAL\fR indent Info paragraphs by VAL spaces (default 3). @@ -95,6 +97,12 @@ split Info files at size NUM (default 300000). \fB\-\-css\-include\fR=\fIFILE\fR include FILE in HTML <style> output; read stdin if FILE is \-. +.TP +\fB\-\-css\-ref\fR=\fIURL\fR +generate reference to a CSS file. +.TP +\fB\-\-transliterate\-file\-names\fR +produce file names in ASCII transliteration. .SS "Options for XML and Docbook:" .TP \fB\-\-output\-indent\fR=\fIVAL\fR @@ -154,9 +162,9 @@ do not process @iftex and @tex text. .TP \fB\-\-no\-ifxml\fR do not process @ifxml and @xml text. -.IP +.P Also, for the \fB\-\-no\-ifFORMAT\fR options, do process @ifnotFORMAT text. -.IP +.P The defaults for the @if... conditionals depend on the output format: if generating HTML, \fB\-\-ifhtml\fR is on and the others are off; if generating Info, \fB\-\-ifinfo\fR is on and the others are off; @@ -178,19 +186,25 @@ write DocBook XML to @setfilename .TP makeinfo \fB\-\-no\-headers\fR foo.texi write plain text to standard output -.IP -makeinfo \fB\-\-html\fR \fB\-\-no\-headers\fR foo.texi write html without node lines, menus -makeinfo \fB\-\-number\-sections\fR foo.texi write Info with numbered sections -makeinfo \fB\-\-no\-split\fR foo.texi write one Info file however big +.TP +makeinfo \fB\-\-html\fR \fB\-\-no\-headers\fR foo.texi +write html without node lines, menus +.TP +makeinfo \fB\-\-number\-sections\fR foo.texi +write Info with numbered sections +.TP +makeinfo \fB\-\-no\-split\fR foo.texi +write one Info file however big .SH "REPORTING BUGS" Email bug reports to bug\-texinfo@gnu.org, general questions and discussion to help\-texinfo@gnu.org. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2004 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B makeinfo diff --git a/Master/texmf/doc/man/man1/makempx.1 b/Master/texmf/doc/man/man1/makempx.1 index e0303101ccc..508d3753326 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.6" +.TH MAKEMPX 1 "4 January 1998" "Web2C 7.5.7" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mf.1 b/Master/texmf/doc/man/man1/mf.1 index b444de89a61..a8b897a77d6 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.6" +.TH MF 1 "10 November 2001" "Web2C 7.5.7" .\"===================================================================== .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 5461047e0c5..54bd66b02e9 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.6" +.TH MFT 1 "14 December 1993" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/mkjobtexmf.1 b/Master/texmf/doc/man/man1/mkjobtexmf.1 index bba1d5d41b8..58086652c0e 100644 --- a/Master/texmf/doc/man/man1/mkjobtexmf.1 +++ b/Master/texmf/doc/man/man1/mkjobtexmf.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "MKJOBTEXMF 1" -.TH MKJOBTEXMF 1 "2008-06-28" "perl v5.8.1" "User Contributed Perl Documentation" +.TH MKJOBTEXMF 1 "2007-09-06" "perl v5.8.1" "User Contributed Perl Documentation" .SH "NAME" mkjobtexmf \-\- Generate a texmf tree for a particular job .SH "SYNOPSIS" @@ -405,11 +405,3 @@ modify it under the same terms as Perl itself * Support for `configure' added. (Thanks to Norbert Preining for writing a first version of the configure stuff.) -.IP "2008/04/05 v0.6" 4 -.IX Item "2008/04/05 v0.6" -* Tiny fix in target `uninstall' in file `Makefile.in'. - (Thanks to Karl Berry) -.IP "2008/06/28 v0.7" 4 -.IX Item "2008/06/28 v0.7" -* Fix for unknown option `\-\-cmd\-strace'. - (Thanks to Juho Niemel"a) diff --git a/Master/texmf/doc/man/man1/mktexlsr.1 b/Master/texmf/doc/man/man1/mktexlsr.1 index 4d2f59b28de..1449aa3e08a 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.6" +.TH MKTEXLSR 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 338053f55ba..03a1b226ab3 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.6" +.TH MKTEXMF 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 6e5ae98f101..6db6e40c0b7 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.6" +.TH MKTEXPK 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 0408897d2d1..6e999865669 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.6" +.TH MKTEXTFM 1 "4 January 1998" "Kpathsea 3.5.7" .\"===================================================================== .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 db1f3264fd3..5cc80bd2669 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.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/mmpfb.1 b/Master/texmf/doc/man/man1/mmpfb.1 index dc13d53aa9d..9d3ce0f5a1e 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.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/mpost.1 b/Master/texmf/doc/man/man1/mpost.1 index bc6e3a7bfeb..2c3951866e2 100644 --- a/Master/texmf/doc/man/man1/mpost.1 +++ b/Master/texmf/doc/man/man1/mpost.1 @@ -1,4 +1,4 @@ -.TH MPOST 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.6" +.TH MPOST 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.7" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mpto.1 b/Master/texmf/doc/man/man1/mpto.1 index 954f47f9428..309afe0c279 100644 --- a/Master/texmf/doc/man/man1/mpto.1 +++ b/Master/texmf/doc/man/man1/mpto.1 @@ -1,4 +1,4 @@ -.TH MPTO 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.6" +.TH MPTO 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.7" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/newer.1 b/Master/texmf/doc/man/man1/newer.1 index 313b8db4b8c..931c541a9c7 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.6" +.TH NEWER 1 "21 June 2005" "Web2C 7.5.7" .\"===================================================================== .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 d13c6a11ccd..b65300057d3 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.6" +.TH OMEGA 1 "27 December 1997" "Web2C 7.5.7" .\"===================================================================== .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 d4ebd306406..6ed20e60a2f 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.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/otftotfm.1 b/Master/texmf/doc/man/man1/otftotfm.1 index feae43f9740..e1d87b48cf6 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.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -205,10 +205,20 @@ LaTeX. We begin with six fonts: "MinionPro-Regular.otf", .PP Our first task is to decide how to encode the fonts. The "encoding scheme" is used by TeX to decide how to typeset accents and symbols like "$". The -"LY1" encoding scheme is a good choice for many OpenType fonts; it -corresponds to the "texnansx.enc" encoding file, so we will supply +"LY1" encoding scheme has reasonable accent support and is a good choice +for many OpenType fonts. LY1 corresponds to the "texnansx.enc" encoding +file, so we will supply .B otftotfm with the "\fB\-e\fR texnansx" option. +.RS +.LP +Expert note: Strictly speaking, LY1 corresponds to the "texnansi.enc" +encoding file. Since the "texnansx.enc" version omits duplicate +characters, it has more room for font-specific glyphs and is generally a +better choice; but if you plan to type characters like "ae" directly into +your editor, rather than using TeX commands like \eae, you should use +"texnansi.enc". +.RE .PP Next, we decide on a naming scheme for the font metric files. Let's use the OpenType font names as a base. (There's generally no need to follow @@ -637,6 +647,41 @@ the output encoding will equal the input encoding (and .B otftotfm will not generate an output encoding). ' +.Sp +.TP 5 +.BI \-\-base\-encodings= file +.B Experts only. +Allow the output font to refer to existing "base" fonts. This can greatly +reduce the number of base fonts generated by +.BR otftotfm ". " +Each line in the +.I file +argument contains a TeX font name (as for +.BR \-\-name ) +and a corresponding literal encoding file (as for +.BR \-\-literal\-encoding ); +for example: +.nf + WarnoProReg\-\-eka eka + WarnoProReg\-\-exp1 exp1 +.fi +The named fonts must have been created by prior runs of +.B otftotfm +on the same input OpenType font, with the same +.BR \-\-extend +and +.BR \-\-slant +options as the current run. The current output font will refer to glyphs +from the named base fonts when possible. If the base fonts cover all +glyphs required by the output font, +.B otftotfm +won't generate any new base fonts at all. The +.I file +can also refer to dotless-J fonts using the following syntax: +.nf + WarnoProReg\-\-lcdfj \- dotlessj +.fi +' .PD ' ' diff --git a/Master/texmf/doc/man/man1/patgen.1 b/Master/texmf/doc/man/man1/patgen.1 index 18ab210d8fd..25a9701a230 100644 --- a/Master/texmf/doc/man/man1/patgen.1 +++ b/Master/texmf/doc/man/man1/patgen.1 @@ -1,9 +1,10 @@ -.TH PATGEN 1 "23 August 2004" "Web2C 7.5.6" +.TH PATGEN 1 "25 November 2007" "Web2C 7.5.7" .\"===================================================================== .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 +.el .ds OX TeX +.\" that's 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 @@ -19,19 +20,18 @@ patgen \- generate patterns for TeX hyphenation .I dictionary_file pattern_file patout_file translate_file .\"===================================================================== .SH DESCRIPTION -This manual page is not meant to be exhaustive. The complete -documentation for this version of \*(TX can be found in the info file -or manual +This manual page is not meant to be exhaustive. +See also the Info file or manual .IR "Web2C: A TeX implementation" . .PP The -.B patgen +.I patgen program reads the .I dictionary_file containing a list of hyphenated words and the .I pattern_file containing previously-generated patterns (if any) for a particular -language, and produces the +language (not a complete TeX source file; see below), and produces the .I patout_file with (previously- plus newly-generated) hyphenation patterns for that language. The @@ -43,28 +43,26 @@ of the lower and upper case version(s) of all \`letters' of that language. Further details of the pattern generation process such as hyphenation levels and pattern lengths are requested interactively from the user's terminal. Optionally -.B patgen +.I patgen creates a new dictionary file .BI pattmp. n showing the good and bad hyphens found by the generated patterns, where .I n -is the highest hypenation level. +is the highest hyphenation level. .PP The patterns generated by -.B patgen +.I patgen can be read by .B initex -for use in hyphenating words. For a (very) long example of +for use in hyphenating words. For a real-life example of .IR patgen 's output, see .IR $TEXMFMAIN/tex/generic/hyphen/hyphen.tex , -which contains the patterns \*(TX uses for English. -At some sites, patterns for several other languages may be available, +which contains the patterns \*(TX uses for English by default. +At some sites, patterns for (many) other languages may be available, and the local .B tex -programs may have them preloaded; consult your -.I Local Guide -or your system administrator for details. +programs may have them preloaded. .PP All filenames must be complete; no adding of default extensions or path searching is done. @@ -79,7 +77,7 @@ must entirely consist of digits (hyphenation levels), dots (\`.', edge of a word), and letters. In pattern files for non-English languages letters are often represented by macros or other expandable constructs. For the purpose of -.B patgen +.I patgen these are just character sequences, subject to the condition that no such sequence is a prefix of another one. .TP \w'@@'u+2n @@ -95,10 +93,23 @@ replacements as defined in the translate file) for hyphens yet to be found, \`good' hyphens (correctly found by the patterns), and \`bad' hyphens (erroneously found by the patterns) respectively; when reading a dictionary file \`*' is treated like \`-' and \`.' is ignored. -.TP \w'@@'u+2n +.TP +.B Pattern file +A pattern file contains only patterns in the format above, e.g., from a +previous run of patgen. It may \fInot\fR contain any \*(TX comments or +control sequences. For instance, this is not a valid pattern file: +.nf + +% this is a pattern file read by TeX. +\\patterns{% + ... +} +.fi +It can only contain the actual patterns, i.e., the `...'. +.TP .B Translate file A translate file starts with a line containing the values of -.I left_hypen_min +.I left_hyphen_min in columns 1-2, .I right_hyphen_min in columns 3-4, and either a blank or the replacement for one of the @@ -112,19 +123,19 @@ one terminated by the delimiter and the whole sequence terminated by another delimiter. If the translate file is empty, the values -.IR left_hypen_min "=2, " right_hyphen_min "=3," +.IR left_hyphen_min "=2, " right_hyphen_min "=3," and the 26 lower case letters .IR a ... z with their upper case representations .IR A ... Z are assumed. -.TP \w'@@'u+2n +.TP .B Terminal input After reading the .I translate_file and any previously-generated patterns from .IR pattern_file, -.B patgen +.I patgen requests input from the user's terminal. First the integer values of @@ -143,19 +154,30 @@ the weights for good and bad hyphens and a weight threshold for useful patterns. Finally the decision (\`y' or \`Y' vs. anything else) whether or not to -produce a hypenated word list. +produce a hyphenated word list. .\"===================================================================== .SH FILES .TP \w'@@'u+2n .I $TEXMFMAIN/tex/generic/hyphen/hyphen.tex -Patterns for English. +The original hyphenation patterns for English, by Donald Knuth and Frank +Liang. +.TP +.I $TEXMFMAIN/tex/generic/hyphen/ushyphmax.tex +Maximal hyphenation patterns for English, extended by Gerard Kuiken. +.TP +.I http://www.ctan.org/tex-archive/language/ +Patterns and support for many other languages .\"===================================================================== .SH "SEE ALSO" +Frank Liang and Peter Breitenlohner, +patgen.web. +.PP Frank Liang, .IR "Word hy-phen-a-tion by com-puter" , STAN-CS-83-977, -Stanford University Ph.D. thesis, 1983. -.br +Stanford University Ph.D. thesis, 1983, +http://tug.org/docs/liang. +.PP Donald E. Knuth, .IR "The \*(OXbook" , Addison-Wesley, 1986, ISBN 0-201-13447-0, Appendix H. @@ -166,5 +188,4 @@ Breitenlohner made a substantial revision in 1991 for \*(TX 3. The first version was published as the appendix to the .I \*(OXware -technical report, available from the \*(TX Users Group. Howard Trickey -originally ported it to Unix. +technical report. Howard Trickey originally ported it to Unix. diff --git a/Master/texmf/doc/man/man1/pdfetex.1 b/Master/texmf/doc/man/man1/pdfetex.1 index eac871edc1e..901b40515ea 100644 --- a/Master/texmf/doc/man/man1/pdfetex.1 +++ b/Master/texmf/doc/man/man1/pdfetex.1 @@ -1,4 +1,4 @@ -.TH PDFETEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.6" +.TH PDFETEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/pdftex.1 b/Master/texmf/doc/man/man1/pdftex.1 index 3ea9021acf2..75c4b2f8c94 100644 --- a/Master/texmf/doc/man/man1/pdftex.1 +++ b/Master/texmf/doc/man/man1/pdftex.1 @@ -1,4 +1,4 @@ -.TH PDFTEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.6" +.TH PDFTEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/pdftexi2dvi.1 b/Master/texmf/doc/man/man1/pdftexi2dvi.1 new file mode 100644 index 00000000000..76d34b6e3da --- /dev/null +++ b/Master/texmf/doc/man/man1/pdftexi2dvi.1 @@ -0,0 +1,184 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH TEXI2DVI "1" "April 2008" "texi2dvi 1.122" "User Commands" +.SH NAME +texi2dvi \- convert Texinfo documents to PDF +.SH SYNOPSIS +.B texi2dvi +[\fIOPTION\fR]... \fIFILE\fR... +.SH DESCRIPTION +Run each Texinfo or (La)TeX FILE through TeX in turn until all +cross\-references are resolved, building all indices. The directory +containing each FILE is searched for included files. The suffix of FILE +is used to determine its language ((La)TeX or Texinfo). To process +(e)plain TeX files, set the environment variable LATEX=tex. +.PP +In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, +the FILE may also be composed of the following simple TeX commands. +.TP +`\einput{FILE}' +the actual file to compile +.TP +`\enonstopmode' +same as \fB\-\-batch\fR +.PP +Makeinfo is used to perform Texinfo macro expansion before running TeX +when needed. +.SS "General options:" +.TP +\fB\-b\fR, \fB\-\-batch\fR +no interaction +.TP +\fB\-D\fR, \fB\-\-debug\fR +turn on shell debugging (set \fB\-x\fR) +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit successfully +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR +leave output in OFILE (implies \fB\-\-clean\fR); +only one input FILE may be specified in this case +.TP +\fB\-q\fR, \fB\-\-quiet\fR +no output unless errors (implies \fB\-\-batch\fR) +.TP +\fB\-s\fR, \fB\-\-silent\fR +same as \fB\-\-quiet\fR +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit successfully +.TP +\fB\-V\fR, \fB\-\-verbose\fR +report on what is done +.SS "TeX tuning:" +.TP +\-@ +use @input instead of \einput for preloaded Texinfo +.TP +\fB\-\-dvi\fR +output a DVI file [default] +.TP +\fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR +force macro expansion using makeinfo +.TP +\fB\-I\fR DIR +search DIR for Texinfo files +.TP +\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR +specify the LANG of FILE (LaTeX or Texinfo) +.TP +\fB\-\-no\-line\-error\fR +do not pass \fB\-\-file\-line\-error\fR to TeX +.TP +\fB\-p\fR, \fB\-\-pdf\fR +use pdftex or pdflatex for processing +.TP +\fB\-r\fR, \fB\-\-recode\fR +call recode before TeX to translate input +.TP +\fB\-\-recode\-from\fR=\fIENC\fR +recode from ENC to the @documentencoding +.TP +\fB\-\-src\-specials\fR +pass \fB\-\-src\-specials\fR to TeX +.TP +\fB\-t\fR, \fB\-\-command\fR=\fICMD\fR +insert CMD in copy of input file +.TP +or \fB\-\-texinfo\fR=\fICMD\fR +multiple values accumulate +.TP +\fB\-\-translate\-file\fR=\fIFILE\fR +use given charset translation file for TeX +.SS "Build modes:" +.TP +\fB\-\-build\fR=\fIMODE\fR +specify the treatment of auxiliary files [local] +.TP +\fB\-\-tidy\fR +same as \fB\-\-build\fR=\fItidy\fR +.TP +\fB\-c\fR, \fB\-\-clean\fR +same as \fB\-\-build\fR=\fIclean\fR +.TP +\fB\-\-build\-dir\fR=\fIDIR\fR +specify where the tidy compilation is performed; +implies \fB\-\-tidy\fR; +defaults to TEXI2DVI_BUILD_DIRECTORY [.] +.TP +\fB\-\-mostly\-clean\fR +remove the auxiliary files and directories +but not the output +.PP +The MODE specifies where the TeX compilation takes place, and, as a +consequence, how auxiliary files are treated. The build mode +can also be set using the environment variable TEXI2DVI_BUILD_MODE. +.SS "Valid MODEs are:" +.TP +`local' +compile in the current directory, leaving all the auxiliary +files around. This is the traditional TeX use. +.TP +`tidy' +compile in a local *.t2d directory, where the auxiliary files +are left. Output files are copied back to the original file. +.TP +`clean' +same as `tidy', but remove the auxiliary directory afterwards. +Every compilation therefore requires the full cycle. +.SS "Using the `tidy' mode brings several advantages:" +.TP +\- +the current directory is not cluttered with plethora of temporary files. +.TP +\- +clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d +directories are stored there. +.TP +\- +clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d +or \fB\-\-build\-dir=\fR$HOME/.t2d. +.TP +\- +the output file is updated after every succesful TeX run, for +sake of concurrent visualization of the output. In a `local' build +the viewer stops during the whole TeX run. +.TP +\- +if the compilation fails, the previous state of the output file +is preserved. +.TP +\- +PDF and DVI compilation are kept in separate subdirectories +preventing any possibility of auxiliary file incompatibility. +.PP +On the other hand, because `tidy' compilation takes place in another +directory, occasionally TeX won't be able to find some files (e.g., when +using \egraphicspath): in that case use \fB\-I\fR to specify the additional +directories to consider. +.PP +The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, +TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used +to run those commands, if they are set. Any CMD strings are added +after @setfilename for Texinfo input, in the first line for LaTeX input. +.SH "REPORTING BUGS" +Email bug reports to <bug\-texinfo@gnu.org>, +general questions and discussion to <help\-texinfo@gnu.org>. +Texinfo home page: http://www.gnu.org/software/texinfo/ +.SH COPYRIGHT +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +The full documentation for +.B texi2dvi +is maintained as a Texinfo manual. If the +.B info +and +.B texi2dvi +programs are properly installed at your site, the command +.IP +.B info texi2dvi +.PP +should give you access to the complete manual. diff --git a/Master/texmf/doc/man/man1/pktogf.1 b/Master/texmf/doc/man/man1/pktogf.1 index 35ea0f1cd88..848d017a8bd 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.6" +.TH PKTOGF 1 "14 December 1993" "Web2C 7.5.7" .\"===================================================================== .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 9851433f778..cce8ec28d3d 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.6" +.TH PKTYPE 1 "13 March 1996" "Web2C 7.5.7" .\"===================================================================== .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 498704375ed..5c27c460c20 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.6" +.TH PLTOTF 1 "27 December 1992" "Web2C 7.5.7" .\"===================================================================== .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 a02050efeb2..a999e191834 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.6" +.TH POOLTYPE 1 "27 December 1992" "Web2C 7.5.7" .\"===================================================================== .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/ps2eps.1 b/Master/texmf/doc/man/man1/ps2eps.1 new file mode 100644 index 00000000000..4c0c674ada8 --- /dev/null +++ b/Master/texmf/doc/man/man1/ps2eps.1 @@ -0,0 +1,357 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "PS2EPS" "1" "24 Januar 2007" "" "" + +.SH NAME +ps2eps \- convert PostScript to EPS (Encapsulated PostScript) files +.SH SYNOPSIS + +\fBps2eps\fR [ \fB-f\fR ] [ \fB-q\fR ] [ \fB-N\fR ] [ \fB-O\fR ] [ \fB-n\fR ] [ \fB-P\fR ] [ \fB-c\fR ] [ \fB-C\fR ] [ \fB-m\fR ] [ \fB-B\fR ] [ \fB-E\fR ] [ \fB-s \fIpagedim\fB\fR ] [ \fB-t \fIoffset\fB\fR ] [ \fB-r \fIresolution\fB\fR ] [ \fB-R \fI+|-|^\fB\fR ] [ \fB-l\fR ] [ \fB-g\fR ] [ \fB-H\fR ] [ \fB-d\fR ] [ \fB-h|--help\fR ] [ \fB-W\fR ] [ \fB-L\fR ] [ \fB-V|--version\fR ] [ \fB--\fR ] [ \fB\fIpsfile1\fB\fR ] [ \fB\fIpsfile2\fB\fR ] [ \fB\fI\&...\fB\fR ] + +.SH "DESCRIPTION" +.PP +This manual page documents \fBps2eps\fR version 1.64. +.PP +\fBps2eps\fR is a tool (written in Perl) to produce +Encapsulated PostScript Files (EPS/EPSF) from usual one-paged Postscript +documents. It calculates correct Bounding Boxes for those EPS files and +filters some special postscript command sequences that can produce +erroneous results on printers. EPS files are often needed for including +(scalable) graphics of high quality into TeX/LaTeX (or even Word) documents. +.PP +Without any argument, ps2eps reads from standard input +and writes to standard output. +If filenames are given as arguments they are processed +one by one and output files are written to filenames +with extension \fI\&.eps\fR\&. If input filenames have the +extension \fI\&.ps\fR or \fI\&.prn\fR, this extension is replaced with \fI\&.eps\fR\&. +In all other cases \fI\&.eps\fR is appended to the input filename. +Please note that PostScript files for input should contain +only one single page (you can possibly use the \fBpsselect\fR from the +psutils package to extract a single page from a document that +contains multiple pages). +.PP +If BoundingBox in output seems to be wrong, please try options \fB--size\fR or +\fB--ignoreBB\fR\&. See also section TROUBLESHOOTING. +.SH "OPTIONS" +.PP +\fBps2eps\fR follows the usual GNU command line syntax, +with long options starting with two dashes (`-'). A summary of +options is included below. +.TP +\fB-h, --help \fR +Show summary of options. +.TP +\fB-V, --version \fR +Show version of program. +.TP +\fB-f, --force \fR +Force overwriting existing files. \fBps2eps\fR +will not overwrite files by default to avoid deleting original EPS +files accidently. +.TP +\fB-q, --quiet \fR +quiet operation (no output while processing files, except errors). +.TP +\fB-N, --noinsert \fR +do not insert any postscript code. Normally a few postscript +instructions are added around the original postscript code by +\fBps2eps\fR which can be turned off by this option. +.TP +\fB-O, --preserveorientation \fR +do not filter %%Orientation: header comment. +.TP +\fB-n, --nofix \fR +do not try to fix postscript code by filtering some instructions. +.TP +\fB-P, --removepreview \fR +remove preview image (smaller file, but no preview anymore). +.TP +\fB-F, --fixps \fR +fix postscript code unconditionally. Otherwise, filtering is +usually triggered by detection of certain drivers only. +.TP +\fB-c, --comments \fR +preserve document structure comments. +.TP +\fB-C, --clip \fR +insert postscript code for clipping. Unless +\fB--nohires\fR is specified, the HiResBoundingBox +(enlarged by 0.1 points) is used for clipping. +.TP +\fB-m, --mono \fR +use black/white bitmap as base for calculation (default: off). +.TP +\fB-s, --size=pagedim \fR +where pagedim is a pre-defined standard page size +(e.g., a4,a0,b0,letter,...) or explicitly specified in a +format pagedim:=\fIX\fRx\fIY\fR[cm|in], +where \fIX\fR and \fIY\fR are numbers (floating points are accepted) followed by +units centimeter (cm) or inch (in), (default: cm). +Use \fB--size=list\fR to list pre-defined pagesizes. +See also environment variable PS2EPS_SIZE\&. +.TP +\fB-t, --translate=x,y \fR +specify an x,y offset (may be negative) in postscript points +(1/72 dpi) for drawing. This option may be required +if your drawing has negative coordinates which usually lets ghostscript +cut the negative part of your picture, because it starts to render +at positive coordinates. The resulting output will +also be shifted. +.TP +\fB-r, --resolution=dpi \fR +specify a resolution in dpi (dots per inch) for drawing under +ghostscript. Default +resolution is 144 dpi which is the double of the typical 72 dpi. +This option may help if there is a hardware dependent resolution +encoded in the postscript, e.g., 600dpi. Example: +\fBps2eps -l -r 600 test.ps\fR +.TP +\fB-R, --rotate=direction \fR +This option rotates the resulting EPS output. +The parameter direction determines the direction of +rotation: + means +90 degrees (clockwise),- means -90 degrees +(counter-clockwise), and ^ means 180 degrees (up-side down). +.TP +\fB-l, --loose \fR +expand the original tight bounding box by one point in each +direction. +.TP +\fB-B, --ignoreBB \fR +do not use existing bounding box as page size for +rendering. +.TP +\fB-E, --ignoreEOF \fR +do not use %%EOF as hint for end of file. Otherwise, \fBps2eps\fR assumes +that postscript code ends after the last %%EOF comment, because +some drivers add trailing binary ``garbage'' code which gets deleted +by \fBps2eps\fR by default. +.TP +\fB-g, --gsbbox \fR +use internal bbox device of ghostscript instead of the external C +program \fBbbox\fR\&. The internal bbox device of ghostscript +generates different values (sometimes even incorrect), +so using the provided \fBbbox\fR should be more robust. +See also environment variable PS2EPS_GSBBOX\&. +.TP +\fB-H, --nohires \fR +do not generate a %%HiResBoundingBox comment for output. +.TP +\fB-L, --license \fR +show licensing information. +.TP +\fB-d, --debuggs \fR +show ghostscript call. This may be helpful for solving problems that +occur during a ghostscript call. +.TP +\fB-W, --warnings \fR +show warnings about sanity of generated EPS file. Certain +postscript commands should not be contained in an EPS file. +With this option set \fBps2eps\fR will issue a warning if it +detects at least one of them. +.SH "TROUBLESHOOTING" +.PP +Based on the given postscript source code (in most cases generated by +some postscript printer driver) there are many potential obstacles or +problems that may occur when trying to create proper EPS files. Please +read this section carefully to be aware of common pitfalls. +.SS "INCOMPLETE/CLIPPED IMAGES" +.PP +or how to determine the right size for ghostscript. +.PP +If you have documents that are larger than your +ghostscript default (usually A4 or US letter), you have to +specify the page dimensions explicitly using the +\fB-s\fR option. Otherwise your EPS +might be cut off during rasterizing by ghostscript resulting +in a wrongly calculated bounding box. You can pass +all pre-defined page sizes to \fB-s\fR that ghostscript understands. These are +currently: 11x17, ledger, legal, letter, lettersmall, archA, archB, archC, archD, archE +a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, isob0, isob1, isob2, isob3, isob4, isob5, isob6, +b0, b1, b2, b3, b4, b5, c0, c1, c2, c3, c4, c5, c6, jisb0, jisb1, +jisb2, jisb3, jisb4, jisb5, jisb6, flsa, flse, halfletter. +Unfortunately, all sizes are currently only available in portrait +orientation (not landscape). +.PP +By default, \fBps2eps\fR uses an already given %%BoundingBox +from the source file, which often corresponds to the size of +the physical page format for which the document was +printed. However, you should be aware that this already +specified bounding box may be not correct, thus resulting in a +wrongly cropped (or even no usable) \fI\&.eps\fR-file. +\fBps2eps\fR can only do as good as ghostscript does in rendering the original +postscript file (though \fBps2eps\fR even works with negative and +fractional values are contained in the original bounding box by using +automatic translation). Therefore, if the given bounding box is to +small or incorrect anyway, you can ignore the existing bounding box with the \fB-B\fR +option, which will cause ghostscript to use its internal +default size (or use \fB-s\fR). However, if the +BoundingBox has negative coordinates, which is not allowed by +the specification, \fBps2eps\fR will shift the output to positive values. +.PP +Hint: to avoid rotating the picture +if you have the original drawing in landscape format, you may +use the ``Encapsulated Postscript'' option in the printer driver +which should generate an EPS file (but with a bounding box of +the sheet size!). But some Windows printer drivers are drawing +the image with an offset from the bottom of the portrait page, +so that a part of it is drawn outside the landscape oriented +page. In this case, you'll have to specify a square size of +the page using the maximum length, e.g., 29.7cm x 29.7cm for +an A4 page. +.SS "CLIPPING" +.PP +or why gets some of my text deleted above the included \fI\&.eps\fR file? +.PP +Some postscript drivers draw a white rectangle from the top left +corner of the page to the right lower corner of the object. This may +erase some or even all text above your imported/included EPS file, +which is very annoying. In order to prevent this, most programs have a +clipping option for imported \fI\&.eps\fR files (within LaTeX you can use +\\includegraphics*{}) for this purpose. If this is unfortunately not +the case, you can use the \fB-C\fR option of \fBps2eps\fR which will (hopefully) +do it for you. Unfortunately, PScript.dll 5.2 (Windows XP) introduced +new very badly behaving Postscript code (initclip) which will even +override the outer clipping! Thus, a new filter had to be installed +in \fBps2eps\fR which will fix it. +.PP +However, because most programs clip directly on the bounding box, +you still may loose some pixels of your image, because the bounding +box is described in the coarse resolution of postscript points, +i.e. 72 dpi. In order to prevent this, you can use the \fB-l\fR +option or \fB-C\fR option (for the latter, clipping by the importing program +should be disabled then) to allow for a 1 point larger bounding box. +\fB-C\fR clips around a 1 point enlarged bounding box and \fB-l\fR enlarges the +bounding box values by 1 point (you can also combine both options). +.SS "INCLUDED FILTERS" +.PP +Some postscript sequences, e.g., for using specific printer +features (featurebegin ...), are not working well within an \fI\&.eps\fR +file, so \fBps2eps\fR tries to filter them out. But please note that +filters for postscript code may not work properly for your printer +driver (\fBps2eps\fR was mainly tested with HP and Adobe printer +drivers, although it may work for all printers using the +PScript.dll). In this case you can try to turn of filtering by +using option \fB-n\fR, or try to find the bad sequence in the postscript +code and adapt the filter rule in the \fBps2eps\fR script (variables +$linefilter, $rangefilter_begin, $rangefilter_end; linefilter is +an expression for filtering single lines, rangefilter_... are +expressions that filter all lines between a pattern matching +$rangefilter_begin and $rangefilter_end; drop me an e-mail with +your modifications). However, things may change as the printer +drivers (e.g., PScript.dll) or postscript language evolve. +.PP +Some applications or drivers generate postscript code with leading +or trailing binary code, which often confuses older postscript +interpreters. \fBps2eps\fR tries to remove such code, but it may +sometimes make a wrong guess about start and end of the real +postscript code (drop me an e-mail with a zipped postscript +source, see section BUGS). +.PP +Comment lines or even blank lines are removed +(which is the default to make .eps files smaller), which may corrupt your +output. Please check the next section how to fix this. +\fBps2eps\fR removes blank lines and also <CR> (carriage ceturn +``\\r'') at the end of lines. However, nicely formatted postscript code +gives a hint by using ``%%BeginBinary'' ``%%EndBinary'' comments. When +\fBps2eps\fR detects these comments it will refrain from any filtering +action within the marked binary sections. +.PP +\fBps2eps\fR filters also %%Orientation: comments by +default (you can use option \fB-O\fR to turn off filtering), +because ghostscript may ``automagically'' rotate images when generating PDF +images, which is not desired in most cases. Hint: you can turn off that +feature in ghostscript unconditionally by specifying -dAutoRotatePages=/None. +.SS "CORRUPTED OUTPUT" +.PP +Some postscript code may get corrupted when comment lines or even blank +lines are removed (which is the default to make .eps files smaller), +because those files may contain encoded images +which also have a % as first character in a line or use a special +comment as end of image delimiter. If this is the case, use the \fB-c\fR +option to prevent filtering comments. +.SS "COLOR AND MEMORY" +.PP +\fBps2eps\fR supports colored postscript, consequently +letting ghostscript consume more resources for drawing its bitmap +(roughly 6MBytes for an A4 page). \fBbbox\fR is reading +the bitmap line by line so it consumes only minimal memory. If you experience problems +with memory consumption of ghostscript, you may use the \fB-m\fR option +for using a monochrome image. But this will probably result in wrongly +determined bounding boxes with colored +images, because ghostscript has to do black/white dithering and may thus suppress +objects drawn in light colors. +.SH "ENVIRONMENT VARIABLES" +.PP +Please note that a command line option always takes precedence over +the related environment variable. +.PP +The environment variable PS2EPS_SIZE can be used +to specify a default page size and take any argument that +\fB--size\fR accepts. Examples: \fBexport PS2EPS_SIZE=a0\fR (bash-like syntax) +or \fBsetenv PS2EPS_SIZE letter\fR (csh syntax). +.PP +If the environment variable PS2EPS_GSBBOX is set +the internal bbox device of ghostscript will be used instead of the external +command \fBbbox\fR\&. Examples: \fBexport PS2EPS_GSBBOX=true\fR (bash-like syntax) +or \fBsetenv PS2EPS_GSBBOX 1\fR (csh syntax). +.SH "EXAMPLES" +.PP +The usual call is simply: +\fBps2eps -l \fIfile\fB\fR +.PP +A relatively failsafe call would be (if your postscript is smaller +than iso b0 [100cm x 141.4cm] and you have a fast computer with enough memory): +\fBps2eps -l -B -s b0 -c -n \fIfile\fB\fR +.PP +If output is not correct try: +\fBps2eps -l -B -s b0 -F \fIfile\fB\fR +.SH "AUTHOR" +.PP +\fBps2eps\fR was written by Roland Bless. +.SS "WHY?" +.PP +Other programs like \fBps2epsi\fR do not calculate the +bounding box always correctly (because the values are put on the +postscript stack which may get corrupted by bad postscript code) or +rounded it off so that clipping the EPS cut off some part of the +image. \fBps2eps\fR uses a double precision resolution +of 144 dpi and appropriate rounding to get a proper bounding +box. The internal bbox device of ghostscript generates different values +(sometimes even incorrect), so using the provided \fBbbox\fR +should be more robust. +However, because normal clipping has only a resolution of 1/72dpi +(postscript point), the clipping process may still erase parts of your +EPS image. In this case please use the \fB-l\fR option to add +an additional point of white space around the tight bounding box. +.SS "ACKNOWLEDGMENTS" +.PP +Some people contributed code or suggestions to improve \fBps2eps\fR\&. Here +are at least some names (sorry if I forgot your name): +Christophe Druet, Hans Ecke, Berend Hasselman, Erik Joergensen, Koji Nakamaru, Hans Fredrik Nordhaug +.PP +An earlier version of this manual page was originally written by +Rafael Laboissiere <rafael at debian.org> for +the Debian system. Thank you Rafael! +.PP +Permission is granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation +License, Version 1.1 or any later version published by the Free +Software Foundation; with no Invariant Sections, no Front-Cover +Texts and no Back-Cover Texts. +.SH "BUGS" +.PP +If you experience problems, please check carefully all hints in the section +TROUBLESHOOTING +first. Otherwise, check for an updated +version at <URL:http://www.tm.uka.de/~bless/ps2eps> +or send a gzipped file of +relevant postscript source code with your error description +and \fBps2eps\fR version number to <roland at bless.de> (please allow some time +to reply). +.SH "SEE ALSO" +.PP +bbox (1), gs (1), ps2epsi (1) diff --git a/Master/texmf/doc/man/man1/t1ascii.1 b/Master/texmf/doc/man/man1/t1ascii.1 index 0ae4d3eed57..7ce2da4ba2c 100644 --- a/Master/texmf/doc/man/man1/t1ascii.1 +++ b/Master/texmf/doc/man/man1/t1ascii.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -45,7 +45,7 @@ Conventions, and may cause problems with older software. .SH AUTHORS Lee Hetherington (ilh@lcs.mit.edu) .br -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) .PP Ported to Microsoft C/C++ Compiler and MS-DOS operating system by Kai-Uwe Herbing (herbing@netmbx.netmbx.de). diff --git a/Master/texmf/doc/man/man1/t1asm.1 b/Master/texmf/doc/man/man1/t1asm.1 index 59d4db5e790..77b6381cf2c 100644 --- a/Master/texmf/doc/man/man1/t1asm.1 +++ b/Master/texmf/doc/man/man1/t1asm.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -93,4 +93,4 @@ http://partners.adobe.com/asn/developer/PDFS/TN/5177.Type2.pdf .SH AUTHORS Lee Hetherington (ilh@lcs.mit.edu) .br -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) diff --git a/Master/texmf/doc/man/man1/t1binary.1 b/Master/texmf/doc/man/man1/t1binary.1 index fc41bcacc87..839638c8ede 100644 --- a/Master/texmf/doc/man/man1/t1binary.1 +++ b/Master/texmf/doc/man/man1/t1binary.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -36,7 +36,7 @@ The default length is as large as memory allows. .SH AUTHORS Lee Hetherington (ilh@lcs.mit.edu) .br -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) .PP Ported to Microsoft C/C++ Compiler and MS-DOS operating system by Kai-Uwe Herbing (herbing@netmbx.netmbx.de). diff --git a/Master/texmf/doc/man/man1/t1disasm.1 b/Master/texmf/doc/man/man1/t1disasm.1 index 381bfb1b607..17a82f27a43 100644 --- a/Master/texmf/doc/man/man1/t1disasm.1 +++ b/Master/texmf/doc/man/man1/t1disasm.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -93,4 +93,4 @@ http://partners.adobe.com/asn/developer/PDFS/TN/5177.Type2.pdf .SH AUTHORS Lee Hetherington (ilh@lcs.mit.edu) .br -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) diff --git a/Master/texmf/doc/man/man1/t1dotlessj.1 b/Master/texmf/doc/man/man1/t1dotlessj.1 index e06e3ed922d..254883bc8df 100644 --- a/Master/texmf/doc/man/man1/t1dotlessj.1 +++ b/Master/texmf/doc/man/man1/t1dotlessj.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/t1lint.1 b/Master/texmf/doc/man/man1/t1lint.1 index ffed5e8337b..e3821c24a12 100644 --- a/Master/texmf/doc/man/man1/t1lint.1 +++ b/Master/texmf/doc/man/man1/t1lint.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/t1mac.1 b/Master/texmf/doc/man/man1/t1mac.1 index 63a196da720..0c381c53fb5 100644 --- a/Master/texmf/doc/man/man1/t1mac.1 +++ b/Master/texmf/doc/man/man1/t1mac.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -59,4 +59,4 @@ resource fork. .M t1asm 1 , .M t1disasm 1 .SH AUTHORS -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) diff --git a/Master/texmf/doc/man/man1/t1reencode.1 b/Master/texmf/doc/man/man1/t1reencode.1 index 170eddcb06f..7914363f2d1 100644 --- a/Master/texmf/doc/man/man1/t1reencode.1 +++ b/Master/texmf/doc/man/man1/t1reencode.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/t1testpage.1 b/Master/texmf/doc/man/man1/t1testpage.1 index d3436e0fae9..eb0e1fb6e84 100644 --- a/Master/texmf/doc/man/man1/t1testpage.1 +++ b/Master/texmf/doc/man/man1/t1testpage.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/t1unmac.1 b/Master/texmf/doc/man/man1/t1unmac.1 index deb6f252136..033530d9767 100644 --- a/Master/texmf/doc/man/man1/t1unmac.1 +++ b/Master/texmf/doc/man/man1/t1unmac.1 @@ -1,4 +1,4 @@ -.ds V 1.32 +.ds V 1.34 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -55,6 +55,14 @@ PFA only: Set the maximum length of encrypted lines in the output to .I num. (These are the lines consisting wholly of hexadecimal digits.) The default is 64. +.SH EXAMPLES +.LP +On Mac OS X, you can use +.B t1unmac +to translate a font into PFA or PFB format as follows: +.nf +% \fBt1unmac\fR --raw FONTFILENAME/..namedfork/rsrc > OUTPUT +.fi .SH "SEE ALSO" .LP .M t1mac 1 , @@ -65,7 +73,7 @@ is 64. .SH AUTHORS Lee Hetherington (ilh@lcs.mit.edu) .br -Eddie Kohler (kohler@icir.org) +Eddie Kohler (ekohler@gmail.com) .PP Ported to Microsoft C/C++ Compiler and MS-DOS operating system by Kai-Uwe Herbing (herbing@netmbx.netmbx.de). diff --git a/Master/texmf/doc/man/man1/tangle.1 b/Master/texmf/doc/man/man1/tangle.1 index f6b352ee489..42b8f09943a 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.6" +.TH TANGLE 1 "20 October 2002" "Web2C 7.5.7" .\"===================================================================== .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 d9fe5885f8a..084f72026cc 100644 --- a/Master/texmf/doc/man/man1/tex.1 +++ b/Master/texmf/doc/man/man1/tex.1 @@ -1,4 +1,4 @@ -.TH TEX 1 "6 December 2006" "Web2C 7.5.6" +.TH TEX 1 "6 December 2006" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/texi2dvi.1 b/Master/texmf/doc/man/man1/texi2dvi.1 index 41fae2f7d5e..98a889f6c73 100644 --- a/Master/texmf/doc/man/man1/texi2dvi.1 +++ b/Master/texmf/doc/man/man1/texi2dvi.1 @@ -1,26 +1,33 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.33. -.TH TEXI2DVI "1" "February 2005" "texi2dvi 1.39" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH TEXI2DVI "1" "April 2008" "texi2dvi 1.122" "User Commands" .SH NAME -texi2dvi \- print Texinfo documents +texi2dvi \- convert Texinfo documents to DVI .SH SYNOPSIS .B texi2dvi [\fIOPTION\fR]... \fIFILE\fR... .SH DESCRIPTION -Run each Texinfo or LaTeX FILE through TeX in turn until all -cross-references are resolved, building all indices. The directory +Run each Texinfo or (La)TeX FILE through TeX in turn until all +cross\-references are resolved, building all indices. The directory containing each FILE is searched for included files. The suffix of FILE -is used to determine its language (LaTeX or Texinfo). +is used to determine its language ((La)TeX or Texinfo). To process +(e)plain TeX files, set the environment variable LATEX=tex. +.PP +In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, +the FILE may also be composed of the following simple TeX commands. +.TP +`\einput{FILE}' +the actual file to compile +.TP +`\enonstopmode' +same as \fB\-\-batch\fR .PP Makeinfo is used to perform Texinfo macro expansion before running TeX when needed. -.SS "Operation modes:" +.SS "General options:" .TP \fB\-b\fR, \fB\-\-batch\fR no interaction .TP -\fB\-c\fR, \fB\-\-clean\fR -remove all auxiliary files -.TP \fB\-D\fR, \fB\-\-debug\fR turn on shell debugging (set \fB\-x\fR) .TP @@ -29,7 +36,7 @@ display this help and exit successfully .TP \fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR leave output in OFILE (implies \fB\-\-clean\fR); -Only one input FILE may be specified in this case +only one input FILE may be specified in this case .TP \fB\-q\fR, \fB\-\-quiet\fR no output unless errors (implies \fB\-\-batch\fR) @@ -44,8 +51,11 @@ display version information and exit successfully report on what is done .SS "TeX tuning:" .TP --@ -use @input instead of \einput; for preloaded Texinfo +\-@ +use @input instead of \einput for preloaded Texinfo +.TP +\fB\-\-dvi\fR +output a DVI file [default] .TP \fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR force macro expansion using makeinfo @@ -56,31 +66,110 @@ search DIR for Texinfo files \fB\-l\fR, \fB\-\-language\fR=\fILANG\fR specify the LANG of FILE (LaTeX or Texinfo) .TP +\fB\-\-no\-line\-error\fR +do not pass \fB\-\-file\-line\-error\fR to TeX +.TP \fB\-p\fR, \fB\-\-pdf\fR use pdftex or pdflatex for processing .TP \fB\-r\fR, \fB\-\-recode\fR -call recode before TeX to translate input characters +call recode before TeX to translate input +.TP +\fB\-\-recode\-from\fR=\fIENC\fR +recode from ENC to the @documentencoding +.TP +\fB\-\-src\-specials\fR +pass \fB\-\-src\-specials\fR to TeX .TP \fB\-t\fR, \fB\-\-command\fR=\fICMD\fR insert CMD in copy of input file .TP or \fB\-\-texinfo\fR=\fICMD\fR multiple values accumulate +.TP +\fB\-\-translate\-file\fR=\fIFILE\fR +use given charset translation file for TeX +.SS "Build modes:" +.TP +\fB\-\-build\fR=\fIMODE\fR +specify the treatment of auxiliary files [local] +.TP +\fB\-\-tidy\fR +same as \fB\-\-build\fR=\fItidy\fR +.TP +\fB\-c\fR, \fB\-\-clean\fR +same as \fB\-\-build\fR=\fIclean\fR +.TP +\fB\-\-build\-dir\fR=\fIDIR\fR +specify where the tidy compilation is performed; +implies \fB\-\-tidy\fR; +defaults to TEXI2DVI_BUILD_DIRECTORY [.] +.TP +\fB\-\-mostly\-clean\fR +remove the auxiliary files and directories +but not the output +.PP +The MODE specifies where the TeX compilation takes place, and, as a +consequence, how auxiliary files are treated. The build mode +can also be set using the environment variable TEXI2DVI_BUILD_MODE. +.SS "Valid MODEs are:" +.TP +`local' +compile in the current directory, leaving all the auxiliary +files around. This is the traditional TeX use. +.TP +`tidy' +compile in a local *.t2d directory, where the auxiliary files +are left. Output files are copied back to the original file. +.TP +`clean' +same as `tidy', but remove the auxiliary directory afterwards. +Every compilation therefore requires the full cycle. +.SS "Using the `tidy' mode brings several advantages:" +.TP +\- +the current directory is not cluttered with plethora of temporary files. +.TP +\- +clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d +directories are stored there. +.TP +\- +clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d +or \fB\-\-build\-dir=\fR$HOME/.t2d. +.TP +\- +the output file is updated after every succesful TeX run, for +sake of concurrent visualization of the output. In a `local' build +the viewer stops during the whole TeX run. +.TP +\- +if the compilation fails, the previous state of the output file +is preserved. +.TP +\- +PDF and DVI compilation are kept in separate subdirectories +preventing any possibility of auxiliary file incompatibility. +.PP +On the other hand, because `tidy' compilation takes place in another +directory, occasionally TeX won't be able to find some files (e.g., when +using \egraphicspath): in that case use \fB\-I\fR to specify the additional +directories to consider. .PP The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used to run those commands, if they are set. Any CMD strings are added after @setfilename for Texinfo input, in the first line for LaTeX input. .SH "REPORTING BUGS" -Email bug reports to <bug-texinfo@gnu.org>, -general questions and discussion to <help-texinfo@gnu.org>. +Email bug reports to <bug\-texinfo@gnu.org>, +general questions and discussion to <help\-texinfo@gnu.org>. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2005 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B texi2dvi diff --git a/Master/texmf/doc/man/man1/texi2pdf.1 b/Master/texmf/doc/man/man1/texi2pdf.1 index e1cd00cddbc..76d34b6e3da 100644 --- a/Master/texmf/doc/man/man1/texi2pdf.1 +++ b/Master/texmf/doc/man/man1/texi2pdf.1 @@ -1 +1,184 @@ -.so man1/texi2dvi.1 +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH TEXI2DVI "1" "April 2008" "texi2dvi 1.122" "User Commands" +.SH NAME +texi2dvi \- convert Texinfo documents to PDF +.SH SYNOPSIS +.B texi2dvi +[\fIOPTION\fR]... \fIFILE\fR... +.SH DESCRIPTION +Run each Texinfo or (La)TeX FILE through TeX in turn until all +cross\-references are resolved, building all indices. The directory +containing each FILE is searched for included files. The suffix of FILE +is used to determine its language ((La)TeX or Texinfo). To process +(e)plain TeX files, set the environment variable LATEX=tex. +.PP +In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, +the FILE may also be composed of the following simple TeX commands. +.TP +`\einput{FILE}' +the actual file to compile +.TP +`\enonstopmode' +same as \fB\-\-batch\fR +.PP +Makeinfo is used to perform Texinfo macro expansion before running TeX +when needed. +.SS "General options:" +.TP +\fB\-b\fR, \fB\-\-batch\fR +no interaction +.TP +\fB\-D\fR, \fB\-\-debug\fR +turn on shell debugging (set \fB\-x\fR) +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit successfully +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR +leave output in OFILE (implies \fB\-\-clean\fR); +only one input FILE may be specified in this case +.TP +\fB\-q\fR, \fB\-\-quiet\fR +no output unless errors (implies \fB\-\-batch\fR) +.TP +\fB\-s\fR, \fB\-\-silent\fR +same as \fB\-\-quiet\fR +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit successfully +.TP +\fB\-V\fR, \fB\-\-verbose\fR +report on what is done +.SS "TeX tuning:" +.TP +\-@ +use @input instead of \einput for preloaded Texinfo +.TP +\fB\-\-dvi\fR +output a DVI file [default] +.TP +\fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR +force macro expansion using makeinfo +.TP +\fB\-I\fR DIR +search DIR for Texinfo files +.TP +\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR +specify the LANG of FILE (LaTeX or Texinfo) +.TP +\fB\-\-no\-line\-error\fR +do not pass \fB\-\-file\-line\-error\fR to TeX +.TP +\fB\-p\fR, \fB\-\-pdf\fR +use pdftex or pdflatex for processing +.TP +\fB\-r\fR, \fB\-\-recode\fR +call recode before TeX to translate input +.TP +\fB\-\-recode\-from\fR=\fIENC\fR +recode from ENC to the @documentencoding +.TP +\fB\-\-src\-specials\fR +pass \fB\-\-src\-specials\fR to TeX +.TP +\fB\-t\fR, \fB\-\-command\fR=\fICMD\fR +insert CMD in copy of input file +.TP +or \fB\-\-texinfo\fR=\fICMD\fR +multiple values accumulate +.TP +\fB\-\-translate\-file\fR=\fIFILE\fR +use given charset translation file for TeX +.SS "Build modes:" +.TP +\fB\-\-build\fR=\fIMODE\fR +specify the treatment of auxiliary files [local] +.TP +\fB\-\-tidy\fR +same as \fB\-\-build\fR=\fItidy\fR +.TP +\fB\-c\fR, \fB\-\-clean\fR +same as \fB\-\-build\fR=\fIclean\fR +.TP +\fB\-\-build\-dir\fR=\fIDIR\fR +specify where the tidy compilation is performed; +implies \fB\-\-tidy\fR; +defaults to TEXI2DVI_BUILD_DIRECTORY [.] +.TP +\fB\-\-mostly\-clean\fR +remove the auxiliary files and directories +but not the output +.PP +The MODE specifies where the TeX compilation takes place, and, as a +consequence, how auxiliary files are treated. The build mode +can also be set using the environment variable TEXI2DVI_BUILD_MODE. +.SS "Valid MODEs are:" +.TP +`local' +compile in the current directory, leaving all the auxiliary +files around. This is the traditional TeX use. +.TP +`tidy' +compile in a local *.t2d directory, where the auxiliary files +are left. Output files are copied back to the original file. +.TP +`clean' +same as `tidy', but remove the auxiliary directory afterwards. +Every compilation therefore requires the full cycle. +.SS "Using the `tidy' mode brings several advantages:" +.TP +\- +the current directory is not cluttered with plethora of temporary files. +.TP +\- +clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d +directories are stored there. +.TP +\- +clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d +or \fB\-\-build\-dir=\fR$HOME/.t2d. +.TP +\- +the output file is updated after every succesful TeX run, for +sake of concurrent visualization of the output. In a `local' build +the viewer stops during the whole TeX run. +.TP +\- +if the compilation fails, the previous state of the output file +is preserved. +.TP +\- +PDF and DVI compilation are kept in separate subdirectories +preventing any possibility of auxiliary file incompatibility. +.PP +On the other hand, because `tidy' compilation takes place in another +directory, occasionally TeX won't be able to find some files (e.g., when +using \egraphicspath): in that case use \fB\-I\fR to specify the additional +directories to consider. +.PP +The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, +TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used +to run those commands, if they are set. Any CMD strings are added +after @setfilename for Texinfo input, in the first line for LaTeX input. +.SH "REPORTING BUGS" +Email bug reports to <bug\-texinfo@gnu.org>, +general questions and discussion to <help\-texinfo@gnu.org>. +Texinfo home page: http://www.gnu.org/software/texinfo/ +.SH COPYRIGHT +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +The full documentation for +.B texi2dvi +is maintained as a Texinfo manual. If the +.B info +and +.B texi2dvi +programs are properly installed at your site, the command +.IP +.B info texi2dvi +.PP +should give you access to the complete manual. diff --git a/Master/texmf/doc/man/man1/texindex.1 b/Master/texmf/doc/man/man1/texindex.1 index 732e12b8874..12dfbe33dae 100644 --- a/Master/texmf/doc/man/man1/texindex.1 +++ b/Master/texmf/doc/man/man1/texindex.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.34. -.TH TEXINDEX "1" "December 2004" "texindex 4.8" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH TEXINDEX "1" "April 2008" "texindex 4.12" "User Commands" .SH NAME texindex \- sort Texinfo index files .SH SYNOPSIS @@ -13,12 +13,6 @@ Usually FILE... is specified as `foo.??' for a document `foo.texi'. \fB\-h\fR, \fB\-\-help\fR display this help and exit .TP -\fB\-k\fR, \fB\-\-keep\fR -keep temporary files around after processing -.TP -\fB\-\-no\-keep\fR -do not keep temporary files around after processing (default) -.TP \fB\-o\fR, \fB\-\-output\fR FILE send output to FILE .TP @@ -29,10 +23,11 @@ Email bug reports to bug\-texinfo@gnu.org, general questions and discussion to help\-texinfo@gnu.org. Texinfo home page: http://www.gnu.org/software/texinfo/ .SH COPYRIGHT -Copyright \(co 2004 Free Software Foundation, Inc. -There is NO warranty. You may redistribute this software -under the terms of the GNU General Public License. -For more information about these matters, see the files named COPYING. +Copyright \(co 2008 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B texindex @@ -44,4 +39,4 @@ programs are properly installed at your site, the command .IP .B info texindex .PP -should give you access to the complete manual. +will give you access to the complete manual. diff --git a/Master/texmf/doc/man/man1/texlinks.1 b/Master/texmf/doc/man/man1/texlinks.1 index d195b2c888e..75e7effcb15 100644 --- a/Master/texmf/doc/man/man1/texlinks.1 +++ b/Master/texmf/doc/man/man1/texlinks.1 @@ -1,4 +1,4 @@ -.TH "texlinks" "8" "September 2000" "teTeX" "teTeX" +.TH "texlinks" "8" "November 2007" "teTeX" "teTeX" .PP .SH "NAME" texlinks \- maintain symbolic links from format to engine @@ -19,14 +19,11 @@ depends on the \fB--multiplatform\fP option\&. .PP .SH "OPTIONS" .PP -.IP "\fB--help\fP or \fB-h\fP" -show some help text .IP "\fB--cnffile\fP \fIFILE\fP or \fB-f\fP \fIFILE\fP" -use -file as configuration file (default: +use file as configuration file (default: \fIfmtutil\&.cnf\fP) -.IP "\fB--verbose\fP or \fB-v\fP" -set verbose mode on (default: off) +.IP "\fB--help\fP or \fB-h\fP" +show some help text .IP "\fB--multiplatform\fP or \fB-m\fP" operate in all platform-specific directories (default: @@ -35,6 +32,10 @@ platform) .IP "\fB--silent\fP or \fB-s\fP" silently skip over existing scripts/binaries instead of printing a warning +.IP "\fB--unlink\fP or \fB-u\fP" +Unlink previously created symlinks +.IP "\fB--verbose\fP or \fB-v\fP" ++set verbose mode on (default: off) .PP .SH "FILES" .PP @@ -49,12 +50,12 @@ Web page: <http://tug\&.org/teTeX/> .PP .SH "BUGS" .PP -None known, but report any bugs found to <tetex@dbs\&.uni-hannover\&.de> (mailing list)\&. +None known, but report any bugs found to <tex-k@tug\&.org> (mailing list)\&. .PP .SH "AUTHOR" .PP \fBtexlinks\fP was written by Thomas Esser -<te@dbs\&.uni-hannover\&.de> and is Copyright © 1999\&. +<te@dbs\&.uni-hannover\&.de> in 1999\&. \fBtexlinks\fP has been released into the public domain\&. .PP This manual page was written by C\&.M\&. Connelly diff --git a/Master/texmf/doc/man/man1/tftopl.1 b/Master/texmf/doc/man/man1/tftopl.1 index b4188f09b39..b447dcff956 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.6" +.TH TFTOPL 1 "17 December 1994" "Web2C 7.5.7" .\"===================================================================== .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 index 02b7d428b1f..9beb45eb03b 100644 --- a/Master/texmf/doc/man/man1/ttftotype42.1 +++ b/Master/texmf/doc/man/man1/ttftotype42.1 @@ -1,4 +1,4 @@ -.ds V 2.48 +.ds V 2.69 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf/doc/man/man1/vftovp.1 b/Master/texmf/doc/man/man1/vftovp.1 index 6a323fc718f..ae970afa7f0 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.6" +.TH VFTOVP 1 "19 December 1994" "Web2C 7.5.7" .\"===================================================================== .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/vlna.1 b/Master/texmf/doc/man/man1/vlna.1 new file mode 100644 index 00000000000..c132823f40c --- /dev/null +++ b/Master/texmf/doc/man/man1/vlna.1 @@ -0,0 +1,121 @@ +.\" $Id$ +.TH VLNA 1 "4. unora 1998" +.nh +.SH NAZEV +vlna \- pridani vlnek za neslabicne predlozky v TeXu +.SH POUZITI +.B vlna +[\fIvolby\fP] +[\fIsoubory\fP] +.SH POPIS +Program +.B vlna +pridava vlnky (misto puvodnich mezer) za neslabicne predlozky +ve vstupnich souborech pro TeX, coz zabrani zlomu radku v nezadoucich mistech. +.PP +Veskere aktivity programu je mozne vypnout sekvenci \fB%~-\fP a zapnout +sekvenci \fB%~+\fP (mezi uvedenymi znaky muze byt libovolne mnozstvi mezer). +.PP +Pred predlozkou se muze nachazet libovolne mnozstvi oteviracich zavorek, +pred kterymi se musi nachazet mezera nebo zacatek radku. Pred +oteviraci svorkou muze byt take misto mezery TeXova +\(lq\\sekvence\(rq (od verze 1.2). +Napr. za \(lq([{(V\(rq na pocatku radku bude vlnka pridana. +Stejne tak se text \(lq\\uv{V lese}\(rq promeni na +\(lq\\uv{V~lese}\(rq. +.PP +Program kontroluje konzistenci matematickych prostredi (neni-li uveden +parametr \fB\-m\fP). +Vstup do \fIdisplay\fP rezimu (\fB$$\fP) uvnitr \fItext\fP rezimu (\fB$\fP) +(napr. \fB$\fP...\fB$$\fP...\fB$\fP) znamena varovani a prechod do +\fIdisplay\fP. +Podobne prazdny radek uvnitr \fItext\fP nebo \fIdisplay\fP rezimu znamena +vypis varovani a prechod do nematematickeho (standardniho) rezimu. +Uvnitr rezimu \fIdisplay\fP se ignoruji vyskyty samostatneho znaku \fB$\fP, +jelikoz byva vetsinou soucasti konstrukce \fB\\hbox\fP. +.PP +Program kontroluje konzistenci verbatim rezimu na konci souboru. +Nebyl-li ukoncen, vypise se varovani. +Kontrola se neprovadi, pokud je pouzita volba \fB\-n\fP nebo \fB\-w\fP. +.PP +Program nedoplnuje vlnky za samostatna pismena, ktera jako predlozky vypadaji, +ale nasleduji bezprostredne za sekvencemi \fB\\TeX\fP nebo \fB\\LaTeX\fP. +Napr. do textu \(lq\fBVlastnosti \\TeX u jsou\fP\(rq nebude zadna vlnka +doplnena. +.SH VOLBY +Volby jsou nepovinne a mohou byt uvedeny v libovolnem poradi, ale nemohou +byt spojovany. +.TP +.B \-f +Filtr. Jmena souboru jsou interpretovana takto: +.RS +.TP 4 +.B vlna \-f \fIsoubor1 soubor2\fP +Vstup je \fIsoubor1\fP, vystup \fIsoubor2\fP. +.TP 4 +.B vlna \-f \fIsoubor1\fP +Vstup je \fIsoubor1\fP, vystup \fIstdout\fP. +.TP 4 +.B vlna \-f +Vstup je \fIstdin\fP, vystup \fIstdout\fP. +.TP 4 +\fBvlna\fP \fIsoubor1\fP [\fIsoubor2\fP [\fIsoubor3\fP ...]] +Neni-li uveden parametr \fB\-f\fP, kazdy soubor je zpracovavan samostatne. +.RE +.TP +.B \-s +Tichy rezim. Program potlaci vypis uvodni zpravy, varovnych zprav a +statistik o zmenach v souborech +(bez uvedeni parametru jsou zpravy vypisovany na \fIstderr\fP). +V tichem rezimu se vypise jen chyba, ktera predcasne ukonci +cinnost programu. +.TP +.B \-r +Nevytvaret (mazat) zalohy. +Parametr \fB\-r\fP nema vliv, pokud je uveden spolu s \fB\-f\fP. +V opacnem pripade se ke kazdemu souboru vytvari zaloha s vlnkou na konci jmena +a parametr \fB\-r\fP zpusobi, ze na konci zpracovani jsou tyto zalohy mazany. +.TP +.B \-v \fIznaky\fP +Znaky povazovane za neslabicne predlozky, za ktere ma byt pridavana +vlnka. Implicitni hodnota je \fB\-v\ KkSsVvZzOoUuAI\fP. (Mezi +\fB\-v\fP a skupinou znaku musi byt mezera.) +.TP +.B \-m +Ignorovani prechodu do matematickych prostredi +(\fB$\fP...\fB$\fP a \fB$$\fP...\fB$$\fP). +Parametr \fB\-m\fP zpusobi vlnkovani i v matematickych prostredich, ktera +se implicitne vynechavaji. +.TP +.B \-n +Ignorovani verbatim rezimu (\fB\\verb\fP\fI<znak>\fP...\fI<znak>\fP, +\fB\\begtt\fP...\fB\\endtt\fP). +Parametr \fB\-n\fP zpusobi vlnkovani i ve verbatim rezimu, ktery se +implicitne vynechava. +.TP +.B \-l +LaTeX. Pro rozpoznani matematickeho rezimu jsou pridana prostredi +\fB\\begin{display}\fP...\fB\\end{display}\fP a +\fB\\begin{equation}\fP...\fB\\end{equation}\fP. +Pro rozpoznani verbatim rezimu je pridano LaTeXove prostredi +\fB\\begin{verbatim}\fP...\fB\\end{verbatim}\fP. +.TP +.B \-w +Web. Pro rozpoznani verbatim rezimu jsou pridany sekvence +\fB@<\fP, \fB@d\fP...\fB@*\fP, \fB@\fP\fImezera\fP nebo \fB@>|\fP. +Ve zdrojovem kodu se tedy nevlnkuje program, ale jen komentare. +.SH PRIKLADY +.TP +.B vlna \-m \-n \-s \-r \fIsoubor\fP +Volani priblizne odpovida volani puvodniho programu \fBvlna\fP. +(Navic se neprovadi vlnkovani za sekvencemi \fB\\TeX\fP a \fB\\LaTeX\fP.) +.TP +.B vlna *.tex +Vlnkovani vsech souboru s priponou \fBtex\fP. +(Pouze na UNIXu.) +.TP +.B vlna \-f soubor > /dev/null +Test konzistence matematickeho a verbatim rezimu bez provedeni zmen. +(Pouze na UNIXu.) +.SH AUTOR +Petr Olsak <olsak@math.feld.cvut.cz>. Manualovou stranku a Makefile vytvoril Rulolf Cejka diff --git a/Master/texmf/doc/man/man1/vptovf.1 b/Master/texmf/doc/man/man1/vptovf.1 index ac78f8393fa..c26d5978b6f 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.6" +.TH VPTOVF 1 "16 December 1994" "Web2C 7.5.7" .\"===================================================================== .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 3a958824d41..380508db2ec 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.6" +.TH WEAVE 1 "4 May 1993" "Web2C 7.5.7" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF M\s-2ETAFONT\s0 diff --git a/Master/texmf/doc/man/man1/xdvi.1 b/Master/texmf/doc/man/man1/xdvi.1 index 91b1bc6adbf..d4b4510aec9 100644 --- a/Master/texmf/doc/man/man1/xdvi.1 +++ b/Master/texmf/doc/man/man1/xdvi.1 @@ -52,7 +52,7 @@ .de SB \&\fB\s-1\&\\$1 \\$2\s0\fR .. -.TH XDVI 1 "2005/04/28" "Xdvik 22.84.10" +.TH XDVI 1 "" "Xdvik 22.84.14:" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME @@ -66,21 +66,19 @@ xdvi \- DVI Previewer for the X Window System [\fB\--help\fP] [\fB\-allowshell\fP] [\fB\-altfont\fP \fIfont\fP] -[\fB\-base\fP \fIbase URL\fP] -.\" [\fB\-bd\fP \fIcolor\fP] [\fB\-bg\fP \fIcolor\fP] [\fB\-browser\fP \fIWWWbrowser\fP] -[\fB\-bw\fP \fIwidth\fP] -[\fB\-bw\fP \fIwidth\fP] [\fB\-copy\fP] [\fB\-cr\fP \fIcolor\fP] [\fB\-debug\fP \fIbitmask\fP|\fIstring[,string ...]\fP] [\fB\-display\fP \fIhost:display\fP] [\fB\-dvipspath\fP \fIpath\fP] [\fB\-editor\fP \fIcommand\fP] +[\fB\-expert\fP] [\fB\-expertmode\fP \fIflag\fP] [\fB\-fg\fP \fIcolor\fP] [\fB\-findstring\fP \fIstring\fP] +[\fB\-text-encoding\fP \fIencoding\fP] [\fB\-font\fP \fIfont\fP] [\fB\-fullscreen \fP] [\fB\-gamma\fP \fIg\fP] @@ -90,18 +88,20 @@ xdvi \- DVI Previewer for the X Window System [\fB\-h\fP] [\fB\-help\fP] [\fB\-hl\fP \fIcolor\fP] -[\fB\-href\fP \fIanchor\fP] +[\fB\-anchorposition\fP \fIanchor\fP] [\fB\-hush\fP] [\fB\-hushchars\fP] [\fB\-hushchecksums\fP] -[\fB\-hushspecials\fP] +[\fB\-warnpecials\fP] [\fB\-hushstdout\fP] +[\fB\-hushbell\fP] [\fB\-icongeometry\fP \fIgeometry\fP] [\fB\-iconic\fP] [\fB\-install\fP] [\fB\-interpreter\fP \fIpath\fP] [\fB\-keep\fP] [\fB\-l\fP] +[\fB\-license\fP] [\fB\-linkcolor\fP \fIcolor\fP] [\fB\-linkstyle\fP \fI0|1|2|3\fP] [\fB\-margins\fP \fIdimen\fP] @@ -283,26 +283,10 @@ file cannot be found. This is useful, for example, with PostScript <tm> fonts. Determines the color of the background. Same as .BR -bg . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\" .TP -.\" .BI \-bd " color" -.\" .RB ( .borderColor ) -.\" Determines the color of the window border. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-bg " color" .RB ( .background ) Determines the color of the background. -.\" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\" .TP -.\" .BI \-bordercolor " color" -.\" Same as -.\" .BR -bd . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-borderwidth " width" -.RB ( .borderWidth ) -Specifies the width of the border of the window. Same as -.BR -bw . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-browser " browser" @@ -320,12 +304,7 @@ and .B WWWBROWSER (in that order) are used to determine the browser command. If these are not set either, the following default value is used: -.SB netscape -raise -remote "openURL(%s,new-window)":xterm -e lynx %s:xterm -e wget %s -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-bw " width" -.RB ( .borderWidth ) -Specifies the width of the border of the window. +\fBxdg-open %s:htmlview %s:firefox -remote -remote "openURL(%s,new-window)":mozilla -remote "openURL(%s,new-window)":netscape -raise -remote "openURL(%s,new-window)":xterm -e w3m %s:xterm -e lynx %s:xterm -e wget %s\fP .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-copy @@ -571,6 +550,14 @@ option is used. Determines the color of the text (foreground). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP +.BI \-text-encoding " encoding" +.RB ( .textEncoding ) +Use +.I encoding +as text encoding of the string in the "Find" window. Usually, +this shouldn't be needed since the encoding is determined from the locale settings. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP .B \-findstring\fP \fIstring\fP This option triggers a search for .I string @@ -694,7 +681,7 @@ and of the highlighting markers in forward search and string search. The default is the foreground color. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.BI \-href " anchor" +.BI \-anchorposition " anchor" Jump to .I anchor after opening the DVI file. This is only useful when invoking @@ -726,13 +713,13 @@ to suppress warnings about checksum mismatches between the file and the font file. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B \-hushspecials -.RB ( .hushSpecials ) +.B \-warnspecials +.RB ( .warnSpecials ) Causes .B xdvi -to suppress warnings about +to print warnings about .B \especial -strings that it cannot process. +strings that it cannot process to stderr. These warnings are suppressed by default. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hushstdout @@ -744,6 +731,11 @@ Note that errors or warnings will still be printed to even if this option is used. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP +.B \-hushbell +.RB ( .hushBell ) +Don't sound the X bell when an error occurs. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP .BI \-icongeometry " geometry" .RB ( .iconGeometry ) Specifies the initial position for the icon. @@ -801,14 +793,12 @@ Sets a flag to indicate that .B xdvi should not move to the home position when moving to a new page. See also the .RB ` k ' -keystroke. This flag is only honoured by the -.B up() -and -.B down() -actions, not by -.B up-or-previous() -and -.BR down-or-next() . +keystroke. This flag is honored by all page switching actions and by +.B up-or-previous() / +.BR down-or-next() , +although the latter only honor the horizontal postion, not the vertical one. +This allows for a "continuous" scrolling back an forth through a document with +a display window narrower than a page width. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-l @@ -816,6 +806,10 @@ and List the names of all fonts used. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP +.B \-license +Prints licensing information. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP .BI \-linkcolor .RB ( .linkColor ) Color used for unvisited hyperlinks (`Blue2' by default). Hyperlinks @@ -1542,7 +1536,7 @@ currently ignored. .BI \-useTeXpages Use logical \*(Te\& pages (the values of the .I \ecount0 -register) instead of physical pages for the pagelist tables and +register) instead of physical pages for the pagelist labels and when jumping to a page in a document with the `g' keystroke (or the .B goto-page() action). @@ -1594,7 +1588,10 @@ until the DVI file can be read entirely. .BI \-wheelunit " pixels" .RB ( .wheelUnit ) Sets the number of pixels that a motion of a wheel mouse will move the -image up or down. If set to zero, the wheel mouse functionality is disabled. +image up or down. (See the +.B wheel +action, below, for more information on this.) +If set to zero, the wheel mouse functionality is disabled. The default value is 80. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP @@ -1647,17 +1644,30 @@ The escape key discards the numerical prefix for all actions (useful when you mistyped a number). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP +.BR Return " key" +.RB [ forward-page() ] +Moves to the next page (or to the +.IR n th +next page if a number is given). Synonyms are +.RB ` n ', +.RB ` f ' +and Line Feed. +.TP +.BR Backspace " key" +.RB [ back-pagee() ] +Moves to the previous page (or back +.I n +pages). Synonyms are +.RB ` p ', +.RB ` b ' +and +.BR Ctrl-h . +.TP .BR Delete " key" .RB [ up-or-previous() ] -Moves down two-thirds of a window-full, or to the top of the previous page -if already at the bottom of the page. With a float argument, moves down the -corresponding fraction of a window-full. By default, the -.I Space -key is bound to the action -.B unpause-or-next() -which does a similar thing; see there. -.br -The `keep' flag is ignored by these actions. +Moves up two-thirds of a window-full, or to the top of the previous page +if already at the top of the page. With a float argument, moves up the +corresponding fraction of a window-full. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Space " key" @@ -1672,7 +1682,10 @@ display the next portion of the page until the next .I special-string or the end of the page is encountered. See the description of the .B \-pause -option for details. +option for details. The action +.RB [ down-or-next() ] +does a similar thing, but without pausing; it is not bound to a key +by default. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Ctrl-Home " (Xaw), " Ctrl-osfBeginLine " (Motif)" @@ -1838,9 +1851,10 @@ for more information on navigating the links. Moves to the previous page (or back .I n pages). Synonyms are -.RB ` p ' +.RB ` p ', +.B Ctrl-h and -.BR Ctrl-h . +.BR Backspace . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B C @@ -1861,6 +1875,15 @@ Moves the page so that the point currently beneath the mouse cursor is moved to the middle of the window, and warps the mouse cursor to the same place. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP +.B D +.RB [ toggle-grid-mode() ] +This key toggles the use of a grid on the displayed page. +If no number is given, the grid mode is switched on or off. +By prepending a number from 1 to 3, 3 different grid levels can be set. +The units of the grid are inches or centimeters, depending +on whether the paper format is letter (in) or a4 (cm). +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP .B d .RB [ down() ] Moves page down two thirds of a window-full. With a float argument to ``down'', @@ -2071,9 +2094,10 @@ the default behaviour. Moves to the previous page (or back .I n pages). Synonyms are -.RB ` b ' +.RB ` b ', +.B Ctrl-h and -.BR Ctrl-h . +.BR Backspace . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B q @@ -2271,13 +2295,44 @@ See also the option .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH MOUSE ACTIONS IN THE MAIN WINDOW -.TP -.B Mouse-1 -.RB [ do-href()magnifier(*1) ] +The mouse actions can be customized by setting the X resource +.BR mouseTranslations . +Since there are three different mouse modes (see the section +.B MODES +below), there is a special action +.B mouse-modes +which lists the actions for each of the three modes: +\fBmouse-modes("ACTIONS-FOR-MODE1", "ACTIONS-FOR-MODE2", "ACTIONS-FOR-MODE3")\fR. +If only one argument is specified, this action is used for all modes. +The default bindings are as follows: +.RS 5 +.nf +.ft 3 +.sp 1n +xdvi.mouseTranslations: \e +Shift<Btn1Down>:mouse-modes("drag(+)")\en\e +Shift<Btn2Down>:mouse-modes("drag(|)")\en\e +Shift<Btn3Down>:mouse-modes("drag(-)")\en\e +Ctrl<Btn1Down>:mouse-modes("source-special()")\en\e +<Btn1Down>: mouse-modes("do-href()magnifier(*2)", "text-selection()", "ruler()")\en\e +<Btn2Down>: mouse-modes("do-href-newwindow()magnifier(*2)", "text-selection()", "ruler()")\en\e +<Btn3Down>: mouse-modes("magnifier(*3)")\en\e +<Btn4Down>: mouse-modes("wheel(-0.2)")\en\e +<Btn5Down>: mouse-modes("wheel(0.2)")\en\e +.sp 1n +.ft +.fi +.RE +All of these actions are described in more detail below. +Note the use of quote symbols around the action strings, which are neccessary +to group them into one argument. +The buttons 4 and 5 refer to wheel movements (wheel up/down) on wheel mice. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Mouse-2 -.RB [ do-href-newwindow()magnifier(*2) ] +.B do-href() +.TP +.B do-href-newwindow() +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Usually, if a binding specifies more then one action, all actions are executed in a sequence. The hyperlink bindings .B do-href() @@ -2288,10 +2343,8 @@ are special in that they are used as an to other actions that might follow them .I if the mouse is currently located on a hyperlink. -In this case, none of the other actions will be executed. -Otherwise, -.I only -the other actions are executed. +In this case, none of the other actions will be executed; +otherwise, only the other actions are executed. .br The action .B do-href() @@ -2303,21 +2356,17 @@ In both cases, the location of the target is indicated by a small arrow drawn in the same color as a visited link in the left corner of the window. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Mouse-3 -.RB [ magnifier(*3) ] -The actions -.B magnifier(n) -will pop up a ``magnifying glass'' which shows the unshrunk +.B magnifier(n x m) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP +.B magnifier(*n) +This action will pop up a ``magnifying glass'' which shows the unshrunk image of the region around the mouse pointer. The magnifier disappears when the mouse button is released. Moving the mouse cursor while holding the button down will move the magnifier. .br -In \fB`Ruler Mode'\fR, the first button moves or sets a ruler cross instead; -see the section -.BR MODES , -below, for details. -.br Different mouse buttons produce different sized windows, as indicated by the the argument of the @@ -2332,48 +2381,65 @@ through .BR *5 , referring to the value specified by the corresponding .BI \-mgs n -option. Note that in order to assign magnifier actions to -the buttons 4 or 5, you need to use the resource -.B wheelTranslations -(more about this resource below), e.g.: -.sp -xdvi.wheelTranslations: <Btn4Down>: magnifier(*4)\en\e - <Btn5Down>: magnifier(*5)\en -.sp +option. +.\" Note that in order to assign magnifier actions to +.\" the buttons 4 or 5, you need to use the resource +.\" .B wheelTranslations +.\" (more about this resource below), e.g.: +.\" .sp +.\" xdvi.wheelTranslations: <Btn4Down>: magnifier(*4)\en\e +.\" <Btn5Down>: magnifier(*5)\en +.\" .sp .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Shift-Mouse-1 -.RB [ drag(+) ] +.B drag(+) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Shift-Mouse-2 -.RB [ drag(|) ] +.B drag(|) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Shift-Mouse-3 -.RB [ drag(-) ] -Drags the page with the mouse. Shift-Mouse 1 allows dragging in all directions, -Shift-Mouse 2 allows vertical dragging only, and Shift-Mouse 3 allows -horizontal dragging only. To access these actions via customization, use the -.B drag -action. This action should have one parameter, the character +.B drag(-) +Drags the page with the mouse. This action should have one parameter, the character .RB `` | '', .RB `` - '', or .RB `` + '', -indicating vertical dragging, horizontal dragging, or dragging in both +indicating vertical dragging only, horizontal dragging only, or dragging in all directions. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP -.B Ctrl-Mouse-1 -.RB [ source-special() ] -Holding down the -.I Ctrl -key and clicking mouse button 1 starts a ``reverse search'', +.B source-special() +This action starts a ``reverse search'', opening the editor at the location in the \*(Te\& file corresponding to the pointer location in the DVI file. See the section on SOURCE SPECIALS, below, for more information on this. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP +.B wheel() +This action can be used to scroll the image with a wheel mouse, where it +is usually bound to mouse button 4 (wheel up) or 5 (wheel down). +The action takes one parameter, giving the distance to scroll the +image. If the parameter contains a decimal point, the distance is +given in wheel units; otherwise, pixels. A negative value scrolls up, +a positive value scrolls down. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP +.B text-selection() +This action allows you to mark a rectangular region of text in the DVI file. +The text is put into the X selection buffer and can be pasted into other +applictions (e.g. text editors). This works similar to the Plain text option +in the +.B Save +dialog; see the discussion there for more information on encoding issues. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.TP +.B ruler() +This action creates a cross-shaped ruler. Moving the mouse and holding +the button down drags the ruler and lets you measure distances on the page. +See the section +.B Ruler Mode +for more information on this. +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH UNBOUND ACTIONS The following actions are not bound to a key by default, but are available @@ -2475,19 +2541,14 @@ keys should come first, for example: .ft 3 .sp 1n xdvi.mainTranslations: #override \e -Ctrl<Btn1Down>: magnifier(*3)\en\e -Shift<Btn1Down>: magnifier(*2)\en\e -<Btn1Down>: magnifier(*1)\en +Shift<Key>s: select-dvi-file()\en\e +Ctrl<Key>s: save()\en\e +<Key>s: find()\en .sp 1n .ft .fi .RE .PP -Note: The additional `Modes' for Mouse-1 (Ruler Mode, Text Mode - see -the section -.BR MODES ) -only work if Mouse-1 has the magnifier() action bound to it. -.PP Because .B xdvi needs to capture pointer motion events, and because the X Toolkit @@ -2512,123 +2573,6 @@ will cause the key to quit .BR xdvi . .PP -Support of wheel mice is controlled by the -.B wheelTranslations -resource. Generally the only action routine called by this resource should be -.BR wheel . -The default value is -``\fB<Btn4Down>:wheel(-1.)\en<Btn5Down>:wheel(1.)\fR''. -Because this resource is implemented differently from the others, it should -not begin with -.RB ``#override ''; -when specifying a value for this resource, all wheel actions should be -included. -.\" #ifxaw -.\" NOTE: following is different with Motif, and will change for Xaw too ... -.\" removed for the time being. -.\" -.\" .PP -.\" The menu entries and actions may also be customized, in a similar manner. -.\" In this case the resource -.\" .B menuTranslations -.\" should consist of a string describing the pulldown menu names, submenu entries -.\" and the associated actions. Currently, only one level of submenus is provided for. -.\" The description consists of lines (substrings separated by the newline character -.\" `\fB\\n\fP'), -.\" where each line describes one menu entry. Each line consists of a colon-separated -.\" list containing the following elements: -.\" .RS 2 -.\" .TP 2 -.\" - -.\" the name of the menu; -.\" .TP -.\" - -.\" the name of the submenu; -.\" .TP -.\" - -.\" an accelerator for the action (the accelerator is currently not displayed in the menu, but it might be in future versions); -.\" .TP -.\" - -.\" one of the actions mentioned in the sections on KEYSTROKES above. -.\" .RE -.\" .PP -.\" Instead of a submenu and an action, an entry may also contain the string -.\" .RB `` SEP '' ; -.\" in this case, a separator line is inserted after the preceding menu entry. -.\" .PP -.\" The default value of this resource is as follows: -.\" .RS 5 -.\" .nf -.\" .ft 3 -.\" .sp 1n -.\" xdvi.menuTranslations: \e -.\" File:Open ...:Ctrl-o:select-dvi-file()\en\e -.\" File:Find ...:Ctrl-f:find()\en\e -.\" File:Reload:R:reread-dvi-file()\en\e -.\" File:Print ...:Ctrl-p:print()\en\e -.\" File:Save as ...::save()\en\e -.\" File:Quit:q:quit()\en\e -.\" Navigate:First:1 g:goto-page(1)\en\e -.\" Navigate:Page-10:10 p:back-page(10)\en\e -.\" Navigate:Page-5:5 p:back-page(10)\en\e -.\" Navigate:Prev:p:back-page(1)\en\e -.\" Navigate:SEP:\en\e -.\" Navigate:Next:n:forward-page(1)\en\e -.\" Navigate:Page+5:5 n:forward-page(5)\en\e -.\" Navigate:Page+10:10 n:forward-page(10)\en\e -.\" Navigate:Last:g:goto-page()\en\e -.\" Navigate:SEP:\en\e -.\" Navigate:Back Hyperlink:B:htex-back()\en\e -.\" Mark:Mark all:-1 m:toggle-mark(-1)\en\e -.\" Mark:Unmark all:0 m:toggle-mark(0)\en\e -.\" Mark:SEP:\en\e -.\" Mark:Toggle odd:1 m:toggle-mark(1)\en\e -.\" Mark:Toggle even:2 m:toggle-mark(2)\en\e -.\" Mark:Toggle current:m:toggle-mark()\en\e -.\" Zoom:Zoom in:Ctrl-+:set-shrink-factor(+)\en\e -.\" Zoom:Zoom out:Ctrl--:set-shrink-factor(-)\en\e -.\" Zoom:SEP:\en\e -.\" Zoom:Fit in window:s:set-shrink-factor(a)\en\e -.\" Zoom:SEP:\en\e -.\" Zoom:$#:1 s:set-shrink-factor(1)\en\e -.\" Zoom:$#:2 s:set-shrink-factor(2)\en\e -.\" Zoom:$#:3 s:set-shrink-factor(3)\en\e -.\" Zoom:$#:4 s:set-shrink-factor(4)\en\e -.\" Zoom:$#:5 s:set-shrink-factor(5)\en\e -.\" Zoom:$#:6 s:set-shrink-factor(6)\en\e -.\" Zoom:$#:7 s:set-shrink-factor(7)\en\e -.\" Zoom:$#:8 s:set-shrink-factor(8)\en\e -.\" Zoom:$#:9 s:set-shrink-factor(9)\en\e -.\" Options:View PS:1 v:set-ps(1)\en\e -.\" Options:View PS + bbox:2 v:set-ps(2)\en\e -.\" Options:No PS, bbox only:0 v:set-ps(0)\en\e -.\" Options:SEP:\en\e -.\" Options:Keep position:k:set-keep-flag(toggle)\en\e -.\" Options:SEP:\en\e -.\" Options:Fonts darker:Alt-Ctrl-+:change-density(25)\en\e -.\" Options:Fonts lighter:Alt-Ctrl--:change-density(-25)\en\e -.\" Help:About ...::help(helpGeneral)\en\e -.\" Help:Page Motion ...::help(helpPagemotion)\en\e -.\" Help:Other Commands ...::help(helpOthercommands)\en\e -.\" Help:Mouse Buttons ...::help(helpMousebuttons)\en\e -.\" Help:HyperTeX commands ...::help(helpHypertex)\en\e -.\" Help:Source specials ...::help(helpSourcespecials)\en -.\" .sp 1n -.\" .ft -.\" .fi -.\" .RE -.\" .PP -.\" The label string may contain a colon if it is escaped by a backslash -.\" (`\fB\\\fP'). (Note: Since the internal handling of menus requires -.\" every menu label to be unique, xdvi's special strings for customizing -.\" shrink factors in the buttons -- -.\" .RB ` $# ', -.\" .RB ` $% ' -.\" and -.\" .RB ' $_ ' -.\" -- are not supported by xdvik). -.\" endif -.PP Some resources are provided to allow customization of the geometry of the Xaw command buttons. Again, they are not changeable via command-line options, other than via the @@ -2687,15 +2631,6 @@ Button 3 moves the image down or left by the same amount. The scrollbars can be removed via the .I -expertmode flag/keystroke (which see). -.PP -Wheel mice are supported: motion of the wheel on such a mouse moves the -image up or down by the number of pixels indicated by the -.B \-wheelunit -option. To access this option via customization, use the -.B wheel -action. This action takes one parameter, giving the distance to scroll -the image. If the parameter contains a decimal point, the distance is given -in wheel units; otherwise, pixels. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH MAGNIFIER @@ -3135,16 +3070,13 @@ to convert the DVI file to a Postscript file, then uses to convert the Postscript file to PDF). .TP - -Plain text in ISO-8859-1 or UTF-8 encoding (the latter will preserve more -of the special LaTeX characters e.g. from mathematical mode). +Plain text in ISO-8859-1 or UTF-8 encoding. The latter will preserve more +of the special LaTeX characters e.g. from mathematical mode. Note however +that e.g. only few of LaTeX's mathematical symbols can be rendered correctly +as text; so this funcionality works best for plain text documents. If a character cannot be displayed in the selected charset, it is replaced by `\e' followed by the hexadecimal character code. If a character is not recognized at all, it is replaced by `?'. -If you think that xdvi should recognize a character but doesn't, -please send a feature request to the address given in -.B AUTHORS -below. Likewise, if you observe spurious spaces or unwanted linebreaks in -the output, please report this as a bug. .RE .PP The programs for Postscript and PDF conversion can be customized via @@ -3159,8 +3091,7 @@ respectively; see the explanation of these options above for more details. The keystroke .B Ctrl-m [\fBswitch-mode()\fR] -switches between three different bindings for -.BR Mouse-1 , +switches between three different mouse bindings, which can also be activated via the .B Modes menu (in Motif, this is a submenu of the @@ -4038,7 +3969,7 @@ macros; this is not likely to change in the near future. This also means that e.g. colored tables (as created by the .I colortbl package) may render incorrectly: Text in colors different from the -default foreground color may not not be displayed. When the page is +default foreground color may not be displayed. When the page is redrawn (e.g. after using the magnifier), the background color of the cells may overdraw the text. .SH FILES diff --git a/Master/texmf/doc/man/man5/info.5 b/Master/texmf/doc/man/man5/info.5 index 08fd289908f..488d2a107ac 100644 --- a/Master/texmf/doc/man/man5/info.5 +++ b/Master/texmf/doc/man/man5/info.5 @@ -1,5 +1,5 @@ .\" info(5) -.\" $Id: info.5,v 1.2 2004/04/11 17:56:45 karl Exp $ +.\" $Id: info.5,v 1.3 2005/01/20 22:38:32 karl Exp $ .\" .\" Copyright (C) 1998 Free Software Foundation, Inc. .\" diff --git a/Master/texmf/doc/man/man5/texinfo.5 b/Master/texmf/doc/man/man5/texinfo.5 index 0ca35cac0d5..3bdb08afed7 100644 --- a/Master/texmf/doc/man/man5/texinfo.5 +++ b/Master/texmf/doc/man/man5/texinfo.5 @@ -1,5 +1,5 @@ .\" texinfo(5) -.\" $Id: texinfo.5,v 1.2 2004/04/11 17:56:45 karl Exp $ +.\" $Id: texinfo.5,v 1.3 2005/01/20 22:38:32 karl Exp $ .\" .\" Copyright (C) 1998, 1999, 2002 Free Software Foundation, Inc. .\" diff --git a/Master/tlpkg/bin/tl-update-images b/Master/tlpkg/bin/tl-update-images index ff340e6ed12..c5ccbc054e0 100755 --- a/Master/tlpkg/bin/tl-update-images +++ b/Master/tlpkg/bin/tl-update-images @@ -24,8 +24,8 @@ unset CDPATH # avoid output from cd umask 0 renice +19 -p $$ >/dev/null 2>&1 -HERE=`cd \`dirname $0\` && /bin/pwd` -cd $HERE || exit 1 # the Master/tlpkg/bin directory +mydir=`cd \`dirname $0\` && /bin/pwd` +cd $mydir || exit 1 # the Master/tlpkg/bin directory master=`cd ../.. && /bin/pwd` test -z "$master" && exit 1 diff --git a/Master/tlpkg/bin/tl-update-man b/Master/tlpkg/bin/tl-update-man new file mode 100755 index 00000000000..f298d6d346c --- /dev/null +++ b/Master/tlpkg/bin/tl-update-man @@ -0,0 +1,37 @@ +#!/bin/sh +# $Id$ +# This script is run by hand at the end of a release cycle to copy the +# man pages from the temporary install tree resulting from a normal +# build to the live Master hierarchy. + +mydir=`cd \`dirname $0\` && pwd` +Master=`cd $mydir/../.. && pwd` +Build=`cd $Master/../Build && pwd` +Build_inst=`cd $Build/source/inst && pwd` + +: ${TMPDIR=/tmp} + +for sect in 1 5; do + # existing: + rundir=$Master/texmf/doc/man/man$sect + (cd $rundir && ls) >$TMPDIR/now + + # from a current build: + cd $Build_inst/share/man/man$sect || exit 1 + ls >$TMPDIR/new + + # omit symlinks since they are now files using .so. (xxtodo should check) + find -type f | sort | xargs tar cf - | (cd $rundir && tar xf -) + + # add new: + comm -13 $TMPDIR/now $TMPDIR/new >$TMPDIR/needed.$sect + test -s $TMPDIR/needed && (cd $rundir && svn add `cat $TMPDIR/needed`) + + # do not delete, since some man pages aren't installed from the build, + # but just in case we want to look: + comm -23 $TMPDIR/now $TMPDIR/new | grep -v '\.pdf$' >>$TMPDIR/extraman.$sect + + # see what we've done: + (cd $rundir && svn status) +done + |