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

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.3 by root, Mon Jan 17 01:44:51 2005 UTC vs.
Revision 1.6 by root, Thu Feb 3 10:24:10 2005 UTC

4 4
5SYNOPSIS 5SYNOPSIS
6 rxvt [options] [-e command [ args ]] 6 rxvt [options] [-e command [ args ]]
7 7
8DESCRIPTION 8DESCRIPTION
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
740THE SCROLLBAR 775THE 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
852LOGIN STAMP 888LOGIN 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
857COLORS AND GRAPHICS 894COLORS 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
903FILES 940FILES
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
910SEE ALSO 944SEE 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)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines