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.156 by ayin, Sun Dec 30 22:43:40 2007 UTC vs.
Revision 1.168 by root, Tue Nov 4 11:03:29 2008 UTC

92 92
93Print out a message describing available options. 93Print out a message describing available options.
94 94
95=item B<-display> I<displayname> 95=item B<-display> I<displayname>
96 96
97Attempt to open a window on the named X display (B<-d> still 97Attempt to open a window on the named X display (the older form B<-d>
98respected). In the absence of this option, the display specified by the 98is still respected. but deprecated). In the absence of this option, the
99B<DISPLAY> environment variable is used. 99display specified by the B<DISPLAY> environment variable is used.
100 100
101=item B<-depth> I<bitdepth> 101=item B<-depth> I<bitdepth>
102 102
103Compile I<xft>: Attempt to find a visual with the given bit depth; 103Compile I<xft>: Attempt to find a visual with the given bit depth;
104resource B<depth>. 104resource B<depth>.
105
106[Please note that many X servers (and libXft) are buggy with
107respect to C<-depth 32> and/or alpha channels, and will cause all sorts
108of graphical corruption. This is harmless, but we can't do anything about
109this, so watch out]
105 110
106=item B<-geometry> I<geom> 111=item B<-geometry> I<geom>
107 112
108Window geometry (B<-g> still respected); resource B<geometry>. 113Window geometry (B<-g> still respected); resource B<geometry>.
109 114
177horizontal radii are considered to be the same. Setting one of the 182horizontal radii are considered to be the same. Setting one of the
178radii to 1 and another to a large number creates interesting effects 183radii to 1 and another to a large number creates interesting effects
179on some backgrounds. Maximum radius value is 128. Compile I<afterimage>; 184on some backgrounds. Maximum radius value is 128. Compile I<afterimage>;
180resource I<blurRadius>. 185resource I<blurRadius>.
181 186
187=item B<-icon> I<file>
188
189Compile I<afterimage>: Use the specified image as application icon. This
190is used by many window managers, taskbars and pagers to represent the
191appliation window; resource I<iconFile>.
192
182=item B<-bg> I<colour> 193=item B<-bg> I<colour>
183 194
184Window background colour; resource B<background>. 195Window background colour; resource B<background>.
185 196
186=item B<-fg> I<colour> 197=item B<-fg> I<colour>
273 284
274=item B<-sb>|B<+sb> 285=item B<-sb>|B<+sb>
275 286
276Turn on/off scrollbar; resource B<scrollBar>. 287Turn on/off scrollbar; resource B<scrollBar>.
277 288
289=item B<-sr>|B<+sr>
290
291Put scrollbar on right/left; resource B<scrollBar_right>.
292
293=item B<-st>|B<+st>
294
295Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
296resource B<scrollBar_floating>.
297
278=item B<-si>|B<+si> 298=item B<-si>|B<+si>
279 299
280Turn on/off scroll-to-bottom on TTY output inhibit; resource 300Turn on/off scroll-to-bottom on TTY output inhibit; resource
281B<scrollTtyOutput> has opposite effect. 301B<scrollTtyOutput> has opposite effect.
282 302
288=item B<-sw>|B<+sw> 308=item B<-sw>|B<+sw>
289 309
290Turn on/off scrolling with the scrollback buffer as new lines appear. 310Turn on/off scrolling with the scrollback buffer as new lines appear.
291This only takes effect if B<-si> is also given; resource 311This only takes effect if B<-si> is also given; resource
292B<scrollWithBuffer>. 312B<scrollWithBuffer>.
293
294=item B<-sr>|B<+sr>
295
296Put scrollbar on right/left; resource B<scrollBar_right>.
297
298=item B<-st>|B<+st>
299
300Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
301resource B<scrollBar_floating>.
302 313
303=item B<-ptab>|B<+ptab> 314=item B<-ptab>|B<+ptab>
304 315
305If enabled (default), "Horizontal Tab" characters are being stored as 316If enabled (default), "Horizontal Tab" characters are being stored as
306actual wide characters in the screen buffer, which makes it possible to 317actual wide characters in the screen buffer, which makes it possible to
335 346
336=item B<-bl> 347=item B<-bl>
337 348
338Compile I<frills>: Set MWM hints to request a borderless window, i.e. 349Compile I<frills>: Set MWM hints to request a borderless window, i.e.
339if honoured by the WM, the rxvt-unicode window will not have window 350if honoured by the WM, the rxvt-unicode window will not have window
340decorations; resource B<borderLess>. 351decorations; resource B<borderLess>. If the window manager does not
352support MWM hints (e.g. kwin), enables override-redirect mode.
341 353
342=item B<-override-redirect> 354=item B<-override-redirect>
343 355
344Compile I<frills>: Sets override-redirect on the window; resource 356Compile I<frills>: Sets override-redirect on the window; resource
345B<override-redirect>. 357B<override-redirect>.
449 461
450Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 462Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
451will not immediately destroy its window when the program executed within 463will not immediately destroy its window when the program executed within
452it exits. Instead, it will wait till it is being killed or closed by the 464it exits. Instead, it will wait till it is being killed or closed by the
453user; resource B<hold>. 465user; resource B<hold>.
466
467=item B<-cd> I<path>
468
469Sets the working directory for the shell (or the command specified via
470B<-e>). The I<path> must be an absolute path and it must exist for
471@@RXVT_NAME@@ to start; resource B<chdir>.
454 472
455=item B<-xrm> I<string> 473=item B<-xrm> I<string>
456 474
457Works like the X Toolkit option of the same name, by adding the I<string> 475Works like the X Toolkit option of the same name, by adding the I<string>
458as if it were specified in a resource file. Resource values specified this 476as if it were specified in a resource file. Resource values specified this
567=item B<depth:> I<bitdepth> 585=item B<depth:> I<bitdepth>
568 586
569Compile I<xft>: Attempt to find a visual with the given bit depth; 587Compile I<xft>: Attempt to find a visual with the given bit depth;
570option B<-depth>. 588option B<-depth>.
571 589
590=item B<buffered:> I<boolean>
591
592Compile I<xft>: Turn on/off double-buffering for xft (default enabled).
593On some card/driver combination enabling it slightly decreases
594performance, on most it greatly helps it. The slowdown is small, so it
595should normally be enabled.
596
572=item B<geometry:> I<geom> 597=item B<geometry:> I<geom>
573 598
574Create the window with the specified X window geometry [default 80x24]; 599Create the window with the specified X window geometry [default 80x24];
575option B<-geometry>. 600option B<-geometry>.
576 601
694 719
695Specify background blending type; option B<-blt>. 720Specify background blending type; option B<-blt>.
696 721
697=item B<blurRadius:> I<number> 722=item B<blurRadius:> I<number>
698 723
699Apply Gaussian Blurr with the specified radius to the transparent 724Apply gaussian blur with the specified radius to the transparent
700background image; option B<-blr>. 725background image; option B<-blr>.
726
727=item B<iconFile:> I<file>
728
729Set the application icon pixmap; option B<-icon>.
701 730
702=item B<scrollColor:> I<colour> 731=item B<scrollColor:> I<colour>
703 732
704Use the specified colour for the scrollbar [default #B2B2B2]. 733Use the specified colour for the scrollbar [default #B2B2B2].
705 734
811option B<-is>, the default), bold/blink font styles imply high 840option B<-is>, the default), bold/blink font styles imply high
812intensity foreground/background colours. Disabling this option (B<False>, 841intensity foreground/background colours. Disabling this option (B<False>,
813option B<+is>) disables this behaviour, the high intensity colours are not 842option B<+is>) disables this behaviour, the high intensity colours are not
814reachable. 843reachable.
815 844
816=item B<scrollstyle:> I<mode>
817
818Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
819the author's favourite.
820
821=item B<title:> I<string> 845=item B<title:> I<string>
822 846
823Set window title string, the default title is the command-line 847Set window title string, the default title is the command-line
824specified after the B<-e> option, if any, otherwise the application 848specified after the B<-e> option, if any, otherwise the application
825name; option B<-title>. 849name; option B<-title>.
838=item B<urgentOnBell:> I<boolean> 862=item B<urgentOnBell:> I<boolean>
839 863
840B<True>: set the urgency hint for the wm on receipt of a bell character. 864B<True>: set the urgency hint for the wm on receipt of a bell character.
841B<False>: do not set the urgency hint [default]. 865B<False>: do not set the urgency hint [default].
842 866
867@@RXVT_NAME@@ resets the urgency hint on every focus change.
868
843=item B<visualBell:> I<boolean> 869=item B<visualBell:> I<boolean>
844 870
845B<True>: use visual bell on receipt of a bell character; option B<-vb>. 871B<True>: use visual bell on receipt of a bell character; option B<-vb>.
846B<False>: no visual bell [default]; option B<+vb>. 872B<False>: no visual bell [default]; option B<+vb>.
847 873
869 895
870 URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) 896 URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
871 897
872This creates a new file in your home directory with the screen contents 898This creates a new file in your home directory with the screen contents
873every time you hit C<Print>. 899every time you hit C<Print>.
900
901=item B<scrollstyle:> I<mode>
902
903Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
904the author's favourite.
874 905
875=item B<scrollBar:> I<boolean> 906=item B<scrollBar:> I<boolean>
876 907
877B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: 908B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
878disable the scrollbar; option B<+sb>. 909disable the scrollbar; option B<+sb>.
1077 1108
1078=item B<secondaryScroll:> I<boolean> 1109=item B<secondaryScroll:> I<boolean>
1079 1110
1080Turn on/off secondary screen scroll (default enabled). If this 1111Turn on/off secondary screen scroll (default enabled). If this
1081option is enabled, scrolls on the secondary screen will change the 1112option is enabled, scrolls on the secondary screen will change the
1082scrollback buffer and switching to/from the secondary screen will 1113scrollback buffer and, when secondaryScreen is off, switching
1083instead scroll the screen up. 1114to/from the secondary screen will instead scroll the screen up.
1084 1115
1085=item B<hold>: I<boolean> 1116=item B<hold>: I<boolean>
1086 1117
1087Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 1118Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
1088will not immediately destroy its window when the program executed within 1119will not immediately destroy its window when the program executed within
1089it exits. Instead, it will wait till it is being killed or closed by the 1120it exits. Instead, it will wait till it is being killed or closed by the
1090user. 1121user.
1122
1123=item B<chdir>: I<path>
1124
1125Sets the working directory for the shell (or the command specified via
1126B<-e>). The I<path> must be an absolute path and it must exist for
1127@@RXVT_NAME@@ to start. If it isn't specified then the current working
1128directory will be used; option B<-cd>.
1091 1129
1092=item B<keysym.>I<sym>: I<string> 1130=item B<keysym.>I<sym>: I<string>
1093 1131
1094Compile I<frills>: Associate I<string> with keysym I<sym>. The 1132Compile I<frills>: Associate I<string> with keysym I<sym>. The
1095intervening resource name B<keysym.> cannot be omitted. 1133intervening resource name B<keysym.> cannot be omitted.
1202all instances, while B<perl-ext> is used for specific instances. 1240all instances, while B<perl-ext> is used for specific instances.
1203 1241
1204=item B<perl-eval>: I<string> 1242=item B<perl-eval>: I<string>
1205 1243
1206Perl code to be evaluated when all extensions have been registered. See 1244Perl code to be evaluated when all extensions have been registered. See
1207the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource 1245the @@RXVT_NAME@@perl(3) manpage.
1208will be ignored when running setuid/setgid.
1209 1246
1210=item B<perl-lib>: I<path> 1247=item B<perl-lib>: I<path>
1211 1248
1212Colon-separated list of additional directories that hold extension 1249Colon-separated list of additional directories that hold extension
1213scripts. When looking for extensions specified by the C<perl> resource, 1250scripts. When looking for extensions specified by the C<perl> resource,
1214@@RXVT_NAME@@ will first look in these directories and then in 1251@@RXVT_NAME@@ will first look in these directories and then in
1215F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource 1252F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1216will be ignored when running setuid/setgid.
1217 1253
1218See the @@RXVT_NAME@@perl(3) manpage. 1254See the @@RXVT_NAME@@perl(3) manpage.
1219 1255
1220=item B<< selection.pattern-I<idx> >>: I<perl-regex> 1256=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1221 1257
1456=back 1492=back
1457 1493
1458=head2 ALPHA CHANNEL SUPPORT 1494=head2 ALPHA CHANNEL SUPPORT
1459 1495
1460If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1496If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1461their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa> 1497their act together, rxvt-unicode will do it's own alpha channel management:
1462(recommended, but B<MUST> have 4 digits/component) colour specifications, 1498
1463in addition to the ones provided by X, where the additional A component 1499You can prefix any color with an opaquenes percentage enclosed in
1500brackets, i.e. C<[percent]>, where C<percent> is a decimal percentage
1501(0-100) that specifies the opacity of the color, where C<0> is completely
1502transparent and C<100> is completely opaque. For example, C<[50]red> is a
1503half-transparent red, while C<[95]#00ff00> is an almost opaque green. This
1504is the recommended format to specify transparency values, and works with
1505all ways to specify a colour.
1506
1507For complete control, rxvt-unicode also supports
1508C<rgba:rrrr/gggg/bbbb/aaaa> (exactly four hex digits/component) colour
1509specifications, where the additional C<aaaa> component specifies opacity
1464specifies opacity (alpha) values. The minimum value of C<0> is completely 1510(alpha) values. The minimum value of C<0000> is completely transparent,
1465transparent). You can also prefix any color with C<[percent]>, where 1511while C<ffff> is completely opaque). The two example colours from
1466C<percent> is a decimal percentage (0-100) that specifies the opacity of 1512earlier could also be specified as C<rgba:ff00/0000/0000/8000> and
1467the color, where C<0> is completely transparent and C<100> is completelxy 1513C<rgba:0000/ff00/0000/f332>.
1468opaque.
1469 1514
1470You probably need to specify B<"-depth 32">, too, and have the luck that 1515You probably need to specify B<"-depth 32">, too, to force a visual with
1471your X-server uses ARGB pixel layout, as X is far from just supporting 1516alpha channels, and have the luck that your X-server uses ARGB pixel
1472ARGB visuals out of the box, and rxvt-unicode just fudges around. 1517layout, as X is far from just supporting ARGB visuals out of the box, and
1518rxvt-unicode just fudges around.
1473 1519
1474For example, the following selects an almost completely transparent red 1520For example, the following selects an almost completely transparent black
1475background, and an almost opaque pink foreground: 1521background, and an almost opaque pink foreground:
1476 1522
1477 @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink" 1523 @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/4444 -fg "[80]pink"
1478 1524
1479I<Please note that transparency of any kind if completely unsupported by 1525When not using a background image, then the interpretation of the
1480the author. Don't bug him with installation questions!> 1526alpha channel is up to your compositing manager (most interpret it as
1527transparency of course).
1528
1529When using a background pixmap or pseudo-transparency, then the background
1530colour will always behave as if it were completely transparent (so the
1531background image shows instead), regardless of how it was specified, while
1532other colours will either be transparent as specified (the background
1533image will show through) on servers supporting the RENDER extension, or
1534fully opaque on servers not supporting the RENDER EXTENSION.
1535
1536Please note that due to bugs in Xft, specifying alpha values might result
1537in garbage being displayed when the X-server does not support the RENDER
1538extension.
1481 1539
1482=head1 ENVIRONMENT 1540=head1 ENVIRONMENT
1483 1541
1484B<@@RXVT_NAME@@> sets and/or uses the following environment variables: 1542B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
1485 1543
1519C<--with-terminfo=PATH>. 1577C<--with-terminfo=PATH>.
1520 1578
1521=item B<DISPLAY> 1579=item B<DISPLAY>
1522 1580
1523Used by @@RXVT_NAME@@ to connect to the display and set to the correct 1581Used by @@RXVT_NAME@@ to connect to the display and set to the correct
1524display in its child processes. 1582display in its child processes if C<-display> isn't used to override. It
1583defaults to C<:0> if it doesn't exist.
1525 1584
1526=item B<SHELL> 1585=item B<SHELL>
1527 1586
1528The shell to be used for command execution, defaults to C</bin/sh>. 1587The shell to be used for command execution, defaults to C</bin/sh>.
1529 1588

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines