Initial import from FreeBSD RELENG_4:
[dragonfly.git] / usr.sbin / pcvt / loadfont / loadfont.1
1 .\" Copyright (c) 1992, 2000 Hellmuth Michaelis
2 .\"
3 .\" All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\"    notice, this list of conditions and the following disclaimer in the
12 .\"    documentation and/or other materials provided with the distribution.
13 .\"
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 .\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
18 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24 .\"
25 .\" Last Edit-Date: [Mon Mar 27 17:07:57 2000]
26 .\"
27 .\" $FreeBSD: src/usr.sbin/pcvt/loadfont/loadfont.1,v 1.9.2.6 2002/12/29 16:35:43 schweikh Exp $
28 .\"
29 .Dd March 27, 2000
30 .Dt LOADFONT 1
31 .Os
32 .Sh NAME
33 .Nm loadfont
34 .Nd pcvt utility for loading fonts into VGA/EGA boards
35 .Sh SYNOPSIS
36 .Nm
37 .Op Fl c Ar charsetno
38 .Op Fl d Ar devicefile
39 .Op Fl f Ar fontfilename
40 .Op Fl i
41 .Sh DESCRIPTION
42 The
43 .Nm
44 utility is used to load fonts needed for proper operation of the pcvt
45 VT220 driver on EGA and VGA boards into the font ram of this boards.
46 .Pp
47 The options are as follows:
48 .Bl -tag -width Ds
49 .It Fl c
50 Specifies the slot, the font is to load into.
51 EGA boards have four
52 slots and VGA boards have eight slots available for downloading fonts.
53 .It Fl d
54 Specifies the devicefile to use.
55 .It Fl f
56 Specifies the file which contains the font to be downloaded.
57 .It Fl i
58 Gives information what type(s) of font do currently reside in which slot.
59 This is also the default behaviour if no options are specified on the commandline.
60 .El
61 .Pp
62 This utility is used only on EGA and VGA boards, as MDA, HCG and CGA boards
63 do not have downloadable character sets available.
64 .Sh FILES
65 The following fontfiles are available in the pcvt distribution:
66 .Bd -literal
67 /usr/share/misc/pcvtfonts/vt220l.808:   8x8  IBM II font
68 /usr/share/misc/pcvtfonts/vt220h.808:   8x8  Extension font
69 /usr/share/misc/pcvtfonts/vt220l.810:   8x10 IBM II font
70 /usr/share/misc/pcvtfonts/vt220h.810:   8x10 Extension font
71 /usr/share/misc/pcvtfonts/vt220l.814:   8x14 IBM II font
72 /usr/share/misc/pcvtfonts/vt220h.814:   8x14 Extension font
73 /usr/share/misc/pcvtfonts/vt220l.816:   8x16 IBM II font
74 /usr/share/misc/pcvtfonts/vt220h.816:   8x16 Extension font
75 .Ed
76 .Sh EXAMPLES
77 The command
78 .Dq Li loadfont -c0 -f/usr/share/misc/pcvtfonts/vt220l.816
79 loads a 8x16 font containing the standard IBM characterset II into font slot
80 0 on a VGA or EGA board.
81 .Sh BUGS
82 No known bugs
83 .Sh SEE ALSO
84 .Xr cursor 1 ,
85 .Xr scon 1 ,
86 .Xr pcvt 4 ,
87 .Xr ispcvt 8