Debian Codegraph @

texmf-dist/doc/latex/psnfss/psnfss2e.tex

raw
1 % file: psnfss2e.tex as of 2020-03-25
2 %
3 % Copyright 2000--2020 Walter Schmidt
4 %
5 % This file may be distributed and/or modified under the
6 % conditions of the LaTeX Project Public License, either version 1.2
7 % of this license or (at your option) any later version.
8 % The latest version of this license is in
9 % http://www.latex-project.org/lppl.txt
10 % and version 1.2 or later is part of all distributions of LaTeX
11 % version 1999/12/01 or later.
12
13 \newif\ifutopia
14
15 % \utopiatrue
16 % If you have got the Utopia fonts, uncomment the above line,
17 % or put \utopiatrue into your ltxguide.cfg.
18
19 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
20
21 \documentclass[11pt]{ltxguide}[1995/11/28]
22 \DeleteShortVerb{\|}
23
24 % You may provide a configuration file ltxguide.cfg
25 % to set up your preferred paper size and page layout.
26 % The .cfg file should, however, not change the fonts used!
27
28 \usepackage{mathptmx,courier}
29 \usepackage[scaled=0.92]{helvet}
30 \normalfont
31 \usepackage{pifont,tabularx,varioref,url}
32 \usepackage[T1]{fontenc}
33 \usepackage{textcomp}
34 \usepackage{ragged2e}
35
36 \usepackage[colorlinks=false, pdfborder={0 0 0}]{hyperref}
37
38 % some dirty hacks to make the ltxguide class look better:
39 \makeatletter
40 \renewcommand\section{\@startsection{section}{1}{\z@}%
41 {-3.5ex \@plus -.75ex}%
42 {1ex}%
43 {\normalfont\Large\bfseries}}
44 \renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
45 {-2.5ex plus -.5ex}%
46 {.75ex}%
47 {\normalfont\large\bfseries}}
48 \renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
49 {-2.5ex plus -.5ex}%
50 {.5ex}%
51 {\normalsize\bfseries}}
52 \setlength{\parskip}{1ex plus 2pt minus 1pt \relax}
53 % borrowed from tdsguide.cls:
54 \labelsep=1.1em % increase distance between item & text
55 \topsep=0pt % no extra skip above list in paragraph
56 \partopsep=0pt % no extra skip above list starting par.
57 \itemsep=0pt % no extra space between items
58 \parsep=.9\parskip % between paragraphs in items
59 \def\@listI{%
60 \leftmargin\leftmargini
61 }
62 \let\@listi\@listI
63 \@listi
64 \def\@listii{%
65 \leftmargin\leftmarginii
66 \labelwidth\leftmarginii \advance \labelwidth-\labelsep
67 }
68 \def\@listiii{%
69 \leftmargin\leftmarginiii
70 \labelwidth\leftmarginiii \advance \labelwidth-\labelsep
71 }
72 \makeatother
73
74 % the (La)TeX logos for use with Times:
75 \def\ptmTeX{T\kern-.1667em\lower.5ex\hbox{E}\kern-.075emX\@}
76 \makeatletter
77 \DeclareRobustCommand{\ptmLaTeX}{L\kern-.25em
78 {\setbox0\hbox{T}%
79 \vbox to\ht0{\hbox{%
80 \csname S@\f@size\endcsname
81 \fontsize\sf@size\z@
82 \math@fontsfalse\selectfont
83 A}%
84 \vss}%
85 }%
86 \kern-.10em
87 \TeX}
88 \makeatother
89 \let\TeX=\ptmTeX
90 \let\LaTeX=\ptmLaTeX
91
92 % a bit of logical markup:
93 \newcommand{\ps}{PostScript}
94 \newcommand{\Lpack}[1]{\textsf{#1}}
95
96 % the macros for the typeface samples:
97 \newlength{\rightwidth}
98 \rightwidth=11cm
99 \newlength{\leftwidth}
100 \leftwidth=\textwidth
101 \addtolength{\leftwidth}{-\rightwidth}
102 \addtolength{\leftwidth}{-1em} % ?
103 \newcommand{\sample}[5]{%
104 \parbox[t]{\leftwidth}{%
105 {\raggedright\footnotesize
106 #1\\
107 #3/#4\par}}
108 \hfill
109 \parbox[t]{\rightwidth}{
110 {\RaggedRight \fontfamily{#2}\fontsize{#3}{#4}\selectfont #5
111 The sun was just rising as Dr.\ Robert entered his wife's room.
112 An orange glow, and against it the jagged silhouette of the mountains.
113 Then suddenly a dazzling sickle of incandescence between two peaks.
114 The sickle became a half circle and the first long shadows,
115 the first shafts of golden light crossed the garden outside the window.
116 And when one looked up again at the mountains there was the whole
117 unbearable glory of the risen sun.
118 \par}}
119 \par
120 \medskip}
121
122
123 \title{Using common \ps\ fonts with \LaTeX}
124
125 \author{Walter Schmidt}
126
127 \date{PSNFSS version 9.3 \\ 2020-03-25}
128
129
130 \hypersetup{pdfauthor={Walter Schmidt},
131 pdftitle={Using common PostScript fonts with LaTeX},
132 pdfsubject={PSNFSS v9.3},
133 pdfkeywords={LaTeX PSNFSS PostScript fonts}}
134
135
136 \begin{document}
137 \MakeShortVerb{\+}
138
139 \maketitle
140
141 \tableofcontents
142 %\pagebreak
143
144
145 \section{What is PSNFSS\,?}
146
147 The PSNFSS collection includes a set of files
148 that provide a complete working setup of the \LaTeX{} font selection scheme
149 (NFSS2) for use with common \ps\ fonts.
150 It covers the so-called `Base~35' fonts
151 (which are built into any Level~2 \ps\ printing device
152 and the Ghostscript interpreter)
153 and %the free Charter, Utopia and Pazo fonts.
154 a number of free fonts.
155
156
157
158 \section{Package overview}
159
160 The easiest way to make use of the above-mentioned typefaces is to completely
161 replace one or more of the font families used by \LaTeX{} as
162 `roman', `sans serif' and `typewriter' family and for math.
163 This is accomplished by the packages listed in table \ref{tab:packages}.
164 Its first row lists the default (Computer Modern) font families.
165 An empty column indicates that a package does not change the particular
166 font family. Some of these packages need more detailed explanation and
167 are described in the below sections \ref{sec:helvet}, \ref{sec:mathpazo}
168 and \ref{sec:mathptmx}.
169
170 The PSNFSS distribution includes also a package
171 \Lpack{pifont}, which serves for accessing symbol fonts (aka `Pi~fonts'),
172 such as Symbol and Zapf Dingbats, see section~\ref{sec:pifont}.
173
174
175 \begin{table}[h!]
176 \caption{Packages for using common \ps\ fonts}
177 \label{tab:packages}
178 \medskip
179 {\footnotesize
180 \begin{center}
181 \renewcommand{\arraystretch}{1.2}
182 \begin{tabular}{|l|p{1.8cm}p{2.2cm}p{2.4cm}p{2.2cm}|}
183 \hline
184 \textbf{package} & \textbf{roman} & \textbf{sans serif} & \textbf{typewriter} & \textbf{formulas} \\\hline\hline
185 (none) & CM Roman & CM Sans Serif & CM Typewriter & $\approx$ CM Roman\\\hline
186 \Lpack{mathpazo} & Palatino
187 &
188 &
189 & $\approx$ Palatino\\\hline
190 \Lpack{mathptmx} & Times
191 &
192 &
193 & $\approx$ Times\\\hline
194 \Lpack{helvet} &
195 & Helvetica
196 &
197 & \\\hline
198 \Lpack{avant} &
199 & Avant~Garde
200 &
201 & \\\hline
202 \Lpack{courier} &
203 &
204 & Courier
205 & \\\hline
206 \Lpack{chancery} & Zapf Chancery
207 &
208 &
209 & \\\hline
210 \Lpack{bookman} & Bookman
211 & Avant~Garde
212 & Courier
213 & \\\hline
214 \Lpack{newcent} & New Century Schoolbook
215 & Avant~Garde
216 & Courier
217 & \\\hline
218 \Lpack{charter} & Charter
219 &
220 &
221 & \\\hline
222 \end{tabular}
223 \end{center}
224 }
225 \end{table}
226
227
228
229 \section{Special considerations}
230
231 \subsection{Output font encoding}
232 None of the packages listed in table~\ref{tab:packages} changes the
233 output font encoding from its default setting OT1.
234 It is, however, highly recommended to use the fonts with the extended
235 T1 and TS1 (text symbols) encodings by means of the commands:
236 \begin{quote}
237 +\usepackage[T1]{fontenc}+\\
238 +\usepackage{textcomp}+
239 \end{quote}
240 When using \ps\ fonts that come from `outside the \TeX{} world',
241 there is no reason at all to stay with the obsolete OT1~encoding,
242 which would not provide access to all available glyphs.
243 However, since these fonts were not particularly designed
244 for use with \TeX{}, they do \emph{not} include all of the
245 text companion (TS1) symbols.
246
247
248 \subsection{Euro support}
249 %% \NEWfeature{2003-11-17 v9.1}
250 From PSNFSS version~9.1 on, all supported text font families,
251 with the exception of \texttt{put} (Utopia), provide
252 a built-in Euro symbol +\texteuro+.
253 Using this command requires the \Lpack{textcomp} package; see above.
254
255
256 \subsection{Inter-line spacing}
257 With certain font families, the leading of the standard \LaTeX{}
258 document classes may be too small.
259 This results from the larger x-height of these typefaces, as compared with
260 Computer Modern.
261 Since it is a question of document design and line width,
262 the packages of the PSNFSS bundle do \emph{not} take care of this.
263 Issuing the command
264 \begin{quote}
265 +\linespread+ \arg{factor}
266 \end{quote}
267 in the preamble will globally enlarge the leading by the given factor.
268 Typical values for \m{factor} are in the range of $1.04\dots1.1$.
269
270
271 \subsection{Using sans serif fonts}
272 The packages \Lpack{helvet} and \Lpack{avant} do not change the
273 default text font family from `roman'.
274 If required, the additional command
275 \begin{quote}
276 +\renewcommand{\familydefault}{\sfdefault}+
277 \end{quote}
278 makes \LaTeX{} use the sans serif font family (Helvetica or Avant~Garde)
279 as the default one in text mode. Notice, however, that this does not change the fonts
280 used in the formulas!
281
282
283
284 \section{The package \Lpack{helvet}}
285 \label{sec:helvet}
286 Helvetica is actually somewhat larger than other typefaces
287 of the same nominal size.
288 As a result, mixing, \eg Times and Helvetica within running text
289 may look bad.
290 \begin{decl}
291 \texttt{[scaled=}\m{scale}\texttt{]}\\
292 \texttt{[scaled]}
293 \end{decl}
294 This can be fixed by loading the package with the option
295 \texttt{[scaled=}\m{scale}\texttt{]},
296 for instance:
297 +\usepackage[scaled=.92]{helvet}+.
298 As a result, the font family \texttt{phv} (Helvetica) will be
299 scaled down to 92\% of its `natural' size, which is suitable
300 for use with Adobe Times.
301 Specifying +[scaled]+ alone is equivalent to +[scaled=0.95]+% and makes
302 %the height of the Helvetica capital letters comply with many other typeface
303 %families
304 .
305
306
307
308 \section{The package \Lpack{mathpazo}}
309 \label{sec:mathpazo}
310 Loading
311 %% \NEWfeature{2001-06-04 v8.2}
312 this package changes the default roman font family
313 to Adobe Palatino, and the virtual `mathpazo' fonts will be used
314 for math.
315 These virtual fonts are made up basically from Palatino Italic, with the
316 missing math symbols coming from the CM and Pazo math fonts.
317
318 \subsection{Package options}
319
320 \begin{decl}
321 +[sc]+\\
322 +[osf]+
323 \end{decl}
324 By default, the package \Lpack{mathpazo} uses
325 the typeface family +ppl+ as the roman text font family.
326 The option +[sc]+ selects Palatino with real smallcaps (family +pplx+) insread.
327 Correspondingly, the option +[osf]+ selects Palatino with smallcaps and default
328 oldstyle figures (family +pplj+).
329 Of course, oldstyle figures will be used only in text mode, as opposed to formulas.
330 \NEWfeature{2004-09-15 v9.2}
331 Using either option is strongly recommended:
332 Beside the real smallcaps, the font families +pplx+ and +pplj+ show further
333 improvements over +ppl+: Increased word space, enhanced kerning tables,
334 additional `dotlessj' glyph.
335
336 \begin{decl}
337 +[slantedGreek]+
338 \end{decl}
339 When the package is loaded with the +[slantedGreek]+ option,
340 uppercase Greek letters in math will be italic by default.
341
342 \begin{decl}
343 +[noBBpl]+
344 \end{decl}
345 This option disables the use of the Pazo fonts as a partial
346 +\mathbb+ alphabet -- see below. The option should be specified,
347 if you want to use a different `blackboard bold' font.
348
349
350 \subsection{New commands}
351
352 \begin{decl}
353 +\upGamma+, +\upDelta+ \dots +\upOmega+
354 \end{decl}
355 \NEWfeature{2004-09-15 v9.2}
356 Regardless of the \texttt{slantedGreek} option,
357 these commands always yield upright uppercase Greek letters.
358 Upright \emph{lowercase} Greek is, however, not available.
359
360 \begin{decl}
361 +\mathbold+\\
362 +\mathbb+
363 \end{decl}
364 +\mathbold+ is a math alphabet for typesetting variables (incl.\ Greek)
365 in a {\bfseries\itshape bold italic} style. Do not mix this up with +\mathbf+,
366 which selects a {\bfseries\upshape bold upright} text font
367 for use in math!
368
369 +\mathbb+ is a `blackboard bold' alphabet, whose characters
370 are taken from the Pazo fonts. %% \NEWfeature{2002-04-10 v9.0}
371 All upper case letters and the numeral `1' are available.
372 If you want to use a different, external, doublestroke alphabet,
373 load the package \Lpack{mathpazo} with the package option +[noBBppl]+, see above.
374
375 \iffalse
376 \begin{decl}
377 +\ppleuro+
378 \end{decl}
379 The command +\ppleuro+ typesets the Euro
380 symbol in a way that suits Palatino using the appropriate glyphs
381 from the Pazo Math font family. It is compatible with both the
382 \Lpack{eurofont} and \Lpack{europs} packages, and one can continue to use either
383 one of these packages, using the +\euro+ command from the
384 \Lpack{eurofont} package or the +\EUR+ command from the \Lpack{europs} package.
385 \fi
386
387
388 \subsection{Font size of the `large' math symbols}
389 With \Lpack{mathpazo}, the `large' math symbols are automatically
390 scaled to fit the base font size.
391 In contrast to standard \LaTeX{} you need not
392 load the package \Lpack{exscale} for this purpose!
393
394
395 \subsection{Known problems}
396
397 In contrast to the standard CM fonts, the virtual \Lpack{mathpazo} fonts
398 do not provide any Greek letters in the math alphabet +\mathrm+.
399 Applying this math alphabet command to Greek letters
400 will result in garbage output.
401
402
403
404 \section{The package \Lpack{mathptmx}}
405 \label{sec:mathptmx}
406 Loading this package changes the default roman font family
407 to Times, and the virtual `mathptmx' fonts will be used
408 for math.
409 These virtual fonts are made up basically from Times Italic, with the
410 missing math symbols coming from CM, RSFS (for +\mathcal+) and
411 Adobe~Symbol.
412
413 \subsection{Package options}
414 \begin{decl}
415 +[slantedGreek]+
416 \end{decl}
417 %% \NEWfeature{2001-06-04 v8.2}
418 When the package is loaded with this option,
419 uppercase Greek letters in math will be italic by default.
420
421 \subsection{New commands}
422 \begin{decl}
423 +\upGamma+, +\upDelta+ \dots +\upOmega+
424 \end{decl}
425 \NEWfeature{2004-09-15 v9.2}
426 Regardless of the \texttt{slantedGreek} option,
427 these commands always yield upright uppercase Greek letters.
428 Upright \emph{lowercase} Greek is, however, not available.
429
430
431 \subsection{Font size of the `large' math symbols}
432 With \Lpack{mathptmx}, the `large' math symbols are automatically scaled
433 to fit the base font size. In contrast to standard \LaTeX{} you need not
434 load the package \Lpack{exscale} for this purpose!
435
436
437 \subsection{Known bugs and deficiencies}
438 \begin{itemize}
439 \item There are no bold math fonts, and +\boldmath+ has no effect.
440 Use of the package \Lpack{bm} in conjunction with \Lpack{mathptmx}
441 is not recommended.
442 \item The symbols
443 +\jmath+, +\coprod +and +\amalg+
444 are not available.
445 \end{itemize}
446
447
448
449 \section{The package \Lpack{pifont}}
450 \label{sec:pifont}
451
452 Using symbol fonts is supported by means of the
453 \Lpack{pifont} package, providing commands for using the Zapf Dingbats font,
454 as well as an interface to other families.\footnote{%
455 This section was adopted, with minor changes,
456 from \cite{companion}, 1st ed.}
457
458 \subsection{Commands for using Zapf Dingbats}
459
460 \begin{decl}
461 +\ding+ \arg{number}
462 \end{decl}
463
464 A given character can be chosen via the +\ding+ command.
465 Its parameter is an integer that specifies the character to be
466 typeset. For example, +\ding{38}+ gives \ding{38};
467 see table~\vref{tab:dingbats}.
468
469 \begin{decl}
470 +\begin{dinglist}+ \arg{number}\\
471 +\begin{dingautolist}+ \arg{number}
472 \end{decl}
473
474 The +dinglist+ environment is a special itemized list.
475 The argument specifies the number of the character to be used
476 as the beginning of each item. For example,
477 \begin{verbatim}
478 \begin{dinglist}{43}
479 \item The first item in the list
480 \item The second item in the list
481 \item The third item in the list
482 \end{dinglist}
483 \end{verbatim}
484 prints
485 \begin{dinglist}{43}
486 \item The first item in the list
487 \item The second item in the list
488 \item The third item in the list
489 \end{dinglist}
490
491 There also exists an environment +dingautolist+, which
492 allows you to build an enumerated list with a set of Zapf Dingbats
493 characters. In this case, the argument specifies the number
494 of the first character in the list. Subsequent items will be numbered
495 with the character following the previous one. E.g.,
496 \begin{verbatim}
497 \begin{dingautolist}{192}
498 \item The first item
499 \item The second item
500 \item The third item
501 \end{dingautolist}
502 \end{verbatim}
503 prints
504 \begin{dingautolist}{192}
505 \item The first item
506 \item The second item
507 \item The third item
508 \end{dingautolist}
509
510 \begin{decl}
511 +\dingfill+ \arg{number}\\
512 +\dingline+ \arg{number}
513 \end{decl}
514
515 +\dingfill+ acts like the other filling commands in \TeX, but
516 fills the space with a chosen symbol \dingfill{224} like that.
517
518 +\dingline+ generates a freestanding line filled with the given symbol,
519 with a little space on the left and right:
520 \dingline{34}
521
522
523 \begin{table}[bt!]
524 \caption{The characters in the \ps{} font Zapf Dingbats}
525 \label{tab:dingbats}
526 \medskip
527
528 {\footnotesize
529 \begin{tabular}{|rr|rr|rr|rr|rr|rr|rr|rr|}
530 \hline
531 32 & \ding{32} & 33 & \ding{33} & 34 & \ding{34} & 35 & \ding{35} & 36 & \ding{36} & 37 & \ding{37} & 38 & \ding{38} & 39 & \ding{39} \\ \hline
532 40 & \ding{40} & 41 & \ding{41} & 42 & \ding{42} & 43 & \ding{43} & 44 & \ding{44} & 45 & \ding{45} & 46 & \ding{46} & 47 & \ding{47} \\ \hline
533 48 & \ding{48} & 49 & \ding{49} & 50 & \ding{50} & 51 & \ding{51} & 52 & \ding{52} & 53 & \ding{53} & 54 & \ding{54} & 55 & \ding{55} \\ \hline
534 56 & \ding{56} & 57 & \ding{57} & 58 & \ding{58} & 59 & \ding{59} & 60 & \ding{60} & 61 & \ding{61} & 62 & \ding{62} & 63 & \ding{63} \\ \hline
535 64 & \ding{64} & 65 & \ding{65} & 66 & \ding{66} & 67 & \ding{67} & 68 & \ding{68} & 69 & \ding{69} & 70 & \ding{70} & 71 & \ding{71} \\ \hline
536 72 & \ding{72} & 73 & \ding{73} & 74 & \ding{74} & 75 & \ding{75} & 76 & \ding{76} & 77 & \ding{77} & 78 & \ding{78} & 79 & \ding{79} \\ \hline
537 80 & \ding{80} & 81 & \ding{81} & 82 & \ding{82} & 83 & \ding{83} & 84 & \ding{84} & 85 & \ding{85} & 86 & \ding{86} & 87 & \ding{87} \\ \hline
538 88 & \ding{88} & 89 & \ding{89} & 90 & \ding{90} & 91 & \ding{91} & 92 & \ding{92} & 93 & \ding{93} & 94 & \ding{94} & 95 & \ding{95} \\ \hline
539 96 & \ding{96} & 97 & \ding{97} & 98 & \ding{98} & 99 & \ding{99} & 100 & \ding{100} & 101 & \ding{101} & 102 & \ding{102} & 103 & \ding{103} \\ \hline
540 104 & \ding{104} & 105 & \ding{105} & 106 & \ding{106} & 107 & \ding{107} & 108 & \ding{108} & 109 & \ding{109} & 110 & \ding{110} & 111 & \ding{111} \\ \hline
541 112 & \ding{112} & 113 & \ding{113} & 114 & \ding{114} & 115 & \ding{115} & 116 & \ding{116} & 117 & \ding{117} & 118 & \ding{118} & 119 & \ding{119} \\ \hline
542 120 & \ding{120} & 121 & \ding{121} & 122 & \ding{122} & 123 & \ding{123} & 124 & \ding{124} & 125 & \ding{125} & 126 & \ding{126} & & \\ \hline
543 & & 161 & \ding{161} & 162 & \ding{162} & 163 & \ding{163} & 164 & \ding{164} & 165 & \ding{165} & 166 & \ding{166} & 167 & \ding{167} \\ \hline
544 168 & \ding{168} & 169 & \ding{169} & 170 & \ding{170} & 171 & \ding{171} & 172 & \ding{172} & 173 & \ding{173} & 174 & \ding{174} & 175 & \ding{175} \\ \hline
545 176 & \ding{176} & 177 & \ding{177} & 178 & \ding{178} & 179 & \ding{179} & 180 & \ding{180} & 181 & \ding{181} & 182 & \ding{182} & 183 & \ding{183} \\ \hline
546 184 & \ding{184} & 185 & \ding{185} & 186 & \ding{186} & 187 & \ding{187} & 188 & \ding{188} & 189 & \ding{189} & 190 & \ding{190} & 191 & \ding{191} \\ \hline
547 192 & \ding{192} & 193 & \ding{193} & 194 & \ding{194} & 195 & \ding{195} & 196 & \ding{196} & 197 & \ding{197} & 198 & \ding{198} & 199 & \ding{199} \\ \hline
548 200 & \ding{200} & 201 & \ding{201} & 202 & \ding{202} & 203 & \ding{203} & 204 & \ding{204} & 205 & \ding{205} & 206 & \ding{206} & 207 & \ding{207} \\ \hline
549 208 & \ding{208} & 209 & \ding{209} & 210 & \ding{210} & 211 & \ding{211} & 212 & \ding{212} & 213 & \ding{213} & 214 & \ding{214} & 215 & \ding{215} \\ \hline
550 216 & \ding{216} & 217 & \ding{217} & 218 & \ding{218} & 219 & \ding{219} & 220 & \ding{220} & 221 & \ding{221} & 222 & \ding{222} & 223 & \ding{223} \\ \hline
551 224 & \ding{224} & 225 & \ding{225} & 226 & \ding{226} & 227 & \ding{227} & 228 & \ding{228} & 229 & \ding{229} & 230 & \ding{230} & 231 & \ding{231} \\ \hline
552 232 & \ding{232} & 233 & \ding{233} & 234 & \ding{234} & 235 & \ding{235} & 236 & \ding{236} & 237 & \ding{237} & 238 & \ding{238} & 239 & \ding{239} \\ \hline
553 & & 241 & \ding{241} & 242 & \ding{242} & 243 & \ding{243} & 244 & \ding{244} & 245 & \ding{245} & 246 & \ding{246} & 247 & \ding{247} \\ \hline
554 248 & \ding{248} & 249 & \ding{249} & 250 & \ding{250} & 251 & \ding{251} & 252 & \ding{252} & 253 & \ding{253} & 254 & \ding{254} & & \\ \hline
555 \end{tabular}
556 \par}
557
558 \end{table}
559
560 \subsection{Generic commands}
561 The \Lpack{pifont} package has a general mechanism for coping with
562 Pi fonts. It provides the following generic commands with, in each case,
563 the first argument \m{family} specifying the name of the
564 Pi font family in question (such as \texttt{psy} for the Symbol font,
565 and \texttt{pzd} for the Zapf Dingbats font, see table~\vref{tab:families}).
566 If indicated, a second argument \m{number}
567 specifies the decimal position of a symbol in that font.
568
569 \begin{decl}
570 +\Pifont+ \arg{family}
571 \end{decl}
572
573 This switches to the font family \m{family}
574 and the encoding U.
575
576 \begin{decl}
577 +\Pisymbol+ \arg{family} \arg{number}
578 \end{decl}
579
580 This command typesets the specified symbol
581 (compare this with the +\ding+ command).
582
583 \begin{decl}
584 +\begin{Pilist}+ \arg{family} \arg{number}\\
585 +\begin{Piautolist}+ \arg{family} \arg{number}
586 \end{decl}
587
588 In the +Pilist+ environment the specified symbol is used in front
589 of each item in an itemized list (compare with the +dinglist+
590 environment).
591
592 +Piautolist+ is an environment where a series of symbols starting
593 with the one at the decimal position \m{number} in font family
594 \m{family} is used to number the items in an enumerated list
595 (compare with the +dingautolist+ environment).
596
597 \begin{decl}
598 +\Pifill+ \arg{family} \arg{number}\\
599 +\Piline+ \arg{family} \arg{number}
600 \end{decl}
601
602 +\Pifill+ acts like the other filling commands in \TeX, but
603 fills the space with a chosen symbol (compare with +\dingfill+).
604
605 +\Piline+ typesets a line consisting of several copies of
606 the specified symbol, with some space at the left and right
607 (compare with +\dingline+).
608
609
610
611 \section{NFSS classification}
612 Table~\vref{tab:families} lists all text and symbol font shapes
613 supported by the basic PSNFSS distribution,
614 and the related \ps\ fonts.
615 \NEWdescription{2004-09-15 v9.2}
616 With the exception of Charter and Utopia, these fonts are commercial products.
617 Therefore, most \TeX\ systems include free substitutes instead.
618
619 Available encodings are OT1, T1 and TS1, except for
620 Symbol and Zapf~Dingbats, which are implemented with encoding U.
621 See \cite{fntguide} for how to access a given font shape directly.
622
623 Only the font families +pplx+ and +pplj+ provide true small capitals
624 (and only in the regular series).
625 With the other families the shape `sc' refers to so-called `faked' small capitals,
626 whose typographical quality is -- at least -- questionable.
627
628 The math font families loaded by the
629 \Lpack{mathptm}, \Lpack{mathptmx}, \Lpack{mathpazo} and \Lpack{mathpple} packages
630 are not listed here.
631 See the documented source file \texttt{psfonts.dtx}
632 for information on this topic.
633
634 \begin{table}[p]
635 \caption{Font shapes supported by the basic PSNFSS distribution}
636 \label{tab:families}
637 \medskip
638
639 {\small
640 \begin{tabularx}{\linewidth}{|l|l|l|>{\raggedright\arraybackslash}X|}
641 \hline
642 \textbf{family} & \textbf{series} & \textbf{shape(s)} & \textbf{\ps{} font names}\\
643 \hline\hline
644 \multicolumn{4}{|c|}{\textit{Avant Garde}}\\ \hline
645 pag & m & n, sl, sc & AvantGarde-Book, AvantGarde-BookOblique\\ \hline
646 pag & b & n, sl, sc & AvantGarde-Demi, AvantGarde-DemiOblique\\ \hline \hline
647 \multicolumn{4}{|c|}{\textit{Bookman}}\\ \hline
648 pbk & l & n, sl, it, sc & Bookman-Light, Bookman-LightItalic\\ \hline
649 pbk & db & n, sl, it, sc & Bookman-Demi, Bookman-DemiItalic\\ \hline \hline
650 \multicolumn{4}{|c|}{\textit{Charter}}\\ \hline
651 bch & m & n, sl, it, sc & CharterBT-Roman, CharterBT-Italic\\ \hline
652 bch & b & n, sl, it, sc & CharterBT-Bold, CharterBT-BoldItalic\\ \hline \hline
653 \multicolumn{4}{|c|}{\textit{Courier}}\\ \hline
654 pcr & m & n, sl, sc & Courier, CourierOblique\\ \hline
655 pcr & b & n, sl, sc & Courier-Bold, Courier-BoldOblique\\ \hline \hline
656 \multicolumn{4}{|c|}{\textit{Helvetica}}\\ \hline
657 phv & m & n, sl, sc & Helvetica, Helvetica-Oblique\\ \hline
658 phv & b & n, sl, sc & Helvetica-Bold, Helvetica-BoldOblique\\ \hline
659 phv & mc & n, sl, sc & Helvetica-Narrow, Helvetica-Narrow-Oblique\\ \hline
660 phv & bc & n, sl, sc & Helvetica-Narrow-Bold, Helvetica-Narrow-BoldOblique\\\hline \hline
661 \multicolumn{4}{|c|}{\textit{New Century Schoolbook}}\\ \hline
662 pnc & m & n, sl, it, sc & NewCenturySchlbk-Roman, NewCenturySchlbk-Italic\\ \hline
663 pnc & b & n, sl, it, sc & NewCenturySchlbk-Bold, NewCenturySchlbk-BoldItalic\\ \hline \hline
664 \multicolumn{4}{|c|}{\textit{Palatino}}\\ \hline
665 ppl & m & n, sl, it, sc & Palatino-Roman, Palatino-Italic\\ \hline
666 ppl & b & n, sl, it, sc & Palatino-Bold, Palatino-BoldItalic\\ \hline
667 pplx & m & n, it, sc & Palatino-Roman, Palatino-Italic, Palatino-SC\\ \hline
668 pplx & b & n, it & Palatino-Bold, Palatino-BoldItalic\\ \hline
669 pplj & m & n, it, sc & Palatino-Roman, Palatino-SC, Palatino-Italic, Palatino-ItalicOsF\\ \hline
670 pplj & b & n, it & Palatino-Bold, Palatino-BoldOsF, Palatino-BoldItalic, Palatino-BoldItalicOsF\\ \hline \hline
671 \multicolumn{4}{|c|}{\textit{Times}}\\ \hline
672 ptm & m & n, sl, it, sc & Times-Roman, Times-Italic\\ \hline
673 ptm & b & n, sl, it, sc & Times-Bold, Times-BoldItalic\\ \hline \hline
674 \multicolumn{4}{|c|}{\textit{Zapf Chancery}}\\ \hline
675 pzc & mb & it & ZapfChancery-MediumItalic\\ \hline \hline
676 \multicolumn{4}{|c|}{\textit{Utopia}}\\ \hline
677 put & m & n, sl, it, sc & Utopia-Regular, Utopia-Italic\\ \hline
678 put & b & n, sl, it, sc & Utopia-Bold, Utopia-BoldItalic\\ \hline \hline
679 \multicolumn{4}{|c|}{\textit{Symbol}}\\ \hline
680 psy & m & n & Symbol\\ \hline \hline
681 \multicolumn{4}{|c|}{\textit{Zapf Dingbats}}\\ \hline
682 pzd & m & n & ZapfDingbats\\ \hline
683 \end{tabularx}
684 \par}
685 \end{table}
686
687
688
689 \section{Obsolete packages}
690 The macro packages listed in table \vref{tab:obsolete} should be considered as obsolete.
691 They are provided for compatibility with existing documents only.
692
693 \begin{table}[hbt]
694 \caption{Obsolete packages in the PSNFSS collection}
695 \label{tab:obsolete}
696 \medskip
697 {\footnotesize
698 \begin{center}
699 \renewcommand{\arraystretch}{1.2}
700 \begin{tabular}{|l|p{1.8cm}p{2.2cm}p{2.4cm}p{2.2cm}|}
701 \hline
702 \textbf{package} & \textbf{roman} & \textbf{sans serif} & \textbf{typewriter} & \textbf{math} \\\hline\hline
703 \Lpack{times} & Times
704 & Helvetica
705 & Courier
706 & \\\hline
707 \Lpack{palatino} & Palatino
708 & Helvetica
709 & Courier
710 & \\\hline
711 \Lpack{mathptm} & Times
712 &
713 &
714 & $\approx$ Times\\\hline
715 \Lpack{mathpple} & Palatino
716 &
717 &
718 & $\approx$ Palatino\\\hline
719 \Lpack{utopia} & Utopia
720 &
721 &
722 & \\\hline
723 \end{tabular}
724 \end{center}
725 }
726 \end{table}
727
728
729 \subsection{The packages \Lpack{times} and \Lpack{palatino}}
730 These packages do not load suitable math fonts,
731 and they do not scale the Helvetica fonts appropriately
732 to match Times and Palatino -- see section \ref{sec:helvet}.
733 Use \Lpack{mathptmx} or \Lpack{mathpazo} in conjunction with
734 \Lpack{helvet} and \Lpack{courier} instead!
735
736 In case you need to load Times or Palatino \emph{without} the
737 related math fonts of the PSNFSS bundle, you can still use the
738 basic NFSS commands. For instance,
739 \begin{quote}
740 +\renewcommand{\rmdefault}{ptm}+
741 \end{quote}
742 changes only the default roman font family to
743 \texttt{ptm}, i.e.\ Times.
744
745 \subsection{The package \Lpack{mathptm}}
746 The package \Lpack{mathptm} is a predecessor to \Lpack{mathptmx}.
747 In contrast to the latter and to \LaTeX's standard behavior,
748 lowercase Greek in math is typeset upright.
749 Zapf Chancery is used as the calligraphic math alphabet,
750 which causes some problems with proper spacing.
751 \Lpack{mathptm} needs the font \texttt{cmex9}, which may not
752 be available in Type~1 format.
753
754 \subsection{The package \Lpack{mathpple}}
755 \Lpack{mathpple} is a predecessor to \Lpack{mathpazo},
756 using also a set of virtual math fonts to go with Palatino.
757 The Greek alphabet is, however, taken from the
758 Euler fonts (which get slanted), rather than from the Pazo fonts.
759 The package \Lpack{mathpple} does not support the
760 Palatino SC/OsF fonts, and there is no `blackboard bold' math alphabet.
761 Further flaws are:
762 \begin{itemize}
763 \item The spacing within numbers and function names in formulas
764 is somewhat too loose.
765 \item The +\coprod+ symbol is missing.
766 \item There are no bold variants of +\partial+ and +\infty+.
767 \item +\jmath+ is taken from the CM math italic font, which does
768 not blend well with Palatino.
769 \item DVI viewers may exhibit problems as to rendering of the artificially slanted
770 Greek letters.
771 \end{itemize}
772 The newer \Lpack{mathpazo} package can be considered as
773 superior; yet you may still use \Lpack{mathpple}, if you prefer
774 the shape of its Greek letters.
775
776 \subsection{The package \Lpack{utopia}}
777 Use %%\NEWdescription{2003-11-17 v9.1}
778 of the \Lpack{utopia}
779 package is no longer recommended, because
780 the newer package \Lpack{fourier} provides a basically improved
781 interface to the Utopia typeface and loads suitable math fonts, too.
782 Notice that this package does \emph{not} belong to the PSNFSS collection!
783
784 Furthermore, the \LaTeX3 team does no longer regard the Utopia
785 fonts as a \emph{required} component of \LaTeX{},
786 because their license does not comply with the strict
787 guidelines of the FSF.
788
789
790 \section{Typeface samples}
791
792 The following samples show the regular font of each typeface family
793 supported by PSNFSS.
794 The particular font size and baselineskip is indicated below the font name.
795 Notice that Helvetica is scaled to 92\,\% of the nominal size.
796
797 \medskip
798
799 \sample{Times}{ptm}{10}{12pt}{}
800
801 \sample{Palatino}{pplx}{10}{12.4pt}{}
802
803 \sample{Bookman}{pbk}{9.6}{11.5pt}{}
804
805 \sample{Charter}{bch}{10}{12.4pt}{}
806
807 \sample{New Century Schoolbook}{pnc}{9.6}{12pt}{}
808
809 \ifutopia
810 \sample{Utopia}{put}{9.6}{12pt}{}
811 \fi
812
813 \sample{Helvetica}{phv}{10}{12pt}{}
814
815 \parbox[t]{\leftwidth}{%
816 {\raggedright\footnotesize
817 \mbox{}Avant\-Garde\\
818 9.6pt
819 \par}}
820 \hfill
821 \parbox[t]{\rightwidth}{
822 {\fontfamily{pag}\fontsize{9.6}{11.5pt}\selectfont\raggedright
823 Don't use Avant Garde for typesetting larger portions of text\,!
824 \par}}\medskip
825
826 \parbox[t]{\leftwidth}{
827 {\raggedright\footnotesize
828 Courier\\
829 10/12pt
830 \par}}
831 \hfill
832 \parbox[t]{\rightwidth}{
833 {\fontfamily{pcr}\fontsize{10}{12pt}\selectfont\raggedright
834 A monospaced typeface, suitable for typesetting filenames, URLs etc.
835 \par}}\medskip
836
837 \parbox[t]{\leftwidth}{
838 {\raggedright\footnotesize
839 Zapf Chancery\\
840 14.4pt
841 \par}}
842 \hfill
843 \parbox[t]{\rightwidth}{
844 {\fontfamily{pzc}\Large\raggedright
845 To Hermann Zapf -- whose strokes are the best.
846 \par}}\medskip
847
848
849
850 \section*{Credits}
851 The PSNFSS system was originally developed by Sebastian Rahtz.
852
853 The virtual \Lpack{mathptm} and \Lpack{mathptmx} fonts and the related packages
854 were created by Alan Jeffrey, Sebastian Rathz and Ulrik Vieth.
855
856 The \Lpack{mathpple} package and its virtual fonts are based
857 on earlier work by Aloysius Helminck. Special thanks to Daniel Schlieper
858 without whose initiative the package would not have been developed.
859
860 The Pazo math fonts and the related virtual fonts were created
861 by Diego Puga.
862
863
864
865 \begin{thebibliography}{1}
866 \raggedright
867
868 \bibitem{companion}
869 Frank Mittelbach et al.:
870 \textit{The LaTeX Companion}.\\
871 2nd edition. Addison Wesley, 2004.
872
873 %\bibitem{gcompanion}
874 %Michel Goossens, Sebastian Rahtz, and
875 %Frank Mittelbach:\\
876 %\textit{The LaTeX Graphics Companion}.\\
877 %Addison Wesley Longman, 1997.
878
879 \bibitem{fntguide}
880 \LaTeX3 Project Team (Ed.):
881 \textit{LaTeX2e font selection.}\\
882 CTAN: \path{macros/latex/doc/fntguide.pdf}\\
883 (Part of the \LaTeX{} online documentation)
884 \end{thebibliography}
885
886
887 \end{document}