From add3d8683677b558254f61267e1dc6830c9c73da Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 28 Feb 2019 19:14:13 +0000 Subject: tl19 texinfo update git-svn-id: svn://tug.org/texlive/trunk@50170 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/dvipng/dvipng.html | 441 ++- Master/texmf-dist/doc/dvipng/dvipng.pdf | Bin 220177 -> 220174 bytes Master/texmf-dist/doc/dvips/dvips.html | 2326 ++++++------- Master/texmf-dist/doc/dvips/dvips.pdf | Bin 405414 -> 405527 bytes Master/texmf-dist/doc/info/dvips.info | 4 +- Master/texmf-dist/doc/info/kpathsea.info | 227 +- Master/texmf-dist/doc/info/tlbuild.info | 1603 ++++----- Master/texmf-dist/doc/info/web2c.info | 6 +- Master/texmf-dist/doc/kpathsea/kpathsea.html | 2112 ++++++------ Master/texmf-dist/doc/kpathsea/kpathsea.pdf | Bin 388425 -> 390501 bytes Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html | 3579 +++++++++----------- Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf | Bin 493309 -> 496534 bytes Master/texmf-dist/doc/web2c/web2c.html | 2529 +++++++------- Master/texmf-dist/doc/web2c/web2c.pdf | Bin 464711 -> 464712 bytes 14 files changed, 6103 insertions(+), 6724 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index ae4503aa543..f3ff549bb85 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.html +++ b/Master/texmf-dist/doc/dvipng/dvipng.html @@ -1,6 +1,6 @@ - + A DVI-to-PNG translator @@ -18,23 +18,14 @@ - + Dvips: A DVI-to-PostScript translator @@ -21,23 +21,14 @@ PostScript. You may freely use, modify and/or distribute this file. --> - + Kpathsea: A library for path searching @@ -36,23 +36,14 @@ approved by the TeX Users Group. --> - + -Building TeX Live (2018) +Building TeX Live (2019) - - + + @@ -38,23 +38,14 @@ approved by the TeX Users Group. --> -
+
paper –json
-
+
@@ -5136,20 +4964,18 @@ some programs, notably dvips. tlmgr does not support settings.


- -
+

Next: , Previous: , Up: tlmgr ACTIONS   [Contents][Index]

- -

B.6.17 path

+

B.6.17 path

path [–w32mode=user|admin] add
-
+
path [–w32mode=user|admin] remove
-
+

On Unix, merely adds or removes symlinks for binaries, man pages, and info pages in the system directories specified by the respective options (see the option description above). Does not change any @@ -5179,59 +5005,55 @@ is issued that the caller does not have enough privileges.


- -
+

Next: , Previous: , Up: tlmgr ACTIONS   [Contents][Index]

- -

B.6.18 pinning

+

B.6.18 pinning

The pinning action manages the pinning file, see Pinning below.

pinning show
-
+

Shows the current pinning data.

pinning add repo pkgglob...
-
+

Pins the packages matching the pkgglob(s) to the repository repo.

pinning remove repo pkgglob...
-
+

Any packages recorded in the pinning file matching the <pkgglob>s for the given repository repo are removed.

pinning remove repo --all
-
+

Remove all pinning data for repository repo.


- -
+ - -

B.6.19 platform

+

B.6.19 platform

platform list|add|remove platform...
-
+
platform set platform
-
+
platform set auto
-
+

platform list lists the TeX Live names of all the platforms (a.k.a. architectures), (i386-linux, ...) available at the package repository. @@ -5257,7 +5079,7 @@ platform instead of auto detection.

–dry-run
-
+

Nothing is actually installed; instead, the actions to be performed are written to the terminal.

@@ -5268,20 +5090,18 @@ written to the terminal.

- -
+ - -

B.6.20 postaction

+

B.6.20 postaction

postaction [option...] install [shortcut|fileassoc|script] [pkg...]
-
+
postaction [option...] remove [shortcut|fileassoc|script] [pkg...]
-
+

Carry out the postaction shortcut, fileassoc, or script given as the second required argument in install or remove mode (which is the first required argument), for either the packages given on the command @@ -5291,7 +5111,7 @@ line, or for all if --all is given.

–w32mode=[user|admin]
-
+

If the option --w32mode is given the value user, all actions will only be carried out in the user-accessible parts of the registry/filesystem, while the value admin selects the system-wide @@ -5300,7 +5120,7 @@ enough permissions, using --w32mode=admin will not succeed.

–fileassocmode=[1|2]
-
+

--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 2, all associations are set to the TeX Live programs. (See also @@ -5308,7 +5128,7 @@ set to 1 (the default), only new associations are added; if it is set to

–all
-
+

Carry out the postactions for all packages

@@ -5318,38 +5138,32 @@ set to 1 (the default), only new associations are added; if it is set to

- -
+ - -

B.6.21 print-platform

+

B.6.21 print-platform

Print the TeX Live identifier for the detected platform (hardware/operating system) combination to standard output, and exit. --print-arch is a synonym.


- -
+ - -

B.6.22 print-platform-info

+

B.6.22 print-platform-info

Print the TeX Live platform identifier, TL platform long name, and original output from guess.


- -
+ - -

B.6.23 remove [option...] pkg...

+

B.6.23 remove [option...] pkg...

Remove each pkg specified. Removing a collection removes all package dependencies (unless --no-depends is specified), but not any @@ -5358,16 +5172,16 @@ package, dependencies are never removed. Options:

–all
-
+

Uninstalls all of TeX Live, asking for confirmation unless --force is also specified.

–backup
-
+
–backupdir directory
-
+

These options behave just as with the (update)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. @@ -5376,17 +5190,17 @@ such a backup, that is, to save a copy of packages before removal.

–no-depends
-
+

Do not remove dependent packages.

–no-depends-at-all
-
+

See above under install (and beware).

–force
-
+

By default, removal of a package or collection that is a dependency of another collection or scheme is not allowed. With this option, the package will be removed unconditionally. Use with care. @@ -5398,7 +5212,7 @@ updated, and will be mentioned as forcibly removed in the output of

–dry-run
-
+

Nothing is actually removed; instead, the actions to be performed are written to the terminal.

@@ -5406,29 +5220,27 @@ written to the terminal.

- -
+ - -

B.6.24 repository

+

B.6.24 repository

repository list
-
+
repository list path|tag
-
+
repository add path [tag]
-
+
repository remove path|tag
-
+
repository set path[#tag] [path[#tag] ...]
-
+

This action manages the list of repositories. See (MULTIPLE_REPOSITORIES) below for detailed explanations.

The first form (list) lists all configured repositories and the @@ -5452,20 +5264,18 @@ otherwise, all operations will fail!


- -
+ - -

B.6.25 restore

+

B.6.25 restore

restore [option...] pkg [rev]
-
+
restore [option...] –all
-
+

Restore a package from a previously-made backup.

If --all is given, try to restore the latest revision of all @@ -5485,31 +5295,31 @@ specified, try to restore the package from the specified backup.

–all
-
+

Try to restore the latest revision of all package backups found in the backup directory. Additional non-option arguments (like pkg) are not allowed.

–backupdir directory
-
+

Specify the directory where the backups are to be found. If not given it will be taken from the configuration setting in the TLPDB.

–dry-run
-
+

Nothing is actually restored; instead, the actions to be performed are written to the terminal.

–force
-
+

Don’t ask questions.

–json
-
+

When listing backups, the option --json turn on JSON output. The format is an array of JSON objects (name, rev, date). For details see tlpkg/doc/JSON-formats.txt, format definition: TLBACKUPS. @@ -5522,23 +5332,21 @@ If both --json and --data are given, --json


- -
+

Next: , Previous: , Up: tlmgr ACTIONS   [Contents][Index]

- -

B.6.26 search

+

B.6.26 search

search [option...] what
-
+
search [option...] –file what
-
+
search [option...] –all what
-
+

By default, search the names, short descriptions, and long descriptions of all locally installed packages for the argument what, interpreted as a (Perl) regular expression. @@ -5547,23 +5355,23 @@ as a (Perl) regular expression.

–file
-
+

List all filenames containing what.

–all
-
+

Search everything: package names, descriptions and filenames.

–global
-
+

Search the TeX Live Database of the installation medium, instead of the local installation.

–word
-
+

Restrict the search of package names and descriptions (but not filenames) to match only full words. For example, searching for table with this option will not output packages containing the word @@ -5576,13 +5384,11 @@ filenames) to match only full words. For example, searching for


- -
+

Next: , Previous: , Up: tlmgr ACTIONS   [Contents][Index]

- -

B.6.27 shell

+

B.6.27 shell

Starts an interactive mode, where tlmgr prompts for commands. This can be used directly, or for scripting. The first line of output is @@ -5599,43 +5405,43 @@ the session.

protocol
-
+

Print protocol n, the current protocol version.

help
-
+

Print pointers to this documentation.

version
-
+

Print tlmgr version information.

quit, end, bye, byebye, EOF
-
+

Exit.

restart
-
+

Restart tlmgr shell with the original command line; most useful when developing tlmgr.

load [local|remote]
-
+

Explicitly load the local or remote, respectively, TLPDB.

save
-
+

Save the local TLPDB, presumably after other operations have changed it.

get [var] =item set [var [val]]
-
+

Get the value of var, or set it to val. Possible var names: debug-translation, machine-readable, no-execute-actions, require-verification, verify-downloads, repository, and @@ -5651,35 +5457,29 @@ current default prompt.


- -
+ - -

B.6.28 show

+

B.6.28 show

Synonym for info.


- -
+ - -

B.6.29 uninstall

+

B.6.29 uninstall

Synonym for remove.


- -
+ - -

B.6.30 update [option...] [pkg...]

+

B.6.30 update [option...] [pkg...]

Updates the packages given as arguments to the latest version available at the installation source. Either --all or at least one pkg name @@ -5687,7 +5487,7 @@ must be specified. Options:

–all
-
+

Update all installed packages except for tlmgr itself. Thus, if updates to tlmgr itself are present, this will simply give an error, unless also the option --force or --self is given. (See below.) @@ -5720,7 +5520,7 @@ due to a slow link), see the --exclude option below.

