--- rxvt-unicode/doc/rxvt.1.pod	2005/02/03 10:24:10	1.48
+++ rxvt-unicode/doc/rxvt.1.pod	2005/02/11 18:14:07	1.53
@@ -16,8 +16,10 @@
 
 =head1 FREQUENTLY ASKED QUESTIONS
 
-See @@RXVT_NAME@@(7) (try C<man 7 @@RXVT_NAME@@>) for a list of frequently
-asked questions and answer to them and some common problems.
+See @@RXVT_NAME@@(7) (try C<man 7 @@RXVT_NAME@@>) for a list of
+frequently asked questions and answer to them and some common
+problems. That document is also accessible on the World-Wide-Web at
+L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
 
 =head1 RXVT-UNICODE VS. RXVT
 
@@ -368,6 +370,10 @@
 Turn on/off secondary screen scroll (default enabled); resource
 B<secondaryScroll>.
 
+=item B<-keysym.>I<sym>: I<string>
+
+Remap a key symbol. See resource B<keysym>.
+
 =item B<-xrm> I<resourcestring>
 
 No effect on rxvt-unicode. Simply passes through an argument to be made
@@ -385,8 +391,16 @@
 Xresource data: using the X libraries (Xrm*-functions) or internal
 Xresources reader (B<~/.Xdefaults>). For the first method (ie.
 B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the
-resources using X11 tools like B<xset>. Many distribution do also load
-settings from the B<~/.Xresources> file when X starts.
+resources using X11 tools like B<xrdb>. Many distribution do also load
+settings from the B<~/.Xresources> file when X starts. @@RXVT_NAME@@
+will consult the following files/resources in order, with later settings
+overwriting earlier ones:
+
+  1. system-wide app-defaults file, either locale-dependent OR global
+  2. app-defaults file in $XAPPLRESDIR
+  3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
+  4. SCREEN_RESOURCES for the current screen
+  5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
 
 If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h>
 lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults
@@ -933,9 +947,9 @@
 
 If mouse reporting mode is active, the normal scrollbar actions are
 disabled -- on the assumption that we are using a fullscreen
-application. Instead, pressing Button1 and Button3 sends B<ESC[6~>
-(Next) and B<ESC[5~> (Prior), respectively. Similarly, clicking on the
-up and down arrows sends B<ESC[A> (Up) and B<ESC[B> (Down),
+application. Instead, pressing Button1 and Button3 sends B<ESC [ 6 ~>
+(Next) and B<ESC [ 5 ~> (Prior), respectively. Similarly, clicking on the
+up and down arrows sends B<ESC [ A> (Up) and B<ESC [ B> (Down),
 respectively.
 
 =head1 TEXT SELECTION AND INSERTION
@@ -1100,12 +1114,83 @@
 
 =head1 ENVIRONMENT
 
-B<@@RXVT_NAME@@> sets the environment variables B<TERM>, B<COLORTERM>
-and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X
-window id number of the B<@@RXVT_NAME@@> window and it also uses and
-sets the environment variable B<DISPLAY> to specify which display
-terminal to use. B<@@RXVT_NAME@@> uses the environment variables
-B<RXVTPATH> and B<PATH> to find XPM files.
+B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
+
+=over 4
+
+=item B<TERM>
+
+Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
+resources or on the commandline.
+
+=item B<COLORTERM>
+
+Either C<rxvt>, C<rxvt-xpm>, depending on wether @@RXVT_NAME@@ was
+compiled with XPM support, and optionally with the added extension
+C<-mono> to indicate that rxvt-unicode runs on a monochrome screen.
+
+=item B<COLORFGBG>
+
+Set to a string of the form C<fg;bg> or C<fg;xpm;bg>, where C<fg> is
+the colour code used as default foreground/text colour (or the string
+C<default> to indicate that the default-colour escape sequence is to be
+used), C<bg> is the colour code used as default background colour (or the
+string C<default>), and C<xpm> is the string C<default> if @@RXVT_NAME@@
+was compiled with XPM support. Libraries like C<slang> can (and do) use
+this information to optimize screen output.
+
+=item B<WINDOWID>
+
+Set to the (decimal) X Window ID of the @@RXVT_NAME@@ window (the toplevel
+window, which usually has subwindows for the scrollbar, the terminal
+window and so on).
+
+=item B<TERMINFO>
+
+Set to the terminfo directory iff @@RXVT_NAME@@ was configured with
+C<--with-terminfo=PATH>.
+
+=item B<DISPLAY>
+
+Used by @@RXVT_NAME@@ to connect to the display and set to the correct
+display in it's child processes.
+
+=item B<SHELL>
+
+The shell to be used for command execution, defaults to C</bin/sh>.
+
+=item B<RXVTPATH>
+
+The path where @@RXVT_NAME@@ looks for support files such as menu and xpm
+files.
+
+=item B<PATH>
+
+Used in the same way as C<RXVTPATH>.
+
+=item B<RXVT_SOCKET>
+
+The unix domain socket path used by @@RXVT_NAME@@c(1) and
+@@RXVT_NAME@@d(1).
+
+Default C<< $HOME/.rxvt-unicode-<nodename >>.
+
+=item B<HOME>
+
+Used to locate the default directory for the unix domain socket for
+daemon communications and to locate various resource files (such as
+C<.Xdefaults>)
+
+=item B<XAPPLRESDIR>
+
+Directory where various X resource files are being located.
+
+=item B<XENVIRONMENT>
+
+If set and accessible, gives the name of a X resource file to be loaded by
+@@RXVT_NAME@@.
+
+=back
 
 =head1 FILES
 
@@ -1137,10 +1222,6 @@
 
 @@RXVT_MAINT@@ L<@@RXVT_MAINTEMAIL@@>
 
-=item Web page maintainter
-
-@@RXVT_WEBMAINT@@ L<@@RXVT_WEBMAINTEMAIL@@>
-
 L<@@RXVT_WEBPAGE@@>
 
 =back