Add a --list-fonts option, since getting PostScript names out of TrueType

[sgt/halibut] / doc / output.but
diff --git a/doc/output.but b/doc/output.but

index 0cea3c2..7852692 100644 (file)
--- a/doc/output.but
+++ b/doc/output.but
@@ -664,8 +664,10 @@ the index.
  
  \dt \I{\cw{\\cfg\{html-nav-next-text\}}}\cw{\\cfg\{html-nav-next-text\}\{}\e{text}\cw{\}}
  
-\dd The text used for the \q{previous page} and \q{next page} links on
-the navigation bar.
+\dt \I{\cw{\\cfg\{html-nav-up-text\}}}\cw{\\cfg\{html-nav-up-text\}\{}\e{text}\cw{\}}
+
+\dd The text used for the \q{previous page}, \q{next page}, and \q{up}
+links on the navigation bar.
  
  \dt \I{\cw{\\cfg\{html-nav-separator\}}}\cw{\\cfg\{html-nav-separator\}\{}\e{text}\cw{\}}
  
@@ -773,7 +775,7 @@ comments.
  
  \dd If this is set to \c{true}, machine-readable relational links will
  be emitted in each HTML file (\I{\cw{<LINK>} tags}\cw{<LINK
-REL="}\e{next}\cw{">} and so on within the \i\cw{<HEAD>} section)
+REL="next">} and so on within the \i\cw{<HEAD>} section)
  providing links to related files. The same set of links are provided
  as in the navigation bar (with which this should not be confused).
  
@@ -965,6 +967,7 @@ The \i{default settings} for Halibut's HTML output format are:
  \c \cfg{html-post-versionid}{]}
  \c \cfg{html-nav-prev-text}{Previous}
  \c \cfg{html-nav-next-text}{Next}
+\c \cfg{html-nav-up-text}{Up}
  \c \cfg{html-nav-separator}{ | }
  \c
  \c \cfg{html-output-charset}{ASCII}
@@ -1668,36 +1671,10 @@ The directives in this section control which fonts Halibut uses for
  various kinds of text.  Directives for setting the font normally take
  three font names, the first of which is used for normal text, the
  second for emphasised text, and the third for code.  Any fonts which
-aren't specified are left unchanged.  Fonts are named using their
-PostScript names.
+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 are:
-
-\b \cw{Times-Roman}
-
-\b \cw{Times-Italic}
-
-\b \cw{Times-Bold}
-
-\b \cw{Times-BoldItalic}
-
-\b \cw{Helvetica}
-
-\b \cw{Helvetica-Oblique}
-
-\b \cw{Helvetica-Bold}
-
-\b \cw{Helvetica-BoldOblique}
-
-\b \cw{Courier}
-
-\b \cw{Courier-Oblique}
-
-\b \cw{Courier-Bold}
-
-\b \cw{Courier-BoldOblique}
-
+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.
@@ -1708,6 +1685,11 @@ 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.
  
+Fonts are specified using their PostScript names.  Running Halibut with
+the \i\cw{\-\-list-fonts} option causes it to display the PostScript
+names of all the fonts it intrinsically knows about, along with any
+fonts the were supplied as input files.
+
  \ii{Font sizes} are specified in PostScript \i{points} (72 to the inch).
  
  \dt \I{\cw{\\cfg\{paper-title-fonts\}}}\cw{\\cfg\{paper-title-fonts\}\{}\e{normal-font}\cw{\}}[\cw{\{}\e{emph-font}\cw{\}}[\cw{\{}\e{code-font}\cw{\}}]]