~kklimonda/ubuntu/lucid/rxvt-unicode/lp-514821 : revision 10

1

<?xml version="1.0" ?>

1

2

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

2

3

3

4

<head>

4

5

<title>REFERENCE - FAQ, command sequences and other background information</title>

6

5

7

6

8

</head>

7

9

27

29

<li><a href="#rxvtunicode_uses_gobs_of_memory__how_can_i_reduce_that">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></li>

28

30

<li><a href="#how_can_i_start_urxvtd_in_a_racefree_way">How can I start urxvtd in a race-free way?</a></li>

29

31

<li><a href="#how_can_i_start_urxvtd_automatically_when_i_run_urxvt_name__c">How can I start urxvtd automatically when I run URXVT_NAME@@c?</a></li>

30

<li><a href="#how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></li>

32

<li><a href="#how_do_i_distinguish_whether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></li>

31

33

<li><a href="#how_do_i_set_the_correct__full_ip_address_for_the_display_variable">How do I set the correct, full IP address for the DISPLAY variable?</a></li>

32

34

<li><a href="#how_do_i_compile_the_manual_pages_on_my_own">How do I compile the manual pages on my own?</a></li>

33

35

<li><a href="#isn_t_rxvtunicode_supposed_to_be_small_don_t_all_those_features_bloat">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</a></li>

227

229

existing daemon.

228

230

229

231

230

<h3><a name="how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></h3>

232

<h3><a name="how_do_i_distinguish_whether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></h3>

231

233

The original rxvt and rxvt-unicode always export the variable ``COLORTERM'',

232

234

so you can check and see if that is set. Note that several programs, JED,

233

235

slrn, Midnight Commander automatically check this variable to decide

278

280

188985 9048 66616 18222 1788 urxvt --disable-everything</pre>

279

281

When you <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (which is unfair, as this involves xft

280

282

and full locale/XIM support which are quite bloaty inside libX11 and my

281

libc), the two diverge, but not unreasnobaly so.

283

libc), the two diverge, but not unreasonably so.

282

284

<pre>

283

285

text data bss drs rss filename

284

286

163431 2152 24 20123 2060 rxvt --enable-everything

361

363

urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc</pre>

362

364

This requires XFT support, and the support of your X-server. If that

363

365

doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't

364

there yet, no matter what they claim. Rxvt-Unicode contains the neccessary

366

there yet, no matter what they claim. Rxvt-Unicode contains the necessary

365

367

bugfixes and workarounds for Xft and Xlib to make it work, but that

366

368

doesn't mean that your WM has the required kludges in place.

367

369

4. Use xcompmgr and let it do the job:

384

386

box, and rxvt-unicode has no way of detecting this (the correct way is to

385

387

ask for the character bounding box, which unfortunately is wrong in these

386

388

cases).

387

It's not clear (to me at least), wether this is a bug in Xft, freetype,

389

It's not clear (to me at least), whether this is a bug in Xft, freetype,

388

390

or the respective font. If you encounter this problem you might try using

389

391

the <code>-lsp</code> option to give the font more height. If that doesn't work, you

390

392

might be forced to use a different font.

416

418

Yes, using an escape sequence. Try something like this, which has the same

417

419

effect as using the <code>-fn</code> switch, and takes effect immediately:

418

420

<pre>

419

printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"</pre>

421

printf '\33]50;%s\007' "9x15bold,xft:Kochi Gothic"</pre>

420

422

This is useful if you e.g. work primarily with japanese (and prefer a

421

423

japanese font), but you have to switch to chinese temporarily, where

422

424

japanese fonts would only be in your way.

426

428

<h3><a name="why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></h3>

427

429

Many fonts have difficulties with italic characters and hinting. For

428

430

example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans

429

Mono</code> completely fails in it's italic face. A workaround might be to

431

Mono</code> completely fails in its italic face. A workaround might be to

430

432

enable freetype autohinting, i.e. like this:

431

433

<pre>

432

434

URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true

442

444

443

445

<h3><a name="rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></h3>

444

446

Rxvt-unicode will use whatever you specify as a font. If it needs to

445

fall back to it's default font search list it will prefer X11 core

447

fall back to its default font search list it will prefer X11 core

446

448

fonts, because they are small and fast, and then use Xft fonts. It has

447

449

antialiasing disabled for most of them, because the author thinks they

448

450

look best that way.

603

605

line that contains it. It tries hard not to do this at the wrong moment,

604

606

but when running a program that doesn't parse cursor movements or in some

605

607

cases during rlogin sessions, it fails to detect this properly.

606

You can permamently switch this feature off by disabling the <code>readline</code>

608

You can permanently switch this feature off by disabling the <code>readline</code>

607

609

extension:

608

610

<pre>

609

611

URxvt.perl-ext-common: default,-readline</pre>

612

614

<h3><a name="my_numerical_keypad_acts_weird_and_generates_differing_output">My numerical keypad acts weird and generates differing output?</a></h3>

613

615

Some Debian GNUL/Linux users seem to have this problem, although no

614

616

specific details were reported so far. It is possible that this is caused

615

by the wrong <code>TERM</code> setting, although the details of wether and how

617

by the wrong <code>TERM</code> setting, although the details of whether and how

616

618

this can happen are unknown, as <code>TERM=rxvt</code> should offer a compatible

617

619

keymap. See the answer to the previous question, and please report if that

618

620

helped.

647

649

648

650

<h3><a name="what_s_with_the_strange_backspace_delete_key_behaviour">What's with the strange Backspace/Delete key behaviour?</a></h3>

649

651

Assuming that the physical Backspace key corresponds to the

650

BackSpace keysym (not likely for Linux ... see the following

652

Backspace keysym (not likely for Linux ... see the following

651

653

question) there are two standard values that can be used for

652

654

Backspace: <code>^H</code> and <code>^?</code>.

653

655

Historically, either value is correct, but rxvt-unicode adopts the debian

766

768

develop for myself mostly, so I actually use most of the extensions I

767

769

write.

768

770

The selection stuff mainly makes the selection perl-error-message aware

769

and tells it to convert pelr error mssages into vi-commands to load the

771

and tells it to convert perl error messages into vi-commands to load the

770

772

relevant file and go tot he error line number.

771

773

<pre>

772

774

URxvt.scrollstyle: plain

773

775

URxvt.secondaryScroll: true</pre>

774

776

As the documentation says: plain is the preferred scrollbar for the

775

author. The <code>secondaryScroll</code> confgiures urxvt to scroll in full-screen

776

apps, like screen, so lines scorlled out of screen end up in urxvt's

777

author. The <code>secondaryScroll</code> configures urxvt to scroll in full-screen

778

apps, like screen, so lines scrolled out of screen end up in urxvt's

777

779

scrollback buffer.

778

780

<pre>

779

781

URxvt.background: #000000

825

827

urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true

826

828

urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>

827

829

I wrote rxvt-unicode to be able to specify fonts exactly. So don't be

828

overwhelmed. A special note: the <code>9x15bold</code> mentioend above is actually

830

overwhelmed. A special note: the <code>9x15bold</code> mentioned above is actually

829

831

the version from XFree-3.3, as XFree-4 replaced it by a totally different

830

832

font (different glyphs for <code>;</code> and many other harmless characters),

831

833

while the second font is actually the <code>9x15bold</code> from XFree4/XOrg. The

832

834

bold version has less chars than the medium version, so I use it for rare

833

characters, too. Whene ditign sources with vim, I use italic for comments

835

characters, too. When editing sources with vim, I use italic for comments

834

836

and other stuff, which looks quite good with Bitstream Vera anti-aliased.

835

837

Terminus is a quite bad font (many very wrong glyphs), but for most of my

836

838

purposes, it works, and gives a different look, as my normal (Non-bold)

883

885

<pre>

884

886

URxvt.resource: value</pre>

885

887

If you want to use another form (there are lots of different ways of

886

specifying resources), make sure you understand wether and why it

888

specifying resources), make sure you understand whether and why it

887

889

works. If unsure, use the form above.

888

890

889

891

924

926

systems still compile some programs using the long-obsoleted termcap

925

927

library (Fedora Core's bash is one example) and rely on a termcap entry

926

928

for <code>rxvt-unicode</code>.

927

You could use rxvt's termcap entry with resonable results in many cases.

929

You could use rxvt's termcap entry with reasonable results in many cases.

928

930

You can also create a termcap entry by using terminfo's infocmp program

929

931

like this:

930

932

<pre>

955

957

956

958

<h3><a name="why_does_ls_no_longer_have_coloured_output">Why does <code>ls</code> no longer have coloured output?</a></h3>

957

959

The <code>ls</code> in the GNU coreutils unfortunately doesn't use terminfo to

958

decide wether a terminal has colour, but uses it's own configuration

959

file. Needless to say, <code>rxvt-unicode</code> is not in it's default file (among

960

decide whether a terminal has colour, but uses its own configuration

961

file. Needless to say, <code>rxvt-unicode</code> is not in its default file (among

960

962

with most other terminals supporting colour). Either add:

961

963

<pre>

962

964

TERM rxvt-unicode</pre>

1003

1005

The best thing is to fix your startup environment, as you will likely run

1004

1006

into other problems. If nothing works you can try this in your .profile.

1005

1007

<pre>

1006

printf '\e]701;%s\007' "$LC_CTYPE"</pre>

1008

printf '\33]701;%s\007' "$LC_CTYPE"</pre>

1007

1009

If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not

1008

1010

supported on your systems. Some systems have a <code>locale</code> command which

1009

1011

displays this (also, <code>perl -e0</code> can be used to check locale settings, as

1030

1032

applications so everybody agrees on character properties such as width

1031

1033

and code number. This mechanism is the locale. Applications not using

1032

1034

that info will have problems (for example, <code>xterm</code> gets the width of

1033

characters wrong as it uses it's own, locale-independent table under all

1035

characters wrong as it uses its own, locale-independent table under all

1034

1036

locales).

1035

1037

Rxvt-unicode uses the <code>LC_CTYPE</code> locale category to select encoding. All

1036

1038

programs doing the same (that is, most) will automatically agree in the

1054

1056

Yes, using an escape sequence. Try something like this, which sets

1055

1057

rxvt-unicode's idea of <code>LC_CTYPE</code>.

1056

1058

<pre>

1057

printf '\e]701;%s\007' ja_JP.SJIS</pre>

1059

printf '\33]701;%s\007' ja_JP.SJIS</pre>

1058

1060

See also the previous answer.

1059

1061

Sometimes this capability is rather handy when you want to work in

1060

1062

one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it

1061

1063

(e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which

1062

1064

first switches to a locale supported by xjdic and back later:

1063

1065

<pre>

1064

printf '\e]701;%s\007' ja_JP.SJIS

1066

printf '\33]701;%s\007' ja_JP.SJIS

1065

1067

xjdic -js

1066

printf '\e]701;%s\007' de_DE.UTF-8</pre>

1068

printf '\33]701;%s\007' de_DE.UTF-8</pre>

1067

1069

You can also use xterm's <code>luit</code> program, which usually works fine, except

1068

1070

for some locales where character width differs between program- and

1069

1071

rxvt-unicode-locales.

1073

1075

Try a search engine, as this is slightly different for every input method server.

1074

1076

Here is a checklist:

1075

1077

<dl>

1076

<dt><a name="item__2d_make_sure_your_locale_and_the_imlocale_are_sup">- Make sure your locale and the imLocale are supported on your OS.</a>

1077

</dt>

1078

<dd>

1079

Try <code>locale -a</code> or check the documentation for your OS.

1080

</dd>

1081

1082

<dt><a name="item__2d_make_sure_your_locale_or_imlocale_matches_a_lo">- Make sure your locale or imLocale matches a locale supported by your XIM.</a>

1083

</dt>

1084

<dd>

1085

For example, kinput2 does not support UTF-8 locales, you should use

1086

<code>ja_JP.EUC-JP</code> or equivalent.

1087

</dd>

1088

1089

<dt><a name="item__2d_make_sure_your_xim_server_is_actually_running_">- Make sure your XIM server is actually running.</a>

1090

</dt>

1091

<dt><a name="item__2d_make_sure_the_xmodifiers_environment_variable_">- Make sure the <code>XMODIFIERS</code> environment variable is set correctly when starting rxvt-unicode.</a>

1092

</dt>

1093

<dd>

1094

When you want to use e.g. kinput2, it must be set to

1095

<code>@im=kinput2</code>. For scim, use <code>@im=SCIM</code>. Youc an see what input

1096

method servers are running with this command:

1078

<dt><a name="item__2d_make_sure_your_locale_and_the_imlocale_are_sup">- Make sure your locale and the imLocale are supported on your OS.</a>

1079

1080

<dd>

1081

Try <code>locale -a</code> or check the documentation for your OS.

1082

</dd>

1083

</li>

1084

<dt><a name="item__2d_make_sure_your_locale_or_imlocale_matches_a_lo">- Make sure your locale or imLocale matches a locale supported by your XIM.</a>

1085

1086

<dd>

1087

For example, kinput2 does not support UTF-8 locales, you should use

1088

<code>ja_JP.EUC-JP</code> or equivalent.

1089

</dd>

1090

</li>

1091

<dt><a name="item__2d_make_sure_your_xim_server_is_actually_running_">- Make sure your XIM server is actually running.</a>

1092

1093

<dt><a name="item__2d_make_sure_the_xmodifiers_environment_variable_">- Make sure the <code>XMODIFIERS</code> environment variable is set correctly when starting rxvt-unicode.</a>

1094

1095

<dd>

1096

When you want to use e.g. kinput2, it must be set to

1097

<code>@im=kinput2</code>. For scim, use <code>@im=SCIM</code>. You can see what input

1098

method servers are running with this command:

1097

1099

</dd>

1098

1100

<dd>

1099

1101

<pre>

1100

1102

xprop -root XIM_SERVERS</pre>

1101

1103

</dd>

1102

1103

1104

</li>

1105

<dt>

1104

1106

</dl>

1105

1107

1106

1108

1146

1148

<h3><a name="i_am_maintaining_rxvtunicode_for_distribution_os_xxx__any_recommendation">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></h3>

1147

1149

You should build one binary with the default options. configure

1148

1150

now enables most useful options, and the trend goes to making them

1149

runtime-switchable, too, so there is usually no drawback to enbaling them,

1151

runtime-switchable, too, so there is usually no drawback to enabling them,

1150

1152

except higher disk and possibly memory usage. The perl interpreter should

1151

1153

be enabled, as important functionality (menus, selection, likely more in

1152

1154

the future) depends on it.

1187

1189

<h3><a name="i_am_on_freebsd_and_rxvtunicode_does_not_seem_to_work_at_all_">I am on FreeBSD and rxvt-unicode does not seem to work at all.</a></h3>

1188

1190

Rxvt-unicode requires the symbol <code>__STDC_ISO_10646__</code> to be defined

1189

1191

in your compile environment, or an implementation that implements it,

1190

wether it defines the symbol or not. <code>__STDC_ISO_10646__</code> requires that

1192

whether it defines the symbol or not. <code>__STDC_ISO_10646__</code> requires that

1191

1193

wchar_t is represented as unicode.

1192

As you might have guessed, FreeBSD does neither define this symobl nor

1193

does it support it. Instead, it uses it's own internal representation of

1194

As you might have guessed, FreeBSD does neither define this symbol nor

1195

does it support it. Instead, it uses its own internal representation of

1194

1196

wchar_t. This is, of course, completely fine with respect to standards.

1195

1197

However, that means rxvt-unicode only works in <code>POSIX</code>, <code>ISO-8859-1</code> and

1196

1198

<code>UTF-8</code> locales under FreeBSD (which all use Unicode as wchar_t.

1238

1240

1239

1241

<h2><a name="definitions">Definitions</a></h2>

1240

1242

<dl>

1241

1242

</dt>

1243

<dd>

1244

The literal character c.

1245

</dd>

1246

1247

1248

</dt>

1249

<dd>

1250

A single (required) character.

1251

</dd>

1252

1253

1254

</dt>

1255

<dd>

1256

A single (usually optional) numeric parameter, composed of one or more

1257

digits.

1258

</dd>

1259

1260

1261

</dt>

1262

<dd>

1263

A multiple numeric parameter composed of any number of single numeric

1264

parameters, separated by <code>;</code> character(s).

1265

</dd>

1266

1267

1268

</dt>

1269

<dd>

1270

A text parameter composed of printable characters.

1271

</dd>

1272

</dl>

1243

1244

1245

<dd>

1246

The literal character c.

1247

</dd>

1248

</li>

1249

1250

1251

<dd>

1252

A single (required) character.

1253

</dd>

1254

</li>

1255

1256

1257

<dd>

1258

A single (usually optional) numeric parameter, composed of one or more

1259

digits.

1260

</dd>

1261

</li>

1262

1263

1264

<dd>

1265

A multiple numeric parameter composed of any number of single numeric

1266

parameters, separated by <code>;</code> character(s).

1267

</dd>

1268

</li>

1269

1270

1271

<dd>

1272

A text parameter composed of printable characters.

1273

</dd>

1274

</li>

1275

</dl>

1273

1276

1274

1277

1275

1278

<h2><a name="values">Values</a></h2>

1276

1279

<dl>

1277

1278

</dt>

1279

<dd>

1280

Enquiry (Ctrl-E) = Send Device Attributes (DA)

1281

request attributes from terminal. See <a href="#item_esc__5b_ps_c"><code>ESC [ Ps c</code></a> >.

1282

</dd>

1283

1284

1285

</dt>

1286

<dd>

1287

Bell (Ctrl-G)

1288

</dd>

1289

1290

1291

</dt>

1292

<dd>

1293

Backspace (Ctrl-H)

1294

</dd>

1295

1296

1297

</dt>

1298

<dd>

1299

Horizontal Tab (HT) (Ctrl-I)

1300

</dd>

1301

1302

1303

</dt>

1304

<dd>

1305

Line Feed or New Line (NL) (Ctrl-J)

1306

</dd>

1307

1308

1309

</dt>

1310

<dd>

1311

Vertical Tab (Ctrl-K) same as <a href="#item_lf"><code>LF</code></a> >

1312

</dd>

1313

1314

1315

</dt>

1316

<dd>

1317

Form Feed or New Page (NP) (Ctrl-L) same as <a href="#item_lf"><code>LF</code></a> >

1318

</dd>

1319

1320

1321

</dt>

1322

<dd>

1323

Carriage Return (Ctrl-M)

1324

</dd>

1325

1326

1327

</dt>

1328

<dd>

1329

Shift Out (Ctrl-N), invokes the G1 character set.

1330

Switch to Alternate Character Set

1331

</dd>

1332

1333

1334

</dt>

1335

<dd>

1336

Shift In (Ctrl-O), invokes the G0 character set (the default).

1337

Switch to Standard Character Set

1338

</dd>

1339

1340

1341

</dt>

1342

<dd>

1343

Space Character

1344

</dd>

1345

</dl>

1280

1281

1282

<dd>

1283

Enquiry (Ctrl-E) = Send Device Attributes (DA)

1284

request attributes from terminal. See <a href="#item_esc__5b_ps_c"><code>ESC [ Ps c</code></a> >.

1285

</dd>

1286

</li>

1287

1288

1289

<dd>

1290

Bell (Ctrl-G)

1291

</dd>

1292

</li>

1293

1294

1295

<dd>

1296

Backspace (Ctrl-H)

1297

</dd>

1298

</li>

1299

1300

1301

<dd>

1302

Horizontal Tab (HT) (Ctrl-I)

1303

</dd>

1304

</li>

1305

1306

1307

<dd>

1308

Line Feed or New Line (NL) (Ctrl-J)

1309

</dd>

1310

</li>

1311

1312

1313

<dd>

1314

Vertical Tab (Ctrl-K) same as <a href="#item_lf"><code>LF</code></a> >

1315

</dd>

1316

</li>

1317

1318

1319

<dd>

1320

Form Feed or New Page (NP) (Ctrl-L) same as <a href="#item_lf"><code>LF</code></a> >

1321

</dd>

1322

</li>

1323

1324

1325

<dd>

1326

Carriage Return (Ctrl-M)

1327

</dd>

1328

</li>

1329

1330

1331

<dd>

1332

Shift Out (Ctrl-N), invokes the G1 character set.

1333

Switch to Alternate Character Set

1334

</dd>

1335

</li>

1336

1337

1338

<dd>

1339

Shift In (Ctrl-O), invokes the G0 character set (the default).

1340

Switch to Standard Character Set

1341

</dd>

1342

</li>

1343

1344

1345

<dd>

1346

Space Character

1347

</dd>

1348

</li>

1349

</dl>

1346

1350

1347

1351

1348

1352

<h2><a name="escape_sequences">Escape Sequences</a></h2>

1349

1353

<dl>

1350

1351

</dt>

1352

<dd>

1353

DEC Screen Alignment Test (DECALN)

1354

</dd>

1355

1356

1357

</dt>

1358

<dd>

1359

Save Cursor (SC)

1360

</dd>

1361

1362

1363

</dt>

1364

<dd>

1365

Restore Cursor

1366

</dd>

1367

1368

1369

</dt>

1370

<dd>

1371

Application Keypad (SMKX). See also next sequence.

1372

</dd>

1373

1374

1375

</dt>

1376

<dd>

1377

Normal Keypad (RMKX)

1354

1355

1356

<dd>

1357

DEC Screen Alignment Test (DECALN)

1358

</dd>

1359

</li>

1360

1361

1362

<dd>

1363

Save Cursor (SC)

1364

</dd>

1365

</li>

1366

1367

1368

<dd>

1369

Restore Cursor

1370

</dd>

1371

</li>

1372

1373

1374

<dd>

1375

Application Keypad (SMKX). See also next sequence.

1376

</dd>

1377

</li>

1378

1379

1380

<dd>

1381

Normal Keypad (RMKX)

1378

1382

</dd>

1379

1383

<dd>

1380

1384

Note: If the numeric keypad is activated, eg, Num_Lock has been

1381

1385

pressed, numbers or control functions are generated by the numeric keypad

1382

1386

(see Key Codes).

1383

1387

</dd>

1384

1385

1386

</dt>

1387

<dd>

1388

Index (IND)

1389

</dd>

1390

1391

1392

</dt>

1393

<dd>

1394

Next Line (NEL)

1395

</dd>

1396

1397

1398

</dt>

1399

<dd>

1400

Tab Set (HTS)

1401

</dd>

1402

1403

1404

</dt>

1405

<dd>

1406

Reverse Index (RI)

1407

</dd>

1408

1409

1410

</dt>

1411

<dd>

1412

Single Shift Select of G2 Character Set (SS2): affects next character

1413

only unimplemented

1414

</dd>

1415

1416

1417

</dt>

1418

<dd>

1419

Single Shift Select of G3 Character Set (SS3): affects next character

1420

only unimplemented

1421

</dd>

1422

1423

1424

</dt>

1425

<dd>

1426

Obsolete form of returns: <code>ESC [ ? 1 ; 2 C</code> > rxvt-unicode compile-time option

1427

</dd>

1428

1429

1430

</dt>

1431

<dd>

1432

Full reset (RIS)

1433

</dd>

1434

1435

1436

</dt>

1437

<dd>

1438

Invoke the G2 Character Set (LS2)

1439

</dd>

1440

1441

1442

</dt>

1443

<dd>

1444

Invoke the G3 Character Set (LS3)

1445

</dd>

1446

1447

1448

</dt>

1449

<dd>

1450

Designate G0 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1451

</dd>

1452

1453

1454

</dt>

1455

<dd>

1456

Designate G1 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1457

</dd>

1458

1459

1460

</dt>

1461

<dd>

1462

Designate G2 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1463

</dd>

1464

1465

1466

</dt>

1467

<dd>

1468

Designate G3 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1469

</dd>

1470

1471

1472

</dt>

1473

<dd>

1474

Designate Kanji Character Set

1388

</li>

1389

1390

1391

<dd>

1392

Index (IND)

1393

</dd>

1394

</li>

1395

1396

1397

<dd>

1398

Next Line (NEL)

1399

</dd>

1400

</li>

1401

1402

1403

<dd>

1404

Tab Set (HTS)

1405

</dd>

1406

</li>

1407

1408

1409

<dd>

1410

Reverse Index (RI)

1411

</dd>

1412

</li>

1413

1414

1415

<dd>

1416

Single Shift Select of G2 Character Set (SS2): affects next character

1417

only unimplemented

1418

</dd>

1419

</li>

1420

1421

1422

<dd>

1423

Single Shift Select of G3 Character Set (SS3): affects next character

1424

only unimplemented

1425

</dd>

1426

</li>

1427

1428

1429

<dd>

1430

Obsolete form of returns: <code>ESC [ ? 1 ; 2 C</code> > rxvt-unicode compile-time option

1431

</dd>

1432

</li>

1433

1434

1435

<dd>

1436

Full reset (RIS)

1437

</dd>

1438

</li>

1439

1440

1441

<dd>

1442

Invoke the G2 Character Set (LS2)

1443

</dd>

1444

</li>

1445

1446

1447

<dd>

1448

Invoke the G3 Character Set (LS3)

1449

</dd>

1450

</li>

1451

1452

1453

<dd>

1454

Designate G0 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1455

</dd>

1456

</li>

1457

1458

1459

<dd>

1460

Designate G1 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1461

</dd>

1462

</li>

1463

1464

1465

<dd>

1466

Designate G2 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1467

</dd>

1468

</li>

1469

1470

1471

<dd>

1472

Designate G3 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.

1473

</dd>

1474

</li>

1475

1476

1477

<dd>

1478

Designate Kanji Character Set

1475

1479

</dd>

1476

1480

<dd>

1477

1481

Where <a href="#item_c"><code>C</code></a> > is one of:

1484

1488

<tr><td>C = 5 </td><td>Finnish character set unimplemented</td></tr>

1485

1489

<tr><td>C = C </td><td>Finnish character set unimplemented</td></tr>

1486

1490

<tr><td>C = K </td><td>German character set unimplemented</td></tr>

1487

</table></dl>

1491

</table></li>

1492

</dl>

1488

1493

1489

1494

1490

1495

1491

1496

<h2><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h2>

1492

1497

<dl>

1493

1494

</dt>

1495

<dd>

1496

Insert <a href="#item_ps"><code>Ps</code></a> > (Blank) <code>Character(s)</code> [default: 1] (ICH)

1497

</dd>

1498

1499

1500

</dt>

1501

<dd>

1502

Cursor Up <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUU)

1503

</dd>

1504

1505

1506

</dt>

1507

<dd>

1508

Cursor Down <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUD)

1509

</dd>

1510

1511

1512

</dt>

1513

<dd>

1514

Cursor Forward <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUF)

1515

</dd>

1516

1517

1518

</dt>

1519

<dd>

1520

Cursor Backward <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUB)

1521

</dd>

1522

1523

1524

</dt>

1525

<dd>

1526

Cursor Down <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] and to first column

1527

</dd>

1528

1529

1530

</dt>

1531

<dd>

1532

Cursor Up <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] and to first column

1533

</dd>

1534

1535

1536

</dt>

1537

<dd>

1538

Cursor to Column <a href="#item_ps"><code>Ps</code></a> > (HPA)

1539

</dd>

1540

1541

1542

</dt>

1543

<dd>

1544

Cursor Position [row;column] [default: 1;1] (CUP)

1545

</dd>

1546

1547

1548

</dt>

1549

<dd>

1550

Move forward <a href="#item_ps"><code>Ps</code></a> > tab stops [default: 1]

1551

</dd>

1552

1553

1554

</dt>

1555

<dd>

1556

Erase in Display (ED)

1498

1499

1500

<dd>

1501

Insert <a href="#item_ps"><code>Ps</code></a> > (Blank) <code>Character(s)</code> [default: 1] (ICH)

1502

</dd>

1503

</li>

1504

1505

1506

<dd>

1507

Cursor Up <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUU)

1508

</dd>

1509

</li>

1510

1511

1512

<dd>

1513

Cursor Down <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUD)

1514

</dd>

1515

</li>

1516

1517

1518

<dd>

1519

Cursor Forward <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUF)

1520

</dd>

1521

</li>

1522

1523

1524

<dd>

1525

Cursor Backward <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] (CUB)

1526

</dd>

1527

</li>

1528

1529

1530

<dd>

1531

Cursor Down <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] and to first column

1532

</dd>

1533

</li>

1534

1535

1536

<dd>

1537

Cursor Up <a href="#item_ps"><code>Ps</code></a> > Times [default: 1] and to first column

1538

</dd>

1539

</li>

1540

1541

1542

<dd>

1543

Cursor to Column <a href="#item_ps"><code>Ps</code></a> > (HPA)

1544

</dd>

1545

</li>

1546

1547

1548

<dd>

1549

Cursor Position [row;column] [default: 1;1] (CUP)

1550

</dd>

1551

</li>

1552

1553

1554

<dd>

1555

Move forward <a href="#item_ps"><code>Ps</code></a> > tab stops [default: 1]

1556

</dd>

1557

</li>

1558

1559

1560

<dd>

1561

Erase in Display (ED)

1557

1562

</dd>

1558

1563

<table>

1559

1564

<tr><td>Ps = 0</td><td>Clear Below (default)</td></tr>

1560

1565

<tr><td>Ps = 1</td><td>Clear Above</td></tr>

1561

1566

<tr><td>Ps = 2</td><td>Clear All</td></tr>

1562

</table>

1563

1564

</dt>

1567

</table></li>

1568

1569

1565

1570

<dd>

1566

Erase in Line (EL)

1571

Erase in Line (EL)

1567

1572

</dd>

1568

1573

<table>

1569

1574

<tr><td>Ps = 0</td><td>Clear to Right (default)</td></tr>

1570

1575

<tr><td>Ps = 1</td><td>Clear to Left</td></tr>

1571

1576

<tr><td>Ps = 2</td><td>Clear All</td></tr>

1572

</table>

1573

1574

</dt>

1575

<dd>

1576

