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.230 by sf-exg, Mon Apr 28 16:00:34 2014 UTC vs.
Revision 1.233 by sf-exg, Sat May 24 18:41:29 2014 UTC

… …
1085As with any resource value, the I<action> string may contain backslash 1085As with any resource value, the I<action> string may contain backslash
1086escape sequences (C<\n>: newline, C<\\>: backslash, C<\000>: octal 1086escape sequences (C<\n>: newline, C<\\>: backslash, C<\000>: octal
1087number), see RESOURCES in C<man 7 X> for further details. 1087number), see RESOURCES in C<man 7 X> for further details.
1088 1088
1089An action starts with an action prefix that selects a certain type 1089An action starts with an action prefix that selects a certain type
1090of action, followed by a colon. An action strings without colons is 1090of action, followed by a colon. An action string without colons is
1091interpreted as a literal string to pass to the tty (as if they were 1091interpreted as a literal string to pass to the tty (as if it was
1092prefixed with C<string:>). 1092prefixed with C<string:>).
1093 1093
1094The following action prefixes are known - extensions can provide 1094The following action prefixes are known - extensions can provide
1095additional prefixes: 1095additional prefixes:
1096 1096
… …
1193@@RXVT_NAME@@'s selection when Alt-Control-c is pressed on typical PC 1193@@RXVT_NAME@@'s selection when Alt-Control-c is pressed on typical PC
1194keyboards: 1194keyboards:
1195 1195
1196 URxvt.keysym.M-C-c: selection:rot13 1196 URxvt.keysym.M-C-c: selection:rot13
1197 1197
1198=item perl:STRING 1198=item perl:STRING *DEPRECATED*
1199 1199
1200This is a deprecated way of passing key mappings to perl extensions. It is 1200This is a deprecated way of passing key mappings to perl extensions. It is
1201still supported, but should not be used anymore. 1201still supported, but should not be used anymore.
1202 1202
1203=back 1203=back
1204
1205In addition, you can define a range of keysyms in one shot by loading
1206the C<keysym-list> perl extension and providing a I<string> with pattern
1207B<list/PREFIX/MIDDLE/SUFFIX>, where the delimiter `/' should be a
1208character not used by the strings.
1209
1210Its usage can be demonstrated by an example:
1211
1212 URxvt.keysym.M-C-0x61: list|\033<|abc|>
1213
1214The above line is equivalent to the following three lines:
1215
1216 URxvt.keysym.Meta-Control-0x61: \033<a>
1217 URxvt.keysym.Meta-Control-0x62: \033<b>
1218 URxvt.keysym.Meta-Control-0x63: \033<c>
1219 1204
1220=item B<perl-ext-common>: I<string> 1205=item B<perl-ext-common>: I<string>
1221 1206
1222=item B<perl-ext>: I<string> 1207=item B<perl-ext>: I<string>
1223 1208
… …
1225use in this terminal instance; option B<-pe>. 1210use in this terminal instance; option B<-pe>.
1226 1211
1227Extension names can be prefixed with a C<-> sign to prohibit using 1212Extension names can be prefixed with a C<-> sign to prohibit using
1228them. This can be useful to selectively disable some extensions loaded 1213them. This can be useful to selectively disable some extensions loaded
1229by default, or specified via the C<perl-ext-common> resource. For 1214by default, or specified via the C<perl-ext-common> resource. For
1230example, C<default,-selection> will use all the default extension except 1215example, C<default,-selection> will use all the default extensions except
1231C<selection>. 1216C<selection>.
1232 1217
1233Extension names can also be followed by an argument in angle brackets 1218The default set includes the C<selection>, C<option-popup>,
1234(e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for 1219C<selection-popup> and C<readline> extensions, any extensions that define
1235searchable scrollback to Alt/Meta-s). Mentioning the same extension 1220keybindings via C<BINDING> meta comments, extensions loaded because
1236multiple times with different arguments will pass multiple arguments to 1221their resources/commandline switches were used, and extensions which are
1237the extension. 1222mentioned in B<keysym> resources.
1238 1223
1239Each extension is looked up in the library directories, loaded if 1224Each extension is looked up in the library directories, loaded if
1240necessary, and bound to the current terminal instance. 1225necessary, and bound to the current terminal instance. When the library
1226search path contains multiple extension files of the same name, then the
1227first one found will be used.
1241 1228
1242If both of these resources are the empty string, then the perl 1229If both of these resources are the empty string, then the perl interpreter
1243interpreter will not be initialized. The idea behind two options is that 1230will not be initialized. The rationale for having two options is that
1244B<perl-ext-common> will be used for extensions that should be available to 1231B<perl-ext-common> will be used for extensions that should be available to
1245all instances, while B<perl-ext> is used for specific instances. 1232all instances, while B<perl-ext> is used for specific instances.
1246 1233
1247=item B<perl-eval>: I<string> 1234=item B<perl-eval>: I<string>
1248 1235
… …
1266=item B<< selection-autotransform.I<idx> >>: I<perl-transform> 1253=item B<< selection-autotransform.I<idx> >>: I<perl-transform>
1267 1254
1268Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage 1255Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage
1269for details. 1256for details.
1270 1257
1271=item B<searchable-scrollback:> I<keysym> 1258=item B<searchable-scrollback:> I<keysym> *DEPRECATED*
1272 1259
1273Sets the hotkey that starts the incremental scrollback buffer search 1260This resource is deprecated and will be removed. Use a B<keysym> resource
1274(default: C<M-s>). 1261instead, e.g.:
1262
1263 URxvt.keysym.M-s: searchable-scrollback:start
1275 1264
1276=item B<url-launcher>: I<string> 1265=item B<url-launcher>: I<string>
1277 1266
1278Specifies the program to be started with a URL argument. Used by the 1267Specifies the program to be started with a URL argument. Used by the
1279C<selection-popup> and C<matcher> perl extensions. 1268C<selection-popup> and C<matcher> perl extensions.

Diff Legend

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