--- rxvt-unicode/doc/rxvt.1.pod 2006/01/16 15:07:27 1.97 +++ rxvt-unicode/doc/rxvt.1.pod 2006/01/31 00:25:16 1.111 @@ -95,6 +95,11 @@ respected). In the absence of this option, the display specified by the B environment variable is used. +=item B<-depth> I + +Compile I: Attempt to find a visual with the given bit depth; +resource B. + =item B<-geometry> I Window geometry (B<-g> still respected); resource B. @@ -112,6 +117,9 @@ Turn on/off inheriting parent window's pixmap. Alternative form is B<-tr>; resource B. +I + =item B<-fade> I Fade the text by the given percentage when focus is lost. Small values @@ -121,7 +129,7 @@ =item B<-fadecolor> I Fade to this colour when fading is used (see B<-fade>). The default colour -is black. resource B. +is opaque black. resource B. =item B<-tint> I @@ -299,6 +307,11 @@ if honoured by the WM, the rxvt-unicode window will not have window decorations; resource B. +=item B<-override-redirect> + +Compile I: Sets override-redirect on the window; resource +B. + =item B<-sbg> Compile I: Disable the usage of the built-in block graphics/line @@ -502,6 +515,11 @@ =over 4 +=item B I + +Compile I: Attempt to find a visual with the given bit depth; +option B<-depth>. + =item B I Create the window with the specified X window geometry [default 80x24]; @@ -584,6 +602,9 @@ artificial transparency. B: do not inherit the parent windows' pixmap. +I + =item B I Fade the text by the given percentage when focus is lost; option B<-fade>. @@ -893,8 +914,16 @@ =item B I -The characters used as delimiters for double-click word selection. The -built-in default: +The characters used as delimiters for double-click word selection +(whitespace delimiting is added automatically if resource is given). + +When the selection extension is in use (the default if compiled in, see +the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters +will be created (if the resource exists, otherwise, no regex will be +created). In this mode, characters outside ISO-8859-1 can be used. + +When the selection extension is not used, only ISO-8859-1 characters can +be used. If not specified, the built-in default is used: B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> @@ -954,18 +983,18 @@ character is passed through. It may contain escape values as described in the entry on B following. -=item B I +=item B I Turn on/off secondary screen (default enabled). -=item B I +=item B I Turn on/off secondary screen scroll (default enabled). If the this option is enabled, scrolls on the secondary screen will change the scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. -=item B: I +=item B: I Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ will not immediately destroy its window when the program executed within @@ -1130,7 +1159,12 @@ =item B: I -Sets the WM_TRANSIENT_FOR property to the given window iw. +Compile I: Sets the WM_TRANSIENT_FOR property to the given window id. + +=item B: I + +Compile I: Sets override-redirect for the terminal window, making +it almost invisible to window managers; option B<-override-redirect>. =back @@ -1182,9 +1216,12 @@ =item B: -Pressing and releasing the Middle mouse button (or B) in -an B<@@RXVT_NAME@@> window causes the current text selection to be -inserted as if it had been typed on the keyboard. +Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@> +window causes the value of the PRIMARY selection (or CLIPBOARD with the +Meta modifier) to be inserted as if it had been typed on the keyboard. + +Pressing B causes the value of the PRIMARY selection to be +inserted too. =back @@ -1281,7 +1318,7 @@ In addition to the default foreground and background colours, B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink versions of the same). Here is a list of the -colours with their B names. +colours with their names. =begin table @@ -1325,6 +1362,28 @@ =back +=head2 ALPHA CHANNEL SUPPORT + +If Xft support has been compiled in and as long as Xft/Xrender/X don't get +their act together, rxvt-unicode will support C +(recommended, but B have 4 digits/component) colour specifications, +in addition to the ones provided by X, where the additional A component +specifies opacity (alpha) values. The minimum value of C<0> is completely +transparent). You can also prefix any color with C<[a]>, where C is on +to four hex digits specifiying the opacity value. + +You probably need to specify B<"-depth 32">, too, and have the luck that +your X-server uses ARGB pixel layout, as X is far from just supporting +ARGB visuals out of the box, and rxvt-unicode just fudges around. + +For example, the following selects an almost completely transparent red +background, and an almost opaque pink foreground: + + @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" + +I + =head1 ENVIRONMENT B<@@RXVT_NAME@@> sets and/or uses the following environment variables: @@ -1372,15 +1431,6 @@ The shell to be used for command execution, defaults to C. -=item B - -The path where @@RXVT_NAME@@ looks for support files such as menu and xpm -files. - -=item B - -Used in the same way as C. - =item B The unix domain socket path used by @@RXVT_NAME@@c(1) and @@ -1459,16 +1509,20 @@ =item Geoff Wing L<< >> -Rewrote screen display and text selection routines. Project Coordinator -(changes.txt 2.4.6 - rxvt-unicode) +Rewrote screen display and text selection routines. + +Project Coordinator (changes.txt 2.4.6 - rxvt-unicode) =item Marc Alexander Lehmann L<< >> -Forked rxvt-unicode, rewrote most of the display code and internal -character handling to store text in unicode, improve xterm -compatibility and apply numerous other bugfixes and extensions. +Forked rxvt-unicode, unicode support, rewrote almost all the code, perl +extension, random hacks, numerous bugfixes and extensions. Project Coordinator (Changes 1.0 -) +=item Emanuele Giaquinta L<< >> + +Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing. + =back