Insert <a href="#item_ps"><code>Ps</code></a> > <code>Line(s)</code> [default: 1] (IL)

1577

</dd>

1578

1579

1580

</dt>

1581

<dd>

1582

Delete <a href="#item_ps"><code>Ps</code></a> > <code>Line(s)</code> [default: 1] (DL)

1583

</dd>

1584

1585

1586

</dt>

1587

<dd>

1588

Delete <a href="#item_ps"><code>Ps</code></a> > <code>Character(s)</code> [default: 1] (DCH)

1589

</dd>

1590

1591

1592

</dt>

1593

<dd>

1594

Initiate . unimplemented Parameters are

1595

[func;startx;starty;firstrow;lastrow].

1596

</dd>

1597

1598

1599

</dt>

1600

<dd>

1601

Tabulator functions

1577

</table></li>

1578

1579

1580

<dd>

1581

Insert <a href="#item_ps"><code>Ps</code></a> > <code>Line(s)</code> [default: 1] (IL)

1582

</dd>

1583

</li>

1584

1585

1586

<dd>

1587

Delete <a href="#item_ps"><code>Ps</code></a> > <code>Line(s)</code> [default: 1] (DL)

1588

</dd>

1589

</li>

1590

1591

1592

<dd>

1593

Delete <a href="#item_ps"><code>Ps</code></a> > <code>Character(s)</code> [default: 1] (DCH)

1594

</dd>

1595

</li>

1596

1597

1598

<dd>

1599

Initiate . unimplemented Parameters are

1600

[func;startx;starty;firstrow;lastrow].

1601

</dd>

1602

</li>

1603

1604

1605

<dd>

1606

Tabulator functions

1602

1607

</dd>

1603

1608

<table>

1604

1609

1605

1610

<tr><td>Ps = 2</td><td>Tab Clear (TBC), Clear Current Column (default)</td></tr>

1606

1611

<tr><td>Ps = 5</td><td>Tab Clear (TBC), Clear All</td></tr>

1607

</table>

1608

1609

</dt>

1610

<dd>

1611

Erase <a href="#item_ps"><code>Ps</code></a> > <code>Character(s)</code> [default: 1] (ECH)

1612

</dd>

1613

1614

1615

</dt>

1616

<dd>

1617

Move backward <a href="#item_ps"><code>Ps</code></a> > [default: 1] tab stops

1618

</dd>

1619

1620

1621

</dt>

1622

<dd>

1623