–self
-
+

Update tlmgr itself (that is, the infrastructure packages) if updates to it are present. On Windows this includes updates to the private Perl interpreter shipped inside TeX Live. @@ -5739,13 +5539,13 @@ updates.

–dry-run
-
+

Nothing is actually installed; instead, the actions to be performed are written to the terminal. This is a more detailed report than --list.

–list [pkg]
-
+

Concisely list the packages which would be updated, newly installed, or removed, without actually changing anything. If --all is also given, all available updates are listed. @@ -5760,7 +5560,7 @@ given, those packages are checked for updates.

–exclude pkg
-
+

Exclude pkg from the update process. If this option is given more than once, its arguments accumulate.

@@ -5782,7 +5582,7 @@ the key update-exclude.

–no-auto-remove [pkg...]
-
+

By default, tlmgr tries to remove packages which have disappeared on the server, as described above under --all. This option prevents such removals, either for all packages (with --all), or for just the @@ -5792,7 +5592,7 @@ authors. Therefore this is not recommend.

–no-auto-install [pkg...]
-
+

Under normal circumstances tlmgr will install packages which are new on the server, as described above under --all. This option prevents any such automatic installation, either for all packages (with @@ -5812,7 +5612,7 @@ server, then

–reinstall-forcibly-removed
-
+

Under normal circumstances tlmgr will not install packages that have been forcibly removed by the user; that is, removed with remove --force, or whose installation was prohibited by --no-auto-install @@ -5826,10 +5626,10 @@ installation with the server’s idea of what is available:

–backup
-
+
–backupdir directory
-
+

These two options control the creation of backups of packages before updating; that is, backup of packages as currently installed. If neither options is given, no backup will made. If --backupdir is @@ -5852,19 +5652,19 @@ incompatibility.

–no-depends
-
+

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.

–no-depends-at-all
-
+

See above under install (and beware).

–force
-
+

Force update of normal packages, without updating tlmgr itself (unless the --self option is also given). Not recommended.

@@ -5885,13 +5685,11 @@ fallback information, but if you don’t like them accumulating (e.g., a possibly different hash), it’s harmless to delete them.


- -
+ - -

B.7 CONFIGURATION FILE FOR TLMGR

+

B.7 CONFIGURATION FILE FOR TLMGR

There are two configuration files for tlmgr: One is system-wide in TEXMFSYSCONFIG/tlmgr/config, and the other is user-specific in @@ -5915,28 +5713,28 @@ ignored. All other lines must look like:

auto-remove, value 0 or 1 (default 1), same as command-line option.
-
+
gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.
-
+
gui-lang llcode, with a language code value as with the command-line option.
-
+
no-checksums, value 0 or 1 (default 0, see below).
-
+
persistent-downloads, value 0 or 1 (default 1), same as command-line option.
-
+
require-verification, value 0 or 1 (default 0), same as command-line option.
-
+
update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.
-
+
verify-downloads, value 0 or 1 (default 1), same as command-line option.
-
+
@@ -5944,7 +5742,7 @@ ignored. All other lines must look like:

allowed-actions action1 [,action,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).
-
+

This allows distributors to include the tlmgr in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn’t @@ -5969,13 +5767,11 @@ Perl and pure Lua modules, are much too slow to be usable in our context.) no-checksums avoids the warning.


- -
+ - -

B.8 CRYPTOGRAPHIC VERIFICATION

+

B.8 CRYPTOGRAPHIC VERIFICATION

tlmgr and install-tl perform cryptographic verification if possible. If verification is performed and successful, the programs @@ -6013,18 +5809,16 @@ of these keys are obtainable from the standard key servers.

Additional trusted keys can be added using the key action.

-
- -
+ - -

B.8.1 Configuration of GnuPG invocation

+

B.8.1 Configuration of GnuPG invocation

The executable used for GnuPG is searched as follows: If the environment variable TL_GNUPG is set, it is tested and used; otherwise gpg is @@ -6036,13 +5830,11 @@ value for --homedir, and TL_GNUPGARGS, which replaces options --no-secmem-warning --no-permission-warning.


- -
+ - -

B.9 USER MODE

+

B.9 USER MODE

tlmgr provides a restricted way, called “user mode”, to manage arbitrary texmf trees in the same way as the main installation. For @@ -6097,22 +5889,20 @@ installed into a user tree.

Description of changes of actions in user mode:

- - -
- -
+ - -

B.9.1 User mode install

+

B.9.1 User mode install

In user mode, the install action checks that the package and all dependencies are all either relocated or already installed in the system @@ -6133,39 +5923,33 @@ the user’s updmap.cfg in USERTREE/web2c/ is made regenerated from the list of installed packages.


- -
+ - -

B.9.2 User mode backup, restore, remove, update

+

B.9.2 User mode backup, restore, remove, update

In user mode, these actions check that all packages to be acted on are installed in the user tree before proceeding; otherwise, they behave just as in normal mode.


- -
+ - -

B.9.3 User mode generate, option, paper

+

B.9.3 User mode generate, option, paper

In user mode, these actions operate only on the user tree’s configuration files and/or texlive.tlpdb. creates configuration files in user tree


- -
+ - -

B.10 MULTIPLE REPOSITORIES

+

