[src/trunk]: src/usr.sbin/wsfontload wsfontload(8): Mention .wsf font files. ...

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/fe913db3f08f
branches:  trunk
changeset: 366694:fe913db3f08f
user:      uwe <uwe%NetBSD.org@localhost>
date:      Wed Jun 08 22:38:29 2022 +0000

description:
wsfontload(8): Mention .wsf font files.  Fix formatting.

diffstat:

 usr.sbin/wsfontload/wsfontload.8 |  89 ++++++++++++++++++++++++++++-----------
 1 files changed, 63 insertions(+), 26 deletions(-)

diffs (165 lines):

diff -r d3da56dd3eb3 -r fe913db3f08f usr.sbin/wsfontload/wsfontload.8
--- a/usr.sbin/wsfontload/wsfontload.8  Wed Jun 08 21:55:51 2022 +0000
+++ b/usr.sbin/wsfontload/wsfontload.8  Wed Jun 08 22:38:29 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wsfontload.8,v 1.31 2021/04/24 09:18:44 nia Exp $
+.\"    $NetBSD: wsfontload.8,v 1.32 2022/06/08 22:38:29 uwe Exp $
 .\"
 .\" Copyright (c) 1999, 2001
 .\"    Matthias Drochner.  All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd April 24, 2021
+.Dd June 9, 2022
 .Dt WSFONTLOAD 8
 .Os
 .Sh NAME
@@ -39,7 +39,8 @@
 .Op Fl N Ar name
 .Op Fl w Ar width
 .Op Ar fontfile
-.Nm Fl l
+.Nm
+.Fl l
 .Sh DESCRIPTION
 The
 .Nm
@@ -54,7 +55,7 @@
 is not provided.
 .Pp
 The options are:
-.Bl -tag -width xxxxxxxxxxx
+.Bl -tag -width Fl
 .It Fl B
 Specifies that the font data is ordered right-to-left byte wise.
 The default is left-to-right.
@@ -63,25 +64,26 @@
 The default is left-to-right.
 .It Fl e Ar encoding
 Sets the encoding of the font.
-This can be either a symbolic abbreviation or a numeric value.
-Currently recognized abbreviations are:
-.Bl -tag -width xxxxxxx
+This can be either a symbolic name or a numeric value.
+Currently recognized names are:
+.Bl -tag -width Ql
 .It Ql iso
 ISO-8859-1 encoding
 .It Ql ibm
-IBM encoded fonts
+IBM CP437 encoding
 .It Ql pcvt
 the custom encoding of the supplemental fonts which came with the
 .Bx
 .Dq pcvt
 console driver
 .It Ql iso2
-ISO-8859-2 (east european) encoding
+ISO-8859-2 (Eastern European) encoding
 .It Ql iso7
-ISO-8859-7 (greek) encoding
+ISO-8859-7 (Greek) encoding
 .It Ql koi8r
-KOI8-R (russian) encoding
+KOI8-R (Russian) encoding
 .El
+.Pp
 Per default,
 .Ql iso
 is assumed.
@@ -106,43 +108,78 @@
 Default is 8.
 .El
 .Pp
+.Nm
+supports
+.Ql \&.wsf
+file format that contains the necessary information about the font in
+the font file itself.
+Such files can be loaded without specifying any arguments,
+though
+.Fl N
+can be used to override the font name.
+.Pp
 Typically, the
 .Nm
-utility will be executed in system startup by the
-.Pa /etc/rc.d/wscons
-script, controlled by the
-.Pa /etc/wscons.conf
-configuration file.
+utility will be executed during system startup by the
+.Xr rc 8
+script.
+See
+.Xr wscons.conf 5 .
 .Sh FILES
-.Pa /etc/wscons.conf
+.Bl -item -compact
+.It
 .Pa /usr/share/wscons/fonts
+.El
 .Sh EXAMPLES
-Load the ISO-encoded 16x32 Spleen font and switch the first console
-screen to use it:
+Load ISO-encoded 20-pixel high Terminus font
+and use it on the current console
 .Pp
-.Bd -offset indent -unfilled
-# wsfontload -w 16 -h 32 -e iso -N spleen32 \\
+.Bd -literal -offset indent
+# wsfontload /usr/share/wscons/fonts/ter-120n.wsf
+# wsfontload -l | grep Terminus
+Terminus20-ISO8859-1 10x20
+# wsconsctl -f `tty` -dw font=Terminus20-ISO8859-1
+.Ed
+.Pp
+Load the ISO-encoded 16\[tmu]32 Spleen font
+and switch the first console screen to use it:
+.Pp
+.Bd -literal -offset indent
+# wsfontload -w 16 -h 32 -e iso -N spleen32 \e
        /usr/share/wscons/fonts/spleen-16x32.fnt
 # wsconsctl -dw font=spleen32
 .Ed
 .Pp
-Load the IBM-encoded 8\(mu8-font from the
+Load the IBM-encoded 8\[tmu]8-font from the
 .Xr wscons 4
 distribution:
 .Pp
-.Bd -offset indent -unfilled
-# wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808
+.Bd -literal -offset indent
+# wsfontload -N myname -h 8 -e ibm \e
+    /usr/share/wscons/fonts/vt220l.808
 .Ed
 .Pp
-This (or another 8\(mu8-font) is necessary to use the
+This or another 8\[tmu]8-font is necessary to use the
 50-line screen type on
 .Xr vga 4
 displays.
 .Sh SEE ALSO
 .Xr wscons 4 ,
-.Xr wsconscfg 8 ,
+.Xr wsfont 4 ,
+.Xr wscons.conf 5 ,
+.\" XXX: BUGS: not yet
+.\" .Xr wsf 5 ,
 .Xr wsconsctl 8
+.Sh HISTORY
+Support for
+.Ql \&.wsf
+font files appeared in
+.Nx 10.0 .
 .Sh BUGS
 Many features are missing.
 .Pp
+The
+.Ql \&.wsf
+file format is undocumented.
+.Pp
 There is no way to remove a loaded font.