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.200 by sf-exg, Wed Aug 10 07:28:35 2011 UTC vs.
Revision 1.220 by root, Fri Sep 21 23:31:43 2012 UTC

98is still respected. but deprecated). In the absence of this option, the 98is still respected. but deprecated). In the absence of this option, the
99display specified by the B<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<frills>: Attempt to find a visual with the given bit depth;
104resource B<depth>. 104resource B<depth>.
105 105
106[Please note that many X servers (and libXft) are buggy with 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 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 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>
112
113Compile I<frills>: Use the given visual (see e.g. C<xdpyinfo> for possible
114visual ids).
115
111=item B<-geometry> I<geom> 116=item B<-geometry> I<geom>
112 117
113Window geometry (B<-g> still respected); resource B<geometry>. 118Window geometry (B<-g> still respected); resource B<geometry>.
114 119
115=item B<-rv>|B<+rv> 120=item B<-rv>|B<+rv>
150=item B<-sh> I<number> 155=item B<-sh> I<number>
151 156
152Darken (0 .. 99) or lighten (101 .. 200) the transparent background. 157Darken (0 .. 99) or lighten (101 .. 200) the transparent background.
153A value of 100 means no shading; resource I<shading>. 158A value of 100 means no shading; resource I<shading>.
154 159
155=item B<-blt> I<string>
156
157Specify background blending type. If background pixmap is specified
158at the same time as transparency - such pixmap will be blended over
159the transparent background, using the method specified. Supported values are:
160B<add>, B<alphablend>, B<allanon> - colour values averaging, B<colorize>,
161B<darken>, B<diff>, B<dissipate>, B<hue>, B<lighten>, B<overlay>,
162B<saturate>, B<screen>, B<sub>, B<tint>, B<value>. The default is
163alpha-blending. Compile I<afterimage>; resource I<blendType>.
164
165=item B<-blr> I<HxV> 160=item B<-blr> I<HxV>
166 161
167Apply Gaussian Blur with the specified radii to the transparent 162Apply Gaussian Blur with the specified radii to the transparent
168background. If a single number is specified - both vertical and 163background. If a single number is specified, the vertical and
169horizontal radii are considered to be the same. Setting one of the 164horizontal radii are considered to be the same. Setting one of the
170radii to 1 and another to a large number creates interesting effects 165radii to 1 and the other to a large number creates interesting effects
171on some backgrounds. Maximum radius value is 128; 166on some backgrounds. The maximum radius value is 128. An horizontal or
167vertical radius of 0 disables blurring;
172resource I<blurRadius>. 168resource I<blurRadius>.
173 169
174=item B<-icon> I<file> 170=item B<-icon> I<file>
175 171
176Compile I<afterimage> or I<pixbuf>: Use the specified image as application icon. This 172Compile I<pixbuf>: Use the specified image as application icon. This
177is used by many window managers, taskbars and pagers to represent the 173is used by many window managers, taskbars and pagers to represent the
178application window; resource I<iconFile>. 174application window; resource I<iconFile>.
179 175
180=item B<-bg> I<colour> 176=item B<-bg> I<colour>
181 177
183 179
184=item B<-fg> I<colour> 180=item B<-fg> I<colour>
185 181
186Window foreground colour; resource B<foreground>. 182Window foreground colour; resource B<foreground>.
187 183
188=item B<-pixmap> I<file[;geom[:op1][:op2][...]]> 184=item B<-pixmap> I<file[;oplist]>
189 185
190Compile I<afterimage> or I<pixbuf>: Specify image file for the background and also 186Compile I<pixbuf>: Specify image file for the background and also
191optionally specify its scaling with a geometry string. Note you may need to 187optionally specify a list of operations to modify it. Note you may need to
192add quotes to avoid special shell interpretation of the C<;> in the 188add quotes to avoid special shell interpretation of the C<;> in the
193command-line; for more details see resource B<backgroundPixmap>. 189command-line; for more details see resource B<backgroundPixmap>.
194 190
195=item B<-cr> I<colour> 191=item B<-cr> I<colour>
196 192
716=item B<shading:> I<number> 712=item B<shading:> I<number>
717 713
718Darken (0 .. 99) or lighten (101 .. 200) the transparent background. 714Darken (0 .. 99) or lighten (101 .. 200) the transparent background.
719A value of 100 means no shading; option B<-sh>. 715A value of 100 means no shading; option B<-sh>.
720 716
721=item B<blendType:> I<string>
722
723Specify background blending type; option B<-blt>.
724
725=item B<blurRadius:> I<number> 717=item B<blurRadius:> I<number>
726 718
727Apply gaussian blur with the specified radius to the transparent 719Apply gaussian blur with the specified radius to the transparent
728background; option B<-blr>. 720background; option B<-blr>.
729 721
743=item B<borderColor:> I<colour> 735=item B<borderColor:> I<colour>
744 736
745The colour of the border around the text area and between the scrollbar 737The colour of the border around the text area and between the scrollbar
746and the text. 738and the text.
747 739
748=item B<backgroundPixmap:> I<file[;geom[:op1][:op2][...]]> 740=item B<backgroundPixmap:> I<file[;oplist]>
749 741
750Use the specified image file for the background and also 742Use the specified image file for the background and also
751optionally specify its scaling with a geometry string B<WxH+X+Y>, 743optionally specify a colon separated list of operations to modify it.
752(default C<100x100+50+50>) in which B<"W" / "H"> specify the
753horizontal/vertical scale (percent), and B<"X" / "Y"> locate the image
754centre (percent). A scale of 0 disables scaling.
755The maximum permitted scale is 1000.
756Additional operations can be specified after colon B<:op1:op2...>.
757Supported operations are: 744Supported operations are:
758 745
759 tile will tile image 746=over 4
760 propscale will scale image keeping proportions 747
761 scale will scale image to match window size 748=item B<WxH+X+Y>
762 root will tile image as if it was a root window background, auto-adjusting 749
763 whenever terminal window moves 750sets scale and position. B<"W" / "H"> specify the horizontal/vertical
751scale (percent), and B<"X" / "Y"> locate the image centre (percent). A
752scale of 0 disables scaling.
753
754=item B<op=tile>
755
756enables tiling
757
758=item B<op=keep-aspect>
759
760maintain the image aspect ratio when scaling
761
762=item B<op=root-align>
763
764use the position of the terminal window relative to the root window as
765the image offset, simulating a root window background
766
767=back
768
769The default scale and position setting is C<100x100+50+50>.
770Alternatively, a predefined set of templates can be used to achieve
771the most common setups:
772
773=over 4
774
775=item B<style=tiled>
776
777the image is tiled with no scaling. Equivalent to 0x0+0+0:op=tile
778
779=item B<style=aspect-stretched>
780
781the image is scaled to fill the whole window maintaining the aspect
782ratio and centered. Equivalent to 100x100+50+50:op=keep-aspect
783
784=item B<style=stretched>
785
786the image is scaled to fill the whole window. Equivalent to 100x100
787
788=item B<style=centered>
789
790the image is centered with no scaling. Equivalent to 0x0+50+50
791
792=item B<style=root-tiled>
793
794the image is tiled with no scaling and using 'root' positioning.
795Equivalent to 0x0:op=tile:op=root-align
796
797=back
798
799If multiple templates are specified the last one wins. Note that a
800template overrides all the scale, position and operations settings.
764 801
765If used in conjunction with B<-tr> option, the specified pixmap will be 802If used in conjunction with B<-tr> option, the specified pixmap will be
766blended over the transparent background using alpha-blending. If I<afterimage> 803blended over the transparent background using alpha-blending.
767support has been compiled in it is possible to choose other blending
768types with B<-blt "type"> option.
769 804
770=item B<path:> I<path> 805=item B<path:> I<path>
771 806
772Specify the colon-delimited search path for finding background image files. 807Specify the colon-delimited search path for finding background image files.
773 808
1159performed in an exact manner; however, the closest match is assured. 1194performed in an exact manner; however, the closest match is assured.
1160 1195
1161I<string> may contain escape values (C<\n>: newline, C<\000>: octal 1196I<string> may contain escape values (C<\n>: newline, C<\000>: octal
1162number), see RESOURCES in C<man 7 X> for further details. 1197number), see RESOURCES in C<man 7 X> for further details.
1163 1198
1164You can define a range of keysyms in one shot by providing a I<string> 1199You can define a range of keysyms in one shot by
1200loading the C<keysym-list> perl extension and providing a I<string>
1165with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimiter `/' 1201with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimiter `/'
1166should be a character not used by the strings. 1202should be a character not used by the strings.
1167 1203
1168Its usage can be demonstrated by an example: 1204Its usage can be demonstrated by an example:
1169 1205
1254the @@RXVT_NAME@@perl(3) manpage. 1290the @@RXVT_NAME@@perl(3) manpage.
1255 1291
1256=item B<perl-lib>: I<path> 1292=item B<perl-lib>: I<path>
1257 1293
1258Colon-separated list of additional directories that hold extension 1294Colon-separated list of additional directories that hold extension
1259scripts. When looking for extensions specified by the C<perl> resource, 1295scripts. When looking for perl extensions, @@RXVT_NAME@@ will first look
1260@@RXVT_NAME@@ will first look in these directories and then in 1296in these directories, then in C<$URXVT_PERL_LIB>, F<$HOME/.urxvt/ext> and
1261F<@@RXVT_LIBDIR@@/urxvt/perl/>. 1297lastly in F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1262 1298
1263See the @@RXVT_NAME@@perl(3) manpage. 1299See the @@RXVT_NAME@@perl(3) manpage.
1264 1300
1265=item B<< selection.pattern-I<idx> >>: I<perl-regex> 1301=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1266 1302
1514White. 1550White.
1515 1551
1516=head2 ALPHA CHANNEL SUPPORT 1552=head2 ALPHA CHANNEL SUPPORT
1517 1553
1518If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1554If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1519their act together, rxvt-unicode will do it's own alpha channel management: 1555their act together, rxvt-unicode will do its own alpha channel management:
1520 1556
1521You can prefix any colour with an opaqueness percentage enclosed in 1557You can prefix any colour with an opaqueness percentage enclosed in
1522brackets, i.e. C<[percent]>, where C<percent> is a decimal percentage 1558brackets, i.e. C<[percent]>, where C<percent> is a decimal percentage
1523(0-100) that specifies the opacity of the colour, where C<0> is completely 1559(0-100) that specifies the opacity of the colour, where C<0> is completely
1524transparent and C<100> is completely opaque. For example, C<[50]red> is a 1560transparent and C<100> is completely opaque. For example, C<[50]red> is a
1606 1642
1607=item B<SHELL> 1643=item B<SHELL>
1608 1644
1609The shell to be used for command execution, defaults to C</bin/sh>. 1645The shell to be used for command execution, defaults to C</bin/sh>.
1610 1646
1611=item B<RXVT_SOCKET> 1647=item B<RXVT_SOCKET> [I<sic>]
1612 1648
1613The unix domain socket path used by @@RXVT_NAME@@c(1) and 1649The unix domain socket path used by @@RXVT_NAME@@c(1) and
1614@@RXVT_NAME@@d(1). 1650@@RXVT_NAME@@d(1).
1615 1651
1616Default F<<< $HOME/.rxvt-unicode-I<< <nodename> >> >>>. 1652Default F<<< $HOME/.urxvt/urxvtd-I<< <nodename> >> >>>.
1653
1654=item B<URXVT_PERL_LIB>
1655
1656Additional F<:>-separated library search path for perl extensions. Will be
1657searched after B<-perl-lib> but before F<~/.urxvt/ext> and the system library
1658directory.
1659
1660=item B<URXVT_PERL_VERBOSITY>
1661
1662See L<@@RXVT_NAME@@perl>(3).
1617 1663
1618=item B<HOME> 1664=item B<HOME>
1619 1665
1620Used to locate the default directory for the unix domain socket for 1666Used to locate the default directory for the unix domain socket for
1621daemon communications and to locate various resource files (such as 1667daemon communications and to locate various resource files (such as
1642 1688
1643=back 1689=back
1644 1690
1645=head1 SEE ALSO 1691=head1 SEE ALSO
1646 1692
1693@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),
1647@@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) 1694@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1648 1695
1649=head1 CURRENT PROJECT COORDINATOR 1696=head1 CURRENT PROJECT COORDINATOR
1650 1697
1651=over 4 1698=over 4
1652 1699

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines