--- rxvt-unicode/doc/rxvt.1.pod	2008/01/23 14:33:42	1.158
+++ rxvt-unicode/doc/rxvt.1.pod	2008/06/15 13:54:15	1.164
@@ -94,15 +94,20 @@
 
 =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>
 
 Compile I<xft>: Attempt to find a visual with the given bit depth;
 resource B<depth>.
 
+[Please note that many X servers (and libXft) are buggy with
+respect to C<-depth 32> and/or alpha channels, and will cause all sorts
+of graphical corruption. This is harmless, but we can't do anything about
+this, so watch out]
+
 =item B<-geometry> I<geom>
 
 Window geometry (B<-g> still respected); resource B<geometry>.
@@ -452,6 +457,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>
@@ -569,6 +580,13 @@
 Compile I<xft>: Attempt to find a visual with the given bit depth;
 option B<-depth>.
 
+=item B<buffered:> I<boolean>
+
+Compile I<xft>: Turn on/off double-buffering for xft (default enabled).
+On some card/driver combination enabling it slightly decreases
+performance, on most it greatly helps it. The slowdown is small, so it
+should normally be enabled.
+
 =item B<geometry:> I<geom>
 
 Create the window with the specified X window geometry [default 80x24];
@@ -1079,8 +1097,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>
 
@@ -1089,6 +1107,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
@@ -1455,7 +1480,7 @@
 
 =back
 
-=head2 ALPHA CHANNEL SUPPORT / TRANSPARENT COLOURS
+=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 do it's own alpha channel management:
@@ -1543,7 +1568,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>