Your support for our advertisers helps cover the cost of hosting, research, and maintenance of this document

## Welcome to Formatting Information

This is the online version of Formatting Information, a book about how to use the LATEX document preparation system. LATEX takes over where wordprocessors and desktop publishing systems leave off, making it possible to automate your formatting consistently, accurately, and reusably, without the tedious and repetitive manual formatting required by other systems.

This book is now at version 7.41 (2016) and has helped thousands of users get started. The only things you need are a computer and a copy of LATEX (free or commercial)...and a document that you want to typeset. LATEX works on almost any computer, and you can download it from the TUG web site, install it from the TUG DVD, or buy one of the excellent commercial versions.

In the web and eBook editions, this page doubles as the index, but in the print (PDF) edition, the index is at the end. If you haven’t done any typesetting before, I recommend that you start at the beginning. If you’re itching to get started, and you feel you know enough about computers and text-editing already, you can try the Quick Start instead.

Either way, welcome to LATEX. Take it gently for a while, and get used to being able to spend more time actually writing than formatting. If you find mistakes, please let me know so that I can correct them.

Some font conventions are used in the text and the index to distinguish between different meanings. These are listed in § 7. The entries in the index are all hyperlinked to their source. In the web and eBook editions, subsequent multiple occurrences give the section number or name. Page or section numbers in bold type indicate the location where the entry is explained.

### Index

\"e  1.7

\'\i{}  1.7

\'e  1.7

\-  1.8

#### .

.h1 Interest Rates  Home

\.m  1.7

10pt  2.1

11pt  2.1

12pt  2.1

#### :

:h1.Interest Rates  Home

\=o  1.7

#### @

\@author  7.2, 7.2

\@date  7.2, 7.2

\@maketitle  7.2

\@title  7.2, 7.2

#### A

a4paper  2.1, 2.1

\aa  1.7

\AA  1.7

AAP  Home

abstract  2.4, 2.4

\abstractname  2.4

abstracts  2.4

accents  1.7

\ae  1.7

\AE  1.7

\affiliation  2.3

American Mathematical Society (AMS)  6.2

American National Standards Institute (ANSI)  E

American Political Science Review (APSR)  5.3

American Standard Code for Information Interchange (see ASCII)  E

ampersand  1.5

Apple Mac  A, A, A.1

\arabic  7.6

arguments  1.3

\arraybackslash  4.2

\arraystretch  4.2

ASCII  Intro.2, 1.7, 1.9, 4.4, 4.7, 8.1, B, C.3, E

\author  2.3, 2.3, 5.1, 7.2

#### B

b  4.6

\b o  1.7

backslash  1.3

baselineskip  6.1

beer  5.4, 5.4

\begin  2.2

\begin{...}  2.2

\begin{abstract}  2.4

\begin{document}  1.7, 2.2, 2.4, 7.2, 8.1

\begin{itemize}[nosep]  4.1

\begin{minipage}  4.6

\begin{tabular}  4.2, 4.6

Berry, Karl  B.2

Berry, Karl  A

Berry, Karl  B.2

\bfseries  1.3, 6.2, Home

bibliographies  5.3

\bibliography  5.3

\bibliographystyle  5.3

bibstyle  5.3

\bigskip  6.1

binary  1

BMP  4.4

boxes  4.6

bp (big points)  1.8

Budyta, Małgorzata  6

#### C

\c c  1.7

\c C  1.7

CALS  4.2

\caption  4.2, 4.3, 5.3

Cascading Style Sheets (see CSS)  8.2

cc (Ciceros)  1.8

cd  C.1

CD-ROM  Home, 8

center  1.8, 4.2, 4.2, 6.2

\centering  1.8, 4.2, 4.2, 6.2

\chapter  2.6, 2.6, 7.6

characters  1.5, 1.7, 1.9, E

Chassell, Bob  Preface

Chikrii, Kirill A  8.2

Chocolate Stout  5.4

\cite  5.3, 5.3, 5.3

\citep  5.3

citestyle  5.3

\citet  5.3

class  3.1

classes  3.1

\clearpage  Home

CLI  Preface, Intro.3

\cline  4.2

CM  Home, B.2

cm (centimeters)  1.8

CMYK  6.2

\color  6.2

\colorbox  6.2

\colorbox{midblue}{\color{magenta}magenta on midblue}  6.2

colour  6.2

columns  5.5

columnsep  5.5

\command  Home

Command-Line Interface (see CLI)  Intro.1