See <a href="#item_esc__5b_ps_g"><code>ESC [ Ps G</code></a> >

1624

</dd>

1625

1626

1627

</dt>

1628

<dd>

1629

See <a href="#item_esc__5b_ps_c"><code>ESC [ Ps C</code></a> >

1630

</dd>

1631

1632

1633

</dt>

1634

<dd>

1635

Send Device Attributes (DA)

1612

</table></li>

1613

1614

1615

<dd>

1616

Erase <a href="#item_ps"><code>Ps</code></a> > <code>Character(s)</code> [default: 1] (ECH)

1617

</dd>

1618

</li>

1619

1620

1621

<dd>

1622

Move backward <a href="#item_ps"><code>Ps</code></a> > [default: 1] tab stops

1623

</dd>

1624

</li>

1625

1626

1627

<dd>

1628

See <a href="#item_esc__5b_ps_g"><code>ESC [ Ps G</code></a> >

1629

</dd>

1630

</li>

1631

1632

1633

<dd>

1634

See <a href="#item_esc__5b_ps_c"><code>ESC [ Ps C</code></a> >

1635

</dd>

1636

</li>

1637

1638

1639

<dd>

1640

Send Device Attributes (DA)

1636

1641

<code>Ps = 0</code> > (or omitted): request attributes from terminal

1637

1642

returns: <code>ESC [ ? 1 ; 2 c</code> > (``I am a VT100 with Advanced Video

1638

Option'')

1639

</dd>

1640

1641

1642

</dt>

1643

<dd>

1644

Cursor to Line <a href="#item_ps"><code>Ps</code></a> > (VPA)

1645

</dd>

1646

1647

1648

</dt>

1649

<dd>

1650

See <a href="#item_esc__5b_ps_a"><code>ESC [ Ps A</code></a> >

1651

</dd>

1652

1653

1654

</dt>

1655

<dd>

1656

Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]

1657

</dd>

1658

1659

1660

</dt>

1661

<dd>

1662

Tab Clear (TBC)

1643

Option'')

1644

</dd>

1645

</li>

1646

1647

1648

<dd>

1649

Cursor to Line <a href="#item_ps"><code>Ps</code></a> > (VPA)

1650

</dd>

1651

</li>

1652

1653

1654

<dd>

1655

See <a href="#item_esc__5b_ps_a"><code>ESC [ Ps A</code></a> >

1656

</dd>

1657

</li>

1658

1659

1660

<dd>

1661

Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]

1662

</dd>

1663

</li>

1664

1665

1666

<dd>

1667

Tab Clear (TBC)

1663

1668

</dd>

1664

1669

<table>

1665

1670

<tr><td>Ps = 0</td><td>Clear Current Column (default)</td></tr>

1666

1671

<tr><td>Ps = 3</td><td>Clear All (TBC)</td></tr>

1667

</table>

1668

1669

</dt>

1672

</table></li>

1673

1674

1670

1675

<dd>

1671

Set Mode (SM). See <a href="#item_esc__5b_pm_l"><code>ESC [ Pm l</code></a> > sequence for description of <a href="#item_pm"><code>Pm</code></a>.

1676

Set Mode (SM). See <a href="#item_esc__5b_pm_l"><code>ESC [ Pm l</code></a> > sequence for description of <a href="#item_pm"><code>Pm</code></a>.

1672

1677

</dd>

1673

1674

1675

</dt>

1678

</li>

1679

1680

1676

1681

<dd>

1677

Printing. See also the <code>print-pipe</code> resource.

1682

Printing. See also the <code>print-pipe</code> resource.

1678

1683

</dd>

1679

1684

<table>

1680

1685

<tr><td>Ps = 0</td><td>print screen (MC0)</td></tr>

1681

1686

<tr><td>Ps = 4</td><td>disable transparent print mode (MC4)</td></tr>

1682

1687

<tr><td>Ps = 5</td><td>enable transparent print mode (MC5)</td></tr>

1683

</table>

1684

1685

</dt>

1688

</table></li>

1689

1690

1686

1691

<dd>

1687

Reset Mode (RM)

1692

Reset Mode (RM)

1688

1693

</dd>

1689

1694

<dl>

1690

1691

</dt>

1695

1696

1692

1697

<table>

1693

1698

<tr><td>h</td><td>Insert Mode (SMIR)</td></tr>

1694

1699

<tr><td>l</td><td>Replace Mode (RMIR)</td></tr>

1695

</table><dt><a name="item_20"><code>Ps = 20</code> > (partially implemented)</a>

1696

</dt>

1700

</table><dt><a name="item_20"><code>Ps = 20</code> > (partially implemented)</a>

1701

1697

1702

<table>

1698

1703

<tr><td>h</td><td>Automatic Newline (LNM)</td></tr>

1699

1704

<tr><td>l</td><td>Normal Linefeed (LNM)</td></tr>

1700

1705

</table></dl>

1701

1702

</dt>

1706

1707

1703

1708

<dd>

1704

Character Attributes (SGR)

1709

Character Attributes (SGR)

1705

1710

</dd>

1706

1711

<table>

1707

1712

<tr><td>Ps = 0</td><td>Normal (default)</td></tr>

1731

1736

<tr><td>Ps = 96 / 106</td><td>fg/bg Bright Cyan</td></tr>

1732

1737

<tr><td>Ps = 97 / 107</td><td>fg/bg Bright White</td></tr>

1733

1738

<tr><td>Ps = 99 / 109</td><td>fg/bg Bright Default</td></tr>

1734

</table>

1735

1736

</dt>

1739

</table></li>

1740

1741

1737

1742

<dd>

1738

Device Status Report (DSR)

1743

Device Status Report (DSR)

1739

1744

</dd>

1740

1745

<table>

1741

1746

<tr><td>Ps = 5</td><td>Status Report ESC [ 0 n (``OK'')</td></tr>

1742

1747

<tr><td>Ps = 6</td><td>Report Cursor Position (CPR) [row;column] as ESC [ r ; c R</td></tr>

1743

1748

<tr><td>Ps = 7</td><td>Request Display Name</td></tr>

1744

1749

<tr><td>Ps = 8</td><td>Request Version Number (place in window title)</td></tr>

1745

</table>

1746

1747

</dt>

1748

<dd>

1749

Set Scrolling Region [top;bottom]

1750

[default: full size of window] (CSR)

1751

</dd>

1752

1753

1754

</dt>

1755

<dd>

1756

Save Cursor (SC)

1757

</dd>

1758

1759

1760

</dt>

1761

<dd>

1762

Window Operations

1750

</table></li>

1751

1752

1753

<dd>

1754

Set Scrolling Region [top;bottom]

1755

[default: full size of window] (CSR)

1756

</dd>

1757

</li>

1758

1759

1760

<dd>

1761

Save Cursor (SC)

1762

</dd>

1763

</li>

1764

1765

1766

<dd>

1767

Window Operations

1763

1768

</dd>

1764

1769

<table>

1765

1770

<tr><td>Ps = 1</td><td>Deiconify (map) window</td></tr>

1778

1783

<tr><td>Ps = 20</td><td>Reports icon label (ESC ] L NAME \234)</td></tr>

1779

1784

<tr><td>Ps = 21</td><td>Reports window title (ESC ] l NAME \234)</td></tr>

1780

1785

<tr><td>Ps = 24..</td><td>Set window height to Ps rows</td></tr>

1781

</table>

1782

1783

</dt>

1784

<dd>

1785

Restore Cursor

1786

</dd>

1787

1788

1789

</dt>

1790

<dd>

1791

Request Terminal Parameters (DECREQTPARM)

1792

</dd>

1793

</dl>

1786

</table></li>

1787

1788

1789

<dd>

1790

Restore Cursor

1791

</dd>

1792

</li>

1793

1794

1795

<dd>

1796

Request Terminal Parameters (DECREQTPARM)

1797

</dd>

1798

</li>

1799

</dl>

1794

1800

1795

1801

1796

1802

1797

1803

<h2><a name="dec_private_modes">DEC Private Modes</a></h2>

1798

1804

<dl>

1799

1800

</dt>

1801

<dd>

1802

DEC Private Mode Set (DECSET)

1803

</dd>

1804

1805

1806

</dt>

1807

<dd>

1808

DEC Private Mode Reset (DECRST)

1809

</dd>

1810

1811

1812

</dt>

1813

<dd>

1814

Restore previously saved DEC Private Mode Values.

1815

</dd>

1816

1817

1818

</dt>

1819

<dd>

1820

Save DEC Private Mode Values.

1821

</dd>

1822

1823

1824

</dt>

1825

<dd>

1826

Toggle DEC Private Mode Values (rxvt extension). where

1805

1806

1807

<dd>

1808

DEC Private Mode Set (DECSET)

1809

</dd>

1810

</li>

1811

1812

1813

<dd>

1814

DEC Private Mode Reset (DECRST)

1815

</dd>

1816

</li>

1817

1818

1819

<dd>

1820

Restore previously saved DEC Private Mode Values.

1821

</dd>

1822

</li>

1823

1824

1825

<dd>

1826

Save DEC Private Mode Values.

1827

</dd>

1828

</li>

1829

1830

1831

<dd>

1832

Toggle DEC Private Mode Values (rxvt extension). where

1827

1833

</dd>

1828

1834

<dl>

1829

<dt><a name="item_1"><code>Ps = 1</code> > (DECCKM)</a>

1830

</dt>

1835

<dt><a name="item_1"><code>Pm = 1</code> > (DECCKM)</a>

1836

1831

1837

<table>

1832

1838

<tr><td>h</td><td>Application Cursor Keys</td></tr>

1833

1839

<tr><td>l</td><td>Normal Cursor Keys</td></tr>

1834

</table><dt><a name="item_2"><code>Ps = 2</code> > (ANSI/VT52 mode)</a>

1835

</dt>

1840

</table><dt><a name="item_2"><code>Pm = 2</code> > (ANSI/VT52 mode)</a>

1841

1836

1842

<table>

1837

1843

<tr><td>h</td><td>Enter VT52 mode</td></tr>

1838

1844

<tr><td>l</td><td>Enter VT52 mode</td></tr>

1839

</table><dt><a name="item_ps__3d_3"><code>Ps = 3</code> ></a>

1840

</dt>

1845

</table><dt><a name="item_pm__3d_3"><code>Pm = 3</code> ></a>

1846

1841

1847

<table>

1842

1848

<tr><td>h</td><td>132 Column Mode (DECCOLM)</td></tr>

1843

1849

<tr><td>l</td><td>80 Column Mode (DECCOLM)</td></tr>

1844

</table><dt><code>Ps = 4</code> >

1845

</dt>

1850

</table><dt><a name="item_pm__3d_4"><code>Pm = 4</code> ></a>

1851

1846

1852

<table>

1847

1853

<tr><td>h</td><td>Smooth (Slow) Scroll (DECSCLM)</td></tr>

1848

1854

<tr><td>l</td><td>Jump (Fast) Scroll (DECSCLM)</td></tr>

1849

</table><dt><a name="item_ps__3d_5"><code>Ps = 5</code> ></a>

1850

</dt>

1855

</table><dt><a name="item_pm__3d_5"><code>Pm = 5</code> ></a>

1856

1851

1857

<table>

1852

1858

<tr><td>h</td><td>Reverse Video (DECSCNM)</td></tr>

1853

1859

<tr><td>l</td><td>Normal Video (DECSCNM)</td></tr>

1854

</table><dt><a name="item_ps__3d_6"><code>Ps = 6</code> ></a>

1855

</dt>

1860

</table><dt><a name="item_pm__3d_6"><code>Pm = 6</code> ></a>

1861

1856

1862

<table>

1857

1863

<tr><td>h</td><td>Origin Mode (DECOM)</td></tr>

1858

1864

<tr><td>l</td><td>Normal Cursor Mode (DECOM)</td></tr>

1859

</table><dt><a name="item_ps__3d_7"><code>Ps = 7</code> ></a>

1860

</dt>

1865

</table><dt><a name="item_pm__3d_7"><code>Pm = 7</code> ></a>

1866

1861

1867

<table>

1862

1868

<tr><td>h</td><td>Wraparound Mode (DECAWM)</td></tr>

1863

1869

<tr><td>l</td><td>No Wraparound Mode (DECAWM)</td></tr>

1864

</table><dt><a name="item_ps__3d_8_unimplemented"><code>Ps = 8</code> > unimplemented</a>

1865

</dt>

1870

</table><dt><a name="item_pm__3d_8_unimplemented"><code>Pm = 8</code> > unimplemented</a>

1871

1866

1872

<table>

1867

1873

<tr><td>h</td><td>Auto-repeat Keys (DECARM)</td></tr>

1868

1874

<tr><td>l</td><td>No Auto-repeat Keys (DECARM)</td></tr>

1869

</table><dt><a name="item_ps__3d_9_x10_xterm"><code>Ps = 9</code> > X10 XTerm</a>

1870

</dt>

1875

</table><dt><a name="item_pm__3d_9_x10_xterm"><code>Pm = 9</code> > X10 XTerm</a>

1876

1871

1877

<table>

1872

1878

<tr><td>h</td><td>Send Mouse X & Y on button press.</td></tr>

1873

1879

<tr><td>l</td><td>No mouse reporting.</td></tr>

1874

</table><dt><a name="item_ps__3d_25"><code>Ps = 25</code> ></a>

1875

</dt>

1880

</table><dt><a name="item_pm__3d_25"><code>Pm = 25</code> ></a>

1881

1876

1882

<table>

1877

1883

<tr><td>h</td><td>Visible cursor {cnorm/cvvis}</td></tr>

1878

1884

<tr><td>l</td><td>Invisible cursor {civis}</td></tr>

1879

</table><dt><a name="item_ps__3d_30"><code>Ps = 30</code> ></a>

1880

</dt>

1885

</table><dt><a name="item_pm__3d_30"><code>Pm = 30</code> ></a>

1886

1881

1887

<table>

1882

1888

<tr><td>h</td><td>scrollBar visisble</td></tr>

1883

1889

<tr><td>l</td><td>scrollBar invisisble</td></tr>

1884

</table><dt><a name="item_35"><code>Ps = 35</code> > (rxvt)</a>

1885

</dt>

1890

</table><dt><a name="item_35"><code>Pm = 35</code> > (rxvt)</a>

1891

1886

1892

<table>

1887

1893

<tr><td>h</td><td>Allow XTerm Shift+key sequences</td></tr>

1888

1894

<tr><td>l</td><td>Disallow XTerm Shift+key sequences</td></tr>

1889

</table><dt><a name="item_ps__3d_38_unimplemented"><code>Ps = 38</code> > unimplemented</a>

1890

</dt>

1895

</table><dt><a name="item_pm__3d_38_unimplemented"><code>Pm = 38</code> > unimplemented</a>

1896

1891

1897

<dd>

1892

Enter Tektronix Mode (DECTEK)

1898

Enter Tektronix Mode (DECTEK)

1893

1899

</dd>

1894

1895

1896

</dt>

1900

</li>

1901

1902

1897

1903

<table>

1898

1904

<tr><td>h</td><td>Allow 80/132 Mode</td></tr>

1899

1905

<tr><td>l</td><td>Disallow 80/132 Mode</td></tr>

1900

</table><dt><a name="item_ps__3d_44_unimplemented"><code>Ps = 44</code> > unimplemented</a>

1901

</dt>

1906

</table><dt><a name="item_pm__3d_44_unimplemented"><code>Pm = 44</code> > unimplemented</a>

1907

1902

1908

<table>

1903

1909

<tr><td>h</td><td>Turn On Margin Bell</td></tr>

1904

1910

<tr><td>l</td><td>Turn Off Margin Bell</td></tr>

1905

</table><dt><a name="item_ps__3d_45_unimplemented"><code>Ps = 45</code> > unimplemented</a>

1906

</dt>

1911

</table><dt><a name="item_pm__3d_45_unimplemented"><code>Pm = 45</code> > unimplemented</a>

1912

1907

1913

<table>

1908

1914

<tr><td>h</td><td>Reverse-wraparound Mode</td></tr>

1909

1915

<tr><td>l</td><td>No Reverse-wraparound Mode</td></tr>

1910

</table><dt><a name="item_ps__3d_46_unimplemented"><code>Ps = 46</code> > unimplemented</a>

1911

</dt>

1912

1913

</dt>

1916

</table><dt><a name="item_pm__3d_46_unimplemented"><code>Pm = 46</code> > unimplemented</a>

1917

1918

1919

1914

1920

<table>

1915

1921

<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>

1916

1922

<tr><td>l</td><td>Use Normal Screen Buffer</td></tr>

1917

1923

</table>

1918

1919

</dt>

1924

1925

1920

1926

<table>

1921

1927

<tr><td>h</td><td>Application Keypad (DECPAM) == ESC =</td></tr>

1922

1928

<tr><td>l</td><td>Normal Keypad (DECPNM) == ESC ></td></tr>

1923

</table><dt><a name="item_ps__3d_67"><code>Ps = 67</code> ></a>

1924

</dt>

1929

</table><dt><a name="item_pm__3d_67"><code>Pm = 67</code> ></a>

1930

1925

1931

<table>

1926

1932

<tr><td>h</td><td>Backspace key sends BS (DECBKM)</td></tr>

1927

1933

<tr><td>l</td><td>Backspace key sends DEL</td></tr>

1928

</table><dt><a name="item_1000"><code>Ps = 1000</code> > (X11 XTerm)</a>

1929

</dt>

1934

</table><dt><a name="item_1000"><code>Pm = 1000</code> > (X11 XTerm)</a>

1935

1930

1936

<table>

1931

1937

<tr><td>h</td><td>Send Mouse X & Y on button press and release.</td></tr>

1932

1938

<tr><td>l</td><td>No mouse reporting.</td></tr>

1933

</table><dt><a name="item_1001"><code>Ps = 1001</code> > (X11 XTerm) unimplemented</a>

1934

</dt>

1939

</table><dt><a name="item_1001"><code>Pm = 1001</code> > (X11 XTerm) unimplemented</a>

1940

1935

1941

<table>

1936

1942

<tr><td>h</td><td>Use Hilite Mouse Tracking.</td></tr>

1937

1943

<tr><td>l</td><td>No mouse reporting.</td></tr>

1938

</table><dt><a name="item_1010"><code>Ps = 1010</code> > (rxvt)</a>

1939

</dt>

1944

</table><dt><a name="item_1010"><code>Pm = 1010</code> > (rxvt)</a>

1945

1940

1946

<table>

1941

1947

<tr><td>h</td><td>Don't scroll to bottom on TTY output</td></tr>

1942

1948

<tr><td>l</td><td>Scroll to bottom on TTY output</td></tr>

1943

</table><dt><a name="item_1011"><code>Ps = 1011</code> > (rxvt)</a>

1944

</dt>

1949

</table><dt><a name="item_1011"><code>Pm = 1011</code> > (rxvt)</a>

1950

1945

1951

<table>

1946

1952

<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr>

1947

1953

<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>

1948

</table><dt><a name="item_1021"><code>Ps = 1021</code> > (rxvt)</a>

1949

</dt>

1954

</table><dt><a name="item_1021"><code>Pm = 1021</code> > (rxvt)</a>

1955

1950

1956

<table>

1951

1957

<tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr>

1952

1958

<tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr>

1953

</table><dt><a name="item_ps__3d_1047"><code>Ps = 1047</code> ></a>

1954

</dt>

1959

</table><dt><a name="item_pm__3d_1047"><code>Pm = 1047</code> ></a>

1960

1955

1961

<table>

1956

1962

<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>

1957

1963

<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>

1958

</table><dt><a name="item_ps__3d_1048"><code>Ps = 1048</code> ></a>

1959

</dt>

1964

</table><dt><a name="item_pm__3d_1048"><code>Pm = 1048</code> ></a>

1965

1960

1966

<table>

1961

1967

<tr><td>h</td><td>Save cursor position</td></tr>

1962

1968

<tr><td>l</td><td>Restore cursor position</td></tr>

1963

</table><dt><a name="item_ps__3d_1049"><code>Ps = 1049</code> ></a>

1964

</dt>

1969

</table><dt><a name="item_pm__3d_1049"><code>Pm = 1049</code> ></a>

1970

1965

1971

<table>

1966

1972

<tr><td>h</td><td>Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it</td></tr>

1967

1973

<tr><td>l</td><td>Use Normal Screen Buffer</td></tr>

1972

1978

1973

1979

<h2><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h2>

1974

1980

<dl>

1975

1976

</dt>

1981

1982

1977

1983

<dd>

1978

Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,

1984

Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,

1979

1985

0x5c), backwards compatible terminator BEL (0x07) is also accepted. any

1980

octet can be escaped by prefixing it with SYN (0x16, ^V).

1986

octet can be escaped by prefixing it with SYN (0x16, ^V).

1981

1987

</dd>

1982

1988

<table>

1983

1989

<tr><td>Ps = 0</td><td>Change Icon Name and Window Title to Pt</td></tr>

2011

2017

<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>

2012

2018

<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>

2013

2019

<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>

2014

</table></dl>

2020

</table></li>

2021

</dl>

2015

2022

2016

2023

2017

2024

<hr />

2021

2028

sequence of scaling/positioning commands separated by semi-colons. The

2022

2029

scaling/positioning commands are as follows:

2023

2030

<dl>

2024

<dt><a name="item_query_scale_2fposition">query scale/position</a>

2025

</dt>

2031

<dt><a name="item_query_scale_2fposition">query scale/position</a>

2032

2026

2033

<dd>

2027

?

2034

?

2028

2035

</dd>

2029

2030

<dt><a name="item_change_scale_and_position">change scale and position</a>

2031

</dt>

2036

</li>

2037

<dt><a name="item_change_scale_and_position">change scale and position</a>

2038

2032

2039

<dd>

2033

WxH+X+Y

2040

WxH+X+Y

2034

2041

</dd>

2035

2042

<dd>

2036

2043

WxH+X (== WxH+X+X)

2047

2054

<dd>

2048

2055

W (same as WxW+50+50)

2049

2056

</dd>

2050

2051

<dt><a name="item_position">change position (absolute)</a>

2052

</dt>

2057

</li>

2058

<dt><a name="item_position">change position (absolute)</a>

2059

2053

2060

<dd>

2054

=+X+Y

2061

=+X+Y

2055

2062

</dd>

2056

2063

<dd>

2057

2064

=+X (same as =+X+Y)

2058

2065

</dd>

2059

2060

<dt>change position (relative)

2061

</dt>

2066

</li>

2067

<dt>change position (relative)

2068

2062

2069

<dd>

2063

+X+Y

2070

+X+Y

2064

2071

</dd>

2065

2072

<dd>

2066

2073

+X (same as +X+Y)

2067

2074

</dd>

2068

2069

<dt><a name="item_rescale">rescale (relative)</a>

2070

</dt>

2075

</li>

2076

<dt><a name="item_rescale">rescale (relative)</a>

2077

2071

2078

<dd>

2072

Wx0 -> W *= (W/100)

2079

Wx0 -> W *= (W/100)

2073

2080

</dd>

2074

2081

<dd>

2075

2082

0xH -> H *= (H/100)

2076

2083

</dd>

2077

</dl>

2084

</li>

2085

</dl>

2078

2086

For example:

2079

2087

<dl>

2080

<dt><a name="item__5ce_5d20_3bfunky_5ca">\E]20;funky\a</a>

2081

</dt>

2082

<dd>

2083

load funky.xpm as a tiled image

2084

</dd>

2085

2086

2087

</dt>

2088

<dd>

2089

load mona.xpm with a scaling of 100%

2090

</dd>

2091

2092

2093

</dt>

2094

<dd>

2095

rescale the current pixmap to 200% and display the image geometry in

2096

the title

2097

</dd>

2098

</dl>

2088

<dt><a name="item__5ce_5d20_3bfunky_5ca">\E]20;funky\a</a>

2089

2090

<dd>

2091

load funky.xpm as a tiled image

2092

</dd>

2093

</li>

2094

2095

2096

<dd>

2097

load mona.xpm with a scaling of 100%

2098

</dd>

2099

</li>

2100

2101

2102

<dd>

2103

rescale the current pixmap to 200% and display the image geometry in

2104

the title

2105

</dd>

2106

</li>

2107

</dl>

2099

2108

2100

2109

2101

2110

<hr />

2102

2111

<h1><a name="mouse_reporting">Mouse Reporting</a></h1>

2103

2112

<dl>

2104

2105

</dt>

2113

2114

2106

2115

<dd>

2107

report mouse position

2116

report mouse position

2108

2117

</dd>

2109

</dl>

2118

</li>

2119

</dl>

2110

2120

The lower 2 bits of <code></code> > indicate the button:

2111

2121

<dl>

2112

<dt><a name="item_button__3d__28_3cb_3e__2d_space_29__26_3">Button = <code>( - SPACE) & 3</code> ></a>

2113

</dt>

2122

<dt><a name="item_button__3d__28_3cb_3e__2d_space_29__26_3">Button = <code>( - SPACE) & 3</code> ></a>

2123

2114

2124

<table>

2115

2125

<tr><td>0</td><td>Button1 pressed</td></tr>

2116

2126

<tr><td>1</td><td>Button2 pressed</td></tr>

2120

2130

The upper bits of <code></code> > indicate the modifiers when the

2121

2131

button was pressed and are added together (X11 mouse report only):

2122

2132

<dl>

2123

<dt><a name="item_state__3d__28_3cb_3e__2d_space_29__26_60">State = <code>( - SPACE) & 60</code> ></a>

2124

</dt>

2133

<dt><a name="item_state__3d__28_3cb_3e__2d_space_29__26_60">State = <code>( - SPACE) & 60</code> ></a>

2134

2125

2135

<table>

2126

2136

<tr><td>4</td><td>Shift</td></tr>

2127

2137

2211

2221

Lehmann <<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>>.

2212

2222

All

2213

2223

<dl>

2214

<dt><a name="item__2d_2denable_2deverything">--enable-everything</a>

2215

</dt>

2224

<dt><a name="item__2d_2denable_2deverything">--enable-everything</a>

2225

2216

2226

<dd>

2217

Add (or remove) support for all non-multichoice options listed in ``./configure

2218

--help''.

2227

Add (or remove) support for all non-multichoice options listed in ``./configure

2228

--help''.

2219

2229

</dd>

2220

2230

<dd>

2221

2231

You can specify this and then disable options you do not like by

2224

2234

<code>--disable-everything</code> and than adding just the <code>--enable-...</code> arguments

2225

2235

you want.

2226

2236

</dd>

2227

2228

<dt><a name="item_xft">--enable-xft (default: enabled)</a>

2229

</dt>

2237

</li>

2238

<dt><a name="item_xft">--enable-xft (default: enabled)</a>

2239

2230

2240

<dd>

2231

Add support for Xft (anti-aliases, among others) fonts. Xft fonts are

2241

Add support for Xft (anti-aliases, among others) fonts. Xft fonts are

2232

2242

slower and require lots of memory, but as long as you don't use them, you

2233

don't pay for them.

2234

</dd>

2235

2236

<dt><a name="item_styles">--enable-font-styles (default: on)</a>

2237

</dt>

2238

<dd>

2239

Add support for bold, italic and bold italic > font

2240

styles. The fonts can be set manually or automatically.

2241

</dd>

2242

2243

<dt><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e__28defaul">--with-codesets=NAME,... (default: all)</a>

2244

</dt>

2245

<dd>

2246

Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>

2243

don't pay for them.

2244

</dd>

2245

</li>

2246

<dt><a name="item_styles">--enable-font-styles (default: on)</a>

2247

2248

<dd>

2249

Add support for bold, italic and bold italic > font

2250

styles. The fonts can be set manually or automatically.

2251

</dd>

2252

</li>

2253

<dt><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e__28defaul">--with-codesets=NAME,... (default: all)</a>

2254

2255

<dd>

2256

Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>

2247

2257

are always compiled in, which includes most 8-bit character sets). These

2248

2258

codeset tables are used for driving X11 core fonts, they are not required

2249

2259

for Xft fonts, although having them compiled in lets rxvt-unicode choose

2250

2260

replacement fonts more intelligently. Compiling them in will make your

2251

2261

binary bigger (all of together cost about 700kB), but it doesn't increase

2252

memory usage unless you use a font requiring one of these encodings.

2262

memory usage unless you use a font requiring one of these encodings.

2253

2263

</dd>

2254

2264

<table>

2255

2265

<tr><td>all</td><td>all available codeset groups</td></tr>

2258

2268

<tr><td>jp</td><td>common japanese encodings</td></tr>

2259

2269

<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr>

2260

2270

<tr><td>kr</td><td>korean encodings</td></tr>

2261

</table>

2262

<dt><a name="item_xim">--enable-xim (default: on)</a>

2263

</dt>

2271

</table></li>

2272

<dt><a name="item_xim">--enable-xim (default: on)</a>

2273

2264

2274

<dd>

2265

Add support for XIM (X Input Method) protocol. This allows using

2275

Add support for XIM (X Input Method) protocol. This allows using

2266

2276

alternative input methods (e.g. kinput2) and will also correctly

2267

set up the input for people using dead keys or compose keys.

2277

set up the input for people using dead keys or compose keys.

2268

2278

</dd>

2269

2270

<dt><a name="item_unicode3">--enable-unicode3 (default: off)</a>

2271

</dt>

2279

</li>

2280

<dt><a name="item_unicode3">--enable-unicode3 (default: off)</a>

2281

2272

2282

<dd>

2273

Recommended to stay off unless you really need non-BMP characters.

2283

Recommended to stay off unless you really need non-BMP characters.

2274

2284

</dd>

2275

2285

<dd>

2276

2286

Enable direct support for displaying unicode codepoints above

2285

2295

see next switch), and right now rxvt-unicode cannot display them

2286

2296

(input/output and cut&paste still work, though).

2287

2297

</dd>

2288

2289

<dt><a name="item_combining">--enable-combining (default: on)</a>

2290

</dt>

2298

</li>

2299

<dt><a name="item_combining">--enable-combining (default: on)</a>

2300

2291

2301

<dd>

2292

Enable automatic composition of combining characters into

2302

Enable automatic composition of combining characters into

2293

2303

composite characters. This is required for proper viewing of text

2294

2304

where accents are encoded as seperate unicode characters. This is

2295

2305

done by using precomposited characters when available or creating

2296

new pseudo-characters when no precomposed form exists.

2306

new pseudo-characters when no precomposed form exists.

2297

2307

</dd>

2298

2308

<dd>

2299

2309

Without --enable-unicode3, the number of additional precomposed

2309

2319

but these are not currently used. Bug me if you want these to be used (and

2310

2320

tell me how these are to be used...).

2311

2321

</dd>

2312

2313

<dt><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a>

2314

</dt>

2315

<dd>

2316

When reading resource settings, also read settings for class CLASS. To

2317

disable resource fallback use --disable-fallback.

2318

</dd>

2319

2320

<dt><a name="item_name">--with-res-name=NAME (default: urxvt)</a>

2321

</dt>

2322

<dd>

2323

Use the given name as default application name when

2324

reading resources. Specify --with-res-name=rxvt to replace rxvt.

2325

</dd>

2326

2327

<dt><a name="item__2d_2dwith_2dres_2dclass_3dclass__2fdefault_3a_urx">--with-res-class=CLASS /default: URxvt)</a>

