]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/vt
acme(1): remove references to awd
[plan9front.git] / sys / man / 1 / vt
1 .TH VT 1 
2 .SH NAME
3 vt \- emulate a VT-100 or VT-220 terminal
4 .SH SYNOPSIS
5 .B vt
6 [
7 .B -2abcrx
8 ]
9 [
10 .B -f
11 .I font
12 ] [
13 .B -l
14 .I log
15 ]
16 .SH DESCRIPTION
17 .I Vt
18 replaces a
19 .I rio
20 window with a fresh instance of the shell,
21 .IR rc (1),
22 running within an emulation of a DEC VT-100 terminal.
23 To exit
24 .IR vt ,
25 exit the
26 .B rc
27 it starts.
28 .SS Options
29 .TF m
30 .TP
31 .B 2
32 .TP
33 .B a
34 .TP
35 .B x
36 change
37 .I vt
38 to emulate a VT-220, ANSI, or XTerm terminal respectively.
39 .TP
40 .B b
41 changes the color scheme to white text on a black background,
42 but potentially with colors from escape sequences.
43 .TP
44 .B c
45 changes the color scheme to monochrome (no colors).
46 .TP
47 .B f
48 sets the
49 .IR font .
50 .TP
51 .B l
52 names a
53 .I log
54 file for the session.
55 .TP
56 .B r
57 start in raw mode.
58 .SS Menus
59 The right button has a menu with the following entries to provide
60 the sort of character processing expected by non-Plan 9 systems:
61 .TF cooked
62 .TP
63 .B 24x80
64 Resize the
65 .I vt
66 window to hold 24 rows of 80 columns.
67 .TP
68 .B crnl
69 Print a newline (linefeed) character after receiving a carriage return from the host.
70 .TP
71 .B cr
72 Do not print a newline after carriage return.
73 .TP
74 .B nlcr
75 Print a carriage return after receiving a newline from the host.
76 .TP
77 .B nl
78 Do not print a carriage return after newline.
79 .TP
80 .B raw
81 Enter raw (no echo, no interpretation) character mode for input.
82 .TP
83 .B cooked
84 Leave raw mode.
85 .TP
86 .B exit
87 Exit
88 .IR vt .
89 .PD
90 .PP
91 The middle button has a menu with the following entries:
92 .TF right_key
93 .TP
94 .B backup
95 Move the display back one screenful.
96 .TP
97 .B forward
98 Move the display forward one screenful.
99 (These are a poor substitute for a scroll bar.)
100 .TP
101 .B reset
102 Display the last screenful; the same as going
103 .B forward
104 to the end.
105 .TP
106 .B clear
107 Clear the screen.  Previous contents can be recovered using
108 .BR backup .
109 .TP
110 .B send
111 Send the contents of the
112 .B rio
113 snarf buffer, just as
114 .B send
115 in the
116 .B rio
117 menu.
118 .TP
119 .B scroll
120 Make new lines visible as they appear at the bottom.
121 .TP
122 .B page
123 When the page fills, pause and wait for a character to be typed before proceeding.
124 The down arrow key advances a page without sending the character to the host.
125 .PD
126 .SH SOURCE
127 .B /sys/src/cmd/vt
128 .SH BUGS
129 This program is used only for communicating with foreign systems,
130 so it is not
131 as rich an emulation as its equivalent in other environments.
132 .PP
133 Use care in setting raw and newline modes when connecting to Unix systems
134 via
135 .IR con (1)
136 or
137 .IR ssh (1).
138 It may also be necessary to set the emulator into raw mode.