fonts: WIP.

1 files changed, 42 insertions, 24 deletions

diff --git a/fauxtari.7 b/fauxtari.7
index de88ee2..8d81cb9 100644
--- a/fauxtari.7
+++ b/fauxtari.7
@@ -29,12 +29,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 ..
 .TH "FAUXTARI" 7 "2024-07-24" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
-fauxtari \- Atari 8-bit-based font for Linux console and X11
+fauxtari \- Atari 8-bit-based font for Linux console and X11/Wayland/Mac/Windows
 .SH DESCRIPTION
 .sp
 \fBfauxtari\fP is a set of monospaced bitmap fonts for use with the
-Linux console or X11. Most of the glyphs are taken from the Atari
-XL/XE ROM font; see \fBGLYPHS\fP, below.
+Linux console or graphical environments such as X11. Most of the
+glyphs are taken from the Atari XL/XE ROM font; see \fBGLYPHS\fP, below.
+.sp
+Three font formats are provided: \fBpsf\fP, for use with the console;
+\fBbdf\fP, for use with "old\-school" X11 apps such as \fBxterm\fP(1);
+and \fBttf\fP for use with modern X11/Wayland/Mac/Windows apps.
 .SH APPEARANCE
 .sp
 The console (\fBpsf\fP files) and X11 (\fBbdf\fP files) fonts each come
@@ -134,6 +138,8 @@ _
 .sp
 Of course, the smaller font sizes might be too small to read, especially
 on smaller displays.
+.sp
+The TrueType font is scalable, but always retains the pixelated look.
 .SH CONSOLE
 .sp
 If the \fBpsf\fP fonts have been installed to the standard console font
@@ -154,7 +160,35 @@ Replace the 16 with 8 or 24, for the other sizes. For Slackware Linux,
 you can make this the default in \fB/etc/rc.d/rc.font\fP, or just put it
 in \fB/etc/rc.d/rc.local\fP\&. Other Linux distributions will have their
 own ways to set this up (especially systemd\-based ones).
-.SH X11
+.SH X11/ETC
+.SS TTF (scalable)
+.sp
+The scalable font is called \fBFauxtari Scalable Mono\fP, and should be
+selectable from graphical applications that allow choosing the font.
+You may also see \fBFauxtari Fixed Mono\fP in the list; this is the \fBbdf\fP
+font.
+.sp
+It can also be used in \fBurxvt\fP and \fBxterm\fP (provided \fBxterm\fP
+was built with support for TTF fonts):
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+urxvt \-fn \(aqxft:Fauxtari Scalable Mono:pixelsize=16\(aq
+
+xterm \-fa \(aqFauxtari Scalable Mono\(aq \-fs 16
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The font can be scaled to any size, though it will look best if you
+stick with multiples of 8 pixels.
+.sp
+The scalable font should also work on Wayland, Macintosh, or Windows
+systems, though this hasn\(aqt been tested.
+.SS BDF (non\-scalable)
 .sp
 If the \fBbdf\fP fonts have been installed (via \fBmake install\fP when
 \fBbw\-atari8\-tools\fP is built), you should be able to launch a terminal
@@ -175,11 +209,11 @@ aliases (added to \fBfonts.alias\fP in the font directory); the full
 names are:
 .INDENT 0.0
 .IP \(bu 2
-\-bw\-fauxtari\-medium\-r\-normal\-\-8\-80\-75\-75\-c\-80\-iso10646\-1
+\-bw\-fauxtari fixed mono\-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
+\-bw\-fauxtari fixed mono\-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
+\-bw\-fauxtari fixed mono\-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
@@ -196,23 +230,7 @@ urxvt \-fn fauxtari\-16 \-fb ""
 .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).
+list, or from your \fBURxvt.font\fP resource) for bold characters.
 .sp
 For \fBst\fP from suckless.org, run:
 .INDENT 0.0