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.158 by root, Wed Jan 23 14:33:42 2008 UTC vs.
Revision 1.166 by root, Fri Oct 10 13:23:56 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
335 340
336=item B<-bl> 341=item B<-bl>
337 342
338Compile I<frills>: Set MWM hints to request a borderless window, i.e. 343Compile 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 344if honoured by the WM, the rxvt-unicode window will not have window
340decorations; resource B<borderLess>. 345decorations; resource B<borderLess>. If the window manager does not
346support MWM hints (e.g. kwin), enables override-redirect mode.
341 347
342=item B<-override-redirect> 348=item B<-override-redirect>
343 349
344Compile I<frills>: Sets override-redirect on the window; resource 350Compile I<frills>: Sets override-redirect on the window; resource
345B<override-redirect>. 351B<override-redirect>.
449 455
450Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 456Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
451will not immediately destroy its window when the program executed within 457will 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 458it exits. Instead, it will wait till it is being killed or closed by the
453user; resource B<hold>. 459user; resource B<hold>.
460
461=item B<-cd> I<path>
462
463Sets the working directory for the shell (or the command specified via
464B<-e>). The I<path> must be an absolute path and it must exist for
465@@RXVT_NAME@@ to start; resource B<chdir>.
454 466
455=item B<-xrm> I<string> 467=item B<-xrm> I<string>
456 468
457Works like the X Toolkit option of the same name, by adding the I<string> 469Works 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 470as if it were specified in a resource file. Resource values specified this
567=item B<depth:> I<bitdepth> 579=item B<depth:> I<bitdepth>
568 580
569Compile I<xft>: Attempt to find a visual with the given bit depth; 581Compile I<xft>: Attempt to find a visual with the given bit depth;
570option B<-depth>. 582option B<-depth>.
571 583
584=item B<buffered:> I<boolean>
585
586Compile I<xft>: Turn on/off double-buffering for xft (default enabled).
587On some card/driver combination enabling it slightly decreases
588performance, on most it greatly helps it. The slowdown is small, so it
589should normally be enabled.
590
572=item B<geometry:> I<geom> 591=item B<geometry:> I<geom>
573 592
574Create the window with the specified X window geometry [default 80x24]; 593Create the window with the specified X window geometry [default 80x24];
575option B<-geometry>. 594option B<-geometry>.
576 595
1077 1096
1078=item B<secondaryScroll:> I<boolean> 1097=item B<secondaryScroll:> I<boolean>
1079 1098
1080Turn on/off secondary screen scroll (default enabled). If this 1099Turn on/off secondary screen scroll (default enabled). If this
1081option is enabled, scrolls on the secondary screen will change the 1100option is enabled, scrolls on the secondary screen will change the
1082scrollback buffer and switching to/from the secondary screen will 1101scrollback buffer and, when secondaryScreen is off, switching
1083instead scroll the screen up. 1102to/from the secondary screen will instead scroll the screen up.
1084 1103
1085=item B<hold>: I<boolean> 1104=item B<hold>: I<boolean>
1086 1105
1087Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 1106Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
1088will not immediately destroy its window when the program executed within 1107will 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 1108it exits. Instead, it will wait till it is being killed or closed by the
1090user. 1109user.
1110
1111=item B<chdir>: I<path>
1112
1113Sets the working directory for the shell (or the command specified via
1114B<-e>). The I<path> must be an absolute path and it must exist for
1115@@RXVT_NAME@@ to start. If it isn't specified then the current working
1116directory will be used; option B<-cd>.
1091 1117
1092=item B<keysym.>I<sym>: I<string> 1118=item B<keysym.>I<sym>: I<string>
1093 1119
1094Compile I<frills>: Associate I<string> with keysym I<sym>. The 1120Compile I<frills>: Associate I<string> with keysym I<sym>. The
1095intervening resource name B<keysym.> cannot be omitted. 1121intervening resource name B<keysym.> cannot be omitted.
1202all instances, while B<perl-ext> is used for specific instances. 1228all instances, while B<perl-ext> is used for specific instances.
1203 1229
1204=item B<perl-eval>: I<string> 1230=item B<perl-eval>: I<string>
1205 1231
1206Perl code to be evaluated when all extensions have been registered. See 1232Perl code to be evaluated when all extensions have been registered. See
1207the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource 1233the @@RXVT_NAME@@perl(3) manpage.
1208will be ignored when running setuid/setgid.
1209 1234
1210=item B<perl-lib>: I<path> 1235=item B<perl-lib>: I<path>
1211 1236
1212Colon-separated list of additional directories that hold extension 1237Colon-separated list of additional directories that hold extension
1213scripts. When looking for extensions specified by the C<perl> resource, 1238scripts. When looking for extensions specified by the C<perl> resource,
1214@@RXVT_NAME@@ will first look in these directories and then in 1239@@RXVT_NAME@@ will first look in these directories and then in
1215F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource 1240F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1216will be ignored when running setuid/setgid.
1217 1241
1218See the @@RXVT_NAME@@perl(3) manpage. 1242See the @@RXVT_NAME@@perl(3) manpage.
1219 1243
1220=item B<< selection.pattern-I<idx> >>: I<perl-regex> 1244=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1221 1245
1453would yield White on Black, while on I<xterm>(1) it would yield Black 1477would yield White on Black, while on I<xterm>(1) it would yield Black
1454on White. 1478on White.
1455 1479
1456=back 1480=back
1457 1481
1458=head2 ALPHA CHANNEL SUPPORT / TRANSPARENT COLOURS 1482=head2 ALPHA CHANNEL SUPPORT
1459 1483
1460If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1484If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1461their act together, rxvt-unicode will do it's own alpha channel management: 1485their act together, rxvt-unicode will do it's own alpha channel management:
1462 1486
1463You can prefix any color with an opaquenes percentage enclosed in 1487You can prefix any color with an opaquenes percentage enclosed in
1541C<--with-terminfo=PATH>. 1565C<--with-terminfo=PATH>.
1542 1566
1543=item B<DISPLAY> 1567=item B<DISPLAY>
1544 1568
1545Used by @@RXVT_NAME@@ to connect to the display and set to the correct 1569Used by @@RXVT_NAME@@ to connect to the display and set to the correct
1546display in its child processes. 1570display in its child processes if C<-display> isn't used to override. It
1571defaults to C<:0> if it doesn't exist.
1547 1572
1548=item B<SHELL> 1573=item B<SHELL>
1549 1574
1550The shell to be used for command execution, defaults to C</bin/sh>. 1575The shell to be used for command execution, defaults to C</bin/sh>.
1551 1576

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines