--- rxvt-unicode/doc/rxvt.1.html 2005/02/17 15:07:48 1.17
+++ rxvt-unicode/doc/rxvt.1.html 2005/10/25 20:22:39 1.25
@@ -29,7 +29,6 @@
ENVIRONMENT
FILES
SEE ALSO
- BUGS
CURRENT PROJECT COORDINATOR
AUTHORS
@@ -49,7 +48,7 @@
-rxvt-unicode, version 5.2, is a colour vt102 terminal
+
rxvt-unicode, version 5.8, is a colour vt102 terminal
emulator intended as an xterm(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, rxvt-unicode uses much less swap space --
@@ -152,7 +151,7 @@
Turn on/off jump scrolling; resource jumpScroll.
--ip|+ip
+-ip|+ip | -tr|+tr
Turn on/off inheriting parent window's pixmap. Alternative form is
@@ -162,16 +161,30 @@
-fade number
-Fade the text by the given percentage when focus is lost. resource fading.
+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 fading.
+
+
+-fadecolor colour
+
+
+Fade to this colour when fading is used (see -fade). The default colour
+is black. resource fadeColor.
-tint colour
Tint the transparent background pixmap with the given colour when
-transparency is enabled with -tr or -ip. See also the -sh
-option that can be used to brighten or darken the image in addition to
-tinting it.
+transparency is enabled with -tr or -ip. This only works for
+non-tiled backgrounds, currently. See also the -sh option that can be
+used to brighten or darken the image in addition to tinting it; resource
+tintColor. Example:
+
+
+
+ rxvt -tr -tint blue -sh 40
-sh
@@ -338,7 +351,7 @@
-st|+st
-Display normal (non XTerm/NeXT) scrollbar without/with a trough;
+Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
resource scrollBar_floating.
@@ -547,14 +560,11 @@
- 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 -embed $xid &";
+ my $rxvt = new Gtk2::Socket;
+ $rxvt->signal_connect_after (realize => sub {
+ my $xid = $_[0]->window->get_xid;
+ system "rxvt -embed $xid &";
+ });
-pty-fd fileno
@@ -582,11 +592,9 @@
my $pty = new IO::Pty;
- fcntl $pty, F_SETFD, 0; # clear close-on-exec
-
-
-
- system "rxvt -pty-fd " . (fileno $pty) . "&";
+ fcntl $pty, F_SETFD, 0; # clear close-on-exec
+ system "rxvt -pty-fd " . (fileno $pty) . "&";
+ close $pty;
@@ -743,13 +751,21 @@
fading: number
-Fade the text by the given percentage when focus is lost.
+Fade the text by the given percentage when focus is lost; option -fade.
+
+
+fadeColor: colour
+
+
+Fade to this colour, when fading is used (see fading:). The default
+colour is black; option -fadecolor.
tintColor: colour
-Tint the transparent background pixmap with the given colour.
+Tint the transparent background pixmap with the given colour; option
+-tint.
shading: number
@@ -769,7 +785,7 @@
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.
borderColor: colour
@@ -899,7 +915,7 @@
Set scrollbar style to rxvt, plain, next or xterm. plain is
-the author's favourite..
+the author's favourite.
title: string
@@ -955,6 +971,20 @@
Print to initiate a screen dump to the printer and Ctrl-Print or
Shift-Print 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 Print.
+
scrollBar: boolean
@@ -1102,7 +1132,8 @@
pointerBlankDelay: number
-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. 987654321) to effectively disable the timeout.
backspacekey: string
@@ -1289,6 +1320,30 @@
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 at least 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 a will automatically provide
+definitions for Meta-a, Shift-a 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 Insert key you will disable rxvt's
+Shift-Insert mapping. To re-enable that, you can poke ``holes'' into the
+user-defined keymap using the builtin: replacement:
+
+
+
+ URxvt.keysym.Insert: <my insert key sequence>
+ URxvt.keysym.S-Insert: builtin:
+
+
+The first line defines a mapping for Insert and any combination
+of modifiers. The second line re-establishes the default mapping for
+Shift-Insert.
+
+
The following example will map Control-Meta-1 and Control-Meta-2 to
the fonts suxuseuro and 9x15bold, so you can have some limited
font-switching at runtime:
@@ -1563,7 +1618,7 @@
rxvtd(1).
-Default $HOME/.rxvt-unicode-<nodename.
+Default $HOME/.rxvt-unicode-<nodename >>>.
HOME
@@ -1602,14 +1657,7 @@
-rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
-
-
-
-
-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(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)