xref: /freebsd/usr.sbin/kbdmap/kbdmap.1 (revision e627b39baccd1ec9129690167cf5e6d860509655)
1.\" Copyright (c) March 1995 Wolfram Schneider <wosch@FreeBSD.org>. Berlin.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $Id: kbdmap.1,v 1.5 1996/08/23 00:56:08 mpp Exp $
26
27.Dd Mar 25, 1995
28.Dt KBDMAP 1
29.Os FreeBSD
30.Sh NAME
31.Nm kbdmap ,
32.Nm vidfont
33.Nd front end for syscons
34
35.Sh SYNOPSIS
36.Nm kbdmap
37.Op Fl K
38.Op Fl V
39.Op Fl d | Fl default
40.Op Fl h | Fl help
41.Op Fl l | Fl lang Ar language
42.Op Fl p | Fl print
43.Op Fl r | Fl restore
44.Op Fl s | Fl show
45.Op Fl v | Fl verbose
46
47.Sh DESCRIPTION
48.Nm kbdmap
49allow easy setting of available keymaps.
50.Nm vidfont
51do it for fonts.
52Both looking in a database for a description. Description is
53in English (default) or any other language.
54
55It is strongly recommended to not choose MSDOS codepage keymaps
56or fonts. Use the ISO standard if available! X11 does not
57support MSDOS codepage.
58
59.Sh OPTIONS
60.Bl -tag -width Ds
61.It Fl K
62Run as command
63.Xr kbdmap 1 .
64
65.It Fl V
66Run as command
67.Xr vidfont 1 .
68
69.It Fl d , Fl default
70Use default language. Ignore $LANG.
71
72.It Fl h , Fl help
73Print options and exit.
74
75.It Fl l , Fl lang Ar language
76Use
77.Ar language
78for description and menu
79
80.It Fl p , Fl print
81Print description  of available keymaps or fonts
82to stdout and exit.
83
84.It Fl r , Fl restore
85Load default font from /etc/sysconfig
86
87.It Fl s , Fl show
88Show currently supported languages and exit.
89
90.It Fl v , Fl verbose
91More warnings.
92
93.Sh ENVIRONMENT
94.Bl -tag -width /etc/master.passwdxx -compact
95.Pa LANG
96Prefered language.
97
98
99.Sh FILES
100.Bl -tag -width /etc/master.passwd -compact
101.Pa /usr/share/syscons/keymaps/INDEX.keymaps
102Database for keymaps.
103
104.Pa /usr/share/syscons/fonts/INDEX.fonts
105Database for fonts.
106
107.Pa /etc/sysconfig
108Default font.
109
110
111.Pa /usr/X11/lib/X11/locale/locale.alias
112Describe common LANG values.
113
114.Sh BUGS
115.\" .Nm kbdmap/vidfont
116.\" does not know which font is in use. E.g. if the current font
117.\" is iso-8859-1 and you chose lang 'ru' (for Russian)
118.\" you get funny latin1 characters and not russkij shrift.
119.\"
120.Nm vidcontrol
121and
122.Nm kbdcontrol
123work only on a (virtual) console an not with X11.
124
125.Sh SEE ALSO
126.Xr kbdcontrol 1 ,
127.Xr vidcontrol 1 ,
128.Xr sysconfig 5 ,
129.Xr dialog 1 .
130
131.Sh HISTORY
132.Nm kbdmap/vidfont
133command appeared in
134.Fx 2.1 .
135
136.Sh AUTHOR
137Wolfram Schneider
138.Aq wosch@FreeBSD.org ,
139Berlin.
140