aboutsummaryrefslogtreecommitdiff
path: root/fauxtari.rst
diff options
context:
space:
mode:
Diffstat (limited to 'fauxtari.rst')
-rw-r--r--fauxtari.rst60
1 files changed, 41 insertions, 19 deletions
diff --git a/fauxtari.rst b/fauxtari.rst
index be0562e..9e6c972 100644
--- a/fauxtari.rst
+++ b/fauxtari.rst
@@ -2,9 +2,9 @@
fauxtari
========
-------------------------------------------------
-Atari 8-bit-based font for Linux console and X11
-------------------------------------------------
+--------------------------------------------------------------------
+Atari 8-bit-based font for Linux console and X11/Wayland/Mac/Windows
+--------------------------------------------------------------------
.. include:: manhdr7.rst
@@ -12,8 +12,12 @@ DESCRIPTION
===========
**fauxtari** 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 **GLYPHS**, below.
+Linux console or graphical environments such as X11. Most of the
+glyphs are taken from the Atari XL/XE ROM font; see **GLYPHS**, below.
+
+Three font formats are provided: **psf**, for use with the console;
+**bdf**, for use with "old-school" X11 apps such as **xterm**\(1);
+and **ttf** for use with modern X11/Wayland/Mac/Windows apps.
APPEARANCE
==========
@@ -44,6 +48,8 @@ on the screen, in the console or with a fullscreen X terminal:
Of course, the smaller font sizes might be too small to read, especially
on smaller displays.
+The TrueType font is scalable, but always retains the pixelated look.
+
CONSOLE
=======
@@ -58,8 +64,32 @@ you can make this the default in **/etc/rc.d/rc.font**, or just put it
in **/etc/rc.d/rc.local**. Other Linux distributions will have their
own ways to set this up (especially systemd-based ones).
-X11
-===
+X11/etc
+=======
+
+TTF (scalable)
+--------------
+
+The scalable font is called **Fauxtari Scalable Mono**, and should be
+selectable from graphical applications that allow choosing the font.
+You may also see **Fauxtari Fixed Mono** in the list; this is the **bdf**
+font.
+
+It can also be used in **urxvt** and **xterm** (provided **xterm**
+was built with support for TTF fonts)::
+
+ urxvt -fn 'xft:Fauxtari Scalable Mono:pixelsize=16'
+
+ xterm -fa 'Fauxtari Scalable Mono' -fs 16
+
+The font can be scaled to any size, though it will look best if you
+stick with multiples of 8 pixels.
+
+The scalable font should also work on Wayland, Macintosh, or Windows
+systems, though this hasn't been tested.
+
+BDF (non-scalable)
+------------------
If the **bdf** fonts have been installed (via **make install** when
**bw-atari8-tools** is built), you should be able to launch a terminal
@@ -71,11 +101,11 @@ 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:
-- -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
-- -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
-- -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
For **urxvt**\(1), you might have to turn off the **boldFont** resource (set
it to an empty string), or run it as::
@@ -83,15 +113,7 @@ 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).
+list, or from your **URxvt.font** resource) for bold characters.
For **st** from suckless.org, run::