--- rxvt-unicode/doc/rxvt.1.pod	2008/01/26 14:24:42	1.161
+++ rxvt-unicode/doc/rxvt.1.pod	2010/04/17 23:00:45	1.176
@@ -94,9 +94,9 @@
 
 =item B<-display> I<displayname>
 
-Attempt to open a window on the named X display (B<-d> still
-respected). In the absence of this option, the display specified by the
-B<DISPLAY> environment variable is used.
+Attempt to open a window on the named X display (the older form B<-d>
+is still respected. but deprecated). In the absence of this option, the
+display specified by the B<DISPLAY> environment variable is used.
 
 =item B<-depth> I<bitdepth>
 
@@ -184,6 +184,12 @@
 on some backgrounds. Maximum radius value is 128. Compile I<afterimage>;
 resource I<blurRadius>.
 
+=item B<-icon> I<file>
+
+Compile I<afterimage>: Use the specified image as application icon. This
+is used by many window managers, taskbars and pagers to represent the
+application window; resource I<iconFile>.
+
 =item B<-bg> I<colour>
 
 Window background colour; resource B<background>.
@@ -317,6 +323,10 @@
 
 Blink the cursor; resource B<cursorBlink>.
 
+=item B<-uc>|B<+uc>
+
+Make the cursor underlined; resource B<cursorUnderline>.
+
 =item B<-iconic>
 
 Start iconified, if the window manager supports that option.
@@ -342,7 +352,8 @@
 
 Compile I<frills>: Set MWM hints to request a borderless window, i.e.
 if honoured by the WM, the rxvt-unicode window will not have window
-decorations; resource B<borderLess>.
+decorations; resource B<borderLess>. If the window manager does not
+support MWM hints (e.g. kwin), enables override-redirect mode.
 
 =item B<-override-redirect>
 
@@ -362,6 +373,13 @@
 the display. Useful to work around font rendering problems; resource
 B<lineSpace>.
 
+=item B<-letsp> I<number>
+
+Compile I<frills>: Amount to adjust the computed character width by
+to control overall letter spacing. Negative values will tighten up the
+letter spacing, positive values will space letters out more. Useful to
+work around odd font metrics; resource B<letterSpace>.
+
 =item B<-tn> I<termname>
 
 This option specifies the name of the terminal type to be set in the
@@ -457,6 +475,12 @@
 it exits. Instead, it will wait till it is being killed or closed by the
 user; resource B<hold>.
 
+=item B<-cd> I<path>
+
+Sets the working directory for the shell (or the command specified via
+B<-e>). The I<path> must be an absolute path and it must exist for
+@@RXVT_NAME@@ to start; resource B<chdir>.
+
 =item B<-xrm> I<string>
 
 Works like the X Toolkit option of the same name, by adding the I<string>
@@ -624,16 +648,21 @@
 Use the specified colour to display underlined characters when the
 foreground colour is the default.
 
-=item B<colorRV:> I<colour>
-
-Use the specified colour as the background for reverse video characters
-when OPTION_HC is disabled (--disable-frills).
-
 =item B<underlineColor:> I<colour>
 
 If set, use the specified colour as the colour for the underline
 itself. If unset, use the foreground colour.
 
+=item B<highlightColor:> I<colour>
+
+If set, use the specified colour as the background for highlighted
+characters. If unset, use reverse video.
+
+=item B<highlightTextColor:> I<colour>
+
+If set and highlightColor is set, use the specified colour as the
+foreground for highlighted characters.
+
 =item B<cursorColor:> I<colour>
 
 Use the specified colour for the cursor. The default is to use the
@@ -708,9 +737,13 @@
 
 =item B<blurRadius:> I<number>
 
-Apply Gaussian Blurr with the specified radius to the transparent
+Apply gaussian blur with the specified radius to the transparent
 background image; option B<-blr>.
 
