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

### An introduction to typesetting with LATEX

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 has helped thousands of users get started. It’s now at version 7.6 (2017) but this is an interim release: everything has been tested but some details remain to be rewritten — this has now to wait until the next release of TEX Live (2016) towards the end of the year. 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.

Fine, Jonathan  Home

Kastrup, David  Home

Chikrii, Kirill A  8.2

Kew, Jonathan  1.2

Berry, Karl  B.3

Péter Szabó  4.4

Stallman, Richard  Preface

Wawrykiewicz, Staszek  4.4

Ota, Takaaki  4.2

Jørgensen, Palle  6.3

Jørgensen, Palle  6.2

Kay, Michael  Intro.1

Nowacki, Janusz M  6.3

Sath­yam, Ujwal  8.1

Knuth, Donald  D

Feuerstack, Thomas  A

Schenk, Christian  A

Knuth, Donald  7.4

Lamport, Leslie  7.4

Berry, Karl  B.3

Budyta, Małgorzata  6.3

Chassell, Bob  Preface

Clea F Rees   5.3

Dorner, Fernando  8.2

DuBois, Paul  8.1

Esser, Thomas  A

Granzer, Andreas  8.2

Gregorio, Enrico  4.4

Hennings, Wilfried  8.2

Malyshev, Basil K  Home

Stephani, Philipp  4.4

Talbot, Nicola  4.2

\"e  1.8

\'\i{}  1.8

\'e  1.8

\-  1.9

#### .

.h1 Interest Rates  Home

\.m  1.8

/p  B.3

10pt  2.1

11pt  2.1

12pt  1.4, 2.1

#### :

:h1.Interest Rates  Home

\=o  1.8

#### @

\@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.8

\AA  1.8

AAP  Home

abstract  2.4, 2.4

\abstractname  2.4

abstracts  2.4

accents  1.8

\ae  1.8

\AE  1.8

\affiliation  2.3

American Political Science Review (APSR)  5.3

American Mathematical Society (AMS)  6.2

American National Standards Institute (ANSI)  E

American Standard Code for Information Interchange (see ASCII)  E

ampersand  1.6

Apple Mac  A, A, A.1

\arabic  7.6

arguments  1.4

\arraybackslash  4.2

\arraystretch  4.2

ASCII  Intro.2, Intro.4, 1.8, 1.10, 2.1, 4.4, 4.7, 8.1, B, C.4, E

\author  2.3, 2.3, 5.1, 7.2

\autocite  5.3, 5.3

#### B

b  4.6

\b o  1.8

backslash  1.4

Barbara Beeton  A.3

baselinestretch  6.1

beer  Home, Home

\begin  1.4, 2.2

\begin{...}  2.2

\begin{abstract}  2.4

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

\begin{itemize}[nosep]  4.1

\begin{tabular}  4.2

Berry, Karl  A

\bfseries  1.4, 6.2, Home

biber  C.1, C.2

BIBINPUTS  5.3

biblatex  Credits, 1.2, 1.8, 1.8, 5.3, 5.3, Home, 5.3, 5.3, 5.3, 5.3, Home, 5.3, 5.3, 5.3, 5.3, 5.3, 5.3, 5.3

bibliographies  5.3

\bibliography  5.3

\bibliographystyle  5.3, 5.3

bibtex  C.1, C.2

\bigskip  6.1

binary  1

BMP  4.4

boxes  4.6

bp (big points)  1.9

#### C

\c C  1.8

\c c  1.8

CALS  4.2

\caption  4.2, 4.3, 5.3

Cascading Style Sheets (see CSS)  8.2

cat *.id >>zor.map  B.3

cc (Ciceros)  1.9

cd  3.2, C.1, C.2

CD-ROM  Home, 8

center  1.4, 1.9, 4.2, 4.2, 6.2

\centering  1.9, 4.2, 4.2, 6.2

Change Directory  C.1

\chapter  2.6, 2.6, 7.6

characters  1.6, 1.8, 1.10, E

Chocolate Stout  Home

\cite  5.3, 5.3, 5.3, Home, 5.3, 5.3, 5.3, 5.4

\citep  5.3, 5.3

\citep[Foreword, p.13]{fg}  5.3

\citet  5.3, 5.3

\cite{fg}  Home

class  3.1

classes  3.1

\clearpage  Home

CLI  Preface, Intro.3

\cline  4.2

CM  Home, B.3

cm (centimeters)  1.9

CMYK  6.2

\color  3.1, 6.2

\colorbox  4.6, 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.4

comment character  1.6

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

ConTEXt  Preface

counter  Home, 1.4

cross-references  5.3

CSS  Home, 6.2

CSV  4.2

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

CTAN   5.4

curly braces  1.4

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

#### D

\d s  1.8

dash  1.9, Home

\date  2.3, 2.3, 7.2, C.3, C.3

\datesubmitted  2.3

dd (Didot points)  1.9

DEB  Home

\DeclareFontFamily  B.3

\DeclareFontShape  B.3

\def  7.4, 7.4

\definecolor  6.2

del  C.1, C.1

DELete  C.1

description  4.1

description*  4.1

desktop publishing (see DTP)  Preface

Digital Equipment Corporation (DEC)  Preface

Digital Restrictions Management (DRM)  1

dimension  2.7

dimensions  1.9

DOCTEX  3.2

document  Intro.4, 1.4, 1.8, 2.2, 2.3

document class  2.1

Document Style Semantics and Specification Language (DSSSL)  8.3

\documentclass  1.4, 1.8, 2.1, 2.1, 2.4, 3.1, 6.2

\documentclass{article}  8.1

dots per inch (see DPI)  Intro.1

double-spacing  6.1

\doublespacing  6.1

DPI  Intro.4

draft  2.1

\dtae  C.3

DTD  Home

DTP  Preface, 4.2, 6.2

DVD  Home, Intro.6, 8, A.4, Home

DVI  Preface, Preface, 3.1, 4.4, 4.4, 4.6, 8.2, C.4, C.4, C.4, C.4

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.9

\emph  6.2, 6.2

