diff options
Diffstat (limited to 'fauxtari.7')
-rw-r--r-- | fauxtari.7 | 66 |
1 files changed, 42 insertions, 24 deletions
@@ -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 |