From 95bc72af9f98cc350cd88af7766fd17b425fd978 Mon Sep 17 00:00:00 2001
From: ben <ben@cda61777-01e9-0310-a592-d414129be87e>
Date: Tue, 13 Feb 2007 22:05:16 +0000
Subject: [PATCH] Document TrueType support.

git-svn-id: svn://svn.tartarus.org/sgt/halibut@7284 cda61777-01e9-0310-a592-d414129be87e
---
 doc/index.but  |  7 +++++--
 doc/output.but | 25 ++++++++++++++++---------
 2 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/doc/index.but b/doc/index.but
index af31cd8..6dc0953 100644
--- a/doc/index.but
+++ b/doc/index.but
@@ -689,8 +689,11 @@ directive
 \IM{embedding fonts} embedding fonts
 \IM{embedding fonts} fonts, embedding
 
-\IM{Type 1 fonts} Type 1 fonts
-\IM{Type 1 fonts} fonts, Type 1
+\IM{Type 1 font} Type 1 fonts
+\IM{Type 1 font} fonts, Type 1
+
+\IM{TrueType font} TrueType fonts
+\IM{TrueType font} fonts, TrueType
 
 \IM{font sizes} font size
 
diff --git a/doc/output.but b/doc/output.but
index 7852692..c698a2b 100644
--- a/doc/output.but
+++ b/doc/output.but
@@ -1675,15 +1675,22 @@ aren't specified are left unchanged.
 
 Halibut intrinsically knows about some fonts, and these fonts are also
 built into all PDF and most PostScript implementations.
-These fonts can be used without further formality.  To use any other
-font, Halibut needs at least to know its measurements, which are
-provided in an \i{Adobe Font Metrics} (\I{AFM files}AFM) file.
-Halibut can also \I{embedding fonts}embed \i{Type 1 fonts} in its PDF
-and PostScript output if provided with font file in either hexadecimal (\I{PFA
-files}PFA) or IBM PC (\I{PFB files}PFB) format.  To provide
-an AFM, PFA, or PFB file to Halibut, simply name it on Halibut's command
-line.  If a PFA or PFB file is specified, the corresponding AFM file
-must come first.
+These fonts can be used without further formality.  Halibut can also use
+other fonts, and can \I{embedding fonts}embed them it its PDF and
+PostScript output.  These other fonts are supplied to Halibut by
+simply adding them to the list of input files on its command line.
+
+To use a \i{Type 1 font} Halibut needs both the font file itself,
+in either hexadecimal (\I{PFA files}PFA) or IBM PC (\I{PFB files}PFB)
+format, and an \i{Adobe Font Metrics} (\I{AFM files}AFM) file.  The AFM
+file must be specified first on the command line.  If Halibut gets an
+AFM file without a corresponding Type 1 font file, the PostScript and
+PDF output files will still use that font, but they won't contain it.
+
+Using a \i{TrueType font} is rather simpler, and simply requires you to
+pass the font file to Halibut.  Halibut does place a few restrictions on
+TrueType fonts, notably that they must include a \i{Unicode} mapping
+table and a PostScript name.
 
 Fonts are specified using their PostScript names.  Running Halibut with
 the \i\cw{\-\-list-fonts} option causes it to display the PostScript
-- 
2.11.0