B.10 MULTIPLE REPOSITORIES

The main TeX Live repository contains a vast array of packages. Nevertheless, additional local repositories can be useful to provide @@ -6197,18 +5981,16 @@ taken from the new repository, by specifying so-called “pinning” rules, described next.

-
- -
+ - -

B.10.1 Pinning

+

B.10.1 Pinning

When a package foo is pinned to a repository, a package foo in any other repository, even if it has a higher revision number, will not be @@ -6271,13 +6053,11 @@ from a given repository:

A summary of the tlmgr pinning actions is given above.


- -
+ - -

B.11 GUI FOR TLMGR

+

B.11 GUI FOR TLMGR

The graphical user interface for tlmgr requires Perl/Tk http://search.cpan.org/search?query=perl%2Ftk. For Windows the @@ -6302,40 +6082,36 @@ repository. To load a different repository, see the tlmgr menu ite information about what is going on.

- - -
- -
+ - -

B.11.1 Main display

+

B.11.1 Main display

- - -
- -
+ - -

B.11.1.1 Display configuration area

+

B.11.1.1 Display configuration area

The first part of the main display allows you to specify (filter) which packages are shown. By default, all are shown. Changes here are @@ -6343,34 +6119,34 @@ reflected right away.

Status
-
+

Select whether to show all packages (the default), only those installed, only those not installed, or only those with update available.

Category
-
+

Select which categories are shown: packages, collections, and/or schemes. These are briefly explained in the DESCRIPTION section above.

Match
-
+

Select packages matching for a specific pattern. By default, this searches both descriptions and filenames. You can also select a subset for searching.

Selection
-
+

Select packages to those selected, those not selected, or all. Here, “selected” means that the checkbox in the beginning of the line of a package is ticked.

Display configuration buttons
-
+

To the right there are three buttons: select all packages, select none (a.k.a. deselect all), and reset all these filters to the defaults, i.e., show all available. @@ -6379,13 +6155,11 @@ i.e., show all available.


- -
+ - -

B.11.1.2 Package list area

+

B.11.1.2 Package list area

The second are of the main display lists all installed packages. If a repository is loaded, those that are available but not installed are @@ -6398,18 +6172,18 @@ further details: the long description, included files, etc.

a checkbox
-
+

Used to select particular packages; some of the action buttons (see below) work only on the selected packages.

package name
-
+

The name (identifier) of the package as given in the database.

local revision (and version)
-
+

If the package is installed the TeX Live revision number for the installed package will be shown. If there is a catalogue version given in the database for this package, it will be shown in parentheses. @@ -6418,7 +6192,7 @@ guaranteed to reflect what is actually installed.

remote revision (and version)
-
+

If a repository has been loaded the revision of the package in the repository (if present) is shown. As with the local column, if a catalogue version is provided it will be displayed. And also as with @@ -6426,26 +6200,24 @@ the local column, the catalogue version may be stale.

short description
-
+

The short description of the package.


- -
+ - -

B.11.1.3 Main display action buttons

+

B.11.1.3 Main display action buttons

Below the list of packages are several buttons:

Update all installed
-
+

This calls tlmgr update --all, i.e., tries to update all available packages. Below this button is a toggle to allow reinstallation of previously removed packages as part of this action. @@ -6455,26 +6227,26 @@ where the checkbox at the beginning of the package line is ticked.

Update
-
+

Update only the selected packages.

Install
-
+

Install the selected packages; acts like tlmgr install, i.e., also installs dependencies. Thus, installing a collection installs all its constituent packages.

Remove
-
+

Removes the selected packages; acts like tlmgr remove, i.e., it will also remove dependencies of collections (but not dependencies of normal packages).

Backup
-
+

Makes a backup of the selected packages; acts like tlmgr backup. This action needs the option backupdir set (see Options - General>).

