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

Diff Legend

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