ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.126 by root, Fri Dec 26 22:52:23 2014 UTC vs.
Revision 1.127 by root, Wed Dec 31 14:12:44 2014 UTC

1.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) 1.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2.\" 2.\"
3.\" Standard preamble: 3.\" Standard preamble:
4.\" ======================================================================== 4.\" ========================================================================
5.de Sp \" Vertical space (when we can't use .PP) 5.de Sp \" Vertical space (when we can't use .PP)
6.if t .sp .5v 6.if t .sp .5v
36.el\{\ 36.el\{\
37. ds -- \|\(em\| 37. ds -- \|\(em\|
38. ds PI \(*p 38. ds PI \(*p
39. ds L" `` 39. ds L" ``
40. ds R" '' 40. ds R" ''
41. ds C`
42. ds C'
43'br\} 41'br\}
44.\" 42.\"
45.\" Escape single quotes in literal strings from groff's Unicode transform. 43.\" Escape single quotes in literal strings from groff's Unicode transform.
46.ie \n(.g .ds Aq \(aq 44.ie \n(.g .ds Aq \(aq
47.el .ds Aq ' 45.el .ds Aq '
48.\" 46.\"
49.\" If the F register is turned on, we'll generate index entries on stderr for 47.\" If the F register is turned on, we'll generate index entries on stderr for
50.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 48.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51.\" entries marked with X<> in POD. Of course, you'll have to process the 49.\" entries marked with X<> in POD. Of course, you'll have to process the
52.\" output yourself in some meaningful fashion. 50.\" output yourself in some meaningful fashion.
53.\" 51.ie \nF \{\
54.\" Avoid warning from groff about undefined register 'F'.
55.de IX 52. de IX
53. tm Index:\\$1\t\\n%\t"\\$2"
56.. 54..
57.nr rF 0 55. nr % 0
58.if \n(.g .if rF .nr rF 1 56. rr F
59.if (\n(rF:(\n(.g==0)) \{ 57.\}
60. if \nF \{ 58.el \{\
61. de IX 59. de IX
62. tm Index:\\$1\t\\n%\t"\\$2"
63.. 60..
64. if !\nF==2 \{
65. nr % 0
66. nr F 2
67. \}
68. \}
69.\} 61.\}
70.rr rF
71.\" 62.\"
72.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 63.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73.\" Fear. Run. Save yourself. No user-serviceable parts. 64.\" Fear. Run. Save yourself. No user-serviceable parts.
74. \" fudge factors for nroff and troff 65. \" fudge factors for nroff and troff
75.if n \{\ 66.if n \{\
131.\} 122.\}
132.rm #[ #] #H #V #F C 123.rm #[ #] #H #V #F C
133.\" ======================================================================== 124.\" ========================================================================
134.\" 125.\"
135.IX Title "@@RXVT_NAME@@ 7" 126.IX Title "@@RXVT_NAME@@ 7"
136.TH @@RXVT_NAME@@ 7 "2014-12-26" "@@RXVT_VERSION@@" "RXVT-UNICODE" 127.TH @@RXVT_NAME@@ 7 "2014-12-31" "@@RXVT_VERSION@@" "RXVT-UNICODE"
137.\" For nroff, turn off justification. Always turn off hyphenation; it makes 128.\" For nroff, turn off justification. Always turn off hyphenation; it makes
138.\" way too many mistakes in technical documents. 129.\" way too many mistakes in technical documents.
139.if n .ad l 130.if n .ad l
140.nh 131.nh
141.SH "NAME" 132.SH "NAME"
152\& # set window title 143\& # set window title
153\& printf \*(Aq\e33]2;%s\e007\*(Aq "new window title" 144\& printf \*(Aq\e33]2;%s\e007\*(Aq "new window title"
154.Ve 145.Ve
155.SH "DESCRIPTION" 146.SH "DESCRIPTION"
156.IX Header "DESCRIPTION" 147.IX Header "DESCRIPTION"
157This document contains the \s-1FAQ,\s0 the \s-1RXVT TECHNICAL REFERENCE\s0 documenting 148This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting
158all escape sequences, and other background information. 149all escape sequences, and other background information.
159.PP 150.PP
160The newest version of this document is also available on the World Wide Web at 151The newest version of this document is also available on the World Wide Web at
161<http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.7.pod>. 152http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.7.pod <http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>.
162.PP 153.PP
163The main manual page for @@RXVT_NAME@@ itself is available at 154The main manual page for @@RXVT_NAME@@ itself is available at
164<http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod>. 155http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod <http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
165.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" 156.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
166.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" 157.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
167.SS "Meta, Features & Commandline Issues" 158.SS "Meta, Features & Commandline Issues"
168.IX Subsection "Meta, Features & Commandline Issues" 159.IX Subsection "Meta, Features & Commandline Issues"
169\fIMy question isn't answered here, can I ask a human?\fR 160\fIMy question isn't answered here, can I ask a human?\fR
170.IX Subsection "My question isn't answered here, can I ask a human?" 161.IX Subsection "My question isn't answered here, can I ask a human?"
171.PP 162.PP
172Before sending me mail, you could go to \s-1IRC: \s0\f(CW\*(C`irc.freenode.net\*(C'\fR, 163Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,
173channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be 164channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be
174interested in learning about new and exciting problems (but not FAQs :). 165interested in learning about new and exciting problems (but not FAQs :).
175.PP 166.PP
176\fII use Gentoo, and I have a problem...\fR 167\fII use Gentoo, and I have a problem...\fR
177.IX Subsection "I use Gentoo, and I have a problem..." 168.IX Subsection "I use Gentoo, and I have a problem..."
255existing daemon. 246existing daemon.
256.PP 247.PP
257\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc.\fR 248\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc.\fR
258.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc." 249.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc."
259.PP 250.PP
260The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\*(R",\s0 251The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
261so you can check and see if that is set. Note that several programs, \s-1JED,\s0 252so you can check and see if that is set. Note that several programs, \s-1JED\s0,
262slrn, Midnight Commander automatically check this variable to decide 253slrn, Midnight Commander automatically check this variable to decide
263whether or not to use colour. 254whether or not to use colour.
264.PP 255.PP
265\fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR 256\fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR
266.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?" 257.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?"
267.PP 258.PP
268If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled 259If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled
269insecure mode then it is possible to use the following shell script 260insecure mode then it is possible to use the following shell script
270snippets to correctly set the display. If your version of rxvt-unicode 261snippets to correctly set the display. If your version of rxvt-unicode
271wasn't also compiled with \s-1ESCZ_ANSWER \s0(as assumed in these snippets) then 262wasn't also compiled with \s-1ESCZ_ANSWER\s0 (as assumed in these snippets) then
272the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a 263the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a
273regular xterm. 264regular xterm.
274.PP 265.PP
275Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script 266Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
276snippets: 267snippets:
328encoding tables, which, if unused, take up disk space but nothing else 319encoding tables, which, if unused, take up disk space but nothing else
329and can be compiled out unless you rely on X11 core fonts that use those 320and can be compiled out unless you rely on X11 core fonts that use those
330encodings. The \s-1BSS\s0 size comes from the 64k emergency buffer that my c++ 321encodings. The \s-1BSS\s0 size comes from the 64k emergency buffer that my c++
331compiler allocates (but of course doesn't use unless you are out of 322compiler allocates (but of course doesn't use unless you are out of
332memory). Also, using an xft font instead of a core font immediately adds a 323memory). Also, using an xft font instead of a core font immediately adds a
333few megabytes of \s-1RSS.\s0 Xft indeed is responsible for a lot of \s-1RSS\s0 even when 324few megabytes of \s-1RSS\s0. Xft indeed is responsible for a lot of \s-1RSS\s0 even when
334not used. 325not used.
335.PP 326.PP
336Of course, due to every character using two or four bytes instead of one, 327Of course, due to every character using two or four bytes instead of one,
337a large scrollback buffer will ultimately make rxvt-unicode use more 328a large scrollback buffer will ultimately make rxvt-unicode use more
338memory. 329memory.
358domain sockets, which are all less portable than \*(C+ itself. 349domain sockets, which are all less portable than \*(C+ itself.
359.PP 350.PP
360Regarding the bloat, see the above question: It's easy to write programs 351Regarding the bloat, see the above question: It's easy to write programs
361in C that use gobs of memory, and certainly possible to write programs in 352in C that use gobs of memory, and certainly possible to write programs in
362\&\*(C+ that don't. \*(C+ also often comes with large libraries, but this is 353\&\*(C+ that don't. \*(C+ also often comes with large libraries, but this is
363not necessarily the case with \s-1GCC.\s0 Here is what rxvt links against on my 354not necessarily the case with \s-1GCC\s0. Here is what rxvt links against on my
364system with a minimal config: 355system with a minimal config:
365.PP 356.PP
366.Vb 4 357.Vb 4
367\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 358\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
368\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) 359\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
555color0\-7 are the low-intensity colours. 546color0\-7 are the low-intensity colours.
556.PP 547.PP
557color8\-15 are the corresponding high-intensity colours. 548color8\-15 are the corresponding high-intensity colours.
558.PP 549.PP
559\fII don't like the screen colours. How do I change them?\fR 550\fII don't like the screen colours. How do I change them?\fR
560.IX Subsection "I don't like the screen colours. How do I change them?" 551.IX Subsection "I don't like the screen colours. How do I change them?"
561.PP 552.PP
562You can change the screen colours at run-time using \fI~/.Xdefaults\fR 553You can change the screen colours at run-time using \fI~/.Xdefaults\fR
563resources (or as long-options). 554resources (or as long-options).
564.PP 555.PP
565Here are values that are supposed to resemble a \s-1VGA\s0 screen, 556Here are values that are supposed to resemble a \s-1VGA\s0 screen,
711\&\fBperl-ext-common\fR resource to the empty string, which also keeps 702\&\fBperl-ext-common\fR resource to the empty string, which also keeps
712rxvt-unicode from initialising perl, saving memory. 703rxvt-unicode from initialising perl, saving memory.
713.PP 704.PP
714If you only want to disable specific features, you first have to 705If you only want to disable specific features, you first have to
715identify which perl extension is responsible. For this, read the section 706identify which perl extension is responsible. For this, read the section
716\&\fB\s-1PREPACKAGED EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For 707\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For
717example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify 708example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
718this \fBperl-ext-common\fR resource: 709this \fBperl-ext-common\fR resource:
719.PP 710.PP
720.Vb 1 711.Vb 1
721\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup 712\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup
776.PP 767.PP
777If it still doesn't work, then maybe your input method doesn't support 768If it still doesn't work, then maybe your input method doesn't support
778compose sequences \- to fall back to the built-in one, make sure you don't 769compose sequences \- to fall back to the built-in one, make sure you don't
779specify an input method via \f(CW\*(C`\-im\*(C'\fR or \f(CW\*(C`XMODIFIERS\*(C'\fR. 770specify an input method via \f(CW\*(C`\-im\*(C'\fR or \f(CW\*(C`XMODIFIERS\*(C'\fR.
780.PP 771.PP
781\fII cannot type \f(CI\*(C`Ctrl\-Shift\-2\*(C'\fI to get an \s-1ASCII NUL\s0 character due to \s-1ISO 14755\s0\fR 772\fII cannot type \f(CI\*(C`Ctrl\-Shift\-2\*(C'\fI to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755\fR
782.IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755" 773.IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755"
783.PP 774.PP
784Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII NUL\s0 even on 775Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on
785international keyboards) or simply use \s-1ISO 14755\s0 support to your 776international keyboards) or simply use \s-1ISO\s0 14755 support to your
786advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII NUL.\s0 This works for other 777advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other
787codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape 778codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape
788character and so on. 779character and so on.
789.PP 780.PP
790\fIMouse cut/paste suddenly no longer works.\fR 781\fIMouse cut/paste suddenly no longer works.\fR
791.IX Subsection "Mouse cut/paste suddenly no longer works." 782.IX Subsection "Mouse cut/paste suddenly no longer works."
837\&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help. 828\&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help.
838.PP 829.PP
839Perhaps someday this will all be resolved in a consistent manner. 830Perhaps someday this will all be resolved in a consistent manner.
840.PP 831.PP
841\fII don't like the key-bindings. How do I change them?\fR 832\fII don't like the key-bindings. How do I change them?\fR
842.IX Subsection "I don't like the key-bindings. How do I change them?" 833.IX Subsection "I don't like the key-bindings. How do I change them?"
843.PP 834.PP
844There are some compile-time selections available via configure. Unless 835There are some compile-time selections available via configure. Unless
845you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can 836you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can
846use the `keysym' resource to alter the keystrings associated with keysyms. 837use the `keysym' resource to alter the keystrings associated with keysyms.
847.PP 838.PP
1314.IX Subsection "I have problems getting my input method working." 1305.IX Subsection "I have problems getting my input method working."
1315.PP 1306.PP
1316Try a search engine, as this is slightly different for every input method server. 1307Try a search engine, as this is slightly different for every input method server.
1317.PP 1308.PP
1318Here is a checklist: 1309Here is a checklist:
1319.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS.\s0" 4 1310.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4
1320.IX Item "- Make sure your locale and the imLocale are supported on your OS." 1311.IX Item "- Make sure your locale and the imLocale are supported on your OS."
1321Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS.\s0 1312Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0.
1322.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM.\s0" 4 1313.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4
1323.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." 1314.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM."
1324For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use 1315For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use
1325\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. 1316\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent.
1326.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 1317.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4
1327.IX Item "- Make sure your XIM server is actually running." 1318.IX Item "- Make sure your XIM server is actually running."
1336.Sp 1327.Sp
1337.Vb 1 1328.Vb 1
1338\& xprop \-root XIM_SERVERS 1329\& xprop \-root XIM_SERVERS
1339.Ve 1330.Ve
1340.PP 1331.PP
1341\fIMy input method wants <some encoding> but I want \s-1UTF\-8,\s0 what can I do?\fR 1332\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1342.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" 1333.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1343.PP 1334.PP
1344You can specify separate locales for the input method and the rest of the 1335You can specify separate locales for the input method and the rest of the
1345terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1336terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
1346.PP 1337.PP
1364crashes cannot be completely avoided even if both sides cooperate. 1355crashes cannot be completely avoided even if both sides cooperate.
1365.PP 1356.PP
1366So the only workaround is not to kill your Input Method Servers. 1357So the only workaround is not to kill your Input Method Servers.
1367.SS "Operating Systems / Package Maintaining" 1358.SS "Operating Systems / Package Maintaining"
1368.IX Subsection "Operating Systems / Package Maintaining" 1359.IX Subsection "Operating Systems / Package Maintaining"
1369\fII am maintaining rxvt-unicode for distribution/OS \s-1XXX,\s0 any recommendation?\fR 1360\fII am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?\fR
1370.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?" 1361.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?"
1371.PP 1362.PP
1372You should build one binary with the default options. \fIconfigure\fR 1363You should build one binary with the default options. \fIconfigure\fR
1373now enables most useful options, and the trend goes to making them 1364now enables most useful options, and the trend goes to making them
1374runtime-switchable, too, so there is usually no drawback to enabling them, 1365runtime-switchable, too, so there is usually no drawback to enabling them,
1385If you can/want build more binaries, I recommend building a minimal 1376If you can/want build more binaries, I recommend building a minimal
1386one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with 1377one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with
1387\&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of 1378\&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of
1388encodings built-in that increase download times and are rarely used). 1379encodings built-in that increase download times and are rarely used).
1389.PP 1380.PP
1390\fII need to make it setuid/setgid to support utmp/ptys on my \s-1OS,\s0 is this safe?\fR 1381\fII need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?\fR
1391.IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" 1382.IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?"
1392.PP 1383.PP
1393It should be, starting with release 7.1. You are encouraged to properly 1384It should be, starting with release 7.1. You are encouraged to properly
1394install urxvt with privileges necessary for your \s-1OS\s0 now. 1385install urxvt with privileges necessary for your \s-1OS\s0 now.
1395.PP 1386.PP
1419.PP 1410.PP
1420However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and 1411However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
1421\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR). 1412\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR).
1422.PP 1413.PP
1423\&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language 1414\&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language
1424apps in an \s-1OS,\s0 as using a locale-dependent (and non-standardized) 1415apps in an \s-1OS\s0, as using a locale-dependent (and non-standardized)
1425representation of \fBwchar_t\fR makes it impossible to convert between 1416representation of \fBwchar_t\fR makes it impossible to convert between
1426\&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding 1417\&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding
1427without implementing OS-specific-wrappers for each and every locale. There 1418without implementing OS-specific-wrappers for each and every locale. There
1428simply are no APIs to convert \fBwchar_t\fR into anything except the current 1419simply are no APIs to convert \fBwchar_t\fR into anything except the current
1429locale encoding. 1420locale encoding.
1612.IX Item "ESC o" 1603.IX Item "ESC o"
1613Invoke the G3 Character Set (\s-1LS3\s0) 1604Invoke the G3 Character Set (\s-1LS3\s0)
1614.ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4 1605.ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4
1615.el .IP "\fB\f(CBESC ( C\fB\fR" 4 1606.el .IP "\fB\f(CBESC ( C\fB\fR" 4
1616.IX Item "ESC ( C" 1607.IX Item "ESC ( C"
1617Designate G0 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. 1608Designate G0 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
1618.ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4 1609.ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4
1619.el .IP "\fB\f(CBESC ) C\fB\fR" 4 1610.el .IP "\fB\f(CBESC ) C\fB\fR" 4
1620.IX Item "ESC ) C" 1611.IX Item "ESC ) C"
1621Designate G1 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. 1612Designate G1 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
1622.ie n .IP "\fB\fB""ESC * C""\fB\fR" 4 1613.ie n .IP "\fB\fB""ESC * C""\fB\fR" 4
1623.el .IP "\fB\f(CBESC * C\fB\fR" 4 1614.el .IP "\fB\f(CBESC * C\fB\fR" 4
1624.IX Item "ESC * C" 1615.IX Item "ESC * C"
1625Designate G2 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. 1616Designate G2 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
1626.ie n .IP "\fB\fB""ESC + C""\fB\fR" 4 1617.ie n .IP "\fB\fB""ESC + C""\fB\fR" 4
1627.el .IP "\fB\f(CBESC + C\fB\fR" 4 1618.el .IP "\fB\f(CBESC + C\fB\fR" 4
1628.IX Item "ESC + C" 1619.IX Item "ESC + C"
1629Designate G3 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. 1620Designate G3 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
1630.ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4 1621.ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4
1631.el .IP "\fB\f(CBESC $ C\fB\fR" 4 1622.el .IP "\fB\f(CBESC $ C\fB\fR" 4
1632.IX Item "ESC $ C" 1623.IX Item "ESC $ C"
1633Designate Kanji Character Set 1624Designate Kanji Character Set
1634.Sp 1625.Sp
1644C = K German character set unimplemented 1635C = K German character set unimplemented
1645.TE 1636.TE
1646.PP 1637.PP
1647 1638
1648.IX Xref "CSI" 1639.IX Xref "CSI"
1649.SS "\s-1CSI \s0(Command Sequence Introducer) Sequences" 1640.SS "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1650.IX Subsection "CSI (Command Sequence Introducer) Sequences" 1641.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1651.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 1642.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1652.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 1643.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1653.IX Item "ESC [ Ps @" 1644.IX Item "ESC [ Ps @"
1654Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) 1645Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
2020.TS 2011.TS
2021l l . 2012l l .
2022h Send Mouse X & Y on button press. 2013h Send Mouse X & Y on button press.
2023l No mouse reporting. 2014l No mouse reporting.
2024.TE 2015.TE
2025.ie n .IP "\fB\fB""Pm = 12""\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4 2016.ie n .IP "\fB\fB""Pm = 12""\fB\fR (\s-1AT&T\s0 610, XTerm)" 4
2026.el .IP "\fB\f(CBPm = 12\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4 2017.el .IP "\fB\f(CBPm = 12\fB\fR (\s-1AT&T\s0 610, XTerm)" 4
2027.IX Item "Pm = 12 (AT&T 610, XTerm)" 2018.IX Item "Pm = 12 (AT&T 610, XTerm)"
2028.TS 2019.TS
2029l l . 2020l l .
2030h Blinking cursor (cvvis) 2021h Blinking cursor (cvvis)
2031l Steady cursor (cnorm) 2022l Steady cursor (cnorm)
2280.IX Subsection "XTerm Operating System Commands" 2271.IX Subsection "XTerm Operating System Commands"
2281.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 2272.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
2282.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 2273.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
2283.IX Item "ESC ] Ps;Pt ST" 2274.IX Item "ESC ] Ps;Pt ST"
2284Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, 2275Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
22850x5c), backwards compatible terminator \s-1BEL \s0(0x07) is also accepted. any 22760x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
2286\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN \s0(0x16, ^V). 2277\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN\s0 (0x16, ^V).
2287.TS 2278.TS
2288l l . 2279l l .
2289Ps = 0 Change Icon Name and Window Title to Pt 2280Ps = 0 Change Icon Name and Window Title to Pt
2290Ps = 1 Change Icon Name to Pt 2281Ps = 1 Change Icon Name to Pt
2291Ps = 2 Change Window Title to Pt 2282Ps = 2 Change Window Title to Pt
2318Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2309Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2319Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 2310Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2320.TE 2311.TE
2321.SH "BACKGROUND IMAGE" 2312.SH "BACKGROUND IMAGE"
2322.IX Header "BACKGROUND IMAGE" 2313.IX Header "BACKGROUND IMAGE"
2323For the \s-1BACKGROUND IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR the value 2314For the \s-1BACKGROUND\s0 \s-1IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR the value
2324of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be one of the following commands: 2315of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be one of the following commands:
2325.ie n .IP "\fB\fB""?""\fB\fR" 4 2316.ie n .IP "\fB\fB""?""\fB\fR" 4
2326.el .IP "\fB\f(CB?\fB\fR" 4 2317.el .IP "\fB\f(CB?\fB\fR" 4
2327.IX Item "?" 2318.IX Item "?"
2328display scale and position in the title 2319display scale and position in the title
2493jp_ext rarely used but big japanese encodings 2484jp_ext rarely used but big japanese encodings
2494kr korean encodings 2485kr korean encodings
2495.TE 2486.TE
2496.IP "\-\-enable\-xim (default: on)" 4 2487.IP "\-\-enable\-xim (default: on)" 4
2497.IX Item "--enable-xim (default: on)" 2488.IX Item "--enable-xim (default: on)"
2498Add support for \s-1XIM \s0(X Input Method) protocol. This allows using 2489Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
2499alternative input methods (e.g. kinput2) and will also correctly 2490alternative input methods (e.g. kinput2) and will also correctly
2500set up the input for people using dead keys or compose keys. 2491set up the input for people using dead keys or compose keys.
2501.IP "\-\-enable\-unicode3 (default: off)" 4 2492.IP "\-\-enable\-unicode3 (default: off)" 4
2502.IX Item "--enable-unicode3 (default: off)" 2493.IX Item "--enable-unicode3 (default: off)"
2503Recommended to stay off unless you really need non-BMP characters. 2494Recommended to stay off unless you really need non-BMP characters.
2530The combining table also contains entries for arabic presentation forms, 2521The combining table also contains entries for arabic presentation forms,
2531but these are not currently used. Bug me if you want these to be used (and 2522but these are not currently used. Bug me if you want these to be used (and
2532tell me how these are to be used...). 2523tell me how these are to be used...).
2533.IP "\-\-enable\-fallback[=CLASS] (default: Rxvt)" 4 2524.IP "\-\-enable\-fallback[=CLASS] (default: Rxvt)" 4
2534.IX Item "--enable-fallback[=CLASS] (default: Rxvt)" 2525.IX Item "--enable-fallback[=CLASS] (default: Rxvt)"
2535When reading resource settings, also read settings for class \s-1CLASS.\s0 To 2526When reading resource settings, also read settings for class \s-1CLASS\s0. To
2536disable resource fallback use \-\-disable\-fallback. 2527disable resource fallback use \-\-disable\-fallback.
2537.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 2528.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4
2538.IX Item "--with-res-name=NAME (default: urxvt)" 2529.IX Item "--with-res-name=NAME (default: urxvt)"
2539Use the given name as default application name when 2530Use the given name as default application name when
2540reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. 2531reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt.
2558\&\fIlastlogin\fR) at start of rxvt execution. This option requires 2549\&\fIlastlogin\fR) at start of rxvt execution. This option requires
2559\&\-\-enable\-utmp to also be specified. 2550\&\-\-enable\-utmp to also be specified.
2560.IP "\-\-enable\-pixbuf (default: on)" 4 2551.IP "\-\-enable\-pixbuf (default: on)" 4
2561.IX Item "--enable-pixbuf (default: on)" 2552.IX Item "--enable-pixbuf (default: on)"
2562Add support for GDK-PixBuf to be used for background images. 2553Add support for GDK-PixBuf to be used for background images.
2563It adds support for many file formats including \s-1JPG, PNG, 2554It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0,
2564TIFF, GIF, XPM, BMP, ICO\s0 and \s-1TGA.\s0 2555\&\s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0 and \s-1TGA\s0.
2565.IP "\-\-enable\-startup\-notification (default: on)" 4 2556.IP "\-\-enable\-startup\-notification (default: on)" 4
2566.IX Item "--enable-startup-notification (default: on)" 2557.IX Item "--enable-startup-notification (default: on)"
2567Add support for freedesktop startup notifications. This allows window managers 2558Add support for freedesktop startup notifications. This allows window managers
2568to display some kind of progress indicator during startup. 2559to display some kind of progress indicator during startup.
2569.IP "\-\-enable\-transparency (default: on)" 4 2560.IP "\-\-enable\-transparency (default: on)" 4
2643\& trailing space removal for selections 2634\& trailing space removal for selections
2644\& verbose X error handling 2635\& verbose X error handling
2645.Ve 2636.Ve
2646.IP "\-\-enable\-iso14755 (default: on)" 4 2637.IP "\-\-enable\-iso14755 (default: on)" 4
2647.IX Item "--enable-iso14755 (default: on)" 2638.IX Item "--enable-iso14755 (default: on)"
2648Enable extended \s-1ISO 14755\s0 support (see @@RXVT_NAME@@(1)). 2639Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1)).
2649Basic support (section 5.1) is enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR, while 2640Basic support (section 5.1) is enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR, while
2650support for 5.2, 5.3 and 5.4 is enabled with this switch. 2641support for 5.2, 5.3 and 5.4 is enabled with this switch.
2651.IP "\-\-enable\-keepscrolling (default: on)" 4 2642.IP "\-\-enable\-keepscrolling (default: on)" 4
2652.IX Item "--enable-keepscrolling (default: on)" 2643.IX Item "--enable-keepscrolling (default: on)"
2653Add support for continual scrolling of the display when you hold 2644Add support for continual scrolling of the display when you hold
2706Set the basename for the installed binaries, resulting 2697Set the basename for the installed binaries, resulting
2707in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with 2698in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with
2708\&\f(CW\*(C`rxvt\*(C'\fR. 2699\&\f(CW\*(C`rxvt\*(C'\fR.
2709.IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4 2700.IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4
2710.IX Item "--with-term=NAME (default: rxvt-unicode)" 2701.IX Item "--with-term=NAME (default: rxvt-unicode)"
2711Change the environmental variable for the terminal to \s-1NAME.\s0 2702Change the environmental variable for the terminal to \s-1NAME\s0.
2712.IP "\-\-with\-terminfo=PATH" 4 2703.IP "\-\-with\-terminfo=PATH" 4
2713.IX Item "--with-terminfo=PATH" 2704.IX Item "--with-terminfo=PATH"
2714Change the environmental variable for the path to the terminfo tree to 2705Change the environmental variable for the path to the terminfo tree to
2715\&\s-1PATH.\s0 2706\&\s-1PATH\s0.
2716.IP "\-\-with\-x" 4 2707.IP "\-\-with\-x" 4
2717.IX Item "--with-x" 2708.IX Item "--with-x"
2718Use the X Window System (pretty much default, eh?). 2709Use the X Window System (pretty much default, eh?).
2719.SH "AUTHORS" 2710.SH "AUTHORS"
2720.IX Header "AUTHORS" 2711.IX Header "AUTHORS"

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines