aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-24 05:35:34 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-24 05:35:34 -0400
commit3a234544fd086ee6f70d2ae1189fa7c1868104c6 (patch)
tree0809a1f2cfe8a7b1649f6a34de0e83443e581d36
parent4c7f9c97e166c52563108f2e85c3c6acd71106bd (diff)
downloadbw-atari8-tools-3a234544fd086ee6f70d2ae1189fa7c1868104c6.tar.gz
fonts: tweak doc.
-rw-r--r--fauxtari.763
-rw-r--r--fauxtari.rst39
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