… | |
… | |
48 | <p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p> |
48 | <p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p> |
49 | <p> |
49 | <p> |
50 | </p> |
50 | </p> |
51 | <hr /> |
51 | <hr /> |
52 | <h1><a name="synopsis">SYNOPSIS</a></h1> |
52 | <h1><a name="synopsis">SYNOPSIS</a></h1> |
53 | <p><strong>urxvt</strong> [options] [-e command [ args ]]</p> |
53 | <p><strong>rxvt</strong> [options] [-e command [ args ]]</p> |
54 | <p> |
54 | <p> |
55 | </p> |
55 | </p> |
56 | <hr /> |
56 | <hr /> |
57 | <h1><a name="description">DESCRIPTION</a></h1> |
57 | <h1><a name="description">DESCRIPTION</a></h1> |
58 | <p><strong>rxvt-unicode</strong>, version <strong>7.8</strong>, is a colour vt102 terminal |
58 | <p><strong>rxvt-unicode</strong>, version <strong>7.9</strong>, is a colour vt102 terminal |
59 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
59 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
60 | require features such as Tektronix 4014 emulation and toolkit-style |
60 | require features such as Tektronix 4014 emulation and toolkit-style |
61 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
61 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
62 | a significant advantage on a machine serving many X sessions.</p> |
62 | a significant advantage on a machine serving many X sessions.</p> |
63 | <p> |
63 | <p> |
64 | </p> |
64 | </p> |
65 | <hr /> |
65 | <hr /> |
66 | <h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> |
66 | <h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> |
67 | <p>See <code>urxvt(7)</code> (try <code>man 7 urxvt</code>) for a list of |
67 | <p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of |
68 | frequently asked questions and answer to them and some common |
68 | frequently asked questions and answer to them and some common |
69 | problems. That document is also accessible on the World-Wide-Web at |
69 | problems. That document is also accessible on the World-Wide-Web at |
70 | <a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> |
70 | <a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> |
71 | <p> |
71 | <p> |
72 | </p> |
72 | </p> |
… | |
… | |
77 | world. Being a terminal emulator, however, some things are very difficult, |
77 | world. Being a terminal emulator, however, some things are very difficult, |
78 | especially cursive scripts such as arabic, vertically written scripts |
78 | especially cursive scripts such as arabic, vertically written scripts |
79 | like mongolian or scripts requiring extremely complex combining rules, |
79 | like mongolian or scripts requiring extremely complex combining rules, |
80 | like tibetan or devenagari. Don't expect pretty output when using these |
80 | like tibetan or devenagari. Don't expect pretty output when using these |
81 | scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work |
81 | scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work |
82 | fine, though. A somewhat difficult case are left-to-right scripts, such |
82 | fine, though. A somewhat difficult case are right-to-left scripts, such |
83 | as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms |
83 | as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms |
84 | belong into the application, not the terminal emulator (too many things -- |
84 | belong into the application, not the terminal emulator (too many things -- |
85 | such as cursor-movement while editing -- break otherwise), but that might |
85 | such as cursor-movement while editing -- break otherwise), but that might |
86 | change.</p> |
86 | change.</p> |
87 | <p>If you are looking for a terminal that supports more exotic scripts, let |
87 | <p>If you are looking for a terminal that supports more exotic scripts, let |
88 | me recommend <code>mlterm</code>, which is a very userfriendly, lean and clean |
88 | me recommend <code>mlterm</code>, which is a very user friendly, lean and clean |
89 | terminal emulator. In fact, the reason rxvt-unicode was born was solely |
89 | terminal emulator. In fact, the reason rxvt-unicode was born was solely |
90 | because the author couldn't get <code>mlterm</code> to use one font for latin1 and |
90 | because the author couldn't get <code>mlterm</code> to use one font for latin1 and |
91 | another for japanese.</p> |
91 | another for japanese.</p> |
92 | <p>Therefore another design rationale was the use of multiple fonts to |
92 | <p>Therefore another design rationale was the use of multiple fonts to |
93 | display characters: The idea of a single unicode font which many other |
93 | display characters: The idea of a single unicode font which many other |
94 | programs force onto its users never made sense to me: You should be able |
94 | programs force onto its users never made sense to me: You should be able |
95 | to choose any font for any script freely.</p> |
95 | to choose any font for any script freely.</p> |
96 | <p>Apart from that, rxvt-unicode is also much better internationalised than |
96 | <p>Apart from that, rxvt-unicode is also much better internationalised than |
97 | its predecessor, supports things such as XFT and ISO 14755 that are handy |
97 | its predecessor, supports things such as XFT and ISO 14755 that are handy |
98 | in i18n-environments, is faster, and has a lot less bugs than the original |
98 | in i18n-environments, is faster, and has a lot bugs less than the original |
99 | rxvt. This all in addition to dozens of other small improvements.</p> |
99 | rxvt. This all in addition to dozens of other small improvements.</p> |
100 | <p>It is still faithfully following the original rxvt idea of being lean |
100 | <p>It is still faithfully following the original rxvt idea of being lean |
101 | and nice on resources: for example, you can still configure rxvt-unicode |
101 | and nice on resources: for example, you can still configure rxvt-unicode |
102 | without most of its features to get a lean binary. It also comes with |
102 | without most of its features to get a lean binary. It also comes with |
103 | a client/daemon pair that lets you open any number of terminal windows |
103 | a client/daemon pair that lets you open any number of terminal windows |
104 | from within a single process, which makes startup time very fast and |
104 | from within a single process, which makes startup time very fast and |
105 | drastically reduces memory usage. See <code>urxvtd(1)</code> (daemon) and |
105 | drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and |
106 | <code>urxvtc(1)</code> (client).</p> |
106 | <code>rxvtc(1)</code> (client).</p> |
107 | <p>It also makes technical information about escape sequences (which have |
107 | <p>It also makes technical information about escape sequences (which have |
108 | been extended) easier accessible: see <code>urxvt(7)</code> for technical |
108 | been extended) more accessible: see <code>rxvt(7)</code> for technical |
109 | reference documentation (escape sequences etc.).</p> |
109 | reference documentation (escape sequences etc.).</p> |
110 | <p> |
110 | <p> |
111 | </p> |
111 | </p> |
112 | <hr /> |
112 | <hr /> |
113 | <h1><a name="options">OPTIONS</a></h1> |
113 | <h1><a name="options">OPTIONS</a></h1> |
114 | <p>The <strong>urxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed |
114 | <p>The <strong>rxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed |
115 | below. In keeping with the smaller-is-better philosophy, options may be |
115 | below. In keeping with the smaller-is-better philosophy, options may be |
116 | eliminated or default values chosen at compile-time, so options and |
116 | eliminated or default values chosen at compile-time, so options and |
117 | defaults listed may not accurately reflect the version installed on |
117 | defaults listed may not accurately reflect the version installed on |
118 | your system. `urxvt -h' gives a list of major compile-time options on |
118 | your system. `rxvt -h' gives a list of major compile-time options on |
119 | the <em>Options</em> line. Option descriptions may be prefixed with which |
119 | the <em>Options</em> line. Option descriptions may be prefixed with which |
120 | compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires |
120 | compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires |
121 | <em>XIM</em> on the <em>Options</em> line. Note: `urxvt -help' gives a list of all |
121 | <em>XIM</em> on the <em>Options</em> line. Note: `rxvt -help' gives a list of all |
122 | command-line options compiled into your version.</p> |
122 | command-line options compiled into your version.</p> |
123 | <p>Note that <strong>urxvt</strong> permits the resource name to be used as a |
123 | <p>Note that <strong>rxvt</strong> permits the resource name to be used as a |
124 | long-option (--/++ option) so the potential command-line options are |
124 | long-option (--/++ option) so the potential command-line options are |
125 | far greater than those listed. For example: `urxvt --loginShell --color1 |
125 | far greater than those listed. For example: `rxvt --loginShell --color1 |
126 | Orange'.</p> |
126 | Orange'.</p> |
127 | <p>The following options are available:</p> |
127 | <p>The following options are available:</p> |
128 | <dl> |
128 | <dl> |
129 | <dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong> |
129 | <dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong> |
130 | |
130 | |
… | |
… | |
171 | <p>Turn on/off inheriting parent window's pixmap. Alternative form is |
171 | <p>Turn on/off inheriting parent window's pixmap. Alternative form is |
172 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p> |
172 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p> |
173 | </dd> |
173 | </dd> |
174 | <dd> |
174 | <dd> |
175 | <p><em>Please note that transparency of any kind if completely unsupported by |
175 | <p><em>Please note that transparency of any kind if completely unsupported by |
176 | the author. Don't bug him with installation questions!</em></p> |
176 | the author. Don't bug him with installation questions! Read the FAQ (man 7 |
|
|
177 | rxvt)!</em></p> |
177 | </dd> |
178 | </dd> |
178 | </li> |
179 | </li> |
179 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong> |
180 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong> |
180 | |
181 | |
181 | <dd> |
182 | <dd> |
… | |
… | |
200 | used to brighten or darken the image in addition to tinting it; resource |
201 | used to brighten or darken the image in addition to tinting it; resource |
201 | <em>tintColor</em>. Example:</p> |
202 | <em>tintColor</em>. Example:</p> |
202 | </dd> |
203 | </dd> |
203 | <dd> |
204 | <dd> |
204 | <pre> |
205 | <pre> |
205 | urxvt -tr -tint blue -sh 40</pre> |
206 | rxvt -tr -tint blue -sh 40</pre> |
206 | </dd> |
207 | </dd> |
207 | </li> |
208 | </li> |
208 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> |
209 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> |
209 | |
210 | |
210 | <dd> |
211 | <dd> |
… | |
… | |
273 | with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>, |
274 | with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>, |
274 | e.g.:</p> |
275 | e.g.:</p> |
275 | </dd> |
276 | </dd> |
276 | <dd> |
277 | <dd> |
277 | <pre> |
278 | <pre> |
278 | urxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
279 | rxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
279 | urxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"</pre> |
280 | rxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"</pre> |
280 | </dd> |
281 | </dd> |
281 | <dd> |
282 | <dd> |
282 | <p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ |
283 | <p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ |
283 | section of urxvt(7).</p> |
284 | section of rxvt(7).</p> |
284 | </dd> |
285 | </dd> |
285 | </li> |
286 | </li> |
286 | <dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong> |
287 | <dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong> |
287 | |
288 | |
288 | <dd> |
289 | <dd> |
… | |
… | |
469 | </dd> |
470 | </dd> |
470 | </li> |
471 | </li> |
471 | <dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong> |
472 | <dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong> |
472 | |
473 | |
473 | <dd> |
474 | <dd> |
474 | <p>Run the command with its command-line arguments in the <strong>urxvt</strong> |
475 | <p>Run the command with its command-line arguments in the <strong>rxvt</strong> |
475 | window; also sets the window title and icon name to be the basename of |
476 | window; also sets the window title and icon name to be the basename of |
476 | the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are |
477 | the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are |
477 | given on the command line. If this option is used, it must be the last |
478 | given on the command line. If this option is used, it must be the last |
478 | on the command-line. If there is no <strong>-e</strong> option then the default is to |
479 | on the command-line. If there is no <strong>-e</strong> option then the default is to |
479 | run the program specified by the <strong>SHELL</strong> environment variable or, |
480 | run the program specified by the <strong>SHELL</strong> environment variable or, |
… | |
… | |
483 | <p>Please note that you must specify a program with arguments. If you want to |
484 | <p>Please note that you must specify a program with arguments. If you want to |
484 | run shell commands, you have to specify the shell, like this:</p> |
485 | run shell commands, you have to specify the shell, like this:</p> |
485 | </dd> |
486 | </dd> |
486 | <dd> |
487 | <dd> |
487 | <pre> |
488 | <pre> |
488 | urxvt -e sh -c "shell commands"</pre> |
489 | rxvt -e sh -c "shell commands"</pre> |
489 | </dd> |
490 | </dd> |
490 | </li> |
491 | </li> |
491 | <dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong> |
492 | <dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong> |
492 | |
493 | |
493 | <dd> |
494 | <dd> |
… | |
… | |
578 | </dd> |
579 | </dd> |
579 | </li> |
580 | </li> |
580 | <dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong> |
581 | <dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong> |
581 | |
582 | |
582 | <dd> |
583 | <dd> |
583 | <p>Turn on/off hold window after exit support. If enabled, urxvt |
584 | <p>Turn on/off hold window after exit support. If enabled, rxvt |
584 | will not immediately destroy its window when the program executed within |
585 | will not immediately destroy its window when the program executed within |
585 | it exits. Instead, it will wait till it is being killed or closed by the |
586 | it exits. Instead, it will wait till it is being killed or closed by the |
586 | user; resource <strong>hold</strong>.</p> |
587 | user; resource <strong>hold</strong>.</p> |
587 | </dd> |
588 | </dd> |
588 | </li> |
589 | </li> |
… | |
… | |
593 | </dd> |
594 | </dd> |
594 | </li> |
595 | </li> |
595 | <dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong> |
596 | <dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong> |
596 | |
597 | |
597 | <dd> |
598 | <dd> |
598 | <p>Tells urxvt to embed its windows into an already-existing window, |
599 | <p>Tells rxvt to embed its windows into an already-existing window, |
599 | which enables applications to easily embed a terminal.</p> |
600 | which enables applications to easily embed a terminal.</p> |
600 | </dd> |
601 | </dd> |
601 | <dd> |
602 | <dd> |
602 | <p>Right now, urxvt will first unmap/map the specified window, so it |
603 | <p>Right now, rxvt will first unmap/map the specified window, so it |
603 | shouldn't be a top-level window. urxvt will also reconfigure it |
604 | shouldn't be a top-level window. rxvt will also reconfigure it |
604 | quite a bit, so don't expect it to keep some specific state. It's best to |
605 | quite a bit, so don't expect it to keep some specific state. It's best to |
605 | create an extra subwindow for urxvt and leave it alone.</p> |
606 | create an extra subwindow for rxvt and leave it alone.</p> |
606 | </dd> |
|
|
607 | <dd> |
607 | </dd> |
|
|
608 | <dd> |
608 | <p>The window will not be destroyed when urxvt exits.</p> |
609 | <p>The window will not be destroyed when rxvt exits.</p> |
609 | </dd> |
|
|
610 | <dd> |
610 | </dd> |
|
|
611 | <dd> |
611 | <p>It might be useful to know that urxvt will not close file |
612 | <p>It might be useful to know that rxvt will not close file |
612 | descriptors passed to it (except for stdin/out/err, of course), so you |
613 | descriptors passed to it (except for stdin/out/err, of course), so you |
613 | can use file descriptors to communicate with the programs within the |
614 | can use file descriptors to communicate with the programs within the |
614 | terminal. This works regardless of wether the <code>-embed</code> option was used or |
615 | terminal. This works regardless of whether the <code>-embed</code> option was used or |
615 | not.</p> |
616 | not.</p> |
616 | </dd> |
617 | </dd> |
617 | <dd> |
618 | <dd> |
618 | <p>Here is a short Gtk2-perl snippet that illustrates how this option can be |
619 | <p>Here is a short Gtk2-perl snippet that illustrates how this option can be |
619 | used (a longer example is in <em>doc/embed</em>):</p> |
620 | used (a longer example is in <em>doc/embed</em>):</p> |
… | |
… | |
621 | <dd> |
622 | <dd> |
622 | <pre> |
623 | <pre> |
623 | my $rxvt = new Gtk2::Socket; |
624 | my $rxvt = new Gtk2::Socket; |
624 | $rxvt->signal_connect_after (realize => sub { |
625 | $rxvt->signal_connect_after (realize => sub { |
625 | my $xid = $_[0]->window->get_xid; |
626 | my $xid = $_[0]->window->get_xid; |
626 | system "urxvt -embed $xid &"; |
627 | system "rxvt -embed $xid &"; |
627 | });</pre> |
628 | });</pre> |
628 | </dd> |
629 | </dd> |
629 | </li> |
630 | </li> |
630 | <dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong> |
631 | <dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong> |
631 | |
632 | |
632 | <dd> |
633 | <dd> |
633 | <p>Tells urxvt NOT to execute any commands or create a new pty/tty |
634 | <p>Tells rxvt NOT to execute any commands or create a new pty/tty |
634 | pair but instead use the given filehandle as the tty master. This is |
635 | pair but instead use the given file descriptor as the tty master. This is |
635 | useful if you want to drive urxvt as a generic terminal emulator |
636 | useful if you want to drive rxvt as a generic terminal emulator |
636 | without having to run a program within it.</p> |
637 | without having to run a program within it.</p> |
637 | </dd> |
638 | </dd> |
638 | <dd> |
639 | <dd> |
639 | <p>If this switch is given, urxvt will not create any utmp/wtmp |
640 | <p>If this switch is given, rxvt will not create any utmp/wtmp |
640 | entries and will not tinker with pty/tty permissions - you have to do that |
641 | entries and will not tinker with pty/tty permissions - you have to do that |
641 | yourself if you want that.</p> |
642 | yourself if you want that.</p> |
642 | </dd> |
643 | </dd> |
643 | <dd> |
644 | <dd> |
644 | <p>As an extremely special case, specifying <code>-1</code> will completely suppress |
645 | <p>As an extremely special case, specifying <code>-1</code> will completely suppress |
… | |
… | |
655 | </dd> |
656 | </dd> |
656 | <dd> |
657 | <dd> |
657 | <pre> |
658 | <pre> |
658 | my $pty = new IO::Pty; |
659 | my $pty = new IO::Pty; |
659 | fcntl $pty, F_SETFD, 0; # clear close-on-exec |
660 | fcntl $pty, F_SETFD, 0; # clear close-on-exec |
660 | system "urxvt -pty-fd " . (fileno $pty) . "&"; |
661 | system "rxvt -pty-fd " . (fileno $pty) . "&"; |
661 | close $pty;</pre> |
662 | close $pty;</pre> |
662 | </dd> |
663 | </dd> |
663 | <dd> |
664 | <dd> |
664 | <pre> |
665 | <pre> |
665 | # now communicate with rxvt |
666 | # now communicate with rxvt |
… | |
… | |
677 | </dl> |
678 | </dl> |
678 | <p> |
679 | <p> |
679 | </p> |
680 | </p> |
680 | <hr /> |
681 | <hr /> |
681 | <h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> |
682 | <h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> |
682 | <p>Note: `urxvt --help' gives a list of all resources (long |
683 | <p>Note: `rxvt --help' gives a list of all resources (long |
683 | options) compiled into your version.</p> |
684 | options) compiled into your version.</p> |
684 | <p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many |
685 | <p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many |
685 | distribution do also load settings from the <strong>~/.Xresources</strong> file when X |
686 | distribution do also load settings from the <strong>~/.Xresources</strong> file when X |
686 | starts. urxvt will consult the following files/resources in order, |
687 | starts. rxvt will consult the following files/resources in order, |
687 | with later settings overwriting earlier ones:</p> |
688 | with later settings overwriting earlier ones:</p> |
688 | <pre> |
689 | <pre> |
689 | 1. system-wide app-defaults file, either locale-dependent OR global |
690 | 1. system-wide app-defaults file, either locale-dependent OR global |
690 | 2. app-defaults file in $XAPPLRESDIR |
691 | 2. app-defaults file in $XAPPLRESDIR |
691 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
692 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
692 | 4. SCREEN_RESOURCES for the current screen |
693 | 4. SCREEN_RESOURCES for the current screen |
693 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename></pre> |
694 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename></pre> |
694 | <p>Note that when reading X resources, <strong>urxvt</strong> recognizes two class |
695 | <p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class |
695 | names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources |
696 | names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources |
696 | common to both <strong>urxvt</strong> and the original <em>rxvt</em> to be easily |
697 | common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily |
697 | configured, while the class name <strong>URxvt</strong> allows resources unique to |
698 | configured, while the class name <strong>URxvt</strong> allows resources unique to |
698 | <strong>urxvt</strong>, to be shared between different <strong>urxvt</strong> |
699 | <strong>rxvt</strong>, to be shared between different <strong>rxvt</strong> |
699 | configurations. If no resources are specified, suitable defaults will |
700 | configurations. If no resources are specified, suitable defaults will |
700 | be used. Command-line arguments can be used to override resource |
701 | be used. Command-line arguments can be used to override resource |
701 | settings. The following resources are supported (you might want to |
702 | settings. The following resources are supported (you might want to |
702 | check the <code>urxvtperl(3)</code> manpage for additional settings by perl |
703 | check the <code>rxvtperl(3)</code> manpage for additional settings by perl |
703 | extensions not documented here):</p> |
704 | extensions not documented here):</p> |
704 | <dl> |
705 | <dl> |
705 | <dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong> |
706 | <dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong> |
706 | |
707 | |
707 | <dd> |
708 | <dd> |
… | |
… | |
740 | 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour |
741 | 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour |
741 | names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p> |
742 | names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p> |
742 | </dd> |
743 | </dd> |
743 | <dd> |
744 | <dd> |
744 | <p>Colours higher than 15 cannot be set using resources (yet), but can be |
745 | <p>Colours higher than 15 cannot be set using resources (yet), but can be |
745 | changed using an escape command (see urxvt(7)).</p> |
746 | changed using an escape command (see rxvt(7)).</p> |
746 | </dd> |
747 | </dd> |
747 | <dd> |
748 | <dd> |
748 | <p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with |
749 | <p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with |
749 | 88 colour support). Colours 80-87 are evenly spaces grey steps.</p> |
750 | 88 colour support). Colours 80-87 are evenly spaces grey steps.</p> |
750 | </dd> |
751 | </dd> |
… | |
… | |
971 | <dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong> |
972 | <dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong> |
972 | |
973 | |
973 | <dd> |
974 | <dd> |
974 | <p>When font styles are not enabled, or this option is enabled (<strong>True</strong>, |
975 | <p>When font styles are not enabled, or this option is enabled (<strong>True</strong>, |
975 | option <strong>-is</strong>, the default), bold and italic font styles imply high |
976 | option <strong>-is</strong>, the default), bold and italic font styles imply high |
976 | intensity foreground/backround colours. Disabling this option (<strong>False</strong>, |
977 | intensity foreground/background colours. Disabling this option (<strong>False</strong>, |
977 | option <strong>+is</strong>) disables this behaviour, the high intensity colours are not |
978 | option <strong>+is</strong>) disables this behaviour, the high intensity colours are not |
978 | reachable.</p> |
979 | reachable.</p> |
979 | </dd> |
980 | </dd> |
980 | </li> |
981 | </li> |
981 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> |
982 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> |
… | |
… | |
1056 | <pre> |
1057 | <pre> |
1057 | URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
1058 | URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
1058 | </dd> |
1059 | </dd> |
1059 | <dd> |
1060 | <dd> |
1060 | <p>This creates a new file in your home directory with the screen contents |
1061 | <p>This creates a new file in your home directory with the screen contents |
1061 | everytime you hit <code>Print</code>.</p> |
1062 | every time you hit <code>Print</code>.</p> |
1062 | </dd> |
1063 | </dd> |
1063 | </li> |
1064 | </li> |
1064 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong> |
1065 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong> |
1065 | |
1066 | |
1066 | <dd> |
1067 | <dd> |
… | |
… | |
1100 | <dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong> |
1101 | <dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong> |
1101 | |
1102 | |
1102 | <dd> |
1103 | <dd> |
1103 | <p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and |
1104 | <p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and |
1104 | <strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll |
1105 | <strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll |
1105 | with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.</p> |
1106 | with scrollback buffer when tty receives new lines; option <strong>+sw</strong>.</p> |
1106 | </dd> |
1107 | </dd> |
1107 | </li> |
1108 | </li> |
1108 | <dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong> |
1109 | <dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong> |
1109 | |
1110 | |
1110 | <dd> |
1111 | <dd> |
… | |
… | |
1243 | <p>The characters used as delimiters for double-click word selection |
1244 | <p>The characters used as delimiters for double-click word selection |
1244 | (whitespace delimiting is added automatically if resource is given).</p> |
1245 | (whitespace delimiting is added automatically if resource is given).</p> |
1245 | </dd> |
1246 | </dd> |
1246 | <dd> |
1247 | <dd> |
1247 | <p>When the selection extension is in use (the default if compiled in, see |
1248 | <p>When the selection extension is in use (the default if compiled in, see |
1248 | the <code>urxvtperl(3)</code> manpage), a suitable regex using these characters |
1249 | the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters |
1249 | will be created (if the resource exists, otherwise, no regex will be |
1250 | will be created (if the resource exists, otherwise, no regex will be |
1250 | created). In this mode, characters outside ISO-8859-1 can be used.</p> |
1251 | created). In this mode, characters outside ISO-8859-1 can be used.</p> |
1251 | </dd> |
1252 | </dd> |
1252 | <dd> |
1253 | <dd> |
1253 | <p>When the selection extension is not used, only ISO-8859-1 characters can |
1254 | <p>When the selection extension is not used, only ISO-8859-1 characters can |
… | |
… | |
1282 | |
1283 | |
1283 | <dd> |
1284 | <dd> |
1284 | <p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or |
1285 | <p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or |
1285 | <code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated |
1286 | <code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated |
1286 | by commas), i.e. it's not in the same format as the other font lists used |
1287 | by commas), i.e. it's not in the same format as the other font lists used |
1287 | in urxvt. The default will be set-up to chose *any* suitable found |
1288 | in rxvt. The default will be set-up to chose *any* suitable found |
1288 | found, preferably one or two pixels differing in size to the base font. |
1289 | found, preferably one or two pixels differing in size to the base font. |
1289 | option <strong>-imfont</strong>.</p> |
1290 | option <strong>-imfont</strong>.</p> |
1290 | </dd> |
1291 | </dd> |
1291 | </li> |
1292 | </li> |
1292 | <dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong> |
1293 | <dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong> |
… | |
… | |
1346 | </dd> |
1347 | </dd> |
1347 | </li> |
1348 | </li> |
1348 | <dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong> |
1349 | <dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong> |
1349 | |
1350 | |
1350 | <dd> |
1351 | <dd> |
1351 | <p>Turn on/off hold window after exit support. If enabled, urxvt |
1352 | <p>Turn on/off hold window after exit support. If enabled, rxvt |
1352 | will not immediately destroy its window when the program executed within |
1353 | will not immediately destroy its window when the program executed within |
1353 | it exits. Instead, it will wait till it is being killed or closed by the |
1354 | it exits. Instead, it will wait till it is being killed or closed by the |
1354 | user.</p> |
1355 | user.</p> |
1355 | </dd> |
1356 | </dd> |
1356 | </li> |
1357 | </li> |
… | |
… | |
1388 | can start or end with whitespace.</p> |
1389 | can start or end with whitespace.</p> |
1389 | </dd> |
1390 | </dd> |
1390 | <dd> |
1391 | <dd> |
1391 | <p>Please note that you need to double the <code>\</code> in resource files, as |
1392 | <p>Please note that you need to double the <code>\</code> in resource files, as |
1392 | Xlib itself does its own de-escaping (you can use <code>\033</code> instead of |
1393 | Xlib itself does its own de-escaping (you can use <code>\033</code> instead of |
1393 | <code>\e</code> (and so on), which will work with both Xt and urxvt's own |
1394 | <code>\e</code> (and so on), which will work with both Xt and rxvt's own |
1394 | processing).</p> |
1395 | processing).</p> |
1395 | </dd> |
1396 | </dd> |
1396 | <dd> |
1397 | <dd> |
1397 | <p>You can define a range of keysyms in one shot by providing a <em>string</em> |
1398 | <p>You can define a range of keysyms in one shot by providing a <em>string</em> |
1398 | with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' |
1399 | with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimiter `/' |
1399 | should be a character not used by the strings.</p> |
1400 | should be a character not used by the strings.</p> |
1400 | </dd> |
1401 | </dd> |
1401 | <dd> |
1402 | <dd> |
1402 | <p>Its usage can be demonstrated by an example:</p> |
1403 | <p>Its usage can be demonstrated by an example:</p> |
1403 | </dd> |
1404 | </dd> |
… | |
… | |
1414 | URxvt.keysym.Meta-Control-0x62: \033<M-C-b> |
1415 | URxvt.keysym.Meta-Control-0x62: \033<M-C-b> |
1415 | URxvt.keysym.Meta-Control-0x63: \033<M-C-c></pre> |
1416 | URxvt.keysym.Meta-Control-0x63: \033<M-C-c></pre> |
1416 | </dd> |
1417 | </dd> |
1417 | <dd> |
1418 | <dd> |
1418 | <p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong> |
1419 | <p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong> |
1419 | is interpreted and executed as urxvt's control sequence. For |
1420 | is interpreted and executed as rxvt's control sequence. For |
1420 | example the following means ``change the current locale to <code>zh_CN.GBK</code> |
1421 | example the following means ``change the current locale to <code>zh_CN.GBK</code> |
1421 | when Control-Meta-c is being pressed'':</p> |
1422 | when Control-Meta-c is being pressed'':</p> |
1422 | </dd> |
1423 | </dd> |
1423 | <dd> |
1424 | <dd> |
1424 | <pre> |
1425 | <pre> |
1425 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1426 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1426 | </dd> |
1427 | </dd> |
1427 | <dd> |
1428 | <dd> |
1428 | <p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> |
1429 | <p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> |
1429 | is passed to the <code>on_keyboard_command</code> perl handler. See the <code>urxvtperl(3)</code> |
1430 | is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code> |
1430 | manpage. For example, the <em>selection</em> extension (activated via |
1431 | manpage. For example, the <em>selection</em> extension (activated via |
1431 | <code>urxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> |
1432 | <code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> |
1432 | </dd> |
1433 | </dd> |
1433 | <dd> |
1434 | <dd> |
1434 | <pre> |
1435 | <pre> |
1435 | URxvt.keysym.M-C-c: perl:selection:rot13</pre> |
1436 | URxvt.keysym.M-C-c: perl:selection:rot13</pre> |
1436 | </dd> |
1437 | </dd> |
… | |
… | |
1442 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
1443 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
1443 | mappings themselves.</p> |
1444 | mappings themselves.</p> |
1444 | </dd> |
1445 | </dd> |
1445 | <dd> |
1446 | <dd> |
1446 | <p>Unfortunately, this will override built-in key mappings. For example |
1447 | <p>Unfortunately, this will override built-in key mappings. For example |
1447 | if you overwrite the <code>Insert</code> key you will disable urxvt's |
1448 | if you overwrite the <code>Insert</code> key you will disable rxvt's |
1448 | <code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the |
1449 | <code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the |
1449 | user-defined keymap using the <code>builtin:</code> replacement:</p> |
1450 | user-defined keymap using the <code>builtin:</code> replacement:</p> |
1450 | </dd> |
1451 | </dd> |
1451 | <dd> |
1452 | <dd> |
1452 | <pre> |
1453 | <pre> |
… | |
… | |
1467 | <pre> |
1468 | <pre> |
1468 | URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 |
1469 | URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 |
1469 | URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre> |
1470 | URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre> |
1470 | </dd> |
1471 | </dd> |
1471 | <dd> |
1472 | <dd> |
1472 | <p>Other things are possible, e.g. resizing (see <code>urxvt(7)</code> for more |
1473 | <p>Other things are possible, e.g. resizing (see <code>rxvt(7)</code> for more |
1473 | info):</p> |
1474 | info):</p> |
1474 | </dd> |
1475 | </dd> |
1475 | <dd> |
1476 | <dd> |
1476 | <pre> |
1477 | <pre> |
1477 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
1478 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
… | |
… | |
1494 | <code>selection</code>.</p> |
1495 | <code>selection</code>.</p> |
1495 | </dd> |
1496 | </dd> |
1496 | <dd> |
1497 | <dd> |
1497 | <p>Extension names can also be followed by an argument in angle brackets |
1498 | <p>Extension names can also be followed by an argument in angle brackets |
1498 | (e.g. <code>searchable-scrollback<M-s></code>, which binds the hotkey for |
1499 | (e.g. <code>searchable-scrollback<M-s></code>, which binds the hotkey for |
1499 | searchable scorllback to Alt/Meta-s). Mentioning the same extension |
1500 | searchable scrollback to Alt/Meta-s). Mentioning the same extension |
1500 | multiple times with different arguments will pass multiple arguments to |
1501 | multiple times with different arguments will pass multiple arguments to |
1501 | the extension.</p> |
1502 | the extension.</p> |
1502 | </dd> |
1503 | </dd> |
1503 | <dd> |
1504 | <dd> |
1504 | <p>Each extension is looked up in the library directories, loaded if |
1505 | <p>Each extension is looked up in the library directories, loaded if |
… | |
… | |
1513 | </li> |
1514 | </li> |
1514 | <dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong> |
1515 | <dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong> |
1515 | |
1516 | |
1516 | <dd> |
1517 | <dd> |
1517 | <p>Perl code to be evaluated when all extensions have been registered. See |
1518 | <p>Perl code to be evaluated when all extensions have been registered. See |
1518 | the <code>urxvtperl(3)</code> manpage. Due to security reasons, this resource |
1519 | the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource |
1519 | will be ignored when running setuid/setgid.</p> |
1520 | will be ignored when running setuid/setgid.</p> |
1520 | </dd> |
1521 | </dd> |
1521 | </li> |
1522 | </li> |
1522 | <dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong> |
1523 | <dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong> |
1523 | |
1524 | |
1524 | <dd> |
1525 | <dd> |
1525 | <p>Colon-separated list of additional directories that hold extension |
1526 | <p>Colon-separated list of additional directories that hold extension |
1526 | scripts. When looking for extensions specified by the <code>perl</code> resource, |
1527 | scripts. When looking for extensions specified by the <code>perl</code> resource, |
1527 | urxvt will first look in these directories and then in |
1528 | rxvt will first look in these directories and then in |
1528 | <em>/usr/local/lib/urxvt/perl/</em>. Due to security reasons, this resource |
1529 | <em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource |
1529 | will be ignored when running setuid/setgid.</p> |
1530 | will be ignored when running setuid/setgid.</p> |
1530 | </dd> |
1531 | </dd> |
1531 | <dd> |
1532 | <dd> |
1532 | <p>See the <code>urxvtperl(3)</code> manpage.</p> |
1533 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
1533 | </dd> |
1534 | </dd> |
1534 | </li> |
1535 | </li> |
1535 | <dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong> |
1536 | <dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong> |
1536 | |
1537 | |
1537 | <dd> |
1538 | <dd> |
1538 | <p>Additional selection patterns, see the <code>urxvtperl(3)</code> manpage for |
1539 | <p>Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for |
1539 | details.</p> |
1540 | details.</p> |
1540 | </dd> |
1541 | </dd> |
1541 | </li> |
1542 | </li> |
1542 | <dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong> |
1543 | <dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong> |
1543 | |
1544 | |
1544 | <dd> |
1545 | <dd> |
1545 | <p>Selection auto-transform patterns, see the <code>urxvtperl(3)</code> manpage |
1546 | <p>Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage |
1546 | for details.</p> |
1547 | for details.</p> |
1547 | </dd> |
1548 | </dd> |
1548 | </li> |
1549 | </li> |
1549 | <dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong> |
1550 | <dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong> |
1550 | |
1551 | |
… | |
… | |
1576 | </dl> |
1577 | </dl> |
1577 | <p> |
1578 | <p> |
1578 | </p> |
1579 | </p> |
1579 | <hr /> |
1580 | <hr /> |
1580 | <h1><a name="the_scrollbar">THE SCROLLBAR</a></h1> |
1581 | <h1><a name="the_scrollbar">THE SCROLLBAR</a></h1> |
1581 | <p>Lines of text that scroll off the top of the <strong>urxvt</strong> window |
1582 | <p>Lines of text that scroll off the top of the <strong>rxvt</strong> window |
1582 | (resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar |
1583 | (resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar |
1583 | or by keystrokes. The normal <strong>urxvt</strong> scrollbar has arrows and |
1584 | or by keystrokes. The normal <strong>rxvt</strong> scrollbar has arrows and |
1584 | its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without |
1585 | its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without |
1585 | arrows and its behaviour mimics that of <em>xterm</em></p> |
1586 | arrows and its behaviour mimics that of <em>xterm</em></p> |
1586 | <p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>. |
1587 | <p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>. |
1587 | Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>. |
1588 | Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>. |
1588 | Continuous scroll with <strong>Button2</strong>.</p> |
1589 | Continuous scroll with <strong>Button2</strong>.</p> |
… | |
… | |
1624 | </dd> |
1625 | </dd> |
1625 | </li> |
1626 | </li> |
1626 | <dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong> |
1627 | <dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong> |
1627 | |
1628 | |
1628 | <dd> |
1629 | <dd> |
1629 | <p>Pressing and releasing the Middle mouse button in an <strong>urxvt</strong> |
1630 | <p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> |
1630 | window causes the value of the PRIMARY selection (or CLIPBOARD with the |
1631 | window causes the value of the PRIMARY selection (or CLIPBOARD with the |
1631 | Meta modifier) to be inserted as if it had been typed on the keyboard.</p> |
1632 | Meta modifier) to be inserted as if it had been typed on the keyboard.</p> |
1632 | </dd> |
1633 | </dd> |
1633 | <dd> |
1634 | <dd> |
1634 | <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be |
1635 | <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be |
… | |
… | |
1710 | both scenario A and B of ISO 14755, including part 5.2.</p> |
1711 | both scenario A and B of ISO 14755, including part 5.2.</p> |
1711 | <p> |
1712 | <p> |
1712 | </p> |
1713 | </p> |
1713 | <hr /> |
1714 | <hr /> |
1714 | <h1><a name="login_stamp">LOGIN STAMP</a></h1> |
1715 | <h1><a name="login_stamp">LOGIN STAMP</a></h1> |
1715 | <p><strong>urxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that |
1716 | <p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that |
1716 | it can be seen via the <em>who(1)</em> command, and can accept messages. To |
1717 | it can be seen via the <em>who(1)</em> command, and can accept messages. To |
1717 | allow this feature, <strong>urxvt</strong> may need to be installed setuid root |
1718 | allow this feature, <strong>rxvt</strong> may need to be installed setuid root |
1718 | on some systems or setgid to root or to some other group on others.</p> |
1719 | on some systems or setgid to root or to some other group on others.</p> |
1719 | <p> |
1720 | <p> |
1720 | </p> |
1721 | </p> |
1721 | <hr /> |
1722 | <hr /> |
1722 | <h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> |
1723 | <h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> |
1723 | <p>In addition to the default foreground and background colours, |
1724 | <p>In addition to the default foreground and background colours, |
1724 | <strong>urxvt</strong> can display up to 16 colours (8 ANSI colours plus |
1725 | <strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus |
1725 | high-intensity bold/blink versions of the same). Here is a list of the |
1726 | high-intensity bold/blink versions of the same). Here is a list of the |
1726 | colours with their names.</p> |
1727 | colours with their names.</p> |
1727 | <table> |
1728 | <table> |
1728 | <tr><td>color0</td><td>(black)</td><td>= Black</td></tr> |
1729 | <tr><td>color0</td><td>(black)</td><td>= Black</td></tr> |
1729 | <tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> |
1730 | <tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> |
… | |
… | |
1745 | <tr><td>background</td><td></td><td>= White</td></tr> |
1746 | <tr><td>background</td><td></td><td>= White</td></tr> |
1746 | </table><p>It is also possible to specify the colour values of <strong>foreground</strong>, |
1747 | </table><p>It is also possible to specify the colour values of <strong>foreground</strong>, |
1747 | <strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as |
1748 | <strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as |
1748 | a number 0-15, as a convenient shorthand to reference the colour name of |
1749 | a number 0-15, as a convenient shorthand to reference the colour name of |
1749 | color0-color15.</p> |
1750 | color0-color15.</p> |
1750 | <p>In addition to the colours defined above, urxvt offers an |
1751 | <p>In addition to the colours defined above, rxvt offers an |
1751 | additional 72 colours. The first 64 of those (with indices 16 to 79) |
1752 | additional 72 colours. The first 64 of those (with indices 16 to 79) |
1752 | consist of a 4*4*4 RGB colour cube (i.e. <em>index = r * 16 + g * 4 + b + |
1753 | consist of a 4*4*4 RGB colour cube (i.e. <em>index = r * 16 + g * 4 + b + |
1753 | 16</em>), followed by 8 additional shades of gray (with indices 80 to 87).</p> |
1754 | 16</em>), followed by 8 additional shades of gray (with indices 80 to 87).</p> |
1754 | <p>Together, all those colours implement the 88 colour xterm colours. Only |
1755 | <p>Together, all those colours implement the 88 colour xterm colours. Only |
1755 | the first 16 can be changed using resources currently, the rest can only |
1756 | the first 16 can be changed using resources currently, the rest can only |
… | |
… | |
1757 | <p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by |
1758 | <p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by |
1758 | always swapping the foreground/background colours. This is in contrast to |
1759 | always swapping the foreground/background colours. This is in contrast to |
1759 | <em>xterm</em>(1) where the colours are only swapped if they have not otherwise |
1760 | <em>xterm</em>(1) where the colours are only swapped if they have not otherwise |
1760 | been specified. For example,</p> |
1761 | been specified. For example,</p> |
1761 | <dl> |
1762 | <dl> |
1762 | <dt><strong><a name="item_urxvt__2dfg_black__2dbg_white__2drv"><strong>urxvt -fg Black -bg White -rv</strong></a></strong> |
1763 | <dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong> |
1763 | |
1764 | |
1764 | <dd> |
1765 | <dd> |
1765 | <p>would yield White on Black, while on <em>xterm</em>(1) it would yield Black |
1766 | <p>would yield White on Black, while on <em>xterm</em>(1) it would yield Black |
1766 | on White.</p> |
1767 | on White.</p> |
1767 | </dd> |
1768 | </dd> |
… | |
… | |
1781 | your X-server uses ARGB pixel layout, as X is far from just supporting |
1782 | your X-server uses ARGB pixel layout, as X is far from just supporting |
1782 | ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> |
1783 | ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> |
1783 | <p>For example, the following selects an almost completely transparent red |
1784 | <p>For example, the following selects an almost completely transparent red |
1784 | background, and an almost opaque pink foreground:</p> |
1785 | background, and an almost opaque pink foreground:</p> |
1785 | <pre> |
1786 | <pre> |
1786 | urxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"</pre> |
1787 | rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"</pre> |
1787 | <p><em>Please note that transparency of any kind if completely unsupported by |
1788 | <p><em>Please note that transparency of any kind if completely unsupported by |
1788 | the author. Don't bug him with installation questions!</em></p> |
1789 | the author. Don't bug him with installation questions!</em></p> |
1789 | <p> |
1790 | <p> |
1790 | </p> |
1791 | </p> |
1791 | <hr /> |
1792 | <hr /> |
1792 | <h1><a name="environment">ENVIRONMENT</a></h1> |
1793 | <h1><a name="environment">ENVIRONMENT</a></h1> |
1793 | <p><strong>urxvt</strong> sets and/or uses the following environment variables:</p> |
1794 | <p><strong>rxvt</strong> sets and/or uses the following environment variables:</p> |
1794 | <dl> |
1795 | <dl> |
1795 | <dt><strong><a name="item_term"><strong>TERM</strong></a></strong> |
1796 | <dt><strong><a name="item_term"><strong>TERM</strong></a></strong> |
1796 | |
1797 | |
1797 | <dd> |
1798 | <dd> |
1798 | <p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via |
1799 | <p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via |
1799 | resources or on the commandline.</p> |
1800 | resources or on the command line.</p> |
1800 | </dd> |
1801 | </dd> |
1801 | </li> |
1802 | </li> |
1802 | <dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong> |
1803 | <dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong> |
1803 | |
1804 | |
1804 | <dd> |
1805 | <dd> |
1805 | <p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether urxvt was |
1806 | <p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether rxvt was |
1806 | compiled with XPM support, and optionally with the added extension |
1807 | compiled with XPM support, and optionally with the added extension |
1807 | <code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p> |
1808 | <code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p> |
1808 | </dd> |
1809 | </dd> |
1809 | </li> |
1810 | </li> |
1810 | <dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong> |
1811 | <dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong> |
… | |
… | |
1812 | <dd> |
1813 | <dd> |
1813 | <p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is |
1814 | <p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is |
1814 | the colour code used as default foreground/text colour (or the string |
1815 | the colour code used as default foreground/text colour (or the string |
1815 | <code>default</code> to indicate that the default-colour escape sequence is to be |
1816 | <code>default</code> to indicate that the default-colour escape sequence is to be |
1816 | used), <code>bg</code> is the colour code used as default background colour (or the |
1817 | used), <code>bg</code> is the colour code used as default background colour (or the |
1817 | string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if urxvt |
1818 | string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt |
1818 | was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can |
1819 | was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can |
1819 | (and do) use this information to optimize screen output.</p> |
1820 | (and do) use this information to optimize screen output.</p> |
1820 | </dd> |
1821 | </dd> |
1821 | </li> |
1822 | </li> |
1822 | <dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong> |
1823 | <dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong> |
1823 | |
1824 | |
1824 | <dd> |
1825 | <dd> |
1825 | <p>Set to the (decimal) X Window ID of the urxvt window (the toplevel |
1826 | <p>Set to the (decimal) X Window ID of the rxvt window (the toplevel |
1826 | window, which usually has subwindows for the scrollbar, the terminal |
1827 | window, which usually has subwindows for the scrollbar, the terminal |
1827 | window and so on).</p> |
1828 | window and so on).</p> |
1828 | </dd> |
1829 | </dd> |
1829 | </li> |
1830 | </li> |
1830 | <dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong> |
1831 | <dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong> |
1831 | |
1832 | |
1832 | <dd> |
1833 | <dd> |
1833 | <p>Set to the terminfo directory iff urxvt was configured with |
1834 | <p>Set to the terminfo directory iff rxvt was configured with |
1834 | <code>--with-terminfo=PATH</code>.</p> |
1835 | <code>--with-terminfo=PATH</code>.</p> |
1835 | </dd> |
1836 | </dd> |
1836 | </li> |
1837 | </li> |
1837 | <dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong> |
1838 | <dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong> |
1838 | |
1839 | |
1839 | <dd> |
1840 | <dd> |
1840 | <p>Used by urxvt to connect to the display and set to the correct |
1841 | <p>Used by rxvt to connect to the display and set to the correct |
1841 | display in its child processes.</p> |
1842 | display in its child processes.</p> |
1842 | </dd> |
1843 | </dd> |
1843 | </li> |
1844 | </li> |
1844 | <dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong> |
1845 | <dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong> |
1845 | |
1846 | |
… | |
… | |
1848 | </dd> |
1849 | </dd> |
1849 | </li> |
1850 | </li> |
1850 | <dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong> |
1851 | <dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong> |
1851 | |
1852 | |
1852 | <dd> |
1853 | <dd> |
1853 | <p>The unix domain socket path used by <code>urxvtc(1)</code> and |
1854 | <p>The unix domain socket path used by <code>rxvtc(1)</code> and |
1854 | urxvtd(1).</p> |
1855 | rxvtd(1).</p> |
1855 | </dd> |
1856 | </dd> |
1856 | <dd> |
1857 | <dd> |
1857 | <p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p> |
1858 | <p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p> |
1858 | </dd> |
1859 | </dd> |
1859 | </li> |
1860 | </li> |
… | |
… | |
1873 | </li> |
1874 | </li> |
1874 | <dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong> |
1875 | <dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong> |
1875 | |
1876 | |
1876 | <dd> |
1877 | <dd> |
1877 | <p>If set and accessible, gives the name of a X resource file to be loaded by |
1878 | <p>If set and accessible, gives the name of a X resource file to be loaded by |
1878 | urxvt.</p> |
1879 | rxvt.</p> |
1879 | </dd> |
1880 | </dd> |
1880 | </li> |
1881 | </li> |
1881 | </dl> |
1882 | </dl> |
1882 | <p> |
1883 | <p> |
1883 | </p> |
1884 | </p> |
… | |
… | |
1893 | </dl> |
1894 | </dl> |
1894 | <p> |
1895 | <p> |
1895 | </p> |
1896 | </p> |
1896 | <hr /> |
1897 | <hr /> |
1897 | <h1><a name="see_also">SEE ALSO</a></h1> |
1898 | <h1><a name="see_also">SEE ALSO</a></h1> |
1898 | <p>urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1899 | <p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1899 | <p> |
1900 | <p> |
1900 | </p> |
1901 | </p> |
1901 | <hr /> |
1902 | <hr /> |
1902 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1903 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1903 | <dl> |
1904 | <dl> |