~ubuntu-branches/ubuntu/trusty/xterm/trusty

« back to all changes in this revision

Viewing changes to ctlseqs.ms

  • Committer: Bazaar Package Importer
  • Author(s): Timo Aaltonen
  • Date: 2010-03-31 12:32:27 UTC
  • mfrom: (1.1.17 upstream) (11.1.17 sid)
  • Revision ID: james.westby@ubuntu.com-20100331123227-8a6qwmyciob6j88y
Tags: 256-1ubuntu1
* Merge from Debian unstable.
* Revert the libutempter change for lucid. (LP: #539473)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"#! troff -ms $1              -*- Nroff -*-
2
2
.\" "Xterm Control Sequences" document
3
 
.\" $XTermId: ctlseqs.ms,v 1.201 2009/12/07 09:59:49 tom Exp $
4
 
.\"
5
 
.\"
6
 
.\" Copyright 1996-2008,2009 by Thomas E. Dickey
 
3
.\" $XTermId: ctlseqs.ms,v 1.211 2010/01/04 09:12:55 tom Exp $
 
4
.\"
 
5
.\"
 
6
.\" Copyright 1996-2009,2010 by Thomas E. Dickey
7
7
.\"
8
8
.\"                         All Rights Reserved
9
9
.\"
288
288
Thomas Dickey
289
289
.AI
290
290
XFree86 Project (1996-2006)
291
 
invisible-island.net (2006-2009)
 
291
invisible-island.net (2006-2010)
292
292
.AU
293
293
.
294
294
.am BT                  \" add page numbers after first page
586
586
\*(Dc\*0\*$\*r\*(Pt\*s\*(ST
587
587
for invalid requests.
588
588
.
 
589
.IP \\*(Dc\\*+\\*p\\*(Pt\\*s\\*(ST
 
590
Set Termcap/Terminfo Data (xterm, experimental).
 
591
The string following the "p" is a name to use for retrieving data from 
 
592
the terminal database.  The data will be used for the "tcap" keyboard
 
593
configuration's function- and special-keys, as well as by the
 
594
Request Termcap/Terminfo String control.
 
595
 
589
596
.IP \\*(Dc\\*+\\*q\\*(Pt\\*s\\*(ST
590
597
Request Termcap/Terminfo String (xterm, experimental).
591
598
The string following the "q" is a list of names
593
600
separated by \*;
594
601
which correspond to termcap or terminfo key names.
595
602
.br
 
603
Two special features are also recognized, which are not key names:
 
604
\fICo\fP for termcap colors (or \fIcolors\fP for terminfo colors),
 
605
and
 
606
\fITN\fP for termcap name (or \fIname\fP for terminfo name).
 
607
.br
596
608
\fIxterm\fP responds with
597
609
\*(Dc\*1\*+\*r\*(Pt\*s\*(ST
598
610
for valid requests, adding to \*(Pt an \*=,
1073
1085
  \*(Ps = \*1 \(-> 7-bit controls (always set for VT100)
1074
1086
  \*(Ps = \*2 \(-> 8-bit controls
1075
1087
.
1076
 
.IP \\*(Cs\\*(Ps\\*s\\*(Sp"\\*q
 
1088
.IP \\*(Cs\\*(Ps\\*s\\*(Sp\\*q
1077
1089
Set cursor style (DECSCUSR, VT520)
1078
1090
  \*(Ps = \*0 \(-> blinking block
1079
1091
  \*(Ps = \*1 \(-> blinking block (default)
1157
1169
  \*(Ps = \*3 \(-> Query window/icon labels using UTF-8
1158
1170
(See discussion of "Title Modes")
1159
1171
.
 
1172
.IP \\*(Cs\\*(Ps\\*s\\*(Sp\\*t
 
1173
Set warning-bell volume (DECSWBV, VT520)
 
1174
  \*(Ps = \*0 or \*1 \(-> off
 
1175
  \*(Ps = \*2, \*3 or \*4 \(-> low
 
1176
  \*(Ps = \*5, \*6, \*7, or \*8 \(-> high
 
1177
.
1160
1178
.IP \\*(Cs\\*u
1161
1179
Restore cursor (ANSI.SYS)
1162
1180
.
 
1181
.IP \\*(Cs\\*(Ps\\*s\\*(Sp\\*u
 
1182
Set margin-bell volume (DECSMBV, VT520)
 
1183
  \*(Ps = \*1 \(-> off
 
1184
  \*(Ps = \*2, \*3 or \*4 \(-> low
 
1185
  \*(Ps = \*0, \*5, \*6, \*7, or \*8 \(-> high
 
1186
.
1163
1187
.IP \\*(Cs\\*(Pt\\*;\\*(Pl\\*;\\*(Pb\\*;\\*(Pr\\*;\\*(Pp\\*;\\*(Pt\\*;\\*(Pl\\*;\\*(Pp\\*$\\*v
1164
1188
Copy Rectangular Area (DECCRA)
1165
1189
  \*(Pt\*;\*(Pl\*;\*(Pb\*;\*(Pr denotes the rectangle.
1326
1350
  \*(Pc = 2 \(-> resource \fBcolorBL\fP (BLINK)
1327
1351
  \*(Pc = 3 \(-> resource \fBcolorRV\fP (REVERSE)
1328
1352
.sp
1329
 
The 8 colors (below) which may be set using \*1\*0 through \*1\*7 are
 
1353
The 8 colors (below) which may be set or queried
 
1354
using \*1\*0 through \*1\*7 are
1330
1355
denoted \fIdynamic colors\fR, since the corresponding control sequences
1331
1356
were the first means for setting \fBxterm\fR's colors dynamically,
1332
1357
i.e., after it was started.
1333
1358
They are not the same as the ANSI colors.
1334
 
One or more parameters is expected for \*(Pt.
 
1359
These controls may be disabled using the \fIallowColorOps\fP resource.
 
1360
At least one parameter is expected for \*(Pt.
1335
1361
Each successive parameter changes the next color in the list.
1336
1362
The value of \*(Ps tells the starting point in the list.
1337
1363
The colors are specified by name or RGB specification as per \fIXParseColor\fP.
1356
1382
compile-time option)
1357
1383
.sp
1358
1384
  \*(Ps = \*5\*0 \(-> Set Font to \*(Pt
 
1385
These controls may be disabled using the \fIallowFontOps\fP resource.
1359
1386
If \*(Pt begins with a "#", index in the font menu, relative (if the
1360
1387
next character is a plus or minus sign) or absolute.  A number is
1361
1388
expected but not required after the sign (the default is the current
1362
1389
entry for relative, zero for absolute indexing).
 
1390
.br
 
1391
The same rule (plus or minus sign, optional number) is used when
 
1392
querying the font.  The remainder of \*(Pt is ignored.
 
1393
.br
 
1394
A font can be specified after a "#" index expression,
 
1395
by adding a space and then the font specifier.
 
1396
.br
 
1397
If the "TrueType Fonts" menu entry is set (the \fBrenderFont\fP resource),
 
1398
then this control sets/queries the \fBfaceName\fP resource.
1363
1399
.sp
1364
1400
  \*(Ps = \*5\*1 (reserved for Emacs shell)
1365
1401
.sp