2328

</dt>

2329

<dd>

2330

Use the given class as default application class

2322

</li>

2323

<dt><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a>

2324

2325

<dd>

2326

When reading resource settings, also read settings for class CLASS. To

2327

disable resource fallback use --disable-fallback.

2328

</dd>

2329

</li>

2330

<dt><a name="item_name">--with-res-name=NAME (default: urxvt)</a>

2331

2332

<dd>

2333

Use the given name as default application name when

2334

reading resources. Specify --with-res-name=rxvt to replace rxvt.

2335

</dd>

2336

</li>

2337

<dt><a name="item__2d_2dwith_2dres_2dclass_3dclass__2fdefault_3a_urx">--with-res-class=CLASS /default: URxvt)</a>

2338

2339

<dd>

2340

Use the given class as default application class

2331

2341

when reading resources. Specify --with-res-class=Rxvt to replace

2332

rxvt.

2333

</dd>

2334

2335

<dt><a name="item_utmp">--enable-utmp (default: on)</a>

2336

</dt>

2337

<dd>

2338

Write user and tty to utmp file (used by programs like w) at

2339

start of rxvt execution and delete information when rxvt exits.

2340

</dd>

2341

2342

<dt><a name="item_wtmp">--enable-wtmp (default: on)</a>

2343

