From 7df10419479604eddc4a871f949c1166a32934f5 Mon Sep 17 00:00:00 2001
From: Karl Berry A DVI-to-PNG translator
@@ -457,7 +456,7 @@ your system before, they may be automatically generated; this process
can take a few minutes, so progress reports appear by default. The next
time the same font is used, it will have been saved on disk, so
rendering will go much faster. (If dvipng tries to endlessly generate
-the same fonts over and over again, something is wrong. See Unable to
+the same fonts over and over again, something is wrong. See Unable to
generate fonts in Kpathsea.)
Many options are available (see the next section). For a brief summary @@ -756,7 +755,7 @@ no matter what the pages are actually numbered. searching and font generation). This needs to be augmented with the base device resolution, given with the ‘--bdpi’ option. See the file ftp://ftp.tug.org/tex/modes.mf for a list of resolutions and mode -names for most devices. See Unable to generate fonts in Kpathsea. +names for most devices. See Unable to generate fonts in Kpathsea.
For details on the TeX path-searching library, and mktexpk
-problems, see Common problems in Kpathsea.
+problems, see Common problems in Kpathsea.
-1
.
Some of these debugging options are actually provided by Kpathsea -(see Debugging in Kpathsea). +(see Debugging in Kpathsea).
The classes are:
This manual documents Dvips version 5.995 -(April 2015), a program to translate a DVI file into +
This manual documents Dvips version 5.996 +(April 2016), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file.
@@ -314,10 +313,10 @@ Next: Invoking Dvips, PreInstalling Dvips is mostly the same as installing any Kpathsea-using program. Therefore, for the basic steps involved, -see Installation in Kpathsea. +see Installation in Kpathsea.
For solutions to common installation problems and information on how to -report a bug, see the file kpathsea/BUGS (see Bugs in Kpathsea). For solutions to Dvips-specific problems, +report a bug, see the file kpathsea/BUGS (see Bugs in Kpathsea). For solutions to Dvips-specific problems, see Debug options. Also see the Dvips home page at http://www.radicaleye.com/dvips.
@@ -357,7 +356,7 @@ printer (output device). Since these are site-specific,make
install
does not create them; you must create them yourself.
(These Dvips configuration files are independent of the Kpathsea -configuration file texmf.cnf (see Config files in Kpathsea). +configuration file texmf.cnf (see Config files in Kpathsea).
@@ -511,7 +510,7 @@ work. The following sections provide some helpful hints if you find yourself in such a situation.For details on effective bug reporting, common installation problems,
-and mktexpk
problems, see Bugs in Kpathsea.
+and mktexpk
problems, see Bugs in Kpathsea.
A good first debugging operation is to set the environment variable
DVIPSDEBUG
, which will display any configuration and map files
@@ -555,7 +554,7 @@ To track all classes, you can use -1
.
You can also set the environment variable KPATHSEA_DEBUG
instead
of using ‘-d’. Some of these debugging options are actually
-provided by Kpathsea (see Debugging in Kpathsea).
+provided by Kpathsea (see Debugging in Kpathsea).
The classes are:
@@ -822,7 +821,7 @@ progress reports appear by default. The next time that document is printed, these fonts will have been saved in the proper directories, so printing will go much faster. (If Dvips tries to endlessly generate the same fonts over and over again, it hasn’t been installed properly. -See Unable to generate fonts in Kpathsea.) +See Unable to generate fonts in Kpathsea.)Many options are available (see the next section). For a brief summary of available options, just type @@ -1190,8 +1189,8 @@ no matter what the pages are actually numbered. generation. This overrides any value from configuration files. With the default paths, explicitly specifying the mode also makes the program assume the fonts are in a subdirectory named mode. -See TeX directory structure in Kpathsea. If Metafont does not understand the mode name, see -Unable to generate fonts in Kpathsea. +See TeX directory structure in Kpathsea. If Metafont does not understand the mode name, see +Unable to generate fonts in Kpathsea.
TEXCONFIG
, which defines where
the configuration files themselves are found.)
-See Path specifications in Kpathsea, for details of +
See Path specifications in Kpathsea, for details of
interpretation of path and other environment variables common to all
Kpathsea-using programs. Only the environment variables specific to
Dvips are mentioned here.
@@ -1576,7 +1575,7 @@ standard output, for debugging. This isn’t done by default because
these files are read even before the banner is printed. For
voluminous additional debugging, set the environment variable
KPATHSEA_DEBUG
to ‘-1’
-(see Debugging in Kpathsea). (If KPATHSEA_DEBUG
is
+(see Debugging in Kpathsea). (If KPATHSEA_DEBUG
is
set to any value, it automatically turns on DVIPSDEBUG
.)
DVIPSDEBUG
.)
Default path to search for all fonts. Overrides all the font path -config file options and other environment variables (see Supported +config file options and other environment variables (see Supported file formats in Kpathsea).
Overrides ‘mktexpk’ as the name of the program to invoke to
create missing PK fonts. You can change the arguments passed to the
mktexpk
program with the MAKETEXPK
environment
-variable; see MakeTeX script arguments in Kpathsea.
+variable; see MakeTeX script arguments in Kpathsea.
DVIPSRC
@@ -1644,7 +1643,7 @@ platforms.)
Path to search for included graphics files. Overrides the ‘S’
config file option (see Configuration file commands). If not set,
-TEXINPUTS
is looked for. See Supported file formats in Kpathsea.
+TEXINPUTS
is looked for. See Supported file formats in Kpathsea.
For information about installing these files, including a prototype file you can copy, see config.ps installation. @@ -1698,7 +1697,7 @@ or individually by each user.
Use path to search for bitmap PK font files is path. The
PKFONTS
, TEXPKS
, GLYPHFONTS
, and TEXFONTS
-environment variables override this. See Supported file formats in Kpathsea.
+environment variables override this. See Supported file formats in Kpathsea.
\input epsf- -
If you are using LaTeX 2.09, add the ‘epsf’ style option, as in: +
+If you are using LaTeX 2.09, add the ‘epsf’ style option, as in:
\documentstyle[12pt,epsf]{article} @@ -2956,8 +2955,8 @@ file to standard output. For example:\special{psfile="`gnuplot foo"}
to include the file foo. Of course, the command to be executed +
+to include the file foo. Of course, the command to be executed can be anything, including using a file conversion utility such as tek2ps or whatever is appropriate. This feature can be disabled with the ‘-R’ command-line option or ‘R’ configuration option. @@ -3023,7 +3022,7 @@ treated as a bitmap. For example, if your figure used the single letter
MetaPost’s output figures contain lines like this for bitmap fonts used -in a MetaPost label (see MetaPost in Web2c). +in a MetaPost label (see MetaPost in Web2c).
\special{ps: plotfile filename}- -
inserts the contents of filename verbatim into the output (except +
+inserts the contents of filename verbatim into the output (except for omitting lines that begin with %). An example of the proper use of literal specials can be found in the file rotate.tex, which makes it easy to typeset text turned in multiples of 90 degrees. @@ -3485,7 +3484,7 @@ are supported; Ghostscript includes limited distiller support
Macros you can use in your TeX document to insert the specials in the first place are available from CTAN:/support/hypertex. For -CTAN info, see unixtex.ftp in Kpathsea. +CTAN info, see unixtex.ftp in Kpathsea.
@@ -3570,7 +3569,7 @@ package (e.g.,tetex-extra
in Debian). Failing that,
commercial versions of the Computer Modern fonts are available from
Blue Sky; public domain versions - in particular, the lm fonts, and
the cm-super fonts, are available from CTAN sites (for CTAN info,
-see unixtex.ftp in Kpathsea).
+see unixtex.ftp in Kpathsea).
You can convert a PostScript file to PDF using distill
, which
comes with Adobe Acrobat, or ps2pdf
, which comes with
@@ -3837,7 +3836,7 @@ can get AFM files for Adobe’s fonts from
TeX uses TeX font metrics (‘.tfm’) files. When you say
‘\font = font’ in your TeX document, TeX reads a file
named ‘font.tfm’. (Well, except for the texfonts.map
-feature; see Fontmap in Kpathsea). TeX can then
+feature; see Fontmap in Kpathsea). TeX can then
calculate the space occupied by characters from the font when
typesetting. In addition, the DVI drivers you use to print or view the
DVI file produced by TeX may need to look at the TFM file.
@@ -3847,11 +3846,11 @@ DVI file produced by TeX may need to look at the TFM file.
TFM files are binary (and hence are typically much smaller than AFM
-files). You can use the tftopl
program (see tftopl
+files). You can use the tftopl
program (see tftopl
invocation in Web2c) that comes with TeX to transform a TFM
file into a human-readable “property list” (‘.pl’) file. You can
also edit a PL file and transform it back to a TeX-readable TFM with
-the companion program pltotf
(see pltotf invocation in Web2c). Editing metrics by hand is not something you’re likely to want
+the companion program pltotf
(see pltotf invocation in Web2c). Editing metrics by hand is not something you’re likely to want
to do often, but the capability is there.
vftovp
and
vptovf
programs convert a VF file to a human-readable VPL
-(virtual property list) format and back again. See vftovp
-invocation in Web2c, and vptovf invocation in Web2c.
+(virtual property list) format and back again. See vftovp
+invocation in Web2c, and vptovf invocation in Web2c.
In the case of a PostScript font f being used in a straightforward
@@ -3984,7 +3983,7 @@ created when you run vptovf
.
You can expand virtual fonts into their base fonts with DVIcopy -(see dvicopy invocation in Web2c). This is useful if you are +(see dvicopy invocation in Web2c). This is useful if you are using a DVI translator that doesn’t understand vf’s itself.
@@ -4303,10 +4302,11 @@ can also obtain special effects such as an oblique font. -An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey’s
-fontinst
program, available from
-CTAN:fonts/utilities/fontinst (for CTAN info,
-see unixtex.ftp in Kpathsea).
+
Alternatives to Afm2tfm for creating virtual fonts include
+fontinst
http://ctan.org/pkg/fontinst,
+lcdf-typetools
, particularly otftotfm
+(http://ctan.org/pkg/lcdf-typetools), and afm2p
+(http://tex.aanhet.net/afm2pl/), among others.
• Changing font encodings: | Reencoding with -t, -p, -T.
@@ -4687,8 +4687,8 @@ put the line
rptmro Times-Roman ".167 SlantFont"- - into psfonts.map. Then ‘rptmro’ (our name for the obliqued +
+into psfonts.map. Then ‘rptmro’ (our name for the obliqued
Times) will act as if it were a resident font, although it is actually
constructed from Times-Roman via the PostScript routine Afm2tfm reads afmfile and writes a corresponding (but raw) TFM
-file. If tfmfile is not supplied, the base name of the AFM file is
-extended with ‘.tfm’ to get the output filename.
+ Afm2tfm reads afmfile and writes a corresponding (but “raw”,
+see below) TFM file. If tfmfile is not supplied, the base name
+of the AFM file is extended with ‘.tfm’ to get the output
+filename.
The simplest example:
The TFM file thus created is raw because it omits ligature and -kern information, and does no character remapping; it simply contains -the character information in the AFM file in TFM form, which is the form +kern information, and does no character remapping; it contains only +the character information in the AFM file in TFM format, which is the form that TeX understands. The characters have the same code in the TFM file as in the AFM file. For text fonts, this means printable ASCII characters will work ok, but little else, because standard PostScript fonts have a different encoding scheme than the one that plain TeX -expects (see Encodings). Although both schemes agree for the +expects (see Encodings). Although the encodings agree for most printable ASCII characters, other characters such as ligatures and accents vary. Thus, in practice, it’s almost always desirable to create a virtual font as well with the ‘-v’ or ‘-V’ option. @@ -4796,6 +4798,19 @@ See Making a font available. The command line options to Afm2tfm:
| Option details | ||
-a : | Option details | |||
-A : | Option details | |||
-a : | Afm2tfm options | |||
-B : | Option details | |||
-b num : | Option details | |||
-c num : | Option details | Option details | ||
absolute page number, and ‘-l’: | Option details | |||
absolute page number, and ‘-p’: | Option details | |||
accent height adjustment, omitting: | Afm2tfm options | |||
accents, in wrong position: | Reencoding with Afm2tfm | |||
accents, wrong: | Afm2tfm options | |||
accuracy in positioning: | Option details | |||
r config command (page reversal) : | Configuration file commands | |||
R fallback resolution config command : | Configuration file commands | |||
raw tfm files: | Afm2tfm options | |||
reencode/*.enc : | Encodings | |||
reencoding: | Reencoding with Afm2tfm | |||
reencoding PostScript fonts: | psfonts.map |
• Introduction: | Overview and history. | |||
+ | ||||
---|---|---|---|---|
• unixtex.ftp: | Obtaining TeX software. | |||
• Security: | Who can write what files, etc. @@ -186,14 +186,17 @@ May 2015. | |||
• TeX directory structure: | Managing the horde of TeX input files. | |||
+ | ||||
• Path searching: | How filename lookups work. | |||
• TeX support: | Special support for TeX-related file lookups. | |||
+ | ||||
• Programming: | How to use Kpathsea features in your program. | |||
+ | ||||
• Reporting bugs: | Where and how to report bugs. | |||
• Index: | General index.
@@ -213,8 +216,8 @@ Next: unixtex.ftp, Previ
- This manual corresponds to version 6.2.1 of the Kpathsea -library, released in May 2015. + This manual corresponds to version 6.2.2 of the Kpathsea +library, released in Aprile 2016. The library’s fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -226,9 +229,9 @@ this library:
Kpathsea is now maintained as part of the TeX Live distribution (http://tug.org/texlive). For information on configuration, -building, installing, and more, see Building TeX +building, installing, and more, see Building TeX Live. @@ -453,12 +456,12 @@ illegitimate root access. ~/.rhosts, and thus an unwitting user who runs TeX on a random document is vulnerable to a trojan horse attack. This loophole is closed by default, but you can be permissive if you so desire in -texmf.cnf. See tex invocation in Web2c. MetaPost has +texmf.cnf. See tex invocation in Web2c. MetaPost has the same issue.Dvips, Xdvi, and TeX can also execute shell commands under some -circumstances. To disable this, see the ‘-R’ option in Option -details in Dvips, the xdvi man page, and tex +circumstances. To disable this, see the ‘-R’ option in Option +details in Dvips, the xdvi man page, and tex invocation in Web2c, respectively. @@ -757,7 +760,7 @@ override; for example,TEXINPUTS_latex overrides TEXINPUTSlatex’.
| --prefix --bindir … | ||
--bindir configure option : | --enable-multiplatform | |||
--build=host : | Cross configuring | |||
--disable-all-packages configure option : | Build one package | |||
--disable-all-packages : | Build one package | |||
--disable-all-pkgs : | --disable-all-pkgs | |||
--disable-bibtex8 : | Configure options for texk/bibtex-x | |||
--disable-bibtexu : | Configure options for texk/bibtex-x | Configure options for texk/web2c | ||
--enable-auto-core : | Configure options for texk/web2c | |||
--enable-compiler-warnings=level : | --enable-compiler-warnings= level | |||
--enable-cxx-runtime-hack configure option : | Macros for compilers | |||
--enable-cxx-runtime-hack : | Macros for compilers | |||
--enable-etex : | Configure options for texk/web2c | |||
--enable-libtool-hack : | Configure options for texk/web2c | |||
--enable-maintainer-mode : | --enable-maintainer-mode | |||
--enable-maintainer-mode configure option : | Build system tools | |||
--enable-maintainer-mode : | Build system tools | |||
--enable-maintainer-mode : | --enable-maintainer-mode | |||
--enable-missing to ignore dependencies : | Build one package | |||
--enable-mktextfm-default : | kpathsea library | |||
--enable-multiplatform : | --enable-multiplatform | |||
--enable-prog : | --enable-prog --disable-prog | Extending TeX Live | ||
am/ top-level directory: | Top-level directories | |||
ANSI C: | Declarations and definitions | |||
ApplicationServices Mac framework, required by xetex : | Prerequisites | |||
asymptote : | Linked scripts | |||
asymptote : | asymptote | |||
Autoconf: | Overview of build system | Build in parallel | ||
callexe.c : | Macros for Windows | |||
CC : | Variables for configure | |||
CC=c-compiler : | Build one package | |||
CC_BUILD : | Cross problems | |||
chktex : | Declarations and definitions | |||
clang compilers, preferred by ICU: | Build one package | |||
clisp : | Variables for configure | |||
CLISP : | Variables for configure | |||
CLISP: | Configure options for utils/xindy | |||
clisp , required by xindy : | Prerequisites | |||
Cocoa Mac framework, required by xetex : | Prerequisites | |||
coding conventions: | Coding conventions | |||
compilers, C and C++: | Prerequisites | |||
config.guess, config.sub : | Top-level directories | xdvik package |
||
ctangle : | Cross problems | |||
CXX : | Variables for configure | |||
CXX=c++-compiler : | Build one package | |||
| ||||
D | ||||
Debian installation of build prerequisites: | Prerequisites | |||
declarations and definitions, in source code: | Declarations and definitions | |||
dependencies, with several output files: | Build in parallel | |||
DESTDIR : | --prefix --bindir … | |||
ICU cross compiling: | Cross problems | |||
ICU libraries: | Variables for configure | |||
ICU, prefers clang compilers: | Build one package | |||
icu-config : | Variables for configure | |||
ICU_CONFIG : | Variables for configure | |||
infrastructure, tools needed for: | Build system tools | Cross compilation | ||
| ||||
O | ||||
OBJCXX=objc-compiler : | Build one package | |||
one package, building: | Build one package | |||
OpenGL, required for Asymptote: | asymptote | |||
operating system distribution, building for: | Distro builds | Build system tools | ||
top-level directories: | Top-level directories | |||
touching files to avoid rerunning: | Build system tools | |||
txt2zlib : | Cross problems | |||
type cast, avoiding: | Const | |||
| ||||
U |