wsfontload(8): Mention .wsf font files. Fix formatting.
This commit is contained in:
parent
f2766c1123
commit
789d65f63b
|
@ -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 @@ or from standard input if
|
|||
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 @@ Specifies that the font data is ordered right-to-left bit wise.
|
|||
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 @@ Sets the width of a font character in pixels.
|
|||
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.
|
||||
|
|
Loading…
Reference in New Issue