</dt>

2344

<dd>

2345

Write user and tty to wtmp file (used by programs like last) at

2342

rxvt.

2343

</dd>

2344

</li>

2345

<dt><a name="item_utmp">--enable-utmp (default: on)</a>

2346

2347

<dd>

2348

Write user and tty to utmp file (used by programs like w) at

2349

start of rxvt execution and delete information when rxvt exits.

2350

</dd>

2351

</li>

2352

<dt><a name="item_wtmp">--enable-wtmp (default: on)</a>

2353

2354

<dd>

2355

Write user and tty to wtmp file (used by programs like last) at

2346

2356

start of rxvt execution and write logout when rxvt exits. This

2347

option requires --enable-utmp to also be specified.

2357

option requires --enable-utmp to also be specified.

2348

2358

</dd>

2349

2350

<dt><a name="item_lastlog">--enable-lastlog (default: on)</a>

2351

</dt>

2359

</li>

2360

<dt><a name="item_lastlog">--enable-lastlog (default: on)</a>

2361

2352

2362

<dd>

2353

Write user and tty to lastlog file (used by programs like

2363

Write user and tty to lastlog file (used by programs like

2354

2364

lastlogin) at start of rxvt execution. This option requires

2355

--enable-utmp to also be specified.

2356

</dd>

2357

2358

<dt><a name="item_background">--enable-xpm-background (default: on)</a>

2359

</dt>

2360

<dd>

2361

Add support for XPM background pixmaps.

2362

</dd>

2363

2364

<dt><a name="item_transparency">--enable-transparency (default: on)</a>

2365

</dt>

2366

<dd>

2367

Add support for inheriting parent backgrounds thus giving a fake

2368

transparency to the term.

2369

</dd>

2370

2371

<dt><a name="item_fading">--enable-fading (default: on)</a>

2372

</dt>

2373

<dd>

2374

Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).

2375

</dd>

2376

2377

<dt><a name="item_tinting">--enable-tinting (default: on)</a>

2378

</dt>

2379

<dd>

2380

Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).

2381

</dd>

2382

2383

<dt><a name="item_scroll">--enable-rxvt-scroll (default: on)</a>

2384

</dt>

2385

<dd>

2386

Add support for the original rxvt scrollbar.

2387

</dd>

2388

2389

<dt>--enable-next-scroll (default: on)

2390

</dt>

2391

<dd>

2392

Add support for a NeXT-like scrollbar.

2393

</dd>

2394

2395

<dt>--enable-xterm-scroll (default: on)

2396

</dt>

2397

<dd>

2398

Add support for an Xterm-like scrollbar.

2399

</dd>

2400

2401

<dt>--enable-plain-scroll (default: on)

2402

</dt>

2403

<dd>

2404

Add support for a very unobtrusive, plain-looking scrollbar that

2365

--enable-utmp to also be specified.

2366

</dd>

2367

</li>

2368

<dt><a name="item_background">--enable-xpm-background (default: on)</a>

2369

2370

<dd>

2371

Add support for XPM background pixmaps.

2372

</dd>

2373

</li>

2374

<dt><a name="item_transparency">--enable-transparency (default: on)</a>

2375

2376

<dd>

2377

Add support for inheriting parent backgrounds thus giving a fake

2378

transparency to the term.

2379

</dd>

2380

</li>

2381

<dt><a name="item_fading">--enable-fading (default: on)</a>

2382

2383

<dd>

2384

Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).

2385

</dd>

2386

</li>

2387

<dt><a name="item_tinting">--enable-tinting (default: on)</a>

2388

2389

<dd>

2390

Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).

2391

</dd>

2392

</li>

2393

<dt><a name="item_scroll">--enable-rxvt-scroll (default: on)</a>

2394

2395

<dd>

2396

Add support for the original rxvt scrollbar.

2397

</dd>

2398

</li>

2399

<dt>--enable-next-scroll (default: on)

2400

2401

<dd>

2402

Add support for a NeXT-like scrollbar.

2403

</dd>

2404

</li>

2405

<dt>--enable-xterm-scroll (default: on)

2406

2407

<dd>

2408

Add support for an Xterm-like scrollbar.

2409

</dd>

2410

</li>

2411

<dt>--enable-plain-scroll (default: on)

2412

2413

<dd>

2414

Add support for a very unobtrusive, plain-looking scrollbar that

2405

2415

is the favourite of the rxvt-unicode author, having used it for

2406

many years.

2407

</dd>

2408

2409

<dt><a name="item_ttygid">--enable-ttygid (default: off)</a>

2410

</dt>

2411

<dd>

2412

Change tty device setting to group ``tty'' - only use this if

2413

your system uses this type of security.

2414

</dd>

2415

2416

<dt><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a>

2417

</dt>

2418

<dd>

2419

Removes any handling of the backspace key by us - let the X server do it.

2420

</dd>

2421

2422

<dt><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a>

2423

</dt>

2424

<dd>

2425

Removes any handling of the delete key by us - let the X server

2426

do it.

2427

</dd>

2428

2429

<dt><a name="item__2d_2ddisable_2dresources">--disable-resources</a>

2430

</dt>

2431

<dd>

2432

Removes any support for resource checking.

2433

</dd>

2434

2435

<dt><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a>

2436

</dt>

2437

<dd>

2438

Remove support for secondary/swap screen.

2439

</dd>

2440

2441

<dt><a name="item_frills">--enable-frills (default: on)</a>

2442

</dt>

2443

<dd>

2444

Add support for many small features that are not essential but nice to

2416

many years.

2417

</dd>

2418

</li>

2419

<dt><a name="item_ttygid">--enable-ttygid (default: off)</a>

2420

2421

<dd>

2422

Change tty device setting to group ``tty'' - only use this if

2423

your system uses this type of security.

2424

</dd>

2425

</li>

2426

<dt><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a>

2427

2428

<dd>

2429

Removes any handling of the backspace key by us - let the X server do it.

2430

</dd>

2431

</li>

2432

<dt><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a>

2433

2434

<dd>

2435

Removes any handling of the delete key by us - let the X server

2436

do it.

2437

</dd>

2438

</li>

2439

<dt><a name="item__2d_2ddisable_2dresources">--disable-resources</a>

2440

2441

<dd>

2442

Removes any support for resource checking.

2443

</dd>

2444

</li>

2445

<dt><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a>

2446

2447

<dd>

2448

Remove support for secondary/swap screen.

2449

</dd>

2450

</li>

2451

<dt><a name="item_frills">--enable-frills (default: on)</a>

2452

2453

<dd>

2454

Add support for many small features that are not essential but nice to

2445

2455

have. Normally you want this, but for very small binaries you may want to

2446

disable this.

2456

disable this.

2447

2457

</dd>

2448

2458

<dd>

2449

2459

A non-exhaustive list of features enabled by <code>--enable-frills</code> (possibly

2465

2475

XEmbed support (-embed)

2466

2476

user-pty (-pty-fd)

2467

2477

hold on exit (-hold)

2468

skip builtin block graphics (-sbg)</pre>

2478

skip builtin block graphics (-sbg)

2479

separate highlightcolor support (-hc)</pre>

2469

2480

</dd>

2470

2481

<dd>

2471

It also enabled some non-essential features otherwise disabled, such as:

2482

It also enables some non-essential features otherwise disabled, such as:

2472

2483

</dd>

2473

2484

<dd>

2474

2485

<pre>

2484

2495

trailing space removal for selections

2485

2496

verbose X error handling</pre>

2486

2497

</dd>

2487

2488

<dt><a name="item_iso14755">--enable-iso14755 (default: on)</a>

2489

</dt>

2498

</li>

2499

<dt><a name="item_iso14755">--enable-iso14755 (default: on)</a>

2500

2490

2501

<dd>

2491

Enable extended ISO 14755 support (see rxvt(1), or

2502

Enable extended ISO 14755 support (see rxvt(1), or

2492

2503

doc/rxvt.1.txt). Basic support (section 5.1) is enabled by

2493

2504

<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with

2494

this switch.

2495

</dd>

2496

2497

<dt><a name="item_keepscrolling">--enable-keepscrolling (default: on)</a>

2498

</dt>

2499

<dd>

2500

Add support for continual scrolling of the display when you hold

2501

the mouse button down on a scrollbar arrow.

2502

</dd>

2503

2504

<dt><a name="item_mousewheel">--enable-mousewheel (default: on)</a>

2505

</dt>

2506

<dd>

2507

Add support for scrolling via mouse wheel or buttons 4 & 5.

2508

</dd>

2509

2510

<dt><a name="item_slipwheeling">--enable-slipwheeling (default: on)</a>

2511

</dt>

2512

<dd>

2513

Add support for continual scrolling (using the mouse wheel as an

2505

this switch.

2506

</dd>

2507

</li>

2508

<dt><a name="item_keepscrolling">--enable-keepscrolling (default: on)</a>

2509

2510

<dd>

2511

Add support for continual scrolling of the display when you hold

2512

the mouse button down on a scrollbar arrow.

2513

</dd>

2514

</li>

2515

<dt><a name="item_mousewheel">--enable-mousewheel (default: on)</a>

2516

2517

<dd>

2518

Add support for scrolling via mouse wheel or buttons 4 & 5.

2519

</dd>

2520

</li>

2521

<dt><a name="item_slipwheeling">--enable-slipwheeling (default: on)</a>

2522

2523

<dd>

2524

Add support for continual scrolling (using the mouse wheel as an

2514

2525

accelerator) while the control key is held down. This option

2515

requires --enable-mousewheel to also be specified.

2516

</dd>

2517

2518

<dt><a name="item__2d_2ddisable_2dnew_2dselection">--disable-new-selection</a>

2519

</dt>

2520

<dd>

2521

Remove support for mouse selection style like that of xterm.

2522

</dd>

2523

2524

<dt><a name="item_dmalloc">--enable-dmalloc (default: off)</a>

2525

</dt>

2526

<dd>

2527

Use Gray Watson's malloc - which is good for debugging See

2526

requires --enable-mousewheel to also be specified.

2527

</dd>

2528

</li>

2529

<dt><a name="item__2d_2ddisable_2dnew_2dselection">--disable-new-selection</a>

2530

2531

<dd>

2532

Remove support for mouse selection style like that of xterm.

2533

</dd>

2534

</li>

2535

<dt><a name="item_dmalloc">--enable-dmalloc (default: off)</a>

2536

2537

<dd>

2538

Use Gray Watson's malloc - which is good for debugging See

2528

2539

<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the

2529

2540

next option, you may need to edit src/Makefile after compiling to point

2530

DINCLUDE and DLIB to the right places.

2541

DINCLUDE and DLIB to the right places.

2531

2542

</dd>

2532

2543

<dd>

2533

2544

You can only use either this option and the following (should

2534

2545

you use either) .

2535

2546

</dd>

2536

2537

<dt><a name="item_dlmalloc">--enable-dlmalloc (default: off)</a>

2538

</dt>

2547

</li>

2548

<dt><a name="item_dlmalloc">--enable-dlmalloc (default: off)</a>

2549

2539

2550

<dd>

2540

Use Doug Lea's malloc - which is good for a production version

2541

See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.

2551

Use Doug Lea's malloc - which is good for a production version

2552

See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.

2542

2553

</dd>

2543

2544

<dt><a name="item_resize">--enable-smart-resize (default: on)</a>

2545

</dt>

2554

</li>

2555

<dt><a name="item_resize">--enable-smart-resize (default: on)</a>

2556

2546

2557

<dd>

2547

Add smart growth/shrink behaviour when changing font size via hot

2558

Add smart growth/shrink behaviour when changing font size via hot

2548

2559

keys. This should keep the window corner which is closest to a corner of

2549

the screen in a fixed position.

2550

</dd>

2551

2552

<dt><a name="item_blank">--enable-pointer-blank (default: on)</a>

2553

</dt>

2554

<dd>

2555

Add support to have the pointer disappear when typing or inactive.

2556

</dd>

2557

2558

<dt><a name="item_perl">--enable-perl (default: on)</a>

2559

</dt>

2560

<dd>

2561

Enable an embedded perl interpreter. See the rxvtperl(3)

2560

the screen in a fixed position.

2561

</dd>

2562

</li>

2563

<dt><a name="item_blank">--enable-pointer-blank (default: on)</a>

2564

2565

<dd>

2566

Add support to have the pointer disappear when typing or inactive.

2567

</dd>

2568

</li>

2569

<dt><a name="item_perl">--enable-perl (default: on)</a>

2570

2571

<dd>

2572

Enable an embedded perl interpreter. See the rxvtperl(3)

2562

2573

manpage (doc/rxvtperl.txt) for more info on this feature, or the files

2563

2574

in src/perl-ext/ for the extensions that are installed by default. The

2564

2575

perl interpreter that is used can be specified via the <code>PERL</code> environment

2565

variable when running configure.

2576

variable when running configure.

2566

2577

</dd>

2567

2568

<dt>--with-name=NAME (default: urxvt)

2569

</dt>

2578

</li>

2579

<dt>--with-name=NAME (default: urxvt)

2580

2570

2581

<dd>

2571

Set the basename for the installed binaries, resulting

2582

Set the basename for the installed binaries, resulting

2572

2583

in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with

2573

<code>rxvt</code>.

2574

</dd>

2575

2576

<dt>--with-term=NAME (default: rxvt-unicode)

2577

</dt>

2578

<dd>

2579

Change the environmental variable for the terminal to NAME.

2580

</dd>

2581

2582

<dt><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a>

2583

</dt>

2584

<dd>

2585

Change the environmental variable for the path to the terminfo tree to

2586

PATH.

2587

</dd>

2588

2589

2590

</dt>

2591

<dd>

2592

Use the X Window System (pretty much default, eh?).

2593

</dd>

2594

2595

<dt><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a>

2596

</dt>

2597

<dd>

2598

Look for the XPM includes in DIR.

2599

</dd>

2600

2601

<dt><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a>

2602

</dt>

2603

<dd>

2604

Look for the XPM library in DIR.

2605

</dd>

2606

2607

2608

</dt>

2609

<dd>

2610

Not needed - define via --enable-xpm-background.

2611

</dd>

2612

</dl>

2584

<code>rxvt</code>.

2585

</dd>

2586

</li>

2587

<dt>--with-term=NAME (default: rxvt-unicode)

2588

2589

<dd>

2590

Change the environmental variable for the terminal to NAME.

2591

</dd>

2592

</li>

2593

<dt><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a>

2594

2595

<dd>

2596

Change the environmental variable for the path to the terminfo tree to

2597

PATH.

2598

</dd>

2599

</li>

2600

2601

2602

<dd>

2603

Use the X Window System (pretty much default, eh?).

2604

</dd>

2605

</li>

2606

<dt><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a>

2607

2608

<dd>

2609

Look for the XPM includes in DIR.

2610

</dd>

2611

</li>

2612

<dt><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a>

2613

2614

<dd>

2615

Look for the XPM library in DIR.

2616

</dd>

2617

</li>

2618

2619

2620

<dd>

2621

Not needed - define via --enable-xpm-background.

2622

</dd>

2623

</li>

2624

</dl>

2613

2625

2614

2626

2615

2627

<hr />