… | |
… | |
4 | |
4 | |
5 | SYNOPSIS |
5 | SYNOPSIS |
6 | rxvt [options] [-e command [ args ]] |
6 | rxvt [options] [-e command [ args ]] |
7 | |
7 | |
8 | DESCRIPTION |
8 | DESCRIPTION |
9 | rxvt-unicode, version 4.8, is a colour vt102 terminal emulator intended |
9 | rxvt-unicode, version 4.9, is a colour vt102 terminal emulator intended |
10 | as an *xterm*(1) replacement for users who do not require features such |
10 | as an *xterm*(1) replacement for users who do not require features such |
11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
12 | result, rxvt-unicode uses much less swap space -- a significant |
12 | result, rxvt-unicode uses much less swap space -- a significant |
13 | advantage on a machine serving many X sessions. |
13 | advantage on a machine serving many X sessions. |
14 | |
14 | |
… | |
… | |
277 | |
277 | |
278 | -im *text* |
278 | -im *text* |
279 | Compile *XIM*: input method name. resource inputMethod. |
279 | Compile *XIM*: input method name. resource inputMethod. |
280 | |
280 | |
281 | -imlocale *string* |
281 | -imlocale *string* |
282 | The locale to use for opening the IM. You can use an LC_CTYPE of |
282 | The locale to use for opening the IM. You can use an "LC_CTYPE" of |
283 | e.g. de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the |
283 | e.g. "de_DE.UTF-8" for normal text processing but "ja_JP.EUC-JP" for |
284 | input extension to be able to input japanese characters while |
284 | the input extension to be able to input japanese characters while |
285 | staying in another locale. |
285 | staying in another locale. resource imLocale. |
|
|
286 | |
|
|
287 | -imfont *fontset* |
|
|
288 | Set the font set to use for the X Input Method, see resource imFont |
|
|
289 | for more info. |
|
|
290 | |
|
|
291 | -tcw |
|
|
292 | Change the meaning of triple-click selection with the left mouse |
|
|
293 | button. Instead of selecting a full line it will extend the |
|
|
294 | selection the end of the logical line only. resource |
|
|
295 | tripleclickwords. |
286 | |
296 | |
287 | -insecure |
297 | -insecure |
288 | Enable "insecure" mode, which currently enables most of the escape |
298 | Enable "insecure" mode, which currently enables most of the escape |
289 | sequences that echo strings. See the resource insecure for more |
299 | sequences that echo strings. See the resource insecure for more |
290 | info. |
300 | info. |
… | |
… | |
654 | |
664 | |
655 | inputMethod: *name* |
665 | inputMethod: *name* |
656 | *name* of inputMethod to use; option -im. |
666 | *name* of inputMethod to use; option -im. |
657 | |
667 | |
658 | imLocale: *name* |
668 | imLocale: *name* |
659 | The locale to use for opening the IM. You can use an LC_CTYPE of |
669 | The locale to use for opening the IM. You can use an "LC_CTYPE" of |
660 | e.g. de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the |
670 | e.g. "de_DE.UTF-8" for normal text processing but "ja_JP.EUC-JP" for |
661 | input extension to be able to input japanese characters while |
671 | the input extension to be able to input japanese characters while |
662 | staying in another locale. option -imlocale. |
672 | staying in another locale. option -imlocale. |
|
|
673 | |
|
|
674 | imFont: *fontset* |
|
|
675 | Specify the font-set used for XIM styles "OverTheSpot" or |
|
|
676 | "OffTheSpot". It must be a standard X font set (XLFD patterns |
|
|
677 | separated by commas), i.e. it's not in the same format as the other |
|
|
678 | font lists used in rxvt. The default will be set-up to chose *any* |
|
|
679 | suitable found found, preferably one or two pixels differing in size |
|
|
680 | to the base font. option -imfont. |
|
|
681 | |
|
|
682 | tripleclickwords: *boolean* |
|
|
683 | Change the meaning of triple-click selection with the left mouse |
|
|
684 | button. Instead of selecting a full line it will extend the |
|
|
685 | selection to the end of the logical line only. option -tcw. |
663 | |
686 | |
664 | insecure: *boolean* |
687 | insecure: *boolean* |
665 | Enables "insecure" mode. Rxvt-unicode offers some escape sequences |
688 | Enables "insecure" mode. Rxvt-unicode offers some escape sequences |
666 | that echo arbitrary strings like the icon name or the locale. This |
689 | that echo arbitrary strings like the icon name or the locale. This |
667 | could be abused if somebody gets 8-bit-clean access to your display, |
690 | could be abused if somebody gets 8-bit-clean access to your display, |
… | |
… | |
700 | Meta, Lock, Mod1, Mod2, Mod3, Mod4, Mod5, and the abbreviated I, K, |
723 | Meta, Lock, Mod1, Mod2, Mod3, Mod4, Mod5, and the abbreviated I, K, |
701 | C, N, S, M, A, L, 1, 2, 3, 4, 5. |
724 | C, N, S, M, A, L, 1, 2, 3, 4, 5. |
702 | |
725 | |
703 | The NumLock, Meta and ISOLevel3 modifiers are usually aliased to |
726 | The NumLock, Meta and ISOLevel3 modifiers are usually aliased to |
704 | whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 |
727 | whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 |
705 | Shift/AltGr keys are being mapped. AppKeypad is a artificial |
728 | Shift/AltGr keys are being mapped. AppKeypad is a synthetic modifier |
706 | modifier mapped to the current application keymap mode state. |
729 | mapped to the current application keymap mode state. |
707 | |
730 | |
708 | The spellings of *key* can be obtained by using xev(1) command or |
731 | The spellings of *key* can be obtained by using xev(1) command or |
709 | searching keysym macros from /usr/X11R6/include/X11/keysymdef.h and |
732 | searching keysym macros from /usr/X11R6/include/X11/keysymdef.h and |
710 | omitting the prefix XK_. Alternatively you can specify *key* by its |
733 | omitting the prefix XK_. Alternatively you can specify *key* by its |
711 | hex keysym value (0x0000 - 0xFFFF). Note that the lookup of *sym*s |
734 | hex keysym value (0x0000 - 0xFFFF). Note that the lookup of *sym*s |
… | |
… | |
731 | URxvt.keysym.Meta-Control-0x61: \e<M-C-a> |
754 | URxvt.keysym.Meta-Control-0x61: \e<M-C-a> |
732 | URxvt.keysym.Meta-Control-0x62: \e<M-C-b> |
755 | URxvt.keysym.Meta-Control-0x62: \e<M-C-b> |
733 | URxvt.keysym.Meta-Control-0x63: \e<M-C-c> |
756 | URxvt.keysym.Meta-Control-0x63: \e<M-C-c> |
734 | |
757 | |
735 | If *string* takes the form of "proto:STRING", the specified STRING |
758 | If *string* takes the form of "proto:STRING", the specified STRING |
736 | is interpreted and executed as rxvt's control sequence. For example, |
759 | is interpreted and executed as rxvt's control sequence. For example |
|
|
760 | the following means "change the current locale to "zh_CN.GBK" when |
|
|
761 | Control-Meta-c is being pressed": |
|
|
762 | |
|
|
763 | URxvt.keysym.M-C-c: proto:\033]701;zh_CN.GBK\007 |
|
|
764 | |
|
|
765 | The following example will map Control-Meta-1 and Control-Meta-2 to |
|
|
766 | the fonts "suxuseuro" and "9x15bold", so you cna have some limited |
|
|
767 | font-switching at runtime: |
|
|
768 | |
|
|
769 | URxvt.keysym.M-C-1: proto:\033]50;suxuseuro\007 |
|
|
770 | URxvt.keysym.M-C-2: proto:\033]50;9x15bold\007 |
|
|
771 | |
737 | "proto:\033]701;zh_CN.GBK\007" means: change the current locale to |
772 | "proto:\033]701;zh_CN.GBK\007" means: change the current locale to |
738 | "zh_CN.GBK". |
773 | "zh_CN.GBK". |
739 | |
774 | |
740 | THE SCROLLBAR |
775 | THE SCROLLBAR |
741 | Lines of text that scroll off the top of the rxvt window (resource: |
776 | Lines of text that scroll off the top of the rxvt window (resource: |
… | |
… | |
765 | |
800 | |
766 | Selection: |
801 | Selection: |
767 | Left click at the beginning of the region, drag to the end of the |
802 | Left click at the beginning of the region, drag to the end of the |
768 | region and release; Right click to extend the marked region; Left |
803 | region and release; Right click to extend the marked region; Left |
769 | double-click to select a word; Left triple-click to select the |
804 | double-click to select a word; Left triple-click to select the |
770 | entire line. |
805 | entire logical line (which can span multiple screen lines), unless |
|
|
806 | modified by resource tripleclickwords. |
771 | |
807 | |
772 | Starting a selection while pressing the Meta key (or Meta+Ctrl keys) |
808 | Starting a selection while pressing the Meta key (or Meta+Ctrl keys) |
773 | (Compile: *frills*) will create a rectangular selection instead of a |
809 | (Compile: *frills*) will create a rectangular selection instead of a |
774 | normal one. |
810 | normal one. |
775 | |
811 | |
… | |
… | |
795 | character codes using the keyboard. It consists of 4 parts. The first |
831 | character codes using the keyboard. It consists of 4 parts. The first |
796 | part is available rxvt-unicode has been compiled with "--enable-frills", |
832 | part is available rxvt-unicode has been compiled with "--enable-frills", |
797 | the rest is available when rxvt-unicode was compiled with |
833 | the rest is available when rxvt-unicode was compiled with |
798 | "--enable-iso14755". |
834 | "--enable-iso14755". |
799 | |
835 | |
800 | 5.1: Basic method |
836 | * 5.1: Basic method |
801 | This allows you to enter unicode characters using their hexcode. |
837 | This allows you to enter unicode characters using their hexcode. |
802 | |
838 | |
803 | Start by pressing and holding both "Control" and "Shift", then enter |
839 | Start by pressing and holding both "Control" and "Shift", then enter |
804 | hex-digits (between one and six). Releasing "Control" and "Shift" |
840 | hex-digits (between one and six). Releasing "Control" and "Shift" |
805 | will commit the character as if it were typed directly. While |
841 | will commit the character as if it were typed directly. While |
… | |
… | |
811 | address, which you cannot type. Fortunately, the card has the e-mail |
847 | address, which you cannot type. Fortunately, the card has the e-mail |
812 | address printed as hexcodes, e.g. "671d 65e5". You can enter this |
848 | address printed as hexcodes, e.g. "671d 65e5". You can enter this |
813 | easily by pressing "Control" and "Shift", followed by |
849 | easily by pressing "Control" and "Shift", followed by |
814 | "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys. |
850 | "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys. |
815 | |
851 | |
816 | 5.2: Keyboard symbols entry method |
852 | * 5.2: Keyboard symbols entry method |
817 | This mode lets you input characters representing the keycap symbols |
853 | This mode lets you input characters representing the keycap symbols |
818 | of your keyboard, if representable in the current locale encoding. |
854 | of your keyboard, if representable in the current locale encoding. |
819 | |
855 | |
820 | Start by pressing "Control" and "Shift" together, then releasing |
856 | Start by pressing "Control" and "Shift" together, then releasing |
821 | them. The next special key (cursor keys, home etc.) you enter will |
857 | them. The next special key (cursor keys, home etc.) you enter will |
… | |
… | |
823 | corresponding keycap symbol. The symbol will only be entered when |
859 | corresponding keycap symbol. The symbol will only be entered when |
824 | the key has been released, otherwise pressing e.g. "Shift" would |
860 | the key has been released, otherwise pressing e.g. "Shift" would |
825 | enter the symbol for "ISO Level 2 Switch", although your intention |
861 | enter the symbol for "ISO Level 2 Switch", although your intention |
826 | might have been to enter a reverse tab (Shift-Tab). |
862 | might have been to enter a reverse tab (Shift-Tab). |
827 | |
863 | |
828 | 5.3: Screen-selection entry method |
864 | * 5.3: Screen-selection entry method |
829 | While this is implemented already (it's basically the selection |
865 | While this is implemented already (it's basically the selection |
830 | mechanism), it could be extended by displaying a unicode character |
866 | mechanism), it could be extended by displaying a unicode character |
831 | map. |
867 | map. |
832 | |
868 | |
833 | 5.4: Feedback method for identifying displayed characters for later |
869 | * 5.4: Feedback method for identifying displayed characters for later |
834 | input |
870 | input |
835 | This method lets you display the unicode character code associated |
871 | This method lets you display the unicode character code associated |
836 | with characters already displayed. |
872 | with characters already displayed. |
837 | |
873 | |
838 | You enter this mode by holding down "Control" and "Shift" together, |
874 | You enter this mode by holding down "Control" and "Shift" together, |
… | |
… | |
850 | both scenario A and B of ISO 14755, including part 5.2. |
886 | both scenario A and B of ISO 14755, including part 5.2. |
851 | |
887 | |
852 | LOGIN STAMP |
888 | LOGIN STAMP |
853 | rxvt tries to write an entry into the *utmp*(5) file so that it can be |
889 | rxvt tries to write an entry into the *utmp*(5) file so that it can be |
854 | seen via the *who(1)* command, and can accept messages. To allow this |
890 | seen via the *who(1)* command, and can accept messages. To allow this |
855 | feature, rxvt must be installed setuid root on some systems. |
891 | feature, rxvt may need to be installed setuid root on some systems or |
|
|
892 | setgid to root or to some other group on others. |
856 | |
893 | |
857 | COLORS AND GRAPHICS |
894 | COLORS AND GRAPHICS |
858 | In addition to the default foreground and background colours, rxvt can |
895 | In addition to the default foreground and background colours, rxvt can |
859 | display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
896 | display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
860 | versions of the same). Here is a list of the colours with their rgb.txt |
897 | versions of the same). Here is a list of the colours with their rgb.txt |
… | |
… | |
899 | rxvt window and it also uses and sets the environment variable DISPLAY |
936 | rxvt window and it also uses and sets the environment variable DISPLAY |
900 | to specify which display terminal to use. rxvt uses the environment |
937 | to specify which display terminal to use. rxvt uses the environment |
901 | variables RXVTPATH and PATH to find XPM files. |
938 | variables RXVTPATH and PATH to find XPM files. |
902 | |
939 | |
903 | FILES |
940 | FILES |
904 | /etc/utmp |
|
|
905 | System file for login records. |
|
|
906 | |
|
|
907 | /usr/lib/X11/rgb.txt |
941 | /usr/lib/X11/rgb.txt |
908 | Color names. |
942 | Color names. |
909 | |
943 | |
910 | SEE ALSO |
944 | SEE ALSO |
911 | rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |
945 | rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |