--- rxvt-unicode/doc/rxvt.1.pod 2005/02/17 15:07:48 1.59 +++ rxvt-unicode/doc/rxvt.1.pod 2005/12/07 20:55:52 1.72 @@ -107,21 +107,31 @@ Turn on/off jump scrolling; resource B. -=item B<-ip>|B<+ip> +=item B<-ip>|B<+ip> | B<-tr>|B<+tr> Turn on/off inheriting parent window's pixmap. Alternative form is B<-tr>; resource B. =item B<-fade> I -Fade the text by the given percentage when focus is lost. resource B. +Fade the text by the given percentage when focus is lost. Small values +fade a little only, 100 completely replaces all colours by the fade +colour; resource B. + +=item B<-fadecolor> I + +Fade to this colour when fading is used (see B<-fade>). The default colour +is black. resource B. =item B<-tint> I Tint the transparent background pixmap with the given colour when -transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> -option that can be used to brighten or darken the image in addition to -tinting it. +transparency is enabled with B<-tr> or B<-ip>. This only works for +non-tiled backgrounds, currently. See also the B<-sh> option that can be +used to brighten or darken the image in addition to tinting it; resource +I. Example: + + @@RXVT_NAME@@ -tr -tint blue -sh 40 =item B<-sh> @@ -240,7 +250,7 @@ =item B<-st>|B<+st> -Display normal (non XTerm/NeXT) scrollbar without/with a trough; +Display rxvt (non XTerm/NeXT) scrollbar without/with a trough; resource B. =item B<-ptab>|B<+ptab> @@ -395,12 +405,11 @@ Here is a short Gtk2-perl snippet that illustrates how this option can be used (a longer example is in F): - my $rxvt = new Gtk2::DrawingArea; - $...->add ($rxvt); # important to add it somewhere first - $rxvt->realize; # now it can be realized - my $xid = $rxvt->window->get_xid; - - system "@@RXVT_NAME@@ -embed $xid &"; + my $rxvt = new Gtk2::Socket; + $rxvt->signal_connect_after (realize => sub { + my $xid = $_[0]->window->get_xid; + system "@@RXVT_NAME@@ -embed $xid &"; + }); =item B<-pty-fd> I @@ -421,8 +430,8 @@ my $pty = new IO::Pty; fcntl $pty, F_SETFD, 0; # clear close-on-exec - system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&"; + close $pty; # now communicate with rxvt my $slave = $pty->slave; @@ -551,11 +560,17 @@ =item B I -Fade the text by the given percentage when focus is lost. +Fade the text by the given percentage when focus is lost; option B<-fade>. + +=item B I + +Fade to this colour, when fading is used (see B). The default +colour is black; option B<-fadecolor>. =item B I -Tint the transparent background pixmap with the given colour. +Tint the transparent background pixmap with the given colour; option +B<-tint>. =item B I @@ -569,7 +584,7 @@ =item B I Use the specified colour for the scrollbar's trough area [default -#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. +#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. =item B I @@ -671,7 +686,7 @@ =item B I Set scrollbar style to B, B, B or B. B is -the author's favourite.. +the author's favourite. =item B I @@ -713,6 +728,15 @@ B to initiate a screen dump to the printer and B or B to include the scrollback as well. +The string will be interpreted as if typed into the shell as-is. + +Example: + + 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. + =item B I B: enable the scrollbar [default]; option B<-sb>. B: @@ -818,7 +842,8 @@ =item B I -Specifies number of seconds before blanking the pointer [default 2]. +Specifies number of seconds before blanking the pointer [default 2]. Use a +large number (e.g. C<987654321>) to effectively disable the timeout. =item B I @@ -960,6 +985,25 @@ URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 +Due the the large number of modifier combinations, a defined key mapping +will match if at I the specified identifiers are being set, and +no other key mappings with those and more bits are being defined. That +means that defining a key map for C will automatically provide +definitions for C, C and so on, unless some of those are defined +mappings themselves. + +Unfortunately, this will override built-in key mappings. For example +if you overwrite the C key you will disable @@RXVT_NAME@@'s +C mapping. To re-enable that, you can poke "holes" into the +user-defined keymap using the C replacement: + + URxvt.keysym.Insert: + URxvt.keysym.S-Insert: builtin: + +The first line defines a mapping for C and I combination +of modifiers. The second line re-establishes the default mapping for +C. + The following example will map Control-Meta-1 and Control-Meta-2 to the fonts C and C<9x15bold>, so you can have some limited font-switching at runtime: @@ -1035,7 +1079,7 @@ You can, however, switch fonts at runtime using escape sequences (and therefore using the menubar), e.g.: - printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" + printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" rxvt-unicode will automatically re-apply these fonts to the output so far. @@ -1221,7 +1265,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). -Default C<< $HOME/.rxvt-unicode->. +Default F<<< $HOME/.rxvt-unicode-I<< > >>>. =item B @@ -1252,15 +1296,7 @@ =head1 SEE ALSO -@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) - -=head1 BUGS - -Check the BUGS file for an up-to-date list. - -Cursor change support is not yet implemented. - -Click-and-drag doesn't work with X11 mouse report overriding. +@@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) =head1 CURRENT PROJECT COORDINATOR