commands  1.3

comment character  1.5

commercial distributions  Intro.5

Common Gateway Interface (CGI)  Intro.1

commutative  6.2

Comprehensive TEX Archive Network (see CTAN)  3

Computer Modern (see CM)  6.2

Con TEXt  Preface

counter  Home

cross-references  5.3

CSS  6.2

CTAN  Foreword, Preface, Intro.4, Intro.5, Intro.6, Home, 2.1, 2.1, 3, 3, 3.1, 3.1, 3.1, 3.2, 3.3, 4.4, 5.4, 6.2, 8.1, 8.2, A, A, A.2, A.4, B.1, C.4, D.2

CUPS  6.2

curly braces  1.3

Cyan-Magenta-Yellow-Black (see CMYK)  6.2

#### D

\d s  1.7

\date  2.3, 2.3, 7.2, C.2, C.2

\datesubmitted  2.3

dd (Didot points)  1.8

DEB  Home

\DeclareFontFamily  B.2

\DeclareFontShape  B.2

\def  7.4, 7.4

\definecolor  6.2

description  4.1

desktop publishing (see DTP)  Preface

device-independent (see DVI)  C.1

Digital Equipment Corporation (DEC)  Preface

Digital Restrictions Management (DRM)  1

dimension  2.7

dimensions  1.8

DOC TEX  3.2

document  Intro.4, 1.7, 2.2, 2.3

document class  2.1

Document Style Semantics and Specification Language (DSSSL)  8.3

\documentclass  1.7, 2.1, 2.4, 3.1, 6.2

\documentclass{article}  8.1

Dorner, Fernando  8.2

dots per inch (see dpi)  Intro.1

double-spacing  6.1

dpi  Intro.4

draft  2.1

\dtae  C.2

DTP  Preface, 4.2, 6.2

DuBois, Paul  8.1

DVD  Home, 8, Home

DVI  Preface, Preface, 3.1, 4.4, 4.6, 8.2, C.1, C.3, C.3, C.3, C.3

dvips -f testpage | lpr  A.1

dvips -R0 ... dvifile  4.4

dvipsnames  6.2

#### E

ECDL  Intro.2

\EF  7.1

em (relative measure)  1.8

\emph  6.2, 6.2

\emph{  8.1

empty  6.1

Encapsulated PostScript (see EPS)  4.4

\end  2.2

\end{...}  2.2

\end{abstract}  2.4

\end{document}  2.2, 8.1

\end{verbatim}  4.7

\enspace  Home

enumerate  4.1

enumi  Home

enumii  Home

enumiii  Home

enumiv  Home

environment  Home, 2.2, 4.1

EPS  4.4, Home, 4.4, 4.4, 4.4, 4.4

equation  1.9

Error messages  C.2, C.2, C.2, C.2, C.2, C.2, C.2

Esser, Thomas  A

\EUR  1.5, 4.2

Euro  1.5

European Computer Driving Licence (see ECDL)  Intro.1

ex (relative measure)  1.8

example  4.1

Extensible Markup Language (see XML)  8

Extensible Stylesheet Language (see XSL)  8.3

#### F

FAQ  Foreword, 3, 3.3, 3.3

\fbox  4.3, 4.6, 4.6, 6.2

fboxrule  4.6, 6.2

fboxsep  4.6, 6.2

\fbox{some text}  4.6

\fcolorbox  6.2

FD  B.2

Feuerstack, Thomas  A

figure  4.3

figure*  5.5

figures  4.3

filenames  C

Fine, Jonathan  Home

floats  4.2, 4.3

flushleft  4.2, 6.2, 6.2, 7.2

flushright  4.2, 6.2, 6.2

FNDB  3.2

\fnsymbol  5.1

font definition  B.2

font series  6.2

font shape  6.2

\fontencoding  6.2

\fontfamily  6.2, 6.2

fonts  2.1, 6.2, 6.2, 6.2, 6.2, 6.2, B, B.2, B.2

\fontsize  6.2

\footcite  5.3

\footnote  5.1, 5.1

footnotes  5.1

\footnotesize  Home

\footnote{...}  Home

\foreign  6.2, 7.3

\foreignlanguage  1.8

FTP  3

#### G

GIF  Home

glossaries  5.4, 5.4

\glossary  5.4, 5.4

GNU  Intro.8

GNU’s Not Unix (see GNU)  Home

Granzer, Andreas  8.2

Graphical User Interface (see GUI)  C.1

Graphics Interchange Format (see GIF)  4.4

\graphicspath  4.4

Gregorio, Enrico  Home

group  6.2

grouping  6.2

groups  6.2

GUI  8.1

#### H

\H o  1.7

HagenHans  Preface

hash mark  1.5

help  3.3

Hennings, Wilfried  8.2

\hline  4.2

\hrule  7.2

\hspace  6.1

\hspace{1in}  6.1

HTML  Intro.8, Home, 2.1, 2.2, 2.7, 4.2, 4.2, 6.2, 8.1, 8.1, 8.2, 8.2, 8.3

HTML5  Credits, Home

HTTP  3

\huge  Home

\Huge  Home

HyperText Markup Language (see HTML)  8

hyphen  4.7

hyphenation  1.8, 1.8

hyphens  1.8, 1.8

#### I

\i  1.7

IBM  Home

images  4.4

in (inches)  1.8

\includegraphics  4.3, 4.4, 4.4, 4.4, 4.4, 4.4

\includegraphics{myhouse}  4.4

\index  5.4, 7.4

indexes  5.4

\index{beer!lite!American}  5.4

\index{beer!lite}  5.4

\index{beer}  5.4

\index{Microbrew|see{beer}}  5.4

\index{Oregon Brewing Company@Rogue}  5.4

inline  4.1

Inline lists  4.1

inparaenum  4.1

Installation  A

ISP  3

\item  4.1

itemize  4.1

\itshape  Home

#### J

Joint Photographic Experts Group (see JPG)  4.4

JPG  4.4, 4.4, 4.4

Jørgensen, Palle  6

Jørgensen, Palle  6.2

#### K

Kastrup, David  Home

Kay, Michael  Intro.1

Kew, Jonathan  Preface

Knuth, Donald  Preface

Knuth, Donald  Preface, D

Knuth, Donald  7.4

kpsewhich  6

#### L

\l  1.7

\L  1.7

\label  4.1, 4.2, 4.3, 5.3, 5.3, 5.3

\labelitemi  7.6

\labelitemiv  7.6

Lamport, Leslie  Preface

Lamport, Leslie  7.4

\Large  1.3, Home, 6.2

\large  Home

\LARGE  Home

latex  Intro.3, 3.2, C.1

\LaTeX  8.1

latex testpage  A.1

\leftmark  6.1

length  Home, 2.7

letterpaper  2.1, 2.1

letterspacing  Home

\linebreak  7.3

Linux  A

\listoffigures  Home, 2.8

\listoftables  Home, 2.8

lists  4.1, 4.1, 4.1, 4.1

Lotz, Manfred  A

\lowerbox  7.6

ls -R  A.5

\lstinline  4.7, 4.7

lstlisting  4.7

#### M

Mac OS X  A

macros  7, 7

\makeatletter  7.2, 7.2

\makeatother  7.2, 7.2, 7.2

\makeglossary  5.4

\makeindex  5.4

\maketitle  2.3, 2.3, 2.4, 2.4, 2.8, 3.1, 6.2, 7.2, 7.2, C.2

Malyshev, Basil K  Home

man makeindex  5.4

marginal notes  5.2

\marginal{Some text}  5.2

margins  6.1

\markboth  6.1

\markright  6.1

markup  1

math characters  1.9

mathematics  Intro.5, 1.9

\mbox  1.8, 7.3

measurements  1.8

\medskip  6.1

metacharacters  1.5

Microbrew  5.4

Microsoft Bitmap (see BMP)  Home

Microsoft Windows  A

minipage  4.6, 4.6, 4.6, 5.1, 7.5

mirror  4.4

mkdir  B.2

mkdir ~/Library/texmf  A.2

mkdir -p fonts/source/public/whatever  B.1

mkdir ~/texmf  A.2

mm (millimeters)  1.8

MS-DOS  4.4

multicols  5.5

\multicolumn  4.2

multiplier  4.2

#### N

New Font Selection Scheme (NFSS)  B

New Typesetting System (NTS)  Preface

\newcommand  7.1, 7.4, 7.4

\newcounter{example}  4.1

\newgeometry  6.1

noitemsep  4.1

normalem  6.2

\normalsize  Home

nosep  4.1

Nowacki, Janusz M  6

#### O

\o  1.7

\O  1.7

octothorpe  1.5

\oe  1.7

\OE  1.7

oneside  2.1

OS X  A

Ota, Takaaki  4.2

\ovalbox  4.6

#### P

\P  5.3

p  B.2

packages  2.1, 3.1, 3.1, 3.1, 3.2, 3.2, 3.2

page size  C.4

\pageref  5.3

\pagestyle  6.1, 6.1

panels  4.6

paper sizes  2.1

\par  4.2, 6.1, 6.2, 6.2, 7.2

\paragraph  2.6, 4.1

\parbox  4.6, 4.6

\parbox[t]{1in}{...}  4.6

\parencite  5.3, 5.3

parindent  2.7, 4.6

parskip  2.7, 2.7, 2.7

\part  2.6

\part*  2.6

pc (picas)  1.8

PC TEX  Home

PDA  Preface, 8

PDF  Preface, Preface, 1.6, 2.1, 3.1, 4.4, 4.4, 4.4, 4.4, 4.6, 4.7, 5.3, 6.1, 6.2, 6, 8.2, 8.3, B.2, C.1, C.1, C.3, C.3, C.3, C.3, C.4

pdflatex  1.2, C.1, C.1

\person  7.4, 7.4

Personal Digital Assistant (see PDA)  Intro.1

personal TEX directory  A.2

personal TEX folder  A.2

\person{Don Knuth}  7.4

\person{Leslie Lamport}  7.4

PFB  B.2

picas  1.8

picture  4.3

plain  6.1

plaintext  1

PNG  4.4, 4.4, 4.4

points  1.8

Portable Document Format (see PDF)  C.3

Portable Network Graphic (see PNG)  4.4

PostScript (PS)  8.2

PostScript Font Binary (see PFB)  B.2

PostScript Font ASCII (PFA)  B.2

Preamble  1.7

preview  C.3

\printbibliography  Home, 5.3, 5.3

Printer Control Language (PCL)  Home

\printglossary  Home

\printindex  Home, 5.4

printing  C, C.4, C.4

\product  6.2, 7.3, 7.3

\protect  5.1

\ProvidesPackage  B.2

pt (points)  1.8

#### Q

quotation  Home, 4.5

quotation marks  1.6

quote  4.5

#### R

\raggedleft  1.8, 1.8, 4.2

\raggedright  1.8, 1.8, 4.2, 4.6

Raggett, Dave  8.1

Rahtz, Sebastian  A

\raisebox  7.6

Red-Green-Blue (see RGB)  6.2

\ref  4.1, 5.3, 5.3, 5.3, 5.3

references  5.3

\ref{normalxref}  Home

\reindex  7.4, 7.4

\renewcommand  2.4, 2.4, 2.7, 4.2, 7.2, 7.6

\renewcommand{\arraystretch{1.5}}  4.2

\RequirePackage  6.2

RGB  6.2

Rich Text Format (see RTF)  8.1

\rightmark  6.1

RIS  5.3, 5.3

\rmdefault  B.2

Rogue  5.4

rotate  4.4

RPM  Home

RTF  8.1, 8.2

#### S

\S  5.3

Sath­yam, Ujwal  8.1

Sbox  4.6, 7.5

Scalable Vector Graphics (SVG)  6.2

scale  4.4

scaled  4.4, 6.2

Schenk, Christian  A

\scriptsize  Home

\scshape  Home

secnumdepth  2.6

section  Home, 2.6, 2.6, 2.7, 6.1, 7.6

section numbering  2.6

sections  2.6

\section{Interest Rates}  Home

\section{Introduction}  7.6

\selectfont  6.2, 6.2

\selectlanguage  1.8

\sentinel  7.4

\setcounter  2.6

\setlength  2.7, 2.7, 4.6, 4.6

\sfdefault  B.2

\sffamily  1.3, Home, 7.2

SGML  Home, 2.1, 8, 8.3

Show Library Folder  A.2

sidebars  4.6

size (fonts)  6.2

\slshape  Home

\small  4.5, Home

\smallskip  6.1

sp (scaled points)  1.8

space  6.1

spaceskip  1.8

special characters  1.5, 1.9

\ss  1.7

Stallman, Richard  Preface

Standard Generalized Markup Language (see SGML)  8.3

Stephani, Philipp  Home

style  5.3

style (fonts)  6.2

\subparagraph  2.6, 4.1

\subparagraph*  2.6

\subsection  2.6

\subsubsection  2.6

sudo texconfig  A.1

summaries  2.4

svgnames  6.2

#### T

t  4.6

\t oo  1.7

T1  1.7

tabcolsep  4.2

table  4.2, 4.3

table*  5.5

\tableofcontents  1.4, 2.8, 2.8, 2.8, C.2

tables  4.2

tabular  4.2, 4.2, 4.3, 4.6, 4.6

Tagged Image File Format (TIFF)  4.4

Talbot, Nicola  4.2

TDS  3.1, 3.2, 3.2, 3.2, 3.2, B

TEI  Home

temporary directory  3.2

term  Home

TEX Directory Structure (see TDS)  3.2

TEX Users Group (see TUG)  D

texconfig  A.1

texdoc  3.1

\text  5.4

Text Encoding Initiative (see TEI)  8.2

\textbackslash  1.5

\textbf{text}  Home

\textbrokenbar  1.9

\textbullet  4.1

\textcite  5.3, 5.3

\textcolor  6.2

\textcolor{red}{like this}  6.2

\textdegree  1.9

\texteuro  1.5

\textit  6.2

\textit{text}  Home

\textlangle  1.9

\textrangle  1.9

\textsc{text}  Home

\textsf{text}  Home

\textsl{text}  Home

\textsterling  1.5

\textsuperscript  1.5

\texttt{text}  Home

textwidth  Home

\thechapter  7.6

\theenumi  Home

\theenumii  Home

\theenumiii  Home

\theenumiv  Home

\theexample  4.1

\TheSbox  7.5

\thesection  7.6

\thinspace  1.6, 1.6, Home

\thispagestyle  6.1

Thành, Hàn Thế  Preface

tilde  1.5

\tiny  Home

\title  2.3, 2.3, 5.1, 7.2

titlepage  2.1

titles  2.3

\tmproduct  7.3

\tmproduct{Velcro}  7.3

tocdepth  2.6, 2.8

tools  5

tracking  Home

True TEX  Home

\ttdefault  B.2

\ttfamily  Home

twocolumn  5.5

twoside  2.1

typographics  6

#### U

\u u  1.7

\uline  6.2

Uniform Resource Indicator (see URI)  4.7

Uniform Resource Locator (URL)  4.7

units  1.8

Unix  A

updmap --enable Map=kurier.map  6

\upshape  Home

URI  2.1, 3.3, 4.7, 4.7, 4.7, 8.1, A.4

\usepackage  3.1, B.1, C.2

\usepackage{foozork}  B.2

\usepackage{graphicx}  4.4, 4.4

\usepackage{kurier}  6

\usepackage{url}  4.7, 8.1

\usepackage{xcolor}  6.2

utf8  1.7

utf8x  1.7, 1.7

#### V

V  B.2

\v u  1.7

\vbox  4.6

\verb  4.7, 4.7, 4.7, 4.7, 5.1

verbatim  4.7, 4.7, 4.7

Verbatim  4.7, 4.7

verbatim text  4.7

\VerbatimFootnotes  5.1

viewing  C

\vspace  6.1

\vspace*{19pt}  6.1

\vspace{18pt}  6.1

V TEX  Home

#### W

Wawrykiewicz, Staszek  4.4

What You See Is What You Get (see WYSIWYG)  Intro.1

white-space  1.4, 1.8, 1.8, 6.1, 6.1, Home

WYSIWYG  Preface, Preface, Home, 2, C.3

#### X

XHTML  8.1, 8.2

XML  Foreword, Preface, Intro.4, Intro.8, Home, 1.4, 2.1, 4.2, 4.7, 8, 8.1, 8.1, 8.1, 8.1, 8.1, 8.2, 8.3, E

XSL  8.3

XSLT  Home, Foreword, 8.1, 8.1, 8.1, 8.1, 8.1, 8.3, E

XSLT2  Intro.8

XƎTEX  Preface

ZIP  3.2, 3.2

\^e  1.7

\^w  1.7

\e  1.7

\~g  1.7

\~n  1.7

## Revision history

v. 7.41 — 30 January 2016
Minor typos, updated event dates
v. 7.4 — 16 November 2015

Started updating converters

v. 7.3 — 26 October 2015

Updated meetings for 2016

v. 7.2 — 12 July 2015

Several sections re-ordered to present the material is a more logical fashion. Numerous grammatical elisions corrected, and some late typos (thanks to Rob Borland).

v. 7.1 — 10 June 2015

Minor changes to accommodate revised PDF format.

v. 7.0 — 30 July 2014

Completely re-edited, large sections rewritten, obsolete material removed, including installation changes for the 2014 DVD, and a completely new responsive web site launched.

v. 6.0 — 30 December 2013

Updated links, replaced references to obsolescent packages, rewrote installation for the 2013 DVD

v. 5.7 — 21 December 2011

Moved and expanded the details of creating a personal TeX directory. Added new section on using the LaTeX Font Catalog.

v. 5.6 — 1 November 2011

Revised installation details for TL2011.

v. 5.5 — 25 May 2011

Minor revision; added details of page references in citations, a warning about the broken harvard.sty and its solution with natbib and har2nat, and a reference to bibunits.

v. 5.4 — 27 April 2011

Minor revision; added details of packages for body type size options; fixed bug in HTML bibrefs which were failing to retrieve the date.

v. 5.3 — 22 March 2011

Minor revision; removed mention of VTeX as a synchronous typographic editor and replaced with BaKoMa TeX. Located and fixed XSLT bug which was preventing cross-reference IDs being used correctly. Finally tracked down the non-appearance of italics in some places (no Lite Italic in my copy of Antique Olive).

v. 5.2 — 13 March 2011

Minor revision; even finer details of the problems Windows users face at installation.

v. 5.1 — 5 March 2011

Minor revision; spellings and font selection errors repaired; missing rule in HTML table example; better details of the problems Windows users face at installation.

v. 5 — 28 January 2011

Major revision; Installation and Editors sections rewritten, remaining package references updated, and more new ones added.

v. 4 — 1 April 2009

Major revision; Installation and Editors sections reorganised, all package references updated, and new ones added.

v. 3.7 — 22 December 2006

There have again been some small but significant improvements, both in the LATEX code, and in the default installations and implementations. The default colour package is now xcolor; the default output for many people is now PDF; and the advent of XƎTEX means that TrueType fonts and Unicode are now much more easily supported. The DocBook DTD has been updated to 4.4, and the TypeBook DTD shim likewise, and the IGNOREd code from 3.5 and earlier versions has now finally been dropped. XSLT still has the notorious design flaw of ignoring whitespace nodes in mixed content when a DTD is used, but this seems to have gone unnoticed except by the publishing industry. The use of the citetitle element for bibliographic references has been replaced by biblioref.

v. 3.6 — 31 March 2005

Since the publication of the November 2003 edition in TUGboat, several new books on LATEX have been released, and this edition reflects some of the new material and approaches contained in them. See the Bibliography for details of these publications. The only technical change has been to use empty elements for the TEX, LATEX, and other logos instead of the more usual entities so that the HTML version can use CSS to produce better logos. Thanks to whoever wrote the CSS for TEX4ht, which is where I found the styles.

v. 3.5 — 29 July 2004

Modified DTD to add span element type to allow use of external entities for formatted TEX, LATEX, and other logos in the HTML version. Changed entity declaration in the internal subset to enable this, and switched declarations and marked sections in the DTD. This now means it needs Saxon 7 or 8 to process, as Saxon 6 does not handle parameter entities values used as parameter entity declarations.

v. 3.4 — 9 November 2003

Applied all Barbara Beeton’s corrections (see separate emails) and rewrote a few formatting macros to allow the document to fit more easily into US Letter shape. It would be nice if it would also format for A5 so that it could become a paperback but that’s another day’s work. Started on writing the missing sections (Installing Type 1 CM Fonts and Going beyond LATEX, but these are not finished yet) and rewrote entirely the existing (non-CM) Type 1 font installation procedure in line with the new (unreleased) Gutta-Percha script. Added hidden meanings for CD-ROM, DVD, IBM.

v. 3.3 — 20 August 2003

Fixed XSLT bug which wrongly lettered appendices. Fixed problem which called wrong font for examples of Times and Helvetica (thanks to William Adams). Updated numerous typos, added comments about pdftex option to color. Rewrote formatting for TUGboat.

v. 3.2 — 5 March 2003

Finished rewrite. Revised and expanded almost everything.

v. 3.1 — 28 August 2002

Recast in DocBook and reworded some sections. Started the big rewrite.

1. See, for example, the list of TEX vendors in Table 1, and the list of consultants published by TUG

2. A guesstimate. With free software it’s virtually impossible to tell how many people are using it.

3. GNU’s Not Unix (GNU) is a project to create a completely free computing system — ‘free’ meaning both free from encumbrances and restrictions as well as free of charge.

4. Knuth still fixes bugs, although the chances of finding a bug in TEX these days approaches zero.

5. Not a wordprocessor like OpenOffice, Lotus Notes, Corel WordPerfect, or Microsoft Word, and not a ‘dumb’ editor like Apple TextEdit or Microsoft Notepad

6. Y&Y, Inc, who produced a TEX distribution for many years, have ceased trading. Some of their add-on fonts are now being distributed by the TEX Users Group (see the appendix ‘User Groups’), or have been replaced by Open Source implementations, and there is a mailing list at the TUG web site for the support of former Y&Y users.

7. Unfortunately, the LATEX command for guillemets was mis-spelled guillemot when it was created, and no-one seems to have the nerve to change it.

8. For example, you do not use these lines when using the new XƎLATEX processor; and if you are using pdf LATEX with the biblatex/biber bibliographic referencing mechanism instead of the older BIBTEX one, you MUST use the utf8 option (no x) instead of utf8x

9. Remember not everyone is lucky enough to be able to install new software: many users on business and academic networks still use old versions of TEX because they or their system managers don’t know how to update them. Local user groups may be able to provide help and support here.

10. Bear in mind that the degree symbol is a non- ASCII character, so you must specify what input encoding you are using if you want to type it: see the example of the inputenc package in § 1.7. If you don’t want to use non-ASCII characters (or if you are using a system which cannot generate them), you can use the command \textdegree to get the degree sign.

11. You will also see dollar signs used for math mode. This is quite common but deprecated: it’s what plain TEX used in the days before LATEX, and the habit got ingrained in many mathematicians. It still works as a convenient shorthand like $x=y$, as do double-dollars for display-mode math like $$E=mc^2$$, but they are only mentioned here to warn readers seeing them in other authors’ work that $$...$$ and $...$ are the proper LATEX commands.

12. Readers familiar with SGML, HTML, and XML will recognise the concept as similar to the Document Type Declaration (it’s still called a ‘type’ there, not a ‘class’).

13. Theses and dissertations may require an Abstract, which is provided in the report class but not in the book class. Many universities provide a special thesis class of their own.

14. The built-in letter class is rather idiosyncratic: there are much better ones you can use which you will find in the memoir package and the komascript bundle.

15. Letter size is 8½″×11″, which is the trimmed size of the long-obsolete Demy Quarto, still in use in North America. The other common US office size is ‘Legal’, which is 8½″×14″, a variant cutting close to the old Foolscap (8¼″×13¼″). ISO standard ‘A’, ‘B’, and ‘C’ paper sizes, used everywhere else, are still virtually unknown in most parts of North America.

16. Note that the standard built-in document classes (book, article, report, or letter) only use the paper size to adjust the margins: they do not embed the paper size name in any PostScript or PDF output file. For this you need the geometry package. If you are using pdf LATEX, or intend creating PostScript output, and you want to change the default paper size, you must specify it both in the Document Class option and as an option to the geometry package (see the last example ‘Read all about it’), in order to ensure that the paper size name gets embedded correctly in the output, otherwise printers may select the wrong paper tray, or reject the job.

17. If you’re familiar with HTML, you’ll recognise this technique: just like start-tags and end-tags.

18. It is arguable that chapters also have no place in reports, either, as these are conventionally divided into sections as the top-level division. LATEX, however, assumes your reports have chapters, but this is only the default, and can be changed very simply (see § 7.6).

19. Paragraph spacing and indentation are cultural settings. If you are typesetting in a language other than English, you should use the babel package, which alters many things, including the spacing and the naming of sections, to conform with the standards of different countries and languages.

20. For example, there is no xcolor.dtx and xcolor.ins for the xcolor package because it forms part of the graphics bundle, which is included with all LATEX systems anyway. Such packages change very rarely, as they form part of the core of LATEX and are very stable. You should never try to update these packages in isolation.

21. Almost all of these have been updated to work with LATEX, so they should be installed as in the penultimate step ‘Install the files’, but there are a few remaining.

22. MiK TEX users should note that you cannot process .ins files inside MiK TEX’s own folders: you have to do this elsewhere first, hence the need for a temporary directory.

23. Note that this means newsreaders for the Usenet News (NNTP) service. It does not mean syndication readers for RSS, which are a different thing entirely — these are unfortunately also sometimes referred to as ‘newsreaders’.

24. It’s worth pointing out that ‘technical’ doesn’t necessarily mean ‘computer technical’ or ‘engineering technical’, least of all ‘mathematical technical’: it just means it contains a lot of τέχνη, the specialist material or artistry of its field. A literary analysis such as La Textualisation de Madame Bovary (on the marginal notes in the manuscripts of Gustave Flaubert’s novel) is every bit as technical in the literary or linguistic field as the maintenance manual for the Airbus 380 is in the aircraft engineering field.

25. In fact, any time you define a counter in LATEX, you automatically get a command to reproduce its value. So if you defined a new counter example to use in a teaching book, by saying \newcounter{example}, that automatically makes available the command \theexample for use when you want to display the current value of example

26. You may find a lot of old files which use a package called epsf. Don’t use it: it’s obsolete.

27. LATEX will search for the graphic file by file type, in this order (check for the newest definition in your pdftex.def): .png, .pdf, .jpg, .mps, .jpeg, .jbig2, .jb2, .PNG, .PDF, .JPG, .JPEG, .JBIG2, and .JB2. Thanks to Enrico Gregorio and Philipp Stephani on comp.text.tex for locating this for me.

28. Some commercial distributions of TEX systems allow other formats to be used, such as GIF, Microsoft Bitmap (BMP), or Hewlett-Packard’s Printer Control Language (PCL) files, and others, by using additional conversion software provided by the supplier; but you cannot send such documents to other LATEX users and expect them to work if they don’t have the same distribution installed as you have. If you use original LATEX, stick to EPS

29. The original term Uniform Resource Locator (URL) is now deprecated in favour of the more accurate Uniform Resource Indicator (URI). For details see http://www.w3.org/Addressing/. Unfortunately the older term still persists, especially in LATEX and XML markup.

30. Like this.

31. Be aware that in some disciplines where cross-references are not much used, the word ‘references’ may be used to mean ‘bibliographic references’.

32. This section is labelled normalxref, for example.

33. Thus I can refer here to the label at the start of this section as \ref{normalxref} and get the value ‘§ 5.3.1’.

34. Fothergill, John (1929) An Innkeeper’s Diary, London : Penguin.

35. On GNU/Linux and Mac systems, just type the command man makeindex; the page is also available in many reference sites on the web.

36. Some authors — and perhaps some designers — believe that consistency is undesirable, and that double-page layouts in printed books should each be designed independently. Valerie Kirschenbaum’s magnificent Goodbye Gutenberg expresses this both eloquently and attractively, but the cost of such design labour and the cost of four-colour printing on all pages places it beyond the reach of most publishers’ budgets until the economics of on-demand four-colour ‘printing’ makes it possible.

37. This does not apply for the German technique in blackletter type of using letter-spacing instead of (non-existent) italics. The defaults in the soul package were designed to cater for this.

38. The pslatex package is also said to be outdated by some experts because it implements rather long-windedly what can now be done in three commands. However, until these replace the current version, I recommend continuing to use pslatex when you want Times with Helvetica and narrow Courier.

39. Although if you’re a typographer wanting to experiment with typewriter typefaces with and without serifs, you can use METAFONT or FontForgeto do exactly this kind of thing. But that’s way outside the scope of this document.

40. If you move all this Preamble into a package ( .sty) file of your own, you don’t need these commands: the use of @ signs in command names is allowed in package and class files.

41. Don’t try this at home alone, folks! This one is safe enough, but you should strictly avoid \def for a couple of years. Stick to \newcommand for now.

42. Strictly speaking it isn’t output at this stage: XML processors build a ‘tree’ (a hierarchy) of elements in memory, and they only get ‘serialised’ at the end of processing, into a stream of characters written to a file.

43. On UNIX and GNU/Linux systems, including Apple Macs, the easiest way to do this is in a Terminal window, in your Personal TEX Directory, using the command mkdir -p fonts/source/public/whatever, as this creates any intervening subdirectories for you. Under Windows, you have to create each subsubdirectory individually.

44. Confusingly, Bitstream fonts (and others from similar sources) mostly have different names from the original fonts, to avoid copyright issues, so what they call Humanist 521 is actually Gill Sans. Until recently, US law only allowed the names of typefaces to be copyrighted, not the font designs themselves, leading to widespread piracy.

45. Y&Y, Inc has ceased trading and their TEX distribution is not longer available, although there is email support at http://lists.ucc.ie/lists/archives/yandytex.html, and their encoding files continue to be used.

46. The only one I had problems with is ‘Å’, which for some weird reason isn’t catered for in this encoding.

47. Some recent versions of Emacs hide the log if there were no errors, and display it only if something went wrong.

48. This only works if you’re using an editor which LATEX can communicate with.

49. This is only a temporary fix to get the file processed. You still have to make that correction in the editor.