… | |
… | |
2 | |
2 | |
3 | rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system) |
3 | rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system) |
4 | |
4 | |
5 | =head1 SYNOPSIS |
5 | =head1 SYNOPSIS |
6 | |
6 | |
7 | B<@@RXVTNAME@@> [options] [-e command [ args ]] |
7 | B<@@RXVT_NAME@@> [options] [-e command [ args ]] |
8 | |
8 | |
9 | =head1 DESCRIPTION |
9 | =head1 DESCRIPTION |
10 | |
10 | |
11 | B<rxvt-unicode>, version B<@@RXVTVERSION@@>, is a colour vt102 terminal |
11 | B<rxvt-unicode>, version B<@@RXVTVERSION@@>, is a colour vt102 terminal |
12 | emulator intended as an I<xterm>(1) replacement for users who do not |
12 | emulator intended as an I<xterm>(1) replacement for users who do not |
13 | require features such as Tektronix 4014 emulation and toolkit-style |
13 | require features such as Tektronix 4014 emulation and toolkit-style |
14 | configurability. As a result, B<rxvt-unicode> uses much less swap space -- |
14 | configurability. As a result, B<rxvt-unicode> uses much less swap space -- |
15 | a significant advantage on a machine serving many X sessions. |
15 | a significant advantage on a machine serving many X sessions. |
16 | |
16 | |
|
|
17 | See also @@RXVT_NAME@@(7) for technical reference documentation (escape |
|
|
18 | sequences etc.). |
|
|
19 | |
17 | =head1 OPTIONS |
20 | =head1 OPTIONS |
18 | |
21 | |
19 | The B<@@RXVTNAME@@> options (mostly a subset of I<xterm>'s) are listed |
22 | The B<@@RXVT_NAME@@> options (mostly a subset of I<xterm>'s) are listed |
20 | below. In keeping with the smaller-is-better philosophy, options may be |
23 | below. In keeping with the smaller-is-better philosophy, options may be |
21 | eliminated or default values chosen at compile-time, so options and |
24 | eliminated or default values chosen at compile-time, so options and |
22 | defaults listed may not accurately reflect the version installed on |
25 | defaults listed may not accurately reflect the version installed on |
23 | your system. `rxvt -h' gives a list of major compile-time options on |
26 | your system. `rxvt -h' gives a list of major compile-time options on |
24 | the I<Options> line. Option descriptions may be prefixed with which |
27 | the I<Options> line. Option descriptions may be prefixed with which |
25 | compile option each is dependent upon. e.g. `Compile I<XIM>:' requires |
28 | compile option each is dependent upon. e.g. `Compile I<XIM>:' requires |
26 | I<XIM> on the I<Options> line. Note: `rxvt -help' gives a list of all |
29 | I<XIM> on the I<Options> line. Note: `rxvt -help' gives a list of all |
27 | command-line options compiled into your version. |
30 | command-line options compiled into your version. |
28 | |
31 | |
29 | Note that B<@@RXVTNAME@@> permits the resource name to be used as a |
32 | Note that B<@@RXVT_NAME@@> permits the resource name to be used as a |
30 | long-option (--/++ option) so the potential command-line options are |
33 | long-option (--/++ option) so the potential command-line options are |
31 | far greater than those listed. For example: `rxvt --loginShell --color1 |
34 | far greater than those listed. For example: `rxvt --loginShell --color1 |
32 | Orange'. |
35 | Orange'. |
33 | |
36 | |
34 | The following options are available: |
37 | The following options are available: |
… | |
… | |
219 | I<termcap(5)> database and should have I<li#> and I<co#> entries; |
222 | I<termcap(5)> database and should have I<li#> and I<co#> entries; |
220 | resource B<termName>. |
223 | resource B<termName>. |
221 | |
224 | |
222 | =item B<-e> I<command [arguments]> |
225 | =item B<-e> I<command [arguments]> |
223 | |
226 | |
224 | Run the command with its command-line arguments in the B<@@RXVTNAME@@> |
227 | Run the command with its command-line arguments in the B<@@RXVT_NAME@@> |
225 | window; also sets the window title and icon name to be the basename of |
228 | window; also sets the window title and icon name to be the basename of |
226 | the program being executed if neither I<-title> (I<-T>) nor I<-n> are |
229 | the program being executed if neither I<-title> (I<-T>) nor I<-n> are |
227 | given on the command line. If this option is used, it must be the last |
230 | given on the command line. If this option is used, it must be the last |
228 | on the command-line. If there is no B<-e> option then the default is to |
231 | on the command-line. If there is no B<-e> option then the default is to |
229 | run the program specified by the B<SHELL> environment variable or, |
232 | run the program specified by the B<SHELL> environment variable or, |
… | |
… | |
291 | |
294 | |
292 | =back |
295 | =back |
293 | |
296 | |
294 | =head1 RESOURCES (available also as long-options) |
297 | =head1 RESOURCES (available also as long-options) |
295 | |
298 | |
296 | Note: `@@RXVTNAME@@ --help' gives a list of all resources (long |
299 | Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long |
297 | options) compiled into your version. |
300 | options) compiled into your version. |
298 | |
301 | |
299 | There are two different methods that @@RXVTNAME@@ can use to get the |
302 | There are two different methods that @@RXVT_NAME@@ can use to get the |
300 | Xresource data: using the X libraries (Xrm*-functions) or internal |
303 | Xresource data: using the X libraries (Xrm*-functions) or internal |
301 | Xresources reader (B<~/.Xdefaults>). For the first method (ie. |
304 | Xresources reader (B<~/.Xdefaults>). For the first method (ie. |
302 | B<@@RXVTNAME@@ -h> lists B<XGetDefaults>), you can set and change the |
305 | B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the |
303 | resources using X11 tools like B<xset>. Many distribution do also load |
306 | resources using X11 tools like B<xset>. Many distribution do also load |
304 | settings from the B<~/.Xresources> file when X starts. |
307 | settings from the B<~/.Xresources> file when X starts. |
305 | |
308 | |
306 | If compiled with internal Xresources support (i.e. B<@@RXVTNAME@@ -h> |
309 | If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h> |
307 | lists B<.Xdefaults>) then B<@@RXVTNAME@@> accepts application defaults |
310 | lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults |
308 | set in XAPPLOADDIR/URxvt (compile-time defined: usually |
311 | set in XAPPLOADDIR/URxvt (compile-time defined: usually |
309 | B</usr/lib/X11/app-defaults/URxvt>) and resources set in |
312 | B</usr/lib/X11/app-defaults/URxvt>) and resources set in |
310 | B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. |
313 | B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. |
311 | Note that when reading X resources, B<@@RXVTNAME@@> recognizes two |
314 | Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two |
312 | class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows |
315 | class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows |
313 | resources common to both B<@@RXVTNAME@@> and the original I<rxvt> to be |
316 | resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be |
314 | easily configured, while the class name B<URxvt> allows resources |
317 | easily configured, while the class name B<URxvt> allows resources |
315 | unique to B<@@RXVTNAME@@>, notably colours and key-handling, to be |
318 | unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be |
316 | shared between different B<@@RXVTNAME@@> configurations. If no |
319 | shared between different B<@@RXVT_NAME@@> configurations. If no |
317 | resources are specified, suitable defaults will be used. Command-line |
320 | resources are specified, suitable defaults will be used. Command-line |
318 | arguments can be used to override resource settings. The following |
321 | arguments can be used to override resource settings. The following |
319 | resources are allowed: |
322 | resources are allowed: |
320 | |
323 | |
321 | =over 4 |
324 | =over 4 |
… | |
… | |
462 | xterm style with 2.20 old word selection, or anything else which gives |
465 | xterm style with 2.20 old word selection, or anything else which gives |
463 | xterm style selection. |
466 | xterm style selection. |
464 | |
467 | |
465 | =item B<scrollstyle:> I<mode> |
468 | =item B<scrollstyle:> I<mode> |
466 | |
469 | |
467 | Set scrollbar style to B<@@RXVTNAME@@>, B<rxvt>, B<plain>, B<next> or |
470 | Set scrollbar style to B<@@RXVT_NAME@@>, B<rxvt>, B<plain>, B<next> or |
468 | B<xterm> |
471 | B<xterm> |
469 | |
472 | |
470 | =item B<title:> I<string> |
473 | =item B<title:> I<string> |
471 | |
474 | |
472 | Set window title string, the default title is the command-line |
475 | Set window title string, the default title is the command-line |
… | |
… | |
703 | |
706 | |
704 | =back |
707 | =back |
705 | |
708 | |
706 | =head1 THE SCROLLBAR |
709 | =head1 THE SCROLLBAR |
707 | |
710 | |
708 | Lines of text that scroll off the top of the B<@@RXVTNAME@@> window |
711 | Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window |
709 | (resource: B<saveLines>) and can be scrolled back using the scrollbar |
712 | (resource: B<saveLines>) and can be scrolled back using the scrollbar |
710 | or by keystrokes. The normal B<@@RXVTNAME@@> scrollbar has arrows and |
713 | or by keystrokes. The normal B<@@RXVT_NAME@@> scrollbar has arrows and |
711 | its behaviour is fairly intuitive. The B<xterm-scrollbar> is without |
714 | its behaviour is fairly intuitive. The B<xterm-scrollbar> is without |
712 | arrows and its behaviour mimics that of I<xterm> |
715 | arrows and its behaviour mimics that of I<xterm> |
713 | |
716 | |
714 | Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>. |
717 | Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>. |
715 | Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>. |
718 | Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>. |
… | |
… | |
743 | line. |
746 | line. |
744 | |
747 | |
745 | =item B<Insertion>: |
748 | =item B<Insertion>: |
746 | |
749 | |
747 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |
750 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |
748 | an B<@@RXVTNAME@@> window causes the current text selection to be |
751 | an B<@@RXVT_NAME@@> window causes the current text selection to be |
749 | inserted as if it had been typed on the keyboard. |
752 | inserted as if it had been typed on the keyboard. |
750 | |
753 | |
751 | =back |
754 | =back |
752 | |
755 | |
753 | =head1 CHANGING FONTS |
756 | =head1 CHANGING FONTS |
… | |
… | |
757 | B<Shift-KP_Subtract>. Or, alternatively (if enabled) with |
760 | B<Shift-KP_Subtract>. Or, alternatively (if enabled) with |
758 | B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the |
761 | B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the |
759 | actual key can be selected using resources |
762 | actual key can be selected using resources |
760 | B<smallfont_key>/B<bigfont_key>. |
763 | B<smallfont_key>/B<bigfont_key>. |
761 | |
764 | |
|
|
765 | =head1 ISO 14755 SUPPORT |
|
|
766 | |
|
|
767 | Partial ISO 14755-support is implemented. that means that pressing |
|
|
768 | |
|
|
769 | Section 5.1: Control and Shift together enters unicode input |
|
|
770 | mode. Entering hex digits composes a Unicode character, pressing space or |
|
|
771 | releasing the modifiers commits the keycode and every other key cancels |
|
|
772 | the current input character. |
|
|
773 | |
|
|
774 | Section 5.2: Pressing and immediately releasing Control and Shift together |
|
|
775 | enters keycap entry mode for the next key: pressing a function key (tab, |
|
|
776 | return etc..) will enter the unicode character corresponding to the given |
|
|
777 | key. |
|
|
778 | |
762 | =head1 LOGIN STAMP |
779 | =head1 LOGIN STAMP |
763 | |
780 | |
764 | B<@@RXVTNAME@@> tries to write an entry into the I<utmp>(5) file so |
781 | B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so |
765 | that it can be seen via the I<who(1)> command, and can accept messages. |
782 | that it can be seen via the I<who(1)> command, and can accept messages. |
766 | To allow this feature, B<@@RXVTNAME@@> must be installed setuid root on |
783 | To allow this feature, B<@@RXVT_NAME@@> must be installed setuid root on |
767 | some systems. |
784 | some systems. |
768 | |
785 | |
769 | =head1 COLORS AND GRAPHICS |
786 | =head1 COLORS AND GRAPHICS |
770 | |
787 | |
771 | In addition to the default foreground and background colours, |
788 | In addition to the default foreground and background colours, |
772 | B<@@RXVTNAME@@> can display up to 16 colours (8 ANSI colours plus |
789 | B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus |
773 | high-intensity bold/blink versions of the same). Here is a list of the |
790 | high-intensity bold/blink versions of the same). Here is a list of the |
774 | colours with their B<rgb.txt> names. |
791 | colours with their B<rgb.txt> names. |
775 | |
792 | |
776 | =begin table |
793 | =begin table |
777 | |
794 | |
… | |
… | |
815 | |
832 | |
816 | =back |
833 | =back |
817 | |
834 | |
818 | =head1 ENVIRONMENT |
835 | =head1 ENVIRONMENT |
819 | |
836 | |
820 | B<@@RXVTNAME@@> sets the environment variables B<TERM>, B<COLORTERM> |
837 | B<@@RXVT_NAME@@> sets the environment variables B<TERM>, B<COLORTERM> |
821 | and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X |
838 | and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X |
822 | window id number of the B<@@RXVTNAME@@> window and it also uses and |
839 | window id number of the B<@@RXVT_NAME@@> window and it also uses and |
823 | sets the environment variable B<DISPLAY> to specify which display |
840 | sets the environment variable B<DISPLAY> to specify which display |
824 | terminal to use. B<@@RXVTNAME@@> uses the environment variables |
841 | terminal to use. B<@@RXVT_NAME@@> uses the environment variables |
825 | B<RXVTPATH> and B<PATH> to find XPM files. |
842 | B<RXVTPATH> and B<PATH> to find XPM files. |
826 | |
843 | |
827 | =head1 FILES |
844 | =head1 FILES |
828 | |
845 | |
829 | =over 4 |
846 | =over 4 |
… | |
… | |
850 | |
867 | |
851 | Cursor change support is not yet implemented. |
868 | Cursor change support is not yet implemented. |
852 | |
869 | |
853 | Click-and-drag doesn't work with X11 mouse report overriding. |
870 | Click-and-drag doesn't work with X11 mouse report overriding. |
854 | |
871 | |
855 | =head1 FTP LOCATION |
|
|
856 | |
|
|
857 | rxvt-+@@RXVTVERSION@@.tar.gz can be found at the following ftp sites L<@@RXVTFTPSITE@@>(@@RXVTFTPSITE@@) |
|
|
858 | |
|
|
859 | =head1 CURRENT PROJECT COORDINATOR |
872 | =head1 CURRENT PROJECT COORDINATOR |
860 | |
873 | |
861 | =over 4 |
874 | =over 4 |
862 | |
875 | |
863 | =item Project Coordinator |
876 | =item Project Coordinator |
864 | |
877 | |
865 | @@RXVTMAINT@@ L<@@RXVTMAINTEMAIL@@> |
878 | @@RXVTMAINT@@ L<@@RXVT_MAINTEMAIL@@> |
866 | |
879 | |
867 | =item Web page maintainter |
880 | =item Web page maintainter |
868 | |
881 | |
869 | @@RXVTWEBMAINT@@ L<@@RXVTWEBMAINTEMAIL@@> |
882 | @@RXVTWEBMAINT@@ L<@@RXVT_WEBMAINTEMAIL@@> |
870 | |
883 | |
871 | L<@@RXVTWEBPAGE@@>(@@RXVTWEBPAGE@@) |
884 | L<@@RXVT_WEBPAGE@@> |
872 | |
885 | |
873 | =back |
886 | =back |
874 | |
887 | |
875 | =head1 AUTHORS |
888 | =head1 AUTHORS |
876 | |
889 | |