+=item B<iconFile:> I<file>
+
+Set the application icon pixmap; option B<-icon>.
+
 =item B<scrollColor:> I<colour>
 
 Use the specified colour for the scrollbar [default #B2B2B2].
@@ -786,7 +819,7 @@
 
 The second font is just used to add additional unicode characters not in
 the base font, likewise the third, which is unfortunately non-bold, but
-the bold version of the font does contain less characters, so this is a
+the bold version of the font does contain fewer characters, so this is a
 useful supplement.
 
 The third font is an Xft font with aliasing turned off, and the characters
@@ -847,6 +880,8 @@
 B<True>: set the urgency hint for the wm on receipt of a bell character.
 B<False>: do not set the urgency hint [default].
 
+@@RXVT_NAME@@ resets the urgency hint on every focus change.
+
 =item B<visualBell:> I<boolean>
 
 B<True>: use visual bell on receipt of a bell character; option B<-vb>.
@@ -980,6 +1015,11 @@
 B<True>: blink the cursor. B<False>: do not blink the cursor [default];
 option B<-bc>.
 
+=item B<cursorUnderline:> I<boolean>
+
+B<True>: Make the cursor underlined. B<False>: Make the cursor a box [default];
+option B<-uc>.
+
 =item B<pointerBlank:> I<boolean>
 
 B<True>: blank the pointer when a key is pressed or after a set number
@@ -1091,8 +1131,8 @@
 
 Turn on/off secondary screen scroll (default enabled). If 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.
+scrollback buffer and, when secondaryScreen is off, switching
+to/from the secondary screen will instead scroll the screen up.
 
 =item B<hold>: I<boolean>
 
@@ -1101,6 +1141,13 @@
 it exits. Instead, it will wait till it is being killed or closed by the
 user.
 
+=item B<chdir>: I<path>
+
+Sets the working directory for the shell (or the command specified via
+B<-e>). The I<path> must be an absolute path and it must exist for
+@@RXVT_NAME@@ to start. If it isn't specified then the current working
+directory will be used; option B<-cd>.
+
 =item B<keysym.>I<sym>: I<string>
 
 Compile I<frills>: Associate I<string> with keysym I<sym>. The
@@ -1148,7 +1195,7 @@
   URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
 
 If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
-is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
+is passed to the C<on_user_command> perl handler. See the @@RXVT_NAME@@perl(3)
 manpage. For example, the F<selection> extension (activated via
 C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
 
@@ -1216,16 +1263,14 @@
 =item B<perl-eval>: I<string>
 
 Perl code to be evaluated when all extensions have been registered. See
-the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
-will be ignored when running setuid/setgid.
+the @@RXVT_NAME@@perl(3) manpage.
 
 =item B<perl-lib>: I<path>
 
 Colon-separated list of additional directories that hold extension
 scripts. When looking for extensions specified by the C<perl> resource,
 @@RXVT_NAME@@ will first look in these directories and then in
-F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
-will be ignored when running setuid/setgid.
+F<@@RXVT_LIBDIR@@/urxvt/perl/>.
 
 See the @@RXVT_NAME@@perl(3) manpage.
 
@@ -1258,6 +1303,10 @@
 Compile I<frills>: Sets override-redirect for the terminal window, making
 it almost invisible to window managers; option B<-override-redirect>.
 
+=item B<iso14755:> I<boolean>
+
+Turn on/off ISO 14755 (default enabled).
+
 =item B<iso14755_52:> I<boolean>
 
 Turn on/off ISO 14755 5.2 mode (default enabled).
@@ -1458,14 +1507,10 @@
 I<xterm>(1) where the colours are only swapped if they have not otherwise
 been specified. For example,
 
-=over 4
-
-=item B<@@RXVT_NAME@@ -fg Black -bg White -rv>
-
-would yield White on Black, while on I<xterm>(1) it would yield Black
-on White.
+   @@RXVT_NAME@@ -fg Black -bg White -rv
 
-=back
+would yield White on Black, while on I<xterm>(1) it would yield Black on
+White.
 
 =head2 ALPHA CHANNEL SUPPORT
 
@@ -1555,7 +1600,8 @@
 =item B<DISPLAY>
 
 Used by @@RXVT_NAME@@ to connect to the display and set to the correct
-display in its child processes.
+display in its child processes if C<-display> isn't used to override. It
+defaults to C<:0> if it doesn't exist.
 
 =item B<SHELL>