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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.43 by root, Sun Jan 16 19:22:16 2005 UTC vs.
Revision 1.48 by root, Thu Feb 3 10:24:10 2005 UTC

… …
328 328
329Compile I<XIM>: input method name. resource B<inputMethod>. 329Compile I<XIM>: input method name. resource B<inputMethod>.
330 330
331=item B<-imlocale> I<string> 331=item B<-imlocale> I<string>
332 332
333The locale to use for opening the IM. You can use an LC_CTYPE of e.g. 333The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
334de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input 334C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
335extension to be able to input japanese characters while staying in 335input extension to be able to input japanese characters while staying in
336another locale. 336another locale. resource B<imLocale>.
337
338=item B<-imfont> I<fontset>
339
340Set the font set to use for the X Input Method, see resource B<imFont>
341for more info.
342
343=item B<-tcw>
344
345Change the meaning of triple-click selection with the left mouse
346button. Instead of selecting a full line it will extend the selection the
347end of the logical line only. resource B<tripleclickwords>.
337 348
338=item B<-insecure> 349=item B<-insecure>
339 350
340Enable "insecure" mode, which currently enables most of the escape 351Enable "insecure" mode, which currently enables most of the escape
341sequences that echo strings. See the resource B<insecure> for more 352sequences that echo strings. See the resource B<insecure> for more
… …
775 786
776I<name> of inputMethod to use; option B<-im>. 787I<name> of inputMethod to use; option B<-im>.
777 788
778=item B<imLocale:> I<name> 789=item B<imLocale:> I<name>
779 790
780The locale to use for opening the IM. You can use an LC_CTYPE of e.g. 791The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
781de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input 792C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
782extension to be able to input japanese characters while staying in 793input extension to be able to input japanese characters while staying in
783another locale. option B<-imlocale>. 794another locale. option B<-imlocale>.
795
796=item B<imFont:> I<fontset>
797
798Specify the font-set used for XIM styles C<OverTheSpot> or
799C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
800by commas), i.e. it's not in the same format as the other font lists used
801in @@RXVT_NAME@@. The default will be set-up to chose *any* suitable found
802found, preferably one or two pixels differing in size to the base font.
803option B<-imfont>.
804
805=item B<tripleclickwords:> I<boolean>
806
807Change the meaning of triple-click selection with the left mouse
808button. Instead of selecting a full line it will extend the selection to
809the end of the logical line only. option B<-tcw>.
784 810
785=item B<insecure:> I<boolean> 811=item B<insecure:> I<boolean>
786 812
787Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 813Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
788echo arbitrary strings like the icon name or the locale. This could be 814echo arbitrary strings like the icon name or the locale. This could be
… …
829and the abbreviated B<I>, B<K>, B<C>, B<N>, B<S>, B<M>, B<A>, B<L>, B<1>, 855and the abbreviated B<I>, B<K>, B<C>, B<N>, B<S>, B<M>, B<A>, B<L>, B<1>,
830B<2>, B<3>, B<4>, B<5>. 856B<2>, B<3>, B<4>, B<5>.
831 857
832The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to 858The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to
833whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr 859whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
834keys are being mapped. B<AppKeypad> is a artificial modifier mapped to the 860keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the
835current application keymap mode state. 861current application keymap mode state.
836 862
837The spellings of I<key> can be obtained by using B<xev>(1) command or 863The spellings of I<key> can be obtained by using B<xev>(1) command or
838searching keysym macros from B</usr/X11R6/include/X11/keysymdef.h> and 864searching keysym macros from B</usr/X11R6/include/X11/keysymdef.h> and
839omitting the prefix B<XK_>. Alternatively you can specify I<key> by its hex 865omitting the prefix B<XK_>. Alternatively you can specify I<key> by its hex
… …
844C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, 870C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab,
845C<\000>: octal number) or verbatim control characters (C<^?>: delete, 871C<\000>: octal number) or verbatim control characters (C<^?>: delete,
846C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it 872C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it
847can start or end with whitespace. 873can start or end with whitespace.
848 874
875Please note that you need to double the C<\> when using
876C<--enable-xgetdefault>, as X itself does it's own de-escaping (you can
877use C<\033> instead of C<\e> (and so on), which will work with both Xt and
878@@RXVT_NAME@@'s own processing).
879
849You can define a range of keysyms in one shot by providing a I<string> 880You can define a range of keysyms in one shot by providing a I<string>
850with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' 881with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/'
851should be a character not used by the strings. 882should be a character not used by the strings.
852 883
853Its usage can be demonstrated by an example: 884Its usage can be demonstrated by an example:
854 885
855 URxvt.keysym.M-C-0x61: list|\e<M-C-|abc|> 886 URxvt.keysym.M-C-0x61: list|\033<M-C-|abc|>
856 887
857The above line is equivalent to the following three lines: 888The above line is equivalent to the following three lines:
858 889
859 URxvt.keysym.Meta-Control-0x61: \e<M-C-a> 890 URxvt.keysym.Meta-Control-0x61: \033<M-C-a>
860 URxvt.keysym.Meta-Control-0x62: \e<M-C-b> 891 URxvt.keysym.Meta-Control-0x62: \033<M-C-b>
861 URxvt.keysym.Meta-Control-0x63: \e<M-C-c> 892 URxvt.keysym.Meta-Control-0x63: \033<M-C-c>
862 893
863If I<string> takes the form of C<proto:STRING>, the specified B<STRING> is 894If I<string> takes the form of C<command:STRING>, the specified B<STRING>
864interpreted and executed as @@RXVT_NAME@@'s control sequence. For example, 895is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
865C<proto:\033]701;zh_CN.GBK\007> means: change the current locale to 896example the following means "change the current locale to C<zh_CN.GBK>
866C<zh_CN.GBK>. 897when Control-Meta-c is being pressed":
898
899 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
900
901The following example will map Control-Meta-1 and Control-Meta-2 to
902the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
903font-switching at runtime:
904
905 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
906 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007
907
908Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
909info):
910
911 URxvt.keysym.M-C-3: command:\033[8;25;80t
912 URxvt.keysym.M-C-4: command:\033[8;48;110t
867 913
868=back 914=back
869 915
870=head1 THE SCROLLBAR 916=head1 THE SCROLLBAR
871 917
… …
899 945
900=over 4 946=over 4
901 947
902=item B<Selection>: 948=item B<Selection>:
903 949
904Left click at the beginning of the region, drag to the end of the 950Left click at the beginning of the region, drag to the end of the region
905region and release; Right click to extend the marked region; Left 951and release; Right click to extend the marked region; Left double-click
906double-click to select a word; Left triple-click to select the entire 952to select a word; Left triple-click to select the entire logical line
907line. 953(which can span multiple screen lines), unless modified by resource
954B<tripleclickwords>.
908 955
909Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) 956Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
910(Compile: I<frills>) will create a rectangular selection instead of a normal 957(Compile: I<frills>) will create a rectangular selection instead of a normal
911one. 958one.
912 959
… …
938C<--enable-frills>, the rest is available when rxvt-unicode was compiled 985C<--enable-frills>, the rest is available when rxvt-unicode was compiled
939with C<--enable-iso14755>. 986with C<--enable-iso14755>.
940 987
941=over 4 988=over 4
942 989
943=item 5.1: Basic method 990=item * 5.1: Basic method
944 991
945This allows you to enter unicode characters using their hexcode. 992This allows you to enter unicode characters using their hexcode.
946 993
947Start by pressing and holding both C<Control> and C<Shift>, then enter 994Start by pressing and holding both C<Control> and C<Shift>, then enter
948hex-digits (between one and six). Releasing C<Control> and C<Shift> will 995hex-digits (between one and six). Releasing C<Control> and C<Shift> will
… …
955address, which you cannot type. Fortunately, the card has the e-mail 1002address, which you cannot type. Fortunately, the card has the e-mail
956address printed as hexcodes, e.g. C<671d 65e5>. You can enter this easily 1003address printed as hexcodes, e.g. C<671d 65e5>. You can enter this easily
957by pressing C<Control> and C<Shift>, followed by C<6-7-1-D-SPACE-6-5-E-5>, 1004by pressing C<Control> and C<Shift>, followed by C<6-7-1-D-SPACE-6-5-E-5>,
958followed by releasing the modifier keys. 1005followed by releasing the modifier keys.
959 1006
960=item 5.2: Keyboard symbols entry method 1007=item * 5.2: Keyboard symbols entry method
961 1008
962This mode lets you input characters representing the keycap symbols of 1009This mode lets you input characters representing the keycap symbols of
963your keyboard, if representable in the current locale encoding. 1010your keyboard, if representable in the current locale encoding.
964 1011
965Start by pressing C<Control> and C<Shift> together, then releasing 1012Start by pressing C<Control> and C<Shift> together, then releasing
… …
968keycap symbol. The symbol will only be entered when the key has been 1015keycap symbol. The symbol will only be entered when the key has been
969released, otherwise pressing e.g. C<Shift> would enter the symbol for 1016released, otherwise pressing e.g. C<Shift> would enter the symbol for
970C<ISO Level 2 Switch>, although your intention might have been to enter a 1017C<ISO Level 2 Switch>, although your intention might have been to enter a
971reverse tab (Shift-Tab). 1018reverse tab (Shift-Tab).
972 1019
973=item 5.3: Screen-selection entry method 1020=item * 5.3: Screen-selection entry method
974 1021
975While this is implemented already (it's basically the selection 1022While this is implemented already (it's basically the selection
976mechanism), it could be extended by displaying a unicode character map. 1023mechanism), it could be extended by displaying a unicode character map.
977 1024
978=item 5.4: Feedback method for identifying displayed characters for later input 1025=item * 5.4: Feedback method for identifying displayed characters for later input
979 1026
980This method lets you display the unicode character code associated with 1027This method lets you display the unicode character code associated with
981characters already displayed. 1028characters already displayed.
982 1029
983You enter this mode by holding down C<Control> and C<Shift> together, then 1030You enter this mode by holding down C<Control> and C<Shift> together, then
… …
995With respect to conformance, rxvt-unicode is supposed to be compliant to 1042With respect to conformance, rxvt-unicode is supposed to be compliant to
996both scenario A and B of ISO 14755, including part 5.2. 1043both scenario A and B of ISO 14755, including part 5.2.
997 1044
998=head1 LOGIN STAMP 1045=head1 LOGIN STAMP
999 1046
1000B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so 1047B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so that
1001that it can be seen via the I<who(1)> command, and can accept messages. 1048it can be seen via the I<who(1)> command, and can accept messages. To
1002To allow this feature, B<@@RXVT_NAME@@> must be installed setuid root on 1049allow this feature, B<@@RXVT_NAME@@> may need to be installed setuid root
1003some systems. 1050on some systems or setgid to root or to some other group on others.
1004 1051
1005=head1 COLORS AND GRAPHICS 1052=head1 COLORS AND GRAPHICS
1006 1053
1007In addition to the default foreground and background colours, 1054In addition to the default foreground and background colours,
1008B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus 1055B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
… …
1062 1109
1063=head1 FILES 1110=head1 FILES
1064 1111
1065=over 4 1112=over 4
1066 1113
1067=item B</etc/utmp>
1068
1069System file for login records.
1070
1071=item B</usr/lib/X11/rgb.txt> 1114=item B</usr/lib/X11/rgb.txt>
1072 1115
1073Color names. 1116Color names.
1074 1117
1075=back 1118=back

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines