texlive[66203] trunk: general doc update for engines/etc.
commits+karl at tug.org
commits+karl at tug.org
Sun Feb 26 22:56:37 CET 2023
Revision: 66203
http://tug.org/svn/texlive?view=revision&revision=66203
Author: karl
Date: 2023-02-26 22:56:36 +0100 (Sun, 26 Feb 2023)
Log Message:
-----------
general doc update for engines/etc.
Modified Paths:
--------------
trunk/Build/source/README.2building
trunk/Build/source/README.4layout
trunk/Build/source/doc/Makefile.am
trunk/Build/source/doc/Makefile.in
trunk/Build/source/doc/tlbuild-incl/install-tl.texi
trunk/Build/source/doc/tlbuild-incl/tlmgr.texi
trunk/Build/source/doc/tlbuild.info
trunk/Build/source/texk/README
trunk/Build/source/texk/dvisvgm/TLpatches/TL-Changes
trunk/Build/source/texk/texlive/tl_support/fmtutil.1
trunk/Build/source/texk/texlive/tl_support/updmap.1
trunk/Master/texmf-dist/doc/dvipdfmx/README
trunk/Master/texmf-dist/doc/dvipng/dvipng.html
trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
trunk/Master/texmf-dist/doc/dvips/NEWS
trunk/Master/texmf-dist/doc/dvips/README
trunk/Master/texmf-dist/doc/dvips/dvips.html
trunk/Master/texmf-dist/doc/dvips/dvips.pdf
trunk/Master/texmf-dist/doc/info/dvips.info
trunk/Master/texmf-dist/doc/info/kpathsea.info
trunk/Master/texmf-dist/doc/info/tlbuild.info
trunk/Master/texmf-dist/doc/info/web2c.info
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.pdf
trunk/Master/texmf-dist/doc/man/man5/synctex.5
trunk/Master/texmf-dist/doc/man/man5/synctex.man5.pdf
trunk/Master/texmf-dist/doc/pdftex/manual/ChangeLog
trunk/Master/texmf-dist/doc/pdftex/manual/Makefile
trunk/Master/texmf-dist/doc/pdftex/manual/pdftex-a.pdf
trunk/Master/texmf-dist/doc/pdftex/manual/pdftex-syntax.txt
trunk/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
trunk/Master/texmf-dist/doc/texlive/tlmgr.html
trunk/Master/texmf-dist/doc/web2c/web2c.html
trunk/Master/texmf-dist/doc/web2c/web2c.pdf
trunk/Master/texmf-dist/doc/xetex/base/NEWS
trunk/Master/texmf-dist/doc/xetex/base/README
trunk/Master/tlpkg/doc/releng.txt
Added Paths:
-----------
trunk/Master/texmf-dist/doc/aleph/base/ChangeLog
trunk/Master/texmf-dist/doc/etex/base/ChangeLog
trunk/Master/texmf-dist/doc/kpathsea/NEWS
trunk/Master/texmf-dist/doc/luatex/base/NEWS
trunk/Master/texmf-dist/doc/web2c/NEWS
trunk/Master/tlpkg/bin/tl-update-news
Modified: trunk/Build/source/README.2building
===================================================================
--- trunk/Build/source/README.2building 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/README.2building 2023-02-26 21:56:36 UTC (rev 66203)
@@ -101,7 +101,7 @@
cd texk/dvipdfm-x
make check
- # Run the new binary in the buil tree, finding support files
+ # Run the new binary in the build tree, finding support files
# in a separate tree for a TeX Live release YYYY
# (Bourne shell syntax):
TEXMFROOT=/usr/local/texlive/YYYY \
Modified: trunk/Build/source/README.4layout
===================================================================
--- trunk/Build/source/README.4layout 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/README.4layout 2023-02-26 21:56:36 UTC (rev 66203)
@@ -31,9 +31,9 @@
automake (GNU automake) 1.16.5
bison (GNU Bison) 3.8.2
flex 2.6.0
- ltmain.sh (GNU libtool) 2.4.6
+ ltmain.sh (GNU libtool) 2.4.7
m4 (GNU M4) 1.4.19
- makeinfo (GNU texinfo) 6.7
+ makeinfo (GNU texinfo) 7.0.2
These versions should be used to update the generated files (e.g.,
'configure' or 'Makefile.in') in all or parts of the TL tree after their
Modified: trunk/Build/source/doc/Makefile.am
===================================================================
--- trunk/Build/source/doc/Makefile.am 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/doc/Makefile.am 2023-02-26 21:56:36 UTC (rev 66203)
@@ -16,6 +16,7 @@
# no reasonable way to avoid it with the pod doc.
MAKEINFOFLAGS = --set INFO_SPECIAL_CHARS_WARNING=0
+MAKEINFOFLAGS += --disable-encoding
#
autogenerate the top-level README files.
readme-files: tlbuild.info
Modified: trunk/Build/source/doc/Makefile.in
===================================================================
--- trunk/Build/source/doc/Makefile.in 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/doc/Makefile.in 2023-02-26 21:56:36 UTC (rev 66203)
@@ -463,7 +463,7 @@
# no reasonable way to avoid it with the pod doc.
-MAKEINFOFLAGS = --set INFO_SPECIAL_CHARS_WARNING=0
+MAKEINFOFLAGS = --set INFO_SPECIAL_CHARS_WARNING=0 --disable-encoding
#
autogenerate texinfo from install-tl and tlmgr pod.
# none of this is intended to be executed except manually.
Modified: trunk/Build/source/doc/tlbuild-incl/install-tl.texi
===================================================================
--- trunk/Build/source/doc/tlbuild-incl/install-tl.texi 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/doc/tlbuild-incl/install-tl.texi 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,24 +1,13 @@
@node install-tl
@appendix install-tl
- at menu
-* install-tl NAME::
-* install-tl SYNOPSIS::
-* install-tl DESCRIPTION::
-* install-tl REFERENCES::
-* install-tl OPTIONS::
-* install-tl PROFILES::
-* install-tl ENVIRONMENT VARIABLES::
-* install-tl AUTHORS AND COPYRIGHT::
- at end menu
-
@node install-tl NAME
- at appendixsec NAME
+ at appendixsec install-tl NAME
install-tl - TeX Live cross-platform installer
@node install-tl SYNOPSIS
- at appendixsec SYNOPSIS
+ at appendixsec install-tl SYNOPSIS
install-tl [@emph{option}]...
@@ -25,7 +14,7 @@
install-tl-windows.bat [@emph{option}]...
@node install-tl DESCRIPTION
- at appendixsec DESCRIPTION
+ at appendixsec install-tl DESCRIPTION
This installer creates a runnable TeX Live installation from various
media, including over the network, from local hard disk, a DVD, etc. The
@@ -36,7 +25,9 @@
The basic idea of TeX Live installation is for you to choose one of the
top-level @emph{schemes}, each of which is defined as a different set of
@emph{collections} and @emph{packages}, where a collection is a set of packages,
-and a package is what contains actual files.
+and a package is what contains actual files. Each package is in exactly
+one collection, while schemes can contain any combination of packages
+and collections.
Within the installer, you can choose a scheme, and further customize the
set of collections to install, but not the set of the packages. To work
@@ -56,20 +47,67 @@
The most up-to-date version of this installer documentation is on the
Internet at @url{https://tug.org/texlive/doc/install-tl.html}.
+For step-by-step instructions, see
+ at url{https://tug.org/texlive/quickinstall.html}.
+
For the full documentation of TeX Live, see
@url{https://tug.org/texlive/doc}.
+ at node install-tl EXAMPLES
+ at appendixsec install-tl EXAMPLES
+
+With no options, @code{install-tl} drops you into an interactive menu where
+essentially all default settings can be changed. With options, you can
+initialize the settings in various ways, or perform the installation
+without interaction. Some examples:
+
+ at table @asis
+ at item @code{install-tl --paper=letter}
+ at anchor{install-tl @code{install-tl --paper=letter}}
+
+Initialize paper size setting. The only values allowed are @code{letter} and
+(the default) @code{a4}.
+
+ at item @code{install-tl --scheme} @emph{scheme}
+ at anchor{install-tl @code{install-tl --scheme} @emph{scheme}}
+
+Initialize the installation scheme; the default is @code{full}. For a list
+of schemes, see the interactive @code{S} menu.
+
+ at item @code{install-tl --no-interaction}
+ at anchor{install-tl @code{install-tl --no-interaction}}
+
+Perform the installation immediately after parsing options, without
+entering the interactive menu.
+
+ at item @code{install-tl --profile} @emph{texlive.profile}
+ at anchor{install-tl @code{install-tl --profile} @emph{texlive.profile}}
+
+Install, without interaction, according to the given TL profile file;
+see @ref{install-tl PROFILES,, PROFILES} below. To initialize from the profile and then enter the
+interactive menu, add @code{--init-from-profile}.
+
+ at end table
+
+Full documentation follows.
+
@node install-tl OPTIONS
- at appendixsec OPTIONS
+ at appendixsec install-tl OPTIONS
As usual, all options can be specified in any order, and with either a
leading @code{-} or @code{--}. An argument value can be separated from its
option by either a space or @code{=}.
+The options relating to customization of the installation can also be
+selected in the interactive installation menus (GUI or text).
+
@table @asis
@item @strong{-gui} [[=]@emph{module}]
@anchor{install-tl @strong{-gui} [[=]@emph{module}]}
+ at item @strong{-no-gui}
+ at anchor{install-tl @strong{-no-gui}}
+
If no @emph{module} is given, starts the Tcl/Tk (see below) GUI installer.
If @emph{module} is given loads the given installer module. Currently the
@@ -93,16 +131,11 @@
@end table
-The default GUI requires Tcl/Tk. This is standard on Macs (although it
-is considered deprecated since Catalina) and is often already installed
-on GNU/Linux, or can be easily installed through a distro package
-manager. For Windows, TeX Live provides a Tcl/Tk runtime.
+The default GUI requires Tcl/Tk. This was standard on Macs, but has been
+removed in the latest macOS releases. It's often already installed on
+GNU/Linux, or can be easily installed through a distro package manager.
+For Windows, TeX Live provides a Tcl/Tk runtime.
- at item @strong{-no-gui}
- at anchor{install-tl @strong{-no-gui}}
-
-Use the text mode installer (default except on Windows and Macs).
-
@item @strong{-lang} @emph{llcode}
@anchor{install-tl @strong{-lang} @emph{llcode}}
@@ -126,9 +159,9 @@
For installation, the default is to pick a mirror automatically, using
@url{https://mirror.ctan.org/systems/texlive/tlnet}; the chosen mirror is
-used for the entire download. You can use the special argument @code{ctan}
-as an abbreviation for this. (See @url{https://ctan.org} for more about CTAN
-and its mirrors.)
+then used for the entire download. You can use the special argument
+ at code{ctan} as an abbreviation for this. (See @url{https://ctan.org} for more
+about CTAN and its mirrors.)
After installation is complete, you can use that installation as the
repository for another installation. If you chose to install less than
@@ -156,15 +189,15 @@
@item @strong{-custom-bin} @emph{path}
@anchor{install-tl @strong{-custom-bin} @emph{path}}
-If you have built your own set of TeX Live binaries (perhaps because
-your platform was not supported by TeX Live out of the box), this option
-allows you to specify the @emph{path} to a directory where the binaries for
-the current system are present. The installation will continue as
-usual, but at the end all files from @emph{path} are copied over to
- at code{bin/custom/} under your installation directory and this @code{bin/custom/}
-directory is what will be added to the path for the post-install
-actions. To install multiple custom binary sets, manually rename
- at code{custom} before doing each.
+If you have built your own set of TeX Live binaries (e.g., because
+precompiled binaries were not provided by TL for your platform), this
+option allows you to specify the @emph{path} to a directory where the
+binaries for the current system are present. The installation will
+continue as usual, but at the end all files from @emph{path} are copied over
+to @code{bin/custom/} under your installation directory and this
+ at code{bin/custom/} directory is what will be added to the path for the
+post-install actions. To install multiple custom binary sets, manually
+rename @code{custom} before doing each.
For more information on custom binaries, see
@url{https://tug.org/texlive/custom-bin.html}. For general information on
@@ -173,9 +206,16 @@
@item @strong{-debug-fakenet}
@anchor{install-tl @strong{-debug-fakenet}}
-Pretend we're doing a network install, for the sole purpose of testing
-broken downloads via moving package files aside in a tlnet mirror.
+Pretend we're doing a network install. This is for the sole purpose of
+testing the code to handle broken downloads, via moving package files
+aside in a tlnet mirror hierarchy.
+ at item @strong{-debug-setup-vars}
+ at anchor{install-tl @strong{-debug-setup-vars}}
+
+Print final values of directory variables; for more debugging
+information on how they were set, also specify @code{-v}.
+
@item @strong{-debug-translation}
@anchor{install-tl @strong{-debug-translation}}
@@ -188,11 +228,12 @@
@anchor{install-tl @strong{-force-platform} @emph{platform}}
Instead of auto-detecting the current platform, use @emph{platform}.
-Binaries for this platform must be present and they must actually be
-runnable, or installation will fail. @code{-force-arch} is a synonym.
+Binaries for this platform must be present in @code{bin/}@emph{platform}@code{/} and
+they must be runnable, or installation will fail. @code{-force-arch} is a
+synonym.
- at item @strong{-help}, @strong{--help}, @strong{-?}
- at anchor{install-tl @strong{-help}@comma{} @strong{--help}@comma{} @strong{-?}}
+ at item @strong{-help}, @strong{@asis{}- at asis{}- at asis{}help}, @strong{-?}
+ at anchor{install-tl @strong{-help}@comma{} @strong{@asis{}- at asis{}- at asis{}help}@comma{} @strong{-?}}
Display this help and exit. (This help is also on the web at
@url{https://tug.org/texlive/doc/install-tl.html}). Sometimes the @code{perldoc}
@@ -234,8 +275,62 @@
@anchor{install-tl @strong{-no-cls}}
For the text mode installer only: do not clear the screen when entering
-a new menu (for debugging purposes).
+a new menu. For debugging.
+ at item @strong{-no-continue}
+ at anchor{install-tl @strong{-no-continue}}
+
+Quit early on installation failure of a non-core package.
+
+By default, a few core packages are installed first; then, a failed
+installation of any other (non-core) package is noted, but does not stop
+the installation. Any such failed packages are retried, once.
+
+If the retry also fails, by default the installer proceeds to completion
+anyway, with the idea that it was a transient network problem and
+reinstallation will succeed later. If this option is specified, and the
+retry fails, the installer aborts.
+
+ at item @strong{-no-doc-install}
+ at anchor{install-tl @strong{-no-doc-install}}
+
+ at item @strong{-no-src-install}
+ at anchor{install-tl @strong{-no-src-install}}
+
+Do not install the documentation resp. source package files, both for
+the immediate installation and for future updates. After installation,
+inclusion of the doc/src files can be re-enabled via @code{tlmgr}:
+
+ at verbatim
+ tlmgr option docfiles 1
+ tlmgr option srcfiles 1
+ at end verbatim
+
+If you later find that you want the doc/src files for a package that has
+been installed without them, you can get them like this (using the
+ at code{fontspec} package as the example):
+
+ at verbatim
+ tlmgr install --reinstall --with-doc --with-src fontspec
+ at end verbatim
+
+The source files mentioned here are those relating to TeX packages, such
+as @code{.dtx} files. The sources that are compiled to make the binaries are
+available separately: see @url{https://tug.org/texlive/svn/}.
+
+ at item @strong{-no-installation}
+ at anchor{install-tl @strong{-no-installation}}
+
+Do not perform any installation. This is for debugging the
+initialization and setup routines without touching the disk.
+
+ at item @strong{-no-interaction}
+ at anchor{install-tl @strong{-no-interaction}}
+
+Do not enter the interactive menu; immediately perform the installation
+after initialization and option parsing. Also omit the check for a
+previous installation and asking about importing previous settings.
+
@item @strong{-no-persistent-downloads}
@anchor{install-tl @strong{-no-persistent-downloads}}
@@ -243,7 +338,7 @@
@anchor{install-tl @strong{-persistent-downloads}}
For network installs, activating this option makes the installer try to
-set up a persistent connection using the @code{Net::LWP} Perl module. This
+set up a persistent connection using the @code{LWP} Perl module. This
opens only one connection between your computer and the server per
session and reuses it, instead of initiating a new download for each
package, which typically yields a significant speed-up.
@@ -266,11 +361,18 @@
For Windows only: configure for the current user, not for all users.
+ at item @strong{-paper} @code{a4}@strong{|}@code{letter}
+ at anchor{install-tl @strong{-paper} @code{a4}@strong{|}@code{letter}}
+
+Set the default paper size for all TeX Live programs, as specified.
+The default is @code{a4}. The paper size can be set after installation with
+the @code{tlmgr paper} command.
+
@item @strong{-portable}
@anchor{install-tl @strong{-portable}}
-Install for portable use, e.g., on a USB stick. Also selectable from
-within the perltk and text installers.
+Install for portable use, e.g., on a USB stick. See the
+ at code{instopt_portable} description below for details.
@item @strong{-print-platform}
@anchor{install-tl @strong{-print-platform}}
@@ -295,13 +397,76 @@
@anchor{install-tl @strong{-scheme} @emph{scheme}}
Schemes are the highest level of package grouping in TeX Live; the
-default is to use the @code{full} scheme, which includes everything. This
-option overrides that default. You can change the scheme again before
-the actual installation with the usual menu. The @emph{scheme} argument may
-optionally have a prefix @code{scheme-}. The list of supported scheme names
+default is to use the @code{full} scheme, which includes everything. This
+option overrides that default. The @emph{scheme} argument value may
+optionally have a prefix @code{scheme-}. The list of supported scheme names
depends on what your package repository provides; see the interactive
menu list.
+ at item @strong{-texdir} @emph{dir}
+ at anchor{install-tl @strong{-texdir} @emph{dir}}
+
+Specify the system installation directory; the default is
+ at code{/usr/local/texlive/YYYY} for release YYYY. Specifying this option also
+causes the @code{TEXMFLOCAL}, @code{TEXMFSYSCONFIG}, and @code{TEXMFSYSVAR}
+directories to be set as subdirectories of @emph{dir}, so they don't have to
+be set individually.
+
+There is a brief summary of these directories trees at @ref{install-tl DIRECTORY
+TREES,, DIRECTORY
+TREES} below; for details on the trees set up by default, and their
+intended usage, see the main TeX Live documentation at
+ at url{https://tug.org/texlive/doc}.
+
+ at item @strong{-texuserdir} @emph{dir}
+ at anchor{install-tl @strong{-texuserdir} @emph{dir}}
+
+Specify the user installation directory; the default is
+ at code{~/.texliveYYYY} (except on Macs, where there is no leading dot).
+Specifying this also causes the @code{TEXMFHOME}, @code{TEXMFCONFIG}, and
+ at code{TEXMFVAR} directories to be set as subdirectories of @emph{dir}.
+
+ at item @strong{-texmflocal} @emph{dir}
+ at anchor{install-tl @strong{-texmflocal} @emph{dir}}
+
+Specify the @code{TEXMFLOCAL} directory; the default is
+ at code{/usr/local/texlive/texmf-local}, that is, one level up from the main
+installation. This is so locally-installed packages can be easily used
+across releases, which is usually desirable. Specifying the @code{-texdir}
+option changes this, putting @code{TEXMFLOCAL} under the main tree. The
+ at code{-texmflocal} option can be used to specify an explicit directory.
+
+Anything installed here must follow the TeX directory structure (TDS),
+e.g., @code{TEXMFHOME/tex/latex/mypkg/mypkg.sty}. TDS reference:
+ at url{https://tug.org/tds}.
+
+ at item @strong{-texmfhome} @emph{dir}
+ at anchor{install-tl @strong{-texmfhome} @emph{dir}}
+
+Specify the @code{TEXMFHOME} directory; the default is @code{~/texmf}, except on
+Macs, where it is @code{~/Library/texmf}. Analogously to @code{TEXMFLOCAL}, the
+ at code{-texuserdir} option changes this default.
+
+Also as with @code{TEXMFLOCAL}, anything installed here must follow the TDS.
+
+ at item @strong{-texmfsysconfig} @emph{dir}
+ at anchor{install-tl @strong{-texmfsysconfig} @emph{dir}}
+
+ at item @strong{-texmfsysvar} @emph{dir}
+ at anchor{install-tl @strong{-texmfsysvar} @emph{dir}}
+
+Specify the @code{TEXMFSYSCONFIG} and @code{TEXMFSYSVAR} system directories.
+
+ at item @strong{-texmfconfig} @emph{dir}
+ at anchor{install-tl @strong{-texmfconfig} @emph{dir}}
+
+ at item @strong{-texmfvar} @emph{dir}
+ at anchor{install-tl @strong{-texmfvar} @emph{dir}}
+
+Specify the @code{TEXMFCONFIG} and @code{TEXMFVAR} user directories.
+The defaults are @code{~/.texliveYYYY/texmf-@{config,var@}}, except on Macs,
+where the leading dot is omitted (@code{~/texliveYYYY/...}).
+
@item @strong{-v}
@anchor{install-tl @strong{-v}}
@@ -308,8 +473,8 @@
Include verbose debugging messages; repeat for maximum debugging: @code{-v
-v}. (Further repeats are accepted but ignored.)
- at item @strong{-version}, @strong{--version}
- at anchor{install-tl @strong{-version}@comma{} @strong{--version}}
+ at item @strong{-version}, @strong{@asis{}- at asis{}- at asis{}version}
+ at anchor{install-tl @strong{-version}@comma{} @strong{@asis{}- at asis{}- at asis{}version}}
Output version information and exit. If @code{-v} is also given, the
versions of the TeX Live modules used are also reported.
@@ -319,17 +484,18 @@
@node install-tl PROFILES
@appendixsec PROFILES
-A @emph{profile} file contains all the values needed to perform an
-installation. After a normal installation has finished, a profile for
+A @emph{profile} file normally contains all the values needed to perform an
+installation. After a normal installation has finished, a profile for
that exact installation is written to the file @code{tlpkg/texlive.profile}.
In addition, from the text menu one can select @code{P} to save the current
-setup as a profile at any time.
+setup as a profile at any time. These are small text files; feel free to
+peruse and edit them according to your needs.
Such a profile file can be given as the argument to @code{-profile}, for
example to redo the exact same installation on a different system.
Alternatively, you can use a custom profile, most easily created by
-starting from a generated one and changing values, or an empty file,
-which will take all the defaults.
+starting from a generated one and changing values. An empty profile
+file will cause the installer to use the defaults.
As mentioned above, the installer only supports selection by scheme and
collections, not individual packages, so packages cannot be specified in
@@ -347,9 +513,9 @@
If the variable @code{selected_scheme} is defined and @emph{no} collection
variables at all are defined, then the collections required by the
specified scheme (which might change over time) are installed, without
-explicitly listing them. This eases maintenance of profile files. If
-any collections are specified in a profile, though, then all desired
-collections must be given explicitly.
+explicitly listing them. This eases maintenance of profile files. If any
+collections are specified in a profile, though, then the scheme is
+ignored and all desired collections must be given explicitly.
For example, a line
@@ -362,8 +528,8 @@
default options. The schemes are described in the @code{S} menu in the
text installer, or equivalent.
-Besides @code{selected_scheme}, here is the list of variable names supported
-in a profile:
+In addition to @code{selected_scheme}, here are the other variable names
+supported in a profile:
@strong{collection options} (prefix @code{collection-})
@@ -377,18 +543,18 @@
@strong{path options}
-It is best to define all of these, even though they may not be used in
-the installation, so as to avoid unintentionally getting a default value
-that could cause problems later.
+It is best to define all of these, even though they may not be used in a
+given installation, so as to avoid unintentionally getting a default
+value that could cause problems later.
@verbatim
TEXDIR
+ TEXMFLOCAL
+ TEXMFSYSCONFIG
+ TEXMFSYSVAR
TEXMFCONFIG
TEXMFVAR
TEXMFHOME
- TEXMFLOCAL
- TEXMFSYSCONFIG
- TEXMFSYSVAR
@end verbatim
@strong{installer options} (prefix @code{instopt_})
@@ -413,8 +579,15 @@
@item @code{instopt_portable} (default 0)
@anchor{install-tl @code{instopt_portable} (default 0)}
-Install for portable use, e.g., on a USB stick.
+Install for portable use, e.g., on a USB stick, without touching the
+host system. Specifically, this forces the user directories
+ at code{TEXMFHOME}, @code{TEXMFCONFIG}, @code{TEXMFVAR} to be identical to the system
+directories @code{TEXMFLOCAL}, @code{TEXMFSYSCONFIG}, @code{TEXMFSYSVAR},
+respectively (regardless of other options and environment variable.)
+In addition, on Windows, it disables the desktop integration, path
+adjustment, and file associations actions usually performed.
+
@item @code{instopt_write18_restricted} (default 1)
@anchor{install-tl @code{instopt_write18_restricted} (default 1)}
@@ -473,6 +646,11 @@
user installations.
@table @asis
+ at item @code{NOPERLDOC}
+ at anchor{install-tl @code{NOPERLDOC}}
+
+Don't try to run the @code{--help} message through @code{perldoc}.
+
@item @code{TEXLIVE_DOWNLOADER}
@anchor{install-tl @code{TEXLIVE_DOWNLOADER}}
@@ -498,6 +676,16 @@
Omit creating the ConTeXt cache. This is useful for redistributors.
+ at item @code{TEXLIVE_INSTALL_NO_DISKCHECK}
+ at anchor{install-tl @code{TEXLIVE_INSTALL_NO_DISKCHECK}}
+
+If set to 1, omit free disk space check. By default, if a
+POSIX-compliant @code{df} program (supporting @code{-Pk}) is available, the
+installer checks for available disk space in the selected installation
+location, and will abort installation if there is insufficient disk
+space, plus a margin of 100MB. An equivalent check is made on Windows
+(not involving @code{df}).
+
@item @code{TEXLIVE_INSTALL_NO_RESUME}
@anchor{install-tl @code{TEXLIVE_INSTALL_NO_RESUME}}
@@ -541,17 +729,73 @@
to @code{/usr/local/texlive}. All the defaults can be seen by running the
installer interactively and then typing @code{D} for the directory menu.
-To override the so-called @code{TEXDIR}, which defaults to the release
-directory within that prefix, e.g., @code{/usr/local/texlive/2020}, use a
-profile file (q.v.).
+The various command line options for specifying directories override
+these environment variables; since specifying both is usually
+accidental, a warning is given if the values are different.
- at item @code{NOPERLDOC}
- at anchor{install-tl @code{NOPERLDOC}}
+ at end table
-Don't try to run the @code{--help} message through @code{perldoc}.
+ at node install-tl DIRECTORY TREES
+ at appendixsec DIRECTORY TREES
- at end table
+There are a plethora of ways to specify the plethora of directory trees
+used by TeX Live. By far the simplest, and recommended, approach is not
+to change anything. The defaults suffice for the vast majority of
+installations.
+But, for the sake of explanation, here is a table of the trees and the
+command line options that change them. The first group of three are
+system directories, and the second group of three are user directories;
+the two groups are quite analogous.
+
+ at verbatim
+ +----------------+--------------------------------------+--------------+------------------+
+ | tree | default | group change | single change |
+ +----------------+--------------------------------------+--------------+------------------+
+ | TEXMFLOCAL | /usr/local/texlive/texmf-local | --texdir | --texmflocal |
+ | TEXMFSYSVAR | /usr/local/texlive/YYYY/texmf-var | --texdir | --texmfsysvar |
+ | TEXMFSYSCONFIG | /usr/local/texlive/YYYY/texmf-config | --texdir | --texmfsysconfig |
+ +----------------+--------------------------------------+--------------+------------------+
+ | TEXMFHOME | ~/texmf | --texuserdir | --texmfhome |
+ | TEXMFVAR | ~/.texliveYYYY/texmf-var | --texuserdir | --texmfvar |
+ | TEXMFCONFIG | ~/.texliveYYYY/texmf-config | --texuserdir | --texmfconfig |
+ +----------------+--------------------------------------+--------------+------------------+
+ at end verbatim
+
+In addition, as mentioned in the previous section, each tree has an
+environment variable @code{TEXLIVE_INSTALL_}@emph{tree} which overrides the
+default; command line and profile settings both override environment
+variable settings.
+
+The defaults vary slightly on Macs, as explained above in @ref{install-tl OPTIONS,, OPTIONS}.
+
+For the user trees, the default value uses @code{~}, and this is left as a
+literal @code{~} in @code{texmf.cnf}. That way, each user can have their own
+ at code{TEXMFHOME}, etc., as intended. On the other hand, for the system
+trees, if @code{~} is used during the installation, this is assumed to
+simply be a typing shorthand, and the expanded home directory is written
+in @code{texmf.cnf}, since it doesn't make sense to have user-specific
+system directories.
+
+For more on the directory trees and their intended usage, see the main
+TeX Live documentation at @url{https://tug.org/texlive/doc}.
+
+ at node install-tl BUGS
+ at appendixsec install-tl BUGS
+
+The @code{install-tl} script copies itself into the installed tree.
+Usually, it can be run from there, using the installed tree as the
+source for another installation. Occasionally, however, there may be
+incompatibilities in the code of the new @code{install-tl} and the
+infrastructure, resulting in (probably) inscrutable Perl errors. The
+way forward is to run @code{install-tl} out of the installer package
+(@code{install-tl-unx.tar.gz} or @code{install-tl.zip}) instead of the
+installation. Feel free to also report the issue; usually the code
+can be easily synced up again.
+
+By the way, do not try to use @code{install-tl} to adjust options or
+installed packages in an existing installed tree. Use @code{tlmgr} instead.
+
@node install-tl AUTHORS AND COPYRIGHT
@appendixsec AUTHORS AND COPYRIGHT
@@ -559,5 +803,5 @@
distribution (@url{https://tug.org/texlive}) and both are licensed under the
GNU General Public License Version 2 or later.
-$Id: install-tl 62146 2022-02-22 22:48:10Z karl $
+$Id: install-tl 66112 2023-02-23 23:28:27Z karl $
Modified: trunk/Build/source/doc/tlbuild-incl/tlmgr.texi
===================================================================
--- trunk/Build/source/doc/tlbuild-incl/tlmgr.texi 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/doc/tlbuild-incl/tlmgr.texi 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,35 +1,18 @@
@node tlmgr
@appendix tlmgr
- at menu
-* tlmgr NAME::
-* tlmgr SYNOPSIS::
-* tlmgr DESCRIPTION::
-* tlmgr EXAMPLES::
-* tlmgr OPTIONS::
-* tlmgr ACTIONS::
-* tlmgr CONFIGURATION FILE FOR TLMGR::
-* tlmgr CRYPTOGRAPHIC VERIFICATION::
-* tlmgr USER MODE::
-* tlmgr MULTIPLE REPOSITORIES::
-* tlmgr GUI FOR TLMGR::
-* tlmgr MACHINE-READABLE OUTPUT::
-* tlmgr ENVIRONMENT VARIABLES::
-* tlmgr AUTHORS AND COPYRIGHT::
- at end menu
-
@node tlmgr NAME
- at appendixsec NAME
+ at appendixsec tlmgr NAME
tlmgr - the native TeX Live Manager
@node tlmgr SYNOPSIS
- at appendixsec SYNOPSIS
+ at appendixsec tlmgr SYNOPSIS
tlmgr [@emph{option}...] @emph{action} [@emph{option}...] [@emph{operand}...]
@node tlmgr DESCRIPTION
- at appendixsec DESCRIPTION
+ at appendixsec tlmgr DESCRIPTION
@strong{tlmgr} manages an existing TeX Live installation, both packages and
configuration options. For information on initially downloading and
@@ -51,7 +34,7 @@
available.
@node tlmgr EXAMPLES
- at appendixsec EXAMPLES
+ at appendixsec tlmgr EXAMPLES
After successfully installing TeX Live, here are a few common operations
with @code{tlmgr}:
@@ -61,7 +44,7 @@
@anchor{tlmgr @code{tlmgr option repository ctan}}
@item @code{tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet}
- at anchor{tlmgr @code{tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet}}
+ at anchor{tlmgr @code{tlmgr option repository https at asis{:}//mirror.ctan.org/systems/texlive/tlnet}}
Tell @code{tlmgr} to use a nearby CTAN mirror for future updates; useful if
you installed TeX Live from the DVD image and want to have continuing
@@ -97,7 +80,7 @@
following voluminous information.
@node tlmgr OPTIONS
- at appendixsec OPTIONS
+ at appendixsec tlmgr OPTIONS
The following options to @code{tlmgr} are global options, not specific to
any action. All options, whether global or action-specific, can be
@@ -107,8 +90,8 @@
between an option name and its value.
@table @asis
- at item @strong{--repository} @emph{url|path}
- at anchor{tlmgr @strong{--repository} @emph{url|path}}
+ at item @strong{@asis{}- at asis{}- at asis{}repository} @emph{url|path}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}repository} @emph{url|path}}
Specify the package repository from which packages should be installed
or updated, either a local directory or network location, as below. This
@@ -147,7 +130,7 @@
@anchor{tlmgr @code{/some/local/dir}}
@item @code{file:/some/local/dir}
- at anchor{tlmgr @code{file:/some/local/dir}}
+ at anchor{tlmgr @code{file at asis{:}/some/local/dir}}
Equivalent ways of specifying a local directory.
@@ -155,7 +138,7 @@
@anchor{tlmgr @code{ctan}}
@item @code{https://mirror.ctan.org/systems/texlive/tlnet}
- at anchor{tlmgr @code{https://mirror.ctan.org/systems/texlive/tlnet}}
+ at anchor{tlmgr @code{https at asis{:}//mirror.ctan.org/systems/texlive/tlnet}}
Pick a CTAN mirror automatically, trying for one that is both nearby and
up-to-date. The chosen mirror is used for the entire download. The bare
@@ -163,7 +146,7 @@
more about CTAN and its mirrors.)
@item @code{http://server/path/to/tlnet}
- at anchor{tlmgr @code{http://server/path/to/tlnet}}
+ at anchor{tlmgr @code{http at asis{:}//server/path/to/tlnet}}
Standard HTTP. If the (default) LWP method is used, persistent
connections are supported. TL can also use @code{curl} or @code{wget} to do the
@@ -172,7 +155,7 @@
(@url{https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES}).
@item @code{https://server/path/to/tlnet}
- at anchor{tlmgr @code{https://server/path/to/tlnet}}
+ at anchor{tlmgr @code{https at asis{:}//server/path/to/tlnet}}
Again, if the (default) LWP method is used, this supports persistent
connections. Unfortunately, some versions of @code{wget} and @code{curl} do not
@@ -182,19 +165,19 @@
http or ftp.
@item @code{ftp://server/path/to/tlnet}
- at anchor{tlmgr @code{ftp://server/path/to/tlnet}}
+ at anchor{tlmgr @code{ftp at asis{:}//server/path/to/tlnet}}
If the (default) LWP method is used, persistent connections are
supported.
@item @code{user@@machine:/path/to/tlnet}
- at anchor{tlmgr @code{user@@machine:/path/to/tlnet}}
+ at anchor{tlmgr @code{user@@machine at asis{:}/path/to/tlnet}}
@item @code{scp://user@@machine/path/to/tlnet}
- at anchor{tlmgr @code{scp://user@@machine/path/to/tlnet}}
+ at anchor{tlmgr @code{scp at asis{:}//user@@machine/path/to/tlnet}}
@item @code{ssh://user@@machine/path/to/tlnet}
- at anchor{tlmgr @code{ssh://user@@machine/path/to/tlnet}}
+ at anchor{tlmgr @code{ssh at asis{:}//user@@machine/path/to/tlnet}}
These forms are equivalent; they all use @code{scp} to transfer files. Using
@code{ssh-agent} is recommended. (Info:
@@ -206,8 +189,8 @@
If the repository is on the network, trailing @code{/} characters and/or
trailing @code{/tlpkg} and/or @code{/archive} components are ignored.
- at item @strong{--gui} [@emph{action}]
- at anchor{tlmgr @strong{--gui} [@emph{action}]}
+ at item @strong{@asis{}- at asis{}- at asis{}gui} [@emph{action}]
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}gui} [@emph{action}]}
Two notable GUI front-ends for @code{tlmgr}, @code{tlshell} and @code{tlcockpit},
are started up as separate programs; see their own documentation.
@@ -228,8 +211,8 @@
TeX Live's Perl distribution for Windows. You may find @code{tlshell} or
@code{tlcockpit} easier to work with.
- at item @strong{--gui-lang} @emph{llcode}
- at anchor{tlmgr @strong{--gui-lang} @emph{llcode}}
+ at item @strong{@asis{}- at asis{}- at asis{}gui-lang} @emph{llcode}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}gui-lang} @emph{llcode}}
By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via @code{LC_MESSAGES}). If that fails
@@ -244,8 +227,8 @@
tlshell shares its message catalog with tlmgr.
- at item @strong{--command-logfile} @emph{file}
- at anchor{tlmgr @strong{--command-logfile} @emph{file}}
+ at item @strong{@asis{}- at asis{}- at asis{}command-logfile} @emph{file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}command-logfile} @emph{file}}
@code{tlmgr} logs the output of all programs invoked (mktexlr, mtxrun, fmtutil,
updmap) to a separate log file, by default
@@ -252,29 +235,29 @@
@code{TEXMFSYSVAR/web2c/tlmgr-commands.log}. This option allows you to specify a
different file for the log.
- at item @strong{--debug-translation}
- at anchor{tlmgr @strong{--debug-translation}}
+ at item @strong{@asis{}- at asis{}- at asis{}debug-translation}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}debug-translation}}
In GUI mode, this switch tells @code{tlmgr} to report any untranslated (or
missing) messages to standard error. This can help translators to see
what remains to be done.
- at item @strong{--machine-readable}
- at anchor{tlmgr @strong{--machine-readable}}
+ at item @strong{@asis{}- at asis{}- at asis{}machine-readable}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}machine-readable}}
Instead of the normal output intended for human consumption, write (to
standard output) a fixed format more suitable for machine parsing. See
the @ref{tlmgr MACHINE-READABLE OUTPUT,, MACHINE-READABLE OUTPUT} section below.
- at item @strong{--no-execute-actions}
- at anchor{tlmgr @strong{--no-execute-actions}}
+ at item @strong{@asis{}- at asis{}- at asis{}no-execute-actions}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-execute-actions}}
Suppress the execution of the execute actions as defined in the tlpsrc
files. Documented only for completeness, as this is only useful in
debugging.
- at item @strong{--package-logfile} @emph{file}
- at anchor{tlmgr @strong{--package-logfile} @emph{file}}
+ at item @strong{@asis{}- at asis{}- at asis{}package-logfile} @emph{file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}package-logfile} @emph{file}}
@code{tlmgr} logs all package actions (install, remove, update, failed
updates, failed restores) to a separate log file, by default
@@ -281,17 +264,17 @@
@code{TEXMFSYSVAR/web2c/tlmgr.log}. This option allows you to specify a
different file for the log.
- at item @strong{--pause}
- at anchor{tlmgr @strong{--pause}}
+ at item @strong{@asis{}- at asis{}- at asis{}pause}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}pause}}
This option makes @code{tlmgr} wait for user input before exiting. Useful on
Windows to avoid disappearing command windows.
- at item @strong{--persistent-downloads}
- at anchor{tlmgr @strong{--persistent-downloads}}
+ at item @strong{@asis{}- at asis{}- at asis{}persistent-downloads}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}persistent-downloads}}
- at item @strong{--no-persistent-downloads}
- at anchor{tlmgr @strong{--no-persistent-downloads}}
+ at item @strong{@asis{}- at asis{}- at asis{}no-persistent-downloads}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-persistent-downloads}}
For network-based installations, this option (on by default) makes
@code{tlmgr} try to set up a persistent connection (using the @code{LWP} Perl
@@ -302,25 +285,25 @@
If this is not possible, @code{tlmgr} will fall back to using @code{wget}. To
disable these persistent connections, use @code{--no-persistent-downloads}.
- at item @strong{--pin-file}
- at anchor{tlmgr @strong{--pin-file}}
+ at item @strong{@asis{}- at asis{}- at asis{}pin-file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}pin-file}}
Change the pinning file location from @code{TEXMFLOCAL/tlpkg/pinning.txt}
(see @ref{tlmgr Pinning,, Pinning} below). Documented only for completeness, as this is
only useful in debugging.
- at item @strong{--usermode}
- at anchor{tlmgr @strong{--usermode}}
+ at item @strong{@asis{}- at asis{}- at asis{}usermode}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}usermode}}
Activates user mode for this run of @code{tlmgr}; see @ref{tlmgr USER MODE,, USER MODE} below.
- at item @strong{--usertree} @emph{dir}
- at anchor{tlmgr @strong{--usertree} @emph{dir}}
+ at item @strong{@asis{}- at asis{}- at asis{}usertree} @emph{dir}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}usertree} @emph{dir}}
Uses @emph{dir} for the tree in user mode; see @ref{tlmgr USER MODE,, USER MODE} below.
- at item @strong{--verify-repo=[none|main|all]}
- at anchor{tlmgr @strong{--verify-repo=[none|main|all]}}
+ at item @strong{@asis{}- at asis{}- at asis{}verify-repo=[none|main|all]}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}verify-repo=[none|main|all]}}
Defines the level of verification done: If @code{none} is specified, no
verification whatsoever is done. If @code{main} is given and a working GnuPG
@@ -343,39 +326,6 @@
@node tlmgr ACTIONS
@appendixsec ACTIONS
- at menu
-* tlmgr help::
-* tlmgr version::
-* tlmgr backup::
-* tlmgr candidates @emph{pkg}::
-* tlmgr check [@emph{option}...] [depends|executes|files|runfiles|texmfdbs|all]::
-* tlmgr conf::
-* tlmgr dump-tlpdb [@emph{option}...] [--json]::
-* tlmgr generate::
-* tlmgr gui::
-* tlmgr info::
-* tlmgr init-usertree::
-* tlmgr install [@emph{option}...] @emph{pkg}...::
-* tlmgr key::
-* tlmgr list::
-* tlmgr option::
-* tlmgr paper::
-* tlmgr path::
-* tlmgr pinning::
-* tlmgr platform::
-* tlmgr postaction::
-* tlmgr print-platform::
-* tlmgr print-platform-info::
-* tlmgr remove [@emph{option}...] @emph{pkg}...::
-* tlmgr repository::
-* tlmgr restore::
-* tlmgr search::
-* tlmgr shell::
-* tlmgr show::
-* tlmgr uninstall::
-* tlmgr update [@emph{option}...] [@emph{pkg}...]::
- at end menu
-
@node tlmgr help
@appendixsubsec help
@@ -397,8 +347,8 @@
@appendixsubsec backup
@table @asis
- at item @strong{backup [@emph{option}...] --all}
- at anchor{tlmgr @strong{backup [@emph{option}...] --all}}
+ at item @strong{backup [@emph{option}...] @asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{backup [@emph{option}...] @asis{}- at asis{}- at asis{}all}}
@item @strong{backup [@emph{option}...] @emph{pkg}...}
@anchor{tlmgr @strong{backup [@emph{option}...] @emph{pkg}...}}
@@ -422,22 +372,22 @@
Options:
@table @asis
- at item @strong{--backupdir} @emph{directory}
- at anchor{tlmgr @strong{--backupdir} @emph{directory}}
+ at item @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory}}
Overrides the @code{backupdir} option setting in the TLPDB.
The @emph{directory} argument is required and must specify an existing,
writable directory where backups are to be placed.
- at item @strong{--all}
- at anchor{tlmgr @strong{--all}}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all}}
If @code{--clean} is not specified, make a backup of all packages in the TeX
Live installation; this will take quite a lot of space and time. If
@code{--clean} is specified, all packages are pruned.
- at item @strong{--clean}[=@emph{N}]
- at anchor{tlmgr @strong{--clean}[=@emph{N}]}
+ at item @strong{@asis{}- at asis{}- at asis{}clean}[=@emph{N}]
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}clean}[=@emph{N}]}
Instead of making backups, prune the backup directory of old backups, as
explained above. The optional integer argument @emph{N} overrides the
@@ -444,8 +394,8 @@
@code{autobackup} option set in the TLPDB. You must use @code{--all} or a list
of packages together with this option, as desired.
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run}}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run}}
Nothing is actually backed up or removed; instead, the actions to be
performed are written to the terminal.
@@ -523,8 +473,8 @@
Options:
@table @asis
- at item @strong{--use-svn}
- at anchor{tlmgr @strong{--use-svn}}
+ at item @strong{@asis{}- at asis{}- at asis{}use-svn}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}use-svn}}
Use the output of @code{svn status} instead of listing the files; for
checking the TL development repository. (This is run nightly.)
@@ -535,11 +485,11 @@
@appendixsubsec conf
@table @asis
- at item @strong{conf [texmf|tlmgr|updmap [--conffile @emph{file}] [--delete] [@emph{key} [@emph{value}]]]}
- at anchor{tlmgr @strong{conf [texmf|tlmgr|updmap [--conffile @emph{file}] [--delete] [@emph{key} [@emph{value}]]]}}
+ at item @strong{conf [texmf|tlmgr|updmap [@asis{}- at asis{}- at asis{}conffile @emph{file}] [@asis{}- at asis{}- at asis{}delete] [@emph{key} [@emph{value}]]]}
+ at anchor{tlmgr @strong{conf [texmf|tlmgr|updmap [@asis{}- at asis{}- at asis{}conffile @emph{file}] [@asis{}- at asis{}- at asis{}delete] [@emph{key} [@emph{value}]]]}}
- at item @strong{conf auxtrees [--conffile @emph{file}] [show|add|remove] [@emph{value}]}
- at anchor{tlmgr @strong{conf auxtrees [--conffile @emph{file}] [show|add|remove] [@emph{value}]}}
+ at item @strong{conf auxtrees [@asis{}- at asis{}- at asis{}conffile @emph{file}] [show|add|remove] [@emph{value}]}
+ at anchor{tlmgr @strong{conf auxtrees [@asis{}- at asis{}- at asis{}conffile @emph{file}] [show|add|remove] [@emph{value}]}}
With only @code{conf}, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
@@ -551,7 +501,7 @@
found (via @code{kpsewhich}) @code{updmap.cfg} file, respectively.
If @emph{key} is given in addition, shows the value of only that @emph{key} in
-the respective file. If option @emph{--delete} is also given, the value in
+the respective file. If option @emph{@asis{}- at asis{}- at asis{}delete} is also given, the value in
the given configuration file is entirely removed (not just commented
out).
@@ -595,8 +545,8 @@
@end table
- at node tlmgr dump-tlpdb [@emph{option}...] [--json]
- at appendixsubsec dump-tlpdb [@emph{option}...] [--json]
+ at node tlmgr dump-tlpdb [@emph{option}...] [@asis{}- at asis{}- at asis{}json]
+ at appendixsubsec dump-tlpdb [@emph{option}...] [@asis{}- at asis{}- at asis{}json]
Dump complete local or remote TLPDB to standard output, as-is. The
output is analogous to the @code{--machine-readable} output; see
@@ -605,18 +555,18 @@
Options:
@table @asis
- at item @strong{--local}
- at anchor{tlmgr @strong{--local}}
+ at item @strong{@asis{}- at asis{}- at asis{}local}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}local}}
Dump the local TLPDB.
- at item @strong{--remote}
- at anchor{tlmgr @strong{--remote}}
+ at item @strong{@asis{}- at asis{}- at asis{}remote}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}remote}}
Dump the remote TLPDB.
- at item @strong{--json}
- at anchor{tlmgr @strong{--json}}
+ at item @strong{@asis{}- at asis{}- at asis{}json}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json}}
Instead of dumping the actual content, the database is dumped as
JSON. For the format of JSON output see @code{tlpkg/doc/JSON-formats.txt},
@@ -720,8 +670,8 @@
Options:
@table @asis
- at item @strong{--dest} @emph{output_file}
- at anchor{tlmgr @strong{--dest} @emph{output_file}}
+ at item @strong{@asis{}- at asis{}- at asis{}dest} @emph{output_file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dest} @emph{output_file}}
specifies the output file (defaults to the respective location in
@code{TEXMFSYSVAR}). If @code{--dest} is given to @code{generate language}, it
@@ -732,14 +682,14 @@
overwriting; if you want a specific name for each output file, we
recommend invoking @code{tlmgr} twice.)
- at item @strong{--localcfg} @emph{local_conf_file}
- at anchor{tlmgr @strong{--localcfg} @emph{local_conf_file}}
+ at item @strong{@asis{}- at asis{}- at asis{}localcfg} @emph{local_conf_file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}localcfg} @emph{local_conf_file}}
specifies the (optional) local additions (defaults to the respective
location in @code{TEXMFLOCAL}).
- at item @strong{--rebuild-sys}
- at anchor{tlmgr @strong{--rebuild-sys}}
+ at item @strong{@asis{}- at asis{}- at asis{}rebuild-sys}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}rebuild-sys}}
tells @code{tlmgr} to run necessary programs after config files have been
regenerated. These are:
@@ -814,8 +764,8 @@
Options:
@table @asis
- at item @strong{--list}
- at anchor{tlmgr @strong{--list}}
+ at item @strong{@asis{}- at asis{}- at asis{}list}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}list}}
If the option @code{--list} is given with a package, the list of contained
files is also shown, including those for platform-specific dependencies.
@@ -822,14 +772,14 @@
When given with schemes and collections, @code{--list} outputs their
dependencies in a similar way.
- at item @strong{--only-installed}
- at anchor{tlmgr @strong{--only-installed}}
+ at item @strong{@asis{}- at asis{}- at asis{}only-installed}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}only-installed}}
If this option is given, the installation source will not be used; only
locally installed packages, collections, or schemes are listed.
- at item @strong{--only-remote}
- at anchor{tlmgr @strong{--only-remote}}
+ at item @strong{@asis{}- at asis{}- at asis{}only-remote}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}only-remote}}
Only list packages from the remote repository. Useful when checking what
is available in a remote repository using
@@ -836,8 +786,8 @@
@code{tlmgr --repo ... --only-remote info}. Note that
@code{--only-installed} and @code{--only-remote} cannot both be specified.
- at item @strong{--data @code{item1,item2,...}}
- at anchor{tlmgr @strong{--data @code{item1 at comma{}item2 at comma{}...}}}
+ at item @strong{@asis{}- at asis{}- at asis{}data @code{item1,item2,...}}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}data @code{item1 at comma{}item2 at comma{}...}}}
If the option @code{--data} is given, its argument must be a comma or colon
separated list of field names from: @code{name}, @code{category}, @code{localrev},
@@ -862,8 +812,8 @@
may be empty or a url value. A brief description is on the CTAN upload
page for new packages: @url{https://ctan.org/upload}.
- at item @strong{--json}
- at anchor{tlmgr @strong{--json} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}json}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json} 1}
In case @code{--json} is specified, the output is a JSON encoded array where
each array element is the JSON representation of a single @code{TLPOBJ} but
@@ -893,34 +843,34 @@
dependent. Options:
@table @asis
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run} 1}
Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
- at item @strong{--file}
- at anchor{tlmgr @strong{--file}}
+ at item @strong{@asis{}- at asis{}- at asis{}file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}file}}
Instead of fetching a package from the installation repository, use
the package files given on the command line. These files must
be standard TeX Live package files (with contained tlpobj file).
- at item @strong{--force}
- at anchor{tlmgr @strong{--force}}
+ at item @strong{@asis{}- at asis{}- at asis{}force}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}force}}
If updates to @code{tlmgr} itself (or other parts of the basic
infrastructure) are present, @code{tlmgr} will bail out and not perform the
installation unless this option is given. Not recommended.
- at item @strong{--no-depends}
- at anchor{tlmgr @strong{--no-depends}}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends}}
Do not install dependencies. (By default, installing a package ensures
that all dependencies of this package are fulfilled.)
- at item @strong{--no-depends-at-all}
- at anchor{tlmgr @strong{--no-depends-at-all}}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends-at-all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends-at-all}}
Normally, when you install a package which ships binary files the
respective binary package will also be installed. That is, for a
@@ -929,8 +879,8 @@
implies @code{--no-depends}. Don't use it unless you are sure of what you
are doing.
- at item @strong{--reinstall}
- at anchor{tlmgr @strong{--reinstall}}
+ at item @strong{@asis{}- at asis{}- at asis{}reinstall}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}reinstall}}
Reinstall a package (including dependencies for collections) even if it
already seems to be installed (i.e, is present in the TLPDB). This is
@@ -939,11 +889,11 @@
When re-installing, only dependencies on normal packages are followed
(i.e., not those of category Scheme or Collection).
- at item @strong{--with-doc}
- at anchor{tlmgr @strong{--with-doc}}
+ at item @strong{@asis{}- at asis{}- at asis{}with-doc}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}with-doc}}
- at item @strong{--with-src}
- at anchor{tlmgr @strong{--with-src}}
+ at item @strong{@asis{}- at asis{}- at asis{}with-src}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}with-src}}
While not recommended, the @code{install-tl} program provides an option to
omit installation of all documentation and/or source files. (By
@@ -1000,11 +950,11 @@
@appendixsubsec option
@table @asis
- at item @strong{option [--json] [show]}
- at anchor{tlmgr @strong{option [--json] [show]}}
+ at item @strong{option [@asis{}- at asis{}- at asis{}json] [show]}
+ at anchor{tlmgr @strong{option [@asis{}- at asis{}- at asis{}json] [show]}}
- at item @strong{option [--json] showall|help}
- at anchor{tlmgr @strong{option [--json] showall|help}}
+ at item @strong{option [@asis{}- at asis{}- at asis{}json] showall|help}
+ at anchor{tlmgr @strong{option [@asis{}- at asis{}- at asis{}json] showall|help}}
@item @strong{option @emph{key} [@emph{value}]}
@anchor{tlmgr @strong{option @emph{key} [@emph{value}]}}
@@ -1119,11 +1069,11 @@
@item @strong{paper [a4|letter]}
@anchor{tlmgr @strong{paper [a4|letter]}}
- at item @strong{<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [@emph{papersize}|--list]}>
- at anchor{tlmgr @strong{<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [@emph{papersize}|--list]}>}
+ at item @strong{<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [@emph{papersize}|@asis{}- at asis{}- at asis{}list]}>
+ at anchor{tlmgr @strong{<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [@emph{papersize}|@asis{}- at asis{}- at asis{}list]}>}
- at item @strong{paper --json}
- at anchor{tlmgr @strong{paper --json}}
+ at item @strong{paper @asis{}- at asis{}- at asis{}json}
+ at anchor{tlmgr @strong{paper @asis{}- at asis{}- at asis{}json}}
@end table
@@ -1159,11 +1109,11 @@
@appendixsubsec path
@table @asis
- at item @strong{path [--w32mode=user|admin] add}
- at anchor{tlmgr @strong{path [--w32mode=user|admin] add}}
+ at item @strong{path [@asis{}- at asis{}- at asis{}w32mode=user|admin] add}
+ at anchor{tlmgr @strong{path [@asis{}- at asis{}- at asis{}w32mode=user|admin] add}}
- at item @strong{path [--w32mode=user|admin] remove}
- at anchor{tlmgr @strong{path [--w32mode=user|admin] remove}}
+ at item @strong{path [@asis{}- at asis{}- at asis{}w32mode=user|admin] remove}
+ at anchor{tlmgr @strong{path [@asis{}- at asis{}- at asis{}w32mode=user|admin] remove}}
On Unix, adds or removes symlinks for executables, man pages, and info
pages in the system directories specified by the respective options (see
@@ -1261,8 +1211,8 @@
Options:
@table @asis
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run} 2}
Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
@@ -1289,8 +1239,8 @@
Options:
@table @asis
- at item @strong{--w32mode=[user|admin]}
- at anchor{tlmgr @strong{--w32mode=[user|admin]}}
+ at item @strong{@asis{}- at asis{}- at asis{}w32mode=[user|admin]}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}w32mode=[user|admin]}}
If the option @code{--w32mode} is given the value @code{user}, all actions will
only be carried out in the user-accessible parts of the
@@ -1298,8 +1248,8 @@
parts of the registry for the file associations. If you do not have
enough permissions, using @code{--w32mode=admin} will not succeed.
- at item @strong{--fileassocmode=[1|2]}
- at anchor{tlmgr @strong{--fileassocmode=[1|2]}}
+ at item @strong{@asis{}- at asis{}- at asis{}fileassocmode=[1|2]}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}fileassocmode=[1|2]}}
@code{--fileassocmode} specifies the action for file associations. If it is
set to 1 (the default), only new associations are added; if it is set to
@@ -1306,8 +1256,8 @@
2, all associations are set to the TeX Live programs. (See also
@code{option fileassocs}.)
- at item @strong{--all}
- at anchor{tlmgr @strong{--all} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all} 1}
Carry out the postactions for all packages
@@ -1337,37 +1287,37 @@
package, dependencies are never removed. Options:
@table @asis
- at item @strong{--all}
- at anchor{tlmgr @strong{--all} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all} 2}
Uninstalls all of TeX Live, asking for confirmation unless @code{--force} is
also specified.
- at item @strong{--backup}
- at anchor{tlmgr @strong{--backup}}
+ at item @strong{@asis{}- at asis{}- at asis{}backup}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backup}}
- at item @strong{--backupdir} @emph{directory}
- at anchor{tlmgr @strong{--backupdir} @emph{directory} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory} 1}
These options behave just as with the @ref{tlmgr update
-[@emph{option}...] [...], update,, update} action (q.v.), except they apply to making
+[@emph{option}...] [@emph{pkg}...],, update} action (q.v.), except they apply to making
backups of packages before they are removed. The default is to make
such a backup, that is, to save a copy of packages before removal.
The @ref{tlmgr restore,, restore} action explains how to restore from a backup.
- at item @strong{--no-depends}
- at anchor{tlmgr @strong{--no-depends} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends} 1}
Do not remove dependent packages.
- at item @strong{--no-depends-at-all}
- at anchor{tlmgr @strong{--no-depends-at-all} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends-at-all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends-at-all} 1}
-See above under @ref{tlmgr install [@emph{option}...] @emph{pkg}..., install, install} (and beware).
+See above under @ref{tlmgr install [@emph{option}...] @emph{pkg}...,, install} (and beware).
- at item @strong{--force}
- at anchor{tlmgr @strong{--force} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}force}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}force} 1}
By default, removal of a package or collection that is a dependency of
another collection or scheme is not allowed. With this option, the
@@ -1378,8 +1328,8 @@
updated, and will be mentioned as @code{forcibly removed} in the output of
@code{tlmgr update --list}.
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run} 3}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run} 3}
Nothing is actually removed; instead, the actions to be performed are
written to the terminal.
@@ -1463,8 +1413,8 @@
@item @strong{restore [@emph{option}...] @emph{pkg} [@emph{rev}]}
@anchor{tlmgr @strong{restore [@emph{option}...] @emph{pkg} [@emph{rev}]}}
- at item @strong{restore [@emph{option}...] --all}
- at anchor{tlmgr @strong{restore [@emph{option}...] --all}}
+ at item @strong{restore [@emph{option}...] @asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{restore [@emph{option}...] @asis{}- at asis{}- at asis{}all}}
Restore a package from a previously-made backup.
@@ -1484,32 +1434,32 @@
Options:
@table @asis
- at item @strong{--all}
- at anchor{tlmgr @strong{--all} 3}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all} 3}
Try to restore the latest revision of all package backups found in the
backup directory. Additional non-option arguments (like @emph{pkg}) are not
allowed.
- at item @strong{--backupdir} @emph{directory}
- at anchor{tlmgr @strong{--backupdir} @emph{directory} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory} 2}
Specify the directory where the backups are to be found. If not given it
will be taken from the configuration setting in the TLPDB.
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run} 4}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run} 4}
Nothing is actually restored; instead, the actions to be performed are
written to the terminal.
- at item @strong{--force}
- at anchor{tlmgr @strong{--force} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}force}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}force} 2}
Don't ask questions.
- at item @strong{--json}
- at anchor{tlmgr @strong{--json} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}json}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json} 2}
When listing backups, the option @code{--json} turn on JSON output.
The format is an array of JSON objects (@code{name}, @code{rev}, @code{date}).
@@ -1527,11 +1477,11 @@
@item @strong{search [@emph{option}...] @emph{what}}
@anchor{tlmgr @strong{search [@emph{option}...] @emph{what}}}
- at item @strong{search [@emph{option}...] --file @emph{what}}
- at anchor{tlmgr @strong{search [@emph{option}...] --file @emph{what}}}
+ at item @strong{search [@emph{option}...] @asis{}- at asis{}- at asis{}file @emph{what}}
+ at anchor{tlmgr @strong{search [@emph{option}...] @asis{}- at asis{}- at asis{}file @emph{what}}}
- at item @strong{search [@emph{option}...] --all @emph{what}}
- at anchor{tlmgr @strong{search [@emph{option}...] --all @emph{what}}}
+ at item @strong{search [@emph{option}...] @asis{}- at asis{}- at asis{}all @emph{what}}
+ at anchor{tlmgr @strong{search [@emph{option}...] @asis{}- at asis{}- at asis{}all @emph{what}}}
By default, search the names, short descriptions, and long descriptions
of all locally installed packages for the argument @emph{what}, interpreted
@@ -1540,24 +1490,24 @@
Options:
@table @asis
- at item @strong{--file}
- at anchor{tlmgr @strong{--file} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}file}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}file} 1}
List all filenames containing @emph{what}.
- at item @strong{--all}
- at anchor{tlmgr @strong{--all} 4}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all} 4}
Search everything: package names, descriptions and filenames.
- at item @strong{--global}
- at anchor{tlmgr @strong{--global}}
+ at item @strong{@asis{}- at asis{}- at asis{}global}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}global}}
Search the TeX Live Database of the installation medium, instead of the
local installation.
- at item @strong{--word}
- at anchor{tlmgr @strong{--word}}
+ at item @strong{@asis{}- at asis{}- at asis{}word}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}word}}
Restrict the search of package names and descriptions (but not
filenames) to match only full words. For example, searching for
@@ -1645,7 +1595,7 @@
@node tlmgr uninstall
@appendixsubsec uninstall
-Synonym for @ref{tlmgr remove [@emph{option}...] @emph{pkg}..., remove, remove}.
+Synonym for @ref{tlmgr remove [@emph{option}...] @emph{pkg}...,, remove}.
@node tlmgr update [@emph{option}...] [@emph{pkg}...]
@appendixsubsec update [@emph{option}...] [@emph{pkg}...]
@@ -1655,8 +1605,8 @@
must be specified. Options:
@table @asis
- at item @strong{--all}
- at anchor{tlmgr @strong{--all} 5}
+ at item @strong{@asis{}- at asis{}- at asis{}all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}all} 5}
Update all installed packages except for @code{tlmgr} itself. If updates to
@code{tlmgr} itself are present, this gives an error, unless also the option
@@ -1695,8 +1645,8 @@
If you want to exclude some packages from the current update run (e.g.,
due to a slow link), see the @code{--exclude} option below.
- at item @strong{--self}
- at anchor{tlmgr @strong{--self}}
+ at item @strong{@asis{}- at asis{}- at asis{}self}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}self}}
Update @code{tlmgr} itself (that is, the infrastructure packages) if updates
to it are present. On Windows this includes updates to the private Perl
@@ -1716,14 +1666,14 @@
# ... this last at your own risk, not recommended!
@end verbatim
- at item @strong{--dry-run}
- at anchor{tlmgr @strong{--dry-run} 5}
+ at item @strong{@asis{}- at asis{}- at asis{}dry-run}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}dry-run} 5}
Nothing is actually installed; instead, the actions to be performed are
written to the terminal. This is a more detailed report than @code{--list}.
- at item @strong{--list} [@emph{pkg}]
- at anchor{tlmgr @strong{--list} [@emph{pkg}]}
+ at item @strong{@asis{}- at asis{}- at asis{}list} [@emph{pkg}]
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}list} [@emph{pkg}]}
Concisely list the packages which would be updated, newly installed, or
removed, without actually changing anything.
@@ -1737,8 +1687,8 @@
If neither @code{--all} nor @code{--self} is given, but specific package names are
given, those packages are checked for updates.
- at item @strong{--exclude} @emph{pkg}
- at anchor{tlmgr @strong{--exclude} @emph{pkg}}
+ at item @strong{@asis{}- at asis{}- at asis{}exclude} @emph{pkg}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}exclude} @emph{pkg}}
Exclude @emph{pkg} from the update process. If this option is given more
than once, its arguments accumulate.
@@ -1761,8 +1711,8 @@
This option can also be set permanently in the tlmgr config file with
the key @code{update-exclude}.
- at item @strong{--no-auto-remove} [@emph{pkg}...]
- at anchor{tlmgr @strong{--no-auto-remove} [@emph{pkg}...]}
+ at item @strong{@asis{}- at asis{}- at asis{}no-auto-remove} [@emph{pkg}...]
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-auto-remove} [@emph{pkg}...]}
By default, @code{tlmgr} tries to remove packages in an existing collection
which have disappeared on the server, as described above under @code{--all}.
@@ -1771,8 +1721,8 @@
inconsistent TeX installation, since packages are not infrequently
renamed or replaced by their authors. Therefore this is not recommended.
- at item @strong{--no-auto-install} [@emph{pkg}...]
- at anchor{tlmgr @strong{--no-auto-install} [@emph{pkg}...]}
+ at item @strong{@asis{}- at asis{}- at asis{}no-auto-install} [@emph{pkg}...]
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-auto-install} [@emph{pkg}...]}
Under normal circumstances @code{tlmgr} will install packages which are new
on the server, as described above under @code{--all}. This option prevents
@@ -1798,8 +1748,8 @@
Again, since packages are sometimes renamed or replaced, using this
option is not recommended.
- at item @strong{--reinstall-forcibly-removed}
- at anchor{tlmgr @strong{--reinstall-forcibly-removed}}
+ at item @strong{@asis{}- at asis{}- at asis{}reinstall-forcibly-removed}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}reinstall-forcibly-removed}}
Under normal circumstances @code{tlmgr} will not install packages that have
been forcibly removed by the user; that is, removed with @code{remove
@@ -1814,11 +1764,11 @@
tlmgr update --reinstall-forcibly-removed --all
@end verbatim
- at item @strong{--backup}
- at anchor{tlmgr @strong{--backup} 1}
+ at item @strong{@asis{}- at asis{}- at asis{}backup}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backup} 1}
- at item @strong{--backupdir} @emph{directory}
- at anchor{tlmgr @strong{--backupdir} @emph{directory} 3}
+ at item @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}backupdir} @emph{directory} 3}
These two options control the creation of backups of packages @emph{before}
updating; that is, backing up packages as currently installed. If
@@ -1840,20 +1790,20 @@
The @ref{tlmgr restore,, restore} action explains how to restore from a backup.
- at item @strong{--no-depends}
- at anchor{tlmgr @strong{--no-depends} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends} 2}
If you call for updating a package normally all depending packages
will also be checked for updates and updated if necessary. This switch
suppresses this behavior.
- at item @strong{--no-depends-at-all}
- at anchor{tlmgr @strong{--no-depends-at-all} 2}
+ at item @strong{@asis{}- at asis{}- at asis{}no-depends-at-all}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}no-depends-at-all} 2}
-See above under @ref{tlmgr install [@emph{option}...] @emph{pkg}..., install, install} (and beware).
+See above under @ref{tlmgr install [@emph{option}...] @emph{pkg}...,, install} (and beware).
- at item @strong{--force}
- at anchor{tlmgr @strong{--force} 3}
+ at item @strong{@asis{}- at asis{}- at asis{}force}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}force} 3}
Force update of normal packages, without updating @code{tlmgr} itself
(unless the @code{--self} option is also given). Not recommended.
@@ -1993,10 +1943,6 @@
Additional trusted keys can be added using the @code{key} action.
- at menu
-* tlmgr Configuration of GnuPG invocation::
- at end menu
-
@node tlmgr Configuration of GnuPG invocation
@appendixsubsec Configuration of GnuPG invocation
@@ -2064,12 +2010,6 @@
Description of changes of actions in user mode:
- at menu
-* tlmgr User mode install::
-* tlmgr User mode backup at comma{} restore at comma{} remove at comma{} update::
-* tlmgr User mode generate at comma{} option at comma{} paper::
- at end menu
-
@node tlmgr User mode install
@appendixsubsec User mode install
@@ -2104,6 +2044,12 @@
In user mode, these actions operate only on the user tree's
configuration files and/or @code{texlive.tlpdb}.
+ at node tlmgr User mode logs
+ at appendixsubsec User mode logs
+
+In user mode, @code{tlmgr.log} and <tlmgr-commands.log> are written in the
+ at code{TEXMFVAR/web2c/} directlry instead of @code{TEXMFSYSVAR/web2c/}.
+
@node tlmgr MULTIPLE REPOSITORIES
@appendixsec MULTIPLE REPOSITORIES
@@ -2136,10 +2082,6 @@
taken from the new repository, by specifying so-called ``pinning''
rules, described next.
- at menu
-* tlmgr Pinning::
- at end menu
-
@node tlmgr Pinning
@appendixsubsec Pinning
@@ -2246,21 +2188,9 @@
Finally, the status area at the bottom of the window gives additional
information about what is going on.
- at menu
-* tlmgr Main display::
-* tlmgr Menu bar::
-* tlmgr GUI options::
- at end menu
-
@node tlmgr Main display
@appendixsubsec Main display
- at menu
-* tlmgr Display configuration area::
-* tlmgr Package list area::
-* tlmgr Main display action buttons::
- at end menu
-
@node tlmgr Display configuration area
@appendixsubsubsec Display configuration area
@@ -2501,15 +2431,10 @@
information it needs by reading stdout.
Currently this option only applies to the
- at ref{tlmgr update [@emph{option}...] [@emph{pkg}...], update, update},
- at ref{tlmgr install [@emph{option}...] @emph{pkg}..., install, install}, and
+ at ref{tlmgr update [@emph{option}...] [@emph{pkg}...],, update},
+ at ref{tlmgr install [@emph{option}...] @emph{pkg}...,, install}, and
@ref{tlmgr option,, option} actions.
- at menu
-* tlmgr Machine-readable @code{update} and @code{install} output::
-* tlmgr Machine-readable @code{option} output::
- at end menu
-
@node tlmgr Machine-readable @code{update} and @code{install} output
@appendixsubsec Machine-readable @code{update} and @code{install} output
@@ -2758,5 +2683,5 @@
distribution (@url{https://tug.org/texlive}) and both are licensed under the
GNU General Public License Version 2 or later.
-$Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $
+$Id: tlmgr.pl 65998 2023-02-21 01:33:24Z karl $
Modified: trunk/Build/source/doc/tlbuild.info
===================================================================
(Binary files differ)
Modified: trunk/Build/source/texk/README
===================================================================
--- trunk/Build/source/texk/README 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/texk/README 2023-02-26 21:56:36 UTC (rev 66203)
@@ -63,7 +63,7 @@
dvipsk - maintained here, by us
-dvisvgm 3.0.2 - checked 1feb23
+dvisvgm 3.0.3 - checked 21feb23
https://dvisvgm.de/Downloads/
https://github.com/mgieseki/dvisvgm
https://ctan.org/pkg/dvisvgm
Modified: trunk/Build/source/texk/dvisvgm/TLpatches/TL-Changes
===================================================================
--- trunk/Build/source/texk/dvisvgm/TLpatches/TL-Changes 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/texk/dvisvgm/TLpatches/TL-Changes 2023-02-26 21:56:36 UTC (rev 66203)
@@ -4,7 +4,7 @@
https://dvisvgm.de/Downloads/
or (hopefully) https://ctan.org/pkg/dvisvgm
-Update version in ./version.ac.
+Update version in ./version.ac and ../README.
Update DATE and copyrights in configure.ac.
ver=3.NEW.VER
@@ -43,6 +43,9 @@
# remake autostuff (then make, etc., with fingers crossed).
autoreconf
+# try build.
+make -C ../../Work/texk/dvisvgm
+
# before committing, update patches:
diff -u2 dvisvgm-$ver/configure.ac ./ >TLpatches/patch-04-configure
for m in `(cd ./dvisvgm-src && find -name Makefile.am -o -name defs.am)`; do \
Modified: trunk/Build/source/texk/texlive/tl_support/fmtutil.1
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/fmtutil.1 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/texk/texlive/tl_support/fmtutil.1 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
-.TH FMTUTIL "1" "March 2022" "TeX Live" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
+.TH FMTUTIL "1" "February 2023" "TeX Live" "User Commands"
.SH NAME
fmtutil \- manage TeX formats and Metafont bases, per-user
.br
@@ -19,7 +19,7 @@
.B mktexfmt
\fI\,FORMAT.fmt|BASE.base|FMTNAME\/\fR
.SH DESCRIPTION
-fmtutil version r60154 (2021\-08\-03 23:55:56 +0200)
+fmtutil version r65989 (2023\-02\-20 22:52:59 +0100)
.PP
Rebuild and manage TeX fmts and Metafont bases, collectively called
"formats" here. (MetaPost no longer uses the past\-equivalent "mems".)
Modified: trunk/Build/source/texk/texlive/tl_support/updmap.1
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/updmap.1 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Build/source/texk/texlive/tl_support/updmap.1 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
-.TH UPDMAP "1" "March 2022" "TeX Live" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
+.TH UPDMAP "1" "February 2023" "TeX Live" "User Commands"
.SH NAME
updmap \- manage TeX font maps
.br
@@ -16,7 +16,7 @@
.B updmap-sys
[\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR]
.SH DESCRIPTION
-updmap version r59152 (2021\-05\-09 23:49:52 +0200)
+updmap version r65932 (2023\-02\-19 21:49:48 +0100)
.PP
Update the default font map files used by pdftex and dvipdfm(x)
(pdftex.map), dvips (psfonts.map), and optionally pxdvi, as determined
Added: trunk/Master/texmf-dist/doc/aleph/base/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/aleph/base/ChangeLog (rev 0)
+++ trunk/Master/texmf-dist/doc/aleph/base/ChangeLog 2023-02-26 21:56:36 UTC (rev 66203)
@@ -0,0 +1,341 @@
+2023-02-21 Phelype Oleinik <phelype.oleinik at latex-project.org>
+
+ * latespecial.ch: reduce memory usage, a la HH/luatex.
+
+2023-02-15 Phelype Oleinik <phelype.oleinik at latex-project.org>
+
+ * latespecial.ch: new change file for "\special shipout".
+ * am/aleph.am (aleph_web_srcs): add latespecial.ch.
+
+2022-10-22 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+
+ * com16bit.ch: Sync with tex.ch changes:
+ - 2022-07-16 r63916 to disallow \noexpand\endwrite.
+ - 2021-07-22 r60013 explicit fmt loading error.
+ - 2022-09-28 r64547 protect against recursive --halt-on-error.
+ * comsrcspec.ch: Sync with tex.ch changes:
+ - 2022-09-28 r64547 protect against recursive --halt-on-error.
+
+2022-03-21 Karl Berry <karl at tug.org>
+
+ * TL'22 release.
+
+2022-01-10 Karl Berry <karl at freefriends.org>
+
+ * am/aleph.am: do not silence tangle-sh.
+
+2021-07-19 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+
+ * com16bit.ch: Sync with tex.ch to initialize limit.
+ https://tug.org/pipermail/tex-k/2021-July/003630.html
+
+2021-05-08 Akira Kakuto <kakuto at w32tex.org>
+
+ * com16bit.ch: Sync sup_param_size and sup_save_size with tex.ch.
+
+2021-03-23 Karl Berry <karl at tug.org>
+
+ * TL'21.
+
+2020-07-07 Akira Kakuto <kakuto at w32tex.org>
+
+ * com16bit.ch: Sync with tex.ch (avoid seg fault in unusual
+ interaction sequence).
+
+2020-02-10 Akira Kakuto <kakuto at w32tex.org>
+
+ * com16bit.ch: Sync with tex.ch for changes by Phelype Oleinik
+ to support \input {...}.
+
+2019-12-18 Akira Kakuto <kakuto at w32tex.org>
+
+ * com16bit.ch: Sync with tex.ch for out_what [1374].
+
+2019-08-10 Akira Kakuto <kakuto at w32tex.org>
+
+ * com16bit.ch: Sync with tex.ch for texmf_yesno('log_openout').
+
+2018-03-24 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+
+ * ceostuff.ch: Recover the right \lastnodetype initialization
+ value ignored by tex.ch.
+
+2017-12-25 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+
+ * omtrans.ch (omega_print): expand \newlinechar for terminal and
+ log output. (Without this, LaTeX error messages contain ^^J.)
+
+2017-12-13 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+
+ * om16bit.ch: \show\odelimiter should be \odelimiter, etc.
+ This is a backport from eptexdir/fam256.ch.
+
+2017-01-28 Karl Berry <karl at freefriends.org>
+
+ * com16bit.ch (texarray): don't mention pool files in error message.
+
+2015-07-10 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Dependencies for 'make check'.
+
+2015-06-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Use $(tie_c) and $(tie_m).
+
+2015-04-14 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephbis.c: Declare {in,out}_file_fd only when used (!WIN32).
+
+2015-01-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch: Drop intcast().
+
+2014-12-15 Karl Berry <karl at tug.org>
+
+ * alephbis.c (runexternalocp): quote arguments to system()
+ and check string values. Untested, sorry to say.
+
+2014-07-21 Akira Kakuto <kakuto at fuk.kindai.ac.jp>
+
+ * com16bit.ch: Add a function get_nullstr.
+
+2014-01-20 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ TeX tuneup of 2014.
+ * com16bit.ch, eobase.ch, eoext.ch, eover.ch, omstr.ch,
+ om16bit.ch: Adapt to TeX Version 3.14159265.
+
+2014-01-14 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch, comsrcspec.ch: Write dump_name to the terminal.
+
+2014-01-13 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch.ch: Restore the word `preloaded' for
+ format_idents (as in ../tex.ch).
+
+2013-06-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephbis.c: Include "alephd.h" before system headers.
+
+2013-04-09 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephextra.h, eover.ch: 0.0-rc4 ---> 0.1 for TL 2013.
+
+2012-12-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Enable silent rules.
+
+2012-12-02 Akira Kakuto <kakuto at fuk.kindai.ac.jp>
+
+ * om16bit.ch: fix a delcode bug.
+
+2012-11-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Define al_tangle and use it instead of o_tangle.
+
+2012-10-05 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * aleph.c ({allocate,undump}{font,ocp}table): Correctly specify
+ the new size for xrealloc(). Remove useless casts.
+ ({allocate,{un,}dump}fontsorttable): Drop unused functions.
+ * omocp.ch: Fix the logic of read_ocp_info().
+ Check for ocp table overflow.
+ Avoid segmentation fault (uninitialized use of 'f').
+
+2012-07-15 Akira Kakuto <kakuto at fuk.kindai.ac.jp>
+
+ * alephextra.c: Must #define DLLPROC before reading alephd.h.
+
+2012-06-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephextra.c [W32TeX]: #define DLLPROC for aleph.dll.
+
+2012-06-28 Akira Kakuto <kakuto at fuk.kindai.ac.jp>
+
+ * om16bit.ch: Aleph uses 256 math font families.
+
+2012-04-11 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * eobase.ch: Fixed a typo in TeX text (for e-TeX).
+
+2012-02-16 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch: Remove test for end-of-file after undump.
+
+2012-02-01 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch: Ensure dvi file size < 2GB.
+
+2011-12-13 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch, om16bit.ch: Consistency of `constants':
+ Aleph requires min_halfword==0.
+
+2011-12-08 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch, om16bit.ch: Consistency of `constants'.
+ * omocp.ch: Adjust to null, i.e., min_halfword <0.
+
+ * aleph.test (new): Just testing 'aleph -version'.
+ * Makefile (removed): Unused.
+ * am/aleph.am: Adjusted.
+
+2011-09-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch.ch (print_file_line): Bug fix: avoid uninitialized
+ lineno - from ../tex.ch.
+ * eobase.ch: Slightly reformulate printing of current line -
+ from ../etexdir/etex.ch.
+
+2011-09-09 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephbis.c (runexternalocp): Declare tempenv as const.
+
+2011-04-19 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ Avoid 'differ in signedness' warnings.
+ * com16bit.ch: Cast runsystem() arg to string.
+
+2011-03-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Use AM_CFLAGS instead of aleph_CFLAGS.
+
+2011-03-23 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ eobase.ch: Remove unused (commented) e-TeX changes.
+
+2011-03-21 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * aleph-pool.h, eomega.ech, etex.ch, omega.ch[012], omxml.ch
+ (removed): Obsolete.
+ * am/aleph.am (EXTRA_DIST): Adapt.
+
+2011-01-14 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * eobase.ch: Adapt to ../etexdir/etex.ch:
+ Mention \protected in error and help messages only when in
+ in extended mode.
+
+2011-01-11 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * aleph.mk (removed): Obsolete.
+
+2011-01-01 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * alephextra.c (new): #include <alephd.h> and <lib/texmfmp.c>.
+
+ * am/aleph.am: alephextra.c is now distributed.
+
+2010-12-31 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am (alephextra.c): Uniform dependencies and rules.
+
+2010-05-19 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * aleph.c (new_input_line): Cast integer to long for printing
+ to avoid warning on 64Bit systems.
+
+2010-05-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * eobase.ch: Adapt to ../etexdir/etex.ch:
+ More error message with \protected, from Heiko.
+
+2010-04-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * eobase.ch: Adapt to ../etexdir/etex.ch:
+ Fixed the error message for improper use of \protected,
+ reported by Heiko Oberdiek <heiko.oberdiek at googlemail.com>.
+
+2010-01-03 Karl Berry <karl at tug.org>
+
+ * com16bit.ch: propagate "executed safely" wording change.
+
+2009-11-27 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch (read_font_info): Better wording of error message.
+
+2009-11-19 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch (read_font_info): Check font name length to avoid
+ broken .dvi files.
+
+2009-11-09 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch: Check for allowed filename before opening the
+ output file. Better diagnostic when input file not found.
+ From Akira Kakuto <kakuto at fuk.kindai.ac.jp>.
+
+2009-10-24 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * com16bit.ch: Use kpse_{in,out}_name_ok(), now in Kpathsea,
+ instead of open_{in,out}_name_ok().
+
+2009-10-07 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Enable compiler warnings.
+
+ Avoid many (--enable-...=max) compiler warnings.
+ * aleph.c (getc_two_LE, ungetc_two_LE): Declare as static.
+ (createeqtbptr): Comment out unused function.
+ (zpnewinputln, ziniteqtbentry): Drop extern decls; instead use
+ pnewinputln and initeqtbentry as defined in alephcoerce.h.
+ * alephbis.c (runexternalocp): Declare in_file_fd, out_file_fd
+ only when used (HAVE_MKSTEMP).
+ * alephmem.h: ANSI C function prototypes.
+ * com16bit.ch (bound_name, months): Declare as const_cstring.
+ (get_strings_started, open_log_file): Drop unused variables.
+ * eo16bit.ch (show_sa): Drop unused variable.
+ * eomem.ch (box_end): Drop unused variable.
+ * om16bit.ch (set_math_char): Drop unused variables.
+
+2009-09-06 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Adapt to new makecpool with one argument,
+ obsoleting aleph-pool.h.
+
+2009-08-16 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am: Adapt to tangle-sh and web2c-sh.
+
+2009-08-13 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/aleph.am (aleph_c_h): avoid to split the C code.
+
+2009-06-23 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * aleph.c, alephbis.c: drop P?C, P?H, use ANSI C function
+ declarations.
+
+2009-02-26 Karl Berry <karl at tug.org>
+
+ * alephextra-rc2.h (BANNER, COPYRIGHT_HOLDER, BUG_ADDRESS):
+ make consistent.
+ * eocprt.ch: do not announce copyright on the terminal,
+ but do include full copyright notices in the .log.
+ * com16bit-rc2.ch (banner_k): just make equivalent to banner,
+ since Web2C announces itself.
+
+ * comsrcspec.ch, com16bit-rc2.ch:
+ Use runsystem() instead of system(), etc. See tex.ch entry in
+ ../ChangeLog
+
+2008-03-23 Karl Berry <karl at freefriends.org>
+
+ * Update to TeX 3.1415926; compile in pool files.
+ From Akira.
+
+2006-05-25 Roozbeh Pournader <roozbeh at farsiweb.info>
+
+ * omfilter.ch: fixed a bug in OCP processing, increased
+ active_mem_size from 2000 to 50000.
+
+ * alephbis.c: updated from ../omegadir/omegabis.c: optimized UTF-8
+ read/write code, fixed a macro, closed files and freed memory to
+ avoid a leak.
+
+ * omfilter.ch, eover-rc2.ch: made 'weave'-able.
+
+ * alephbis.c, aleph.c, aleph.defines, alephextra.h,
+ alephextra-rc1.h, alephextra-rc2.h, alephmem.h: fixed copyright
+ lines.
Modified: trunk/Master/texmf-dist/doc/dvipdfmx/README
===================================================================
--- trunk/Master/texmf-dist/doc/dvipdfmx/README 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/dvipdfmx/README 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,11 +1,26 @@
+$Id: README 63453 2022-05-31 15:40:57Z karl $
dvipdfmx and xdvipdfmx for TeX Live
===================================
+dvipdfmx is a DVI-to-PDF translator. It requires the Kpathsea library
+for patch searching.
+This package is released under the GNU GPL, version 2, or (at your
+option) any later version.
+
+Mailing list for bug reports and all discussion:
+https://lists.tug.org/dvipdfmx; anyone can join the list, but it is not
+necessary to join to post. Archives are public.
+
+dvipdfmx is now maintained as part of TeX Live, https://tug.org/texlive.
+Info on building only one program from TL, like this one:
+ https://tug.org/texinfohtml/tlbuild.html#Build-one-package
+TeX Live general build info:
+ https://tug.org/texlive/build.html
+
xdvipdfmx
=========
-
xdvipdfmx is an extended version of dvipdfmx, and is now incorporated in
-the same sources.
+the same sources. In the installation, dvipdfmx is a symlink to xdvipdfmx.
The extensions provided by xdvipdfmx provide support for the Extended DVI
(.xdv) format used by xetex, including support for platform-native fonts
@@ -15,8 +30,6 @@
redistributed under the terms of the GNU General Public License,
version 2 or (at your option) any later version.
-There is a hope to merge xdvipdfmx into dvipdfmx.
-
Jonathan Kew mentions that in the past, XeTeX used a Mac-specific
program xdv2pdf as the backend instead of xdvipdfmx. xdv2pdf supported
a couple of special effects that are not yet available through
@@ -26,73 +39,8 @@
if anyone is looking for some nontrivial but not-impossible job and
happens across this file.
-The dvipdfmx Project
-====================
-Copyright (C) 2002-2014 by Jin-Hwan Cho, Shunsaku Hirata,
-Matthias Franz, and the dvipdfmx project team. This package is released
-under the GNU GPL, version 2, or (at your option) any later version.
-
-dvipdfmx is now maintained as part of TeX Live.
-
-Contents
---------
-
1. Introduction
-
-2. Installation
-
- 2.1. Compiling and Installation
-
- 2.2. TeX Directory Structure (TDS)
-
- 2.3. Auxiliary Files
-
-3. CJK Support
-
- 3.1. Quick Test of Installation
-
- 3.2. CJK-LaTeX and HLaTeX
-
- 3.3. Omega and Other Extended TeX
-
- 3.4. Vertical Typesetting
-
-4. Unicode Support
-
- 4.1. Unicode Support in General
-
- 4.2. ToUnicode CMap Support
-
- 4.3. OpenType Support and Unicode
-
- 4.4. Type1 Font Support and Unicode
-
-5. Graphics and Image Format
-
- 5.1. Supported Graphics File Format
-
- 5.2. Graphics Extension
-
- 5.3. Using External Programs for Format Conversion
-
-6. DVI Specials
-
- 6.1. Compatibility
-
- 6.2. Additions to Dvipdfm's pdf: Special
-
-7. Font Mapping
-
-8. Incompatible Changes From Dvipdfm
-
-9. Other Improvement Over Dvipdfm
-
-10. Font Licensing and Embedding
-
-
-
-1. Introduction
------------
The dvipdfmx (formerly dvipdfm-cjk) project provides an eXtended version
@@ -106,405 +54,53 @@
Hirata and its modified one, dvipdfm-kor, by Jin-Hwan Cho.
-2. Installation
- -----------------------
+2. Random number generating function
+ ---------------------------------
- Typical usage and installation steps are not different from the original dvipdfm.
- Please refer documents from dvipdfm distribution for detailed instruction on how
- to install and how to use dvipdfm.
+ Prefixes of font names are calculated by using a function which
+ generates pseudo random numbers. In order to obtain a unique
+ prefix on all platforms when current time is common, a special
+ function MT19937, coded by Takuji Nishimura and Makoto Matsumoto,
+ is used. The header of the C program by Takuji Nishimura and
+ Makoto Matsumoto is the following:
+ A C-program for MT19937, with initialization improved 2002/1/26.
+ Coded by Takuji Nishimura and Makoto Matsumoto.
-2.1. Compiling and Installation
+ Before using, initialize the state by using init_genrand(seed)
+ or init_by_array(init_key, key_length).
+ Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura,
+ All rights reserved.
- If you have obtained older version, please use latest version unless you have a
- clear reason to choose older versions. The latest snapshot of dvipdfmx source is
- available at:
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
- http://project.ktug.or.kr/dvipdfmx/snapshot/
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
- And the CVS repository for this project can be obtained through anonymous CVS
- access with the following command:
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
- cvs -d:pserver:anonymous at cvs.ktug.or.kr:/home/cvsroot login
- cvs -d:pserver:anonymous at cvs.ktug.or.kr:/home/cvsroot co dvipdfmx
+ 3. The names of its contributors may not be used to endorse or promote
+ products derived from this software without specific prior written
+ permission.
- When prompted for a password, simply press the Enter key.
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
- The kpathsea library is required to compile and install dvipdfmx in UNIX or
- UNIX-like platforms. It is usually included for most of TeX distributions.
- If you already have installed dvipdfm (the original) by yourself, you should
- already have kpathsea library and it's headers. And zlib library is highly
- recommended as dvipdfmx can't compress data without this.
-
- Before starting things, you must check the location of your TeX installation.
- If other TeX related programs are installed under, e.g., '/usr/local/TeX/bin',
- you should specify directory '/usr/local/TeX' as an for ./configure script as
-
- ./configure --prefix=/usr/local/TeX --with-kpathsea=/usr/local/TeX
-
- If you are using libpaper to handle paper sizes for various program, you can
- use --with-paper option to ./configure. The location of libpaper library can
- be specified with this option as
-
- --with-paper=DIR
-
- Please note thath dvipdfmx uses JIS paper size for B-series paper instead of
- ISO's one for historical reason. (too late to change the default behavior)
- The most easiest way to fix this is to use libpaper if you already have that,
- otherwise define ISO_PAPERSIZE macro at compilation time.
-
- Dvipdfmx requires libpng library available from
-
- http://www.libpng.org/pub/png/libpng.html
-
- to read PNG format images. To tell dvipdfmx the location of libpng header
- and library, use configure option
-
- --with-png=DIR
-
- After you have finished ./configure, just type
-
- make && make install
-
- then dvipdfmx will be installed under the directory specified by the --prefix
- option to ./configure script. After you have successfully installed dvipdfmx,
- you may need to install various auxiliary files and slightly adjust location
- of files or configuration. Amount of additional files and modification depends
- on your environment, and briefly described in the sections follows.
-
-
-2.2. TeX Directory Structure (TDS)
-
-
- If your TeX installation is conforming with TDS version 1.1 described in
-
- http://www.tug.org/ftp/tex/tds-1.1/
-
- , then you'll need to adjust your dvipdfmx installtion. This also applies when
- you have updated programs without modifying existing platform independent files
- (files in texmf directory). Dvipdfmx installs few files in addition to dvipdfmx
- program itself, dvipdfmx.cnf, cid-x.map and others, but it currently does not
- choose installation directory as appropriate for TDS 1.1.
-
- If your 'kpsewhich' program recognizes '.sfd' file format, i.e.,
-
- kpsewhich --show-path --format=.sfd
-
- does not answer as 'unknown format', then you should move several files under
- appropriate locations or should modify texmf.cnf as follows:
-
- * Subfont Definition (SFD) Files
-
- Recommended location of SFD files (.sfd) is
-
- $TEXMF/fonts/sfd/
-
- and environmental variable for specifying additional search path for this
- file format files is
-
- SFDFONTS
-
- . To make those files visible to dvipdfmx under TDS 1.1 installation, you
- must move all .sfd files to the directory mentioned above or set SFDFONTS
- variable in texmf.cnf. As some programs may not be updated to follow this
- convention yet, it is recommended to preserve old installation directory.
- If you have .sfd files under "$TEXMF/dvipdfm/", please do not use that,
- please move all files to the directory mentioned above.
-
- * PostScript CMap Resources
-
- Recommended location of CMap files (no suffix or with suffix .cmap) is
-
- $TEXMF/fonts/cmap/
-
- and environmental variable for adding extra search path for this format files
- is
-
- CMAPFONTS
-
- You may want to set CMAPFONTS to include GhostScript's Resource path, e.g.,
-
- /usr/share/ghostscript/Resource/CMap//
-
- in your texmf.cnf file as this resource can be used by various programs that
- manipulates PS/PDF files. Dvipdfmx installs few additional files into the
- directory "$TEXMF/dvipdfm/CMap", please move this files to the directory for
- CMap files. But please note that file "Adobe-Identity-UCS2" is not meaningful
- to other programs at all, so you should place at least this file in different
- location than CMap files. (Or you can just remove this unless you see problems
- in copy-and-pasting text from dvipdfmx output PDF.)
-
- * Font Mapping Files
-
- Suggested place for dvipdfm's font mapping files (.map) is
-
- $TEXMF/fonts/map/dvipdfm/
-
- and environmental variable for this format files is
-
- TEXFONTMAPS
-
- For files containing dvipdfmx extension to dvipdfm format, place them into
-
- $TEXMF/fonts/map/dvipdfmx/
-
- instead of sub-directory 'dvipdfm'.
-
- * OpenType Fonts
-
- Appropriate place for OpenType font with PostScript outline (.otf) is
-
- $TEXMF/fonts/opentype/supplier/typeface/
-
- where 'supplier' and 'typeface' should be replaced with font's supplier and
- typeface identifier strings.
-
-
-2.3. Auxiliary Files
-
-
- 1) CMap PostScript Resources
-
- Dvipdfmx internally identifies glyphs in a font with identifier represented
- as numbers ranging from 0 to 65535. CMap PostScript Resources defines how the
- input character codes are translated to those ID's (CID). CID's should be
- uniquely assigned to every glyphs contained in a collection of glyphs. Adobe
- has defined several "character collection"s; Adobe-GB1 (Simplified Chinese),
- Adobe-CNS1 (Traditional Chinese), Adobe-Japan1 (Japanese), and Adobe-Korea1
- (Korean), which contains much of glyphs necessary for publishing for each
- languages. Details on Adobe's character collections can be found at Adobe's
- developer site:
-
- http://partners.adobe.com/public/developer/font/index.html
-
- Please install CMap resource files under the directory
-
- ${TEXMF}/fonts/cmap
-
- , or set CMAPFONTS variable to point the directory containing CMap resource
- in texmf.cnf. If your TeX installation does not conforming TDS 1.1, then you
- should set CMAPINPUTS variable to make those files visible to dvipdfmx. For
- examples,
-
- CMAPINPUTS= .;$TEXMF/fonts/cmap//
-
- Adobe's "CMaps for PDF 1.4 CJK Fonts" are available from:
-
- http://partners.adobe.com/public/developer/acrobat/index_advanced.html
-
- or
-
- ftp://ftp.oreilly.com/pub/examples/nutshell/cjkv/adobe/
-
- You can find a short explanation of each CMap files in cid2code.txt contained
- in the archive files found at the above FTP site.
-
-
- 2) SubFont Definition Files
-
- .....
-
-
- 3) Adobe Glyph List and ToUnicode Mapping Files
-
- The Adobe glyph list (AGL) file describes correspondence between PostScript
- glyph names (e.g., AE, Aacute, ...) and it's Unicode character sequences.
- Most features described in the section "Unicode Support" requires this file.
-
- Dvipdfmx looks for file "glyphlist.txt" when conversion from PostScript glyph
- names to Unicode is necessary. This conversion is done in various situations;
- when creating ToUnicode CMap for 8bit encoded fonts, finding glyph description
- from TrueType/OpenType fonts supporting Unicode when the font itself does not
- provide the mapping from PostScript glyph names to glyph indices (version 2.0
- "post" table), and when encoding "unicode" is specified for Type 1 font.
-
- The "glyphlist.txt" file written by Adobe is found at
-
- http://partners.adobe.com/asn/tech/type/glyphlist.txt
-
- You should place file "glyphlist.txt" in a directory shown by
-
- kpsewhich --progname=dvipdfm --show-path="other text files"
-
- Please check kpathsea library can find this file by 'kpsewhich' command:
-
- kpsewhich --progname=dvipdfm --format="other text files" glyphlist.txt
-
- The 'progname' is not dvipdfmx but dvipdfm here.
-
- ToUnicode mapping is similar to glyph list file but describes correspondence
- between CID numbers and Unicode values. The content of this file look like a
- CMap files and is contained in "CMaps for PDF 1.4 CJK Fonts" from Adobe (see
- "CMap PostScript Resources" above). This file is required to support TrueType
- font (including OpenType fonts with TrueType outline). Those files should be
- installed same directory as ordinary CMap files.
-
-
-3. CJK Support
-
-3.1. Quick Test of Installation
-
-3.2. CJK-LaTeX and HLaTeX
-
-3.3. Omega and Other Extended TeX
-
-
-4. Unicode Support
-
-4.1. Unicode Support in General
-
-4.2. ToUnicode CMap Support
-
-4.3. OpenType Support and Unicode
-
-4.4. Type1 Font Support and Unicode
-
-
-5. Graphics and Image Format
-
-5.1. Supported Graphics File Format
-
-5.2. Graphics Extension
-
-5.3. Using External Programs for Format Conversion
-
-
-6. DVI Specials
-
-6.1. Compatibility
-
-6.2. Additions to Dvipdfm's pdf: Special
-
-
-7. Font Mapping
-
-
-7.1. Options for CJK Font
-
- Few options are available in dvipdfmx (for CID-keyed fonts) in addition
- to the original dvipdfm.
-
-
- 1) TTC Index
-
- You can specify TrueType Collection index number with :n: option in front
- of TrueType font name.
-
- min10 H :1:mincho
-
- In this example, the option :1: tells dvipdfmx to select TrueType font #1
- from TrueType collection font "mincho.ttc".
-
-
- 2) No-embed Switch
-
- It is possible to block embedding glyph data with the character `!'
- in front of the font name in the font mapping file.
-
- This feature reduces the size of the final PDF output, but the PDF file
- may not be viewed exactly in other systems on which appropriate fonts
- are not installed.
-
- Use of this option is not recommended for fonts that contains unusual
- characters (and characters having different width from default value).
- Please note that glyph metric information is not written in the output
- PDF file for TrueType fonts without embedding. It will be treated as
- fixed-pitch with all widths equal to the default value (will be fixed
- someday).
-
-
- 3) Stylistic Variants
-
- Keywords ",Bold", ",Italic", and ",BoldItalic" can be used to create
- synthetic bold, italic, and bolditalic style variants from other font
- using PDF viewer's (or OS's) function.
-
- jbtmo at UKS@ UniKSCms-UCS2-H :0:!batang,Italic
- jbtb at Unicode@ Identity-H !batang/UCS,Bold
-
- Availability of this feature highly depends on the implementation of PDF
- viewers. This feature is not supported for embedded fonts in the most of
- PDF viewers, like Adobe Acrobat Reader and GNU Ghostscript.
-
- Notice that this option automatically disable font embedding.
-
-
-
-8. Incompatible Changes From Dvipdfm
-
-
-
-9. Other Improvement Over Dvipdfm
-
-
-9.1. Encryption
-
-
-9.2. Font
-
-
-
-10. Font Licensing and Embedding
-
- In OpenType format, information regarding how the font should be treated
- when creating documents can be recorded. Dvipdfmx uses this information
- to decide whether embedding font into the document is permitted.
-
- This font embedding information is indicated by a flag called as "fsType"
- flag; each bit representing different restrictions on font embedding.
- If multiple flag bits are set in fsType, the least restrictive license
- granted takes precedence in dvipdfmx. The fsType flag bits recognized by
- dvipdfmx is as follows:
-
- * Installable embedding
-
- All font with this type of license can be embedded.
-
- * Editable embedding
-
- All font with this type of license can be embedded.
-
- * Embedding for Preview & Print only
-
- Dvipdfmx give the following warning message for fonts with this
- type of license:
-
- This document contains `Preview & Print' only licensed font
-
- For the font with this type of licensing, font embedding is allowed
- solely for the purpose of (on-screen) viewing and/or printing the
- document; further editing of the document or extracting an embedded
- font data for other purpose is not allowed. To ensure this condition,
- you must at least protect your document with non-empty password.
-
- All other flags are treated as more restrictive license than any of the
- above flags and treated as "No embedding allowed"; e.g., if both of the
- editable-embedding flag and unrecognized license flag is set, the font
- is treated as editable-embedding allowed, however, if only unrecognized
- flags are set, the font is not embedded.
-
- Embedding flags are preserved in embedded font if the font is embedded
- as a TrueType font or a CIDFontType 2 CIDFont. For all font embedded as
- a PostScript font (CFF, CIDFontType 0 CIDFont), they are not preserved.
- Only /Copyright and /Notice in the FontInfo dictionary are preserved in
- this case.
-
- Some font vendors put different embedding restrictions for different
- condition; e.g., font embedding might be not permitted for commercial
- materials unless you acquire "commercial license" separately.
- Please read EULA carefully before making decision on font usage.
-
-
- Adobe provide a font licensing FAQ and a list of embedding permissions
- for Adobe Type Library fonts:
-
- http://www.adobe.com/type/browser/legal/
-
- For Japanese font in general, embedding permission tend to be somewhat
- restrictive. Japanese users should read the statement regarding font
- embedding from Japan Typography Association (in Japanese):
-
- http://www.typography.or.jp/act/morals/moral4.html
+ Any feedback is very welcome.
+ http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html
+ email: m-mat @ math.sci.hiroshima-u.ac.jp (remove space)
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,6 +1,6 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.0.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>A DVI-to-PNG translator</title>
@@ -19,21 +19,17 @@
<link href="#Introduction" rel="next" title="Introduction">
<style type="text/css">
<!--
-a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
-a.summary-letter {text-decoration: none}
-blockquote.indentedblock {margin-right: 0em}
-div.display {margin-left: 3.2em}
+a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
+a.summary-letter-printindex {text-decoration: none}
div.example {margin-left: 3.2em}
-kbd {font-style: oblique}
-pre.display {font-family: inherit}
-pre.format {font-family: inherit}
-pre.menu-comment {font-family: serif}
-pre.menu-preformatted {font-family: serif}
-span.nolinebreak {white-space: nowrap}
-span.roman {font-family: initial; font-weight: normal}
-span.sansserif {font-family: sans-serif; font-weight: normal}
-span:hover a.copiable-anchor {visibility: visible}
-ul.no-bullet {list-style: none}
+span.r {font-family: initial; font-weight: normal; font-style: normal}
+span:hover a.copiable-link {visibility: visible}
+td.printindex-index-entry {vertical-align: top}
+td.printindex-index-section {vertical-align: top}
+th.entries-header-printindex {text-align:left}
+th.sections-header-printindex {text-align:left}
+ul.mark-bullet {list-style-type: disc}
+ul.toc-numbered-mark {list-style: none}
-->
</style>
@@ -41,7 +37,6 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">A DVI-to-PNG translator</h1>
@@ -50,12 +45,12 @@
-<div class="top" id="Top">
-<div class="header">
+<div class="top-level-extent" id="Top">
+<div class="nav-panel">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="dvipng"></span><h1 class="top">dvipng</h1>
+<h1 class="top" id="dvipng">dvipng</h1>
<p>This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
@@ -62,7 +57,7 @@
</p>
<p>This file documents dvipng version 1.17
</p>
-<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
+<p>Corrections or perhaps rewrites of sections are <em class="emph">very welcome</em>.
</p>
<p>Jan-Åke Larsson
</p>
@@ -70,15 +65,15 @@
-<div class="Contents_element" id="SEC_Contents">
+<div class="element-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
-<ul class="no-bullet">
+<ul class="toc-numbered-mark">
<li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
<li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Prerequisites-1" href="#Prerequisites">2.1 Prerequisites</a></li>
<li><a id="toc-Configure-1" href="#Configure">2.2 Configure</a></li>
<li><a id="toc-Build_002finstall-1" href="#Build_002finstall">2.3 Build/install</a></li>
@@ -87,23 +82,23 @@
</ul></li>
<li><a id="toc-Basic-usage-of-dvipng" href="#Basic-usage">3 Basic usage of dvipng</a></li>
<li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">4 Command-line options</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Option-summary-1" href="#Option-summary">4.1 Option summary</a></li>
<li><a id="toc-Option-details-1" href="#Option-details">4.2 Option details</a></li>
</ul></li>
<li><a id="toc-Graphics-1" href="#Graphics">5 Graphics</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Encapsulated-PostScript-1" href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a></li>
<li><a id="toc-Bitmapped-graphics-1" href="#Bitmapped-graphics">5.2 Bitmapped graphics</a></li>
<li><a id="toc-Raw-PostScript-1" href="#Raw-PostScript">5.3 Raw PostScript</a></li>
</ul></li>
<li><a id="toc-Color-1" href="#Color">6 Color</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Color-specifications-1" href="#Color-specifications">6.1 Color specifications</a></li>
<li><a id="toc-Color-specials-1" href="#Color-specials">6.2 Color specials</a></li>
</ul></li>
<li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">7 Diagnosing problems</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Contact-information-1" href="#Contact-information">7.1 Contact information</a></li>
<li><a id="toc-Debug-options-1" href="#Debug-options">7.2 Debug options</a></li>
</ul></li>
@@ -114,12 +109,12 @@
</div>
</div>
<hr>
-<div class="chapter" id="Introduction">
-<div class="header">
+<div class="chapter-level-extent" id="Introduction">
+<div class="nav-panel">
<p>
Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
+<h2 class="chapter" id="Introduction-1">1 Introduction</h2>
@@ -128,7 +123,7 @@
from TeX and its relatives.
</p>
<p>If GIF support is enabled, GIF output is chosen by using the
-‘<samp>dvigif</samp>’ binary or with the ‘<samp>--gif</samp>’ option.
+‘<samp class="samp">dvigif</samp>’ binary or with the ‘<samp class="samp">--gif</samp>’ option.
</p>
<p>It is intended to produce anti-aliased screen-resolution images as fast
@@ -136,43 +131,43 @@
regenerate many images again and again. The primary target is the
preview-latex (X)Emacs package, a package to preview formulas from
within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs
-buffer, see <a href="http://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</a>.
+buffer, see <a class="url" href="http://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</a>.
</p>
<p>Another example is WeBWorK, an internet-based method for delivering
homework problems to students over the internet, giving students
instant feedback as to whether or not their answers are correct, see
-<a href="http://webwork.math.rochester.edu">http://webwork.math.rochester.edu</a>.
+<a class="url" href="http://webwork.math.rochester.edu">http://webwork.math.rochester.edu</a>.
</p>
<p>A more recent addition to the dvipng-using applications out there is
MediaWiki, the software behind Wikipedia and many other wikis out
there. Dvipng is used to render mathematical formulae from version
-1.8.0 of MediaWiki, see <a href="http://www.mediawiki.org">http://www.mediawiki.org</a>.
+1.8.0 of MediaWiki, see <a class="url" href="http://www.mediawiki.org">http://www.mediawiki.org</a>.
</p>
<p>Other applications may also benefit, like web applications as latex2html
and WYSIWYG editors like LyX.
</p>
-<p>The benefits of ‘<samp>dvipng</samp>’/‘<samp>dvigif</samp>’ include
+<p>The benefits of ‘<samp class="samp">dvipng</samp>’/‘<samp class="samp">dvigif</samp>’ include
</p>
-<ul>
-<li> Speed. It is a very fast bitmap-rendering code for DVI files, which
+<ul class="itemize mark-bullet">
+<li>Speed. It is a very fast bitmap-rendering code for DVI files, which
makes it suitable for generating large amounts of images on-the-fly,
as needed in preview-latex, WeBWorK and others.
-</li><li> It does not read the postamble, so it can be started before TeX
-finishes. There is a ‘<samp>--follow</samp>’ switch that makes dvipng wait at
+</li><li>It does not read the postamble, so it can be started before TeX
+finishes. There is a ‘<samp class="samp">--follow</samp>’ switch that makes dvipng wait at
end-of-file for further output, unless it finds the POST marker that
indicates the end of the DVI.
-</li><li> Interactive query of options. dvipng can read options interactively
+</li><li>Interactive query of options. dvipng can read options interactively
through stdin, and all options are usable. It is even possible to change
the input file through this interface.
-</li><li> Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts (i.e.,
+</li><li>Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts (i.e.,
as used in CJK-LaTeX), color specials, and inclusion of PostScript,
PNG, JPEG or GIF images.
-</li><li> and more...
+</li><li>and more...
</li></ul>
@@ -179,24 +174,24 @@
<hr>
</div>
-<div class="chapter" id="Installation">
-<div class="header">
+<div class="chapter-level-extent" id="Installation">
+<div class="nav-panel">
<p>
Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage of dvipng</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
+<h2 class="chapter" id="Installation-1">2 Installation</h2>
-<span id="index-configuration_002c-of-dvipng"></span>
-<span id="index-compilation"></span>
-<span id="index-installation_002c-of-dvipng"></span>
+<a class="index-entry-id" id="index-configuration_002c-of-dvipng"></a>
+<a class="index-entry-id" id="index-compilation"></a>
+<a class="index-entry-id" id="index-installation_002c-of-dvipng"></a>
-<p>Installing dvipng should be simple: merely <code>./configure</code>,
-<code>make</code>, and <code>make install</code>.
+<p>Installing dvipng should be simple: merely <code class="code">./configure</code>,
+<code class="code">make</code>, and <code class="code">make install</code>.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Prerequisites" accesskey="1">Prerequisites</a></li>
<li><a href="#Configure" accesskey="2">Configure</a></li>
<li><a href="#Build_002finstall" accesskey="3">Build/install</a></li>
@@ -204,31 +199,31 @@
<li><a href="#Advice-for-non_002dprivileged-users" accesskey="5">Installation for non-privileged users</a></li>
</ul>
<hr>
-<div class="section" id="Prerequisites">
-<div class="header">
+<div class="section-level-extent" id="Prerequisites">
+<div class="nav-panel">
<p>
Next: <a href="#Configure" accesskey="n" rel="next">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Prerequisites-1"></span><h3 class="section">2.1 Prerequisites</h3>
+<h3 class="section" id="Prerequisites-1">2.1 Prerequisites</h3>
-<ul>
-<li> The GD Graphics Draw library, libgd
+<ul class="itemize mark-bullet">
+<li>The GD Graphics Draw library, libgd
-<p>The drawing library ‘<samp>libgd</samp>’ is necessary, and is downloadable at
-<a href="https://bitbucket.org/libgd/gd-libgd/downloads">https://bitbucket.org/libgd/gd-libgd/downloads</a>, and there are
+<p>The drawing library ‘<samp class="samp">libgd</samp>’ is necessary, and is downloadable at
+<a class="uref" href="https://bitbucket.org/libgd/gd-libgd/downloads">https://bitbucket.org/libgd/gd-libgd/downloads</a>, and there are
binary packages for most operating systems from their respective
-distributors. In any case, the library installs using ‘<samp>autoconf</samp>’ so
+distributors. In any case, the library installs using ‘<samp class="samp">autoconf</samp>’ so
it should not be difficult for you to install it from source, and then
proceed with installing dvipng.
</p>
-</li><li> The path-searching library kpathsea
+</li><li>The path-searching library kpathsea
<p>Kpathsea is most likely included in your LaTeX installation, but it
may happen that ./configure does not find it; see below. If you do not
-have it, download it from <a href="http://www.ctan.org">http://www.ctan.org</a> and compile it.
+have it, download it from <a class="uref" href="http://www.ctan.org">http://www.ctan.org</a> and compile it.
I have no experience with this, so I cannot help much here.
</p>
-</li><li> The font-rendering library FreeType 2
+</li><li>The font-rendering library FreeType 2
<p>While not strictly necessary, a recent FreeType 2 is recommended since
dvipng currently will produce better-quality images when this library is
@@ -244,13 +239,13 @@
<p>Finally, it will enable subfont support in dvipng. That is, if you want
to render CJK-LaTeX characters, you must have FreeType 2 installed.
</p>
-</li><li> libpng and libz
+</li><li>libpng and libz
<p>To be able to compress and write PNG files to disk, dvipng (or really
libgd) uses libpng which in turn uses libz. These should be available on
any modern system, if not, download them and install them.
</p>
-</li><li> The <code>texinfo</code> package
+</li><li>The <code class="code">texinfo</code> package
<p>This is needed for building the documentation.
</p></li></ul>
@@ -257,68 +252,68 @@
<hr>
</div>
-<div class="section" id="Configure">
-<div class="header">
+<div class="section-level-extent" id="Configure">
+<div class="nav-panel">
<p>
Next: <a href="#Build_002finstall" accesskey="n" rel="next">Build/install</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Configure-1"></span><h3 class="section">2.2 Configure</h3>
+<h3 class="section" id="Configure-1">2.2 Configure</h3>
<p>The first step is to configure the source code, telling it where
various files will be. To do so, run
</p>
<div class="example">
-<pre class="example">./configure <var>options</var>
+<pre class="example-preformatted">./configure <var class="var">options</var>
</pre></div>
<p>(Note: if you have fetched dvipng from CVS rather than a regular
-release, you will have to first generate <samp>./configure</samp> by running
-<code>autoconf</code> 2.53 or later.)
+release, you will have to first generate <samp class="file">./configure</samp> by running
+<code class="code">autoconf</code> 2.53 or later.)
</p>
<p>On many machines, you will not need to specify any options, but if
-<code>configure</code> cannot determine something on its own, you’ll need to
+<code class="code">configure</code> cannot determine something on its own, you’ll need to
help it out. For a list of the options type
</p>
<div class="example">
-<pre class="example">./configure --help
+<pre class="example-preformatted">./configure --help
</pre></div>
<p>On some machines, the libraries will be installed in directories that
are not in the linker’s search path. This will generate an error when
-running <samp>./configure</samp>, indicating that it cannot find libgd or
+running <samp class="file">./configure</samp>, indicating that it cannot find libgd or
libkpathsea (most likely). You then need to specify the path to the
respective library’s object files. They are typically called e.g.,
-<samp>libgd.a</samp> or <samp>libgd.so</samp>. If they are located in e.g.,
-<samp>/sw/local/lib</samp>, do
+<samp class="file">libgd.a</samp> or <samp class="file">libgd.so</samp>. If they are located in e.g.,
+<samp class="file">/sw/local/lib</samp>, do
</p>
<div class="example">
-<pre class="example">./configure LDFLAGS=-L/sw/local/lib
+<pre class="example-preformatted">./configure LDFLAGS=-L/sw/local/lib
</pre></div>
-<p>If the library is available as a shared object file (<samp>.so</samp>), the
+<p>If the library is available as a shared object file (<samp class="file">.so</samp>), the
runtime linker may also need to be told where to find the library,
then use
</p>
<div class="example">
-<pre class="example">./configure LDFLAGS='-L/sw/local/lib -R/sw/local/lib'
+<pre class="example-preformatted">./configure LDFLAGS='-L/sw/local/lib -R/sw/local/lib'
</pre></div>
<p>When either of these is necessary, it is likely that the C header
files are also installed in directories that are not in the C
preprocessor’s search path. This will also generate an error when
-running <samp>./configure</samp>, indicating that it cannot find e.g.,
-<samp>gd.h</samp> or <samp>kpathsea.h</samp> (most likely). You then need to
+running <samp class="file">./configure</samp>, indicating that it cannot find e.g.,
+<samp class="file">gd.h</samp> or <samp class="file">kpathsea.h</samp> (most likely). You then need to
specify the path to the respective library’s C header files. If they
-are located in e.g., <samp>/sw/local/include</samp>, do
+are located in e.g., <samp class="file">/sw/local/include</samp>, do
</p>
<div class="example">
-<pre class="example">./configure CPPFLAGS=-I/sw/local/include
+<pre class="example-preformatted">./configure CPPFLAGS=-I/sw/local/include
</pre></div>
<p>On my SUN Solaris workstation, I had to combine this into
</p>
<div class="example">
-<pre class="example">./configure CPPFLAGS='-I/sw/local/include -I/sw/tex/teTeX/1.0/include'\
+<pre class="example-preformatted">./configure CPPFLAGS='-I/sw/local/include -I/sw/tex/teTeX/1.0/include'\
LDFLAGS='-L/sw/local/lib -R/sw/local/lib -L/sw/tex/teTeX/1.0/lib/'
</pre></div>
@@ -326,17 +321,17 @@
</p>
<hr>
</div>
-<div class="section" id="Build_002finstall">
-<div class="header">
+<div class="section-level-extent" id="Build_002finstall">
+<div class="nav-panel">
<p>
Next: <a href="#Installation-outside-the-texmf-tree" accesskey="n" rel="next">Installation outside the texmf tree</a>, Previous: <a href="#Configure" accesskey="p" rel="prev">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build_002finstall-1"></span><h3 class="section">2.3 Build/install</h3>
+<h3 class="section" id="Build_002finstall-1">2.3 Build/install</h3>
-<p>Once <samp>configure</samp> has been run, simply enter
+<p>Once <samp class="file">configure</samp> has been run, simply enter
</p>
<div class="example">
-<pre class="example">make
+<pre class="example-preformatted">make
</pre></div>
<p>at the prompt to compile the C code, and build the documentation files.
@@ -343,7 +338,7 @@
To install the files into the locations chosen earlier, type
</p>
<div class="example">
-<pre class="example">make install
+<pre class="example-preformatted">make install
</pre></div>
<p>You may need special privileges to install, e.g., if you are installing
@@ -351,44 +346,44 @@
</p>
<hr>
</div>
-<div class="section" id="Installation-outside-the-texmf-tree">
-<div class="header">
+<div class="section-level-extent" id="Installation-outside-the-texmf-tree">
+<div class="nav-panel">
<p>
Next: <a href="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Installation for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Installation-outside-the-texmf-tree-1"></span><h3 class="section">2.4 Installation outside the texmf tree</h3>
+<h3 class="section" id="Installation-outside-the-texmf-tree-1">2.4 Installation outside the texmf tree</h3>
<p>In some cases, a dvipng binary installed outside the texmf tree will
not be able to find virtual fonts, or the PostScript font maps
-(normally used by dvips). This may be because <em>only</em>
+(normally used by dvips). This may be because <em class="emph">only</em>
$SELFAUTOLOC, $SELFAUTODIR, and $SELFAUTOPARENT are used in the texmf
-tree configuration file ‘<samp>texmf.cnf</samp>’. If so, give the switch
-‘<samp>--enable-selfauto-set</samp>’ to ‘<samp>./configure</samp>’. This will make
+tree configuration file ‘<samp class="samp">texmf.cnf</samp>’. If so, give the switch
+‘<samp class="samp">--enable-selfauto-set</samp>’ to ‘<samp class="samp">./configure</samp>’. This will make
dvipng adjust these three internally so that kpathsea thinks that
-dvipng <em>is</em> installed in the texmf tree.
+dvipng <em class="emph">is</em> installed in the texmf tree.
</p>
<hr>
</div>
-<div class="section" id="Advice-for-non_002dprivileged-users">
-<div class="header">
+<div class="section-level-extent" id="Advice-for-non_002dprivileged-users">
+<div class="nav-panel">
<p>
Previous: <a href="#Installation-outside-the-texmf-tree" accesskey="p" rel="prev">Installation outside the texmf tree</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Installation-for-non_002dprivileged-users"></span><h3 class="section">2.5 Installation for non-privileged users</h3>
+<h3 class="section" id="Installation-for-non_002dprivileged-users">2.5 Installation for non-privileged users</h3>
<p>Often people without system administration privileges want to install
software for their private use. In that case you need to specify more
-options to the <samp>configure</samp> script, usually this is done by using
-the ‘<samp>--prefix</samp>’ option to the <samp>configure</samp> script, and let it
+options to the <samp class="file">configure</samp> script, usually this is done by using
+the ‘<samp class="samp">--prefix</samp>’ option to the <samp class="file">configure</samp> script, and let it
point to the personal home directory. In that way, resulting binaries
-will be installed under the <samp>bin</samp> subdirectory of your home
-directory, manual pages under <samp>man</samp> and so on. That way, it is
+will be installed under the <samp class="file">bin</samp> subdirectory of your home
+directory, manual pages under <samp class="file">man</samp> and so on. That way, it is
reasonably easy to maintain a bunch of additional packages, since the
-prefix argument is supported by most <samp>configure</samp> scripts.
+prefix argument is supported by most <samp class="file">configure</samp> scripts.
</p>
-<p>You’ll have to add something like <samp>/home/myself/bin</samp> to your
-<code>PATH</code> shell variable, if it isn’t there already, and similarly
-set the <code>INFOPATH</code> and <code>MANPATH</code> variables to be able to
+<p>You’ll have to add something like <samp class="file">/home/myself/bin</samp> to your
+<code class="code">PATH</code> shell variable, if it isn’t there already, and similarly
+set the <code class="code">INFOPATH</code> and <code class="code">MANPATH</code> variables to be able to
access the documentation.
</p>
@@ -395,25 +390,25 @@
<hr>
</div>
</div>
-<div class="chapter" id="Basic-usage">
-<div class="header">
+<div class="chapter-level-extent" id="Basic-usage">
+<div class="nav-panel">
<p>
Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Basic-usage-of-dvipng"></span><h2 class="chapter">3 Basic usage of dvipng</h2>
+<h2 class="chapter" id="Basic-usage-of-dvipng">3 Basic usage of dvipng</h2>
-<span id="index-invoking-dvipng"></span>
+<a class="index-entry-id" id="index-invoking-dvipng"></a>
<p>To use dvipng at its simplest, simply type
</p>
<div class="example">
-<pre class="example">dvipng foo
+<pre class="example-preformatted">dvipng foo
</pre></div>
-<p>where <samp>foo.dvi</samp> is the output of TeX that you want to convert to
-PNG format. If there are four pages in <samp>foo.dvi</samp>, those pages will
-be output as <samp>foo1.png</samp>, <samp>foo2.png</samp>, <samp>foo3.png</samp>, and
-<samp>foo4.png</samp>, respectively.
+<p>where <samp class="file">foo.dvi</samp> is the output of TeX that you want to convert to
+PNG format. If there are four pages in <samp class="file">foo.dvi</samp>, those pages will
+be output as <samp class="file">foo1.png</samp>, <samp class="file">foo2.png</samp>, <samp class="file">foo3.png</samp>, and
+<samp class="file">foo4.png</samp>, respectively.
</p>
<p>If you have enabled the PostScript font support (via FreeType),
fonts will be rendered as they are needed. Otherwise, dvipng will use
@@ -423,26 +418,26 @@
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 <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to
-generate fonts</a> in <cite>Kpathsea</cite>.)
+generate fonts</a> in <cite class="cite">Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
of available options, just type
</p>
<div class="example">
-<pre class="example">dvipng --help
+<pre class="example-preformatted">dvipng --help
</pre></div>
<hr>
</div>
-<div class="chapter" id="Command_002dline-options">
-<div class="header">
+<div class="chapter-level-extent" id="Command_002dline-options">
+<div class="nav-panel">
<p>
Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Command_002dline-options-1"></span><h2 class="chapter">4 Command-line options</h2>
+<h2 class="chapter" id="Command_002dline-options-1">4 Command-line options</h2>
-<span id="index-command_002dline-options"></span>
-<span id="index-options_002c-dvipng"></span>
+<a class="index-entry-id" id="index-command_002dline-options"></a>
+<a class="index-entry-id" id="index-options_002c-dvipng"></a>
<p>dvipng has a plethora of command line options. Reading through this
section will give a good idea of the capabilities of the driver.
@@ -449,24 +444,24 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Option-summary" accesskey="1">Option summary</a></li>
<li><a href="#Option-details" accesskey="2">Option details</a></li>
</ul>
<hr>
-<div class="section" id="Option-summary">
-<div class="header">
+<div class="section-level-extent" id="Option-summary">
+<div class="nav-panel">
<p>
Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Option-summary-1"></span><h3 class="section">4.1 Option summary</h3>
+<h3 class="section" id="Option-summary-1">4.1 Option summary</h3>
-<span id="index-options_002c-summary"></span>
+<a class="index-entry-id" id="index-options_002c-summary"></a>
<p>Here is a handy summary of the options; it is printed out when you run
-dvipng with no arguments or with the standard ‘<samp>--help</samp>’ option.
+dvipng with no arguments or with the standard ‘<samp class="samp">--help</samp>’ option.
</p>
<div class="example">
-<pre class="example">This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson
+<pre class="example-preformatted">This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -514,57 +509,57 @@
<hr>
</div>
-<div class="section" id="Option-details">
-<div class="header">
+<div class="section-level-extent" id="Option-details">
+<div class="nav-panel">
<p>
Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Option-details-1"></span><h3 class="section">4.2 Option details</h3>
+<h3 class="section" id="Option-details-1">4.2 Option details</h3>
-<span id="index-option_002c-details-of"></span>
+<a class="index-entry-id" id="index-option_002c-details-of"></a>
<p>Many of the parameterless options listed here can be turned off by
-suffixing the option with a zero (‘<samp>0</samp>’); for instance, to turn off
-page reversal, use ‘<samp>-r0</samp>’. Such options are marked with a trailing
-‘<samp>*</samp>’.
+suffixing the option with a zero (‘<samp class="samp">0</samp>’); for instance, to turn off
+page reversal, use ‘<samp class="samp">-r0</samp>’. Such options are marked with a trailing
+‘<samp class="samp">*</samp>’.
</p>
-<dl compact="compact">
-<dt id='index-options_002c-reading-from-standard-input'><span>‘<samp>-</samp>’<a href='#index-options_002c-reading-from-standard-input' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-standard-input_002c-reading-options-from"></span>
+<dl class="table">
+<dt id='index-options_002c-reading-from-standard-input'><span>‘<samp class="samp">-</samp>’<a class="copiable-link" href='#index-options_002c-reading-from-standard-input'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-standard-input_002c-reading-options-from"></a>
<p>Read additional options from standard input after processing the command
line.
</p>
</dd>
-<dt><span>‘<samp>--help</samp>’</span></dt>
+<dt>‘<samp class="samp">--help</samp>’</dt>
<dd><p>Print a usage message and exit.
</p>
</dd>
-<dt><span>‘<samp>--version</samp>’</span></dt>
+<dt>‘<samp class="samp">--version</samp>’</dt>
<dd><p>Print the version number and exit.
</p>
</dd>
-<dt><span>‘<samp>-bd <var>num</var></samp>’</span></dt>
-<dt><span>‘<samp>-bd <var>color_spec</var></samp>’</span></dt>
-<dt id='index-transparent-border-width'><span>‘<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>’<a href='#index-transparent-border-width' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-transparent-border-fallback-color"></span>
+<dt>‘<samp class="samp">-bd <var class="var">num</var></samp>’</dt>
+<dt>‘<samp class="samp">-bd <var class="var">color_spec</var></samp>’</dt>
+<dt id='index-transparent-border-width'><span>‘<samp class="samp">-bd '<var class="var">num</var> <var class="var">color_spec</var>'</samp>’<a class="copiable-link" href='#index-transparent-border-width'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-transparent-border-fallback-color"></a>
<p>Set the pixel width of the transparent border (default 0). Using this
option will make the image edges transparent, but it only affects pixels
-with the background color. Giving a <var>color_spec</var> will set the
+with the background color. Giving a <var class="var">color_spec</var> will set the
fallback color, to be used in viewers that cannot handle transparency
(the default is the background color). The color spec should be in
TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. Setting the
-fallback color makes the default border width 1 px. See <a href="#Color">Color</a>.
+fallback color makes the default border width 1 px. See <a class="xref" href="#Color">Color</a>.
</p>
</dd>
-<dt id='index-base-resolution_002c-setting'><span>‘<samp>--bdpi <var>num</var></samp>’<a href='#index-base-resolution_002c-setting' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-base-resolution_002c-setting'><span>‘<samp class="samp">--bdpi <var class="var">num</var></samp>’<a class="copiable-link" href='#index-base-resolution_002c-setting'> ¶</a></span></dt>
<dd><p>This option only has an effect when using bitmapped (PK) fonts. The
option sets the base (Metafont) resolution, both horizontal and
-vertical, to <var>num</var> dpi (dots per inch). This option is necessary
+vertical, to <var class="var">num</var> dpi (dots per inch). This option is necessary
when manually selecting Metafont mode with the –mode option (see
below).
</p>
</dd>
-<dt id='index-background-color-_0028option_0029'><span>‘<samp>-bg <var>color_spec</var></samp>’<a href='#index-background-color-_0028option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-background-color-_0028option_0029'><span>‘<samp class="samp">-bg <var class="var">color_spec</var></samp>’<a class="copiable-link" href='#index-background-color-_0028option_0029'> ¶</a></span></dt>
<dd><p>Choose background color for the images. This option will be ignored if
there is a background color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. You can
@@ -575,25 +570,25 @@
background with non-transparent antialiased pixels. The latter would be
suitable for viewers who cannot cope with a true alpha channel. GIF
images do not support full alpha transparency, so in case of GIF output,
-both variants will use the latter behaviour. See <a href="#Color">Color</a>.
+both variants will use the latter behaviour. See <a class="xref" href="#Color">Color</a>.
</p>
</dd>
-<dt id='index-debugging'><span>‘<samp>-d <var>num</var></samp>’<a href='#index-debugging' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-debugging'><span>‘<samp class="samp">-d <var class="var">num</var></samp>’<a class="copiable-link" href='#index-debugging'> ¶</a></span></dt>
<dd><p>Set the debug flags, showing what dvipng (thinks it) is doing. This will
-work unless dvipng has been compiled without the <code>DEBUG</code> option
-(not recommended). Set the flags as you need them, use ‘<samp>-d -1</samp>’ as
-the first option for maximum output. See <a href="#Debug-options">Debug options</a>.
+work unless dvipng has been compiled without the <code class="code">DEBUG</code> option
+(not recommended). Set the flags as you need them, use ‘<samp class="samp">-d -1</samp>’ as
+the first option for maximum output. See <a class="xref" href="#Debug-options">Debug options</a>.
</p>
</dd>
-<dt id='index-output-resolution_002c-setting'><span>‘<samp>-D <var>num</var></samp>’<a href='#index-output-resolution_002c-setting' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Set the output resolution, both horizontal and vertical, to <var>num</var>
+<dt id='index-output-resolution_002c-setting'><span>‘<samp class="samp">-D <var class="var">num</var></samp>’<a class="copiable-link" href='#index-output-resolution_002c-setting'> ¶</a></span></dt>
+<dd><p>Set the output resolution, both horizontal and vertical, to <var class="var">num</var>
dpi (dots per inch).
</p>
<p>One may want to adjust this to fit a certain text font size (e.g., on
-a web page), and for a text font height of <var>font_px</var> pixels (in
+a web page), and for a text font height of <var class="var">font_px</var> pixels (in
Mozilla) the correct formula is
</p><div class="example">
-<pre class="example"><var>dpi</var> = <var>font_px</var> * 72.27 / 10 [px * TeXpt/in / TeXpt]
+<pre class="example-preformatted"><var class="var">dpi</var> = <var class="var">font_px</var> * 72.27 / 10 [px * TeXpt/in / TeXpt]
</pre></div>
<p>The last division by ten is due to the standard font height 10pt in
your document, if you use 12pt, divide by 12. Unfortunately, some
@@ -601,52 +596,52 @@
have to rescale that to pixels, using the screen resolution (default
is usually 96 dpi) which means the formula is
</p><div class="example">
-<pre class="example"><var>font_px</var> = <var>font_pt</var> * 96 / 72 [pt * px/in / (pt/in)]
+<pre class="example-preformatted"><var class="var">font_px</var> = <var class="var">font_pt</var> * 96 / 72 [pt * px/in / (pt/in)]
</pre></div>
<p>On some high-res screens, the value is instead 120 dpi. Good luck!
</p>
</dd>
-<dt id='index-baseline-reporting'><span>‘<samp>--depth*</samp>’<a href='#index-baseline-reporting' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-depth-reporting"></span>
+<dt id='index-baseline-reporting'><span>‘<samp class="samp">--depth*</samp>’<a class="copiable-link" href='#index-baseline-reporting'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-depth-reporting"></a>
<p>Report the depth of the image. This only works reliably when the
-LaTeX style <samp>preview.sty</samp> from preview-latex is used with
-the ‘<samp>active</samp>’ option. It reports the number of pixels from the
+LaTeX style <samp class="file">preview.sty</samp> from preview-latex is used with
+the ‘<samp class="samp">active</samp>’ 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)
</p><div class="example">
-<pre class="example"><IMG SRC="<var>filename.png</var>" STYLE="vertical-align: -<var>depth</var>px">
+<pre class="example-preformatted"><IMG SRC="<var class="var">filename.png</var>" STYLE="vertical-align: -<var class="var">depth</var>px">
</pre></div>
<p>The depth is a negative offset in this case, so the minus sign is
necessary, and the unit is pixels (px).
</p>
</dd>
-<dt><span>‘<samp>--dvinum*</samp>’</span></dt>
+<dt>‘<samp class="samp">--dvinum*</samp>’</dt>
<dd><p>Set this option to make the output page number be the TeX page
-numbers rather than the physical page number. See the ‘<samp>-o</samp>’ switch.
+numbers rather than the physical page number. See the ‘<samp class="samp">-o</samp>’ switch.
</p>
</dd>
-<dt id='index-foreground-color-_0028option_0029'><span>‘<samp>-fg <var>color_spec</var></samp>’<a href='#index-foreground-color-_0028option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-foreground-color-_0028option_0029'><span>‘<samp class="samp">-fg <var class="var">color_spec</var></samp>’<a class="copiable-link" href='#index-foreground-color-_0028option_0029'> ¶</a></span></dt>
<dd><p>Choose foreground color for the images. This option will be ignored if
there is a foreground color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’.
-See <a href="#Color">Color</a>.
+See <a class="xref" href="#Color">Color</a>.
</p>
</dd>
-<dt id='index-follow-mode'><span>‘<samp>--follow*</samp>’<a href='#index-follow-mode' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-follow-mode'><span>‘<samp class="samp">--follow*</samp>’<a class="copiable-link" href='#index-follow-mode'> ¶</a></span></dt>
<dd><p>Wait for data at end-of-file. One of the benefits of dvipng is that it
does not read the postamble, so it can be started before TeX
finishes. This switch makes dvipng wait at end-of-file for further
output, unless it finds the POST marker that indicates the end of the
-DVI. This is similar to ‘<samp>tail -f</samp>’ but for DVI-to-PNG conversion.
+DVI. This is similar to ‘<samp class="samp">tail -f</samp>’ but for DVI-to-PNG conversion.
</p>
</dd>
-<dt id='index-FreeType-font-rendering'><span>‘<samp>--freetype*</samp>’<a href='#index-FreeType-font-rendering' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-FreeType-font-rendering'><span>‘<samp class="samp">--freetype*</samp>’<a class="copiable-link" href='#index-FreeType-font-rendering'> ¶</a></span></dt>
<dd><p>Enable/disable FreeType font rendering (default on). This option is
available if the FreeType2 font library was present at compilation time.
If this is the case, dvipng will have direct support for PostScript
-Type1 and TrueType fonts internally, rather than using ‘<samp>gsftopk</samp>’
+Type1 and TrueType fonts internally, rather than using ‘<samp class="samp">gsftopk</samp>’
for rendering the fonts. If you have PostScript versions of Computer
Modern installed, there will be no need to generate bitmapped (PK)
variants on disk of these. Then, you can render images at different (and
@@ -657,127 +652,127 @@
renderer and therefore can give slightly different output on each platform.
</p>
</dd>
-<dt id='index-gamma'><span>‘<samp>--gamma <var>num</var></samp>’<a href='#index-gamma' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-dark-fonts"></span>
-<span id="index-light-fonts"></span>
-<span id="index-fuzzy-images"></span>
+<dt id='index-gamma'><span>‘<samp class="samp">--gamma <var class="var">num</var></samp>’<a class="copiable-link" href='#index-gamma'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-dark-fonts"></a>
+<a class="index-entry-id" id="index-light-fonts"></a>
+<a class="index-entry-id" id="index-fuzzy-images"></a>
<p>Control the interpolation of colors in the greyscale anti-aliasing
-color palette. Default value is 1.0. For 0 < <var>num</var> < 1, the
-fonts will be lighter (more like the background), and for <var>num</var> >
+color palette. Default value is 1.0. For 0 < <var class="var">num</var> < 1, the
+fonts will be lighter (more like the background), and for <var class="var">num</var> >
1, the fonts will be darker (more like the foreground).
</p>
</dd>
-<dt id='index-GIF-image-format'><span>‘<samp>--gif*</samp>’<a href='#index-GIF-image-format' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-GIF-image-format'><span>‘<samp class="samp">--gif*</samp>’<a class="copiable-link" href='#index-GIF-image-format'> ¶</a></span></dt>
<dd><p>The images are output in the GIF format, if GIF support is enabled.
-This is the default for the ‘<samp>dvigif</samp>’ binary, which only will be
+This is the default for the ‘<samp class="samp">dvigif</samp>’ binary, which only will be
available when GIF support is enabled. GIF images are palette images
-(see the ‘<samp>--palette</samp>’ option) and does not support true alpha
-channels (see the ‘<samp>--bg</samp>’ option). See also the ‘<samp>--png</samp>’
+(see the ‘<samp class="samp">--palette</samp>’ option) and does not support true alpha
+channels (see the ‘<samp class="samp">--bg</samp>’ option). See also the ‘<samp class="samp">--png</samp>’
option.
</p>
</dd>
-<dt id='index-baseline-reporting-1'><span>‘<samp>--height*</samp>’<a href='#index-baseline-reporting-1' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-height-reporting"></span>
+<dt id='index-baseline-reporting-1'><span>‘<samp class="samp">--height*</samp>’<a class="copiable-link" href='#index-baseline-reporting-1'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-height-reporting"></a>
<p>Report the height of the image. This only works reliably when the
-LaTeX style <samp>preview.sty</samp> from preview-latex is used with
-the ‘<samp>active</samp>’ option. It reports the number of pixels from the top
+LaTeX style <samp class="file">preview.sty</samp> from preview-latex is used with
+the ‘<samp class="samp">active</samp>’ 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
-‘<samp>--height</samp>’ and ‘<samp>--depth</samp>’.
+‘<samp class="samp">--height</samp>’ and ‘<samp class="samp">--depth</samp>’.
</p>
</dd>
-<dt id='index-last-page-printed'><span>‘<samp>-l [=]<var>num</var></samp>’<a href='#index-last-page-printed' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-page_002c-last-printed"></span>
-<span id="index-physical-page-number_002c-and-_002dl"></span>
-<span id="index-absolute-page-number_002c-and-_002dl"></span>
-<p>The last page printed will be the first one numbered <var>num</var>. Default
-is the last page in the document. If <var>num</var> is prefixed by an equals
-sign, then it (and the argument to the ‘<samp>-p</samp>’ option, if specified)
+<dt id='index-last-page-printed'><span>‘<samp class="samp">-l [=]<var class="var">num</var></samp>’<a class="copiable-link" href='#index-last-page-printed'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-page_002c-last-printed"></a>
+<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dl"></a>
+<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dl"></a>
+<p>The last page printed will be the first one numbered <var class="var">num</var>. Default
+is the last page in the document. If <var class="var">num</var> is prefixed by an equals
+sign, then it (and the argument to the ‘<samp class="samp">-p</samp>’ option, if specified)
is treated as a physical (absolute) page number, rather than a value to
-compare with the TeX ‘<samp>\count0</samp>’ values stored in the DVI file.
-Thus, using ‘<samp>-l =9</samp>’ will end with the ninth page of the document,
+compare with the TeX ‘<samp class="samp">\count0</samp>’ values stored in the DVI file.
+Thus, using ‘<samp class="samp">-l =9</samp>’ will end with the ninth page of the document,
no matter what the pages are actually numbered.
</p>
</dd>
-<dt id='index-mode-name_002c-specifying'><span>‘<samp>--mode <var>mode</var></samp>’<a href='#index-mode-name_002c-specifying' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-Metafont-mode_002c-specifying"></span>
+<dt id='index-mode-name_002c-specifying'><span>‘<samp class="samp">--mode <var class="var">mode</var></samp>’<a class="copiable-link" href='#index-mode-name_002c-specifying'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-Metafont-mode_002c-specifying"></a>
<p>This option only has an effect when using bitmapped (PK) fonts. Use
-<var>mode</var> as the Metafont device name for the PK fonts (both for path
+<var class="var">mode</var> as the Metafont device name for the PK fonts (both for path
searching and font generation). This needs to be augmented with the base
-device resolution, given with the ‘<samp>--bdpi</samp>’ option. See the file
-<a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
-names for most devices. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+device resolution, given with the ‘<samp class="samp">--bdpi</samp>’ option. See the file
+<a class="url" href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
+names for most devices. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite class="cite">Kpathsea</cite>.
</p>
</dd>
-<dt id='index-font-generation_002c-avoiding'><span>‘<samp>-M*</samp>’<a href='#index-font-generation_002c-avoiding' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-mktexpk_002c-avoiding"></span>
+<dt id='index-font-generation_002c-avoiding'><span>‘<samp class="samp">-M*</samp>’<a class="copiable-link" href='#index-font-generation_002c-avoiding'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-mktexpk_002c-avoiding"></a>
<p>This option only has an effect when using bitmapped (PK) fonts. It turns
-off automatic PK font generation (<samp>mktexpk</samp>).
+off automatic PK font generation (<samp class="file">mktexpk</samp>).
</p>
</dd>
-<dt id='index-GhostScript_002c-turning-off'><span>‘<samp>--nogs*</samp>’<a href='#index-GhostScript_002c-turning-off' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-GhostScript_002c-turning-off'><span>‘<samp class="samp">--nogs*</samp>’<a class="copiable-link" href='#index-GhostScript_002c-turning-off'> ¶</a></span></dt>
<dd><p>This switch prohibits the internal call to GhostScript for displaying
-PostScript specials. ‘<samp>--nogs0</samp>’ turns the call back on.
+PostScript specials. ‘<samp class="samp">--nogs0</samp>’ turns the call back on.
</p>
</dd>
-<dt id='index-GhostScript-and-_002ddSAFER'><span>‘<samp>--nogssafer*</samp>’<a href='#index-GhostScript-and-_002ddSAFER' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-_002ddSAFER"></span>
+<dt id='index-GhostScript-and-_002ddSAFER'><span>‘<samp class="samp">--nogssafer*</samp>’<a class="copiable-link" href='#index-GhostScript-and-_002ddSAFER'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ddSAFER"></a>
<p>Normally, if GhostScript is used to render PostScript specials, the
-GhostScript interpreter is run with the option ‘<samp>-dSAFER</samp>’. The
-‘<samp>--nogssafer</samp>’ option runs GhostScript without ‘<samp>-dSAFER</samp>’. The
-‘<samp>-dSAFER</samp>’ option in Ghostscript disables PostScript operators such
+GhostScript interpreter is run with the option ‘<samp class="samp">-dSAFER</samp>’. The
+‘<samp class="samp">--nogssafer</samp>’ option runs GhostScript without ‘<samp class="samp">-dSAFER</samp>’. The
+‘<samp class="samp">-dSAFER</samp>’ option in Ghostscript disables PostScript operators such
as deletefile, to prevent possibly malicious PostScript programs from
having any effect.
</p>
</dd>
-<dt id='index-PostScript_002c-turning-off-raw-PostScript-specials'><span>‘<samp>--norawps*</samp>’<a href='#index-PostScript_002c-turning-off-raw-PostScript-specials' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-PostScript_002c-turning-off-raw-PostScript-specials'><span>‘<samp class="samp">--norawps*</samp>’<a class="copiable-link" href='#index-PostScript_002c-turning-off-raw-PostScript-specials'> ¶</a></span></dt>
<dd><p>Some packages generate raw PostScript specials, even non-rendering such
specials. This switch turns off the internal call to GhostScript
-intended to display these raw PostScript specials. ‘<samp>--norawps0</samp>’
+intended to display these raw PostScript specials. ‘<samp class="samp">--norawps0</samp>’
turns the call back on.
</p>
</dd>
-<dt id='index-output_002c-redirecting'><span>‘<samp>-o <var>name</var></samp>’<a href='#index-output_002c-redirecting' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-standard-output_002c-output-to"></span>
-<p>Send output to the file <var>name</var>. A single occurrence of ‘<samp>%d</samp>’ or
-‘<samp>%01d</samp>’, …, ‘<samp>%09d</samp>’ will be exchanged for the physical
-page number (this can be changed, see the ‘<samp>--dvinum</samp>’ switch). The
-default output filename is ‘<samp><var>file</var>%d.png</samp>’ where the input DVI
-file was ‘<samp><var>file</var>.dvi</samp>’.
+<dt id='index-output_002c-redirecting'><span>‘<samp class="samp">-o <var class="var">name</var></samp>’<a class="copiable-link" href='#index-output_002c-redirecting'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-standard-output_002c-output-to"></a>
+<p>Send output to the file <var class="var">name</var>. A single occurrence of ‘<samp class="samp">%d</samp>’ or
+‘<samp class="samp">%01d</samp>’, …, ‘<samp class="samp">%09d</samp>’ will be exchanged for the physical
+page number (this can be changed, see the ‘<samp class="samp">--dvinum</samp>’ switch). The
+default output filename is ‘<samp class="samp"><var class="var">file</var>%d.png</samp>’ where the input DVI
+file was ‘<samp class="samp"><var class="var">file</var>.dvi</samp>’.
</p>
</dd>
-<dt id='index-offset-pages'><span>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’<a href='#index-offset-pages' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
-pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’.
+<dt id='index-offset-pages'><span>‘<samp class="samp">-O <var class="var">x-offset</var>,<var class="var">y-offset</var></samp>’<a class="copiable-link" href='#index-offset-pages'> ¶</a></span></dt>
+<dd><p>Move the origin by <var class="var">x-offset</var>,<var class="var">y-offset</var>, a comma-separated
+pair of dimensions such as ‘<samp class="samp">.1in,-.3cm</samp>’.
The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
the paper) by this amount.
</p>
</dd>
-<dt id='index-first-page-printed'><span>‘<samp>-p [=]<var>num</var></samp>’<a href='#index-first-page-printed' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-page_002c-first-printed"></span>
-<span id="index-physical-page-number_002c-and-_002dp"></span>
-<span id="index-absolute-page-number_002c-and-_002dp"></span>
-<p>The first page printed will be the first one numbered <var>num</var>. Default
-is the first page in the document. If <var>num</var> is prefixed by an
-equals sign, then it (and the argument to the ‘<samp>-l</samp>’ option, if
+<dt id='index-first-page-printed'><span>‘<samp class="samp">-p [=]<var class="var">num</var></samp>’<a class="copiable-link" href='#index-first-page-printed'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-page_002c-first-printed"></a>
+<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dp"></a>
+<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dp"></a>
+<p>The first page printed will be the first one numbered <var class="var">num</var>. Default
+is the first page in the document. If <var class="var">num</var> is prefixed by an
+equals sign, then it (and the argument to the ‘<samp class="samp">-l</samp>’ option, if
specified) is treated as a physical (absolute) page number, rather than
-a value to compare with the TeX ‘<samp>\count0</samp>’ values stored in the
-DVI file. Thus, using ‘<samp>-p =3</samp>’ will start with the third page of
+a value to compare with the TeX ‘<samp class="samp">\count0</samp>’ values stored in the
+DVI file. Thus, using ‘<samp class="samp">-p =3</samp>’ will start with the third page of
the document, no matter what the pages are actually numbered.
</p>
</dd>
-<dt id='index-forcing-palette-output'><span>‘<samp>--palette*</samp>’<a href='#index-forcing-palette-output' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>When an external image is included, ‘<samp>dvipng</samp>’ will automatically
+<dt id='index-forcing-palette-output'><span>‘<samp class="samp">--palette*</samp>’<a class="copiable-link" href='#index-forcing-palette-output'> ¶</a></span></dt>
+<dd><p>When an external image is included, ‘<samp class="samp">dvipng</samp>’ will automatically
switch to truecolor mode, to avoid unnecessary delay and quality
reduction, and enable the EPS translator to draw on a transparent
background and outside of the boundingbox. This switch will force
-palette (256-color) output and make ‘<samp>dvipng</samp>’ revert to opaque
-clipped image inclusion. This will also override the ‘<samp>--truecolor</samp>’
+palette (256-color) output and make ‘<samp class="samp">dvipng</samp>’ revert to opaque
+clipped image inclusion. This will also override the ‘<samp class="samp">--truecolor</samp>’
switch if present.
</p>
</dd>
-<dt id='index-no-erroneous-images'><span>‘<samp>--picky*</samp>’<a href='#index-no-erroneous-images' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-no-erroneous-images'><span>‘<samp class="samp">--picky*</samp>’<a class="copiable-link" href='#index-no-erroneous-images'> ¶</a></span></dt>
<dd><p>No images are output when a warning occurs. Normally, dvipng will
output an image in spite of a warning, but there may be something
missing in this image. One reason to use this option would be if you
@@ -787,108 +782,108 @@
missing PK fonts.
</p>
</dd>
-<dt id='index-PNG-image-format'><span>‘<samp>--png*</samp>’<a href='#index-PNG-image-format' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-PNG-image-format'><span>‘<samp class="samp">--png*</samp>’<a class="copiable-link" href='#index-PNG-image-format'> ¶</a></span></dt>
<dd><p>The images are output in the PNG format. This is the default for the
-‘<samp>dvipng</samp>’ binary. See also the ‘<samp>--gif</samp>’ option.
+‘<samp class="samp">dvipng</samp>’ binary. See also the ‘<samp class="samp">--gif</samp>’ option.
</p>
</dd>
-<dt id='index-page-range'><span>‘<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>’<a href='#index-page-range' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
-equivalent to ‘<samp>-p <var>firstpage</var> -l <var>lastpage</var></samp>’. For example,
+<dt id='index-page-range'><span>‘<samp class="samp">-pp <var class="var">firstpage</var>-<var class="var">lastpage</var></samp>’<a class="copiable-link" href='#index-page-range'> ¶</a></span></dt>
+<dd><p>Print pages <var class="var">firstpage</var> through <var class="var">lastpage</var>; but not quite
+equivalent to ‘<samp class="samp">-p <var class="var">firstpage</var> -l <var class="var">lastpage</var></samp>’. For example,
when rendering a book, there may be several instances of a page in the
-DVI file (one in <code>\frontmatter</code>, one in <code>\mainmatter</code>, and one
-in <code>\backmatter</code>). In case of several pages matching, ‘<samp>-pp
-<var>firstpage</var>-<var>lastpage</var></samp>’ will render <em>all</em> pages that
-matches the specified range, while ‘<samp>-p <var>firstpage</var> -l
-<var>lastpage</var></samp>’ will render the pages from the <em>first</em> occurrence
-of <var>firstpage</var> to the <em>first</em> occurrence of <var>lastpage</var>.
+DVI file (one in <code class="code">\frontmatter</code>, one in <code class="code">\mainmatter</code>, and one
+in <code class="code">\backmatter</code>). In case of several pages matching, ‘<samp class="samp">-pp
+<var class="var">firstpage</var>-<var class="var">lastpage</var></samp>’ will render <em class="emph">all</em> pages that
+matches the specified range, while ‘<samp class="samp">-p <var class="var">firstpage</var> -l
+<var class="var">lastpage</var></samp>’ will render the pages from the <em class="emph">first</em> occurrence
+of <var class="var">firstpage</var> to the <em class="emph">first</em> occurrence of <var class="var">lastpage</var>.
This is the (undocumented) behaviour of dvips. In dvipng you can give
both kinds of options, in which case you get all pages that matches the
-range in ‘<samp>-pp</samp>’ between the pages from ‘<samp>-p</samp>’ to ‘<samp>-l</samp>’. Also
-multiple ‘<samp>-pp</samp>’ options accumulate, unlike ‘<samp>-p</samp>’ and ‘<samp>-l</samp>’.
-The ‘<samp>-</samp>’ separator can also be ‘<samp>:</samp>’. Note that ‘<samp>-pp -1</samp>’
+range in ‘<samp class="samp">-pp</samp>’ between the pages from ‘<samp class="samp">-p</samp>’ to ‘<samp class="samp">-l</samp>’. Also
+multiple ‘<samp class="samp">-pp</samp>’ options accumulate, unlike ‘<samp class="samp">-p</samp>’ and ‘<samp class="samp">-l</samp>’.
+The ‘<samp class="samp">-</samp>’ separator can also be ‘<samp class="samp">:</samp>’. Note that ‘<samp class="samp">-pp -1</samp>’
will be interpreted as "all pages up to and including 1", if you want a
-page numbered -1 (only the table of contents, say) put ‘<samp>-pp -1--1</samp>’,
-or more readable, ‘<samp>-pp -1:-1</samp>’.
+page numbered -1 (only the table of contents, say) put ‘<samp class="samp">-pp -1--1</samp>’,
+or more readable, ‘<samp class="samp">-pp -1:-1</samp>’.
</p>
</dd>
-<dt id='index-quiet-operation'><span>‘<samp>-q*</samp>’<a href='#index-quiet-operation' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-silent-operation"></span>
-<span id="index-warnings_002c-suppressing"></span>
+<dt id='index-quiet-operation'><span>‘<samp class="samp">-q*</samp>’<a class="copiable-link" href='#index-quiet-operation'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-silent-operation"></a>
+<a class="index-entry-id" id="index-warnings_002c-suppressing"></a>
<p>Run quietly. Don’t chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
</p>
</dd>
-<dt id='index-antialiasing-levels_002c-number-of'><span>‘<samp>-Q <var>num</var></samp>’<a href='#index-antialiasing-levels_002c-number-of' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-quality"></span>
-<p>Set the quality to <var>num</var>. That is, choose the number of antialiasing
+<dt id='index-antialiasing-levels_002c-number-of'><span>‘<samp class="samp">-Q <var class="var">num</var></samp>’<a class="copiable-link" href='#index-antialiasing-levels_002c-number-of'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-quality"></a>
+<p>Set the quality to <var class="var">num</var>. That is, choose the number of antialiasing
levels for bitmapped fonts (PK), to be
-<var>num</var>*<var>num</var>+1. The default value is 4 which gives 17 levels of
+<var class="var">num</var>*<var class="var">num</var>+1. The default value is 4 which gives 17 levels of
antialiasing for antialiased fonts from these two. If FreeType is
available, its rendering is unaffected by this option.
</p>
</dd>
-<dt id='index-reverse-pagination'><span>‘<samp>-r*</samp>’<a href='#index-reverse-pagination' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-reverse-pagination'><span>‘<samp class="samp">-r*</samp>’<a class="copiable-link" href='#index-reverse-pagination'> ¶</a></span></dt>
<dd><p>Toggle output of pages in reverse/forward order. By default, the first
page in the DVI is output first.
</p>
</dd>
-<dt id='index-exit-on-erroneous-images'><span>‘<samp>--strict*</samp>’<a href='#index-exit-on-erroneous-images' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-exit-on-erroneous-images'><span>‘<samp class="samp">--strict*</samp>’<a class="copiable-link" href='#index-exit-on-erroneous-images'> ¶</a></span></dt>
<dd><p>The program exits when a warning occurs. Normally, dvipng will output
an image in spite of a warning, but there may be something missing in
this image. One reason to use this option would be if you have a more
-complete but slower fallback converter. See the ‘<samp>--picky</samp>’ option
+complete but slower fallback converter. See the ‘<samp class="samp">--picky</samp>’ option
above for a list of when warnings occur.
</p>
</dd>
-<dt><span>‘<samp>-T <var>image_size</var></samp>’</span></dt>
-<dd><p>Set the image size to <var>image_size</var> which can be either of
-‘<samp>bbox</samp>’, ‘<samp>tight</samp>’, or a comma-separated pair of dimensions
-<var>hsize</var>,<var>vsize</var> such as ‘<samp>.1in,.3cm</samp>’. The default is
-‘<samp>bbox</samp>’ which produces a PNG that includes all ink put on the page
+<dt>‘<samp class="samp">-T <var class="var">image_size</var></samp>’</dt>
+<dd><p>Set the image size to <var class="var">image_size</var> which can be either of
+‘<samp class="samp">bbox</samp>’, ‘<samp class="samp">tight</samp>’, or a comma-separated pair of dimensions
+<var class="var">hsize</var>,<var class="var">vsize</var> such as ‘<samp class="samp">.1in,.3cm</samp>’. The default is
+‘<samp class="samp">bbox</samp>’ which produces a PNG that includes all ink put on the page
and in addition the DVI origin, located 1in from the top and 1in from
the left edge of the paper. This usually gives whitespace above and to
-the left in the produced image. The value ‘<samp>tight</samp>’ will make dvipng
+the left in the produced image. The value ‘<samp class="samp">tight</samp>’ will make dvipng
only include all ink put on the page, producing neat images.
</p>
</dd>
-<dt id='index-truecolor-output'><span>‘<samp>--truecolor*</samp>’<a href='#index-truecolor-output' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>This will make ‘<samp>dvipng</samp>’ generate truecolor output. Note that
+<dt id='index-truecolor-output'><span>‘<samp class="samp">--truecolor*</samp>’<a class="copiable-link" href='#index-truecolor-output'> ¶</a></span></dt>
+<dd><p>This will make ‘<samp class="samp">dvipng</samp>’ generate truecolor output. Note that
truecolor output is automatic if you include an external image in your
-DVI, e.g., via a PostScript special (i.e., the ‘<samp>graphics</samp>’ or
-‘<samp>graphicx</samp>’ package). This switch is overridden by the
-‘<samp>--palette</samp>’ switch.
+DVI, e.g., via a PostScript special (i.e., the ‘<samp class="samp">graphics</samp>’ or
+‘<samp class="samp">graphicx</samp>’ package). This switch is overridden by the
+‘<samp class="samp">--palette</samp>’ switch.
</p>
</dd>
-<dt><span>‘<samp>-v*</samp>’</span></dt>
+<dt>‘<samp class="samp">-v*</samp>’</dt>
<dd><p>Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
</p>
</dd>
-<dt id='index-width-reporting'><span>‘<samp>--width*</samp>’<a href='#index-width-reporting' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Report the width of the image. See also ‘<samp>--height</samp>’ and
-‘<samp>--depth</samp>’.
+<dt id='index-width-reporting'><span>‘<samp class="samp">--width*</samp>’<a class="copiable-link" href='#index-width-reporting'> ¶</a></span></dt>
+<dd><p>Report the width of the image. See also ‘<samp class="samp">--height</samp>’ and
+‘<samp class="samp">--depth</samp>’.
</p>
</dd>
-<dt id='index-magnification_002c-overriding-DVI'><span>‘<samp>-x <var>num</var></samp>’<a href='#index-magnification_002c-overriding-DVI' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-magnification_002c-overriding-DVI'><span>‘<samp class="samp">-x <var class="var">num</var></samp>’<a class="copiable-link" href='#index-magnification_002c-overriding-DVI'> ¶</a></span></dt>
<dd><p>This option is deprecated; it should not be used. It is much better to
-select the output resolution directly with the ‘<samp>-D</samp>’ option. This
-option sets the magnification ratio to <em class='math'><var>num</var>/1000</em> and
+select the output resolution directly with the ‘<samp class="samp">-D</samp>’ option. This
+option sets the magnification ratio to <em class="math"><var class="var">num</var>/1000</em> and
overrides the magnification specified in the DVI file. Must be between
10 and 100000. It is recommended that you use standard magstep values
(1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the
-total number of PK files generated. <var>num</var> may be a real number, not
+total number of PK files generated. <var class="var">num</var> may be a real number, not
an integer, for increased precision.
</p>
</dd>
-<dt id='index-compression'><span>‘<samp>-z <var>num</var></samp>’<a href='#index-compression' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Set the PNG compression level to <var>num</var>. This option is enabled if
-your ‘<samp>libgd</samp>’ is new enough. The default compression level is 1,
+<dt id='index-compression'><span>‘<samp class="samp">-z <var class="var">num</var></samp>’<a class="copiable-link" href='#index-compression'> ¶</a></span></dt>
+<dd><p>Set the PNG compression level to <var class="var">num</var>. This option is enabled if
+your ‘<samp class="samp">libgd</samp>’ is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
-older ‘<samp>libgd</samp>’, the hard-soldered value 5 is used. The include file
-‘<samp>png.h</samp>’ says
-</p><blockquote>
+older ‘<samp class="samp">libgd</samp>’, the hard-soldered value 5 is used. The include file
+‘<samp class="samp">png.h</samp>’ says
+</p><blockquote class="quotation">
<p>Currently, valid values range from 0 - 9, corresponding directly to the
zlib compression levels 0 - 9 (0 - no compression, 9 - "maximal"
compression). Note that tests have shown that zlib compression levels
@@ -902,34 +897,34 @@
<hr>
</div>
</div>
-<div class="chapter" id="Graphics">
-<div class="header">
+<div class="chapter-level-extent" id="Graphics">
+<div class="nav-panel">
<p>
Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Graphics-1"></span><h2 class="chapter">5 Graphics</h2>
+<h2 class="chapter" id="Graphics-1">5 Graphics</h2>
-<p>‘<samp>dvipng</samp>’ attempts to handle graphics as included by the
-‘<samp>graphicx</samp>’ and ‘<samp>graphics</samp>’ packages, without the need of
+<p>‘<samp class="samp">dvipng</samp>’ attempts to handle graphics as included by the
+‘<samp class="samp">graphicx</samp>’ and ‘<samp class="samp">graphics</samp>’ packages, without the need of
specifying a driver to these packages. This means that it recognizes
-the encapsulated postscript inclusion meant for ‘<samp>dvips</samp>’, but is
+the encapsulated postscript inclusion meant for ‘<samp class="samp">dvips</samp>’, but is
also able (from version 1.8) to include bitmapped graphics. It also
tries to handle some of the raw PostScript that is output from various
packages. Some of the possibilities and problems are mentioned below.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></li>
<li><a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></li>
<li><a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></li>
</ul>
<hr>
-<div class="section" id="Encapsulated-PostScript">
-<div class="header">
+<div class="section-level-extent" id="Encapsulated-PostScript">
+<div class="nav-panel">
<p>
Next: <a href="#Bitmapped-graphics" accesskey="n" rel="next">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Encapsulated-PostScript-1"></span><h3 class="section">5.1 Encapsulated PostScript</h3>
+<h3 class="section" id="Encapsulated-PostScript-1">5.1 Encapsulated PostScript</h3>
<p>When an EPS file is included, a call to GhostScript is performed to
produce a bitmapped image that can be included. The default is to
@@ -939,43 +934,43 @@
is done. The included image will be a truecolor image, so for maximum
performance the output PNG will be in truecolor mode as well.
</p>
-<p>This conversion needs the ‘<samp>pngalpha</samp>’ output device to be present
+<p>This conversion needs the ‘<samp class="samp">pngalpha</samp>’ output device to be present
in your copy of GhostScript. If that device is not present, or you use
-the ‘<samp>--palette</samp>’ switch or request GIF output, the fallback is to
-use the ‘<samp>png16m</samp>’ device to produce a cropped opaque image for
-inclusion. Other relevant switches are ‘<samp>--noghostscript</samp>’ and
-‘<samp>--nogssafer</samp>’. See <a href="#Option-details">Option details</a>.
+the ‘<samp class="samp">--palette</samp>’ switch or request GIF output, the fallback is to
+use the ‘<samp class="samp">png16m</samp>’ device to produce a cropped opaque image for
+inclusion. Other relevant switches are ‘<samp class="samp">--noghostscript</samp>’ and
+‘<samp class="samp">--nogssafer</samp>’. See <a class="xref" href="#Option-details">Option details</a>.
</p>
-<span id="index-PostScript-inclusion-problems"></span>
+<a class="index-entry-id" id="index-PostScript-inclusion-problems"></a>
<p>The most common problem with including graphics is an incorrect
bounding box. Complain to whoever wrote the software that generated
the file if the bounding box is indeed incorrect. An adjusted
-boundingbox can be specified in the ‘<samp>\includegraphics</samp>’ call, as
-in this example (using ‘<samp>graphicx</samp>’):
+boundingbox can be specified in the ‘<samp class="samp">\includegraphics</samp>’ call, as
+in this example (using ‘<samp class="samp">graphicx</samp>’):
</p>
<div class="example">
-<pre class="example">\includegraphics[bb=10 20 100 200]{imagename.eps}
+<pre class="example-preformatted">\includegraphics[bb=10 20 100 200]{imagename.eps}
</pre></div>
<hr>
</div>
-<div class="section" id="Bitmapped-graphics">
-<div class="header">
+<div class="section-level-extent" id="Bitmapped-graphics">
+<div class="nav-panel">
<p>
Next: <a href="#Raw-PostScript" accesskey="n" rel="next">Raw PostScript</a>, Previous: <a href="#Encapsulated-PostScript" accesskey="p" rel="prev">Encapsulated PostScript</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Bitmapped-graphics-1"></span><h3 class="section">5.2 Bitmapped graphics</h3>
+<h3 class="section" id="Bitmapped-graphics-1">5.2 Bitmapped graphics</h3>
<p>dvipng can include PNG, JPEG and GIF graphics. When including such
-images via ‘<samp>\includegraphics</samp>’ you need to specify the bounding
+images via ‘<samp class="samp">\includegraphics</samp>’ you need to specify the bounding
box since TeX itself cannot read them from the files in question.
-The bounding box size should be given as ‘<samp>0 0 w h</samp>’ in pixels,
-e.g., if the file ‘<samp>imagename.png</samp>’ is 300x400 pixels, the
+The bounding box size should be given as ‘<samp class="samp">0 0 w h</samp>’ in pixels,
+e.g., if the file ‘<samp class="samp">imagename.png</samp>’ is 300x400 pixels, the
inclusion would read
</p>
<div class="example">
-<pre class="example">\includegraphics[bb=0 0 300 400]{imagename.png}
+<pre class="example-preformatted">\includegraphics[bb=0 0 300 400]{imagename.png}
</pre></div>
<p>The default size is the image size in bp (“big points” in TeX
@@ -991,30 +986,30 @@
wide:
</p>
<div class="example">
-<pre class="example">\includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png}
+<pre class="example-preformatted">\includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png}
</pre></div>
<hr>
</div>
-<div class="section" id="Raw-PostScript">
-<div class="header">
+<div class="section-level-extent" id="Raw-PostScript">
+<div class="nav-panel">
<p>
Previous: <a href="#Bitmapped-graphics" accesskey="p" rel="prev">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Raw-PostScript-1"></span><h3 class="section">5.3 Raw PostScript</h3>
+<h3 class="section" id="Raw-PostScript-1">5.3 Raw PostScript</h3>
<p>dvipng attempts to handle raw PostScript. Rendering raw PostScript
specials is done on top of the page by including a transparent image
-generated by the ‘<samp>pngalpha</samp>’ device in GhostScript (automatically
-selecting ‘<samp>truecolor</samp>’ mode in dvipng).
+generated by the ‘<samp class="samp">pngalpha</samp>’ device in GhostScript (automatically
+selecting ‘<samp class="samp">truecolor</samp>’ mode in dvipng).
</p>
<p>Included PostScript headers are respected, and if the header
-‘<samp>tex.pro</samp>’ is included, dvipng also throws in ‘<samp>color.pro</samp>’ and
-‘<samp>special.pro</samp>’. The package ‘<samp>xcolor</samp>’ includes its own headers
+‘<samp class="samp">tex.pro</samp>’ is included, dvipng also throws in ‘<samp class="samp">color.pro</samp>’ and
+‘<samp class="samp">special.pro</samp>’. The package ‘<samp class="samp">xcolor</samp>’ includes its own headers
with color names, and this is not only kept as a PostScript header, but
is also read and interpreted by dvipng itself. An attempt is also made
to respect the PGF header. The non-rendering specials from
-‘<samp>hyperref</samp>’ are handled via some heuristics and do not give an
+‘<samp class="samp">hyperref</samp>’ are handled via some heuristics and do not give an
error.
</p>
<p>Really rendering and moving things with raw PostScript specials is more
@@ -1026,7 +1021,7 @@
specials output by PGF (tikz), and also PSTricks. Some things work, but
others do not. This is especially clear when mixing PostScript and DVI
rendering commands such as glyphs. dvipng cannot at present detect if
-PostScript code moves ‘<samp>currentpoint</samp>’ or rotates the frame since
+PostScript code moves ‘<samp class="samp">currentpoint</samp>’ or rotates the frame since
GhostScript does not return such information. A recommendation would be
to produce images from these packages as EPS files and include them into
your document in the standard manner.
@@ -1033,92 +1028,92 @@
</p>
<p>Another way to handle this would be to use a slower fallback (with dvips
and gs, for example). If you want to disable raw PostScript handling in
-dvipng, use the switch ‘<samp>--norawps</samp>’. This switch turns off the
+dvipng, use the switch ‘<samp class="samp">--norawps</samp>’. This switch turns off the
internal call to GhostScript intended to display these raw PostScript
specials. Further, when dvipng encounters raw PostScript and the gs call
is turned off, it gives a warning. It is now possible to use the switch
-‘<samp>--picky</samp>’ to disable page rendering of pages with warnings, and use
+‘<samp class="samp">--picky</samp>’ to disable page rendering of pages with warnings, and use
the slower fallback for these pages.
</p>
<hr>
</div>
</div>
-<div class="chapter" id="Color">
-<div class="header">
+<div class="chapter-level-extent" id="Color">
+<div class="nav-panel">
<p>
Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-1"></span><h2 class="chapter">6 Color</h2>
+<h2 class="chapter" id="Color-1">6 Color</h2>
<p>To support color, dvipng recognizes a certain set of specials as
-generated by the ‘<samp>color</samp>’ and ‘<samp>xcolor</samp>’ style files. These
-specials start with the keyword ‘<samp>color</samp>’ or the keyword
-‘<samp>background</samp>’, followed by a color specification.
+generated by the ‘<samp class="samp">color</samp>’ and ‘<samp class="samp">xcolor</samp>’ style files. These
+specials start with the keyword ‘<samp class="samp">color</samp>’ or the keyword
+‘<samp class="samp">background</samp>’, followed by a color specification.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li>
<li><a href="#Color-specials" accesskey="2">Color specials</a></li>
</ul>
<hr>
-<div class="section" id="Color-specifications">
-<div class="header">
+<div class="section-level-extent" id="Color-specifications">
+<div class="nav-panel">
<p>
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-specifications-1"></span><h3 class="section">6.1 Color specifications</h3>
+<h3 class="section" id="Color-specifications-1">6.1 Color specifications</h3>
-<span id="index-color-specifications"></span>
+<a class="index-entry-id" id="index-color-specifications"></a>
<p>The color specification supported by dvipng is by-value or by-name. The
-by-value spec starts with the name of a color model (one of ‘<samp>rgb</samp>’,
-‘<samp>hsb</samp>’, ‘<samp>cmy</samp>’, ‘<samp>cmyk</samp>’, or ‘<samp>gray</samp>’) followed by the
+by-value spec starts with the name of a color model (one of ‘<samp class="samp">rgb</samp>’,
+‘<samp class="samp">hsb</samp>’, ‘<samp class="samp">cmy</samp>’, ‘<samp class="samp">cmyk</samp>’, or ‘<samp class="samp">gray</samp>’) followed by the
appropriate number of parameters. Thus, the color specification
-‘<samp>rgb 0.3 0.4 0.5</samp>’ would correspond to the color that is ‘<samp>0.3
+‘<samp class="samp">rgb 0.3 0.4 0.5</samp>’ would correspond to the color that is ‘<samp class="samp">0.3
0.4 0.5</samp>’ in its red, blue and green values. The color model used
-internally in dvipng is ‘<samp>RGB</samp>’ (discretized to 256 levels), for
-details on the formulas used in conversion, see the ‘<samp>xcolor</samp>’
+internally in dvipng is ‘<samp class="samp">RGB</samp>’ (discretized to 256 levels), for
+details on the formulas used in conversion, see the ‘<samp class="samp">xcolor</samp>’
documentation.
</p>
<p>By-name color specifications are single (case-dependent) words and are
-compared with color names defined in ‘<samp>dvipsnam.def</samp>’ (from the
-‘<samp>graphics</samp>’ bundle), ‘<samp>svgnam.def</samp>’ and ‘<samp>xcolor.sty</samp>’ (from
-the ‘<samp>xcolor</samp>’ bundle). See the ‘<samp>xcolor</samp>’ documentation for a
+compared with color names defined in ‘<samp class="samp">dvipsnam.def</samp>’ (from the
+‘<samp class="samp">graphics</samp>’ bundle), ‘<samp class="samp">svgnam.def</samp>’ and ‘<samp class="samp">xcolor.sty</samp>’ (from
+the ‘<samp class="samp">xcolor</samp>’ bundle). See the ‘<samp class="samp">xcolor</samp>’ documentation for a
list of names and the corresponding colors.
</p>
-<p>On the command-line, the name ‘<samp>Transparent</samp>’ can also be used as
-an argument to ‘<samp>--bg</samp>’ to choose transparent background.
-See <a href="#Option-details">Option details</a>.
+<p>On the command-line, the name ‘<samp class="samp">Transparent</samp>’ can also be used as
+an argument to ‘<samp class="samp">--bg</samp>’ to choose transparent background.
+See <a class="xref" href="#Option-details">Option details</a>.
</p>
<hr>
</div>
-<div class="section" id="Color-specials">
-<div class="header">
+<div class="section-level-extent" id="Color-specials">
+<div class="nav-panel">
<p>
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-specials-1"></span><h3 class="section">6.2 Color specials</h3>
+<h3 class="section" id="Color-specials-1">6.2 Color specials</h3>
-<p>We will describe ‘<samp>background</samp>’ first, since it is the simplest. The
-‘<samp>background</samp>’ keyword must be followed by a color specification.
+<p>We will describe ‘<samp class="samp">background</samp>’ first, since it is the simplest. The
+‘<samp class="samp">background</samp>’ keyword must be followed by a color specification.
That color specification is used as a fill color for the background. The
-last ‘<samp>background</samp>’ special on a page is the one that gets used, and
+last ‘<samp class="samp">background</samp>’ special on a page is the one that gets used, and
is used for the whole of the page image. (This is possible because the
prescan phase of dvipng notices all of the color specials so that the
appropriate information can be written out during the second phase.)
</p>
-<p>The ‘<samp>color</samp>’ special itself has three forms. The first is just
-‘<samp>color</samp>’ followed by a color specification. In this case, the
+<p>The ‘<samp class="samp">color</samp>’ special itself has three forms. The first is just
+‘<samp class="samp">color</samp>’ followed by a color specification. In this case, the
current global color is set to that color; the color stack must be empty
when such a command is executed.
</p>
-<p>The second form is ‘<samp>color push</samp>’ followed by a color specification.
+<p>The second form is ‘<samp class="samp">color push</samp>’ followed by a color specification.
This saves the current color on the color stack and sets the color to be
that given by the color specification. This is the most common way to
set a color.
</p>
-<p>The final form of the ‘<samp>color</samp>’ special is just ‘<samp>color pop</samp>’,
+<p>The final form of the ‘<samp class="samp">color</samp>’ special is just ‘<samp class="samp">color pop</samp>’,
with no color specification; this says to pop the color last pushed on
the color stack from the color stack and set the current color to be
that color.
@@ -1129,16 +1124,16 @@
<hr>
</div>
</div>
-<div class="chapter" id="Diagnosing-problems">
-<div class="header">
+<div class="chapter-level-extent" id="Diagnosing-problems">
+<div class="nav-panel">
<p>
Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Diagnosing-problems-1"></span><h2 class="chapter">7 Diagnosing problems</h2>
+<h2 class="chapter" id="Diagnosing-problems-1">7 Diagnosing problems</h2>
-<span id="index-problems"></span>
-<span id="index-trouble"></span>
-<span id="index-debugging-1"></span>
+<a class="index-entry-id" id="index-problems"></a>
+<a class="index-entry-id" id="index-trouble"></a>
+<a class="index-entry-id" id="index-debugging-1"></a>
<p>You’ve gone through all the trouble of installing dvipng, carefully read
all the instructions in this manual, and still can’t get something to
@@ -1146,92 +1141,92 @@
yourself in such a situation.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Contact-information" accesskey="1">Contact information</a></li>
<li><a href="#Debug-options" accesskey="2">Debug options</a></li>
</ul>
<hr>
-<div class="section" id="Contact-information">
-<div class="header">
+<div class="section-level-extent" id="Contact-information">
+<div class="nav-panel">
<p>
Next: <a href="#Debug-options" accesskey="n" rel="next">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Contact-information-1"></span><h3 class="section">7.1 Contact information</h3>
+<h3 class="section" id="Contact-information-1">7.1 Contact information</h3>
<p>Bug reports should be sent to
-<a href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
+<a class="email" href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
</p>
<p>Questions, suggestions for new features, pleas for help, and/or praise
-should go to <a href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>. For more information on this
+should go to <a class="email" href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>. For more information on this
mailing list, send a message with just the word ‘help’ as subject or
-body to <a href="mailto:dvipng-request at nongnu.org">dvipng-request at nongnu.org</a> or look at
-<a href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>.
+body to <a class="email" href="mailto:dvipng-request at nongnu.org">dvipng-request at nongnu.org</a> or look at
+<a class="url" href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>.
</p>
<p>Offers to support further development will be appreciated. For developer
-access, ask on <a href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
+access, ask on <a class="email" href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
</p>
-<p>For details on the TeX path-searching library, and <code>mktexpk</code>
-problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>.
+<p>For details on the TeX path-searching library, and <code class="code">mktexpk</code>
+problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite class="cite">Kpathsea</cite>.
</p>
<hr>
</div>
-<div class="section" id="Debug-options">
-<div class="header">
+<div class="section-level-extent" id="Debug-options">
+<div class="nav-panel">
<p>
Previous: <a href="#Contact-information" accesskey="p" rel="prev">Contact information</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Debug-options-1"></span><h3 class="section">7.2 Debug options</h3>
+<h3 class="section" id="Debug-options-1">7.2 Debug options</h3>
-<p>The ‘<samp>-d</samp>’ flag to dvipng helps in tracking down certain errors. The
+<p>The ‘<samp class="samp">-d</samp>’ flag to dvipng helps in tracking down certain errors. The
parameter to this flag is an integer that tells what errors are
currently being tracked. To track a certain class of debug messages,
simply provide the appropriate number given below; if you wish to track
multiple classes, sum the numbers of the classes you wish to track. To
-track all classes, you can use <code>-1</code>.
+track all classes, you can use <code class="code">-1</code>.
</p>
<p>Some of these debugging options are actually provided by Kpathsea
-(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>).
</p>
<p>The classes are:
-</p><dl compact="compact">
-<dt><span>1</span></dt>
+</p><dl class="table">
+<dt>1</dt>
<dd><p>Normal dvi op-codes
</p></dd>
-<dt><span>2</span></dt>
+<dt>2</dt>
<dd><p>Virtual fonts
</p></dd>
-<dt><span>4</span></dt>
+<dt>4</dt>
<dd><p>PK fonts
</p></dd>
-<dt><span>8</span></dt>
+<dt>8</dt>
<dd><p>TFM files
</p></dd>
-<dt><span>16</span></dt>
+<dt>16</dt>
<dd><p>Glyph rendering
</p></dd>
-<dt><span>32</span></dt>
+<dt>32</dt>
<dd><p>FreeType calls
</p></dd>
-<dt><span>64</span></dt>
+<dt>64</dt>
<dd><p>Encoding loads
</p></dd>
-<dt><span>128</span></dt>
+<dt>128</dt>
<dd><p>Color specials
</p></dd>
-<dt><span>256</span></dt>
+<dt>256</dt>
<dd><p>GhostScript specials
</p></dd>
-<dt><span>512</span></dt>
-<dd><p>Kpathsea <code>stat</code> calls
+<dt>512</dt>
+<dd><p>Kpathsea <code class="code">stat</code> calls
</p></dd>
-<dt><span>1024</span></dt>
+<dt>1024</dt>
<dd><p>Kpathsea hash table lookups
</p></dd>
-<dt><span>2048</span></dt>
+<dt>2048</dt>
<dd><p>Kpathsea path element expansion
</p></dd>
-<dt><span>4096</span></dt>
+<dt>4096</dt>
<dd><p>Kpathsea path searches
</p>
</dd>
@@ -1240,12 +1235,12 @@
<hr>
</div>
</div>
-<div class="chapter" id="Credits">
-<div class="header">
+<div class="chapter-level-extent" id="Credits">
+<div class="nav-panel">
<p>
Next: <a href="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Credits-1"></span><h2 class="chapter">8 Credits</h2>
+<h2 class="chapter" id="Credits-1">8 Credits</h2>
<p>A number of persons have contributed, if I forget to mention someone,
I apologize. First and foremost we have David Kastrup whose
@@ -1268,12 +1263,12 @@
<hr>
</div>
-<div class="chapter" id="Copying">
-<div class="header">
+<div class="chapter-level-extent" id="Copying">
+<div class="nav-panel">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Credits" accesskey="p" rel="prev">Credits</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Copying-1"></span><h2 class="chapter">9 Copying</h2>
+<h2 class="chapter" id="Copying-1">9 Copying</h2>
<p>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
@@ -1295,210 +1290,212 @@
</p>
<hr>
</div>
-<div class="unnumbered" id="Index">
-<div class="header">
+<div class="unnumbered-level-extent" id="Index">
+<div class="nav-panel">
<p>
Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
+<h2 class="unnumbered" id="Index-1">Index</h2>
-<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
+<div class="printindex cp-printindex">
+<table class="cp-letters-header-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
<br>
-<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
-<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
-<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
-<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
-<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
-<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
-<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
-<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
-<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
-<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
-<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
-<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
-<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
-<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
-<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
-<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
-<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
-<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
</td></tr></table>
-<table class="index-cp" border="0">
-<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
+<table class="cp-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td> </td><th class="sections-header-printindex"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002ddSAFER">-dSAFER</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ddSAFER">-dSAFER</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-antialiasing-levels_002c-number-of">antialiasing levels<span class="roman">, number of</span></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp class="samp">-l</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp class="samp">-p</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-antialiasing-levels_002c-number-of">antialiasing levels<span class="r">, number of</span></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-background-color-_0028option_0029">background color (option)</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-base-resolution_002c-setting">base resolution, setting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-baseline-reporting">baseline reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-baseline-reporting-1">baseline reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-background-color-_0028option_0029">background color (option)</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-base-resolution_002c-setting">base resolution, setting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-baseline-reporting">baseline reporting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-baseline-reporting-1">baseline reporting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-specifications">color specifications</a>:</td><td> </td><td valign="top"><a href="#Color-specifications">Color specifications</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command_002dline-options">command-line options</a>:</td><td> </td><td valign="top"><a href="#Command_002dline-options">Command-line options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compilation">compilation</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compression">compression</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration_002c-of-dvipng">configuration, of dvipng</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-specifications">color specifications</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-specifications">Color specifications</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-command_002dline-options">command-line options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Command_002dline-options">Command-line options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compilation">compilation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compression">compression</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-of-dvipng">configuration, of dvipng</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dark-fonts">dark fonts</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-debugging">debugging</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-debugging-1">debugging</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-depth-reporting">depth reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dark-fonts">dark fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging">debugging</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-1">debugging</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-depth-reporting">depth reporting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-exit-on-erroneous-images">exit on erroneous images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-exit-on-erroneous-images">exit on erroneous images</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-first-page-printed">first page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-follow-mode">follow mode</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-forcing-palette-output">forcing palette output</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-foreground-color-_0028option_0029">foreground color (option)</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-FreeType-font-rendering">FreeType font rendering</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fuzzy-images">fuzzy images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-first-page-printed">first page printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-follow-mode">follow mode</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-forcing-palette-output">forcing palette output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-foreground-color-_0028option_0029">foreground color (option)</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FreeType-font-rendering">FreeType font rendering</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fuzzy-images">fuzzy images</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gamma">gamma</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-GhostScript-and-_002ddSAFER">GhostScript and -dSAFER</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-GhostScript_002c-turning-off">GhostScript, turning off</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-GIF-image-format">GIF image format</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gamma">gamma</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GhostScript-and-_002ddSAFER">GhostScript and -dSAFER</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GhostScript_002c-turning-off">GhostScript, turning off</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GIF-image-format">GIF image format</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-height-reporting">height reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-height-reporting">height reporting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-installation_002c-of-dvipng">installation, of dvipng</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-invoking-dvipng">invoking dvipng</a>:</td><td> </td><td valign="top"><a href="#Basic-usage">Basic usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installation_002c-of-dvipng">installation, of dvipng</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invoking-dvipng">invoking dvipng</a>:</td><td> </td><td class="printindex-index-section"><a href="#Basic-usage">Basic usage</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-light-fonts">light fonts</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-light-fonts">light fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="roman">, avoiding</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mode-name_002c-specifying">mode name, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="r">, avoiding</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode-name_002c-specifying">mode name, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-no-erroneous-images">no erroneous images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no-erroneous-images">no erroneous images</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-offset-pages">offset pages</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-option_002c-details-of">option, details of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-dvipng">options, dvipng</a>:</td><td> </td><td valign="top"><a href="#Command_002dline-options">Command-line options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-reading-from-standard-input">options, reading from standard input</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-summary">options, summary</a>:</td><td> </td><td valign="top"><a href="#Option-summary">Option summary</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output-resolution_002c-setting">output resolution, setting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-offset-pages">offset pages</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-option_002c-details-of">option, details of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-dvipng">options, dvipng</a>:</td><td> </td><td class="printindex-index-section"><a href="#Command_002dline-options">Command-line options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-reading-from-standard-input">options, reading from standard input</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-summary">options, summary</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-summary">Option summary</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-resolution_002c-setting">output resolution, setting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-physical-page-number_002c-and-_002dl">physical page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-physical-page-number_002c-and-_002dp">physical page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PNG-image-format">PNG image format</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-inclusion-problems">PostScript inclusion problems</a>:</td><td> </td><td valign="top"><a href="#Encapsulated-PostScript">Encapsulated PostScript</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript_002c-turning-off-raw-PostScript-specials">PostScript, turning off raw PostScript specials</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-problems">problems</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-range">page range</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dl">physical page number, and ‘<samp class="samp">-l</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dp">physical page number, and ‘<samp class="samp">-p</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PNG-image-format">PNG image format</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-inclusion-problems">PostScript inclusion problems</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encapsulated-PostScript">Encapsulated PostScript</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript_002c-turning-off-raw-PostScript-specials">PostScript, turning off raw PostScript specials</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-problems">problems</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quality">quality</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quality">quality</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reverse-pagination">reverse pagination</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reverse-pagination">reverse pagination</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-silent-operation">silent operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-silent-operation">silent operation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-transparent-border-fallback-color">transparent border fallback color</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-transparent-border-width">transparent border width</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-trouble">trouble</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-truecolor-output">truecolor output</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-border-fallback-color">transparent border fallback color</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-border-width">transparent border width</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trouble">trouble</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-truecolor-output">truecolor output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-width-reporting">width reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-width-reporting">width reporting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
-<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
+<table class="cp-letters-footer-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
<br>
-<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
-<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
-<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
-<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
-<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
-<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
-<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
-<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
-<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
-<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
-<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
-<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
-<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
-<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
-<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
-<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
-<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
-<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
</td></tr></table>
</div>
</div>
+</div>
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/dvips/NEWS
===================================================================
--- trunk/Master/texmf-dist/doc/dvips/NEWS 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/dvips/NEWS 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,6 +1,30 @@
-$Id: NEWS 46759 2018-02-27 23:14:55Z karl $
+$Id: NEWS 65770 2023-02-09 21:26:50Z karl $
This file records noteworthy changes. (Public domain.)
+dvips 2023.1 (TeX Live 2023):
+ Check --help and --version early to avoid looking for texmf.cnf.
+
+dvips 2022.1 (TeX Live 2022):
+ New option (and config file directive) -landscaperotate: try to
+ automatically match rotated page content and paper sizes; in the past,
+ this was done by default, but it is generally unnecessary nowadays,
+ and can be troublesome when converting to PDF, so now the default is
+ not to do this. This option re-enables the rotated matching.
+ Use full font path (if specified) for tfm lookups, as with pk.
+
+dvips 2021.1 (TeX Live 2021):
+ Default title is now the basename of the input file instead of the
+ full path, and can be overridden with new option -title.
+ If an .eps or other image file is not found, dvips now exits unsuccessfully.
+ Support new feature of virtual font to fallback Japanese font definition.
+
+dvips 2020.1 (TeX Live 2020):
+ Encodings for bitmap fonts:
+ https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf
+
+dvips 5.999 (TeX Live 2019):
+ Buffer overflows.
+
dvips 5.998 (TeX Live 2018):
New JFM (Japanese font metrics) spec supported; compiler portability fixes.
Modified: trunk/Master/texmf-dist/doc/dvips/README
===================================================================
--- trunk/Master/texmf-dist/doc/dvips/README 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/dvips/README 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,13 +1,25 @@
-$Id: README 17566 2010-03-26 17:29:02Z karl $
+$Id: README 63453 2022-05-31 15:40:57Z karl $
This directory contains Dvips, Tom Rokicki's dvips, a DVI-to-PostScript
translator. It requires the Kpathsea library for path searching.
-See `NEWS' for changes by release, `ChangeLog` for all changes.
-See `../kpathsea/BUGS' for details on reporting bugs.
-
Dvips is free software; Tom's original files are public domain. The
files Karl wrote (originally for the Free Software Foundation) are
covered by the GNU General Public License -- see the files COPYING*.
+
+Mailing list for bug reports and all general discussion:
+https://lists.tug.org/tex-k; anyone can join the list, but it is not
+necessary to join to post. Archives are public.
+
+See `NEWS' for changes by release, `ChangeLog` for all changes.
+
+dvips is now maintained as part of TeX Live, https://tug.org/texlive.
+Info on building only one program from TL, like this one:
+ https://tug.org/texinfohtml/tlbuild.html#Build-one-package
+TeX Live general build info:
+ https://tug.org/texlive/build.html
+Mailing list for build issues (same setup as tex-k, above):
+ https://lists.tug.org/tlbuild
+
-------------------------------------------------------------------------
The documentation is in the file dvips.texi.
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvips/dvips.html 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/dvips/dvips.html 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,10 +1,10 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.0.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<!-- This manual documents Dvips version 2022.1
-(January 2022), a program to translate a DVI file into
+<!-- This manual documents Dvips version 2023.1
+(February 2022), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file. -->
<title>Dvips: A DVI-to-PostScript translator</title>
@@ -22,21 +22,20 @@
<link href="#Why-Dvips" rel="next" title="Why Dvips">
<style type="text/css">
<!--
-a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
-a.summary-letter {text-decoration: none}
-blockquote.indentedblock {margin-right: 0em}
+a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
+a.summary-letter-printindex {text-decoration: none}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
-kbd {font-style: oblique}
-pre.display {font-family: inherit}
-pre.format {font-family: inherit}
-pre.menu-comment {font-family: serif}
-pre.menu-preformatted {font-family: serif}
-span.nolinebreak {white-space: nowrap}
-span.roman {font-family: initial; font-weight: normal}
-span.sansserif {font-family: sans-serif; font-weight: normal}
-span:hover a.copiable-anchor {visibility: visible}
-ul.no-bullet {list-style: none}
+pre.display-preformatted {font-family: inherit}
+span.r {font-family: initial; font-weight: normal; font-style: normal}
+span:hover a.copiable-link {visibility: visible}
+td.printindex-index-entry {vertical-align: top}
+td.printindex-index-section {vertical-align: top}
+th.entries-header-printindex {text-align:left}
+th.sections-header-printindex {text-align:left}
+ul.mark-bullet {list-style-type: disc}
+ul.mark-minus {list-style-type: "\2212"}
+ul.toc-numbered-mark {list-style: none}
-->
</style>
@@ -44,7 +43,6 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">Dvips: A DVI-to-PostScript translator</h1>
@@ -53,33 +51,33 @@
-<div class="top" id="Top">
-<div class="header">
+<div class="top-level-extent" id="Top">
+<div class="nav-panel">
<p>
Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why use Dvips?</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Dvips"></span><h1 class="top">Dvips</h1>
+<h1 class="top" id="Dvips">Dvips</h1>
-<p>This manual documents Dvips version 2022.1
-(January 2022), a program to translate a DVI file into
+<p>This manual documents Dvips version 2023.1
+(February 2022), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
</p>
-<div class="Contents_element" id="SEC_Contents">
+<div class="element-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
-<ul class="no-bullet">
+<ul class="toc-numbered-mark">
<li><a id="toc-Why-use-Dvips_003f" href="#Why-Dvips">1 Why use Dvips?</a></li>
<li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
- <ul class="no-bullet">
- <li><a id="toc-config_002eps-installation-1" href="#config_002eps-installation">2.1 <samp>config.ps</samp> installation</a></li>
+ <ul class="toc-numbered-mark">
+ <li><a id="toc-config_002eps-installation-1" href="#config_002eps-installation">2.1 <samp class="file">config.ps</samp> installation</a></li>
<li><a id="toc-PostScript-font-installation-1" href="#PostScript-font-installation">2.2 PostScript font installation</a></li>
<li><a id="toc-Ghostscript-installation-1" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li>
<li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">2.4 Diagnosing problems</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Debug-options-1" href="#Debug-options">2.4.1 Debug options</a></li>
<li><a id="toc-No-output-at-all" href="#No-output">2.4.2 No output at all</a></li>
<li><a id="toc-Output-too-small-or-inverted" href="#Small-or-inverted">2.4.3 Output too small or inverted</a></li>
@@ -89,65 +87,65 @@
</ul></li>
</ul></li>
<li><a id="toc-Invoking-Dvips-1" href="#Invoking-Dvips">3 Invoking Dvips</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Basic-usage-of-Dvips" href="#Basic-usage">3.1 Basic usage of Dvips</a></li>
<li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">3.2 Command-line options</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Option-summary-1" href="#Option-summary">3.2.1 Option summary</a></li>
<li><a id="toc-Option-details-1" href="#Option-details">3.2.2 Option details</a></li>
</ul></li>
<li><a id="toc-Environment-variables-1" href="#Environment-variables">3.3 Environment variables</a></li>
<li><a id="toc-Dvips-configuration-files" href="#Config-files">3.4 Dvips configuration files</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Configuration-file-searching-1" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li>
<li><a id="toc-Configuration-file-commands-1" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Paper-size-and-landscape-orientation" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a>
- <ul class="no-bullet">
- <li><a id="toc-papersize-special-1" href="#papersize-special">4.1 ‘<samp>papersize</samp>’ special</a></li>
+ <ul class="toc-numbered-mark">
+ <li><a id="toc-papersize-special-1" href="#papersize-special">4.1 ‘<samp class="samp">papersize</samp>’ special</a></li>
<li><a id="toc-Configuration-file-paper-size-command" href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a></li>
<li><a id="toc-Paper-trays-1" href="#Paper-trays">4.3 Paper trays</a></li>
</ul></li>
<li><a id="toc-Interaction-with-PostScript-1" href="#Interaction-with-PostScript">5 Interaction with PostScript</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-PostScript-figures-1" href="#PostScript-figures">5.1 PostScript figures</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-The-bounding-box-comment" href="#Bounding-box">5.1.1 The bounding box comment</a></li>
<li><a id="toc-The-_005cincludegraphics-macro-for-LaTeX" href="#g_t_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a></li>
<li><a id="toc-Using-the-EPSF-macros" href="#EPSF-macros">5.1.3 Using the EPSF macros</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-EPSF-scaling-1" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li>
<li><a id="toc-EPSF-clipping-1" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li>
</ul></li>
- <li><a id="toc-psfile-special-1" href="#psfile-special">5.1.4 ‘<samp>psfile</samp>’ special</a></li>
+ <li><a id="toc-psfile-special-1" href="#psfile-special">5.1.4 ‘<samp class="samp">psfile</samp>’ special</a></li>
<li><a id="toc-Dynamic-creation-of-PostScript-graphics-files" href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a></li>
<li><a id="toc-Fonts-in-figures-1" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li>
</ul></li>
<li><a id="toc-PostScript-header-files" href="#Header-files">5.2 PostScript header files</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Including-headers-from-TeX-1" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li>
<li><a id="toc-Including-headers-from-the-command-line-1" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li>
<li><a id="toc-Headers-and-memory-usage-1" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li>
</ul></li>
<li><a id="toc-Literal-PostScript" href="#Literal-PS">5.3 Literal PostScript</a>
- <ul class="no-bullet">
- <li><a id="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code>"</code> special: Literal PostScript</a></li>
- <li><a id="toc-ps-special-1" href="#ps-special">5.3.2 ‘<samp>ps</samp>’ special</a></li>
- <li><a id="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li>
+ <ul class="toc-numbered-mark">
+ <li><a id="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code class="code">"</code> special: Literal PostScript</a></li>
+ <li><a id="toc-ps-special-1" href="#ps-special">5.3.2 ‘<samp class="samp">ps</samp>’ special</a></li>
+ <li><a id="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a></li>
<li><a id="toc-PostScript-hooks-1" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li>
<li><a id="toc-Literal-examples-1" href="#Literal-examples">5.3.5 Literal examples</a></li>
</ul></li>
<li><a id="toc-HyperTeXt" href="#Hypertext">5.4 HyperTeXt</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Hypertext-caveats-1" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li>
<li><a id="toc-Hypertext-specials-1" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li>
</ul></li>
</ul></li>
<li><a id="toc-PostScript-fonts-1" href="#PostScript-fonts">6 PostScript fonts</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Font-concepts-1" href="#Font-concepts">6.1 Font concepts</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Metric-files-1" href="#Metric-files">6.1.1 Metric files</a></li>
<li><a id="toc-Glyph-files-1" href="#Glyph-files">6.1.2 Glyph files</a></li>
<li><a id="toc-Virtual-fonts-1" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li>
@@ -157,12 +155,12 @@
</ul></li>
<li><a id="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li>
<li><a id="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Changing-font-encodings-1" href="#Changing-font-encodings">6.3.1 Changing font encodings</a>
- <ul class="no-bullet">
- <li><a id="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</a></li>
- <li><a id="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</a></li>
- <li><a id="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li>
+ <ul class="toc-numbered-mark">
+ <li><a id="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp class="samp">-t</samp>’: Changing TeX encodings</a></li>
+ <li><a id="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a></li>
+ <li><a id="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a></li>
<li><a id="toc-Reencoding-with-Afm2tfm-1" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li>
<li><a id="toc-Encoding-file-format-1" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li>
</ul></li>
@@ -169,10 +167,10 @@
<li><a id="toc-Special-font-effects-1" href="#Special-font-effects">6.3.2 Special font effects</a></li>
<li><a id="toc-Afm2tfm-options-1" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li>
</ul></li>
- <li><a id="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp>psfonts.map</samp>: PostScript font catalog</a></li>
+ <li><a id="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp class="file">psfonts.map</samp>: PostScript font catalog</a></li>
</ul></li>
<li><a id="toc-Color-1" href="#Color">7 Color</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Color-macro-files-1" href="#Color-macro-files">7.1 Color macro files</a></li>
<li><a id="toc-User_002ddefinable-colors-1" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li>
<li><a id="toc-Color-subtleties-1" href="#Color-subtleties">7.3 Color subtleties</a></li>
@@ -179,7 +177,7 @@
<li><a id="toc-Printing-in-black_002fwhite-after-colorizing" href="#Ted-Turner">7.4 Printing in black/white after colorizing</a></li>
<li><a id="toc-Color-device-configuration-1" href="#Color-device-configuration">7.5 Color device configuration</a></li>
<li><a id="toc-Color-support-details-1" href="#Color-support-details">7.6 Color support details</a>
- <ul class="no-bullet">
+ <ul class="toc-numbered-mark">
<li><a id="toc-Color-specifications-1" href="#Color-specifications">7.6.1 Color specifications</a></li>
<li><a id="toc-Color-specials-1" href="#Color-specials">7.6.2 Color specials</a></li>
</ul></li>
@@ -188,11 +186,11 @@
</ul>
</div>
</div>
-<div class="Overview_element" id="SEC_Overview">
+<div class="element-shortcontents" id="SEC_Shortcontents">
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
-<ul class="no-bullet">
+<ul class="toc-numbered-mark">
<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li>
<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li>
<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li>
@@ -205,17 +203,17 @@
</div>
</div>
<hr>
-<div class="chapter" id="Why-Dvips">
-<div class="header">
+<div class="chapter-level-extent" id="Why-Dvips">
+<div class="nav-panel">
<p>
Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Why-use-Dvips_003f"></span><h2 class="chapter">1 Why use Dvips?</h2>
+<h2 class="chapter" id="Why-use-Dvips_003f">1 Why use Dvips?</h2>
<p>The Dvips program has a number of features that set it apart from
other PostScript drivers for TeX. This rather long section describes
the advantages of using Dvips, and may be skipped if you are just
-interested in learning how to use the program. See <a href="#Installation">Installation</a>, for
+interested in learning how to use the program. See <a class="xref" href="#Installation">Installation</a>, for
details of compilation and installation.
</p>
<p>The Dvips driver generates excellent, standard PostScript, that
@@ -259,77 +257,77 @@
is possible. Adding such features is made easier by the highly modular
structure of the program.
</p>
-<span id="index-Rokicki_002c-Tomas"></span>
+<a class="index-entry-id" id="index-Rokicki_002c-Tomas"></a>
<p>Tom Rokicki wrote and maintains the original Dvips program.
</p>
<hr>
</div>
-<div class="chapter" id="Installation">
-<div class="header">
+<div class="chapter-level-extent" id="Installation">
+<div class="nav-panel">
<p>
Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why use Dvips?</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
+<h2 class="chapter" id="Installation-1">2 Installation</h2>
-<span id="index-configuration_002c-of-Dvips"></span>
-<span id="index-compilation"></span>
-<span id="index-installation_002c-of-Dvips"></span>
+<a class="index-entry-id" id="index-configuration_002c-of-Dvips"></a>
+<a class="index-entry-id" id="index-compilation"></a>
+<a class="index-entry-id" id="index-installation_002c-of-Dvips"></a>
<p>Installing Dvips is mostly the same as installing any Kpathsea-using
program. Therefore, for the basic steps involved,
-see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
+see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite class="cite">Kpathsea</cite>.
</p>
<p>For solutions to common installation problems and information on how to
-report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems,
-see <a href="#Debug-options">Debug options</a>.
+report a bug, see the file <samp class="file">kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>). For solutions to Dvips-specific problems,
+see <a class="pxref" href="#Debug-options">Debug options</a>.
</p>
<p>Dvips does require some additional installation, detailed in the
-sections below. Also, to configure color devices, see <a href="#Color-device-configuration">Color device configuration</a>.
+sections below. Also, to configure color devices, see <a class="pxref" href="#Color-device-configuration">Color device configuration</a>.
</p>
-<ul class="section-toc">
-<li><a href="#config_002eps-installation" accesskey="1"><samp>config.ps</samp> installation</a></li>
+<ul class="mini-toc">
+<li><a href="#config_002eps-installation" accesskey="1"><samp class="file">config.ps</samp> installation</a></li>
<li><a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></li>
<li><a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></li>
<li><a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></li>
</ul>
<hr>
-<div class="section" id="config_002eps-installation">
-<div class="header">
+<div class="section-level-extent" id="config_002eps-installation">
+<div class="nav-panel">
<p>
Next: <a href="#PostScript-font-installation" accesskey="n" rel="next">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="config_002eps-installation-1"></span><h3 class="section">2.1 <samp>config.ps</samp> installation</h3>
+<h3 class="section" id="config_002eps-installation-1">2.1 <samp class="file">config.ps</samp> installation</h3>
-<span id="index-config_002eps-installation"></span>
-<span id="index-installation-of-config_002eps"></span>
-<span id="index-printer-configuration"></span>
-<span id="index-paper-size_002c-default"></span>
-<span id="index-configuration-files_002c-creating"></span>
+<a class="index-entry-id" id="index-config_002eps-installation"></a>
+<a class="index-entry-id" id="index-installation-of-config_002eps"></a>
+<a class="index-entry-id" id="index-printer-configuration"></a>
+<a class="index-entry-id" id="index-paper-size_002c-default"></a>
+<a class="index-entry-id" id="index-configuration-files_002c-creating"></a>
-<p>Dvips has its own configuration files: a file <samp>config.ps</samp> for
-sitewide defaults, and a file <samp>config.<var>printer</var></samp> for each
-printer (output device). Since these are site-specific, <code>make
+<p>Dvips has its own configuration files: a file <samp class="file">config.ps</samp> for
+sitewide defaults, and a file <samp class="file">config.<var class="var">printer</var></samp> for each
+printer (output device). Since these are site-specific, <code class="code">make
install</code> does not create them; you must create them yourself.
</p>
<p>(These Dvips configuration files are independent of the Kpathsea
-configuration file <samp>texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+configuration file <samp class="file">texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>).
</p>
-<span id="index-config_002eproto"></span>
-<span id="index-prototype-printer-configuration-file"></span>
-<span id="index-printer-configuration-file_002c-prototype"></span>
-<span id="index-configuration-files_002c-prototype"></span>
+<a class="index-entry-id" id="index-config_002eproto"></a>
+<a class="index-entry-id" id="index-prototype-printer-configuration-file"></a>
+<a class="index-entry-id" id="index-printer-configuration-file_002c-prototype"></a>
+<a class="index-entry-id" id="index-configuration-files_002c-prototype"></a>
<p>Dvips configuration files contents and searching are described fully in
-<a href="#Config-files">Dvips configuration files</a>. The simplest way to create a new configuration file
-is to copy and modify the file <samp>dvipsk/contrib/config.proto</samp>,
-seasoning with options to your taste from <a href="#Config-files">Dvips configuration files</a>. Here is
-<samp>config.proto</samp>
+<a class="ref" href="#Config-files">Dvips configuration files</a>. The simplest way to create a new configuration file
+is to copy and modify the file <samp class="file">dvipsk/contrib/config.proto</samp>,
+seasoning with options to your taste from <a class="ref" href="#Config-files">Dvips configuration files</a>. Here is
+<samp class="file">config.proto</samp>
for your reading pleasure:
</p><div class="example">
-<pre class="example">% Prototype Dvips configuration file. (Public domain.)
+<pre class="example-preformatted">% Prototype Dvips configuration file. (Public domain.)
% How to print, maybe with lp instead lpr, etc.
o |lpr
@@ -339,7 +337,7 @@
% Metafont mode. (This is completely different from the -M command-line
% option, which controls whether MakeTeXPK is invoked.) Get
-% <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of mode names. This mode
+% <a class="url" href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of mode names. This mode
% and the D number above must agree, or MakeTeXPK will get confused.
M ljfour
@@ -356,7 +354,7 @@
% Partially download Type 1 fonts by default. Only reason not to do
% this is if you encounter bugs. (Please report them to
-% <a href="mailto:tex-k at tug.org">tex-k at tug.org</a> if you do.)
+% <a class="email" href="mailto:tex-k at tug.org">tex-k at tug.org</a> if you do.)
j
% Also look for fonts at these resolutions.
@@ -376,93 +374,93 @@
%c FILENAME
% You will also want definitions for alternative paper sizes -- A4,
-% legal, and such. Examples in <samp>contrib/papersize.level2</samp> and
-% <samp>contrib/papersize.simple</samp>.
+% legal, and such. Examples in <samp class="file">contrib/papersize.level2</samp> and
+% <samp class="file">contrib/papersize.simple</samp>.
</pre></div>
<hr>
</div>
-<div class="section" id="PostScript-font-installation">
-<div class="header">
+<div class="section-level-extent" id="PostScript-font-installation">
+<div class="nav-panel">
<p>
-Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev"><samp>config.ps</samp> installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev"><samp class="file">config.ps</samp> installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="PostScript-font-installation-1"></span><h3 class="section">2.2 PostScript font installation</h3>
+<h3 class="section" id="PostScript-font-installation-1">2.2 PostScript font installation</h3>
-<span id="index-installation-of-PostScript-fonts"></span>
-<span id="index-fonts_002c-installation-of-PostScript"></span>
-<span id="index-PostScript-fonts_002c-installing"></span>
+<a class="index-entry-id" id="index-installation-of-PostScript-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-installation-of-PostScript"></a>
+<a class="index-entry-id" id="index-PostScript-fonts_002c-installing"></a>
<p>To use PostScript fonts with TeX and Dvips, you need both metric
-files (<samp>.tfm</samp> and <samp>.vf</samp>) and the outlines (<samp>.pfa</samp> or
-<samp>.pfb</samp>). See <a href="#Font-concepts">Font concepts</a>. Current TeX systems
+files (<samp class="file">.tfm</samp> and <samp class="file">.vf</samp>) and the outlines (<samp class="file">.pfa</samp> or
+<samp class="file">.pfb</samp>). See <a class="xref" href="#Font-concepts">Font concepts</a>. Current TeX systems
come with support for 35 base PostScript fonts and many more.
</p>
-<span id="index-fonts_002c-system-PostScript"></span>
-<span id="index-PostScript-fonts_002c-on-your-system"></span>
-<span id="index-psfonts_002emap"></span>
+<a class="index-entry-id" id="index-fonts_002c-system-PostScript"></a>
+<a class="index-entry-id" id="index-PostScript-fonts_002c-on-your-system"></a>
+<a class="index-entry-id" id="index-psfonts_002emap"></a>
<p>If you have additional PostScript fonts, you can make them available
to Dvips by (1) giving them appropriate filenames; and
-(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a PostScript font available</a>) to make TFM
+(2) running Afm2tfm (see <a class="pxref" href="#Making-a-font-available">Making a PostScript font available</a>) to make TFM
and VF metrics for TeX and Dvips to use. Also add them to
-<samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>); this file must contain
-everything available in the system. The <code>updmap</code> program is
-usually used to maintain <samp>psfonts.map</samp>; run ‘<samp>updmap --help</samp>’
+<samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>); this file must contain
+everything available in the system. The <code class="code">updmap</code> program is
+usually used to maintain <samp class="file">psfonts.map</samp>; run ‘<samp class="samp">updmap --help</samp>’
for lots of information about how it works.
</p>
<hr>
</div>
-<div class="section" id="Ghostscript-installation">
-<div class="header">
+<div class="section-level-extent" id="Ghostscript-installation">
+<div class="nav-panel">
<p>
Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#PostScript-font-installation" accesskey="p" rel="prev">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Ghostscript-installation-1"></span><h3 class="section">2.3 Ghostscript installation</h3>
+<h3 class="section" id="Ghostscript-installation-1">2.3 Ghostscript installation</h3>
-<span id="index-Ghostscript-installation"></span>
-<span id="index-gs-installation"></span>
+<a class="index-entry-id" id="index-Ghostscript-installation"></a>
+<a class="index-entry-id" id="index-gs-installation"></a>
-<span id="index-Deutsch_002c-Peter"></span>
-<span id="index-Epson-printers"></span>
-<span id="index-previewing-Dvips-output"></span>
-<span id="index-PostScript-previewers"></span>
-<span id="index-PDF-files_002c-making"></span>
-<span id="index-Aladdin-Ghostscript"></span>
+<a class="index-entry-id" id="index-Deutsch_002c-Peter"></a>
+<a class="index-entry-id" id="index-Epson-printers"></a>
+<a class="index-entry-id" id="index-previewing-Dvips-output"></a>
+<a class="index-entry-id" id="index-PostScript-previewers"></a>
+<a class="index-entry-id" id="index-PDF-files_002c-making"></a>
+<a class="index-entry-id" id="index-Aladdin-Ghostscript"></a>
<p>Ghostscript is a PostScript interpreter freely available to end-users,
originally written by Peter Deutsch. It can read the PostScript
produced by Dvips and render it on your monitor, or for another device
(e.g., an Epson printer) that does not support PostScript, or in PDF
format. The latest version is available via
-<a href="https://ghostscript.com">https://ghostscript.com</a>.
+<a class="url" href="https://ghostscript.com">https://ghostscript.com</a>.
</p>
-<span id="index-Theisen_002c-Tim"></span>
-<span id="index-ghostview"></span>
-<span id="index-Ghostview_002c-and-no-N"></span>
-<span id="index-EPS_002c-and-Ghostview"></span>
-<span id="index-standard-PostScript_002c-required-by-Ghostview"></span>
-<span id="index-_0025_0025Page_002c-required-by-Ghostview"></span>
+<a class="index-entry-id" id="index-Theisen_002c-Tim"></a>
+<a class="index-entry-id" id="index-ghostview"></a>
+<a class="index-entry-id" id="index-Ghostview_002c-and-no-N"></a>
+<a class="index-entry-id" id="index-EPS_002c-and-Ghostview"></a>
+<a class="index-entry-id" id="index-standard-PostScript_002c-required-by-Ghostview"></a>
+<a class="index-entry-id" id="index-_0025_0025Page_002c-required-by-Ghostview"></a>
<p>The program Ghostview, originally written by Johannes Plass and Tim
Theisen, provides typical previewing capabilities (next page/previous
page, magnification, etc.). It requires Ghostscript to run, and files
-in structured PostScript, specifically with ‘<samp>%%Page</samp>’ comments (no
-‘<samp>N</samp>’ in <samp>config.ps</samp>). The current version is known as GV,
-and is available from <a href="https://www.gnu.org/software/gv">https://www.gnu.org/software/gv</a>.
+in structured PostScript, specifically with ‘<samp class="samp">%%Page</samp>’ comments (no
+‘<samp class="samp">N</samp>’ in <samp class="file">config.ps</samp>). The current version is known as GV,
+and is available from <a class="url" href="https://www.gnu.org/software/gv">https://www.gnu.org/software/gv</a>.
</p>
<hr>
</div>
-<div class="section" id="Diagnosing-problems">
-<div class="header">
+<div class="section-level-extent" id="Diagnosing-problems">
+<div class="nav-panel">
<p>
Previous: <a href="#Ghostscript-installation" accesskey="p" rel="prev">Ghostscript installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Diagnosing-problems-1"></span><h3 class="section">2.4 Diagnosing problems</h3>
+<h3 class="section" id="Diagnosing-problems-1">2.4 Diagnosing problems</h3>
-<span id="index-problems"></span>
-<span id="index-trouble"></span>
-<span id="index-debugging"></span>
+<a class="index-entry-id" id="index-problems"></a>
+<a class="index-entry-id" id="index-trouble"></a>
+<a class="index-entry-id" id="index-debugging"></a>
<p>You’ve gone through all the trouble of installing Dvips, carefully read
all the instructions in this manual, and still can’t get something to
@@ -470,16 +468,16 @@
yourself in such a situation.
</p>
<p>For details on effective bug reporting, common installation problems,
-and <code>mktexpk</code> problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>.
+and <code class="code">mktexpk</code> problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>.
</p>
<p>A good first debugging operation is to set the environment variable
-<code>DVIPSDEBUG</code>, which will display any configuration and map files
+<code class="env">DVIPSDEBUG</code>, which will display any configuration and map files
read by Dvips. This way you can be sure it’s finding the files and
settings you expect.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Debug-options" accesskey="1">Debug options</a></li>
<li><a href="#No-output" accesskey="2">No output at all</a></li>
<li><a href="#Small-or-inverted" accesskey="3">Output too small or inverted</a></li>
@@ -488,67 +486,67 @@
<li><a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></li>
</ul>
<hr>
-<div class="subsection" id="Debug-options">
-<div class="header">
+<div class="subsection-level-extent" id="Debug-options">
+<div class="nav-panel">
<p>
Next: <a href="#No-output" accesskey="n" rel="next">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Debug-options-1"></span><h4 class="subsection">2.4.1 Debug options</h4>
+<h4 class="subsection" id="Debug-options-1">2.4.1 Debug options</h4>
-<span id="index-debugging-options"></span>
-<span id="index-options_002c-debugging"></span>
+<a class="index-entry-id" id="index-debugging-options"></a>
+<a class="index-entry-id" id="index-options_002c-debugging"></a>
-<p>The ‘<samp>-d</samp>’ flag to Dvips helps in tracking down certain errors.
+<p>The ‘<samp class="samp">-d</samp>’ flag to Dvips helps in tracking down certain errors.
The parameter to this flag is an integer that tells what errors are
currently being tracked. To track a certain class of debug messages,
specify the appropriate number given below; if you wish to track
multiple classes, sum the numbers of the classes you wish to track.
-To track all classes, you can use <code>-1</code>.
+To track all classes, you can use <code class="code">-1</code>.
</p>
-<p>You can also set the environment variable <code>KPATHSEA_DEBUG</code> instead
-of using ‘<samp>-d</samp>’. Some of these debugging options are actually
-provided by Kpathsea (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+<p>You can also set the environment variable <code class="env">KPATHSEA_DEBUG</code> instead
+of using ‘<samp class="samp">-d</samp>’. Some of these debugging options are actually
+provided by Kpathsea (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>).
</p>
<p>The classes are:
</p>
-<dl compact="compact">
-<dt><span>1</span></dt>
+<dl class="table">
+<dt>1</dt>
<dd><p>specials
</p></dd>
-<dt><span>2</span></dt>
+<dt>2</dt>
<dd><p>paths
</p></dd>
-<dt><span>4</span></dt>
+<dt>4</dt>
<dd><p>fonts
</p></dd>
-<dt><span>8</span></dt>
+<dt>8</dt>
<dd><p>pages
</p></dd>
-<dt><span>16</span></dt>
+<dt>16</dt>
<dd><p>headers
</p></dd>
-<dt><span>32</span></dt>
+<dt>32</dt>
<dd><p>font compression
</p></dd>
-<dt><span>64</span></dt>
+<dt>64</dt>
<dd><p>files
</p></dd>
-<dt><span>128</span></dt>
+<dt>128</dt>
<dd><p>(omitted)
</p></dd>
-<dt><span>256</span></dt>
+<dt>256</dt>
<dd><p>config files
</p></dd>
-<dt><span>512</span></dt>
-<dd><p>Kpathsea <code>stat</code> calls
+<dt>512</dt>
+<dd><p>Kpathsea <code class="code">stat</code> calls
</p></dd>
-<dt><span>1024</span></dt>
+<dt>1024</dt>
<dd><p>Kpathsea hash table lookups
</p></dd>
-<dt><span>2048</span></dt>
+<dt>2048</dt>
<dd><p>Kpathsea path element expansion
</p></dd>
-<dt><span>4096</span></dt>
+<dt>4096</dt>
<dd><p>Kpathsea path searches
</p></dd>
</dl>
@@ -556,29 +554,29 @@
<hr>
</div>
-<div class="subsection" id="No-output">
-<div class="header">
+<div class="subsection-level-extent" id="No-output">
+<div class="nav-panel">
<p>
Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Output too small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="No-output-at-all"></span><h4 class="subsection">2.4.2 No output at all</h4>
+<h4 class="subsection" id="No-output-at-all">2.4.2 No output at all</h4>
-<span id="index-output_002c-none"></span>
-<span id="index-no-output-at-all"></span>
-<span id="index-failure_002c-to-print-at-all"></span>
+<a class="index-entry-id" id="index-output_002c-none"></a>
+<a class="index-entry-id" id="index-no-output-at-all"></a>
+<a class="index-entry-id" id="index-failure_002c-to-print-at-all"></a>
<p>If you are not getting any output at all, even from the simplest
-one-character file (for instance, ‘<samp>\ \bye</samp>’), then something is very
+one-character file (for instance, ‘<samp class="samp">\ \bye</samp>’), then something is very
wrong. Practically any file sent to a PostScript laser printer should
generate some output, at the very least a page detailing what error
occurred, if any. Talk to your system administrator about downloading a
PostScript error handler. (Adobe distributes a good one called
-‘<samp>ehandler.ps</samp>’.)
-<span id="index-ehandler_002eps"></span>
+‘<samp class="samp">ehandler.ps</samp>’.)
+<a class="index-entry-id" id="index-ehandler_002eps"></a>
</p>
-<span id="index-PowerPage-PostScript-implementation"></span>
-<span id="index-Shinko-CHC_002dS446i-printer"></span>
-<span id="index-Mitsubishi-Shinko-CHC_002dS446i-printer"></span>
+<a class="index-entry-id" id="index-PowerPage-PostScript-implementation"></a>
+<a class="index-entry-id" id="index-Shinko-CHC_002dS446i-printer"></a>
+<a class="index-entry-id" id="index-Mitsubishi-Shinko-CHC_002dS446i-printer"></a>
<p>It is possible, especially if you are using non-Adobe PostScript, that
your PostScript interpreter is broken. Even then it should generate an
error message. Dvips tries to work around as many bugs as possible in
@@ -590,88 +588,88 @@
<p>If Dvips gives any strange error messages, or compilation on your
machine generated a lot of warnings, perhaps the Dvips program itself is
broken. Try using the debug options to determine where the error
-occurred (see <a href="#Debug-options">Debug options</a>).
+occurred (see <a class="pxref" href="#Debug-options">Debug options</a>).
</p>
<p>It is possible your spooler is broken and is misinterpreting the
-structured comments. Try the ‘<samp>-N</samp>’ flag to turn off structured
+structured comments. Try the ‘<samp class="samp">-N</samp>’ flag to turn off structured
comments and see what happens.
</p>
<hr>
</div>
-<div class="subsection" id="Small-or-inverted">
-<div class="header">
+<div class="subsection-level-extent" id="Small-or-inverted">
+<div class="nav-panel">
<p>
Next: <a href="#Printer-errors" accesskey="n" rel="next">Error messages from printer</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Output-too-small-or-inverted"></span><h4 class="subsection">2.4.3 Output too small or inverted</h4>
+<h4 class="subsection" id="Output-too-small-or-inverted">2.4.3 Output too small or inverted</h4>
-<span id="index-output_002c-too-small"></span>
-<span id="index-output_002c-inverted"></span>
-<span id="index-inverted-output"></span>
-<span id="index-too_002dsmall-output"></span>
+<a class="index-entry-id" id="index-output_002c-too-small"></a>
+<a class="index-entry-id" id="index-output_002c-inverted"></a>
+<a class="index-entry-id" id="index-inverted-output"></a>
+<a class="index-entry-id" id="index-too_002dsmall-output"></a>
-<span id="index-save_002frestore_002c-and-inverted-output"></span>
+<a class="index-entry-id" id="index-save_002frestore_002c-and-inverted-output"></a>
<p>If some documents come out inverted or too small, probably your spooler
is not supplying an end of job indicator at the end of each file. (This
commonly happens on small machines that don’t have spoolers.) You can
-force Dvips to do this with the ‘<samp>-F</samp>’ flag (or ‘<samp>F</samp>’ config file
+force Dvips to do this with the ‘<samp class="samp">-F</samp>’ flag (or ‘<samp class="samp">F</samp>’ config file
option), but this generates files with a terminating binary character
-(control-D). You can also try using the ‘<samp>-s</samp>’ flag (or ‘<samp>s</samp>’
+(control-D). You can also try using the ‘<samp class="samp">-s</samp>’ flag (or ‘<samp class="samp">s</samp>’
config file option) to enclose the entire job in a save/restore pair.
-See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Dvips configuration files</a>.
+See <a class="xref" href="#Command_002dline-options">Command-line options</a>, and <a class="ref" href="#Config-files">Dvips configuration files</a>.
</p>
<hr>
</div>
-<div class="subsection" id="Printer-errors">
-<div class="header">
+<div class="subsection-level-extent" id="Printer-errors">
+<div class="nav-panel">
<p>
Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail to print</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Output too small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Error-messages-from-printer"></span><h4 class="subsection">2.4.4 Error messages from printer</h4>
+<h4 class="subsection" id="Error-messages-from-printer">2.4.4 Error messages from printer</h4>
-<span id="index-printer-errors"></span>
-<span id="index-error-messages-from-printer"></span>
-<span id="index-failure_002c-and-printer-errors"></span>
+<a class="index-entry-id" id="index-printer-errors"></a>
+<a class="index-entry-id" id="index-error-messages-from-printer"></a>
+<a class="index-entry-id" id="index-failure_002c-and-printer-errors"></a>
-<span id="index-bop-undefined-error"></span>
+<a class="index-entry-id" id="index-bop-undefined-error"></a>
<p>If your printer returns error messages, the error message gives very
good information on what might be going wrong. One of the most common
-error messages is ‘<samp>bop undefined</samp>’. This is caused by old versions
+error messages is ‘<samp class="samp">bop undefined</samp>’. This is caused by old versions
of Transcript and other spoolers that do not properly parse the setup
section of the PostScript. To fix this, turn off structured comments
-with the ‘<samp>-N</samp>’ option, but it’d be best to get your spooling
+with the ‘<samp class="samp">-N</samp>’ option, but it’d be best to get your spooling
software updated.
</p>
-<span id="index-VM-exhausted"></span>
-<span id="index-printer-memory-exhausted"></span>
-<span id="index-memory-of-printer-exhausted"></span>
-<p>Another error message is ‘<samp>VM exhausted</samp>’. Some printers indicate
+<a class="index-entry-id" id="index-VM-exhausted"></a>
+<a class="index-entry-id" id="index-printer-memory-exhausted"></a>
+<a class="index-entry-id" id="index-memory-of-printer-exhausted"></a>
+<p>Another error message is ‘<samp class="samp">VM exhausted</samp>’. Some printers indicate
this error by locking up, others quietly reset. This is caused by Dvips
thinking that the printer has more memory than it actually does, and
then printing a complicated document. To fix this, try lowering the
-‘<samp>m</samp>’ parameter in the configuration file; use the debug option to
+‘<samp class="samp">m</samp>’ parameter in the configuration file; use the debug option to
make sure you adjust the correct file.
</p>
<p>Other errors may indicate you are trying to include graphics that don’t
nest properly in other PostScript documents, among other things. Try
the PostScript file on a QMS PS-810 or other Adobe PostScript printer if
-you have one, or Ghostscript (see <a href="#Ghostscript-installation">Ghostscript installation</a>); it
+you have one, or Ghostscript (see <a class="pxref" href="#Ghostscript-installation">Ghostscript installation</a>); it
might be a problem with the printer itself.
</p>
<hr>
</div>
-<div class="subsection" id="Long-documents-fail">
-<div class="header">
+<div class="subsection-level-extent" id="Long-documents-fail">
+<div class="nav-panel">
<p>
Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Error messages from printer</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Long-documents-fail-to-print"></span><h4 class="subsection">2.4.5 Long documents fail to print</h4>
+<h4 class="subsection" id="Long-documents-fail-to-print">2.4.5 Long documents fail to print</h4>
-<span id="index-long-documents-not-printing"></span>
-<span id="index-failure_002c-of-long-documents"></span>
+<a class="index-entry-id" id="index-long-documents-not-printing"></a>
+<a class="index-entry-id" id="index-failure_002c-of-long-documents"></a>
<p>This is usually caused by incorrectly specifying the amount of memory
the printer has in the configuration file; see the previous section.
@@ -679,22 +677,22 @@
<hr>
</div>
-<div class="subsection" id="Including-graphics-fails">
-<div class="header">
+<div class="subsection-level-extent" id="Including-graphics-fails">
+<div class="nav-panel">
<p>
Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail to print</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Including-graphics-fails-1"></span><h4 class="subsection">2.4.6 Including graphics fails</h4>
+<h4 class="subsection" id="Including-graphics-fails-1">2.4.6 Including graphics fails</h4>
-<span id="index-including-graphics-fails"></span>
-<span id="index-graphics-inclusion-fails"></span>
-<span id="index-failure_002c-to-include-graphics"></span>
+<a class="index-entry-id" id="index-including-graphics-fails"></a>
+<a class="index-entry-id" id="index-graphics-inclusion-fails"></a>
+<a class="index-entry-id" id="index-failure_002c-to-include-graphics"></a>
<p>The most common problem with including graphics is an incorrect bounding
-box (see <a href="#Bounding-box">The bounding box comment</a>). Complain to whoever wrote the software that
+box (see <a class="pxref" href="#Bounding-box">The bounding box comment</a>). Complain to whoever wrote the software that
generated the file if the bounding box is indeed incorrect.
</p>
-<span id="index-Illustrator_002c-workaround-for"></span>
+<a class="index-entry-id" id="index-Illustrator_002c-workaround-for"></a>
<p>Another possible problem is that the figure you are trying to include
does not nest properly; there are certain rules PostScript applications
must follow when generating files to be included. The Dvips program
@@ -701,7 +699,7 @@
includes work-arounds for such errors in Adobe Illustrator and other
programs, but there are certainly applications that haven’t been tested.
</p>
-<p>One possible thing to try is the ‘<samp>-K</samp>’ flag which strips the comments
+<p>One possible thing to try is the ‘<samp class="samp">-K</samp>’ flag which strips the comments
from an included figure. This might be necessary if the PostScript
spooling software does not read the structured comments correctly. Use
of this flag will break graphics from some applications, though, since
@@ -708,7 +706,7 @@
some applications read the PostScript file from the input stream,
looking for a particular comment.
</p>
-<span id="index-binary-files_002c-not-supported"></span>
+<a class="index-entry-id" id="index-binary-files_002c-not-supported"></a>
<p>Any application which generates graphics output containing raw binary
(not ASCII hex) will probably fail with Dvips.
</p>
@@ -717,16 +715,16 @@
</div>
</div>
</div>
-<div class="chapter" id="Invoking-Dvips">
-<div class="header">
+<div class="chapter-level-extent" id="Invoking-Dvips">
+<div class="nav-panel">
<p>
Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape orientation</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Invoking-Dvips-1"></span><h2 class="chapter">3 Invoking Dvips</h2>
+<h2 class="chapter" id="Invoking-Dvips-1">3 Invoking Dvips</h2>
-<span id="index-command_002dline-options"></span>
-<span id="index-options_002c-Dvips"></span>
-<span id="index-invoking-Dvips"></span>
+<a class="index-entry-id" id="index-command_002dline-options"></a>
+<a class="index-entry-id" id="index-options_002c-Dvips"></a>
+<a class="index-entry-id" id="index-invoking-Dvips"></a>
<p>Dvips reads a DVI file as output by (for example) TeX, and converts
it to PostScript, taking care of builtin or downloaded PostScript fonts,
@@ -738,7 +736,7 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Basic-usage" accesskey="1">Basic usage of Dvips</a></li>
<li><a href="#Command_002dline-options" accesskey="2">Command-line options</a></li>
<li><a href="#Environment-variables" accesskey="3">Environment variables</a></li>
@@ -745,23 +743,23 @@
<li><a href="#Config-files" accesskey="4">Dvips configuration files</a></li>
</ul>
<hr>
-<div class="section" id="Basic-usage">
-<div class="header">
+<div class="section-level-extent" id="Basic-usage">
+<div class="nav-panel">
<p>
Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Basic-usage-of-Dvips"></span><h3 class="section">3.1 Basic usage of Dvips</h3>
+<h3 class="section" id="Basic-usage-of-Dvips">3.1 Basic usage of Dvips</h3>
-<span id="index-usage_002c-basic"></span>
+<a class="index-entry-id" id="index-usage_002c-basic"></a>
<p>To use Dvips at its simplest, simply type
</p>
<div class="example">
-<pre class="example">dvips foo
+<pre class="example-preformatted">dvips foo
</pre></div>
-<p>where <samp>foo.dvi</samp> is the output of TeX that you want to print.
-The default output is to a corresponding file <samp>foo.ps</samp>; Dvips may
+<p>where <samp class="file">foo.dvi</samp> is the output of TeX that you want to print.
+The default output is to a corresponding file <samp class="file">foo.ps</samp>; Dvips may
also have been locally configured to output directly to a printer by
default.
</p>
@@ -771,24 +769,24 @@
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 <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.)
+See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite class="cite">Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
of available options, run
</p>
<div class="example">
-<pre class="example">dvips --help
+<pre class="example-preformatted">dvips --help
</pre></div>
<hr>
</div>
-<div class="section" id="Command_002dline-options">
-<div class="header">
+<div class="section-level-extent" id="Command_002dline-options">
+<div class="nav-panel">
<p>
Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of Dvips</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Command_002dline-options-1"></span><h3 class="section">3.2 Command-line options</h3>
+<h3 class="section" id="Command_002dline-options-1">3.2 Command-line options</h3>
<p>Dvips has a plethora of command line options. Reading through this
section will give a good idea of the capabilities of the driver.
@@ -795,22 +793,22 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Option-summary" accesskey="1">Option summary</a></li>
<li><a href="#Option-details" accesskey="2">Option details</a></li>
</ul>
<hr>
-<div class="subsection" id="Option-summary">
-<div class="header">
+<div class="subsection-level-extent" id="Option-summary">
+<div class="nav-panel">
<p>
Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Option-summary-1"></span><h4 class="subsection">3.2.1 Option summary</h4>
+<h4 class="subsection" id="Option-summary-1">3.2.1 Option summary</h4>
-<span id="index-options_002c-summary"></span>
+<a class="index-entry-id" id="index-options_002c-summary"></a>
<p>Here is a handy summary of the options; it is printed out when you run
-Dvips with no arguments or with the standard ‘<samp>--help</samp>’ option.
-<span id="index-_002d_002dhelp"></span>
+Dvips with no arguments or with the standard ‘<samp class="samp">--help</samp>’ option.
+<a class="index-entry-id" id="index-_002d_002dhelp"></a>
</p>
<pre class="verbatim">Usage: dvips [OPTION]... FILENAME[.dvi]
Convert DVI input files to PostScript.
@@ -856,118 +854,118 @@
<hr>
</div>
-<div class="subsection" id="Option-details">
-<div class="header">
+<div class="subsection-level-extent" id="Option-details">
+<div class="nav-panel">
<p>
Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Option-details-1"></span><h4 class="subsection">3.2.2 Option details</h4>
+<h4 class="subsection" id="Option-details-1">3.2.2 Option details</h4>
-<span id="index-option_002c-details-of"></span>
+<a class="index-entry-id" id="index-option_002c-details-of"></a>
<p>Many of the parameterless options listed here can be turned off by
-suffixing the option with a zero (‘<samp>0</samp>’); for instance, to turn off
-page reversal, use ‘<samp>-r0</samp>’. Such options are marked with a trailing
-‘<samp>*</samp>’.
+suffixing the option with a zero (‘<samp class="samp">0</samp>’); for instance, to turn off
+page reversal, use ‘<samp class="samp">-r0</samp>’. Such options are marked with a trailing
+‘<samp class="samp">*</samp>’.
</p>
-<dl compact="compact">
-<dt id='index-_002d'><span>‘<samp>-</samp>’<a href='#index-_002d' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-options_002c-reading-from-standard-input"></span>
-<span id="index-standard-input_002c-reading-options-from"></span>
+<dl class="table">
+<dt id='index-_002d'><span>‘<samp class="samp">-</samp>’<a class="copiable-link" href='#index-_002d'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-options_002c-reading-from-standard-input"></a>
+<a class="index-entry-id" id="index-standard-input_002c-reading-options-from"></a>
<p>Read additional options from standard input after processing the command
line.
</p>
</dd>
-<dt id='index-_002d_002dhelp-1'><span>‘<samp>--help</samp>’<a href='#index-_002d_002dhelp-1' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002d_002dhelp-1'><span>‘<samp class="samp">--help</samp>’<a class="copiable-link" href='#index-_002d_002dhelp-1'> ¶</a></span></dt>
<dd><p>Print a usage message and exit.
</p>
</dd>
-<dt id='index-_002d_002dversion'><span>‘<samp>--version</samp>’<a href='#index-_002d_002dversion' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002d_002dversion'><span>‘<samp class="samp">--version</samp>’<a class="copiable-link" href='#index-_002d_002dversion'> ¶</a></span></dt>
<dd><p>Print the version number and exit.
</p>
</dd>
-<dt id='index-_002da'><span>‘<samp>-a*</samp>’<a href='#index-_002da' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-memory_002c-conserving"></span>
+<dt id='index-_002da'><span>‘<samp class="samp">-a*</samp>’<a class="copiable-link" href='#index-_002da'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-memory_002c-conserving"></a>
<p>Conserve memory by making three passes over the DVI file instead
of two and only loading those characters actually used. Generally only
useful on machines with a very limited amount of memory, like some PCs.
</p>
</dd>
-<dt id='index-_002dA'><span>‘<samp>-A</samp>’<a href='#index-_002dA' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-odd-pages-only"></span>
+<dt id='index-_002dA'><span>‘<samp class="samp">-A</samp>’<a class="copiable-link" href='#index-_002dA'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-odd-pages-only"></a>
<p>Print only the odd pages. This option uses TeX
page numbers, not physical page numbers.
</p>
</dd>
-<dt id='index-_002db-num'><span>‘<samp>-b <var>num</var></samp>’<a href='#index-_002db-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-_002f_0023copies"></span>
-<span id="index-copies_002c-duplicated-page-bodies"></span>
-<span id="index-color-separations"></span>
-<p>Generate <var>num</var> copies of each page, but duplicating the page body
-rather than using the ‘<samp>/#copies</samp>’ PostScript variable. This can
-be useful in conjunction with a header file setting ‘<samp>bop-hook</samp>’ to
+<dt id='index-_002db-num'><span>‘<samp class="samp">-b <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002db-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002f_0023copies"></a>
+<a class="index-entry-id" id="index-copies_002c-duplicated-page-bodies"></a>
+<a class="index-entry-id" id="index-color-separations"></a>
+<p>Generate <var class="var">num</var> copies of each page, but duplicating the page body
+rather than using the ‘<samp class="samp">/#copies</samp>’ PostScript variable. This can
+be useful in conjunction with a header file setting ‘<samp class="samp">bop-hook</samp>’ to
do color separations or other neat tricks.
</p>
</dd>
-<dt id='index-_002dB'><span>‘<samp>-B</samp>’<a href='#index-_002dB' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-even-pages-only"></span>
-<span id="index-double_002dsided-printing"></span>
+<dt id='index-_002dB'><span>‘<samp class="samp">-B</samp>’<a class="copiable-link" href='#index-_002dB'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-even-pages-only"></a>
+<a class="index-entry-id" id="index-double_002dsided-printing"></a>
<p>Print only the even pages. This option uses TeX page numbers, not
physical page numbers.
</p>
</dd>
-<dt id='index-_002dbitmapfontenc-option'><span>‘<samp>-bitmapfontenc <var>option</var></samp>’<a href='#index-_002dbitmapfontenc-option' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-bitmap-font-encoding"></span>
-<p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings
-for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings
+<dt id='index-_002dbitmapfontenc-option'><span>‘<samp class="samp">-bitmapfontenc <var class="var">option</var></samp>’<a class="copiable-link" href='#index-_002dbitmapfontenc-option'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-bitmap-font-encoding"></a>
+<p>Turns bitmap font encoding to ‘<samp class="samp">off</samp>’, ‘<samp class="samp">on</samp>’ (no warnings
+for missing bitmap font encodings), or ‘<samp class="samp">strict</samp>’ (with warnings
for missing bitmap font encodings).
</p>
</dd>
-<dt id='index-_002dc-num'><span>‘<samp>-c <var>num</var></samp>’<a href='#index-_002dc-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-_002f_0023copies-1"></span>
-<span id="index-copies_002c-uncollated"></span>
-<span id="index-uncollated-copies"></span>
-<p>Generate <var>num</var> consecutive copies of every page, i.e., the output is
+<dt id='index-_002dc-num'><span>‘<samp class="samp">-c <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dc-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002f_0023copies-1"></a>
+<a class="index-entry-id" id="index-copies_002c-uncollated"></a>
+<a class="index-entry-id" id="index-uncollated-copies"></a>
+<p>Generate <var class="var">num</var> consecutive copies of every page, i.e., the output is
uncollated. This merely sets the builtin PostScript variable
-‘<samp>/#copies</samp>’.
+‘<samp class="samp">/#copies</samp>’.
</p>
</dd>
-<dt id='index-_002dC-num'><span>‘<samp>-C <var>num</var></samp>’<a href='#index-_002dC-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-copies_002c-collated"></span>
-<span id="index-collated-copies"></span>
-<p>Generate <var>num</var> copies, but collated (by replicating the data in the
-PostScript file). Slower than the ‘<samp>-c</samp>’ option, but easier on the
+<dt id='index-_002dC-num'><span>‘<samp class="samp">-C <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dC-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-copies_002c-collated"></a>
+<a class="index-entry-id" id="index-collated-copies"></a>
+<p>Generate <var class="var">num</var> copies, but collated (by replicating the data in the
+PostScript file). Slower than the ‘<samp class="samp">-c</samp>’ option, but easier on the
hands, and faster than resubmitting the same PostScript file multiple
times.
</p>
</dd>
-<dt id='index-_002dd-num'><span>‘<samp>-d <var>num</var></samp>’<a href='#index-_002dd-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-debugging-1"></span>
+<dt id='index-_002dd-num'><span>‘<samp class="samp">-d <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dd-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-debugging-1"></a>
<p>Set the debug flags, showing what Dvips (thinks it) is doing. This will
-work unless Dvips has been compiled without the ‘<samp>DEBUG</samp>’ option (not
-recommended). See <a href="#Debug-options">Debug options</a>, for the possible values of
-<var>num</var>. Use ‘<samp>-d -1</samp>’ as the first option for maximum output.
+work unless Dvips has been compiled without the ‘<samp class="samp">DEBUG</samp>’ option (not
+recommended). See <a class="xref" href="#Debug-options">Debug options</a>, for the possible values of
+<var class="var">num</var>. Use ‘<samp class="samp">-d -1</samp>’ as the first option for maximum output.
</p>
</dd>
-<dt id='index-_002dD-num'><span>‘<samp>-D <var>num</var></samp>’<a href='#index-_002dD-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-resolution_002c-setting"></span>
-<p>Set both the horizontal and vertical resolution to <var>num</var>, given in
+<dt id='index-_002dD-num'><span>‘<samp class="samp">-D <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dD-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-resolution_002c-setting"></a>
+<p>Set both the horizontal and vertical resolution to <var class="var">num</var>, given in
dpi (dots per inch). This affects the choice of bitmap fonts that are
loaded and also the positioning of letters in resident PostScript
fonts. Must be between 10 and 10000. This affects both the horizontal
and vertical resolution. If a high resolution (something greater than
-400 dpi, say) is selected, the ‘<samp>-Z</samp>’ flag should probably also be
+400 dpi, say) is selected, the ‘<samp class="samp">-Z</samp>’ flag should probably also be
used. If you are using fonts made with Metafont, such as Computer
-Modern, <samp>mktexpk</samp> needs to know about the value for <var>num</var>
+Modern, <samp class="file">mktexpk</samp> needs to know about the value for <var class="var">num</var>
that you use or Metafont will fail. See the file
-<a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
+<a class="url" href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
names for most devices.
</p>
</dd>
-<dt id='index-_002de-num'><span>‘<samp>-e <var>num</var></samp>’<a href='#index-_002de-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-maxdrift"></span>
-<span id="index-accuracy-in-positioning"></span>
-<span id="index-positioning-accuracy"></span>
+<dt id='index-_002de-num'><span>‘<samp class="samp">-e <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002de-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-maxdrift"></a>
+<a class="index-entry-id" id="index-accuracy-in-positioning"></a>
+<a class="index-entry-id" id="index-positioning-accuracy"></a>
<p>Maximum drift in pixels of each character from its ‘true’
resolution-independent position on the page. The default value of this
parameter is resolution dependent (it is the number of entries in the
@@ -979,10 +977,10 @@
letters in words.
</p>
</dd>
-<dt id='index-_002dE'><span>‘<samp>-E*</samp>’<a href='#index-_002dE' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-EPSF_002c-generating"></span>
-<span id="index-tight-bounding-box_002c-finding"></span>
-<span id="index-bounding-box_002c-finding-tight"></span>
+<dt id='index-_002dE'><span>‘<samp class="samp">-E*</samp>’<a class="copiable-link" href='#index-_002dE'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-EPSF_002c-generating"></a>
+<a class="index-entry-id" id="index-tight-bounding-box_002c-finding"></a>
+<a class="index-entry-id" id="index-bounding-box_002c-finding-tight"></a>
<p>Generate an EPSF file with a tight bounding box. This only looks at
marks made by characters and rules, not by any included graphics. In
addition, it gets the glyph metrics from the TFM file, so characters
@@ -993,32 +991,32 @@
like. (Of course, Dvips output, especially when using bitmap fonts, is
resolution-dependent and thus does not make very good EPSF files,
especially if the images are to be scaled; use these EPSF files with
-care.) For multiple page input files, also specify ‘<samp>-i</samp>’ to get
+care.) For multiple page input files, also specify ‘<samp class="samp">-i</samp>’ to get
each page as a separate EPSF file; otherwise, all the pages are overlaid
in the single output file.
</p>
</dd>
-<dt id='index-_002df'><span>‘<samp>-f*</samp>’<a href='#index-_002df' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-filter_002c-running-as-a"></span>
-<span id="index-standard-I_002fO"></span>
-<span id="index-pipes_002c-not-readable"></span>
-<span id="index-PRINTER_002c-avoided-with-_002df"></span>
+<dt id='index-_002df'><span>‘<samp class="samp">-f*</samp>’<a class="copiable-link" href='#index-_002df'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-filter_002c-running-as-a"></a>
+<a class="index-entry-id" id="index-standard-I_002fO"></a>
+<a class="index-entry-id" id="index-pipes_002c-not-readable"></a>
+<a class="index-entry-id" id="index-PRINTER_002c-avoided-with-_002df"></a>
<p>Run as a filter. Read the DVI file from standard input and write the
PostScript to standard output. The standard input must be seekable, so
it cannot be a pipe. If your input must be a pipe, write a shell script
that copies the pipe output to a temporary file and then points Dvips at
this file. This option also disables the automatic reading of the
-<code>PRINTER</code> environment variable; use ‘<samp>-P$PRINTER</samp>’ after the
-‘<samp>-f</samp>’ to read it anyway. It also turns off the automatic sending of
-control-D if it was turned on with the ‘<samp>-F</samp>’ option or in the
-configuration file; use ‘<samp>-F</samp>’ after the ‘<samp>-f</samp>’ to send it anyway.
+<code class="code">PRINTER</code> environment variable; use ‘<samp class="samp">-P$PRINTER</samp>’ after the
+‘<samp class="samp">-f</samp>’ to read it anyway. It also turns off the automatic sending of
+control-D if it was turned on with the ‘<samp class="samp">-F</samp>’ option or in the
+configuration file; use ‘<samp class="samp">-F</samp>’ after the ‘<samp class="samp">-f</samp>’ to send it anyway.
</p>
</dd>
-<dt id='index-_002dF'><span>‘<samp>-F*</samp>’<a href='#index-_002dF' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-EOF"></span>
-<span id="index-control_002dD"></span>
-<span id="index-printer_002c-driving-directly"></span>
-<span id="index-spooler_002c-lacking"></span>
+<dt id='index-_002dF'><span>‘<samp class="samp">-F*</samp>’<a class="copiable-link" href='#index-_002dF'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-EOF"></a>
+<a class="index-entry-id" id="index-control_002dD"></a>
+<a class="index-entry-id" id="index-printer_002c-driving-directly"></a>
+<a class="index-entry-id" id="index-spooler_002c-lacking"></a>
<p>Write control-D (ASCII code 4) as the very last character of the
PostScript file. This is useful when Dvips is driving the printer
directly instead of working through a spooler, as is common on personal
@@ -1026,35 +1024,35 @@
recommended.
</p>
</dd>
-<dt id='index-_002dG'><span>‘<samp>-G*</samp>’<a href='#index-_002dG' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-low-characters_002c-shifting"></span>
-<span id="index-non_002dprinting-characters_002c-shifting"></span>
+<dt id='index-_002dG'><span>‘<samp class="samp">-G*</samp>’<a class="copiable-link" href='#index-_002dG'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-low-characters_002c-shifting"></a>
+<a class="index-entry-id" id="index-non_002dprinting-characters_002c-shifting"></a>
<p>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions.
This was useful to work around bugs in old versions of Adobe’s PDF
reader. It’s more likely to cause problems nowadays.
</p>
</dd>
-<dt id='index-_002dh-name'><span>‘<samp>-h <var>name</var></samp>’<a href='#index-_002dh-name' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-header-file_002c-downloading"></span>
-<span id="index-userdict_002c-used-for-header-files"></span>
-<p>Prepend <var>name</var> as an additional header file, or, if <var>name</var> is
-‘<samp>-</samp>’, suppress inclusion of default header files. If <code>-h</code> is
+<dt id='index-_002dh-name'><span>‘<samp class="samp">-h <var class="var">name</var></samp>’<a class="copiable-link" href='#index-_002dh-name'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-header-file_002c-downloading"></a>
+<a class="index-entry-id" id="index-userdict_002c-used-for-header-files"></a>
+<p>Prepend <var class="var">name</var> as an additional header file, or, if <var class="var">name</var> is
+‘<samp class="samp">-</samp>’, suppress inclusion of default header files. If <code class="code">-h</code> is
given multiple times, the headers are included in the order given.
Any definitions in the header file get added to the PostScript
-‘<samp>userdict</samp>’.
+‘<samp class="samp">userdict</samp>’.
</p>
</dd>
-<dt id='index-_002di'><span>‘<samp>-i*</samp>’<a href='#index-_002di' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-sections-output_002c-in-separate-files"></span>
-<span id="index-multiple-output-files"></span>
-<span id="index-output-files_002c-multiple"></span>
-<p>Make each section be a separate file; a <em>section</em> is a part of the
+<dt id='index-_002di'><span>‘<samp class="samp">-i*</samp>’<a class="copiable-link" href='#index-_002di'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-sections-output_002c-in-separate-files"></a>
+<a class="index-entry-id" id="index-multiple-output-files"></a>
+<a class="index-entry-id" id="index-output-files_002c-multiple"></a>
+<p>Make each section be a separate file; a <em class="dfn">section</em> is a part of the
document processed independently, most often created to avoid memory
overflow. The filenames are created replacing the suffix of the
supplied output file name by a three-digit sequence number. This option
-is most often used in conjunction with the ‘<samp>-S</samp>’ option which sets
-the maximum section length in pages; if ‘<samp>-i</samp>’ is specified and
-‘<samp>-S</samp>’ is not, each page is output as a separate file. For instance,
+is most often used in conjunction with the ‘<samp class="samp">-S</samp>’ option which sets
+the maximum section length in pages; if ‘<samp class="samp">-i</samp>’ is specified and
+‘<samp class="samp">-S</samp>’ is not, each page is output as a separate file. For instance,
some phototypesetters cannot print more than ten or so consecutive pages
before running out of steam; these options can be used to automatically
split a book into ten-page sections, each to its own file.
@@ -1062,33 +1060,33 @@
<p>On the other hand, if your document uses very large fonts or very
large included figures, Dvips might take it upon itself to split the
output into unwanted sections, to try to avoid overflowing printer
-memory. See <a href="#Headers-and-memory-usage">Headers and memory usage</a>, for ways to handle this.
+memory. See <a class="xref" href="#Headers-and-memory-usage">Headers and memory usage</a>, for ways to handle this.
</p>
</dd>
-<dt id='index-_002dj-for-partial-font-downloading'><span>‘<samp>-j*</samp>’<a href='#index-_002dj-for-partial-font-downloading' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002dj-for-partial-font-downloading'><span>‘<samp class="samp">-j*</samp>’<a class="copiable-link" href='#index-_002dj-for-partial-font-downloading'> ¶</a></span></dt>
<dd><p>Download only needed characters from Type 1 fonts. This is the
default in the current release. Some debugging flags trace this operation
-(see <a href="#Debug-options">Debug options</a>). You can also control partial downloading on a
-per-font basis (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>).
+(see <a class="pxref" href="#Debug-options">Debug options</a>). You can also control partial downloading on a
+per-font basis (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>).
</p>
</dd>
-<dt id='index-_002dk-for-cropmarks'><span>‘<samp>-k*</samp>’<a href='#index-_002dk-for-cropmarks' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-cropmarks"></span>
-<span id="index-crop_002epro"></span>
+<dt id='index-_002dk-for-cropmarks'><span>‘<samp class="samp">-k*</samp>’<a class="copiable-link" href='#index-_002dk-for-cropmarks'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-cropmarks"></a>
+<a class="index-entry-id" id="index-crop_002epro"></a>
<p>Print crop marks. This option increases the paper size (which should be
-specified, either with a paper size special or with the ‘<samp>-T</samp>’
+specified, either with a paper size special or with the ‘<samp class="samp">-T</samp>’
option) by a half inch in each dimension. It translates each page by a
quarter inch and draws cross-style crop marks. It is mostly useful with
typesetters that can set the page size automatically. This works by
-downloading <samp>crop.pro</samp>.
+downloading <samp class="file">crop.pro</samp>.
</p>
</dd>
-<dt id='index-_002dK'><span>‘<samp>-K*</samp>’<a href='#index-_002dK' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-comments_002c-removing-included"></span>
-<span id="index-_0025_0025Page_002c-removing"></span>
+<dt id='index-_002dK'><span>‘<samp class="samp">-K*</samp>’<a class="copiable-link" href='#index-_002dK'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-comments_002c-removing-included"></a>
+<a class="index-entry-id" id="index-_0025_0025Page_002c-removing"></a>
<p>Remove comments in included PostScript graphics, font files, and
headers; only necessary to get around bugs in spoolers or PostScript
-post-processing programs. Specifically, the ‘<samp>%%Page</samp>’
+post-processing programs. Specifically, the ‘<samp class="samp">%%Page</samp>’
comments, when left in, often cause difficulties. Use of this flag can
cause other graphics to fail, however, since the PostScript header
macros from some software packages read portion the input stream line by
@@ -1095,92 +1093,92 @@
line, searching for a particular comment.
</p>
</dd>
-<dt id='index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-l [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-last-page-printed"></span>
-<span id="index-page_002c-last-printed"></span>
-<span id="index-page-numbers_002c-multiple-repetitions-of"></span>
-<span id="index-physical-page-number_002c-and-_002dl"></span>
-<span id="index-absolute-page-number_002c-and-_002dl"></span>
-<p>The last page printed will be the first one numbered <var>num</var>; the
+<dt id='index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp class="samp">-l [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</samp>’<a class="copiable-link" href='#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-last-page-printed"></a>
+<a class="index-entry-id" id="index-page_002c-last-printed"></a>
+<a class="index-entry-id" id="index-page-numbers_002c-multiple-repetitions-of"></a>
+<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dl"></a>
+<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dl"></a>
+<p>The last page printed will be the first one numbered <var class="var">num</var>; the
default is the last page in the document.
</p>
-<p>By default, <var>num</var> is compared to TeX’s idea of the page number
-(more precisely, the <code>\count0</code> value written in the DVI file).
-But if <var>num</var> is prefixed by an equals sign, then it (and the
-argument to the ‘<samp>-p</samp>’ option, if specified) is treated as a
-physical (absolute) page number, Thus, using ‘<samp>-l =9</samp>’ will end the
+<p>By default, <var class="var">num</var> is compared to TeX’s idea of the page number
+(more precisely, the <code class="code">\count0</code> value written in the DVI file).
+But if <var class="var">num</var> is prefixed by an equals sign, then it (and the
+argument to the ‘<samp class="samp">-p</samp>’ option, if specified) is treated as a
+physical (absolute) page number, Thus, using ‘<samp class="samp">-l =9</samp>’ will end the
output with the ninth page of the document, no matter what the pages
are actually numbered.
</p>
-<p>On the other hand, if <var>pageseq</var> is specified, the <var>pageseq</var>th
+<p>On the other hand, if <var class="var">pageseq</var> is specified, the <var class="var">pageseq</var>th
occurrence of the given TeX page number is used. For example,
-‘<samp>-l 99.2</samp>’ says to end with the second page numbered 99 in the
-document. The ‘<samp>=</samp>’ and <var>lastseq</var> features aren’t useful
+‘<samp class="samp">-l 99.2</samp>’ says to end with the second page numbered 99 in the
+document. The ‘<samp class="samp">=</samp>’ and <var class="var">lastseq</var> features aren’t useful
together.
</p>
</dd>
-<dt id='index-_002dL'><span>‘<samp>-L*</samp>’<a href='#index-_002dL' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-papersize-special_002c-first-vs_002e-last"></span>
-<p>By default or with <code>-L1</code>, the last ‘<samp>papersize</samp>’ special wins;
-with <code>-L0</code>, the first special wins. See <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>.
+<dt id='index-_002dL'><span>‘<samp class="samp">-L*</samp>’<a class="copiable-link" href='#index-_002dL'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-papersize-special_002c-first-vs_002e-last"></a>
+<p>By default or with <code class="code">-L1</code>, the last ‘<samp class="samp">papersize</samp>’ special wins;
+with <code class="code">-L0</code>, the first special wins. See <a class="xref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>.
</p>
</dd>
-<dt id='index-_002dlandscaperotate'><span>‘<samp>-landscaperotate*</samp>’<a href='#index-_002dlandscaperotate' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-landscaperotate"></span>
+<dt id='index-_002dlandscaperotate'><span>‘<samp class="samp">-landscaperotate*</samp>’<a class="copiable-link" href='#index-_002dlandscaperotate'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-landscaperotate"></a>
<p>When looking for matching paper sizes, permit rotation of page content
on the page to match the given size; the default, as of Dvips 2022.1,
is not to do this. It should not be needed in modern systems with
normal print spoolers, and can be harmful when converting to PDF
-(see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>). This option accepts an optional
+(see <a class="pxref" href="#Config-file-paper-sizes">Configuration file paper size command</a>). This option accepts an optional
suffix of 0 (to explicitly disable) or 1 (to explicitly enable); if
the option is specified without a suffix, it enables the behavior.
</p>
</dd>
-<dt id='index-_002dm'><span>‘<samp>-m*</samp>’<a href='#index-_002dm' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-manual-feed"></span>
+<dt id='index-_002dm'><span>‘<samp class="samp">-m*</samp>’<a class="copiable-link" href='#index-_002dm'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-manual-feed"></a>
<p>Specify manual feed, if supported by the output device.
</p>
</dd>
-<dt id='index-_002dmode-mode'><span>‘<samp>-mode <var>mode</var></samp>’<a href='#index-_002dmode-mode' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-mode-name_002c-specifying"></span>
-<span id="index-Metafont-mode_002c-specifying"></span>
-<p>Use <var>mode</var> as the Metafont device name for path searching and font
+<dt id='index-_002dmode-mode'><span>‘<samp class="samp">-mode <var class="var">mode</var></samp>’<a class="copiable-link" href='#index-_002dmode-mode'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-mode-name_002c-specifying"></a>
+<a class="index-entry-id" id="index-Metafont-mode_002c-specifying"></a>
+<p>Use <var class="var">mode</var> as the Metafont device name for path searching and font
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 <var>mode</var>.
-See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see
-<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+assume the fonts are in a subdirectory named <var class="var">mode</var>.
+See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite class="cite">Kpathsea</cite>. If Metafont does not understand the <var class="var">mode</var> name, see
+<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite class="cite">Kpathsea</cite>.
</p>
</dd>
-<dt id='index-_002dM'><span>‘<samp>-M*</samp>’<a href='#index-_002dM' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-font-generation_002c-avoiding"></span>
-<span id="index-mktexpk_002c-avoiding"></span>
-<span id="index-missfont_002elog"></span>
-<p>Turns off automatic font generation (<samp>mktexpk</samp>). If
-<code>mktexpk</code>, the invocation is appended to a file
-<samp>missfont.log</samp> (by default) in the current directory. You can then
+<dt id='index-_002dM'><span>‘<samp class="samp">-M*</samp>’<a class="copiable-link" href='#index-_002dM'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-font-generation_002c-avoiding"></a>
+<a class="index-entry-id" id="index-mktexpk_002c-avoiding"></a>
+<a class="index-entry-id" id="index-missfont_002elog"></a>
+<p>Turns off automatic font generation (<samp class="file">mktexpk</samp>). If
+<code class="code">mktexpk</code>, the invocation is appended to a file
+<samp class="file">missfont.log</samp> (by default) in the current directory. You can then
execute the log file to create the missing files after fixing the
problem.
-<span id="index-TEXMFOUTPUT"></span>
-<span id="index-MISSFONT_005fLOG"></span>
+<a class="index-entry-id" id="index-TEXMFOUTPUT"></a>
+<a class="index-entry-id" id="index-MISSFONT_005fLOG"></a>
If the current directory is not writable and the environment variable or
-configuration file value ‘<samp>TEXMFOUTPUT</samp>’ is set, its value is used.
-Otherwise, nothing is written. The name ‘<samp>missfont.log</samp>’ is
-overridden by the ‘<samp>MISSFONT_LOG</samp>’ environment variable or
+configuration file value ‘<samp class="samp">TEXMFOUTPUT</samp>’ is set, its value is used.
+Otherwise, nothing is written. The name ‘<samp class="samp">missfont.log</samp>’ is
+overridden by the ‘<samp class="samp">MISSFONT_LOG</samp>’ environment variable or
configuration file value.
</p>
</dd>
-<dt id='index-_002dn-num'><span>‘<samp>-n <var>num</var></samp>’<a href='#index-_002dn-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-maximum-pages-printed"></span>
-<span id="index-pages_002c-maximum-printed"></span>
-<p>Print at most <var>num</var> pages. Default is 100000.
+<dt id='index-_002dn-num'><span>‘<samp class="samp">-n <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dn-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-maximum-pages-printed"></a>
+<a class="index-entry-id" id="index-pages_002c-maximum-printed"></a>
+<p>Print at most <var class="var">num</var> pages. Default is 100000.
</p>
</dd>
-<dt id='index-_002dN'><span>‘<samp>-N*</samp>’<a href='#index-_002dN' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-structured-comments"></span>
-<span id="index-TranScript"></span>
-<span id="index-_0025_0025Page_002c-not-generating"></span>
-<p>Turns off generation of structured comments such as ‘<samp>%%Page</samp>’; this
+<dt id='index-_002dN'><span>‘<samp class="samp">-N*</samp>’<a class="copiable-link" href='#index-_002dN'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-structured-comments"></a>
+<a class="index-entry-id" id="index-TranScript"></a>
+<a class="index-entry-id" id="index-_0025_0025Page_002c-not-generating"></a>
+<p>Turns off generation of structured comments such as ‘<samp class="samp">%%Page</samp>’; this
may be necessary on some systems 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.
@@ -1188,21 +1186,21 @@
such as Ghostview.
</p>
</dd>
-<dt id='index-_002dnoomega'><span>‘<samp>-noomega</samp>’<a href='#index-_002dnoomega' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-Omega-extensions"></span>
-<span id="index-pTeX-extensions"></span>
+<dt id='index-_002dnoomega'><span>‘<samp class="samp">-noomega</samp>’<a class="copiable-link" href='#index-_002dnoomega'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-Omega-extensions"></a>
+<a class="index-entry-id" id="index-pTeX-extensions"></a>
<p>Disable the use of Omega extensions when interpreting DVI
-files. By default, the additional opcodes ‘<samp>129</samp>’ and ‘<samp>134</samp>’
+files. By default, the additional opcodes ‘<samp class="samp">129</samp>’ and ‘<samp class="samp">134</samp>’
are recognized by Dvips as Omega or pTeX extensions and interpreted as
requests to set 2-byte characters.
</p>
</dd>
-<dt id='index-_002dnoptex'><span>‘<samp>-noptex</samp>’<a href='#index-_002dnoptex' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-pTeX-extensions-1"></span>
+<dt id='index-_002dnoptex'><span>‘<samp class="samp">-noptex</samp>’<a class="copiable-link" href='#index-_002dnoptex'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-pTeX-extensions-1"></a>
<p>Disable the use of pTeX extensions when interpreting DVI files. By
-default, the additional opcodes ‘<samp>130</samp>’ and ‘<samp>135</samp>’ are
+default, the additional opcodes ‘<samp class="samp">130</samp>’ and ‘<samp class="samp">135</samp>’ are
recognized by Dvips as Omega extensions and interpreted as requests to
-set 3-byte characters, and ‘<samp>255</samp>’ as request to change the
+set 3-byte characters, and ‘<samp class="samp">255</samp>’ as request to change the
typesetting direction.
</p>
<p>The only drawback is that the virtual font array will (at least
@@ -1210,127 +1208,127 @@
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</samp>’, or both by using ‘<samp>-noomega</samp>’
+extension by using ‘<samp class="samp">-noptex</samp>’, or both by using ‘<samp class="samp">-noomega</samp>’
(but please do send a bug report if you find such problems,
-see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>).
+see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>).
</p>
</dd>
-<dt id='index-_002do-name'><span>‘<samp>-o <var>name</var></samp>’<a href='#index-_002do-name' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-output_002c-redirecting"></span>
-<span id="index-standard-output_002c-output-to"></span>
-<p>Send output to the file <var>name</var>. If ‘<samp>-o</samp>’ is specified without
-<var>name</var> (i.e., it is the last thing on the command line), the
-default is ‘<samp><var>file</var>.ps</samp>’ where the input DVI file was
-‘<samp><var>file</var>.dvi</samp>’. If ‘<samp>-o</samp>’ isn’t given at all, the
+<dt id='index-_002do-name'><span>‘<samp class="samp">-o <var class="var">name</var></samp>’<a class="copiable-link" href='#index-_002do-name'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-output_002c-redirecting"></a>
+<a class="index-entry-id" id="index-standard-output_002c-output-to"></a>
+<p>Send output to the file <var class="var">name</var>. If ‘<samp class="samp">-o</samp>’ is specified without
+<var class="var">name</var> (i.e., it is the last thing on the command line), the
+default is ‘<samp class="samp"><var class="var">file</var>.ps</samp>’ where the input DVI file was
+‘<samp class="samp"><var class="var">file</var>.dvi</samp>’. If ‘<samp class="samp">-o</samp>’ isn’t given at all, the
configuration file default is used.
</p>
-<span id="index-popen-for-output"></span>
-<span id="index-_002d-as-output-filename"></span>
-<span id="index-_0021-starting-output-filename"></span>
-<span id="index-_007c-starting-output-filename"></span>
-<span id="index-lpr-spooler_002c-MS_002dDOS-emulation"></span>
-<span id="index-spooling-to-lpr-on-MS_002dDOS"></span>
-<p>If <var>name</var> is ‘<samp>-</samp>’, output goes to standard output. If the first
-character of <var>name</var> is ‘<samp>!</samp>’ or ‘<samp>|</samp>’, then the remainder will
-be used as an argument to <code>popen</code>; thus, specifying ‘<samp>|lpr</samp>’ as
+<a class="index-entry-id" id="index-popen-for-output"></a>
+<a class="index-entry-id" id="index-_002d-as-output-filename"></a>
+<a class="index-entry-id" id="index-_0021-starting-output-filename"></a>
+<a class="index-entry-id" id="index-_007c-starting-output-filename"></a>
+<a class="index-entry-id" id="index-lpr-spooler_002c-MS_002dDOS-emulation"></a>
+<a class="index-entry-id" id="index-spooling-to-lpr-on-MS_002dDOS"></a>
+<p>If <var class="var">name</var> is ‘<samp class="samp">-</samp>’, output goes to standard output. If the first
+character of <var class="var">name</var> is ‘<samp class="samp">!</samp>’ or ‘<samp class="samp">|</samp>’, then the remainder will
+be used as an argument to <code class="code">popen</code>; thus, specifying ‘<samp class="samp">|lpr</samp>’ as
the output file will automatically queue the file for printing as
usual. (The MS-DOS version will print to the local printer device
-<samp>PRN</samp> when <var>name</var> is ‘<samp>|lpr</samp>’ and a program by that name
+<samp class="file">PRN</samp> when <var class="var">name</var> is ‘<samp class="samp">|lpr</samp>’ and a program by that name
cannot be found.)
</p>
-<p>‘<samp>-o</samp>’ disables the automatic reading of the <code>PRINTER</code>
+<p>‘<samp class="samp">-o</samp>’ disables the automatic reading of the <code class="code">PRINTER</code>
environment variable, and turns off the automatic sending of control-D.
-See the ‘<samp>-f</samp>’ option for how to override this.
+See the ‘<samp class="samp">-f</samp>’ option for how to override this.
</p>
</dd>
-<dt id='index-_002dO-x_002doffset_002cy_002doffset'><span>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’<a href='#index-_002dO-x_002doffset_002cy_002doffset' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-offset-pages"></span>
-<span id="index-printer-offset"></span>
-<p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
-pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). The origin of the page is shifted from the default position
+<dt id='index-_002dO-x_002doffset_002cy_002doffset'><span>‘<samp class="samp">-O <var class="var">x-offset</var>,<var class="var">y-offset</var></samp>’<a class="copiable-link" href='#index-_002dO-x_002doffset_002cy_002doffset'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-offset-pages"></a>
+<a class="index-entry-id" id="index-printer-offset"></a>
+<p>Move the origin by <var class="var">x-offset</var>,<var class="var">y-offset</var>, a comma-separated
+pair of dimensions such as ‘<samp class="samp">.1in,-.3cm</samp>’ (see <a class="pxref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>). The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
the paper) by this amount. This is usually best specified in the
printer-specific configuration file.
</p>
-<span id="index-testpage_002etex"></span>
+<a class="index-entry-id" id="index-testpage_002etex"></a>
<p>This is useful for a printer that consistently offsets output pages by a
-certain amount. You can use the file <samp>testpage.tex</samp> to determine
+certain amount. You can use the file <samp class="file">testpage.tex</samp> to determine
the correct value for your printer. Be sure to do several runs with the
-same <code>O</code> value—some printers vary widely from run to run.
+same <code class="code">O</code> value—some printers vary widely from run to run.
</p>
-<span id="index-bop_002dhook_002c-and-offset-pages"></span>
+<a class="index-entry-id" id="index-bop_002dhook_002c-and-offset-pages"></a>
<p>If your printer offsets every other page consistently, instead of every
-page, your best recourse is to use ‘<samp>bop-hook</samp>’ (see <a href="#PostScript-hooks">PostScript hooks</a>).
+page, your best recourse is to use ‘<samp class="samp">bop-hook</samp>’ (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>).
</p>
</dd>
-<dt id='index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-p [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-first-page-printed"></span>
-<span id="index-page_002c-first-printed"></span>
-<span id="index-physical-page-number_002c-and-_002dp"></span>
-<span id="index-absolute-page-number_002c-and-_002dp"></span>
-<p>Exactly analogous to <code>-l</code> (q.v.), but specifying the first page
+<dt id='index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp class="samp">-p [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</samp>’<a class="copiable-link" href='#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-first-page-printed"></a>
+<a class="index-entry-id" id="index-page_002c-first-printed"></a>
+<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dp"></a>
+<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dp"></a>
+<p>Exactly analogous to <code class="code">-l</code> (q.v.), but specifying the first page
number to be printed (processed).
</p>
</dd>
-<dt id='index-_002dpp-first_002dlast'><span>‘<samp>-pp <var>first</var>-<var>last</var></samp>’<a href='#index-_002dpp-first_002dlast' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-page-range"></span>
-<span id="index-_002dpp-range"></span>
-<p>Print pages <var>first</var> through <var>last</var>; equivalent to ‘<samp>-p
-<var>first</var> -l <var>last</var></samp>’, except that multiple ‘<samp>-pp</samp>’ options
-accumulate, unlike ‘<samp>-p</samp>’ and ‘<samp>-l</samp>’. The ‘<samp>-</samp>’ separator can
-also be ‘<samp>:</samp>’.
+<dt id='index-_002dpp-first_002dlast'><span>‘<samp class="samp">-pp <var class="var">first</var>-<var class="var">last</var></samp>’<a class="copiable-link" href='#index-_002dpp-first_002dlast'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-page-range"></a>
+<a class="index-entry-id" id="index-_002dpp-range"></a>
+<p>Print pages <var class="var">first</var> through <var class="var">last</var>; equivalent to ‘<samp class="samp">-p
+<var class="var">first</var> -l <var class="var">last</var></samp>’, except that multiple ‘<samp class="samp">-pp</samp>’ options
+accumulate, unlike ‘<samp class="samp">-p</samp>’ and ‘<samp class="samp">-l</samp>’. The ‘<samp class="samp">-</samp>’ separator can
+also be ‘<samp class="samp">:</samp>’.
</p>
</dd>
-<dt id='index-_002dP-printer'><span>‘<samp>-P <var>printer</var></samp>’<a href='#index-_002dP-printer' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-config_002eps"></span>
-<p>Read the configuration file <samp>config.<var>printer</var></samp>
-(<samp><var>printer</var>.cfg</samp> on MS-DOS), which typically sets the output
-name (most likely ‘<samp>o |lpr -P<var>printer</var></samp>’), resolution, Metafont
+<dt id='index-_002dP-printer'><span>‘<samp class="samp">-P <var class="var">printer</var></samp>’<a class="copiable-link" href='#index-_002dP-printer'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-config_002eps"></a>
+<p>Read the configuration file <samp class="file">config.<var class="var">printer</var></samp>
+(<samp class="file"><var class="var">printer</var>.cfg</samp> on MS-DOS), which typically sets the output
+name (most likely ‘<samp class="samp">o |lpr -P<var class="var">printer</var></samp>’), resolution, Metafont
mode, and perhaps other printer-specific defaults. It works best to
-put sitewide defaults in the one master ‘<samp>config.ps</samp>’ file and only
+put sitewide defaults in the one master ‘<samp class="samp">config.ps</samp>’ file and only
things that vary from printer to printer in the
-‘<samp>config.<var>printer</var></samp>’ files; ‘<samp>config.ps</samp>’ is read before
-‘<samp>config.<var>printer</var></samp>’.
+‘<samp class="samp">config.<var class="var">printer</var></samp>’ files; ‘<samp class="samp">config.ps</samp>’ is read before
+‘<samp class="samp">config.<var class="var">printer</var></samp>’.
</p>
<p>A configuration file for eventual creation of Adobe PDF files is
-provided in ‘<samp>config.pdf</samp>’ and thus can be loaded with
-‘<samp>-Ppdf</samp>’. It will try to include Type 1 outline fonts into the
-PostScript file (see <a href="#Hypertext-caveats">Hypertext caveats</a>).
+provided in ‘<samp class="samp">config.pdf</samp>’ and thus can be loaded with
+‘<samp class="samp">-Ppdf</samp>’. It will try to include Type 1 outline fonts into the
+PostScript file (see <a class="pxref" href="#Hypertext-caveats">Hypertext caveats</a>).
</p>
-<p>If no ‘<samp>-P</samp>’ or ‘<samp>-o</samp>’ is given, the environment variable
-<code>PRINTER</code> is checked. If that variable exists, and a corresponding
-<samp>config.<var>printer</var></samp> (<samp><var>printer</var>.cfg</samp> on MS-DOS) file
+<p>If no ‘<samp class="samp">-P</samp>’ or ‘<samp class="samp">-o</samp>’ is given, the environment variable
+<code class="code">PRINTER</code> is checked. If that variable exists, and a corresponding
+<samp class="file">config.<var class="var">printer</var></samp> (<samp class="file"><var class="var">printer</var>.cfg</samp> on MS-DOS) file
exists, it is read.
-See <a href="#Configuration-file-searching">Configuration file searching</a>.
+See <a class="xref" href="#Configuration-file-searching">Configuration file searching</a>.
</p>
</dd>
-<dt id='index-_002dq'><span>‘<samp>-q*</samp>’<a href='#index-_002dq' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-quiet-operation"></span>
-<span id="index-silent-operation"></span>
-<span id="index-warnings_002c-suppressing"></span>
+<dt id='index-_002dq'><span>‘<samp class="samp">-q*</samp>’<a class="copiable-link" href='#index-_002dq'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-quiet-operation"></a>
+<a class="index-entry-id" id="index-silent-operation"></a>
+<a class="index-entry-id" id="index-warnings_002c-suppressing"></a>
<p>Run quietly. Don’t chatter about pages converted, etc.,
and report no warnings (only errors) to standard error.
</p>
</dd>
-<dt id='index-_002dr'><span>‘<samp>-r*</samp>’<a href='#index-_002dr' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-reverse-pagination"></span>
+<dt id='index-_002dr'><span>‘<samp class="samp">-r*</samp>’<a class="copiable-link" href='#index-_002dr'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-reverse-pagination"></a>
<p>Output pages in reverse order. By default, page 1 is output first.
</p>
</dd>
-<dt id='index-_002dR'><span>‘<samp>-R</samp>’<a href='#index-_002dR' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-security"></span>
-<span id="index-shell-command-execution_002c-disabling"></span>
-<span id="index-absolute-filenames_002c-disabling"></span>
-<span id="index-_002e_002e_002drelative-filenames"></span>
-<p>Run securely. ‘<samp>-R2</samp>’ disables both shell command execution in
-<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of PostScript graphics files</a>)
-and config files (via the ‘<samp>E</samp>’ option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp>..</samp>-relative
-filenames. ‘<samp>-R1</samp>’, the default, forbids shell escapes but allows
-absolute filenames. ‘<samp>-R0</samp>’ allows both.
+<dt id='index-_002dR'><span>‘<samp class="samp">-R</samp>’<a class="copiable-link" href='#index-_002dR'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-security"></a>
+<a class="index-entry-id" id="index-shell-command-execution_002c-disabling"></a>
+<a class="index-entry-id" id="index-absolute-filenames_002c-disabling"></a>
+<a class="index-entry-id" id="index-_002e_002e_002drelative-filenames"></a>
+<p>Run securely. ‘<samp class="samp">-R2</samp>’ disables both shell command execution in
+<code class="code">\special</code> (via ‘<samp class="samp">`</samp>’, see <a class="pxref" href="#Dynamic-creation-of-graphics">Dynamic creation of PostScript graphics files</a>)
+and config files (via the ‘<samp class="samp">E</samp>’ option, see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp class="file">..</samp>-relative
+filenames. ‘<samp class="samp">-R1</samp>’, the default, forbids shell escapes but allows
+absolute filenames. ‘<samp class="samp">-R0</samp>’ allows both.
</p>
</dd>
-<dt id='index-_002ds'><span>‘<samp>-s*</samp>’<a href='#index-_002ds' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-save_002frestore_002c-generating-global"></span>
+<dt id='index-_002ds'><span>‘<samp class="samp">-s*</samp>’<a class="copiable-link" href='#index-_002ds'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-save_002frestore_002c-generating-global"></a>
<p>Enclose the output in a global save/restore pair. This causes the file
to not be truly conformant, and is thus not recommended, but is useful
if you are driving a deficient printer directly and thus don’t care too
@@ -1337,75 +1335,75 @@
much about the portability of the output to other environments.
</p>
</dd>
-<dt id='index-_002dS-num'><span>‘<samp>-S <var>num</var></samp>’<a href='#index-_002dS-num' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002dS-num'><span>‘<samp class="samp">-S <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dS-num'> ¶</a></span></dt>
<dd><p>Set the maximum number of pages in each ‘section’. This option is most
-commonly used with the ‘<samp>-i</samp>’ option; see its description above for
+commonly used with the ‘<samp class="samp">-i</samp>’ option; see its description above for
more information.
</p>
</dd>
-<dt id='index-_002dt-papertype'><span>‘<samp>-t <var>papertype</var></samp>’<a href='#index-_002dt-papertype' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-paper-type"></span>
-<span id="index-media"></span>
-<span id="index-letter-papertype"></span>
-<span id="index-legal-papertype"></span>
-<span id="index-ledger-papertype"></span>
-<span id="index-a4-papertype"></span>
-<span id="index-a3-papertype"></span>
-<span id="index-landscape-papertype"></span>
-<span id="index-papersize-special_002c-and-no-_002dt"></span>
-<p>Set the paper type to <var>papertype</var>, usually defined in one of the
+<dt id='index-_002dt-papertype'><span>‘<samp class="samp">-t <var class="var">papertype</var></samp>’<a class="copiable-link" href='#index-_002dt-papertype'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-paper-type"></a>
+<a class="index-entry-id" id="index-media"></a>
+<a class="index-entry-id" id="index-letter-papertype"></a>
+<a class="index-entry-id" id="index-legal-papertype"></a>
+<a class="index-entry-id" id="index-ledger-papertype"></a>
+<a class="index-entry-id" id="index-a4-papertype"></a>
+<a class="index-entry-id" id="index-a3-papertype"></a>
+<a class="index-entry-id" id="index-landscape-papertype"></a>
+<a class="index-entry-id" id="index-papersize-special_002c-and-no-_002dt"></a>
+<p>Set the paper type to <var class="var">papertype</var>, usually defined in one of the
configuration files, along with the appropriate PostScript code to
-select it (see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>).
-</p><ul class="no-bullet">
-<li>- You can also specify a <var>papertype</var> of ‘<samp>landscape</samp>’,
+select it (see <a class="pxref" href="#Config-file-paper-sizes">Configuration file paper size command</a>).
+</p><ul class="itemize mark-minus">
+<li>You can also specify a <var class="var">papertype</var> of ‘<samp class="samp">landscape</samp>’,
which rotates a document by 90 degrees.
-</li><li>- To rotate a document whose paper type is not the default, you
-can use the ‘<samp>-t</samp>’ option twice, once for the paper type, and once
-for ‘<samp>landscape</samp>’.
-</li><li>- In general, you should not use any ‘<samp>-t</samp>’ option when
-using a ‘<samp>papersize</samp>’ special, which some LaTeX packages (e.g.,
-‘<samp>hyperref</samp>’) insert.
-</li><li>- One exception is when using a nonstandard paper size that is not
-already defined in <samp>config.ps</samp>; in this case, you need to specify
-‘<samp>-t unknown</samp>’.
-</li><li>- Another exception is when producing multi-page files for further
-processing; use ‘<samp>-t nopaper</samp>’ to omit any paper size
+</li><li>To rotate a document whose paper type is not the default, you
+can use the ‘<samp class="samp">-t</samp>’ option twice, once for the paper type, and once
+for ‘<samp class="samp">landscape</samp>’.
+</li><li>In general, you should not use any ‘<samp class="samp">-t</samp>’ option when
+using a ‘<samp class="samp">papersize</samp>’ special, which some LaTeX packages (e.g.,
+‘<samp class="samp">hyperref</samp>’) insert.
+</li><li>One exception is when using a nonstandard paper size that is not
+already defined in <samp class="file">config.ps</samp>; in this case, you need to specify
+‘<samp class="samp">-t unknown</samp>’.
+</li><li>Another exception is when producing multi-page files for further
+processing; use ‘<samp class="samp">-t nopaper</samp>’ to omit any paper size
information in the output. (If you just have a single page document,
-you can use ‘<samp>-E</samp>’ to get pure EPSF output.)
+you can use ‘<samp class="samp">-E</samp>’ to get pure EPSF output.)
</li></ul>
</dd>
-<dt id='index-_002dtitle-str'><span>‘<samp>-title <var>string</var></samp>’<a href='#index-_002dtitle-str' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-title_002c-specifying"></span>
-<span id="index-output-title_002c-specifying"></span>
-<span id="index-document-title_002c-specifying"></span>
-<span id="index-_0025_0025Title"></span>
-<p>Use <var>string</var> as the title in the generated PostScript
-(<code>%%Title</code>). If not specified, the default is the basename of the
-input file; for example, running <code>dvips /foo/bar.dvi</code> will have a
-<code>%%Title</code> of ‘<samp>bar.dvi</samp>’.
+<dt id='index-_002dtitle-str'><span>‘<samp class="samp">-title <var class="var">string</var></samp>’<a class="copiable-link" href='#index-_002dtitle-str'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-title_002c-specifying"></a>
+<a class="index-entry-id" id="index-output-title_002c-specifying"></a>
+<a class="index-entry-id" id="index-document-title_002c-specifying"></a>
+<a class="index-entry-id" id="index-_0025_0025Title"></a>
+<p>Use <var class="var">string</var> as the title in the generated PostScript
+(<code class="code">%%Title</code>). If not specified, the default is the basename of the
+input file; for example, running <code class="code">dvips /foo/bar.dvi</code> will have a
+<code class="code">%%Title</code> of ‘<samp class="samp">bar.dvi</samp>’.
</p>
</dd>
-<dt id='index-_002dT-hsize_002cvsize'><span>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’<a href='#index-_002dT-hsize_002cvsize' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated
-pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). It overrides any paper size special in the DVI file. Be
+<dt id='index-_002dT-hsize_002cvsize'><span>‘<samp class="samp">-T <var class="var">hsize</var>,<var class="var">vsize</var></samp>’<a class="copiable-link" href='#index-_002dT-hsize_002cvsize'> ¶</a></span></dt>
+<dd><p>Set the paper size to (<var class="var">hsize</var>,<var class="var">vsize</var>), a comma-separated
+pair of dimensions such as ‘<samp class="samp">.1in,-.3cm</samp>’ (see <a class="pxref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>). It overrides any paper size special in the DVI file. Be
careful, as the paper size will stick to a predefined size if there is
-one close enough. To disable this behavior, use ‘<samp>-tunknown</samp>’.
+one close enough. To disable this behavior, use ‘<samp class="samp">-tunknown</samp>’.
</p>
</dd>
-<dt id='index-_002du-psmapfile'><span>‘<samp>-u <var>psmapfile</var></samp>’<a href='#index-_002du-psmapfile' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-PostScript-font-alias-file"></span>
-<span id="index-resident-fonts_002c-different-in-different-printers"></span>
-<p>Set <var>psmapfile</var> to be the file that dvips uses for looking up
-PostScript font aliases. If <var>psmapfile</var> begins with a ‘<samp>+</samp>’
+<dt id='index-_002du-psmapfile'><span>‘<samp class="samp">-u <var class="var">psmapfile</var></samp>’<a class="copiable-link" href='#index-_002du-psmapfile'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-PostScript-font-alias-file"></a>
+<a class="index-entry-id" id="index-resident-fonts_002c-different-in-different-printers"></a>
+<p>Set <var class="var">psmapfile</var> to be the file that dvips uses for looking up
+PostScript font aliases. If <var class="var">psmapfile</var> begins with a ‘<samp class="samp">+</samp>’
character, then the rest of the name is used as the name of the map file,
and the map file is appended to the list of map files (instead of replacing
-the list). In either case, if the name has no extension, then ‘<samp>.map</samp>’
+the list). In either case, if the name has no extension, then ‘<samp class="samp">.map</samp>’
is added at the end.
</p>
</dd>
-<dt id='index-_002dU'><span>‘<samp>-U*</samp>’<a href='#index-_002dU' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-Xerox-4045"></span>
+<dt id='index-_002dU'><span>‘<samp class="samp">-U*</samp>’<a class="copiable-link" href='#index-_002dU'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-Xerox-4045"></a>
<p>Disable a PostScript virtual memory-saving optimization that stores the
character metric information in the same string that is used to store
the bitmap information. This is only necessary when driving the Xerox
@@ -1414,18 +1412,18 @@
printer.
</p>
</dd>
-<dt id='index-_002dv'><span>‘<samp>-v</samp>’<a href='#index-_002dv' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002dv'><span>‘<samp class="samp">-v</samp>’<a class="copiable-link" href='#index-_002dv'> ¶</a></span></dt>
<dd><p>Print the dvips version number and exit.
</p>
</dd>
-<dt id='index-_002dV'><span>‘<samp>-V*</samp>’<a href='#index-_002dV' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002dV'><span>‘<samp class="samp">-V*</samp>’<a class="copiable-link" href='#index-_002dV'> ¶</a></span></dt>
<dd><p>Download non-resident PostScript fonts as bitmaps. This requires use
-<span id="index-mtpk"></span>
-<span id="index-gsftopk"></span>
-<span id="index-pstopk"></span>
-of <code>mtpk</code> or <code>gsftopk</code> or <code>pstopk</code> or some combination
+<a class="index-entry-id" id="index-mtpk"></a>
+<a class="index-entry-id" id="index-gsftopk"></a>
+<a class="index-entry-id" id="index-pstopk"></a>
+of <code class="code">mtpk</code> or <code class="code">gsftopk</code> or <code class="code">pstopk</code> or some combination
thereof to generate the required bitmap fonts; these programs are
-supplied with Dvips. The bitmap must be put into <samp>psfonts.map</samp> as
+supplied with Dvips. The bitmap must be put into <samp class="file">psfonts.map</samp> as
the downloadable file for that font. This is useful only for those
fonts for which you do not have real outlines, being downloaded to
printers that have no resident fonts, i.e., very rarely.
@@ -1432,50 +1430,50 @@
</p>
</dd>
-<dt id='index-_002dx-num'><span>‘<samp>-x <var>num</var></samp>’<a href='#index-_002dx-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-magnification_002c-overriding-DVI"></span>
-<p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em>. Overrides
+<dt id='index-_002dx-num'><span>‘<samp class="samp">-x <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dx-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-magnification_002c-overriding-DVI"></a>
+<p>Set the magnification ratio to <em class="math"><var class="var">num</var>/1000</em>. Overrides
the magnification specified in the DVI file. Must be between 10 and
100000. It is recommended that you use standard magstep values (1095,
1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total
-number of PK files generated. <var>num</var> may be a real number, not an
+number of PK files generated. <var class="var">num</var> may be a real number, not an
integer, for increased precision.
</p>
</dd>
-<dt id='index-_002dX-num'><span>‘<samp>-X <var>num</var></samp>’<a href='#index-_002dX-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-resolution"></span>
-<p>Set the horizontal resolution in dots per inch to <var>num</var>.
+<dt id='index-_002dX-num'><span>‘<samp class="samp">-X <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dX-num'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-resolution"></a>
+<p>Set the horizontal resolution in dots per inch to <var class="var">num</var>.
</p>
</dd>
-<dt id='index-magnification_002c-vertical'><span>‘<samp>-y <var>num</var></samp>’<a href='#index-magnification_002c-vertical' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em> times the
+<dt id='index-magnification_002c-vertical'><span>‘<samp class="samp">-y <var class="var">num</var></samp>’<a class="copiable-link" href='#index-magnification_002c-vertical'> ¶</a></span></dt>
+<dd><p>Set the magnification ratio to <em class="math"><var class="var">num</var>/1000</em> times the
magnification specified in the DVI file. See
-‘<samp>-x</samp>’ above.
+‘<samp class="samp">-x</samp>’ above.
</p>
</dd>
-<dt id='index-_002dY-num'><span>‘<samp>-Y <var>num</var></samp>’<a href='#index-_002dY-num' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Set the vertical resolution in dots per inch to <var>num.</var>
-<span id="index-resolution-1"></span>
+<dt id='index-_002dY-num'><span>‘<samp class="samp">-Y <var class="var">num</var></samp>’<a class="copiable-link" href='#index-_002dY-num'> ¶</a></span></dt>
+<dd><p>Set the vertical resolution in dots per inch to <var class="var">num.</var>
+<a class="index-entry-id" id="index-resolution-1"></a>
</p>
</dd>
-<dt id='index-_002dz-for-recognizing-hyperdvi'><span>‘<samp>-z*</samp>’<a href='#index-_002dz-for-recognizing-hyperdvi' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-hyperdvi-extensions_002c-enabling"></span>
-<span id="index-distillation_002c-and-_002dz"></span>
-<span id="index-PDF-files_002c-option-for"></span>
-<span id="index-html-specials_002c-and-_002dz"></span>
-<p>Pass ‘<samp>html</samp>’ hyperdvi specials through to the output for eventual
+<dt id='index-_002dz-for-recognizing-hyperdvi'><span>‘<samp class="samp">-z*</samp>’<a class="copiable-link" href='#index-_002dz-for-recognizing-hyperdvi'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-hyperdvi-extensions_002c-enabling"></a>
+<a class="index-entry-id" id="index-distillation_002c-and-_002dz"></a>
+<a class="index-entry-id" id="index-PDF-files_002c-option-for"></a>
+<a class="index-entry-id" id="index-html-specials_002c-and-_002dz"></a>
+<p>Pass ‘<samp class="samp">html</samp>’ hyperdvi specials through to the output for eventual
distillation into PDF. This is not enabled by default to avoid
including the header files unnecessarily, and use of temporary files in
-creating the output. See <a href="#Hypertext">HyperTeXt</a>.
+creating the output. See <a class="xref" href="#Hypertext">HyperTeXt</a>.
</p>
</dd>
-<dt id='index-_002dZ-for-compressing-bitmap-fonts'><span>‘<samp>-Z*</samp>’<a href='#index-_002dZ-for-compressing-bitmap-fonts' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-compressing-bitmap-fonts"></span>
+<dt id='index-_002dZ-for-compressing-bitmap-fonts'><span>‘<samp class="samp">-Z*</samp>’<a class="copiable-link" href='#index-_002dZ-for-compressing-bitmap-fonts'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-compressing-bitmap-fonts"></a>
<p>Compress bitmap fonts in the output file, thereby reducing the size of
what gets downloaded. Especially useful at high resolutions or when
very large fonts are used. May slow down printing, especially on early
68000-based PostScript printers. Generally recommend today, and can be
-enabled in the configuration file (see <a href="#Configuration-file-commands">Configuration file commands</a>).
+enabled in the configuration file (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>).
</p>
</dd>
</dl>
@@ -1484,87 +1482,87 @@
<hr>
</div>
</div>
-<div class="section" id="Environment-variables">
-<div class="header">
+<div class="section-level-extent" id="Environment-variables">
+<div class="nav-panel">
<p>
Next: <a href="#Config-files" accesskey="n" rel="next">Dvips configuration files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Environment-variables-1"></span><h3 class="section">3.3 Environment variables</h3>
+<h3 class="section" id="Environment-variables-1">3.3 Environment variables</h3>
-<span id="index-environment-variables"></span>
+<a class="index-entry-id" id="index-environment-variables"></a>
<p>Dvips looks for many environment variables, to define search paths and
other things. The path variables are read as needed, after all
configuration files are read, so they override values in the
-configuration files. (Except for <code>TEXCONFIG</code>, which defines where
+configuration files. (Except for <code class="code">TEXCONFIG</code>, which defines where
the configuration files themselves are found.)
</p>
-<p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of
+<p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite class="cite">Kpathsea</cite>, 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.
</p>
-<dl compact="compact">
-<dt id='index-DVIPSDEBUG'><span><code>DVIPSDEBUG</code><a href='#index-DVIPSDEBUG' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-KPATHSEA_005fDEBUG"></span>
+<dl class="vtable">
+<dt id='index-DVIPSDEBUG'><span><code class="code">DVIPSDEBUG</code><a class="copiable-link" href='#index-DVIPSDEBUG'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-KPATHSEA_005fDEBUG"></a>
<p>Write the absolute path names of any configuration or map files to
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
-<code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’
-(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is
-set to any value, it automatically turns on <code>DVIPSDEBUG</code>.)
+<code class="env">KPATHSEA_DEBUG</code> to ‘<samp class="samp">-1</samp>’
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>). (If <code class="env">KPATHSEA_DEBUG</code> is
+set to any value, it automatically turns on <code class="env">DVIPSDEBUG</code>.)
</p>
</dd>
-<dt id='index-DVIPSFONTS'><span><code>DVIPSFONTS</code><a href='#index-DVIPSFONTS' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-DVIPSFONTS'><span><code class="code">DVIPSFONTS</code><a class="copiable-link" href='#index-DVIPSFONTS'> ¶</a></span></dt>
<dd><p>Default path to search for all fonts. Overrides all the font path
config file options and other environment variables (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported
-file formats</a> in <cite>Kpathsea</cite>).
+file formats</a> in <cite class="cite">Kpathsea</cite>).
</p>
</dd>
-<dt id='index-DVIPSHEADERS'><span><code>DVIPSHEADERS</code><a href='#index-DVIPSHEADERS' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Default path to search for PostScript header files. Overrides the ‘<samp>H</samp>’
-config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>).
+<dt id='index-DVIPSHEADERS'><span><code class="code">DVIPSHEADERS</code><a class="copiable-link" href='#index-DVIPSHEADERS'> ¶</a></span></dt>
+<dd><p>Default path to search for PostScript header files. Overrides the ‘<samp class="samp">H</samp>’
+config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>).
</p>
</dd>
-<dt id='index-DVIPSMAKEPK'><span><code>DVIPSMAKEPK</code><a href='#index-DVIPSMAKEPK' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-mktexpk_002c-changing-name"></span>
-<p>Overrides ‘<samp>mktexpk</samp>’ as the name of the program to invoke to
+<dt id='index-DVIPSMAKEPK'><span><code class="code">DVIPSMAKEPK</code><a class="copiable-link" href='#index-DVIPSMAKEPK'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-mktexpk_002c-changing-name"></a>
+<p>Overrides ‘<samp class="samp">mktexpk</samp>’ as the name of the program to invoke to
create missing PK fonts. You can change the arguments passed to the
-<code>mktexpk</code> program with the <code>MAKETEXPK</code> environment
-variable; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>.
+<code class="code">mktexpk</code> program with the <code class="code">MAKETEXPK</code> environment
+variable; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite class="cite">Kpathsea</cite>.
</p>
</dd>
-<dt id='index-DVIPSRC'><span><code>DVIPSRC</code><a href='#index-DVIPSRC' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp>config.ps</samp> but before any
+<dt id='index-DVIPSRC'><span><code class="code">DVIPSRC</code><a class="copiable-link" href='#index-DVIPSRC'> ¶</a></span></dt>
+<dd><p>Specifies the name of the startup file (see <a class="pxref" href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp class="file">config.ps</samp> but before any
printer-specific configuration files.
</p>
</dd>
-<dt id='index-DVIPSSIZES'><span><code>DVIPSSIZES</code><a href='#index-DVIPSSIZES' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></span>
-<p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp>R</samp>’
-definition in config files (see <a href="#Configuration-file-commands">Configuration file commands</a>).
+<dt id='index-DVIPSSIZES'><span><code class="code">DVIPSSIZES</code><a class="copiable-link" href='#index-DVIPSSIZES'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></a>
+<p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp class="samp">R</samp>’
+definition in config files (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>).
</p>
</dd>
-<dt id='index-PRINTER'><span><code>PRINTER</code><a href='#index-PRINTER' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-PRINTER'><span><code class="code">PRINTER</code><a class="copiable-link" href='#index-PRINTER'> ¶</a></span></dt>
<dd><p>Determine the default printer configuration file. (Dvips itself does
-not use <code>PRINTER</code> to determine the output destination in any way.)
+not use <code class="code">PRINTER</code> to determine the output destination in any way.)
</p>
</dd>
-<dt id='index-TEXCONFIG'><span><code>TEXCONFIG</code><a href='#index-TEXCONFIG' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-configuration-file-path"></span>
-<p>Path to search for Dvips’ <samp>config.<var>printer</var></samp> configuration
-files, including the base <samp>config.ps</samp>. Using this single
+<dt id='index-TEXCONFIG'><span><code class="code">TEXCONFIG</code><a class="copiable-link" href='#index-TEXCONFIG'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-configuration-file-path"></a>
+<p>Path to search for Dvips’ <samp class="file">config.<var class="var">printer</var></samp> configuration
+files, including the base <samp class="file">config.ps</samp>. Using this single
environment variable, you can override everything else. (The
-printer-specific configuration files are called <samp><var>printer</var>.cfg</samp>
-on MS-DOS, but <samp>config.ps</samp> is called by that name on all
+printer-specific configuration files are called <samp class="file"><var class="var">printer</var>.cfg</samp>
+on MS-DOS, but <samp class="file">config.ps</samp> is called by that name on all
platforms.)
</p>
</dd>
-<dt id='index-TEXPICTS'><span><code>TEXPICTS</code><a href='#index-TEXPICTS' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Path to search for included graphics files. Overrides the ‘<samp>S</samp>’
-config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). If not set,
-<code>TEXINPUTS</code> is looked for. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<dt id='index-TEXPICTS'><span><code class="code">TEXPICTS</code><a class="copiable-link" href='#index-TEXPICTS'> ¶</a></span></dt>
+<dd><p>Path to search for included graphics files. Overrides the ‘<samp class="samp">S</samp>’
+config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>). If not set,
+<code class="code">TEXINPUTS</code> is looked for. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>.
</p>
</dd>
</dl>
@@ -1572,86 +1570,86 @@
<hr>
</div>
-<div class="section" id="Config-files">
-<div class="header">
+<div class="section-level-extent" id="Config-files">
+<div class="nav-panel">
<p>
Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment variables</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Dvips-configuration-files"></span><h3 class="section">3.4 Dvips configuration files</h3>
+<h3 class="section" id="Dvips-configuration-files">3.4 Dvips configuration files</h3>
-<span id="index-configuration-files"></span>
+<a class="index-entry-id" id="index-configuration-files"></a>
-<p>This section describes in detail the Dvips-specific <samp>config.*</samp>
-device configuration files (called <samp>*.cfg</samp> on MS-DOS), which
-override the <samp>texmf.cnf</samp>
+<p>This section describes in detail the Dvips-specific <samp class="file">config.*</samp>
+device configuration files (called <samp class="file">*.cfg</samp> on MS-DOS), which
+override the <samp class="file">texmf.cnf</samp>
configuration files generic to Kpathsea which Dvips also reads
-(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>).
</p>
<p>For information about installing these files, including a prototype file
-you can copy, see <a href="#config_002eps-installation"><samp>config.ps</samp> installation</a>.
+you can copy, see <a class="pxref" href="#config_002eps-installation"><samp class="file">config.ps</samp> installation</a>.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></li>
<li><a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></li>
</ul>
<hr>
-<div class="subsection" id="Configuration-file-searching">
-<div class="header">
+<div class="subsection-level-extent" id="Configuration-file-searching">
+<div class="nav-panel">
<p>
Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Configuration-file-searching-1"></span><h4 class="subsection">3.4.1 Configuration file searching</h4>
+<h4 class="subsection" id="Configuration-file-searching-1">3.4.1 Configuration file searching</h4>
-<span id="index-configuration-file-searching"></span>
-<span id="index-searching-config-files_002c-order-of"></span>
+<a class="index-entry-id" id="index-configuration-file-searching"></a>
+<a class="index-entry-id" id="index-searching-config-files_002c-order-of"></a>
<p>The Dvips program loads many different configuration files, so that
parameters can be set globally across the system, on a per-device basis,
or individually by each user.
</p>
-<ol>
-<li> <span id="index-config_002eps_002c-searched-for"></span>
-Dvips first reads (if it exists) <samp>config.ps</samp>; it is searched for
+<ol class="enumerate">
+<li> <a class="index-entry-id" id="index-config_002eps_002c-searched-for"></a>
+Dvips first reads (if it exists) <samp class="file">config.ps</samp>; it is searched for
along the path for Dvips configuration files, as described in
-<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>.
-</li><li> <span id="index-_002edvipsrc_002c-searched-for"></span>
+</li><li> <a class="index-entry-id" id="index-_002edvipsrc_002c-searched-for"></a>
A user-specific startup file is loaded, so individual users can override
any options set in the global file. The environment variable
-<code>DVIPSRC</code>, if defined, is used as the specification of the startup
+<code class="code">DVIPSRC</code>, if defined, is used as the specification of the startup
file. If this variable is undefined, Dvips uses a platform-specific
default name. On Unix Dvips looks for the default startup file under
-the name <samp>$HOME/.dvipsrc</samp>, which is in the user’s home directory.
+the name <samp class="file">$HOME/.dvipsrc</samp>, which is in the user’s home directory.
On MS-DOS and MS-Windows, where users generally don’t have their private
-directories, the startup file is called <samp>dvips.ini</samp> and it is
+directories, the startup file is called <samp class="file">dvips.ini</samp> and it is
searched for along the path for Dvips configuration files (as described
-in <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are
+in <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>.); users are
expected to set this path as they see fit for their taste.
-</li><li> <span id="index-_002dPprinter_002c-and-config-file-searching"></span>
-The command line is read and parsed: if the ‘<samp>-P<var>device</var></samp>’ option
-is encountered, at that point <samp>config.<var>device</var></samp> is loaded.
+</li><li> <a class="index-entry-id" id="index-_002dPprinter_002c-and-config-file-searching"></a>
+The command line is read and parsed: if the ‘<samp class="samp">-P<var class="var">device</var></samp>’ option
+is encountered, at that point <samp class="file">config.<var class="var">device</var></samp> is loaded.
Thus, the printer configuration file can override anything in the
site-wide or user configuration file, and it can also override options
-in the command line up to the point that the ‘<samp>-P</samp>’ option was
+in the command line up to the point that the ‘<samp class="samp">-P</samp>’ option was
encountered. (On MS-DOS, the printer configuration files are called
-<samp><var>device</var>.cfg</samp>, since DOS doesn’t allow more than 3 characters
+<samp class="file"><var class="var">device</var>.cfg</samp>, since DOS doesn’t allow more than 3 characters
after the dot in filenames.)
-</li><li> <span id="index-PRINTER_002c-and-config-file-searching"></span>
-If no ‘<samp>-P</samp>’ option was specified, and also the ‘<samp>-o</samp>’ and
-‘<samp>-f</samp>’ command line options were not used, Dvips checks the
-environment variable <code>PRINTER</code>. If it exists, then
-<samp>config.<var>$PRINTER</var></samp> (<samp><var>$PRINTER</var>.cfg</samp> on MS-DOS) is
+</li><li> <a class="index-entry-id" id="index-PRINTER_002c-and-config-file-searching"></a>
+If no ‘<samp class="samp">-P</samp>’ option was specified, and also the ‘<samp class="samp">-o</samp>’ and
+‘<samp class="samp">-f</samp>’ command line options were not used, Dvips checks the
+environment variable <code class="code">PRINTER</code>. If it exists, then
+<samp class="file">config.<var class="var">$PRINTER</var></samp> (<samp class="file"><var class="var">$PRINTER</var>.cfg</samp> on MS-DOS) is
loaded (if it exists).
</li></ol>
-<p>Because the <samp>.dvipsrc</samp> file is read before the printer-specific
+<p>Because the <samp class="file">.dvipsrc</samp> file is read before the printer-specific
configuration files, individual users cannot override settings in the
-latter. On the other hand, the <code>TEXCONFIG</code> path can be set to
+latter. On the other hand, the <code class="code">TEXCONFIG</code> path can be set to
anything, so the users can always define their own printer-specific
configuration files to be found before the system’s.
</p>
@@ -1658,27 +1656,27 @@
<p>A few command-line options are treated specially, in that they are not
overridden by configuration files:
</p>
-<dl compact="compact">
-<dt><span>‘<samp>-D</samp>’</span></dt>
+<dl class="table">
+<dt>‘<samp class="samp">-D</samp>’</dt>
<dd><p>As well as setting the resolution, this unsets the mode, if the mode was
-previously set from a configuration file. If <samp>config.$PRINTER</samp> is
-read, however, any ‘<samp>D</samp>’ or ‘<samp>M</samp>’ lines from there will take
+previously set from a configuration file. If <samp class="file">config.$PRINTER</samp> is
+read, however, any ‘<samp class="samp">D</samp>’ or ‘<samp class="samp">M</samp>’ lines from there will take
effect.
</p>
</dd>
-<dt><span>‘<samp>-mode</samp>’</span></dt>
-<dd><p>This overrides any mode setting (‘<samp>M</samp>’ line) in configuration files.
-‘<samp>-mode</samp>’ does not affect the resolution.
+<dt>‘<samp class="samp">-mode</samp>’</dt>
+<dd><p>This overrides any mode setting (‘<samp class="samp">M</samp>’ line) in configuration files.
+‘<samp class="samp">-mode</samp>’ does not affect the resolution.
</p>
</dd>
-<dt><span>‘<samp>-o</samp>’</span></dt>
-<dd><p>This overrides any output setting (‘<samp>o</samp>’ line) in configuration files.
+<dt>‘<samp class="samp">-o</samp>’</dt>
+<dd><p>This overrides any output setting (‘<samp class="samp">o</samp>’ line) in configuration files.
</p>
</dd>
</dl>
<p>The purpose of these special cases is to (1) minimize the chance of
-having a mismatched mode and resolution (which ‘<samp>mktexpk</samp>’ cannot
+having a mismatched mode and resolution (which ‘<samp class="samp">mktexpk</samp>’ cannot
resolve), and (2) let command-line options override config files where
possible.
</p>
@@ -1685,15 +1683,15 @@
<hr>
</div>
-<div class="subsection" id="Configuration-file-commands">
-<div class="header">
+<div class="subsection-level-extent" id="Configuration-file-commands">
+<div class="nav-panel">
<p>
Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Configuration-file-commands-1"></span><h4 class="subsection">3.4.2 Configuration file commands</h4>
+<h4 class="subsection" id="Configuration-file-commands-1">3.4.2 Configuration file commands</h4>
-<span id="index-configuration-file-options"></span>
-<span id="index-Dvips-configuration-file-options"></span>
+<a class="index-entry-id" id="index-configuration-file-options"></a>
+<a class="index-entry-id" id="index-Dvips-configuration-file-options"></a>
<p>Most of the configuration file commands are similar to corresponding
command line options, but there are a few exceptions. When they are the
@@ -1700,115 +1698,115 @@
same, we omit the description here.
</p>
<p>As with command line options, many may be turned off by suffixing the
-letter with a zero (‘<samp>0</samp>’).
+letter with a zero (‘<samp class="samp">0</samp>’).
</p>
-<span id="index-comments_002c-in-configuration-files"></span>
-<span id="index-continuation-lines_002c-not-supported"></span>
+<a class="index-entry-id" id="index-comments_002c-in-configuration-files"></a>
+<a class="index-entry-id" id="index-continuation-lines_002c-not-supported"></a>
<p>Within a configuration file, empty lines, and lines starting with a
space, asterisk, equal sign, percent sign, or pound sign are ignored.
There is no provision for continuation lines.
</p>
-<dl compact="compact">
-<dt id='index-_0040-config-command-_0028define-paper-sizes_0029'><span>‘<samp>@ <var>name hsize vsize</var></samp>’<a href='#index-_0040-config-command-_0028define-paper-sizes_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Define paper sizes. See <a href="#Config-file-paper-sizes">Configuration file paper size command</a>.
+<dl class="table">
+<dt id='index-_0040-config-command-_0028define-paper-sizes_0029'><span>‘<samp class="samp">@ <var class="var">name hsize vsize</var></samp>’<a class="copiable-link" href='#index-_0040-config-command-_0028define-paper-sizes_0029'> ¶</a></span></dt>
+<dd><p>Define paper sizes. See <a class="xref" href="#Config-file-paper-sizes">Configuration file paper size command</a>.
</p>
</dd>
-<dt id='index-a-config-command-_0028conserve-memory_0029'><span>‘<samp>a*</samp>’<a href='#index-a-config-command-_0028conserve-memory_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-a-config-command-_0028conserve-memory_0029'><span>‘<samp class="samp">a*</samp>’<a class="copiable-link" href='#index-a-config-command-_0028conserve-memory_0029'> ¶</a></span></dt>
+<dd><p>Memory conservation. Same as ‘<samp class="samp">-a</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-b-config-command-_0028_0023copies_0029'><span>‘<samp>b <var>#copies</var></samp>’<a href='#index-b-config-command-_0028_0023copies_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-b-config-command-_0028_0023copies_0029'><span>‘<samp class="samp">b <var class="var">#copies</var></samp>’<a class="copiable-link" href='#index-b-config-command-_0028_0023copies_0029'> ¶</a></span></dt>
+<dd><p>Multiple copies. Same as ‘<samp class="samp">-b</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029'><span>‘<samp>bitmapfontenc <var>option</var></samp>’<a href='#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings
-for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings
+<dt id='index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029'><span>‘<samp class="samp">bitmapfontenc <var class="var">option</var></samp>’<a class="copiable-link" href='#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029'> ¶</a></span></dt>
+<dd><p>Turns bitmap font encoding to ‘<samp class="samp">off</samp>’, ‘<samp class="samp">on</samp>’ (no warnings
+for missing bitmap font encodings), or ‘<samp class="samp">strict</samp>’ (with warnings
for missing bitmap font encodings).
</p>
</dd>
-<dt id='index-c-config-command-_0028include-another-config-file_0029'><span>‘<samp>c <var>filename</var></samp>’<a href='#index-c-config-command-_0028include-another-config-file_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Include <var>filename</var> as an additional configuration file, read
+<dt id='index-c-config-command-_0028include-another-config-file_0029'><span>‘<samp class="samp">c <var class="var">filename</var></samp>’<a class="copiable-link" href='#index-c-config-command-_0028include-another-config-file_0029'> ¶</a></span></dt>
+<dd><p>Include <var class="var">filename</var> as an additional configuration file, read
immediately.
</p>
</dd>
-<dt id='index-D-config-command-_0028dpi_0029'><span>‘<samp>D <var>dpi</var></samp>’<a href='#index-D-config-command-_0028dpi_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-D-config-command-_0028dpi_0029'><span>‘<samp class="samp">D <var class="var">dpi</var></samp>’<a class="copiable-link" href='#index-D-config-command-_0028dpi_0029'> ¶</a></span></dt>
+<dd><p>Output resolution. Same as ‘<samp class="samp">-D</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-e-config-command-_0028maxdrift_0029'><span>‘<samp>e <var>num</var></samp>’<a href='#index-e-config-command-_0028maxdrift_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-e-config-command-_0028maxdrift_0029'><span>‘<samp class="samp">e <var class="var">num</var></samp>’<a class="copiable-link" href='#index-e-config-command-_0028maxdrift_0029'> ¶</a></span></dt>
+<dd><p>Max drift. Same as ‘<samp class="samp">-e</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-E-config-command-_0028shell-escape_0029'><span>‘<samp>E <var>command</var></samp>’<a href='#index-E-config-command-_0028shell-escape_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-system-in-config-file"></span>
-<span id="index-datestamp_002c-in-output"></span>
-<span id="index-shell-escape_002c-in-config-file"></span>
-<p>Executes the command listed with <code>system</code>(3); can be used to get
+<dt id='index-E-config-command-_0028shell-escape_0029'><span>‘<samp class="samp">E <var class="var">command</var></samp>’<a class="copiable-link" href='#index-E-config-command-_0028shell-escape_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-system-in-config-file"></a>
+<a class="index-entry-id" id="index-datestamp_002c-in-output"></a>
+<a class="index-entry-id" id="index-shell-escape_002c-in-config-file"></a>
+<p>Executes the command listed with <code class="code">system</code>(3); can be used to get
the current date into a header file for inclusion, for instance.
Possibly dangerous; this may be disabled, in which case a warning will
be printed if the option is used (and warnings are not suppressed).
</p>
</dd>
-<dt id='index-f-config-command-_0028filter_0029'><span>‘<samp>f*</samp>’<a href='#index-f-config-command-_0028filter_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dt><span>‘<samp>F</samp>’</span></dt>
-<dd><span id="index-F-config-command-_0028filter_0029"></span>
-<p>Run as a filter. Same as ‘<samp>-f</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-f-config-command-_0028filter_0029'><span>‘<samp class="samp">f*</samp>’<a class="copiable-link" href='#index-f-config-command-_0028filter_0029'> ¶</a></span></dt>
+<dt>‘<samp class="samp">F</samp>’</dt>
+<dd><a class="index-entry-id" id="index-F-config-command-_0028filter_0029"></a>
+<p>Run as a filter. Same as ‘<samp class="samp">-f</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-G-config-command-_0028character-shifting_0029'><span>‘<samp>G*</samp>’<a href='#index-G-config-command-_0028character-shifting_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’,
-see <a href="#Option-details">Option details</a>.
+<dt id='index-G-config-command-_0028character-shifting_0029'><span>‘<samp class="samp">G*</samp>’<a class="copiable-link" href='#index-G-config-command-_0028character-shifting_0029'> ¶</a></span></dt>
+<dd><p>Shift low-numbered characters; obsolete. Same as ‘<samp class="samp">-G</samp>’,
+see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-h-config-command-_0028download-additional-header_0029'><span>‘<samp>h <var>header</var></samp>’<a href='#index-h-config-command-_0028download-additional-header_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’; that is, the
-config file <code>h</code> directive suppresses any inclusion of standard
-headers (see <a href="#Option-details">Option details</a>).
+<dt id='index-h-config-command-_0028download-additional-header_0029'><span>‘<samp class="samp">h <var class="var">header</var></samp>’<a class="copiable-link" href='#index-h-config-command-_0028download-additional-header_0029'> ¶</a></span></dt>
+<dd><p>Prepend <var class="var">header</var> to output. Same as ‘<samp class="samp">h-</samp>’; that is, the
+config file <code class="code">h</code> directive suppresses any inclusion of standard
+headers (see <a class="pxref" href="#Option-details">Option details</a>).
</p>
</dd>
-<dt id='index-H-config-command-_0028PostScript-header-path_0029'><span>‘<samp>H <var>path</var></samp>’<a href='#index-H-config-command-_0028PostScript-header-path_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-header-path_002c-defining"></span>
-<span id="index-DVIPSHEADERS_002c-overrides-H"></span>
-<p>Use <var>path</var> to search for PostScript header files. The environment
-variable <code>DVIPSHEADERS</code> overrides this.
+<dt id='index-H-config-command-_0028PostScript-header-path_0029'><span>‘<samp class="samp">H <var class="var">path</var></samp>’<a class="copiable-link" href='#index-H-config-command-_0028PostScript-header-path_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-header-path_002c-defining"></a>
+<a class="index-entry-id" id="index-DVIPSHEADERS_002c-overrides-H"></a>
+<p>Use <var class="var">path</var> to search for PostScript header files. The environment
+variable <code class="code">DVIPSHEADERS</code> overrides this.
</p>
</dd>
-<dt id='index-i-config-command-_0028pages_002fsection_0029'><span>‘<samp>i <var>n</var></samp>’<a href='#index-i-config-command-_0028pages_002fsection_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-i-config-command-_0028pages_002fsection_0029'><span>‘<samp class="samp">i <var class="var">n</var></samp>’<a class="copiable-link" href='#index-i-config-command-_0028pages_002fsection_0029'> ¶</a></span></dt>
+<dd><p>Make multiple output files. Same as ‘<samp class="samp">-i -S <var class="var">n</var></samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-j-config-command-_0028partial-font-downloading_0029'><span>‘<samp>j*</samp>’<a href='#index-j-config-command-_0028partial-font-downloading_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-j-config-command-_0028partial-font-downloading_0029'><span>‘<samp class="samp">j*</samp>’<a class="copiable-link" href='#index-j-config-command-_0028partial-font-downloading_0029'> ¶</a></span></dt>
+<dd><p>Partially download Type 1 fonts. Same as ‘<samp class="samp">-j</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-K-config-command-_0028comment-removal_0029'><span>‘<samp>K*</samp>’<a href='#index-K-config-command-_0028comment-removal_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’,
-see <a href="#Option-details">Option details</a>.
+<dt id='index-K-config-command-_0028comment-removal_0029'><span>‘<samp class="samp">K*</samp>’<a class="copiable-link" href='#index-K-config-command-_0028comment-removal_0029'> ¶</a></span></dt>
+<dd><p>Remove comments from included PostScript files. Same as ‘<samp class="samp">-K</samp>’,
+see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-L-config-command-_0028last-paper-size-wins_0029'><span>‘<samp>L*</samp>’<a href='#index-L-config-command-_0028last-paper-size-wins_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-L-config-command-_0028last-paper-size-wins_0029'><span>‘<samp class="samp">L*</samp>’<a class="copiable-link" href='#index-L-config-command-_0028last-paper-size-wins_0029'> ¶</a></span></dt>
<dd><p>If zero, the first paper size specified is effective, else the last.
-Same as ‘<samp>-L</samp>’, see <a href="#Option-details">Option details</a>.
+Same as ‘<samp class="samp">-L</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-landscaperotate-config-command'><span>‘<samp>landscaperotate</samp>’<a href='#index-landscaperotate-config-command' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-landscaperotate-config-command'><span>‘<samp class="samp">landscaperotate</samp>’<a class="copiable-link" href='#index-landscaperotate-config-command'> ¶</a></span></dt>
<dd><p>Permit rotation of page content to match page size.
-Same as ‘<samp>-landscaperotate</samp>’, see <a href="#Option-details">Option details</a>.
+Same as ‘<samp class="samp">-landscaperotate</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-m-config-command-_0028available-memory_0029'><span>‘<samp>m <var>num</var></samp>’<a href='#index-m-config-command-_0028available-memory_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-memory-available"></span>
-<span id="index-printer-memory"></span>
-<p>Declare <var>num</var> as the memory available for fonts and strings in the
+<dt id='index-m-config-command-_0028available-memory_0029'><span>‘<samp class="samp">m <var class="var">num</var></samp>’<a class="copiable-link" href='#index-m-config-command-_0028available-memory_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-memory-available"></a>
+<a class="index-entry-id" id="index-printer-memory"></a>
+<p>Declare <var class="var">num</var> as the memory available for fonts and strings in the
printer. The compile-time default is 180000, but this is typically
-overridden by <samp>config.ps</samp> or other configuration files. This
+overridden by <samp class="file">config.ps</samp> or other configuration files. This
value must be accurate if memory conservation and document splitting
is to work correctly. To determine this value, send the following
file to the printer:
</p>
<div class="example">
-<pre class="example">%! Hey, we're PostScript
+<pre class="example-preformatted">%! Hey, we're PostScript
/Times-Roman findfont 30 scalefont setfont 144 432 moveto
vmstatus exch sub 40 string cvs show pop showpage
</pre></div>
@@ -1822,84 +1820,84 @@
and Ghostscript. In these cases, a value of, say, 10 million is
likely fine.
</p>
-<p>To go all out: If <var>num</var> is zero or negative, Dvips sets the
+<p>To go all out: If <var class="var">num</var> is zero or negative, Dvips sets the
available memory to a very large number (the maximum integer value in
C), the idea being that output is not to a printer and thus no
splitting of the output is desirable. The Dvips config file
-<samp>config.maxmem</samp> is provided to do this conveniently, namely with
-‘<samp>dvips -Pmaxmem</samp>’.
+<samp class="file">config.maxmem</samp> is provided to do this conveniently, namely with
+‘<samp class="samp">dvips -Pmaxmem</samp>’.
</p>
</dd>
-<dt id='index-M-config-command-_0028mf-mode_0029'><span>‘<samp>M <var>mode</var></samp>’<a href='#index-M-config-command-_0028mf-mode_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-M-config-command-_0028mf-mode_0029'><span>‘<samp class="samp">M <var class="var">mode</var></samp>’<a class="copiable-link" href='#index-M-config-command-_0028mf-mode_0029'> ¶</a></span></dt>
+<dd><p>Metafont mode. Same as ‘<samp class="samp">-mode</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-N--config-command-_0028disable-EPS_0029'><span>‘<samp>N*</samp>’<a href='#index-N--config-command-_0028disable-EPS_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-N-config-command-_0028disable-EPS_0029'><span>‘<samp class="samp">N*</samp>’<a class="copiable-link" href='#index-N-config-command-_0028disable-EPS_0029'> ¶</a></span></dt>
<dd><p>Disable structured comments. Beware: This also turns off displaying
page numbers or changing to specific page numbers in PostScript viewers.
-Same as ‘<samp>-N</samp>’, see <a href="#Option-details">Option details</a>.
+Same as ‘<samp class="samp">-N</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-o-config-command-_0028output-destination_0029'><span>‘<samp>o <var>name</var></samp>’<a href='#index-o-config-command-_0028output-destination_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-output-file_002c-setting"></span>
-<p>Send output to <var>name</var>. Same as ‘<samp>-o</samp>’, see <a href="#Option-details">Option details</a>.
-In the file <samp>config.foo</samp>, a setting like this is probably
+<dt id='index-o-config-command-_0028output-destination_0029'><span>‘<samp class="samp">o <var class="var">name</var></samp>’<a class="copiable-link" href='#index-o-config-command-_0028output-destination_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-output-file_002c-setting"></a>
+<p>Send output to <var class="var">name</var>. Same as ‘<samp class="samp">-o</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
+In the file <samp class="file">config.foo</samp>, a setting like this is probably
appropriate:
</p><div class="example">
-<pre class="example">o |lpr -Pfoo
+<pre class="example-preformatted">o |lpr -Pfoo
</pre></div>
-<p>The MS-DOS version will emulate spooling to <code>lpr</code> by printing to
-the local printer device <samp>PRN</samp> if it doesn’t find an executable
-program by that name in the current directory or along the <code>PATH</code>.
+<p>The MS-DOS version will emulate spooling to <code class="code">lpr</code> by printing to
+the local printer device <samp class="file">PRN</samp> if it doesn’t find an executable
+program by that name in the current directory or along the <code class="code">PATH</code>.
</p>
</dd>
-<dt id='index-O-config-command-_0028page-offsets_0029'><span>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’<a href='#index-O-config-command-_0028page-offsets_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-O-config-command-_0028page-offsets_0029'><span>‘<samp class="samp">O <var class="var">xoff</var>,<var class="var">yoff</var></samp>’<a class="copiable-link" href='#index-O-config-command-_0028page-offsets_0029'> ¶</a></span></dt>
+<dd><p>Origin offset. Same as ‘<samp class="samp">-O</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-p-config-command-_0028font-aliases_0029'><span>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’<a href='#index-p-config-command-_0028font-aliases_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-PostScript-font-alias-file-1"></span>
-<span id="index-resident-fonts_002c-different-in-different-printers-1"></span>
-<span id="index-_002bpsmapfile"></span>
-<p>Examine <var>name</var> for PostScript font aliases. Default is
-<samp>psfonts.map</samp>. This option allows you to specify different resident
-fonts that different printers may have. If <var>name</var> starts with a
-‘<samp>+</samp>’ character, then the rest of the name (after any leading spaces)
+<dt id='index-p-config-command-_0028font-aliases_0029'><span>‘<samp class="samp">p <span class="r">[+]</span><var class="var">name</var></samp>’<a class="copiable-link" href='#index-p-config-command-_0028font-aliases_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-PostScript-font-alias-file-1"></a>
+<a class="index-entry-id" id="index-resident-fonts_002c-different-in-different-printers-1"></a>
+<a class="index-entry-id" id="index-_002bpsmapfile"></a>
+<p>Examine <var class="var">name</var> for PostScript font aliases. Default is
+<samp class="file">psfonts.map</samp>. This option allows you to specify different resident
+fonts that different printers may have. If <var class="var">name</var> starts with a
+‘<samp class="samp">+</samp>’ character, then the rest of the name (after any leading spaces)
is used as an additional map file; thus, it is possible to have local
map files pointed to by local configuration files that append to the
global map file. This can be used for font families.
</p>
</dd>
-<dt id='index-P-config-command-_0028PK-path_0029'><span>‘<samp>P <var>path</var></samp>’<a href='#index-P-config-command-_0028PK-path_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-PKFONTS_002c-overrides-P"></span>
-<span id="index-TEXPKS_002c-overrides-P"></span>
-<span id="index-GLYPHFONTS_002c-overrides-P"></span>
-<span id="index-TEXFONTS_002c-overrides-P"></span>
-<p>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The
-<code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, and <code>TEXFONTS</code>
-environment variables override this. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<dt id='index-P-config-command-_0028PK-path_0029'><span>‘<samp class="samp">P <var class="var">path</var></samp>’<a class="copiable-link" href='#index-P-config-command-_0028PK-path_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-PKFONTS_002c-overrides-P"></a>
+<a class="index-entry-id" id="index-TEXPKS_002c-overrides-P"></a>
+<a class="index-entry-id" id="index-GLYPHFONTS_002c-overrides-P"></a>
+<a class="index-entry-id" id="index-TEXFONTS_002c-overrides-P"></a>
+<p>Use <var class="var">path</var> to search for bitmap PK font files is <var class="var">path</var>. The
+<code class="code">PKFONTS</code>, <code class="code">TEXPKS</code>, <code class="code">GLYPHFONTS</code>, and <code class="code">TEXFONTS</code>
+environment variables override this. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>.
</p>
</dd>
-<dt id='index-q-config-command-_0028quiet_0029'><span>‘<samp>q*</samp>’<a href='#index-q-config-command-_0028quiet_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dt><span>‘<samp>Q</samp>’</span></dt>
-<dd><span id="index-Q-config-command-_0028quiet_0029"></span>
-<p>Run quietly. Same as ‘<samp>-q</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-q-config-command-_0028quiet_0029'><span>‘<samp class="samp">q*</samp>’<a class="copiable-link" href='#index-q-config-command-_0028quiet_0029'> ¶</a></span></dt>
+<dt>‘<samp class="samp">Q</samp>’</dt>
+<dd><a class="index-entry-id" id="index-Q-config-command-_0028quiet_0029"></a>
+<p>Run quietly. Same as ‘<samp class="samp">-q</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-r-config-command-_0028page-reversal_0029'><span>‘<samp>r*</samp>’<a href='#index-r-config-command-_0028page-reversal_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-r-config-command-_0028page-reversal_0029'><span>‘<samp class="samp">r*</samp>’<a class="copiable-link" href='#index-r-config-command-_0028page-reversal_0029'> ¶</a></span></dt>
+<dd><p>Page reversal. Same as ‘<samp class="samp">-r</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-R-config-command-_0028fallback-resolution_0029'><span>‘<samp>R <var>num1 num2 …</var></samp>’<a href='#index-R-config-command-_0028fallback-resolution_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-fallback-resolutions"></span>
-<span id="index-default-resolutions"></span>
-<span id="index-last_002dresort-scaling_002c-with-R"></span>
+<dt id='index-R-config-command-_0028fallback-resolution_0029'><span>‘<samp class="samp">R <var class="var">num1 num2 …</var></samp>’<a class="copiable-link" href='#index-R-config-command-_0028fallback-resolution_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-fallback-resolutions"></a>
+<a class="index-entry-id" id="index-default-resolutions"></a>
+<a class="index-entry-id" id="index-last_002dresort-scaling_002c-with-R"></a>
<p>Define the list of default resolutions for PK fonts. If a font size
actually used in a document is not available and cannot be created,
Dvips will scale the font found at the closest of these resolutions to
the requested size, using PostScript scaling. The resulting output may
be ugly, and thus a warning is issued. To turn this last-resort scaling
-off, use a line with just the ‘<samp>R</samp>’ and no numbers.
+off, use a line with just the ‘<samp class="samp">R</samp>’ and no numbers.
</p>
<p>The given numbers must be sorted in increasing order; any number smaller
than the preceding one is ignored. This is because it is better to
@@ -1906,74 +1904,74 @@
scale a font up than down; scaling down can obliterate small features in
the character shape.
</p>
-<span id="index-DVIPSSIZES_002c-overrides-R"></span>
-<span id="index-TEXSIZES_002c-overrides-R"></span>
-<p>The environment and config file values ‘<samp>DVIPSSIZES</samp>’ or
-‘<samp>TEXSIZES</samp>’ override this configuration file setting.
+<a class="index-entry-id" id="index-DVIPSSIZES_002c-overrides-R"></a>
+<a class="index-entry-id" id="index-TEXSIZES_002c-overrides-R"></a>
+<p>The environment and config file values ‘<samp class="samp">DVIPSSIZES</samp>’ or
+‘<samp class="samp">TEXSIZES</samp>’ override this configuration file setting.
</p>
-<span id="index-default_005ftexsizes-Make-variable"></span>
-<p>If no ‘<samp>R</samp>’ settings or environment variables are specified, a list
+<a class="index-entry-id" id="index-default_005ftexsizes-Make-variable"></a>
+<p>If no ‘<samp class="samp">R</samp>’ settings or environment variables are specified, a list
compiled in during installation is used. This default list is defined by
-the Makefile variable ‘<samp>default_texsizes</samp>’, defined in the file
-<samp>make/paths.make</samp>.
+the Makefile variable ‘<samp class="samp">default_texsizes</samp>’, defined in the file
+<samp class="file">make/paths.make</samp>.
</p>
</dd>
-<dt id='index-s-config-command-_0028global-save_002frestore_0029'><span>‘<samp>s*</samp>’<a href='#index-s-config-command-_0028global-save_002frestore_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-s-config-command-_0028global-save_002frestore_0029'><span>‘<samp class="samp">s*</samp>’<a class="copiable-link" href='#index-s-config-command-_0028global-save_002frestore_0029'> ¶</a></span></dt>
+<dd><p>Output global save/restore. Same as ‘<samp class="samp">-s</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-S-config-command-_0028pict-path_0029'><span>‘<samp>S <var>path</var></samp>’<a href='#index-S-config-command-_0028pict-path_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-TEXPICTS_002c-overrides-S"></span>
-<span id="index-TEXINPUTS_002c-overrides-S"></span>
-<p>Use <var>path</var> to search for special illustrations (Encapsulated
-PostScript files or psfiles). The <code>TEXPICTS</code> and then
-<code>TEXINPUTS</code> environment variables override this.
+<dt id='index-S-config-command-_0028pict-path_0029'><span>‘<samp class="samp">S <var class="var">path</var></samp>’<a class="copiable-link" href='#index-S-config-command-_0028pict-path_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-TEXPICTS_002c-overrides-S"></a>
+<a class="index-entry-id" id="index-TEXINPUTS_002c-overrides-S"></a>
+<p>Use <var class="var">path</var> to search for special illustrations (Encapsulated
+PostScript files or psfiles). The <code class="code">TEXPICTS</code> and then
+<code class="code">TEXINPUTS</code> environment variables override this.
</p>
</dd>
-<dt id='index-T-config-command-_0028TFM-path_0029'><span>‘<samp>T <var>path</var></samp>’<a href='#index-T-config-command-_0028TFM-path_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-TFMFONTS_002c-overrides-T"></span>
-<span id="index-TEXFONTS_002c-overrides-T"></span>
-<p>Use <var>path</var> to search for TFM files. The <code>TFMFONTS</code> and then
-<code>TEXFONTS</code> environment variables overrides this. This path is used
+<dt id='index-T-config-command-_0028TFM-path_0029'><span>‘<samp class="samp">T <var class="var">path</var></samp>’<a class="copiable-link" href='#index-T-config-command-_0028TFM-path_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-TFMFONTS_002c-overrides-T"></a>
+<a class="index-entry-id" id="index-TEXFONTS_002c-overrides-T"></a>
+<p>Use <var class="var">path</var> to search for TFM files. The <code class="code">TFMFONTS</code> and then
+<code class="code">TEXFONTS</code> environment variables overrides this. This path is used
for resident fonts and fonts that can’t otherwise be found.
</p>
</dd>
-<dt id='index-U-config-command-_0028Xerox-4045_0029'><span>‘<samp>U*</samp>’<a href='#index-U-config-command-_0028Xerox-4045_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>.
+<dt id='index-U-config-command-_0028Xerox-4045_0029'><span>‘<samp class="samp">U*</samp>’<a class="copiable-link" href='#index-U-config-command-_0028Xerox-4045_0029'> ¶</a></span></dt>
+<dd><p>Work around bug in Xerox 4045 printer. Same as ‘<samp class="samp">-U</samp>’, see <a class="pxref" href="#Option-details">Option details</a>.
</p>
</dd>
-<dt id='index-V-config-command-_0028vf-path_0029'><span>‘<samp>V <var>path</var></samp>’<a href='#index-V-config-command-_0028vf-path_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-virtual-font-path"></span>
-<span id="index-device-dependency_002c-and-virtual-fonts"></span>
-<p>Use <var>path</var> to search for virtual font files. This may be
+<dt id='index-V-config-command-_0028vf-path_0029'><span>‘<samp class="samp">V <var class="var">path</var></samp>’<a class="copiable-link" href='#index-V-config-command-_0028vf-path_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-virtual-font-path"></a>
+<a class="index-entry-id" id="index-device-dependency_002c-and-virtual-fonts"></a>
+<p>Use <var class="var">path</var> to search for virtual font files. This may be
device-dependent if you use virtual fonts to simulate actual fonts on
different devices.
</p>
</dd>
-<dt id='index-W-config-command-_0028emit-warning_0029'><span>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’<a href='#index-W-config-command-_0028emit-warning_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-warning-messages_002c-defining"></span>
-<p>If <var>string</var> is supplied, write it to standard error after reading
-all the configuration files; with no <var>string</var>, cancel any previous
-‘<samp>W</samp>’ message. This is useful in the default configuration file to
+<dt id='index-W-config-command-_0028emit-warning_0029'><span>‘<samp class="samp">W <span class="r">[<var class="var">string</var>]</span></samp>’<a class="copiable-link" href='#index-W-config-command-_0028emit-warning_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-warning-messages_002c-defining"></a>
+<p>If <var class="var">string</var> is supplied, write it to standard error after reading
+all the configuration files; with no <var class="var">string</var>, cancel any previous
+‘<samp class="samp">W</samp>’ message. This is useful in the default configuration file to
remind users to specify a printer, for instance, or to notify users
about special characteristics of a particular printer.
</p>
</dd>
-<dt id='index-X-config-command-_0028horizontal-resolution_0029'><span>‘<samp>X <var>num</var></samp>’<a href='#index-X-config-command-_0028horizontal-resolution_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>).
+<dt id='index-X-config-command-_0028horizontal-resolution_0029'><span>‘<samp class="samp">X <var class="var">num</var></samp>’<a class="copiable-link" href='#index-X-config-command-_0028horizontal-resolution_0029'> ¶</a></span></dt>
+<dd><p>Horizontal resolution. Same as ‘<samp class="samp">-X</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>).
</p>
</dd>
-<dt id='index-Y-config-command-_0028vertical-resolution_0029'><span>‘<samp>Y <var>num</var></samp>’<a href='#index-Y-config-command-_0028vertical-resolution_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>).
+<dt id='index-Y-config-command-_0028vertical-resolution_0029'><span>‘<samp class="samp">Y <var class="var">num</var></samp>’<a class="copiable-link" href='#index-Y-config-command-_0028vertical-resolution_0029'> ¶</a></span></dt>
+<dd><p>Vertical resolution. Same as ‘<samp class="samp">-Y</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>).
</p>
</dd>
-<dt id='index-Z-config-command-_0028compress-fonts_0029'><span>‘<samp>Z*</samp>’<a href='#index-Z-config-command-_0028compress-fonts_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>).
+<dt id='index-Z-config-command-_0028compress-fonts_0029'><span>‘<samp class="samp">Z*</samp>’<a class="copiable-link" href='#index-Z-config-command-_0028compress-fonts_0029'> ¶</a></span></dt>
+<dd><p>Compress bitmap fonts. Same as ‘<samp class="samp">-Z</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>).
</p>
</dd>
-<dt id='index-z-config-command-_0028secure-mode_0029'><span>‘<samp>z*</samp>’<a href='#index-z-config-command-_0028secure-mode_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Disables execution of system commands, like ‘<samp>-R</samp>’
-(see <a href="#Option-details">Option details</a>). If ‘<samp>-R</samp>’ is specified
+<dt id='index-z-config-command-_0028secure-mode_0029'><span>‘<samp class="samp">z*</samp>’<a class="copiable-link" href='#index-z-config-command-_0028secure-mode_0029'> ¶</a></span></dt>
+<dd><p>Disables execution of system commands, like ‘<samp class="samp">-R</samp>’
+(see <a class="pxref" href="#Option-details">Option details</a>). If ‘<samp class="samp">-R</samp>’ is specified
on the command line, that takes precedence.
</p>
</dd>
@@ -1984,14 +1982,14 @@
</div>
</div>
</div>
-<div class="chapter" id="Paper-size-and-landscape">
-<div class="header">
+<div class="chapter-level-extent" id="Paper-size-and-landscape">
+<div class="nav-panel">
<p>
Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Paper-size-and-landscape-orientation"></span><h2 class="chapter">4 Paper size and landscape orientation</h2>
+<h2 class="chapter" id="Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</h2>
-<span id="index-paper-size_002c-general"></span>
+<a class="index-entry-id" id="index-paper-size_002c-general"></a>
<p>Most TeX documents at a particular site are designed to use the
local standard paper size (letter size in the United States, A4
@@ -1998,86 +1996,86 @@
elsewhere). The Dvips program can be customized either sitewide or
for a particular printer.
</p>
-<span id="index-landscape-orientation_002c-defined"></span>
-<span id="index-portrait-orientation_002c-defined"></span>
+<a class="index-entry-id" id="index-landscape-orientation_002c-defined"></a>
+<a class="index-entry-id" id="index-portrait-orientation_002c-defined"></a>
<p>On the other hand, plenty of documents are designed for other paper
sizes. For instance, you may want to design a document that has the
long edge of the paper horizontal. This can be useful when
typesetting booklets, brochures, complex tables, or many other
-documents. This type of paper orientation is called <em>landscape</em>
-orientation (the default orientation is called <em>portrait</em>).
+documents. This type of paper orientation is called <em class="dfn">landscape</em>
+orientation (the default orientation is called <em class="dfn">portrait</em>).
Alternatively, a document might be designed for ledger or A3 paper.
</p>
<p>Since the intended paper size in these cases is a document design
decision, not a printing decision, such information should be given in
the TeX file and not on the Dvips command line. For this reason,
-Dvips supports a ‘<samp>papersize</samp>’ special. It is hoped that this
+Dvips supports a ‘<samp class="samp">papersize</samp>’ special. It is hoped that this
special will become standard over time for TeX previewers and other
printer drivers.
</p>
-<p>Some LaTeX packages, e.g., ‘<samp>hyperref.sty</samp>’, write a
-‘<samp>papersize</samp>’ special into the DVI file. In this case, you need
+<p>Some LaTeX packages, e.g., ‘<samp class="samp">hyperref.sty</samp>’, write a
+‘<samp class="samp">papersize</samp>’ special into the DVI file. In this case, you need
not and should not attempt to override it manually.
</p>
-<ul class="section-toc">
-<li><a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></li>
+<ul class="mini-toc">
+<li><a href="#papersize-special" accesskey="1">‘<samp class="samp">papersize</samp>’ special</a></li>
<li><a href="#Config-file-paper-sizes" accesskey="2">Configuration file paper size command</a></li>
<li><a href="#Paper-trays" accesskey="3">Paper trays</a></li>
</ul>
<hr>
-<div class="section" id="papersize-special">
-<div class="header">
+<div class="section-level-extent" id="papersize-special">
+<div class="nav-panel">
<p>
Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="papersize-special-1"></span><h3 class="section">4.1 ‘<samp>papersize</samp>’ special</h3>
+<h3 class="section" id="papersize-special-1">4.1 ‘<samp class="samp">papersize</samp>’ special</h3>
-<span id="index-papersize-special"></span>
+<a class="index-entry-id" id="index-papersize-special"></a>
-<p>The format of the ‘<samp>papersize</samp>’ special is
+<p>The format of the ‘<samp class="samp">papersize</samp>’ special is
</p>
<div class="example">
-<pre class="example">\special{papersize=<var>width</var>,<var>height</var>}
+<pre class="example-preformatted">\special{papersize=<var class="var">width</var>,<var class="var">height</var>}
</pre></div>
-<p><var>width</var> is the horizontal size of the page, and <var>height</var> is the
+<p><var class="var">width</var> is the horizontal size of the page, and <var class="var">height</var> is the
vertical size. The dimensions supported are the same as for TeX;
namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp
(scaled points), bp (big points, the same as the default PostScript
unit), pc (picas), dd (didot points), and cc (ciceros).
</p>
-<span id="index-landscape_002c-as-_005cspecial"></span>
-<p>For a US letter size landscape document, the ‘<samp>papersize</samp>’ would be:
+<a class="index-entry-id" id="index-landscape_002c-as-_005cspecial"></a>
+<p>For a US letter size landscape document, the ‘<samp class="samp">papersize</samp>’ would be:
</p><div class="example">
-<pre class="example">\special{papersize=11in,8.5in}
+<pre class="example-preformatted">\special{papersize=11in,8.5in}
</pre></div>
-<p>An alternate specification of <code>landscape</code>:
+<p>An alternate specification of <code class="code">landscape</code>:
</p><div class="example">
-<pre class="example">\special{landscape}
+<pre class="example-preformatted">\special{landscape}
</pre></div>
<p>This is supported for backward compatibility, but it is hoped that
-eventually the ‘<samp>papersize</samp>’ comment will dominate.
+eventually the ‘<samp class="samp">papersize</samp>’ comment will dominate.
</p>
-<p>Of course, such a <code>\special</code> only informs Dvips of the desired
-paper size; you must also adjust <code>\hsize</code> and <code>\vsize</code> in your
+<p>Of course, such a <code class="code">\special</code> only informs Dvips of the desired
+paper size; you must also adjust <code class="code">\hsize</code> and <code class="code">\vsize</code> in your
TeX document typeset to those dimensions.
</p>
-<span id="index-unknown_002c-paper-format-for-_002dt"></span>
-<p>When using the ‘<samp>papersize</samp>’ special, you generally should not also
-specify <code>-t</code> on the command line (see <a href="#Option-details">Option details</a>). The
+<a class="index-entry-id" id="index-unknown_002c-paper-format-for-_002dt"></a>
+<p>When using the ‘<samp class="samp">papersize</samp>’ special, you generally should not also
+specify <code class="code">-t</code> on the command line (see <a class="pxref" href="#Option-details">Option details</a>). The
exception is when using a nonstandard paper size that isn’t
-predefined; in this case, use <code>-t unknown</code>.
+predefined; in this case, use <code class="code">-t unknown</code>.
</p>
-<p>The ‘<samp>papersize</samp>’ special must occur somewhere on the first page of
-the document. Some packages, notably ‘<samp>hyperref</samp>’, insert this special.
+<p>The ‘<samp class="samp">papersize</samp>’ special must occur somewhere on the first page of
+the document. Some packages, notably ‘<samp class="samp">hyperref</samp>’, insert this special.
</p>
-<p>By default, if a DVI file contains multiple ‘<samp>papersize</samp>’ specials,
-the last one wins; this is also the behavior of the <code>dvipdfmx</code>
-driver. If the <code>-L0</code> command line option or <code>L0</code> config
+<p>By default, if a DVI file contains multiple ‘<samp class="samp">papersize</samp>’ specials,
+the last one wins; this is also the behavior of the <code class="code">dvipdfmx</code>
+driver. If the <code class="code">-L0</code> command line option or <code class="code">L0</code> config
file command is specified, the first special wins—this was the
behavior of Dvips prior to the 2017 release.
</p>
@@ -2084,48 +2082,48 @@
<hr>
</div>
-<div class="section" id="Config-file-paper-sizes">
-<div class="header">
+<div class="section-level-extent" id="Config-file-paper-sizes">
+<div class="nav-panel">
<p>
-Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp class="samp">papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Configuration-file-paper-size-command"></span><h3 class="section">4.2 Configuration file paper size command</h3>
+<h3 class="section" id="Configuration-file-paper-size-command">4.2 Configuration file paper size command</h3>
-<span id="index-paper-size-configuration-file-command"></span>
-<span id="index-configuration-file-paper-size-command"></span>
+<a class="index-entry-id" id="index-paper-size-configuration-file-command"></a>
+<a class="index-entry-id" id="index-configuration-file-paper-size-command"></a>
-<p>The ‘<samp>@</samp>’ command in a configuration file sets the paper size
-defaults and options. The first ‘<samp>@</samp>’ command defines the default
+<p>The ‘<samp class="samp">@</samp>’ command in a configuration file sets the paper size
+defaults and options. The first ‘<samp class="samp">@</samp>’ command defines the default
paper size. It has three possible parameters:
</p>
<div class="example">
-<pre class="example">@ <span class="roman">[</span><var>name</var> <span class="roman">[</span><var>hsize</var> <var>vsize</var><span class="roman">]]</span>
+<pre class="example-preformatted">@ <span class="r">[</span><var class="var">name</var> <span class="r">[</span><var class="var">hsize</var> <var class="var">vsize</var><span class="r">]]</span>
</pre></div>
-<p>If ‘<samp>@</samp>’ is specified on a line by itself, with no parameters, it
+<p>If ‘<samp class="samp">@</samp>’ is specified on a line by itself, with no parameters, it
instructs Dvips to discard all previous paper size information (possibly
from another configuration file).
</p>
<p>If three parameters are given, with the first parameter being a name and
-the second and third being a dimension (as in ‘<samp>8.5in</samp>’ or
-‘<samp>3.2cc</samp>’, just like in the ‘<samp>papersize</samp>’ special), then the
+the second and third being a dimension (as in ‘<samp class="samp">8.5in</samp>’ or
+‘<samp class="samp">3.2cc</samp>’, just like in the ‘<samp class="samp">papersize</samp>’ special), then the
option is interpreted as starting a new paper size description, where
-<var>name</var> is the name and <var>hsize</var> and <var>vsize</var> define the
+<var class="var">name</var> is the name and <var class="var">hsize</var> and <var class="var">vsize</var> define the
horizontal and vertical size of the sheet of paper, respectively. For
example:
</p>
<div class="example">
-<pre class="example">@ letterSize 8.5in 11in
+<pre class="example-preformatted">@ letterSize 8.5in 11in
</pre></div>
-<p>If both <var>hsize</var> and <var>vsize</var> are zero (you must still specify
-units!) then any page size will match. If the ‘<samp>@</samp>’ character is
-immediately followed by a ‘<samp>+</samp>’ sign, then the remainder of the line
+<p>If both <var class="var">hsize</var> and <var class="var">vsize</var> are zero (you must still specify
+units!) then any page size will match. If the ‘<samp class="samp">@</samp>’ character is
+immediately followed by a ‘<samp class="samp">+</samp>’ sign, then the remainder of the line
(after skipping any leading blanks) is treated as PostScript code to
send to the printer, presumably to select that particular paper size:
</p>
<div class="example">
-<pre class="example">@ letter 8.5in 11in
+<pre class="example-preformatted">@ letter 8.5in 11in
@+ %%BeginPaperSize: Letter
@+ letter
@+ %%EndPaperSize
@@ -2137,7 +2135,7 @@
For example:
</p>
<div class="example">
-<pre class="example">@ legal 8.5in 14in
+<pre class="example-preformatted">@ legal 8.5in 14in
@+ ! %%DocumentPaperSizes: Legal
@+ %%BeginPaperSize: Legal
@+ legal
@@ -2145,23 +2143,23 @@
</pre></div>
<p>When Dvips has a paper format name given on the command line, it looks
-for a match by the <var>name</var>; when it has a ‘<samp>papersize</samp>’ special,
+for a match by the <var class="var">name</var>; when it has a ‘<samp class="samp">papersize</samp>’ special,
it looks for a match by dimensions. The best match found (from the
paper size information in the configuration file) is used. The
dimensions must match within 5bp.
</p>
<p>If nothing matches, a warning is printed and the first paper size with
-zero dimensions is used; this should be the <code>unknown</code> paper size
+zero dimensions is used; this should be the <code class="code">unknown</code> paper size
definition mentioned below, resulting in the actual dimensions being
used.
</p>
-<span id="index-landscaperotate-configuration-file-command"></span>
-<span id="index-landscaperotate-command-line-option"></span>
+<a class="index-entry-id" id="index-landscaperotate-configuration-file-command"></a>
+<a class="index-entry-id" id="index-landscaperotate-command-line-option"></a>
<p>In versions of Dvips prior to 2022.1, if the paper size specified did
not match one of the defined paper sizes, Dvips considered rotated
page content and rotated paper sizes for a match. This provided some
automatic support for landscape mode on raw printers, but today it can
-be harmful when generating PDF. (Specifically, the ‘<samp>/MediaBox</samp>’
+be harmful when generating PDF. (Specifically, the ‘<samp class="samp">/MediaBox</samp>’
then ends up with rotated values, which is not expected by PDF
viewers, e.g., when a document intentionally has a single page
rotated.)
@@ -2171,101 +2169,101 @@
the document and inserts appropriate media selection commands as part
of the print job. So, this automatic rotation is no longer done by
default by Dvips. If you want to enable it, the
-‘<samp>-landscaperotate</samp>’ command line option or ‘<samp>landscaperotate</samp>’
-configuration file option can be used. See <a href="#Option-details">Option details</a>.
+‘<samp class="samp">-landscaperotate</samp>’ command line option or ‘<samp class="samp">landscaperotate</samp>’
+configuration file option can be used. See <a class="xref" href="#Option-details">Option details</a>.
</p>
-<span id="index-zero-dimensions-and-setting-paper-size"></span>
+<a class="index-entry-id" id="index-zero-dimensions-and-setting-paper-size"></a>
<p>If your printer has a command to set a special paper size, then give
-dimensions of ‘<samp>0in 0in</samp>’; the PostScript code that sets the paper
-size can refer to the dimensions the user requested as ‘<samp>hsize</samp>’
-and ‘<samp>vsize</samp>’; these will be macros defined in the PostScript that
+dimensions of ‘<samp class="samp">0in 0in</samp>’; the PostScript code that sets the paper
+size can refer to the dimensions the user requested as ‘<samp class="samp">hsize</samp>’
+and ‘<samp class="samp">vsize</samp>’; these will be macros defined in the PostScript that
return the requested size in default PostScript units. Also, some
-printers want ‘<samp>BeginPaperSize</samp>’ comments and paper size setting
-commands; others (such as the NeXT) want ‘<samp>PaperSize</samp>’ comments and
+printers want ‘<samp class="samp">BeginPaperSize</samp>’ comments and paper size setting
+commands; others (such as the NeXT) want ‘<samp class="samp">PaperSize</samp>’ comments and
they will handle setting the paper size. So paper size entries should
typically specify both.
</p>
-<span id="index-unknown_002c-paper-format-for-_002dt-1"></span>
+<a class="index-entry-id" id="index-unknown_002c-paper-format-for-_002dt-1"></a>
<p>When using a paper size that is not already defined in
-<samp>config.ps</samp>, you probably want to say ‘<samp>-t unknown</samp>’ on
-the command line; the <code>unknown</code> paper size definition in
-<samp>config.ps</samp> has the requisite PostScript incantation to set the
+<samp class="file">config.ps</samp>, you probably want to say ‘<samp class="samp">-t unknown</samp>’ on
+the command line; the <code class="code">unknown</code> paper size definition in
+<samp class="file">config.ps</samp> has the requisite PostScript incantation to set the
PostScript page size, as just described.
</p>
-<span id="index-nopaper_002c-paper-format-for-_002dt"></span>
+<a class="index-entry-id" id="index-nopaper_002c-paper-format-for-_002dt"></a>
<p>If you want no paper size information in the output at all, use
-‘<samp>-t nopaper</samp>’. This is useful with multi-page output that
+‘<samp class="samp">-t nopaper</samp>’. This is useful with multi-page output that
will be processed further. If you just have a single page document,
-you can use ‘<samp>-E</samp>’ to get pure EPSF output.
+you can use ‘<samp class="samp">-E</samp>’ to get pure EPSF output.
</p>
-<span id="index-mkdvipspapers"></span>
-<p>The Perl 5 script <samp>contrib/configs/mkdvipspapers</samp> in the
+<a class="index-entry-id" id="index-mkdvipspapers"></a>
+<p>The Perl 5 script <samp class="file">contrib/configs/mkdvipspapers</samp> in the
distribution directory may help in determining appropriate paper size
definitions.
</p>
-<span id="index-config_002eps-paper-sizes"></span>
-<span id="index-letter-paper-size"></span>
-<span id="index-a4-paper-size"></span>
-<p>Notwithstanding the above, the default <code>letter</code> and <code>a4</code>
-paper size definitions in <samp>config.ps</samp> execute the
-<code>setpagedevice</code> operator if it exists (it was defined in
-PostScript Level 2), or the ‘<samp>letter</samp>’ or ‘<samp>a4</samp>’ operator
+<a class="index-entry-id" id="index-config_002eps-paper-sizes"></a>
+<a class="index-entry-id" id="index-letter-paper-size"></a>
+<a class="index-entry-id" id="index-a4-paper-size"></a>
+<p>Notwithstanding the above, the default <code class="code">letter</code> and <code class="code">a4</code>
+paper size definitions in <samp class="file">config.ps</samp> execute the
+<code class="code">setpagedevice</code> operator if it exists (it was defined in
+PostScript Level 2), or the ‘<samp class="samp">letter</samp>’ or ‘<samp class="samp">a4</samp>’ operator
if they exist (they are nonstandard and thus perhaps cause failures on
certain (unknown) printers). Not executing any page size definition
at all confuses PostScript conversion programs such as
-<code>ps2pdf</code>, so we want to execute one if we can.
+<code class="command">ps2pdf</code>, so we want to execute one if we can.
</p>
-<span id="index-letterSize-paper-size"></span>
-<span id="index-A4size-paper-size"></span>
-<p>The <code>letterSize</code> and <code>A4Size</code> paper size definitions are now
-synonyms for <code>letter</code> and <code>a4</code>.
+<a class="index-entry-id" id="index-letterSize-paper-size"></a>
+<a class="index-entry-id" id="index-A4size-paper-size"></a>
+<p>The <code class="code">letterSize</code> and <code class="code">A4Size</code> paper size definitions are now
+synonyms for <code class="code">letter</code> and <code class="code">a4</code>.
</p>
<hr>
</div>
-<div class="section" id="Paper-trays">
-<div class="header">
+<div class="section-level-extent" id="Paper-trays">
+<div class="nav-panel">
<p>
Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Paper-trays-1"></span><h3 class="section">4.3 Paper trays</h3>
+<h3 class="section" id="Paper-trays-1">4.3 Paper trays</h3>
-<span id="index-paper-trays"></span>
-<span id="index-dual-paper-trays"></span>
-<span id="index-multiple-paper-trays"></span>
-<span id="index-HP4Si-printer-and-paper-trays"></span>
+<a class="index-entry-id" id="index-paper-trays"></a>
+<a class="index-entry-id" id="index-dual-paper-trays"></a>
+<a class="index-entry-id" id="index-multiple-paper-trays"></a>
+<a class="index-entry-id" id="index-HP4Si-printer-and-paper-trays"></a>
-<span id="index-bop_002dhook"></span>
+<a class="index-entry-id" id="index-bop_002dhook"></a>
<p>Some printers, such as the Hewlett-Packard HP4si, have multiple paper
trays. You can set up Dvips to take advantage of this using the
-<code>bop-hook</code> PostScript variable (see <a href="#PostScript-hooks">PostScript hooks</a>).
+<code class="code">bop-hook</code> PostScript variable (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>).
</p>
-<span id="index-letterhead-tray"></span>
+<a class="index-entry-id" id="index-letterhead-tray"></a>
<p>For example, suppose you have an alternate tray stocked with letterhead
paper; the usual tray has the usual paper. You have a document where
you want the first page printed on letterhead, and the remaining pages
on the usual paper. You can create a header file, say
-<samp>firstletterhead.PS</samp>, with the following (PostScript) code
-(<code>bop-hook</code> is passed the current physical page number, which
+<samp class="file">firstletterhead.PS</samp>, with the following (PostScript) code
+(<code class="code">bop-hook</code> is passed the current physical page number, which
starts at zero):
</p>
<div class="example">
-<pre class="example">/bop-hook { dup 0 eq { <var>alternatetray</var> } { <var>normaltray</var> } ifelse } def
+<pre class="example-preformatted">/bop-hook { dup 0 eq { <var class="var">alternatetray</var> } { <var class="var">normaltray</var> } ifelse } def
</pre></div>
-<p>where <var>alternatetray</var> and <var>normaltray</var> are the appropriate
-commands to select the paper trays. On the 4SI, <var>alternatetray</var> is
-‘<samp>statusdict begin 1 setpapertray end</samp>’ and <var>normaltray</var> is
-‘<samp>statusdict begin 0 setpapertray end</samp>’.
+<p>where <var class="var">alternatetray</var> and <var class="var">normaltray</var> are the appropriate
+commands to select the paper trays. On the 4SI, <var class="var">alternatetray</var> is
+‘<samp class="samp">statusdict begin 1 setpapertray end</samp>’ and <var class="var">normaltray</var> is
+‘<samp class="samp">statusdict begin 0 setpapertray end</samp>’.
</p>
<p>Then, include the file with either
-</p><ul>
-<li> the ‘<samp>-h</samp>’ command-line option (see <a href="#Option-details">Option details</a>); or
+</p><ul class="itemize mark-bullet">
+<li>the ‘<samp class="samp">-h</samp>’ command-line option (see <a class="pxref" href="#Option-details">Option details</a>); or
-</li><li> the ‘<samp>h</samp>’ config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>); or
+</li><li>the ‘<samp class="samp">h</samp>’ config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>); or
-</li><li> ‘<samp>\special{header=<var>file</var>}</samp>’ in your TeX document
-(see <a href="#Including-headers-from-TeX">Including headers from TeX</a>).
+</li><li>‘<samp class="samp">\special{header=<var class="var">file</var>}</samp>’ in your TeX document
+(see <a class="pxref" href="#Including-headers-from-TeX">Including headers from TeX</a>).
</li></ul>
@@ -2273,15 +2271,15 @@
<hr>
</div>
</div>
-<div class="chapter" id="Interaction-with-PostScript">
-<div class="header">
+<div class="chapter-level-extent" id="Interaction-with-PostScript">
+<div class="nav-panel">
<p>
Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape orientation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Interaction-with-PostScript-1"></span><h2 class="chapter">5 Interaction with PostScript</h2>
+<h2 class="chapter" id="Interaction-with-PostScript-1">5 Interaction with PostScript</h2>
-<span id="index-interaction-with-PostScript"></span>
-<span id="index-PostScript-interaction"></span>
+<a class="index-entry-id" id="index-interaction-with-PostScript"></a>
+<a class="index-entry-id" id="index-PostScript-interaction"></a>
<p>Dvips supports inclusion of PostScript figure files (e.g., Encapsulated
PostScript), downloading other header files (e.g., fonts), including
@@ -2289,7 +2287,7 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#PostScript-figures" accesskey="1">PostScript figures</a></li>
<li><a href="#Header-files" accesskey="2">PostScript header files</a></li>
<li><a href="#Literal-PS" accesskey="3">Literal PostScript</a></li>
@@ -2296,12 +2294,12 @@
<li><a href="#Hypertext" accesskey="4">HyperTeXt</a></li>
</ul>
<hr>
-<div class="section" id="PostScript-figures">
-<div class="header">
+<div class="section-level-extent" id="PostScript-figures">
+<div class="nav-panel">
<p>
Next: <a href="#Header-files" accesskey="n" rel="next">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="PostScript-figures-1"></span><h3 class="section">5.1 PostScript figures</h3>
+<h3 class="section" id="PostScript-figures-1">5.1 PostScript figures</h3>
<p>Scaling and including PostScript graphics is a breeze—if the PostScript
file is correctly formed. Even if it is not, however, the file can usually
@@ -2309,23 +2307,23 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Bounding-box" accesskey="1">The bounding box comment</a></li>
<li><a href="#g_t_005cincludegraphics" accesskey="2">The \includegraphics macro for LaTeX</a></li>
<li><a href="#EPSF-macros" accesskey="3">Using the EPSF macros</a></li>
-<li><a href="#psfile-special" accesskey="4">‘<samp>psfile</samp>’ special</a></li>
+<li><a href="#psfile-special" accesskey="4">‘<samp class="samp">psfile</samp>’ special</a></li>
<li><a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of PostScript graphics files</a></li>
<li><a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></li>
</ul>
<hr>
-<div class="subsection" id="Bounding-box">
-<div class="header">
+<div class="subsection-level-extent" id="Bounding-box">
+<div class="nav-panel">
<p>
Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="The-bounding-box-comment"></span><h4 class="subsection">5.1.1 The bounding box comment</h4>
+<h4 class="subsection" id="The-bounding-box-comment">5.1.1 The bounding box comment</h4>
-<span id="index-bounding-box_002c-comment-for"></span>
+<a class="index-entry-id" id="index-bounding-box_002c-comment-for"></a>
<p>The most important feature of a good PostScript file from the standpoint
of including it in another document is an accurate bounding box comment.
@@ -2332,17 +2330,17 @@
Every well-formed PostScript file has a comment describing where on the
page the graphic is located, and how big that graphic is.
</p>
-<span id="index-big-points"></span>
-<span id="index-PostScript-units"></span>
-<span id="index-bounding-box_002c-defined"></span>
+<a class="index-entry-id" id="index-big-points"></a>
+<a class="index-entry-id" id="index-PostScript-units"></a>
+<a class="index-entry-id" id="index-bounding-box_002c-defined"></a>
<p>This information is given as the lower left and upper right corners of
the box just enclosing the graphic, and is thus referred to as the
-<em>bounding box</em>. These coordinates are given in the default
+<em class="dfn">bounding box</em>. These coordinates are given in the default
PostScript units (there are precisely 72 PostScript units to the inch,
like TeX big points) with respect to the lower left corner of the
sheet of paper.
</p>
-<span id="index-_0025_0025BoundingBox"></span>
+<a class="index-entry-id" id="index-_0025_0025BoundingBox"></a>
<p>To see if a PostScript file has a bounding box comment, just look at the
first few lines of the file. PostScript files are standard ASCII, so
you can use any text editor to do this. If within the first few dozen
@@ -2349,7 +2347,7 @@
lines there is a line like
</p>
<div class="example">
-<pre class="example">%%BoundingBox: 25 50 400 300
+<pre class="example-preformatted">%%BoundingBox: 25 50 400 300
</pre></div>
<p>(with any reasonable numbers), chances are very good that the file is
@@ -2356,10 +2354,10 @@
Encapsulated PostScript and will work easily with Dvips. If the file
contains instead a line like
</p>
-<span id="index-atend_002c-bounding-box-specification"></span>
-<span id="index-_0028atend_0029_002c-bounding-box-specification"></span>
+<a class="index-entry-id" id="index-atend_002c-bounding-box-specification"></a>
+<a class="index-entry-id" id="index-_0028atend_0029_002c-bounding-box-specification"></a>
<div class="example">
-<pre class="example">%%BoundingBox: (atend)
+<pre class="example-preformatted">%%BoundingBox: (atend)
</pre></div>
<p>the file is still probably Encapsulated PostScript, but the bounding box
@@ -2369,18 +2367,18 @@
PostScript couldn’t know the size in advance, or was too lazy to compute
it.)
</p>
-<span id="index-bbfig"></span>
-<span id="index-bounding-box_002c-determining"></span>
-<p>If the document lacks a ‘<samp>%%BoundingBox:</samp>’ altogether, you can
-determine one in a couple of ways. One is to use the ‘<samp>bbfig</samp>’
-program distributed with Dvips in the <samp>contrib</samp> directory. This can
+<a class="index-entry-id" id="index-bbfig"></a>
+<a class="index-entry-id" id="index-bounding-box_002c-determining"></a>
+<p>If the document lacks a ‘<samp class="samp">%%BoundingBox:</samp>’ altogether, you can
+determine one in a couple of ways. One is to use the ‘<samp class="samp">bbfig</samp>’
+program distributed with Dvips in the <samp class="file">contrib</samp> directory. This can
usually find the correct bounding box automatically; it works best with
Ghostscript.
</p>
-<span id="index-612-792-bounding-box-size"></span>
+<a class="index-entry-id" id="index-612-792-bounding-box-size"></a>
<p>If the comment looks like this:
</p><div class="example">
-<pre class="example">%%BoundingBox: 0 0 612 792
+<pre class="example-preformatted">%%BoundingBox: 0 0 612 792
</pre></div>
<p>the graphic claims to take up an entire sheet of paper. This is
@@ -2389,20 +2387,20 @@
<p>The other is to do it yourself: print the file. Now, take a ruler, and
make the following measurements (in PostScript units, so measure in
inches and multiply by 72): From the left edge of the paper to the
-leftmost mark on the paper is <var>llx</var>, the first number. From the
+leftmost mark on the paper is <var class="var">llx</var>, the first number. From the
bottom edge of the paper to the bottommost mark on the paper is
-<var>lly</var>, the second number. From the left edge of the paper to the
-rightmost mark on the paper is <var>urx</var>, the third number. The fourth
-and final number, <var>ury</var>, is the distance from the bottom of the page
+<var class="var">lly</var>, the second number. From the left edge of the paper to the
+rightmost mark on the paper is <var class="var">urx</var>, the third number. The fourth
+and final number, <var class="var">ury</var>, is the distance from the bottom of the page
to the uppermost mark on the paper.
</p>
<p>Once you have the numbers, add a comment of the following form as the
second line of the document. (The first line should already be a line
-starting with the two characters ‘<samp>%!</samp>’; if it is not, the file
+starting with the two characters ‘<samp class="samp">%!</samp>’; if it is not, the file
probably isn’t PostScript.)
</p>
<div class="example">
-<pre class="example">%%BoundingBox: <var>llx</var> <var>lly</var> <var>urx</var> <var>ury</var>
+<pre class="example-preformatted">%%BoundingBox: <var class="var">llx</var> <var class="var">lly</var> <var class="var">urx</var> <var class="var">ury</var>
</pre></div>
<p>Or, if you don’t want to modify the file, you can simply write these
@@ -2417,15 +2415,15 @@
<hr>
</div>
-<div class="subsection" id="g_t_005cincludegraphics">
-<div class="header">
+<div class="subsection-level-extent" id="g_t_005cincludegraphics">
+<div class="nav-panel">
<p>
Next: <a href="#EPSF-macros" accesskey="n" rel="next">Using the EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">The bounding box comment</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="The-_005cincludegraphics-macro-for-LaTeX"></span><h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4>
+<h4 class="subsection" id="The-_005cincludegraphics-macro-for-LaTeX">5.1.2 The \includegraphics macro for LaTeX</h4>
-<span id="index-_005cincludegraphics-LaTeX-macro"></span>
-<span id="index-macros-for-epsf-inclusion"></span>
+<a class="index-entry-id" id="index-_005cincludegraphics-LaTeX-macro"></a>
+<a class="index-entry-id" id="index-macros-for-epsf-inclusion"></a>
<p>Once the figure file has a bounding box comment (see the previous
section) you are ready to import the graphic into a LaTeX
@@ -2432,7 +2430,7 @@
document. For LaTeX2e, you can use the epsf, graphics or graphicx
packages, but the last is recommended—it has the most flexible
syntax, and is briefly described here. Further information can be
-found in <samp>grfguide</samp> or <samp>epslatex</samp>, which should be included
+found in <samp class="file">grfguide</samp> or <samp class="file">epslatex</samp>, which should be included
in your LaTeX distribution in DVI, PDF, or other formats. (If you
are still using LaTeX 2.09, use epsf.sty).
</p>
@@ -2439,41 +2437,41 @@
<p>Just put the following command into your preamble:
</p>
<div class="example">
-<pre class="example">\usepackage[dvips]{graphicx}
+<pre class="example-preformatted">\usepackage[dvips]{graphicx}
</pre></div>
<p>Depending on your system, a suitable driver setup may already be
present, so that LaTeX automatically produces DVI files suitable for
-Dvips. In this case you can leave out the ‘<samp>[dvips]</samp>’ parameter.
+Dvips. In this case you can leave out the ‘<samp class="samp">[dvips]</samp>’ parameter.
</p>
-<p>Now, at the point you want to include a file <samp>foo.eps</samp>, enter a
+<p>Now, at the point you want to include a file <samp class="file">foo.eps</samp>, enter a
line such as:
</p>
<div class="example">
-<pre class="example">\includegraphics{foo.eps}
+<pre class="example-preformatted">\includegraphics{foo.eps}
</pre></div>
<p>However, it is usually best to omit the file extension and only use
</p>
<div class="example">
-<pre class="example">\includegraphics{foo}
+<pre class="example-preformatted">\includegraphics{foo}
</pre></div>
<p>because then you can process the same LaTeX file with
different TeX engines or DVI converters if you also provide
-suitable graphics files for them, e.g., <samp>foo.pdf</samp> or
-<samp>foo.png</samp>.
+suitable graphics files for them, e.g., <samp class="file">foo.pdf</samp> or
+<samp class="file">foo.png</samp>.
</p>
-<span id="index-bounding-box_002c-supplying-to-TeX"></span>
+<a class="index-entry-id" id="index-bounding-box_002c-supplying-to-TeX"></a>
<p>The \includegraphics command has many options, specified in
-‘<samp>key=value</samp>’ syntax, to allow you to resize, rotate or trim the
-included graphic—see <samp>grfguide</samp> or <samp>epslatex</samp>. If your
+‘<samp class="samp">key=value</samp>’ syntax, to allow you to resize, rotate or trim the
+included graphic—see <samp class="file">grfguide</samp> or <samp class="file">epslatex</samp>. If your
file does not have a bounding box comment, you can supply the numbers
as determined in the previous section, in the same order they would
have been in a normal bounding box comment:
</p>
<div class="example">
-<pre class="example">\includegraphics[bb=100 100 500 500]{foo.ps}
+<pre class="example-preformatted">\includegraphics[bb=100 100 500 500]{foo.ps}
</pre></div>
<p>Now, save your changes and run LaTeX and Dvips; the output should
@@ -2483,7 +2481,7 @@
<p>PostScript graphics have their origin in the lower left
corner. Therefore, in TeX, a graphic will occupy a box that extends
far above the line where it is put in, but has depth zero below it.
-Combining ‘<samp>\includegraphics</samp>’ with ‘<samp>\parbox</samp>’ commands or
+Combining ‘<samp class="samp">\includegraphics</samp>’ with ‘<samp class="samp">\parbox</samp>’ commands or
minipages can sometimes be confusing when this is not taken into
account.
</p>
@@ -2490,33 +2488,33 @@
<hr>
</div>
-<div class="subsection" id="EPSF-macros">
-<div class="header">
+<div class="subsection-level-extent" id="EPSF-macros">
+<div class="nav-panel">
<p>
-Next: <a href="#psfile-special" accesskey="n" rel="next">‘<samp>psfile</samp>’ special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#psfile-special" accesskey="n" rel="next">‘<samp class="samp">psfile</samp>’ special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Using-the-EPSF-macros"></span><h4 class="subsection">5.1.3 Using the EPSF macros</h4>
+<h4 class="subsection" id="Using-the-EPSF-macros">5.1.3 Using the EPSF macros</h4>
-<span id="index-EPSF-macros"></span>
-<span id="index-macros-for-epsf-inclusion-1"></span>
+<a class="index-entry-id" id="index-EPSF-macros"></a>
+<a class="index-entry-id" id="index-macros-for-epsf-inclusion-1"></a>
-<p>If you are using LaTeX2e, use the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’
-package. See <a href="#g_t_005cincludegraphics">The \includegraphics macro for LaTeX</a>.
+<p>If you are using LaTeX2e, use the ‘<samp class="samp">graphics</samp>’ or ‘<samp class="samp">graphicx</samp>’
+package. See <a class="xref" href="#g_t_005cincludegraphics">The \includegraphics macro for LaTeX</a>.
</p>
-<p>If you are using plain TeX or LaTeX 2.09, you need <samp>epsf.tex</samp>
-(for plain TeX) and <samp>epsf.sty</samp> (for LaTeX). For plain
+<p>If you are using plain TeX or LaTeX 2.09, you need <samp class="file">epsf.tex</samp>
+(for plain TeX) and <samp class="file">epsf.sty</samp> (for LaTeX). For plain
TeX, add a line like this near the top of your input file:
</p>
-<span id="index-epsf_002etex"></span>
+<a class="index-entry-id" id="index-epsf_002etex"></a>
<div class="example">
-<pre class="example">\input epsf
+<pre class="example-preformatted">\input epsf
</pre></div>
-<p><span id="index-epsf_002esty"></span>
-If you are using LaTeX 2.09, add the ‘<samp>epsf</samp>’ style option, as in:
+<a class="index-entry-id" id="index-epsf_002esty"></a>
+<p>If you are using LaTeX 2.09, add the ‘<samp class="samp">epsf</samp>’ style option, as in:
</p>
<div class="example">
-<pre class="example">\documentstyle[12pt,epsf]{article}
+<pre class="example-preformatted">\documentstyle[12pt,epsf]{article}
</pre></div>
<p>In any case, the above only needs to be done once, no matter how many
@@ -2525,13 +2523,13 @@
<p>Now, at the point you want to include a file, enter a line such as:
</p>
<div class="example">
-<pre class="example">\epsffile{foo.eps}
+<pre class="example-preformatted">\epsffile{foo.eps}
</pre></div>
-<span id="index-_005cleavevmode"></span>
-<span id="index-bounding-box_002c-supplying-to-TeX-1"></span>
-<p>If you are using LaTeX, you may need to add <code>\leavevmode</code>
-immediately before the <code>\epsffile</code> command to get certain
+<a class="index-entry-id" id="index-_005cleavevmode"></a>
+<a class="index-entry-id" id="index-bounding-box_002c-supplying-to-TeX-1"></a>
+<p>If you are using LaTeX, you may need to add <code class="code">\leavevmode</code>
+immediately before the <code class="code">\epsffile</code> command to get certain
environments to work correctly. If your file does not have a bounding
box comment, you can supply the numbers as determined in the previous
section, in the same order they would have been in a normal bounding box
@@ -2538,7 +2536,7 @@
comment:
</p>
<div class="example">
-<pre class="example">\epsffile[100 100 500 500]{foo.ps}
+<pre class="example-preformatted">\epsffile[100 100 500 500]{foo.ps}
</pre></div>
<p>Now, save your changes and run TeX and Dvips; the output should have
@@ -2545,9 +2543,9 @@
your graphic positioned at precisely the point you indicated, occupying
the proper amount of space.
</p>
-<span id="index-_005cepsffile-macro"></span>
-<span id="index-figures_002c-natural-size"></span>
-<p>The <code>\epsffile</code> macro typesets the figure as a TeX <code>\vbox</code>
+<a class="index-entry-id" id="index-_005cepsffile-macro"></a>
+<a class="index-entry-id" id="index-figures_002c-natural-size"></a>
+<p>The <code class="code">\epsffile</code> macro typesets the figure as a TeX <code class="code">\vbox</code>
at the point of the page that the command is executed. By default, the
graphic will have its ‘natural’ width (namely, the width of its bounding
box). The TeX box will have depth zero and its natural height. By
@@ -2555,31 +2553,31 @@
just as is everything else in your document. See the next section for
more information on scaling.
</p>
-<span id="index-_005cepsfverbosetrue"></span>
-<span id="index-verbose-EPSF-processing"></span>
+<a class="index-entry-id" id="index-_005cepsfverbosetrue"></a>
+<a class="index-entry-id" id="index-verbose-EPSF-processing"></a>
<p>If you want TeX to report the size of the figure as a message on your
terminal when it processes each figure, give the command:
</p>
<div class="example">
-<pre class="example">\epsfverbosetrue
+<pre class="example-preformatted">\epsfverbosetrue
</pre></div>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></li>
<li><a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></li>
</ul>
<hr>
-<div class="subsubsection" id="EPSF-scaling">
-<div class="header">
+<div class="subsubsection-level-extent" id="EPSF-scaling">
+<div class="nav-panel">
<p>
Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="EPSF-scaling-1"></span><h4 class="subsubsection">5.1.3.1 EPSF scaling</h4>
+<h4 class="subsubsection" id="EPSF-scaling-1">5.1.3.1 EPSF scaling</h4>
-<span id="index-scaling-of-figures"></span>
-<span id="index-figures_002c-scaling"></span>
+<a class="index-entry-id" id="index-scaling-of-figures"></a>
+<a class="index-entry-id" id="index-figures_002c-scaling"></a>
<p>Usually, you will want to scale an EPSF figure to some size appropriate
for your document, since its natural size is determined by the creator
@@ -2586,21 +2584,21 @@
of the EPS file.
</p>
<p>The best way to do this is to assign the desired size to the TeX
-<code>\epsfxsize</code> or <code>\epsfysize</code> variables, whichever is more
+<code class="code">\epsfxsize</code> or <code class="code">\epsfysize</code> variables, whichever is more
convenient for you. That is, put
</p>
-<span id="index-_005cepsfxsize"></span>
+<a class="index-entry-id" id="index-_005cepsfxsize"></a>
<div class="example">
-<pre class="example">\epsfxsize=<var>dimen</var>
+<pre class="example-preformatted">\epsfxsize=<var class="var">dimen</var>
</pre></div>
-<p>right before the call to <code>\epsffile</code>. Then the width of the TeX
-box will be <var>dimen</var> and its height will be scaled proportionately.
+<p>right before the call to <code class="code">\epsffile</code>. Then the width of the TeX
+box will be <var class="var">dimen</var> and its height will be scaled proportionately.
Similarly, you can set the vertical size with
</p>
-<span id="index-_005cepsfysize"></span>
+<a class="index-entry-id" id="index-_005cepsfysize"></a>
<div class="example">
-<pre class="example">\epsfysize=<var>dimen</var>
+<pre class="example-preformatted">\epsfysize=<var class="var">dimen</var>
</pre></div>
<p>in which case the height will be set and the width scaled
@@ -2610,87 +2608,87 @@
included graphic may necessarily be distorted, i.e., its contents
stretched in one direction or the other.
</p>
-<span id="index-_005cepsfsize"></span>
+<a class="index-entry-id" id="index-_005cepsfsize"></a>
<p>You can resize graphics in a more general way by redefining the
-<code>\epsfsize</code> macro. <code>\epsffile</code> calls this with two
+<code class="code">\epsfsize</code> macro. <code class="code">\epsffile</code> calls this with two
parameters: the natural horizontal and vertical sizes of the PostScript
-graphic. <code>\epsfsize</code> must expand to the desired horizontal size,
-that is, the width of the <code>\vbox</code>. Schematically:
+graphic. <code class="code">\epsfsize</code> must expand to the desired horizontal size,
+that is, the width of the <code class="code">\vbox</code>. Schematically:
</p>
<div class="example">
-<pre class="example">\def\epsfsize#1#2{<var>body</var>}
+<pre class="example-preformatted">\def\epsfsize#1#2{<var class="var">body</var>}
</pre></div>
-<p>Some useful definitions of <var>body</var>:
+<p>Some useful definitions of <var class="var">body</var>:
</p>
-<dl compact="compact">
-<dt><span>‘<samp>\epsfxsize</samp>’</span></dt>
+<dl class="table">
+<dt>‘<samp class="samp">\epsfxsize</samp>’</dt>
<dd><p>This definition (the default) enables the default features listed above,
-by setting <code>\epsfxsize</code> to the same value it had before the macro
+by setting <code class="code">\epsfxsize</code> to the same value it had before the macro
was called.
</p>
</dd>
-<dt><span>‘<samp>#1</samp>’</span></dt>
+<dt>‘<samp class="samp">#1</samp>’</dt>
<dd><p>Force the natural size by returning the first parameter (the original
width).
</p>
</dd>
-<dt><span>‘<samp>0pt</samp>’</span></dt>
-<dd><p>A special case, equivalent to ‘<samp>#1</samp>’.
+<dt>‘<samp class="samp">0pt</samp>’</dt>
+<dd><p>A special case, equivalent to ‘<samp class="samp">#1</samp>’.
</p>
</dd>
-<dt><span>‘<samp>0.5#1</samp>’</span></dt>
+<dt>‘<samp class="samp">0.5#1</samp>’</dt>
<dd><p>Scale to half the natural size.
</p>
</dd>
-<dt><span>‘<samp>\hsize</samp>’</span></dt>
-<dd><p>Scale to the current <code>\hsize</code>. (In LaTeX, use <code>\textwidth</code>
-instead of <code>\hsize</code>.)
+<dt>‘<samp class="samp">\hsize</samp>’</dt>
+<dd><p>Scale to the current <code class="code">\hsize</code>. (In LaTeX, use <code class="code">\textwidth</code>
+instead of <code class="code">\hsize</code>.)
</p>
</dd>
-<dt><span>‘<samp>\ifnum#1>\hsize\hsize\else#1\fi</samp>’</span></dt>
-<dd><p>If the natural width is greater than the current <code>\hsize</code>, scale to
-<code>\hsize</code>, otherwise use the natural width.
+<dt>‘<samp class="samp">\ifnum#1>\hsize\hsize\else#1\fi</samp>’</dt>
+<dd><p>If the natural width is greater than the current <code class="code">\hsize</code>, scale to
+<code class="code">\hsize</code>, otherwise use the natural width.
</p>
</dd>
</dl>
-<span id="index-DVI-magnification"></span>
-<span id="index-magnification_002c-DVI"></span>
-<span id="index-_005cmagnification"></span>
+<a class="index-entry-id" id="index-DVI-magnification"></a>
+<a class="index-entry-id" id="index-magnification_002c-DVI"></a>
+<a class="index-entry-id" id="index-_005cmagnification"></a>
<p>For compatibility with other PostScript drivers, it is possible to turn
off the default scaling of included figures by the DVI magnification
with the following TeX command:
</p>
-<span id="index-_002fmagscale"></span>
+<a class="index-entry-id" id="index-_002fmagscale"></a>
<div class="example">
-<pre class="example">\special{! /magscale false def}
+<pre class="example-preformatted">\special{! /magscale false def}
</pre></div>
<p>Use of this command is not recommended because it will make the
-<code>\epsffile</code> graphics the “wrong” size if global magnification is
+<code class="code">\epsffile</code> graphics the “wrong” size if global magnification is
being used, and it will cause any PostScript graphics to appear
improperly scaled and out of position if a DVI to DVI program is used to
scale or otherwise modify the document.
</p>
-<span id="index-bop_002dhook-1"></span>
+<a class="index-entry-id" id="index-bop_002dhook-1"></a>
<p>DVI magnification is not applied to any output from code you write in
-‘<samp>bop-hook</samp>’ or its ilk (see <a href="#PostScript-hooks">PostScript hooks</a>),
+‘<samp class="samp">bop-hook</samp>’ or its ilk (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>),
</p>
<hr>
</div>
-<div class="subsubsection" id="EPSF-clipping">
-<div class="header">
+<div class="subsubsection-level-extent" id="EPSF-clipping">
+<div class="nav-panel">
<p>
Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="EPSF-clipping-1"></span><h4 class="subsubsection">5.1.3.2 EPSF clipping</h4>
+<h4 class="subsubsection" id="EPSF-clipping-1">5.1.3.2 EPSF clipping</h4>
-<span id="index-clipping-of-EPSF"></span>
-<span id="index-bounding-box_002c-inaccurate"></span>
-<span id="index-text-in-figures_002c-chopped-off"></span>
-<span id="index-lines-in-figures_002c-wrong-width"></span>
+<a class="index-entry-id" id="index-clipping-of-EPSF"></a>
+<a class="index-entry-id" id="index-bounding-box_002c-inaccurate"></a>
+<a class="index-entry-id" id="index-text-in-figures_002c-chopped-off"></a>
+<a class="index-entry-id" id="index-lines-in-figures_002c-wrong-width"></a>
<p>By default, clipping is disabled for included EPSF images. This is
because clipping to the bounding box dimensions often cuts off a
@@ -2701,13 +2699,13 @@
turn clipping on, just use the command
</p>
<div class="example">
-<pre class="example">\epsfclipon
+<pre class="example-preformatted">\epsfclipon
</pre></div>
<p>and to turn clipping back off, use
</p>
<div class="example">
-<pre class="example">\epsfclipoff
+<pre class="example-preformatted">\epsfclipoff
</pre></div>
@@ -2714,77 +2712,77 @@
<hr>
</div>
</div>
-<div class="subsection" id="psfile-special">
-<div class="header">
+<div class="subsection-level-extent" id="psfile-special">
+<div class="nav-panel">
<p>
Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of PostScript graphics files</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">Using the EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="psfile-special-1"></span><h4 class="subsection">5.1.4 ‘<samp>psfile</samp>’ special</h4>
+<h4 class="subsection" id="psfile-special-1">5.1.4 ‘<samp class="samp">psfile</samp>’ special</h4>
-<span id="index-psfile-special"></span>
+<a class="index-entry-id" id="index-psfile-special"></a>
<p>The basic special for file inclusion is as follows:
</p>
<div class="example">
-<pre class="example">\special{psfile=<var>filename</var>.ps <span class="roman">[</span><var>key</var>=<var>value</var><span class="roman">]</span> … }
+<pre class="example-preformatted">\special{psfile=<var class="var">filename</var>.ps <span class="r">[</span><var class="var">key</var>=<var class="var">value</var><span class="r">]</span> … }
</pre></div>
-<p>This downloads the PostScript file <samp><var>filename</var>.ps</samp> such that
+<p>This downloads the PostScript file <samp class="file"><var class="var">filename</var>.ps</samp> such that
the current point will be the origin of the PostScript coordinate
-system. The optional <var>key</var><tt>=</tt><var>value</var> assignments allow you to
+system. The optional <var class="var">key</var><code class="t">=</code><var class="var">value</var> assignments allow you to
specify transformations on the PostScript.
</p>
-<p>The possible <var>key</var>s are:
+<p>The possible <var class="var">key</var>s are:
</p>
-<dl compact="compact">
-<dt id='index-hoffset-_0028psfile-special-option_0029'><span>‘<samp>hoffset</samp>’<a href='#index-hoffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dl class="table">
+<dt id='index-hoffset-_0028psfile-special-option_0029'><span>‘<samp class="samp">hoffset</samp>’<a class="copiable-link" href='#index-hoffset-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The horizontal offset (default 0).
</p>
</dd>
-<dt id='index-voffset-_0028psfile-special-option_0029'><span>‘<samp>voffset</samp>’<a href='#index-voffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-voffset-_0028psfile-special-option_0029'><span>‘<samp class="samp">voffset</samp>’<a class="copiable-link" href='#index-voffset-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The vertical offset (default 0).
</p>
</dd>
-<dt id='index-hsize-_0028psfile-special-option_0029'><span>‘<samp>hsize</samp>’<a href='#index-hsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-hsize-_0028psfile-special-option_0029'><span>‘<samp class="samp">hsize</samp>’<a class="copiable-link" href='#index-hsize-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The horizontal clipping size (default 612).
</p>
</dd>
-<dt id='index-vsize-_0028psfile-special-option_0029'><span>‘<samp>vsize</samp>’<a href='#index-vsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-vsize-_0028psfile-special-option_0029'><span>‘<samp class="samp">vsize</samp>’<a class="copiable-link" href='#index-vsize-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The vertical clipping size (default 792).
</p>
</dd>
-<dt id='index-hscale-_0028psfile-special-option_0029'><span>‘<samp>hscale</samp>’<a href='#index-hscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-hscale-_0028psfile-special-option_0029'><span>‘<samp class="samp">hscale</samp>’<a class="copiable-link" href='#index-hscale-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The horizontal scaling factor, as a percentage (default 100).
</p>
</dd>
-<dt id='index-vscale-_0028psfile-special-option_0029'><span>‘<samp>vscale</samp>’<a href='#index-vscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-vscale-_0028psfile-special-option_0029'><span>‘<samp class="samp">vscale</samp>’<a class="copiable-link" href='#index-vscale-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The vertical scaling factor, as a percentage (default 100).
</p>
</dd>
-<dt id='index-angle-_0028psfile-special-option_0029'><span>‘<samp>angle</samp>’<a href='#index-angle-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-angle-_0028psfile-special-option_0029'><span>‘<samp class="samp">angle</samp>’<a class="copiable-link" href='#index-angle-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>The rotation, in degrees (default 0).
</p>
</dd>
-<dt id='index-clip-_0028psfile-special-option_0029'><span>‘<samp>clip</samp>’<a href='#index-clip-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-clip-_0028psfile-special-option_0029'><span>‘<samp class="samp">clip</samp>’<a class="copiable-link" href='#index-clip-_0028psfile-special-option_0029'> ¶</a></span></dt>
<dd><p>Enable clipping to the bounding box (default disabled).
</p>
</dd>
-<dt id='index-llx-_0028psfile-special-option_0029'><span>‘<samp>llx, lly, urx, ury</samp>’<a href='#index-llx-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-lly-_0028psfile-special-option_0029"></span>
-<span id="index-urx-_0028psfile-special-option_0029"></span>
-<span id="index-ury-_0028psfile-special-option_0029"></span>
-<p>Bounding box of the included image, just as in a <code>%%BoundingBox</code>
+<dt id='index-llx-_0028psfile-special-option_0029'><span>‘<samp class="samp">llx, lly, urx, ury</samp>’<a class="copiable-link" href='#index-llx-_0028psfile-special-option_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-lly-_0028psfile-special-option_0029"></a>
+<a class="index-entry-id" id="index-urx-_0028psfile-special-option_0029"></a>
+<a class="index-entry-id" id="index-ury-_0028psfile-special-option_0029"></a>
+<p>Bounding box of the included image, just as in a <code class="code">%%BoundingBox</code>
comment. Values are in big points, and may be fractional.
</p>
</dd>
-<dt id='index-rhi-_0028psfile-special-option_0029'><span>‘<samp>rhi, rwi</samp>’<a href='#index-rhi-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-rwi-_0028psfile-special-option_0029"></span>
+<dt id='index-rhi-_0028psfile-special-option_0029'><span>‘<samp class="samp">rhi, rwi</samp>’<a class="copiable-link" href='#index-rhi-_0028psfile-special-option_0029'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-rwi-_0028psfile-special-option_0029"></a>
<p>Desired width and height of the resulting figure in the output, in
tenths of big points (720 to the inch); may be fractional.
</p>
-<p>If both <code>rwi</code> and <code>rhi</code> are nonzero, the picture is scaled,
-possibly losing aspect ratio. If only one of <code>rwi</code> and
-<code>rhi</code> is nonzero, the picture is scaled, preserving aspect ratio.
+<p>If both <code class="code">rwi</code> and <code class="code">rhi</code> are nonzero, the picture is scaled,
+possibly losing aspect ratio. If only one of <code class="code">rwi</code> and
+<code class="code">rhi</code> is nonzero, the picture is scaled, preserving aspect ratio.
</p>
</dd>
</dl>
@@ -2793,10 +2791,10 @@
Thus, for example:
</p>
<div class="example">
-<pre class="example">\special{psfile=foo.ps hoffset=72 hscale=90 vscale=90}
+<pre class="example-preformatted">\special{psfile=foo.ps hoffset=72 hscale=90 vscale=90}
</pre></div>
-<p>will shift the graphics produced by file <samp>foo.ps</samp> right by one inch
+<p>will shift the graphics produced by file <samp class="file">foo.ps</samp> right by one inch
and will draw it at 0.9 times normal size. Offsets are given relative
to the point of the special command, and are unaffected by scaling or
rotation. Rotation is counterclockwise about the origin. The order of
@@ -2803,195 +2801,195 @@
operations is to rotate the figure, scale it, then offset it.
</p>
<p>For compatibility with older PostScript drivers, it is possible to change
-the units that ‘<samp>hscale</samp>’ and ‘<samp>vscale</samp>’ are given in. This can be
-done by redefining ‘<samp>@scaleunit</samp>’
-<span id="index-scaleunit"></span>
-in ‘<samp>SDict</samp>’
-<span id="index-SDict"></span>
+the units that ‘<samp class="samp">hscale</samp>’ and ‘<samp class="samp">vscale</samp>’ are given in. This can be
+done by redefining ‘<samp class="samp">@scaleunit</samp>’
+<a class="index-entry-id" id="index-scaleunit"></a>
+in ‘<samp class="samp">SDict</samp>’
+<a class="index-entry-id" id="index-SDict"></a>
by a TeX command such as
</p>
<div class="example">
-<pre class="example">\special{! /@scaleunit 1 def}
+<pre class="example-preformatted">\special{! /@scaleunit 1 def}
</pre></div>
-<p>The ‘<samp>@scaleunit</samp>’ variable, which is by default 100, is what
-‘<samp>hscale</samp>’ and ‘<samp>vscale</samp>’ are divided by to yield an absolute
+<p>The ‘<samp class="samp">@scaleunit</samp>’ variable, which is by default 100, is what
+‘<samp class="samp">hscale</samp>’ and ‘<samp class="samp">vscale</samp>’ are divided by to yield an absolute
scale factor.
</p>
<hr>
</div>
-<div class="subsection" id="Dynamic-creation-of-graphics">
-<div class="header">
+<div class="subsection-level-extent" id="Dynamic-creation-of-graphics">
+<div class="nav-panel">
<p>
-Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">‘<samp>psfile</samp>’ special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">‘<samp class="samp">psfile</samp>’ special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Dynamic-creation-of-PostScript-graphics-files"></span><h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4>
+<h4 class="subsection" id="Dynamic-creation-of-PostScript-graphics-files">5.1.5 Dynamic creation of PostScript graphics files</h4>
-<span id="index-dynamic-creation-of-graphics"></span>
-<span id="index-compressed-PostScript"></span>
-<span id="index-uncompressing-PostScript"></span>
+<a class="index-entry-id" id="index-dynamic-creation-of-graphics"></a>
+<a class="index-entry-id" id="index-compressed-PostScript"></a>
+<a class="index-entry-id" id="index-uncompressing-PostScript"></a>
<p>PostScript is an excellent page description language—but it does tend
to be rather verbose. Compressing PostScript graphics files can reduce
them by factor of five or more. For this reason, if the name of an
-included PostScript file ends with <samp>.Z</samp> or <samp>.gz</samp>, Dvips
-automatically runs ‘<samp>gzip -d</samp>’. For example:
+included PostScript file ends with <samp class="file">.Z</samp> or <samp class="file">.gz</samp>, Dvips
+automatically runs ‘<samp class="samp">gzip -d</samp>’. For example:
</p>
<div class="example">
-<pre class="example">\epsffile[72 72 540 720]{foo.ps.gz}
+<pre class="example-preformatted">\epsffile[72 72 540 720]{foo.ps.gz}
</pre></div>
<p>Since the results of such a command are not accessible to TeX, if you
-use this facility with the <samp>epsf</samp> macros, you need to supply the
+use this facility with the <samp class="file">epsf</samp> macros, you need to supply the
bounding box parameter yourself, as shown.
</p>
<p>More generally, if the filename parameter to one of the graphics
-inclusion techniques starts with a left quote (‘<samp>`</samp>’), the parameter
+inclusion techniques starts with a left quote (‘<samp class="samp">`</samp>’), the parameter
is instead interpreted as a command to execute that will send the actual
file to standard output. For example:
</p>
<div class="example">
-<pre class="example">\special{psfile="`gnuplot foo"}
+<pre class="example-preformatted">\special{psfile="`gnuplot foo"}
</pre></div>
-<p><span id="index-gnuplot"></span>
-to include the file <samp>foo</samp>. Of course, the command to be executed
+<a class="index-entry-id" id="index-gnuplot"></a>
+<p>to include the file <samp class="file">foo</samp>. Of course, the command to be executed
can be anything, including using a file conversion utility such as
-<samp>tek2ps</samp> or whatever is appropriate. This feature can be disabled
-with the ‘<samp>-R</samp>’ command-line option or ‘<samp>R</samp>’ configuration option.
+<samp class="file">tek2ps</samp> or whatever is appropriate. This feature can be disabled
+with the ‘<samp class="samp">-R</samp>’ command-line option or ‘<samp class="samp">R</samp>’ configuration option.
</p>
<hr>
</div>
-<div class="subsection" id="Fonts-in-figures">
-<div class="header">
+<div class="subsection-level-extent" id="Fonts-in-figures">
+<div class="nav-panel">
<p>
Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of PostScript graphics files</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Fonts-in-figures-1"></span><h4 class="subsection">5.1.6 Fonts in figures</h4>
+<h4 class="subsection" id="Fonts-in-figures-1">5.1.6 Fonts in figures</h4>
-<span id="index-figures-and-fonts"></span>
-<span id="index-fonts_002c-in-PostScript-figures"></span>
-<span id="index-_0025_002aFont"></span>
+<a class="index-entry-id" id="index-figures-and-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-in-PostScript-figures"></a>
+<a class="index-entry-id" id="index-_0025_002aFont"></a>
<p>You can use any font available to TeX and Dvips within a graphics
-file by putting a <code>%*Font:</code> line in the leading commentary of the
+file by putting a <code class="code">%*Font:</code> line in the leading commentary of the
file. Schematically, this looks like:
</p>
<div class="example">
-<pre class="example">%*Font: <var>tfmname</var> <var>scaledbp</var> <var>designbp</var> <var>hex-start</var>:<var>hex-bitstring</var>
+<pre class="example-preformatted">%*Font: <var class="var">tfmname</var> <var class="var">scaledbp</var> <var class="var">designbp</var> <var class="var">hex-start</var>:<var class="var">hex-bitstring</var>
</pre></div>
<p>Here is the meaning of each of these elements:
</p>
-<dl compact="compact">
-<dt><span><var>tfmname</var></span></dt>
-<dd><p>The TeX TFM filename, e.g., <samp>cmr10</samp>. You can give the same
-<var>tfmname</var> on more than one ‘<samp>%*Font</samp>’ line; this is useful when
+<dl class="table">
+<dt><var class="var">tfmname</var></dt>
+<dd><p>The TeX TFM filename, e.g., <samp class="file">cmr10</samp>. You can give the same
+<var class="var">tfmname</var> on more than one ‘<samp class="samp">%*Font</samp>’ line; this is useful when
the number of characters from the font used needs a longer
-<var>hex-bitstring</var> (see item below) than conveniently fits on one line.
+<var class="var">hex-bitstring</var> (see item below) than conveniently fits on one line.
</p>
</dd>
-<dt><span><var>scaledbp</var></span></dt>
+<dt><var class="var">scaledbp</var></dt>
<dd><p>The size at which you are using the font, in PostScript points (TeX
-big points). 72bp = 72.27pt = 1in.
+big points). 72<span class="dmn">bp</span> = 72.27<span class="dmn">pt</span> = 1<span class="dmn">in</span>.
</p>
</dd>
-<dt><span><var>designbp</var></span></dt>
+<dt><var class="var">designbp</var></dt>
<dd><p>The designsize of the font, again in PostScript points. This should
-match the value in the TFM file <var>tfmname</var>. Thus, for <samp>cmr10</samp>,
-it should be ‘<samp>9.96265</samp>’.
+match the value in the TFM file <var class="var">tfmname</var>. Thus, for <samp class="file">cmr10</samp>,
+it should be ‘<samp class="samp">9.96265</samp>’.
</p>
</dd>
-<dt><span><var>hex-start</var></span></dt>
+<dt><var class="var">hex-start</var></dt>
<dd><p>The character code of the first character used from the font, specified
-as two ASCII hexadecimal characters, e.g., ‘<samp>4b</samp>’ or ‘<samp>4B</samp>’ for
-‘<samp>K</samp>’.
+as two ASCII hexadecimal characters, e.g., ‘<samp class="samp">4b</samp>’ or ‘<samp class="samp">4B</samp>’ for
+‘<samp class="samp">K</samp>’.
</p>
</dd>
-<dt><span><var>hex-bitstring</var></span></dt>
+<dt><var class="var">hex-bitstring</var></dt>
<dd><p>An arbitrary number of ASCII hexadecimal digits specifying which
-characters following (and including) <var>hex-start</var> are used. This is
+characters following (and including) <var class="var">hex-start</var> are used. This is
treated as a bitmap. For example, if your figure used the single letter
-‘<samp>K</samp>’, you would use ‘<samp>4b:8</samp>’ for <var>hex-start</var> and
-<var>hex-bitstring</var>. If it used ‘<samp>KLMNP</samp>’, you would use
-‘<samp>4b:f4</samp>’.
+‘<samp class="samp">K</samp>’, you would use ‘<samp class="samp">4b:8</samp>’ for <var class="var">hex-start</var> and
+<var class="var">hex-bitstring</var>. If it used ‘<samp class="samp">KLMNP</samp>’, you would use
+‘<samp class="samp">4b:f4</samp>’.
</p>
</dd>
</dl>
<p>MetaPost’s output figures contain lines like this for bitmap fonts used
-in a MetaPost label (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>).
+in a MetaPost label (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite class="cite">Web2c</cite>).
</p>
<hr>
</div>
</div>
-<div class="section" id="Header-files">
-<div class="header">
+<div class="section-level-extent" id="Header-files">
+<div class="nav-panel">
<p>
Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PostScript</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="PostScript-header-files"></span><h3 class="section">5.2 PostScript header files</h3>
+<h3 class="section" id="PostScript-header-files">5.2 PostScript header files</h3>
-<span id="index-header-files_002c-defined"></span>
-<span id="index-PostScript-header-files"></span>
+<a class="index-entry-id" id="index-header-files_002c-defined"></a>
+<a class="index-entry-id" id="index-PostScript-header-files"></a>
-<p><em>Header files</em> are bits of PostScript included in the output file;
+<p><em class="dfn">Header files</em> are bits of PostScript included in the output file;
generally they provide support for special features, rather than
producing any printed output themselves. You can explicitly request
downloading header files if necessary for some figure, or to achieve
some special effect.
</p>
-<span id="index-psheaderdir"></span>
-<span id="index-_002epro-prologue-files"></span>
-<span id="index-_002elpro-long-prologue-files"></span>
+<a class="index-entry-id" id="index-psheaderdir"></a>
+<a class="index-entry-id" id="index-_002epro-prologue-files"></a>
+<a class="index-entry-id" id="index-_002elpro-long-prologue-files"></a>
<p>Dvips includes some headers on its own initiative, to implement features
such as PostScript font reencoding, bitmap font downloading, handling of
-<code>\special</code>’s, and so on. These standard headers are the
-<samp>.pro</samp> files (for “prologue”) in the installation directory
-‘<samp>$(psheaderdir)</samp>’; they are created from the <samp>.lpro</samp> (“long
+<code class="code">\special</code>’s, and so on. These standard headers are the
+<samp class="file">.pro</samp> files (for “prologue”) in the installation directory
+‘<samp class="samp">$(psheaderdir)</samp>’; they are created from the <samp class="file">.lpro</samp> (“long
prologue”) files in the distribution by stripping
comments, squeezing blank lines, etc., for maximum efficiency. If you
-want to peruse one of the standard header files, read the <samp>.lpro</samp>
+want to peruse one of the standard header files, read the <samp class="file">.lpro</samp>
version.
</p>
-<span id="index-userdict_002c-and-dictionary-files"></span>
-<span id="index-dictionary_002c-userdict"></span>
-<p>The PostScript dictionary stack will be at the ‘<samp>userdict</samp>’ level
+<a class="index-entry-id" id="index-userdict_002c-and-dictionary-files"></a>
+<a class="index-entry-id" id="index-dictionary_002c-userdict"></a>
+<p>The PostScript dictionary stack will be at the ‘<samp class="samp">userdict</samp>’ level
when header files are included.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></li>
<li><a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></li>
<li><a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></li>
</ul>
<hr>
-<div class="subsection" id="Including-headers-from-TeX">
-<div class="header">
+<div class="subsection-level-extent" id="Including-headers-from-TeX">
+<div class="nav-panel">
<p>
Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Including-headers-from-TeX-1"></span><h4 class="subsection">5.2.1 Including headers from TeX</h4>
+<h4 class="subsection" id="Including-headers-from-TeX-1">5.2.1 Including headers from TeX</h4>
-<span id="index-including-headers-in-TeX"></span>
-<span id="index-header_003dfile-_005cspecial"></span>
-<span id="index-TeX_002c-including-headers-in"></span>
+<a class="index-entry-id" id="index-including-headers-in-TeX"></a>
+<a class="index-entry-id" id="index-header_003dfile-_005cspecial"></a>
+<a class="index-entry-id" id="index-TeX_002c-including-headers-in"></a>
-<span id="index-headers_002c-including-in-TeX"></span>
+<a class="index-entry-id" id="index-headers_002c-including-in-TeX"></a>
<p>In order to get a particular graphic file to work, a certain font or
header file might need to be sent first. The Dvips program provides
-support for this with the ‘<samp>header</samp>’ <code>\special</code>. For instance,
-to ensure that <samp>foo.ps</samp> gets downloaded:
+support for this with the ‘<samp class="samp">header</samp>’ <code class="code">\special</code>. For instance,
+to ensure that <samp class="file">foo.ps</samp> gets downloaded:
</p>
<div class="example">
-<pre class="example">\special{header=foo.ps}
+<pre class="example-preformatted">\special{header=foo.ps}
</pre></div>
-<span id="index-fonts_002c-as-header-files"></span>
+<a class="index-entry-id" id="index-fonts_002c-as-header-files"></a>
<p>As another example, if you have some PostScript code that uses a
PostScript font not built into your printer, you must download it to the
printer. If the font isn’t used elsewhere in the document, Dvips can’t
@@ -2998,26 +2996,26 @@
know you’ve used it, so you must include it in the same way, as in:
</p>
<div class="example">
-<pre class="example">\special{header=putr.pfa}
+<pre class="example-preformatted">\special{header=putr.pfa}
</pre></div>
<p>to include the font definition file for Adobe Utopia Roman.
</p>
-<p>The <code>header</code> also special allows for specifying some additional
+<p>The <code class="code">header</code> also special allows for specifying some additional
code that should be inserted into the PostScript document before and after
the file itself, as follows:
</p>
<div class="example">
-<pre class="example">\special{header={foo.ps} pre={pre code} post={post code}}
+<pre class="example-preformatted">\special{header={foo.ps} pre={pre code} post={post code}}
</pre></div>
-<span id="index-before-header_002c-inserting-code"></span>
-<span id="index-after-header_002c-inserting-code"></span>
-<span id="index-pre-code-before-headers"></span>
-<span id="index-post-code-after-headers"></span>
-<p>This will insert <code>pre code</code> just before <samp>foo.ps</samp> and
-<code>post code</code> just after. It is required to use the (balanced)
-braces in <em>all</em> of the arguments, including the <code>header</code>,
+<a class="index-entry-id" id="index-before-header_002c-inserting-code"></a>
+<a class="index-entry-id" id="index-after-header_002c-inserting-code"></a>
+<a class="index-entry-id" id="index-pre-code-before-headers"></a>
+<a class="index-entry-id" id="index-post-code-after-headers"></a>
+<p>This will insert <code class="code">pre code</code> just before <samp class="file">foo.ps</samp> and
+<code class="code">post code</code> just after. It is required to use the (balanced)
+braces in <em class="emph">all</em> of the arguments, including the <code class="code">header</code>,
when using this extended syntax.
</p>
<p>This allows, for instance, dynamic headers, where some of the content
@@ -3025,125 +3023,125 @@
is the inclusion of graphics inside the PostScript header, so that
they can be reused throughout the document, as with logs. That avoids
including the same graphic several times. This is implemented in the
-<samp>graphics/graphicx-psmin</samp> package.
+<samp class="file">graphics/graphicx-psmin</samp> package.
</p>
<p>This extended syntax has one additional feature. When Dvips finds the
-extended syntax, it will also look in the installed <samp>tex/</samp>
-tree(s) for the header file (<samp>foo.ps</samp> in our example), and not
+extended syntax, it will also look in the installed <samp class="file">tex/</samp>
+tree(s) for the header file (<samp class="file">foo.ps</samp> in our example), and not
only in the current directory and dvips tree as the original syntax
does. This is because common graphics may well come with packages
-which are installed in the <samp>tex/</samp> tree.
+which are installed in the <samp class="file">tex/</samp> tree.
</p>
<hr>
</div>
-<div class="subsection" id="Including-headers-from-the-command-line">
-<div class="header">
+<div class="subsection-level-extent" id="Including-headers-from-the-command-line">
+<div class="nav-panel">
<p>
Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Including-headers-from-the-command-line-1"></span><h4 class="subsection">5.2.2 Including headers from the command line</h4>
+<h4 class="subsection" id="Including-headers-from-the-command-line-1">5.2.2 Including headers from the command line</h4>
-<span id="index-including-headers-from-the-command-line"></span>
-<span id="index-command-line_002c-including-headers-from"></span>
-<span id="index-headers_002c-including-from-the-command-line"></span>
+<a class="index-entry-id" id="index-including-headers-from-the-command-line"></a>
+<a class="index-entry-id" id="index-command-line_002c-including-headers-from"></a>
+<a class="index-entry-id" id="index-headers_002c-including-from-the-command-line"></a>
<p>You can include headers when you run Dvips, as well as from your
document (see the previous section). To do this, run Dvips with the
-option ‘<samp>-P <var>header</var></samp>’; this will read the file
-<samp>config.<var>header</var></samp>, which in turn can specify a header file to
-be downloaded with the ‘<samp>h</samp>’ option. See <a href="#Configuration-file-commands">Configuration file commands</a>. These files are called <samp><var>header</var>.cfg</samp> on MS-DOS.
+option ‘<samp class="samp">-P <var class="var">header</var></samp>’; this will read the file
+<samp class="file">config.<var class="var">header</var></samp>, which in turn can specify a header file to
+be downloaded with the ‘<samp class="samp">h</samp>’ option. See <a class="xref" href="#Configuration-file-commands">Configuration file commands</a>. These files are called <samp class="file"><var class="var">header</var>.cfg</samp> on MS-DOS.
</p>
-<span id="index-duplex-printers"></span>
-<span id="index-simplex-mode-on-duplex-printers"></span>
-<span id="index-screen-frequencies_002c-setting"></span>
-<p>You can arrange for the same file to serve as a ‘<samp>-P</samp>’ config file
+<a class="index-entry-id" id="index-duplex-printers"></a>
+<a class="index-entry-id" id="index-simplex-mode-on-duplex-printers"></a>
+<a class="index-entry-id" id="index-screen-frequencies_002c-setting"></a>
+<p>You can arrange for the same file to serve as a ‘<samp class="samp">-P</samp>’ config file
and the downloadable header file, by starting the lines of PostScript
-code with a space, leaving only the ‘<samp>h</samp>’ line and any comments
+code with a space, leaving only the ‘<samp class="samp">h</samp>’ line and any comments
starting in the first column. As an example, see
-<samp>contrib/volker/config.*</samp> (<samp>contrib/volker/*.cfg</samp> on MS-DOS).
+<samp class="file">contrib/volker/config.*</samp> (<samp class="file">contrib/volker/*.cfg</samp> on MS-DOS).
(These files also perform useful functions: controlling duplex/simplex
mode on duplex printers, and setting various screen frequencies;
-<samp>contrib/volker/README</samp> explains further.)
+<samp class="file">contrib/volker/README</samp> explains further.)
</p>
<hr>
</div>
-<div class="subsection" id="Headers-and-memory-usage">
-<div class="header">
+<div class="subsection-level-extent" id="Headers-and-memory-usage">
+<div class="nav-panel">
<p>
Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Headers-and-memory-usage-1"></span><h4 class="subsection">5.2.3 Headers and memory usage</h4>
+<h4 class="subsection" id="Headers-and-memory-usage-1">5.2.3 Headers and memory usage</h4>
-<span id="index-headers-and-memory-usage"></span>
-<span id="index-memory-usage_002c-and-headers"></span>
+<a class="index-entry-id" id="index-headers-and-memory-usage"></a>
+<a class="index-entry-id" id="index-memory-usage_002c-and-headers"></a>
-<span id="index-sections-of-output-file_002c-and-memory"></span>
-<span id="index-output-file_002c-sectioning-of"></span>
+<a class="index-entry-id" id="index-sections-of-output-file_002c-and-memory"></a>
+<a class="index-entry-id" id="index-output-file_002c-sectioning-of"></a>
<p>Dvips tries to avoid overflowing the printer’s memory by splitting the
-output files into “sections” (see the ‘<samp>-i</samp>’ option in <a href="#Option-details">Option details</a>). Therefore, for all header files, Dvips debits the printer VM
+output files into “sections” (see the ‘<samp class="samp">-i</samp>’ option in <a class="ref" href="#Option-details">Option details</a>). Therefore, for all header files, Dvips debits the printer VM
budget by some value. If the header file has, in its leading
commentary a line of the form
</p>
-<span id="index-VMusage"></span>
-<span id="index-_0025_0025VMusage"></span>
+<a class="index-entry-id" id="index-VMusage"></a>
+<a class="index-entry-id" id="index-_0025_0025VMusage"></a>
<div class="example">
-<pre class="example">%%VMusage: <var>min</var> <var>max</var>
+<pre class="example-preformatted">%%VMusage: <var class="var">min</var> <var class="var">max</var>
</pre></div>
-<p>then <var>max</var> is used. If there is no <code>%%VMusage</code> line, then
+<p>then <var class="var">max</var> is used. If there is no <code class="code">%%VMusage</code> line, then
the size (in bytes) of the header file is used as an approximation.
If you want a file to be ignored in the sectioning calculations, use
-‘<samp>%%VMusage: 0 0</samp>’.
+‘<samp class="samp">%%VMusage: 0 0</samp>’.
</p>
-<p>Illustrations (figure files) are also checked for <code>%%VMusage</code> line.
+<p>Illustrations (figure files) are also checked for <code class="code">%%VMusage</code> line.
</p>
<p>Therefore, if your document uses very large fonts or very large
included figures, Dvips might take it upon itself to split the output
into unwanted sections. If this causes problems, the simplest
-solution is to use ‘<samp>dvips -Pmaxmem</samp>’, which reads the Dvips file
-<samp>config.maxmem</samp>, which sets Dvips’s idea of the memory available
-to a very large number. (See the ‘<samp>m</samp>’ item in <a href="#Configuration-file-commands">Configuration file commands</a>.)
+solution is to use ‘<samp class="samp">dvips -Pmaxmem</samp>’, which reads the Dvips file
+<samp class="file">config.maxmem</samp>, which sets Dvips’s idea of the memory available
+to a very large number. (See the ‘<samp class="samp">m</samp>’ item in <a class="ref" href="#Configuration-file-commands">Configuration file commands</a>.)
</p>
<hr>
</div>
</div>
-<div class="section" id="Literal-PS">
-<div class="header">
+<div class="section-level-extent" id="Literal-PS">
+<div class="nav-panel">
<p>
Next: <a href="#Hypertext" accesskey="n" rel="next">HyperTeXt</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Literal-PostScript"></span><h3 class="section">5.3 Literal PostScript</h3>
+<h3 class="section" id="Literal-PostScript">5.3 Literal PostScript</h3>
-<span id="index-literal-PostScript_002c-using"></span>
-<span id="index-PostScript-code_002c-literal"></span>
+<a class="index-entry-id" id="index-literal-PostScript_002c-using"></a>
+<a class="index-entry-id" id="index-PostScript-code_002c-literal"></a>
<p>You can include literal PostScript code in your document in several ways.
</p>
-<ul class="section-toc">
-<li><a href="#g_t_0022-special" accesskey="1"><code>"</code> special: Literal PostScript</a></li>
-<li><a href="#ps-special" accesskey="2">‘<samp>ps</samp>’ special</a></li>
-<li><a href="#Literal-headers" accesskey="3">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li>
+<ul class="mini-toc">
+<li><a href="#g_t_0022-special" accesskey="1"><code class="code">"</code> special: Literal PostScript</a></li>
+<li><a href="#ps-special" accesskey="2">‘<samp class="samp">ps</samp>’ special</a></li>
+<li><a href="#Literal-headers" accesskey="3">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a></li>
<li><a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></li>
<li><a href="#Literal-examples" accesskey="5">Literal examples</a></li>
</ul>
<hr>
-<div class="subsection" id="g_t_0022-special">
-<div class="header">
+<div class="subsection-level-extent" id="g_t_0022-special">
+<div class="nav-panel">
<p>
-Next: <a href="#ps-special" accesskey="n" rel="next">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#ps-special" accesskey="n" rel="next">‘<samp class="samp">ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_0022-special_003a-Literal-PostScript"></span><h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4>
+<h4 class="subsection" id="g_t_0022-special_003a-Literal-PostScript">5.3.1 <code class="code">"</code> special: Literal PostScript</h4>
-<span id="index-_0022-special-_0028literal-PostScript_0029"></span>
+<a class="index-entry-id" id="index-_0022-special-_0028literal-PostScript_0029"></a>
<p>For simple graphics, or just for experimentation, literal PostScript
-code can be included. Simply use a <code>\special</code> beginning with a
-double quote character ‘<samp>"</samp>’; there is no matching closing ‘<samp>"</samp>’.
+code can be included. Simply use a <code class="code">\special</code> beginning with a
+double quote character ‘<samp class="samp">"</samp>’; there is no matching closing ‘<samp class="samp">"</samp>’.
</p>
<p>For instance, the following (simple) graphic:
</p>
@@ -3151,30 +3149,30 @@
<p>was created by typing:
</p>
<div class="example">
-<pre class="example">\vbox to 100bp{\vss % a bp is the same as a PostScript unit
+<pre class="example-preformatted">\vbox to 100bp{\vss % a bp is the same as a PostScript unit
\special{" newpath 0 0 moveto 100 100 lineto 394 0 lineto
closepath gsave 0.8 setgray fill grestore stroke}}
</pre></div>
<p>You are responsible for leaving space for such literal graphics, as with
-the <code>\vbox</code> above.
+the <code class="code">\vbox</code> above.
</p>
<hr>
</div>
-<div class="subsection" id="ps-special">
-<div class="header">
+<div class="subsection-level-extent" id="ps-special">
+<div class="nav-panel">
<p>
-Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev"><code>"</code> special: Literal PostScript</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev"><code class="code">"</code> special: Literal PostScript</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="ps-special-1"></span><h4 class="subsection">5.3.2 ‘<samp>ps</samp>’ special</h4>
+<h4 class="subsection" id="ps-special-1">5.3.2 ‘<samp class="samp">ps</samp>’ special</h4>
-<span id="index-ps-special"></span>
+<a class="index-entry-id" id="index-ps-special"></a>
-<span id="index-save_002frestore_002c-and-specials"></span>
+<a class="index-entry-id" id="index-save_002frestore_002c-and-specials"></a>
<p>Generally, Dvips encloses specials in a PostScript save/restore pair,
guaranteeing that the special will have no effect on the rest of the
-document. The ‘<samp>ps</samp>’ special, however, allows you to insert literal
+document. The ‘<samp class="samp">ps</samp>’ special, however, allows you to insert literal
PostScript instructions without this protective shield; you should
understand what you’re doing (and you shouldn’t change the PostScript
graphics state unless you are willing to take the consequences). This
@@ -3182,76 +3180,76 @@
of the following will work:
</p>
<div class="example">
-<pre class="example">\special{ps:<var>text</var>}
-\special{ps::<var>text</var>}
-\special{ps::[begin]<var>text</var>}
-\special{ps::[end]<var>text</var>}
-\special{ps::[nobreak]<var>text</var>}
+<pre class="example-preformatted">\special{ps:<var class="var">text</var>}
+\special{ps::<var class="var">text</var>}
+\special{ps::[begin]<var class="var">text</var>}
+\special{ps::[end]<var class="var">text</var>}
+\special{ps::[nobreak]<var class="var">text</var>}
</pre></div>
<p>(with longer forms taking precedence over shorter forms, when they are
-present). ‘<samp>ps::</samp>’ and ‘<samp>ps::[end]</samp>’ do no positioning, so they
-can be used to continue PostScript literals started with ‘<samp>ps:</samp>’ or
-‘<samp>ps::[begin]</samp>’.
+present). ‘<samp class="samp">ps::</samp>’ and ‘<samp class="samp">ps::[end]</samp>’ do no positioning, so they
+can be used to continue PostScript literals started with ‘<samp class="samp">ps:</samp>’ or
+‘<samp class="samp">ps::[begin]</samp>’.
</p>
-<p>Literal PostScript instructions after ‘<samp>ps::[nobreak]</samp>’ are
-<em>not</em> broken into lines. This feature may be used to include
+<p>Literal PostScript instructions after ‘<samp class="samp">ps::[nobreak]</samp>’ are
+<em class="emph">not</em> broken into lines. This feature may be used to include
PostScript comments, for example.
</p>
-<span id="index-plotfile_002c-ps-subspecial"></span>
+<a class="index-entry-id" id="index-plotfile_002c-ps-subspecial"></a>
<p>In addition, the variant
</p>
<div class="example">
-<pre class="example">\special{ps: plotfile <var>filename</var>}
+<pre class="example-preformatted">\special{ps: plotfile <var class="var">filename</var>}
</pre></div>
-<p><span id="index-rotate_002etex"></span>
-inserts the contents of <var>filename</var> verbatim into the output (except
+<a class="index-entry-id" id="index-rotate_002etex"></a>
+<p>inserts the contents of <var class="var">filename</var> 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 <samp>rotate.tex</samp>, which makes
+literal specials can be found in the file <samp class="file">rotate.tex</samp>, which makes
it easy to typeset text turned in multiples of 90 degrees.
</p>
<hr>
</div>
-<div class="subsection" id="Literal-headers">
-<div class="header">
+<div class="subsection-level-extent" id="Literal-headers">
+<div class="nav-panel">
<p>
-Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">‘<samp class="samp">ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Literal-headers_003a-_0021-_005cspecial"></span><h4 class="subsection">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></h4>
+<h4 class="subsection" id="Literal-headers_003a-_0021-_005cspecial">5.3.3 Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></h4>
-<span id="index-literal-headers"></span>
-<span id="index-SDict-dictionary"></span>
+<a class="index-entry-id" id="index-literal-headers"></a>
+<a class="index-entry-id" id="index-SDict-dictionary"></a>
-<span id="index-_0021-special-_0028literal-PS-header_0029"></span>
-<span id="index-dictionary_002c-SDict"></span>
+<a class="index-entry-id" id="index-_0021-special-_0028literal-PS-header_0029"></a>
+<a class="index-entry-id" id="index-dictionary_002c-SDict"></a>
<p>You can download literal PostScript header code in your TeX document,
for use with (for example) literal graphics code that you include later.
-The text of a <code>\special</code> beginning with an ‘<samp>!</samp>’ is copied into
-the output file. A dictionary <code>SDict</code> will be current when this
-code is executed; Dvips arranges for <code>SDict</code> to be first on the
+The text of a <code class="code">\special</code> beginning with an ‘<samp class="samp">!</samp>’ is copied into
+the output file. A dictionary <code class="code">SDict</code> will be current when this
+code is executed; Dvips arranges for <code class="code">SDict</code> to be first on the
dictionary stack when any PostScript graphic is included, whether
-literally (the ‘<samp>"</samp>’ special) or through macros (e.g.,
-<samp>epsf.tex</samp>).
+literally (the ‘<samp class="samp">"</samp>’ special) or through macros (e.g.,
+<samp class="file">epsf.tex</samp>).
</p>
<p>For example:
</p>
<div class="example">
-<pre class="example">\special{! /reset { 0 0 moveto} def}
+<pre class="example-preformatted">\special{! /reset { 0 0 moveto} def}
</pre></div>
<hr>
</div>
-<div class="subsection" id="PostScript-hooks">
-<div class="header">
+<div class="subsection-level-extent" id="PostScript-hooks">
+<div class="nav-panel">
<p>
-Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="PostScript-hooks-1"></span><h4 class="subsection">5.3.4 PostScript hooks</h4>
+<h4 class="subsection" id="PostScript-hooks-1">5.3.4 PostScript hooks</h4>
-<span id="index-PostScript-hooks"></span>
+<a class="index-entry-id" id="index-PostScript-hooks"></a>
<p>Besides including literal PostScript at a particular place in your
document (as described in the previous section), you can also arrange to
@@ -3258,20 +3256,20 @@
execute arbitrary PostScript code at particular times while the
PostScript is printing.
</p>
-<span id="index-bop_002dhook-2"></span>
-<span id="index-eop_002dhook"></span>
-<span id="index-start_002dhook"></span>
-<span id="index-end_002dhook"></span>
-<p>If any of the PostScript names <code>bop-hook</code>, <code>eop-hook</code>,
-<code>start-hook</code>, or <code>end-hook</code> are defined in <code>userdict</code>,
+<a class="index-entry-id" id="index-bop_002dhook-2"></a>
+<a class="index-entry-id" id="index-eop_002dhook"></a>
+<a class="index-entry-id" id="index-start_002dhook"></a>
+<a class="index-entry-id" id="index-end_002dhook"></a>
+<p>If any of the PostScript names <code class="code">bop-hook</code>, <code class="code">eop-hook</code>,
+<code class="code">start-hook</code>, or <code class="code">end-hook</code> are defined in <code class="code">userdict</code>,
they will be executed at the beginning of a page, end of a page, start
of the document, and end of a document, respectively.
</p>
-<span id="index-draft-copies"></span>
-<span id="index-dated-output"></span>
+<a class="index-entry-id" id="index-draft-copies"></a>
+<a class="index-entry-id" id="index-dated-output"></a>
<p>When these macros are executed, the default PostScript coordinate system
and origin is in effect. Such macros can be defined in headers added by
-the ‘<samp>-h</samp>’ option or the ‘<samp>header=</samp>’ special, and might be useful
+the ‘<samp class="samp">-h</samp>’ option or the ‘<samp class="samp">header=</samp>’ special, and might be useful
for writing, for instance, ‘DRAFT’ across the entire page, or, with the
aid of a shell script, dating the document. These macros are executed
outside of the save/restore context of the individual pages, so it is
@@ -3279,9 +3277,9 @@
divided into sections because of memory constraints, such added
information will be lost across section breaks.
</p>
-<span id="index-physical-page-number_002c-and-bop_002dhook"></span>
-<p>The single argument to <code>bop-hook</code> is the physical page number; the
-first page gets zero, the second one, etc. <code>bop-hook</code> must leave
+<a class="index-entry-id" id="index-physical-page-number_002c-and-bop_002dhook"></a>
+<p>The single argument to <code class="code">bop-hook</code> is the physical page number; the
+first page gets zero, the second one, etc. <code class="code">bop-hook</code> must leave
this number on the stack. None of the other hooks are passed arguments.
</p>
<p>As an example of what can be done, the following special will write
@@ -3288,16 +3286,16 @@
a light grey ‘DRAFT’ across each page in the document:
</p>
<div class="example">
-<pre class="example">\special{!userdict begin /bop-hook{gsave 200 30 translate
+<pre class="example-preformatted">\special{!userdict begin /bop-hook{gsave 200 30 translate
65 rotate /Times-Roman findfont 216 scalefont setfont
0 0 moveto 0.7 setgray (DRAFT) show grestore}def end}
</pre></div>
-<span id="index-_0025_0025Page_002c-and-multi_002dpage-information"></span>
-<p>Using <code>bop-hook</code> or <code>eop-hook</code> to preserve information across
+<a class="index-entry-id" id="index-_0025_0025Page_002c-and-multi_002dpage-information"></a>
+<p>Using <code class="code">bop-hook</code> or <code class="code">eop-hook</code> to preserve information across
pages breaks compliance with the Adobe document structuring conventions,
-so if you use any such tricks, you may also want to use the ‘<samp>-N</samp>’
-option to turn off structured comments (such as ‘<samp>%%Page</samp>’).
+so if you use any such tricks, you may also want to use the ‘<samp class="samp">-N</samp>’
+option to turn off structured comments (such as ‘<samp class="samp">%%Page</samp>’).
Otherwise, programs that read your file will assume its pages are
independent.
</p>
@@ -3304,21 +3302,21 @@
<hr>
</div>
-<div class="subsection" id="Literal-examples">
-<div class="header">
+<div class="subsection-level-extent" id="Literal-examples">
+<div class="nav-panel">
<p>
Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Literal-examples-1"></span><h4 class="subsection">5.3.5 Literal examples</h4>
+<h4 class="subsection" id="Literal-examples-1">5.3.5 Literal examples</h4>
-<span id="index-literal-PostScript_002c-examples"></span>
-<span id="index-examples-of-literal-PostScript"></span>
+<a class="index-entry-id" id="index-literal-PostScript_002c-examples"></a>
+<a class="index-entry-id" id="index-examples-of-literal-PostScript"></a>
<p>To finish off this section, the following examples of literal PostScript
are presented without explanation:
</p>
<div class="example">
-<pre class="example">\def\rotninety{\special{ps:currentpoint currentpoint translate 90
+<pre class="example-preformatted">\def\rotninety{\special{ps:currentpoint currentpoint translate 90
rotate neg exch neg exch translate}}\font\huge=cmbx10 at 14.4truept
\setbox0=\hbox to0pt{\huge A\hss}\vskip16truept\centerline{\copy0
\special{ps:gsave}\rotninety\copy0\rotninety\copy0\rotninety
@@ -3328,7 +3326,7 @@
<div class="example">
-<pre class="example">\vbox to 2truein{\special{ps:gsave 0.3 setgray}\hrule height 2in
+<pre class="example-preformatted">\vbox to 2truein{\special{ps:gsave 0.3 setgray}\hrule height 2in
width\hsize\vskip-2in\special{ps:grestore}\font\big=cminch\big
\vss\special{ps:gsave 1 setgray}\vbox to 0pt{\vskip2pt
\line{\hss\hskip4pt NEAT\hss}\vss}\special{ps:0 setgray}%
@@ -3336,14 +3334,14 @@
</pre></div>
-<span id="index-_005crotninety"></span>
-<span id="index-gsave_002fgrestore_002c-and-literal-PS"></span>
-<span id="index-save_002frestore_002c-and-literal-PS"></span>
-<p>Some caveats are in order, however. Make sure that each <code>gsave</code> is
-matched with a <code>grestore</code> on the same page. Do not use <code>save</code>
-and <code>restore</code>; they can interact with the PostScript generated by
+<a class="index-entry-id" id="index-_005crotninety"></a>
+<a class="index-entry-id" id="index-gsave_002fgrestore_002c-and-literal-PS"></a>
+<a class="index-entry-id" id="index-save_002frestore_002c-and-literal-PS"></a>
+<p>Some caveats are in order, however. Make sure that each <code class="code">gsave</code> is
+matched with a <code class="code">grestore</code> on the same page. Do not use <code class="code">save</code>
+and <code class="code">restore</code>; they can interact with the PostScript generated by
Dvips if care is not taken. Try to understand what the above macros are
-doing before writing your own. The <code>\rotninety</code> macro especially
+doing before writing your own. The <code class="code">\rotninety</code> macro especially
has a useful trick that appears again and again.
</p>
@@ -3350,64 +3348,64 @@
<hr>
</div>
</div>
-<div class="section" id="Hypertext">
-<div class="header">
+<div class="section-level-extent" id="Hypertext">
+<div class="nav-panel">
<p>
Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PostScript</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="HyperTeXt"></span><h3 class="section">5.4 HyperTeXt</h3>
+<h3 class="section" id="HyperTeXt">5.4 HyperTeXt</h3>
-<span id="index-hypertext-support"></span>
+<a class="index-entry-id" id="index-hypertext-support"></a>
-<span id="index-_002dz"></span>
-<span id="index-html-specials"></span>
-<span id="index-pdfmark"></span>
+<a class="index-entry-id" id="index-_002dz"></a>
+<a class="index-entry-id" id="index-html-specials"></a>
+<a class="index-entry-id" id="index-pdfmark"></a>
<p>Dvips has support for producing hypertext PostScript documents. If you
-specify the ‘<samp>-z</samp>’ option, the <samp>html:</samp> specials described below
-will be converted into ‘<samp>pdfmark</samp>’ PostScript operators to specify
-links. Without ‘<samp>-z</samp>’, <samp>html:</samp> specials are ignored.
+specify the ‘<samp class="samp">-z</samp>’ option, the <samp class="file">html:</samp> specials described below
+will be converted into ‘<samp class="samp">pdfmark</samp>’ PostScript operators to specify
+links. Without ‘<samp class="samp">-z</samp>’, <samp class="file">html:</samp> specials are ignored.
</p>
-<span id="index-distiller_002c-for-PDF-files"></span>
-<span id="index-PDF-files_002c-making-1"></span>
+<a class="index-entry-id" id="index-distiller_002c-for-PDF-files"></a>
+<a class="index-entry-id" id="index-PDF-files_002c-making-1"></a>
<p>The resulting PostScript can then be processed by a distiller program to
make a PDF file. (It can still be handled by ordinary PostScript
interpreters as well.) Various versions of both PC and Unix distillers
are supported; Ghostscript includes limited distiller support
-(see <a href="#Ghostscript-installation">Ghostscript installation</a>).
+(see <a class="pxref" href="#Ghostscript-installation">Ghostscript installation</a>).
</p>
<p>By far the most common LaTeX package used to create hyperlinked
-output is <code>hyperref</code> (<a href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a>). For
+output is <code class="code">hyperref</code> (<a class="url" href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a>). For
plain TeX, the Eplain package has some hyperlink support
-(<a href="https://tug.org/eplain">https://tug.org/eplain</a>).
+(<a class="url" href="https://tug.org/eplain">https://tug.org/eplain</a>).
</p>
-<span id="index-Doyle_002c-Mark"></span>
-<span id="index-Bhattacharya_002c-Tanmoy"></span>
-<span id="index-dvihps_002c-hyperdvi-to-PostScript"></span>
+<a class="index-entry-id" id="index-Doyle_002c-Mark"></a>
+<a class="index-entry-id" id="index-Bhattacharya_002c-Tanmoy"></a>
+<a class="index-entry-id" id="index-dvihps_002c-hyperdvi-to-PostScript"></a>
<p>This hypertext support (and original form of the documentation) was
-written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp>dvihps</samp>’
+written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp class="samp">dvihps</samp>’
program.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></li>
<li><a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></li>
</ul>
<hr>
-<div class="subsection" id="Hypertext-caveats">
-<div class="header">
+<div class="subsection-level-extent" id="Hypertext-caveats">
+<div class="nav-panel">
<p>
Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Hypertext-caveats-1"></span><h4 class="subsection">5.4.1 Hypertext caveats</h4>
+<h4 class="subsection" id="Hypertext-caveats-1">5.4.1 Hypertext caveats</h4>
-<span id="index-hypertext-caveats"></span>
+<a class="index-entry-id" id="index-hypertext-caveats"></a>
-<span id="index-Computer-Modern-in-PostScript"></span>
-<span id="index-hypertext-and-bitmap-fonts"></span>
-<span id="index-hypertext-caveats-1"></span>
-<span id="index-embedding-Type-1-fonts"></span>
-<span id="index-PDF-files_002c-font-quality"></span>
+<a class="index-entry-id" id="index-Computer-Modern-in-PostScript"></a>
+<a class="index-entry-id" id="index-hypertext-and-bitmap-fonts"></a>
+<a class="index-entry-id" id="index-hypertext-caveats-1"></a>
+<a class="index-entry-id" id="index-embedding-Type-1-fonts"></a>
+<a class="index-entry-id" id="index-PDF-files_002c-font-quality"></a>
<p>If you intend to go all the way to PDF, you may want to use the standard
35 PostScript fonts exclusively, since other fonts are embedded as
bitmaps by default. The Adobe PDF readers are extremely slow when
@@ -3420,11 +3418,11 @@
any screen or printer resolution.
</p>
<p>To get the TeX fonts embedded in the PostScript file as Type 1 fonts,
-add ‘<samp>-Ppdf</samp>’ to the dvips command line switches. The printout
+add ‘<samp class="samp">-Ppdf</samp>’ to the dvips command line switches. The printout
for a run should look something like this:
</p>
-<div class="example">
-<pre class="example"> dvips report -Ppdf -o report.ps
+<div class="example smallexample">
+<pre class="example-preformatted"> dvips report -Ppdf -o report.ps
This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com)
' TeX output 2001.06.15:0837' -> report.ps
<tex.pro><alt-rule.pro><texc.pro><texps.pro><special.pro>.
@@ -3438,33 +3436,33 @@
Modern Roman 10 point font in a PostScript Font Binary file, translated
it to an ASCII encoding, and embedded it. You can confirm this by
examining the PostScript output file, looking for the section starting
-<code>%%BeginFont: CMR10</code> followed by an entry <code>/FontType 1 def</code>.
+<code class="code">%%BeginFont: CMR10</code> followed by an entry <code class="code">/FontType 1 def</code>.
</p>
-<p>The ‘<samp>-Ppdf</samp>’ option requires that the relevant outline
-(<samp>.pfa</samp> or <samp>.pfb</samp>) files be installed (see <a href="#Font-concepts">Font concepts</a>). For example, the <samp>cmr10</samp> file might be in
-<samp>/usr/share/texmf/fonts/type1/bluesky/cm/cmr10.pfb</samp>. Your TeX
+<p>The ‘<samp class="samp">-Ppdf</samp>’ option requires that the relevant outline
+(<samp class="file">.pfa</samp> or <samp class="file">.pfb</samp>) files be installed (see <a class="pxref" href="#Font-concepts">Font concepts</a>). For example, the <samp class="file">cmr10</samp> file might be in
+<samp class="file">/usr/share/texmf/fonts/type1/bluesky/cm/cmr10.pfb</samp>. Your TeX
distribution may make those fonts available in a separate optional
-package (e.g., <code>tetex-extra</code> in Debian). Failing that,
+package (e.g., <code class="code">tetex-extra</code> in Debian). Failing that,
commercial versions of the Computer Modern fonts are available from
Blue Sky; public domain versions, in particular, the lm
and cm-super font families, are available from CTAN and in TeX
distributions.
</p>
-<p>You can convert a PostScript file to PDF using <code>distill</code>, which
-comes with Adobe Acrobat, or <code>ps2pdf</code>, which comes with
-Ghostscript. The <code>ps2pdf</code> that comes with <code>Ghostscript</code>
+<p>You can convert a PostScript file to PDF using <code class="code">distill</code>, which
+comes with Adobe Acrobat, or <code class="code">ps2pdf</code>, which comes with
+Ghostscript. The <code class="code">ps2pdf</code> that comes with <code class="code">Ghostscript</code>
version 6.0 or earlier will not embed Type 1 fonts. Current
recommendations are GNU Ghostscript 6.51 or Aladdin Ghostscript 7.0.
You can check the fonts in a PDF file with Acrobat Reader by selecting
-the menu entries ‘<samp>File|Document Info|Fonts</samp>’.
+the menu entries ‘<samp class="samp">File|Document Info|Fonts</samp>’.
</p>
-<span id="index-psi-character-missing"></span>
-<span id="index-trailing-spaces_002c-dropped"></span>
-<span id="index-spaces_002c-dropped-trailing"></span>
+<a class="index-entry-id" id="index-psi-character-missing"></a>
+<a class="index-entry-id" id="index-trailing-spaces_002c-dropped"></a>
+<a class="index-entry-id" id="index-spaces_002c-dropped-trailing"></a>
<p>Also, the Adobe distillers prior to 2.1 drop trailing space characters
(character code 32) from strings. Unfortunately, the PostScript fonts
use this character code for characters other than space (notably the
-Greek letter psi in the <code>Symbol</code> font), and so these characters are
+Greek letter psi in the <code class="code">Symbol</code> font), and so these characters are
dropped. This bug is fixed in version 2.1.
</p>
<p>If you can’t upgrade, one workaround is to change all the trailing
@@ -3472,7 +3470,7 @@
because the default behavior is to substitute a blank for a missing
character, i.e., the distiller is fooled into substituting the right
character. For instance, with the Blue Sky fonts, you can globally
-replace ‘<samp> )</samp>’ with ‘<samp>\200)</samp>’ (with <code>sed</code>, for example) and
+replace ‘<samp class="samp"> )</samp>’ with ‘<samp class="samp">\200)</samp>’ (with <code class="code">sed</code>, for example) and
get the desired result. With the public domain fonts, you will probably
have to use a character code in the range 128 to 191 since these fonts
duplicate the first 32 characters starting at 192 to avoid MS-DOS
@@ -3483,102 +3481,102 @@
Kendall Whitehouse of Adobe. Adobe seems not to offer the article any
more, but copies are available elsewhere:
</p><div class="display">
-<pre class="display"><a href="http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html">http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html</a>
-<a href="http://www.utdallas.edu/~cantrell/online/543e.html">http://www.utdallas.edu/~cantrell/online/543e.html</a>
+<pre class="display-preformatted"><a class="url" href="http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html">http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html</a>
+<a class="url" href="http://www.utdallas.edu/~cantrell/online/543e.html">http://www.utdallas.edu/~cantrell/online/543e.html</a>
</pre></div>
<hr>
</div>
-<div class="subsection" id="Hypertext-specials">
-<div class="header">
+<div class="subsection-level-extent" id="Hypertext-specials">
+<div class="nav-panel">
<p>
Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Hypertext-specials-1"></span><h4 class="subsection">5.4.2 Hypertext specials</h4>
+<h4 class="subsection" id="Hypertext-specials-1">5.4.2 Hypertext specials</h4>
-<span id="index-hypertext-specials"></span>
-<span id="index-specials_002c-hypertext"></span>
+<a class="index-entry-id" id="index-hypertext-specials"></a>
+<a class="index-entry-id" id="index-specials_002c-hypertext"></a>
-<span id="index-Smith_002c-Arthur"></span>
+<a class="index-entry-id" id="index-Smith_002c-Arthur"></a>
<p>Current support for the World Wide Web in the TeX system does not
involve modifying TeX itself. We need only define some specials;
-Arthur Smith (<a href="mailto:apsmith at aps.org">apsmith at aps.org</a>), Tanmoy Bhattacharya, and Paul
+Arthur Smith (<a class="email" href="mailto:apsmith at aps.org">apsmith at aps.org</a>), Tanmoy Bhattacharya, and Paul
Ginsparg originally proposed and implemented the following:
</p><div class="example">
-<pre class="example">html:<a href="<var>xurl</var>">
-html:<a name="<var>name</var>">
+<pre class="example-preformatted">html:<a href="<var class="var">xurl</var>">
+html:<a name="<var class="var">name</var>">
html:</a>
-html:<img src="<var>xurl</var>">
-html:<base href="<var>xurl</var>">
+html:<img src="<var class="var">xurl</var>">
+html:<base href="<var class="var">xurl</var>">
</pre></div>
-<p>Like all TeX <code>\special</code>’s, these produce no visible output, and
+<p>Like all TeX <code class="code">\special</code>’s, these produce no visible output, and
are uninterpreted by TeX itself. They are instructions to DVI
processors only.
</p>
-<span id="index-uniform-resource-locator"></span>
-<span id="index-extended-URL"></span>
-<span id="index-URL_002c-extended-for-TeX"></span>
-<span id="index-Murphy_002c-Tim"></span>
-<p>Here, <var>xurl</var> is a standard WWW uniform resource locator (URL),
-possibly extended with a ‘<samp>#<var>type</var>.<var>string</var></samp>’ construct,
-where <var>type</var> is ‘<samp>page</samp>’, ‘<samp>section</samp>’, ‘<samp>equation</samp>’,
-‘<samp>reference</samp>’ (for bibliographic references), ‘<samp>figure</samp>’,
-‘<samp>table</samp>’, etc. For example,
-</p><div class="example">
-<pre class="example">\special{html:<a href="http://www.maths.tcd.ie/~tim/ch1.dvi#equation.1.1">}
+<a class="index-entry-id" id="index-uniform-resource-locator"></a>
+<a class="index-entry-id" id="index-extended-URL"></a>
+<a class="index-entry-id" id="index-URL_002c-extended-for-TeX"></a>
+<a class="index-entry-id" id="index-Murphy_002c-Tim"></a>
+<p>Here, <var class="var">xurl</var> is a standard WWW uniform resource locator (URL),
+possibly extended with a ‘<samp class="samp">#<var class="var">type</var>.<var class="var">string</var></samp>’ construct,
+where <var class="var">type</var> is ‘<samp class="samp">page</samp>’, ‘<samp class="samp">section</samp>’, ‘<samp class="samp">equation</samp>’,
+‘<samp class="samp">reference</samp>’ (for bibliographic references), ‘<samp class="samp">figure</samp>’,
+‘<samp class="samp">table</samp>’, etc. For example,
+</p><div class="example smallexample">
+<pre class="example-preformatted">\special{html:<a href="http://www.maths.tcd.ie/~tim/ch1.dvi#equation.1.1">}
</pre></div>
<p>is a link to equation (1.1) in an example document by Tim Murphy.
</p>
-<span id="index-URL_002c-definition"></span>
-<p>See the URL <a href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a>
+<a class="index-entry-id" id="index-URL_002c-definition"></a>
+<p>See the URL <a class="url" href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a>
for a precise description of base URL’s.
</p>
-<p>Descriptions of the <code>\special</code>’s:
-</p><dl compact="compact">
-<dt id='index-href'><span>‘<samp>href</samp>’<a href='#index-href' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-links_002c-hypertext"></span>
+<p>Descriptions of the <code class="code">\special</code>’s:
+</p><dl class="ftable">
+<dt id='index-href'><span>‘<samp class="samp">href</samp>’<a class="copiable-link" href='#index-href'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-links_002c-hypertext"></a>
<p>Creates links in your TeX document. For example:
</p><div class="example">
-<pre class="example">\special{html:<a href="http://www.tug.org/">}\TeX\ Users
+<pre class="example-preformatted">\special{html:<a href="http://www.tug.org/">}\TeX\ Users
Group\special{html:</a>}
</pre></div>
<p>The user will be able to click on the text ‘TeX Users
Group’ while running Xdvi and get to the TUG home page. (By the way,
this is for illustration. In practice, you most likely want to use
-macros to insert the <code>\special</code> commands; reference above.)
+macros to insert the <code class="code">\special</code> commands; reference above.)
</p>
</dd>
-<dt id='index-name'><span>‘<samp>name</samp>’<a href='#index-name' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-Anderson_002c-Laurie"></span>
+<dt id='index-name'><span>‘<samp class="samp">name</samp>’<a class="copiable-link" href='#index-name'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-Anderson_002c-Laurie"></a>
<p>Defines URL targets in your TeX documents, so links can be
resolved. For example:
</p><div class="example">
-<pre class="example">\special{html:<a name="paradise">}Paradise\special{html:</a>}
+<pre class="example-preformatted">\special{html:<a name="paradise">}Paradise\special{html:</a>}
is exactly where you are right now.
</pre></div>
-<p>This will resolve an ‘<samp>href="#paradise"</samp>’. You’ll also have to
-change the catcode of ‘<samp>#</samp>’, etc. It’s usually easiest to use
+<p>This will resolve an ‘<samp class="samp">href="#paradise"</samp>’. You’ll also have to
+change the catcode of ‘<samp class="samp">#</samp>’, etc. It’s usually easiest to use
existing macro packages which take care of all the details, such as
-<samp>hyperref</samp> for LaTeX. The <a href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information.
+<samp class="file">hyperref</samp> for LaTeX. The <a class="url" href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information.
</p>
</dd>
-<dt id='index-img'><span>‘<samp>img</samp>’<a href='#index-img' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-mailcap-and-hypertext"></span>
+<dt id='index-img'><span>‘<samp class="samp">img</samp>’<a class="copiable-link" href='#index-img'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-mailcap-and-hypertext"></a>
<p>Links to an arbitrary external file. Interactively, a viewer is spawned
-to read the file according to the file extension and your <samp>mailcap</samp>
+to read the file according to the file extension and your <samp class="file">mailcap</samp>
file (see the Xdvi documentation).
</p>
</dd>
-<dt id='index-base'><span>‘<samp>base</samp>’<a href='#index-base' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Defines a base URL that is prepended to all the <code>name</code> targets.
+<dt id='index-base'><span>‘<samp class="samp">base</samp>’<a class="copiable-link" href='#index-base'> ¶</a></span></dt>
+<dd><p>Defines a base URL that is prepended to all the <code class="code">name</code> targets.
Typically unnecessary, as the name of the DVI file being read is used by
default.
</p></dd>
</dl>
-<p>The ‘<samp>img</samp>’ and ‘<samp>base</samp>’ tags are not yet implemented in Dvips or
+<p>The ‘<samp class="samp">img</samp>’ and ‘<samp class="samp">base</samp>’ tags are not yet implemented in Dvips or
the NeXTSTEP DVI viewer.
</p>
@@ -3586,14 +3584,14 @@
</div>
</div>
</div>
-<div class="chapter" id="PostScript-fonts">
-<div class="header">
+<div class="chapter-level-extent" id="PostScript-fonts">
+<div class="nav-panel">
<p>
Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="PostScript-fonts-1"></span><h2 class="chapter">6 PostScript fonts</h2>
+<h2 class="chapter" id="PostScript-fonts-1">6 PostScript fonts</h2>
-<span id="index-PostScript-fonts"></span>
+<a class="index-entry-id" id="index-PostScript-fonts"></a>
<p>Dvips supports the use of PostScript fonts in TeX documents. To use
a PostScript font conveniently, you need to prepare a corresponding
@@ -3601,40 +3599,40 @@
with that.
</p>
<p>All the necessary support for the standard 35 PostScript fonts
-(‘<samp>AvantGarde-Book</samp>’ through ‘<samp>ZapfDingbats</samp>’), plus other freely
+(‘<samp class="samp">AvantGarde-Book</samp>’ through ‘<samp class="samp">ZapfDingbats</samp>’), plus other freely
or commonly available PostScript fonts is available along with Dvips.
To use these fonts, you need do nothing beyond what is mentioned in the
-installation procedure (see <a href="#Installation">Installation</a>). This chapter is
+installation procedure (see <a class="pxref" href="#Installation">Installation</a>). This chapter is
therefore relevant only if you are installing new PostScript fonts not
supplied with Dvips. (Or if you’re curious.)
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Font-concepts" accesskey="1">Font concepts</a></li>
<li><a href="#Making-a-font-available" accesskey="2">Making a PostScript font available</a></li>
<li><a href="#Invoking-afm2tfm" accesskey="3">Invoking Afm2tfm</a></li>
-<li><a href="#psfonts_002emap" accesskey="4"><samp>psfonts.map</samp>: PostScript font catalog</a></li>
+<li><a href="#psfonts_002emap" accesskey="4"><samp class="file">psfonts.map</samp>: PostScript font catalog</a></li>
</ul>
<hr>
-<div class="section" id="Font-concepts">
-<div class="header">
+<div class="section-level-extent" id="Font-concepts">
+<div class="nav-panel">
<p>
Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Font-concepts-1"></span><h3 class="section">6.1 Font concepts</h3>
+<h3 class="section" id="Font-concepts-1">6.1 Font concepts</h3>
-<span id="index-font-concepts"></span>
+<a class="index-entry-id" id="index-font-concepts"></a>
<p>The information needed to typeset using a particular font is contained
-in two files: a <em>metric file</em> that contains shape-independent
-information and a <em>glyph file</em> that contains the actual shapes of
-the font’s characters. A <em>virtual font</em> is an optional additional
+in two files: a <em class="dfn">metric file</em> that contains shape-independent
+information and a <em class="dfn">glyph file</em> that contains the actual shapes of
+the font’s characters. A <em class="dfn">virtual font</em> is an optional additional
file that can specify special ways to construct the characters. TeX
itself (or LaTeX) look only at the metric file, but DVI drivers such
as Dvips look at all three of these files.
</p>
-<p>An <em>encoding file</em> defines the correspondence between the code
+<p>An <em class="dfn">encoding file</em> defines the correspondence between the code
numbers of the characters in a font and their descriptive names. Two
encoding files used together can describe a reencoding that rearranges,
i.e., renumbers, the characters of a font.
@@ -3641,7 +3639,7 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Metric-files" accesskey="1">Metric files</a></li>
<li><a href="#Glyph-files" accesskey="2">Glyph files</a></li>
<li><a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></li>
@@ -3650,16 +3648,16 @@
<li><a href="#PostScript-typesetting" accesskey="6">How PostScript typesets a character</a></li>
</ul>
<hr>
-<div class="subsection" id="Metric-files">
-<div class="header">
+<div class="subsection-level-extent" id="Metric-files">
+<div class="nav-panel">
<p>
Next: <a href="#Glyph-files" accesskey="n" rel="next">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Metric-files-1"></span><h4 class="subsection">6.1.1 Metric files</h4>
+<h4 class="subsection" id="Metric-files-1">6.1.1 Metric files</h4>
-<span id="index-metric-files"></span>
+<a class="index-entry-id" id="index-metric-files"></a>
-<p>A <em>metric file</em> describes properties of the font that are
+<p>A <em class="dfn">metric file</em> describes properties of the font that are
independent of what the characters actually look like. Aside from
general information about the font itself, a metric file has two kinds
of information: information about individual characters, organized by
@@ -3668,53 +3666,53 @@
<p>The per-character information specifies the width, height, depth, and
italic correction of each character in the font. Any might be zero.
</p>
-<span id="index-kerning_002c-defined"></span>
-<span id="index-ligature_002c-defined"></span>
+<a class="index-entry-id" id="index-kerning_002c-defined"></a>
+<a class="index-entry-id" id="index-ligature_002c-defined"></a>
<p>In addition to information on individual characters, the metric file
-specifies <em>kerning</em>, i.e., adding or removing space between
-particular character pairs. It further specifies <em>ligature</em>
+specifies <em class="dfn">kerning</em>, i.e., adding or removing space between
+particular character pairs. It further specifies <em class="dfn">ligature</em>
information: when a sequence of input characters should be typeset as a
single (presumably different) “ligature” character. For example, it’s
-traditional for the input ‘<samp>fi</samp>’ to be typeset as ‘fi’, not as
-‘<span class="roman">f</span><span class="roman">i</span>’ (with the dot of the ‘i’ colliding with ‘f’). (In English,
+traditional for the input ‘<samp class="samp">fi</samp>’ to be typeset as ‘fi’, not as
+‘<span class="r">f</span><span class="r">i</span>’ (with the dot of the ‘i’ colliding with ‘f’). (In English,
the only common ligatures are fi, fl, ff, ffi, and ffl.)
</p>
<p>Different typesetting systems use different metric file formats:
</p>
-<ul>
-<li> <span id="index-afm-files"></span>
-<span id="index-_002eafm-Adobe-metric-files"></span>
-Each PostScript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’)
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-afm-files"></a>
+<a class="index-entry-id" id="index-_002eafm-Adobe-metric-files"></a>
+Each PostScript font has an <em class="dfn">Adobe font metrics</em> (‘<samp class="samp">.afm</samp>’)
file. These files are plain text, so you can inspect them easily. You
can get AFM files for Adobe’s fonts from
-<a href="ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs">ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs</a>.
+<a class="url" href="ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs">ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs</a>.
-</li><li> <span id="index-tfm-files"></span>
-<span id="index-_002etfm-TeX-font-metric-files"></span>
-TeX uses <em>TeX font metrics</em> (‘<samp>.tfm</samp>’) files. When you say
-‘<samp>\font = <var>font</var></samp>’ in your TeX document, TeX reads a file
-named ‘<samp><var>font</var>.tfm</samp>’. (Well, except for the <samp>texfonts.map</samp>
-feature; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then
+</li><li><a class="index-entry-id" id="index-tfm-files"></a>
+<a class="index-entry-id" id="index-_002etfm-TeX-font-metric-files"></a>
+TeX uses <em class="dfn">TeX font metrics</em> (‘<samp class="samp">.tfm</samp>’) files. When you say
+‘<samp class="samp">\font = <var class="var">font</var></samp>’ in your TeX document, TeX reads a file
+named ‘<samp class="samp"><var class="var">font</var>.tfm</samp>’. (Well, except for the <samp class="file">texfonts.map</samp>
+feature; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite class="cite">Kpathsea</cite>). 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.
-<span id="index-property-list-files"></span>
-<span id="index-tftopl"></span>
-<span id="index-pltotf"></span>
-<span id="index-_002epl-property-list-files"></span>
+<a class="index-entry-id" id="index-property-list-files"></a>
+<a class="index-entry-id" id="index-tftopl"></a>
+<a class="index-entry-id" id="index-pltotf"></a>
+<a class="index-entry-id" id="index-_002epl-property-list-files"></a>
<p>TFM files are binary (and hence are typically much smaller than AFM
-files). You can use the <code>tftopl</code> program (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl
-invocation</a> in <cite>Web2c</cite>) that comes with TeX to transform a TFM
-file into a human-readable “property list” (‘<samp>.pl</samp>’) file. You can
+files). You can use the <code class="code">tftopl</code> program (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl
+invocation</a> in <cite class="cite">Web2c</cite>) that comes with TeX to transform a TFM
+file into a human-readable “property list” (‘<samp class="samp">.pl</samp>’) file. You can
also edit a PL file and transform it back to a TeX-readable TFM with
-the companion program <code>pltotf</code> (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want
+the companion program <code class="code">pltotf</code> (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite class="cite">Web2c</cite>). Editing metrics by hand is not something you’re likely to want
to do often, but the capability is there.
</p>
-</li><li> <span id="index-pfm-files"></span>
-<span id="index-_002epfm-printer-font-metric-files"></span>
-ATM and other typesetting systems use <em>printer font metric</em>
-(‘<samp>.pfm</samp>’) files. These are binary files. They are irrelevant in the
+</li><li><a class="index-entry-id" id="index-pfm-files"></a>
+<a class="index-entry-id" id="index-_002epfm-printer-font-metric-files"></a>
+ATM and other typesetting systems use <em class="dfn">printer font metric</em>
+(‘<samp class="samp">.pfm</samp>’) files. These are binary files. They are irrelevant in the
TeX world, and not freely available, so we will not discuss them
further.
@@ -3722,19 +3720,19 @@
<p>The Afm2tfm program distributed with Dvips converts an AFM file
to a TFM file and performs other useful transformations as well.
-See <a href="#Invoking-afm2tfm">Invoking Afm2tfm</a>.
+See <a class="xref" href="#Invoking-afm2tfm">Invoking Afm2tfm</a>.
</p>
<hr>
</div>
-<div class="subsection" id="Glyph-files">
-<div class="header">
+<div class="subsection-level-extent" id="Glyph-files">
+<div class="nav-panel">
<p>
Next: <a href="#Virtual-fonts" accesskey="n" rel="next">Virtual fonts</a>, Previous: <a href="#Metric-files" accesskey="p" rel="prev">Metric files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Glyph-files-1"></span><h4 class="subsection">6.1.2 Glyph files</h4>
+<h4 class="subsection" id="Glyph-files-1">6.1.2 Glyph files</h4>
-<span id="index-glyph-files"></span>
+<a class="index-entry-id" id="index-glyph-files"></a>
<p>Although a metric file (see the previous section) contains information
about the spatial and other properties of the character at position 75,
@@ -3744,53 +3742,53 @@
TeX itself only reads the TFM file for a font; it does not need to
know character shapes.
</p>
-<p>A <em>glyph file</em> is a file that defines the shapes of the characters
+<p>A <em class="dfn">glyph file</em> is a file that defines the shapes of the characters
in a font. The shapes can be defined either by outlines or by bitmaps.
</p>
-<span id="index-outline-fonts"></span>
-<span id="index-arcs"></span>
-<span id="index-splines"></span>
-<p>PostScript fonts are defined as <em>outline fonts</em>: Each character in
+<a class="index-entry-id" id="index-outline-fonts"></a>
+<a class="index-entry-id" id="index-arcs"></a>
+<a class="index-entry-id" id="index-splines"></a>
+<p>PostScript fonts are defined as <em class="dfn">outline fonts</em>: Each character in
the font is defined by giving the mathematical curves (lines, arcs, and
splines) that define its contours. Different sizes of a character are
generated by linearly scaling a single shape. For example, a 10-point
‘A’ is simply half the size of a 20-point ‘A’. Nowadays, outline fonts
-usually also contain <em>hints</em>—additional information to improve the
+usually also contain <em class="dfn">hints</em>—additional information to improve the
appearance of the font at small sizes or low resolutions.
</p>
-<span id="index-Type-1-fonts"></span>
-<span id="index-pfa-files"></span>
-<span id="index-pfb-files"></span>
-<span id="index-_002epfa-printer-font-ascii-files"></span>
-<span id="index-_002epfb-printer-font-binary-files"></span>
+<a class="index-entry-id" id="index-Type-1-fonts"></a>
+<a class="index-entry-id" id="index-pfa-files"></a>
+<a class="index-entry-id" id="index-pfb-files"></a>
+<a class="index-entry-id" id="index-_002epfa-printer-font-ascii-files"></a>
+<a class="index-entry-id" id="index-_002epfb-printer-font-binary-files"></a>
<p>Although various kinds of PostScript outline fonts exist, by far the
-most common, and the only one we will consider, is called <em>Type 1</em>.
+most common, and the only one we will consider, is called <em class="dfn">Type 1</em>.
The glyph files for PostScript Type 1 fonts typically have names ending
-in ‘<samp>.pfa</samp>’ (“printer font ASCII”) or ‘<samp>.pfb</samp>’ (“printer font
+in ‘<samp class="samp">.pfa</samp>’ (“printer font ASCII”) or ‘<samp class="samp">.pfb</samp>’ (“printer font
binary”).
</p>
-<span id="index-bitmap-fonts"></span>
-<span id="index-_002emf-Metafont-source-files"></span>
-<span id="index-Metafont-source-files"></span>
+<a class="index-entry-id" id="index-bitmap-fonts"></a>
+<a class="index-entry-id" id="index-_002emf-Metafont-source-files"></a>
+<a class="index-entry-id" id="index-Metafont-source-files"></a>
<p>In contrast, glyph files for Computer Modern and the other standard
-TeX fonts are <em>bitmap fonts</em>, generated from Metafont
-(‘<samp>.mf</samp>’) descriptions. The Metafont program distributed with TeX
+TeX fonts are <em class="dfn">bitmap fonts</em>, generated from Metafont
+(‘<samp class="samp">.mf</samp>’) descriptions. The Metafont program distributed with TeX
generates bitmaps from these descriptions.
</p>
-<span id="index-pk-files"></span>
-<span id="index-_002ennnpk-packed-font-bitmaps"></span>
+<a class="index-entry-id" id="index-pk-files"></a>
+<a class="index-entry-id" id="index-_002ennnpk-packed-font-bitmaps"></a>
<p>The glyph files for TeX bitmap fonts are usually stored in
-<em>packed font</em> (PK) files. The names of these files end in
-‘<samp>.<var>nnn</var>pk</samp>’, where <var>nnn</var> is the resolution of the font in
-dots per inch. For example, <samp>cmr10.600pk</samp> contains the bitmaps for
-the ‘<samp>cmr10</samp>’ font at a resolution of 600dpi. (On DOS
-filesystems, it’s more likely <samp>dpi600\cmr10.pk</samp>.)
+<em class="dfn">packed font</em> (PK) files. The names of these files end in
+‘<samp class="samp">.<var class="var">nnn</var>pk</samp>’, where <var class="var">nnn</var> is the resolution of the font in
+dots per inch. For example, <samp class="file">cmr10.600pk</samp> contains the bitmaps for
+the ‘<samp class="samp">cmr10</samp>’ font at a resolution of 600<span class="dmn">dpi</span>. (On DOS
+filesystems, it’s more likely <samp class="file">dpi600\cmr10.pk</samp>.)
</p>
-<span id="index-gf-files"></span>
-<span id="index-gftopk"></span>
-<p>Metafont actually outputs <em>generic font</em> (GF) files, e.g.,
-<samp>cmr10.600gf</samp>, but the GF files are usually converted immediately
-to PK format (using the <code>gftopk</code> utility that comes with TeX)
+<a class="index-entry-id" id="index-gf-files"></a>
+<a class="index-entry-id" id="index-gftopk"></a>
+<p>Metafont actually outputs <em class="dfn">generic font</em> (GF) files, e.g.,
+<samp class="file">cmr10.600gf</samp>, but the GF files are usually converted immediately
+to PK format (using the <code class="code">gftopk</code> utility that comes with TeX)
since PK files are smaller and contain the same information. (The GF
format is a historical artifact.)
</p>
@@ -3797,88 +3795,88 @@
<hr>
</div>
-<div class="subsection" id="Virtual-fonts">
-<div class="header">
+<div class="subsection-level-extent" id="Virtual-fonts">
+<div class="nav-panel">
<p>
Next: <a href="#Encodings" accesskey="n" rel="next">Encodings</a>, Previous: <a href="#Glyph-files" accesskey="p" rel="prev">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Virtual-fonts-1"></span><h4 class="subsection">6.1.3 Virtual fonts</h4>
+<h4 class="subsection" id="Virtual-fonts-1">6.1.3 Virtual fonts</h4>
-<span id="index-virtual-fonts"></span>
+<a class="index-entry-id" id="index-virtual-fonts"></a>
-<p>A <em>virtual font</em> is constructed by extracting characters from one
+<p>A <em class="dfn">virtual font</em> is constructed by extracting characters from one
or more existing fonts and rearranging them, or synthesizing new
characters in various ways. The explanation in this manual is
intended to suffice for understanding enough about virtual fonts to
use them with Dvips. It isn’t a reference manual on virtual fonts.
For more information: The primary document on virtual fonts is
-Donald E. Knuth, <cite>TUGboat</cite> 11(1), Apr. 1990, pp. 13–23,
+Donald E. Knuth, <cite class="cite">TUGboat</cite> 11(1), Apr. 1990, pp. 13–23,
“Virtual Fonts: More Fun for Grand Wizards”
-(<a href="mirror.ctan.org/info/virtual-fonts.knuth">mirror.ctan.org/info/virtual-fonts.knuth</a>). (Don’t be
+(<a class="url" href="mirror.ctan.org/info/virtual-fonts.knuth">mirror.ctan.org/info/virtual-fonts.knuth</a>). (Don’t be
intimidated by the subtitle.)
</p>
-<span id="index-vf-files"></span>
-<span id="index-vpl-files"></span>
-<p>A virtual font (‘<samp>.vf</samp>’) file specifies, for each character in the
+<a class="index-entry-id" id="index-vf-files"></a>
+<a class="index-entry-id" id="index-vpl-files"></a>
+<p>A virtual font (‘<samp class="samp">.vf</samp>’) file specifies, for each character in the
virtual font, a recipe for typesetting that character. A VF file, like
-a TFM file, is in a compressed binary format. The <code>vftovp</code> and
-<code>vptovf</code> programs convert a VF file to a human-readable VPL
+a TFM file, is in a compressed binary format. The <code class="code">vftovp</code> and
+<code class="code">vptovf</code> programs convert a VF file to a human-readable VPL
(virtual property list) format and back again. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp
-invocation</a> in <cite>Web2c</cite>, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>.
+invocation</a> in <cite class="cite">Web2c</cite>, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite class="cite">Web2c</cite>.
</p>
-<span id="index-base-fonts"></span>
-<p>In the case of a PostScript font <var>f</var> being used in a straightforward
-way, the recipe says: character <var>i</var> in the VF font is character
-<var>j</var> in font <var>f</var>. The font <var>f</var> is called a <em>base font</em>.
+<a class="index-entry-id" id="index-base-fonts"></a>
+<p>In the case of a PostScript font <var class="var">f</var> being used in a straightforward
+way, the recipe says: character <var class="var">i</var> in the VF font is character
+<var class="var">j</var> in font <var class="var">f</var>. The font <var class="var">f</var> is called a <em class="dfn">base font</em>.
For example, the VF file could remap the characters of the PostScript
font to the positions where TeX expects to find them.
-See <a href="#Encodings">Encodings</a>.
+See <a class="xref" href="#Encodings">Encodings</a>.
</p>
<p>Since TeX reads only TFM files, not VF’s, each VF must have a
corresponding TFM for use with TeX. This corresponding TFM is
-created when you run <code>vptovf</code>.
+created when you run <code class="code">vptovf</code>.
</p>
-<span id="index-expansion_002c-of-virtual-fonts"></span>
-<span id="index-virtual-font-expansion"></span>
-<p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy
-(see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are
+<a class="index-entry-id" id="index-expansion_002c-of-virtual-fonts"></a>
+<a class="index-entry-id" id="index-virtual-font-expansion"></a>
+<p>You can <em class="dfn">expand</em> virtual fonts into their base fonts with DVIcopy
+(see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite class="cite">Web2c</cite>). This is useful if you are
using a DVI translator that doesn’t itself understand vf’s.
</p>
-<span id="index-ptex-JFM"></span>
-<span id="index-uptex-JFM"></span>
-<span id="index-Japanese-font-metric-file"></span>
-<span id="index-JFM-file_002c-and-virtual-font-fallback"></span>
+<a class="index-entry-id" id="index-ptex-JFM"></a>
+<a class="index-entry-id" id="index-uptex-JFM"></a>
+<a class="index-entry-id" id="index-Japanese-font-metric-file"></a>
+<a class="index-entry-id" id="index-JFM-file_002c-and-virtual-font-fallback"></a>
<p>If a virtual font has no entry at a given codepoint and the first
-<code>MAPFONT</code> designates an (u)pTeX JFM, we designate the glyph of
+<code class="code">MAPFONT</code> designates an (u)pTeX JFM, we designate the glyph of
the same codepoint in the TFM(JFM) with the smallest font ID. This
feature helps to reduce the size of Japanese virtual fonts. For more
information about the extensive support of Japanese in TeX, see
-<a href="https://github.com/texjporg">https://github.com/texjporg</a>.
+<a class="url" href="https://github.com/texjporg">https://github.com/texjporg</a>.
</p>
<hr>
</div>
-<div class="subsection" id="Encodings">
-<div class="header">
+<div class="subsection-level-extent" id="Encodings">
+<div class="nav-panel">
<p>
Next: <a href="#Bitmap-font-encodings" accesskey="n" rel="next">Bitmap font encodings</a>, Previous: <a href="#Virtual-fonts" accesskey="p" rel="prev">Virtual fonts</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Encodings-1"></span><h4 class="subsection">6.1.4 Encodings</h4>
+<h4 class="subsection" id="Encodings-1">6.1.4 Encodings</h4>
-<span id="index-encodings"></span>
+<a class="index-entry-id" id="index-encodings"></a>
-<p>Every font, whatever its type, has an <em>encoding</em>, that specifies the
+<p>Every font, whatever its type, has an <em class="dfn">encoding</em>, that specifies the
correspondence between “logical” characters and character codes. For
example, the ASCII encoding specifies that the character numbered 65
(decimal) is an uppercase ‘A’. The encoding does not specify what the
character at that position looks like; there are lots of ways to draw an
-‘A’, and a glyph file (see <a href="#Glyph-files">Glyph files</a>) tells how. Nor does it
+‘A’, and a glyph file (see <a class="pxref" href="#Glyph-files">Glyph files</a>) tells how. Nor does it
specify how much space that character occupies; that information is in a
-metric file (see <a href="#Metric-files">Metric files</a>).
+metric file (see <a class="pxref" href="#Metric-files">Metric files</a>).
</p>
-<span id="index-Computer-Modern_002c-encoding-of"></span>
+<a class="index-entry-id" id="index-Computer-Modern_002c-encoding-of"></a>
<p>TeX implicitly assumes a particular encoding for the fonts you use
-with it. For example, the plain TeX macro <code>\'</code>, which typesets
+with it. For example, the plain TeX macro <code class="code">\'</code>, which typesets
an acute accent over the following letter, assumes the acute accent is
at position 19 (decimal). This happens to be true of standard TeX
fonts such as Computer Modern, as you might expect, but it is not true
@@ -3887,14 +3885,14 @@
<p>It’s possible but painful to change all the macros that assume
particular character positions. A better solution is to create a new
font with the information for the acute accent at position 19, where
-TeX expects it to be. See <a href="#Making-a-font-available">Making a PostScript font available</a>.
+TeX expects it to be. See <a class="xref" href="#Making-a-font-available">Making a PostScript font available</a>.
</p>
-<span id="index-PostScript-encoding"></span>
-<span id="index-encoding-files"></span>
-<span id="index-encoding-vectors_002c-defined"></span>
+<a class="index-entry-id" id="index-PostScript-encoding"></a>
+<a class="index-entry-id" id="index-encoding-files"></a>
+<a class="index-entry-id" id="index-encoding-vectors_002c-defined"></a>
<p>PostScript represents encodings as a sequence of 256 character names
-called an <em>encoding vector</em>. An <em>encoding file</em> (‘<samp>.enc</samp>’)
+called an <em class="dfn">encoding vector</em>. An <em class="dfn">encoding file</em> (‘<samp class="samp">.enc</samp>’)
gives such a vector, together with ligature and kerning information
(with which we are not concerned at the moment). These encoding files
are used by the Afm2tfm program. Encoding files are also downloaded to
@@ -3901,36 +3899,36 @@
the PostScript interpreter in your printer if you use one of them in
place of the default encoding vector for a particular PostScript font.
</p>
-<span id="index-dvips_002eenc"></span>
-<span id="index-8r_002eenc"></span>
-<span id="index-texmext_002eenc"></span>
-<span id="index-texmital_002eenc"></span>
-<span id="index-texmsym_002eenc"></span>
-<span id="index-reencode_002f_002a_002eenc"></span>
-<p>Examples of encodings: the <samp>dvips.enc</samp> encoding file that comes
-with the Fontname distribution (<a href="http://tug.org/fontname">http://tug.org/fontname</a>) is a
+<a class="index-entry-id" id="index-dvips_002eenc"></a>
+<a class="index-entry-id" id="index-8r_002eenc"></a>
+<a class="index-entry-id" id="index-texmext_002eenc"></a>
+<a class="index-entry-id" id="index-texmital_002eenc"></a>
+<a class="index-entry-id" id="index-texmsym_002eenc"></a>
+<a class="index-entry-id" id="index-reencode_002f_002a_002eenc"></a>
+<p>Examples of encodings: the <samp class="file">dvips.enc</samp> encoding file that comes
+with the Fontname distribution (<a class="url" href="http://tug.org/fontname">http://tug.org/fontname</a>) is a
good (but not perfect) approximation to the TeX encoding for
TeX’s Computer Modern text fonts. This is the encoding of the
-fonts that originated with Dvips, such as <samp>ptmr.tfm</samp>. The
+fonts that originated with Dvips, such as <samp class="file">ptmr.tfm</samp>. The
distribution includes many other encoding files; for example,
-<samp>8r.enc</samp>, which is the base font for the current PostScript font
+<samp class="file">8r.enc</samp>, which is the base font for the current PostScript font
distribution, and three corresponding to the TeX mathematics fonts:
-<samp>texmext.enc</samp> for math extensions, <samp>texmital.enc</samp> for math
-italics, and <samp>texmsym.enc</samp> for math symbols.
+<samp class="file">texmext.enc</samp> for math extensions, <samp class="file">texmital.enc</samp> for math
+italics, and <samp class="file">texmsym.enc</samp> for math symbols.
</p>
<hr>
</div>
-<div class="subsection" id="Bitmap-font-encodings">
-<div class="header">
+<div class="subsection-level-extent" id="Bitmap-font-encodings">
+<div class="nav-panel">
<p>
Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">How PostScript typesets a character</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Bitmap-font-encodings-1"></span><h4 class="subsection">6.1.5 Bitmap font encodings</h4>
+<h4 class="subsection" id="Bitmap-font-encodings-1">6.1.5 Bitmap font encodings</h4>
-<span id="index-bitmap-font-encodings"></span>
-<span id="index-font-encodings_002c-bitmap"></span>
-<span id="index-encodings_002c-for-bitmap-fonts"></span>
+<a class="index-entry-id" id="index-bitmap-font-encodings"></a>
+<a class="index-entry-id" id="index-font-encodings_002c-bitmap"></a>
+<a class="index-entry-id" id="index-encodings_002c-for-bitmap-fonts"></a>
<p>To dvips, bitmapped fonts do not have any notion of linguistics; they
are simply a vector of glyphs. By comparison, PostScript fonts are
@@ -3942,17 +3940,17 @@
naming information to Type 3 bitmapped fonts (if they can locate such
information) as an Encoding vector. This provides some support for
search, for copy and paste, and even some limited support for
-accessibility. The ‘<samp>bitmapfontenc</samp>’ command line option
-(see <a href="#Option-details">Option details</a> and <code>bitmapfontenc</code> configuration option
-(see <a href="#Configuration-file-commands">Configuration file commands</a>) enable and disable this
+accessibility. The ‘<samp class="samp">bitmapfontenc</samp>’ command line option
+(see <a class="pxref" href="#Option-details">Option details</a> and <code class="code">bitmapfontenc</code> configuration option
+(see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>) enable and disable this
functionality; by default it is set to enabled, without warnings.
</p>
-<span id="index-dvips_002dall_002eenc"></span>
+<a class="index-entry-id" id="index-dvips_002dall_002eenc"></a>
<p>To do this, dvips must find encoding information for the bitmapped
fonts. It does this by first searching for a font-specific encoding
-file; for instance, for cmr10, it will search for <samp>dvips-cmr10.enc</samp>
+file; for instance, for cmr10, it will search for <samp class="file">dvips-cmr10.enc</samp>
in the standard encoding path. If it does not find such a file, it
-will search for a <samp>dvips-all.enc</samp> file which contains a base set of
+will search for a <samp class="file">dvips-all.enc</samp> file which contains a base set of
encodings for many fonts.
</p>
<p>The specific syntax of an encoding file is unspecified, except that it
@@ -3966,13 +3964,13 @@
enhancements that may add additional constructs to the font dictionary
to enhance the interpretation of font characters.
</p>
-<p>The <samp>dvips-all.enc</samp> file contains encodings for many fonts, and
+<p>The <samp class="file">dvips-all.enc</samp> file contains encodings for many fonts, and
it is loaded by dvips at most once. The format is just a sequence of
font names, one per line, each terminated by a colon, followed by the
encoding to use for those files.
</p>
-<span id="index-bounding-box_002c-for-bitmap-fonts"></span>
-<span id="index-coordinate-system_002c-for-bitmap-fonts"></span>
+<a class="index-entry-id" id="index-bounding-box_002c-for-bitmap-fonts"></a>
+<a class="index-entry-id" id="index-coordinate-system_002c-for-bitmap-fonts"></a>
<p>As part of its operation, to enable heuristics in PostScript and
PDF viewers to properly identify word breaks and column gutters,
dvips also generates a modified font bounding box and a modified
@@ -3981,15 +3979,15 @@
<hr>
</div>
-<div class="subsection" id="PostScript-typesetting">
-<div class="header">
+<div class="subsection-level-extent" id="PostScript-typesetting">
+<div class="nav-panel">
<p>
Previous: <a href="#Bitmap-font-encodings" accesskey="p" rel="prev">Bitmap font encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="How-PostScript-typesets-a-character"></span><h4 class="subsection">6.1.6 How PostScript typesets a character</h4>
+<h4 class="subsection" id="How-PostScript-typesets-a-character">6.1.6 How PostScript typesets a character</h4>
-<span id="index-typesetting-in-PostScript"></span>
-<span id="index-character-lookup-procedure-in-PostScript"></span>
+<a class="index-entry-id" id="index-typesetting-in-PostScript"></a>
+<a class="index-entry-id" id="index-character-lookup-procedure-in-PostScript"></a>
<p>The output of Dvips is a program in the PostScript language that
instructs your (presumably PostScript-capable) printer how to typeset
@@ -3999,9 +3997,9 @@
</p>
<p>The program must include the definition of any PostScript fonts that you
use in your document. Fonts built into your printer (probably the
-standard 35: ‘<samp>Times-Roman</samp>’, ‘<samp>ZapfDingbats</samp>’, …) are
+standard 35: ‘<samp class="samp">Times-Roman</samp>’, ‘<samp class="samp">ZapfDingbats</samp>’, …) are
defined within the interpreter itself. Other fonts must be downloaded
-as pfa or pfb files (see <a href="#Glyph-files">Glyph files</a>) from your host (the computer
+as pfa or pfb files (see <a class="pxref" href="#Glyph-files">Glyph files</a>) from your host (the computer
on which you’re running Dvips).
</p>
<p>You may be wondering exactly how a PostScript interpreter figures out
@@ -4009,27 +4007,27 @@
and other information. (If you’re not wondering, skip this section
…)
</p>
-<span id="index-show-PostScript-operator"></span>
+<a class="index-entry-id" id="index-show-PostScript-operator"></a>
<p>The basic PostScript operator for imaging characters is
-<code>show</code>. Suppose you’ve asked TeX to typeset an ‘S’. This will
+<code class="code">show</code>. Suppose you’ve asked TeX to typeset an ‘S’. This will
eventually wind up in the Dvips output as the equivalent of this
PostScript operation:
</p>
<div class="example">
-<pre class="example">(S) show
+<pre class="example-preformatted">(S) show
</pre></div>
<p>Here is how PostScript typesets the ‘S’:
</p>
-<ol>
-<li> <span id="index-ASCII-character-codes_002c-used-by-PostScript"></span>
+<ol class="enumerate">
+<li> <a class="index-entry-id" id="index-ASCII-character-codes_002c-used-by-PostScript"></a>
PostScript interpreters use ASCII; therefore ‘S’ is represented as the
integer 83. (Any of the 256 possible characters representable in a
standard 8-bit byte can be typeset.)
-</li><li> <span id="index-current-font_002c-in-PostScript"></span>
-<span id="index-dictionary_002c-PostScript-language"></span>
-A PostScript <em>dictionary</em> is a mapping of names to arbitrary values.
+</li><li> <a class="index-entry-id" id="index-current-font_002c-in-PostScript"></a>
+<a class="index-entry-id" id="index-dictionary_002c-PostScript-language"></a>
+A PostScript <em class="dfn">dictionary</em> is a mapping of names to arbitrary values.
A font, to the interpreter, is a dictionary which contains entries for
certain names. (If these entries are missing, the interpreter refuses
to do anything with that font.)
@@ -4037,28 +4035,28 @@
<p>PostScript has a notion of “the current font”—whatever font is
currently being typeset in.
</p>
-</li><li> <span id="index-encoding-vectors_002c-in-Type-1-fonts"></span>
-<span id="index-Encoding-Type-1-dictionary"></span>
-One of the mandatory entries in a font dictionary is ‘<samp>Encoding</samp>’,
-which defines the encoding vector (see <a href="#Encodings">Encodings</a>) for that font.
+</li><li> <a class="index-entry-id" id="index-encoding-vectors_002c-in-Type-1-fonts"></a>
+<a class="index-entry-id" id="index-Encoding-Type-1-dictionary"></a>
+One of the mandatory entries in a font dictionary is ‘<samp class="samp">Encoding</samp>’,
+which defines the encoding vector (see <a class="pxref" href="#Encodings">Encodings</a>) for that font.
This vector of 256 names maps each possible input character to a name.
</li><li> The interpreter retrieves the entry at position 83 of the encoding
-vector. This value is a PostScript name: <code>/S</code>.
+vector. This value is a PostScript name: <code class="code">/S</code>.
-</li><li> <span id="index-CharStrings-Type-1-dictionary"></span>
-<span id="index-dictionary_002c-CharStrings"></span>
+</li><li> <a class="index-entry-id" id="index-CharStrings-Type-1-dictionary"></a>
+<a class="index-entry-id" id="index-dictionary_002c-CharStrings"></a>
For Type 1 fonts (we’re not going to discuss anything else), the
-interpreter now looks up <code>/S</code> as a key in a dictionary named
-<code>CharStrings</code>, another mandatory entry in a font dictionary.
+interpreter now looks up <code class="code">/S</code> as a key in a dictionary named
+<code class="code">CharStrings</code>, another mandatory entry in a font dictionary.
-</li><li> <span id="index-hints"></span>
-<span id="index-character-definitions-in-PostScript"></span>
-The value of <code>S</code> in <code>CharStrings</code> is the equivalent of a
-series of standard PostScript commands like ‘<samp>curveto</samp>’,
-‘<samp>lineto</samp>’, ‘<samp>fill</samp>’, and so on. These commands are executed to
-draw the character. There can also be <em>hint information</em> that helps
-adapt the character to low-resolution rasters. (See <a href="#Glyph-files">Glyph files</a>.)
+</li><li> <a class="index-entry-id" id="index-hints"></a>
+<a class="index-entry-id" id="index-character-definitions-in-PostScript"></a>
+The value of <code class="code">S</code> in <code class="code">CharStrings</code> is the equivalent of a
+series of standard PostScript commands like ‘<samp class="samp">curveto</samp>’,
+‘<samp class="samp">lineto</samp>’, ‘<samp class="samp">fill</samp>’, and so on. These commands are executed to
+draw the character. There can also be <em class="dfn">hint information</em> that helps
+adapt the character to low-resolution rasters. (See <a class="xref" href="#Glyph-files">Glyph files</a>.)
The commands are actually represented in a more compact way than
standard PostScript source; see the Type 1 book for details.
@@ -4072,15 +4070,15 @@
<hr>
</div>
</div>
-<div class="section" id="Making-a-font-available">
-<div class="header">
+<div class="section-level-extent" id="Making-a-font-available">
+<div class="nav-panel">
<p>
Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking Afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Making-a-PostScript-font-available"></span><h3 class="section">6.2 Making a PostScript font available</h3>
+<h3 class="section" id="Making-a-PostScript-font-available">6.2 Making a PostScript font available</h3>
-<span id="index-installing-fonts"></span>
-<span id="index-fonts_002c-installing"></span>
+<a class="index-entry-id" id="index-installing-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-installing"></a>
<p>To make a PostScript font available in a TeX document, you need to
install the font on your system and then define it within the document.
@@ -4089,41 +4087,41 @@
an AFM file for any font you install. Unless the font is built into your
printer, you must also have a PFA or PFB file.
</p>
-<p>In the following examples, we use the font ‘<samp>Times-Roman</samp>’ to
+<p>In the following examples, we use the font ‘<samp class="samp">Times-Roman</samp>’ to
illustrate the process. But you should use the prebuilt fonts for Times
and the other standard fonts, rather than rebuilding them. The prebuilt
fonts are made using a more complicated process than that described
here, to make them work as well as possible with TeX. So following
the steps in this manual will not generate files identical to the
-distributed ones. See <a href="#PostScript-font-installation">PostScript font installation</a>, for pointers to
+distributed ones. See <a class="xref" href="#PostScript-font-installation">PostScript font installation</a>, for pointers to
the prebuilt fonts.
</p>
-<p>Installation of a PostScript font proceeds in three steps. See <a href="#Font-concepts">Font concepts</a>, for descriptions of the various files involved.
+<p>Installation of a PostScript font proceeds in three steps. See <a class="xref" href="#Font-concepts">Font concepts</a>, for descriptions of the various files involved.
</p>
-<ol>
-<li> Run <code>afm2tfm</code> to create a TFM file for the original font,
+<ol class="enumerate">
+<li> Run <code class="code">afm2tfm</code> to create a TFM file for the original font,
and the VPL form of the virtual font:
<div class="example">
-<pre class="example">afm2tfm Times-Roman -v ptmr rptmr
+<pre class="example-preformatted">afm2tfm Times-Roman -v ptmr rptmr
</pre></div>
-</li><li> Run <code>vptovf</code> to generate a VF and TFM file for the virtual font
+</li><li> Run <code class="code">vptovf</code> to generate a VF and TFM file for the virtual font
from the VPL file:
<div class="example">
-<pre class="example">vptovf ptmr.vpl ptmr.vf ptmr.tfm
+<pre class="example-preformatted">vptovf ptmr.vpl ptmr.vf ptmr.tfm
</pre></div>
-</li><li> Insert an entry for the font in <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>):
+</li><li> Insert an entry for the font in <samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>):
<div class="example">
-<pre class="example">rptmr Times-Roman <ptmr8a.pfa
+<pre class="example-preformatted">rptmr Times-Roman <ptmr8a.pfa
</pre></div>
</li><li> Install the files in the standard locations, as in:
<div class="example">
-<pre class="example">cp ptmr.vf <var>fontdir</var>/vf/…
-cp *ptmr.tfm <var>fontdir</var>/tfm/…
-cp ptmr.afm <var>fontdir</var>/afm/…
-cp ptmr.pf? <var>fontdir</var>/type1/…
+<pre class="example-preformatted">cp ptmr.vf <var class="var">fontdir</var>/vf/…
+cp *ptmr.tfm <var class="var">fontdir</var>/tfm/…
+cp ptmr.afm <var class="var">fontdir</var>/afm/…
+cp ptmr.pf? <var class="var">fontdir</var>/type1/…
</pre></div>
</li></ol>
@@ -4130,33 +4128,33 @@
<p>The simplest invocation of Afm2tfm to make virtual fonts goes something
like this:
</p>
-<span id="index-afm2tfm"></span>
+<a class="index-entry-id" id="index-afm2tfm"></a>
<div class="example">
-<pre class="example">afm2tfm Times-Roman -v ptmr rptmr
+<pre class="example-preformatted">afm2tfm Times-Roman -v ptmr rptmr
</pre></div>
-<p>This reads the file <samp>Times-Roman.afm</samp>, and produces two files as
-output, namely the virtual property list file <samp>ptmr.vpl</samp>, and the
-“raw” font metric file <samp>rptmr.tfm</samp>. To use the font in TeX,
+<p>This reads the file <samp class="file">Times-Roman.afm</samp>, and produces two files as
+output, namely the virtual property list file <samp class="file">ptmr.vpl</samp>, and the
+“raw” font metric file <samp class="file">rptmr.tfm</samp>. To use the font in TeX,
you first run
</p>
-<span id="index-vptovf"></span>
+<a class="index-entry-id" id="index-vptovf"></a>
<div class="example">
-<pre class="example">vptovf ptmr.vpl ptmr.vf ptmr.tfm
+<pre class="example-preformatted">vptovf ptmr.vpl ptmr.vf ptmr.tfm
</pre></div>
-<p>You should then install the virtual font file <samp>ptmr.vf</samp> where Dvips
-will see it and install <samp>ptmr.tfm</samp> and <samp>rptmr.tfm</samp> where
+<p>You should then install the virtual font file <samp class="file">ptmr.vf</samp> where Dvips
+will see it and install <samp class="file">ptmr.tfm</samp> and <samp class="file">rptmr.tfm</samp> where
TeX and Dvips will see them.
</p>
<p>Using these raw fonts is not recommended; there are no raw fonts in the
prebuilt PostScript fonts distributed along with Dvips. But
nevertheless, that’s how Afm2tfm presently operates, so that’s what we
-document here. The ‘<samp>r</samp>’ prefix convention is likewise historical
+document here. The ‘<samp class="samp">r</samp>’ prefix convention is likewise historical
accident.
</p>
-<p>You can also make more complex virtual fonts by editing <samp>ptmr.vpl</samp>
-before running ‘<samp>vptovf</samp>’; such editing might add the uppercase Greek
+<p>You can also make more complex virtual fonts by editing <samp class="file">ptmr.vpl</samp>
+before running ‘<samp class="samp">vptovf</samp>’; such editing might add the uppercase Greek
characters in the standard TeX positions, for instance. (This has
already been done for the prebuilt fonts.)
</p>
@@ -4163,23 +4161,23 @@
<p>Once the files have been installed, you’re all set. You can now do
things like this in TeX:
</p><div class="example">
-<pre class="example">\font\myfont = ptmr at 12pt
+<pre class="example-preformatted">\font\myfont = ptmr at 12pt
\myfont Hello, I am being typeset in 12-point Times-Roman.
</pre></div>
-<p>Thus, we have two fonts, one actual (‘<samp>rptmr</samp>’, which is analogous to
-the font in the printer) and one virtual (‘<samp>ptmr</samp>’, which has been
+<p>Thus, we have two fonts, one actual (‘<samp class="samp">rptmr</samp>’, which is analogous to
+the font in the printer) and one virtual (‘<samp class="samp">ptmr</samp>’, which has been
remapped to the standard TeX encoding (almost)), and has typesetting
know-how added. You could also say
</p>
<div class="example">
-<pre class="example">\font\raw = rptmr at 10pt
+<pre class="example-preformatted">\font\raw = rptmr at 10pt
</pre></div>
<p>and typeset directly with that, but then you would have no ligatures or
kerning, and you would have to use Adobe character positions for special
letters like
-The virtual font ‘<samp>ptmr</samp>’ not only has ligatures and kerning, and
+The virtual font ‘<samp class="samp">ptmr</samp>’ not only has ligatures and kerning, and
most of the standard accent conventions of TeX, it also has a few
additional features not present in the Computer Modern fonts. For
example, it includes all the Adobe characters (such as the Polish ogonek
@@ -4187,40 +4185,40 @@
TeX text fonts are the dotless ‘j’ (which can be hacked into the VPL
file with literal PostScript specials if you have the patience) and
uppercase Greek letters (which just don’t exist unless you buy them
-separately). See <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a>.
+separately). See <a class="xref" href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a>.
</p>
<p>As a final step you need to record information about both the virtual
font and the original font (if you ever might want to use it) in the
-<samp>psfonts.map</samp> file (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>). For our example, you’d
-insert the following into <samp>psfonts.map</samp>:
+<samp class="file">psfonts.map</samp> file (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>). For our example, you’d
+insert the following into <samp class="file">psfonts.map</samp>:
</p><div class="example">
-<pre class="example">rptmr Times-Roman <ptmr8a.pfa
+<pre class="example-preformatted">rptmr Times-Roman <ptmr8a.pfa
</pre></div>
-<p>Of course, <code>Times-Roman</code> is already built in to most every
+<p>Of course, <code class="code">Times-Roman</code> is already built in to most every
printer, so there’s no need to download any Type 1 file for it. But if
you are actually following these instructions for new fonts, most likely
they are not built in to the printer.
</p>
-<span id="index-memory_002c-used-by-PostScript-fonts"></span>
-<span id="index-efficiency_002c-and-fonts"></span>
+<a class="index-entry-id" id="index-memory_002c-used-by-PostScript-fonts"></a>
+<a class="index-entry-id" id="index-efficiency_002c-and-fonts"></a>
<p>These PostScript fonts can be scaled to any size. Go wild! Using
PostScript fonts, however, does use up a great deal of the printer’s
memory and it does take time. You may find downloading bitmap fonts
-(possibly compressed, with the ‘<samp>Z</samp>’ option) to be faster than using
+(possibly compressed, with the ‘<samp class="samp">Z</samp>’ option) to be faster than using
the built-in PostScript fonts.
</p>
<hr>
</div>
-<div class="section" id="Invoking-afm2tfm">
-<div class="header">
+<div class="section-level-extent" id="Invoking-afm2tfm">
+<div class="nav-panel">
<p>
-Next: <a href="#psfonts_002emap" accesskey="n" rel="next"><samp>psfonts.map</samp>: PostScript font catalog</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#psfonts_002emap" accesskey="n" rel="next"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Invoking-Afm2tfm"></span><h3 class="section">6.3 Invoking Afm2tfm</h3>
+<h3 class="section" id="Invoking-Afm2tfm">6.3 Invoking Afm2tfm</h3>
-<span id="index-afm2tfm-1"></span>
+<a class="index-entry-id" id="index-afm2tfm-1"></a>
<p>The Afm2tfm program converts an AFM file for a PostScript font to a TFM
file and a VPL file for a corresponding virtual font (or, in its
@@ -4229,76 +4227,76 @@
especially by the reencodings you can specify with those options. You
can also obtain special effects such as an oblique font.
</p>
-<span id="index-fontinst"></span>
-<span id="index-virtual-fonts_002c-creating"></span>
-<span id="index-Jeffrey_002c-Alan"></span>
+<a class="index-entry-id" id="index-fontinst"></a>
+<a class="index-entry-id" id="index-virtual-fonts_002c-creating"></a>
+<a class="index-entry-id" id="index-Jeffrey_002c-Alan"></a>
<p>Alternatives to Afm2tfm for creating virtual fonts include
-<code>fontinst</code> <a href="https://ctan.org/pkg/fontinst">https://ctan.org/pkg/fontinst</a>,
-<code>lcdf-typetools</code>, particularly <code>otftotfm</code>
-(<a href="https://ctan.org/pkg/lcdf-typetools">https://ctan.org/pkg/lcdf-typetools</a>), and <code>afm2pl</code>
-(<a href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others.
+<code class="code">fontinst</code> <a class="url" href="https://ctan.org/pkg/fontinst">https://ctan.org/pkg/fontinst</a>,
+<code class="code">lcdf-typetools</code>, particularly <code class="code">otftotfm</code>
+(<a class="url" href="https://ctan.org/pkg/lcdf-typetools">https://ctan.org/pkg/lcdf-typetools</a>), and <code class="code">afm2pl</code>
+(<a class="url" href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></li>
<li><a href="#Special-font-effects" accesskey="2">Special font effects</a></li>
<li><a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></li>
</ul>
<hr>
-<div class="subsection" id="Changing-font-encodings">
-<div class="header">
+<div class="subsection-level-extent" id="Changing-font-encodings">
+<div class="nav-panel">
<p>
Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Changing-font-encodings-1"></span><h4 class="subsection">6.3.1 Changing font encodings</h4>
+<h4 class="subsection" id="Changing-font-encodings-1">6.3.1 Changing font encodings</h4>
-<span id="index-encoding-changes"></span>
-<span id="index-fonts_002c-changing-encoding-of"></span>
+<a class="index-entry-id" id="index-encoding-changes"></a>
+<a class="index-entry-id" id="index-fonts_002c-changing-encoding-of"></a>
<p>Afm2tfm allows you to specify a different encoding for a PostScript font
-(for a general introduction to encodings, see <a href="#Encodings">Encodings</a>). The
-‘<samp>-t</samp>’ option changes the TeX encoding, ‘<samp>-p</samp>’ changes the
-PostScript encoding, and ‘<samp>-T</samp>’ changes both simultaneously, as
+(for a general introduction to encodings, see <a class="pxref" href="#Encodings">Encodings</a>). The
+‘<samp class="samp">-t</samp>’ option changes the TeX encoding, ‘<samp class="samp">-p</samp>’ changes the
+PostScript encoding, and ‘<samp class="samp">-T</samp>’ changes both simultaneously, as
detailed in the sections below.
</p>
-<ul class="section-toc">
-<li><a href="#Changing-TeX-encodings" accesskey="1">‘<samp>-t</samp>’: Changing TeX encodings</a></li>
-<li><a href="#Changing-PostScript-encodings" accesskey="2">‘<samp>-p</samp>’: Changing PostScript encodings</a></li>
-<li><a href="#Changing-both-encodings" accesskey="3">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li>
+<ul class="mini-toc">
+<li><a href="#Changing-TeX-encodings" accesskey="1">‘<samp class="samp">-t</samp>’: Changing TeX encodings</a></li>
+<li><a href="#Changing-PostScript-encodings" accesskey="2">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a></li>
+<li><a href="#Changing-both-encodings" accesskey="3">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a></li>
<li><a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></li>
<li><a href="#Encoding-file-format" accesskey="5">Encoding file format</a></li>
</ul>
<hr>
-<div class="subsubsection" id="Changing-TeX-encodings">
-<div class="header">
+<div class="subsubsection-level-extent" id="Changing-TeX-encodings">
+<div class="nav-panel">
<p>
-Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_002dt_003a-Changing-TeX-encodings"></span><h4 class="subsubsection">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</h4>
+<h4 class="subsubsection" id="g_t_002dt_003a-Changing-TeX-encodings">6.3.1.1 ‘<samp class="samp">-t</samp>’: Changing TeX encodings</h4>
-<span id="index-changing-TeX-encodings"></span>
-<span id="index-TeX-encoding_002c-changing"></span>
+<a class="index-entry-id" id="index-changing-TeX-encodings"></a>
+<a class="index-entry-id" id="index-TeX-encoding_002c-changing"></a>
-<span id="index-_002dt-tex_002denc"></span>
-<p>To build a virtual font with Afm2tfm, you specify the ‘<samp>-v</samp>’ or
-‘<samp>-V</samp>’ option. You can then specify an encoding for that virtual font
-with ‘<samp>-t <var>tex-enc</var></samp>’. (‘<samp>-t</samp>’ is ignored if neither
-‘<samp>-v</samp>’ nor ‘<samp>-V</samp>’ is present.) Any ligature and kerning
-information you specify in <var>tex-enc</var> will be used in the VPL, in
+<a class="index-entry-id" id="index-_002dt-tex_002denc"></a>
+<p>To build a virtual font with Afm2tfm, you specify the ‘<samp class="samp">-v</samp>’ or
+‘<samp class="samp">-V</samp>’ option. You can then specify an encoding for that virtual font
+with ‘<samp class="samp">-t <var class="var">tex-enc</var></samp>’. (‘<samp class="samp">-t</samp>’ is ignored if neither
+‘<samp class="samp">-v</samp>’ nor ‘<samp class="samp">-V</samp>’ is present.) Any ligature and kerning
+information you specify in <var class="var">tex-enc</var> will be used in the VPL, in
addition to the ligature and kerning information from the AFM file.
</p>
-<p>If the AFM file has no entry for a character specified in <var>tex-enc</var>,
+<p>If the AFM file has no entry for a character specified in <var class="var">tex-enc</var>,
that character will be omitted from the output VPL.
</p>
-<span id="index-texmsym_002eenc-1"></span>
-<p>The ‘<samp>-t</samp>’ option is likely to be needed when you have a PostScript
+<a class="index-entry-id" id="index-texmsym_002eenc-1"></a>
+<p>The ‘<samp class="samp">-t</samp>’ option is likely to be needed when you have a PostScript
font corresponding to a TeX font other than a normal text font such
as Computer Modern. For instance, if you have a PostScript font that
contains math symbols, you’d probably want to use the encoding in the
-<samp>texmsym.enc</samp> file supplied with Dvips. (For a start; to actually
+<samp class="file">texmsym.enc</samp> file supplied with Dvips. (For a start; to actually
get usable math fonts, you have to define much more than just an
encoding.)
</p>
@@ -4305,41 +4303,41 @@
<hr>
</div>
-<div class="subsubsection" id="Changing-PostScript-encodings">
-<div class="header">
+<div class="subsubsection-level-extent" id="Changing-PostScript-encodings">
+<div class="nav-panel">
<p>
-Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">‘<samp>-t</samp>’: Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">‘<samp class="samp">-t</samp>’: Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_002dp_003a-Changing-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</h4>
+<h4 class="subsubsection" id="g_t_002dp_003a-Changing-PostScript-encodings">6.3.1.2 ‘<samp class="samp">-p</samp>’: Changing PostScript encodings</h4>
-<span id="index-changing-PostScript-encodings"></span>
-<span id="index-PostScript-encoding_002c-changing"></span>
-<span id="index-_002dp-ps_002denc"></span>
+<a class="index-entry-id" id="index-changing-PostScript-encodings"></a>
+<a class="index-entry-id" id="index-PostScript-encoding_002c-changing"></a>
+<a class="index-entry-id" id="index-_002dp-ps_002denc"></a>
<p>By default, Afm2tfm uses the encoding it finds in the AFM file. You can
-specify a different PostScript encoding with ‘<samp>-p <var>ps-enc</var></samp>’.
+specify a different PostScript encoding with ‘<samp class="samp">-p <var class="var">ps-enc</var></samp>’.
This makes the raw TFM file (the one output by Afm2tfm) have the
-encoding specified in the encoding file <var>ps-enc</var>. Any ligature or
-kern information specified in <var>ps-enc</var> is ignored by Afm2tfm, since
+encoding specified in the encoding file <var class="var">ps-enc</var>. Any ligature or
+kern information specified in <var class="var">ps-enc</var> is ignored by Afm2tfm, since
ligkern info is always omitted from the raw TFM.
</p>
-<p>If you use this option, you must also arrange to download <var>ps-enc</var>
+<p>If you use this option, you must also arrange to download <var class="var">ps-enc</var>
as part of any document that uses this font. You do this by adding a
-line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>):
+line like the following one to <samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>):
</p><div class="example">
-<pre class="example">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc
+<pre class="example-preformatted">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc
</pre></div>
-<span id="index-trademark-character_002c-accessing"></span>
-<span id="index-registered-character_002c-accessing"></span>
-<span id="index-extra-characters_002c-accessing"></span>
-<p>Using ‘<samp>-p</samp>’ is the only way to access characters in a PostScript
+<a class="index-entry-id" id="index-trademark-character_002c-accessing"></a>
+<a class="index-entry-id" id="index-registered-character_002c-accessing"></a>
+<a class="index-entry-id" id="index-extra-characters_002c-accessing"></a>
+<p>Using ‘<samp class="samp">-p</samp>’ is the only way to access characters in a PostScript
font that are neither encoded in the AFM file nor constructed from other
-characters. For instance, Adobe’s ‘<samp>Times-Roman</samp>’ font contains the
-extra characters ‘<samp>trademark</samp>’ and ‘<samp>registered</samp>’ (among others);
+characters. For instance, Adobe’s ‘<samp class="samp">Times-Roman</samp>’ font contains the
+extra characters ‘<samp class="samp">trademark</samp>’ and ‘<samp class="samp">registered</samp>’ (among others);
these can only be accessed through such a PostScript reencoding.
</p>
-<span id="index-8r-encoding_002c-and-extra-characters"></span>
+<a class="index-entry-id" id="index-8r-encoding_002c-and-extra-characters"></a>
<p>The ‘8r’ base encoding used for the current PostScript font
distribution does do this reencoding, for precisely this reason.
</p>
@@ -4346,18 +4344,18 @@
<hr>
</div>
-<div class="subsubsection" id="Changing-both-encodings">
-<div class="header">
+<div class="subsubsection-level-extent" id="Changing-both-encodings">
+<div class="nav-panel">
<p>
-Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</h4>
+<h4 class="subsubsection" id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings">6.3.1.3 ‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</h4>
-<span id="index-_002dT-enc_002dfile"></span>
+<a class="index-entry-id" id="index-_002dT-enc_002dfile"></a>
-<p>The option ‘<samp>-T <var>enc-file</var></samp>’ is equivalent to ‘<samp>-p
-<var>enc-file</var> -t <var>enc-file</var></samp>’. If you make regular use of a private
-non-standard reencoding ‘<samp>-T</samp>’ is usually a better idea than the
+<p>The option ‘<samp class="samp">-T <var class="var">enc-file</var></samp>’ is equivalent to ‘<samp class="samp">-p
+<var class="var">enc-file</var> -t <var class="var">enc-file</var></samp>’. If you make regular use of a private
+non-standard reencoding ‘<samp class="samp">-T</samp>’ is usually a better idea than the
individual options, to avoid unexpected inconsistencies in mapping
otherwise. An example of when you might use this option is a dingbats
font: when you have a TeX encoding that is designed to be used with a
@@ -4366,18 +4364,18 @@
<hr>
</div>
-<div class="subsubsection" id="Reencoding-with-Afm2tfm">
-<div class="header">
+<div class="subsubsection-level-extent" id="Reencoding-with-Afm2tfm">
+<div class="nav-panel">
<p>
-Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Reencoding-with-Afm2tfm-1"></span><h4 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h4>
+<h4 class="subsubsection" id="Reencoding-with-Afm2tfm-1">6.3.1.4 Reencoding with Afm2tfm</h4>
-<span id="index-reencoding"></span>
-<span id="index-remapping"></span>
+<a class="index-entry-id" id="index-reencoding"></a>
+<a class="index-entry-id" id="index-remapping"></a>
<p>The Afm2tfm program creates the TFM and VF files for the virtual font
-corresponding to a PostScript font by <em>reencoding</em> the PostScript
+corresponding to a PostScript font by <em class="dfn">reencoding</em> the PostScript
font. Afm2tfm generates these files from two encodings: one for TeX
and one for PostScript. The TeX encoding is used to map character
numbers to character names while the PostScript encoding is used to map
@@ -4385,17 +4383,17 @@
can get access to any character of a PostScript font at any position for
TeX typesetting.
</p>
-<p>In the default case, when you specify none of the <code>-t</code>, <code>-p</code>,
-or <code>-T</code> options, Afm2tfm uses a default TeX encoding (which
+<p>In the default case, when you specify none of the <code class="code">-t</code>, <code class="code">-p</code>,
+or <code class="code">-T</code> options, Afm2tfm uses a default TeX encoding (which
mostly corresponds to the Computer Modern text fonts) and the PostScript
encoding found in the AFM file being read. The reencoding is also
-sometimes called a <em>remapping</em>.
+sometimes called a <em class="dfn">remapping</em>.
</p>
<p>For example, the default encodings reencode the acute accent in two
steps: first the default TeX encoding maps the number 19 to the
-character name ‘<samp>acute</samp>’; then the default PostScript encoding, as
+character name ‘<samp class="samp">acute</samp>’; then the default PostScript encoding, as
found in the AFM file for an ordinary PostScript font, maps the
-character name ‘<samp>acute</samp>’ to the number 194. (The PostScript encoding
+character name ‘<samp class="samp">acute</samp>’ to the number 194. (The PostScript encoding
works in reverse, by looking in the encoding vector for the name and
then yielding the corresponding number.) The combined mapping of 19 to
194 shows up explicitly in the VF file and also implicitly in the fact
@@ -4402,29 +4400,29 @@
that the properties of PostScript character 194 appear in position 19 of
the TFM file for the virtual font.
</p>
-<span id="index-accents_002c-in-wrong-position"></span>
-<span id="index-Hungarian-umlaut"></span>
-<span id="index-dot-accent"></span>
-<span id="index-Scandinavian-A-ring"></span>
-<span id="index-A-ring_002c-Scandinavian-letter"></span>
-<p>The default encoding of the distributed fonts (e.g., <samp>ptmr.tfm</samp>)
+<a class="index-entry-id" id="index-accents_002c-in-wrong-position"></a>
+<a class="index-entry-id" id="index-Hungarian-umlaut"></a>
+<a class="index-entry-id" id="index-dot-accent"></a>
+<a class="index-entry-id" id="index-Scandinavian-A-ring"></a>
+<a class="index-entry-id" id="index-A-ring_002c-Scandinavian-letter"></a>
+<p>The default encoding of the distributed fonts (e.g., <samp class="file">ptmr.tfm</samp>)
mostly follows plain TeX conventions for accents. The exceptions:
-the Hungarian umlaut (which is at position <code>0x7D</code> in ‘<samp>cmr10</samp>’,
-but position <code>0xCD</code> in ‘<samp>ptmr</samp>’); the dot accent (at positions
-<code>0x5F</code> and <code>0xC7</code>, respectively); and the Scandinavian A ring
-<code>\AA</code>, whose definition needs different tweaking. In order to use
+the Hungarian umlaut (which is at position <code class="code">0x7D</code> in ‘<samp class="samp">cmr10</samp>’,
+but position <code class="code">0xCD</code> in ‘<samp class="samp">ptmr</samp>’); the dot accent (at positions
+<code class="code">0x5F</code> and <code class="code">0xC7</code>, respectively); and the Scandinavian A ring
+<code class="code">\AA</code>, whose definition needs different tweaking. In order to use
these accents with PostScript fonts or in math mode when
-<code>\textfont0</code> is a PostScript font, you will need to use the
+<code class="code">\textfont0</code> is a PostScript font, you will need to use the
following definitions. These definitions will not work with the
Computer Modern fonts for the relevant accents. They are already part
-of the distributed <samp>psfonts.sty</samp> for use with LaTeX.
+of the distributed <samp class="file">psfonts.sty</samp> for use with LaTeX.
</p>
-<span id="index-_005cH"></span>
-<span id="index-_005c_002e"></span>
-<span id="index-_005cdot"></span>
-<span id="index-_005cAA"></span>
+<a class="index-entry-id" id="index-_005cH"></a>
+<a class="index-entry-id" id="index-_005c_002e"></a>
+<a class="index-entry-id" id="index-_005cdot"></a>
+<a class="index-entry-id" id="index-_005cAA"></a>
<div class="example">
-<pre class="example">\def\H#1{{\accent"CD #1}}
+<pre class="example-preformatted">\def\H#1{{\accent"CD #1}}
\def\.#1{{\accent"C7 #1}}
\def\dot{\mathaccent"70C7 }
\newdimen\aadimen
@@ -4433,59 +4431,59 @@
\hbox to \wd0{\hss\char'27\hss}}A}
</pre></div>
-<span id="index-CODINGSCHEME"></span>
-<p>As a kind of summary, here are the ‘<samp>CODINGSCHEME</samp>’s that result from
+<a class="index-entry-id" id="index-CODINGSCHEME"></a>
+<p>As a kind of summary, here are the ‘<samp class="samp">CODINGSCHEME</samp>’s that result from
the various possible choices for reencoding.
</p>
-<dl compact="compact">
-<dt><span>default encoding</span></dt>
+<dl class="table">
+<dt>default encoding</dt>
<dd><div class="example">
-<pre class="example">(CODINGSCHEME TeX text + AdobeStandardEncoding)
+<pre class="example-preformatted">(CODINGSCHEME TeX text + AdobeStandardEncoding)
</pre></div>
</dd>
-<dt><span>‘<samp>-p dc.enc</samp>’</span></dt>
+<dt>‘<samp class="samp">-p dc.enc</samp>’</dt>
<dd><div class="example">
-<pre class="example">(CODINGSCHEME TeX text + DCEncoding)
+<pre class="example-preformatted">(CODINGSCHEME TeX text + DCEncoding)
</pre></div>
</dd>
-<dt><span>‘<samp>-t dc.enc</samp>’</span></dt>
+<dt>‘<samp class="samp">-t dc.enc</samp>’</dt>
<dd><div class="example">
-<pre class="example">(CODINGSCHEME DCEncoding + AdobeStandardEncoding)
+<pre class="example-preformatted">(CODINGSCHEME DCEncoding + AdobeStandardEncoding)
</pre></div>
</dd>
-<dt><span>‘<samp>-T dc.enc</samp>’</span></dt>
+<dt>‘<samp class="samp">-T dc.enc</samp>’</dt>
<dd><div class="example">
-<pre class="example">(CODINGSCHEME DCEncoding + DCEncoding)
+<pre class="example-preformatted">(CODINGSCHEME DCEncoding + DCEncoding)
</pre></div>
</dd>
</dl>
-<p>The ‘<samp>CODINGSCHEME</samp>’ line appears in the VPL file but is
+<p>The ‘<samp class="samp">CODINGSCHEME</samp>’ line appears in the VPL file but is
ignored by Dvips.
</p>
<hr>
</div>
-<div class="subsubsection" id="Encoding-file-format">
-<div class="header">
+<div class="subsubsection-level-extent" id="Encoding-file-format">
+<div class="nav-panel">
<p>
Previous: <a href="#Reencoding-with-Afm2tfm" accesskey="p" rel="prev">Reencoding with Afm2tfm</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Encoding-file-format-1"></span><h4 class="subsubsection">6.3.1.5 Encoding file format</h4>
+<h4 class="subsubsection" id="Encoding-file-format-1">6.3.1.5 Encoding file format</h4>
-<span id="index-encoding-file-format"></span>
+<a class="index-entry-id" id="index-encoding-file-format"></a>
<p>Afm2tfm’s encoding files have the same format as an encoding vector in a
PostScript font. Here is a skeletal example:
</p>
<div class="example">
-<pre class="example">% <span class="roman">Comments are ignored, unless the first word after the percent sign</span>
-% <span class="roman">is ‘<samp>LIGKERN</samp>’; see below.</span>
-/MyEncoding [ % <span class="roman">exactly 256 entries follow, each with a leading ‘<samp>/</samp>’</span>
+<pre class="example-preformatted">% <span class="r">Comments are ignored, unless the first word after the percent sign</span>
+% <span class="r">is ‘<samp class="samp">LIGKERN</samp>’; see below.</span>
+/MyEncoding [ % <span class="r">exactly 256 entries follow, each with a leading ‘<samp class="samp">/</samp>’</span>
/Alpha /Beta /Gamma /Delta …
/A /B … /Z
… /.notdef /xfooaccent /yfooaccent /zfooaccent
@@ -4495,77 +4493,77 @@
<p>These encoding files are downloaded as part of changing the encoding at
the PostScript level (see the previous section).
</p>
-<span id="index-comments_002c-in-encoding-files"></span>
+<a class="index-entry-id" id="index-comments_002c-in-encoding-files"></a>
<p>Comments, which start with a percent sign and continue until the end
-of the line, are ignored unless they start with ‘<samp>LIGKERN</samp>’ (see below).
+of the line, are ignored unless they start with ‘<samp class="samp">LIGKERN</samp>’ (see below).
</p>
<p>The first non-comment word of the file must start with a forward slash
-‘<samp>/</samp>’ (i.e., a PostScript literal name) and defines the name of the
-encoding. The next word must be an left bracket ‘<samp>[</samp>’. Following
-that must be precisely 256 character names; use ‘<samp>/.notdef</samp>’ for any
+‘<samp class="samp">/</samp>’ (i.e., a PostScript literal name) and defines the name of the
+encoding. The next word must be an left bracket ‘<samp class="samp">[</samp>’. Following
+that must be precisely 256 character names; use ‘<samp class="samp">/.notdef</samp>’ for any
that you want to leave undefined. Then there must be a matching right
-bracket <code>]</code>. A final ‘<samp>def</samp>’ token is optional. All names are
+bracket <code class="code">]</code>. A final ‘<samp class="samp">def</samp>’ token is optional. All names are
case-sensitive.
</p>
<p>Any ligature or kern information is given as a comment. If the first
-word after the ‘<samp>%</samp>’ is ‘<samp>LIGKERN</samp>’, then the entire rest of the
+word after the ‘<samp class="samp">%</samp>’ is ‘<samp class="samp">LIGKERN</samp>’, then the entire rest of the
line is parsed for ligature and kern information. This ligature and
kern information is given in groups of words: each group is terminated
by a space and a semicolon and (unless the semicolon is at the end of a
line) another space.
</p>
-<span id="index-LIGKERN-encoding-file-command"></span>
-<p>In these <code>LIGKERN</code> statements, three types of information may be
+<a class="index-entry-id" id="index-LIGKERN-encoding-file-command"></a>
+<p>In these <code class="code">LIGKERN</code> statements, three types of information may be
specified. These three types are ligature pairs, kerns to ignore, and
the character value of this font’s boundary character.
</p>
-<span id="index-boundary-character"></span>
-<p>Throughout a <code>LIGKERN</code> statement, the boundary character is
-specified as ‘<samp>||</samp>’. To set the font’s boundary character value for
+<a class="index-entry-id" id="index-boundary-character"></a>
+<p>Throughout a <code class="code">LIGKERN</code> statement, the boundary character is
+specified as ‘<samp class="samp">||</samp>’. To set the font’s boundary character value for
TeX:
</p>
<div class="example">
-<pre class="example">% LIGKERN || = 39 ;
+<pre class="example-preformatted">% LIGKERN || = 39 ;
</pre></div>
<p>To indicate a kern to remove, give the names of the two characters
-(without the leading slash) separated by ‘<samp>{}</samp>’, as in ‘<samp>one
+(without the leading slash) separated by ‘<samp class="samp">{}</samp>’, as in ‘<samp class="samp">one
{} one ;</samp>’. This is intended to be reminiscent of the way you might
-use ‘<samp>{}</samp>’ in a TeX file to turn off ligatures or kerns at a
+use ‘<samp class="samp">{}</samp>’ in a TeX file to turn off ligatures or kerns at a
particular location. Either or both of the character names can be given
-as ‘<samp>*</samp>’, which is a wild card matching any character; thus, all
-kerns can be removed with ‘<samp>* {} * ;</samp>’.
+as ‘<samp class="samp">*</samp>’, which is a wild card matching any character; thus, all
+kerns can be removed with ‘<samp class="samp">* {} * ;</samp>’.
</p>
-<span id="index-ligature-operations"></span>
-<span id="index-Metafont-ligature-operations"></span>
+<a class="index-entry-id" id="index-ligature-operations"></a>
+<a class="index-entry-id" id="index-Metafont-ligature-operations"></a>
<p>To specify a ligature, specify the names of the pair of characters,
followed by the ligature operation (as in Metafont), followed by the
replacing character name. Either (but not both) of the first two
-characters can be ‘<samp>||</samp>’ to indicate a word boundary.
+characters can be ‘<samp class="samp">||</samp>’ to indicate a word boundary.
</p>
-<span id="index-_003d_003a-ligature-operation"></span>
-<p>The most common operation is ‘<samp>=:</samp>’ meaning that both characters are
-removed and replaced by the third character, but by adding the ‘<samp>|</samp>’
-character on either side of the ‘<samp>=:</samp>’, you can retain either or both
+<a class="index-entry-id" id="index-_003d_003a-ligature-operation"></a>
+<p>The most common operation is ‘<samp class="samp">=:</samp>’ meaning that both characters are
+removed and replaced by the third character, but by adding the ‘<samp class="samp">|</samp>’
+character on either side of the ‘<samp class="samp">=:</samp>’, you can retain either or both
of the two leading characters. In addition, by suffixing the ligature
-operation with one or two ‘<samp>></samp>’ signs, you can make the ligature
+operation with one or two ‘<samp class="samp">></samp>’ signs, you can make the ligature
scanning operation skip that many resulting characters before
proceeding. This works just like in Metafont. For example, the ‘fi’
-ligature is specified with ‘<samp>f i =: fi ;</samp>’<!-- /@w -->. A more convoluted
-ligature is ‘<samp>one one |=:|>> exclam ;</samp>’ which separates a pair of
-adjacent <code>1</code>’s with an exclamation point, and then skips over two
+ligature is specified with ‘<samp class="samp">f i =: fi ;</samp>’<!-- /@w -->. A more convoluted
+ligature is ‘<samp class="samp">one one |=:|>> exclam ;</samp>’ which separates a pair of
+adjacent <code class="code">1</code>’s with an exclamation point, and then skips over two
of the resulting characters before continuing searching for ligatures
-and kerns. You cannot give more <tt>></tt>’s than <tt>|</tt>’s in an ligature
+and kerns. You cannot give more <code class="t">></code>’s than <code class="t">|</code>’s in an ligature
operation, so there are a total of eight possibilities:
</p>
<div class="example">
-<pre class="example">=: |=: |=:> =:| =:|> |=:| |=:|> |=:|>>
+<pre class="example-preformatted">=: |=: |=:> =:| =:|> |=:| |=:|> |=:|>>
</pre></div>
<p>The default set of ligatures and kerns built in to Afm2tfm is:
</p>
<div class="example">
-<pre class="example">% LIGKERN question quoteleft =: questiondown ;
+<pre class="example-preformatted">% LIGKERN question quoteleft =: questiondown ;
% LIGKERN exclam quoteleft =: exclamdown ;
% LIGKERN hyphen hyphen =: endash ; endash hyphen =: emdash ;
% LIGKERN quoteleft quoteleft =: quotedblleft ;
@@ -4580,63 +4578,63 @@
<hr>
</div>
</div>
-<div class="subsection" id="Special-font-effects">
-<div class="header">
+<div class="subsection-level-extent" id="Special-font-effects">
+<div class="nav-panel">
<p>
Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Special-font-effects-1"></span><h4 class="subsection">6.3.2 Special font effects</h4>
+<h4 class="subsection" id="Special-font-effects-1">6.3.2 Special font effects</h4>
-<span id="index-oblique-fonts"></span>
-<span id="index-slanted-fonts"></span>
-<span id="index-fonts_002c-slanted"></span>
+<a class="index-entry-id" id="index-oblique-fonts"></a>
+<a class="index-entry-id" id="index-slanted-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-slanted"></a>
<p>Besides the reencodings described in the previous section, Afm2tfm can
do other manipulations. (Again, it’s best to use the prebuilt fonts
rather than attempting to remake them.)
</p>
-<p>‘<samp>-s <var>slant</var></samp>’ makes an obliqued variant, as in:
+<p>‘<samp class="samp">-s <var class="var">slant</var></samp>’ makes an obliqued variant, as in:
</p>
<div class="example">
-<pre class="example">afm2tfm Times-Roman -s .167 -v ptmro rptmro
+<pre class="example-preformatted">afm2tfm Times-Roman -s .167 -v ptmro rptmro
</pre></div>
-<p>This creates <samp>ptmro.vpl</samp> and <samp>rptmro.tfm</samp>. To use this font,
+<p>This creates <samp class="file">ptmro.vpl</samp> and <samp class="file">rptmro.tfm</samp>. To use this font,
put the line
</p>
-<span id="index-SlantFont"></span>
+<a class="index-entry-id" id="index-SlantFont"></a>
<div class="example">
-<pre class="example">rptmro Times-Roman ".167 SlantFont"
+<pre class="example-preformatted">rptmro Times-Roman ".167 SlantFont"
</pre></div>
-<p><span id="index-psfonts_002emap-1"></span>
-into <samp>psfonts.map</samp>. Then ‘<samp>rptmro</samp>’ (our name for the obliqued
+<a class="index-entry-id" id="index-psfonts_002emap-1"></a>
+<p>into <samp class="file">psfonts.map</samp>. Then ‘<samp class="samp">rptmro</samp>’ (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 <code>SlantFont</code>
+constructed from Times-Roman via the PostScript routine <code class="code">SlantFont</code>
(which will slant everything 1/6 to the right, in this case).
</p>
-<span id="index-expanded-fonts"></span>
-<span id="index-fonts_002c-expanded"></span>
+<a class="index-entry-id" id="index-expanded-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-expanded"></a>
<p>Similarly, you can get an expanded font with
</p>
<div class="example">
-<pre class="example">afm2tfm Times-Roman -e 1.2 -v ptmrre rptmrre
+<pre class="example-preformatted">afm2tfm Times-Roman -e 1.2 -v ptmrre rptmrre
</pre></div>
<p>and by recording the pseudo-resident font
-<span id="index-ExtendFont"></span>
+<a class="index-entry-id" id="index-ExtendFont"></a>
</p>
<div class="example">
-<pre class="example">rptmrre Times-Roman "1.2 ExtendFont"
+<pre class="example-preformatted">rptmrre Times-Roman "1.2 ExtendFont"
</pre></div>
-<p>in <samp>psfonts.map</samp>.
+<p>in <samp class="file">psfonts.map</samp>.
</p>
<p>You can also create a small caps font with a command such as
-<span id="index-small-caps-fonts"></span>
-<span id="index-fonts_002c-small-caps"></span>
+<a class="index-entry-id" id="index-small-caps-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-small-caps"></a>
</p>
<div class="example">
-<pre class="example">afm2tfm Times-Roman -V ptmrc rptmrc
+<pre class="example-preformatted">afm2tfm Times-Roman -V ptmrc rptmrc
</pre></div>
<p>This will generate a set of pseudo-small caps mapped into the usual
@@ -4645,7 +4643,7 @@
the default 0.8:
</p>
<div class="example">
-<pre class="example">afm2tfm Times-Roman -c 0.7 -V ptmrc rptmrc
+<pre class="example-preformatted">afm2tfm Times-Roman -c 0.7 -V ptmrc rptmrc
</pre></div>
<p>It is unfortunately not possible to increase the width of the small caps
@@ -4653,22 +4651,22 @@
professional looking set of small caps, you need to acquire a small caps
font.
</p>
-<span id="index-PaintType"></span>
-<span id="index-outline-fonts-1"></span>
-<span id="index-fonts_002c-outlined"></span>
-<p>To change the <code>PaintType</code> in a font from filled (0) to outlined
-(2), you can add <code>"/PaintType 2 store"</code> to <samp>psfonts.map</samp>, as
+<a class="index-entry-id" id="index-PaintType"></a>
+<a class="index-entry-id" id="index-outline-fonts-1"></a>
+<a class="index-entry-id" id="index-fonts_002c-outlined"></a>
+<p>To change the <code class="code">PaintType</code> in a font from filled (0) to outlined
+(2), you can add <code class="code">"/PaintType 2 store"</code> to <samp class="file">psfonts.map</samp>, as
in the following:
</p>
<div class="example">
-<pre class="example">rphvrl Helvetica "/PaintType 2 store"
+<pre class="example-preformatted">rphvrl Helvetica "/PaintType 2 store"
</pre></div>
<p>Afm2tfm writes to standard output the line you need to add to
-<samp>psfonts.map</samp> to use that font, assuming the font is resident in
+<samp class="file">psfonts.map</samp> to use that font, assuming the font is resident in
the printer; if the font is not resident, you must add the
-‘<samp><<var>filename</var></samp>’ command to download the font. Each identical
-line only needs to be specified once in the ‘<samp>psfonts.map</samp>’ file,
+‘<samp class="samp"><<var class="var">filename</var></samp>’ command to download the font. Each identical
+line only needs to be specified once in the ‘<samp class="samp">psfonts.map</samp>’ file,
even though many different fonts (small caps variants, or ones with
different output encodings) may be based on it.
</p>
@@ -4675,35 +4673,35 @@
<hr>
</div>
-<div class="subsection" id="Afm2tfm-options">
-<div class="header">
+<div class="subsection-level-extent" id="Afm2tfm-options">
+<div class="nav-panel">
<p>
Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Afm2tfm-options-1"></span><h4 class="subsection">6.3.3 Afm2tfm options</h4>
+<h4 class="subsection" id="Afm2tfm-options-1">6.3.3 Afm2tfm options</h4>
-<span id="index-options_002c-to-Afm2tfm"></span>
-<span id="index-afm2tfm-options"></span>
+<a class="index-entry-id" id="index-options_002c-to-Afm2tfm"></a>
+<a class="index-entry-id" id="index-afm2tfm-options"></a>
<p>Synopsis:
</p><div class="example">
-<pre class="example">afm2tfm [<var>option</var>]… <var>afmfile</var>[.afm] [<var>tfmfile</var>[.tfm]]
+<pre class="example-preformatted">afm2tfm [<var class="var">option</var>]… <var class="var">afmfile</var>[.afm] [<var class="var">tfmfile</var>[.tfm]]
</pre></div>
-<p>Afm2tfm reads <var>afmfile</var> and writes a corresponding (but “raw”,
-see below) TFM file. If <var>tfmfile</var> is not supplied, the base name
-of the AFM file is extended with ‘<samp>.tfm</samp>’ to get the output
+<p>Afm2tfm reads <var class="var">afmfile</var> and writes a corresponding (but “raw”,
+see below) TFM file. If <var class="var">tfmfile</var> is not supplied, the base name
+of the AFM file is extended with ‘<samp class="samp">.tfm</samp>’ to get the output
filename.
</p>
<p>The simplest example:
</p>
<div class="example">
-<pre class="example">afm2tfm Times-Roman rptmr
+<pre class="example-preformatted">afm2tfm Times-Roman rptmr
</pre></div>
-<span id="index-accents_002c-wrong"></span>
-<span id="index-raw-tfm-files"></span>
-<p>The TFM file thus created is <em>raw</em> because it omits ligature and
+<a class="index-entry-id" id="index-accents_002c-wrong"></a>
+<a class="index-entry-id" id="index-raw-tfm-files"></a>
+<p>The TFM file thus created is <em class="dfn">raw</em> because it omits ligature and
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
@@ -4710,21 +4708,21 @@
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 <a href="#Encodings">Encodings</a>). Although the encodings agree for most
+expects (see <a class="pxref" href="#Encodings">Encodings</a>). 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 ‘<samp>-v</samp>’ or ‘<samp>-V</samp>’ option.
-See <a href="#Making-a-font-available">Making a PostScript font available</a>.
+a virtual font as well with the ‘<samp class="samp">-v</samp>’ or ‘<samp class="samp">-V</samp>’ option.
+See <a class="xref" href="#Making-a-font-available">Making a PostScript font available</a>.
</p>
<p>The command line options to Afm2tfm:
</p>
-<dl compact="compact">
-<dt id='index-_002da-1'><span>‘<samp>-a</samp>’<a href='#index-_002da-1' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-accent-height-adjustment_002c-omitting"></span>
+<dl class="table">
+<dt id='index-_002da-1'><span>‘<samp class="samp">-a</samp>’<a class="copiable-link" href='#index-_002da-1'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-accent-height-adjustment_002c-omitting"></a>
<p>By default, Afm2tfm looks for precomposed accented characters, such as
tdieresis, and possibly adjusts the height of the basic letter (t)
-upward so that the result of using <code>\accent</code> (as in <code>\"t</code>)
-is visually the same as the precomposed characters. The <code>-a</code>
+upward so that the result of using <code class="code">\accent</code> (as in <code class="code">\"t</code>)
+is visually the same as the precomposed characters. The <code class="code">-a</code>
option omits such adjustments, so that all characters’ heights remain
as they are given in the AFM file. (Until Afm2tfm 8.4, released in
2016, heights could also be adjusted downward, but this is no longer
@@ -4731,52 +4729,52 @@
the case.)
</p>
</dd>
-<dt id='index-_002dc-ratio'><span>‘<samp>-c <var>ratio</var></samp>’<a href='#index-_002dc-ratio' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-scaling-small-caps"></span>
-<p>See ‘<samp>-V</samp>’; overrides the default ratio of 0.8 for the
+<dt id='index-_002dc-ratio'><span>‘<samp class="samp">-c <var class="var">ratio</var></samp>’<a class="copiable-link" href='#index-_002dc-ratio'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-scaling-small-caps"></a>
+<p>See ‘<samp class="samp">-V</samp>’; overrides the default ratio of 0.8 for the
scaling of small caps.
</p>
</dd>
-<dt id='index-_002de-ratio'><span>‘<samp>-e <var>ratio</var></samp>’<a href='#index-_002de-ratio' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-expanded-fonts-1"></span>
-<span id="index-condensed-fonts"></span>
-<p>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you
+<dt id='index-_002de-ratio'><span>‘<samp class="samp">-e <var class="var">ratio</var></samp>’<a class="copiable-link" href='#index-_002de-ratio'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-expanded-fonts-1"></a>
+<a class="index-entry-id" id="index-condensed-fonts"></a>
+<p>Stretch characters horizontally by <var class="var">ratio</var>; if less than 1.0, you
get a condensed font.
</p>
</dd>
-<dt id='index-_002dO'><span>‘<samp>-O</samp>’<a href='#index-_002dO' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-octal-character-codes"></span>
-<p>Output all character codes in the ‘<samp>vpl</samp>’ file as octal numbers, not
+<dt id='index-_002dO'><span>‘<samp class="samp">-O</samp>’<a class="copiable-link" href='#index-_002dO'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-octal-character-codes"></a>
+<p>Output all character codes in the ‘<samp class="samp">vpl</samp>’ file as octal numbers, not
names; this is useful for symbol or other special-purpose fonts where
-character names such as ‘<samp>A</samp>’ have no meaning.
+character names such as ‘<samp class="samp">A</samp>’ have no meaning.
</p>
</dd>
-<dt id='index-_002dp-ps_002denc-1'><span>‘<samp>-p <var>ps-enc</var></samp>’<a href='#index-_002dp-ps_002denc-1' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font;
-<var>ps-enc</var> must be mentioned as a header file for the font in
-‘<samp>psfonts.map</samp>’.
-See <a href="#Changing-PostScript-encodings">‘<samp>-p</samp>’: Changing PostScript encodings</a>.
+<dt id='index-_002dp-ps_002denc-1'><span>‘<samp class="samp">-p <var class="var">ps-enc</var></samp>’<a class="copiable-link" href='#index-_002dp-ps_002denc-1'> ¶</a></span></dt>
+<dd><p>Use <var class="var">ps-enc</var> for the destination (PostScript) encoding of the font;
+<var class="var">ps-enc</var> must be mentioned as a header file for the font in
+‘<samp class="samp">psfonts.map</samp>’.
+See <a class="xref" href="#Changing-PostScript-encodings">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>.
</p>
</dd>
-<dt id='index-_002ds-slant'><span>‘<samp>-s <var>slant</var></samp>’<a href='#index-_002ds-slant' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-slanted-fonts_002c-making"></span>
-<p>Slant characters to the right by <var>slant</var>. If <var>slant</var> is
+<dt id='index-_002ds-slant'><span>‘<samp class="samp">-s <var class="var">slant</var></samp>’<a class="copiable-link" href='#index-_002ds-slant'> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-slanted-fonts_002c-making"></a>
+<p>Slant characters to the right by <var class="var">slant</var>. If <var class="var">slant</var> is
negative, the letters slope to the left (or they might be upright if you
start with an italic font).
</p>
</dd>
-<dt id='index-_002dt-tex_002denc-1'><span>‘<samp>-t <var>tex-enc</var></samp>’<a href='#index-_002dt-tex_002denc-1' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Use <var>tex-enc</var> for the target (TeX) encoding of the font.
-Ligature and kern information may also be specified in <var>file</var>.
-<var>file</var> is not mentioned in <samp>psfonts.map</samp>.
+<dt id='index-_002dt-tex_002denc-1'><span>‘<samp class="samp">-t <var class="var">tex-enc</var></samp>’<a class="copiable-link" href='#index-_002dt-tex_002denc-1'> ¶</a></span></dt>
+<dd><p>Use <var class="var">tex-enc</var> for the target (TeX) encoding of the font.
+Ligature and kern information may also be specified in <var class="var">file</var>.
+<var class="var">file</var> is not mentioned in <samp class="file">psfonts.map</samp>.
</p>
</dd>
-<dt id='index-_002dT-ps_002dtex_002denc'><span>‘<samp>-T <var>ps-tex-enc</var></samp>’<a href='#index-_002dT-ps_002dtex_002denc' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings
-of the font. Equivalent to ‘<samp>-p <var>file</var> -t <var>file</var></samp>’.
+<dt id='index-_002dT-ps_002dtex_002denc'><span>‘<samp class="samp">-T <var class="var">ps-tex-enc</var></samp>’<a class="copiable-link" href='#index-_002dT-ps_002dtex_002denc'> ¶</a></span></dt>
+<dd><p>Use <var class="var">ps-tex-enc</var> for both the PostScript and target TeX encodings
+of the font. Equivalent to ‘<samp class="samp">-p <var class="var">file</var> -t <var class="var">file</var></samp>’.
</p>
</dd>
-<dt id='index-_002du'><span>‘<samp>-u</samp>’<a href='#index-_002du' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002du'><span>‘<samp class="samp">-u</samp>’<a class="copiable-link" href='#index-_002du'> ¶</a></span></dt>
<dd><p>Use only those characters specified in the TeX encoding, and no
others. By default, Afm2tfm tries to include all characters in the
input font, even those not present in the TeX encoding (it puts them
@@ -4783,12 +4781,12 @@
into otherwise-unused positions, arbitrarily).
</p>
</dd>
-<dt id='index-_002dv-vpl_002dfile'><span>‘<samp>-v <var>vpl-file</var></samp>’<a href='#index-_002dv-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt>
+<dt id='index-_002dv-vpl_002dfile'><span>‘<samp class="samp">-v <var class="var">vpl-file</var></samp>’<a class="copiable-link" href='#index-_002dv-vpl_002dfile'> ¶</a></span></dt>
<dd><p>Output a VPL (virtual property list) file, as well as a TFM file.
</p>
</dd>
-<dt id='index-_002dV-vpl_002dfile'><span>‘<samp>-V <var>vpl-file</var></samp>’<a href='#index-_002dV-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt>
-<dd><p>Same as ‘<samp>-v</samp>’, but the virtual font generated is a pseudo small caps
+<dt id='index-_002dV-vpl_002dfile'><span>‘<samp class="samp">-V <var class="var">vpl-file</var></samp>’<a class="copiable-link" href='#index-_002dV-vpl_002dfile'> ¶</a></span></dt>
+<dd><p>Same as ‘<samp class="samp">-v</samp>’, but the virtual font generated is a pseudo small caps
font obtained by scaling uppercase letters by 0.8 to typeset
lowercase. This font handles accented letters and retains proper
kerning.
@@ -4799,112 +4797,112 @@
<hr>
</div>
</div>
-<div class="section" id="psfonts_002emap">
-<div class="header">
+<div class="section-level-extent" id="psfonts_002emap">
+<div class="nav-panel">
<p>
Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking Afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="psfonts_002emap_003a-PostScript-font-catalog"></span><h3 class="section">6.4 <samp>psfonts.map</samp>: PostScript font catalog</h3>
+<h3 class="section" id="psfonts_002emap_003a-PostScript-font-catalog">6.4 <samp class="file">psfonts.map</samp>: PostScript font catalog</h3>
-<span id="index-psfonts_002emap-2"></span>
-<span id="index-non_002dresident-fonts"></span>
-<span id="index-downloading-PostScript-fonts"></span>
-<span id="index-fonts_002c-downloading"></span>
+<a class="index-entry-id" id="index-psfonts_002emap-2"></a>
+<a class="index-entry-id" id="index-non_002dresident-fonts"></a>
+<a class="index-entry-id" id="index-downloading-PostScript-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-downloading"></a>
-<p>The <samp>psfonts.map</samp> file associates a PostScript font with related
+<p>The <samp class="file">psfonts.map</samp> file associates a PostScript font with related
files and constructs. Each line has the format:
</p>
<div class="example">
-<pre class="example"><var>filename</var> <var>PostScript-name</var> <var>options</var>
+<pre class="example-preformatted"><var class="var">filename</var> <var class="var">PostScript-name</var> <var class="var">options</var>
</pre></div>
-<span id="index-_003c-font-downloading"></span>
+<a class="index-entry-id" id="index-_003c-font-downloading"></a>
<p>For example, the line
</p><div class="example">
-<pre class="example">rpstrn StoneInformal <StoneInformal.pfb
+<pre class="example-preformatted">rpstrn StoneInformal <StoneInformal.pfb
</pre></div>
-<p>causes Dvips to download <samp>StoneInformal.pfb</samp> (just as if it were
-a header file, see <a href="#Header-files">PostScript header files</a>) if the DVI file (or a virtual
-font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file ‘<samp>rpstrn</samp>’.
-The PostScript <code>/FontName</code> of the font defined inside the ‘<samp>pfb</samp>’
-file should be <code>StoneInformal</code>.
+<p>causes Dvips to download <samp class="file">StoneInformal.pfb</samp> (just as if it were
+a header file, see <a class="pxref" href="#Header-files">PostScript header files</a>) if the DVI file (or a virtual
+font, see <a class="pxref" href="#Virtual-fonts">Virtual fonts</a>) references the TFM file ‘<samp class="samp">rpstrn</samp>’.
+The PostScript <code class="code">/FontName</code> of the font defined inside the ‘<samp class="samp">pfb</samp>’
+file should be <code class="code">StoneInformal</code>.
</p>
-<span id="index-transforming-downloaded-fonts"></span>
-<span id="index-expanded-fonts-2"></span>
-<span id="index-wide-fonts"></span>
-<span id="index-narrow-fonts"></span>
+<a class="index-entry-id" id="index-transforming-downloaded-fonts"></a>
+<a class="index-entry-id" id="index-expanded-fonts-2"></a>
+<a class="index-entry-id" id="index-wide-fonts"></a>
+<a class="index-entry-id" id="index-narrow-fonts"></a>
<p>You can generate transformed fonts with a line like this:
</p><div class="example">
-<pre class="example">rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont"
+<pre class="example-preformatted">rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont"
</pre></div>
-<p>See <a href="#Special-font-effects">Special font effects</a>, for a
+<p>See <a class="xref" href="#Special-font-effects">Special font effects</a>, for a
complete list of font effects.
</p>
-<span id="index-reencoding-PostScript-fonts"></span>
+<a class="index-entry-id" id="index-reencoding-PostScript-fonts"></a>
<p>You can change the encoding of the Type 1 font at the PostScript
-level with a ‘<samp>ReEncodeFont</samp>’ instruction, plus the name of the
+level with a ‘<samp class="samp">ReEncodeFont</samp>’ instruction, plus the name of the
encoding file. This allows you access to characters that may be present
in the Type 1 font file, but not encoded by default—most of the
preaccented characters, for example. An example:
-</p><div class="example">
-<pre class="example">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <8r.enc <pstrn8a.pfb
+</p><div class="example smallexample">
+<pre class="example-preformatted">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <8r.enc <pstrn8a.pfb
</pre></div>
-<span id="index-8r-font-encoding"></span>
-<span id="index-base-encoding_002c-recommended"></span>
-<p>The ‘<samp>8r</samp>’ encoding mentioned here has been designed to serve as a
+<a class="index-entry-id" id="index-8r-font-encoding"></a>
+<a class="index-entry-id" id="index-base-encoding_002c-recommended"></a>
+<p>The ‘<samp class="samp">8r</samp>’ encoding mentioned here has been designed to serve as a
base for all downloadable fonts; it allows access to all the characters
commonly present in a Type 1 font. For more details, see the
-<samp>8r.enc</samp> source file that comes with (and is installed with) Dvips.
+<samp class="file">8r.enc</samp> source file that comes with (and is installed with) Dvips.
</p>
-<span id="index-_003c_005b-encoding-vector-downloading"></span>
+<a class="index-entry-id" id="index-_003c_005b-encoding-vector-downloading"></a>
<p>You may notice that the same syntax is used for downloading encoding
vectors and Type 1 font files. To make your intentions clear, you can
-also use ‘<samp><[</samp>’ to explicitly indicate you are downloading an
+also use ‘<samp class="samp"><[</samp>’ to explicitly indicate you are downloading an
encoding vector, as in:
-</p><div class="example">
-<pre class="example">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <[8r.enc <pstrn8a.pfb
+</p><div class="example smallexample">
+<pre class="example-preformatted">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <[8r.enc <pstrn8a.pfb
</pre></div>
-<span id="index-_002eenc-extension-for-encoding-vectors"></span>
-<p>If the filename of your encoding vector does not end in ‘<samp>.enc</samp>’, and
-you are using partial font downloading, you must use the ‘<samp><[</samp>’
+<a class="index-entry-id" id="index-_002eenc-extension-for-encoding-vectors"></a>
+<p>If the filename of your encoding vector does not end in ‘<samp class="samp">.enc</samp>’, and
+you are using partial font downloading, you must use the ‘<samp class="samp"><[</samp>’
syntax, or Dvips will not download the font properly.
</p>
-<span id="index-_002epfa-extension-required-for-partial-downloading"></span>
-<span id="index-_002epfb-extension-required-for-partial-downloading"></span>
+<a class="index-entry-id" id="index-_002epfa-extension-required-for-partial-downloading"></a>
+<a class="index-entry-id" id="index-_002epfb-extension-required-for-partial-downloading"></a>
<p>Similarly, the name of the Type 1 font file itself must have extension
-<samp>.pfa</samp> or <samp>.pfb</samp> for partial downloading to work properly.
+<samp class="file">.pfa</samp> or <samp class="file">.pfb</samp> for partial downloading to work properly.
</p>
-<span id="index-pfb-files_002c-automatically-unpacked"></span>
+<a class="index-entry-id" id="index-pfb-files_002c-automatically-unpacked"></a>
<p>When using PFB files, Dvips is smart enough to unpack the binary PFB
format into printable ASCII so there is no need to perform this
conversion yourself. In addition, Dvips scans the font to determine its
-memory usage, just as it does for other header files (see <a href="#Header-files">PostScript header files</a>).
+memory usage, just as it does for other header files (see <a class="pxref" href="#Header-files">PostScript header files</a>).
</p>
-<span id="index-partial-font-downloading"></span>
-<span id="index-downloading-fonts-partially"></span>
-<p>If the ‘<samp>j</samp>’ config file or command-line option is enabled (as it
-is by default), <samp>StoneInformal.pfb</samp> will be <em>partially
+<a class="index-entry-id" id="index-partial-font-downloading"></a>
+<a class="index-entry-id" id="index-downloading-fonts-partially"></a>
+<p>If the ‘<samp class="samp">j</samp>’ config file or command-line option is enabled (as it
+is by default), <samp class="file">StoneInformal.pfb</samp> will be <em class="dfn">partially
downloaded</em>—only those characters your document actually uses will
be extracted and downloaded, and the remainder discarded.
-See <a href="#Option-details">Option details</a>.
+See <a class="xref" href="#Option-details">Option details</a>.
</p>
-<span id="index-whole-font-downloading"></span>
-<span id="index-multiple-master-fonts"></span>
-<span id="index-Minion-typeface-family"></span>
-<span id="index-_003c_003c-whole-font-downloading"></span>
+<a class="index-entry-id" id="index-whole-font-downloading"></a>
+<a class="index-entry-id" id="index-multiple-master-fonts"></a>
+<a class="index-entry-id" id="index-Minion-typeface-family"></a>
+<a class="index-entry-id" id="index-_003c_003c-whole-font-downloading"></a>
<p>Adobe Multiple Master fonts, such as Minion, cannot be partially
downloaded. To partially download in general, but avoid partial
-downloading for individual fonts, use ‘<samp><<</samp>’ instead ‘<samp><</samp>’:
+downloading for individual fonts, use ‘<samp class="samp"><<</samp>’ instead ‘<samp class="samp"><</samp>’:
</p><div class="example">
-<pre class="example">pmnr8r Minion <<Minion.pfb
+<pre class="example-preformatted">pmnr8r Minion <<Minion.pfb
</pre></div>
-<p>Here is a brief summary of how <samp>psfonts.map</samp> is read:
+<p>Here is a brief summary of how <samp class="file">psfonts.map</samp> is read:
</p>
-<ol>
+<ol class="enumerate">
<li> If a line is empty or begins with a space, percent, asterisk,
semicolon, or hash mark, it is ignored.
@@ -4912,22 +4910,22 @@
separated by spaces or tabs, except that if a word begins with a double
quote, it extends until the next double quote or the end of the line.
-</li><li> If a word starts with ‘<samp><<</samp>’, it is taken as a font file to be
+</li><li> If a word starts with ‘<samp class="samp"><<</samp>’, it is taken as a font file to be
wholly downloaded. Use this to avoid partial downloading, as described
above.
-</li><li> If a word starts with ‘<samp><[</samp>’, it is taken as an encoding file
+</li><li> If a word starts with ‘<samp class="samp"><[</samp>’, it is taken as an encoding file
to be downloaded. Use this if the name of the encoding file does end in
-‘<samp>.enc</samp>’, also as described above.
+‘<samp class="samp">.enc</samp>’, also as described above.
-</li><li> If a word starts with a ‘<samp><</samp>’ character, it is
+</li><li> If a word starts with a ‘<samp class="samp"><</samp>’ character, it is
treated as a header file that needs to be downloaded. If the name ends
-in ‘<samp>.pfa</samp>’ or ‘<samp>.pfb</samp>’, it is taken as Type 1 font file that will
-be partially downloaded if the ‘<samp>j</samp>’ option is in effect. There can
-be more than one such header for a given font. If a ‘<samp><</samp>’ is a word
+in ‘<samp class="samp">.pfa</samp>’ or ‘<samp class="samp">.pfb</samp>’, it is taken as Type 1 font file that will
+be partially downloaded if the ‘<samp class="samp">j</samp>’ option is in effect. There can
+be more than one such header for a given font. If a ‘<samp class="samp"><</samp>’ is a word
by itself, the next word is taken as the name of the header file.
-</li><li> If a word starts with a ‘<samp>"</samp>’ character, it is taken as PostScript
+</li><li> If a word starts with a ‘<samp class="samp">"</samp>’ character, it is taken as PostScript
code used in generating that font, and is inserted into the output
verbatim at the appropriate point. (And the double quotes beginning and
ending the word are removed.)
@@ -4944,22 +4942,22 @@
<hr>
</div>
</div>
-<div class="chapter" id="Color">
-<div class="header">
+<div class="chapter-level-extent" id="Color">
+<div class="nav-panel">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-1"></span><h2 class="chapter">7 Color</h2>
+<h2 class="chapter" id="Color-1">7 Color</h2>
-<span id="index-color"></span>
+<a class="index-entry-id" id="index-color"></a>
-<span id="index-Hafner_002c-Jim"></span>
+<a class="index-entry-id" id="index-Hafner_002c-Jim"></a>
<p>Dvips supports one-pass multi-color printing of TeX documents on any
color PostScript device. Initially added by Jim Hafner, IBM Research,
-<a href="mailto:hafner at almaden.ibm.com">hafner at almaden.ibm.com</a>, the color support has gone through many
+<a class="email" href="mailto:hafner at almaden.ibm.com">hafner at almaden.ibm.com</a>, the color support has gone through many
changes by Tomas Rokicki. Besides the source code support itself, there
-are additional TeX macro files: ‘<samp>colordvi.tex</samp>’ and
-‘<samp>blackdvi.tex</samp>’, and corresponding ‘<samp>.sty</samp>’ versions for use with
+are additional TeX macro files: ‘<samp class="samp">colordvi.tex</samp>’ and
+‘<samp class="samp">blackdvi.tex</samp>’, and corresponding ‘<samp class="samp">.sty</samp>’ versions for use with
LaTeX.
</p>
<p>In this section we describe the use of color from the document
@@ -4968,7 +4966,7 @@
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Color-macro-files" accesskey="1">Color macro files</a></li>
<li><a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></li>
<li><a href="#Color-subtleties" accesskey="3">Color subtleties</a></li>
@@ -4977,34 +4975,34 @@
<li><a href="#Color-support-details" accesskey="6">Color support details</a></li>
</ul>
<hr>
-<div class="section" id="Color-macro-files">
-<div class="header">
+<div class="section-level-extent" id="Color-macro-files">
+<div class="nav-panel">
<p>
Next: <a href="#User_002ddefinable-colors" accesskey="n" rel="next">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-macro-files-1"></span><h3 class="section">7.1 Color macro files</h3>
+<h3 class="section" id="Color-macro-files-1">7.1 Color macro files</h3>
-<span id="index-macros-for-color"></span>
-<span id="index-color-macros"></span>
+<a class="index-entry-id" id="index-macros-for-color"></a>
+<a class="index-entry-id" id="index-color-macros"></a>
-<p>All the color macro commands are defined in ‘<samp>colordvi.tex</samp>’ (or
-‘<samp>colordvi.sty</samp>’). To access these macros simply add to the top of
+<p>All the color macro commands are defined in ‘<samp class="samp">colordvi.tex</samp>’ (or
+‘<samp class="samp">colordvi.sty</samp>’). To access these macros simply add to the top of
your plain TeX file the command:
</p><div class="example">
-<pre class="example">\input colordvi
+<pre class="example-preformatted">\input colordvi
</pre></div>
-<p>For (the obsolete) LaTeX 2.09, add the ‘<samp>colordvi</samp>’ style option as in:
+<p>For (the obsolete) LaTeX 2.09, add the ‘<samp class="samp">colordvi</samp>’ style option as in:
</p><div class="example">
-<pre class="example">\documentstyle[12pt,colordvi]{article}
+<pre class="example-preformatted">\documentstyle[12pt,colordvi]{article}
</pre></div>
<p>For LaTeX2e, these examples are not applicable. Instead, please see
the documentation for the graphics package
-(<a href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a>), and the epslatex document
-(<a href="https://ctan.org/pkg/epslatex">https://ctan.org/pkg/epslatex</a>).
+(<a class="url" href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a>), and the epslatex document
+(<a class="url" href="https://ctan.org/pkg/epslatex">https://ctan.org/pkg/epslatex</a>).
</p>
-<span id="index-Crayola-crayon-box"></span>
-<span id="index-Pantone-colors"></span>
-<span id="index-color-names_002c-mixed-case"></span>
+<a class="index-entry-id" id="index-Crayola-crayon-box"></a>
+<a class="index-entry-id" id="index-Pantone-colors"></a>
+<a class="index-entry-id" id="index-color-names_002c-mixed-case"></a>
<p>These macros provide two basic kinds of color macros: ones for local
color changes (a few words, a single symbol) and one for global color
changes (the whole document). All the color names use a mixed case
@@ -5011,8 +5009,8 @@
scheme to avoid conflicts with other macros. There are 68 predefined
colors, with names taken primarily from the Crayola crayon box of 64
colors, and one pair of macros for the user to set his own color pattern
-(see <a href="#User_002ddefinable-colors">User-definable colors</a>). You can browse the file
-‘<samp>colordvi.tex</samp>’ for a list of the predefined colors. The comments
+(see <a class="pxref" href="#User_002ddefinable-colors">User-definable colors</a>). You can browse the file
+‘<samp class="samp">colordvi.tex</samp>’ for a list of the predefined colors. The comments
in this file also show a rough correspondence between the crayon names
and Pantones.
</p>
@@ -5019,39 +5017,39 @@
<p>A local color command has the form
</p>
<div class="example">
-<pre class="example">\<var>ColorName</var>{this is the color <var>ColorName</var>}
+<pre class="example-preformatted">\<var class="var">ColorName</var>{this is the color <var class="var">ColorName</var>}
</pre></div>
-<span id="index-_005cColorName"></span>
-<p>where <var>ColorName</var> is the name of a predefined color, e.g.,
-‘<samp>Blue</samp>’. As shown, these macros take one argument, the text to
+<a class="index-entry-id" id="index-_005cColorName"></a>
+<p>where <var class="var">ColorName</var> is the name of a predefined color, e.g.,
+‘<samp class="samp">Blue</samp>’. As shown, these macros take one argument, the text to
print in the specified color. This can be used for nested color changes
since it restores the original color state when it completes. For
example:
</p>
<div class="example">
-<pre class="example">This text is normal but here we are \Red{switching to red,
+<pre class="example-preformatted">This text is normal but here we are \Red{switching to red,
\Blue{nesting blue}, recovering the red} and back to original.
</pre></div>
-<p><span id="index-color-nesting-level"></span>
-The color nesting level has no hard limit, but it is not advisable to
+<a class="index-entry-id" id="index-color-nesting-level"></a>
+<p>The color nesting level has no hard limit, but it is not advisable to
nest too deeply lest you and the reader lose track of the color history.
</p>
<p>The global color command has the form
</p>
<div class="example">
-<pre class="example">\text<var>ColorName</var>
+<pre class="example-preformatted">\text<var class="var">ColorName</var>
</pre></div>
-<p><span id="index-_005ctextColorName"></span>
-These macros take no arguments and changes the default color from that
-point on to <var>ColorName</var>. This of course can be overridden globally
+<a class="index-entry-id" id="index-_005ctextColorName"></a>
+<p>These macros take no arguments and changes the default color from that
+point on to <var class="var">ColorName</var>. This of course can be overridden globally
by another such command or locally by local color commands. For example,
expanding on the example above, we might have
</p>
<div class="example">
-<pre class="example">\textGreen
+<pre class="example-preformatted">\textGreen
This text is green but here we are \Red{switching to red,
\Blue{nesting blue}, recovering the red} and back to
original green.
@@ -5063,7 +5061,7 @@
<p>The color commands will even work in math mode and across math mode
boundaries. This means that if you have a color before going into math
mode, the mathematics will be set in that color as well. In alignment
-environments like <code>\halign</code>, ‘<samp>tabular</samp>’ or ‘<samp>eqnarray</samp>’,
+environments like <code class="code">\halign</code>, ‘<samp class="samp">tabular</samp>’ or ‘<samp class="samp">eqnarray</samp>’,
local color commands cannot extend beyond the alignment characters.
</p>
<p>Because local color commands respect only some environment and
@@ -5077,18 +5075,18 @@
<hr>
</div>
-<div class="section" id="User_002ddefinable-colors">
-<div class="header">
+<div class="section-level-extent" id="User_002ddefinable-colors">
+<div class="nav-panel">
<p>
Next: <a href="#Color-subtleties" accesskey="n" rel="next">Color subtleties</a>, Previous: <a href="#Color-macro-files" accesskey="p" rel="prev">Color macro files</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="User_002ddefinable-colors-1"></span><h3 class="section">7.2 User-definable colors</h3>
+<h3 class="section" id="User_002ddefinable-colors-1">7.2 User-definable colors</h3>
-<span id="index-user_002ddefinable-colors"></span>
-<span id="index-colors_002c-user_002ddefinable"></span>
+<a class="index-entry-id" id="index-user_002ddefinable-colors"></a>
+<a class="index-entry-id" id="index-colors_002c-user_002ddefinable"></a>
<p>There are two ways for the user to specify colors not already defined.
-For local changes, there is the command <code>\Color</code> which takes two
+For local changes, there is the command <code class="code">\Color</code> which takes two
arguments. The first argument is four numbers between zero and one and
specifies the intensity of cyan, magenta, yellow and black (CMYK) in
that order. The second argument is the text that should appear in the
@@ -5097,16 +5095,16 @@
and 20% black. You would use the command
</p>
<div class="example">
-<pre class="example">\Color{.5 .85 .4 .2}{this color is pretty}
+<pre class="example-preformatted">\Color{.5 .85 .4 .2}{this color is pretty}
</pre></div>
-<p>For global color changes, there is a command <code>\textColor</code> which
+<p>For global color changes, there is a command <code class="code">\textColor</code> which
takes one argument, the CMYK quadruple of relative color intensities.
For example, if you want the default color to be as above, then the
command
</p>
<div class="example">
-<pre class="example">\textColor{.5 .85 .4 .2}
+<pre class="example-preformatted">\textColor{.5 .85 .4 .2}
The text from now on will be this pretty color
</pre></div>
@@ -5119,17 +5117,17 @@
<hr>
</div>
-<div class="section" id="Color-subtleties">
-<div class="header">
+<div class="section-level-extent" id="Color-subtleties">
+<div class="nav-panel">
<p>
Next: <a href="#Ted-Turner" accesskey="n" rel="next">Printing in black/white after colorizing</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-subtleties-1"></span><h3 class="section">7.3 Color subtleties</h3>
+<h3 class="section" id="Color-subtleties-1">7.3 Color subtleties</h3>
-<span id="index-color-subtleties"></span>
+<a class="index-entry-id" id="index-color-subtleties"></a>
-<p>Color macros are defined via <code>\special</code> keywords. As such, they
-are put in the ‘<samp>.dvi</samp>’ file only as explicit message strings to the
+<p>Color macros are defined via <code class="code">\special</code> keywords. As such, they
+are put in the ‘<samp class="samp">.dvi</samp>’ file only as explicit message strings to the
driver. The (unpleasant) result is that certain unprotected regions of
the text can have unwanted color side effects. For example, if a color
region is split by TeX across a page boundary, then the footers of
@@ -5140,7 +5138,7 @@
header and footer in plain TeX, use
</p>
<div class="example">
-<pre class="example">\headline{\Black{My Header}}
+<pre class="example-preformatted">\headline{\Black{My Header}}
\footline{\Black{\hss\tenrm\folio\hss}}
</pre></div>
@@ -5153,21 +5151,21 @@
</p>
<p>Even when writing your own macros, much care must be taken. The macros
that ‘colorize’ a portion of the text work prefix the text work by
-outputting one <code>\special</code> command to turn the color on before the
-text, and outputting another <code>\special</code> command afterwards to
+outputting one <code class="code">\special</code> command to turn the color on before the
+text, and outputting another <code class="code">\special</code> command afterwards to
restore the original color. It is often useful to ensure that TeX is
in horizontal mode before the first special command is issued; this can
-be done by prefixing the color command with <code>\leavevmode</code>.
+be done by prefixing the color command with <code class="code">\leavevmode</code>.
</p>
<hr>
</div>
-<div class="section" id="Ted-Turner">
-<div class="header">
+<div class="section-level-extent" id="Ted-Turner">
+<div class="nav-panel">
<p>
Next: <a href="#Color-device-configuration" accesskey="n" rel="next">Color device configuration</a>, Previous: <a href="#Color-subtleties" accesskey="p" rel="prev">Color subtleties</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Printing-in-black_002fwhite-after-colorizing"></span><h3 class="section">7.4 Printing in black/white after colorizing</h3>
+<h3 class="section" id="Printing-in-black_002fwhite-after-colorizing">7.4 Printing in black/white after colorizing</h3>
<p>If you have a TeX or LaTeX document written with color macros and
you want to print it in black and white there are two options. On all
@@ -5174,10 +5172,10 @@
(good) PostScript devices, printing a color file will print in
corresponding gray levels. This is useful to get a rough idea of the
colors without using expensive color printing devices. The second
-option is to replace the call to input <samp>colordvi.tex</samp> with
-‘<samp>blackdvi.tex</samp>’ (and similarly for the ‘<samp>.sty</samp>’ files). So in
-the above example, replacing the word ‘<samp>colordvi</samp>’ with
-‘<samp>blackdvi</samp>’ suffices. <samp>blackdvi.tex</samp> defines the color macros
+option is to replace the call to input <samp class="file">colordvi.tex</samp> with
+‘<samp class="samp">blackdvi.tex</samp>’ (and similarly for the ‘<samp class="samp">.sty</samp>’ files). So in
+the above example, replacing the word ‘<samp class="samp">colordvi</samp>’ with
+‘<samp class="samp">blackdvi</samp>’ suffices. <samp class="file">blackdvi.tex</samp> defines the color macros
as no-ops, and so will produce normal black/white printing. By this
simple mechanism, the user can switch to all black/white printing
without having to ferret out the color commands. Also, some device
@@ -5189,152 +5187,152 @@
<hr>
</div>
-<div class="section" id="Color-device-configuration">
-<div class="header">
+<div class="section-level-extent" id="Color-device-configuration">
+<div class="nav-panel">
<p>
Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Printing in black/white after colorizing</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-device-configuration-1"></span><h3 class="section">7.5 Color device configuration</h3>
+<h3 class="section" id="Color-device-configuration-1">7.5 Color device configuration</h3>
-<span id="index-color-configuration"></span>
-<span id="index-configuration_002c-of-color-devices"></span>
+<a class="index-entry-id" id="index-color-configuration"></a>
+<a class="index-entry-id" id="index-configuration_002c-of-color-devices"></a>
<p>To configure Dvips for a particular color device you need to fine tune
the color parameters to match your device’s color rendition. To do this,
you will need a Pantone chart for your device. The header file
-‘<samp>color.lpro</samp>’ shows a (rough) correspondence between the Crayola
+‘<samp class="samp">color.lpro</samp>’ shows a (rough) correspondence between the Crayola
crayon names and the Pantone numbers and also defines default CMYK
values for each of the colors. Note that these colors must be defined
in CMYK terms and not RGB, as Dvips outputs PostScript color commands in
CMYK. This header file also defines (if they are not known to the
-interpreter) the PostScript commands ‘<samp>setcmykcolor</samp>’ and
-‘<samp>currentcmykcolor</samp>’ in terms of a RGB equivalent so if your device
+interpreter) the PostScript commands ‘<samp class="samp">setcmykcolor</samp>’ and
+‘<samp class="samp">currentcmykcolor</samp>’ in terms of a RGB equivalent so if your device
only understands RGB, there should be no problem.
</p>
-<span id="index-Phaser-printer_002c-used-for-color-calibration"></span>
-<span id="index-Tektronix-Phaser-printer_002c-used-for-color-calibration"></span>
+<a class="index-entry-id" id="index-Phaser-printer_002c-used-for-color-calibration"></a>
+<a class="index-entry-id" id="index-Tektronix-Phaser-printer_002c-used-for-color-calibration"></a>
<p>The parameters set in this file were determined by comparing the Pantone
chart of a Tektronix Phaser printer with the actual Crayola Crayons.
Because these were defined for a particular device, the actual color
rendition on your device may be very different. There are two ways to
adjust this. One is to use the PAntone chart for your device to rewrite
-‘<samp>color.lpro</samp>’ prior to compilation and installation. A better
+‘<samp class="samp">color.lpro</samp>’ prior to compilation and installation. A better
alternative, which supports multiple devices, is to add a header file
-option in the configuration file (see <a href="#Configuration-file-commands">Configuration file commands</a>)
-for each device that defines, in ‘<samp>userdict</samp>’, the color parameters
+option in the configuration file (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>)
+for each device that defines, in ‘<samp class="samp">userdict</samp>’, the color parameters
for those colors that need redefining.
</p>
<p>For example, if you need to change the parameters defining
-‘<samp>Goldenrod</samp>’ (approximately Pantone 109 on the Phaser) for your
-device ‘<samp>mycolordev</samp>’, do the following. In the Pantone chart for
+‘<samp class="samp">Goldenrod</samp>’ (approximately Pantone 109 on the Phaser) for your
+device ‘<samp class="samp">mycolordev</samp>’, do the following. In the Pantone chart for
your device, find the CMYK values for Pantone 109. Let’s say they are
-‘<samp>{\ 0 0.10 0.75 0.03 }</samp>’. Then create a header file named
-‘<samp>mycolordev.pro</samp>’ with the commands
+‘<samp class="samp">{\ 0 0.10 0.75 0.03 }</samp>’. Then create a header file named
+‘<samp class="samp">mycolordev.pro</samp>’ with the commands
</p>
<div class="example">
-<pre class="example">userdict begin
+<pre class="example-preformatted">userdict begin
/Goldenrod { 0 0.10 0.75 0.03 setcmykcolor} bind def
</pre></div>
-<p>Finally, in ‘<samp>config.mycolordev</samp>’ add the line
+<p>Finally, in ‘<samp class="samp">config.mycolordev</samp>’ add the line
</p>
<div class="example">
-<pre class="example">h mycolordev.pro
+<pre class="example-preformatted">h mycolordev.pro
</pre></div>
-<p>This will then define ‘<samp>Goldenrod</samp>’ in your device’s CMYK values in
-<samp>userdict</samp> which is checked before defining it in <samp>TeXdict</samp> by
-<samp>color.pro</samp>. (On MS-DOS, you will have to call this file
-<samp>mycolordev.cfg</samp>.)
+<p>This will then define ‘<samp class="samp">Goldenrod</samp>’ in your device’s CMYK values in
+<samp class="file">userdict</samp> which is checked before defining it in <samp class="file">TeXdict</samp> by
+<samp class="file">color.pro</samp>. (On MS-DOS, you will have to call this file
+<samp class="file">mycolordev.cfg</samp>.)
</p>
-<p>This mechanism, together with additions to <samp>colordvi.tex</samp> and
-<samp>blackdvi.tex</samp> (and the ‘<samp>.sty</samp>’ files), can also be used to
+<p>This mechanism, together with additions to <samp class="file">colordvi.tex</samp> and
+<samp class="file">blackdvi.tex</samp> (and the ‘<samp class="samp">.sty</samp>’ files), can also be used to
predefine other colors for your users.
</p>
<hr>
</div>
-<div class="section" id="Color-support-details">
-<div class="header">
+<div class="section-level-extent" id="Color-support-details">
+<div class="nav-panel">
<p>
Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color device configuration</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-support-details-1"></span><h3 class="section">7.6 Color support details</h3>
+<h3 class="section" id="Color-support-details-1">7.6 Color support details</h3>
<p>To support color, Dvips recognizes a certain set of specials. These
-specials start with the keyword ‘<samp>color</samp>’ or the keyword
-‘<samp>background</samp>’, followed by a color specification.
+specials start with the keyword ‘<samp class="samp">color</samp>’ or the keyword
+‘<samp class="samp">background</samp>’, followed by a color specification.
</p>
-<ul class="section-toc">
+<ul class="mini-toc">
<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li>
<li><a href="#Color-specials" accesskey="2">Color specials</a></li>
</ul>
<hr>
-<div class="subsection" id="Color-specifications">
-<div class="header">
+<div class="subsection-level-extent" id="Color-specifications">
+<div class="nav-panel">
<p>
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-specifications-1"></span><h4 class="subsection">7.6.1 Color specifications</h4>
+<h4 class="subsection" id="Color-specifications-1">7.6.1 Color specifications</h4>
-<span id="index-color-specifications"></span>
+<a class="index-entry-id" id="index-color-specifications"></a>
<p>What is a color specification? One of three things. First, it might be
a PostScript procedure as defined in a PostScript header file. The
-<samp>color.pro</samp> file defines 64 of these, including ‘<samp>Maroon</samp>’.
+<samp class="file">color.pro</samp> file defines 64 of these, including ‘<samp class="samp">Maroon</samp>’.
This PostScript procedure must set the current color to be some value;
-in this case, ‘<samp>Maroon</samp>’ is defined as ‘<samp>0 0.87 0.68 0.32
+in this case, ‘<samp class="samp">Maroon</samp>’ is defined as ‘<samp class="samp">0 0.87 0.68 0.32
setcmykcolor</samp>’.
</p>
<p>The second possibility is the name of a color model (initially, one of
-‘<samp>rgb</samp>’, ‘<samp>hsb</samp>’, ‘<samp>cmyk</samp>’, or ‘<samp>gray</samp>’) followed by the
+‘<samp class="samp">rgb</samp>’, ‘<samp class="samp">hsb</samp>’, ‘<samp class="samp">cmyk</samp>’, or ‘<samp class="samp">gray</samp>’) followed by the
appropriate number of parameters. When Dvips encounters such a macro,
it sends out the parameters first, followed by the string created by
-prefixing ‘<samp>TeXcolor</samp>’ to the color model. Thus, the color
-specification ‘<samp>rgb 0.3 0.4 0.5</samp>’ would generate the PostScript code
-‘<samp>0.3 0.4 0.5 TeXrgbcolor</samp>’. Note that the case of zero arguments is
+prefixing ‘<samp class="samp">TeXcolor</samp>’ to the color model. Thus, the color
+specification ‘<samp class="samp">rgb 0.3 0.4 0.5</samp>’ would generate the PostScript code
+‘<samp class="samp">0.3 0.4 0.5 TeXrgbcolor</samp>’. Note that the case of zero arguments is
disallowed, as that is handled by the single keyword case
-(‘<samp>Maroon</samp>’) above, where no changes to the name are made before it
+(‘<samp class="samp">Maroon</samp>’) above, where no changes to the name are made before it
is sent to the PostScript file.
</p>
<p>The third and final type of color specification is a double quote
followed by any sequence of PostScript. The double quote is stripped
from the output. For instance, the color specification
-‘<samp>"AggiePattern setpattern</samp>’ will set the ‘color’ to the Aggie logo
+‘<samp class="samp">"AggiePattern setpattern</samp>’ will set the ‘color’ to the Aggie logo
pattern (assuming such exists.)
</p>
<hr>
</div>
-<div class="subsection" id="Color-specials">
-<div class="header">
+<div class="subsection-level-extent" id="Color-specials">
+<div class="nav-panel">
<p>
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Color-specials-1"></span><h4 class="subsection">7.6.2 Color specials</h4>
+<h4 class="subsection" id="Color-specials-1">7.6.2 Color specials</h4>
-<p>We will describe ‘<samp>background</samp>’ first, since it is the simplest. The
-‘<samp>background</samp>’ keyword must be followed by a color specification.
+<p>We will describe ‘<samp class="samp">background</samp>’ first, since it is the simplest. The
+‘<samp class="samp">background</samp>’ keyword must be followed by a color specification.
That color specification is used as a fill color for the background.
-The last ‘<samp>background</samp>’ special on a page is the one that gets
+The last ‘<samp class="samp">background</samp>’ special on a page is the one that gets
issued, and it gets issued at the very beginning of the page, before any
text or specials are sent. (This is possible because the prescan phase
of Dvips notices all of the color specials so that the appropriate
information can be written out during the second phase.)
</p>
-<p>The ‘<samp>color</samp>’ special itself has three forms.
-The first is just ‘<samp>color</samp>’ followed by a color specification. In
+<p>The ‘<samp class="samp">color</samp>’ special itself has three forms.
+The first is just ‘<samp class="samp">color</samp>’ followed by a color specification. In
this case, the current global color is set to that color; the color stack
must be empty when such a command is executed.
</p>
-<p>The second form is ‘<samp>color push</samp>’ followed by a color specification.
+<p>The second form is ‘<samp class="samp">color push</samp>’ followed by a color specification.
This saves the current color on the color stack and sets the color to be
that given by the color specification. This is the most common way to
set a color.
</p>
-<p>The final version of the ‘<samp>color</samp>’ special is just ‘<samp>color pop</samp>’,
+<p>The final version of the ‘<samp class="samp">color</samp>’ special is just ‘<samp class="samp">color pop</samp>’,
with no color specification; this says to pop the color last pushed on
the color stack from the color stack and set the current color to be
that color.
@@ -5347,9 +5345,9 @@
one color specification can be active at a time. For instance, at the
beginning of a page, only the bottommost entry on the color stack is
sent; also, when a color is popped, all that is done is that the color
-specification from the previous stack entry is sent. No ‘<samp>gsave</samp>’ or
-‘<samp>grestore</samp>’ is used. This means that you cannot easily mix usage of
-the ‘<samp>color</samp>’ specials for screens and colors, just one or the other.
+specification from the previous stack entry is sent. No ‘<samp class="samp">gsave</samp>’ or
+‘<samp class="samp">grestore</samp>’ is used. This means that you cannot easily mix usage of
+the ‘<samp class="samp">color</samp>’ specials for screens and colors, just one or the other.
This may be addressed in the future by adding support for different
categories of color-like state.
</p>
@@ -5358,967 +5356,969 @@
</div>
</div>
</div>
-<div class="unnumbered" id="Index">
-<div class="header">
+<div class="unnumbered-level-extent" id="Index">
+<div class="nav-panel">
<p>
Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
+<h2 class="unnumbered" id="Index-1">Index</h2>
-<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a>
+<div class="printindex cp-printindex">
+<table class="cp-letters-header-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>!</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-2"><b>"</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>"</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-3"><b>%</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>%</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-4"><b>(</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>(</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-5"><b>+</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>+</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-6"><b>-</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>-</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-7"><b>.</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>.</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-8"><b>/</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>/</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>6</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>8</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-11"><b><</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b><</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-12"><b>=</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>=</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-13"><b>@</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>@</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-14"><b>\</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-14"><b>\</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-15"><b>|</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-15"><b>|</b></a>
<br>
-<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
-<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
-<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
-<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
-<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
-<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
-<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
-<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
-<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
-<a class="summary-letter" href="#Index_cp_letter-J"><b>J</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a>
-<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
-<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
-<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
-<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
-<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
-<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
-<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
-<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
-<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
-<a class="summary-letter" href="#Index_cp_letter-U"><b>U</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
-<a class="summary-letter" href="#Index_cp_letter-V"><b>V</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
-<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
-<a class="summary-letter" href="#Index_cp_letter-X"><b>X</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Y"><b>Y</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Z"><b>Z</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
</td></tr></table>
-<table class="index-cp" border="0">
-<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
+<table class="cp-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td> </td><th class="sections-header-printindex"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-1">!</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0021-special-_0028literal-PS-header_0029"><code>! <span class="roman">special (literal PS header)</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-headers">Literal headers</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0021-starting-output-filename"><code>! <span class="roman">starting output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021-special-_0028literal-PS-header_0029"><code>! <span class="r">special (literal PS header)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021-starting-output-filename"><code>! <span class="r">starting output filename</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-2">"</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0022-special-_0028literal-PostScript_0029"><code>" <span class="roman">special (literal PostScript)</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_0022-special">" special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022-special-_0028literal-PostScript_0029"><code>" <span class="r">special (literal PostScript)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#g_t_0022-special">" special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-3">%</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025BoundingBox"><code>%%BoundingBox</code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-and-multi_002dpage-information"><code>%%Page<span class="roman">, and multi-page information</span></code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-not-generating"><code>%%Page<span class="roman">, not generating</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-removing"><code>%%Page<span class="roman">, removing</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-required-by-Ghostview"><code>%%Page<span class="roman">, required by Ghostview</span></code></a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025Title"><code>%%Title</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_0025VMusage"><code>%%VMusage</code></a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0025_002aFont"><code>%*Font</code></a>:</td><td> </td><td valign="top"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025BoundingBox"><code>%%BoundingBox</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-and-multi_002dpage-information"><code>%%Page<span class="r">, and multi-page information</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-not-generating"><code>%%Page<span class="r">, not generating</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-removing"><code>%%Page<span class="r">, removing</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-required-by-Ghostview"><code>%%Page<span class="r">, required by Ghostview</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Title"><code>%%Title</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025VMusage"><code>%%VMusage</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_002aFont"><code>%*Font</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-4">(</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0028atend_0029_002c-bounding-box-specification"><code>(atend)<span class="roman">, bounding box specification</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0028atend_0029_002c-bounding-box-specification"><code>(atend)<span class="r">, bounding box specification</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-5">+</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002bpsmapfile"><code>+<var>psmapfile</var></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002bpsmapfile"><code>+<var class="var">psmapfile</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-6">-</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d"><code>-</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d-as-output-filename"><code>- <span class="roman">as output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp"><code>--help</code></a>:</td><td> </td><td valign="top"><a href="#Option-summary">Option summary</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp-1"><code>--help</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d_002dversion"><code>--version</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002da"><code>-a</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dA"><code>-A</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002da-1"><code>-a</code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dB"><code>-B</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002db-num"><code>-b <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dbitmapfontenc-option"><code>-bitmapfontenc <var>option</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dc-num"><code>-c <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dC-num"><code>-C <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dc-ratio"><code>-c <var>ratio</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dd-num"><code>-d <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dD-num"><code>-D <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dE"><code>-E</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002de-num"><code>-e <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002de-ratio"><code>-e <var>ratio</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002df"><code>-f</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dF"><code>-F</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dG"><code>-G</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dh-name"><code>-h <var>name</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002di"><code>-i</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dj-for-partial-font-downloading"><code>-j <span class="roman">for partial font downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dK"><code>-K</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dk-for-cropmarks"><code>-k <span class="roman">for cropmarks</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dL"><code>-L</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"><code>-l [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dlandscaperotate"><code>-landscaperotate</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dm"><code>-m</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dM"><code>-M</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dmode-mode"><code>-mode <var>mode</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dN"><code>-N</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dn-num"><code>-n <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dnoomega"><code>-noomega</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dnoptex"><code>-noptex</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dO"><code>-O</code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002do-name"><code>-o <var>name</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dO-x_002doffset_002cy_002doffset"><code>-O <var>x-offset</var>,<var>y-offset</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dP-printer"><code>-P <var>printer</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc-1"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"><code>-p [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dpp-first_002dlast"><code>-pp <var>first</var>-<var>last</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dpp-range"><code>-pp <var>range</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dPprinter_002c-and-config-file-searching"><code>-P<var>printer</var><span class="roman">, and config file searching</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dq"><code>-q</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dr"><code>-r</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dR"><code>-R</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002ds"><code>-s</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dS-num"><code>-S <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002ds-slant"><code>-s <var>slant</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dT-enc_002dfile"><code>-T <var>enc-file</var></code></a>:</td><td> </td><td valign="top"><a href="#Changing-both-encodings">Changing both encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dT-hsize_002cvsize"><code>-T <var>hsize</var>,<var>vsize</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dt-papertype"><code>-t <var>papertype</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dT-ps_002dtex_002denc"><code>-T <var>ps-tex-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dt-tex_002denc"><code>-t <var>tex-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dt-tex_002denc-1"><code>-t <var>tex-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dtitle-str"><code>-title <var>str</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dU"><code>-U</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002du"><code>-u</code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002du-psmapfile"><code>-u <var>psmapfile</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dv"><code>-v</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dV"><code>-V</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dv-vpl_002dfile"><code>-v <var>vpl-file</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dV-vpl_002dfile"><code>-V <var>vpl-file</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dx-num"><code>-x <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dX-num"><code>-X <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dY-num"><code>-Y <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dz"><code>-z</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dZ-for-compressing-bitmap-fonts"><code>-Z <span class="roman">for compressing bitmap fonts</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002dz-for-recognizing-hyperdvi"><code>-z <span class="roman">for recognizing hyperdvi</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d"><code>-</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-as-output-filename"><code>- <span class="r">as output filename</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp"><code>--help</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-summary">Option summary</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp-1"><code>--help</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dversion"><code>--version</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002da"><code>-a</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dA"><code>-A</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002da-1"><code>-a</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dB"><code>-B</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002db-num"><code>-b <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dbitmapfontenc-option"><code>-bitmapfontenc <var class="var">option</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dc-num"><code>-c <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dC-num"><code>-C <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dc-ratio"><code>-c <var class="var">ratio</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dd-num"><code>-d <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dD-num"><code>-D <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dE"><code>-E</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002de-num"><code>-e <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002de-ratio"><code>-e <var class="var">ratio</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002df"><code>-f</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dF"><code>-F</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dG"><code>-G</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dh-name"><code>-h <var class="var">name</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002di"><code>-i</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dj-for-partial-font-downloading"><code>-j <span class="r">for partial font downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dK"><code>-K</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dk-for-cropmarks"><code>-k <span class="r">for cropmarks</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dL"><code>-L</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"><code>-l [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dlandscaperotate"><code>-landscaperotate</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dm"><code>-m</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dM"><code>-M</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmode-mode"><code>-mode <var class="var">mode</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dN"><code>-N</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dn-num"><code>-n <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dnoomega"><code>-noomega</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dnoptex"><code>-noptex</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dO"><code>-O</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002do-name"><code>-o <var class="var">name</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dO-x_002doffset_002cy_002doffset"><code>-O <var class="var">x-offset</var>,<var class="var">y-offset</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dP-printer"><code>-P <var class="var">printer</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-ps_002denc"><code>-p <var class="var">ps-enc</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-ps_002denc-1"><code>-p <var class="var">ps-enc</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"><code>-p [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpp-first_002dlast"><code>-pp <var class="var">first</var>-<var class="var">last</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpp-range"><code>-pp <var class="var">range</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dPprinter_002c-and-config-file-searching"><code>-P<var class="var">printer</var><span class="r">, and config file searching</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dq"><code>-q</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dr"><code>-r</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dR"><code>-R</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ds"><code>-s</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dS-num"><code>-S <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ds-slant"><code>-s <var class="var">slant</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-enc_002dfile"><code>-T <var class="var">enc-file</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-both-encodings">Changing both encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-hsize_002cvsize"><code>-T <var class="var">hsize</var>,<var class="var">vsize</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-papertype"><code>-t <var class="var">papertype</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-ps_002dtex_002denc"><code>-T <var class="var">ps-tex-enc</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-tex_002denc"><code>-t <var class="var">tex-enc</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-tex_002denc-1"><code>-t <var class="var">tex-enc</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dtitle-str"><code>-title <var class="var">str</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dU"><code>-U</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002du"><code>-u</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002du-psmapfile"><code>-u <var class="var">psmapfile</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dv"><code>-v</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dV"><code>-V</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dv-vpl_002dfile"><code>-v <var class="var">vpl-file</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dV-vpl_002dfile"><code>-V <var class="var">vpl-file</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dx-num"><code>-x <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dX-num"><code>-X <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dY-num"><code>-Y <var class="var">num</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dz"><code>-z</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dZ-for-compressing-bitmap-fonts"><code>-Z <span class="r">for compressing bitmap fonts</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dz-for-recognizing-hyperdvi"><code>-z <span class="r">for recognizing hyperdvi</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-7">.</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002e_002e_002drelative-filenames"><samp>..</samp>-relative filenames</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002eafm-Adobe-metric-files"><code>.afm <span class="roman">Adobe metric files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002edvipsrc_002c-searched-for"><code>.dvipsrc<span class="roman">, searched for</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002eenc-extension-for-encoding-vectors"><code>.enc <span class="roman">extension for encoding vectors</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002elpro-long-prologue-files"><code>.lpro <span class="roman">long prologue files</span></code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002emf-Metafont-source-files"><code>.mf <span class="roman">Metafont source files</span></code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002ennnpk-packed-font-bitmaps"><code>.<var>nnn</var>pk <span class="roman">packed font bitmaps</span></code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epfa-extension-required-for-partial-downloading"><code>.pfa <span class="roman">extension required for partial downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epfa-printer-font-ascii-files"><code>.pfa <span class="roman">printer font ascii files</span></code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epfb-extension-required-for-partial-downloading"><code>.pfb <span class="roman">extension required for partial downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epfb-printer-font-binary-files"><code>.pfb <span class="roman">printer font binary files</span></code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epfm-printer-font-metric-files"><code>.pfm <span class="roman">printer font metric files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epl-property-list-files"><code>.pl <span class="roman">property list files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002epro-prologue-files"><code>.pro <span class="roman">prologue files</span></code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002etfm-TeX-font-metric-files"><code>.tfm <span class="roman">TeX font metric files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002e_002e_002drelative-filenames"><samp class="file">..</samp>-relative filenames</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eafm-Adobe-metric-files"><code>.afm <span class="r">Adobe metric files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002edvipsrc_002c-searched-for"><code>.dvipsrc<span class="r">, searched for</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eenc-extension-for-encoding-vectors"><code>.enc <span class="r">extension for encoding vectors</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002elpro-long-prologue-files"><code>.lpro <span class="r">long prologue files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002emf-Metafont-source-files"><code>.mf <span class="r">Metafont source files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ennnpk-packed-font-bitmaps"><code>.<var class="var">nnn</var>pk <span class="r">packed font bitmaps</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfa-extension-required-for-partial-downloading"><code>.pfa <span class="r">extension required for partial downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfa-printer-font-ascii-files"><code>.pfa <span class="r">printer font ascii files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfb-extension-required-for-partial-downloading"><code>.pfb <span class="r">extension required for partial downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfb-printer-font-binary-files"><code>.pfb <span class="r">printer font binary files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfm-printer-font-metric-files"><code>.pfm <span class="r">printer font metric files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epl-property-list-files"><code>.pl <span class="r">property list files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epro-prologue-files"><code>.pro <span class="r">prologue files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002etfm-TeX-font-metric-files"><code>.tfm <span class="r">TeX font metric files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-8">/</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002f_0023copies"><code>/#copies</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002f_0023copies-1"><code>/#copies</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002fmagscale"><code>/magscale</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_0023copies"><code>/#copies</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_0023copies-1"><code>/#copies</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002fmagscale"><code>/magscale</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-9">6</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-612-792-bounding-box-size"><code>612 792 <span class="roman">bounding box size</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-612-792-bounding-box-size"><code>612 792 <span class="r">bounding box size</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-10">8</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-8r-encoding_002c-and-extra-characters"><code>8r <span class="roman">encoding, and extra characters</span></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-8r-font-encoding">8r font encoding</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-8r_002eenc"><code>8r.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-8r-encoding_002c-and-extra-characters"><code>8r <span class="r">encoding, and extra characters</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-8r-font-encoding">8r font encoding</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-8r_002eenc"><code>8r.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-11"><</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_003c-font-downloading"><code>< <span class="roman">font downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_003c_003c-whole-font-downloading"><code><< <span class="roman">whole font downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_003c_005b-encoding-vector-downloading"><code><[ <span class="roman">encoding vector downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c-font-downloading"><code>< <span class="r">font downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_003c-whole-font-downloading"><code><< <span class="r">whole font downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_005b-encoding-vector-downloading"><code><[ <span class="r">encoding vector downloading</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-12">=</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_003d_003a-ligature-operation"><code>=: <span class="roman">ligature operation</span></code></a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003d_003a-ligature-operation"><code>=: <span class="r">ligature operation</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-13">@</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0040-config-command-_0028define-paper-sizes_0029"><code>@ <span class="roman">config command (define paper sizes)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0040-config-command-_0028define-paper-sizes_0029"><code>@ <span class="r">config command (define paper sizes)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-14">\</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_002e"><code>\.</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cAA"><code>\AA</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cColorName"><code>\<var>ColorName</var></code></a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cdot"><code>\dot</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cepsffile-macro"><code>\epsffile <span class="roman">macro</span></code></a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cepsfsize"><code>\epsfsize</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cepsfverbosetrue"><code>\epsfverbosetrue</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cepsfxsize"><code>\epsfxsize</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cepsfysize"><code>\epsfysize</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cH"><code>\H</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cincludegraphics-LaTeX-macro">\includegraphics LaTeX macro</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cleavevmode"><code>\leavevmode</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmagnification"><code>\magnification</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005crotninety"><code>\rotninety</code></a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ctextColorName"><code>\text<var>ColorName</var></code></a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002e"><code>\.</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cAA"><code>\AA</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cColorName"><code>\<var class="var">ColorName</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cdot"><code>\dot</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsffile-macro"><code>\epsffile <span class="r">macro</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfsize"><code>\epsfsize</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfverbosetrue"><code>\epsfverbosetrue</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfxsize"><code>\epsfxsize</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfysize"><code>\epsfysize</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH"><code>\H</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cincludegraphics-LaTeX-macro">\includegraphics LaTeX macro</a>:</td><td> </td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cleavevmode"><code>\leavevmode</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cmagnification"><code>\magnification</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005crotninety"><code>\rotninety</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ctextColorName"><code>\text<var class="var">ColorName</var></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-15">|</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_007c-starting-output-filename"><code>| <span class="roman">starting output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007c-starting-output-filename"><code>| <span class="r">starting output filename</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-a-config-command-_0028conserve-memory_0029"><code>a <span class="roman">config command (conserve memory)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-A-ring_002c-Scandinavian-letter">A ring, Scandinavian letter</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-a3-papertype">a3 papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-a4-paper-size"><code>a4 <span class="roman">paper size</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-a4-papertype">a4 papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-A4size-paper-size"><code>A4size <span class="roman">paper size</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-absolute-filenames_002c-disabling">absolute filenames, disabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accent-height-adjustment_002c-omitting">accent height adjustment, omitting</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accents_002c-in-wrong-position">accents, in wrong position</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accents_002c-wrong">accents, wrong</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accuracy-in-positioning">accuracy in positioning</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-afm-files">afm files</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-afm2tfm"><code>afm2tfm</code></a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-afm2tfm-1"><code>afm2tfm</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-afm2tfm-options">afm2tfm options</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-after-header_002c-inserting-code">after header, inserting code</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Aladdin-Ghostscript">Aladdin Ghostscript</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Anderson_002c-Laurie">Anderson, Laurie</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-angle-_0028psfile-special-option_0029"><code>angle <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-arcs">arcs</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ASCII-character-codes_002c-used-by-PostScript">ASCII character codes, used by PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-atend_002c-bounding-box-specification"><code>atend<span class="roman">, bounding box specification</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-a-config-command-_0028conserve-memory_0029"><code>a <span class="r">config command (conserve memory)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-A-ring_002c-Scandinavian-letter">A ring, Scandinavian letter</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-a3-papertype">a3 papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-a4-paper-size"><code>a4 <span class="r">paper size</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-a4-papertype">a4 papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-A4size-paper-size"><code>A4size <span class="r">paper size</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-filenames_002c-disabling">absolute filenames, disabling</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp class="samp">-l</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp class="samp">-p</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accent-height-adjustment_002c-omitting">accent height adjustment, omitting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accents_002c-in-wrong-position">accents, in wrong position</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accents_002c-wrong">accents, wrong</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accuracy-in-positioning">accuracy in positioning</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-afm-files">afm files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm"><code>afm2tfm</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm-1"><code>afm2tfm</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm-options">afm2tfm options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-after-header_002c-inserting-code">after header, inserting code</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Aladdin-Ghostscript">Aladdin Ghostscript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Anderson_002c-Laurie">Anderson, Laurie</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-angle-_0028psfile-special-option_0029"><code>angle <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arcs">arcs</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ASCII-character-codes_002c-used-by-PostScript">ASCII character codes, used by PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-atend_002c-bounding-box-specification"><code>atend<span class="r">, bounding box specification</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-b-config-command-_0028_0023copies_0029"><code>b <span class="roman">config command (#copies)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-base"><code>base</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-base-encoding_002c-recommended">base encoding, recommended</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-base-fonts">base fonts</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bbfig"><code>bbfig</code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-before-header_002c-inserting-code">before header, inserting code</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Bhattacharya_002c-Tanmoy">Bhattacharya, Tanmoy</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-big-points">big points</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-binary-files_002c-not-supported">binary files, not supported</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bitmap-font-encoding">bitmap font encoding</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bitmap-font-encodings">bitmap font encodings</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bitmap-fonts">bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"><code>bitmapfontenc <span class="roman">config command (bitmap font encoding)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bop-undefined-error"><tt>bop undefined</tt> error</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bop_002dhook"><code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bop_002dhook-1"><code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bop_002dhook-2"><code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bop_002dhook_002c-and-offset-pages"><code>bop-hook<span class="roman">, and offset pages</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-boundary-character">boundary character</a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-comment-for">bounding box, comment for</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-defined">bounding box, defined</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-determining">bounding box, determining</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-finding-tight">bounding box, finding tight</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-for-bitmap-fonts">bounding box, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-inaccurate">bounding box, inaccurate</a>:</td><td> </td><td valign="top"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX-1">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-b-config-command-_0028_0023copies_0029"><code>b <span class="r">config command (#copies)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-base"><code>base</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-base-encoding_002c-recommended">base encoding, recommended</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-base-fonts">base fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bbfig"><code>bbfig</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-before-header_002c-inserting-code">before header, inserting code</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Bhattacharya_002c-Tanmoy">Bhattacharya, Tanmoy</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-big-points">big points</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-binary-files_002c-not-supported">binary files, not supported</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-font-encoding">bitmap font encoding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-font-encodings">bitmap font encodings</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-fonts">bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"><code>bitmapfontenc <span class="r">config command (bitmap font encoding)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bop-undefined-error"><code class="t">bop undefined</code> error</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook"><code>bop-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook-1"><code>bop-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook-2"><code>bop-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook_002c-and-offset-pages"><code>bop-hook<span class="r">, and offset pages</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boundary-character">boundary character</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-comment-for">bounding box, comment for</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-defined">bounding box, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-determining">bounding box, determining</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-finding-tight">bounding box, finding tight</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-for-bitmap-fonts">bounding box, for bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-inaccurate">bounding box, inaccurate</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-supplying-to-TeX">bounding box, supplying to TeX</a>:</td><td> </td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-supplying-to-TeX-1">bounding box, supplying to TeX</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-c-config-command-_0028include-another-config-file_0029"><code>c <span class="roman">config command (include another config file)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-changing-PostScript-encodings">changing PostScript encodings</a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-changing-TeX-encodings">changing TeX encodings</a>:</td><td> </td><td valign="top"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-character-definitions-in-PostScript">character definitions in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-character-lookup-procedure-in-PostScript">character lookup procedure in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-CharStrings-Type-1-dictionary"><code>CharStrings <span class="roman">Type 1 dictionary</span></code></a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-clip-_0028psfile-special-option_0029"><code>clip <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-clipping-of-EPSF">clipping of EPSF</a>:</td><td> </td><td valign="top"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-CODINGSCHEME"><code>CODINGSCHEME</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-collated-copies">collated copies</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color">color</a>:</td><td> </td><td valign="top"><a href="#Color">Color</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-configuration">color configuration</a>:</td><td> </td><td valign="top"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-macros">color macros</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-names_002c-mixed-case">color names, mixed case</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-nesting-level">color nesting level</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-separations">color separations</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-specifications">color specifications</a>:</td><td> </td><td valign="top"><a href="#Color-specifications">Color specifications</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-subtleties">color subtleties</a>:</td><td> </td><td valign="top"><a href="#Color-subtleties">Color subtleties</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-colors_002c-user_002ddefinable">colors, user-definable</a>:</td><td> </td><td valign="top"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command-line_002c-including-headers-from">command line, including headers from</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command_002dline-options">command-line options</a>:</td><td> </td><td valign="top"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-comments_002c-in-configuration-files">comments, in configuration files</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-comments_002c-in-encoding-files">comments, in encoding files</a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-comments_002c-removing-included">comments, removing included</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compilation">compilation</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compressed-PostScript">compressed PostScript</a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compressing-bitmap-fonts">compressing bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Computer-Modern-in-PostScript">Computer Modern in PostScript</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Computer-Modern_002c-encoding-of">Computer Modern, encoding of</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-condensed-fonts">condensed fonts</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-config_002eproto"><code>config.proto</code></a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-config_002eps"><code>config.ps</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-config_002eps-installation"><code>config.ps <span class="roman">installation</span></code></a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-config_002eps-paper-sizes"><code>config.ps <span class="roman">paper sizes</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-config_002eps_002c-searched-for"><code>config.ps<span class="roman">, searched for</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-file-options">configuration file options</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-file-paper-size-command">configuration file paper size command</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-file-path">configuration file path</a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-file-searching">configuration file searching</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-files">configuration files</a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-files_002c-creating">configuration files, creating</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-files_002c-prototype">configuration files, prototype</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration_002c-of-color-devices">configuration, of color devices</a>:</td><td> </td><td valign="top"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration_002c-of-Dvips">configuration, of Dvips</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-continuation-lines_002c-not-supported">continuation lines, not supported</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-control_002dD">control-D</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-coordinate-system_002c-for-bitmap-fonts">coordinate system, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-copies_002c-collated">copies, collated</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-copies_002c-duplicated-page-bodies">copies, duplicated page bodies</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-copies_002c-uncollated">copies, uncollated</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Crayola-crayon-box">Crayola crayon box</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-crop_002epro"><code>crop.pro</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cropmarks">cropmarks</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-current-font_002c-in-PostScript">current font, in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-c-config-command-_0028include-another-config-file_0029"><code>c <span class="r">config command (include another config file)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-PostScript-encodings">changing PostScript encodings</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-TeX-encodings">changing TeX encodings</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-definitions-in-PostScript">character definitions in PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-lookup-procedure-in-PostScript">character lookup procedure in PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CharStrings-Type-1-dictionary"><code>CharStrings <span class="r">Type 1 dictionary</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-clip-_0028psfile-special-option_0029"><code>clip <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-clipping-of-EPSF">clipping of EPSF</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CODINGSCHEME"><code>CODINGSCHEME</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-collated-copies">collated copies</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color">color</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color">Color</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-configuration">color configuration</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-macros">color macros</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-names_002c-mixed-case">color names, mixed case</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-nesting-level">color nesting level</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-separations">color separations</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-specifications">color specifications</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-specifications">Color specifications</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-subtleties">color subtleties</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-subtleties">Color subtleties</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-colors_002c-user_002ddefinable">colors, user-definable</a>:</td><td> </td><td class="printindex-index-section"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-command-line_002c-including-headers-from">command line, including headers from</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-command_002dline-options">command-line options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-configuration-files">comments, in configuration files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-encoding-files">comments, in encoding files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-removing-included">comments, removing included</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compilation">compilation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compressed-PostScript">compressed PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compressing-bitmap-fonts">compressing bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern-in-PostScript">Computer Modern in PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern_002c-encoding-of">Computer Modern, encoding of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-condensed-fonts">condensed fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eproto"><code>config.proto</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps"><code>config.ps</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps-installation"><code>config.ps <span class="r">installation</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps-paper-sizes"><code>config.ps <span class="r">paper sizes</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps_002c-searched-for"><code>config.ps<span class="r">, searched for</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-options">configuration file options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-paper-size-command">configuration file paper size command</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-path">configuration file path</a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-searching">configuration file searching</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files">configuration files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files_002c-creating">configuration files, creating</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files_002c-prototype">configuration files, prototype</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-of-color-devices">configuration, of color devices</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-of-Dvips">configuration, of Dvips</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continuation-lines_002c-not-supported">continuation lines, not supported</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control_002dD">control-D</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-coordinate-system_002c-for-bitmap-fonts">coordinate system, for bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-collated">copies, collated</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-duplicated-page-bodies">copies, duplicated page bodies</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-uncollated">copies, uncollated</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Crayola-crayon-box">Crayola crayon box</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-crop_002epro"><code>crop.pro</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cropmarks">cropmarks</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-font_002c-in-PostScript">current font, in PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-D-config-command-_0028dpi_0029"><code>D <span class="roman">config command (dpi)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dated-output">dated output</a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-datestamp_002c-in-output">datestamp, in output</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-debugging">debugging</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-debugging-1">debugging</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-debugging-options">debugging options</a>:</td><td> </td><td valign="top"><a href="#Debug-options">Debug options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-default-resolutions">default resolutions</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-default_005ftexsizes-Make-variable"><code>default_texsizes <span class="roman">Make variable</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Deutsch_002c-Peter">Deutsch, Peter</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-device-dependency_002c-and-virtual-fonts">device dependency, and virtual fonts</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dictionary_002c-CharStrings">dictionary, <code>CharStrings</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dictionary_002c-PostScript-language">dictionary, PostScript language</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dictionary_002c-SDict">dictionary, <code>SDict</code></a>:</td><td> </td><td valign="top"><a href="#Literal-headers">Literal headers</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dictionary_002c-userdict">dictionary, <code>userdict</code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-distillation_002c-and-_002dz">distillation, and ‘<samp>-z</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-distiller_002c-for-PDF-files">distiller, for PDF files</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-title_002c-specifying">document title, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dot-accent">dot accent</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double_002dsided-printing">double-sided printing</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-downloading-fonts-partially">downloading fonts partially</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-downloading-PostScript-fonts">downloading PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Doyle_002c-Mark">Doyle, Mark</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-draft-copies">draft copies</a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dual-paper-trays">dual paper trays</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-duplex-printers">duplex printers</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVI-magnification">DVI magnification</a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dvihps_002c-hyperdvi-to-PostScript"><code>dvihps<span class="roman">, hyperdvi to PostScript</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Dvips-configuration-file-options">Dvips configuration file options</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dvips_002dall_002eenc"><code>dvips-all.enc</code></a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dvips_002eenc"><code>dvips.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSDEBUG"><code>DVIPSDEBUG</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSFONTS"><code>DVIPSFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSHEADERS"><code>DVIPSHEADERS</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSHEADERS_002c-overrides-H"><code>DVIPSHEADERS<span class="roman">, overrides</span> H</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSMAKEPK"><code>DVIPSMAKEPK</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSRC"><code>DVIPSRC</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSSIZES"><code>DVIPSSIZES</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-DVIPSSIZES_002c-overrides-R"><code>DVIPSSIZES<span class="roman">, overrides</span> R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dynamic-creation-of-graphics">dynamic creation of graphics</a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-D-config-command-_0028dpi_0029"><code>D <span class="r">config command (dpi)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dated-output">dated output</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-datestamp_002c-in-output">datestamp, in output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging">debugging</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-1">debugging</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-options">debugging options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Debug-options">Debug options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-default-resolutions">default resolutions</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-default_005ftexsizes-Make-variable"><code>default_texsizes <span class="r">Make variable</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Deutsch_002c-Peter">Deutsch, Peter</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-dependency_002c-and-virtual-fonts">device dependency, and virtual fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-CharStrings">dictionary, <code class="code">CharStrings</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-PostScript-language">dictionary, PostScript language</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-SDict">dictionary, <code class="code">SDict</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-userdict">dictionary, <code class="code">userdict</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-distillation_002c-and-_002dz">distillation, and ‘<samp class="samp">-z</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-distiller_002c-for-PDF-files">distiller, for PDF files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-document-title_002c-specifying">document title, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dot-accent">dot accent</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-double_002dsided-printing">double-sided printing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-downloading-fonts-partially">downloading fonts partially</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-downloading-PostScript-fonts">downloading PostScript fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Doyle_002c-Mark">Doyle, Mark</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-draft-copies">draft copies</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dual-paper-trays">dual paper trays</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-duplex-printers">duplex printers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-magnification">DVI magnification</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dvihps_002c-hyperdvi-to-PostScript"><code>dvihps<span class="r">, hyperdvi to PostScript</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Dvips-configuration-file-options">Dvips configuration file options</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dvips_002dall_002eenc"><code>dvips-all.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dvips_002eenc"><code>dvips.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSDEBUG"><code>DVIPSDEBUG</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSFONTS"><code>DVIPSFONTS</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSHEADERS"><code>DVIPSHEADERS</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSHEADERS_002c-overrides-H"><code>DVIPSHEADERS<span class="r">, overrides</span> H</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSMAKEPK"><code>DVIPSMAKEPK</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSRC"><code>DVIPSRC</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSSIZES"><code>DVIPSSIZES</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSSIZES_002c-overrides-R"><code>DVIPSSIZES<span class="r">, overrides</span> R</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-creation-of-graphics">dynamic creation of graphics</a>:</td><td> </td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-e-config-command-_0028maxdrift_0029"><code>e <span class="roman">config command (maxdrift)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-E-config-command-_0028shell-escape_0029"><code>E <span class="roman">config command (shell escape)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-efficiency_002c-and-fonts">efficiency, and fonts</a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ehandler_002eps"><code>ehandler.ps</code></a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-embedding-Type-1-fonts">embedding Type 1 fonts</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encoding-changes">encoding changes</a>:</td><td> </td><td valign="top"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encoding-file-format">encoding file format</a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encoding-files">encoding files</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Encoding-Type-1-dictionary"><code>Encoding <span class="roman">Type 1 dictionary</span></code></a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encoding-vectors_002c-defined">encoding vectors, defined</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encoding-vectors_002c-in-Type-1-fonts">encoding vectors, in Type 1 fonts</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encodings">encodings</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-encodings_002c-for-bitmap-fonts">encodings, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-end_002dhook"><code>end-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environment-variables">environment variables</a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EOF">EOF</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-eop_002dhook"><code>eop-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EPS_002c-and-Ghostview">EPS, and Ghostview</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EPSF-macros">EPSF macros</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EPSF_002c-generating">EPSF, generating</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-epsf_002esty"><code>epsf.sty</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-epsf_002etex"><code>epsf.tex</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Epson-printers">Epson printers</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-error-messages-from-printer">error messages from printer</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-even-pages-only">even pages only</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-examples-of-literal-PostScript">examples of literal PostScript</a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-expanded-fonts">expanded fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-expanded-fonts-1">expanded fonts</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-expanded-fonts-2">expanded fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-expansion_002c-of-virtual-fonts">expansion, of virtual fonts</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-extended-URL">extended URL</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ExtendFont"><code>ExtendFont</code></a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-extra-characters_002c-accessing">extra characters, accessing</a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-e-config-command-_0028maxdrift_0029"><code>e <span class="r">config command (maxdrift)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-E-config-command-_0028shell-escape_0029"><code>E <span class="r">config command (shell escape)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-efficiency_002c-and-fonts">efficiency, and fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ehandler_002eps"><code>ehandler.ps</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-embedding-Type-1-fonts">embedding Type 1 fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-changes">encoding changes</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-file-format">encoding file format</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-files">encoding files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Encoding-Type-1-dictionary"><code>Encoding <span class="r">Type 1 dictionary</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-vectors_002c-defined">encoding vectors, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-vectors_002c-in-Type-1-fonts">encoding vectors, in Type 1 fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encodings">encodings</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encodings_002c-for-bitmap-fonts">encodings, for bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dhook"><code>end-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables">environment variables</a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EOF">EOF</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-eop_002dhook"><code>eop-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EPS_002c-and-Ghostview">EPS, and Ghostview</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EPSF-macros">EPSF macros</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EPSF_002c-generating">EPSF, generating</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-epsf_002esty"><code>epsf.sty</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-epsf_002etex"><code>epsf.tex</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Epson-printers">Epson printers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-error-messages-from-printer">error messages from printer</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-even-pages-only">even pages only</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-examples-of-literal-PostScript">examples of literal PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts">expanded fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts-1">expanded fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts-2">expanded fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-of-virtual-fonts">expansion, of virtual fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extended-URL">extended URL</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ExtendFont"><code>ExtendFont</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-characters_002c-accessing">extra characters, accessing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-f-config-command-_0028filter_0029"><code>f <span class="roman">config command (filter)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-F-config-command-_0028filter_0029"><code>F <span class="roman">config command (filter)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-failure_002c-and-printer-errors">failure, and printer errors</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-failure_002c-of-long-documents">failure, of long documents</a>:</td><td> </td><td valign="top"><a href="#Long-documents-fail">Long documents fail</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-failure_002c-to-include-graphics">failure, to include graphics</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-failure_002c-to-print-at-all">failure, to print at all</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fallback-resolutions">fallback resolutions</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figures-and-fonts">figures and fonts</a>:</td><td> </td><td valign="top"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figures_002c-natural-size">figures, natural size</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figures_002c-scaling">figures, scaling</a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-filter_002c-running-as-a">filter, running as a</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-first-page-printed">first page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-concepts">font concepts</a>:</td><td> </td><td valign="top"><a href="#Font-concepts">Font concepts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-encodings_002c-bitmap">font encodings, bitmap</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fontinst"><code>fontinst</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-as-header-files">fonts, as header files</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-changing-encoding-of">fonts, changing encoding of</a>:</td><td> </td><td valign="top"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-downloading">fonts, downloading</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-expanded">fonts, expanded</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-in-PostScript-figures">fonts, in PostScript figures</a>:</td><td> </td><td valign="top"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-installation-of-PostScript">fonts, installation of PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-installing">fonts, installing</a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-outlined">fonts, outlined</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-slanted">fonts, slanted</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-small-caps">fonts, small caps</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-system-PostScript">fonts, system PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-f-config-command-_0028filter_0029"><code>f <span class="r">config command (filter)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-F-config-command-_0028filter_0029"><code>F <span class="r">config command (filter)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-and-printer-errors">failure, and printer errors</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-of-long-documents">failure, of long documents</a>:</td><td> </td><td class="printindex-index-section"><a href="#Long-documents-fail">Long documents fail</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-to-include-graphics">failure, to include graphics</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-to-print-at-all">failure, to print at all</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-resolutions">fallback resolutions</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-figures-and-fonts">figures and fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-figures_002c-natural-size">figures, natural size</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-figures_002c-scaling">figures, scaling</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filter_002c-running-as-a">filter, running as a</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-first-page-printed">first page printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-concepts">font concepts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Font-concepts">Font concepts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-encodings_002c-bitmap">font encodings, bitmap</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fontinst"><code>fontinst</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-as-header-files">fonts, as header files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-changing-encoding-of">fonts, changing encoding of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-downloading">fonts, downloading</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-expanded">fonts, expanded</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-in-PostScript-figures">fonts, in PostScript figures</a>:</td><td> </td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-installation-of-PostScript">fonts, installation of PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-installing">fonts, installing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-outlined">fonts, outlined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-slanted">fonts, slanted</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-small-caps">fonts, small caps</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-system-PostScript">fonts, system PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-G-config-command-_0028character-shifting_0029"><code>G <span class="roman">config command (character shifting)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gf-files">gf files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gftopk"><code>gftopk</code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Ghostscript-installation">Ghostscript installation</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ghostview"><code>ghostview</code></a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Ghostview_002c-and-no-N">Ghostview, and no ‘<samp>N</samp>’</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-glyph-files">glyph files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-GLYPHFONTS_002c-overrides-P"><code>GLYPHFONTS<span class="roman">, overrides</span> P</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gnuplot"><code>gnuplot</code></a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-inclusion-fails">graphics inclusion fails</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gs-installation"><code>gs <span class="roman">installation</span></code></a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gsave_002fgrestore_002c-and-literal-PS"><code>gsave<span class="roman">/</span>grestore<span class="roman">, and literal PS</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-gsftopk"><code>gsftopk</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-G-config-command-_0028character-shifting_0029"><code>G <span class="r">config command (character shifting)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gf-files">gf files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gftopk"><code>gftopk</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Ghostscript-installation">Ghostscript installation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ghostview"><code>ghostview</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Ghostview_002c-and-no-N">Ghostview, and no ‘<samp class="samp">N</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-files">glyph files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GLYPHFONTS_002c-overrides-P"><code>GLYPHFONTS<span class="r">, overrides</span> P</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gnuplot"><code>gnuplot</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-graphics-inclusion-fails">graphics inclusion fails</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gs-installation"><code>gs <span class="r">installation</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gsave_002fgrestore_002c-and-literal-PS"><code>gsave<span class="r">/</span>grestore<span class="r">, and literal PS</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gsftopk"><code>gsftopk</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-h-config-command-_0028download-additional-header_0029"><code>h <span class="roman">config command (download additional header)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-H-config-command-_0028PostScript-header-path_0029"><code>H <span class="roman">config command (PostScript header path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Hafner_002c-Jim">Hafner, Jim</a>:</td><td> </td><td valign="top"><a href="#Color">Color</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header-file_002c-downloading">header file, downloading</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header-files_002c-defined">header files, defined</a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header-path_002c-defining">header path, defining</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header_003dfile-_005cspecial"><code>header=<var>file</var> \special</code></a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-headers-and-memory-usage">headers and memory usage</a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-headers_002c-including-from-the-command-line">headers, including from the command line</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-headers_002c-including-in-TeX">headers, including in TeX</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hints">hints</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hoffset-_0028psfile-special-option_0029"><code>hoffset <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-HP4Si-printer-and-paper-trays">HP4Si printer and paper trays</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-href"><code>href</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hscale-_0028psfile-special-option_0029"><code>hscale <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hsize-_0028psfile-special-option_0029"><code>hsize <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-html-specials"><code>html <span class="roman">specials</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-html-specials_002c-and-_002dz"><code>html <span class="roman">specials, and ‘<samp>-z</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Hungarian-umlaut">Hungarian umlaut</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hyperdvi-extensions_002c-enabling">hyperdvi extensions, enabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hypertext-and-bitmap-fonts">hypertext and bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hypertext-caveats">hypertext caveats</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hypertext-caveats-1">hypertext caveats</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hypertext-specials">hypertext specials</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hypertext-support">hypertext support</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-h-config-command-_0028download-additional-header_0029"><code>h <span class="r">config command (download additional header)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-H-config-command-_0028PostScript-header-path_0029"><code>H <span class="r">config command (PostScript header path)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Hafner_002c-Jim">Hafner, Jim</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color">Color</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-header-file_002c-downloading">header file, downloading</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-header-files_002c-defined">header files, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-header-path_002c-defining">header path, defining</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-header_003dfile-_005cspecial"><code>header=<var class="var">file</var> \special</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers-and-memory-usage">headers and memory usage</a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers_002c-including-from-the-command-line">headers, including from the command line</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers_002c-including-in-TeX">headers, including in TeX</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hints">hints</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hoffset-_0028psfile-special-option_0029"><code>hoffset <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-HP4Si-printer-and-paper-trays">HP4Si printer and paper trays</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-href"><code>href</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hscale-_0028psfile-special-option_0029"><code>hscale <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hsize-_0028psfile-special-option_0029"><code>hsize <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-html-specials"><code>html <span class="r">specials</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-html-specials_002c-and-_002dz"><code>html <span class="r">specials, and ‘<samp class="samp">-z</samp>’</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Hungarian-umlaut">Hungarian umlaut</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyperdvi-extensions_002c-enabling">hyperdvi extensions, enabling</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-and-bitmap-fonts">hypertext and bitmap fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-caveats">hypertext caveats</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-caveats-1">hypertext caveats</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-specials">hypertext specials</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-support">hypertext support</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-i-config-command-_0028pages_002fsection_0029"><code>i <span class="roman">config command (pages/section)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Illustrator_002c-workaround-for">Illustrator, workaround for</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-img"><code>img</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-including-graphics-fails">including graphics fails</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-including-headers-from-the-command-line">including headers from the command line</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-including-headers-in-TeX">including headers in TeX</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-installation-of-config_002eps">installation of <samp>config.ps</samp></a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-installation-of-PostScript-fonts">installation of PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-installation_002c-of-Dvips">installation, of Dvips</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-installing-fonts">installing fonts</a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-interaction-with-PostScript">interaction with PostScript</a>:</td><td> </td><td valign="top"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-inverted-output">inverted output</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-invoking-Dvips">invoking Dvips</a>:</td><td> </td><td valign="top"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-i-config-command-_0028pages_002fsection_0029"><code>i <span class="r">config command (pages/section)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Illustrator_002c-workaround-for">Illustrator, workaround for</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-img"><code>img</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-including-graphics-fails">including graphics fails</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-including-headers-from-the-command-line">including headers from the command line</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-including-headers-in-TeX">including headers in TeX</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installation-of-config_002eps">installation of <samp class="file">config.ps</samp></a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installation-of-PostScript-fonts">installation of PostScript fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installation_002c-of-Dvips">installation, of Dvips</a>:</td><td> </td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installing-fonts">installing fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interaction-with-PostScript">interaction with PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inverted-output">inverted output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invoking-Dvips">invoking Dvips</a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-J">J</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-j-config-command-_0028partial-font-downloading_0029"><code>j <span class="roman">config command (partial font downloading)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Japanese-font-metric-file">Japanese font metric file</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Jeffrey_002c-Alan">Jeffrey, Alan</a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-JFM-file_002c-and-virtual-font-fallback">JFM file, and virtual font fallback</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-j-config-command-_0028partial-font-downloading_0029"><code>j <span class="r">config command (partial font downloading)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Japanese-font-metric-file">Japanese font metric file</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Jeffrey_002c-Alan">Jeffrey, Alan</a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-JFM-file_002c-and-virtual-font-fallback">JFM file, and virtual font fallback</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-K">K</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-K-config-command-_0028comment-removal_0029"><code>K <span class="roman">config command (comment removal)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-kerning_002c-defined">kerning, defined</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-K-config-command-_0028comment-removal_0029"><code>K <span class="r">config command (comment removal)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning_002c-defined">kerning, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-L-config-command-_0028last-paper-size-wins_0029"><code>L <span class="roman">config command (last paper size wins)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscape-papertype">landscape papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscape_002c-as-_005cspecial"><code>landscape<span class="roman">, as <code>\special</code></span></code></a>:</td><td> </td><td valign="top"><a href="#papersize-special">‘<samp>papersize</samp>’ special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscaperotate">landscaperotate</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscaperotate-command-line-option">landscaperotate command line option</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscaperotate-config-command"><code>landscaperotate <span class="roman">config command</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscaperotate-configuration-file-command">landscaperotate configuration file command</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-last_002dresort-font-scaling_002c-with-DVIPSSIZES">last-resort font scaling, with <code>DVIPSSIZES</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-last_002dresort-scaling_002c-with-R">last-resort scaling, with <code>R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ledger-papertype">ledger papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-legal-papertype">legal papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letter-paper-size"><code>letter <span class="roman">paper size</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letter-papertype">letter papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letterhead-tray">letterhead tray</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letterSize-paper-size"><code>letterSize <span class="roman">paper size</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ligature-operations">ligature operations</a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ligature_002c-defined">ligature, defined</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LIGKERN-encoding-file-command"><code>LIGKERN <span class="roman">encoding file command</span></code></a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lines-in-figures_002c-wrong-width">lines in figures, wrong width</a>:</td><td> </td><td valign="top"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-links_002c-hypertext">links, hypertext</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-literal-headers">literal headers</a>:</td><td> </td><td valign="top"><a href="#Literal-headers">Literal headers</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-literal-PostScript_002c-examples">literal PostScript, examples</a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-literal-PostScript_002c-using">literal PostScript, using</a>:</td><td> </td><td valign="top"><a href="#Literal-PS">Literal PS</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-llx-_0028psfile-special-option_0029"><code>llx <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lly-_0028psfile-special-option_0029"><code>lly <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-long-documents-not-printing">long documents not printing</a>:</td><td> </td><td valign="top"><a href="#Long-documents-fail">Long documents fail</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-low-characters_002c-shifting">low characters, shifting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lpr-spooler_002c-MS_002dDOS-emulation">lpr spooler, MS-DOS emulation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-L-config-command-_0028last-paper-size-wins_0029"><code>L <span class="r">config command (last paper size wins)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape-papertype">landscape papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape_002c-as-_005cspecial"><code>landscape<span class="r">, as <code class="code">\special</code></span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate">landscaperotate</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-command-line-option">landscaperotate command line option</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-config-command"><code>landscaperotate <span class="r">config command</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-configuration-file-command">landscaperotate configuration file command</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002dresort-font-scaling_002c-with-DVIPSSIZES">last-resort font scaling, with <code class="code">DVIPSSIZES</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002dresort-scaling_002c-with-R">last-resort scaling, with <code class="code">R</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ledger-papertype">ledger papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-legal-papertype">legal papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-letter-paper-size"><code>letter <span class="r">paper size</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-letter-papertype">letter papertype</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-letterhead-tray">letterhead tray</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-letterSize-paper-size"><code>letterSize <span class="r">paper size</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligature-operations">ligature operations</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligature_002c-defined">ligature, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LIGKERN-encoding-file-command"><code>LIGKERN <span class="r">encoding file command</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines-in-figures_002c-wrong-width">lines in figures, wrong width</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-links_002c-hypertext">links, hypertext</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-headers">literal headers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-PostScript_002c-examples">literal PostScript, examples</a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-PostScript_002c-using">literal PostScript, using</a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-PS">Literal PS</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-llx-_0028psfile-special-option_0029"><code>llx <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lly-_0028psfile-special-option_0029"><code>lly <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-long-documents-not-printing">long documents not printing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Long-documents-fail">Long documents fail</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-low-characters_002c-shifting">low characters, shifting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lpr-spooler_002c-MS_002dDOS-emulation">lpr spooler, MS-DOS emulation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-m-config-command-_0028available-memory_0029"><code>m <span class="roman">config command (available memory)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-M-config-command-_0028mf-mode_0029"><code>M <span class="roman">config command (mf mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macros-for-color">macros for color</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macros-for-epsf-inclusion">macros for epsf inclusion</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macros-for-epsf-inclusion-1">macros for epsf inclusion</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-magnification_002c-DVI">magnification, DVI</a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-magnification_002c-vertical">magnification, vertical</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mailcap-and-hypertext"><code>mailcap <span class="roman">and hypertext</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-manual-feed">manual feed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-maxdrift">maxdrift</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-maximum-pages-printed">maximum pages printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-media">media</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-memory-available">memory available</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-memory-of-printer-exhausted">memory of printer exhausted</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-memory-usage_002c-and-headers">memory usage, and headers</a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-memory_002c-conserving">memory, conserving</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-memory_002c-used-by-PostScript-fonts">memory, used by PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Metafont-ligature-operations">Metafont ligature operations</a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Metafont-source-files">Metafont source files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-metric-files">metric files</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Minion-typeface-family">Minion typeface family</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-missfont_002elog"><code>missfont.log</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-MISSFONT_005fLOG"><code>MISSFONT_LOG</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Mitsubishi-Shinko-CHC_002dS446i-printer">Mitsubishi Shinko CHC-S446i printer</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mkdvipspapers"><code>mkdvipspapers</code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="roman">, avoiding</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mktexpk_002c-changing-name"><code>mktexpk<span class="roman">, changing name</span></code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mode-name_002c-specifying">mode name, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mtpk"><code>mtpk</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multiple-master-fonts">multiple master fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multiple-output-files">multiple output files</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multiple-paper-trays">multiple paper trays</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Murphy_002c-Tim">Murphy, Tim</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-m-config-command-_0028available-memory_0029"><code>m <span class="r">config command (available memory)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-M-config-command-_0028mf-mode_0029"><code>M <span class="r">config command (mf mode)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-color">macros for color</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-epsf-inclusion">macros for epsf inclusion</a>:</td><td> </td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-epsf-inclusion-1">macros for epsf inclusion</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-DVI">magnification, DVI</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-vertical">magnification, vertical</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mailcap-and-hypertext"><code>mailcap <span class="r">and hypertext</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manual-feed">manual feed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-maxdrift">maxdrift</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-maximum-pages-printed">maximum pages printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-media">media</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-available">memory available</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-of-printer-exhausted">memory of printer exhausted</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-usage_002c-and-headers">memory usage, and headers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-memory_002c-conserving">memory, conserving</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-memory_002c-used-by-PostScript-fonts">memory, used by PostScript fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-ligature-operations">Metafont ligature operations</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-source-files">Metafont source files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-metric-files">metric files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Minion-typeface-family">Minion typeface family</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-missfont_002elog"><code>missfont.log</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MISSFONT_005fLOG"><code>MISSFONT_LOG</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Mitsubishi-Shinko-CHC_002dS446i-printer">Mitsubishi Shinko CHC-S446i printer</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mkdvipspapers"><code>mkdvipspapers</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="r">, avoiding</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk_002c-changing-name"><code>mktexpk<span class="r">, changing name</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode-name_002c-specifying">mode name, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mtpk"><code>mtpk</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-master-fonts">multiple master fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-output-files">multiple output files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-paper-trays">multiple paper trays</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Murphy_002c-Tim">Murphy, Tim</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-N--config-command-_0028disable-EPS_0029"><code>N <span class="roman"> config command (disable EPS)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-name"><code>name</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-narrow-fonts">narrow fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-no-output-at-all">no output at all</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-non_002dprinting-characters_002c-shifting">non-printing characters, shifting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-non_002dresident-fonts">non-resident fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-nopaper_002c-paper-format-for-_002dt"><code>nopaper<span class="roman">, paper format for ‘<samp>-t</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-N-config-command-_0028disable-EPS_0029"><code>N <span class="r"> config command (disable EPS)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name"><code>name</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-narrow-fonts">narrow fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no-output-at-all">no output at all</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dprinting-characters_002c-shifting">non-printing characters, shifting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dresident-fonts">non-resident fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nopaper_002c-paper-format-for-_002dt"><code>nopaper<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-o-config-command-_0028output-destination_0029"><code>o <span class="roman">config command (output destination)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-O-config-command-_0028page-offsets_0029"><code>O <span class="roman">config command (page offsets)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-oblique-fonts">oblique fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-octal-character-codes">octal character codes</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-odd-pages-only">odd pages only</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-offset-pages">offset pages</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Omega-extensions">Omega extensions</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-option_002c-details-of">option, details of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-debugging">options, debugging</a>:</td><td> </td><td valign="top"><a href="#Debug-options">Debug options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-Dvips">options, Dvips</a>:</td><td> </td><td valign="top"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-reading-from-standard-input">options, reading from standard input</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-summary">options, summary</a>:</td><td> </td><td valign="top"><a href="#Option-summary">Option summary</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-to-Afm2tfm">options, to Afm2tfm</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-outline-fonts">outline fonts</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-outline-fonts-1">outline fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output-file_002c-sectioning-of">output file, sectioning of</a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output-file_002c-setting">output file, setting</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output-files_002c-multiple">output files, multiple</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output-title_002c-specifying">output title, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output_002c-inverted">output, inverted</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output_002c-none">output, none</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-output_002c-too-small">output, too small</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-o-config-command-_0028output-destination_0029"><code>o <span class="r">config command (output destination)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-O-config-command-_0028page-offsets_0029"><code>O <span class="r">config command (page offsets)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-oblique-fonts">oblique fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-octal-character-codes">octal character codes</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-odd-pages-only">odd pages only</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-offset-pages">offset pages</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Omega-extensions">Omega extensions</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-option_002c-details-of">option, details of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-debugging">options, debugging</a>:</td><td> </td><td class="printindex-index-section"><a href="#Debug-options">Debug options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-Dvips">options, Dvips</a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-reading-from-standard-input">options, reading from standard input</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-summary">options, summary</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-summary">Option summary</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-to-Afm2tfm">options, to Afm2tfm</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-outline-fonts">outline fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-outline-fonts-1">outline fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-file_002c-sectioning-of">output file, sectioning of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-file_002c-setting">output file, setting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-files_002c-multiple">output files, multiple</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-title_002c-specifying">output title, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-inverted">output, inverted</a>:</td><td> </td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-none">output, none</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-too-small">output, too small</a>:</td><td> </td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="roman">config command (font aliases)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="roman">config command (PK path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-numbers_002c-multiple-repetitions-of">page numbers, multiple repetitions of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pages_002c-maximum-printed">pages, maximum printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PaintType"><code>PaintType</code></a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Pantone-colors">Pantone colors</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paper-size-configuration-file-command">paper size configuration file command</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paper-size_002c-default">paper size, default</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paper-size_002c-general">paper size, general</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paper-trays">paper trays</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paper-type">paper type</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-papersize-special"><code>papersize <span class="roman">special</span></code></a>:</td><td> </td><td valign="top"><a href="#papersize-special">‘<samp>papersize</samp>’ special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-papersize-special_002c-and-no-_002dt">papersize special, and no ‘<samp>-t</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-papersize-special_002c-first-vs_002e-last">‘<samp>papersize</samp>’ special, first vs. last</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-partial-font-downloading">partial font downloading</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-files_002c-font-quality">PDF files, font quality</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-files_002c-making">PDF files, making</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-files_002c-making-1">PDF files, making</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-files_002c-option-for">PDF files, option for</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pdfmark"><code>pdfmark</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pfa-files">pfa files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pfb-files">pfb files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pfb-files_002c-automatically-unpacked">pfb files, automatically unpacked</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pfm-files">pfm files</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Phaser-printer_002c-used-for-color-calibration">Phaser printer, used for color calibration</a>:</td><td> </td><td valign="top"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-physical-page-number_002c-and-_002dl">physical page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-physical-page-number_002c-and-_002dp">physical page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-physical-page-number_002c-and-bop_002dhook">physical page number, and <code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pipes_002c-not-readable">pipes, not readable</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pk-files">pk files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PKFONTS_002c-overrides-P"><code>PKFONTS<span class="roman">, overrides</span> P</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-plotfile_002c-ps-subspecial"><code>plotfile<span class="roman">, ‘<samp>ps</samp>’ subspecial</span></code></a>:</td><td> </td><td valign="top"><a href="#ps-special">ps special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pltotf"><code>pltotf</code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-popen-for-output"><code>popen <span class="roman">for output</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-portrait-orientation_002c-defined">portrait orientation, defined</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-positioning-accuracy">positioning accuracy</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-post-code-after-headers"><code>post <span class="roman">code after headers</span></code></a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-code_002c-literal">PostScript code, literal</a>:</td><td> </td><td valign="top"><a href="#Literal-PS">Literal PS</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-encoding">PostScript encoding</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-encoding_002c-changing">PostScript encoding, changing</a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-font-alias-file">PostScript font alias file</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-font-alias-file-1">PostScript font alias file</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-fonts">PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#PostScript-fonts">PostScript fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-fonts_002c-installing">PostScript fonts, installing</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-fonts_002c-on-your-system">PostScript fonts, on your system</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-header-files">PostScript header files</a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-hooks">PostScript hooks</a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-interaction">PostScript interaction</a>:</td><td> </td><td valign="top"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-previewers">PostScript previewers</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PostScript-units">PostScript units</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PowerPage-PostScript-implementation">PowerPage PostScript implementation</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pre-code-before-headers"><code>pre <span class="roman">code before headers</span></code></a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-previewing-Dvips-output">previewing Dvips output</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PRINTER"><code>PRINTER</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-configuration">printer configuration</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-configuration-file_002c-prototype">printer configuration file, prototype</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-errors">printer errors</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-memory">printer memory</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-memory-exhausted">printer memory exhausted</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer-offset">printer offset</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PRINTER_002c-and-config-file-searching"><code>PRINTER<span class="roman">, and config file searching</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PRINTER_002c-avoided-with-_002df"><code>PRINTER<span class="roman">, avoided with ‘<samp>-f</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-printer_002c-driving-directly">printer, driving directly</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-problems">problems</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-property-list-files">property list files</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-prototype-printer-configuration-file">prototype printer configuration file</a>:</td><td> </td><td valign="top"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ps-special"><code>ps <span class="roman">special</span></code></a>:</td><td> </td><td valign="top"><a href="#ps-special">ps special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psfile-special"><code>psfile <span class="roman">special</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psfonts_002emap"><code>psfonts.map</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psfonts_002emap-1"><code>psfonts.map</code></a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psfonts_002emap-2"><code>psfonts.map</code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psheaderdir"><code>psheaderdir</code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-psi-character-missing">psi character missing</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pstopk"><code>pstopk</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pTeX-extensions">pTeX extensions</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pTeX-extensions-1">pTeX extensions</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ptex-JFM"><code>ptex <span class="roman">JFM</span></code></a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="r">config command (font aliases)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="r">config command (PK path)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-numbers_002c-multiple-repetitions-of">page numbers, multiple repetitions of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-range">page range</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pages_002c-maximum-printed">pages, maximum printed</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PaintType"><code>PaintType</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Pantone-colors">Pantone colors</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size-configuration-file-command">paper size configuration file command</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size_002c-default">paper size, default</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size_002c-general">paper size, general</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-trays">paper trays</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-type">paper type</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special"><code>papersize <span class="r">special</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special_002c-and-no-_002dt">papersize special, and no ‘<samp class="samp">-t</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special_002c-first-vs_002e-last">‘<samp class="samp">papersize</samp>’ special, first vs. last</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-partial-font-downloading">partial font downloading</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-font-quality">PDF files, font quality</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-making">PDF files, making</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-making-1">PDF files, making</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-option-for">PDF files, option for</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pdfmark"><code>pdfmark</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pfa-files">pfa files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pfb-files">pfb files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pfb-files_002c-automatically-unpacked">pfb files, automatically unpacked</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pfm-files">pfm files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Phaser-printer_002c-used-for-color-calibration">Phaser printer, used for color calibration</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dl">physical page number, and ‘<samp class="samp">-l</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dp">physical page number, and ‘<samp class="samp">-p</samp>’</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-bop_002dhook">physical page number, and <code class="code">bop-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pipes_002c-not-readable">pipes, not readable</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pk-files">pk files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PKFONTS_002c-overrides-P"><code>PKFONTS<span class="r">, overrides</span> P</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-plotfile_002c-ps-subspecial"><code>plotfile<span class="r">, ‘<samp class="samp">ps</samp>’ subspecial</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pltotf"><code>pltotf</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-popen-for-output"><code>popen <span class="r">for output</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-portrait-orientation_002c-defined">portrait orientation, defined</a>:</td><td> </td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-positioning-accuracy">positioning accuracy</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-post-code-after-headers"><code>post <span class="r">code after headers</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-code_002c-literal">PostScript code, literal</a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-PS">Literal PS</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-encoding">PostScript encoding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-encoding_002c-changing">PostScript encoding, changing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-font-alias-file">PostScript font alias file</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-font-alias-file-1">PostScript font alias file</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts">PostScript fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-fonts">PostScript fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts_002c-installing">PostScript fonts, installing</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts_002c-on-your-system">PostScript fonts, on your system</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-header-files">PostScript header files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-hooks">PostScript hooks</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-interaction">PostScript interaction</a>:</td><td> </td><td class="printindex-index-section"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-previewers">PostScript previewers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-units">PostScript units</a>:</td><td> </td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PowerPage-PostScript-implementation">PowerPage PostScript implementation</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pre-code-before-headers"><code>pre <span class="r">code before headers</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-previewing-Dvips-output">previewing Dvips output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER"><code>PRINTER</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-configuration">printer configuration</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-configuration-file_002c-prototype">printer configuration file, prototype</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-errors">printer errors</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-memory">printer memory</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-memory-exhausted">printer memory exhausted</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-offset">printer offset</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER_002c-and-config-file-searching"><code>PRINTER<span class="r">, and config file searching</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER_002c-avoided-with-_002df"><code>PRINTER<span class="r">, avoided with ‘<samp class="samp">-f</samp>’</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printer_002c-driving-directly">printer, driving directly</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-problems">problems</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-property-list-files">property list files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-prototype-printer-configuration-file">prototype printer configuration file</a>:</td><td> </td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-special"><code>ps <span class="r">special</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psfile-special"><code>psfile <span class="r">special</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap"><code>psfonts.map</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap-1"><code>psfonts.map</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap-2"><code>psfonts.map</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psheaderdir"><code>psheaderdir</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psi-character-missing">psi character missing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pstopk"><code>pstopk</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pTeX-extensions">pTeX extensions</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pTeX-extensions-1">pTeX extensions</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ptex-JFM"><code>ptex <span class="r">JFM</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-q-config-command-_0028quiet_0029"><code>q <span class="roman">config command (quiet)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Q-config-command-_0028quiet_0029"><code>Q <span class="roman">config command (quiet)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-q-config-command-_0028quiet_0029"><code>q <span class="r">config command (quiet)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Q-config-command-_0028quiet_0029"><code>Q <span class="r">config command (quiet)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-R-config-command-_0028fallback-resolution_0029"><code>R <span class="roman">config command (fallback resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="roman">config command (page reversal)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-raw-tfm-files">raw tfm files</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reencode_002f_002a_002eenc"><code>reencode/*.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reencoding">reencoding</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reencoding-PostScript-fonts">reencoding PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-registered-character_002c-accessing"><code>registered <span class="roman">character, accessing</span></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-remapping">remapping</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resident-fonts_002c-different-in-different-printers">resident fonts, different in different printers</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resident-fonts_002c-different-in-different-printers-1">resident fonts, different in different printers</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resolution">resolution</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resolution-1">resolution</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resolution_002c-setting">resolution, setting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reverse-pagination">reverse pagination</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rhi-_0028psfile-special-option_0029"><code>rhi <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Rokicki_002c-Tomas">Rokicki, Tomas</a>:</td><td> </td><td valign="top"><a href="#Why-Dvips">Why Dvips</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rotate_002etex"><code>rotate.tex</code></a>:</td><td> </td><td valign="top"><a href="#ps-special">ps special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rwi-_0028psfile-special-option_0029"><code>rwi <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-R-config-command-_0028fallback-resolution_0029"><code>R <span class="r">config command (fallback resolution)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="r">config command (page reversal)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-raw-tfm-files">raw tfm files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reencode_002f_002a_002eenc"><code>reencode/*.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reencoding">reencoding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reencoding-PostScript-fonts">reencoding PostScript fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registered-character_002c-accessing"><code>registered <span class="r">character, accessing</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-remapping">remapping</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resident-fonts_002c-different-in-different-printers">resident fonts, different in different printers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resident-fonts_002c-different-in-different-printers-1">resident fonts, different in different printers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution">resolution</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution-1">resolution</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-setting">resolution, setting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reverse-pagination">reverse pagination</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rhi-_0028psfile-special-option_0029"><code>rhi <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Rokicki_002c-Tomas">Rokicki, Tomas</a>:</td><td> </td><td class="printindex-index-section"><a href="#Why-Dvips">Why Dvips</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rotate_002etex"><code>rotate.tex</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rwi-_0028psfile-special-option_0029"><code>rwi <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-s-config-command-_0028global-save_002frestore_0029"><code>s <span class="roman">config command (global save/restore)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-S-config-command-_0028pict-path_0029"><code>S <span class="roman">config command (pict path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-save_002frestore_002c-and-inverted-output">save/restore, and inverted output</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-save_002frestore_002c-and-literal-PS"><code>save<span class="roman">/</span>restore<span class="roman">, and literal PS</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-save_002frestore_002c-and-specials">save/restore, and specials</a>:</td><td> </td><td valign="top"><a href="#ps-special">ps special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-save_002frestore_002c-generating-global">save/restore, generating global</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scaleunit"><code>scaleunit</code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scaling-of-figures">scaling of figures</a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scaling-small-caps">scaling small caps</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Scandinavian-A-ring">Scandinavian A ring</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-screen-frequencies_002c-setting">screen frequencies, setting</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-SDict"><code>SDict</code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-SDict-dictionary"><code>SDict <span class="roman">dictionary</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-headers">Literal headers</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-searching-config-files_002c-order-of">searching config files, order of</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sections-of-output-file_002c-and-memory">sections of output file, and memory</a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sections-output_002c-in-separate-files">sections output, in separate files</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-security">security</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-shell-command-execution_002c-disabling">shell command execution, disabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-shell-escape_002c-in-config-file">shell escape, in config file</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Shinko-CHC_002dS446i-printer">Shinko CHC-S446i printer</a>:</td><td> </td><td valign="top"><a href="#No-output">No output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-show-PostScript-operator"><code>show <span class="roman">PostScript operator</span></code></a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-silent-operation">silent operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-simplex-mode-on-duplex-printers">simplex mode on duplex printers</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-slanted-fonts">slanted fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-slanted-fonts_002c-making">slanted fonts, making</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-SlantFont"><code>SlantFont</code></a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-small-caps-fonts">small caps fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Smith_002c-Arthur">Smith, Arthur</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spaces_002c-dropped-trailing">spaces, dropped trailing</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-specials_002c-hypertext">specials, hypertext</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-splines">splines</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spooler_002c-lacking">spooler, lacking</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spooling-to-lpr-on-MS_002dDOS">spooling to lpr on MS-DOS</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-I_002fO">standard I/O</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-standard-PostScript_002c-required-by-Ghostview">standard PostScript, required by Ghostview</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-start_002dhook"><code>start-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-structured-comments">structured comments</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-system-in-config-file"><code>system <span class="roman">in config file</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-s-config-command-_0028global-save_002frestore_0029"><code>s <span class="r">config command (global save/restore)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-S-config-command-_0028pict-path_0029"><code>S <span class="r">config command (pict path)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-inverted-output">save/restore, and inverted output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-literal-PS"><code>save<span class="r">/</span>restore<span class="r">, and literal PS</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-specials">save/restore, and specials</a>:</td><td> </td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-generating-global">save/restore, generating global</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaleunit"><code>scaleunit</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-of-figures">scaling of figures</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-small-caps">scaling small caps</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Scandinavian-A-ring">Scandinavian A ring</a>:</td><td> </td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-screen-frequencies_002c-setting">screen frequencies, setting</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SDict"><code>SDict</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SDict-dictionary"><code>SDict <span class="r">dictionary</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-searching-config-files_002c-order-of">searching config files, order of</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sections-of-output-file_002c-and-memory">sections of output file, and memory</a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sections-output_002c-in-separate-files">sections output, in separate files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-security">security</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-command-execution_002c-disabling">shell command execution, disabling</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-escape_002c-in-config-file">shell escape, in config file</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Shinko-CHC_002dS446i-printer">Shinko CHC-S446i printer</a>:</td><td> </td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-show-PostScript-operator"><code>show <span class="r">PostScript operator</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-silent-operation">silent operation</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-simplex-mode-on-duplex-printers">simplex mode on duplex printers</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-slanted-fonts">slanted fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-slanted-fonts_002c-making">slanted fonts, making</a>:</td><td> </td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SlantFont"><code>SlantFont</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-small-caps-fonts">small caps fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Smith_002c-Arthur">Smith, Arthur</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spaces_002c-dropped-trailing">spaces, dropped trailing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-specials_002c-hypertext">specials, hypertext</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-splines">splines</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spooler_002c-lacking">spooler, lacking</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spooling-to-lpr-on-MS_002dDOS">spooling to lpr on MS-DOS</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-I_002fO">standard I/O</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-PostScript_002c-required-by-Ghostview">standard PostScript, required by Ghostview</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-start_002dhook"><code>start-hook</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-structured-comments">structured comments</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-system-in-config-file"><code>system <span class="r">in config file</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-T-config-command-_0028TFM-path_0029"><code>T <span class="roman">config command (TFM path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration">Tektronix Phaser printer, used for color calibration</a>:</td><td> </td><td valign="top"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-testpage_002etex"><code>testpage.tex</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TeX-encoding_002c-changing">TeX encoding, changing</a>:</td><td> </td><td valign="top"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TeX_002c-including-headers-in">TeX, including headers in</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXCONFIG"><code>TEXCONFIG</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXFONTS_002c-overrides-P"><code>TEXFONTS<span class="roman">, overrides</span> P</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXFONTS_002c-overrides-T"><code>TEXFONTS<span class="roman">, overrides</span> T</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXINPUTS_002c-overrides-S"><code>TEXINPUTS<span class="roman">, overrides</span> S</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-texmext_002eenc"><code>texmext.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXMFOUTPUT"><code>TEXMFOUTPUT</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-texmital_002eenc"><code>texmital.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-texmsym_002eenc"><code>texmsym.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-texmsym_002eenc-1"><code>texmsym.enc</code></a>:</td><td> </td><td valign="top"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXPICTS"><code>TEXPICTS</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXPICTS_002c-overrides-S"><code>TEXPICTS<span class="roman">, overrides</span> S</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXPKS_002c-overrides-P"><code>TEXPKS<span class="roman">, overrides</span> P</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TEXSIZES_002c-overrides-R"><code>TEXSIZES<span class="roman">, overrides</span> R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text-in-figures_002c-chopped-off">text in figures, chopped off</a>:</td><td> </td><td valign="top"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tfm-files">tfm files</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TFMFONTS_002c-overrides-T"><code>TFMFONTS<span class="roman">, overrides</span> T</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tftopl"><code>tftopl</code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Theisen_002c-Tim">Theisen, Tim</a>:</td><td> </td><td valign="top"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tight-bounding-box_002c-finding">tight bounding box, finding</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-title_002c-specifying">title, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-too_002dsmall-output">too-small output</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-trademark-character_002c-accessing"><code>trademark <span class="roman">character, accessing</span></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-trailing-spaces_002c-dropped">trailing spaces, dropped</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TranScript">TranScript</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-transforming-downloaded-fonts">transforming downloaded fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-trouble">trouble</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Type-1-fonts">Type 1 fonts</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typesetting-in-PostScript">typesetting in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-T-config-command-_0028TFM-path_0029"><code>T <span class="r">config command (TFM path)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration">Tektronix Phaser printer, used for color calibration</a>:</td><td> </td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-testpage_002etex"><code>testpage.tex</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-encoding_002c-changing">TeX encoding, changing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-including-headers-in">TeX, including headers in</a>:</td><td> </td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXCONFIG"><code>TEXCONFIG</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS_002c-overrides-P"><code>TEXFONTS<span class="r">, overrides</span> P</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS_002c-overrides-T"><code>TEXFONTS<span class="r">, overrides</span> T</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXINPUTS_002c-overrides-S"><code>TEXINPUTS<span class="r">, overrides</span> S</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-texmext_002eenc"><code>texmext.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFOUTPUT"><code>TEXMFOUTPUT</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-texmital_002eenc"><code>texmital.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-texmsym_002eenc"><code>texmsym.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-texmsym_002eenc-1"><code>texmsym.enc</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPICTS"><code>TEXPICTS</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPICTS_002c-overrides-S"><code>TEXPICTS<span class="r">, overrides</span> S</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPKS_002c-overrides-P"><code>TEXPKS<span class="r">, overrides</span> P</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXSIZES_002c-overrides-R"><code>TEXSIZES<span class="r">, overrides</span> R</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-in-figures_002c-chopped-off">text in figures, chopped off</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tfm-files">tfm files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TFMFONTS_002c-overrides-T"><code>TFMFONTS<span class="r">, overrides</span> T</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tftopl"><code>tftopl</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Theisen_002c-Tim">Theisen, Tim</a>:</td><td> </td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tight-bounding-box_002c-finding">tight bounding box, finding</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-title_002c-specifying">title, specifying</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-too_002dsmall-output">too-small output</a>:</td><td> </td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trademark-character_002c-accessing"><code>trademark <span class="r">character, accessing</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-spaces_002c-dropped">trailing spaces, dropped</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TranScript">TranScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transforming-downloaded-fonts">transforming downloaded fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trouble">trouble</a>:</td><td> </td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Type-1-fonts">Type 1 fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-typesetting-in-PostScript">typesetting in PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-U">U</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-U-config-command-_0028Xerox-4045_0029"><code>U <span class="roman">config command (Xerox 4045)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-uncollated-copies">uncollated copies</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-uncompressing-PostScript">uncompressing PostScript</a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-uniform-resource-locator">uniform resource locator</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-unknown_002c-paper-format-for-_002dt"><code>unknown<span class="roman">, paper format for ‘<samp>-t</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#papersize-special">‘<samp>papersize</samp>’ special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-unknown_002c-paper-format-for-_002dt-1"><code>unknown<span class="roman">, paper format for ‘<samp>-t</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-uptex-JFM"><code>uptex <span class="roman">JFM</span></code></a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-URL_002c-definition">URL, definition</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-URL_002c-extended-for-TeX">URL, extended for TeX</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-urx-_0028psfile-special-option_0029"><code>urx <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ury-_0028psfile-special-option_0029"><code>ury <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-usage_002c-basic">usage, basic</a>:</td><td> </td><td valign="top"><a href="#Basic-usage">Basic usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-user_002ddefinable-colors">user-definable colors</a>:</td><td> </td><td valign="top"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-userdict_002c-and-dictionary-files"><code>userdict<span class="roman">, and dictionary files</span></code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-userdict_002c-used-for-header-files">userdict<span class="roman">, used for header files</span></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-U-config-command-_0028Xerox-4045_0029"><code>U <span class="r">config command (Xerox 4045)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uncollated-copies">uncollated copies</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uncompressing-PostScript">uncompressing PostScript</a>:</td><td> </td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uniform-resource-locator">uniform resource locator</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unknown_002c-paper-format-for-_002dt"><code>unknown<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unknown_002c-paper-format-for-_002dt-1"><code>unknown<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uptex-JFM"><code>uptex <span class="r">JFM</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-URL_002c-definition">URL, definition</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-URL_002c-extended-for-TeX">URL, extended for TeX</a>:</td><td> </td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-urx-_0028psfile-special-option_0029"><code>urx <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ury-_0028psfile-special-option_0029"><code>ury <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-usage_002c-basic">usage, basic</a>:</td><td> </td><td class="printindex-index-section"><a href="#Basic-usage">Basic usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-user_002ddefinable-colors">user-definable colors</a>:</td><td> </td><td class="printindex-index-section"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-userdict_002c-and-dictionary-files"><code>userdict<span class="r">, and dictionary files</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-userdict_002c-used-for-header-files">userdict<span class="r">, used for header files</span></a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-V">V</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-V-config-command-_0028vf-path_0029"><code>V <span class="roman">config command (vf path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-verbose-EPSF-processing">verbose EPSF processing</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vf-files">vf files</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-virtual-font-expansion">virtual font expansion</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-virtual-font-path">virtual font path</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-virtual-fonts">virtual fonts</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-virtual-fonts_002c-creating">virtual fonts, creating</a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-VM-exhausted">VM exhausted</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-VMusage"><code>VMusage</code></a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-voffset-_0028psfile-special-option_0029"><code>voffset <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vpl-files">vpl files</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vptovf"><code>vptovf</code></a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vscale-_0028psfile-special-option_0029"><code>vscale <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vsize-_0028psfile-special-option_0029"><code>vsize <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-V-config-command-_0028vf-path_0029"><code>V <span class="r">config command (vf path)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-verbose-EPSF-processing">verbose EPSF processing</a>:</td><td> </td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vf-files">vf files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-font-expansion">virtual font expansion</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-font-path">virtual font path</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-fonts">virtual fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-fonts_002c-creating">virtual fonts, creating</a>:</td><td> </td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-VM-exhausted">VM exhausted</a>:</td><td> </td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-VMusage"><code>VMusage</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-voffset-_0028psfile-special-option_0029"><code>voffset <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vpl-files">vpl files</a>:</td><td> </td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vptovf"><code>vptovf</code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vscale-_0028psfile-special-option_0029"><code>vscale <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vsize-_0028psfile-special-option_0029"><code>vsize <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-W-config-command-_0028emit-warning_0029"><code>W <span class="roman">config command (emit warning)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-warning-messages_002c-defining">warning messages, defining</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-whole-font-downloading">whole font downloading</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-wide-fonts">wide fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-W-config-command-_0028emit-warning_0029"><code>W <span class="r">config command (emit warning)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warning-messages_002c-defining">warning messages, defining</a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-whole-font-downloading">whole font downloading</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-wide-fonts">wide fonts</a>:</td><td> </td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-X">X</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-X-config-command-_0028horizontal-resolution_0029"><code>X <span class="roman">config command (horizontal resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Xerox-4045">Xerox 4045</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-X-config-command-_0028horizontal-resolution_0029"><code>X <span class="r">config command (horizontal resolution)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Xerox-4045">Xerox 4045</a>:</td><td> </td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-Y">Y</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Y-config-command-_0028vertical-resolution_0029"><code>Y <span class="roman">config command (vertical resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Y-config-command-_0028vertical-resolution_0029"><code>Y <span class="r">config command (vertical resolution)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="roman">config command (compress fonts)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="roman">config command (secure mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-zero-dimensions-and-setting-paper-size">zero dimensions and setting paper size</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="r">config command (compress fonts)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="r">config command (secure mode)</span></code></a>:</td><td> </td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-zero-dimensions-and-setting-paper-size">zero dimensions and setting paper size</a>:</td><td> </td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
-<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a>
+<table class="cp-letters-footer-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>!</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-2"><b>"</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>"</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-3"><b>%</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>%</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-4"><b>(</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>(</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-5"><b>+</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>+</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-6"><b>-</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>-</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-7"><b>.</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>.</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-8"><b>/</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>/</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>6</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>8</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-11"><b><</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b><</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-12"><b>=</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>=</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-13"><b>@</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>@</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-14"><b>\</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-14"><b>\</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-15"><b>|</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_symbol-15"><b>|</b></a>
<br>
-<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
-<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
-<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
-<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
-<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
-<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
-<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
-<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
-<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
-<a class="summary-letter" href="#Index_cp_letter-J"><b>J</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a>
-<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
-<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
-<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
-<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
-<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
-<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
-<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
-<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
-<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
-<a class="summary-letter" href="#Index_cp_letter-U"><b>U</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
-<a class="summary-letter" href="#Index_cp_letter-V"><b>V</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
-<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
-<a class="summary-letter" href="#Index_cp_letter-X"><b>X</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Y"><b>Y</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a>
-<a class="summary-letter" href="#Index_cp_letter-Z"><b>Z</b></a>
+<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
</td></tr></table>
+</div>
</div>
</div>
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.pdf
===================================================================
(Binary files differ)
Added: trunk/Master/texmf-dist/doc/etex/base/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/etex/base/ChangeLog (rev 0)
+++ trunk/Master/texmf-dist/doc/etex/base/ChangeLog 2023-02-26 21:56:36 UTC (rev 66203)
@@ -0,0 +1,619 @@
+2022-03-21 Karl Berry <karl at tug.org>
+
+ * TL'22 release.
+
+2022-01-10 Karl Berry <karl at freefriends.org>
+
+ * am/etex.am: do not silence tangle-sh.
+
+2021-03-23 Karl Berry <karl at tug.org>
+
+ * TL'21.
+
+2021-02-22 Phelype Oleinik <phe.h.o1 at gmail.com>
+
+ * etex.ch: avoid "expansion depth" overflow with \numexpr.
+
+2021-02-13 Karl Berry <karl at freefriends.org>
+
+ * am/etex.am (etex_ch_srcs): adjust for split enctex changes.
+
+2019-12-10 Hironori Kitagawa <h_kitagawa2001 at yahoo.co.jp>
+
+ * am/etex.am (etex_CPPFLAGS): append $(ZLIB_INCLUDES).
+ (etex_LDADD): include $(ZLIB_LIBS.)
+ (etex_DEPENDENCIES): define as $(ZLIB_DEPEND)
+ (etex_web_srcs): include zlib-fmt.ch.
+
+2018-03-24 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+ Hironori Kitagawa <h_kitagawa2001 at yahoo.co.jp>
+
+ * tex.ech: Recover the right \lastnodetype initialization
+ value ignored by tex.ch.
+
+2016-04-06 Karl Berry <karl at tug.org>
+
+ * etexextra.h (COPYRIGHT_HOLDER): add et al. since
+ peb passed away in 2015 so can't hold later copyrights.
+
+2015-09-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etriptest.test: Also check tripos.tex and etrip.out.
+
+2015-07-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Fixed a stupid typo that caused 'make dist' to
+ create e-TeX.
+
+2015-07-10 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etriptest (removed): Renamed ...
+ * etriptest.test (new): ... into this.
+ * am/etex.am: Better dependencies for 'make check'.
+
+2015-06-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Use $(tie_c) and $(tie_m).
+
+2015-04-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etrip.diffs: Updated for TL 2015.
+
+2014-12-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etriptest: Complain early if (e)trip.fmt is not created.
+ Inspired by report from vvv, tlbuild 14 Jun 2011 10:25:47.
+
+2014-05-02 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etrip.diffs: Updated for TL14.
+
+2014-01-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etrip.{diffs,fot,log,tex,typ}, etrip/etripin.log:
+ Updated for e-TeX 3.14159265.
+
+2014-01-21 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etexextra.h: Adapt to TeX Version 3.14159265.
+
+2014-01-20 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ TeX tuneup of 2014.
+ * etex.ch, tex.ch0, tex.ech: Adapt to TeX Version 3.14159265.
+
+2014-01-17 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip.test (removed): Renamed ...
+ * etriptest (new): ... into this.
+ * am/etex.am: Adapted.
+
+2013-11-21 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Enable hyphenation of text between \beginL and \endL or
+ between \beginR and \endR.
+ * etrip/etrip.diffs, etrip/etrip.fot, etrip/etrip.log,
+ etrip/etrip.tex, etrip/etrip.typ, etrip/etripin.log:
+ Version 2.6 [2013-11-21] for TL 2014.
+
+2013-04-09 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etrip.diffs, etrip/etrip.fot, etrip/etrip.typ,
+ etrip/etripin.log: Update for TL 2013.
+
+2013-03-08 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Towards better handling of right-to-left text.
+
+2013-03-04 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Better rule for etex_version.h.
+
+2013-03-01 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch, etex_version.h: Version 2.6.
+ Better handling of right-to-left text.
+ * etrip/etrip.diffs, etrip/etrip.fot, etrip/etrip.log,
+ etrip/etrip.tex, etrip/etripin.log: Version 2.6 [2013-03-01].
+
+2013-02-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Version 2.5, dated February 28, 2013.
+
+2013-01-24 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * wprob.test: Avoid spurious failure of parallel-tests.
+ * am/etex.am: Renamed wprob.{tex,log} => ewprob.{tex,log}.
+
+2013-01-15 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am, etrip.test: Enable parallel-tests.
+
+2012-12-16 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etex_version.h): Enable silent rules.
+
+2012-08-02 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch, etex_version.h: Version 2.5.
+ Better tracing of font definitions, reported by
+ Bruno Le Floch <blflatex@@gmail.com>, Jul 2012.
+ * etrip/etrip.tex: Test the additional tracing.
+
+2012-07-19 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Distribute etex_version.h.
+
+2012-07-15 Akira Kakuto <kakuto at fuk.kindai.ac.jp>
+
+ * etexextra.c: Must #define DLLPROC before reading etexd.h.
+
+2012-06-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etexextra.c [W32TeX]: #define DLLPROC for etex.dll.
+
+2012-05-11 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Version 2.4, dated May 11, 2012.
+ * etrip/etrip.tex, etrip/etripin.log, etrip/etrip.log,
+ etrip/etrip.fot, etrip/etrip.typ, etrip/etrip.diffs: Adapted.
+
+2012-04-11 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Fixed a typo in TeX text.
+
+ * INSTALL, README: Removed these obsolete files.
+ * am/etex.am (EXTRA_DIST): Removed INSTALL and README.
+
+2011-09-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * wprob.test: New shell script to test for uninitialized line.
+ * am/etex.am: Add the new test.
+
+2011-09-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Slightly reformulate printing of current line.
+
+2011-04-07 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Version 2.3, dated April 7, 2011.
+ * etrip/etrip.tex, etrip/etripin.log, etrip/etrip.log,
+ etrip/etrip.fot, etrip/etrip.typ, etrip/etrip.diffs: Adapted.
+
+2011-04-03 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Remove remove_end_M and insert_end_M (now unused).
+
+2011-03-31 Hironori Kitagawa <h_kitagawa2001 at yahoo.co.jp>
+
+ * etex.ch: TeX formatting.
+
+2011-03-30 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Further reduce e-pTeX interferences.
+
+2011-03-29 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Rename box_lrstat into box_lr and define to also work
+ for min_quarterword<0.
+
+2011-03-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Use AM_CFLAGS instead of etex_CFLAGS.
+
+2011-03-27 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Reformulate @<Fetch an item in the current node...@>,
+ begin_box, and delete_last to fix a bug in \lastpenalty & Co;
+ further reduce e-pTeX interferences.
+
+2011-03-24 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Reformulate begin_box and delete_last to reduce
+ interferences between e-TeX and pTeX.
+
+2011-03-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Reformulate @<Fetch an item in the current node...@>
+ to reduce interferences between e-TeX and pTeX.
+
+2011-03-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Define and use the Web macros box_lr and set_box_lr
+ to reduce interferences between e-TeX and pTeX.
+
+2011-01-17 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etrip.diffs): Use $(triptrap_diffs).
+
+2011-01-15 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etrip.tex: Fixed 'wrong last node type' diagnostic.
+
+2011-01-14 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etrip-clean): Use TRIPTRAP_CLEAN.
+
+2011-01-14 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Mention \protected in error and help messages only
+ when in extended mode.
+ * etrip/etrip.tex: Fixed a typo currentgroup{type => level}.
+
+2011-01-11 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.mak, etex.mk (removed): Obsolete.
+
+2011-01-08 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etex_web_srcs): Removed etex.fix.
+ (etex_ch_srcs): Added enctex.ch.
+ * etex.fix: Deleted.
+
+2011-01-01 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etexextra.in: Renamed ...
+ * etexextra.h: ... into this; #include etex_version.h
+ for ETEX_VERSION.
+
+ * etexextra.c (new): #include <etexd.h> and <lib/texmfmp.c>.
+
+ * am/etex.am: etexextra.[ch] are now distributed;
+ create etex_version.h instead of etex.version.
+
+2010-06-10 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etex_CPPFLAGS): Add $(AM_CPPFLAGS).
+
+2010-05-25 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (EXTRA_DIST): Remove tmf-pool.h.
+
+2010-05-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: More error message with \protected, from Heiko.
+
+2010-04-28 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Checked and adjusted tex.web line numbers.
+ Fixed the error message for improper use of \protected,
+ reported by Heiko Oberdiek <heiko.oberdiek at googlemail.com>.
+
+2010-04-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etex_ch_srcs): Use tex-binpool.ch as for TeX.
+
+2010-03-04 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (TRIPTRAP): Add etrip.diffs.
+
+2009-12-23 Karl Berry <karl at tug.org>
+
+ * etexextra.in (BUG_ADDRESS): tex-k at tug.org, not @mail.
+
+2009-12-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Replace the obsolete $(mkdir_p) by $(MKDIR_P).
+
+2009-10-04 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Enable compiler warnings.
+ * etex-binpool.ch (get_strings_started): Drop unused variables.
+
+2009-09-06 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Adapt to new makecpool with one argument.
+
+2009-09-04 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Prepare compiler warnings.
+
+2009-08-18 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: SyncTeX now integrated into ../texmfmp.h.
+
+2009-08-16 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am: Adapt to tangle-sh and web2c-sh.
+
+2009-08-13 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * am/etex.am (etex_c_h): avoid to split the C code.
+
+2009-05-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip.test (new): Shell script for e-TRIP tests.
+ * etrip/texmf.cnf (main_memory): Increased from 2999 to 3999
+ required due to increased node sizes for syncTeX extensions.
+
+2008-05-15 Karl Berry <karl at tug.org>
+
+ * etex.mk (etex-pool.c): the input is etex.pool. From Akira.
+
+2008-05-13 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex-mk: Use $(makecpool) instead of ./tex-mkcpool.
+
+2008-03-24 Karl Berry <karl at tug.org>
+
+ * tex.ch0,
+ * etex.ch,
+ * tex.ech: update for 3.1415926.
+
+2008-02-17 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Fixed a bug in hyph_code handling (\savinghyphcodes)
+ reported by Vladimir Volovich <vvv at vsu.ru>.
+ Corrected a few typos in TeX text.
+
+2005-08-03 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * tex.ech: Implement -etex switch.
+
+2004-12-19 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk (etexextra.c): Depends on etexdir/etexextra.h.
+
+ * etex.mk (etex-check): Add TEXMFCNF=../kpathsea to the mltex
+ test, so the right files are found when the installation is not
+ yet done. From Peter Breitenlohner <peb at mppmu.mpg.de>.
+
+2004-10-12 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Fixed a bug in the revised glue rounding code
+ (detected by Tigran Aivazian <tigran at aivazian.fsnet.co.uk>).
+ Version 2.2, dated October 12, 2004.
+
+2004-09-15 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Fixed a typo in TeX text, found by Giuseppe
+ Bilotta <bilotta78 at hotpop.com>.
+
+2004-09-06 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Incorporated register recycling bug fix from Bernd
+ Raichle <bernd at dante.de>.
+ Final Version 2.2 (hopefully).
+
+ * etrip/etrip.{fot,log,tex,typ}, etrip/etripin.log:
+ Updated for current version.
+
+ * etex.mk: Modified rule for etex.version.
+
+2004-08-26 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.mk (etrip): Use etex with "--progname=einitex --ini" or
+ "--progname=etex".
+
+2004-08-26 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.fix: Include fix for register recycling bug from Bernd
+ Raichle <bernd at dante.de>.
+
+2004-08-25 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etrip/etripman.tex: Updated to Version 2.2
+
+2004-08-21 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Version 2.2.
+
+2004-08-20 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etexextra.in: Peter holds copyright now.
+
+2004-08-26 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.version: Is from now on a generated file.
+
+ * etexextra.in: renamed from etexextra.h. The current e-TeX
+ version is substituted from etex.version. Variant of code
+ supplied by Peter Breitenlohner <peb at mppmu.mpg.de>.
+
+ * etex.mk: Added rules to extract current e-TeX version from
+ etex.ch and insert into etex.version and etexextra.h. Variant of
+ code supplied by Peter Breitenlohner <peb at mppmu.mpg.de>.
+
+2004-08-17 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk, etex.fix: Resurrected etex.fix, there is again a need
+ to include late-breaking changes.
+
+2004-07-29 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Somewhat rearrange mixed direction typesetting code
+ in order to reduce interference between eTeX and pdfTeX change
+ files.
+
+2004-07-25 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Reorganize additional command codes for convert
+ and last_item in order to reduce interference between eTeX and
+ pdfTeX change files.
+
+2004-07-23 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch, tex.ch[01], tex.ech: Reorganize handling of banner
+ string in order to reduce interference between eTeX, pdfTeX,
+ and web2c change files.
+
+2004-07-22 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Reorganize handling of additional token types.
+ This also fixed a bug in error context for additional token list
+ parameters, introduced by their reorganization.
+
+2004-07-21 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etrip/etripin.log: Update from Preter Breitenlohner.
+
+ * etrip/etrip.tex: Update from Peter Breitenlohner.
+
+ * etrip/etrip.fot: Update from Peter Breitenlohner.
+
+2004-07-19 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch, tex.ch[01]: Reorganize handling of additional token
+ list and integer parameters and e-TeX's additional penalties in
+ order to reduce interference between eTeX, pdfTeX, and web2c
+ change files.
+
+ * etex.ch: Add a note that this file not only defines etex.web
+ in terms of changes to be applies to tex.web, but in addition
+ is used to define pdfetex.web.
+
+ * tex.ech: Add a note that this file is used to construct the
+ web2c change files for both e-TeX and pdfeTeX.
+
+2004-07-17 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * etex.ch: Towards etex-2.2: Adapt to TeX 3.141592; this is still
+ somewhat preliminary; do_glue still needs to be adapted to the new
+ glue rounding algorithm of TeX 3.141592.
+ Incorporate bug fixes from etex.fix.
+
+ * etex.ch0, etrip/etrip.{fot,tex}, etrip/etripin.log: Adapted
+ to TeX 3.141592.
+
+ * tex.ch1, tex.ech: Change the xmalloc_array calls to the `new'
+ interface (from 2001-11-10).
+
+ * etex.ch0, etex.ch1, etex.fix, tex.ch2: Removed.
+
+ * etex.mk: Rewrite build rules for etex.{web,ch}, add
+ etexdir/etex.mk and remove etex.{ch0,ch1,fix}, tex.ch2.
+
+ * etex.version: add newline.
+
+ * etrip/etrip.log, etrip.diffs: changed due to bug fix.
+
+2004-07-14 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.fix: Add fix for typo on line 2737 of etex.ch. From Peter
+ Breitenlohner.
+
+ * etexextra.h: Add BUG_ADDRESS.
+
+2004-07-04 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk: Move the creation of the format-related links to
+ format-related install rules; this seems to be a better place for
+ them, as the links are pointless without the corresponding
+ formats. Make the install-*-pool rules depend on the pool file in
+ question.
+
+2004-07-03 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk: Set up the make rules so that if etex isn't built (by
+ default) we do not forward from the general to the etex-specific
+ rules. But the etex-specific rules can be used.
+
+ * etex.mk: Use $(TANGLE), $(TIE) instead ./tangle, ./tie to
+ support cross-compiling.
+
+2004-05-10 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk (install-etex-programs): Typo resulted in no etex binary
+ being installed.
+
+2004-05-08 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk (install-etex-programs): This rule didn't have a command
+ attached, so etex didn't get installed.
+ (install-etex-links): Dont install einitex, evirtex links.
+
+ * etex.mk: Formats are now parked in a subdirectory of
+ $(web2cdir).
+
+ * etex.mk: Change the .efmt extension to .fmt. One consequence is
+ that we don't want to build tex.fmt, where we could safely build
+ tex.efmt.
+
+ * etexextra.h: .efmt -> .fmt.
+
+ * tex.ech: .efmt -> .fmt.
+
+2004-01-27 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.fix: The assignment to cur_val instead of cur_val_level
+ would result in \lastnodetype getting confused about what type of
+ value it was supposed to be. Reported by Hartmut Henkel
+ <hartmut_henkel at gmx.de>, fix found by Fabrice Popineau
+ <Fabrice.Popineau at supelec.fr>.
+
+2003-02-19 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk: Installation of formats is no longer done via
+ install-data in this file, but just from the install-data ->
+ install-dumps -> install-fmts in the main Makefile. That way we
+ can prevent automatic installation with a single change in that
+ Makefile.
+ (etex.p): Depend on tangle.
+ (triptrap): Depend on etrip.
+ (install-etex-data): Double-colon rule.
+ (install-data): Combine with install-etex-data.
+
+2003-02-17 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.ch1: Reduce to banner changes.
+
+ * etex.ch0: Slightly extend the reverted bits here, so they can be
+ cleared out of etex.ch1 and are now all in one file.
+
+2003-02-16 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.ch1: Correct the banners, and revert a final few bits of
+ TeX that use a variable that doesn't exist in e-TeX.
+
+ * etex.ch0: TeX 3.141592 and e-TeX 2.1 require reconciliation.
+ Revert some of TeX's code to 3.14159 to get e-TeX 2.1 to tangle.
+
+ * etexextra.h: Update banner for 3.141592-2.1.
+
+ * etex.mk (etex.web): Add etex.ch0 and etex.ch1 to build rules.
+
+2003-02-15 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk: From klibtool to libtool. Based on patches from Albert
+ Chin-A-Young <china at thewrittenword.com>.
+
+ * etex.mk: Changes to make e-TeX, in extended mode, the engine
+ under LaTeX2e.
+
+2003-02-07 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk: Reorganized to match the new Makefile.in.
+
+2003-01-15 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * etex.mk (etestenv): Add LC_ALL=C to the etrip environment.
+
+2002-10-11 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * tex.ch1: Settle on a text for the not-TeX banner.
+
+2002-06-02 Olaf Weber <olaf at infovore.xs4all.nl>
+
+ * tex.ch0, tex.ch1: Changes to account for the banner changing
+ when certain options are specified that make the program
+ not-strictly TeX.
+
+ * tex.ch2: Commented-out changes deleted. These changes became
+ active in tex.ch1.
+
+Mon Feb 01 18:35:30 1999 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * Version 2.1 for Web2c Version 7.2
+
+Thu Feb 19 18:03:12 1998 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * Version 2.0 for Web2c Version 7.2
+
+Sat Aug 23 14:14:12 1997 Peter Breitenlohner <peb at mppmu.mpg.de>
+
+ * Integrated e-TeX Version 1.1 into Web2c Version 7.0
+ (by Karl Berry, as of Feb 7 1997.
+
+ All e-TeX (and e-TRIP) source files as well as a Makefile fragment
+ are in a separate directory: web2c/etexdir. This will certainly make
+ it easier to switch to e-TeX Version 2.
Modified: trunk/Master/texmf-dist/doc/info/dvips.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/dvips.info 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/info/dvips.info 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,6 +1,6 @@
-This is dvips.info, produced by makeinfo version 6.8 from dvips.texi.
+This is dvips.info, produced by makeinfo version 6.5 from dvips.texi.
-This manual documents Dvips version 2022.1 (January 2022), a program to
+This manual documents Dvips version 2023.1 (February 2022), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
INFO-DIR-SECTION TeX
@@ -16,7 +16,7 @@
Dvips
*****
-This manual documents Dvips version 2022.1 (January 2022), a program to
+This manual documents Dvips version 2023.1 (February 2022), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
@@ -4754,88 +4754,83 @@
Tag Table:
-Node: Top520
-Node: Why Dvips1269
-Node: Installation3852
-Node: config.ps installation4787
-Node: PostScript font installation7394
-Node: Ghostscript installation8314
-Node: Diagnosing problems9253
-Node: Debug options10344
-Node: No output11348
-Node: Small or inverted12814
-Node: Printer errors13532
-Node: Long documents fail14864
-Node: Including graphics fails15205
-Node: Invoking Dvips16444
-Node: Basic usage17035
-Node: Command-line options18033
-Node: Option summary18481
-Node: Option details20756
-Node: Environment variables41579
-Node: Config files44440
-Node: Configuration file searching45110
-Node: Configuration file commands48307
-Node: Paper size and landscape56512
-Node: papersize special58137
-Node: Config file paper sizes59844
-Node: Paper trays64867
-Node: Interaction with PostScript66201
-Node: PostScript figures66854
-Node: Bounding box67580
-Node: \includegraphics70952
-Node: EPSF macros73244
-Node: EPSF scaling75212
-Node: EPSF clipping77782
-Node: psfile special78424
-Node: Dynamic creation of graphics80816
-Node: Fonts in figures82134
-Node: Header files83784
-Node: Including headers from TeX84990
-Node: Including headers from the command line87028
-Node: Headers and memory usage88127
-Node: Literal PS89338
-Node: " special89920
-Node: ps special90661
-Node: Literal headers92159
-Node: PostScript hooks92868
-Node: Literal examples94964
-Node: Hypertext96418
-Node: Hypertext caveats97592
-Node: Hypertext specials101720
-Node: PostScript fonts104354
-Node: Font concepts105471
-Node: Metric files106701
-Node: Glyph files109481
-Node: Virtual fonts111840
-Node: Encodings113995
-Node: Bitmap font encodings116397
-Node: PostScript typesetting118927
-Node: Making a font available122024
-Node: Invoking afm2tfm127058
-Node: Changing font encodings128078
-Node: Changing TeX encodings128869
-Node: Changing PostScript encodings129971
-Node: Changing both encodings131315
-Node: Reencoding with Afm2tfm131989
-Node: Encoding file format135092
-Node: Special font effects139296
-Node: Afm2tfm options141556
-Node: psfonts.map145081
-Node: Color149811
-Node: Color macro files150855
-Node: User-definable colors154065
-Node: Color subtleties155341
-Node: Ted Turner156993
-Node: Color device configuration158218
-Node: Color support details160662
-Node: Color specifications161040
-Node: Color specials162444
-Node: Index164573
+Node: Top521
+Node: Why Dvips1271
+Node: Installation3854
+Node: config.ps installation4789
+Node: PostScript font installation7396
+Node: Ghostscript installation8316
+Node: Diagnosing problems9255
+Node: Debug options10346
+Node: No output11350
+Node: Small or inverted12816
+Node: Printer errors13534
+Node: Long documents fail14866
+Node: Including graphics fails15207
+Node: Invoking Dvips16446
+Node: Basic usage17037
+Node: Command-line options18035
+Node: Option summary18483
+Node: Option details20758
+Node: Environment variables41581
+Node: Config files44442
+Node: Configuration file searching45112
+Node: Configuration file commands48309
+Node: Paper size and landscape56514
+Node: papersize special58139
+Node: Config file paper sizes59846
+Node: Paper trays64869
+Node: Interaction with PostScript66203
+Node: PostScript figures66856
+Node: Bounding box67582
+Node: \includegraphics70954
+Node: EPSF macros73246
+Node: EPSF scaling75214
+Node: EPSF clipping77784
+Node: psfile special78426
+Node: Dynamic creation of graphics80818
+Node: Fonts in figures82136
+Node: Header files83786
+Node: Including headers from TeX84992
+Node: Including headers from the command line87030
+Node: Headers and memory usage88129
+Node: Literal PS89340
+Node: " special89922
+Node: ps special90663
+Node: Literal headers92161
+Node: PostScript hooks92870
+Node: Literal examples94966
+Node: Hypertext96420
+Node: Hypertext caveats97594
+Node: Hypertext specials101722
+Node: PostScript fonts104356
+Node: Font concepts105473
+Node: Metric files106703
+Node: Glyph files109483
+Node: Virtual fonts111842
+Node: Encodings113997
+Node: Bitmap font encodings116399
+Node: PostScript typesetting118929
+Node: Making a font available122026
+Node: Invoking afm2tfm127060
+Node: Changing font encodings128080
+Node: Changing TeX encodings128871
+Node: Changing PostScript encodings129973
+Node: Changing both encodings131317
+Node: Reencoding with Afm2tfm131991
+Node: Encoding file format135094
+Node: Special font effects139298
+Node: Afm2tfm options141558
+Node: psfonts.map145083
+Node: Color149813
+Node: Color macro files150857
+Node: User-definable colors154067
+Node: Color subtleties155343
+Node: Ted Turner156995
+Node: Color device configuration158220
+Node: Color support details160664
+Node: Color specifications161042
+Node: Color specials162446
+Node: Index164575
End Tag Table
-
-
-Local Variables:
-coding: utf-8
-End:
Modified: trunk/Master/texmf-dist/doc/info/kpathsea.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/kpathsea.info 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/info/kpathsea.info 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,9 +1,9 @@
-This is kpathsea.info, produced by makeinfo version 5.1 from
+This is kpathsea.info, produced by makeinfo version 6.5 from
kpathsea.texi.
This file documents the Kpathsea library for path searching.
- Copyright (C) 1996-2022 Karl Berry & Olaf Weber.
+ Copyright (C) 1996-2023 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -37,7 +37,7 @@
****************
This manual documents the Kpathsea library for path searching. It
-corresponds to version 6.3.4, released in January 2022.
+corresponds to version 6.3.5, released in February 2023.
* Menu:
@@ -61,8 +61,8 @@
1 Introduction
**************
-This manual corresponds to version 6.3.4 of the Kpathsea library,
-released in January 2022.
+This manual corresponds to version 6.3.5 of the Kpathsea library,
+released in February 2023.
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
@@ -1317,7 +1317,7 @@
enc files: .enc
cmap files (cmap):
subfont definition files: .sfd
- opentype fonts: .otf
+ opentype fonts: .otf .OTF
pdftex config (pdftexconfig):
lig files: .lig
texmfscripts:
@@ -1703,6 +1703,10 @@
'ls-R'
(Filename databases, *note Filename database::) 'TEXMFDBS'.
+'lua'
+ (Lua scripts, <https://ctan.org/pkg/luatex>) 'LUAINPUTS' suffixes
+ '.lua', '.luatex', '.luc', '.luctex', '.texlua', '.texluc', '.tlu'.
+
'map'
(Fontmaps, *note Fontmap::) 'TEXFONTMAPS'; suffix '.map'.
@@ -3031,7 +3035,7 @@
* !! and casefolding: Casefolding examples.
(line 57)
* !! in path specifications: ls-R. (line 57)
-* !! in 'TEXMFDBS': ls-R. (line 11)
+* !! in TEXMFDBS: ls-R. (line 11)
* $ expansion: Variable expansion. (line 6)
* --all: Path searching options.
(line 12)
@@ -3039,7 +3043,7 @@
(line 19)
* --cnf-line: Path searching options.
(line 28)
-* '--cnf-line', source for path: Path sources. (line 9)
+* --cnf-line, source for path: Path sources. (line 9)
* --color=tty: ls-R. (line 25)
* --debug=NUM: Auxiliary tasks. (line 9)
* --dpi=NUM: Path searching options.
@@ -3085,12 +3089,12 @@
* --without-mktexpk-default: mktex configuration. (line 12)
* --without-mktextfm-default: mktex configuration. (line 12)
* -1 debugging value: Debugging. (line 23)
-* -A option to 'ls': ls-R. (line 39)
+* -A option to ls: ls-R. (line 39)
* -D NUM: Path searching options.
(line 49)
* -iname, find predicate: Casefolding examples.
(line 78)
-* -L option to 'ls': ls-R. (line 44)
+* -L option to ls: ls-R. (line 44)
* . directories, ignored: ls-R. (line 39)
* . files: ls-R. (line 39)
* .2602gf: Unable to generate fonts.
@@ -3127,71 +3131,85 @@
(line 84)
* .lig: Supported file formats.
(line 88)
+* .lua: Supported file formats.
+ (line 94)
+* .luatex: Supported file formats.
+ (line 94)
+* .luc: Supported file formats.
+ (line 94)
+* .luctex: Supported file formats.
+ (line 94)
* .map: Supported file formats.
- (line 94)
+ (line 98)
* .mem: Supported file formats.
- (line 97)
+ (line 101)
* .mf: Supported file formats.
- (line 105)
+ (line 109)
* .mft: Supported file formats.
- (line 113)
+ (line 117)
* .mlbib: Supported file formats.
- (line 121)
+ (line 125)
* .mlbst: Supported file formats.
- (line 125)
+ (line 129)
* .mp: Supported file formats.
- (line 129)
+ (line 133)
* .ocp: Supported file formats.
- (line 137)
+ (line 141)
* .ofm: Supported file formats.
- (line 141)
+ (line 145)
* .opl: Supported file formats.
- (line 148)
+ (line 152)
* .otp: Supported file formats.
- (line 151)
+ (line 155)
* .ovf: Supported file formats.
- (line 154)
+ (line 158)
* .ovp: Supported file formats.
- (line 157)
+ (line 161)
* .pfa: Supported file formats.
- (line 211)
+ (line 215)
* .pfb: Supported file formats.
- (line 211)
+ (line 215)
* .pk: Supported file formats.
- (line 164)
+ (line 168)
* .pool: Supported file formats.
- (line 109)
+ (line 113)
* .pool <1>: Supported file formats.
- (line 133)
+ (line 137)
* .pool <2>: Supported file formats.
- (line 195)
+ (line 199)
* .pro: Supported file formats.
- (line 169)
-* .PROGNAME qualifier in 'texmf.cnf': Config files. (line 50)
+ (line 173)
+* .PROGNAME qualifier in texmf.cnf: Config files. (line 50)
* .rhosts, writable by TeX: Security. (line 10)
* .ris: Supported file formats.
- (line 173)
+ (line 177)
* .sfd: Supported file formats.
- (line 177)
+ (line 181)
* .so: Supported file formats.
(line 42)
* .tex: Supported file formats.
- (line 180)
-* .tex file, included in 'ls-R': ls-R. (line 39)
+ (line 184)
+* .tex file, included in ls-R: ls-R. (line 39)
+* .texlua: Supported file formats.
+ (line 94)
+* .texluc: Supported file formats.
+ (line 94)
* .tfm: Supported file formats.
- (line 199)
+ (line 203)
+* .tlu: Supported file formats.
+ (line 94)
* .ttc: Supported file formats.
- (line 207)
+ (line 211)
* .ttf: Supported file formats.
- (line 207)
+ (line 211)
* .vf: Supported file formats.
- (line 219)
+ (line 223)
* .w: Supported file formats.
(line 53)
* .web: Supported file formats.
(line 53)
* .web <1>: Supported file formats.
- (line 223)
+ (line 227)
* / may not be /: Searching overview. (line 13)
* /, trailing in home directory: Tilde expansion. (line 19)
* //: Subdirectory expansion.
@@ -3205,9 +3223,9 @@
* 8.3 filenames, using: mktex configuration. (line 68)
* : may not be :: Searching overview. (line 13)
* :: expansion: Default expansion. (line 6)
-* ; translated to ':' in 'texmf.cnf': Config files. (line 66)
-* = omitted in 'texmf.cnf' and misparsing: Config files. (line 86)
-* \, line continuation in 'texmf.cnf': Config files. (line 37)
+* ; translated to : in texmf.cnf: Config files. (line 66)
+* = omitted in texmf.cnf and misparsing: Config files. (line 86)
+* \, line continuation in texmf.cnf: Config files. (line 37)
* \openin: Searching overview. (line 31)
* \special, suppressing warnings about: Suppressing warnings.
(line 31)
@@ -3230,15 +3248,15 @@
* announcement mailing list: Mailing lists. (line 6)
* API, re-entrant: Programming overview.
(line 16)
-* append-only directories and 'mktexpk': Security. (line 36)
+* append-only directories and mktexpk: Security. (line 36)
* appendonlydir: mktex configuration. (line 60)
* Apple filesystem, case-insensitive: Casefolding rationale.
(line 6)
-* arguments to 'mktex': mktex script arguments.
+* arguments to mktex: mktex script arguments.
(line 6)
* argv[0]: Calling sequence. (line 14)
* autoconf, recommended: Calling sequence. (line 117)
-* automounter, and 'ls-R': ls-R. (line 46)
+* automounter, and ls-R: ls-R. (line 46)
* auxiliary tasks: Auxiliary tasks. (line 6)
* Bach, Johann Sebastian: Default expansion. (line 41)
* backslash-newline: Config files. (line 37)
@@ -3247,8 +3265,8 @@
* BIBINPUTS: Supported file formats.
(line 30)
* BIBINPUTS <1>: Supported file formats.
- (line 121)
-* blank lines, in 'texmf.cnf': Config files. (line 35)
+ (line 125)
+* blank lines, in texmf.cnf: Config files. (line 35)
* BLTXMLINPUTS: Supported file formats.
(line 34)
* brace expansion: Brace expansion. (line 6)
@@ -3256,7 +3274,7 @@
* BSTINPUTS: Supported file formats.
(line 38)
* BSTINPUTS <1>: Supported file formats.
- (line 125)
+ (line 129)
* bug address: Reporting bugs. (line 6)
* bug checklist: Bug checklist. (line 6)
* bug mailing list: Mailing lists. (line 6)
@@ -3276,7 +3294,7 @@
* checksum: Suppressing warnings.
(line 16)
* circle fonts: Fontmap. (line 19)
-* client_path in 'kpse->format_info': Calling sequence. (line 47)
+* client_path in kpse->format_info: Calling sequence. (line 47)
* CLUAINPUTS: Supported file formats.
(line 42)
* CMAPFONTS: Supported file formats.
@@ -3287,7 +3305,7 @@
* cnf.h: Programming with config files.
(line 27)
* comments, in fontmap files: Fontmap. (line 27)
-* comments, in 'texmf.cnf': Config files. (line 27)
+* comments, in texmf.cnf: Config files. (line 27)
* comments, making: Introduction. (line 29)
* common features in glyph lookup: Basic glyph lookup. (line 6)
* common problems: Common problems. (line 6)
@@ -3312,9 +3330,8 @@
* config.status: Bug checklist. (line 27)
* configuration bugs: Bug checklist. (line 27)
* configuration file, source for path: Path sources. (line 20)
-* configuration of 'mktex' scripts: mktex configuration. (line 6)
-* 'configure' options for 'mktex' scripts: mktex configuration.
- (line 12)
+* configuration of mktex scripts: mktex configuration. (line 6)
+* configure options for mktex scripts: mktex configuration. (line 12)
* context diff: Bug checklist. (line 52)
* continuation character: Config files. (line 37)
* core dumps, reporting: Bug checklist. (line 58)
@@ -3338,12 +3355,12 @@
* directory permissions: Security. (line 51)
* directory structure, for TeX files: TeX directory structure.
(line 6)
-* disabling 'mktex' scripts: mktex configuration. (line 6)
+* disabling mktex scripts: mktex configuration. (line 6)
* disk search: Searching overview. (line 22)
* disk searching, avoiding: ls-R. (line 57)
* disk usage, reducing: Logging. (line 6)
* doc files: Supported file formats.
- (line 185)
+ (line 189)
* DOS compatible names: mktex configuration. (line 68)
* dosnames: mktex configuration. (line 67)
* dot files: ls-R. (line 39)
@@ -3354,9 +3371,9 @@
* dvipdfmx.cfg: Specially-recognized files.
(line 19)
* DVIPSFONTS: Supported file formats.
- (line 254)
+ (line 258)
* DVIPSHEADERS: Supported file formats.
- (line 211)
+ (line 215)
* DVIPSMAKEPK: mktex script names. (line 32)
* DVIPSSIZES: Fallback font. (line 6)
* dynamic creation of files: mktex scripts. (line 6)
@@ -3365,7 +3382,7 @@
(line 41)
* elt-dirs.c <1>: Subdirectory expansion.
(line 48)
-* enabling 'mktex' scripts: mktex configuration. (line 6)
+* enabling mktex scripts: mktex configuration. (line 6)
* ENCFONTS: Supported file formats.
(line 61)
* engine name: Path searching options.
@@ -3394,7 +3411,7 @@
* extensions, filename: File lookup. (line 24)
* externally-built filename database: Filename database. (line 6)
* extra colons: Default expansion. (line 6)
-* failed 'mktex...' script invocation: mktex script names. (line 35)
+* failed mktex... script invocation: mktex script names. (line 35)
* fallback font: Fallback font. (line 6)
* fallback resolutions: Fallback font. (line 6)
* FAQ, Kpathsea: Common problems. (line 6)
@@ -3437,9 +3454,9 @@
* fontname: mktex configuration. (line 87)
* fontnames, arbitrary length: Fontmap. (line 15)
* FOOINPUTS: Supported file formats.
- (line 236)
+ (line 240)
* FOOINPUTS <1>: Supported file formats.
- (line 239)
+ (line 243)
* fopen, redefined: Debugging. (line 54)
* format of external database: Database format. (line 6)
* ftp.cs.stanford.edu: unixtex.ftp. (line 20)
@@ -3456,7 +3473,7 @@
* GLYPHFONTS: Supported file formats.
(line 75)
* GLYPHFONTS <1>: Supported file formats.
- (line 164)
+ (line 168)
* glyphlist.txt: Specially-recognized files.
(line 25)
* GNU C compiler bugs: TeX or Metafont failing.
@@ -3480,7 +3497,7 @@
(line 151)
* interface, not frozen: Introduction. (line 29)
* introduction: Introduction. (line 6)
-* 'kdebug:': Debugging. (line 105)
+* kdebug:: Debugging. (line 105)
* kdefault.c: Default expansion. (line 48)
* Knuth, Donald E.: History. (line 6)
* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20)
@@ -3546,6 +3563,8 @@
(line 91)
* ls-R database file: ls-R. (line 6)
* ls-R, simplest build: ls-R. (line 22)
+* LUAINPUTS: Supported file formats.
+ (line 94)
* Mac filesystem, case-insensitive: Casefolding rationale.
(line 6)
* MacKenzie, David: History. (line 44)
@@ -3568,13 +3587,13 @@
* MFBASES: Supported file formats.
(line 26)
* MFINPUTS: Supported file formats.
- (line 105)
+ (line 109)
* MFPOOL: Supported file formats.
- (line 109)
+ (line 113)
* MFTINPUTS: Supported file formats.
- (line 113)
+ (line 117)
* MISCFONTS: Supported file formats.
- (line 117)
+ (line 121)
* mismatched checksum warnings: Suppressing warnings.
(line 17)
* missfont.log: mktex script names. (line 35)
@@ -3583,9 +3602,9 @@
(line 20)
* mkocp: mktex script names. (line 18)
* mkofm: mktex script names. (line 21)
-* 'mktex' script configuration: mktex configuration. (line 6)
-* 'mktex' script names: mktex script names. (line 6)
-* 'mktex' scripts: mktex scripts. (line 6)
+* mktex script configuration: mktex configuration. (line 6)
+* mktex script names: mktex script names. (line 6)
+* mktex scripts: mktex scripts. (line 6)
* mktex.cnf: Specially-recognized files.
(line 28)
* mktex.cnf <1>: mktex configuration. (line 29)
@@ -3595,30 +3614,30 @@
* mktexfmt: mktex script names. (line 10)
* mktexmf: mktex script names. (line 15)
* mktexpk: mktex script names. (line 24)
-* 'mktexpk' can't guess mode: Unable to generate fonts.
+* mktexpk can't guess mode: Unable to generate fonts.
(line 12)
* mktextex: mktex script names. (line 27)
* mktextfm: mktex script names. (line 30)
* MLBIBINPUTS: Supported file formats.
- (line 121)
+ (line 125)
* MLBSTINPUTS: Supported file formats.
- (line 125)
+ (line 129)
* mode directory, omitting: mktex configuration. (line 98)
* Morgan, Tim: History. (line 12)
* MPINPUTS: Supported file formats.
- (line 129)
+ (line 133)
* MPMEMS: Supported file formats.
- (line 97)
+ (line 101)
* MPPOOL: Supported file formats.
- (line 133)
+ (line 137)
* MPSUPPORT: Supported file formats.
- (line 101)
+ (line 105)
* MT_FEATURES: mktex configuration. (line 39)
* multiple TeX hierarchies: Brace expansion. (line 20)
* must exist: Searching overview. (line 31)
-* names for 'mktex' scripts: mktex script names. (line 6)
+* names for mktex scripts: mktex script names. (line 6)
* Neumann, Gustaf: History. (line 56)
-* NFS and 'ls-R': ls-R. (line 46)
+* NFS and ls-R: ls-R. (line 46)
* nomfdrivers: mktex configuration. (line 92)
* nomode: mktex configuration. (line 97)
* none: Suppressing warnings.
@@ -3627,25 +3646,25 @@
* numeric debugging values: Debugging. (line 34)
* obtaining TeX: unixtex.ftp. (line 6)
* OCPINPUTS: Supported file formats.
- (line 137)
+ (line 141)
* OFMFONTS: Supported file formats.
- (line 141)
+ (line 145)
* online Metafont display, spurious: Unable to generate fonts.
(line 36)
* OPENTYPEFONTS: Supported file formats.
- (line 145)
+ (line 149)
* optimization caveat: TeX or Metafont failing.
(line 12)
* options for debugging: Debugging. (line 6)
* OTPINPUTS: Supported file formats.
- (line 151)
+ (line 155)
* overview of path searching: Searching overview. (line 6)
* overview of programming with Kpathsea: Programming overview.
(line 6)
* OVFFONTS: Supported file formats.
- (line 154)
+ (line 158)
* OVPFONTS: Supported file formats.
- (line 157)
+ (line 161)
* path expansion: Path expansion. (line 6)
* path searching: Path searching. (line 6)
* path searching options: Path searching options.
@@ -3661,7 +3680,7 @@
* pdftex.cfg: Specially-recognized files.
(line 34)
* PDFTEXCONFIG: Supported file formats.
- (line 161)
+ (line 165)
* pdftexconfig.tex: Specially-recognized files.
(line 34)
* permission denied: Searching overview. (line 63)
@@ -3668,7 +3687,7 @@
* permissions, directory: Security. (line 51)
* permissions, file: Security. (line 47)
* PKFONTS: Supported file formats.
- (line 164)
+ (line 168)
* plain.base: Unable to generate fonts.
(line 46)
* privacy, semblance of: Logging. (line 32)
@@ -3685,7 +3704,7 @@
* proof mode: Unable to generate fonts.
(line 36)
* PSHEADERS: Supported file formats.
- (line 169)
+ (line 173)
* pxp Pascal preprocessor: History. (line 12)
* quoting variable values: Variable expansion. (line 17)
* rationale for casefolding fallback: Casefolding rationale.
@@ -3705,7 +3724,7 @@
* retrieving TeX: unixtex.ftp. (line 6)
* right-hand side of variable assignments: Config files. (line 57)
* RISINPUTS: Supported file formats.
- (line 173)
+ (line 177)
* Rokicki, Tom: History. (line 12)
* root user: Tilde expansion. (line 19)
* runtime configuration files: Config files. (line 6)
@@ -3726,16 +3745,16 @@
* sending patches: Bug checklist. (line 52)
* setgid scripts: Security. (line 40)
* SFDFONTS: Supported file formats.
- (line 177)
+ (line 181)
* shell variables: Variable expansion. (line 17)
* shell_escape, example for code: Programming with config files.
(line 10)
-* site overrides for 'mktex...': mktex configuration. (line 29)
+* site overrides for mktex...: mktex configuration. (line 29)
* skeleton TeX directory: TeX directory structure.
(line 6)
* slow startup time: Slow path searching. (line 6)
* source files: Supported file formats.
- (line 188)
+ (line 192)
* sources for search paths: Path sources. (line 6)
* special: Suppressing warnings.
(line 30)
@@ -3765,7 +3784,7 @@
(line 6)
* symbolic links not found: Unable to find files.
(line 21)
-* symbolic links, and 'ls-R': ls-R. (line 44)
+* symbolic links, and ls-R: ls-R. (line 44)
* symlinks, resolving: Calling sequence. (line 31)
* system C compiler bugs: TeX or Metafont failing.
(line 16)
@@ -3772,11 +3791,11 @@
* system-dependent casefolding behavior: Casefolding rationale.
(line 6)
* T1FONTS: Supported file formats.
- (line 211)
+ (line 215)
* T1INPUTS: Supported file formats.
- (line 211)
+ (line 215)
* T42FONTS: Supported file formats.
- (line 216)
+ (line 220)
* tcfmgr.map: Specially-recognized files.
(line 46)
* TDS: TeX directory structure.
@@ -3803,21 +3822,21 @@
* TEXBIB: Supported file formats.
(line 30)
* TEXBIB <1>: Supported file formats.
- (line 121)
+ (line 125)
* TEXCONFIG: Supported file formats.
(line 57)
* TEXDOCS: Supported file formats.
- (line 185)
+ (line 189)
* TEXFONTMAPS: Supported file formats.
- (line 94)
+ (line 98)
* TEXFONTS: Supported file formats.
(line 75)
* TEXFONTS <1>: Supported file formats.
- (line 164)
+ (line 168)
* TEXFONTS <2>: Supported file formats.
- (line 199)
+ (line 203)
* TEXFONTS <3>: Supported file formats.
- (line 219)
+ (line 223)
* texfonts.map: Fontmap. (line 6)
* TEXFORMATS: Supported file formats.
(line 64)
@@ -3826,12 +3845,12 @@
* TEXINPUTS: Supported file formats.
(line 79)
* TEXINPUTS <1>: Supported file formats.
- (line 180)
+ (line 184)
* TEXMF: TeX directory structure.
(line 6)
* texmf.cnf: Specially-recognized files.
(line 38)
-* 'texmf.cnf' missing, warning about: Config files. (line 18)
+* texmf.cnf missing, warning about: Config files. (line 18)
* texmf.cnf, and variable expansion: Variable expansion. (line 6)
* texmf.cnf, definition for: Config files. (line 6)
* texmf.cnf, source for path: Path sources. (line 20)
@@ -3846,11 +3865,11 @@
* TEXMFINI <1>: Supported file formats.
(line 64)
* TEXMFINI <2>: Supported file formats.
- (line 97)
+ (line 101)
* TEXMFLOG: Logging. (line 10)
* TEXMFOUTPUT: mktex script names. (line 40)
* TEXMFSCRIPTS: Supported file formats.
- (line 191)
+ (line 195)
* texmfvar: mktex configuration. (line 122)
* TEXMFVAR: mktex configuration. (line 123)
* texmf_casefold_search: Casefolding search. (line 12)
@@ -3857,37 +3876,37 @@
* TEXPICTS: Supported file formats.
(line 79)
* TEXPKS: Supported file formats.
- (line 164)
+ (line 168)
* TEXPOOL: Supported file formats.
- (line 195)
+ (line 199)
* TEXPSHEADERS: Supported file formats.
- (line 169)
+ (line 173)
* TEXPSHEADERS <1>: Supported file formats.
- (line 211)
+ (line 215)
* TEXSIZES: Fallback font. (line 6)
* TEXSOURCES: Supported file formats.
- (line 188)
+ (line 192)
* TEX_HUSH: Searching overview. (line 63)
* TEX_HUSH <1>: Suppressing warnings.
(line 6)
* TFMFONTS: Supported file formats.
- (line 199)
+ (line 203)
* tilde expansion: Tilde expansion. (line 6)
* tilde.c: Tilde expansion. (line 25)
* time system call: Logging. (line 15)
* tolerance for glyph lookup: Basic glyph lookup. (line 15)
-* trailing '/' in home directory: Tilde expansion. (line 19)
+* trailing / in home directory: Tilde expansion. (line 19)
* trailing colons: Default expansion. (line 6)
* translations, of path searching description: Path searching.
(line 10)
* TRFONTS: Supported file formats.
- (line 203)
+ (line 207)
* trick for detecting leaf directories: Subdirectory expansion.
(line 22)
* trojan horse attack: Security. (line 10)
* try_std_extension_first: File lookup. (line 24)
* TTFONTS: Supported file formats.
- (line 207)
+ (line 211)
* tug.org: unixtex.ftp. (line 6)
* typeface directory, omitting: mktex configuration. (line 105)
* typeface directory, omitting <1>: mktex configuration. (line 108)
@@ -3902,7 +3921,7 @@
* unreadable file warnings: Suppressing warnings.
(line 27)
* unreadable files: Searching overview. (line 63)
-* unusable 'ls-R' warning: ls-R. (line 51)
+* unusable ls-R warning: ls-R. (line 51)
* usage patterns, finding: Logging. (line 6)
* USERPROFILE, as ~ expansion: Tilde expansion. (line 6)
* USE_TEXMFVAR: mktex configuration. (line 128)
@@ -3917,19 +3936,19 @@
* version numbers, determining: Bug checklist. (line 15)
* VF files, not found: Searching overview. (line 31)
* VFFONTS: Supported file formats.
- (line 219)
+ (line 223)
* Vojta, Paul: History. (line 30)
* Walsh, Norman: History. (line 56)
-* warning about unusable 'ls-R': ls-R. (line 51)
-* warning, about missing 'texmf.cnf': Config files. (line 18)
+* warning about unusable ls-R: ls-R. (line 51)
+* warning, about missing texmf.cnf: Config files. (line 18)
* warnings, file access: Searching overview. (line 63)
* warnings, suppressing: Suppressing warnings.
(line 6)
* WEB2C: Supported file formats.
- (line 227)
+ (line 231)
* Weber, Olaf: History. (line 73)
* WEBINPUTS: Supported file formats.
- (line 223)
+ (line 227)
* whitespace, in fontmap files: Fontmap. (line 31)
* whitespace, not ignored on continuation lines: Config files.
(line 37)
@@ -3939,7 +3958,7 @@
* XDvi: Specially-recognized files.
(line 41)
* XDVIFONTS: Supported file formats.
- (line 254)
+ (line 258)
* XDVIMAKEPK: mktex script names. (line 32)
* XDVISIZES: Fallback font. (line 6)
* zuhn, david: History. (line 50)
@@ -3948,61 +3967,61 @@
Tag Table:
Node: Top1480
-Node: Introduction2262
-Node: History4331
-Node: unixtex.ftp8927
-Node: Security10397
-Node: TeX directory structure12901
-Node: Path searching16940
-Node: Searching overview17898
-Node: Path sources21717
-Node: Config files22943
-Node: Path expansion27815
-Node: Default expansion28768
-Node: Variable expansion30838
-Node: Tilde expansion32239
-Node: Brace expansion33219
-Node: KPSE_DOT expansion34158
-Node: Subdirectory expansion34671
-Node: Casefolding search37019
-Node: Casefolding rationale37788
-Node: Casefolding examples39134
-Node: Filename database44180
-Node: ls-R45162
-Node: Filename aliases48838
-Node: Database format50016
-Node: Invoking kpsewhich51029
-Node: Path searching options51984
-Node: Specially-recognized files61582
-Node: Auxiliary tasks62937
-Node: Standard options66662
-Node: TeX support67018
-Node: Supported file formats68372
-Node: File lookup76040
-Node: Glyph lookup77789
-Node: Basic glyph lookup78913
-Node: Fontmap79793
-Node: Fallback font82303
-Node: Suppressing warnings83215
-Node: mktex scripts84342
-Node: mktex configuration85557
-Node: mktex script names91360
-Node: mktex script arguments92746
-Node: Programming93625
-Node: Programming overview94198
-Node: Calling sequence97059
-Node: Program-specific files103588
-Node: Programming with config files104611
-Node: Reporting bugs106198
-Node: Bug checklist106876
-Node: Mailing lists110345
-Node: Debugging111022
-Node: Logging116099
-Node: Common problems117966
-Node: Unable to find files118443
-Node: Slow path searching120853
-Node: Unable to generate fonts122228
-Node: TeX or Metafont failing124700
-Node: Index125902
+Node: Introduction2263
+Node: History4333
+Node: unixtex.ftp8929
+Node: Security10399
+Node: TeX directory structure12903
+Node: Path searching16942
+Node: Searching overview17900
+Node: Path sources21719
+Node: Config files22945
+Node: Path expansion27817
+Node: Default expansion28770
+Node: Variable expansion30840
+Node: Tilde expansion32241
+Node: Brace expansion33221
+Node: KPSE_DOT expansion34160
+Node: Subdirectory expansion34673
+Node: Casefolding search37021
+Node: Casefolding rationale37790
+Node: Casefolding examples39136
+Node: Filename database44182
+Node: ls-R45164
+Node: Filename aliases48840
+Node: Database format50018
+Node: Invoking kpsewhich51031
+Node: Path searching options51986
+Node: Specially-recognized files61589
+Node: Auxiliary tasks62944
+Node: Standard options66669
+Node: TeX support67025
+Node: Supported file formats68379
+Node: File lookup76198
+Node: Glyph lookup77947
+Node: Basic glyph lookup79071
+Node: Fontmap79951
+Node: Fallback font82461
+Node: Suppressing warnings83373
+Node: mktex scripts84500
+Node: mktex configuration85715
+Node: mktex script names91518
+Node: mktex script arguments92904
+Node: Programming93783
+Node: Programming overview94356
+Node: Calling sequence97217
+Node: Program-specific files103746
+Node: Programming with config files104769
+Node: Reporting bugs106356
+Node: Bug checklist107034
+Node: Mailing lists110503
+Node: Debugging111180
+Node: Logging116257
+Node: Common problems118124
+Node: Unable to find files118601
+Node: Slow path searching121011
+Node: Unable to generate fonts122386
+Node: TeX or Metafont failing124858
+Node: Index126060
End Tag Table
Modified: trunk/Master/texmf-dist/doc/info/tlbuild.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/tlbuild.info 2023-02-26 21:29:23 UTC (rev 66202)
+++ trunk/Master/texmf-dist/doc/info/tlbuild.info 2023-02-26 21:56:36 UTC (rev 66203)
@@ -1,10 +1,10 @@
-This is tlbuild.info, produced by makeinfo version 6.8 from
+This is tlbuild.info, produced by makeinfo version 7.0.2 from
tlbuild.texi.
This file documents the TeX Live build system and more.
-Copyright (C) 2016-2022 Karl Berry.
-Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
+Copyright © 2016–2023 Karl Berry.
+Copyright © 2013–2015 Karl Berry & Peter Breitenlohner.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -33,7 +33,7 @@
File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir)
-Building TeX Live (2022)
+Building TeX Live (2023)
************************
For an overview of this manual, *note Introduction::.
@@ -59,17 +59,18 @@
1 Introduction
**************
-This manual (dated March 2022) corresponds to the TeX Live 2022 release.
+This manual (dated February 2023) corresponds to the TeX Live 2023
+release.
This manual is aimed at system installers and programmers, and
focuses on how to configure, build, and develop the TeX Live (TL)
sources. It is also available as plain text files in the source tree:
-'source/README.*'.
+‘source/README.*’.
- The main 'source/README' file in the TL source tree provides
+ The main ‘source/README’ file in the TL source tree provides
maximally-terse information for doing a build, and portability
information for different systems, along with
-'source/doc/README.solaris'.
+‘source/doc/README.solaris’.
For information on acquiring the TL sources, see
<https://tug.org/texlive/svn>. The canonical source repository uses
@@ -78,27 +79,27 @@
This manual does not duplicate the information found in other TL
documentation resources, such as:
- * The TeX Live web pages: <https://tug.org/texlive>.
+ • The TeX Live web pages: <https://tug.org/texlive>.
- * The web page describing how to build the binaries which are
+ • The web page describing how to build the binaries which are
distributed with TeX Live: <https://tug.org/texlive/build.html>.
- * The TeX Live user manual: <https://tug.org/texlive/doc.html>, or
- run 'texdoc texlive'.
+ • The TeX Live user manual: <https://tug.org/texlive/doc.html>, or
+ run ‘texdoc texlive’.
- * Other TeX-related Texinfo manuals (*note (web2c)::, *note
+ • Other TeX-related Texinfo manuals (*note (web2c)::, *note
(kpathsea)::, etc.): <https://tug.org/texinfohtml/>, or check the
- 'TeX' category in the GNU Info system.
+ ‘TeX’ category in the GNU Info system.
- * Package documentation:
- <https://tug.org/texlive/Contents/live/doc.html>, or the 'doc.html'
+ • Package documentation:
+ <https://tug.org/texlive/Contents/live/doc.html>, or the ‘doc.html’
file at the top level of the installed TL.
- As an exception, the full documentation for 'install-tl' and 'tlmgr'
+ As an exception, the full documentation for ‘install-tl’ and ‘tlmgr’
is included here as appendices, simply because it is easy to do so. The
same text is available online (linked from
<https://tug.org/texlive/doc.html>, or by invoking the program with
-'--help' (or look at the end of the source).
+‘--help’ (or look at the end of the source).
File: tlbuild.info, Node: Overview of build system, Next: Prerequisites, Prev: Introduction, Up: Top
@@ -108,34 +109,34 @@
The TeX Live build system was redesigned in 2009 to consistently use
Autoconf, Automake, and Libtool. Thus, running
- 'configure && make && make check && make install'
-or the essentially-equivalent top-level 'Build' script suffices to build
-and install the TL programs. The 'make check' clause performs various
-tests of the generated programs--not strictly required but strongly
-recommended. Running 'configure --help' will display a comprehensive
-list of all 'configure' options.
+ ‘configure && make && make check && make install’
+or the essentially-equivalent top-level ‘Build’ script suffices to build
+and install the TL programs. The ‘make check’ clause performs various
+tests of the generated programs—not strictly required but strongly
+recommended. Running ‘configure --help’ will display a comprehensive
+list of all ‘configure’ options.
The main components of the TL build system are:
-'libs/LIB'
+‘libs/LIB’
Generic libraries.
-'texk/LIB'
- TeX-specific libraries in subdirectories, notably LIB='kpathsea'.
- (The other one is 'texk/ptexenc'.)
+‘texk/LIB’
+ TeX-specific libraries in subdirectories, notably LIB=‘kpathsea’.
+ (The other one is ‘texk/ptexenc’.)
-'texk/PROG'
+‘texk/PROG’
TeX-specific programs (that use Kpathsea).
-'utils/PROG'
- Other programs (that don't use Kpathsea).
+‘utils/PROG’
+ Other programs (that don’t use Kpathsea).
The primary design goal of the build system is modularity. Each
program and library module (or package) specifies its own requirements
and properties, such as required libraries, whether an installed
-(system) version of a library can be used, 'configure' options to be
+(system) version of a library can be used, ‘configure’ options to be
seen at the top level, and more. An explicit list of all available
-modules is kept in a single central place: 'm4/kpse-pkgs.m4'.
+modules is kept in a single central place: ‘m4/kpse-pkgs.m4’.
A second, related goal is to configure and build each library before
configuring any other (program or library) module which uses that
@@ -158,60 +159,60 @@
***************
Overall, building the TeX Live programs, when using all libraries from
-the TL source tree, requires C and C++11 compilers, GNU 'make', and
+the TL source tree, requires C and C++11 compilers, GNU ‘make’, and
Python.
- * If 'make' from your 'PATH' is not GNU 'make', you can set the
- 'MAKE' environment variable to whatever is necessary.
+ • If ‘make’ from your ‘PATH’ is not GNU ‘make’, you can set the
+ ‘MAKE’ environment variable to whatever is necessary.
- GNU 'make' is required only because of third-party libraries,
+ GNU ‘make’ is required only because of third-party libraries,
notably FreeType. Automake/Autoconf output in general, and the
- TL-maintained directories, work with any reasonable 'make'.(1)
+ TL-maintained directories, work with any reasonable ‘make’.(1)
- * A C++11 compiler is similarly required because of the third-party
- libraries ICU and HarfBuzz (at least); the program 'dvisvgm' also
+ • A C++11 compiler is similarly required because of the third-party
+ libraries ICU and HarfBuzz (at least); the program ‘dvisvgm’ also
requires C++11. It is possible to build what remains with older
compilers, but you have to remove the C++11-dependent sources.
*Note Build one package::.
- * Python is required by ICU tests. (If you know how to disable these
+ • Python is required by ICU tests. (If you know how to disable these
tests and thus eliminate the requirement, please write.)
A few programs in the tree have additional requirements:
-'web2c'
- requires 'perl' for some tests run by 'make check'. Incidentally,
- the TeX Live installer ('install-tl') and manager ('tlmgr') are
+‘web2c’
+ requires ‘perl’ for some tests run by ‘make check’. Incidentally,
+ the TeX Live installer (‘install-tl’) and manager (‘tlmgr’) are
also written in Perl, but this does not matter for compiling the
sources.
-'xdvik'
-'xpdfopen'
+‘xdvik’
+‘xpdfopen’
require X11 headers and libraries, typically in devel(opment)
packages that are not installed by default.
-'xetex'
- requires 'fontconfig' (again both headers and library), or, for
- MacOS only, the 'ApplicationServices' and 'Cocoa' frameworks.
+‘xetex’
+ requires ‘fontconfig’ (again both headers and library), or, for
+ MacOS only, the ‘ApplicationServices’ and ‘Cocoa’ frameworks.
-'xindy'
- requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally,
- to build the rules and/or documentation: 'perl', 'latex',
- 'pdflatex'.
+‘xindy’
+ requires GNU ‘clisp’, ‘libsigsegv’, and ‘libiconv’; additionally,
+ to build the rules and/or documentation: ‘perl’, ‘latex’,
+ ‘pdflatex’.
Lacking the required tools, building these programs must avoided, e.g.,
-'configure --without-x --disable-xetex --disable-xindy'
+‘configure --without-x --disable-xetex --disable-xindy’
Modifying source files induces more requirements, as one might
expect:
- * Modification of any '.y' or '.l' source files requires 'bison' or
- 'flex' to update the corresponding C sources.
+ • Modification of any ‘.y’ or ‘.l’ source files requires ‘bison’ or
+ ‘flex’ to update the corresponding C sources.
- * Modification of the sources for '.info' files requires 'makeinfo'.
+ • Modification of the sources for ‘.info’ files requires ‘makeinfo’.
- * Modification of any part of the build system (M4 macros,
- 'configure.ac', 'Makefile.am', or their fragments) requires GNU M4,
+ • Modification of any part of the build system (M4 macros,
+ ‘configure.ac’, ‘Makefile.am’, or their fragments) requires GNU M4,
GNU Autoconf, GNU Automake, and GNU Libtool to update the generated
files. Furthermore, to reliably reproduce the build files, the
original GNU releases of these tools must be used, not any distro
@@ -218,18 +219,18 @@
packaging of them. *Note Build system tools::, for more
discussion.
- If you haven't modified any source files, and infrastructure tools
-such as 'autoconf' or 'makeinfo' are still being run, check your
-timestamps--notably, 'use-commit-times' must be set to 'yes' in your
+ If you haven’t modified any source files, and infrastructure tools
+such as ‘autoconf’ or ‘makeinfo’ are still being run, check your
+timestamps—notably, ‘use-commit-times’ must be set to ‘yes’ in your
Subversion configuration (*note Build system tools::). No
infrastructure tools are needed to do a normal build (barring bugs).
---------- Footnotes ----------
- (1) There is one exception in TL: the 'tangle-sh' and related rules
-use '$@' to mean the target name, a feature not present in all 'make's.
-This could be alleviated by laborious editing, but since there's no way
-to avoid GNU 'make' for builds of the entire tree, it does not seem
+ (1) There is one exception in TL: the ‘tangle-sh’ and related rules
+use ‘$@’ to mean the target name, a feature not present in all ‘make’s.
+This could be alleviated by laborious editing, but since there’s no way
+to avoid GNU ‘make’ for builds of the entire tree, it does not seem
worth the trouble.
@@ -238,25 +239,25 @@
4 Building
**********
-The top-level 'Build' script is intended to simplify building the
-binaries distributed with TeX Live itself--we call this the "native" TL
-build. It runs 'configure && make world', which builds everything in a
-subdirectory of the main source tree (default 'Work/'), installs
-everything in another subdirectory (default 'inst/'), and finally runs
-'make check'. The exact directory and command names can be specified
+The top-level ‘Build’ script is intended to simplify building the
+binaries distributed with TeX Live itself—we call this the “native” TL
+build. It runs ‘configure && make world’, which builds everything in a
+subdirectory of the main source tree (default ‘Work/’), installs
+everything in another subdirectory (default ‘inst/’), and finally runs
+‘make check’. The exact directory and command names can be specified
via environment variables and a few leading options. All remaining
-arguments (assignments or options) are passed to the 'configure' script.
-Please take a look at the './Build' source file for more information; it
+arguments (assignments or options) are passed to the ‘configure’ script.
+Please take a look at the ‘./Build’ source file for more information; it
is a straightforward shell script.
An alternative, and the one we will mainly discuss here, is to run
-'configure' and 'make' in a suitable empty subdirectory. Building in
+‘configure’ and ‘make’ in a suitable empty subdirectory. Building in
the source directory itself is not supported (sorry).
* Menu:
-* Build iteration:: What 'configure' and 'make' do in TL.
-* Build in parallel:: Simultaneous 'make' processes.
+* Build iteration:: What ‘configure’ and ‘make’ do in TL.
+* Build in parallel:: Simultaneous ‘make’ processes.
* Build distribution:: Making a distribution tarball.
* Build one package:: Example of working on just one program.
* Build one engine:: Example of building just one TeX engine.
@@ -268,22 +269,22 @@
4.1 Build iteration
===================
-Running the top-level 'configure' script configures the top level and
-the subdirectories 'libs', 'utils', and 'texk'. Running 'make' at the
+Running the top-level ‘configure’ script configures the top level and
+the subdirectories ‘libs’, ‘utils’, and ‘texk’. Running ‘make’ at the
top level first iterates over the TeX-specific libraries, and then runs
-'make' in 'libs', 'utils', and 'texk' to iterate over the generic
+‘make’ in ‘libs’, ‘utils’, and ‘texk’ to iterate over the generic
libraries, utility programs, and TeX-specific programs, respectively.
These iterations consist of two steps:
1. For each library or program module not yet configured, run
- 'configure', adding the configure option '--disable-build' if the
- module need not be built, otherwise running 'make all'.
+ ‘configure’, adding the configure option ‘--disable-build’ if the
+ module need not be built, otherwise running ‘make all’.
- 2. For each library or program module that must be built, run 'make'
- for the selected target(s): 'default' or 'all' to (re-)build,
- 'check' to run tests, 'install', etc.
+ 2. For each library or program module that must be built, run ‘make’
+ for the selected target(s): ‘default’ or ‘all’ to (re-)build,
+ ‘check’ to run tests, ‘install’, etc.
- Running the top-level 'make' a second time iterates again over all
+ Running the top-level ‘make’ a second time iterates again over all
the library and program modules, and finds (should find) nothing to be
done.
@@ -293,14 +294,14 @@
4.2 Build in parallel
=====================
-The TL build system carefully formulates dependencies as well as 'make'
-rules when a tool (such as 'tangle', 'ctangle', and 'convert') creates
-several output files. This allows for parallel builds ('make -j N' with
-N>1 or even 'make -j') that can considerably speed up the TL build.
+The TL build system carefully formulates dependencies as well as ‘make’
+rules when a tool (such as ‘tangle’, ‘ctangle’, and ‘convert’) creates
+several output files. This allows for parallel builds (‘make -j N’ with
+N>1 or even ‘make -j’) that can considerably speed up the TL build.
Incidentally, a noticeable speed-up can be independently gained by
-using a configure cache file, i.e., specifying the 'configure' option
-'-C' (recommended).
+using a configure cache file, i.e., specifying the ‘configure’ option
+‘-C’ (recommended).
File: tlbuild.info, Node: Build distribution, Next: Build one package, Prev: Build in parallel, Up: Building
@@ -308,9 +309,9 @@
4.3 Build distribution
======================
-Running 'make dist' at the top level creates a tarball
-'tex-live-YYYY-MM-DD.tar.xz' from the TL source tree. Running 'make
-distcheck' also verifies that this tarball suffices to build and install
+Running ‘make dist’ at the top level creates a tarball
+‘tex-live-YYYY-MM-DD.tar.xz’ from the TL source tree. Running ‘make
+distcheck’ also verifies that this tarball suffices to build and install
all of TL.
This is useful for checking consistency of the source tree and
@@ -324,14 +325,14 @@
4.4 Build one package
=====================
-To build one package, the basic idea is to use the 'configure' option
-'--disable-all-pkgs' (*note --disable-all-pkgs::). Then all program and
+To build one package, the basic idea is to use the ‘configure’ option
+‘--disable-all-pkgs’ (*note --disable-all-pkgs::). Then all program and
library modules are configured but none are made. However, the
-'Makefile's still contain all build rules and dependencies and can be
+‘Makefile’s still contain all build rules and dependencies and can be
invoked to build an individual program or library, first building any
required libraries.
- Here is an example from start to finish for working on 'dvipdfm-x'.
+ Here is an example from start to finish for working on ‘dvipdfm-x’.
Unfortunately, this does not suffice for building the TeX engines; see
the next section.
@@ -355,7 +356,7 @@
cd texk/dvipdfm-x
make check
- # Run the new binary in the buil tree, finding support files
+ # Run the new binary in the build tree, finding support files
# in a separate tree for a TeX Live release YYYY
# (Bourne shell syntax):
TEXMFROOT=/usr/local/texlive/YYYY \
@@ -362,20 +363,20 @@
TEXMFCNF=$TEXMFROOT/texmf-dist/web2c \
./xdvipdfmx ...
- Then you can modify source files in 'mydir/texk/dvipdfm-x' and rerun
-'make' in 'mydir/Work/texk/dvipdfm-x' to rebuild; that build directory
+ Then you can modify source files in ‘mydir/texk/dvipdfm-x’ and rerun
+‘make’ in ‘mydir/Work/texk/dvipdfm-x’ to rebuild; that build directory
is where the binary ends up and where you can run a debugger, etc.
- The second line of the 'configure' invocation shows examples of extra
+ The second line of the ‘configure’ invocation shows examples of extra
things you likely want to specify if you intend to hack the sources (and
-not just build binaries): the '-C' speeds 'configure' by enabling a
-cache file, and the 'CFLAGS' and 'CXXFLAGS' settings eliminate compiler
+not just build binaries): the ‘-C’ speeds ‘configure’ by enabling a
+cache file, and the ‘CFLAGS’ and ‘CXXFLAGS’ settings eliminate compiler
optimization for debugging purposes.
Of course, you need to actually look at the output and check that
-things are working. There are many 'configure' options you can tweak as
-desired; check the output from 'configure --help'. It is also a good
-idea to run 'make check' after making any changes, to ensure that
+things are working. There are many ‘configure’ options you can tweak as
+desired; check the output from ‘configure --help’. It is also a good
+idea to run ‘make check’ after making any changes, to ensure that
whatever tests have been written still pass.
Reducing source download size
@@ -385,10 +386,10 @@
megabytes). It is natural to ask if this is really necessary. Strictly
speaking, the answer is no, but it is vastly more convenient to do so.
If you cut down the source tree, you must also give additional
-'configure' flags to individually disable using system versions of
-libraries, or the intricacies of the dependencies (such as 'teckit'
-requiring 'zlib') will have undesired side effects. For an example of
-this approach, see the 'build-pdftex.sh' script in the 'pdftex'
+‘configure’ flags to individually disable using system versions of
+libraries, or the intricacies of the dependencies (such as ‘teckit’
+requiring ‘zlib’) will have undesired side effects. For an example of
+this approach, see the ‘build-pdftex.sh’ script in the ‘pdftex’
development source (details at <http://pdftex.org>), which is indeed
such a cut-down TL source tree.
@@ -395,10 +396,10 @@
GCC used by default
...................
-By default, the 'gcc' compilers will be used if present; otherwise,
+By default, the ‘gcc’ compilers will be used if present; otherwise,
individual packages may use something different. You can explicitly
-specify the compilers to be used with the environment variables 'CC',
-'CXX', and 'OBJCXX'.
+specify the compilers to be used with the environment variables ‘CC’,
+‘CXX’, and ‘OBJCXX’.
Removing C+11 dependency
........................
@@ -405,28 +406,28 @@
Some libraries and programs require C++11; one such is XeTeX. If you
want to build with an older compiler lacking such support, you need to
-(re)move those source directories; unfortunately, specifying '--disable'
-for them does not suffice. It's also necessary to specify
-'--disable-xetex' explicitly. Specifically, before running 'configure
---disable-xetex ...':
+(re)move those source directories; unfortunately, specifying ‘--disable’
+for them does not suffice. It’s also necessary to specify
+‘--disable-xetex’ explicitly. Specifically, before running ‘configure
+--disable-xetex ...’:
rm -rf libs/icu libs/graphite2 texk/dvisvgm texk/web2c/xetexdir
- Also, even with '--disable-all-pkgs', dependencies are (currently)
+ Also, even with ‘--disable-all-pkgs’, dependencies are (currently)
checked. One notable case: if a (non-MacOS) system does not have
-'fontconfig', XeTeX cannot be built (*note Prerequisites::), and
-'configure' will terminate even with '--disable-xetex'. To proceed
-without such dependencies, specify '--enable-missing' also.
+‘fontconfig’, XeTeX cannot be built (*note Prerequisites::), and
+‘configure’ will terminate even with ‘--disable-xetex’. To proceed
+without such dependencies, specify ‘--enable-missing’ also.
As of 2022, HarfBuzz also requires C++11. Therefore even more would
-have to be disabled and removed, notably including 'luahbtex', the
+have to be disabled and removed, notably including ‘luahbtex’, the
standard engine used for LuaLaTeX. Removing that would not be
acceptable for builds intended for distribution; but perhaps for testing
the above information could still be useful.
- In general, the TL 'configure' will run in all directories.
+ In general, the TL ‘configure’ will run in all directories.
Therefore a general workaround for build problems is to remove failing
-directories from the tree, and also specify the relevant '--disable-...'
+directories from the tree, and also specify the relevant ‘--disable-...’
option(s).
Patches to improve all this would be most welcome.
@@ -454,21 +455,21 @@
cd texk/web2c # cd engine build directory
make tex # must specify target
- The first 'make' run will configure everything, and even build the
+ The first ‘make’ run will configure everything, and even build the
libraries, even though the packages are disabled.
The source tree can be cut down to just what is needed for the given
engine (the separate pdfTeX and LuaTeX source repositories do this, for
example), but see caveats in previous section. When the
-'--disable-xetex' and '--enable-missing' options are needed is also
+‘--disable-xetex’ and ‘--enable-missing’ options are needed is also
explained in the previous section.
If you want to debug an X-related program or shared library setup, or
-other variants, change the 'configure' options accordingly. Either
-'../Build' or '../configure' can be run.
+other variants, change the ‘configure’ options accordingly. Either
+‘../Build’ or ‘../configure’ can be run.
- Then it is necessary to again specify the target engine ('tex', in
-the above) in the 'make'.
+ Then it is necessary to again specify the target engine (‘tex’, in
+the above) in the ‘make’.
All these complications are rather unfortunate. Patches are welcome.
@@ -475,24 +476,24 @@
Testing one engine
..................
-To run only the tests for a given engine, say 'hitex':
+To run only the tests for a given engine, say ‘hitex’:
make -C $ww check SUBDIRS=. TESTS='$(hitex_tests)'
-where '$ww' is the web2c build directory, that is,
-'ww=/wherever/Build/source/Work/texk/web2c'.
+where ‘$ww’ is the web2c build directory, that is,
+‘ww=/wherever/Build/source/Work/texk/web2c’.
- It's also possible to run individual tests the same way, using the
-test name exactly as specified in the '.am' file:
+ It’s also possible to run individual tests the same way, using the
+test name exactly as specified in the ‘.am’ file:
make -C $ww check SUBDIRS=. TESTS=hitexdir/tests/hello.test
- If you get tired of looking at the 'Entering'/'Leaving directory'
-lines, you can add the (GNU) make option '--no-print-dir'.
+ If you get tired of looking at the ‘Entering’/‘Leaving directory’
+lines, you can add the (GNU) make option ‘--no-print-dir’.
You may find it useful to put lengthy incantations like this into a
-trivial shell script with a short name (say, 'hitst'). Then you just
-run 'hitst' and edit the file when necessary to change things around.
+trivial shell script with a short name (say, ‘hitst’). Then you just
+run ‘hitst’ and edit the file when necessary to change things around.
File: tlbuild.info, Node: Cross compilation, Prev: Build one engine, Up: Building
@@ -500,21 +501,21 @@
4.6 Cross compilation
=====================
-In a cross compilation a "build" system is used to create binaries to be
-executed on a "host" system with different hardware and/or operating
+In a cross compilation a “build” system is used to create binaries to be
+executed on a “host” system with different hardware and/or operating
system.
In simple cases, the build system can execute binaries for the host
system. This typically occurs for bi-arch systems where, e.g.,
-'i386-linux' binaries can run on 'x86_64-linux' systems and 'win32'
-binaries can run on 'win64' systems. Although sometimes called "native
-cross", technically this is not cross compilation at all. In most such
+‘i386-linux’ binaries can run on ‘x86_64-linux’ systems and ‘win32’
+binaries can run on ‘win64’ systems. Although sometimes called “native
+cross”, technically this is not cross compilation at all. In most such
cases it suffices to specify suitable compiler flags. It might be
-useful to add the configure option '--build=HOST' to get the correct
-canonical host name, but note that this should _not_ be '--host=HOST'
+useful to add the configure option ‘--build=HOST’ to get the correct
+canonical host name, but note that this should _not_ be ‘--host=HOST’
(*note (autoconf)Hosts and Cross-Compilation::).
- In order to build, e.g., 32-bit binaries with 'clang' on a 64-bit
+ In order to build, e.g., 32-bit binaries with ‘clang’ on a 64-bit
MacOS system one could use:
TL_BUILD_ENV="CC='clang -arch i386' \
@@ -535,13 +536,13 @@
In a standard cross compilation, binaries for the host system cannot
execute on the build system and it is necessary to specify the configure
-options '--host=HOST' and '--build=BUILD' with two different values.
+options ‘--host=HOST’ and ‘--build=BUILD’ with two different values.
- Building binaries requires suitable "cross" tools, e.g., compiler,
-linker, and archiver, and perhaps a "cross" version of 'pkg-config' and
+ Building binaries requires suitable “cross” tools, e.g., compiler,
+linker, and archiver, and perhaps a “cross” version of ‘pkg-config’ and
similar to locate host system libraries. Autoconf expects that these
cross tools are given by their usual variables or found under their
-usual name prefixed with 'HOST-'. Here a list of such tools and
+usual name prefixed with ‘HOST-’. Here a list of such tools and
corresponding variables:
ar AR
@@ -554,8 +555,8 @@
ranlib RANLIB
strip STRIP
-In order to, e.g., build 'mingw32' binaries on 'x86_64-linux' with a
-cross compiler found as 'i386-pc-mingw32-gcc' one would specify
+In order to, e.g., build ‘mingw32’ binaries on ‘x86_64-linux’ with a
+cross compiler found as ‘i386-pc-mingw32-gcc’ one would specify
--host=i386-pc-mingw32 --build=x86_64-linux-gnu
@@ -563,9 +564,9 @@
--host=mingw32 --build=x86_64-linux CC=i386-pc-mingw32-gcc
-but this latter, especially, might require adding 'CXX' and others.
+but this latter, especially, might require adding ‘CXX’ and others.
- Configure arguments such as 'CFLAGS=...' refer to the cross compiler.
+ Configure arguments such as ‘CFLAGS=...’ refer to the cross compiler.
If necessary, you can specify compilers and flags for the few auxiliary
C and C++ programs required for the build process as configure arguments
@@ -585,7 +586,7 @@
The fact that binaries for the host system cannot be executed on the
build system causes some problems.
- One problem is that configure tests using 'AC_RUN_IFELSE' can compile
+ One problem is that configure tests using ‘AC_RUN_IFELSE’ can compile
and link the test program but cannot execute it. Such tests should be
avoided if possible and otherwise must supply a pessimistic test result.
@@ -592,24 +593,24 @@
Another problem arises if the build process must execute some
(auxiliary or installable) programs. Auxiliary programs can be placed
into a subdirectory that is configured natively as is done for
-'texk/web2c/web2c', 'texk/dvipsk/squeeze', and 'texk/xdvik/squeeze'.
-The module 'libs/freetype2' uses the value of 'CC_BUILD', 'BUILD-gcc',
-'gcc', or 'cc' as the compiler for the auxiliary program.
+‘texk/web2c/web2c’, ‘texk/dvipsk/squeeze’, and ‘texk/xdvik/squeeze’.
+The module ‘libs/freetype2’ uses the value of ‘CC_BUILD’, ‘BUILD-gcc’,
+‘gcc’, or ‘cc’ as the compiler for the auxiliary program.
The situation for installable programs needed by the build process is
somewhat different. A rather expensive possibility, chosen for the ICU
-libraries in module 'libs/icu', is to first compile natively for the
+libraries in module ‘libs/icu’, is to first compile natively for the
build system and in a second step to use these (uninstalled) programs
during the cross compilation.
- This approach would also be possible for the tools such as 'tangle'
-used in the module 'texk/web2c' to build the WEB programs, but that
-would require first building a native 'kpathsea' library. To avoid this
+ This approach would also be possible for the tools such as ‘tangle’
+used in the module ‘texk/web2c’ to build the WEB programs, but that
+would require first building a native ‘kpathsea’ library. To avoid this
complication, cross compilation of programs written in (C)WEB requires
-sufficiently recent installed versions of 'tangle', 'ctangle',
-'otangle', and 'tie'.
+sufficiently recent installed versions of ‘tangle’, ‘ctangle’,
+‘otangle’, and ‘tie’.
- Building 'xindy' requires running the host system 'clisp' binary,
+ Building ‘xindy’ requires running the host system ‘clisp’ binary,
thus cross compilation is painful, but possible.
@@ -618,22 +619,22 @@
5 Installing
************
-This section discusses the results of 'make install' in the source tree.
+This section discusses the results of ‘make install’ in the source tree.
- The main consideration is that 'make install' is not enough to make a
+ The main consideration is that ‘make install’ is not enough to make a
usable TeX installation. Beyond the compiled binaries, (thousands of)
-support files are needed; just as a first example, 'plain.tex' is not in
+support files are needed; just as a first example, ‘plain.tex’ is not in
the source tree.
These support files are maintained completely independently and are
not present in the TL source tree. The best basis for dealing with them
-is the TeX Live (plain text) database in 'Master/tlpkg/texlive.tlpdb',
-and/or the TeX Live installer, 'install-tl'. More information is under
-'Master/tlpkg' and at <https://tug.org/texlive/distro.html>.
+is the TeX Live (plain text) database in ‘Master/tlpkg/texlive.tlpdb’,
+and/or the TeX Live installer, ‘install-tl’. More information is under
+‘Master/tlpkg’ and at <https://tug.org/texlive/distro.html>.
* Menu:
-* Installation directories:: The prefix, 'bindir', etc., directories.
+* Installation directories:: The prefix, ‘bindir’, etc., directories.
* Linked scripts:: Scripts not maintained in the sources.
* Distro builds:: Configuring and building for OS distributions.
@@ -643,15 +644,15 @@
5.1 Installation directories
============================
-Running 'make install' (or 'make install-strip') installs executables in
-'BINDIR', libraries in 'LIBDIR', headers in 'INCLUDEDIR', general data
-(including "linked scripts", *note Linked scripts::) in
-'DATAROOTDIR/texmf-dist', man pages in 'MANDIR', and Info files in
-'INFODIR'.
+Running ‘make install’ (or ‘make install-strip’) installs executables in
+‘BINDIR’, libraries in ‘LIBDIR’, headers in ‘INCLUDEDIR’, general data
+(including “linked scripts”, *note Linked scripts::) in
+‘DATAROOTDIR/texmf-dist’, man pages in ‘MANDIR’, and Info files in
+‘INFODIR’.
- The values of these directories are determined by 'configure' and can
-be specified explicitly as options such as '--prefix=PREFIX' or
-'--bindir=BINDIR'; otherwise, they are given by their usual Autoconf
+ The values of these directories are determined by ‘configure’ and can
+be specified explicitly as options such as ‘--prefix=PREFIX’ or
+‘--bindir=BINDIR’; otherwise, they are given by their usual Autoconf
defaults:
PREFIX /usr/local
@@ -665,22 +666,22 @@
except possibly modified as follows:
- * If the option '--enable-multiplatform' is given, '/PLATFORM' (i.e.,
- the canonical platform name) is appended to 'BINDIR' and 'LIBDIR'.
+ • If the option ‘--enable-multiplatform’ is given, ‘/PLATFORM’ (i.e.,
+ the canonical platform name) is appended to ‘BINDIR’ and ‘LIBDIR’.
This is implied for a native TL build.
- * In a native TL build, 'DATAROOTDIR' is set to 'PREFIX', 'INFODIR'
- is set to 'PREFIX/texmf-dist/doc/info', and 'MANDIR' to
- 'PREFIX/texmf-dist/doc/man', corresponding to the directories used
+ • In a native TL build, ‘DATAROOTDIR’ is set to ‘PREFIX’, ‘INFODIR’
+ is set to ‘PREFIX/texmf-dist/doc/info’, and ‘MANDIR’ to
+ ‘PREFIX/texmf-dist/doc/man’, corresponding to the directories used
in the TL distribution.
-The top-level 'configure' script displays all these installation paths.
+The top-level ‘configure’ script displays all these installation paths.
- For the native TL build, the 'Build' script leaves the binaries in
-'./inst/bin/STD-SYSTEM-TRIPLET'. The new binaries are not directly
+ For the native TL build, the ‘Build’ script leaves the binaries in
+‘./inst/bin/STD-SYSTEM-TRIPLET’. The new binaries are not directly
usable from that location; they need to be copied to
-'Master/bin/TL-PLATFORM'. The other files and directories that end up
-in './inst/' are ignored.
+‘Master/bin/TL-PLATFORM’. The other files and directories that end up
+in ‘./inst/’ are ignored.
File: tlbuild.info, Node: Linked scripts, Next: Distro builds, Prev: Installation directories, Up: Installing
@@ -691,26 +692,26 @@
Quite a few executables are architecture-independent shell, Perl, or
other interpreted scripts, rather than compiled binaries. A few are
maintained as part of the TL source tree, but most are maintained
-elsewhere with copies under 'texk/texlive/linked_scripts'.
+elsewhere with copies under ‘texk/texlive/linked_scripts’.
- These so-called "linked scripts" are installed under
-'DATAROOTDIR/texmf-dist/scripts'; for Unix-like systems a symbolic link
-is made in 'BINDIR'. For example, a symlink points from 'BINDIR/ps2eps'
-to 'DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl'. For Windows, a
-standard wrapper binary (copied to, e.g., 'BINDIR/ps2eps.exe') serves
+ These so-called “linked scripts” are installed under
+‘DATAROOTDIR/texmf-dist/scripts’; for Unix-like systems a symbolic link
+is made in ‘BINDIR’. For example, a symlink points from ‘BINDIR/ps2eps’
+to ‘DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl’. For Windows, a
+standard wrapper binary (copied to, e.g., ‘BINDIR/ps2eps.exe’) serves
the same purpose. The source for the wrapper is in
-'texk/texlive/w32_wrapper'.
+‘texk/texlive/w32_wrapper’.
One reason for this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
- Most important of all, we want the 'BINDIR' resulting from the build
+ Most important of all, we want the ‘BINDIR’ resulting from the build
to be as close as possible to what is in the TL distribution. At
-present, there are a few exceptions--Asymptote, Biber, Xindy--and each
-one creates considerable extra work. We don't want to add more. (See
+present, there are a few exceptions—Asymptote, Biber, Xindy—and each one
+creates considerable extra work. We don’t want to add more. (See
<https://tug.org/texlive/build.html> for information about building
-those exceptions, as well as the 'xz' and 'wget' programs that are used
+those exceptions, as well as the ‘xz’ and ‘wget’ programs that are used
in the TL infrastructure.)
@@ -721,50 +722,50 @@
Although they use the same code base, building for the native TL
distribution as shipped by the TeX user groups is typically quite
-different from a "distro" build needed by, e.g., a full GNU/Linux or BSD
+different from a “distro” build needed by, e.g., a full GNU/Linux or BSD
operating system distribution.
The native TL distribution uses shared libraries only when absolutely
-necessary ('libc', 'libm', X11 libraries, and 'libfontconfig'). In
+necessary (‘libc’, ‘libm’, X11 libraries, and ‘libfontconfig’). In
contrast, a distro typically wants to use as many shared libraries as
possible from elsewhere on the system, including TeX-specific libraries
-such as 'libkpathsea' (even though Kpathsea has never officially been
+such as ‘libkpathsea’ (even though Kpathsea has never officially been
released as a shared library). In addition, the installation paths
will, in general, be completely different.
- Here are the 'configure' options that distro builds are likely to
+ Here are the ‘configure’ options that distro builds are likely to
find most relevant:
-'--disable-native-texlive-build'
+‘--disable-native-texlive-build’
This must be specified to avoid interference from the many tweaks
we do for the native TL build.
-'--with-banner-add=/SOMEDISTRO'
- This isn't technically required, but is strongly recommended, so
+‘--with-banner-add=/SOMEDISTRO’
+ This isn’t technically required, but is strongly recommended, so
your build and your distro can be distinguished from others.
-'--enable-shared'
+‘--enable-shared’
Build shared versions of the TeX-specific libraries (uses
- 'libtool').
+ ‘libtool’).
-'--disable-static'
+‘--disable-static’
Do not build the static versions of the TeX-specific libraries.
-'--with-system-LIB'
- Look for and use a system version of the library LIB. 'configure
- --help' will give you the list of possibilities.
+‘--with-system-LIB’
+ Look for and use a system version of the library LIB. ‘configure
+ --help’ will give you the list of possibilities.
-'--with-LIB-includes=DIR'
-'--with-LIB-libdir=DIR'
+‘--with-LIB-includes=DIR’
+‘--with-LIB-libdir=DIR’
If needed, allows you to specify where the headers/code are for the
given library LIB.
-'--prefix=/usr'
-'--prefix=/opt/TeXLive'
- Or whatever your convention is. The default is '/usr/local' and
- you shouldn't install there for a distro.
+‘--prefix=/usr’
+‘--prefix=/opt/TeXLive’
+ Or whatever your convention is. The default is ‘/usr/local’ and
+ you shouldn’t install there for a distro.
-'--libdir=\${exec_prefix}/lib64'
+‘--libdir=\${exec_prefix}/lib64’
May be needed for 64-bit bi-architecture (GNU/Linux) systems.
You will need to take care of the support files mentioned above
@@ -781,9 +782,9 @@
6 Layout and infrastructure
***************************
-The TeX Live source tree is the subtree rooted at 'Build/source' of the
+The TeX Live source tree is the subtree rooted at ‘Build/source’ of the
complete TL distribution and contains the sources for all executables
-distributed by TL, as well as 'configure' scripts and 'make' rules to
+distributed by TL, as well as ‘configure’ scripts and ‘make’ rules to
build and install them together with some of their support files.
* Menu:
@@ -803,15 +804,15 @@
As mentioned above (*note Prerequisites::), a normal build has few
requirements. On the other hand, if you want to modify the TeX Live
-infrastructure sources, such as 'configure.ac' or 'Makefile.am' files,
+infrastructure sources, such as ‘configure.ac’ or ‘Makefile.am’ files,
you will need to have several additional tools installed.
In general, the TL build system uses the latest released versions of
the GNU build tools, installed directly from the original GNU releases
-(e.g., by building them with 'configure --prefix=/usr/local/gnu' and
-having 'PATH' start with '/usr/local/gnu/bin'). We have found that
+(e.g., by building them with ‘configure --prefix=/usr/local/gnu’ and
+having ‘PATH’ start with ‘/usr/local/gnu/bin’). We have found that
trying to use the versions of these tools packaged for distros causes
-many extra hassles, so don't do that, tempting as it may be.
+many extra hassles, so don’t do that, tempting as it may be.
Currently the versions we use are:
@@ -819,30 +820,30 @@
automake (GNU automake) 1.16.5
bison (GNU Bison) 3.8.2
flex 2.6.0
- ltmain.sh (GNU libtool) 2.4.6
+ ltmain.sh (GNU libtool) 2.4.7
m4 (GNU M4) 1.4.19
- makeinfo (GNU texinfo) 6.7
+ makeinfo (GNU texinfo) 7.0.2
These versions should be used to update the generated files (e.g.,
-'configure' or 'Makefile.in') in all or parts of the TL tree after their
+‘configure’ or ‘Makefile.in’) in all or parts of the TL tree after their
dependencies have been changed. This can be done explicitly with the
-top-level 'reautoconf' script or implicitly by using the configure
-option '--enable-maintainer-mode'.
+top-level ‘reautoconf’ script or implicitly by using the configure
+option ‘--enable-maintainer-mode’.
It has often turned out that the bison and flex versions are not
-critical; however, the autotools versions are. If you don't have the
+critical; however, the autotools versions are. If you don’t have the
given versions, get them before modifying the build infrastructure.
The files in the Subversion repository (see
<https://tug.org/texlive/svn>) are all up to date (barring bugs). For
this to be reflected by their timestamps in your checkout, be sure to
-set 'use-commit-times=yes' in '~/.subversion/config' or the equivalent.
+set ‘use-commit-times=yes’ in ‘~/.subversion/config’ or the equivalent.
If timestamps are wrong, you may also be able to avoid unnecessary
-runs of 'bison', 'flex', or 'makeinfo' with 'touch' of the generated
-('.c', '.h', or '.info') files. With '--enable-maintainer-mode' it may
-also be necessary to 'touch' first 'aclocal.m4', then 'configure' and
-'config.h.in' (or 'c-auto.in'), and finally all 'Makefile.in' files.
+runs of ‘bison’, ‘flex’, or ‘makeinfo’ with ‘touch’ of the generated
+(‘.c’, ‘.h’, or ‘.info’) files. With ‘--enable-maintainer-mode’ it may
+also be necessary to ‘touch’ first ‘aclocal.m4’, then ‘configure’ and
+‘config.h.in’ (or ‘c-auto.in’), and finally all ‘Makefile.in’ files.
File: tlbuild.info, Node: Top-level directories, Next: Autoconf macros, Prev: Build system tools, Up: Layout and infrastructure
@@ -854,39 +855,39 @@
source tree.
As mentioned at the beginning of *note Overview of build system::,
-the main source directories are 'texk/' (TeX-specific programs and
-libraries), 'utils/' (additional programs), and 'libs/' (generic
+the main source directories are ‘texk/’ (TeX-specific programs and
+libraries), ‘utils/’ (additional programs), and ‘libs/’ (generic
libraries).
- In addition, the top-level directories 'am/' and 'm4/' contain
-'Makefile.am' fragments and Autoconf macros, respectively, used in many
-places. Specifically, the file 'm4/kpse-pkgs.m4' contains lists of all
+ In addition, the top-level directories ‘am/’ and ‘m4/’ contain
+‘Makefile.am’ fragments and Autoconf macros, respectively, used in many
+places. Specifically, the file ‘m4/kpse-pkgs.m4’ contains lists of all
program and library modules; missing modules are silently ignored.
(This helps in creating cut-down source trees.)
Each module contributes fragments (in separate files) defining its
-capabilities and requirements to the 'configure.ac' scripts at the
-top-level and in the subdirectories 'libs', 'utils', and 'texk'. The
-fragments from program modules supply 'configure' options to disable or
+capabilities and requirements to the ‘configure.ac’ scripts at the
+top-level and in the subdirectories ‘libs’, ‘utils’, and ‘texk’. The
+fragments from program modules supply ‘configure’ options to disable or
enable building them; those from library modules specify if an installed
(system) version of that library can be used. This ultimately
-determines which modules need to be built--although all modules must be
-configured for the benefit of 'make' targets such as 'dist' or
-'distcheck'.
+determines which modules need to be built—although all modules must be
+configured for the benefit of ‘make’ targets such as ‘dist’ or
+‘distcheck’.
- The top-level 'build-aux/' directory contains the common files
-'compile', 'config.guess', 'config.sub', 'depcomp', etc. used by most
+ The top-level ‘build-aux/’ directory contains the common files
+‘compile’, ‘config.guess’, ‘config.sub’, ‘depcomp’, etc. used by most
packages. These are taken from the GNU Gnulib sources
(<https://www.gnu.org/software/gnulib>), which in turn synchronizes with
any ultimate upstream repository. There are independent copies of some
of these in a few other places, e.g.,
-'libs/freetype2/freetype-*/builds/unix/'. The 'reautoconf' script does
+‘libs/freetype2/freetype-*/builds/unix/’. The ‘reautoconf’ script does
not touch those, but a TL cron job keeps them in sync (nightly).
- When the top-level './Build' script is used to build TL, two more two
-more top-level directories appear: 'Work/' for the build tree, and
-'inst/' for the install tree (from 'make install'). These names (and
-everything else about 'Build''s operation) can be changed by setting
+ When the top-level ‘./Build’ script is used to build TL, two more two
+more top-level directories appear: ‘Work/’ for the build tree, and
+‘inst/’ for the install tree (from ‘make install’). These names (and
+everything else about ‘Build’’s operation) can be changed by setting
environment variables before running it; see the script source.
@@ -896,9 +897,9 @@
===================
Here we describe a few of the Autoconf macros used in several
-modules--many more are defined in the sources; see the top-level 'm4/'
+modules—many more are defined in the sources; see the top-level ‘m4/’
directory. These general macros are supplemented by module-specific
-macros in directories such as 'texk/dvipng/m4/'; some of those are
+macros in directories such as ‘texk/dvipng/m4/’; some of those are
described in following sections (*note Library modules:: and *note
Program modules::).
@@ -921,18 +922,18 @@
-- Macro: KPSE_BASIC (NAME, [MORE-OPTIONS])
Initialize the basic TL infrastructure for module NAME:
- 'AM_INIT_AUTOMAKE([foreign MORE-OPTIONS])'
- 'AM_MAINTAINER_MODE'
- 'KPSE_COMPILER_WARNINGS'
+ ‘AM_INIT_AUTOMAKE([foreign MORE-OPTIONS])’
+ ‘AM_MAINTAINER_MODE’
+ ‘KPSE_COMPILER_WARNINGS’
and make sure the C compiler understands function prototypes. This
is used for all generic library and program modules.
-- Macro: KPSE_COMMON (NAME, [MORE-OPTIONS])
- Like 'KPSE_BASIC' but add:
- 'LT_PREREQ([2.2.6])'
- 'LT_INIT([win32-dll])'
- 'AC_SYS_LARGEFILE'
- 'AC_FUNC_FSEEKO'
+ Like ‘KPSE_BASIC’ but add:
+ ‘LT_PREREQ([2.2.6])’
+ ‘LT_INIT([win32-dll])’
+ ‘AC_SYS_LARGEFILE’
+ ‘AC_FUNC_FSEEKO’
along with checks for frequently used functions, headers, types,
and structures. This is used for TeX-specific modules.
@@ -945,20 +946,20 @@
Macros for program checks:
-- Macro: KPSE_CHECK_LATEX
- Set 'LATEX' to the first of 'latex', 'elatex', or 'lambda' which
- exists in 'PATH', or to 'no' if none of them exists. Call
- 'AC_SUBST' for 'LATEX'. The result of this test can be overridden
- by setting the 'LATEX' environment variable or the cache variable
- 'ac_cv_prog_LATEX'.
+ Set ‘LATEX’ to the first of ‘latex’, ‘elatex’, or ‘lambda’ which
+ exists in ‘PATH’, or to ‘no’ if none of them exists. Call
+ ‘AC_SUBST’ for ‘LATEX’. The result of this test can be overridden
+ by setting the ‘LATEX’ environment variable or the cache variable
+ ‘ac_cv_prog_LATEX’.
-- Macro: KPSE_CHECK_PDFLATEX
- Check for 'pdflatex' in 'PATH' and set 'PDFLATEX'.
+ Check for ‘pdflatex’ in ‘PATH’ and set ‘PDFLATEX’.
-- Macro: KPSE_CHECK_PERL
- Check for 'perl' or 'perl5' in 'PATH' and set 'PERL'.
+ Check for ‘perl’ or ‘perl5’ in ‘PATH’ and set ‘PERL’.
-- Macro: KPSE_PROG_LEX
- Call 'AC_PROG_LEX' and add the flag '-l' for 'flex'.
+ Call ‘AC_PROG_LEX’ and add the flag ‘-l’ for ‘flex’.
File: tlbuild.info, Node: Macros for compilers, Next: Macros for libraries, Prev: Macros for programs, Up: Autoconf macros
@@ -970,30 +971,30 @@
-- Macro: KPSE_COMPILER_WARNINGS
When using the (Objective) C/C++ compiler, set
- 'WARNING_[OBJ]C[XX]FLAGS' to suitable warning flags (depending on
- the value given to or implied for '--enable-compiler-warnings').
- Call 'AC_SUBST' for them. At present this assumes GNU compiler
+ ‘WARNING_[OBJ]C[XX]FLAGS’ to suitable warning flags (depending on
+ the value given to or implied for ‘--enable-compiler-warnings’).
+ Call ‘AC_SUBST’ for them. At present this assumes GNU compiler
warning options, but could be extended to others if necessary.
- This macro caches its results in the 'kpse_cv_warning_cflags', ...
+ This macro caches its results in the ‘kpse_cv_warning_cflags’, ...
variables.
-- Macro: KPSE_COMPILER_VISIBILITY
When using the C or C++ compiler, try to set
- 'VISIBILITY_C[XX]FLAGS' to flags to hide external symbols. Call
- 'AC_SUBST' for this variable. At present this only tests for the
- compiler option '-fvisibility=hidden', but could be extended if
+ ‘VISIBILITY_C[XX]FLAGS’ to flags to hide external symbols. Call
+ ‘AC_SUBST’ for this variable. At present this only tests for the
+ compiler option ‘-fvisibility=hidden’, but could be extended if
necessary.
- This macro caches its results in the 'kpse_cv_visibility_cflags' or
- 'kpse_cv_visibility_cxxflags' variable.
+ This macro caches its results in the ‘kpse_cv_visibility_cflags’ or
+ ‘kpse_cv_visibility_cxxflags’ variable.
-- Macro: KPSE_CXX_HACK
- Provide the configure option '--enable-cxx-runtime-hack'. If
- enabled and when using 'g++', try to statically link with
- 'libstdc++', notably improving portability of the resulting binary.
+ Provide the configure option ‘--enable-cxx-runtime-hack’. If
+ enabled and when using ‘g++’, try to statically link with
+ ‘libstdc++’, notably improving portability of the resulting binary.
- This macro caches its result in the 'kpse_cv_cxx_hack' variable.
+ This macro caches its result in the ‘kpse_cv_cxx_hack’ variable.
File: tlbuild.info, Node: Macros for libraries, Next: Macros for library and header flags, Prev: Macros for compilers, Up: Autoconf macros
@@ -1004,8 +1005,8 @@
One macro for a library check:
-- Macro: KPSE_LARGEFILE (VARIABLE, [EXTRA-DEFINE])
- Call 'AC_SYS_LARGEFILE' and 'AC_FUNC_FSEEKO' and append suitable
- '-D' flags (optionally including '-DEXTRA-DEFINE') to VARIABLE.
+ Call ‘AC_SYS_LARGEFILE’ and ‘AC_FUNC_FSEEKO’ and append suitable
+ ‘-D’ flags (optionally including ‘-DEXTRA-DEFINE’) to VARIABLE.
File: tlbuild.info, Node: Macros for library and header flags, Next: Macros for Windows, Prev: Macros for libraries, Up: Autoconf macros
@@ -1013,33 +1014,33 @@
6.3.5 Macros for library and header flags
-----------------------------------------
-Each library module 'libs/LIB' or 'texk/LIB' is supplemented by a macro
-'KPSE_LIB_FLAGS' (all uppercase) that provides make variables for that
-library. E.g., for 'libs/libpng':
+Each library module ‘libs/LIB’ or ‘texk/LIB’ is supplemented by a macro
+‘KPSE_LIB_FLAGS’ (all uppercase) that provides make variables for that
+library. E.g., for ‘libs/libpng’:
-- Macro: KPSE_LIBPNG_FLAGS
- Provide the configure option '--with-system-libpng'. Set and
- 'AC_SUBST' 'make' variables for modules using this library (either
+ Provide the configure option ‘--with-system-libpng’. Set and
+ ‘AC_SUBST’ ‘make’ variables for modules using this library (either
an installed version or from the TeX Live tree):
- 'LIBPNG_INCLUDES' for use in 'CPPFLAGS',
- 'LIBPNG_LIBS' for use in 'LDADD',
- 'LIBPNG_DEPEND' for use as a Makefile dependency,
- 'LIBPNG_RULE' for the 'make' rules to rebuild the library.
+ ‘LIBPNG_INCLUDES’ for use in ‘CPPFLAGS’,
+ ‘LIBPNG_LIBS’ for use in ‘LDADD’,
+ ‘LIBPNG_DEPEND’ for use as a Makefile dependency,
+ ‘LIBPNG_RULE’ for the ‘make’ rules to rebuild the library.
-- Macro: KPSE_ADD_FLAGS (NAME)
- Temporarily extend 'CPPFLAGS' and 'LIBS' with the values required
- for the library module 'NAME'.
+ Temporarily extend ‘CPPFLAGS’ and ‘LIBS’ with the values required
+ for the library module ‘NAME’.
-- Macro: KPSE_RESTORE_FLAGS
- Restore 'CPPFLAGS' and 'LIBS' to their original values.
+ Restore ‘CPPFLAGS’ and ‘LIBS’ to their original values.
- As an example, the 'configure.ac' file for a hypothetical program
-'utils/foo' using 'libpng', and hence 'zlib', would contain
+ As an example, the ‘configure.ac’ file for a hypothetical program
+‘utils/foo’ using ‘libpng’, and hence ‘zlib’, would contain
KPSE_ZLIB_FLAGS
KPSE_LIBPNG_FLAGS
-and its 'Makefile.am' would be along these lines:
+and its ‘Makefile.am’ would be along these lines:
bin_PROGRAMS = foo
AM_CPPFLAGS = ${LIBPNG_INCLUDES} ${ZLIB_INCLUDES}
foo_LDADD = ${LIBPNG_LIBS} ${ZLIB_LIBS}
@@ -1049,13 +1050,13 @@
## Rebuild libpng
@LIBPNG_RULE@
- If it were necessary to examine whether certain 'zlib' or 'libpng'
-features were available, 'configure.ac' should be continued this way:
+ If it were necessary to examine whether certain ‘zlib’ or ‘libpng’
+features were available, ‘configure.ac’ should be continued this way:
KPSE_ADD_FLAGS([zlib])
- ... # tests for 'zlib' features, if any
+ ... # tests for ‘zlib’ features, if any
KPSE_ADD_FLAGS([libpng])
- ... # tests for 'libpng' features
- KPSE_RESTORE_FLAGS # restore 'CPPFLAGS' and 'LIBS'
+ ... # tests for ‘libpng’ features
+ KPSE_RESTORE_FLAGS # restore ‘CPPFLAGS’ and ‘LIBS’
File: tlbuild.info, Node: Macros for Windows, Prev: Macros for library and header flags, Up: Autoconf macros
@@ -1067,33 +1068,33 @@
due to the lack of symbolic links.
-- Macro: KPSE_CHECK_WIN32
- Check if compiling for a Windows system. The result is either 'no'
- for Unix-like systems (including Cygwin), 'mingw32' for Windows
- with GCC, or 'native' for Windows with MSVC. The result is cached
- in the 'kpse_cv_have_win32' variable.
+ Check if compiling for a Windows system. The result is either ‘no’
+ for Unix-like systems (including Cygwin), ‘mingw32’ for Windows
+ with GCC, or ‘native’ for Windows with MSVC. The result is cached
+ in the ‘kpse_cv_have_win32’ variable.
-- Macro: KPSE_COND_WIN32
- Call 'KPSE_CHECK_WIN32' and define the Automake conditional 'WIN32'
- ('true' if the value of 'kpse_cv_have_win32' is not 'no').
+ Call ‘KPSE_CHECK_WIN32’ and define the Automake conditional ‘WIN32’
+ (‘true’ if the value of ‘kpse_cv_have_win32’ is not ‘no’).
-- Macro: KPSE_COND_MINGW32
- Call 'KPSE_COND_WIN32' and define the Automake conditional
- 'MINGW32' ('true' if the value of 'kpse_cv_have_win32' is
- 'mingw32').
+ Call ‘KPSE_COND_WIN32’ and define the Automake conditional
+ ‘MINGW32’ (‘true’ if the value of ‘kpse_cv_have_win32’ is
+ ‘mingw32’).
-- Macro: KPSE_COND_WIN32_WRAP
- Call 'KPSE_COND_WIN32' and define the Automake conditional
- 'WIN32_WRAP' ('true' if the standard Windows wrapper
- ('texk/texlive/w32_wrapper/runscript.exe') exists. This wrapper is
- used on Windows instead of symlinks for the "linked scripts" (*note
+ Call ‘KPSE_COND_WIN32’ and define the Automake conditional
+ ‘WIN32_WRAP’ (‘true’ if the standard Windows wrapper
+ (‘texk/texlive/w32_wrapper/runscript.exe’) exists. This wrapper is
+ used on Windows instead of symlinks for the “linked scripts” (*note
Linked scripts::).
-- Macro: KPSE_WIN32_CALL
- Call 'KPSE_COND_WIN32' and check if the file
- 'texk/texlive/w32_wrapper/callexe.c' exists; if it does, create a
- symlink in the build tree. Compiling 'callexe.c' with
- '-DEXEPROG='"FOO.exe"'' and installing 'callexe.exe' as 'BAR.exe'
- is used on Windows instead of a symlink 'BAR->FOO' for Unix-like
+ Call ‘KPSE_COND_WIN32’ and check if the file
+ ‘texk/texlive/w32_wrapper/callexe.c’ exists; if it does, create a
+ symlink in the build tree. Compiling ‘callexe.c’ with
+ ‘-DEXEPROG='"FOO.exe"'’ and installing ‘callexe.exe’ as ‘BAR.exe’
+ is used on Windows instead of a symlink ‘BAR->FOO’ for Unix-like
systems.
@@ -1108,27 +1109,27 @@
* Menu:
-* png library:: 'libs/libpng'
-* zlib library:: 'libs/zlib'
-* freetype library:: 'libs/freetype2'
-* kpathsea library:: 'texk/kpathsea'
+* png library:: ‘libs/libpng’
+* zlib library:: ‘libs/zlib’
+* freetype library:: ‘libs/freetype2’
+* kpathsea library:: ‘texk/kpathsea’
File: tlbuild.info, Node: png library, Next: zlib library, Up: Library modules
-6.4.1 The 'png' library in 'libs/libpng'
+6.4.1 The ‘png’ library in ‘libs/libpng’
----------------------------------------
-The "generic" 'png' library uses the source tree in the subdirectory
-'libpng-src/', with all modifications for TL recorded in 'TLpatches/*'.
-The 'configure.ac' fragment 'ac/withenable.ac' contains
+The “generic” ‘png’ library uses the source tree in the subdirectory
+‘libpng-src/’, with all modifications for TL recorded in ‘TLpatches/*’.
+The ‘configure.ac’ fragment ‘ac/withenable.ac’ contains
KPSE_WITH_LIB([libpng], [zlib])
-to specify the module name and indicate the dependency on 'zlib'. A
-third literal argument ''tree'' would specify that the library from the
+to specify the module name and indicate the dependency on ‘zlib’. A
+third literal argument ‘‘tree’’ would specify that the library from the
TeX Live tree cannot be replaced by a system version. That not being
-the case here, a second fragment 'ac/libpng.ac' contains
+the case here, a second fragment ‘ac/libpng.ac’ contains
KPSE_TRY_LIB([libpng],
[#include <png.h>],
@@ -1144,85 +1145,85 @@
return 0; }
which Autoconf uses to verify the usability of a system version with C
-code. The analogous macro 'KPSE_TRY_LIBXX' would check using C++.
-These fragments are included by the 'configure.ac' at the top level of
-TL ('Build/source/configure.ac').
+code. The analogous macro ‘KPSE_TRY_LIBXX’ would check using C++.
+These fragments are included by the ‘configure.ac’ at the top level of
+TL (‘Build/source/configure.ac’).
For this library, like many other modules, a proxy build system for
-TL is used, consisting of our own 'configure.ac', 'Makefile.am',
-'include/Makefile.am'; the distributed build system is not used.
+TL is used, consisting of our own ‘configure.ac’, ‘Makefile.am’,
+‘include/Makefile.am’; the distributed build system is not used.
(Consequently, a few generated files and auxiliary scripts are removed
from the distributed source tree.)
- The public headers 'png.h', 'pngconf.h', and 'pnglibconf.h' are
-"installed" (as symlinks) under 'include/' in the build tree exactly as
-they are for a system version under, e.g., '/usr/include/'.
+ The public headers ‘png.h’, ‘pngconf.h’, and ‘pnglibconf.h’ are
+“installed” (as symlinks) under ‘include/’ in the build tree exactly as
+they are for a system version under, e.g., ‘/usr/include/’.
- The module is supplemented by the file 'm4/kpse-libpng-flags.m4' that
-defines the M4 macro 'KPSE_LIBPNG_FLAGS' used by all modules depending
-on this library in their 'configure.ac' to generate the 'make' variables
-'LIBPNG_INCLUDES' for use in 'CPPFLAGS', 'LIBPNG_LIBS' for use in
-'LDADD', 'LIBPNG_DEPEND' for use as dependencies, and 'LIBPNG_RULE' for
-the 'make' rules to rebuild the library.
+ The module is supplemented by the file ‘m4/kpse-libpng-flags.m4’ that
+defines the M4 macro ‘KPSE_LIBPNG_FLAGS’ used by all modules depending
+on this library in their ‘configure.ac’ to generate the ‘make’ variables
+‘LIBPNG_INCLUDES’ for use in ‘CPPFLAGS’, ‘LIBPNG_LIBS’ for use in
+‘LDADD’, ‘LIBPNG_DEPEND’ for use as dependencies, and ‘LIBPNG_RULE’ for
+the ‘make’ rules to rebuild the library.
- 'm4/kpse-libpng-flags.m4' also supplies the configure option
-'--with-system-libpng', which then uses 'pkg-config' to determine the
+ ‘m4/kpse-libpng-flags.m4’ also supplies the configure option
+‘--with-system-libpng’, which then uses ‘pkg-config’ to determine the
flags required for the system library.
File: tlbuild.info, Node: zlib library, Next: freetype library, Prev: png library, Up: Library modules
-6.4.2 The 'zlib' library in 'libs/zlib'
+6.4.2 The ‘zlib’ library in ‘libs/zlib’
---------------------------------------
-This generic library is very much analogous to 'libpng', but without the
-dependency on any other library. The file 'm4/kpse-zlib-flags.m4'
-supplies the configure option '--with-system-zlib', as well as
-'--with-zlib-includes' and '--with-zlib-libdir' to specify non-standard
-locations of the 'zlib' headers and/or library.
+This generic library is very much analogous to ‘libpng’, but without the
+dependency on any other library. The file ‘m4/kpse-zlib-flags.m4’
+supplies the configure option ‘--with-system-zlib’, as well as
+‘--with-zlib-includes’ and ‘--with-zlib-libdir’ to specify non-standard
+locations of the ‘zlib’ headers and/or library.
File: tlbuild.info, Node: freetype library, Next: kpathsea library, Prev: zlib library, Up: Library modules
-6.4.3 The 'freetype' library in 'libs/freetype2'
+6.4.3 The ‘freetype’ library in ‘libs/freetype2’
------------------------------------------------
This module uses a wrapper build system. In contrast to the proxy build
described earlier, the wrapper build has an almost trivial
-'configure.ac' and a 'Makefile.am' which invokes the 'configure' and
-'make' in the distributed source, followed by 'make install' with the TL
+‘configure.ac’ and a ‘Makefile.am’ which invokes the ‘configure’ and
+‘make’ in the distributed source, followed by ‘make install’ with the TL
build tree as destination. In other words, this actually uses the build
system provided by upstream (possibly patched).
The flags required for the system library are obtained through
-'freetype-config'.
+‘freetype-config’.
File: tlbuild.info, Node: kpathsea library, Prev: freetype library, Up: Library modules
-6.4.4 The 'kpathsea' library in 'texk/kpathsea'
+6.4.4 The ‘kpathsea’ library in ‘texk/kpathsea’
-----------------------------------------------
This is one of the TeX-specific libraries that are maintained as part of
-TeX Live (*note (kpathsea)::); the other is 'ptexenc'. These TeX
+TeX Live (*note (kpathsea)::); the other is ‘ptexenc’. These TeX
libraries are Libtool libraries (static and/or shared) and are installed
-by 'make install' together with the programs. They are, however, not
+by ‘make install’ together with the programs. They are, however, not
part of the TL DVD as distributed by TeX user groups, and have never
been officially released for standalone use.
It is possible, and probably useful for distro builds (*note Distro
-builds::), to specify the configure option '--with-system-kpathsea' in
+builds::), to specify the configure option ‘--with-system-kpathsea’ in
order to use a system version of the library. Programs outside the TL
-tree should use 'pkg-config' for the required flags.
+tree should use ‘pkg-config’ for the required flags.
- In addition to 'kpathsea/ac/withenable.ac' and
-'kpathsea/ac/kpathsea.ac' here there is a third fragment
-'kpathsea.ac/mktex.ac', included by both 'withenable.ac' and
-'configure.ac', which supplies configure options such as
-'--enable-mktextfm-default'. These determine the compile time default
-of whether or not to run 'mktextfm' (and similar) to generate a missing
-'.tfm' (or whatever) file. In any case, however, the command line
-options '-mktex=tfm' or '-no-mktex=tfm' for the TeX-like engines
+ In addition to ‘kpathsea/ac/withenable.ac’ and
+‘kpathsea/ac/kpathsea.ac’ here there is a third fragment
+‘kpathsea.ac/mktex.ac’, included by both ‘withenable.ac’ and
+‘configure.ac’, which supplies configure options such as
+‘--enable-mktextfm-default’. These determine the compile time default
+of whether or not to run ‘mktextfm’ (and similar) to generate a missing
+‘.tfm’ (or whatever) file. In any case, however, the command line
+options ‘-mktex=tfm’ or ‘-no-mktex=tfm’ for the TeX-like engines
override this default.
@@ -1236,85 +1237,85 @@
* Menu:
-* t1utils package:: 'utils/t1utils'
-* xindy package:: 'utils/xindy'
-* xdvik package:: 'texk/xdvik'
-* asymptote:: 'utils/asymptote'
+* t1utils package:: ‘utils/t1utils’
+* xindy package:: ‘utils/xindy’
+* xdvik package:: ‘texk/xdvik’
+* asymptote:: ‘utils/asymptote’
File: tlbuild.info, Node: t1utils package, Next: xindy package, Up: Program modules
-6.5.1 The 't1utils' package in 'utils/t1utils'
+6.5.1 The ‘t1utils’ package in ‘utils/t1utils’
----------------------------------------------
-Here we use the distributed source tree 't1utils-src' with modifications
-documented in 'TLpatches/*' and a proxy build system consisting of
-'configure.ac' and 'Makefile.am'. The fragment 'ac/withenable.ac'
+Here we use the distributed source tree ‘t1utils-src’ with modifications
+documented in ‘TLpatches/*’ and a proxy build system consisting of
+‘configure.ac’ and ‘Makefile.am’. The fragment ‘ac/withenable.ac’
contains
KPSE_ENABLE_PROG([t1utils])
specifying the module name without any dependencies, and supplies the
-configure option '--disable-t1utils'.
+configure option ‘--disable-t1utils’.
File: tlbuild.info, Node: xindy package, Next: xdvik package, Prev: t1utils package, Up: Program modules
-6.5.2 The 'xindy' package in 'utils/xindy'
+6.5.2 The ‘xindy’ package in ‘utils/xindy’
------------------------------------------
-This module uses the distributed source tree 'xindy-src/' with
-modifications documented in 'TLpatches/*', and a wrapper 'configure.ac'
-and 'Makefile.am' that descends into 'xindy-src'.
+This module uses the distributed source tree ‘xindy-src/’ with
+modifications documented in ‘TLpatches/*’, and a wrapper ‘configure.ac’
+and ‘Makefile.am’ that descends into ‘xindy-src’.
- The 'xindy' build requires a 'make' that supports a 'VPATH' build,
-can handle all targets, and does not refer to '${top_srcdir}' or
-'${top_builddir}'. The fragment 'xindy/ac/withenable.ac' contains
+ The ‘xindy’ build requires a ‘make’ that supports a ‘VPATH’ build,
+can handle all targets, and does not refer to ‘${top_srcdir}’ or
+‘${top_builddir}’. The fragment ‘xindy/ac/withenable.ac’ contains
KPSE_ENABLE_PROG([xindy], , [disable])
m4_include(kpse_TL[utils/xindy/ac/xindy.ac])
m4_include(kpse_TL[utils/xindy/ac/clisp.ac])
-where 'disable' in the third argument indicates that 'xindy' is only
-built if explicitly enabled by the user with 'configure --enable-xindy'
-(the need for 'clisp' makes it too painful to enable by default).
+where ‘disable’ in the third argument indicates that ‘xindy’ is only
+built if explicitly enabled by the user with ‘configure --enable-xindy’
+(the need for ‘clisp’ makes it too painful to enable by default).
- The additional fragments 'ac/xindy.ac' and 'ac/clisp.ac' specify more
-'configure' options to be seen at the top level, with 'ac/xindy.ac' also
-included by 'configure.ac'.
+ The additional fragments ‘ac/xindy.ac’ and ‘ac/clisp.ac’ specify more
+‘configure’ options to be seen at the top level, with ‘ac/xindy.ac’ also
+included by ‘configure.ac’.
File: tlbuild.info, Node: xdvik package, Next: asymptote, Prev: xindy package, Up: Program modules
-6.5.3 The 'xdvik' package in 'texk/xdvik'
+6.5.3 The ‘xdvik’ package in ‘texk/xdvik’
-----------------------------------------
This package is maintained as part of the TeX Live tree with sources in
-its own directory ('texk/xdvik/'). The fragment
-'xdvik/ac/withenable.ac' contains
+its own directory (‘texk/xdvik/’). The fragment
+‘xdvik/ac/withenable.ac’ contains
dnl extra_dirs = texk/xdvik/squeeze
KPSE_ENABLE_PROG([xdvik], [kpathsea freetype2], [x])
m4_include(kpse_TL[texk/xdvik/ac/xdvik.ac])
-thus specifying dependencies on the 'kpathsea', 'freetype', and X11
-libraries. The M4 comment (following 'dnl') signals the subsidiary
-'squeeze/configure.ac'. This is needed because the main executable
-'xdvi-bin' (to be installed as, e.g., 'xdvi-xaw') is for the 'host'
-system whereas the auxiliary program 'squeeze/squeeze' has to run on the
-'build' system; in a cross compilation, these differ.
+thus specifying dependencies on the ‘kpathsea’, ‘freetype’, and X11
+libraries. The M4 comment (following ‘dnl’) signals the subsidiary
+‘squeeze/configure.ac’. This is needed because the main executable
+‘xdvi-bin’ (to be installed as, e.g., ‘xdvi-xaw’) is for the ‘host’
+system whereas the auxiliary program ‘squeeze/squeeze’ has to run on the
+‘build’ system; in a cross compilation, these differ.
- The additional fragment 'ac/xdvik.ac' is also included by
-'configure.ac' and supplies the configure option '--with-xdvi-x-toolkit'
+ The additional fragment ‘ac/xdvik.ac’ is also included by
+‘configure.ac’ and supplies the configure option ‘--with-xdvi-x-toolkit’
also seen at the top level.
File: tlbuild.info, Node: asymptote, Prev: xdvik package, Up: Program modules
-6.5.4 The subdirectory 'utils/asymptote'
+6.5.4 The subdirectory ‘utils/asymptote’
----------------------------------------
-This subdirectory contains the sources for 'asy' and 'xasy' but due to
+This subdirectory contains the sources for ‘asy’ and ‘xasy’ but due to
its complexity and prerequisites (e.g., OpenGL) it is not part of the TL
build system. These programs must be built and installed independently,
but are included on the TL DVD together with their support files. See
@@ -1329,12 +1330,12 @@
This section outlines the basic process for adding new packages to the
TL build system.
- In any case, a new package directory 'foo' should contain the
+ In any case, a new package directory ‘foo’ should contain the
original sources, modified only with changes necessary for TL, in
-'foo/foo-src'. The changes should be documented in 'foo/TLpatches/*',
-and also be submitted upstream whenever reasonable. In addition, 'foo/'
-will need the usual Automake build-related files ('configure.ac',
-'Makefile.am', etc. Please maintain 'foo/ChangeLog' for all TL changes.
+‘foo/foo-src’. The changes should be documented in ‘foo/TLpatches/*’,
+and also be submitted upstream whenever reasonable. In addition, ‘foo/’
+will need the usual Automake build-related files (‘configure.ac’,
+‘Makefile.am’, etc. Please maintain ‘foo/ChangeLog’ for all TL changes.
* Menu:
@@ -1349,102 +1350,102 @@
6.6.1 Adding a new program module
---------------------------------
-A TeX-specific program module in a subdirectory 'texk/PROG' may use the
-TeX-specific libraries and is included by adding its name 'PROG' to the
-M4 list 'kpse_texk_pkgs' defined in 'm4/kpse-pkgs.m4'.
+A TeX-specific program module in a subdirectory ‘texk/PROG’ may use the
+TeX-specific libraries and is included by adding its name ‘PROG’ to the
+M4 list ‘kpse_texk_pkgs’ defined in ‘m4/kpse-pkgs.m4’.
- A generic program module in a subdirectory 'utils/PROG' must not use
-the TeX-specific libraries and is included by adding its name 'PROG' to
-the M4 list 'kpse_utils_pkgs' in 'm4/kpse-pkgs.m4'.
+ A generic program module in a subdirectory ‘utils/PROG’ must not use
+the TeX-specific libraries and is included by adding its name ‘PROG’ to
+the M4 list ‘kpse_utils_pkgs’ in ‘m4/kpse-pkgs.m4’.
- In either case, the subdirectory 'texk/PROG' or 'utils/PROG' must
-provide a fragment 'ac/withenable.ac' that contains the M4 macro
-'KPSE_ENABLE_PROG' defined in 'm4/kpse-setup.m4' with 'PROG' as the
+ In either case, the subdirectory ‘texk/PROG’ or ‘utils/PROG’ must
+provide a fragment ‘ac/withenable.ac’ that contains the M4 macro
+‘KPSE_ENABLE_PROG’ defined in ‘m4/kpse-setup.m4’ with ‘PROG’ as the
mandatory first argument and three optional arguments:
1. a list of required libraries from the TL tree;
- 2. a list of options: 'disable' if this module is not to be built
- without the configure option '--enable-PROG', 'native' if cross
- compilation is not possible, 'x' if the program requires X11
+ 2. a list of options: ‘disable’ if this module is not to be built
+ without the configure option ‘--enable-PROG’, ‘native’ if cross
+ compilation is not possible, ‘x’ if the program requires X11
libraries;
- 3. a comment added to the help text for the 'configure' option
- '--enable-PROG' or '--disable-PROG'.
+ 3. a comment added to the help text for the ‘configure’ option
+ ‘--enable-PROG’ or ‘--disable-PROG’.
- If the module requires specific 'configure' options to be seen at the
-top level, they should be defined in an additional fragment 'ac/PROG.ac'
-included from 'ac/withenable.ac' and 'configure.ac'.
+ If the module requires specific ‘configure’ options to be seen at the
+top level, they should be defined in an additional fragment ‘ac/PROG.ac’
+included from ‘ac/withenable.ac’ and ‘configure.ac’.
Usually, the new program is maintained somewhere outside of TeX Live.
In that case, as above, we put the upstream sources into a subdirectory
-'PROG-src' (e.g., 'utils/newprog/newprog-src'). We do not typically run
-'configure' in this original '...-src' directory, but only in our own
-directory; but we do compile using the source files in '...-src'.
+‘PROG-src’ (e.g., ‘utils/newprog/newprog-src’). We do not typically run
+‘configure’ in this original ‘...-src’ directory, but only in our own
+directory; but we do compile using the source files in ‘...-src’.
So, to summarize the files that must (usually) be created inside a
-new TL source directory ('texk/newprog' or 'utils/newprog'):
+new TL source directory (‘texk/newprog’ or ‘utils/newprog’):
-'ac/withenable.ac'
- The 'KPSE_ENABLE_PROG' call just explained.
+‘ac/withenable.ac’
+ The ‘KPSE_ENABLE_PROG’ call just explained.
-'configure.ac'
-'Makefile.am'
- By merging the contents of the original 'configure.ac' (if
+‘configure.ac’
+‘Makefile.am’
+ By merging the contents of the original ‘configure.ac’ (if
provided) and a comparable program already in TL. In the above
- example, one line that will be needed in 'configure.ac' (can be
- added before the 'AC_CONFIG_FILES' at the end) is:
+ example, one line that will be needed in ‘configure.ac’ (can be
+ added before the ‘AC_CONFIG_FILES’ at the end) is:
AC_SUBST([NEWPROG_TREE], [newprog-src])
- and then use '@NEWPROG_TREE@' in 'Makefile.am' where needed.
+ and then use ‘@NEWPROG_TREE@’ in ‘Makefile.am’ where needed.
In general, there is no magic recipe for this part of the job.
- It's necessary to think about what needs to be done in the original
- vs. in TeX Live. It's useful to look at the setup for the most
- comparable programs already in TL that you can find. It's also
- useful to grep the entire 'Build/source' tree for whatever you can
+ It’s necessary to think about what needs to be done in the original
+ vs. in TeX Live. It’s useful to look at the setup for the most
+ comparable programs already in TL that you can find. It’s also
+ useful to grep the entire ‘Build/source’ tree for whatever you can
think of to investigate how something is done. Most of the
- TL-specific macros are defined in 'Build/source/m4/*'.
+ TL-specific macros are defined in ‘Build/source/m4/*’.
-'TLpatches/TL-Changes'
+‘TLpatches/TL-Changes’
First actions taken after getting the original source tree;
typically removal of derived or unused common files.
-'TLpatches/patch-...'
+‘TLpatches/patch-...’
If any changes are needed to the original sources, record the
patches here so they can be applied next time. Also, send them
- upstream so that we don't have to maintain them forever.
+ upstream so that we don’t have to maintain them forever.
-'ChangeLog'
+‘ChangeLog’
Record all TL-specific changes, now and in the future.
- After populating the new TL source directory ('.../newprog/', in the
-above), run GNU 'autoreconf' there (*note Build system tools::). Once
-that works, if you are the one who's eventually going to commit the new
-package, 'svn add' the necessary files, including the generated
-'Makefile.in aclocal.m4 configure', and 'svn:ignore' the Automake cache
-'autom4te.cache'. (This is so people checking out the TL source tree do
-not have to run any autotools, but can simply run 'configure'.)
+ After populating the new TL source directory (‘.../newprog/’, in the
+above), run GNU ‘autoreconf’ there (*note Build system tools::). Once
+that works, if you are the one who’s eventually going to commit the new
+package, ‘svn add’ the necessary files, including the generated
+‘Makefile.in aclocal.m4 configure’, and ‘svn:ignore’ the Automake cache
+‘autom4te.cache’. (This is so people checking out the TL source tree do
+not have to run any autotools, but can simply run ‘configure’.)
- To reiterate: do not fail to commit the generated 'configure' and
-other files. The m4 code in 'kpse-pkgs.m4' uses the existence of
-'configure' to determine whether to descend into (and configure) a given
+ To reiterate: do not fail to commit the generated ‘configure’ and
+other files. The m4 code in ‘kpse-pkgs.m4’ uses the existence of
+‘configure’ to determine whether to descend into (and configure) a given
subdirectory.
- Then, run the TL tool 'reautoconf' in the top-level TL
-'Build/source/' directory, to incorporate the new program into the build
-tree. It is good to then rebuild the whole tree (e.g., using TL's
-'Build/Build' script) to get all the necessary files generated.
+ Then, run the TL tool ‘reautoconf’ in the top-level TL
+‘Build/source/’ directory, to incorporate the new program into the build
+tree. It is good to then rebuild the whole tree (e.g., using TL’s
+‘Build/Build’ script) to get all the necessary files generated.
It will probably fail. So then you need to keep at it until the
program compiles and tests successfully. The most efficient way is to
-rerun 'autoreconf' as needed in the new source directory
-('Build/source/.../newprog'), then 'make' in the corresponding build
-directory ('Build/work/.../newprog'), then 'make check', etc. In the
+rerun ‘autoreconf’ as needed in the new source directory
+(‘Build/source/.../newprog’), then ‘make’ in the corresponding build
+directory (‘Build/work/.../newprog’), then ‘make check’, etc. In the
end, also make sure that the whole tree builds from scratch.
- After final success, don't forget to commit. (Or email the TL
+ After final success, don’t forget to commit. (Or email the TL
maintainers with the patch.)
@@ -1454,32 +1455,32 @@
-------------------------
Adding a new TeX engine is not completely different from adding a
-program, but it's not all that similar, either. In this case, the main
-work is done by creating a new subdirectory of 'texk/web2c/' for the
-engine. The subdirectory is conventionally named ending in 'dir', like
-'pdftexdir' and 'xetexdir', to avoid clashes with executable names.
+program, but it’s not all that similar, either. In this case, the main
+work is done by creating a new subdirectory of ‘texk/web2c/’ for the
+engine. The subdirectory is conventionally named ending in ‘dir’, like
+‘pdftexdir’ and ‘xetexdir’, to avoid clashes with executable names.
The source files for the new engine should be put in this
-'NEWENGINEdir' subdirectory. Also, a file
-'NEWENGINEdir/am/NEWENGINE.am' (e.g., 'pdftexdir/am/pdftex.am' is needed
+‘NEWENGINEdir’ subdirectory. Also, a file
+‘NEWENGINEdir/am/NEWENGINE.am’ (e.g., ‘pdftexdir/am/pdftex.am’ is needed
with the Makefile fragment needed to build it.
- The overall 'web2c/Makefile.am' needs to have an 'include' statement
-added to insert that 'NEWENGINE.am' file.
+ The overall ‘web2c/Makefile.am’ needs to have an ‘include’ statement
+added to insert that ‘NEWENGINE.am’ file.
- In 'web2c/ac/web2c.ac', a line needs to be added in the definition of
-the 'kpse_tex_progs' variable to include it in the build. That line
+ In ‘web2c/ac/web2c.ac’, a line needs to be added in the definition of
+the ‘kpse_tex_progs’ variable to include it in the build. That line
specifies whether the new engine is built by default, and the additional
libraries requires.
For examples of building engines in CWEB, you can check the existing
-'hitexdir' and 'mplibdir' directories; these are somewhat simpler than
+‘hitexdir’ and ‘mplibdir’ directories; these are somewhat simpler than
LuaTeX. Of course, every engine will have its own unique features and
requirements, so existing examples will only take you so far.
- Web2c is built as one "package", with each subdirectory's '.am'
-fragment inserted with an Automake 'include'. This means that, for
-instance, '$(srcdir)' is '.../web2c', not '.../webdir/enginedir'. It is
+ Web2c is built as one “package”, with each subdirectory’s ‘.am’
+fragment inserted with an Automake ‘include’. This means that, for
+instance, ‘$(srcdir)’ is ‘.../web2c’, not ‘.../webdir/enginedir’. It is
a difficult setup to come to terms with, but the alternative is to
recurse into each engine subdirectory, and that would be far worse
(*note (automake)Directories::).
@@ -1490,41 +1491,41 @@
6.6.3 Adding a new generic library module
-----------------------------------------
-A generic library module in a subdirectory 'libs/LIB' must not depend on
+A generic library module in a subdirectory ‘libs/LIB’ must not depend on
TeX-specific libraries, by definition. It is included by adding its
-name 'LIB' to the M4 macro 'kpse_libs_pkgs' in 'm4/kpse-pkgs.m4'--before
+name ‘LIB’ to the M4 macro ‘kpse_libs_pkgs’ in ‘m4/kpse-pkgs.m4’—before
any other libraries from the TeX Live tree on which it depends.
- As with program modules, the subdirectory 'libs/LIB' must contain the
+ As with program modules, the subdirectory ‘libs/LIB’ must contain the
sources and build system for the library (and any installable support
-programs) and a fragment 'ac/withenable.ac' that contains the M4 macro
-'KPSE_WITH_LIB' defined in 'm4/kpse-setup.m4' with 'LIB' as the
+programs) and a fragment ‘ac/withenable.ac’ that contains the M4 macro
+‘KPSE_WITH_LIB’ defined in ‘m4/kpse-setup.m4’ with ‘LIB’ as the
mandatory first argument and two optional arguments: a list of required
libraries from the TL tree, and a list of options: for libraries,
-currently there is only one--specify 'tree' if this library cannot be
+currently there is only one—specify ‘tree’ if this library cannot be
replaced by a system version.
- If a system version can be used, a second fragment 'ac/LIB.ac' is
-needed, containing the M4 macro 'KPSE_TRY_LIB' (or 'KPSE_TRY_LIBXX')
-with 'LIB' as the mandatory first argument and two additional arguments
-for the Autoconf macro 'AC_LANG_PROGRAM' used to compile and link a
+ If a system version can be used, a second fragment ‘ac/LIB.ac’ is
+needed, containing the M4 macro ‘KPSE_TRY_LIB’ (or ‘KPSE_TRY_LIBXX’)
+with ‘LIB’ as the mandatory first argument and two additional arguments
+for the Autoconf macro ‘AC_LANG_PROGRAM’ used to compile and link a
small C (or C++) program as sanity check for using the system library.
- In addition a file 'm4/kpse-LIB-flags' (at the top level) must define
-the M4 macro 'KPSE_LIB_FLAGS' (all uppercase) setting up the 'make'
-variables 'LIB_INCLUDES', 'LIB_LIBS', 'LIB_DEPEND', and 'LIB_RULE' with
-the values required for 'CPPFLAGS', 'LDADD', dependencies, and a
-(multi-line) 'make' rule to rebuild the library when necessary. All of
+ In addition a file ‘m4/kpse-LIB-flags’ (at the top level) must define
+the M4 macro ‘KPSE_LIB_FLAGS’ (all uppercase) setting up the ‘make’
+variables ‘LIB_INCLUDES’, ‘LIB_LIBS’, ‘LIB_DEPEND’, and ‘LIB_RULE’ with
+the values required for ‘CPPFLAGS’, ‘LDADD’, dependencies, and a
+(multi-line) ‘make’ rule to rebuild the library when necessary. All of
that is needed for the library from the TL tree and, if supported, for a
system version.
- If a system library is allowed, 'KPSE_LIB_FLAGS' also provides the
-configure option '--with-system-LIB' and uses the additional M4 macro
-'KPSE_LIB_SYSTEM_FLAGS' to generate the 'make' variables for a system
+ If a system library is allowed, ‘KPSE_LIB_FLAGS’ also provides the
+configure option ‘--with-system-LIB’ and uses the additional M4 macro
+‘KPSE_LIB_SYSTEM_FLAGS’ to generate the ‘make’ variables for a system
library. In addition, the definition of the M4 macro
-'KPSE_ALL_SYSTEM_FLAGS' in 'm4/kpse-pkgs.m4' must be extended by the
+‘KPSE_ALL_SYSTEM_FLAGS’ in ‘m4/kpse-pkgs.m4’ must be extended by the
line:
- 'AC_REQUIRE([KPSE_LIB_SYSTEM_FLAGS])'
+ ‘AC_REQUIRE([KPSE_LIB_SYSTEM_FLAGS])’
File: tlbuild.info, Node: Adding a new TeX-specific library module, Prev: Adding a new generic library module, Up: Extending TeX Live
@@ -1532,15 +1533,15 @@
6.6.4 Adding a new TeX-specific library module
----------------------------------------------
-A TeX-specific library module in a subdirectory 'texk/LIB' may depend on
+A TeX-specific library module in a subdirectory ‘texk/LIB’ may depend on
other TeX-specific libraries but must not depend on any generic library
from the TL tree. It is included in the same general ways as a generic
library (see the previous section), with these modifications:
- * The library name 'LIB' is added to the M4 macro
- 'kpse_texlibs_pkgs', which is also in 'm4/kpse-pkgs.m4'.
+ • The library name ‘LIB’ is added to the M4 macro
+ ‘kpse_texlibs_pkgs’, which is also in ‘m4/kpse-pkgs.m4’.
- * The fragment 'ac/withenable.ac' must use 'KPSE_WITH_TEXLIB'.
+ • The fragment ‘ac/withenable.ac’ must use ‘KPSE_WITH_TEXLIB’.
File: tlbuild.info, Node: Configure options, Next: Coding conventions, Prev: Layout and infrastructure, Up: Top
@@ -1549,13 +1550,13 @@
*******************
Corresponding to the large number of program and library modules there
-are a large number 'configure' options, most of which are described
+are a large number ‘configure’ options, most of which are described
here. The command
- 'configure --help'
+ ‘configure --help’
at the top level gives an exhaustive list of all global options and a
few important module-specific ones, whereas, e.g.,
- 'texk/lcdf-typetools/configure --help'
-also displays the 'lcdf-typetools' specific options, which are not shown
+ ‘texk/lcdf-typetools/configure --help’
+also displays the ‘lcdf-typetools’ specific options, which are not shown
at the top level.
The help text also mentions several influential environment
@@ -1562,10 +1563,10 @@
variables, but for TeX Live it is better to specify them as assignments
on the command line.
- The './Build' script used to make the binaries shipped with TeX Live
-invokes the top-level 'configure' with a few additional options (*note
+ The ‘./Build’ script used to make the binaries shipped with TeX Live
+invokes the top-level ‘configure’ with a few additional options (*note
Building::). The defaults discussed below are those for the actual
-'configure' script; invoking 'configure' via './Build' yields different
+‘configure’ script; invoking ‘configure’ via ‘./Build’ yields different
results.
Defaults for most options are set at the top level and propagated
@@ -1605,55 +1606,55 @@
File: tlbuild.info, Node: --disable-native-texlive-build, Next: --prefix --bindir ..., Up: Global configure options
-7.1.1 '--disable-native-texlive-build'
+7.1.1 ‘--disable-native-texlive-build’
--------------------------------------
If enabled (the default), build for a TL binary distribution as shipped
-by the TeX user groups. This requires GNU 'make' and implies
-'--enable-multiplatform' and '--enable-cxx-runtime-hack' (unless they
-are explicitly disabled), and enforces '--disable-shared'.
+by the TeX user groups. This requires GNU ‘make’ and implies
+‘--enable-multiplatform’ and ‘--enable-cxx-runtime-hack’ (unless they
+are explicitly disabled), and enforces ‘--disable-shared’.
If building TL for a GNU/Linux or other distribution, this should be
disabled and system versions of most libraries should be used (*note
Distro builds::).
- A related option, '--enable-texlive-build', is automatically passed
+ A related option, ‘--enable-texlive-build’, is automatically passed
to all subdirectories (and cannot be disabled). Subdirectories that can
-also be built independently from the TL tree (such as 'utils/xindy' and
-'texk/dvipng') but cooperate with TL can use this option to enable
+also be built independently from the TL tree (such as ‘utils/xindy’ and
+‘texk/dvipng’) but cooperate with TL can use this option to enable
TL-specific adaptations, such as installation paths.
File: tlbuild.info, Node: --prefix --bindir ..., Next: --disable-largefile, Prev: --disable-native-texlive-build, Up: Global configure options
-7.1.2 '--prefix', '--bindir', ...
+7.1.2 ‘--prefix’, ‘--bindir’, ...
---------------------------------
These standard Autoconf options specify various installation directories
as usual. For the complete list, *note Installation directories::.
- Also as usual, all values are prefixed by the value of 'DESTDIR', if
-set, on the 'make' command line (*note Installation in a temporary
+ Also as usual, all values are prefixed by the value of ‘DESTDIR’, if
+set, on the ‘make’ command line (*note Installation in a temporary
location: (automake)Staged Installs.).
File: tlbuild.info, Node: --disable-largefile, Next: --disable-missing, Prev: --prefix --bindir ..., Up: Global configure options
-7.1.3 '--disable-largefile'
+7.1.3 ‘--disable-largefile’
---------------------------
Omit large file support (LFS), which is needed on most 32-bit Unix
systems for files with 2GB or more. Regardless of this option, the size
-of 'DVI' and 'GF' files must always be <2GB, due to the file format
+of ‘DVI’ and ‘GF’ files must always be <2GB, due to the file format
specifications.
With LFS, there is no fixed limit on the size of PDF files created by
-'pdftex' or PostScript files created by 'dvips'.
+‘pdftex’ or PostScript files created by ‘dvips’.
File: tlbuild.info, Node: --disable-missing, Next: --enable-compiler-warnings=LEVEL, Prev: --disable-largefile, Up: Global configure options
-7.1.4 '--disable-missing'
+7.1.4 ‘--disable-missing’
-------------------------
Immediately terminate the build process if a requested program or
@@ -1663,13 +1664,13 @@
File: tlbuild.info, Node: --enable-compiler-warnings=LEVEL, Next: --enable-cxx-runtime-hack, Prev: --disable-missing, Up: Global configure options
-7.1.5 '--enable-compiler-warnings='LEVEL
+7.1.5 ‘--enable-compiler-warnings=’LEVEL
----------------------------------------
Enable various levels of compiler warnings for C, C++, and/or
-Objective C: the LEVEL value can be one of: 'no min yes max all'. The
-default is 'yes' in 'maintainer-mode' (see below) and 'min' otherwise.
-This option defines the variables 'WARNING_[OBJ]C[XX]FLAGS', but these
+Objective C: the LEVEL value can be one of: ‘no min yes max all’. The
+default is ‘yes’ in ‘maintainer-mode’ (see below) and ‘min’ otherwise.
+This option defines the variables ‘WARNING_[OBJ]C[XX]FLAGS’, but these
variables are not consistently used in all library and program modules.
At present, these warning flags assume options from the GNU compilers.
@@ -1676,73 +1677,73 @@
File: tlbuild.info, Node: --enable-cxx-runtime-hack, Next: --enable-maintainer-mode, Prev: --enable-compiler-warnings=LEVEL, Up: Global configure options
-7.1.6 '--enable-cxx-runtime-hack'
+7.1.6 ‘--enable-cxx-runtime-hack’
---------------------------------
-If enabled (as it is for the native TL build), when using 'g++', try to
-statically link with 'libstdc++', thus improving portability of the
+If enabled (as it is for the native TL build), when using ‘g++’, try to
+statically link with ‘libstdc++’, thus improving portability of the
resulting binary. *Note Macros for compilers::.
File: tlbuild.info, Node: --enable-maintainer-mode, Next: --enable-multiplatform, Prev: --enable-cxx-runtime-hack, Up: Global configure options
-7.1.7 '--enable-maintainer-mode'
+7.1.7 ‘--enable-maintainer-mode’
--------------------------------
-Enable 'make' rules and dependencies not useful (and sometimes
+Enable ‘make’ rules and dependencies not useful (and sometimes
confusing) to the casual user. This requires current versions of the
GNU build tools (*note Build system tools::), as it automatically
-rebuilds infrastructure files as needed. *Note 'missing' and
-'AM_MAINTAINER_MODE': (automake)maintainer-mode.
+rebuilds infrastructure files as needed. *Note ‘missing’ and
+‘AM_MAINTAINER_MODE’: (automake)maintainer-mode.
File: tlbuild.info, Node: --enable-multiplatform, Next: --enable-shared, Prev: --enable-maintainer-mode, Up: Global configure options
-7.1.8 '--enable-multiplatform'
+7.1.8 ‘--enable-multiplatform’
------------------------------
-If enabled (as it is for the native TL build) and '--bindir=DIR' or
-'--libdir=DIR' are not specified, install executables and libraries in
-per-platform subdirectories of 'EPREFIX/bin' and 'EPREFIX/lib' where
-EPREFIX is the value given or implied for 'exec_prefix'. In any case,
-the values for 'bindir' and 'libdir' are automatically propagated to all
+If enabled (as it is for the native TL build) and ‘--bindir=DIR’ or
+‘--libdir=DIR’ are not specified, install executables and libraries in
+per-platform subdirectories of ‘EPREFIX/bin’ and ‘EPREFIX/lib’ where
+EPREFIX is the value given or implied for ‘exec_prefix’. In any case,
+the values for ‘bindir’ and ‘libdir’ are automatically propagated to all
subdirectories.
File: tlbuild.info, Node: --enable-shared, Next: --enable-silent-rules, Prev: --enable-multiplatform, Up: Global configure options
-7.1.9 '--enable-shared'
+7.1.9 ‘--enable-shared’
-----------------------
Build shared versions of the TeX-specific libraries such as
-'libkpathsea'. This is not allowed for a native TL build (i.e.,
-'--disable-native-texlive-build' must also be specified).
+‘libkpathsea’. This is not allowed for a native TL build (i.e.,
+‘--disable-native-texlive-build’ must also be specified).
File: tlbuild.info, Node: --enable-silent-rules, Next: --without-ln-s, Prev: --enable-shared, Up: Global configure options
-7.1.10 '--enable-silent-rules'
+7.1.10 ‘--enable-silent-rules’
------------------------------
-Enable the use of less verbose build rules. When using GNU 'make' (or
-any 'make' implementation supporting nested variable expansions), you
-can specify 'V=1' on the 'make' command line to get more verbosity, or
-'V=0' to get less, regardless of this option.
+Enable the use of less verbose build rules. When using GNU ‘make’ (or
+any ‘make’ implementation supporting nested variable expansions), you
+can specify ‘V=1’ on the ‘make’ command line to get more verbosity, or
+‘V=0’ to get less, regardless of this option.
File: tlbuild.info, Node: --without-ln-s, Next: --without-x, Prev: --enable-silent-rules, Up: Global configure options
-7.1.11 '--without-ln-s'
+7.1.11 ‘--without-ln-s’
-----------------------
-Required when using a system without a working 'ln -s' to build binaries
-for a Unix-like system. However, 'make install' will not create
+Required when using a system without a working ‘ln -s’ to build binaries
+for a Unix-like system. However, ‘make install’ will not create
anything useful, and might fail.
File: tlbuild.info, Node: --without-x, Prev: --without-ln-s, Up: Global configure options
-7.1.12 '--without-x'
+7.1.12 ‘--without-x’
--------------------
Disable all programs using the X Window System.
@@ -1753,7 +1754,7 @@
7.2 Program-specific configure options
======================================
-Here are (some of) the program-specific 'configure' options.
+Here are (some of) the program-specific ‘configure’ options.
* Menu:
@@ -1770,197 +1771,197 @@
File: tlbuild.info, Node: --enable-PROG --disable-PROG, Next: --disable-all-pkgs, Up: Program-specific configure options
-7.2.1 '--enable-PROG', '--disable-PROG'
+7.2.1 ‘--enable-PROG’, ‘--disable-PROG’
---------------------------------------
-Do or do not build and install the program(s) of module 'PROG'.
+Do or do not build and install the program(s) of module ‘PROG’.
File: tlbuild.info, Node: --disable-all-pkgs, Next: Configure options for texk/web2c, Prev: --enable-PROG --disable-PROG, Up: Program-specific configure options
-7.2.2 '--disable-all-pkgs'
+7.2.2 ‘--disable-all-pkgs’
--------------------------
-Do not build any program modules by default--only those explicitly
+Do not build any program modules by default—only those explicitly
enabled. This is useful when one wants to work on only a single
-program, which is specified with an additional '--enable' option, e.g.,
-'--enable-dvipdfm-x'. It's still simplest to check out and configure
+program, which is specified with an additional ‘--enable’ option, e.g.,
+‘--enable-dvipdfm-x’. It’s still simplest to check out and configure
the whole source tree, but at least only the program you are interested
in, and its dependencies, are built. *Note Build one package::.
Without this option, all modules are built except those that are
-explicitly disabled or specify 'disable' in their 'ac/withenable.ac'
+explicitly disabled or specify ‘disable’ in their ‘ac/withenable.ac’
fragment.
File: tlbuild.info, Node: Configure options for texk/web2c, Next: Configure options for texk/bibtex-x, Prev: --disable-all-pkgs, Up: Program-specific configure options
-7.2.3 Configure options for 'texk/web2c'
+7.2.3 Configure options for ‘texk/web2c’
----------------------------------------
-'--with-banner-add=STR'
-Add 'STR' to the default version string (which is ''TeX Live YEAR'' or
-''Web2C YEAR'') appended to banner lines. This is ignored for a native
-TL build, but distro builds should specify, e.g., '/SOMEDISTRO'.
+‘--with-banner-add=STR’
+Add ‘STR’ to the default version string (which is ‘‘TeX Live YEAR’’ or
+‘‘Web2C YEAR’’) appended to banner lines. This is ignored for a native
+TL build, but distro builds should specify, e.g., ‘/SOMEDISTRO’.
-'--with-editor=CMD'
-Specify the command 'CMD' to invoke from the 'e' option of TeX and
-friends, replacing the default 'vi +%d '%s'' for Unix or 'texworks
---position=%d "%s"' for Windows.
+‘--with-editor=CMD’
+Specify the command ‘CMD’ to invoke from the ‘e’ option of TeX and
+friends, replacing the default ‘vi +%d '%s'’ for Unix or ‘texworks
+--position=%d "%s"’ for Windows.
-'--with-fontconfig-includes=DIR', '--with-fontconfig-libdir=DIR'
-Building XeTeX on non-Mac systems requires the 'fontconfig' library
+‘--with-fontconfig-includes=DIR’, ‘--with-fontconfig-libdir=DIR’
+Building XeTeX on non-Mac systems requires the ‘fontconfig’ library
headers and code. If one or both of these options are given, the
required flags are derived from them; otherwise, they are determined via
-'pkg-config' (if present).
+‘pkg-config’ (if present).
-'--with-mf-x-toolkit'
-Use the X toolkit ('libXt') for Metafont (the default is to use the
-lowest-level 'Xlib' support; it seems this has the best chance of
+‘--with-mf-x-toolkit’
+Use the X toolkit (‘libXt’) for Metafont (the default is to use the
+lowest-level ‘Xlib’ support; it seems this has the best chance of
working across X installations nowadays).
-'--disable-dump-share'
-Make the 'fmt'/'base' dump files architecture dependent (somewhat faster
+‘--disable-dump-share’
+Make the ‘fmt’/‘base’ dump files architecture dependent (somewhat faster
on LittleEndian architectures).
-'--disable-ipc'
-Disable TeX's '--ipc' option.
+‘--disable-ipc’
+Disable TeX’s ‘--ipc’ option.
-'--disable-mf-nowin'
-Do not build a separate non-graphically-capable Metafont ('mf-nowin').
+‘--disable-mf-nowin’
+Do not build a separate non-graphically-capable Metafont (‘mf-nowin’).
-'--disable-tex', '--enable-etex', ...
+‘--disable-tex’, ‘--enable-etex’, ...
Do not or do build the various TeX, Metafont, and MetaPost engines
-(defaults are defined in the fragment 'texk/web2c/ac/web2c.ac').
+(defaults are defined in the fragment ‘texk/web2c/ac/web2c.ac’).
-'--disable-web-progs'
-Do not build the original WEB programs 'bibtex', ..., 'weave'. Useful
+‘--disable-web-progs’
+Do not build the original WEB programs ‘bibtex’, ..., ‘weave’. Useful
if, e.g., you only want to (re)build some engines.
-'--enable-auto-core'
+‘--enable-auto-core’
This option causes TeX and Metafont to produce a core dump when a
particular hacky filename is encountered, for use in creating preloaded
binaries. This is rarely done nowadays.
-'--enable-libtool-hack'
-If enabled (which is the default for all platforms), prevents 'libtool'
-from linking explicitly with dependencies of 'libfontconfig' such as
-'libexpat'.
+‘--enable-libtool-hack’
+If enabled (which is the default for all platforms), prevents ‘libtool’
+from linking explicitly with dependencies of ‘libfontconfig’ such as
+‘libexpat’.
-'--enable-*win'
+‘--enable-*win’
Include various types of non-X window support for Metafont (EPSF output,
-'mftalk', old graphics terminals, ...).
+‘mftalk’, old graphics terminals, ...).
-'--enable-tex-synctex', '--disable-etex-synctex', ...
-Build the TeX engines with or without 'SyncTeX' support; ignored for a
+‘--enable-tex-synctex’, ‘--disable-etex-synctex’, ...
+Build the TeX engines with or without ‘SyncTeX’ support; ignored for a
native TeX Live build. Defaults are defined in
-'texk/web2c/ac/web2c.ac'.
+‘texk/web2c/ac/web2c.ac’.
-'--disable-synctex'
-Do not build the 'SyncTeX' library and tool.
+‘--disable-synctex’
+Do not build the ‘SyncTeX’ library and tool.
File: tlbuild.info, Node: Configure options for texk/bibtex-x, Next: Configure options for texk/dvipdfm-x, Prev: Configure options for texk/web2c, Up: Program-specific configure options
-7.2.4 Configure options for 'texk/bibtex-x'
+7.2.4 Configure options for ‘texk/bibtex-x’
-------------------------------------------
-The programs 'bibtex8' and 'bibtexu' have been merged into the module
-'bibtex-x' (extended BibTeX).
+The programs ‘bibtex8’ and ‘bibtexu’ have been merged into the module
+‘bibtex-x’ (extended BibTeX).
-'--disable-bibtex8'
-Do not build the 'bibtex8' program.
+‘--disable-bibtex8’
+Do not build the ‘bibtex8’ program.
-'--disable-bibtexu'
-Do not build the 'bibtexu' program (building 'bibtexu' requires 'ICU'
+‘--disable-bibtexu’
+Do not build the ‘bibtexu’ program (building ‘bibtexu’ requires ‘ICU’
libraries).
File: tlbuild.info, Node: Configure options for texk/dvipdfm-x, Next: Configure options for texk/dvisvgm, Prev: Configure options for texk/bibtex-x, Up: Program-specific configure options
-7.2.5 Configure options for 'texk/dvipdfm-x'
+7.2.5 Configure options for ‘texk/dvipdfm-x’
--------------------------------------------
-The former modules 'dvipdfmx' (extended DVI to PDF converter) and
-'xdvipdfmx' (the same, as used by XeTeX) have been merged into
-'dvipdfm-x' at the source level. Two separate binaries are still
-created by default. In addition, 'dvipdfm' is created as a symlink to
-'dvipdfmx', with backward-compatible (very slightly different) behavior.
+The former modules ‘dvipdfmx’ (extended DVI to PDF converter) and
+‘xdvipdfmx’ (the same, as used by XeTeX) have been merged into
+‘dvipdfm-x’ at the source level. Two separate binaries are still
+created by default. In addition, ‘dvipdfm’ is created as a symlink to
+‘dvipdfmx’, with backward-compatible (very slightly different) behavior.
-'--disable-dvipdfmx'
-Do not build the 'dvipdfmx' program or make the 'dvipdfm' symlink.
+‘--disable-dvipdfmx’
+Do not build the ‘dvipdfmx’ program or make the ‘dvipdfm’ symlink.
-'--disable-xdvipdfmx'
-Do not build the 'xdvipdfmx' program.
+‘--disable-xdvipdfmx’
+Do not build the ‘xdvipdfmx’ program.
File: tlbuild.info, Node: Configure options for texk/dvisvgm, Next: Configure options for texk/texlive, Prev: Configure options for texk/dvipdfm-x, Up: Program-specific configure options
-7.2.6 Configure options for 'texk/dvisvgm'
+7.2.6 Configure options for ‘texk/dvisvgm’
------------------------------------------
-'--with-system-libgs'
-Build 'dvisvgm' using installed Ghostscript ('gs') headers and library
-(not allowed for a native TL build). The default is to load the 'gs'
+‘--with-system-libgs’
+Build ‘dvisvgm’ using installed Ghostscript (‘gs’) headers and library
+(not allowed for a native TL build). The default is to load the ‘gs’
library at runtime if possible, else to disable support for PostScript
specials.
-'--without-libgs'
-Build 'dvisvgm' without PostScript support at all. Because the dynamic
+‘--without-libgs’
+Build ‘dvisvgm’ without PostScript support at all. Because the dynamic
loading just mentioned defeats all attempts at static linking, the
result can crash due to library incompatibilities, e.g., on CentOS 5.
-'--with-libgs-includes=DIR', '--with-libgs-libdir=DIR'
+‘--with-libgs-includes=DIR’, ‘--with-libgs-libdir=DIR’
Specify non-standard locations of the Ghostscript headers and library.
File: tlbuild.info, Node: Configure options for texk/texlive, Next: Configure options for texk/xdvik, Prev: Configure options for texk/dvisvgm, Up: Program-specific configure options
-7.2.7 Configure options for 'texk/texlive'
+7.2.7 Configure options for ‘texk/texlive’
------------------------------------------
-'--disable-linked-scripts'
-Do not install the "linked scripts" (*note Linked scripts::), except for
-the TL scripts required to run 'texlinks'.
+‘--disable-linked-scripts’
+Do not install the “linked scripts” (*note Linked scripts::), except for
+the TL scripts required to run ‘texlinks’.
File: tlbuild.info, Node: Configure options for texk/xdvik, Next: Configure options for utils/xindy, Prev: Configure options for texk/texlive, Up: Program-specific configure options
-7.2.8 Configure options for 'texk/xdvik'
+7.2.8 Configure options for ‘texk/xdvik’
----------------------------------------
-'--with-gs=FILENAME'
-Hardwire the location of Ghostscript ('gs') as called by Xdvik.
+‘--with-gs=FILENAME’
+Hardwire the location of Ghostscript (‘gs’) as called by Xdvik.
-'--with-xdvi-x-toolkit=KIT'
-Use toolkit 'KIT' for 'xdvik', one of: 'motif xaw xaw3d neXtaw'. The
-default is 'motif' if available, else 'xaw'.
+‘--with-xdvi-x-toolkit=KIT’
+Use toolkit ‘KIT’ for ‘xdvik’, one of: ‘motif xaw xaw3d neXtaw’. The
+default is ‘motif’ if available, else ‘xaw’.
-'--enable-xi2-scrolling'
-Use XInput 2.1 "smooth scrolling" if available (default: yes, except for
+‘--enable-xi2-scrolling’
+Use XInput 2.1 “smooth scrolling” if available (default: yes, except for
a native TL build).
File: tlbuild.info, Node: Configure options for utils/xindy, Prev: Configure options for texk/xdvik, Up: Program-specific configure options
-7.2.9 Configure options for 'utils/xindy'
+7.2.9 Configure options for ‘utils/xindy’
-----------------------------------------
-'--enable-xindy-rules'
-Build and install 'xindy' rules (default: yes, except for a native TL
+‘--enable-xindy-rules’
+Build and install ‘xindy’ rules (default: yes, except for a native TL
build).
-'--enable-xindy-docs'
-Build and install 'xindy' documentation (default: yes, except for a
+‘--enable-xindy-docs’
+Build and install ‘xindy’ documentation (default: yes, except for a
native TL build).
-'--with-clisp-runtime=FILENAME'
-Specifies the full path for the Clisp runtime file ('lisp.run' or
-'lisp.exe') to be installed. When specified as 'default' (the default
+‘--with-clisp-runtime=FILENAME’
+Specifies the full path for the Clisp runtime file (‘lisp.run’ or
+‘lisp.exe’) to be installed. When specified as ‘default’ (the default
for a native TL build) the path is determined by the Clisp executable;
-the value 'system' (not allowed for a native TL build, but the default
-otherwise) indicates that 'xindy' will use the installed version of
-'clisp' (which must be identical to the one used to build 'xindy').
+the value ‘system’ (not allowed for a native TL build, but the default
+otherwise) indicates that ‘xindy’ will use the installed version of
+‘clisp’ (which must be identical to the one used to build ‘xindy’).
File: tlbuild.info, Node: Library-specific configure options, Next: Variables for configure, Prev: Program-specific configure options, Up: Configure options
@@ -1968,21 +1969,21 @@
7.3 Library-specific configure options
======================================
-Here are (some of) the library-specific 'configure' options, starting
+Here are (some of) the library-specific ‘configure’ options, starting
with this generic one:
-'--with-system-LIB'
+‘--with-system-LIB’
- Use an installed (system) version of the library 'LIB'; this option
+ Use an installed (system) version of the library ‘LIB’; this option
exists for most libraries, but is not allowed for a native TL build.
Using a system version implies also using the system versions of all
libraries that LIB depends on.
- For many libraries '--with-LIB-includes=DIR' and
-'--with-LIB-libdir=DIR' can specify non-standard search locations;
-others use 'pkg-config' or similar to determine the required flags.
+ For many libraries ‘--with-LIB-includes=DIR’ and
+‘--with-LIB-libdir=DIR’ can specify non-standard search locations;
+others use ‘pkg-config’ or similar to determine the required flags.
- The top-level 'configure' script performs a consistency check for all
+ The top-level ‘configure’ script performs a consistency check for all
required system libraries and bails out if tests fail.
* Menu:
@@ -1992,25 +1993,25 @@
File: tlbuild.info, Node: Configure options for kpathsea, Up: Library-specific configure options
-7.3.1 Configure options for 'kpathsea'
+7.3.1 Configure options for ‘kpathsea’
--------------------------------------
-'--enable-CMD-default', '--disable-CMD-default'
+‘--enable-CMD-default’, ‘--disable-CMD-default’
Determine the compile time default for whether or not to run CMD, which
is one of:
-'mkocp'
+‘mkocp’
(Omega compiled translation process file)
-'mkofm'
+‘mkofm’
(Omega font metrics file)
-'mktexfmt'
+‘mktexfmt’
(format/base dump file)
-'mktexmf'
+‘mktexmf’
(Metafont source)
-'mktexpk'
+‘mktexpk’
(PK bitmap font)
-'mktextex'
+‘mktextex’
(TeX source)
-'mktextfm'
+‘mktextfm’
(TFM file)
to generate the specified type of file dynamically. The default can be
@@ -2022,44 +2023,44 @@
7.4 Variables for configure
===========================
-The values for these variables can be specified as 'configure' arguments
-of the form 'VAR=VALUE'. They can also be defined in the environment,
+The values for these variables can be specified as ‘configure’ arguments
+of the form ‘VAR=VALUE’. They can also be defined in the environment,
but that might not work for cross compilations.
-'CC'
-'CXX'
-'CPPFLAGS'
+‘CC’
+‘CXX’
+‘CPPFLAGS’
And plenty more. As usual with Autoconf, these variables specify
the name (or full path) of compilers, preprocessor flags, and
similar. *Note (autoconf)Preset Output Variables::.
-'CLISP'
- Name (or full path) of the 'clisp' executable, used to build
- 'xindy'.
+‘CLISP’
+ Name (or full path) of the ‘clisp’ executable, used to build
+ ‘xindy’.
-'FT2_CONFIG'
-'ICU_CONFIG'
-'PKG_CONFIG'
- These specify the name (or path) for the 'freetype-config',
- 'icu-config', and 'pkg-config' commands used to determine the flags
- required for system versions of 'libfreetype', the ICU libraries,
+‘FT2_CONFIG’
+‘ICU_CONFIG’
+‘PKG_CONFIG’
+ These specify the name (or path) for the ‘freetype-config’,
+ ‘icu-config’, and ‘pkg-config’ commands used to determine the flags
+ required for system versions of ‘libfreetype’, the ICU libraries,
and other libraries, respectively.
-'KPSEWHICH'
- Name (or path) of an installed 'kpsewhich' binary, used by 'make
- check' to determine the location of, e.g., 'cmbx10.tfm'.
+‘KPSEWHICH’
+ Name (or path) of an installed ‘kpsewhich’ binary, used by ‘make
+ check’ to determine the location of, e.g., ‘cmbx10.tfm’.
-'MAKE'
-'SED'
- And more. Name (or path) of the 'make', 'sed', and similar
+‘MAKE’
+‘SED’
+ And more. Name (or path) of the ‘make’, ‘sed’, and similar
programs; used at the top level and propagated to all
subdirectories.
-'PERL'
-'LATEX'
-'PDFLATEX'
- Name (or full path) for the 'perl', 'latex', and 'pdflatex'
- commands used, e.g., to build the 'xindy' documentation.
+‘PERL’
+‘LATEX’
+‘PDFLATEX’
+ Name (or full path) for the ‘perl’, ‘latex’, and ‘pdflatex’
+ commands used, e.g., to build the ‘xindy’ documentation.
File: tlbuild.info, Node: Coding conventions, Next: Continuous integration, Prev: Configure options, Up: Top
@@ -2067,12 +2068,12 @@
8 Coding conventions
********************
-Ideally, building all of TeX Live with '--enable-compiler-warnings=max'
+Ideally, building all of TeX Live with ‘--enable-compiler-warnings=max’
should produce no (GCC) compiler warnings at all. In spite of
considerable efforts into that direction we are still far from that goal
and there are reasons that we may never fully reach it. Below are some
rules about declarations of functions or variables and the use of
-'const'. These rules should be applied to the code maintained in the
+‘const’. These rules should be applied to the code maintained in the
TeX Live tree and for other packages whose maintainers are willing to
accept patches.
@@ -2092,7 +2093,7 @@
The TeX Live build system no longer supports pre-ANSI C compilers. Thus
all function prototypes and definitions must conform to the ANSI C
-standard (including 'void' in the declaration of C functions with no
+standard (including ‘void’ in the declaration of C functions with no
parameters). On the other hand, TL is built for a wide variety of
systems, not all of which support the C99 standard. Therefore using C99
features should be avoided if that can easily be done. In particular, C
@@ -2101,10 +2102,10 @@
If some C99 (or later) constructs must be used, the module should
verify that they are available and otherwise provide an alternative.
-For example, the module 'texk/chktex' uses the C99 function 'stpcpy()'
+For example, the module ‘texk/chktex’ uses the C99 function ‘stpcpy()’
that may or may not be available on a particular system. It uses
-'AC_CHECK_DECLS([stpcpy])' in 'configure.ac' to test this, and provides
-a perhaps less efficient alternative (in the file 'Utility.h'):
+‘AC_CHECK_DECLS([stpcpy])’ in ‘configure.ac’ to test this, and provides
+a perhaps less efficient alternative (in the file ‘Utility.h’):
#if !(defined HAVE_DECL_STPCPY && HAVE_DECL_STPCPY)
static inline char *stpcpy(char *dest, const char *src)
@@ -2116,17 +2117,17 @@
Static functions
................
-Functions used in only one file should be declared 'static'; they
+Functions used in only one file should be declared ‘static’; they
require no prototype except in forward declarations.
Extern functions
................
-Functions not declared 'static', usually because they are used in
-several files, require an ('extern') prototype in exactly one header
+Functions not declared ‘static’, usually because they are used in
+several files, require an (‘extern’) prototype in exactly one header
file, which is included in the file defining the function and in all
-files using that function--this is the only way to guarantee consistency
-between definition and use. There should be no 'extern' declarations
+files using that function—this is the only way to guarantee consistency
+between definition and use. There should be no ‘extern’ declarations
sprinkled throughout the C code (with or without comments as to where
that function is defined).
@@ -2134,7 +2135,7 @@
.....................
The declaration of global variables follows analogous rules: they are
-either declared 'static' if used in only one file or declared 'extern'
+either declared ‘static’ if used in only one file or declared ‘extern’
in exactly one header and instantiated in exactly one file.
@@ -2143,39 +2144,39 @@
8.2 Const
=========
-The 'const' feature of C is valuable, but easy to mis-use.
+The ‘const’ feature of C is valuable, but easy to mis-use.
Function parameters
...................
Ideally, a function parameter not modified by the function should be
-declared as 'const'. This is important in particular for strings
-('char*') because the actual arguments are often string literals. It is
-perfectly legitimate and safe to use a type 'char*' value for a type
-'const char*' variable (in an assignment, as initializer, as function
+declared as ‘const’. This is important in particular for strings
+(‘char*’) because the actual arguments are often string literals. It is
+perfectly legitimate and safe to use a type ‘char*’ value for a type
+‘const char*’ variable (in an assignment, as initializer, as function
argument, or as return value). It is equally safe to use a type
-'char**' value for a type 'const char*const*' variable, but not for a
-type 'const char**' variable since that might cause modification of a
+‘char**’ value for a type ‘const char*const*’ variable, but not for a
+type ‘const char**’ variable since that might cause modification of a
quantity supposed to be constant.
- Getting all 'const' qualifiers right can get quite involved but can
+ Getting all ‘const’ qualifiers right can get quite involved but can
almost always be done. There are only a couple notable exceptions: the
-X11 headers are full of declarations that ought to use 'const' but do
-not; at one time, 'libfreetype' also did not fully specify 'const', but
+X11 headers are full of declarations that ought to use ‘const’ but do
+not; at one time, ‘libfreetype’ also did not fully specify ‘const’, but
this has not been checked recently.
-What must be avoided with 'const'
+What must be avoided with ‘const’
.................................
-The GCC compiler warnings "assignment discards qualifiers..." and
-analogous warnings for "initialization", "passing arg", or "return" must
+The GCC compiler warnings “assignment discards qualifiers...” and
+analogous warnings for “initialization”, “passing arg”, or “return” must
be strenuously avoided in our own code. The only exception is when they
are caused by X11 declarations or other third party code.
-What should be avoided with 'const'
+What should be avoided with ‘const’
...................................
-A type cast, e.g., from 'const char*' to 'char*' does not solve any
+A type cast, e.g., from ‘const char*’ to ‘char*’ does not solve any
problems; depending on warning options, it may only hide them.
Therefore such casts should be avoided whenever possible and otherwise
must be carefully analyzed to make sure that they cannot cause the
@@ -2208,7 +2209,7 @@
======================================
The git-svn program (<https://git-scm.com/docs/git-svn>) is used to
-check out the subtree 'Build/source' of the canonical Subversion
+check out the subtree ‘Build/source’ of the canonical Subversion
repository. The author index file used is not maintained in either Git
or Subversion but can be provided on request.
@@ -2216,7 +2217,7 @@
git svn --authors-file usermap clone \
svn://USER@tug.org/texlive/trunk/Build/source
-where the 'usermap' file maps Subversion user names to name and emails
+where the ‘usermap’ file maps Subversion user names to name and emails
of the authors. Anonymous checkout is also possible:
git svn --authors-file usermap clone \
svn://tug.org/texlive/trunk/Build/source
@@ -2223,29 +2224,29 @@
In the following, we will use _admin_ to refer to a user who has
read/write access to the TeX Live subversion repository, and is also an
-administrator of the ''TeX-Live'' team at Github. The above initial
-checkout has been carried out by _admin_ on the server 'texlive.info'.
+administrator of the ‘‘TeX-Live’’ team at Github. The above initial
+checkout has been carried out by _admin_ on the server ‘texlive.info’.
- On Github, a new git repository named 'texlive-source' was created by
-_admin_ within the 'TeX-Live' "organization"
+ On Github, a new git repository named ‘texlive-source’ was created by
+_admin_ within the ‘TeX-Live’ “organization”
(<https://github.com/TeX-Live>). The remote was added to the checkout
-with 'git remote add origin git at github.com:TeX-Live/texlive-source.git'.
+with ‘git remote add origin git at github.com:TeX-Live/texlive-source.git’.
To automate the update on Github, a new ssh key was generated and
-added to the 'texlive-source' repository on Github as deployment key.
-Thus, pushes using this key can only go to the 'texlive-source'
+added to the ‘texlive-source’ repository on Github as deployment key.
+Thus, pushes using this key can only go to the ‘texlive-source’
repository and not anywhere else.
- The usage of 'git-svn' requires a strict discipline to keep a linear
+ The usage of ‘git-svn’ requires a strict discipline to keep a linear
history in the master branch. Since we are aiming at a pure mirror
-facility on Github, we have decided to further restrict the 'master'
-branch of the 'texlive-source' repository on Github to changes by
+facility on Github, we have decided to further restrict the ‘master’
+branch of the ‘texlive-source’ repository on Github to changes by
_admin_.
- This setup allows other developers to branch off 'master' and push
+ This setup allows other developers to branch off ‘master’ and push
their branches to the Github repository, but all updates need to come
-from the local 'master' (not the one on Github) to Subversion, back to
-'master' on 'texlive.info', and from there to Github.
+from the local ‘master’ (not the one on Github) to Subversion, back to
+‘master’ on ‘texlive.info’, and from there to Github.
File: tlbuild.info, Node: Automatic update of the Git mirror, Next: CI testing on Travis-CI, Prev: Transfer from Subversion to Github, Up: Continuous integration
@@ -2253,10 +2254,10 @@
9.2 Automatic update of the Git mirror
======================================
-_admin_ has installed a cron job on 'texlive.info' running every 30
-minute which essentially runs 'git svn rebase' and 'git push' in the
-'master' branch of the checkout. The first command fetches the changes
-from the Subversion repository and updates the 'master' branch with
+_admin_ has installed a cron job on ‘texlive.info’ running every 30
+minute which essentially runs ‘git svn rebase’ and ‘git push’ in the
+‘master’ branch of the checkout. The first command fetches the changes
+from the Subversion repository and updates the ‘master’ branch with
them, and the second pushes changes (if any) to Github.
@@ -2265,10 +2266,10 @@
9.3 CI testing on Travis-CI
===========================
-The 'source' tree of TeX Live contains a top-level file '.travis.yml'
+The ‘source’ tree of TeX Live contains a top-level file ‘.travis.yml’
which controls the automatic testing on Travis-CI. _admin_ has
-registered with Travis-CI and allowed access to the Github's 'TeX-Live'
-organization's 'texlive-source' repository. The default settings are to
+registered with Travis-CI and allowed access to the Github’s ‘TeX-Live’
+organization’s ‘texlive-source’ repository. The default settings are to
build the last commit of each push. No further action is necessary on
Travis-CI.
@@ -2281,7 +2282,7 @@
9.4 Releases on Github
======================
-Given a git checkout of 'texlive-source':
+Given a git checkout of ‘texlive-source’:
git pull
git tag build-svnNNNN
@@ -2289,7 +2290,7 @@
and the result will appear at
<https://github.com/TeX-Live/texlive-source/releases>. Releases can
-also be made manually from that web page (see 'tl-update-bindir' for
+also be made manually from that web page (see ‘tl-update-bindir’ for
hints).
@@ -2304,16 +2305,19 @@
* install-tl SYNOPSIS::
* install-tl DESCRIPTION::
* install-tl REFERENCES::
+* install-tl EXAMPLES::
* install-tl OPTIONS::
* install-tl PROFILES::
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list.