--- sourceforge.net/trunk/rdesktop/doc/rdesktop.1	2003/10/20 21:04:40	507
+++ sourceforge.net/trunk/rdesktop/doc/rdesktop.1	2004/08/09 13:50:41	747
@@ -1,4 +1,4 @@
-.TH rdesktop 1 "October 2002"
+.TH rdesktop 1 "January 2004"
 .SH NAME
 .I rdesktop
 \- Remote Desktop Protocol client
@@ -7,14 +7,14 @@
 .br
 .SH DESCRIPTION
 .I rdesktop
-is a client for Microsoft Windows NT Terminal Server, Windows 2000 Terminal
-Services, Windows XP Remote Desktop, and possibly other Terminal Services
-products.  rdesktop currently implements the RDP version 4 protocol.
+is a client for Remote Desktop Protocol (RDP), used in a number of Microsoft
+products including Windows NT Terminal Server, Windows 2000 Server, Windows XP
+and Windows 2003 Server.
 
 .SH OPTIONS
 .TP
 .BR "-u <username>"
-Username for authentication on the terminal server.
+Username for authentication on the server.
 .TP
 .BR "-d <domain>"
 Domain for authentication.
@@ -22,14 +22,6 @@
 .BR "-s <shell>"
 Startup shell for the user - starts a specific application instead of Explorer.
 .TP
-.BR "-S <button size>"
-Enable single application mode. This option can be used when running a
-single, maximized application (via -s). When the minimize button of
-the windows application is pressed, the rdesktop window is minimized
-instead of the remote application. The maximize/restore button is
-disabled. For this to work, you must specify the correct button
-size, in pixels. The special word "standard" means 18 pixels. 
-.TP
 .BR "-c <directory>"
 The initial working directory for the user.  Often used in combination with -s
 to set up a fixed login environment.
@@ -54,8 +46,8 @@
 .BR "-g <geometry>"
 Desktop geometry (WxH). If geometry is the special word "workarea", the geometry
 will be fetched from the extended window manager hints property _NET_WORKAREA, from
-the root window. The geometry can also be specified in terms of percent of the whole
-screen, like "-g 80%". 
+the root window. The geometry can also be specified as a percentage of the whole
+screen, e.g. "-g 80%". 
 .TP
 .BR "-f"
 Enable fullscreen mode.  This overrides the window manager and causes the
@@ -71,8 +63,8 @@
 have a French version of NT TSE.
 .TP
 .BR "-E"
-Disable encryption from client to server.  This sends an encrypted login-packet,
-but everything after this is unencrypted. This also includes interactive logins.
+Disable encryption from client to server.  This sends an encrypted login packet,
+but everything after this is unencrypted (including interactive logins).
 .TP
 .BR "-m"
 Do not send mouse motion events.  This saves bandwidth, although some Windows
@@ -82,30 +74,102 @@
 Use private colourmap.  This will improve colour accuracy on an 8-bit display,
 but rdesktop will appear in false colour when not focused.
 .TP
+.BR "-D"
+Hide window manager decorations, by using MWM hints. 
+.TP
 .BR "-K"
 Do not override window manager key bindings.  By default rdesktop attempts
 to grab all keyboard input when it is in focus.
 .TP
+.BR "-S <button size>"
+Enable single application mode. This option can be used when running a
+single, maximized application (via -s). When the minimize button of
+the windows application is pressed, the rdesktop window is minimized
+instead of the remote application. The maximize/restore button is
+disabled. For this to work, you must specify the correct button
+size, in pixels. The special word "standard" means 18 pixels. 
+.TP
 .BR "-T <title>"
-Window title.
+Sets the window title.
 .TP
-.BR "-D"
-Hide window manager decorations, by using MWM hints. 
+.BR "-N"
+Enable numlock syncronization between the Xserver and the remote RDP
+session.  This is useful with applications that looks at the numlock
+state, but might cause problems with some Xservers like Xvnc. 
+.TP
+.BR "-X <windowid>"
+Embed rdesktop-window in another window. The windowid is expected to
+be decimal.
 .TP
 .BR "-a <bpp>"
-Use bpp as colourdepth for the connection. Supported are 8, 15, 16 and 24.
-More than 8 bpp are only supported when connecting to Windows XP or
-Windows Server 2003.
+Sets the colour depth for the connection (8, 15, 16 or 24).
+More than 8 bpp are only supported when connecting to Windows XP
+(up to 16 bpp) or newer.  Note that the colour depth may also be
+limited by the server configuration.
+.TP
+.BR "-x <experience>"
+Changes default bandwidth performance behaviour for RDP5. By default only
+theming is enabled, and all other options are disabled (corresponding
+to modem (56 Kbps)). Setting experience to b[roadband] enables menu
+animations and full window dragging. Setting experience to l[an] will
+also enable the desktop wallpaper. Setting experience to m[odem]
+disables all (including themes). Experience can also be a hexidecimal
+number containing the flags.
+.TP
+.BR "-P"
+Enable caching of bitmaps to disk (persistent bitmap caching). This generally
+improves performance (especially on low bandwidth connections) and reduces
+network traffic at the cost of slightly longer startup and some disk space.
+(10MB for 8-bit colour, 20MB for 15/16-bit colour and 30MB for 24-bit colour
+sessions)
+.TP
+.BR "-r <device>"
+Enable redirection of the specified device on the client, such
+that it appears on the server. Note that the allowed
+redirections may be restricted by the server configuration.
+
+Following devices are currently supported:
+.TP
+.BR "-r comport:<comport>=<device>,..."
+Redirects serial devices on your client to the
+server. Note that if you need to change any settings on the serial device(s),
+do so with an appropriate tool before starting rdesktop. In most
+OSes you would use stty. Bidirectional/Read support requires Windows XP or newer.
+In Windows 2000 it will create a port, but it's not seamless, most
+shell programs will not work with it.
+.TP
+.BR "-r disk:<sharename>=<path>,..."
+Redirects a path to the share \\\\tsclient\\<sharename> on the server
+(requires Windows XP or newer). The share name is limited to 8
+characters. 
+.TP
+.BR "-r lptport:<lptport>=<device>,..."
+Redirects parallel devices on your client to the server.
+Bidirectional/Read support requires Windows XP or newer. In Windows 2000
+it will create a port, but it's not seamless, most shell programs will not work with
+it.
+.TP
+.BR "-r printer:<printername>[=<driver>],..."
+Redirects a printer queue on the client to the server. The <printername>
+is the name of the queue in your local system. <driver> defaults to a
+simple PS-driver unless you specify one. Keep in mind that you need a
+100% match in the server environment, or the driver will fail. The first
+printer on the command line will be set as your default printer.
+.TP
+.BR "-r sound:[local|off|remote]"
+Redirects sound generated on the server to the client. "remote" only has
+any effect when you connect to the console with the -0 option. (Requires
+Windows XP or newer).
 .TP
 .BR "-0"
-Attach to the console of the Server.
+Attach to the console of the server (requires Windows Server 2003
+or newer).
 .TP
 .BR "-4"
 Use RDP version 4.
 .TP
 .BR "-5"
 Use RDP version 5 (default).
-
 .PP
 .SH LINKS
 Main website of rdesktop