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.236 by sf-exg, Sat Aug 16 10:51:23 2014 UTC vs.
Revision 1.243 by root, Sat May 30 21:02:05 2015 UTC

108of graphical corruption. This is harmless, but we can't do anything about 108of graphical corruption. This is harmless, but we can't do anything about
109this, so watch out] 109this, so watch out]
110 110
111=item B<-visual> I<visualID> 111=item B<-visual> I<visualID>
112 112
113Compile I<frills>: Use the given visual (see e.g. C<xdpyinfo> for possible 113Compile I<frills>: Use the given visual (see e.g. C<xdpyinfo> for
114visual ids). 114possible visual ids) instead of the default, and also allocate a private
115colormap. All visual types except for DirectColor are supported.
115 116
116=item B<-geometry> I<geom> 117=item B<-geometry> I<geom>
117 118
118Window geometry (B<-g> still respected); resource B<geometry>. 119Window geometry (B<-g> still respected); resource B<geometry>.
119 120
378 379
379=item B<-pt> I<style> 380=item B<-pt> I<style>
380 381
381Compile I<XIM>: input style for input method; B<OverTheSpot>, 382Compile I<XIM>: input style for input method; B<OverTheSpot>,
382B<OffTheSpot>, B<Root>; resource B<preeditType>. 383B<OffTheSpot>, B<Root>; resource B<preeditType>.
384
385If the perl extension C<xim-onthespot> is used (which is the default),
386then additionally the C<OnTheSpot> preedit type is available.
383 387
384=item B<-im> I<text> 388=item B<-im> I<text>
385 389
386Compile I<XIM>: input method name. resource B<inputMethod>. 390Compile I<XIM>: input method name. resource B<inputMethod>.
387 391
976 980
977B<< BACKSLASH `"'&()*,;<=>?@[]^{|} >> 981B<< BACKSLASH `"'&()*,;<=>?@[]^{|} >>
978 982
979=item B<preeditType:> I<style> 983=item B<preeditType:> I<style>
980 984
981B<OverTheSpot>, B<OffTheSpot>, B<Root>; option B<-pt>. 985B<OnTheSpot>, B<OverTheSpot>, B<OffTheSpot>, B<Root>; option B<-pt>.
982 986
983=item B<inputMethod:> I<name> 987=item B<inputMethod:> I<name>
984 988
985I<name> of inputMethod to use; option B<-im>. 989I<name> of inputMethod to use; option B<-im>.
986 990
1119 1123
1120 URxvt.keysym.Shift-Tab: string:echo rm -rf /\n 1124 URxvt.keysym.Shift-Tab: string:echo rm -rf /\n
1121 1125
1122This could in theory be used to completely redefine your keymap. 1126This could in theory be used to completely redefine your keymap.
1123 1127
1128In addition, for actions of this type, you can define a range of
1129keysyms in one shot by loading the C<keysym-list> perl extension and
1130providing an I<action> with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where
1131the delimiter `/' should be a character not used by the strings.
1132
1133Its usage can be demonstrated by an example:
1134
1135 URxvt.keysym.M-C-0x61: list|\033<|abc|>
1136
1137The above line is equivalent to the following three lines:
1138
1139 URxvt.keysym.Meta-Control-0x61: string:\033<a>
1140 URxvt.keysym.Meta-Control-0x62: string:\033<b>
1141 URxvt.keysym.Meta-Control-0x63: string:\033<c>
1142
1124=item command:STRING 1143=item command:STRING
1125 1144
1126If I<action> takes the form of C<command:STRING>, the specified B<STRING> 1145If I<action> takes the form of C<command:STRING>, the specified B<STRING>
1127is interpreted and executed as @@RXVT_NAME@@'s control sequence (basically 1146is interpreted and executed as @@RXVT_NAME@@'s control sequence (basically
1128the opposite of C<string:> - instead of sending it to the program running 1147the opposite of C<string:> - instead of sending it to the program running
1187 1206
1188Similarly, to let applications gain access to the C<C-M-c> (copy to 1207Similarly, to let applications gain access to the C<C-M-c> (copy to
1189clipboard) and C<C-M-v> (paste clipboard) key combination, you can do 1208clipboard) and C<C-M-v> (paste clipboard) key combination, you can do
1190this: 1209this:
1191 1210
1192 URxvt.keysym.C-S-c: builtin-string: 1211 URxvt.keysym.C-M-c: builtin-string:
1193 URxvt.keysym.C-S-v: builtin-string: 1212 URxvt.keysym.C-M-v: builtin-string:
1194 1213
1195=item EXTENSION:STRING 1214=item EXTENSION:STRING
1196 1215
1197An action of this form passes the B<STRING> to the @@RXVT_NAME@@perl(3) 1216An action of this form invokes the action B<STRING>, if any, provided
1198extension of the same name. The extension will be loaded automatically if 1217by the @@RXVT_NAME@@perl(3) extension B<EXTENSION>. The extension will
1199necessary. 1218be loaded automatically if necessary.
1200 1219
1201Not all extensions define key actions, but popular extensions that do 1220Not all extensions define actions, but popular extensions that do
1202include the I<selection> and I<matcher> extensions (documented in their 1221include the I<selection> and I<matcher> extensions (documented in their
1203own manpages, @@RXVT_NAME@@-selection(1) and @@RXVT_NAME@@-matcher(1), 1222own manpages, @@RXVT_NAME@@-selection(1) and @@RXVT_NAME@@-matcher(1),
1204respectively). 1223respectively).
1205 1224
1206From the silly examples department, this will rot13-"encrypt" 1225From the silly examples department, this will rot13-"encrypt"
1209 1228
1210 URxvt.keysym.M-C-c: selection:rot13 1229 URxvt.keysym.M-C-c: selection:rot13
1211 1230
1212=item perl:STRING *DEPRECATED* 1231=item perl:STRING *DEPRECATED*
1213 1232
1214This is a deprecated way of passing key mappings to perl extensions. It is 1233This is a deprecated way of invoking commands provided by perl
1215still supported, but should not be used anymore. 1234extensions. It is still supported, but should not be used anymore.
1216 1235
1217=back 1236=back
1218 1237
1219=item B<perl-ext-common>: I<string> 1238=item B<perl-ext-common>: I<string>
1220 1239
1228by default, or specified via the C<perl-ext-common> resource. For 1247by default, or specified via the C<perl-ext-common> resource. For
1229example, C<default,-selection> will use all the default extensions except 1248example, C<default,-selection> will use all the default extensions except
1230C<selection>. 1249C<selection>.
1231 1250
1232The default set includes the C<selection>, C<option-popup>, 1251The default set includes the C<selection>, C<option-popup>,
1233C<selection-popup> and C<readline> extensions, any extensions that define 1252C<selection-popup>, C<readline> and C<searchable-scrollback>
1234keybindings via C<BINDING> meta comments, extensions loaded because 1253extensions, and extensions which are mentioned in B<keysym> resources.
1235their resources/commandline switches were used, and extensions which are 1254
1236mentioned in B<keysym> resources. 1255Any extension such that a corresponding resource is given on the
1256command line is automatically appended to B<perl-ext>.
1237 1257
1238Each extension is looked up in the library directories, loaded if 1258Each extension is looked up in the library directories, loaded if
1239necessary, and bound to the current terminal instance. When the library 1259necessary, and bound to the current terminal instance. When the library
1240search path contains multiple extension files of the same name, then the 1260search path contains multiple extension files of the same name, then the
1241first one found will be used. 1261first one found will be used.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines