Download Guide for pdflatex

The pdfTEX user manual
Contents
1
2
3
4
5
6
7
8
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1
About PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Getting started . . . . . . . . . . . . . . . . . . . . . . . 3
Macro packages supporting PDFTEX . . . . 9
Setting up fonts . . . . . . . . . . . . . . . . . . . . . . 10
Formal syntax specification . . . . . . . . . . . 14
PDFTEX primitives . . . . . . . . . . . . . . . . . . . 18
Graphics and color . . . . . . . . . . . . . . . . . . . 36
9
10
Character translation . . . . . . . . . . . . . . . . . 37
Limitations of PDFTEX . . . . . . . . . . . . . . . . 38
Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . .
Examples of HZ and protruding . . . . . . . . . . .
Additional PDF keys . . . . . . . . . . . . . . . . . . . . .
Colophon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
GNU Free Documentation License . . . . . . . . .
38
39
41
41
42
1 Introduction
The main purpose of the pdfTEX project is to create and maintain an extension of TEX that can produce
pdf directly from TEX source files and improve/enhance the result of TEX typesetting with the help of pdf.
When pdf output is not selected, pdfTEX produces normal dvi output, otherwise it generates pdf output that
looks identical to the dvi output. An important aspect of this project is to investigate alternative justification
algorithms (e. g. a font expansion algorithm akin to the hz micro--typography algorithm by Prof. Hermann
Zapf), optionally making use of multiple master fonts.
pdfTEX is based on the original TEX sources and Web2c, and has been successfully compiled on Unix, Win32
and MSDos systems. It is under active development, with new features trickling in. Great care is taken to
keep new pdfTEX versions backward compatible with earlier ones.
For some years there has been a ‘moderate’ successor to TEX available, called ε-TEX. Because mainstream
macro packages such as LATEX have started supporting this welcome extension, pdfTEX also is available as
pdfeTEX. Although in this document we will speak of pdfTEX, we advise users to use pdfeTEX when available.
That way they get the best of all worlds and are ready for the future. Starting with TEX Live 2004, that future
has arrived: pdfeTEX is now the primary TEX engine.
Other extensions to pdfTEX are MLTEX and encTEX; recent pdfTEX engines have these often included.
pdfTEX is maintained by Hàn Thế Thành, Martin Schröder, Hans Hagen, Hartmut Henkel, and others.
The pdfTEX homepage is http://www.pdftex.org. Please send pdfTEX comments and bug reports to the
mailing list [email protected].
We thank all readers who send us corrections and suggestions. We also wish to express the hope that pdfTEX
will be of as much use to you as it is to us. Since pdfTEX is still being improved and extended, we suggest
you to keep track of updates.
1.1
About this manual
This manual revision (1.622) tries to keep track with the recent pdfTEX development up to version 1.30.4.
Main text updates were done regarding the new configuration scheme, font mapping, and new or updated
primitives. The primary repository for the manual and its sources is at http://sarovar.org/projects
/pdftex/. Copies in pdf format can also be found at the CTAN network in directory ctan:systems
/pdftex.
Thanks to Karl Berry for proof reading and submitting a long changes list. New errors might have slipped in
afterwards by the editor. Please send questions or suggestions by email to [email protected].
1