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.69 by root, Tue Oct 25 19:04:45 2005 UTC vs.
Revision 1.76 by root, Sat Dec 31 16:06:48 2005 UTC

124is black. resource B<fadeColor>. 124is black. resource B<fadeColor>.
125 125
126=item B<-tint> I<colour> 126=item B<-tint> I<colour>
127 127
128Tint the transparent background pixmap with the given colour when 128Tint the transparent background pixmap with the given colour when
129transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> 129transparency is enabled with B<-tr> or B<-ip>. This only works for
130option that can be used to brighten or darken the image in addition to 130non-tiled backgrounds, currently. See also the B<-sh> option that can be
131tinting it; resource I<tintColor>. Example: 131used to brighten or darken the image in addition to tinting it; resource
132I<tintColor>. Example:
132 133
133 @@RXVT_NAME@@ -tr -tint blue -sh 40 134 @@RXVT_NAME@@ -tr -tint blue -sh 40
134 135
135=item B<-sh> 136=item B<-sh>
136 137
200 201
201=item B<-fbi> I<fontlist> 202=item B<-fbi> I<fontlist>
202 203
203Compile font-styles: The bold italic font list to use when bold characters are to 204Compile font-styles: The bold italic font list to use when bold characters are to
204be printed. See resource B<boldItalicFont> for details. 205be printed. See resource B<boldItalicFont> for details.
206
207=item B<-is>|B<+is>
208
209Compile font-styles: Bold/Italic font styles imply high intensity
210foreground/background (default). See resource B<intensityStyles> for
211details.
205 212
206=item B<-name> I<name> 213=item B<-name> I<name>
207 214
208Specify the application name under which resources are to be obtained, 215Specify the application name under which resources are to be obtained,
209rather than the default executable file name. Name should not contain 216rather than the default executable file name. Name should not contain
312given on the command line. If this option is used, it must be the last 319given on the command line. If this option is used, it must be the last
313on the command-line. If there is no B<-e> option then the default is to 320on the command-line. If there is no B<-e> option then the default is to
314run the program specified by the B<SHELL> environment variable or, 321run the program specified by the B<SHELL> environment variable or,
315failing that, I<sh(1)>. 322failing that, I<sh(1)>.
316 323
324Please note that you must specify a program with arguments. If you want to
325run shell commands, you have to specify the shell, like this:
326
327 @@RXVT_NAME@@ -e sh -c "shell commands"
328
317=item B<-title> I<text> 329=item B<-title> I<text>
318 330
319Window title (B<-T> still respected); the default title is the basename 331Window title (B<-T> still respected); the default title is the basename
320of the program specified after the B<-e> option, if any, otherwise the 332of the program specified after the B<-e> option, if any, otherwise the
321application name; resource B<title>. 333application name; resource B<title>.
376 388
377=item B<-ssr>|B<+ssr> 389=item B<-ssr>|B<+ssr>
378 390
379Turn on/off secondary screen scroll (default enabled); resource 391Turn on/off secondary screen scroll (default enabled); resource
380B<secondaryScroll>. 392B<secondaryScroll>.
393
394=item B<-hold>|B<+hold>
395
396Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
397will not immediately destroy its window when the program executed within
398it exits. Instead, it will wait till it is being killed or closed by the
399user; resource B<hold>.
381 400
382=item B<-keysym.>I<sym> I<string> 401=item B<-keysym.>I<sym> I<string>
383 402
384Remap a key symbol. See resource B<keysym>. 403Remap a key symbol. See resource B<keysym>.
385 404
674not possible, replacement fonts of the desired shape will be tried. 693not possible, replacement fonts of the desired shape will be tried.
675 694
676If set, but empty, then this specific style is disabled and the normal 695If set, but empty, then this specific style is disabled and the normal
677text font will being used for the given style. 696text font will being used for the given style.
678 697
698=item B<intensityStyles:> I<boolean>
699
700When font styles are not enabled, or this option is enabled (B<True>,
701option B<-is>, the default), bold and italic font styles imply high
702intensity foreground/backround colours. Disabling this option (B<False>,
703option B<+is>) disables this behaviour, the high intensity colours are not
704reachable.
705
679=item B<selectstyle:> I<mode> 706=item B<selectstyle:> I<mode>
680 707
681Set mouse selection style to B<old> which is 2.20, B<oldword> which is 708Set mouse selection style to B<old> which is 2.20, B<oldword> which is
682xterm style with 2.20 old word selection, or anything else which gives 709xterm style with 2.20 old word selection, or anything else which gives
683xterm style selection. 710xterm style selection.
897=item B<insecure:> I<boolean> 924=item B<insecure:> I<boolean>
898 925
899Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 926Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
900echo arbitrary strings like the icon name or the locale. This could be 927echo arbitrary strings like the icon name or the locale. This could be
901abused if somebody gets 8-bit-clean access to your display, whether 928abused if somebody gets 8-bit-clean access to your display, whether
902throuh a mail client displaying mail bodies unfiltered or though 929through a mail client displaying mail bodies unfiltered or through
903write(1). Therefore, these sequences are disabled by default. (Note 930write(1) or any other means. Therefore, these sequences are disabled by
904that other terminals, including xterm, have these sequences 931default. (Note that many other terminals, including xterm, have these
905enabled by default). You can enable them by setting this boolean 932sequences enabled by default, which doesn't make it safer, though).
906resource or specifying B<-insecure> as an option. At the moment, this 933
907enabled display-answer, locale, findfont, icon label and window title 934You can enable them by setting this boolean resource or specifying
908requests as well as dynamic menubar dispatch. 935B<-insecure> as an option. At the moment, this enables display-answer,
936locale, findfont, icon label and window title requests as well as dynamic
937menubar dispatch.
909 938
910=item B<modifier:> I<modifier> 939=item B<modifier:> I<modifier>
911 940
912Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, 941Set the key to be interpreted as the Meta key to: B<alt>, B<meta>,
913B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option 942B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
927 956
928Turn on/off secondary screen scroll (default enabled). If the this 957Turn on/off secondary screen scroll (default enabled). If the this
929option is enabled, scrolls on the secondary screen will change the 958option is enabled, scrolls on the secondary screen will change the
930scrollback buffer and switching to/from the secondary screen will 959scrollback buffer and switching to/from the secondary screen will
931instead scroll the screen up. 960instead scroll the screen up.
961
962=item B<hold>: I<bool>
963
964Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
965will not immediately destroy its window when the program executed within
966it exits. Instead, it will wait till it is being killed or closed by the
967user.
932 968
933=item B<keysym.>I<sym>: I<string> 969=item B<keysym.>I<sym>: I<string>
934 970
935Compile I<frills>: Associate I<string> with keysym I<sym>. The 971Compile I<frills>: Associate I<string> with keysym I<sym>. The
936intervening resource name B<keysym.> cannot be omitted. 972intervening resource name B<keysym.> cannot be omitted.
1057to select a word; Left triple-click to select the entire logical line 1093to select a word; Left triple-click to select the entire logical line
1058(which can span multiple screen lines), unless modified by resource 1094(which can span multiple screen lines), unless modified by resource
1059B<tripleclickwords>. 1095B<tripleclickwords>.
1060 1096
1061Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) 1097Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
1062(Compile: I<frills>) will create a rectangular selection instead of a normal 1098(Compile: I<frills>) will create a rectangular selection instead of a
1063one. 1099normal one. In this mode, every selected row becomes its own line in the
1100selection, and trailing whitespace is visually underlined and removed from
1101the selection.
1064 1102
1065=item B<Insertion>: 1103=item B<Insertion>:
1066 1104
1067Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1105Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
1068an B<@@RXVT_NAME@@> window causes the current text selection to be 1106an B<@@RXVT_NAME@@> window causes the current text selection to be
1076supported in rxvt-unicode. Bug me if you need this. 1114supported in rxvt-unicode. Bug me if you need this.
1077 1115
1078You can, however, switch fonts at runtime using escape sequences (and 1116You can, however, switch fonts at runtime using escape sequences (and
1079therefore using the menubar), e.g.: 1117therefore using the menubar), e.g.:
1080 1118
1081 printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" 1119 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
1082 1120
1083rxvt-unicode will automatically re-apply these fonts to the output so far. 1121rxvt-unicode will automatically re-apply these fonts to the output so far.
1084 1122
1085=head1 ISO 14755 SUPPORT 1123=head1 ISO 14755 SUPPORT
1086 1124
1295 1333
1296=head1 SEE ALSO 1334=head1 SEE ALSO
1297 1335
1298@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) 1336@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1299 1337
1300=head1 BUGS
1301
1302Check the BUGS file for an up-to-date list.
1303
1304Cursor change support is not yet implemented.
1305
1306Click-and-drag doesn't work with X11 mouse report overriding.
1307
1308=head1 CURRENT PROJECT COORDINATOR 1338=head1 CURRENT PROJECT COORDINATOR
1309 1339
1310=over 4 1340=over 4
1311 1341
1312=item Project Coordinator 1342=item Project Coordinator

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines