From 7bb43a604ef27001d3b902daae035ad76c64a75c Mon Sep 17 00:00:00 2001 From: Peter Breitenlohner Date: Wed, 5 May 2010 09:39:01 +0000 Subject: dvips pTeX extensions: documentation git-svn-id: svn://tug.org/texlive/trunk@18108 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipsk/dvips.1 | 37 ++-- Build/source/texk/dvipsk/dvips.info | 336 +++++++++++++++++++----------------- Build/source/texk/dvipsk/dvips.texi | 33 ++-- 3 files changed, 221 insertions(+), 185 deletions(-) (limited to 'Build') diff --git a/Build/source/texk/dvipsk/dvips.1 b/Build/source/texk/dvipsk/dvips.1 index 3275decabf3..05e5bcb5d2b 100644 --- a/Build/source/texk/dvipsk/dvips.1 +++ b/Build/source/texk/dvipsk/dvips.1 @@ -1,11 +1,9 @@ -.TH DVIPS 1 "1 January 2010" +.TH DVIPS 1 "4 May 2010" .SH NAME dvips \- convert a TeX DVI file to PostScript .SH SYNOPSIS .B dvips -[ -.I options -] +.RI [ OPTIONS ] .IR file [\fB.dvi\fP] .SH DESCRIPTION THIS MAN PAGE IS OBSOLETE! @@ -245,18 +243,33 @@ that try to interpret PostScript comments in weird ways, or on some PostScript printers. Old versions of TranScript in particular cannot handle modern Encapsulated PostScript. .TP -.B -noomega -This will disable the use of Omega extensions when interpreting DVI files. -By default, the additional opcodes +.BR -noomega +This will disable the use of Omega and pTeX extensions when interpreting DVI +files. By default, the additional opcodes .I 129 and .I 134 are recognized by dvips as Omega extensions and interpreted as requests to -set 2-byte characters. The only drawback is that the virtual font array will -(at least temporarily) require 65536 positions instead of the default 256 -positions, i.e. the memory requirements of dvips will be slightly larger. If -you find this unacceptable or encounter another problem with the Omega -extensions, you can switch this extension off by using +set 2-byte characters. +.TP +.BR -noptex +This will disable the use of pTeX extensions when interpreting DVI files. +By default, the additional opcodes +.I 130 +and +.I 135 +are recognized by dvips as pTeX extensions and interpreted as requests to +set 3-byte characters, and +.I 255 +as request to change the typesetting direction. +.sp +The only drawback is that the virtual font array will (at least temporarily) +require 65536 or more positions instead of the default 256 positions, i.e., +the memory requirements of dvips will be somewhat larger. If you find this +unacceptable or encounter another problem with the Omega or pTeX extensions, +you can switch off the pTeX extension by using +.BR -noptex , +or both by using .B -noomega (but please do send a bug report if you find such problems - see the bug address in the diff --git a/Build/source/texk/dvipsk/dvips.info b/Build/source/texk/dvipsk/dvips.info index 680e1dad9a8..88961e3e83b 100644 --- a/Build/source/texk/dvipsk/dvips.info +++ b/Build/source/texk/dvipsk/dvips.info @@ -1,7 +1,7 @@ This is ../../../texk/dvipsk/dvips.info, produced by makeinfo version 4.13 from ../../../texk/dvipsk/dvips.texi. -This manual documents Dvips version 5.98 (December 2009), a program to +This manual documents Dvips version 5.98 (May 2010), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -18,7 +18,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 5.98 (December 2009), a program to +This manual documents Dvips version 5.98 (May 2010), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -581,7 +581,8 @@ Options: -m* Manual feed -M* Don't make fonts -mode s Metafont device name -n # Maximum number of pages -N* No structured comments --noomega Disable Omega extensions +-noomega Disable Omega and pTeX extensions +-noptex Disable pTeX extensions -o f Output file -O c Set/change paper offset -p # First page -P s Load config.$s -pp l Print only pages listed @@ -806,17 +807,26 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. movement, etc., in PostScript viewers such as Ghostview. `-noomega' - This will disable the use of Omega extensions when interpreting - DVI files. By default, the additional opcodes `129' and `134' are + This will disable the use of Omega and pTeX extensions when + interpreting DVI files. By default, the additional opcodes `129' + and `134' are recognized by Dvips as Omega extensions and + interpreted as requests to set 2-byte characters. + +`-noptex' + This will disable the use of pTeX extensions when interpreting DVI + files. By default, the additional opcodes `130' and `135' are recognized by Dvips as Omega extensions and interpreted as - requests to set 2-byte characters. The only drawback is that the - virtual font array will (at least temporarily) require 65536 - positions instead of the default 256 positions, i.e., the memory - requirements of Dvips will be slightly larger. If you find this - unacceptable or encounter another problem with the Omega - extensions, you can switch this extension off by using `-noomega' - (but please do send a bug report if you find such problems, *note - Bugs: (kpathsea)Bugs.). + requests to set 3-byte characters, and `255' as request to change + the typesetting direction. + + The only drawback is that the virtual font array will (at least + temporarily) require 65536 or more positions instead of the + default 256 positions, i.e., the memory requirements of Dvips will + be somewhat larger. If you find this unacceptable or encounter + another problem with the Omega or pTeX extensions, you can switch + off the pTeX extension by using `-noptex', or both by using + `-noomega' (but please do send a bug report if you find such + problems, *note Bugs: (kpathsea)Bugs.). `-o NAME' Send output to the file NAME. If `-o' is specified without NAME @@ -3768,7 +3778,7 @@ Index * Menu: * ! special (literal PS header): Literal headers. (line 6) -* ! starting output filename: Option details. (line 224) +* ! starting output filename: Option details. (line 233) * " special (literal PostScript): " special. (line 6) * %%BoundingBox: Bounding box. (line 17) * %%Page, and multi-page information: PostScript hooks. (line 37) @@ -3783,7 +3793,7 @@ Index * +PSMAPFILE: Configuration file commands. (line 105) * -: Option details. (line 11) -* - as output filename: Option details. (line 224) +* - as output filename: Option details. (line 233) * --help <1>: Option details. (line 15) * --help: Option summary. (line 7) * --version: Option details. (line 18) @@ -3815,46 +3825,47 @@ Index * -N: Option details. (line 198) * -n NUM: Option details. (line 195) * -noomega: Option details. (line 206) +* -noptex: Option details. (line 212) * -O: Afm2tfm options. (line 41) -* -o NAME: Option details. (line 219) -* -O X-OFFSET,Y-OFFSET: Option details. (line 236) -* -p [=]NUM: Option details. (line 254) -* -P PRINTER: Option details. (line 268) +* -o NAME: Option details. (line 228) +* -O X-OFFSET,Y-OFFSET: Option details. (line 245) +* -p [=]NUM: Option details. (line 263) +* -P PRINTER: Option details. (line 277) * -p PS-ENC <1>: Afm2tfm options. (line 46) * -p PS-ENC: Changing PostScript encodings. (line 6) -* -pp FIRST-LAST: Option details. (line 263) -* -pp RANGE: Option details. (line 263) +* -pp FIRST-LAST: Option details. (line 272) +* -pp RANGE: Option details. (line 272) * -PPRINTER, and config file searching: Configuration file searching. (line 27) -* -q: Option details. (line 287) -* -R: Option details. (line 294) -* -r: Option details. (line 291) -* -s: Option details. (line 302) -* -S NUM: Option details. (line 309) +* -q: Option details. (line 296) +* -R: Option details. (line 303) +* -r: Option details. (line 300) +* -s: Option details. (line 311) +* -S NUM: Option details. (line 318) * -s SLANT: Afm2tfm options. (line 51) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 338) -* -t PAPERTYPE: Option details. (line 314) +* -T HSIZE,VSIZE: Option details. (line 347) +* -t PAPERTYPE: Option details. (line 323) * -T PS-TEX-ENC: Afm2tfm options. (line 61) * -t TEX-ENC <1>: Afm2tfm options. (line 56) * -t TEX-ENC: Changing TeX encodings. (line 6) * -u: Afm2tfm options. (line 65) -* -U: Option details. (line 353) -* -u PSMAPFILE: Option details. (line 345) -* -V: Option details. (line 364) -* -v: Option details. (line 361) +* -U: Option details. (line 362) +* -u PSMAPFILE: Option details. (line 354) +* -V: Option details. (line 373) +* -v: Option details. (line 370) * -V VPL-FILE: Afm2tfm options. (line 74) * -v VPL-FILE: Afm2tfm options. (line 71) -* -X NUM: Option details. (line 381) -* -x NUM: Option details. (line 373) -* -Y NUM: Option details. (line 388) +* -X NUM: Option details. (line 390) +* -x NUM: Option details. (line 382) +* -Y NUM: Option details. (line 397) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 397) -* -z for recognizing hyperdvi: Option details. (line 391) -* ..-relative filenames: Option details. (line 294) +* -Z for compressing bitmap fonts: Option details. (line 406) +* -z for recognizing hyperdvi: Option details. (line 400) +* ..-relative filenames: Option details. (line 303) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3909,15 +3920,15 @@ Index (line 21) * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) -* a3 papertype: Option details. (line 314) +* a3 papertype: Option details. (line 323) * a4 paper size: Config file paper sizes. (line 84) -* a4 papertype: Option details. (line 314) +* a4 papertype: Option details. (line 323) * A4size paper size: Config file paper sizes. (line 92) -* absolute filenames, disabling: Option details. (line 294) +* absolute filenames, disabling: Option details. (line 303) * absolute page number, and -l: Option details. (line 163) -* absolute page number, and -p: Option details. (line 254) +* absolute page number, and -p: Option details. (line 263) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) * accents, wrong: Afm2tfm options. (line 17) @@ -3962,7 +3973,7 @@ Index * bop-hook <1>: PostScript hooks. (line 11) * bop-hook <2>: EPSF scaling. (line 75) * bop-hook: Paper trays. (line 6) -* bop-hook, and offset pages: Option details. (line 249) +* bop-hook, and offset pages: Option details. (line 258) * boundary character: Encoding file format. (line 41) * bounding box, comment for: Bounding box. (line 6) @@ -4010,13 +4021,13 @@ Index * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 397) +* compressing bitmap fonts: Option details. (line 406) * Computer Modern in PostScript: Hypertext caveats. (line 6) * Computer Modern, encoding of: Encodings. (line 15) * condensed fonts: Afm2tfm options. (line 37) * config.proto: config.ps installation. (line 15) -* config.ps: Option details. (line 268) +* config.ps: Option details. (line 277) * config.ps installation: config.ps installation. (line 6) * config.ps paper sizes: Config file paper sizes. @@ -4072,7 +4083,7 @@ Index (line 35) * dictionary, SDict: Literal headers. (line 6) * dictionary, userdict: Header files. (line 21) -* distillation, and -z: Option details. (line 391) +* distillation, and -z: Option details. (line 400) * distiller, for PDF files: Hypertext. (line 11) * dot accent: Reencoding with Afm2tfm. (line 32) @@ -4167,7 +4178,7 @@ Index * figures, natural size: EPSF macros. (line 38) * figures, scaling: EPSF scaling. (line 6) * filter, running as a: Option details. (line 98) -* first page printed: Option details. (line 254) +* first page printed: Option details. (line 263) * font concepts: Font concepts. (line 6) * font generation, avoiding: Option details. (line 184) * fontinst: Invoking afm2tfm. (line 13) @@ -4213,7 +4224,7 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 365) +* gsftopk: Option details. (line 374) * h header downloading config command: Configuration file commands. (line 48) * H header path config command: Configuration file commands. @@ -4241,12 +4252,12 @@ Index * hscale (psfile special option): psfile special. (line 30) * hsize (psfile special option): psfile special. (line 24) * html specials: Hypertext. (line 6) -* html specials, and -z: Option details. (line 391) +* html specials, and -z: Option details. (line 400) * http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21) * http://xxx.lanl.gov/hypertex: Hypertext. (line 21) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 391) +* hyperdvi extensions, enabling: Option details. (line 400) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext specials: Hypertext specials. (line 6) @@ -4285,18 +4296,18 @@ Index (line 18) * landscape orientation, defined: Paper size and landscape. (line 11) -* landscape papertype: Option details. (line 314) +* landscape papertype: Option details. (line 323) * landscape, as \special: papersize special. (line 16) * last page printed: Option details. (line 163) * last-resort font scaling, with DVIPSSIZES: Environment variables. (line 47) * last-resort scaling, with R: Configuration file commands. (line 127) -* ledger papertype: Option details. (line 314) -* legal papertype: Option details. (line 314) +* ledger papertype: Option details. (line 323) +* legal papertype: Option details. (line 323) * letter paper size: Config file paper sizes. (line 84) -* letter papertype: Option details. (line 314) +* letter papertype: Option details. (line 323) * letterhead tray: Paper trays. (line 10) * letterSize paper size: Config file paper sizes. (line 92) @@ -4314,7 +4325,7 @@ Index * lly (psfile special option): psfile special. (line 42) * long documents not printing: Long documents fail. (line 6) * low characters, shifting: Option details. (line 117) -* lpr spooler, MS-DOS emulation: Option details. (line 224) +* lpr spooler, MS-DOS emulation: Option details. (line 233) * Lucida, installing: PostScript font installation. (line 10) * m config command (available memory): Configuration file commands. @@ -4325,13 +4336,13 @@ Index * macros for epsf inclusion <1>: EPSF macros. (line 6) * macros for epsf inclusion: \includegraphics. (line 6) * magnification, DVI: EPSF scaling. (line 63) -* magnification, overriding DVI: Option details. (line 373) -* magnification, vertical: Option details. (line 384) +* magnification, overriding DVI: Option details. (line 382) +* magnification, vertical: Option details. (line 393) * mailcap and hypertext: Hypertext specials. (line 53) * manual feed: Option details. (line 172) * maxdrift: Option details. (line 71) * maximum pages printed: Option details. (line 195) -* media: Option details. (line 314) +* media: Option details. (line 323) * memory available: Configuration file commands. (line 67) * memory of printer exhausted: Printer errors. (line 14) @@ -4359,7 +4370,7 @@ Index (line 10) * Monotype fonts, installing: PostScript font installation. (line 19) -* mtpk: Option details. (line 365) +* mtpk: Option details. (line 374) * multiple master fonts: psfonts.map. (line 60) * multiple output files: Option details. (line 127) * multiple paper trays: Paper trays. (line 6) @@ -4381,7 +4392,7 @@ Index (line 6) * octal character codes: Afm2tfm options. (line 41) * odd pages only: Option details. (line 27) -* offset pages: Option details. (line 236) +* offset pages: Option details. (line 245) * Omega extensions: Option details. (line 206) * option, details of: Option details. (line 6) * options, debugging: Debug options. (line 6) @@ -4399,14 +4410,14 @@ Index * output files, multiple: Option details. (line 127) * output, inverted: Small or inverted. (line 6) * output, none: No output. (line 6) -* output, redirecting: Option details. (line 219) +* output, redirecting: Option details. (line 228) * output, too small: Small or inverted. (line 6) * p config command (font aliases): Configuration file commands. (line 105) * P config command (PK path): Configuration file commands. (line 114) -* page range: Option details. (line 263) -* page, first printed: Option details. (line 254) +* page range: Option details. (line 272) +* page, first printed: Option details. (line 263) * page, last printed: Option details. (line 163) * pages, maximum printed: Option details. (line 195) * PaintType: Special font effects. @@ -4419,15 +4430,15 @@ Index * paper size, general: Paper size and landscape. (line 6) * paper trays: Paper trays. (line 6) -* paper type: Option details. (line 314) +* paper type: Option details. (line 323) * papersize special: papersize special. (line 6) -* papersize special, and no -t: Option details. (line 314) +* papersize special, and no -t: Option details. (line 323) * partial font downloading: psfonts.map. (line 55) * PDF files, font quality: Hypertext caveats. (line 6) * PDF files, making <1>: Hypertext. (line 11) * PDF files, making: Ghostscript installation. (line 6) -* PDF files, option for: Option details. (line 391) +* PDF files, option for: Option details. (line 400) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4436,7 +4447,7 @@ Index * Phaser printer, used for color calibration: Color device configuration. (line 18) * physical page number, and -l: Option details. (line 163) -* physical page number, and -p: Option details. (line 254) +* physical page number, and -p: Option details. (line 263) * physical page number, and bop-hook: PostScript hooks. (line 26) * pipes, not readable: Option details. (line 98) * pk files: Glyph files. (line 35) @@ -4444,7 +4455,7 @@ Index (line 114) * plotfile, ps subspecial: ps special. (line 30) * pltotf: Metric files. (line 39) -* popen for output: Option details. (line 224) +* popen for output: Option details. (line 233) * portrait orientation, defined: Paper size and landscape. (line 11) * positioning accuracy: Option details. (line 71) @@ -4456,7 +4467,7 @@ Index (line 6) * PostScript font alias file <1>: Configuration file commands. (line 105) -* PostScript font alias file: Option details. (line 345) +* PostScript font alias file: Option details. (line 354) * PostScript fonts: PostScript fonts. (line 6) * PostScript fonts, installing: PostScript font installation. (line 6) @@ -4484,7 +4495,7 @@ Index * printer memory: Configuration file commands. (line 67) * printer memory exhausted: Printer errors. (line 14) -* printer offset: Option details. (line 236) +* printer offset: Option details. (line 245) * PRINTER, and config file searching: Configuration file searching. (line 36) * PRINTER, avoided with -f: Option details. (line 98) @@ -4502,12 +4513,13 @@ Index (line 24) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 55) -* pstopk: Option details. (line 365) +* pstopk: Option details. (line 374) +* pTeX extensions: Option details. (line 206) * Q config command (quiet): Configuration file commands. (line 121) * q config command (quiet): Configuration file commands. (line 121) -* quiet operation: Option details. (line 287) +* quiet operation: Option details. (line 296) * r config command (page reversal): Configuration file commands. (line 124) * R fallback resolution config command: Configuration file commands. @@ -4523,10 +4535,10 @@ Index * resident fonts, different in different printers <1>: Configuration file commands. (line 105) * resident fonts, different in different printers: Option details. - (line 345) -* resolution: Option details. (line 381) + (line 354) +* resolution: Option details. (line 390) * resolution, setting: Option details. (line 58) -* reverse pagination: Option details. (line 291) +* reverse pagination: Option details. (line 300) * rhi (psfile special option): psfile special. (line 46) * Rokicki, Tomas: Why Dvips. (line 68) * rotate.tex: ps special. (line 34) @@ -4538,7 +4550,7 @@ Index * save/restore, and inverted output: Small or inverted. (line 6) * save/restore, and literal PS: Literal examples. (line 27) * save/restore, and specials: ps special. (line 6) -* save/restore, generating global: Option details. (line 302) +* save/restore, generating global: Option details. (line 311) * scaleunit: psfile special. (line 67) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 33) @@ -4553,14 +4565,14 @@ Index * sections of output file, and memory: Headers and memory usage. (line 6) * sections output, in separate files: Option details. (line 127) -* security: Option details. (line 294) -* shell command execution, disabling: Option details. (line 294) +* security: Option details. (line 303) +* shell command execution, disabling: Option details. (line 303) * shell escape, in config file: Configuration file commands. (line 33) * Shinko CHC-S446i printer: No output. (line 14) * show PostScript operator: PostScript typesetting. (line 23) -* silent operation: Option details. (line 287) +* silent operation: Option details. (line 296) * simplex mode on duplex printers: Including headers from the command line. (line 13) * slanted fonts: Special font effects. @@ -4579,10 +4591,10 @@ Index * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) * spooler, lacking: Option details. (line 110) -* spooling to lpr on MS-DOS: Option details. (line 224) +* spooling to lpr on MS-DOS: Option details. (line 233) * standard I/O: Option details. (line 98) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 219) +* standard output, output to: Option details. (line 228) * standard PostScript, required by Ghostview: Ghostscript installation. (line 17) * start-hook: PostScript hooks. (line 11) @@ -4593,7 +4605,7 @@ Index (line 157) * Tektronix Phaser printer, used for color calibration: Color device configuration. (line 18) -* testpage.tex: Option details. (line 243) +* testpage.tex: Option details. (line 252) * TeX encoding, changing: Changing TeX encodings. (line 6) * TeX, including headers in: Including headers from TeX. @@ -4677,12 +4689,12 @@ Index (line 171) * warning messages, defining: Configuration file commands. (line 171) -* warnings, suppressing: Option details. (line 287) +* warnings, suppressing: Option details. (line 296) * whole font downloading: psfonts.map. (line 60) * wide fonts: psfonts.map. (line 19) * X config command (horizontal resolution): Configuration file commands. (line 178) -* Xerox 4045: Option details. (line 353) +* Xerox 4045: Option details. (line 362) * Y config command (vertical resolution): Configuration file commands. (line 181) * Y&Y fonts, installing: PostScript font installation. @@ -4691,87 +4703,87 @@ Index (line 184) * z config command (secure mode): Configuration file commands. (line 187) -* | starting output filename: Option details. (line 224) +* | starting output filename: Option details. (line 233)  Tag Table: -Node: Top563 -Node: Why Dvips1311 -Node: Installation4759 -Node: config.ps installation5780 -Node: PostScript font installation8317 -Node: Ghostscript installation11191 -Node: Diagnosing problems12288 -Node: Debug options13383 -Node: No output14409 -Node: Small or inverted15877 -Node: Printer errors16596 -Node: Long documents fail17928 -Node: Including graphics fails18269 -Node: Invoking Dvips19507 -Node: Basic usage20098 -Node: Command-line options21082 -Node: Option summary21531 -Node: Option details23693 -Node: Environment variables42697 -Node: Config files45656 -Node: Configuration file searching46339 -Node: Configuration file commands49639 -Node: Paper size and landscape56752 -Node: papersize special58350 -Node: Config file paper sizes59759 -Node: Paper trays63914 -Node: Interaction with PostScript65248 -Node: PostScript figures65901 -Node: Bounding box66627 -Node: \includegraphics69998 -Node: EPSF macros72289 -Node: EPSF scaling74259 -Node: EPSF clipping76829 -Node: psfile special77471 -Node: Dynamic creation of graphics79864 -Node: Fonts in figures81182 -Node: Header files82842 -Node: Including headers from TeX84048 -Node: Including headers from the command line86082 -Node: Headers and memory usage87182 -Node: Literal PS87892 -Node: " special88474 -Node: ps special89215 -Node: Literal headers90713 -Node: PostScript hooks91428 -Node: Literal examples93518 -Node: Hypertext94970 -Node: Hypertext caveats96528 -Node: Hypertext specials100925 -Node: PostScript fonts103559 -Node: Font concepts104675 -Node: Metric files105842 -Node: Glyph files108668 -Node: Virtual fonts111024 -Node: Encodings112914 -Node: PostScript typesetting115317 -Node: Making a font available118399 -Node: Invoking afm2tfm123429 -Node: Changing font encodings124399 -Node: Changing TeX encodings125189 -Node: Changing PostScript encodings126289 -Node: Changing both encodings127633 -Node: Reencoding with Afm2tfm128306 -Node: Encoding file format131410 -Node: Special font effects135613 -Node: Afm2tfm options137876 -Node: psfonts.map140861 -Node: Color145593 -Node: Color macro files146637 -Node: User-definable colors149835 -Node: Color subtleties151110 -Node: Ted Turner152761 -Node: Color device configuration153986 -Node: Color support details156428 -Node: Color specifications156806 -Node: Color specials158209 -Node: Index160338 +Node: Top558 +Node: Why Dvips1301 +Node: Installation4749 +Node: config.ps installation5770 +Node: PostScript font installation8307 +Node: Ghostscript installation11181 +Node: Diagnosing problems12278 +Node: Debug options13373 +Node: No output14399 +Node: Small or inverted15867 +Node: Printer errors16586 +Node: Long documents fail17918 +Node: Including graphics fails18259 +Node: Invoking Dvips19497 +Node: Basic usage20088 +Node: Command-line options21072 +Node: Option summary21521 +Node: Option details23726 +Node: Environment variables43112 +Node: Config files46071 +Node: Configuration file searching46754 +Node: Configuration file commands50054 +Node: Paper size and landscape57167 +Node: papersize special58765 +Node: Config file paper sizes60174 +Node: Paper trays64329 +Node: Interaction with PostScript65663 +Node: PostScript figures66316 +Node: Bounding box67042 +Node: \includegraphics70413 +Node: EPSF macros72704 +Node: EPSF scaling74674 +Node: EPSF clipping77244 +Node: psfile special77886 +Node: Dynamic creation of graphics80279 +Node: Fonts in figures81597 +Node: Header files83257 +Node: Including headers from TeX84463 +Node: Including headers from the command line86497 +Node: Headers and memory usage87597 +Node: Literal PS88307 +Node: " special88889 +Node: ps special89630 +Node: Literal headers91128 +Node: PostScript hooks91843 +Node: Literal examples93933 +Node: Hypertext95385 +Node: Hypertext caveats96943 +Node: Hypertext specials101340 +Node: PostScript fonts103974 +Node: Font concepts105090 +Node: Metric files106257 +Node: Glyph files109083 +Node: Virtual fonts111439 +Node: Encodings113329 +Node: PostScript typesetting115732 +Node: Making a font available118814 +Node: Invoking afm2tfm123844 +Node: Changing font encodings124814 +Node: Changing TeX encodings125604 +Node: Changing PostScript encodings126704 +Node: Changing both encodings128048 +Node: Reencoding with Afm2tfm128721 +Node: Encoding file format131825 +Node: Special font effects136028 +Node: Afm2tfm options138291 +Node: psfonts.map141276 +Node: Color146008 +Node: Color macro files147052 +Node: User-definable colors150250 +Node: Color subtleties151525 +Node: Ted Turner153176 +Node: Color device configuration154401 +Node: Color support details156843 +Node: Color specifications157221 +Node: Color specials158624 +Node: Index160753  End Tag Table diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi index 4c95f2166e8..bf151674e96 100644 --- a/Build/source/texk/dvipsk/dvips.texi +++ b/Build/source/texk/dvipsk/dvips.texi @@ -3,7 +3,7 @@ @settitle Dvips: A DVI-to-PostScript translator @set version 5.98 -@set month-year December 2009 +@set month-year May 2010 @copying This manual documents Dvips version @value{version} @@ -914,16 +914,27 @@ such as Ghostview. @item -noomega @opindex -noomega @cindex Omega extensions -This will disable the use of Omega extensions when interpreting DVI files. -By default, the additional opcodes @samp{129} and @samp{134} are recognized -by Dvips as Omega extensions and interpreted as requests to set 2-byte -characters. The only drawback is that the virtual font array will (at least -temporarily) require 65536 positions instead of the default 256 positions, -i.e., the memory requirements of Dvips will be slightly larger. If you find -this unacceptable or encounter another problem with the Omega extensions, -you can switch this extension off by using @samp{-noomega} (but please do -send a bug report if you find such problems, @pxref{Bugs,,, kpathsea, -Kpathsea}). +@cindex pTeX extensions +This will disable the use of Omega and pTeX extensions when interpreting DVI +files. By default, the additional opcodes @samp{129} and @samp{134} are +recognized by Dvips as Omega extensions and interpreted as requests to set +2-byte characters. + +@item -noptex +@opindex -noptex +@cindex pTeX extensions +This will disable the use of pTeX extensions when interpreting DVI files. +By default, the additional opcodes @samp{130} and @samp{135} are recognized +by Dvips as Omega extensions and interpreted as requests to set 3-byte +characters, and @samp{255} as request to change the typesetting direction. + +The only drawback is that the virtual font array will (at least temporarily) +require 65536 or more positions instead of the default 256 positions, i.e., +the memory requirements of Dvips will be somewhat larger. If you find this +unacceptable or encounter another problem with the Omega or pTeX extensions, +you can switch off the pTeX extension by using @samp{-noptex}, or both by +using @samp{-noomega} (but please do send a bug report if you find such +problems, @pxref{Bugs,,, kpathsea, Kpathsea}). @item -o @var{name} @opindex -o @var{name} -- cgit v1.2.3