Wed Jun 8 12:47:51 2011 UTC ()
Sort options. New sentence, new line.


(wiz)
diff -r1.25 -r1.26 src/usr.sbin/wsfontload/wsfontload.8
cvs diff -r1.25 -r1.26 src/usr.sbin/wsfontload/wsfontload.8 (expand / switch to unified diff)

--- src/usr.sbin/wsfontload/wsfontload.8 2011/06/08 10:25:21 1.25
+++ src/usr.sbin/wsfontload/wsfontload.8 2011/06/08 12:47:51 1.26
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: wsfontload.8,v 1.25 2011/06/08 10:25:21 drochner Exp $ 1.\" $NetBSD: wsfontload.8,v 1.26 2011/06/08 12:47:51 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 1999, 2001 3.\" Copyright (c) 1999, 2001
4.\" Matthias Drochner. All rights reserved. 4.\" Matthias Drochner. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
@@ -22,131 +22,114 @@ @@ -22,131 +22,114 @@
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE. 25.\" SUCH DAMAGE.
26.\" 26.\"
27.Dd May 4, 2003 27.Dd May 4, 2003
28.Dt WSFONTLOAD 8 28.Dt WSFONTLOAD 8
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm wsfontload 31.Nm wsfontload
32.Nd "load a font bitmap into the wsfont pool or a wscons display device" 32.Nd "load a font bitmap into the wsfont pool or a wscons display device"
33.Sh SYNOPSIS 33.Sh SYNOPSIS
34.Nm 34.Nm
35.Bk -words 35.Op Fl Bbv
 36.Op Fl e Ar encoding
36.Op Fl f Ar wsdev 37.Op Fl f Ar wsdev
37.Ek 
38.Bk -words 
39.Op Fl w Ar width 
40.Ek 
41.Bk -words 
42.Op Fl h Ar height 38.Op Fl h Ar height
43.Ek 
44.Bk -words 
45.Op Fl e Ar encoding 
46.Ek 
47.Bk -words 
48.Op Fl N Ar name 39.Op Fl N Ar name
49.Ek 40.Op Fl w Ar width
50.Bk -words 
51.Op Fl b 
52.Ek 
53.Bk -words 
54.Op Fl B 
55.Ek 
56.Bk -words 
57.Op Fl v 
58.Ek 
59.Op Ar fontfile 41.Op Ar fontfile
60.Sh DESCRIPTION 42.Sh DESCRIPTION
61The 43The
62.Nm 44.Nm
63utility loads a font bitmap into the wsfont font pool 45utility loads a font bitmap into the wsfont font pool
64(or a wscons device if the device driver supports this). 46(or a wscons device if the device driver supports this).
65The font gets assigned a name in this process which it can be referred to 47The font gets assigned a name in this process which it can be referred to
66by later for use on a display screen. 48by later for use on a display screen.
67The font is loaded from the specified 49The font is loaded from the specified
68.Ar fontfile , 50.Ar fontfile ,
69or from standard input if 51or from standard input if
70.Ar fontfile 52.Ar fontfile
71is not provided. 53is not provided.
72.Pp 54.Pp
73The options are: 55The options are:
74.Bl -tag -width xxxxxxxxxxx 56.Bl -tag -width xxxxxxxxxxx
75.It Fl f Ar wsdev 57.It Fl B
76Specify the device to operate on. 58Specifies that the font data is ordered right-to-left byte wise.
77Default is 59The default is left-to-right.
78.Pa /dev/wsfont . 60.It Fl b
79.It Fl w Ar width 61Specifies that the font data is ordered right-to-left bit wise.
80Sets the width of a font character in pixels. 62The default is left-to-right.
81Default is 8. 
82.It Fl h Ar height 
83Sets the height of a font character in pixels. 
84Default is 16. 
85.It Fl e Ar encoding 63.It Fl e Ar encoding
86Sets the encoding of the font. 64Sets the encoding of the font.
87This can be either a symbolic abbreviation or a numeric value. 65This can be either a symbolic abbreviation or a numeric value.
88Currently recognized abbreviations are: 66Currently recognized abbreviations are:
89.Bl -tag -width xxxxxxx 67.Bl -tag -width xxxxxxx
90.It Ql iso 68.It Ql iso
91ISO-8859-1 encoding 69ISO-8859-1 encoding
92.It Ql ibm 70.It Ql ibm
93IBM encoded fonts 71IBM encoded fonts
94.It Ql pcvt 72.It Ql pcvt
95the custom encoding of the supplemental fonts which came with the 73the custom encoding of the supplemental fonts which came with the
96.Bx 74.Bx
97.Dq pcvt 75.Dq pcvt
98console driver 76console driver
99.It Ql iso2 77.It Ql iso2
100ISO-8859-2 (east european) encoding 78ISO-8859-2 (east european) encoding
101.It Ql iso7 79.It Ql iso7
102ISO-8859-7 (greek) encoding 80ISO-8859-7 (greek) encoding
103.It Ql koi8r 81.It Ql koi8r
104KOI8-R (russian) encoding 82KOI8-R (russian) encoding
105.El 83.El
106Per default, 84Per default,
107.Ql iso 85.Ql iso
108is assumed. 86is assumed.
 87.It Fl f Ar wsdev
 88Specify the device to operate on.
 89Default is
 90.Pa /dev/wsfont .
 91.It Fl h Ar height
 92Sets the height of a font character in pixels.
 93Default is 16.
109.It Fl N Ar name 94.It Fl N Ar name
110Specifies a name which can be used later to refer to the font. 95Specifies a name which can be used later to refer to the font.
111If none is given, the 96If none is given, the
112.Ar fontfile 97.Ar fontfile
113name is used to create one. 98name is used to create one.
114.It Fl b 
115Specifies that the font data is ordered right-to-left bit wise. 
116The default is left-to-right. 
117.It Fl B 
118Specifies that the font data is ordered right-to-left byte wise. 
119The default is left-to-right. 
120.It Fl v 99.It Fl v
121Prints the font's properties before loading it. 100Prints the font's properties before loading it.
 101.It Fl w Ar width
 102Sets the width of a font character in pixels.
 103Default is 8.
122.El 104.El
123.Pp 105.Pp
124Typically, the 106Typically, the
125.Nm 107.Nm
126utility will be executed in system startup by the 108utility will be executed in system startup by the
127.Pa /etc/rc.d/wscons 109.Pa /etc/rc.d/wscons
128script, controlled by the 110script, controlled by the
129.Pa /etc/wscons.conf 111.Pa /etc/wscons.conf
130configuration file. 112configuration file.
131.Sh FILES 113.Sh FILES
132.Pa /etc/wscons.conf 114.Pa /etc/wscons.conf
133.Pa /usr/share/wscons/fonts 115.Pa /usr/share/wscons/fonts
134.Sh EXAMPLES 116.Sh EXAMPLES
135.Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808 117.Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808
136.Pp 118.Pp
137Load the IBM-encoded 8\(mu8-font from the 119Load the IBM-encoded 8\(mu8-font from the
138.Xr wscons 4 120.Xr wscons 4
139distribution. This (or another 8\(mu8-font) is necessary to use the 121distribution.
 122This (or another 8\(mu8-font) is necessary to use the
14050-line screen type on 12350-line screen type on
141.Xr vga 4 124.Xr vga 4
142displays. 125displays.
143.Pp 126.Pp
144.Dl wsfontload -N orator -e ibm /usr/share/wscons/fonts/orator.816 127.Dl wsfontload -N orator -e ibm /usr/share/wscons/fonts/orator.816
145.Dl wsconsctl -dw font=orator 128.Dl wsconsctl -dw font=orator
146.Pp 129.Pp
147Load the 130Load the
148.Dq orator 131.Dq orator
149IBM-encoded 8\(mu16 font and switch the first console screen 132IBM-encoded 8\(mu16 font and switch the first console screen
150(ttyE0, wsconsctl's default) to this alternate font. 133(ttyE0, wsconsctl's default) to this alternate font.
151.Sh SEE ALSO 134.Sh SEE ALSO
152.Xr wscons 4 , 135.Xr wscons 4 ,