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.235 by mikachu, Tue Jul 29 13:50:05 2014 UTC vs.
Revision 1.240 by sf-exg, Mon Oct 13 17:05:32 2014 UTC

… …
219 219
220=item B<-ls>|B<+ls> 220=item B<-ls>|B<+ls>
221 221
222Start as a login-shell/sub-shell; resource B<loginShell>. 222Start as a login-shell/sub-shell; resource B<loginShell>.
223 223
224=item B<-mc> I<milliseconds>
225
226Specify the maximum time between multi-click selections.
227
224=item B<-ut>|B<+ut> 228=item B<-ut>|B<+ut>
225 229
226Compile I<utmp>: Inhibit/enable writing a utmp entry; resource 230Compile I<utmp>: Inhibit/enable writing a utmp entry; resource
227B<utmpInhibit>. 231B<utmpInhibit>.
228 232
… …
786 790
787B<True>: start as a login shell by prepending a `-' to B<argv[0]> of 791B<True>: start as a login shell by prepending a `-' to B<argv[0]> of
788the shell; option B<-ls>. B<False>: start as a normal sub-shell 792the shell; option B<-ls>. B<False>: start as a normal sub-shell
789[default]; option B<+ls>. 793[default]; option B<+ls>.
790 794
795=item B<multiClickTime:> I<number>
796
797Specify the maximum time in milliseconds between multi-click select
798events. The default is 500 milliseconds; option B<-mc>.
799
791=item B<utmpInhibit:> I<boolean> 800=item B<utmpInhibit:> I<boolean>
792 801
793B<True>: inhibit writing record into the system log file B<utmp>; 802B<True>: inhibit writing record into the system log file B<utmp>;
794option B<-ut>. B<False>: write record into the system log file B<utmp> 803option B<-ut>. B<False>: write record into the system log file B<utmp>
795[default]; option B<+ut>. 804[default]; option B<+ut>.
… …
1110 1119
1111 URxvt.keysym.Shift-Tab: string:echo rm -rf /\n 1120 URxvt.keysym.Shift-Tab: string:echo rm -rf /\n
1112 1121
1113This could in theory be used to completely redefine your keymap. 1122This could in theory be used to completely redefine your keymap.
1114 1123
1124In addition, for actions of this type, you can define a range of
1125keysyms in one shot by loading the C<keysym-list> perl extension and
1126providing an I<action> with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where
1127the delimiter `/' should be a character not used by the strings.
1128
1129Its usage can be demonstrated by an example:
1130
1131 URxvt.keysym.M-C-0x61: list|\033<|abc|>
1132
1133The above line is equivalent to the following three lines:
1134
1135 URxvt.keysym.Meta-Control-0x61: string:\033<a>
1136 URxvt.keysym.Meta-Control-0x62: string:\033<b>
1137 URxvt.keysym.Meta-Control-0x63: string:\033<c>
1138
1115=item command:STRING 1139=item command:STRING
1116 1140
1117If I<action> takes the form of C<command:STRING>, the specified B<STRING> 1141If I<action> takes the form of C<command:STRING>, the specified B<STRING>
1118is interpreted and executed as @@RXVT_NAME@@'s control sequence (basically 1142is interpreted and executed as @@RXVT_NAME@@'s control sequence (basically
1119the opposite of C<string:> - instead of sending it to the program running 1143the opposite of C<string:> - instead of sending it to the program running
… …
1178 1202
1179Similarly, to let applications gain access to the C<C-M-c> (copy to 1203Similarly, to let applications gain access to the C<C-M-c> (copy to
1180clipboard) and C<C-M-v> (paste clipboard) key combination, you can do 1204clipboard) and C<C-M-v> (paste clipboard) key combination, you can do
1181this: 1205this:
1182 1206
1183 URxvt.keysym.C-S-c: builtin-string: 1207 URxvt.keysym.C-M-c: builtin-string:
1184 URxvt.keysym.C-S-v: builtin-string: 1208 URxvt.keysym.C-M-v: builtin-string:
1185 1209
1186=item EXTENSION:STRING 1210=item EXTENSION:STRING
1187 1211
1188An action of this form passes the B<STRING> to the @@RXVT_NAME@@perl(3) 1212An action of this form invokes the action B<STRING>, if any, provided
1189extension of the same name. The extension will be loaded automatically if 1213by the @@RXVT_NAME@@perl(3) extension B<EXTENSION>. The extension will
1190necessary. 1214be loaded automatically if necessary.
1191 1215
1192Not all extensions define key actions, but popular extensions that do 1216Not all extensions define actions, but popular extensions that do
1193include the I<selection> and I<matcher> extensions (documented in their 1217include the I<selection> and I<matcher> extensions (documented in their
1194own manpages, @@RXVT_NAME@@-selection(1) and @@RXVT_NAME@@-matcher(1), 1218own manpages, @@RXVT_NAME@@-selection(1) and @@RXVT_NAME@@-matcher(1),
1195respectively). 1219respectively).
1196 1220
1197From the silly examples department, this will rot13-"encrypt" 1221From the silly examples department, this will rot13-"encrypt"
… …
1200 1224
1201 URxvt.keysym.M-C-c: selection:rot13 1225 URxvt.keysym.M-C-c: selection:rot13
1202 1226
1203=item perl:STRING *DEPRECATED* 1227=item perl:STRING *DEPRECATED*
1204 1228
1205This is a deprecated way of passing key mappings to perl extensions. It is 1229This is a deprecated way of invoking commands provided by perl
1206still supported, but should not be used anymore. 1230extensions. It is still supported, but should not be used anymore.
1207 1231
1208=back 1232=back
1209 1233
1210=item B<perl-ext-common>: I<string> 1234=item B<perl-ext-common>: I<string>
1211 1235
… …
1219by default, or specified via the C<perl-ext-common> resource. For 1243by default, or specified via the C<perl-ext-common> resource. For
1220example, C<default,-selection> will use all the default extensions except 1244example, C<default,-selection> will use all the default extensions except
1221C<selection>. 1245C<selection>.
1222 1246
1223The default set includes the C<selection>, C<option-popup>, 1247The default set includes the C<selection>, C<option-popup>,
1224C<selection-popup> and C<readline> extensions, any extensions that define 1248C<selection-popup> and C<readline> extensions, any extensions that
1225keybindings via C<BINDING> meta comments, extensions loaded because 1249define keybindings via C<BINDING> meta comments, and extensions which
1226their resources/commandline switches were used, and extensions which are
1227mentioned in B<keysym> resources. 1250are mentioned in B<keysym> resources.
1251
1252Any extension such that a corresponding resource is given on the
1253command line is automatically appended to B<perl-ext>.
1228 1254
1229Each extension is looked up in the library directories, loaded if 1255Each extension is looked up in the library directories, loaded if
1230necessary, and bound to the current terminal instance. When the library 1256necessary, and bound to the current terminal instance. When the library
1231search path contains multiple extension files of the same name, then the 1257search path contains multiple extension files of the same name, then the
1232first one found will be used. 1258first one found will be used.

Diff Legend

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