TUGb oat, Volume 18 1997, No. 2 81

T X Live CD-ROM

E

The T X Live Guide, version 2 1. "-T X, which adds a small but powerful set of

E

E

new primitives, and the T X--X T extensions

E

E

Sebastian Rahtz and Michel Go ossens

for left to right typ esetting; in default mo de,

Contents "-T X is 100 compatible with ordinary T X.

E E

See share/texmf/doc/html/e-tex/etex.htm

1 Intro duction 81

on the CD-ROM for details.

1.1 History and acknowledgements ...... 81

2. p dfT X, which can optionally write Acrobat

1.2 Future versions ...... 82

E

PDF format instead of dvi; there is no formal

2 Structure and contents of the CD-ROM 82

do cumentation for this yet, but the le share/

2.1 The TDS tree ...... 82

texmf/tex/pdftex/example.tex shows howit

A

is used. The L T X hyperref package has an

3 Installation and use under Unix 83

E

3.1 Running T X Live from the CD-ROM . . . . . 83

option `p dftex' which turns on all the program

E

3.2 Installing T X Live to a hard disk ...... 84

E

features.

3.3 Installing individual packages from T X Live

E

While "-T X is stable, p dfT X is under continual

to a hard disk ...... 84

E E

3.4 texconfig ...... 86

development; the version on the CD-ROM may not

3.5 Building on a new platform ...... 86

b e stable. Most platforms haveversion 0.11 of May

7th, but some have a slightly earlier one of May 5th,

4 A user's guide to the Web2c system 86

whichmayhave problems including PNG les.

4.1 Kpathsea path searching ...... 87

The entire GUTenb erg distribution for Win-

4.2 Filename databases ...... 89

4.3 Runtime options ...... 93

dows is included on the CD-ROM, ready to install,

as are the following complete packages:

5 Other packages on the CD-ROM 93

 OzT X 3.0 for Macintosh

5.1 OzT X ...... 93

E

E

5.2 CMacTeX ...... 94

 CMacTeX 2.6 for Macintosh

5.3 MiKTeX ...... 94

 Macintosh utilities Alpha, Excalibur, etc.

5.4 emTeX ...... 94

 MikTeX for Windows 95

A The texmf.cnf le 95

 emTeX for MSDOS and OS/2

B Catalogue of Packages 101

 T X shells for Windows and DOS Winedt, e4t,

E

TeXtelmExtel, emTeXgi



These are provided unchanged from CTAN, and have

not b een integrated in anyway with the rest of the

1 Intro duction

CD-ROM.

This do cumentation describ es the main features of

1.1 History and acknowledgements

A

the T X Live CD-ROM,aT X/L T X distribution

E E E

This CD-ROM distribution is a joint eort by the for Unix, Windows32, Amiga and NeXT systems,

A

T X Users Group, the UK T X Users Group, and that includes T X, L T X2 , METAFONT , Meta-

"

E E E E

the FrenchT X Users GUTenb erg, with the sup- Post, many other programs such as Makeindex,

E

p ort of the Dutch, German and Czech/Slovak user dvips, xdvi and BibT X; and a very complete set

E

groups. Discussion b egan in late 1993 when the of macros, fonts and do cumentation conforming to

Dutch T X Users Group was starting work on its the T X Directory Standard which can b e used with

E E

4AllT X CD-ROM for MSDOS users, and it was nearly every T X setup.

E E

hop ed at that time to issue a single, rational, CD- This T X package uses the Web2c implementa-

E

ROM for all systems. This was far to o ambitious tion of the programs, which tries to make T Xing

E

a target, but it did spawn not only the very suc- as easy as p ossible, and takes full advantage of the

cessful 4AllT X CD-ROM, but also the TUG Tech- ecient and highly customizable Kpathsea library

E

nical Council working group on a T X Directory from Karl Berry. It can b e run either directly from

E

Structure, which sp ecied how to create consistent the CD-ROM, or installed on a hard disk.

and manageable collections of T X supp ort les. The T X Live runnable systems contain two

E E

The nal draft of the TDS was published in the exp erimental extensions to normal T X: E

82 TUGb oat, Volume 18 1997, No. 2

Decemb er 1995 issue of TUGb oat , and it was clear more help material, more utilities, more installation

from an early stage that one desirable pro duct would programs, and of course an ever-improved and

be a mo del structure on CD-ROM. The CD-ROM checked tree of macros and fonts. This work is

you nowhaveisavery direct result of the working all done by hard-pressed volunteers in their limited

group's delib erations. It was also clear that the spare time, and a great deal remains to be done.

success of the 4AllT X CD-ROM meant that Unix If you can help, don't hesitate to put your name

E

users would b enet from a similarly easy system, forward!

and this is the other main strand of T X Live. Corrections, suggestions and additions for fu-

E

We underto ok to make a new Unix-based TDS ture revisions should b e sent to:

CD-ROM in the autumn of 1995, and quickly iden-

Sebastian Rahtz

tied Thomas Esser's teT X as the ideal setup, as

E

7 Strateld Road

it already had multi-platform supp ort and was built

Oxford OX2 7BG

with p ortability across le systems in mind. Thomas

United Kingdom

agreed to help, and work b egan seriously at the

mailto:[email protected]

start of 1996. The rst edition was released in May

Up dates, notes, and suggestions will be made

1996. At the start of 1997, Karl Berry completed

available on CTAN in info/texlive. A WWW

a ma jor new release of his Web2c package, which

page for information and ordering details is at http:

included nearly all the features which Thomas Esser

//www.tug.org/tex-live.html.

had added in teT X, and we decided to base the 2nd

E

edition of the CD-ROM on the standard Web2c, with

2 Structure and contents of the CD-ROM

the addition of teT X's texconfig script.

E

The CD-ROM top level directories are:

We are particularly grateful to: Karl Berry for

bin The T X family programs, arranged in separate

E

extra advice, encouragement, and of course for

platform directories;

providing the Web2c distribution; Thomas Esser,

info Do cumentation in GNU `info' format for the

without whose marvellous teT X package this CD-

E

T X system;

E

ROM would certainly not exist, and whose continual

macintosh The OzT X and CMacTeX packages

E

help makes it a b etter pro duct; and Ulrik Vieth,

ready to install, plus some other utilities;

for checking many assumptions at the start, and

man Do cumentation in Unix man pages for the

providing a great deal of extra material for the

T X system;

E

do cumentation tree.

msdos DOS T X packages  emTeX, and three

E

Fabrice Popineau did the excellent p ort of

T X shells;

E

Web2c 7.0 to Windows 95/NT and provided much

supp ort The source of all programs, including the

help; Andreas Scherer contributed the Amiga com-

main Web2c T X and METAFONT distribution;

pilation; Gregor Ho eit contributed the TeXview

E

this directory also includes various bits of T X-

material for NextStep users, and the NextStep bi- E

related software which are not installed by

naries. At Florida State University Sup ercomputer

default, such as MusixT X supp ort programs,

Research Institute, Mimi Burbank arranged access

E

and a complete set of Ghostscript;

to a slew of dierent computers to compile T X on,

E

share The main supp ort tree of macros, fonts and

and acted as an essential guinea-pig whenever asked.

do cumentation;

Michel Go ossens provided access to computers at

wingut The GUTenb erg distribution for Windows;

CERN, and Robin Fairbairns stepp ed in to provide

this consists of compressed archives whichmust

an Alpha running Linux at Cambridge.

be unpacked and installed on a hard disk.

Some of this do cumentation is drawn from the

Please see the detailed instructions in French;

teT X guide by Thomas Esser and Dirk Hillbrecht;

E

win32 T X packages for Windows 95 and NT users

the catalogue of packages dep ends very much on

E

MikTeX, and the original package of the Win32

the ongoing work of Graham Williams mailto:

p ort of Web2c.

[email protected], who kindly

agreed to allowus to use it here. Mimi Burbank,

There are also two installation scripts for Unix

Robin Fairbairns and Ulrik Vieth worked hard to

systems, install-cd.sh and install-pkg.sh;we

improve this text.

discuss them on p. 83.

1.2 Future versions

2.1 The TDS tree

This CD-ROM is not a perfect product! We plan to

The T X Live share/texmf tree consists of various

E

re-issue it once a year, and would like to provide

`collections', each of which has a set of `packages', of

TUGb oat, Volume 18 1997, No. 2 83

which there are over 400 on the CD-ROM. Normal 3. You can install selected packages to work either

installation allows the user to copy all of a collection with your existing T X system or a T X Live

E

E

to a lo cal hard disk from the CD-ROM, but it is also system you installed earlier.

p ossible to install just one package of a collection.

Each of these metho ds is describ ed in more detail in

Each of the collections is divided into basic 1,

the following sections.

recommended 2 and other 3. The collections are:

Warning: This CD-ROM is in ISO 9660 High

ams The American Mathematical So ciety macro

Sierra format, with Ro ck Ridge extensions. In

packages and fonts

order to take full advantage of the CD-ROM on

bibtex BibT Xstyles and databases

E

a Unix system, your system needs to be able to

do c General guides and do cumentation in various

use the Ro ck Ridge extensions. Please consult

formats, including HTML and PDF

the do cumentation for your mount command to

dvips Supp ort for Rokicki's dvi to PostScript driver

see if it is p ossible. If you have several dierent

machines on a lo cal network, see if you can mount

fonts Font sources, metrics, PostScript and bitmap

the CD-ROM on one which does supp ort Ro ck

forms

Ridge, and use it from the others.

formats Eplain, RevT X, physxx, texsis, alatex,

E

Linux, FreeBSD, Sun, SGI and DEC Alpha

text1, lollip op, etc.

systems should b e able to use the CD-ROM with

generic Extra macros for use with any format

no problems. We would appreciate receiving

graphics Macro packages for graphics

detailed advice from other system users who also

succeed, for future versions of this do cumentation.

lang Supp ort for non-English languages

The discussion b elow ab out installation as-

A A

latex L T X, including ocial to ols and all L T X2

"

E E

sumes you have b een able to mount the CD-ROM

contributed packages

with full Ro ck Ridge compatibility.

metap ost Supp ort for MetaPost

3.1 Running T X Live from the CD-ROM

plain Macros for plain T X

E E

systems Binaries for Unix platforms

The organisation of Web2c means that you can

run programs simply by adding the appropriate

texlive Basic material for the distribution

directory under bin on the CD-ROM to your PATH,

The app endix starting on p. 101 lists all the packages

and the supp ort les will all b e found with no further

in alphab etical order with the collection they are

ado. The following table shows the list of available

found in, and a brief description. Thus all packages

directories and the systems they apply to.

in collection latex1 are what one must have to get

A

started with L T X, packages in latex2 are recom-

E

alpha-linux DEC Alpha Linux

mended for most users, and latex3 contains op-

alpha-osf3.2 DEC Alpha OS 3.2

tional packages. The directory share/texmf/lists

amiweb2c Amiga

contains lists of all les in each package used by the

hppa11-hpux9.05 HP9000 HPUX 9.05

installation package.

hppa11-hpux10.20 HP9000 HPUX 10.20

i386-linux Intel PC with Linux ELF

3 Installation and use under Unix

i586-freebsd2.2 Intel PC with Free BSD

You can use the T X Live CD-ROM in three ways:

E

i686-linux Intel Pentium Pro with Linux

1. You can mount the CD-ROM on your le sys-

mab-nextstep3 NextStep 3

tem, adjust your PATH, and run everything o

mips-irix4.0.5 SGI IRIX 4.0.5

the CD-ROM; this takes very little disk space,

mips-irix5.3 SGI IRIX 5.3

and gives you immediate access to everything

mips-irix6.3 SGI IRIX 6.3

on the CD-ROM; although the p erformance will

mips-ultrix4.4 DECstation Ultrix 4.4

not b e optimal, it is p erfectly acceptable on, for

rs6000-aix3.2.5 IBM RS 6000 AIX 3.2.5

instance, PCs running Linux;

rs6000-aix4.1.1 IBM RS 6000 AIX 4.1.1

2. You can install all or part of the system to sparc-sunos4.1.3 Sun Sparc Sunos 4.1.3

your lo cal hard disk; this is the b est metho d for sparc-solaris2.5 Sun Sparc Solaris 2.5

many p eople, if they have enough disk space to sparc-solaris2.4 Sun Sparc Solaris 2.4

spare a minimum of ab out 10 megabytes, or sparc-linux Sun Sparc Linux

100 megabytes for a recommended go o d-sized win32 Windows 95 or NT system;

84 TUGb oat, Volume 18 1997, No. 2

You may worry that when you subsequently default installation directory is /usr/local; note

make fonts or change conguration, things will that the disk space required for the current instal-

go wrong b ecause you cannot change les on the lation conguration is also displayed. If you make

CD-ROM. However, you can maintain a parallel, a suggested setup, you need ab out 172 megabytes

writeable, T X tree on your hard disk; this is of disk free; however, the basic setup will only take

E

searched b efore the main tree on the CD-ROM. The ab out 10 megabytes, and you can enhance it with

default lo cation is /usr/local/texmf, but you can selected packages as you need them.

override this by setting the TEXMFLOCAL environment Under the directory you cho ose for installation,

variable. the installation script will put the binaries in a

Thus sh or bash users on an Intel PC running sub directory of bin, and the supp ort tree in share/

Linux who mount the T X Live CD-ROM on texmf.

E

/cdrom by issuing the command: The options item lets you decide whether to

make new fonts be created in another lo cation if

mount -t iso9660 /dev/cdrom /cdrom

you want the main package mounted read-only for

might add the following to their .profile script:

most users, and whether to make symb olic links

PATH=/cdrom/bin/i386-linux:$PATH

for the man and GNU info pages in the `standard'

export PATH

lo cations.

If in doubt, ask your lo cal system supp ort guru to

When you cho ose for collections, you will

help you work out how to mountyour CD-ROM or

see the displayof available collections, the level of

which directory to use for your system.

installation selected, and the disk space required

Appropriate supp ort les will be installed on

Figure 2. You can set alternative levels of instal-

your hard disk the rst time you need them. It is a

lation for each collection, ranging from none to al l.

go o d idea to immediately run the texconfig script

You can either set this for all collections at once,

to initialize things, and check it all works.

or cho ose a particular collection and set its level

Figure 3.

3.2 Installing T X Livetoa hard disk

E

When you are nished, return to the main

All of the necessary steps to install all or part of

screen, and ask the installation to start. It will

the distribution on your hard disk are achieved by

take each of the collections and systems that you

mounting the CD-ROM, changing to the top-level

requested, consult the list of les on the CD-ROM,

directory, and typing:

and build a master list of les to transfer. These

sh install-cd.sh

will then be copied to your hard disk, and the

initialization sequence run creating format les

On some Unix systems, you may need to use sh5

etc.. When this has nished, all you need do is

or bsh. This works by accessing lists of collections

add the correct sub directory of bin in the T X

E

and packages from the CD-ROM, and trying to guess

installation to your path, and start using T X.

E

what sort of computer system you are on; it should

If you want to move the binaries up one level,

start by displaying the following:

e.g. from /usr/local/bin/alpha-osf3.2 to /usr/

Initializing collections... Done.

local/bin,you need to edit share/texmf/web2c/

Counting selected collections... Done.

texmf.cnf and change the line

Calculating disk space requirements for

prefix = $SELFAUTOPARENT

collections...Done.

Initializing system packages... Done.

to

It will then show the main control screen Figure 1,

prefix = $SELFAUTODIR

which lets you change four things:

You can of course change the value of prefix to any

1. the typ e of system you are on, or want to install

directory you like, and move the supp ort directory

for;

there.

2. the collections you want to install, at basic,

3.3 Installing individual packages from

recommended or other level;

T X Live to a hard disk

3. the lo cation on your hard disk to put the les;

E

4. some runtime b ehaviour features.

You may want to use the T X Live CD-ROM to

E

either up date an existing setup, or add features You cho ose options by typing a letter or number

to an earlier installation from the CD-ROM. The and pressing return. In the example, a Linux ELF

main installation program is intended for the rst system has b een detected, the default of all collec-

time only, and subsequently you should use the tions to recommended level has b een chosen, and the

TUGb oat, Volume 18 1997, No. 2 85

======> TeX Live installation procedure <======

===> Note: Letters/digits in brackets indicate menu items <===

===> for commands or configurable options <===

Detected system: Intel PC with Linux ELF

collections: 21 out of 30, disk space required: 163955 kB

systems: 1 out of 20, disk space required: 7946 kB

total disk space required: 171901 kB

directories:

TEXDIR = /usr/local

options:

[ ] alternate directory for automatically generated fonts

[ ] create symlinks in standard directories

Other commands:

start installation, help, quit

Enter command:

Figure 1: Installation screen, example 1

Current collections setup: total size : 171901 kB

======

name selection size

<1> ams [recommended] 6359 kB

<2> bibtex [recommended] 6584 kB

<3> doc [recommended] 26531 kB

<4> dvips [recommended] 563 kB

<5> fonts [recommended] 21862 kB

<6> formats [recommended] 1003 kB

<7> generic [recommended] 501 kB

<8> graphics [recommended] 10373 kB

<9> lang [recommended] 3287 kB

metapost [recommended] 1280 kB

latex [recommended] 28333 kB

plain [recommended] 756 kB

texlive [recommended] 56523 kB

SUM: 163955 kB

======

global commands: select one / asic / rcommended / ll

for all collections

return to platform menu

quit

Enter command to modify current selection:

Figure 2: Installation screen, example 2

Collection: Fonts

======

Fonts, including metrics, virtual fonts and sources

======

no packages

basic packages [ 2007 kB]

basic + recommended packages [ 21862 kB]

all packages [ 34303 kB]

======

return to collection menu

quit

Enter command:

Figure 3: Installation screen, example 3

86 TUGb oat, Volume 18 1997, No. 2

install-pkg.sh script on the CD-ROM. Run this install-pkg.sh --package=pstricks \

by mounting the CD-ROM,changing to the mounted --archive=/tmp/pstricks.tar

directory, and typing

3.4 texconfig

sh install-pkg.sh options

After the installation program has copied all les to

The script supp orts nine options; the rst four

their nal lo cations, you can call a program called

let you set the individual package you want to

texconfig that allows you to congure the system

install, the whole collection i.e., ams2, the name

to t your lo cal needs. This can be called at any

of the mounted CD-ROM directory, and the name of

other time to change your setup, with a full-screen

the directory containing the list les normally these

which requires the dialog program or command-

latter two will b e set automatically:

line interface. It should b e used for all maintenance,

--package=name

likechanges of installed printers, or rebuilding of the

--collection=name

le database. Both mo des have help text to guide

--cddir=name

you through the facilities.

--listdir=name

What actually happ ens is controlled by four

3.5 Building on a new platform

more switches; the rst two allow you to exclude

If you have a platform for which we have not

do cumentation or source les from the installa-

provided binary sources, you will need to compile

tion; the third stops the default action of run-

T X and friends from scratch. This is not as hard

E

ning MakeTeXls-R on completion to rebuild the le

as it sounds. What you need is all in the directory

database, and the last do es nothing but list the les

support/texk-7.0 on the CD-ROM.

that would b e installed:

To compile T X, you should get gcc, ex and a

--nodoc

E

recentversion of GNU make. gcc-2.5.8, ex-2.4.7 and

--nosrc

GNU make-3.72.1 or newer should b e ne. You may

--nohash

be able to work with other C compilers and Make

--listonly

programs, but you will need a go o d understanding

Finally, you can sp ecify that instead of in-

of building Unix programs to sort out problems.

stalling the les, the script should makea tar archive

You should rst install the supp ort tree from

in a sp ecied lo cation:

the T X Live CD-ROM do a basic install, with no

--archive=name

E

system binaries chosen. Then copy the texk-7.0

Thus, if we simply wanted to see the les that

directory to your disk, and run

make up the package fancyhdr b efore we installed,

our command and output would b e as follows:

configure -prefix=$TEXMF

sh install-pkg.sh --package=fancyhdr --listonly

texmf/doc/latex/fancyhdr/fancy hdr.d vi

where $TEXMF is the place where you installed T X

E

texmf/doc/latex/fancyhdr/fancy hdr.t ex

Live.

texmf/lists/latex3/fancyhdr

Nowtyp e make install-exec and relax. . .

texmf/source/latex/fancyhdr/RE ADME

texmf/source/latex/fancyhdr/fa ncyhe adin gs.ne w

4 A user's guide to the Web2c system

texmf/tex/latex/fancyhdr/extra marks .sty

Web2c contains a set of T X-related programs,

E

texmf/tex/latex/fancyhdr/fancy hdr.s ty

i.e., T X itself, METAFONT , MetaPost, BibT X,

E E

texmf/tex/latex/fancyhdr/fixma rks.s ty

etc. The original implementation was by Tomas

Other examples of usage are:

Rokicki, who in 1987 develop ed a rst T X-to-C

E

A

 Install the L T X package arseneau:

E

system adapting change les under Unix, whichwere

primarily the work of Howard Trickey and Pavel

install-pkg.sh --package=arseneau

Curtis. Tim Morgan b ecame the maintainer of the

A

 Install the L T X package alg with no source

E

system, and during this p erio d the name changed to

les and no do cumentation:

Web-to-C. In 1990, Karl Berry to ok over the work,

install-pkg.sh \

assisted by dozens of additional contributors. The

--package=alg --nosrc --nodoc

latest result is Web2c Version 7, whichwas released

 Install all the packages available in the `extra'

in February 1997, and forms the basis of the present

Plain T X collection:

E

T X Live CD-ROM.

E

install-pkg.sh --collection=plain3

The Web2c 7.0 system runs on Unix, Windows

95/NT, DOS, Amiga, and other op erating systems.  Place all les which are need for PSTricks in a

It uses Knuth's original sources for T X and other tar le in /tmp: E

TUGb oat, Volume 18 1997, No. 2 87

basic programs written in web and translates them 4.1 Kpathsea path searching

into C source co de. Moreover, the system oers

Let us rst describ e the generic path searching

a large set of macros and functions develop ed to

mechanism of the Kpathsea library.

augment the original T X software. The most

E

We call a search path a colon- or semicolon-

commonly used comp onents are:

separated list of path elements, which are basically

bibtex Maintaining bibliographies.

directory names. A search path can come from a

dmp troff to MPX MetaPost pictures.

combination of  many sources. To lo ok up a le

my_file along a path .:/dir , Kpathsea checks

dvicopy Virtual font expansion.

each elementof the path in turn: rst ./my_file,

dvitomp DVI to MPX MetaPost pictures.

then /dir/my_file, returning the rst match or

dvitype DVI to human-readable text.

p ossibly all matches.

gftodvi Generic font pro ofsheets.

In order to adapt optimally to all op erating sys-

gftopk Generic to packed fonts.

tems' conventions, on non-Unix systems Kpathsea

gftype GF to human-readable text.

can use lename separators dierent from colon

makempx MetaPost lab el typ esetting.

 :  and slash  / .

mf Creating typ eface families.

Tocheck a particular path element p, Kpathsea

mft Prettyprinting METAFONT source.

rst checks if a prebuilt database see Filename

mpost Creating technical diagrams.

database on p. 89 applies to p, i.e., if the database

mpto MetaPost lab el extraction.

is in a directory that is a prex of p. If so, the path

sp ecication is matched against the contents of the

newer Compare mo dication times.

database.

patgen Creating hyphenation patterns.

If the database do es not exist, or do es not apply

pktogf Packed to generic fonts.

to this path element, or contains no matches, the

pktype PK to human-readable text.

lesystem is searched if this was not forbidden by

pltotf Prop erty list to TFM.

a sp ecication starting with !! and if the le

pooltype Display WEB p o ol les.

b eing searched for must exist. Kpathsea constructs

tangle WEB to Pascal.

the list of directories that corresp ond to this path

tex Typ esetting.

element, and then checks in each for the le b eing

tftopl TFM to prop erty list.

searched for.

vftovp Virtual font to virtual prop erty list

The le must exist condition comes into play

vptovf Virtual prop erty list to virtual font.

with VF les and input les read byT X's \openin

E

command. Such les may not exist e.g., cmr10.vf,

weave WEB to T X.

E

and so it would be wrong to search the disk for

The precise functions and syntax of these pro-

them. Therefore, if you fail to up date ls-R when

grams are describ ed in the do cumentation of the

you install a new VF le, it will never b e found.

individual packages or of Web2c itself. However,

Each path elementischecked in turn: rst the

knowing a few principles governing the whole family

database, then the disk. If a match is found, the

of programs will help you to b enet optimally from

search stops and the result is returned.

your Web2c installation.

Although the simplest and most common path

All programs honor the standard GNU options:

element is a directory name, Kpathsea supp orts ad-

help print basic usage summary.

ditional features in search paths: layered default val-

verbose print detailed progress rep ort.

ues, environmentvariable names, cong le values,

version printversion information, then exit.

users' home directories, and recursive sub directory

For lo cating les the Web2c programs use the

searching. Thus, we say that Kpathsea expands a

path searching library Kpathsea. This library uses

path element, meaning transforming all the sp eci-

a combination of environment variables and a few

cations into basic directory name or names. This is

conguration les to optimize searching the T X

describ ed in the following sections in the same order

E

directory tree. Web2c 7.0 can handle more than

as it takes place.

one directory tree simultaneously, which is useful if

Note that if the lename b eing searched for is

one wants to maintain T X's standard distribution

absolute or explicitly relative, i.e., starts with /

E

and lo cal extensions in two distinct trees. To sp eed

or ./ or ../ , Kpathsea simply checks if that le

up le searches the ro ot of each tree has a le ls-R,

exists.

containing an entry showing the name and relative pathname for all les hanging under that ro ot.

88 TUGb oat, Volume 18 1997, No. 2

4.1.1 Path sources  value may contain any characters except 

and @ . The $var.prog feature is not avail-

A search path can come from many sources. In the

able on the right-hand side; instead, you must

order in which Kpathsea uses them:

use an additional variable see the denition of

1. A user-set environment variable, for instance,

the variable latex2e_inputs for example. A

TEXINPUTS. Environment variables with a

; invalue is translated to : if running under

p erio d and a program name app ended override;

Unix; this is useful to write a single texmf.cnf

e.g., if latex is the name of the program

which can b e used under b oth Unix and NT.

b eing run, then TEXINPUTS.latex will override

 All denitions are read b efore anything is ex-

TEXINPUTS.

panded, so you can use variables b efore they

2. A program-sp ecic conguration le, for exam-

are dened.

ple, a line S /a:/b indvips' config.ps.

A conguration le fragment illustrating most of

3. A Kpathsea conguration le texmf.cnf, con-

these p oints is shown b elow:

taining a line like TEXINPUTS=/c:/d see b e-

 TeX input files -- i.e.,

low.

 anything found by \input or \openin ...

4. The compile-time default.

latex209_inputs = \

You can see each of these values for a given

.:$TEXMF/tex/latex209//:$TEXMF/tex//

search path by using the debugging options see

latex2e_inputs = \

Debugging actions on p. 92.

.:$TEXMF/tex/latex//:$TEXMF/tex//

TEXINPUTS = .:$TEXMF/tex//

4.1.2 Cong les

TEXINPUTS.latex209 = $latex209_inputs

Kpathsea reads runtime conguration les named

TEXINPUTS.latex2e = $latex2e_inputs

texmf.cnf for search path and other denitions.

TEXINPUTS.latex = $latex2e_inputs

The search path used to lo ok for these les is

named TEXMFCNF by default such a le lives in the

4.1.3 Path expansion

share/texmf/web2c sub directory. All texmf.cnf

Kpathsea recognizes certain sp ecial characters and

les in the search path will be read and def-

constructions in search paths, similar to that in

initions in earlier les override those in later

Unix shells. As an general example, the following

les. Thus, with a search path of .:$TEXMF ,

complex path: ~$USER/{foo,bar}//baz expands to

values from ./texmf.cnf override those from

all sub directories under directories foo and bar in

$TEXMF/texmf.cnf.

$USER's home directory that contain a directory or

While reading the description of the format of

le baz. These expansions are explained in the

the le texmf.cnf b elow, please also refer to p. 95,

sections b elow.

which lists the texmf.cnf le on the CD-ROM.

 Comments start with  and continue to the

4.1.4 Default expansion

end of the line.

If the highest-priority search path see Path

 Blank lines are ignored.

sources on p. 88 contains an extracolon i.e., lead-

 A \ at the end of a line acts as a continua-

ing, trailing, or doubled, Kpathsea inserts at that

tion character, i.e., the next line is app ended.

p oint the next-highest-priority search path that is

Whitespace at the b eginning of continuation

dened. If that inserted path has an extra colon, the

lines is not ignored.

same happ ens with the next-highest. For example,

 Each remaining line must lo ok like

given an environmentvariable setting

variable [.progname ] [=] value

setenv TEXINPUTS /home/karl:

where the = and surrounding whitespace is

and a TEXINPUTS value from texmf.cnf of

optional.

.:$TEXMF//tex

 The variable name may contain anycharacter

then the nal value used for searching will b e:

other than whitespace, = , or . , but sticking

/home/karl:.:$TEXMF//tex

to A-Za-z_ is safest.

Since it would be useless to insert the default  If .progname is present, the denition only

value in more than one place, Kpathsea changes applies if the program that is running is named

only one extra : and leaves any others in place: progname or progname.exe. This allows dif-

it checks rst for a leading : , then a trailing : , ferent avors of T X to have dierent search

E

then a doubled : . paths, for example.

TUGb oat, Volume 18 1997, No. 2 89

4.1.5 Brace expansion  Start of comment.

\ Continuation character allows multi-line entries.

A useful feature is brace expansion, which means

that, for instance, v{a,b}w expands to vaw:vbw.

!! Search only database to lo cate le, do not search

Nesting is allowed. This can b e used to implement

the disk.

multiple T X hierarchies, by assigning a brace list

E

4.2 Filename databases

to $TEXMF.

For example, in texmf.cnf,you nd the follow-

Kpathsea go es to some lengths to minimize disk

ing denition:

accesses for searches. Nevertheless, at installations

with enough directories, searching each p ossible

texdir = $TEXMFLOCAL/tex,!!$TEXMFMAIN/tex

directory for a given le can take an excessively

Then you can write something like:

long time this is esp ecially true if manyhundreds

TEXINPUTS = .;$texdir//

of font directories havetobetraversed. Therefore,

which means that after lo oking in the current di-

Kpathsea can use an externally-built database le

rectory, rst the full $TEXMFLOCAL/tex directory

named ls-R that maps les to directories, thus

tree on disk and then the !!$TEXMFMAIN/tex tree

avoiding the need to exhaustively search the disk.

using the data base le ls-R only  will b e searched.

A second database le aliases allows you to

It is a convenientway for running two parallel T X

give additional names to the les listed in ls-R. This

E

structures, one frozen likeona CD-ROM and the

can b e helpful to adapt to 8.3 lename conventions

other b eing continuously up dated with new versions

in source les.

as they b ecome available. By using the $texdir

4.2.1 ls-R lename database

variable in all denitions, one is sure to always

search the up-to-date tree rst.

As explained ab ove, the name of the main lename

database must be ls-R. You can put one at the

4.1.6 Sub directory expansion

ro ot of eachT X installation hierarchyyou wish to

E

Two or more consecutive slashes in a path element

search$TEXMF by default; most sites have only one

following a directory d is replaced by all sub directo-

hierarchy. Kpathsea lo oks for ls-R les along the

ries of d : rst those sub directories directly under d,

TEXMFDBS path.

then the subsub directories under those, and so on.

The recommended way to create and maintain

At each level, the order in which the directories are

ls-R is to run the MakeTeXls-R script coming

searched is unspecied.

with the distribution. It is invoked by the various

If you sp ecify any lename comp onents after

MakeTeX... scripts. In principle, this script just

the // , only sub directories with matching comp o-

runs the command

nents are included. For example, /a//b expands

cd /your/texmf/root && ls -LAR ./ >ls-R

into directories /a/1/b, /a/2/b, /a/1/1/b, and so

presuming your system's ls pro duces the right out-

on, but not /a/b/c or /a/1.

put format GNU's ls is all right. To ensure that

Multiple // constructs in a path are p ossible,

the database is always up to date, it is easiest to

but // at the b eginning of a path is ignored.

rebuild it regularly via cron, so that for changes

in the installed les  p erhaps after installing or

4.1.7 List of sp ecial characters and their

A

up dating a L T X package  the le ls-R is auto-

meaning: a summary

E

matically up dated.

The following list summarises the meaning of sp ecial

If a le is not found in the database, by default

characters in Kpathsea conguration les.

Kpathsea go es ahead and searches the disk. If a

: Separator in path sp ecication; at the b eginning

particular path element b egins with !! , however,

or the end of a path it substitutes the default

only the database will b e searched for that element,

path expansion.

never the disk.

; Separator on non-Unix systems acts like :.

4.2.2 kpsewhich: Standalone path searching

$ Variable expansion.

The kpsewhich program exercises path searching ~ Represents the user's home directory.

indep endent of any particular application. This

{...} Brace expansion, e.g., a{1,2}b will b ecome

can be useful as a sort of find program to lo cate

a1b:a2b.

les in T X hierarchies this is used heavily in the

E

// Sub directory expansion. It can o ccur in the

distributed MakeTeX... scripts.

middle or at the end of a path not at the

kpsewhich option ... filename ... b eginning.

90 TUGb oat, Volume 18 1997, No. 2

Options can start with either - or -- , and .mf MFINPUTS

13 METAFONT program strings

any unambiguous abbreviation is accepted.

.pool MFPOOL, TEXMFINI

Kpathsea lo oks up each non-option argument

14 METAFONT prettyprinter style les

on the command line as a lename, and returns the

.mft MFTINPUTS

rst le found. There is no option to return all the

15 MetaPost sources

les with a particular name you can run the Unix

.mp MPINPUTS

find utility for that.

16 MetaPost program strings

The more imp ortant options are describ ed next.

.pool MPPOOL, TEXMFINI

17 MetaPost supp ort les

dpi=num Set the resolution to num ; this only af-

MPSUPPORT

fects gf and pk lo okups. -D is a synonym,

18 compiled pro cess

for compatibility with dvips. Default is 600.

.ocp OCPINPUTS

format=name

19 font metrics

Set the format for lo okup to name. By default,

.ofm OFMFONTS, TEXFONTS

the format is guessed from the lename. In

20 prop erty list

fact, the recognized lename extensions and the

.opl OPLFONTS, TEXFONTS

allowable name s including any leading .  are

21 tranlation pro cess les

.otp OTPINPUTS

the same.

22 virtual fonts

You can also sp ecify an integer for name ; this

.ovf OVFFONTS, TEXFONTS

is the only way to sp ecify formats that don't

23 virtual prop erty lists

have an asso ciated sux, such as MetaPost sup-

.ovp OVPFONTS, TEXFONTS

p ort les and dvips conguration les. It's also

24 graphics/gure

somewhat faster, since no unused formats need

.eps .epsi TEXPICTS, TEXINPUTS

to b e initialized. The integers app ear in the out-

25 Source input les read byT X

put of help . Currently recognized le typ e

E

.tex .ltx .dtx .texi .texinfo

numb ers, with their description, p ossible le

.txi .cls .sty .eps .epsi

extensions, and the corresp onding environment

1

TEXINPUTS

variables b etween parentheses  as follows:

26 T X do cumentation

E

0 Generic font les

.ps .pdf .doc .txt TEXDOCS

.gf GFFONTS, GLYPHFONTS,

27 T X program strings

E

TEXFONTS

.pool TEXPOOL, TEXMFINI

1 packed font les

28 T X system package sources

E

.pk PKFONTS, TEXPKS,

.dtx .ins TEXSOURCES

GLYPHFONTS, TEXFONTS

29 PostScript header/font

2 T X bitmap font

E

.pro TEXPSHEADERS, PSHEADERS

GLYPHFONTS

30 Troff fonts

3 Adob e PostScript font metrics

TRFONTS

.afm AFMFONTS

31 T X font metric les

E

4 METAFONT memory dump

.tfm TFMFONTS, TEXFONTS

.base MFBASES, TEXMFINI

32 PostScript typ e1 fonts

5 BibT X bibliography database

E

.pfa .pfb T1FONTS, T1INPUTS,

.bib BIBINPUTS, TEXBIB

TEXPSHEADERS, PSHEADERS

6 BibT Xstyles

E

33 virtual fonts

.bst BSTINPUTS

.vf VFFONTS, TEXFONTS

7 Runtime conguration les

34 dvips conguration les

.cnf TEXMFCNF

config.xxx , xxx.map TEXCONFIG

8 Web2c lename database

35 MakeIndex style les

ls-R TEXMFDBS

.ist TEXIDXSTYLE, INDEXSTYLE

9 T X memory dump

E

These environment variables are set by de-

.fmt TEXFORMATS, TEXMFINI

fault in the conguration le texmf.cnf. It is

10 T X generic font maps

E

only when you wanttooverride one or more of

.map TEXFONTMAPS

11 MetaPost memory dump

the values sp ecied in that le that you might

.mem MPMEMS, TEXMFINI

want to set them explicitly in your execution

12 METAFONT source les

environment.

1

Note that the format and path options

You can nd denitions for these environmentvariables

in the le texmf.cnf p. 95 are mutually exclusive.

TUGb oat, Volume 18 1997, No. 2 91

mode=string Font bitmap glyph les of typ e .pk corresp ond to

Set the mo de name to string ; this also only format typ e 2. They are used by visualization

aects gf and pk lo okups. No default: any programs like dvips and xdvi. On our system

mo de will b e found. we found the Computer Mo dern le cmr10 for the

mo de ljfour, at a base resolution of 600 dpi dots

must-exist

per inch. However, when sp ecifying that we are

Do everything p ossible to nd the les, notably

only interested in a resolution of 300dpi -dpi=300

including searching the disk. By default, only

we are told there is no such font available on the

the ls-R database is checked, in the interest of

system. In fact, a program like dvips or xdvi

eciency.

would go o and actually build the .pk les at the

path=string

required resolution using the script MakeTeXPK. The

Search along the path string colon-separated

last two commands lo ok for a le ptmb8r.pk. When

as usual, instead of guessing the search path

sp ecifying no explicit resolution the system returns

from the lename. // and all the usual

one at 597 dpi which is closest to the default set

expansions are supp orted. The options path

in the MakeTeXPK script 600 dpi. However, when

and format are mutually exclusive.

sp ecifying the desired resolution 300 dpi the full

progname=name

path name of the relevant target le is shown.

Set the program name to name. This can aect

Next we turn our attention to dvips's header

the search paths via the .prognam feature in

format typ e 29 and conguration les format typ e

conguration les. The default is kpsewhich .

34.

show-path=name

>> kpsewhich tex.pro

shows the path used for le lo okups of le

.../dvips/base/tex.pro

typ e name. Either a lename extension  .pk ,

.vf , etc. or an integer can b e used, just as

>> kpsewhich -format=34 psfonts.map

with format option.

.../dvips/base/psfonts.map

debug=num

sets the debugging options to num.

>> kpsewhich -format=.map config.ps

.../dvips/config/config.ps

4.2.3 Examples of use

Let us nowhave a lo ok at Kpathsea in action.

We rst lo ok at a few of the commonly used

>> kpsewhich -format=.tex article.cls

les, namely the general prolog tex.pro for T X

E

/usr/local/share/texmf/t ex/l ate x/ba se/a rti cle. cls

supp ort, b efore turning our attention to the generic

We are lo oking for the le article.cls in the

conguration le config.ps and the PostScript

T X source le directories typ e .tex, format typ e

E

font map psfonts.map. Note how we fo ol the

25. We nd it in the sub directory tex/latex/base

system by asking for config.ps as if it had a sux

b elow the TEXMF ro ot directory. Tosave space, in

of .map.

the following examples we will denote with ... the

Wenow lo ok a little closer at the URW Times

rep etitive part /usr/local/share/texmf preceding

PostScript supp ort les. The name for these in

each le path.

Berry's font naming scheme is utm . The rst le

we lo ok at is the conguration le, which contains

>> kpsewhich tugboat.bib

.../bibtex/bib/beebe/tug boat .bi b

the name of the map le.

BibT X bibliography databases corresp ond to for-

E

>> kpsewhich -format=34 config.utm

mat typ e .bib. Here we lo cated le tugboat.bib.

.../dvips/config/config.utm

>> kpsewhich cmr10.pk

The contents of that le is

.../fonts/pk/ljfour/publ ic/c m/c mr10 .600 pk

p +utm.map

>> kpsewhich -dpi=300 cmr10.pk

which p oints to the le utm.map, whichwewantto

lo cate next.

>> kpsewhich ptmb8r.pk

>> kpsewhich utm.map

.../fonts/pk/modeless/dp i597 /pt mb8r .pk

.../dvips/urw/utm.map

In this map le, which resides in dvips's urw >> kpsewhich -dpi=300 ptmb8r.pk

sub directory, the le names of the Typ e1 PostScript .../fonts/pk/modeless/dp i300 /pt mb8r .pk

92 TUGb oat, Volume 18 1997, No. 2

A

Let us consider, as an example, a small L T X fonts referenced are dened. The contents lo oks like

E

source le, hello_world.tex, which contains the we only show part of the lines:

following input.

utmb8r NimbusRomNo9L-Medi ...

utmbi8r NimbusRomNo9L-MediItal...

\documentclass{article}

utmr8r NimbusRomNo9L-Regu ...

\begin{document}

utmri8r NimbusRomNo9L-ReguItal...

Hello World!

utmbo8r NimbusRomNo9L-Medi " ...

\end{document}

utmro8r NimbusRomNo9L-Regu " ...

This little le only used the font cmr10, so let us

Let's, for instance take the Times Regular instance

lo ok how dvips prepares the PostScript le.

utmr8a.pfb, and nd its p osition in the texmf

>> dvips -d4100 hello_world -o

directory tree by using a search with format typ e

In this case wehave combined dvips's debug class

32.

4 font paths with Kpathsea's path element ex-

>> kpsewhich utmr8a.pfb

pansion see dvips Reference Manual. We get

.../fonts/type1/urw/utm/ utmr 8a. pfb

something like shown b elowwehave rearranged the

It should be evident from these few examples

output for easier display.

how one can easily lo cate the whereab outs of a

debug:start searchfile=texmf.cnf, must_exist=1,

given le. This is esp ecially imp ortant if you

find_all=1,

path=.:/usr/local/bin/te xliv e:/ usr/ loca l/b in:

susp ect that the wrong version of a le is picked up

/usr/local/bin/share/te xmf /web 2c:/ usr /loc al:

somehow, since kpsewhich will show you the rst

/usr/local/share/texmf/ web 2c:

le encountered.

/.:/./teTeX/TeX/share/t exm f/we b2c: .

kdebug:start searchfile=ls-R, must_exist=1,

4.2.4 Debugging actions

find_all=1,

path=/usr/local/texmf:/u sr/l oca l/sh are/ tex mf.

Sometimes it is necessary to really investigate how

kdebug:searchls-R =>/usr/local/share/texmf /ls- R

a program resolves le references. To make this

kdebug:start searchfile=aliases, must_exist=1,

find_all=1,

feasible in a convenientway Kpathsea oers various

path=/usr/local/texmf:/u sr/l oca l/sh are/ tex mf.

debug levels:

kdebug:searchaliases =>

1 stat calls le tests. When running with an

kdebug:start searchfile=config.ps, must_exist=0,

find_all=0,

up-to-date ls-R database this should almost

path=.:/usr/local/texmf/ dvip s// :

give no output.

!!/usr/local/share/texm f/d vips //.

kdebug:searchconfig.p s =>

2 References to hash tables like ls-R database,

/usr/local/share/texmf/d vips /co nfig /con fig .ps

map les, conguration les.

kdebug:start searchfile=/root/.dvips rc,

4 File op en and close op erations.

must_exist=0, find_all=0,

path=.:/usr/local/texmf/ dvip s// :

8 General path information for le typ es searched

!!/usr/local/share/texm f/d vips //.

by Kpathsea. This is useful to nd out where a

kdebug:search$HOME/.d vips rc =>

particular path for the le was dened.

...

kdebug:start searchfile=psfonts.map, must_exist=0,

16 Directory list for each path element only rele-

find_all=0,

vant for searches on disk.

path=.:/usr/local/texmf/ dvip s// :

!!/usr/local/share/texm f/d vips //.

32 File searches.

kdebug:searchpsfonts. map =>

A value of -1 will set all the ab ove options; in

/usr/local/share/texmf/d vips /ba se/p sfon ts. map

practice you will probably always use these levels

First dvips lo cates its working les. It rst found

if you need any debugging.

texmf.cnf with the denitions of the paths of

Similarly, with the dvips program one can, by

the other les, then the le data base ls-R to

setting some debug switches, follow in detail where

optimize le searching. It go es on to nd the

les are picked up from. Alternatively, when a

generic conguration le config.ps, and then lo oks

le is not found, the debug trace shows in which

for the customization le .dvipsrc which, in this

directories the program lo oks for the given le, so

case is not found . Finally dvips lo cates the generic

that one can get an indication what the problem is.

map le for PostScript fonts psfonts.map dening

Generally sp eaking, as most programs call the

the relation b etween the internal and external names

Kpathsea library internally,you can select a debug

for the PostScript fonts.

option by using the KPATHSEA_DEBUG environment

At this p oint dvips identies itself to the user:

variable, and setting it to a combination of  values

dvipsk 5.66a Copyright 1986-97 Radical Eye Software

www.radicaleye.com as describ ed in the ab ove list.

TUGb oat, Volume 18 1997, No. 2 93

will then be read from texmf.cnf See p. 95, then go es on to lo ok for the prolog le texc.pro,

line 280 for the generic value and line 281 for

kdebug:start searchfile=texc.pro, must_exist=0,

find_all=0,

the huge one instantiated by hugetex.

path=.:/usr/local/texmf/dv ips //:

extra_mem_bot Extra space for large T X data

E

!!/usr/local/share/texmf /dvi ps// :

structures: boxes, glue, breakp oints, etc. Esp e-

/usr/local/texmf/fonts// type 1//:

!!/usr/local/share/texmf /fon ts// typ e1// .

cially useful if you use P CT X.

I E

kdebug:searchtexc.pro =>

font_mem_size Number of words for font informa-

/usr/local/share/texmf/dvi ps/ base /tex c.p ro

tion available for T X. This is more or less the

E

After having found the le, dvips outputs date and

total size of all TFM les read.

time, and informs us that it will generate the le

hash_extra Additional space for the hash table of

hello_world.ps, then that it needs the font le

control sequence names. Approximately 10,000

cmr10, and that the latter is declared as resident

control sequences can be stored in the main

' TeX output 1997.05.01:1316' -> hello_world.ps

hash table; if you have a large book with

Defining font  cmr10 at 10.0pt

numerous cross-references, this might not be

Font cmr10 is resident.

enough. On line 297 and 298 of le texmf.cnf

Now the search is on for the le cmr10.tfm, which

as shown in p. 95 you see that b oth the hugetex

is found, then a few more prolog les not shown,

and pdftex program invo cations ask for an

and nally for the Typ e1 instance cmr10.pfb of the

extra 10,000 control sequences the default

font which is found and included in the output le

value of hash_extra is zero, as seen on line

see last line.

296.

kdebug:start searchfile=cmr10.tfm, must_exist=1,

Of course, this facility is no substitute for truly

find_all=0,

path=.:/usr/local/texmf/fo nts /tfm //:

dynamic arrays and memory allo cation, but since

!!/usr/local/share/texmf /fon ts/t fm/ /:

this is extremely dicult to implement in present

/var/tex/fonts/tfm//.

T X, these runtime parameters provide a practical

E

kdebug:searchcmr10.tfm =>

compromise allowing some exibility.

/usr/local/share/texmf/f onts /tf m/pu blic /cm /cmr 10. tfm

kdebug:start searchfile=texps.pro, must_exist=0,

find_all=0,

5 Other packages on the CD-ROM

...

While the main p ortion of T X Live the fonts,

E

.

macros and do cumentation can b e used on anyT X

E

kdebug:start searchfile=cmr10.pfb, must_exist=0,

system, the set of runnable binaries is not suitable

find_all=0,

for everyone. To make the disk as widely useful as

path=.:/usr/local/texmf/dv ips //:

p ossible, wehave included the original distributions

!!/usr/local/share/texmf /dvi ps// :

/usr/local/texmf/fonts// type 1//:

of four complete T X systems, two for Macintosh,

E

!!/usr/local/share/texmf /fon ts// typ e1// .

one for Windows 95, and one for DOS and OS/2.

kdebug:searchcmr10.pfb =>

Windows 3.1 users should lo ok at the GUTenb erg

/usr/local/share/texmf/f onts /ty pe1/ publ ic/ cm/c mr1 0.pf b

distribution on the CD-ROM.

[1]

2

5.1 OzT X

4.3 Runtime options

E

OzT X is a Macintosh T X system created by An-

Another of the nice features of Web2c 7.0 is its

E E

drew Trevorrow. The OzT X application includes

p ossibility to control a numb er of memory parame-

E

T X, INITEX,a DVI previewer, a DVI-to-PostScript

ters in particular, array sizes via the runtime le

E

translator Tom Rokicki's dvips and a driver for

texmf.cnf read by Kpathsea. A detailed list of

QuickDraw printers. OzT X also includes dvidvi,

all set-table parameters can be found in that le

E

dvicopy, and Angus Duggan's PostScript utilities:

see p. 95, Part 3 starting at line 261. The most

psbook, psnup, psselect and pstops.

interesting values are:

The version of dvips included in OzT X sup-

E

main_memory Total words of memory available, for

p orts Hyp erT X and the partial downloading of

E

T X, METAFONT , and MetaPost. You must

E

PostScript fonts. It has also b een enhanced for

make a new format le for each dierent set-

Mac users in a number of ways: Standard Mac

ting. For instance, you could generate a

PostScript fonts LWFN les can be downloaded,

huge version of T X, and call the format le

E

fully or partially. All OzT X-sp ecic \special

E

hugetex.fmt. Using the standard way of sp ec-

commands are supp orted, such as the inclusion of

ifying the program name used by Kpathsea the

2

particular value of the main_memory variable This section was written by Andrew Trevorrow.

94 TUGb oat, Volume 18 1997, No. 2

PICT/PNTG/EPSF les. The dvips output can is provided to registered users. Send all queries and

b e sent directly to the current printer. comments to Andrew Trevorrow[email protected].

OzT X's previewer has lots of features to make

E

3

5.2 CMacTeX

it easy to pro ofread DVI les. It can handle PK and

PostScript fonts. Anti-aliasing is supp orted. Virtual CMacTeX is an implementation of T X for the

E

fonts are pro cessed on the y. The previewer sup- Macintosh by Thomas Kie mailto:tkiffe@math.

p orts most of the \special commands generated by tamu.edu. It includes the three main parts of

A

L T X's color, graphics/x and hyperref packages. anyT X installation  T X, METAFONT and dvips.

E E E

It recognizes all dvips-sp ecic \specials and those It also includes two dvi previewers, a utility for

it cannot handle like rotation are silently ignored. printing dvi les on a non PostScript printer, a

OzT X includes all the most p opular formats PostScript previewer and numerous utilities for ma-

E

A

and macro packages. Plain T X, L T X, AMS-T X, nipulating T X fonts. Full supp ort for the automatic

E E E E

A

AMS-L T X and REVT X are all installed and ready generation of pk font les is an integral part of the

E E

to run. distribution. CMacTeX can be congured to work

OzT X is easy to extend and customize. A in an integrated fashion with BBEdit, Alpha, and

E

default conguration le is read when OzT X starts MPW. It will run on any Macintosh with 8 MB of

E

up; it contains a host of parameters for setting up RAM and System 7.

search paths, telling T X how much memory to CMacTeX is shareware. The registration fee is

E

allo cate for various arrays, sp ecifying which TFMs US$35 for a single-user license and US$150 for a site

license. are for PostScript fonts, etc. A Cong menu makes

Installation instructions can b e found in the le it easy to load other cong les at any time. And

/macintosh/cmactex/ReadMeFirst for even more exibility, OzT X can automatically

E

load a sp ecied cong le just b efore typ esetting,

4

5.3 MiKTeX

previewing or printing.

MiKTeX 1.07 is an implementation by Chris-

5.1.1 Additional programs

tian Schenk mailto:[email protected]

of T X and METAFONT related utilities for Windows The usual assortmentofT X-related programs are

E E

NT and Windows 95. The MiKTeX distribution provided with OzT X, including OzMF, a Mac im-

E

A

includes T X; L T X2 Dec'96 including standard plementation of METAFONT, and OzMP, a Mac

"

E E

packages; METAFONT ; MetaPost; dvips MakeIndex; p ort of John Hobby's MetaPost program for pro-

BibT X; YAP Yet Another Previewer; TeXware ducing PostScript pictures using a METAFONT-like

E

dvityp e etc.; METAFONT ware gftopk etc.; psutils language.

psselect, pstops etc.; and DVIcopy. The following programs are also distributed

Installation instructions can b e found in the le with OzT X, courtesy of their authors; BibT X

E E

/win32/miktex/README.TXT by Vince Darley; MakeIndex by Rick Zaccone;

A

Excalibur, a T X/L T X sp elling checker, by Rick

E E

5.4 emTeX

Zaccone and Rob ert Gottshall; and AlphaLite, a

A

The emTeX distribution for DOS and OS/2 is T X/L T X-savvy text editor, byPete Keleher.

E E

wriiten by Eb erhard Mattes mailto:mattes@azu. For the latest information ab out OzT X, keep

E

informatik.uni-stuttgart.de. It includes the an eye on the Web page at the URL http://www.

T X typ esetter, the METAFONT font generation kagi.com/authors/akt/oztex.html.

E

program, printer drivers, screen previewers, and An even b etter way to keep up-to-date is to

to ols like BibT X and MakeIndex. It also includes join the oztex-info mailing list. To subscrib e, send

E

A A

the macro packages L T X 2.09 and L T X2 . Fonts some e-mail to

"

E E

are included as pixel les and METAFONT source

[email protected]

les.

Installation instructions can b e found in the le

with the following line in the body of the message:

/msdos/emtex/README.ENG

subscribe oztex-info

OzT X is distributed as shareware, so you are

E

welcome to try it out b efore paying the registration

fee. The individual fee is US$30 and the site fee is

3

This section is taken from the CMacTeX

US$300. See the Shareware Fee item in OzT X's

E

do cumentation.

4

Help menu for details on howtopay. E-mail supp ort This section is drawn from the do cumentation.

TUGb oat, Volume 18 1997, No. 2 95

A The texmf.cnf le

1  original texmf.cnf -- runtime path configuration file for kpathsea.

2  If you change or delete `original' on the previous line, the

3  distribution won't install its version over yours.

4  Public domain.

5 

6  What follows is a super-summary of what this .cnf file can

7  contain. Please read the Kpathsea manual for more information.

8 

9  texmf.cnf is generated from texmf.cnf.in, by replacing @var@ with the

10  value of the Make variable `var', via a sed file texmf.sed, generated

11  once by kpathsea/Makefile itself generated from kpathsea/Makefile.in

12  by configure.

13 

14  Any identifier sticking to A-Za-z_ for names is safest can be assigned.

15  The `=' and surrounding spaces is optional.

16  No  or @ in texmf.cnf.in, for the sake of autogeneration.

17  However, 's and @'s can be edited into texmf.cnf or put in envvar values.

18  $foo or ${foo} in a value expands to the envvar or cnf value of foo.

19 

20  Earlier entries in the same or another file override later ones, and

21  an environment variable foo overrides any texmf.cnf definition of foo.

22 

23  All definitions are read before anything is expanded, so you can use

24  variables before they are defined.

25 

26  If a variable assignment is qualified with `.PROGRAM', it is ignored

27  unless the current executable last filename component of argv[0] is

28  named PROGRAM. This foo.PROGRAM construct is not recognized on the

29  right-hand side. For environment variables, use FOO_PROGRAM.

30 

31  Which file formats use which paths for searches is described in the

32  various programs' and the kpathsea documentation.

33 

34  // means to search subdirectories recursively.

35  A leading !! means to look only in the ls-R db, never on the disk.

36  A leading/trailing/doubled : in the paths will be expanded into the

37  compile-time default. Probably not what you want.

38

39  Part 1: Search paths and directories.

40

41  The root of everything below.

42 prefix = $SELFAUTOPARENT

43

44  You can set an environment variable to override this if you're testing

45  a new TeX tree, without changing anything else.

46 

47  You may wish to use one of the $SELFAUTO... variables here so TeX will

48  find where to look dynamically. See the manual and the definition

49  below of TEXMFCNF.

50 

51  If you have multiple trees, you can use shell brace notation, for example:

52  TEXMF = {/usr/local/mytex,/usr/local/ other tex}

53  and also set TEXMFDBS to /usr/local/mytex:/usr/local/ot herte x.

54 TEXMFLOCAL=/usr/local/texmf

55 TEXMFMAIN = $prefix/share/texmf

56 TEXMFLS_R = $TEXMFLOCAL

57  Where to look for ls-R files. There need not be an ls-R in the

96 TUGb oat, Volume 18 1997, No. 2

58  directories in this path, but if there is one, Kpathsea will use it.

59 TEXMFDBS = $TEXMFLOCAL;$TEXMFMAIN

60

61  Where you want generated files to go. Choose one of the texmf trees

62  listed in $TEXMF. The following is the default:

63 VARTEXMF = $TEXMFLOCAL

64

65  The TeX inputs and fonts directories.

66 texdir = {$TEXMFLOCAL/tex,!!$TEXMFMAIN/ tex}

67 omegadir ={$TEXMFLOCAL/omega,!!$TEXMFMA IN/om ega}

68 fontdir = {$TEXMFLOCAL/fonts,!!$TEXMFMA IN/fo nts}

69 dbmain=!!$TEXMFMAIN

70 

71 dbtex = $texdir

72 dbomega = $omegadir

73 dbfonts = $fontdir

74

75  TeX input files -- i.e., anything to be found by \input or \openin,

76  including .sty, .eps, etc.

77 TEXINPUTS = .;$dbtex//

78

79  LaTeX 2e specific macros are stored in latex.

80  latex209 is not supported, at the request of the authors of LaTeX

81 

82 latex_inputs = .;$dbtex/latex//;$dbtex/gener ic//

83 TEXINPUTS.latex = $latex_inputs

84 TEXINPUTS.latextex = $latex_inputs

85

86  Omega

87 TEXINPUTS.lambda2e = .;$dbomega/lambda//;$latex_input s

88 TEXINPUTS.lambda = .;$dbomega/lambda//;$latex_in puts

89

90  Fontinst needs to read afm files.

91 TEXINPUTS.fontinst = .;$dbtex//;$dbfonts/afm//

92

93  Plain TeX. Have the command tex check all directories as a last

94  resort, we may have plain-compatible stuff anywhere.

95 plain_inputs = $dbtex/plain//;$dbtex/generic //

96 TEXINPUTS.textex = .;$dbtex//;$plain_inputs

97 TEXINPUTS.tex = .;$plain_inputs;$dbtex//

98 TEXINPUTS.omega = .;$dbomega//;$plain_inputs;$db tex//

99

100  INITEX. May as well make this separate so it can search on disk;

101  initex is seldom run, and might be used directly after files have been

102  added, when ls-R may not up be to date.

103 TEXINPUTS.initex = .;$texdir//

104 TEXINPUTS.iniomega = .;$omegadir//;$texdir//

105

106  Earlier entries override later ones, so put this last.

107 TEXINPUTS.viromega = .;$dbomega//;$dbtex//

108 TEXINPUTS = .;$dbtex//

109

110  Metafont, MetaPost inputs.

111 MFINPUTS = .;{$TEXMFLOCAL,$dbmain}/meta font/ /;{$ dbfon ts,$ VARTE XFON TS}/s ource //

112 MPINPUTS = .;{$TEXMFLOCAL,$dbmain}/meta post/ /

113

114  Dump files fmt/base/mem for vir{tex,mf,mp} to read see

115  web2c/INSTALL, and string pools .pool for ini{tex,mf,mp}. It is

116  silly that we have six paths and directories here they all resolve to

TUGb oat, Volume 18 1997, No. 2 97

117  a single place by default, but historically ...

118 TEXFORMATS = .;{$TEXMFLOCAL,$dbmain}/web2c

119 MFBASES = .;{$TEXMFLOCAL,$dbmain}/web2c

120 MPMEMS = .;{$TEXMFLOCAL,$dbmain}/web2c

121 TEXPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c

122 MFPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c

123 MPPOOL = .;{$TEXMFLOCAL,$dbmain}/web2c

124

125  If you have a read-only central font directory and therefore need to

126  cache MakeTeXPK-created fonts locally, set this as appropriate and

127  also set the `vartexfonts' feature in MT_FEATURES in MakeTeXnames.cnf.

128 VARTEXFONTS = /var/tex/fonts

129

130  Device-independent font metric files.

131 VFFONTS = .;$dbfonts/vf//

132 TFMFONTS = .;$dbfonts/tfm//;$VARTEXFONT S/tfm //

133

134  The $MAKETEX_MODE below means the drivers will not use a cx font when

135  the mode is ricoh. If no mode is explicitly specified, kpse_prog_init

136  sets MAKETEX_MODE to /, so all subdirectories are searched. See the manual.

137 PKFONTS = .;{$dbfonts,$VARTEXFONTS}/pk/ $MAKE TEX_ MODE/ /

138

139  xdvi needs to find bitmaps for PostScript fonts, which can be

140  generated by the standalone program gsftopk, among others.

141 PKFONTS.xdvi = .;{$dbfonts,$VARTEXFONTS}/pk/ {$MA KETEX _MOD E,mod eles s}//

142

143  Similarly for the GF format, which only remains in existence because

144  Metafont outputs it and MF isn't going to change.

145 GFFONTS = .;$dbfonts/gf/$MAKETEX_MODE//

146

147  A backup for PKFONTS and GFFONTS. Not used for anything.

148 GLYPHFONTS = .;$dbfonts

149

150  For texfonts.map and included map files used by MakeTeXPK.

151  See ftp;//ftp.tug.org/tex/fontna me.ta r.gz.

152 TEXFONTMAPS = .;{$TEXMFLOCAL,$dbmain}/fontna me

153

154  BibTeX bibliographies and style files.

155 BIBINPUTS = .;{$TEXMFLOCAL,$dbmain}/bibtex/b ib//

156 BSTINPUTS = .;{$TEXMFLOCAL,$dbmain}/bibtex/b st//

157

158  MFT style files.

159 MFTINPUTS = .;{$TEXMFLOCAL,$dbmain}/mft//

160

161  PostScript headers, prologues .pro, encodings .enc and fonts.

162 TEXPSHEADERS = .;$TEXMFLOCAL/dvips;$dbmain/d vips //;$d bfon ts/ty pe1/ /

163

164  PostScript Type 1 outline fonts.

165 T1FONTS = .;$dbfonts/type1//;$TEXMFLOCA L/dvi ps// ;$dbm ain/ dvips //

166

167  PostScript AFM metric files.

168 AFMFONTS = .;$dbfonts/afm//

169

170  Dvips' config.* files this name should not start with `TEX'!.

171 TEXCONFIG = .;$TEXMFLOCAL/dvips;$dbmain/dvip s//

172

173  Makeindex style .ist files.

174 INDEXSTYLE = .;{$TEXMFLOCAL,$dbmain}/makeind ex// 175

98 TUGb oat, Volume 18 1997, No. 2

176  Used by DMP ditroff-to-mpx, called by makempx -troff.

177 TRFONTS = /usr/lib/font/devpost

178 MPSUPPORT = .;{$TEXMFLOCAL,$dbmain}/metapost /sup port

179

180  For xdvi to find mime.types and .mailcap, if they do not exist in

181  $HOME. These are single directories, not paths.

182  But the default mime.types, at least, may well suffice.

183 MIMELIBDIR = $prefix/etc

184 MAILCAPLIBDIR = $prefix/etc

185

186  TeX documentation and source files, for use with kpsewhich.

187 TEXDOCS = .;{$TEXMFLOCAL,$dbmain}/doc//

188 TEXSOURCES = .;{$TEXMFLOCAL,$dbmain}/source/ /

189

190  Omega-related fonts and other files.

191 OFMFONTS = .;{$dbfonts,$VARTEXFONTS}//o fm//

192 OPLFONTS = .;{$dbfonts,$VARTEXFONTS}//o pl//

193 OVFFONTS = .;{$dbfonts,$VARTEXFONTS}//o vf//

194 OVPFONTS = .;{$dbfonts,$VARTEXFONTS}//o vp//

195 OTPINPUTS = .;{$TEXMFLOCAL,$dbmain}/omega/ot p//

196 OCPINPUTS = .;{$TEXMFLOCAL,$dbmain}/omega/oc p//

197

198  For MakeTeX.common, MakeTeX.site, ls-R.

199 web2cdir = {$TEXMFLOCAL,$dbmain}/web2c

200 TEXMFCNF_DIR = $TEXMFMAIN/web2c

201

202  The MakeTeX* scripts rely on KPSE_DOT. Do not change it.

203 KPSE_DOT = .

204

205  This definition isn't used from this .cnf file itself that would be

206  paradoxical, but the compile-time default in paths.h is built from it.

207  The SELFAUTO* variables are set automatically from the location of

208  argv[0], in kpse_set_progname.

209 

210  About the /. construction;

211  1 if the variable is undefined, we'd otherwise have an empty path

212  element in the compile-time path. This is not meaningful.

213  2 if we used /$VARIABLE, we'd end up with // if VARIABLE is defined,

214  which would search the entire world.

215 

216  The TETEXDIR stuff isn't likely to relevant unless you're using teTeX,

217  but it doesn't hurt.

218 

219 TEXMFCNF =.;$SELFAUTOLOC;$SELFAUTODIR;$ SELFA UTOD IR/sh are/ texmf /web 2c;$S ELFAU TOPA RENT; \

220 $SELFAUTOPARENT/share/texmf/we b2c; /.$TE TEXDI R;/. {$TEX MFLO CAL,$ dbma in}/w eb2c; $web 2cdir

221

222  Part 2; Non-path options.

223

224  Write .log/.dvi/etc. files here, if the current directory is unwritable.

225  TEXMFOUTPUT = /tmp

226

227  If a dynamic file creation fails, log the command to this file, in

228  either the current directory or TEXMFOUTPUT. Set to the

229  empty string or 0 to avoid logging.

230 MISSFONT_LOG = missfont.log

231

232  Set to a colon-separated list of words specifying warnings to suppress.

233  To suppress everything, use TEX_HUSH = all; this is equivalent to

234  TEX_HUSH = checksum;lostchar;readable;spec ial

TUGb oat, Volume 18 1997, No. 2 99

235 TEX_HUSH = 0

236

237  Enable system commands via \write18{...}?

238 shell_escape = 0

239

240  Allow TeX \openout on filenames starting with `.' e.g., .rhosts?

241 openout_any = 0

242

243  Enable the MakeTeX... scripts by default? These must be set to 0 or 1.

244  Particular programs can and do override these settings, for example

245  dvips's -M option. Your first chance to specify whether the scripts

246  are invoked by default is at configure time.

247 

248  These values are ignored if the script names are changed; e.g., if you

249  set DVIPSMAKEPK to `foo', what counts is the value of the environment

250  variable/config value `FOO', not the `MAKETEXPK' value.

251 

252  MAKETEXTEX = 0

253  MAKETEXPK = 0

254  MAKETEXMF = 0

255  MAKETEXTFM = 0

256

257  What MetaPost runs to make MPX files. This is passed an option -troff

258  if MP is in troff mode. Set to `0' to disable this feature.

259 MPXCOMMAND = makempx

260

261  Part 3; Array and other sizes for TeX and Metafont and MetaPost.

262 

263  If you want to change some of these sizes only for a certain TeX

264  variant, the usual dot notation works, e.g.,

265  main_memory.hugetex = 20000000

266 

267  If a change here appears to be ignored, try redumping the format file.

268

269  Memory. Must be less than 8,000,000.

270 

271  main_memory is relevant only to initex, extra_mem_* only to non-ini.

272  Thus, have to redump the .fmt file after changing main_memory; to add

273  to existing fmt files, increase the other. To get an idea of how

274  much, try \tracingstats=2 in your TeX source file;

275  web2c/tests/memtest.tex might also be interesting.

276 

277  To increase space for boxes as might be needed by, e.g., PiCTeX,

278  increase extra_mem_bot.

279 

280 main_memory = 263000  words of memory available; also applies to mf&mp

281 main_memory.hugetex = 1100000

282 extra_mem_top = 0  extra high memory for chars, tokens, etc.

283 extra_mem_bot = 0  extra low memory for boxes, glue, breakpoints, etc.

284

285  Words of font info for TeX total size of all TFM files, approximately.

286 font_mem_size = 100000

287 font_mem_size.hugetex = 400000

288 font_mem_size.pdftex = 400000

289

290  Total number of fonts. Must be >= 50 and <= 2000 without tex.ch changes.

291 font_max = 500

292 font_max.hugetex = 900 293

100 TUGb oat, Volume 18 1997, No. 2

294  Extra space for the hash table of control sequences which allows 10K

295  names as distributed.

296 hash_extra = 0

297 hash_extra.hugetex = 10000

298 hash_extra.pdftex = 10000

299

300  Max number of characters in all strings, including all error messages,

301  help texts, font names, control sequences. These values apply to TeX and MP.

302 pool_size = 125000

303 pool_size.hugetex = 500000

304 pool_size.pdftex = 500000

305  Minimum pool space after TeX/MP's own strings; must be at least

306  25000 less than pool_size, but doesn't need to be nearly that large.

307 string_vacancies = 25000

308 string_vacancies.hugetex = 45000

309 string_vacancies.pdftex = 45000

310 max_strings = 15000  max number of strings

311 max_strings.hugetex = 55000  max number of strings

312 max_strings.pdftex = 55000  max number of strings

313 pool_free = 5000  min pool space left after loading .fmt

314

315  Hyphenation trie. As distributed, the maximum is 65535; this should

316  work unless `unsigned short' is not supported or is smaller than 16

317  bits. This value should suffice for UK English, US English, French,

318  and German for example. To increase, you must change

319  `ssup_trie_opcode' and `ssup_trie_size' in tex.ch and rebuild TeX;

320  the trie will then consume four bytes per entry, instead of two.

321 

322  US English, German, and Portuguese; 30000.

323  German; 14000.

324  US English; 10000.

325 

326 trie_size = 64000

327

328 hyph_size = 1000  number of hyphenation exceptions, >610 and <32767.

329 buf_size = 3000  max length of input lines or control sequence names

330 nest_size = 100  simultaneous semantic levels e.g., groups

331 max_in_open = 15  simultaneous input files and error insertions

332 param_size = 500  simultaneous macro parameters

333 save_size = 4000  for saving values outside current group

334 save_size.pdftex = 30000  for saving values outside current group

335 save_size.hugetex = 30000  for saving values outside current group

336 stack_size = 300  simultaneous input sources

337

338  These work best if they are the same as the I/O buffer size, but it

339  doesn't matter much. Must be a multiple of 8.

340 dvi_buf_size = 16384  TeX

341 gf_buf_size = 16384  MF

342

343  It's probably inadvisable to change these. At any rate, we must have:

344  45 < error_line < 255;

345  30 < half_error_line < error_line - 15;

346  max_print_line < 60 ;

347  These apply to Metafont and MetaPost as well.

348 error_line = 79

349 half_error_line = 50

350 max_print_line = 79

TUGb oat, Volume 18 1997, No. 2 101

B Catalogue of Packages

Table 1: T X Live packages

E

Package Col lection Description

A A

a4 latex3 Originally for L T X 2.09 but up dated for L T X2 . Mostly sup erseded by

"

E E

A

L T X2 supp ort for a4 pap er but denes the extra option of widemargins.

"

E

The geometry package is usually b etter.

A

aiaa latex3 A bundle of L T X/BibT X les and sample do cuments to aid those

E E

pro ducing pap ers and journal articles according to the guidelines of the

American Institute of Aeronautics and Astronautics AIAA

A

achemso latex3 L T X and BibT Xstyle for American Chemical So ciety

E E

acronym latex3 This package ensures that all acronyms used in the text are sp elled out

in full at least once. It also provides an environment to build a list of

acronyms.

A

adrlist latex3 Using address lists in L T X.

E

aguplus latex3 Styles for American Geophysical Union.

A

alatex formats3 An extended L T X with b etter mo dularity

E

A

alg latex3 L T Xenvironments for typ esetting algorithms

E

algorithms latex3 Denes a oating algorithm environment designed to work with the

algorithmic package.

alpha-linux systems1 System binaries for Alpha running Linux.

alpha-osf3.2 systems1 System binaries for Alpha running OSF 3.2.

altfont latex3 A generalised replacement for some parts of psnfss and mfnfss. Similar to

psfont with the PostScript sp ecic co de removed.

amiweb2c systems1 An Amiga p ort of the complete UNIX-TeX system.

amsfonts ams2 A set of miscellaneous T X fonts from the American Mathematical So ciety

E

that augment the standard set normally distributed with T X. The set

E

includes: Extra mathematical symb ols; Blackb oard b old letters upp ercase

only; Fraktur letters; Subscript sizes of b old math italic and b old Greek

letters; Subscript sizes of large symb ols such as sum and pro duct; Added

sizes of the Computer Mo dern small caps font; Cyrillic fonts from the

UniversityofWashington; Euler math fonts.

amslatex ams2 A collection of lo osely related les that are distributed together by

the American Mathematical So ciety. These les are miscellaneous

A

enhancements to L T X whose aim is sup erior information structure of

E

mathematical do cuments and sup erior printed output.

amstex ams2 American Mathematical So ciety plain T X macros

E

answers latex3 Styles for setting questions or exercises and answers.

A

apa latex3 L T X class and BibT Xstyle used to format text according to the

E E

American Psychological Asso ciation Publication Manual 4th ed.

sp ecications for manuscripts or, with an option to the package, in an

APA journal style format or as a regular do cument.

apl fonts3 Fonts for typ esetting APL programs.

arabtex lang3 Macros and fonts for typ esetting Arabic

arseneau latex2 Miscellaneous macros by Donald Arseneau.

ascii fonts3 Supp ort for IBM extended ASCI I font.

astro fonts3 Astronomical planetary symb ols.

aurora dvips3 Header les for dvips to make colour separations

autotab latex3 Generating tabular setups.

A

bab el latex1 Multilingual supp ort for L T X.

E

backgammon fonts3 Style for typ esetting backgammon b oards.

bakoma fonts2 Computer Mo dern and AMS fonts in PostScript Typ e1 form.

barco des fonts3 Fonts for making barco des.

barr graphics3 Diagram macros by Michael Barr.

A

base latex1 Basic L T X system.

E

bb ding fonts3 An NFSS-interface to the symb ol font bb ding containing many of the Zapf

dingbats fonts.

102 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

A

bbm fonts3 Blackb oard variant fonts for Computer Mo dern, with L T X supp ort

E

bbtbase bibtex1 Basic BibT Xstyles.

E

bbtdo c bibtex2 Basic BibT X do cumentation/

E

b eeb e bibtex2 Nelson Beeb e's collection of T X-related bibliographies, and BibT Xstyle

E E

les

A

b eton latex3 Typ eset a L T X2 do cument with the Concrete fonts designed by Don

"

E

Knuth and used in his b o ok Concrete Mathematics .

biblist latex3 BibT Xstyles by Joachim Schro d.

E

blue formats3 Kees van der Laan's BLUe format, a concise but expressive do cument

preparation system mo delled on Knuth's manmac

bm latex2 This is a package for accessing b old symb ols in math mo de. Similar to

the AMS \boldsymbol command, but taking more care over spacing,

delimiters etc..

b o oktabs latex2 Nicer layout of tables

b orceux graphics3 Diagram macros byFrancois Borceux

bridge latex3 Macros for typ esetting Bridge diagrams.

A

calc latex2 Adds inx expressions to p erform arithmetic in the L T X commands

E

\setcounter, \addtocounter, \setlength, and \addtolength.

calendar plain3 Plain macros for making nice calendars

calrsfs latex3 Nicer calligraphic letters.

camel latex3 Comprehensive bibliography manager prototyp e citation engine for

A

L T X3. Will b ecome BibT X 1.0 on release. Under development.

E E

caption latex2 Extends caption capabilities for gures and tables, such as the caption

width, style, font. Many asp ects are tunable as options.

carlisle latex2 Miscellaneous small packages byDavid Carlisle

A

ccfonts latex L T X supp ort for Concrete fonts.

E

cchess fonts3 Macros and fonts for typ esetting Chinese Chess b oard diagrams.

cellular plain3 Cellular table construction

A

changebar latex2 Generate changebars in L T X do cuments.

E

A

chemcono latex3 ALT Xstyle le for using comp ound numb ers in chemistry do cuments.

E

It works like \cite and the \thebibliography, using \fcite and

\theffbibliography instead. It allows comp ound names in do cuments to

be numb ered and do es not aect the normal citation routines.

chemsym latex3 Macros for typing chemical symb ols

cheq fonts3 Adob e chess font.

cherokee fonts3 Fonts for Cherokee scripts

chess fonts3 Fonts for typ esetting chess b oards.

circ graphics3 Macros for typ esetting circuit diagrams. Several electrical symb ols like

resistor, capacitor, transistors etc., are dened. The symb ols can b e

connected with wires.

circuit graphics3 Language for drawing circuit diagrams.

cirth fonts3 Fonts for Cirth

cite latex2 Supp orts compressed, sorted lists of numerical citations: [8,1116].

cm fonts1 Computer Mo dern fonts

cmbright fonts2 Computer Mo dern Bright fonts

cmcyralt latex3 Alternative Russian enco ding supp ort

cmextra fonts2 Extra Computer Mo dern fonts, from the American Mathematical So ciety

cmpica fonts3 A Computer Mo dern Pica variant

cmps fonts2 Typ e1 versions of PostScript fonts, from Blue Sky and Y&Y.

co depage latex3 Supp ort for variant co de pages.

colorsep dvips3 Supp ort for colour separation when using dvips

concmath fonts3 Concrete math fonts derived from Computer Mo dern math fonts using

A

parameters from Concrete text fonts. ALT X package providing the

E

necessary font denition co de is included.

concrete fonts3 Concrete fonts

TUGb oat, Volume 18 1997, No. 2 103

Catalogue of Packages continued

Package Col lection Description

context generic3 pp chtex is a package that can b e used to typ eset chemical formulas.

The package is a separate mo dule of the context macro package for T X

E

context is a full featured, parameter driven macro package, which fully

supp orts advanced interactive do cuments.

count1to latex3 Setting \count1 to \count9

croatian lang3 Fonts for typ esetting Croatian scripts

crosswrd latex3 Macros for typ esetting crossword puzzles.

csfonts fonts2 Czech/Slovak-tuned METAFONT Computer Mo dern fonts.

A

cslatex latex L T X supp ort for Czech/Slovak typ esetting.

E

csplain plain2 Plain T X supp ort for Czech/Slovak typ esetting.

E

A

curves graphics3 Draws curves in the L T X picture environment using parab olas b etween

E

p oints with continuous slop e at p oints. Equivalent to technical p ens with

compasses and French curves.

custom-bib latex2 Package generating customized BibT X bibliographystyles from a generic

E

le using do cstrip.

dancers fonts3 Font for the Sherlo ck Holmes `Dancing Men'

dates latex3 Macros for parsing date strings.

deleq latex3 Provides a more exible numb ering of equations, sub equations, and

`recycled' equations, including `partial' equation numb ers `3a', `3b' etc..

devanagari lang3 Fonts for typ esetting Devanagari

A

dialogl latex3 Macros for constructing interactiveLT X scripts

E

dinbrief latex3 German letter DIN style.

do c1 texlive1 Basic do cumentation for T X Live.

E

do c2 texlive2 Recommended do cumentation for T X Live.

E

dotseqn latex3 Flush left equations with dotted letters to the numb ers

draftcopy latex3 Places the word DRAFT or other words in light grey diagonally across

the background or at the b ottom of each or selected pages of the

do cument.

dratex graphics3 General drawing macros entirely in T X

E

A

dropping latex3 ALT X2 macro for dropping the rst characters or words of a

"

E

A

paragraph. This is an extension of the L T X 2.09 package drop caps. This

E

package automatically takes care of nding the font name.

dtk latex3 Macros for the DANTE publication.

duerer fonts3 Computer Duerer fonts.

dvips generic1 Tom Rokicki's dvi to PostScript driver

dvipsbas dvips1 Basic supp ort les for dvips.

ean generic3 Font for making EAN barco des.

easy latex3 Macros for simplying the writing of equations.

A

ec fonts2 The ec fonts supp ort the complete L T X T1 enco ding, as dened at the

E

1990 TUG conference hold at Cork/Ireland. They are intended to b e as

stable as the cm fonts are, i.e., there shall b e no more changes to the tfm

les. The ec fonts also contain a Text Companion Symb ol font, called

tc, featuring many useful characters needed in typ esetting, for example

oldstyle digits, currency symb ols including the newly created Euro

symb ol, the p ermille sign, copyright, trade mark and servicemark as well

A

as a copyleft sign, and many others. Recent releases of L T X2 supp ort

"

E

the ec fonts. The dc fonts, whichwere termed as preliminary versions, will

dissapp ear from the archives.