@@ -6482,19 +6254,17 @@ action needs the option backupdir set (see Options - G

- -
+ - -

B.11.2 Menu bar

+

B.11.2 Menu bar

The following entries can be found in the menu bar:

tlmgr menu
-
+

The items here load various repositories: the default as specified in the TeX Live database, the default network repository, the repository specified on the command line (if any), and an arbitrarily @@ -6502,7 +6272,7 @@ manually-entered one. Also has the so-necessary quit operation.

Options menu
-
+

Provides access to several groups of options: Paper (configuration of default paper sizes), Platforms (only on Unix, configuration of the supported/installed platforms), GUI Language (select language used in @@ -6522,7 +6292,7 @@ installation; e.g., when a package is renamed.

Actions menu
-
+

Provides access to several actions: update the filename database (aka ls-R, mktexlsr, texhash), rebuild all formats (fmtutil-sys --all), update the font map database (updmap-sys), restore from a backup @@ -6534,7 +6304,7 @@ on Windows).

Help menu
-
+

Provides access to the TeX Live manual (also on the web at http://tug.org/texlive/doc.html) and the usual “About” box.

@@ -6542,43 +6312,41 @@ on Windows).

- -
+ - -

B.11.3 GUI options

+

B.11.3 GUI options

Some generic Perl/Tk options can be specified with tlmgr gui to control the display:

-background color
-
+

Set background color.

-font " fontname fontsize "
-
+

Set font, e.g., tlmgr gui -font "helvetica 18". The argument to -font must be quoted, i.e., passed as a single string.

-foreground color
-
+

Set foreground color.

-geometry geomspec
-
+

Set the X geometry, e.g., tlmgr gui -geometry 1024x512-0+0 creates the window of (approximately) the given size in the upper-right corner of the display.

-xrm xresource
-
+

Pass the arbitrary X resource string xresource.

@@ -6589,13 +6357,11 @@ the Perl/Tk documentation (http://se complete list, and any X documentation for general information.


-
-
+ - -

B.12 MACHINE-READABLE OUTPUT

+

B.12 MACHINE-READABLE OUTPUT

With the --machine-readable option, tlmgr writes to stdout in the fixed line-oriented format described here, and the usual informational @@ -6609,20 +6375,18 @@ information it needs by reading stdout. option actions.

- -
- -
+ - -

B.12.1 Machine-readable update and install output

+

B.12.1 Machine-readable update and install output

The output format is as follows:

@@ -6651,14 +6415,14 @@ and the estimated total time.

location-url location
-
+

The location may be a url (including file:///foo/bar/...), or a directory name (/foo/bar). It is the package repository from which the new package information was drawn.

total-bytes count
-
+

The count is simply a decimal number, the sum of the sizes of all the packages that need updating or installing (which are listed subsequently).

@@ -6673,54 +6437,54 @@ each line are separated by a tab. Here are the fields.

pkgname
-
+

The TeX Live package identifier, with a possible platform suffix for executables. For instance, pdftex and pdftex.i386-linux are given as two separate packages, one on each line.

status
-
+

The status of the package update. One character, as follows:

d
-
+

The package was removed on the server.

f
-
+

The package was removed in the local installation, even though a collection depended on it. (E.g., the user ran tlmgr remove --force.)

u
-
+

Normal update is needed.

r
-
+

Reversed non-update: the locally-installed version is newer than the version on the server.

a
-
+

Automatically-determined need for installation, the package is new on the server and is (most probably) part of an installed collection.

i
-
+

Package will be installed and isn’t present in the local installation (action install).

I
-
+

Package is already present but will be reinstalled (action install).

@@ -6728,43 +6492,41 @@ the server and is (most probably) part of an installed collection.
localrev
-
+

The revision number of the installed package, or - if it is not present locally.

serverrev
-
+

The revision number of the package on the server, or - if it is not present on the server.

size
-
+

The size in bytes of the package on the server. The sum of all the package sizes is given in the total-bytes header field mentioned above.

runtime
-
+

The run time since start of installations or updates.

esttot
-
+

The estimated total time.


- -
+ - -

B.12.2 Machine-readable option output

+

B.12.2 Machine-readable option output

The output format is as follows:

@@ -6776,13 +6538,11 @@ Previous:
-
-
+ - -

B.13 AUTHORS AND COPYRIGHT

+

B.13 AUTHORS AND COPYRIGHT

This script and its documentation were written for the TeX Live distribution (http://tug.org/texlive) and both are licensed under the @@ -6792,18 +6552,14 @@ GNU General Public License Version 2 or later.


- -
+

Previous: , Up: Top   [Contents][Index]

- -

Index

+

Index

- + @@ -6920,10 +6676,7 @@ Previous: , Up: -C configure option: - - - - + @@ -6938,7 +6691,7 @@ Previous: , Up: autoconf macros: - + @@ -6947,6 +6700,7 @@ Previous: , Up: build directory, required: + @@ -6957,8 +6711,8 @@ Previous: , Up: building a distribution: - - + + @@ -6968,14 +6722,13 @@ Previous: , Up: CC=c-compiler: - - + @@ -7004,9 +6757,9 @@ Previous: , Up: CXX: - - + + @@ -7015,20 +6768,19 @@ Previous: , Up: dist and distcheck targets for make: + - - + + - - + - @@ -7038,9 +6790,12 @@ Previous: , Up: freetype-config: - + + + + @@ -7048,7 +6803,7 @@ Previous: , Up: GNU/Linux distro: - + @@ -7062,7 +6817,7 @@ Previous: , Up: introduction: - + @@ -7109,11 +6864,13 @@ Previous: , Up: KPSE_WITH_LIB: - + + + @@ -7121,6 +6878,7 @@ Previous: , Up: library module, TeX-specific, adding: + @@ -7130,7 +6888,7 @@ Previous: , Up: lisp.run, lisp.exe: - + @@ -7140,6 +6898,7 @@ Previous: , Up: macros, general setup: + @@ -7149,18 +6908,19 @@ Previous: , Up: modules, for programs: - + - + + - + @@ -7179,15 +6939,16 @@ Previous: , Up: program module, adding: + - + - + - + @@ -7208,7 +6969,7 @@ Previous: , Up: synctex: - + @@ -7220,16 +6981,17 @@ Previous: , Up: top-level directories: - + + - + - + - + @@ -7242,11 +7004,12 @@ Previous: , Up: withenable.ac, for new modules: + - + + - @@ -7255,20 +7018,18 @@ Previous: , Up: xindy: - + - +
Jump to:   -   -. -  
A   @@ -6853,7 +6609,7 @@ Previous: , Up:
Index Entry  Section

-
-
--bindir configure option: --prefix --bindir
--bindir configure option: --enable-multiplatform
--build=host: Cross configuring
 Build in parallel
-j make option: Build in parallel

.
.travis.yml: CI testing on Travis-CI

A
A
adapting TeX Live for distros: Distro builds
adding a new generic library: Adding a new generic library module
adding a new program: Adding a new program module
 Autoconf macros
Automake: Overview of build system

B
B
biber: Linked scripts
bibtex-x: Configure options for texk/bibtex-x
bibtex8: Configure options for texk/bibtex-x
 Building
build iteration: Build iteration
build on demand: Build one package
build one engine: Build one engine
build one package: Build one package
build problems: Build problems
Build script: Building
 Build distribution
building in parallel: Build in parallel

C
C++11, required by dvisvgm: Prerequisites
C
C++11, required: Prerequisites
C, ANSI, required: Declarations and definitions
C99, avoided: Declarations and definitions
cache file, for configure: Build in parallel
 Build one package
CC_BUILD: Cross problems
chktex: Declarations and definitions
ci: Continuous integration
clisp: Variables for configure
CLISP: Variables for configure
CLISP: Configure options for utils/xindy
clisp, required by xindy: Prerequisites
Cocoa Mac framework, required by xetex: Prerequisites
coding conventions: Coding conventions
compilers, C and C++: Prerequisites
compilers, C and C++11: Prerequisites
config.guess, config.sub, …: Top-level directories
configure options: Configure options
configure options, for bibtex-x: Configure options for texk/bibtex-x
 Variables for configure
CXX=c++-compiler: Build one package

D
Debian installation of build prerequisites: Prerequisites
D
declarations and definitions, in source code: Declarations and definitions
declarations before statements, avoiding: Declarations and definitions
dependencies, with several output files: Build in parallel
DESTDIR: --prefix --bindir
directories, for installation: Installation directories
 Build distribution
distribution tarball, making: Build distribution
distro, building for: Distro builds
dvipdfm-x: Configure options for texk/dvipdfm-x
dvipdfmx: Configure options for texk/dvipdfm-x
dvisvgm: Configure options for texk/dvisvgm
dvisvgm requirement for C++11: Prerequisites

E
E
engine, building one: Build one engine
environment variables, for configure: Configure options
exec_prefix: --enable-multiplatform
extending TeX Live: Extending TeX Live
extern functions: Declarations and definitions
extra/ top-level directory: Top-level directories

F
F
failure to build: Build problems
ffcall, required by xindy: Prerequisites
flags, macros for library and header: Macros for library and header flags
fontconfig library, required by xetex: Prerequisites
FreeType: Prerequisites
 Variables for configure
FT2_CONFIG: Variables for configure

G
G
gcc, default compilers: Build one package
general setup macros: General setup macros
generic library module, adding: Adding a new generic library module
Ghostscript location for Xdvik: Configure options for texk/xdvik
git-svn: Transfer from Subversion to Github
global configure options: Global configure options
gmake, required: Prerequisites
GNU make, required: Prerequisites
 Distro builds
Gnulib, used for common files: Top-level directories

I
I
ICU cross compiling: Cross problems
ICU libraries: Variables for configure
icu-config: Variables for configure
 Introduction
iteration through sources, by configure and make: Build iteration

K
K
kpathsea library: kpathsea library
kpathsea.ac: kpathsea library
kpse-libpng-flags.m4: png library
 Adding a new generic library module
KPSE_WITH_TEXLIB: Adding a new TeX-specific library module

L
L
large file support: --disable-largefile
LATEX: Variables for configure
layout of sources: Layout and infrastructure
LFS (large file support): --disable-largefile
libexpat, dependency of libfontconfig: Configure options for texk/web2c
libfontconfig, hack for avoiding linking dependencies: Configure options for texk/web2c
libfreetype: Variables for configure
libfreetype, and const: Const
libpng library: png library
 Adding a new TeX-specific library module
library modules: Library modules
library-specific configure options: Library-specific configure options
libsigsegv, required by xindy: Prerequisites
libstc++, statically linking: Macros for compilers
Libtool: Overview of build system
libtool, hack for avoiding excessive linking: Configure options for texk/web2c
 Configure options for utils/xindy
LittleEndian architectures: Configure options for texk/web2c

M
M
m4/ top-level directory: Top-level directories
macros, for compilers: Macros for compilers
macros, for libraries: Macros for libraries
 General setup macros
MAKE: Variables for configure
make -t: Build system tools
make rules, verbose vs. silent: --enable-silent-rules
mf-nowin: Configure options for texk/web2c
mingw32: Cross configuring
MINGW32, Automake conditional: Macros for Windows
 Program modules
motif: Configure options for texk/xdvik

N
N
native cross compilation: Cross compilation

O
O
OBJCXX=objc-compiler: Build one package
one engine, building: Build one engine
one package, building: Build one package
OpenGL, required for Asymptote: asymptote
operating system distribution, building for: Distro builds
otangle: Cross problems
overall build process: Building

P
P
parallel build: Build in parallel
paths, for installation: Installation directories
PDF files, size of: --disable-largefile
 Adding a new program module
program modules: Program modules
program-specific configure options: Program-specific configure options
proxy build system: png library

R
R
reautoconf: Build system tools
requirements for building: Prerequisites
runscript.exe: Macros for Windows

S
S
scripts, linked and not maintained: Linked scripts
scrolling: Configure options for texk/xdvik
scrolling, smooth: Configure options for texk/xdvik
SED: Variables for configure
setup macros, general: General setup macros
shared libraries, using vs. avoiding: Distro builds
 Configure options for texk/web2c
system distribution, building for: Distro builds

T
T
t1utils package: t1utils package
tangle: Cross problems
tests, running: Overview of build system
 Top-level directories
touching files to avoid rerunning: Build system tools
Travis-CI: Continuous integration
type cast, avoiding: Const
travis.yml: CI testing on Travis-CI
type cast from const, avoiding: Const

U
U
use-commit-times, Subversion: Build system tools

V
V
variable declarations, in source code: Declarations and definitions
variables for configure: Variables for configure

W
W
warning, discards qualifiers: Const
WARNING_C[XX]FLAGS: Macros for compilers
web2c program: Cross problems
 Adding a new program module
Work/ top-level directory: Top-level directories
wrapper binary for scripts on Windows: Linked scripts
wrapper build system: freetype library

X
X
X toolkit: Configure options for texk/web2c
X11 development, required by X clients: Prerequisites
X11 headers, and const: Const
X11, required by X clients: Prerequisites
xasy: asymptote
xaw: Configure options for texk/xdvik
xdvik: xdvik package
 Linked scripts
xindy: xindy package
xindy: Configure options for utils/xindy
xindy cross compiling impossible: Cross problems
xindy cross compiling requires clisp: Cross problems
XInput: Configure options for texk/xdvik
Xlib: Configure options for texk/web2c
xpdf as library: Configure options for system poppler
xz: Linked scripts

Z
Z
zlib library: zlib library

Jump to:   -   -. -  
A   diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf index 6311bde0047..52c01dc18b4 100644 Binary files a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf and b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf differ diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 3149ec75a91..7d2c557a111 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -19,7 +19,7 @@ permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation --> - + Web2c: A TeX implementation @@ -37,23 +37,14 @@ except that this permission notice may be stated in a translation --> .)

@@ -3056,31 +2965,31 @@ D.E. Knuth.) ‘-help’ and ‘-version’ (see Common options):

-change=chfile[.ch]
-
- +
+

Apply the change file chfile as with Tangle and Weave (see WEB).

-style=mftfile[.mft]
-
- - +
+ +

Read mftfile before anything else; a MFT style file typically contains only MFT directives as described above. The default style file is named plain.mft, which defines this properly for programs using plain Metafont. The MFT files is searched along the -MFTINPUTS path; see Supported file formats in Kpathsea. +MFTINPUTS path; see Supported file formats in Kpathsea.

- - - + + +

Other examples of MFT style files are cmbase.mft, which defines formatting rules for the macros defined in cm.base, and e.mft, which was used in the production of Knuth’s Volume E, Computer Modern Typefaces.

- +

Using an appropriate MFT style file, it is also possible to configure MFT for typesetting MetaPost sources. However, MFT does not search the usual places for MetaPost input files. @@ -3093,17 +3002,15 @@ configure TeX to print these properly.


- -
+

Next: , Previous: , Up: Top   [Contents][Index]

- -

6 MetaPost: Creating technical illustrations

+

6 MetaPost: Creating technical illustrations

- - - + + +

MetaPost is a picture-drawing language similar to Metafont (see Metafont), but instead of outputting bitmaps in a “font”, it outputs PostScript commands. It’s primarily intended for creating @@ -3114,28 +3021,26 @@ a natural way, using any typesetter (TeX and Troff are both supported) and a number of other subsidiary programs, described below.

- - -
- -
+ - -

6.1 mpost invocation

+

6.1 mpost invocation

- - + + - +

MetaPost (installed as mpost) reads a series of pictures specified in the MetaPost programming language, and outputs corresponding PostScript code. This section merely describes the @@ -3151,7 +3056,7 @@ also: related information). - +

Also, a standard MetaPost package for drawing graphs is documented in AT&T technical report CSTR-164, available as the file mpgraph.ps, generally stored alongside mpman.ps. @@ -3166,20 +3071,20 @@ mpost [option]… \first-line mpost [option]… &mem args

- - + +

MetaPost searches the usual places for the main input file mpname -(see Supported file formats in Kpathsea), extending +(see Supported file formats in Kpathsea), extending mpname with .mp if necessary. To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program.

- - - - - - + + + + + +

MetaPost writes its PostScript output to a series of files basempname.nnn (or perhaps basempname.ps, very occasionally @@ -3194,10 +3099,10 @@ with any other PostScript figures. For example, with this TeX command:

\special{psfile="filename"}
 
-

or by using epsf.tex (see EPSF macros in Dvips). +

or by using epsf.tex (see EPSF macros in Dvips).

- - + +

The MetaPost construct

btex … tex-input … etex
@@ -3222,21 +3127,21 @@ package (unfortunately absent from many Troff implementations), or an
 equivalent such as the ‘-m pspic’ macros from GNU groff described
 in grops(1).
 

- - - + + +

Naturally, you must use fonts that are supported by the typesetter; specifically, you’ll probably want to use standard PostScript fonts with Troff. And only the TeX system understands Computer Modern or other Metafont fonts; you can also use PostScript fonts with TeX, of course.

- - - + + +

MetaPost-generated PostScript figures which do use Computer Modern fonts for labels cannot be directly previewed or printed. Instead, you must include them in a TeX document and run the resulting DVI file through -Dvips to arrange for the downloading of the required fonts (see Fonts +Dvips to arrange for the downloading of the required fonts (see Fonts in figures in Dvips). To help with this, the MetaPost distribution provides a small TeX file mproof.tex which is typically called as: @@ -3245,16 +3150,16 @@ typically called as:

The resulting file mproof.ps can then be printed or previewed.

- - + +

To generate EPSF files, set the internal MetaPost variable prologues positive. To make the output files self-contained, use only standard PostScript fonts. MetaPost reads the same psfonts.map file as Dvips, to determine PostScript fonts that -need to be downloaded (see psfonts.map in Dvips). +need to be downloaded (see psfonts.map in Dvips).

- - + +

It is posible for pdfTeX to read MetaPost output directly; this is in contrast to general EPSF files, which have to be converted for use with PDF output. The easiest way is to name the MetaPost output files @@ -3262,7 +3167,7 @@ with the .mps extension. Then the LaTeX \includegraphics command, for example, will be able to read them, even when outputting PDF.

- +

MetaPost can write output files, via the write primitive; this opens a security hole. See tex invocation.

@@ -3288,14 +3193,14 @@ See Common options.
-T
-troff
-
- - +
+ +

Set the prologues internal variable to 1.

-tex=texprogram
-
+

When this option is given, the program texprogram is used to typeset the labels.

@@ -3304,16 +3209,14 @@ typeset the labels.
- -
+ - -

6.2 Initial MetaPost

+

6.2 Initial MetaPost

- - + +

As of MetaPost 1.504 (TeX Live 2011), MetaPost no longer dumps .mem files (see Memory dumps) and does not distinguish @@ -3323,10 +3226,10 @@ virgin and initial forms (see Initial and virgin

For a list of options and other information, see mpost invocation.

- - - - + + + +

MetaPost provides a format with all the features of plain Metafont, called mfplain. You can use that in the same way; just run mfplain instead of mpost. This lets you directly @@ -3336,17 +3239,15 @@ Metafont in proof mode and GFtoDVI (see gftodvi in


-
-
+

Previous: , Up: MetaPost   [Contents][Index]

- -

6.3 DVItoMP: DVI to MPX conversion

+

6.3 DVItoMP: DVI to MPX conversion

- - - + + +

DVItoMP converts DVI files into low-level MetaPost commands in a so-called MPX file. Synopsis: @@ -3359,7 +3260,7 @@ so-called MPX file. Synopsis: dvifile extended with .mpx, e.g., ‘dvitomp /wherever/foo.dvi’ creates ./foo.mpx.

- +

DVItoMP supports Dvips-style color specials, such as ‘color push name’ and ‘color pop’, outputting them as withcolor MetaPost commands. @@ -3368,42 +3269,38 @@ MetaPost commands.


- -
+

Next: , Previous: , Up: Top   [Contents][Index]

- -

7 BibTeX: Bibliographies

+

7 BibTeX: Bibliographies

- - + +

BibTeX automates much of the job of typesetting bibliographies, and makes bibliography entries reusable in many different contexts.

- -
- -
+ - -

7.1 BibTeX invocation

+

7.1 BibTeX invocation

- + - - - + + +

BibTeX creates a printable bibliography (.bbl) file from references in a .aux file, generally written by TeX or LaTeX. The .bbl file is then incorporated on a subsequent @@ -3415,23 +3312,23 @@ of the .bbl file. Synopsis:

bibtex [option]… auxfile[.aux]
 
- - + +

The output goes to the basename of auxfile extended with .bbl; for example, ‘bibtex /wherever/foo.aux’ creates ./foo.bbl. BibTeX also writes a log file to the basename of auxfile extended with ‘.blg’.

- - - - - + + + + +

The names of the .bib and .bst files are specified in the .aux file as well, via the \bibliography and \bibliographystyle (La)TeX macros. BibTeX searches for .bib files using the BIBINPUTS and TEXBIB paths, -and for .bst files using BSTINPUTS (see Supported file +and for .bst files using BSTINPUTS (see Supported file formats in Kpathsea). It does no path searching for .aux files.

@@ -3439,16 +3336,16 @@ formats in Kpathsea). It does no path searching for ‘-help’ and ‘-version’ (see Common options):

-terse
-
- - +
+ +

Suppress the program banner and progress reports normally output.

-min-crossrefs=n
-
- - +
+ +

If at least n (2 by default) bibliography entries refer to another entry e via their crossref field, include e in the .bbl file, even if it was not explicitly referenced in the .aux @@ -3468,31 +3365,31 @@ for e to the .aux, and nothing will remove it.

See also:

btxdoc.tex
-
+

Basic LaTeXable documentation for general BibTeX users.

btxhak.tex
-
- +
+

LaTeXable documentation for style designers.

btxdoc.bib
-
+

BibTeX database file for the two above documents.

xampl.bib
-
+

Example database file with all the standard entry types.

ftp://ftp.math.utah.edu/pub/tex/bib/
-
- - - +
+ + +

A very large .bib and .bst collection, including references for all the standard TeX books and a complete bibliography for TUGboat. @@ -3501,46 +3398,44 @@ for TUGboat.


- -
+

Previous: , Up: BibTeX   [Contents][Index]

- -

7.2 Basic BibTeX style files

+

7.2 Basic BibTeX style files

- - + +

Here are descriptions of the four standard and four semi-standard basic BibTeX styles. CTAN:/biblio/bibtex contains these and -many more (for CTAN info, see unixtex.ftp in Kpathsea). +many more (for CTAN info, see unixtex.ftp in Kpathsea).

plain
-
+

Sorts entries alphabetically, with numeric labels. Generally formatted according to van Leunen’s A Handbook for Scholars. The other style files listed here are based on plain.

abbrv
-
+

First names, month names, and journal names are abbreviated.

acm
-
+

Names are printed in small caps.

alpha
-
+

Alphanumeric labels, e.g., ‘Knu66’.

apalike
-
+

No labels at all; instead, the year appears in parentheses after the author. Use this in conjunction with apalike.tex (plain TeX) or apalike.sty (LaTeX), which also changes the citations in the @@ -3548,19 +3443,19 @@ text to be ‘(author, year)’.

ieeetr
-
+

Numeric labels, entries in citation order, IEEE abbreviations, article titles in quotes.

siam
-
+

Numeric labels, alphabetic order, Math. Reviews abbreviations, names in small caps.

unsrt
-
+

Lists entries in citation order, i.e., unsorted.

@@ -3572,16 +3467,14 @@ abbreviations, names in small caps.
- -
+

Next: , Previous: , Up: Top   [Contents][Index]

- -

8 WEB: Literate programming

+

8 WEB: Literate programming

- - + +

WEB languages allow you to write a single source file that can produce both a compilable program and a well-formatted document @@ -3590,13 +3483,13 @@ Writing in this kind of dual-purpose language is called literate programming. (The Usenet newsgroup comp.programming.literate is devoted to this subject.)

- - - - - - - + + + + + + +

WEB-like languages have been implemented with many pairs of base languages: Cweb provides C and Troff (see References); CWEB provides C and TeX (CTAN:/web/c_cpp/cweb); Spiderweb provides C, @@ -3611,27 +3504,25 @@ which is included in the ftp://ftp.tu (and available in many other places, of course).

- - -
-
-
+

Next: , Up: WEB   [Contents][Index]

- -

8.1 Tangle: Translate WEB to Pascal

+

8.1 Tangle: Translate WEB to Pascal

- - - + + +

Tangle creates a compilable Pascal program from a WEB source file (see WEB). Synopsis: @@ -3640,14 +3531,14 @@ Next: ,

tangle [option]… webfile[.web] [changefile[.ch]]
 
- +

The Pascal output is written to the basename of webfile extended with ‘.p’; for example, ‘tangle /wherever/foo.web’ creates ./foo.p. Tangle applies changefile to webfile before writing the output; by default, there is no change file.

- - + +

If the program makes use of the WEB string facility, Tangle writes the string pool to the basename of webfile extended with ‘.pool’.

@@ -3660,8 +3551,8 @@ semicolons when this can be done conveniently.

-length=number
-
- +
+

The number of characters that are considered significant in an identifier. Whether underline characters are counted depends on the ‘-underline’ option. The default value is 32, the original tangle @@ -3671,10 +3562,10 @@ used 7, but this proved too restrictive for use by Web2c.

-lowercase
-mixedcase
-uppercase
-
- - - +
+ + +

These options specify the case of identifiers in the output of tangle. If ‘-uppercase’ (‘-lowercase’) is specified, tangle will convert all identfiers to uppercase (lowercase). The default is @@ -3682,17 +3573,17 @@ convert all identfiers to uppercase (lowercase). The default is

-underline
-
- +
+

When this option is given, tangle does not strip underline characters from identifiers.

-loose
-strict
-
- - +
+ +

These options specify how strict tangle must be when checking identifiers for equality. The default is ‘-loose’, which means that tangle will follow the rules set by the case-smashing and underline @@ -3704,18 +3595,16 @@ whether they collide.


- -
+ - -

8.2 Weave: Translate WEB to TeX

+

8.2 Weave: Translate WEB to TeX

- - - - + + + +

Weave creates a TeX document from a WEB source file (see WEB), assuming various macros defined in webmac.tex. It takes care of @@ -3727,7 +3616,7 @@ cross-reference information. Synopsis:

weave [option]… webfile[.web] [changefile[.ch]]
 
- +

The output is to the basename of webfile extended with ‘.tex’; for example, ‘weave /wherever/foo.web’ creates ./foo.tex. Weave applies changefile to webfile @@ -3737,10 +3626,10 @@ before writing the output; by default, there is no change file. ‘-verbose’, ‘-help’ and ‘-version’ (see Common options):

-x
-
- - - +
+ + +

Omit the cross-reference information: the index, the list of WEB module names, and the table of contents (an empty CONTENTS.tex file will still be written when the Weave output file is processed by TeX using @@ -3755,18 +3644,16 @@ first change in the change file).


- -
+

Previous: , Up: WEB   [Contents][Index]

- -

8.3 Pooltype: Display WEB pool files

+

8.3 Pooltype: Display WEB pool files

- - - - + + + +

Pooltype shows the so-called string number of each string in a WEB pool file (see WEB), as output by Tangle (see tangle invocation), including the first 256 strings corresponding to the @@ -3794,8 +3681,8 @@ output. (23617 characters in all.)

- - + +

In Metafont and MetaPost, the first 256 characters are actually represented as single bytes (i.e., themselves), not in the ‘^^’ notation. Consider Pooltype as showing the results after conversion for @@ -3803,26 +3690,24 @@ output.


- -
+

Next: , Previous: , Up: Top   [Contents][Index]

- -

9 DVI utilities

+

9 DVI utilities

- +

TeX outputs a file in DVI (DeVice Independent) format as a compact representation of the original document. DVI files can be translated to meet the requirements of a real physical device, such as -PostScript printers (see Introduction in Dvips), PCL +PostScript printers (see Introduction in Dvips), PCL printers (see dvilj(1)), and X displays (see xdvi(1)). In fact, DVI translators are available for virtually all common devices: see -CTAN:/dviware (for CTAN info, see unixtex.ftp in Kpathsea). +CTAN:/dviware (for CTAN info, see unixtex.ftp in Kpathsea).

- - + +

For the precise definition of the DVI file format, see (for example) the source file web2c/dvitype.web.

@@ -3830,26 +3715,24 @@ source file web2c/dvitype.web. drivers; they perform generic utility functions.

- -
- -
+ - -

9.1 DVIcopy: Canonicalize virtual font references

+

9.1 DVIcopy: Canonicalize virtual font references

- - + +

DVIcopy reads a DVI file, expands any references to virtual fonts -(see Virtual fonts in Dvips) to base fonts, and writes the +(see Virtual fonts in Dvips) to base fonts, and writes the resulting DVI file. Thus you can use virtual fonts even if your DVI processor does not support them, by passing the documents through DVIcopy first. Synopsis: @@ -3865,24 +3748,24 @@ standard output if outdvi is not specified. ‘-help’ and ‘-version’ (see Common options):

-magnification=integer
-
- - +
+ +

Override existing magnification in indvi with integer; 1000 specifies no magnification. This is equivalent to setting TeX’s \mag parameter.

-max-pages=n
-
+

Process n pages; default is one million.

-page-start=page-spec
-
- - - +
+ + +

Start at the first page matching page-spec, which is one or more (signed) integers separated by periods, corresponding to TeX’s \count0…9 parameters at \shipout time; ‘*’ @@ -3892,20 +3775,18 @@ matches anything. Examples: ‘3’, ‘1.*.-4 - -

+ - -

9.2 DVItype: Plain text transliteration of DVI files

+

9.2 DVItype: Plain text transliteration of DVI files

- - - - - - + + + + + +

DVItype translates a DeVice Independent (DVI) file (as output by TeX, for example) to a plain text file that humans can read. It also serves @@ -3918,7 +3799,7 @@ correct. Synopsis:

DVItype does not read any bitmap files, but it does read TFM files for fonts referenced in dvifile. The usual places are searched -(see Supported file formats in Kpathsea). To see all the +(see Supported file formats in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program.

@@ -3928,27 +3809,27 @@ relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-help’ and ‘-version’ (see Common options):

-dpi=real
-
+

Do pixel movement calculations at real pixels per inch; default 300.0.

-magnification=integer
-
- - +
+ +

Override existing magnification in indvi with integer; 1000 specifies no magnification. This is equivalent to setting TeX’s \mag parameter.

-max-pages=n
-
+

Process n pages; default is one million.

-output-level=n
-
+

Verbosity level of output, from 0 to 4 (default 4):

  • 0: Global document information only. @@ -3961,10 +3842,10 @@ in the file, reading the DVI postamble first.
-page-start=page-spec
-
- - - +
+ + +

Start at the first page matching page-spec, which is one or more (signed) integers separated by periods, corresponding to TeX’s \count0…9 parameters at \shipout time; ‘*’ @@ -3972,10 +3853,10 @@ matches anything. Examples: ‘1’, ‘5.*.-9

-show-opcodes
-
- - - +
+ + +

Show numeric opcode values (in decimal) for DVI commands, in braces after the command name. This can help in debugging DVI utilities. We use decimal because in the DVI format documentation (in @@ -3984,21 +3865,19 @@ use decimal because in the DVI format documentation (in

-
- -
+ - -

9.2.1 DVItype output example

+

9.2.1 DVItype output example

- +

As an example of the output from DVItype (see section above), here is its (abridged) translation of the story.dvi resulting from running the example in The TeXbook, with @@ -4079,66 +3958,62 @@ STORY]’ and the ‘[ 1]’.


- -
+

Next: , Previous: , Up: Top   [Contents][Index]

- -

10 Font utilities

+

10 Font utilities

- +

The Web2c programs described here convert between various TeX-related font formats; the first section below briefly describes the formats. GFtoPK is the only one that is routinely used, as Metafont outputs GF format, but it’s most efficient for device drivers to use PK.

- - - - + + + +

The precise definitions of the PK, GF, TFM, PL, VF, and VPL formats mentioned below are in the source files that read them; pktype.web, gftype.web, tftopl.web, etc.

- - - - - - - - - -
- -
+ - -

10.1 Font file formats

+

10.1 Font file formats

- - + + -

(For another perspective on this, see Font concepts in Dvips). +

(For another perspective on this, see Font concepts in Dvips).

Font files come in several varieties, with suffixes like:

@@ -4146,7 +4021,7 @@ Next:

Each represents a file format.

- +

A TFM (TeX font metric) file is a compact binary file that contains information about each character in a font, about combinations of characters within that font, and about the font as a whole. The font @@ -4156,10 +4031,10 @@ described below, TFM font files contain no information about the shapes of characters. They describe rectangular areas and combinations thereof, but not what will eventually be printed in those areas.

- - - - + + + +

Since TeX does scaling calculations, one TFM file serves for all magnifications of a given typeface. On the other hand, the best printed results are obtained when magnified (or reduced fonts) are not produced @@ -4168,7 +4043,7 @@ with each size a separate design (as done with Computer Modern and the EC fonts, for example); then a separate TFM file is needed for each size.

- +

At any rate, TeX produces a DVI (DeVice Independent) file from your source document. In order to print DVI files on real devices, you need font files defining digitized character shapes and other data. Then @@ -4180,9 +4055,9 @@ font was produced, and the ‘pk’ or ‘gf.pfa’ or ‘.pfb’.

- - - + + +

Fonts in pk (packed) format are in the tightly packed raster format that is pretty much the standard today. They take up less space than fonts in the gf (generic font) format that Metafont generates, and far less @@ -4190,7 +4065,7 @@ space than fonts in pxl format. Fonts in pxl format take up gross amounts of disk space and permit only 128 characters. They are obsolete.

- +

Font files with the ‘.pl’ (property list) suffix are the plain text (human-readable) analog of the binary ‘.tfm’ files. The TFtoPL and PLtoTF programs convert between the two formats @@ -4201,33 +4076,31 @@ These are the files used by Metafont to generate rastered fonts for specific typefaces at specific magnifications for the specific resolution and type of mapping used by your device.

- - + +

The suffix ‘.vf’ identifies “virtual font” files, for which ‘.vpl’ is the human-readable analog. See See vftovp invocation, and vptovf invocation. For further discussion of virtual fonts, see CTAN:/doc/virtual-fonts.knuth, -CTAN:/help/virtualfonts.txt, and Virtual fonts in Dvips. +CTAN:/help/virtualfonts.txt, and Virtual fonts in Dvips.

- - + +

(This section is based on documentation in the original Unix TeX distribution by Pierre MacKay and Elizabeth Tachikawa.)


- -
+ - -

10.2 GFtoPK: Generic to packed font conversion

+

10.2 GFtoPK: Generic to packed font conversion

- - - - + + + +

GFtoPK converts a generic font (GF) file output by, for example, Metafont (see mf invocation) to a packed font (PK) file. PK files @@ -4240,7 +4113,7 @@ Synopsis:

gftopk [option]… gfname.dpi[gf] [pkfile]
 
-

The font gfname is searched for in the usual places (see Glyph +

The font gfname is searched for in the usual places (see Glyph lookup in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program. @@ -4258,18 +4131,16 @@ of ‘gfname.dpipk’, e.g., ‘<


- -
+ - -

10.3 PKtoGF: Packed to generic font conversion

+

10.3 PKtoGF: Packed to generic font conversion

- - - - + + + +

PKtoGF converts a packed font (PK) file to a generic font (GF) file. Since PK format is much more compact than GF format, the most likely @@ -4281,7 +4152,7 @@ programs do not support PK format. Synopsis:

pktogf [option]… pkname.dpi[pk] [gffile]
 
-

The font pkname is searched for in the usual places (see Glyph +

The font pkname is searched for in the usual places (see Glyph lookup in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program. @@ -4299,20 +4170,18 @@ of ‘pkname.dpigf’, e.g., ‘<


- -
+ - -

10.4 PKtype: Plain text transliteration of packed fonts

+

10.4 PKtype: Plain text transliteration of packed fonts

- - - - - - + + + + + +

PKtype translates a packed font (PK) bitmap file (as output by GFtoPK, for example) to a plain text file that humans can read. It also serves @@ -4323,7 +4192,7 @@ correct. Synopsis:

pktype pkname.dpi[pk]
 
-

The font pkname is searched for in the usual places (see Glyph +

The font pkname is searched for in the usual places (see Glyph lookup in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program. @@ -4341,8 +4210,8 @@ letter ‘K’ in ‘cmr10’, as rendered at 600dp ‘ljfour’ from modes.mf (available from ftp://ftp.tug.org/tex/modes.mf).

-
-
955:  Flag byte = 184  Character = 75  Packet length = 174
+
+
955:  Flag byte = 184  Character = 75  Packet length = 174
   Dynamic packing variable = 11
   TFM width = 815562  dx = 4259840 
   Height = 57  Width = 57  X-offset = -3  Y-offset = 56
@@ -4355,62 +4224,62 @@ letter ‘K’ in ‘cmr10’, as rendered at 600dp
 

955
-
+

The byte position in the file where this character starts.

Flag byte
Dynamic packing variable
-
- +
+

Related to the packing for this character; see the source code.

Character
-
+

The character code, in decimal.

Packet length
-
+

The total length of this character definition, in bytes.

TFM width
-
- - +
+ +

The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size.

dx
-
- - - +
+ + +

The device-dependent width, in scaled pixels, i.e., units of horizontal pixels times 2^16.

Height
Width
-
- - - +
+ + +

The bitmap height and width, in pixels.

X-offset
Y-offset
-
- - - - - - +
+ + + + + +

Horizontal and vertical offset from the upper left pixel to the reference (origin) pixel for this character, in pixels (right and down are positive). The reference pixel is the pixel that occupies the @@ -4421,8 +4290,8 @@ escapement minus the bitmap width plus the x-offset.

[2]23(16)…
-
- +
+

Finally, run lengths of black pixels alternate with parenthesized run lengths of white pixels, and brackets indicate a repeated row.

@@ -4430,20 +4299,18 @@ lengths of white pixels, and brackets indicate a repeated row.
- -
+ - -

10.5 GFtype: Plain text transliteration of generic fonts

+

10.5 GFtype: Plain text transliteration of generic fonts

- - - - - - + + + + + +

GFtype translates a generic font (GF) bitmap file (as output by Metafont, for example) to a plain text file that humans can read. It @@ -4454,7 +4321,7 @@ it’s correct. Synopsis:

gftype [option]… gfname.dpi[gf]
 
-

The font gfname is searched for in the usual places (see Glyph +

The font gfname is searched for in the usual places (see Glyph lookup in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program. @@ -4468,12 +4335,12 @@ not an extension; no ‘.’ precedes it: for instance, -help’ and ‘-version’ (see Common options):

-images
-
+

Show the characters’ bitmaps using asterisks and spaces.

-mnemonics
-
+

Translate all commands in the GF file.

@@ -4527,19 +4394,19 @@ main definition:
2033
2043
-
+

The byte position in the file where each GF command starts.

beginning of char 75
-
+

The character code, in decimal.

3<=m<=60 0<=n<=56
-
- - +
+ +

The character’s bitmap lies between 3 and 60 (inclusive) horizontally, and between 0 and 56 (inclusive) vertically. (m is a column position and n is a row position.) Thus, 3 is the left side @@ -4548,18 +4415,18 @@ below) minus the maximum m.

(initially n=56) paint (0)24(12)20
-
+

The first row of pixels: 0 white pixels, 24 black pixels, 12 white pixels, etc.

newrow 0 (n=55) paint 24(12)20
-
+

The second row of pixels, with zero leading white pixels on the row.

eoc
-
+

The end of the main character definition.

@@ -4575,13 +4442,13 @@ pixels, etc.

dx
-
- - - - - - +
+ + + + + +

The device-dependent width, in scaled pixels, i.e., units of horizontal pixels times 2^16. The ‘(65)’ is simply the same number rounded. If the vertical escapement is nonzero, it would appear here as @@ -4589,9 +4456,9 @@ a ‘dy’ value.

width
-
- - +
+ +

The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size. The ‘64.57289’ is the same number converted to pixels. @@ -4605,22 +4472,20 @@ times the ratio of the true width to the font’s design size. The


- -
+ - -

10.6 TFtoPL: TeX font metric to property list conversion

+

10.6 TFtoPL: TeX font metric to property list conversion

- - - - - - + + + + + + -

TFtoPL translates a TeX font metric (TFM, see Metric +

TFtoPL translates a TeX font metric (TFM, see Metric files in Dvips) file (as output by Metafont, for example) to property list format (a list of parenthesized items describing the font) that humans can edit or read. This program is mostly used by @@ -4632,7 +4497,7 @@ Synopsis:

The font tfmname (extended with ‘.tfm’ if necessary) is -searched for in the usual places (see Supported file formats in Kpathsea). To see all the relevant paths, set the +searched for in the usual places (see Supported file formats in Kpathsea). To see all the relevant paths, set the environment variable KPATHSEA_DEBUG to ‘-1’ before running the program.

@@ -4645,7 +4510,7 @@ program TFtoPL (see the next section). ‘-verbose’, ‘-help’ and ‘-version’ (see Common options):

-charcode-format=type
-
+

Output character codes in the PL file according to type: either ‘octal’ or ‘ascii’. Default is ‘ascii’ for letters and digits, octal for all other characters. Exception: if the font’s coding @@ -4664,7 +4529,7 @@ confusing.

- +

As an example of the output, here is the (abridged) property list translation of cmr10.tfm:

@@ -4720,25 +4585,25 @@ translation of cmr10.tfm: properties, nested where necessary.