\emph{  8.1

empty  6.1

Encapsulated Postscript (see EPS)  4.4

\end  1.4, 2.2

\end{...}  2.2

\end{abstract}  2.4

\end{document}  1.4, 1.4, 2.2, 8.1

\end{itemize}  1.4

\end{verbatim}  4.7

\enspace  Home

enumerate  4.1

enumerate*  4.1

enumi  Home

enumii  Home

enumiii  Home

enumiv  Home

environment  Home, 1.4, 2.2, 4.1

EPS  4.4, 4.4, 4.4, 4.4, 4.4

EPUB3  Home

equation  1.10

error  C

Error messages  C.3, C.3, C.3, C.3, C.3, C.3, C.3

\EUR  1.6, 4.2

Euro  1.6

European Computer Driving Licence (see ECDL)  Intro.1

ex (relative measure)  1.9

example  4.1

exit  6.2, C.1, C.1

Extensible Markup Language (see XML)  8

Extensible Stylesheet Language (see XSL)  8.3

#### F

FAQ  Foreword, 3, 3.3, 3.3

\fbox  1.4, 4.3, 4.6, 4.6, 6.2

fboxrule  4.6, 6.2

fboxsep  4.6, 6.2

fc-cache -fv  6.2

fc-list  B.1

\fcolorbox  4.6, 6.2

FD  B.3

figure  4.3, 6.2

figure*  5.5

figures  4.3

filenames  C

floats  4.2, 4.3

flushleft  4.2, 6.2, 7.2

flushright  4.2, 6.2

FNDB  3.2, Home

\fnsymbol  5.1

font definition  B.3

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, 6.2, B, B.3, B.3

\fontsize  6.2

\footcite  5.3, 5.3

\footcite{fg}  Home

\footnote  4.7, 5.1, 5.1

footnotes  5.1

\footnotesize  Home

\footnote{...}  Home

\footnote{Like this}  5.1

\foreign  6.2, 7.3

\foreignlanguage  1.9

FTP  3

#### G

GIF  4.4

glossaries  5.4, 5.4

\glossary  5.4, 5.4

\gls  5.4

\gls{esis}  5.4

GNU  Home, Intro, Intro.4, Intro.8

GNU Image Manipulation Program (GIMP)  4.4

GNU’s Not Unix (see GNU)  Home

Graphics Interchange Format (see GIF)  4.4

\graphicspath  4.4

grep  B.1

group  1.9, 6.2, 6.2, 6.2

grouping  6.2

groups  6.2

GUI  5.4, 8.1

#### H

\H o  1.8

Hagen Hans  Preface

hash mark  1.6

help  3.3

\hline  4.2, 4.2

\hrule  7.2

\hspace{1in}  6.1

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

HTML5  Credits, Home, 5.3, 8.2, 8.2

HTTP  3

\huge  Home

\Huge  Home

HyperText Markup Language (see HTML)  8

hyphen  4.7

hyphenation  1.9, 1.9, 1.9

hyphens  1.9, 1.9

#### I

\i  1.8

IBM  Home

ID  5.3

images  4.4

in (inches)  1.9

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

\includegraphics[width=3in]{myhouse}  4.7

\index  5.4, 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

INFO  Preface

inline  4.1

inparaenum  4.1

\input{mygloss.tex}  5.4

Installation  A

ISO  Intro.6

ISP  3

\item  1.4, 4.1

itemize  1.4, 4.1

itemize*  4.1

\itshape  Home

#### J

Joint Photographic Experts Group (see JPG)  4.4

JPG  Home, 4.4, 4.4, 4.4, 4.4, 4.4, 4.4

#### K

Kew, Jonathan  Preface

Knuth, Donald  Preface

Knuth, Donald  Preface

kpsewhich  6.3

#### L

\l  1.8

\L  1.8

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

\labelitemi  7.6

\labelitemiv  7.6

Lamport, Leslie  Preface

\Large  1.4, Home

\large  Home

\LARGE  Home

latex  1.3, 3.2, C.1, C.2

\LaTeX  1.4, 8.1

latex testpage  A.1

latexmk  C.1, C.2

\leftmark  6.1

length  Home, 2.7

letterpaper  2.1, 2.1

letterspacing  Home

\linebreak  7.3

Linux  A

\listoffigures  2.8

\listoftables  2.8

lists  4.1, 4.1, 4.1, 4.1

Lotz, Manfred  A

\lowerbox  7.6

lrbox  4.6

ls -R  A.5

\lstinline  4.7, 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, C.1, C.2

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

man makeindex  5.4

MARC  Preface

marginal notes  5.2

\marginal{Some text}  5.2

margins  6.1

\markboth  6.1

\markright  6.1

markup  1

math characters  1.10

mathematics  Intro.5, 1.10

\mbox  1.9, 7.3

measurements  1.9

\medskip  6.1

metacharacters  1.6

Michael Sperberg-McQueen  A.3

Microbrew  Home

Microsoft Bitmap (see BMP)  4.4

Microsoft Windows  A

Minimal [Non-]Working Example (MWE)  3.3

minipage  4.6, 4.6, 4.6, 5.1, 7.5

mirror  4.4

mkdir  B.3

mkdir ~/Library/texmf  A.2

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

mkdir ~/texmf  A.2

mm (millimeters)  1.9

more  C.1

MoVe  C.1

MS-DOS  4.4, C.1

multicols  5.5

\multicolumn  4.2, 4.2

multiplier  4.2

mv  C.1, C.1

#### N

New Font Selection Scheme (NFSS)  B

New Typesetting System (NTS)  Preface

\newcommand  7.1, 7.4, 7.4

\newcounter{example}  4.1

\newfontface  6.2

\newfontfamily  6.2

\newgeometry  6.1

\newglossaryentry  5.4

NNTP  3.3

\noindent  4.5

noitemsep  4.1

normalem  6.2

\normalsize  Home

nosep  4.1

#### O

\o  1.8

\O  1.8

octothorpe  1.6

\oe  1.8

\OE  1.8

\onehalfspacing  6.1

oneside  2.1

options  3.1

OS X  A

\ovalbox  4.6

#### P

\P  5.3

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

page size  C.5

\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]{3in}{...}  4.6

\parencite  5.3, 5.3

\parencite{fg}  Home, Home

parindent  2.7, 4.6

parskip  2.7, 2.7, 2.7

\part  2.6

\part*  2.6

pc (picas)  1.9

PCTEX  Home

PDA  Preface, 8

PDF  Home, Home, Preface, Preface, Preface, Preface, Intro.4, 1.7, 2.1, 3.1, 4.4, 4.4, 4.4, 4.4, 4.4, 4.4, 4.4, 4.4, 4.6, 4.7, 5.3, 6.1, 6.2, 6.3, 8.1, 8.2, 8.3, B.3, C.4, C.4, C.4, C.4, C.5

pdflatex  C.1, C.2

\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.3

picas  1.9

picture  4.3

plain  6.1

plaintext  1

PNG  Home, 4.4, 4.4, 4.4, 4.4, 4.4

points  1.9

Portable Document Format (see PDF)  4.4

Portable Network Graphic (see PNG)  4.4

PostScript (PS)  8.2

PostScript Font ASCII (PFA)  B.3

PostScript Font Binary (see PFB)  B.3

Preamble  1.8

preview  C.4

\printbibliography  5.3

Printer Control Language (PCL)  4.4

\printglossaries  5.4

\printindex  5.4

printing  C, C.5, C.5

\product  6.2, 7.3, 7.3

prompt  C.1

\protect  5.1

\ProvidesPackage  B.3

pt (points)  1.9

#### Q

quotation  Home, 4.5, 6.2

quotation marks  1.7

#### R

\raggedleft  1.9, 1.9, 4.2

\RaggedLeft  1.9

\raggedright  1.9, 1.9, 4.2, 4.6

\RaggedRight  1.9

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

ReMove  C.1

ren  C.1, C.1

REName  C.1

\renewcommand  2.4, 2.4, 2.6, 4.2, 7.2, 7.6

\renewcommand{\arraystretch}{1.5}  4.2

\renewcommand{\baselinestretch}{1.75}  6.1

\RequirePackage  6.2

RGB  6.2

Rich Text Format (see RTF)  8.1

\rightmark  6.1

RIS  5.3, 5.3

rm  C.1, C.1

\rmdefault  B.3

Rogue  Home

rotate  4.4

RPM  Home

RTF  8.1, 8.2

rule  Home, 4.2

#### S

\S  5.3

Sbox  4.6, 4.6, 7.5

Scalable Vector Graphics (see SVG)  6.2

scale  4.4

Scale  6.2

scaled  4.4, 6.2

\scriptsize  Home

\scshape  Home

secnumdepth  1.4, 2.6

section  Home, 1.4, 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.9

\sentinel  7.4

\setcounter  1.4, 2.6, 2.7

\setlength  2.7, 2.7, 4.6, 4.6

\setmainfont  6.2

\setmonofont  6.2

\setsansfont  6.2

\sfdefault  B.3

\sffamily  1.4, Home, 7.2

SGML  Home, 2.1, 2.2, 8, 8.3

Show Library Folder  A.2

sidebars  4.6

\singlespacing  6.1

size (fonts)  6.2

\slshape  Home

\small  4.5, Home

\smallskip  6.1

sp (scaled points)  1.9

space  6.1

spaceskip  1.9

spacing  6.1

special characters  1.6, 1.10

\ss  1.8

Standard Generalized Markup Language (see SGML)  8.3

strut  4.2

style (fonts)  6.2

\subparagraph  2.6, 4.1

\subparagraph*  2.6

\subsection  1.4, 2.6

\subsubsection  2.6

sudo su -  6.2

sudo texconfig  A.1

summaries  2.4

SVG  8.2

svgnames  6.2

#### T

t  4.6

\t oo  1.8

T1  1.8

tabcolsep  4.2

table  4.2, 4.2, 4.3, 6.2

table*  5.5

\tableofcontents  1.5, 2.8, 2.8, 2.8, C.3

tables  4.2

\tablesfont  6.2

tabular  4.2, 4.2, 4.3, 4.6, 4.6

Tagged Image File Format (TIFF)  4.4

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

TEI  Home, 8.2

temporary directory  3.2

term  Home

terminal  C

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)  D.1

text-only interface  C.1

\textbackslash  1.6

\textbf{text}  Home

\textbrokenbar  1.10

\textbullet  4.1

\textcite  5.3, 5.3

\textcite{fg}  Home, Home

\textcolor  6.2

\textcolor{red}{like this}  6.2

\textdegree  1.10

\texteuro  1.6

\textit  1.4, 6.2

\textit{text}  Home

\textlangle  1.10

\textrangle  1.10

\textsc{text}  Home

\textsf{text}  Home

\textsl{text}  Home

\textsterling  1.6

\textsuperscript  1.6

\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.7, 1.7, Home

\thispagestyle  6.1

Thành, Hàn Thế  1.2

Thành, Hàn Thế  Preface

tilde  1.6

\tiny  Home

\title  2.3, 2.3, 5.1, 7.2

\titlecite  5.3

titlepage  2.1

titles  2.3

\tmproduct  7.3

\tmproduct{Velcro}  7.3

tocdepth  2.6, 2.8

\today  1.4

tools  5

tracking  Home

TrueTEX  Home

\ttdefault  B.3

\ttfamily  Home

twocolumn  5.5

twoside  2.1

typographics  6

#### U

\u u  1.8

\uline  6.2

unboxed  4.1

Uniform Resource Indicator (see URI)  4.7

Uniform Resource Locator (URL)  4.7

units  1.9

Unix  A

unscoped  6.2

\upshape  Home

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

url  1.4, 1.4, 4.7, 4.7, 4.7, 5.1, 8.1

US  Home

\usepackage  1.4, 2.1, 3.1, 3.1, B.2, C.3

\usepackage{foozork}  B.3

\usepackage{graphicx}  4.4, 4.4

\usepackage{kurier}  6.3

\usepackage{url}  4.7, 8.1

\usepackage{xcolor}  6.2

utf8  1.8

utf8x  1.8, 1.8

#### V

V  B.3

\v u  1.8

\verb  4.7, 4.7, 4.7, 4.7, 4.7, 5.1

verbatim  4.7, 4.7

Verbatim  4.7

verbatim text  4.7

\VerbatimFootnotes  5.1

viewer  C

\vspace  6.1

\vspace*{19pt}  6.1

\vspace{18pt}  6.1

VTEX  Home

#### W

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

white-space  1.9, 6.1, 6.1, 6.1, Home

WYSIWYG  Preface, Preface, Home, 2, 8.1, C.4

#### X

xelatex  Intro.3, C.1, C.2

XHTML  5.3, 8.1, 8.2

XML  Home, Home, Foreword, Preface, Preface, Intro.4, Intro.8, Home, 1.5, 2.1, 2.2, 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.3, E

XSLT2  Home, Intro.8

XƎTEX  Preface

ZIP  3.2, 3.2

\^e  1.8

\^w  1.8

\e  1.8

\~g  1.8

\~n  1.8

#### ␣

\␣  1.9

v. 7.81 — 19 November 2018
Updated and rewrote the section on image file formats
v. 7.8 — 25 February 2018
Updated BachoTEX and MarkupUP
v. 7.7 — 14 February 2018
Updated conference dates; added details of lwarp; fixed bibref pointer to PDF pages where given.
v. 7.6 — 14 May 2017
Added salient comments about how to choose an editor from Michael Sperberg-McQueen, and slides from TUG 2017 from Barbara Beeton on how to handle LATEX errors.
v. 7.5 — 21 January 2017
Full update of Mac and Windows installation with new screenshots and a new layout for procedures; introduction of an XSLT routine to test when an element is immediately preceded by another element with only white-space intervening, and to generate a space token if needed (this overcomes the design flaw alluded to in the revision comments to v3.7 below); many updates to phraseology, and removal of obsolete mentions of packages and practices.
v. 7.45 — 4 November 2016
Updated details of TDS package installation
v. 7.44 — 11 October 2016
Updated details of meetings
v. 7.43 — 15 April 2016
v. 7.42 — 1 March 2016
Edited all sections, corrected spellings, updated package details and all examples to XƎLATEX/biblatex/biber, fixed stray typos, checked links,. This is preparatory to v8, due for later in 2016.
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. Some which are straightforward are shown in Figure 1.1

8. Embarrassingly, the LATEX command for guillemets was mis-spelled guillemot when it was created, and no-one seems to have the nerve to change it. Albatross!

9. Note for MacTEX users: the TEXShop editor that comes with MacTEX is not set for UTF-8 by default: see the step ‘Set the LATEX processor to XƎLATEX …’ for how to set it.

10. 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.

11. 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.8. 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.

12. 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.

13. 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’).

14. 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.

15. 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.

16. ‘Letter’ size is 8½″×11″, which is the trimmed size of the long-obsolete Demy Quarto, still in use in North America. Other common US office sizes are ‘Legal’, which is 8½″×14″, a ‘bastard’ (variant) cutting close to the old Foolscap (8¼″×13¼″); Ledger or Tabloid (11″×17″, which is exactly twice ‘Letter’, in the same way that A3 is twice A4); and ‘Executive’ (7″×10″). ISO standard ‘A’, ‘B’, and ‘C’ paper sizes, used everywhere else, are still largely unknown in most parts of North America.

17. 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 the PostScript or PDF output. For this you need the geometry package. If you are using PDFLATEX, or you 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 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.

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. MiKTEX users MUST note that you cannot process .ins files inside MiKTEX’s own installation folders: you have to process them elsewhere first, hence the need for a temporary directory.

21. For example, there is no separate 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 kernel of LATEX and are very stable. You should never try to update these packages in isolation.

22. 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.

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 τέχνη, Greek for specialist material or artistry. 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. 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 this LATEX package and its command, and in some XML markup vocabularies.

28. Like this.

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

30. This section is labelled normalxref, for example.

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

32. It’s not clear how they refer to conventional footnotes, or if they even use them.

33. On Unix & GNU/Linux systems (including Apple Macintosh OS X, just type the command man makeindex; the page is also available in many reference sites on the web.

34. 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.

35. 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.

36. 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.

37. 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.

38. 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.

39. 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.

40. 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.

41. On UNIX & GNU/Linux systems, including Apple Macintosh OS X, 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.

42. 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.

43. 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.

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