changed notes about how to startup configure synergy. it now

discourages using boot scripts, which can't handle X servers
requiring authorization, and suggests modifying xdm's Xsetup.

README

@@ -226,29 +226,16 @@ linux, unix:
   before starting synergy as a daemon you should understand that
   synergy requires an X server that it can connect to.  synergy
   can start before the X server does and will repeatly attempt to
-  connect to the X server until it succeeds.  the DISPLAY env var
+  connect to the X server until it succeeds.  however, if the
-  should be set appropriately before starting synergy.  note that
+  server requires authorization then it's unlikely that synergy
-  it probably will not be set when running startup scripts so you
+  will ever succeed.  in that case synergy should be (re)started
-  have to set it yourself (probably to ":0").  if it's not set
+  by the X display manager.
-  then synergy will use the default ":0.0" which is correct in
-  most cases.
 
-  if the X server goes down then all the clients connected to it
+  the DISPLAY env var should be set appropriately before starting
-  must terminate.  synergy has to deal with this because some
+  synergy.  note that it probably will not be set when running
-  display managers will automatically restart the X server when
+  boot scripts so you have to set it yourself (probably to ":0").
-  a user logs out.  synergy can automatically restart itself and
+  if it's not set then synergy will use the default ":0.0" which
-  it does so by default.  the `--no-restart' option turns this
+  is correct in most cases.
-  feature off.
-
-  some display managers also prevent any X client other than
-  those they themselves start from connecting to the X server
-  during login for security reasons.  for these display managers,
-  synergy should be part of the manager's screen initialization
-  script and synergy should be started with the --no-restart
-  option since the display manager will do the restarting.
-  otherwise, synergy should not use the --no-restart option and
-  it can be started at boot time (sometime after the network is
-  started) or when the X server is started.
 
   finally, some display managers (xdm and kdm, but not gdm)
   grab the keyboard and do not release it until the user logs
@@ -259,21 +246,40 @@ linux, unix:
 
   to install synergy as a daemon, you'll need to add the
   appropriate lines and/or files to start synergy at boot time
-  or as part of a display manager screen initialization script.
+  or modify the display manager screen initialization scripts.
   do not use the `-f' or `--no-daemon' options.  for the server
   use the `--config' option to specify the path to the
   configuration file or just put the configuration in
   /etc/synergy.conf.
 
 linux:
-  if starting synergy from xdm's or kdm's screen initialization
+  you should modify xdm's Xsetup script to start the synergy
-  script you'll want add a line to start synergy in
+  client or server.  for example, somewhere near the bottom of
-  /etc/X11/xdm/Xsetup_0, probably near the bottom.  you'll also
+  Xsetup (but someplace before anywhere the script calls exit)
-  want to put the configuration file in /etc/synergy.conf and
+  you might add:
-  the synergy executable in /usr/sbin.  to uninstall, remove the
+    /usr/bin/killall synergy
-  added line and files.
+    /usr/sbin/synergy 192.168.1.101
+  this assumes synergy is installed in /usr/sbin.  these lines
+  make sure any already running synergy is terminated and starts
+  a fresh copy.  it's important to kill old copies so that you
+  don't end up with multiple synergy instances fighting each
+  other or, at the very least, using up system resources.
 
-  if starting the synergy client using init.d then:
+  to start the synergy server you might use:
+    /usr/bin/killall synergyd
+    /usr/sbin/synergyd --config /root/synergy.conf
+  assuming synergyd is installed in /usr/sbin.  if you've put
+  the configuration data in /etc/synergy.conf then you don't
+  need the --config option.
+
+  another option is to put the synergy startup in .Xsession in
+  your home directory.  that allows users without root access to
+  start synergy when they login.  in this case synergy will not
+  be running while on the login screen.
+
+  if your X server does not require authorization then you can
+  start synergy at boot time.  if starting the synergy client
+  using init.d then:
     # /bin/cp synergy /usr/sbin/synergy
     # /bin/cp synergy.linux.init /etc/init.d/synergy
     # /sbin/chkconfig --add synergy
@@ -306,6 +312,10 @@ linux:
     # /bin/rm /etc/init.d/synergyd
     # /bin/rm /usr/sbin/synergyd
 
+  note that synergy.linux.init and synergyd.linux.init are not
+  tested on a wide variety of platforms and may need editing
+  for your platform.
+
 
 common command line options
 ---------------------------
@@ -455,4 +465,5 @@ tips and tricks
 * turn off mouse driven virtual desktop switching on X windows.  it
   will interfere with synergy.  use keyboard shortcuts instead.
 
-* synergy's screensaver synchronization works best with xscreensaver.
+* synergy's screensaver synchronization works best with xscreensaver
+  under X windows.