ecc fonts3 `Europ ean' T1 enco ded version of the Concrete fonts.

edmac plain3 A macro package for typ esetting scholarly critical editions

A

eepic graphics2 A set of T X macros for L T X implementing several extensions to EPIC

E E

A

and the L T X picture drawing environment, including the drawing of lines

E

at any slop e, the drawing of circles in any radii, and the drawing of dotted

and dashed lines much faster with much less T X memory, and providing

E

several new commands for drawing ellipses, arcs, splines, and lled circles and ellipses.

104 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

eiad latex3 Macros and EIAD fonts.

elsevier latex3 Preprintstyle for Elsevier Science journals

elvish fonts3 Font for typ esetting Tolkien Elvish script

endoat latex3 Place all gures on pages by themselves at the end of the do cument with

markers like [Figure 3 ab out here] app earing in the text by default

near to where the gure or table would normally have o ccurred.

engwar fonts3 Font for typ esetting Tolkien Engwar script, by Michael Urban

envbig latex3 Printing addresses on envelop es

A

envlab latex3 ALT X2 package for pro ducing mailing envelop es and lab els, including

"

E

barco des and address formatting according to the US Postal Service rules.

A

Redenes the standard \makelabels command of the L T X2 letter

"

E

do cumentclass.

eplain formats2 Simple but p owerful extended version of the plain format, adding supp ort

for bibliographies, tables of contents, enumerated lists, verbatim input

of les, numb ered equations, tables, two-column output, fo otnotes and

commutative diagrams.

epslatex do c2 An extensive do cument which explains how to use Encapsulated

A

PostScript EPS les in L T X2 do cuments. Includes explanations of

"

E

Bounding Boxes, and more.

eqname latex3 Style for dierent equation numb ering.

eqnarray latex3 More generalised equation arrays with numb ering.

euler latex3 Provides a setup for using the AMS Euler family of fonts for math in

A

L T X do cuments. The underlying philosophy of Zapf 's Euler design

E

was to capture the avor of mathematics as it might b e written bya

mathematician with excellent handwriting. [concrete-tug] The euler

package is based on Knuth's macros for the b o ok Concrete Mathematics .

The text fonts for the Concrete b o ok are provided by the b eton package.

A

everysel latex3 L T X package which provides ho oks into \selectfont.

E

everyshi latex3 Ho oks for taking action at every \shipout

exam latex3 Package for typ esetting exam scripts.

exams latex3 Exam questions can b e multiple choice or free form long/short answer

questions. Options include the typ esetting of the exam itself, an exam

showing all the answers and a collection of questions and answers.

Questions can b e parametrized. Use of a random generator provides for

automatic shu ing of multiple choice items.

exp dlist latex3 Expanded description environments

A

exp ort latex3 This package allows the user to exp ort/imp ort the values of L T X

E

registers counters, rigid and rubb er lengths only. It is denitely NOT for

faint-hearted users.

A

fancyhdr latex3 Supp ort for sophisticated control of page headers and fo oters in L T X2 .

"

E

It sup ersedes fancyheadings.

A

fancyheadings latex2 Better control over page headers and fo oters in L T X. This is an

E

A A

up-to-date version for L T X. For L T X2 it is now called fancyhdr.

"

E E

fancyvrb latex2 Sophisticated handling of verbatim text, to write it out, read it in, and

typ eset it

fax latex3 Do cument class for preparing faxes.

fc fonts3 Fonts for African languages, complementary to Computer Mo dern.

feynmf graphics3 Macros and fonts for creating Feynman and other diagrams.

oat latex2 Improves the interface for dening oating ob jects such as gures and

tables. Intro duces the b oxed oat and the ruled oat. You can dene your

own oats and improve the b ehaviour of the old ones. Also incorp orates

the H option of the sup erseded here package. You can select this as

automatic default with \floatplacement{figure}{H}.

oatg latex3 Allows text to b e wrapp ed around gures.

TUGb oat, Volume 18 1997, No. 2 105

Catalogue of Packages continued

Package Col lection Description

oatt latex3 Float text around gures and tables which do not span the full width of

a page. This is an improved version of oatg. It is more or less similar

to oatingtable. The tables/gures can b e set left/right or alternating

on even/o dd pages. Works with the multicol package. Do esn't work well

A

in the neighb ourho o d of list environments unless you change your L T X

E

do cument.

fncychap latex3 This package provides six predened chapter headings. Each can b e

mo died using a set of simple commands. Optionally one can mo dify the

formatting routines in order to create additional chapter headings. This

package was previously known as FancyChapter.

A

foiltex latex3 ALT X2 class for overhead transparencies. Can b e used with fancyb ox

"

E

to place a variety of b orders around the slides.

fontinst latex3 T X macros for converting Adob e Font Metric les to T X metric and

E E

virtual font format

fontmisc fonts1 Miscellaneous METAFONT input les

fontname texlive1 Karl Berry's scheme for naming fonts in T X

E

A

fonts latex1 Extra line and circle fonts for L T X

E

fo otnote latex3 More sophisticated fo otnotes.

fo otnpag latex3 Allows fo otnotes on individual pages to b e numb ered from 1, rather than

b eing numb ered sequentially through the do cument.

formats texlive2 Prebuilt T X format and METAFONT base les

E

fp latex3 Provides an extensive collection of arithmetic op erations for xed p oint

real numb ers of high precision.

french lang2 Style for Frenchtyp ography

A

fribrief latex3 ALT X class for writing letters.

E

A

fundus latex3 Providing L T X access to various font families.

E

futhark fonts3 Fonts for the Older Futhark script

A

g-brief latex3 A do cument class for L T X2 . Serves for formatting formless letters in

"

E

german or english language.

gb4e latex3 Government Binding styles.

general do c1 Useful general do cumentation.

genmisc generic3 Miscellaneous small les for all formats, sp ecic to the T X Live

E

CD-ROM.

A

geometry latex3 A package which allows L T X2 users to customise page layout

"

E

page sizes using an easy and exible user interface. You can sp ecify

\geometry{body={6.5in,8.75in} , top=1.2in, left=2cm, nohead}. This

is an up date of the now sup erseded pagesize package.

german latex2 Style for German typ ography.

germbib bibtex2 German variants of standard BibT Xstyles.

E

go fonts3 Fonts and macros for typ esetting go games.

gothic fonts3 Gothic and ornamental initial fonts byYannis Haralamb ous.

A

graphics latex2 The primary L T X package for the supp ort of the inclusion of graphics

E

generally pro duced with other to ols. This package aims to givea

consistentinterface to including the le typ es that are understo o d byyour

printer driver.

gray fonts3 Fonts for gray scales

hands fonts3 Pointing hand fonts

harp o on latex3 Extra harp o ons, using the graphics package

harvard bibtex2 The Harvard bibliographystyle family.

harvmac plain3 Paul Ginsparg's Harvard macros for scientic articles

hh latex3 Fancy b oxing eects

A

histogr latex3 Drawing histograms with the L T X picture environment.

E

hppa1.1-hpux10.20 systems1 System binaries HP running hpux10.20.

hppa1.1-hpux9.05 systems1 System binaries HP running hpux9.05.

html do c2 Various T X do cumentation converted to HTML E

106 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

A

hyp er latex3 Redenes L T X cross-referencing commands to insert \special

E

commands for Hyp erTeX dvi viewers

A

hyp erref latex3 Redenes L T X cross-referencing commands to insert \special

E

commands for Hyp erTeX dvi viewers, or translation to Acrobat.

hyphen lang1 Collection of hyphenation patterns.

i386-linux systems1 System binaries for Intel machines running Linux.

i586-freebsd2.2 systems1 System binaries for Intel PC running FreeBSD 2.2.

i686-linux systems1 System binaries for Intel Pentium Pro running Linux.

ieeep es latex3 Allows typ esetting of transactions, as well as discussions and closures, for

the IEEE Power Engineering So cietyTransactions journals.

ifacmtg latex3 Elsevier Science preprintstyle for IFAC meetings.

indxcite latex3 A package to automatically generate an Author Index based on citations

made using BibT X. It requires the use of the harvard and index packages

E

A

and L T X2 .

"

E

info do c2 Do cumentation in GNU info form

inputenc latex3 Controlling inp out enco ding

ipa latex3 Style for using International Phonetic Alphab et fonts

isostds latex3 Class and package les for typ esetting ISO International Standard

do cuments. Several standard do cuments have b een printed by ISO from

A

camera-ready copy prepared using L T X and these les. One set of les is

E

for generic ISO typ esetting and the other is an extension set of packages

for typ esetting ISO 10303 standards.

A

jadetex latex3 Macro package on top of L T Xtotyp eset T X output of Jade DSSSL

E E

implementation.

jknapp en latex2 Miscellaneous macros, mostly for making use of extra fonts, by Jörg

Knapp en.

jsmisc plain3 Miscellaneous useful macros by Joachim Schro d.

jura latex3 A do cument class for German law students.

knuth do c3 Knuth's own do cumentation, including the T Xb o ok and the

E

METAFONT book

koma-script latex3 A replacement for the article/rep ort/b o ok classes with emphasis on

Europ ean rules of typ ography and pap er formats as laid down by Jan

Tschichold.

kuvio graphics3 Drawing macros and fonts for diagrams.

lab els latex3 Supp ort for printing sheets of sticky lab els but could also b e used for

business cards. The number of rows and columns of lab els, and their size,

can b e changed.

A

lamstex formats3 A merge of the b est in AMST X and L T X

E E

A

lastpage latex3 Reference the numb er of pages in your L T X do cument as in a page

E

fo oter that says: Page N of M.

lgreek latex3 Macros for using Silvio Levy's Greek fonts

lineno latex3 Adds line numb ers to selected paragraphs with reference p ossible through

A

the L T X \ref and \pageref cross reference mechanism. Version 2.00

E

supp orts numb ering of one in ve lines and switching the line numb ers

from the left to the right side of the page in twoside mo de.

listings latex3 Package for pretty-printed program listings, with supp ort for a range of

languages.

lo callo c latex3 Macros for lo calizing T X register allo cations

E

logic fonts3 METAFONT font for drawing logic diagrams.

lollip op formats3 A new generation format

A

lshort latex1 Short intro duction to L T X.

E

ltablex latex3 Mo dies the tabularx environment to combine the features of the tabularx

package auto-sized columns in a xed width table with those of the

longtable package multi-page tables.

A

ltxdo c latex1 Class for do cumented L T X2 classes.

"

E

A

ltxmisc latex2 Miscellaneous L T Xstyles. E

TUGb oat, Volume 18 1997, No. 2 107

Catalogue of Packages continued

Package Col lection Description

A

lw35ps fonts2 Font metrics and L T X font description les for standard 35 PostScript

E

fonts.

A

ly1 latex3 Supp ort for LY1 L T X enco ding, i.e. the Y&Y texnansi enco ding.

E

mab-nextstep3 systems1 System binaries for Next b oxes running NextStep 3.

mailing latex3 Macros for mail merging

makeindex texlive1 Do cumentation for the MakeIndex program.

malvern fonts3 A new sans-serif font family

map co des latex3 Supp ort for multiple character sets and enco dings.

maple latex3 Styles and examples for the MAPLE newsletter.

mathcomp latex2 A package which provides access to some interesting characters of the Text

Companion fonts TS1 enco ding in math mo de.

mcite latex3 Supp ort for collapsing multiple citations into one, as customary in physics

journals

mdwto ols latex3 Miscellaneous to ols by Mark Wo o ding, including supp ort for @, a doafter

command, fo otnotes, mathenv for various alignment in maths, list

A

handling, trivial maths o ddments, rewrite of L T X's tabular and array

E

environments, verbatim handling, and syntax diagrams.

m latex3 A package to provide something similar to `multiple master' fonts, but

using METAFONT ;you sp ecify a fontby a set of METAFONT parameters,

and T X makes up a .mf le to generate the required font; this package is

E

not integrated with NFSS or MakeTeXTFM yet fun.

A

mogo latex1 L T X package and font denition le to access the Knuthian `logo' fonts

E

describ ed in `The METAFONT b o ok' and the METAFONT and MetaPost

A

logos in L T X do cuments.

E

mfmisc fonts1 Small supp ort les for METAFONT .

mfnfss latex3 Font description les for extra fonts like yinit and ygoth

mfpic graphics3 Macros which generate METAFONT co de for drawing pictures.

mfto eps fonts3 a METAFONT package for generating encapsulated PostScript

les readable by CorelDRAW!, Adob e Illustrator and Fontographer.

METAFONT writes PostScript co de to a LOG-le, and from the LOG-le

the co de can b e extracted by either T XorAWK. DOS batch les, T X

E E

source, and AWK source are placed in the sub directory PROGS.

midnight generic3 A set of useful macro to ols

minito c latex3 Table of contents p er chapter.

mips-irix4.0.5 systems1 System binaries for SGI b ox running Irix 4.0.5.

mips-irix5.3 systems1 System binaries for SGI b ox running Irix 5.3.

mips-irix6.3 systems1 System binaries for SGI b ox running Irix 6.3.

mips-ultrix4.4 systems1 System binaries for MIPS machine running Ultrix 4.4.

A

misc latex3 Miscellaneous small macro les for L T X.

E

A

misc209 latex2 Miscellaneous small macro les for L T X2.09.

E

mnras plain3 Styles for the Monthly Notices of the Royal Astronomical So ciety.

A

monster latex3 Towards a more rational and mo dular L T X, by Matt Swift; a set of

E

powerful to ols

moreverb latex3 Averbatim mo de that can handle TABs prop erly, can numb er lines, can

numb er lines in an included le, can pro duce b oxed verbatims, etc.

mpbase metap ost1 Basic MetaPost supp ort les.

mpfnmark latex3 A package which provides the command \mpfootnotemark, which can b e

used in the same wayas\footnotemark. The dierence b etween these two

macros is that within minipage environments the latter uses the standard

fo otnote marker style dened by \thefootnote, while the new command

uses the minipage fo otnote marker style dened by \thempfootnote.

A

mslapa latex3 L T X and BibT Xstyle les for a resp ectably close approximation to

E E

APA American Psychological Asso ciation citation and reference style.

mtb e plain3 Examples from Mathematical T X by Example by Arvind Borde

E

musictex generic3 Typ esetting music with T X.

E

musixtex generic3 Extended MusicTeX, with b etter slurs

108 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

myletter latex3 Another letter package.

nassow latex3 Drawing Nassi-Schneidermann diagrams.

natbib bibtex2 A bibliographystyle that handles author-year and numb ered references.

newalg latex3 Format algorithms like Cormen, Leiserson and Rivest.

newsletr plain3 Macros for making newsletters

newthm latex3 A mo died version of the theorem-style which provides generation of lists

of theorems.

niceframe latex3 Supp ort for fancy framing of pages

nomencl latex3 Nomenclature package for pro ducing lists of symb ols using the capabilities

of the MakeIndex program.

A

ntgclass latex2 Versions of the standard L T X article and rep ort classes, rewritten to

E

reect a more Europ ean design, by the DutchT X Users Group

E

numline latex3 Macros for numb ering lines.

ob jectz latex3 Macros for typ esetting Ob ject Z

oca fonts3 OCR font

o cr-a fonts3 Fonts for OCR-A

o cr-b fonts3 Fonts for OCR-A

ogham fonts3 Fonts for typ esetting Ogham script

ogonek latex3 Supp ort for Polish typ ography and the ogonek

oldstyle latex3 Font information needed to load the cmmi and cmmib fonts for use to

pro duce oldstyle numb ers

osmanian fonts3 Osmanian fonts by Alan Stanier for writing Somali

ot2cyr fonts2 Macros to use to the OT2 Cyrillic enco ding

overword latex3 This package provides two macros which can b e used as building blo cks

for the parsing of text. For an example of their use, see the calendar

package.

pandora fonts3 The Pandora font family

pap er latex3 A class derived from article, tuned for pro ducing pap ers for journals.

Intro duces new layout options and font commands for sections/parts.

Denes a new keywords environment, and subtitle and institution

commands for the title section. New commands for revisions. And more.

parallel latex3 Provides a parallel environment which allows two columns of text to b e

typ eset. Useful for typ esetting two languages side-by-side.

patch latex3 Macros for package management.

pb-diagram latex3 Diagram package, using LAMST X fonts, byPaul Burchard.

E

p dcmac plain3 Damian Cugley's macro to ols.

pdf do c2 Do cumentation in PDF format.

p dftex plain2 Macro packages for variantT X which writes PDF format.

E

phonetic fonts3 METAFONT Phonetic fonts, based on Computer Mo dern

physe formats3 PHYSE format

phyzzx formats3 AT X format for physicists

E

picinpar latex3 Insert pictures into paragraphs. NOTE: Piet van Oostrum do es not

recommend this package. Picins is recommended instead.

A

pictex graphics2 Picture drawing macros for L T X.

E

pi latex3 Macro to ols by Mike Pi

plainmisc plain1 Miscellaneous useful macros for plain T X

E

plaintex plain1 Basic Plain T X macros

E

plfonts fonts3 Computer Mo dern variant fonts for Polish

A

plgraph generic3 L T X graphics package with wrapp er to allow it to b e used with generic

E

plain T X

E

A

pmgraph latex3 A set of extensions to L T X picture environment, including a wider range

E

of vectors, and a lot more b ox frame styles.

p oligraf generic3 Page preparation for prepress, color separation, crop-marks, color and gray

scale bars, b o oklet preparation, etc.

prelim2e latex3 Allows the marking of preliminary versions of a do cument

TUGb oat, Volume 18 1997, No. 2 109

Catalogue of Packages continued

Package Col lection Description

A

prettyref latex3 Additional functionalitytoLT X2 lab elreference mechanism. It allows

"

E

the author to preformat all typ es of lab els.

progkeys latex3 The le `programs.sty' is intended to allow a parameterized wayof

A

typ esetting programs with T X/L T X commands inside. The le

E E

`keywords.sty' allows use and dene sets of keywords that will b e typ eset

with dierent fonts, according to the wish of the user.

program latex3 Typ esetting programs and algorithms

pro ofs latex3 Macros for building pro of trees.

A

psfonts fonts2 PostScript fonts for use with T X and L T X.

E E

A

psfrag graphics2 A set of macros and a PostScript header which allows L T X constructions

E

equations, picture environments, etc. to b e precisely sup erimp osed

over Encapsulated PostScript gures. The user can use his/her favorite

drawing to ol to create an EPS gure, placing simple text tags where

each replacement is to b e placed. PSfrag will automatically remove those

A

tags from the gure and replace them with the L T X construction that

E

the user sp ecies, prop erly aligned, scaled, and/or rotated.

psizzl formats3 AT X format from SLAC

E

A

pslatex latex2 A small package that makes L T X default to `standard' PostScript fonts.

E

It is basically a merger of the times and mathptm styles from the psnfss

A

suite of packages. You must have installed standard L T X and PSNFSS

E

PostScript fonts to use this package. The main novel feature is that the

pslatex package tries to comp ensate for the visual dierences b etween the

Adob e fonts by scaling Helvetica by 90, and `condensing' Courier i.e.

scaling horizontally by 85. The package is supplied with a unix shell

A

le for a `pslatex' command that allows standard L T X do cuments to b e

E

pro cessed, without needing to edit the le.

psnfss fonts2 Font denition les, macros and font metrics for common PostScript fonts

psnfssx latex3 Extra styles and enco dings for PS fonts, including Y&Y enco ding supp ort.

A

pspicture latex2 Replacement for core L T X picture macros to use PostScript \special

E

commands

pstricks graphics2 An extensive collection of PostScript macros that is compatible with

A

most T X macro packages, including Plain T X, L T X, AMS-T X, and

E E E E

A

AMS-L T X. Included are macros for color, graphics, pie charts, rotation,

E

trees and overlays. It has many sp ecial features, including: a wide variety

of graphics picture drawing macros, with a exible interface and with

color supp ort. There are macros for coloring or shading the cells of tables.

punk fonts3 Donald Knuth's punk font

A

qobitree graphics3 L T X macros for typ esetting trees

E

qsymb ols latex3 For dening systematic mnemonic abbreviations, starting with ` for math

symb ols and \" for arrows, from the amssymb and stmaryrd packages

A

ragged2e latex3 L T X package which denes new commands \Centering, \RaggedLeft,

E

and \RaggedRight and new environments Center, FlushLeft, and

FlushRight, which set ragged text and are easily congurable to allow

hyphenation.

A

rcs latex3 Use RCS revision control system tags in L T X do cuments.

E

realcalc plain3 Macros for real arithmetic calculations.

refman latex3 Variant rep ort and article styles

revtex latex2 Styles for American Physical So ciety, American Institute of Physics, and

Optical So ciety of America. Only works in compatibility mo de under

A

L T X2 .

"

E

rlepsf generic3 A macro package for use with epsf.tex which allows PostScript lab els in an

eps le to b e replaced byT X lab els.

E

A

rotating latex2 A package built on the standard L T X graphics package to p erform all the

E

dierent sorts of rotation one might like, including complete gures and

tables and captions.

rotoat latex3 Rotate oats.

110 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

rplain latex3 Redenes the `plain' pagestyle. The page numb ers are now in the lower

right corner.

rs6000-aix3.2.5 systems1 System binaries for RS6000 running AIX 3.2.5.

rs6000-aix4.1.1 systems1 System binaries for RS6000 running AIX 4.1.1.

sauter fonts3 Extensions to the CM fonts, providing a parameterization scheme to build

fonts at true design sizes

p

scale latex3 A package to scale a do cumentby 2. This is useful if you are preparing

a do cument on e.g. A5 pap er and want to print on A4 pap er to achievea

b etter resolution.

script latex3 Variant rep ort / b o ok styles

semantic latex3 Eases the typ esetting of notation of semantics and compilers. Includes

T-diagrams, various derivation symb ols and inference threes.

seminar latex2 Pro duce overhead slides transparencies with b ells and whistles.

setspace latex3 Provides commands and environments for doing double and one-and-a-half

line spacing based on pt size. If a dierent spacing is required then the

\setstretch{baselinestretch} command is supp orted. The spacing

environment takes one argument which is the baselinestretch to use, e.g.,

\begin{spacing}{2.5}.

shadb ox latex3 A to ol to shade the background of anybox  text, gure, table etc. 

A

using Plain L T X.

E

shadethm latex3 Package that allows declarations of the form

\newshadetheorem{thm}{Theorem } or \newshadetheorem{}[]{} or

\newshadetheorem{}{}[] to pro duce shaded b oxes from the usual

command \begin{theorem} ...\end{theorem}. The color package is

required.

showlab els latex3 Show lab el commands in the margin.

siam generic3 Styles for SIAM publications

siggraph latex3 Do cument class for formatting pap ers according to the sp ecications for

submission to the annual ACM Siggraph conference

slidenotes latex3 A class package for the easy pro duction of a slide collection with

annotations. Builds on the rep ort style or variants.

smallcap latex3 Supp ort for all 4 shap es of Small caps in DC1.3 where SC b ecomes a

family, rather than a shap e \scshape is replaced by \scfamily. Thus

you can write \bf\scfamily\slshape to get small caps b old slanted.

songb o ok latex3 Package for typ esetting song lyrics.

sparc-linux systems1 System binaries for Sparc running Linux.

sparc-solaris2.4 systems1 System binaries for Sparc running Solaris 2.4.

sparc-solaris2.5 systems1 System binaries for Sun Sparc running Solaris 2.5.

sparc-sunos4.1.3 systems1 System binaries for Sparc running SunOS 4.1.3.

sprite graphics3 Macros to set bitmaps with T X

E

A

ssqquote latex3 L T X package and font denition le to access the `cmssq' fonts, i.e.

E

A

Computer Mo dern Sans Serif Quotation Style. The L T X package also

E

denes a chapterquotes environment as an example application.

startex formats3 AT X format designed to help students write short rep orts and essays.

E

It provides the user with a suitable set of commands for such a task. It is

A

also more robust than plain T X and L T X.

E E

stmaryrd fonts2 St Mary Road symb ols for functional programming.

sub eqn latex3 Package for sub equation numb ering.

sub eqnarray latex3 Equation array with sub numb ering.

subgure latex3 Figures divided into subgures.

sup ertabular latex3 Amulti-page tables package.

swift latex3 Miscellaneous macros by Matt Swift.

tap plain3 An advanced table package.

taylor graphics3 Diagram macros byPaul Taylor.

tb e plain3 Examples from Arvind Borde's T X by Example

E

tengwar fonts3 Font for typ esetting Tolkien Tengwar script, by Michael Urban

TUGb oat, Volume 18 1997, No. 2 111

Catalogue of Packages continued

Package Col lection Description

tex-ps generic3 Various extra supp ort le for dvips.

texdraw graphics3 Graphical macros, using emb edded PostScript.

texip formats3 Macros from T XinPractice

E

texlive texlive1 Basic material for T X Live.

E

text1 formats3 T X format from the UniversityofWashington

E

textcomp latex3 Supp orts the Text Companion fonts which provide many text symb ols

such as baht, bullet, copyright, musicalnote, onequarter, section, and yen

in the TS1 enco ding.

textt latex3 Package to supp ort tting of text to a given width or heightby scaling the

font

A

textmerg latex3 Merge text in T X and L T X. Useful, for example, in mail merge.

E E

thesis latex3 A class for pro ducing a thesis based on the rep ort class for a more

Europ ean and more exible lo ok. Supp orts options like noindent,

noitemization, headline, no center, crosshair, and chapterbib.

timesht latex3 Package for typ esetting time sheets.

tipa fonts3 Fonts and macros for IPA phonetics characters.

A

to ols latex2 Standard L T X2 to ols, for extended tabular, verbatim and theorem

"

E

supp ort

tracking latex3 Automatically adjust spaces b etween symb ols in words or phrases to t

them into a sp ecied length. Anychain of symb ols including spaces in

the current fontmay b e treated.

treesvr latex3 Tree macros.

treetex plain3 Allows the automatic layout of n-ary trees with arbitrary no de sizes in

A

L T X, using an external C program to do much of the hard work.

E

A

tugb oat generic2 Macros for TUGb oat articles plain and L T X.

E

typ e1cm latex3 A package that removes the restriction when using scalable versions of

the cm fonts Typ e1 Bakoma, or versions from BSR/Y&Y, or True Typ e

A

versions from Kinch, PCTeX etc. where L T X restricts the cm fonts to

E

discrete sizes.

A

typ ehtml latex3 Typ eset HTML i.e., World Wide Web do cuments directly from L T X.

E

Can handle almost all of HTML2, and most of the math fragment of the

draft HTML3.

A

uaclasses latex3 This package provides a L T X2 do cument class named `ua-thesis' for

"

E

typ esetting theses and dissertations in the ocial format required by the

University of Arizona. Moreover, there is a fully compatible alternative

do cument class `my-thesis' for private nice copies of the dissertation, and

the resp ective title pages are available as separate packages to work with

any do cument class.

A

ucthesis latex3 A mo died version of the standard L T X REPORTstyle that is accepted

E

for use with University of California PhD dissertations and Masters theses.

ulsy latex3 Extra mathematical characters

umlaute latex3 An interface to inputenc for using alternate input enco dings

umrand fonts3 Package for page frames.

underlin latex3 Package for underlining. Be advised that underlining is considered bad

A

style in typ esetting. See also ulem which is a sp ecic package for L T X.

E

A

useful do c2 Useful do cumentation; various L T X guides, FAQ, fontname do cs, etc.

E

utthesis latex3 Pro duces a thesis that meets the requirements of the Graduate Scho ol of

The UniversityofTexas at Austin :-

uwthesis latex3 UniversityofWashington thesis

vdm latex3 Typ esetting VDM schemas

A

vector latex3 Macros for more convenient representation of vectors in L T X2 , b oth

"

E

symb olically and as implicit or explicit rows/columns of elements

vertex plain3 Styles for economics working pap ers and journals

vita latex3 This class provides necessary macros to prepare your Curriculum Vitae or

Resume.

vrb latex3 Verbatim macros via plain T X E

112 TUGb oat, Volume 18 1997, No. 2

Catalogue of Packages continued

Package Col lection Description

vrsion latex3 Denes a command which pro duces a version numb er in the .dvi-le when

A

L T X is run.

E

wasy fonts3 The wasy fonts Waldis symb ol fonts

wasysym latex2 Makes some additional characters available that come from the wasy fonts

Waldis symb ol fonts. These fonts are not automatically included in

A

NFSS2/L T X2 since they take up imp ortant space and aren't necessary

"

E

if one makes use of the packages amsfonts or amssymb. Symb ols include:

join, b ox, diamond, leadsto, sqsubset, lhd, rhd, apprle, o circle, invneg,

logof, varint, male, female, phone, clo ck, lightning, p ointer, sun, b ell,

p ermil, smiley,various electrical symb ols, shap es, music notes, circles,

signs, astronomy, etc.

williams latex3 Miscellaneous macros byPeter Williams.

win32 systems1 System binaries for Windows 32.

wnri fonts3 METAFONT fonts for Old English, Indic languages in transcription, and

American Indian languages.

wsuipa fonts2 Washington State UniversityIPA phonetic fonts

xymtex latex3 Typ esetting chemical structures.

xypic graphics2 Sophisticated macros and fonts, originally designed for commutative

diagrams, but with general applicability.

A

yhmath latex3 Extended maths fonts for L T X.

E

youngtab latex3 A package for typ esetting Young-Tableaux mathematical symb ols for

the representations of groups, providing two macros, \yng1 and

\young1 to generate the whole Young-Tableaux.

ytex formats3 Macro package develop ed at MIT.

zed-csp latex3 Typ esetting Z and CSP format sp ecications

 Sebastian Rahtz

7 Strateld Road

Oxford OX2 7BG

UK

[email protected]

 Michel Go ossens

CERN

CH-211 Geneva23

Switzerland [email protected]