From 3a234544fd086ee6f70d2ae1189fa7c1868104c6 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 24 Jul 2024 05:35:34 -0400
Subject: fonts: tweak doc.

---
 fauxtari.7   | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 fauxtari.rst | 39 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 100 insertions(+), 2 deletions(-)

diff --git a/fauxtari.7 b/fauxtari.7
index bf980f8..de88ee2 100644
--- a/fauxtari.7
+++ b/fauxtari.7
@@ -175,8 +175,60 @@ aliases (added to \fBfonts.alias\fP in the font directory); the full
 names are:
 .INDENT 0.0
 .IP \(bu 2
-TODO
+\-bw\-fauxtari\-medium\-r\-normal\-\-8\-80\-75\-75\-c\-80\-iso10646\-1
+.IP \(bu 2
+\-bw\-fauxtari\-medium\-r\-normal\-\-16\-160\-75\-75\-c\-160\-iso10646\-1
+.IP \(bu 2
+\-bw\-fauxtari\-medium\-r\-normal\-\-24\-240\-75\-75\-c\-240\-iso10646\-1
+.UNINDENT
+.sp
+For \fBurxvt\fP(1), you might have to turn off the \fBboldFont\fP resource (set
+it to an empty string), or run it as:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+urxvt \-fn fauxtari\-16 \-fb ""
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This keeps \fBurxvt\fP from using some other font (from its built\-in
+list, or from your \fBURxvt.font\fP resource) for bold characters. You
+could also try:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+urxvt \-fn \(aqxft:Fauxtari:size=16\(aq
+.ft P
+.fi
+.UNINDENT
 .UNINDENT
+.sp
+Note that the "size=" must be one of the available sizes (8, 16, or
+24). Or, rather, \fBurxvt\fP \fIwill\fP use one of these sizes, whichever is the
+next larger than the size you gave it (or, it\(aqll refuse to load the
+font, if the size is too large).
+.sp
+For \fBst\fP from suckless.org, run:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+st \-f fauxtari\-16
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+It\(aqs possible to use the fonts with \fBrxvt\fP, but since \fBrxvt\fP
+doesn\(aqt support Unicode, it won\(aqt be all that useful except for plain
+ASCII text. Why are you still using \fBrxvt\fP, anyway?
 .SH GLYPHS
 .sp
 All 3 sizes contain the same set of glyphs. These include:
@@ -216,6 +268,15 @@ copyright symbol, and the Euro currency sign.
 .IP \(bu 2
 TODO: Commodore 64 graphics characters.
 .UNINDENT
+.SH LIMITATIONS
+.INDENT 0.0
+.IP \(bu 2
+Since these are bitmap fonts, applications generally won\(aqt render them at
+arbitrary sizes.
+.IP \(bu 2
+There are no true descenders, since the Atari ROM character set doesn\(aqt use them.
+Someday I may add hand\-hacked true descender versions of the fonts.
+.UNINDENT
 .SH COPYRIGHT
 .sp
 WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
diff --git a/fauxtari.rst b/fauxtari.rst
index fa3fbe9..be0562e 100644
--- a/fauxtari.rst
+++ b/fauxtari.rst
@@ -71,7 +71,35 @@ Replace the 16 with 8 or 24, for the other sizes. These names are
 aliases (added to **fonts.alias** in the font directory); the full
 names are:
 
-- TODO
+- -bw-fauxtari-medium-r-normal--8-80-75-75-c-80-iso10646-1
+
+- -bw-fauxtari-medium-r-normal--16-160-75-75-c-160-iso10646-1
+
+- -bw-fauxtari-medium-r-normal--24-240-75-75-c-240-iso10646-1
+
+For **urxvt**\(1), you might have to turn off the **boldFont** resource (set
+it to an empty string), or run it as::
+
+  urxvt -fn fauxtari-16 -fb ""
+
+This keeps **urxvt** from using some other font (from its built-in
+list, or from your **URxvt.font** resource) for bold characters. You
+could also try::
+
+  urxvt -fn 'xft:Fauxtari:size=16'
+
+Note that the "size=" must be one of the available sizes (8, 16, or
+24). Or, rather, **urxvt** *will* use one of these sizes, whichever is the
+next larger than the size you gave it (or, it'll refuse to load the
+font, if the size is too large).
+
+For **st** from suckless.org, run::
+
+  st -f fauxtari-16
+
+It's possible to use the fonts with **rxvt**, but since **rxvt**
+doesn't support Unicode, it won't be all that useful except for plain
+ASCII text. Why are you still using **rxvt**, anyway?
 
 GLYPHS
 ======
@@ -112,4 +140,13 @@ All 3 sizes contain the same set of glyphs. These include:
 
 - TODO: Commodore 64 graphics characters.
 
+LIMITATIONS
+===========
+
+- Since these are bitmap fonts, applications generally won't render them at
+  arbitrary sizes.
+
+- There are no true descenders, since the Atari ROM character set doesn't use them.
+  Someday I may add hand-hacked true descender versions of the fonts.
+
 .. include:: manftr.rst
-- 
cgit v1.2.3