--- rxvt-unicode/doc/rxvt.1.pod 2006/01/12 12:15:10 1.95 +++ 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 @@ -174,7 +182,7 @@ =item B<-fn> I Select the fonts to be used. This is a comma separated list of font names -that are used in turn when trying to display Unicode characters. The +that are checked in order when trying to find glyphs for characters. The first font defines the cell size for characters; other fonts might be smaller, but not (in general) larger. A (hopefully) reasonable default font list is always appended to it. See resource B for more details. @@ -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>. @@ -629,25 +650,17 @@ be magnified beyond 10 times its original size. The maximum permitted scale is 1000. [default 0x0+50+50] -=item B I - -Read in the specified menu file (note the `.menu' extension is -optional) and also optionally specify a starting tag to find. See the -reference documentation for details on the syntax for the menuBar. - =item B I -Specify the colon-delimited search path for finding files (XPM and -menus), in addition to the paths specified by the B and -B environment variables. +Specify the colon-delimited search path for finding XPM files. =item B I -Select the fonts to be used. This is a comma separated list of font -names that are used in turn when trying to display Unicode characters. -The first font defines the cell size for characters; other fonts might -be smaller, but not larger. A reasonable default font list is always -appended to it; option B<-fn>. +Select the fonts to be used. This is a comma separated list of font names +that are checked in order when trying to find glyphs for characters. The +first font defines the cell size for characters; other fonts might be +smaller, but not (in general) larger. A (hopefully) reasonable default +font list is always appended to it; option B<-fn>. Each font can either be a standard X11 core font (XLFD) name, with optional prefix C or a Xft font (Compile I), prefixed with C. @@ -659,7 +672,7 @@ For example, this font resource - URxvt*font: 9x15bold,\ + URxvt.font: 9x15bold,\ -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ @@ -766,7 +779,7 @@ Example: - URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) + URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) This creates a new file in your home directory with the screen contents everytime you hit C. @@ -901,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 `"'&()*,;<=>?@[]{|} >> @@ -948,8 +969,7 @@ You can enable them by setting this boolean resource or specifying B<-insecure> as an option. At the moment, this enables display-answer, -locale, findfont, icon label and window title requests as well as dynamic -menubar dispatch. +locale, findfont, icon label and window title requests. =item B I @@ -963,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 @@ -1139,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 @@ -1191,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 @@ -1202,11 +1230,15 @@ Changing fonts (or font sizes, respectively) via the keypad is not yet supported in rxvt-unicode. Bug me if you need this. -You can, however, switch fonts at runtime using escape sequences (and -therefore using the menubar), e.g.: +You can, however, switch fonts at runtime using escape sequences, e.g.: printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" +You can use keyboard shortcuts, too: + + URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 + URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 + rxvt-unicode will automatically re-apply these fonts to the output so far. =head1 ISO 14755 SUPPORT @@ -1286,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 @@ -1330,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: @@ -1377,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 @@ -1464,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