Debian Codegraph @

upstream/debian-unstable/man8/mapscrn.8

raw
1 .\" @(#)man/man8/mapscrn.8 1.0 3/19/93 17:04:00
2 .TH MAPSCRN 8 "24 October 2024" "kbd"
3 .SH NAME
4 mapscrn \- load screen output mapping table
5 .SH SYNOPSIS
6 .BR mapscrn
7 [\fI\,options\/\fR]
8 .I mapfile
9 .SH DESCRIPTION
10 The
11 .B mapscrn
12 command is obsolete - its function is now built-in into setfont.
13 However, for backwards compatibility it is still available
14 as a separate command.
15 .LP
16 The
17 .I mapscrn
18 command loads a user defined output character mapping table into the
19 console driver. The console driver may be later put into
20 .B use user-defined mapping table
21 mode by outputting a special escape sequence to the console device.
22 This sequence is
23 .I <esc>(K
24 for the
25 .B G0
26 character set and
27 .I <esc>)K
28 for the
29 .B G1
30 character set.
31 When the
32 .I -o
33 option is given, the old map is saved in
34 .I map.orig.
35 .SH USE
36 There are two kinds of mapping tables: direct-to-font tables,
37 that give a font position for each user byte value, and user-to-unicode
38 tables that give a unicode value for each user byte. The corresponding
39 glyph is now found using the unicode index of the font.
40 The command
41 .RS
42 mapscrn trivial
43 .RE
44 sets up a one-to-one direct-to-font table where user bytes
45 directly address the font. This is useful for fonts that are
46 in the same order as the character set one uses.
47 A command like
48 .RS
49 mapscrn 8859-2
50 .RE
51 sets up a user-to-unicode table that assumes that the user
52 uses ISO 8859-2.
53 .SH "INPUT FORMAT"
54 The
55 .I mapscrn
56 command can read the map in either of two formats:
57 .br
58 1. 256 or 512 bytes binary data
59 .br
60 2. two-column text file
61 .br
62 Format (1) is a direct image of the translation
63 .I table. The 256-bytes tables are direct-to-font,
64 the 512-bytes tables are user-to-unicode tables.
65 Format (2) is used to fill the
66 .I table
67 as follows: cell with offset mentioned in the first column is filled
68 with the value mentioned in the second column.
69 When values larger than 255 occur, or values are written using
70 the U+xxxx notation, the table is assumed to be a user-to-unicode
71 table, otherwise it is a direct-to-font table.
72 .PP
73 Values in the file may be specified in one of several
74 .B formats:
75 .br
76 .B 1. Decimal:
77 String of decimal digits not starting with '0'
78 .br
79 .B 2. Octal:
80 String of octal digits beginning with '0'.
81 .br
82 .B 3. Hexadecimal:
83 String of hexadecimal digits preceded by "0x".
84 .br
85 .B 4. Unicode:
86 String of four hexadecimal digits preceded by "U+".
87 .br
88 .B 5. Character:
89 Single character enclosed in single quotes. (And the binary value is used.)
90 Note that blank, comma, tab character and '#' cannot be specified
91 with this format.
92 .br
93 .B 6. UTF-8 Character:
94 Single (possibly multi-byte) UTF-8 character, enclosed in single quotes.
95 .PP
96 Note that control characters (with codes < 32) cannot be re-mapped with
97 .I mapscrn
98 because they have special meaning for the driver.
99 .SH OPTIONS
100 .TP
101 \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
102 save the old map to the \fI\,FILE\/\fR.
103 .TP
104 \fB\-C\fR, \fB\-\-console\fR=\fI\,DEV\/\fR
105 the console device to be used.
106 .TP
107 \fB\-v\fR, \fB\-\-verbose\fR
108 be more verbose.
109 .TP
110 \fB\-V\fR, \fB\-\-version\fR
111 print version number.
112 .TP
113 \fB\-h\fR, \fB\-\-help\fR
114 print this usage message.
115 .SH FILES
116 .TP
117 .I /usr/share/consoletrans
118 The default directory for screen mappings.
119 .LP
120 .SH "SEE ALSO"
121 .IR setfont (8)
122 .SH AUTHOR
123 Copyright (C) 1993 Eugene G. Crosser
124 .br
125 <[email protected]>
126 .br
127 This software and documentation may be distributed freely.