x11vnc: touchscreen uinput support and Java viewer mousewheel support. See x11vnc/ChangeLog for rest.

1 files changed, 1553 insertions, 0 deletions

diff --git a/x11vnc/RELEASE-NOTES b/x11vnc/RELEASE-NOTES
new file mode 100644
index 0000000..0d5c4b9
--- /dev/null
+++ b/x11vnc/RELEASE-NOTES
@@ -0,0 +1,1553 @@
+
+x11vnc 0.9.13	2010-12-20
+
+New in the 0.9.13 x11vnc release:
+
+	Improved support for non-X11 touchscreen devices (e.g. handheld or
+		cell phone) via Linux uinput input injection.  Additional
+		tuning parameters are added. TSLIB touchscreen calibration
+		is supported. Tested on Qtmoko Neo Freerunner.
+
+		A tool, misc/uinput.pl, is provided to diagnose uinput
+		behavior on new devices.
+
+		The env. vars. X11VNC_UINPUT_BUS and X11VNC_UINPUT_VERSION
+		are available if leaving them unset does not work.
+
+	The Linux uinput non-X11 input injection can now be bypassed:
+		events can be directly written to the /dev/input/event
+		devices specified by the user (direct_abs=..., etc.)
+
+		A -pipeinput input injection helper script,
+		misc/qt_tslib_inject.pl is provided as a tweakable
+		non-builtin direct input injection method.
+
+	The list of new uinput parameters for the above two features is:
+		pressure, tslib_cal, touch_always, dragskip, btn_touch;
+		direct_rel, direct_abs, direct_btn, direct_key.
+
+	The included SSL enabled Java VNC Viewers now handle Mouse
+		Wheel events.
+
+
+  miscellaneous new features and changes:
+
+	In -reflect mode, the libvncclient connection can now have
+		the pixel format modified via the environment
+		variables X11VNC_REFLECT_bitsPerSample,
+		X11VNC_REFLECT_samplesPerPixel, and
+		X11VNC_REFLECT_bytesPerPixel
+
+	In -create mode the following environment variables are added
+		to fine tune the behavior: FIND_DISPLAY_NO_LSOF:
+		do not use lsof(1) to try to determine the Linux VT,
+		FIND_DISPLAY_NO_VT_FIND: do not try to determine the
+		Linux VT at all, X11VNC_CREATE_LC_ALL_C_OK: do not bother
+		undoing the setting LC_ALL=C that the create_display
+		script sets.  The performance of the -create script
+		has been improved for large installations (100's of
+		user sessions on one machine.)
+
+	In -unixpw mode, one can now Tab from login: to Password.
+
+	An environment variable, X11VNC_SB_FACTOR, allows one to scale
+		the -sb screenblank sleep time from the default 2 secs.
+
+	In -rawfb mode, a bug is fixed in setting the number of bits
+		per pixel.
+
+	Documented that -grabkbd is no longer working with some/most
+		window managers (it can prevent resizing and menu posting.)
+
+	The macosx deprecated interface GetMainDevice() call is removed.
+		Compile with -DX11VNC_MACOSX_USE_GETMAINDEVICE if needed
+		for an old macosx version...
+
+	Miscellaneous code cleanup.
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.12	2010-09-10
+
+New in the 0.9.12 x11vnc release:
+
+	One can now specify the maximum number of displays
+		that can be created in -create mode via the
+		env. var. X11VNC_CREATE_MAX_DISPLAYS
+
+	The X11VNC_NO_LIMIT_SHM env. var. is added to skip any
+		automatic shared memory reduction.
+
+	The kdm display manager is now detected when trying not to get
+		killed by the display manager.
+
+  miscellaneous new features and changes:
+
+	A compile error is fixed when using --with-system-libvncserver
+		pointing to LibVNCServer 0.9.7.
+
+	-nevershared -forever usage mode is documented.
+
+	Old SuSE broken thread local storage is documented.
+
+	x11vnc exit cases are documented.
+
+	A compile bug from forced use of Xdefs.h is worked around.
+
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.11	2010-08-08
+
+New in the 0.9.11 x11vnc release:
+
+	The source tree is synchronized with the most recent libvncclient
+		(this only affects -reflect mode.)  The build is fixed
+		for incompatibilities when using an external LibVNCServer
+		(e.g.  ./configure --with-system-libvncserver...)
+
+	The SSL enabled Java VNC Viewer Makefile has been modified so
+		that the jar files that are built are compatible back
+		to Java 1.4.
+
+	In -reflect mode cursor position updates are now handled
+		correctly.
+
+	In -create/-unixpw mode, the env. var. FD_USERPREFS may be set
+		to a filename in the user's home directory that includes
+		default username:options values (so the options do not
+		need to be typed every time at the login prompt.)
+
+  miscellaneous new features and changes:
+
+	An option -always_inject is provided: Even if there is no
+		displacement (dx = dy = 0) for a VNC mouse event force
+		the pointer to the indicated x,y position anyway.
+
+	New java viewer debugging and workaround applet parameters:
+		debugKeyboard mapF5_to_atsign forbid_Ctrl_Alt 
+
+	You can set X11VNC_AVAHI_NAME, X11VNC_AVAHI_HOST, and/or
+		X11VNC_AVAHI_PORT environment variables to override the
+		default values. For example: -env X11VNC_AVAHI_NAME=wally
+
+	When opening the X11 display extra XAUTHLOCALHOSTNAME settings
+		are attempted.
+
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.10	2010-05-03
+
+New in the 0.9.10 x11vnc release:
+
+	IPv6 is now supported for all usage modes: forward and reverse
+		connections, SSL and unencrypted, etc.
+
+	The included SSL enabled Java VNC viewer applet now supports
+		Chained SSL Certificates (x11vnc -ssl always has.)
+		The applet autodects x11vnc and set GET=1 for faster
+		connecting via HTTPS.
+
+	A demo CGI script 'desktop.cgi' shows how to create an
+		SSL encrypted, multi-user x11vnc web login desktop
+		service.  The user logs into a secure web site and gets
+		his/her own virtual desktop and his browser accesses it
+		with the SSL Java VNC Viewer applet.
+
+	A serverCert Java Viewer applet parameter is provided.
+		Use an authenticated HTTPS browser connection to set
+		this parameter (the user could set it locally too.)
+		The onetimekey tool has -certonly option for this scheme.
+
+	The Xdummy script (use Xorg 'dummy' driver instead of Xvfb)
+		no longer requires being run as root.
+
+
+  miscellaneous new features and changes:
+
+	In the Java viewer applet, debugCerts and debugKeyboard parameters
+		are provided.  The debugging output of the applet is more
+		readable.  Some corner-case bugs (e.g. socket exceptions)
+		are now handled gracefully.  Parameters forbid_Ctrl_Alt
+		and mapF5_to_atsign are added.
+
+	The amount of time to wait for HTTPS applet downloads to finish
+		can be set in env. var. X11VNC_HTTPS_DOWNLOAD_WAIT_TIME.
+
+	The -xkb mode is automatically enabled if there are more than
+		4 keysyms per key.
+
+	-coe is now an alias for -connect_or_exit.
+
+	The -input_eagerly option enables this LibVNCServer feature
+		(it is like -allinput.)
+
+	The "%" unix password verification tricks for the -unixpw
+		option are now documented.  They also run a command
+		in UNIXPW_CMD.
+
+	In -create (-svc, etc.) modes, a warning is printed out if Xvfb
+		cannot be found.  Xvfb '+kb' option is checked for.
+		The -env CREATE_DISPLAY_OUTPUT=/tmp/mydebug.txt debugging
+		option is documented.  Try to preserve user's PATH
+		if possible.
+
+		In XDMCP connection mode, a test for GDM listening only
+		on IPv6 (::1) is performed.  The interface can also be
+		specified via FD_XDMCP_IF.
+
+	The example scripts connect_switch, ultravnc_repeater.pl, inet6to4
+		have settings to let them run reliably for long times
+		as daemons.  They also support IPv6.
+
+	IPv6 notes: for some very esoteric cases (e.g. -chatwindow)
+		IPv4 localhost may be required for local IPC.  A demo
+		transition tool 'inet6to4' is also included (can be
+		used for other apps.)  x11vnc options related to IPv6:
+		-listen6, -6, -no6, -noipv4, -noipv6, and -connect,
+		-proxy.
+
+	Use STUNNEL_LISTEN in -stunnel mode to have it listen on a
+		particular interface.  Also STUNNEL_PROG.
+
+	New remote control query options: pointer_x, pointer_y,
+		pointer_same, pointer_root, and pointer_mask. A demo
+		script using them misc/panner.pl is provided.
+
+	Remote control change of -clip option will not create new
+		framebuffer if the size has not changed (for panner.pl)
+
+	The X11VNC_DISABLE_SSL_CLIENT_MODE env. var. can be set to
+		disable SSL client role in reverse connections.  This
+		means the VNC viewer side must be in SSL client role.
+		UltraVNC repeater operation can benefit from this.
+
+		The SSL_INIT_TIMEOUT is increased to 1 hour if 'repeater'
+		is detected in a reverse connect string.
+
+	The X property X11VNC_TRAP_XRANDR can be set on a desktop to
+		force x11vnc to use the -xrandr screen size change
+		trapping code.
+
+	The -sslScripts option prints out the SSL certificate management
+		scripts.
+
+	Suggest '-auth guess' and '-findauth' if X connection fails.
+
+	The TightVNC sercurity type (TightVNC features enabler) now
+		works for RFB version 3.8.
+
+	RECORD scroll detection is now working with the new gtk/gdk scroll
+		mechanism.  Set X11VNC_SCROLL_MUST_EQUAL to disable.
+
+
+For more information:
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.9	2009-12-21
+
+
+
+New in the 0.9.9 x11vnc release:
+
+	A new option -findauth runs the FINDDISPLAY script that applies
+		heuristics to try to determine the correct XAUTHORITY
+		file.  The use of '-auth guess' will use the XAUTHORITY
+		that -findauth reveals.  This can be handy in with
+		the lastest GDM where the ability to store cookies in
+		~/.Xauthority has been removed.
+
+		If x11vnc is running as root (e.g. inetd or XDM/GDM/KDM)
+		the FD_XDM=1 mode will be tried if the above -findauth
+		or '-auth guess' command fails; it will find the
+		correct XAUTHORITY for the given display (this works for
+		XDM/GDM/KDM if the login greeter panel is up or if someone
+		has already logged into an X session.)	You can also
+		set -env FD_XDM=1 to force it to be done on the first try.
+
+	The -unixpw_system_greeter option, when used in combined
+		unixpw and XDMCP FINDCREATEDISPLAY mode (e.g. -xdmsvc),
+		enables the user to press Escape to jump directly to the
+		XDM/GDM/KDM login greeter screen.  This way the user
+		avoids entering his unix password twice at X session
+		creation time.	For subseqent logins to the same session,
+		he uses the regular x11vnc unixpw "login:" prompt.   Also,
+		the unixpw login panel now has a short help displayed
+		if the user presses 'F1' that lists the options.
+
+	The -appshare option enables simple application sharing based on
+		the -id/-sid mechanism.  Every new toplevel window that
+		the application creates induces a new viewer window via
+		a reverse connection.  The -id/-sid and -connect options
+		are required.  Run 'x11vnc -appshare -help' for more info.
+
+	Heuristics are applied to try to determine if the X display
+		is currently in a Display Manager Greeter Login panel
+		(e.g. GDM.)  If so, x11vnc's creation of any windows and
+		use of XFIXES are delayed.
+
+		This is to try to avoid x11vnc being killed after the user
+		logs in if the GDM KillInitClients=true is in effect.
+		So one no longer needs to set KillInitClients=false in
+		gdm.conf.  Note that in recent GDM the KillInitClients
+		option has been removed.
+
+		Also delayed is the use of the XFIXES cursor fetching
+		functionality; this avoids an Xorg bug that causes Xorg
+		to crash right after the user logs in.
+
+	x11vnc now tries to be more aggressive in keeping up with VNC
+		client's framebuffer update requests.  Some broken VNC
+		clients continuously spray these requests at VNC servers
+		(regardless of whether they have received any updates
+		or not.)  The -extra_fbur option allows one to fine tune
+		the setting.
+
+	The "-display WAIT:cmd=...", -find, -create modes now work
+		correctly for the user-supplied login program scheme
+		"-unixpw_cmd ...", as long as the login program supports
+		running commands specified in the environment variable
+		"RFB_UNIXPW_CMD_RUN" as the logged-in user.  The mode
+		"-unixpw_nis ..." has also been made more consistent.
+		The username option "tag=..." can be used to set FD_TAG.
+
+	The -stunnel option (like -ssl but uses stunnel as an external
+		helper program) now works with the -ssl "SAVE" and "TMP"
+		special certificate names.  The -sslverify and -sslCRL
+		options now work correctly in -stunnel mode.  Single port
+		HTTPS connections are also supported for this mode.
+
+	The remote control command -R can be used to instruct x11vnc
+		to resend its most recent copy of the Clipboard,
+		Primary, or Cutbuffer selections: "x11vnc -R
+		resend_clipboard", "x11vnc -R resend_primary", and
+		"x11vnc -R resend_cutbuffer".
+
+  miscellaneous new features and changes:
+
+	The fonts in the GUI (-gui) can now by set via environment
+		variables, e.g. -env X11VNC_FONT_BOLD='Helvetica -16 bold'
+		and -env X11VNC_FONT_FIXED='Courier -14'.
+
+	The value of the -timeout option is now also used for the timing
+		out of reverse connections.  The -timeout exit will
+		occur if no client has made it to normal operating state
+		(instead of merely trying to connect.)
+
+	One can add extra URL parameters to the HTTPS (-ssl) urls
+		via X11VNC_EXTRA_HTTPS_PARAMS without needing to edit
+		index.vnc. E.g.: -env X11VNC_EXTRA_HTTPS_PARAMS='?GET=1'
+
+	One can make the libvncserver HTTP (non-SSL) server listen on
+		localhost: -env X11VNC_HTTP_LISTEN_LOCALHOST=1 (this way
+		only the single-port VNC+HTTPS is exposed to the network.)
+
+	Warnings are printed out at startup if $DISPLAY appears to
+		start with "localhost:" (SSH X11 forwarding) or 
+		"hostname:" (remote X display; will fail w/o -noshm)
+
+	The -solid option now uses the DBUS_SESSION_BUS_ADDRESS env. var
+		if available.  The -solid option now works in xfce.
+		If available, the dbus_launch(1) will be used in
+		FINDCREATEDISPLAY for gnome sessions.
+
+	The bcx_xattach remote control command was added to facilitate
+		xattach and x2x desktop cursor switching.  Other new
+		remote control commands: grab_state, ping:mystring,
+		grablocal, resend_cutbuffer, resend_clipboard,
+		resend_primary, keycode, keysym, fakebuttonevent,
+		ptr, sleep, get_xprop, set_xprop, wininfo, pointer_pos,
+		mouse_xy, noop, guess_dbus, DIRECT:query.  Remote control
+		scripting, -query_retries, and -remote_prefix were
+		also added.
+
+	In -rawfb mode the X display will not be opened at all unless
+		the -rawfb string is prefixed with '+' or -display
+		was specified on the cmdline.
+
+	For multiple, separate x11vnc instances on the same X display,
+		one can rename the X11VNC_REMOTE, X11VNC_TICKER, and
+		VNC_CONNECT property names to unique ones.
+
+	The -showrfbauth option prints out the VNC rfbauth password.
+
+	The XDAMAGE mechanism is now automatically disabled for a
+		period of time if a game or screensaver generates too
+		many XDAMAGE rectangles per second.  This avoids the X11
+		event queue from soaking up too much memory.
+
+	x11vnc does not switch on server autorepeat if any keys are
+		pressed down to work around a recent Xorg server and/or
+		gnome bug where the key will never stop repeating.
+
+	Thse list of current clients is kept more up-to-date in the
+		tkx11vnc gui.  Bugs in the gui setpass mode have been
+		fixed.
+
+	Threads stability is further improved.  See under the -threads
+		option help info about -env X11VNC_THREADS_NEW_FB_SLEEP=ms
+
+	There is an experimental workaround: "-env X11VNC_WATCH_DX_DY=1"
+		that tries to avoid problems with poorly constructed
+		menu themes that place the initial position of the mouse
+		cursor inside a menu item's active zone.
+
+	The crypt(3) function is now declared inside the x11vnc code on
+		all platforms (not just Linux).  To disable this, set
+		CPPFLAGS='-DDO_NOT_DECLARE_CRYPT' while configuring.
+		(crypt is declared to avoid problems with header files.)
+
+	Error reasons are printed for -storepasswd failures.
+
+	Two scripts are added to x11vnc/misc: connect_switch and
+		ultravnc_repeater.pl
+
+For more information:
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.8	2009-07-08
+
+
+New in the 0.9.8 x11vnc release:
+
+	Better reliability for the Java Viewer applet when connecting
+		through a Web Proxy via HTTPS.	A proxy hostname
+		and port can be specified via applet parameters.
+		Proxy Authentication via Auth-Basic is supported.
+		More x11vnc printout in -ssl is provided to help
+		troubleshoot this mode and other ssl connections.
+
+	Stability improvements to -threads mode. Running x11vnc this
+		way is more reliable now. Threaded operation sometimes
+		gives better interactive response and faster updates. The
+		threaded mode now supports multiple VNC viewers using
+		the same VNC encoding (some only on Linux or enabled
+		at build time.)  The threaded mode can also yield
+		a performance enhancement in the many client case
+		(e.g. class-room broadcast.) We have tested with 30 to
+		50 simultaneous clients.  See also -reflect.
+
+
+  miscellaneous new features and changes:
+
+	x11vnc automatically tries to work around an Xorg server bug
+		involving infinitely repeating keys when turning off key
+		repeating. Use -repeat if the automatic workaround fails.
+		Also, the environment variable X11VNC_IDLE_TIMEOUT
+		(seconds) is provided.
+
+	In -reflect mode the environment variable X11VNC_REFLECT_PASSWORD
+		is provided.
+
+	The -clip mode works under -rawfb.
+
+	The -nounixpw option can disable unixpw mode if an earlier option
+		enables it (e.g. -svc).
+
+	Scroll detection is skipped for windows with 'OpenOffice' in
+		their name.
+
+
+For more information:
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.7	2009-03-31
+
+
+New in the 0.9.7 x11vnc release:
+
+	Basic support for building with VirtualGL's TurboVNC (an
+		enhanced TightVNC for fast LAN high framerate usage)
+		encoding and TightVNC modifications.  More info:
+		http://www.karlrunge.com/x11vnc/faq.html#faq-turbovnc
+		and x11vnc/misc/turbovnc/README.
+
+	The -ncache_cr option has been fixed and so in -ncache mode
+		smooth opaque window motions are now work correctly. Try
+		it out to see how smooth it is even on a slow link.
+
+	Support for Linux text consoles (virtual terminals, e.g. 1-6)
+		is provided via, e.g., 'x11vnc -rawfb vt2' (for virtual
+		terminal #2).
+
+		This is like LinuxVNC (i.e. text only), it avoids using
+		/dev/fb and uses /dev/vcsaN instead (the '-rawfb console'
+		mode uses /dev/fb.)  With /dev/vcsaN the text terminal
+		is accessible even it if is not the currently active one.
+
+	The -rawfb option now supports framebuffers with bits per pixel
+		less than 8 (e.g. 4 or 1 bpp.)
+
+	Reverse connections now work in Anonymous Diffie Hellman SSL/TLS
+		mode.  Reverse connections also work for VeNCrypt and
+		ANONTLS modes.
+
+
+  miscellaneous new features and changes:
+
+	The included SSL enabled UltraVNC java viewer now has a
+		configurable [Home] entry in the drives drop down menu.
+
+	In the -create, -svc, etc. modes one can now specify a
+		range of X displays to ignore in X11VNC_SKIP_DISPLAY.
+		Improvements and bugfixes were made to the find_display
+		and create_display scripts.  FD_EXTRA option is provided.
+
+	The '-rawfb video' option finds the video device file more
+		carefully.
+
+	The -rmflag option allows a new way to indicate to other
+		applications that x11vnc has started.
+
+	All of the java applet parameters are now documented in
+		the classes/ssl/README file.
+
+	There is now a "sendbell" remote control command.
+
+	A one-time -padgeom once:WxH mode is added.
+
+	Improvements to the CUPS Terminal Services helper mode.
+
+	If the X display cannot be opened normally then the env. var.
+		XAUTHLOCALHOSTNAME=localhost is tried.
+
+	Bugfix for selection transfer to a now non-existent X window
+		(Thunderbird can cause this.)  Related, the env. variable
+		LIBXCB_ALLOW_SLOPPY_LOCK is now set by default.
+
+	Bugfix for -8to24 mode due to nonstandard indexed color support.
+
+	The libvncserver and x11vnc autoconf/automake settings have
+		been improved.
+
+	libXrandr include file is now found on Solaris.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.6	2008-12-10
+
+
+New in the 0.9.6 x11vnc release:
+
+	x11vnc's SSL encryption is extended to support the VeNCrypt and
+		TLS (older; vino) SSL/TLS security type extensions to VNC.
+
+	Anonymous Diffie-Hellman key exchange (-ssl ANON) and Certificate
+		Revocation List support (-sslCRL) is added to the SSL
+		encryption mode.
+
+	The Java viewer applet can now be served up through the VNC port
+		(5900) in addition to the normal HTTP port (5800) via
+		the -http_oneport option.  Previously this only worked
+		for SSL connections and HTTPS.
+
+	The "-rfbport PROMPT" mode presents a simple gui for the user
+		to select a port for the x11vnc service and a few other
+		settings.  This enables a menu entry for naive users
+		that is included in x11vnc.desktop.
+
+	If x11vnc is not built with the Avahi Zeroconf library an external
+		helper program (avahi-publish or dns-sd on Mac OS X)
+		is used instead.
+
+  miscellaneous new features and changes:
+
+	The default mode for '-ssl' is now the '-ssl SAVE' mode; i.e.
+		the generated certificate is saved and reused in
+		subsequent sessions rather than being discarded.
+		Use '-ssl TMP' recover the old way.  This change made
+		to for it to be more likely that the VNC Viewer can save
+		the accepted cert for future authentications.
+
+	The solid background color option works on the Mac OS X console.
+
+	The -reopen option enables x11vnc to try to re connect to the X
+		display if GDM (or other display manager) kills it just
+		after the user logs in.
+
+	The -dhparams option can be used to point to your own Diffie
+		Hellman parameters.
+
+	The -setdefer option allows tuning how quickly updates will
+		be sent.  Default setting tuned.
+
+	The option -zeroconf is now an alias for -avahi/-mdns.
+
+	In pipeinput mode, the pipe filehandle is now closed when
+		x11vnc exits.
+
+	The -sshonly option turns off VeNCrypt and TLSVNC (vino) mod
+		leaving only the standard SSL (i.e. vncs://)
+
+	For testing, the option -rand in an alias for -rawfb rand -nopw
+
+	Minor tweaks to improve CUPS Print tunneling.
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.5	2008-10-24
+
+
+New in the 0.9.5 x11vnc release:
+
+	Symmetric key encryption using the RC4, AES, Blowfish, and 3DES
+		ciphers is supported via the -enc cipher:keyfile option.
+		The SSVNC unix viewer 1.0.20 and later supports these
+		encryption methods.
+
+	Server-side scaling can now have different scale factors along
+		the horizontal and vertical axes.  E.g. -scale 1280x1024
+		(same as -geometry 1280x1024) or -scale 0.8x0.75
+
+	The -chatwindow option allows a chat window to appear on the
+		X console during UltraVNC chats (requires the SSVNC
+		viewer package.)
+
+  miscellaneous new features and changes:
+
+	The HTTP Java viewer applet jar, classes/VncViewer.jar, has
+		been updated with an improved implementation based on
+		the code used by the classes/ssl applets.
+
+	A description and instructions are now printed out when
+		X_ShmAttach fails if one tries to attach to a remote
+		$DISPLAY (i.e. $DISPLAY is on a different machine from
+		the machine x11vnc is running on; this often happens
+		with SSH X redirection, X terminal servers, etc).
+
+	The -allow option now works correctly in -ssl mode.
+
+	The -remap option now works on the MacOSX console.
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.4	2008-09-17
+
+
+New in the 0.9.4 x11vnc release:
+
+	Reverse VNC connections (-connect and  -connect_or_exit options)
+		work in the -find and -create X session FINDCREATEDISPLAY
+		modes.
+
+	Reverse VNC connections (either normal or using SSL) can use a
+		Web Proxy, a SOCKS proxy, the UltraVNC repeater proxy,
+		an SSH connection, or even a CGI URL to make the outgoing
+		connection (-proxy option).  Forward connections can
+		use the -ssh option to set up a reachable redirection.
+
+	Support for the ZYWRLE encoding is added, this is the RealVNC ZRLE
+		encoding extended to do motion video and photo regions
+		more efficiently by way of a Wavelet based transformation.
+
+	The session finding and creating modes (-find and -create) have
+		been improved to be more reliable and also provide a new
+		desktop types (xfce) and new service redirection options.
+
+	Support for indexed colormaps (PseudoColor) with depths other
+		than 8 is provided (depths 1 to 16 now work).
+
+	Java viewer applet source code is provided in the x11vnc 0.9.4
+		tarball so now everything can be built from source.  
+
+  miscellaneous new features and changes:
+
+	To unset Caps_Lock, Num_Lock and raise all keys in the X server
+		use -clear_all, or by remote control 'x11vnc -R clear_all'
+
+	The -autoport option gives more control over the server port
+		range that probes.
+
+	The -ping option can be used to help keep idle connections alive.
+
+	The -finddpy and -listdpy utilities help to debug and configure
+		the -find, -create, and -display WAIT:... modes.
+
+	Some automatic detection of screen resizes are handled even if
+		the -xrandr option is not supplied.
+
+	The -advertise_truecolor option can workaround some VNC viewer
+		incompatibilities with PseudoColor.
+
+	The option '-clip xinerama0' can be used to clip to the first
+		Xinerama sub-screen, etc.
+
+	If a fast framebuffer read rate is detected the -wait and -defer
+		parameters are reduced to 10 and 15 msec, respectively.
+
+	Pasting of the selection/clipboard into remote applications
+		(e.g. Java) is improved.
+
+	Usage with dvorak keyboards is improved.  The option -macuskbd is
+		available on MacOSX to use the original US keyboard code.
+
+	Via a compiler option (-DENABLE_GRABLOCAL) one can use the
+		-grablocal n option to filter VNC client input if someone
+		at the console has done mouse or keyboard input n secs ago. 
+
+	The -sleepin option can now sleep a random amount of time between
+		min and max time delays (-sleepin min-max).
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.3	2007-10-04
+
+
+New in the 0.9.3 x11vnc release:
+
+	This release provides client-side caching to improve interactive
+	response.  Almost no VNC viewers implement caching which is why
+	VNC is slow compared to other remote graphics protocols.
+
+	The x11vnc caching will work with any VNC viewer, but they will
+	not hide the pixmap cache region that is below the main desktop
+	(one must adjust the window manually).  The SSVNC Unix VNC viewer,
+	however, automatically detects and hides the region.
+
+	To enable caching, supply "-ncache n" to x11vnc, where the
+	number n, e.g. 10, indicates how much memory to devote to the
+	caching scheme.
+
+	See http://www.karlrunge.com/x11vnc/#faq-client-caching
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.2	2007-06-18
+
+
+New in the 0.9.2 x11vnc release:
+
+	A compile-time bug is fixed for when the OpenSSL library is not
+		available or --without-ssl is supplied; previously the
+		build would fail.
+
+	One can configure x11vnc via "configure --with-system-libvncserver"
+		to use a system installed libvncserver library instead of
+		the one bundled in the release tarball. 
+
+	If UltraVNC file transfer or chat is detected, then VNC clients
+		are "pinged" more often to prevent these side channels
+		from becoming serviced too infrequently.
+
+	In -unixpw mode in the username and password dialog no text will
+		be echoed if the first character sent is "Escape".  This
+		enables a convenience feature in SSVNC to send the username
+		and password automatically.  
+
+  miscellaneous new features and changes:
+
+	When building from the CVS tree --with-x11vnc must be supplied if
+		you want x11vnc to be built.  The LibVNCServer release
+		tarball no longer contains the x11vnc source.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9.1	2007-05-24
+
+
+New in the 0.9.1 x11vnc release:
+
+	A new Unix username identification scheme is provided when
+		SSL client certificates are used to authenticate VNC
+		viewers.  The username is extracted from the 'Subject'
+		section of the cert.  The option is "-users sslpeer="
+		which, like "-users unixpw=" already does, will cause
+		a switch to the Unix user.  This is useful for the
+		-find and -create options that try to find an existing
+		X session associated with the user or create a new one.
+
+	The UltraVNC Java Viewer has been modified to support SSL
+		connections.  Some bugs were also fixed and some
+		improvements added.  A patch file and a compiled jar file
+		(UltraViewerSSL.jar and SignedUltraViewerSSL.jar in the
+		classes/ssl directory) are provided in the x11vnc package.
+
+	For the -user option groups are now handled better by using
+		initgroups(3), or if finer control is needed one can
+		use: "-users user1.group1,..."
+
+	When SSL client certification is being used and external login
+		programs are being used the env. var. RFB_SSL_CLIENT_CERT
+		is set to the clients certificate.  Set X11VNC_SSLPEER_CN
+		to use the Common Name instead of the certificate email
+		address to find the unix username.
+
+  miscellaneous new features and changes:
+
+	The -wait and -defer defaults were lowered from 30 to 20
+		milliseconds, set the values explicitly if this increases
+		the load too much for your liking.
+
+	In -create mode where a Xvfb session is started, mwm was added
+		as a session type.  setpgrp(2) is used for the spawned
+		process if available.  The XKEYBOARD extension is 
+		enabled (+kb, but it doesn't seem to always work).
+		TrueColor is forced to be the default visual (recent
+		Xvfb seem to choose DirectColor, this is likely a bug)
+		One can also force creating a new Xvfb by setting the
+		env. var. X11VNC_FINDDISPLAY_ALWAYS_FAILS (not exactly
+		clear what this would be used for). 
+
+	The WAITBG env. var. enables -display WAIT:... to take place in
+		the background.
+
+	One can specify the X11VNC_SKIP_DISPLAY env. var. for a list of
+		displays to exclude in the FINDDISPLAY action.	This can
+		also be specified via nd=... as a -unixpw login option.
+
+	setsid() or setpgrp() is called for the external command spawned
+		by the -gone option (since it may be long lived, e.g. a
+		screen locker).
+
+	The script "onetimekey" utility is provided in the classes/ssl
+		subdirectory that allows a (very long) string representing
+		a Client SSL certificate to be provided by the authenticating
+		client, or via https cgi script (e.g. after a web login).
+
+	Some bugs were fixed in the libvncserver implementation of
+		UltraVNC file transfer.
+
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.9	2007-04-18
+
+
+New in the 0.9 x11vnc release:
+
+	VNC Service advertising via mDNS / ZeroConf / BonJour with the
+		Avahi client library. Enable via "-avahi".
+
+	Implementations of UltraVNC's TextChat, SingleWindow, and
+		ServerInput extensions (requires ultravnc viewer or ssvnc
+		Unix viewer). They toggle the selection of a single window
+		(-id), and disable (friendly) user input and viewing
+		(monitor blank) at the VNC server.
+
+	Short aliases "-find", "-create", "-svc", and "-xdmsvc" for
+		commonly used FINDCREATEDISPLAY usage modes (to find
+		the user's display or create one, etc).
+
+	Reverse VNC connections (viewer listening) now work in SSL
+		(-ssl) mode.
+
+  miscellaneous new features and changes:
+
+	New options to control the Monitor power state and keyboard/mouse
+		grabbing: -forcedpms, -clientdpms, -noserverdpms,
+		and -grabalways.
+
+	A simple way to emulate inetd(8) to some degree via the "-loopbg"
+		option.
+
+	Monitor the accuracy of XDAMAGE and apply "-noxdamage" if it is
+		not working well. OpenGL applications like like beryl and
+		MythTv have been shown to make XDAMAGE not work properly.
+
+	For Java SSL connections involving a router/firewall port
+		redirection, an option -httpsredir to spare the user
+		from needing to include PORT=NNN in the browser URL.
+
+	A -sleepin n option to delay startup by n seconds to let redirs
+		and listening clients to get started.
+
+	TightVNC file transfer is now off by default; enable via
+		-tightfilexfer
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.8.4	2007-02-01
+
+
+New in the 0.8.4 x11vnc release:
+
+	Native Mac OS X Aqua/Quartz support.  It exports the full
+		display (no X11 server, etc).
+
+		This provides an alternative to OSXvnc; some activities
+		are faster (and see the client-side caching feature
+		-ncache in the 0.8.5 development version for more
+		speedups).
+
+	x11vnc can act as a VNC reflector/repeater using the
+		"-reflect host:N" option.  This is useful for large
+		classroom broadcasting or demos.  You set up a number
+		of reflectors to spread the network and CPU load around
+		for better response.
+
+	A new login mode: "-display WAIT:cmd=FINDCREATEDISPLAY -unixpw ..."
+		that will Create a new X session (Xvfb, Xdummy, or
+		Xorg) for the user if it cannot find the user's X
+		session display via the FINDDISPLAY method.  It will
+		be re-found upon reconnection.
+
+		This enables a simple "terminal services" mode based on
+		Unix username and password and where the user does not
+		have to memorize their VNC display number, etc.
+
+
+  miscellaneous new features and changes:
+
+	Option -nodpms to avoid problems with programs like KDE's
+		kdesktop_lock that keep restarting the screen saver
+		every few seconds even with active VNC clients connected.
+
+	The "-N" option couples the VNC Display number to the X Display
+		number. E.g. if your X DISPLAY is :2 then the VNC display
+		will be :2 (i.e. using port 5902). If that port is taken
+		x11vnc will exit.
+
+	Wireframe copyrect detection for local user activity (e.g. someone
+		sitting at the physical display moving windows).  You
+		can disable this with the -nowireframelocal option.
+
+	To automatically fix the common mouse motion problem on XINERAMA
+		(multi-headed) displays, the -xwarppointer option is
+		enabled by default when XINERAMA is active.  You can
+		disable this with the -noxwarppointer option.
+
+	By default in -reflect mode -shared is implied (it makes sense),
+		use -noshared after the -reflect option to disable this. 
+
+	The -prog option lets you specify the full path (argv[0]) to
+		the program, in case it is spawned by inetd/tcpd and
+		cannot determine its path.  The path is needed for the
+		-http option to guess the http classes directory.
+
+	Usually not needed, but there are many options for tuning the
+		native Mac OS X mode: -macnodim -macnosleep -macnosaver
+		-macnowait -macwheel -macnoswap -macnoresize -maciconanim
+		-macmenu.
+
+	An option -debug_xdamage has been added for debugging and profiling.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.8.3	2006-11-13
+
+
+New in the 0.8.3 x11vnc release:
+
+	The -ssl option provides SSL encryption and authentication
+		natively via the www.openssl.org library.  One can use
+		from a simple self-signed certificate server certificate
+		up to full CA and client certificate authentication schemes.
+
+	The -sslverify option allows for authenticating VNC clients via
+		their certificates in either -ssl or -stunnel modes.
+
+	Certificate creation and management tools are provide in the
+		-sslGenCert, -sslGenCA, and related options.
+
+	An SSL enabled Java applet VNC Viewer applet is provided in
+		classes/ssl/VncViewer.jar.
+
+		The applet may also be loaded into the web
+		browser via HTTPS, i.e one can use the VNC port,
+		e.g. https://host:5900/
+
+		See our "Enhanced TightVNC Viewer" project, for native
+		SSL enabled viewers.
+
+	The -unixpw option supports Unix username and password
+		authentication. The -ssl or -localhost and -stunnel
+		options (or detection of an SSH tunnel) are enforced in
+		this mode to prevent password sniffing.
+
+	Coupling -unixpw with -display WAIT:cmd=FINDDISPLAY provides a
+		way to allow a user to login with their UNIX password
+		and have their display connected to automatically.
+
+	Hooks are provided in the -unixpw_cmd and "-passwdfile cmd:,custom:..."
+		options to allow you to supply your own authentication
+		and password lookup programs (e.g. LDAP).
+
+	The "-ultrafilexfer" alias is provided and improved UltraVNC
+		filetransfer rates have been achieved.
+
+	The -rotate option enables you to rotate or reflect the screen
+		before exporting via VNC. This is intended for use on
+		handhelds and other devices where the rotation orientation
+		is not "natural".
+
+  miscellaneous new features and changes:
+
+	Similar to -ssl, the -stunnel option starts up a SSL tunnel server
+		stunnel (that must be installed separately on the system)
+		to allow only encrypted SSL connections from the network.
+
+	Option -sslnofail to exit immediately if there are any SSL
+		connection failures.
+
+	A simpler variant of -unixpw is the -unixpw_nis option that
+		works in environments where the encrypted passwords are
+		readable, e.g. NIS.
+
+	x11vnc can be configured and built to not depend on X11 libraries
+		"./configure --without-x" for -rawfb only operation
+		(e.g. embedded linux console devices).
+
+	Add -cursor_drag to change the mouse cursor during Drag and Drop, etc.
+
+	Under the "-connect_or_exit host" option x11vnc will exit
+		immediately unless the reverse connection to host
+		succeeds. The "-rfbport 0" option disables TCP listening
+		for connections (useful for this mode).
+
+	The "-rawfb rand" and "-rawfb none" options are useful for
+		testing automation scripts, etc., without requiring a
+		full desktop.
+
+	Reduced spewing of information at startup, use "-verbose" (also
+		"-v") to turn it back on for debugging.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.8.2	2006-07-13
+
+
+New in the 0.8.2 x11vnc release:
+
+	Support for full mouse and keyboard input into the Linux
+		console framebuffer /dev/fb0 in -rawfb mode
+		(i.e. non-X11) by using the Linux "uinput" driver.
+
+		This enables, for example, viewing and interacting
+		with Qt-embedded/Qtopia-Core apps on Linux-based
+		handhelds, etc.
+
+		Options:   -rawfb cons, -pipeinput UINPUT More info:
+		http://www.karlrunge.com/x11vnc/#faq-qt-embedded
+
+	Extension of the display option: -display WAIT:<disp-or-cmd>
+		to delay x11vnc's opening of the X display
+		until a VNC client connects (useful built-in:
+		-display WAIT:cmd=FINDDISPLAY, to find a user's
+		display and Xauthority data).
+
+	Options -grabkbd and -grabptr have x11vnc try to grab
+		the X display when VNC clients are connected to
+		prevent a (non-malicious) user at the physical X
+		display from performing keyboard or mouse input.
+		E.g. remote help-desk support.
+	
+
+  miscellaneous new features and changes:
+
+	-allowedcmds option to fine-tune which external commands
+		may be run by x11vnc, rather than shutting
+		them all off with -nocmds.
+
+	-env VAR=VALUE convenience option to avoid the need of
+		setting environment variables before starting
+		x11vnc.
+
+	-allinput option to enable libvncserver handleEventsEagerly
+		parameter (not clear it yields an improvement).
+
+	-rawfb rand  fun/testing option using /dev/urandom as a fb.
+
+	-license, -copying, -warranty option.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.8.1	2006-06-03
+
+New in the 0.8.1 x11vnc release:
+
+	Improved support for webcams and tv tuners with video4linux
+		/dev/video: see the "-rawfb video" and "-pipeinput VID"
+		options. (the latter gives a simple keyboard control
+		of a tv tuner; see also the -freqtab option for stations).
+
+	FBPM support for hardware that provides framebuffer power
+		management (it needs to be disabled when vnc clients
+		are connected).
+
+	The -usepw option will require x11vnc to use a password of 
+		some sort or otherwise exit immediately.  Put it in
+		your ~/.x11vncrc so you don't forget.
+
+	The command "x11vnc -storepasswd" will prompt for a password
+		without echoing and save it in ~/.vnc/passwd
+
+	The X CLIPBOARD selection is managed in addition to the
+		X PRIMARY selection.
+
+
+  miscellaneous new features and changes:
+
+	Convenience option for accessing the Linux console: -rawfb cons
+		etc. (requires /dev/fb0 to be working).
+
+	clipboard/cut-text input can now be managed on a per-client
+		basis.
+
+	-capslock and -skip_lockkeys options can help make CapsLock work
+		better.
+
+	The Xdummy wrapper script is included in the source tree.
+
+	A mode "-gone popup" as been added.
+
+	-24to32 option to avoid 24bpp problems.
+
+	-xinerama is on by default.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.8	2006-02-13
+
+
+New in the 0.8 x11vnc release:
+
+	TightVNC file transfer support is enabled via the extension to
+		LibVNCServer added by Rohit Kumar.
+
+	The -passwdfile option has been enhanced to handle any number
+		of full-access and view only passwords in an easy to
+		maintain format, and additional features.
+
+	The -8to24 option enables multi-depth viewing on systems that do
+		not support -overlay. The 8bpp regions are transformed
+		to depth 24 TrueColor before exporting via VNC.
+
+	The x11vnc source code has gone through a major reorganization.
+		The build has been enhanced and many bugs fixed.
+
+
+  miscellaneous new features and changes:
+
+	-afteraccept option is like -accept however it enables running
+		a user supplied command after client authentication
+		has taken place. The RFB_* environment variables have
+		been extended.
+	-loop option will run x11vnc in an outer loop restarting each time
+		(useful for situations where the X server restarts often).
+	-slow_fb allows for slow polling for special purpose applications
+		(e.g. video).  -blackout noptr,WxH+X+Y,... will prevent
+	the pointer from going into a blacked out region.
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help | less
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.7.2	2005-07-11
+
+
+New in the 0.7.2 x11vnc release:
+
+	The X DAMAGE extension is supported to dramatically reduce
+		resource consumption when idle: often 20 times less;
+		and to pick up small changed regions more quickly.
+
+		DAMAGE sends events indicating damaged (modified) screen
+		rectangles to x11vnc.  These are used as hints to focus
+		the polling and also if the rectangle is below a size
+		threshold it is accepted unconditionally (i.e. dragged in
+		from the framebuffer).	Tuning is possible with -xd_area.
+
+		DAMAGE is available on recent Xorg servers and Solaris 10.
+
+	-wireframe: Heuristics are used to guess when a window is being
+		moved or resized and during this period show only a
+		moving wireframe outline.  Just like on video cards in
+		the 90's, remember?  This is to avoid window "lurching"
+		when you move or resize one opaquely.
+
+		Also, -wirecopyrect applies the VNC CopyRect encoding
+		for the moved window.  Both are on by default, use
+		-nowireframe or -nowirecopyrect to disable (aka -nowf
+		and -nowcr).
+
+	-scrollcopyrect: Sniff the X11 protocol via the RECORD extension
+		and to try to detect window scrolls (e.g. via scrollbar,
+		Up/Down arrow, etc).  When detected, the VNC CopyRect
+		encoding is applied to the scrolled regions for a speedup.
+
+		The contents of the scrolling window may only be
+		approximate while it is being scrolled: e.g. tearing,
+		bunching-up, etc.  The heuristics will also miss scrolls
+		by certain toolkits or applications, so those will still
+		happen the slow way.  To disable use -noscrollcopyrect
+		(aka -noscr).  Tuning is also available, see the -help
+		entry.
+
+	-listen: Makes x11vnc listen only on a single network interface.
+		-localhost now implies '-listen localhost'.
+
+	-rawfb: Instead of polling an X server framebuffer, poll a raw
+		one (i.e. a mapped file or a shm segment).  E.g. for
+		the linux framebuffer device:
+
+		    -rawfb map:/dev/fb0@1024x768x32
+
+		This is a bit out of x11vnc's scope but may have some
+		interesting applications.  Perhaps /dev/video?
+
+	-pipeinput: Pipe the VNC user's pointer and keyboard input events
+		to a helper program you provide.  Two examples are in
+		misc/vcinject.pl and misc/slide.pl.  Primarily intended
+		for use with -rawfb to somehow kludge-up user input,
+		but it can also be used by itself.
+
+	Improvements for the magnification scaling case (e.g. -scale 2)
+		for use in low vision applications.  It is faster and
+		no-blending :nb now works correctly.
+
+	More safety measures are taken WRT remote-control in the
+		default mode.  See the -unsafe, -safer, -privremote,
+		and -nocmds options.
+
+	The GUI has been improved, and running with the options "-gui icon"
+		presents a small, simple gui instead of the full blown one,
+		and "-gui tray" attempts to embed the small icon in the
+		system tray.  Use "-gui tray=setpass" to prompt for
+		session password creation at startup.
+
+
+  miscellaneous new features and changes:
+
+	-xkb: a simple test is performed at startup to see if it is a
+		good idea to apply -xkb mode for the current keyboard
+		keymapping (i.e. if keysyms like !, @, [ are otherwise
+		unavailable).  To disable use -noxkb.
+	 ISO_Level3_Shift vs. Mode_switch:  Set things up in -xkb mode to
+		prefer ISO_Level3_Shift over Mode_switch for modtweaking.
+		No override; let me know if this causes problems.
+	-add_keysyms is now the default, use -noadd_keysyms to disable.
+		the added keysyms are periodically deleted.
+	-remap DEAD: shorthand for mapping many "dead" keysyms to their
+		"un-dead" counterparts, e.g. grave -> dead_grave.  For
+		some VNC viewers that are unable to send the dead keysym.
+	-skip_dups: skip impossible duplicate key events sent by some VNC
+		viewers. -noskip_dups to disable (currently off by default).
+	-sloppy_keys: try to handle sloppy keyboarding (esp. between
+		different language keyboards) where, say, Shift is released
+		before the key.
+	-norepeat N: ping-pong N times if something else on the desktop
+		restores key autorepeating (e.g. session startup). Default
+		2.  Also, If the VNC client is idle for 5 min. autorepeat
+		is restored.
+	-wait_ui: If there is very recent user input, cut the -wait sleep
+		time by the specified factor (default 2.0).
+	-nowait_bog: Detection is now in place to watch for polling "bogging
+		down" (e.g. lots of scrolling text from a long build in a
+		terminal) and to sleep more.  Use -nowait_bog to disable.
+	-flag: write PORT=5900 to a flag file to aid wrapper scripts.
+	-http: try to guess what the -httpdir should be and if found
+		enable http listening.
+	-clip WxH+X+Y: only show the specified rectangle not the
+		entire screen.
+	 cursors are now scaled by default under -scale, use -scale_cursor
+		to modify this behavior.
+	-arrow n: select from some different arrow cursors (ignored under
+		XFIXES cursor grabbing mode).
+	-nolookup: disable DNS lookups for broken environments.
+	-seldir: fine tune and debug selection transfer. 
+	 build-time customization macros: SHARED, FOREVER, NOREPEAT,
+		REMOTE_CONTROL, SMALL_FOOTPRINT, default passwd, etc.
+		see the top of the x11vnc.c for more info.
+	-xtrap: DEC-XTRAP extension is supported for legacy systems
+		with insufficient XTEST extension (X11R5).
+	-shiftcmap: for legacy systems with non-standard colormap values.
+	-noxrecord: do not use the RECORD extension for anything (currently
+		only -scrollcopyrect and grabserver watching use it).
+	-grab_buster: fork a helper thread to watch for XGrabServer deadlock
+		in x11vnc and break the grab.  Under -scrollcopyrect there
+		is a small window where x11vnc is vulnerable to this deadlock.
+	-dbg:   A "crash shell" with tips on debugging will be presented
+		instead of exiting when a fatal error occurs.	
+	-fixscreen: periodically refresh the screen to get rid of painting
+		errors, etc. induced by new features, jpeg compression, etc.
+	-speeds: Tell x11vnc what the network and fb speeds are instead of
+		having it try to measure them.  (these speeds are used by
+		various features, such as -wireframe, -scrollcopyrect, etc.).
+	-wmdt: set the window manager or desktop to spare x11vnc from guessing.
+	-readtimeout: set libvncserver's read timeout parameter, useful on
+		very slow links that take more than 20secs to paint
+		the whole screen.
+	-nopw: If you use x11vnc without a password it now prints out a
+		scary warning message.  Use -nopw to disable the warning.
+	 plugged X event leaks; periodically purge any remaining buildup.
+	
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.7.1	2005-02-24
+
+
+New in the 0.7.1 x11vnc release:
+
+	Improved algorithm for approximating XFIXES cursors with
+		transparency (alpha channel).  No more ugly black fuzz
+		around translucent cursors.  Tuning parameters -alpha*
+		if it is still not right.
+
+	Added mechanisms to handle XFIXES cursors with transparency
+		exactly (i.e. blend in the background).  Works by default
+		under -nocursorshape updates, and also works under limited
+		circumstances for cursorshape updates if the VNC viewer
+		is patched (TightVNC viewer patch provided).
+
+	-solid: to improve performance switch the background to a solid
+		color when clients are connected.  Works on GNOME, KDE,
+		CDE, and classic X.
+
+	-input: allows fine-tuning the type of allowed user input
+		(Keystroke, Mouse-motion, Button-click).  Useful for
+		certain applications of x11vnc, e.g. demos. Also
+		per-client settings via -R input:xyz..
+
+	-users: enables switching to different users if started as root.
+		Please read the description for details.
+
+	-gui ez: less daunting GUI with fewer options via '-gui ez' or
+		"Misc -> simple-gui" once started.
+
+  miscellaneous new features and changes:
+
+	-nap is now the default, use -nonap to disable.
+	-snapfb: snapshot h/w fb to RAM periodically, not clear how useful...
+	-timeout n: for use in certain applications, exit if no client
+		connects after n seconds.
+	-oa and -logappend for appending to logfiles.
+	-opts will just show the options w/o the long -help descriptions.
+	if you forget to set -display, it will beep and try :0 after a bit.
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.7	2004-12-23
+
+
+New in the 0.7 x11vnc release:
+
+	Support for the XFIXES X extension to show the exact mouse cursor
+		shape.  Requires libXfixes.  For approximate cursor
+		shapes also see: -cursor (none|arrow|X|some|most)
+
+	-remote/-R: remote-control support: nearly every setting can be
+		changed dynamically without restarting x11vnc.	For
+		example, "x11vnc -R shared", and "x11vnc -R scale:3/4"
+		will connect to a running x11vnc server to make it shared
+		and re-scaled, respectively.
+
+	-gui: launches a simple tcl/tk GUI based on the remote control
+		function.  Requires the tcl/tk "wish" program.
+
+	-overlay: support for overlay/multi-depth (e.g. 24+8) visuals
+		on Solaris (SUN_OVL extension) and IRIX.
+
+	-xrandr: support for the XRANDR (X Resize, Rotate and Reflection)
+		extension: if the screen changes size or rotates x11vnc
+		creates a new framebuffer to match it.  Useful to have a VNC
+		Viewer that supports NewFBSize extension. (also -padgeom)
+
+	-pointer_mode: Experimental pointer input handling schemes,
+		e.g.: "-pointer_mode 3" (similar to -nodragging)
+
+	man page x11vnc.1 and README files created.
+
+  miscellaneous new features and changes:
+
+	-sb: set screen blank idle timeout
+	-nocursorshape: disable cursor shape VNC extension.
+	RFB_MODE = "accept" or "gone" passed to -accept/-gone commands.
+        -vncconnect is now the default.
+        -norepeat is now the default.
+	"-id pick" to pick a window via xwininfo for the -id option. 
+	-sid option: like -id but crops root window instead.
+	Related to remote-control: -query, -noremote, -sync, 
+		-deny_all, -safer, -unsafe.
+
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help
+
+-----------------------------------------------------------------------------
+
+
+x11vnc 0.6.2	2004-08-02
+
+New in the 0.6.2 x11vnc release:
+
+	-scale option for server side scaling (e.g. -scale 2/3).
+
+	-storepasswd option to create VNC password files.
+
+	~/.x11vncrc simple config file support.
+
+	-cursorpos now the default (send cursor position updates to clients
+		that understand them, disable with -nocursorpos)
+
+	more connection info sent to the -accept and -gone commands.
+
+  new keyboard related features:
+
+	-modtweak is now the default (it automatically adjusts the modifier
+		keys state to send a Keysym properly, disable -nomodtweak)
+		this works around "ghost" keys like "< >" in XFree86.
+
+	-xkb option to use XKEYBOARD extension for modtweak-ing to further
+		improve the accuracy of sending Keysyms between different
+		language keyboards.
+
+	-skip_keycodes and -add_keysyms options to fine tune stubborn
+		keyboard differences.
+
+	-norepeat option to turn off X server key autorepeat when clients
+		are connected (works around the repeated characters problem)
+
+	-clear_mods and -clear_keys to send key release events at
+		startup and exit.	
+
+  removed options:
+
+	-hints/-nohints: we now always use hints.
+
+For more information: 
+
+	http://www.karlrunge.com/x11vnc/
+	http://www.karlrunge.com/x11vnc/x11vnc_opts.html
+       	x11vnc -help
+
+-----------------------------------------------------------------------------
+