Updated documentation.

This commit is contained in:
crs 2004-05-26 20:20:23 +00:00
parent 06d77fe314
commit 70e2d2b89a
6 changed files with 372 additions and 21 deletions

View File

@ -1,6 +1,7 @@
Synergy Authors Synergy Authors
=============== ===============
Chris Schoeneman <crs23@bigfoot.com> -- creator, maintainer, X11, Win32 Chris Schoeneman <crs23@bigfoot.com> -- Creator, owner, X11, Win32
Ryan Breen <ryan@ryanbreen.com> -- Mac OS X port Ryan Breen <ryan@ryanbreen.com> -- Initial Mac OS X port
Guido Poschta <moolder@gmx.net> -- Windows installer Guido Poschta <moolder@gmx.net> -- Windows installer
Bertrand Landry Hetu <bertrand@landryhetu.com> -- Mac OS X port

306
ChangeLog
View File

@ -1,3 +1,309 @@
2004/05/26 19:23:32 crs
//depot/project/synergy/lib/common/MacOSXPrecomp.h
//depot/project/synergy/lib/common/common.h
//depot/project/synergy/lib/platform/COSXClipboardTextConverter.cpp
//depot/project/synergy/lib/platform/COSXClipboardTextConverter.h
//depot/project/synergy/lib/platform/COSXEventQueueBuffer.cpp
//depot/project/synergy/lib/platform/COSXKeyState.cpp
//depot/project/synergy/lib/platform/COSXKeyState.h
//depot/project/synergy/lib/platform/COSXScreen.cpp
//depot/project/synergy/lib/platform/COSXScreen.h
//depot/project/synergy/synergy.xcode/project.pbxproj
Merged Bertrand's OS X changes. Also added support for mouse wheel
on OS X server.
----------
2004/05/18 20:32:13 crs
//depot/project/synergy/lib/platform/CMSWindowsScreen.cpp
If the server manages to detect ctrl+alt+del it will no longer send
that to the client. If it did then the user could see the effect of
ctrl+alt+del on both the server and client which we never want. The
user can use ctrl+alt+pause to emulate ctrl+alt+del on the client.
----------
2004/05/18 20:26:48 crs
//depot/project/synergy/lib/platform/CXWindowsEventQueueBuffer.cpp
//depot/project/synergy/lib/platform/CXWindowsEventQueueBuffer.h
Fixed bug that could allow multiple threads to simultaneously access
the X11 display connection. The only problematic method was
CXWindowsEventQueueBuffer::addEvent given that the other event queue
methods are only called from the main thread.
----------
2004/05/17 21:55:55 crs
//depot/project/synergy/cmd/synergyc/synergyc.cpp
Fixed logging of connection to server. Was DEBUG now NOTE.
----------
2004/05/17 21:55:38 crs
//depot/project/synergy/lib/platform/CMSWindowsKeyState.cpp
Fixed ctrl+alt+del emulation on win32 server. It was mapping
VK_DELETE to the keypad delete key. This key is not interpreted
on the client as causing ctrl+alt+del.
----------
2004/05/16 18:04:36 crs
//depot/project/synergy/lib/client/CServerProxy.cpp
//depot/project/synergy/lib/server/CClientProxy1_0.cpp
//depot/project/synergy/lib/synergy/ProtocolTypes.h
Fixed handling of screen resolution changes.
----------
2004/05/16 18:03:36 crs
//depot/project/synergy/cmd/launcher/CAutoStart.cpp
Changed (win NT) service to depend on the 'Browser' service to
ensure correct startup order.
----------
2004/05/16 18:02:49 crs
//depot/project/synergy/all.dsp
//depot/project/synergy/cmd/exec.dsp
//depot/project/synergy/cmd/launcher/launcher.dsp
//depot/project/synergy/cmd/synergyc/synergyc.dsp
//depot/project/synergy/cmd/synergys/synergys.dsp
//depot/project/synergy/dist/nullsoft/installer.dsp
//depot/project/synergy/dist/nullsoft/synergy.nsi
//depot/project/synergy/lib/arch/arch.dsp
//depot/project/synergy/lib/base/base.dsp
//depot/project/synergy/lib/client/client.dsp
//depot/project/synergy/lib/common/common.dsp
//depot/project/synergy/lib/io/io.dsp
//depot/project/synergy/lib/mt/mt.dsp
//depot/project/synergy/lib/net/net.dsp
//depot/project/synergy/lib/platform/makehook.dsp
//depot/project/synergy/lib/platform/platform.dsp
//depot/project/synergy/lib/platform/synrgyhk.dsp
//depot/project/synergy/lib/server/server.dsp
//depot/project/synergy/lib/synergy/libsynergy.dsp
Changed VC++ projects to put release targets in ./build, debug
targets in ./debug, and intermediate files under ./gen.
----------
2004/05/15 19:44:05 crs
//depot/project/synergy/configure.in
//depot/project/synergy/lib/common/Version.h
Changed version to 1.1.6.
----------
2004/05/15 19:43:33 crs
//depot/project/synergy/lib/platform/CMSWindowsScreen.cpp
Avoided duplicate logging of screen size on win32.
----------
2004/05/15 19:41:46 crs
//depot/project/synergy/Makefile.am
//depot/project/synergy/configure.in
//depot/project/synergy/lib/common/common.h
//depot/project/synergy/lib/platform/COSXClipboard.cpp
//depot/project/synergy/lib/platform/COSXClipboard.h
//depot/project/synergy/lib/platform/COSXClipboardAnyTextConverter.cpp
//depot/project/synergy/lib/platform/COSXClipboardAnyTextConverter.h
//depot/project/synergy/lib/platform/COSXClipboardTextConverter.cpp
//depot/project/synergy/lib/platform/COSXClipboardTextConverter.h
//depot/project/synergy/lib/platform/COSXClipboardUTF16Converter.cpp
//depot/project/synergy/lib/platform/COSXClipboardUTF16Converter.h
//depot/project/synergy/lib/platform/COSXEventQueueBuffer.cpp
//depot/project/synergy/lib/platform/COSXEventQueueBuffer.h
//depot/project/synergy/lib/platform/COSXScreen.cpp
//depot/project/synergy/lib/platform/COSXScreen.h
//depot/project/synergy/lib/platform/Makefile.am
//depot/project/synergy/synergy.xcode/project.pbxproj
Added bertrand landry hetu's mac OS X port to date.
----------
2004/05/12 20:28:00 crs
//depot/project/synergy/lib/platform/CXWindowsScreen.cpp
//depot/project/synergy/lib/platform/CXWindowsScreen.h
Now restoring input focus when entering the screen to the window
that had the focus when the screen was left.
----------
2004/05/12 19:50:58 crs
//depot/project/synergy/lib/arch/CArchNetworkBSD.cpp
//depot/project/synergy/lib/arch/CArchNetworkWinsock.cpp
Fixed thread reference leak in network code.
----------
2004/05/12 19:12:28 crs
//depot/project/synergy/configure.in
Added configure option to enable debug builds. If not enabled then
asserts are disabled.
----------
2004/05/12 18:54:03 crs
//depot/project/synergy/lib/platform/CXWindowsClipboardBMPConverter.cpp
Fixed build error in gcc 3.3.
----------
audrey2% ./nodist/p4tolog -p //depot/project/synergy/ -m 15 | less
audrey2% ./nodist/p4tolog -p //depot/project/synergy/ -m 15
2004/05/26 19:23:32 crs
lib/common/MacOSXPrecomp.h
lib/common/common.h
lib/platform/COSXClipboardTextConverter.cpp
lib/platform/COSXClipboardTextConverter.h
lib/platform/COSXEventQueueBuffer.cpp
lib/platform/COSXKeyState.cpp
lib/platform/COSXKeyState.h
lib/platform/COSXScreen.cpp
lib/platform/COSXScreen.h
synergy.xcode/project.pbxproj
Merged Bertrand's OS X changes. Also added support for mouse wheel
on OS X server.
----------
2004/05/18 20:32:13 crs
lib/platform/CMSWindowsScreen.cpp
If the server manages to detect ctrl+alt+del it will no longer send
that to the client. If it did then the user could see the effect of
ctrl+alt+del on both the server and client which we never want. The
user can use ctrl+alt+pause to emulate ctrl+alt+del on the client.
----------
2004/05/18 20:26:48 crs
lib/platform/CXWindowsEventQueueBuffer.cpp
lib/platform/CXWindowsEventQueueBuffer.h
Fixed bug that could allow multiple threads to simultaneously access
the X11 display connection. The only problematic method was
CXWindowsEventQueueBuffer::addEvent given that the other event queue
methods are only called from the main thread.
----------
2004/05/17 21:55:55 crs
cmd/synergyc/synergyc.cpp
Fixed logging of connection to server. Was DEBUG now NOTE.
----------
2004/05/17 21:55:38 crs
lib/platform/CMSWindowsKeyState.cpp
Fixed ctrl+alt+del emulation on win32 server. It was mapping
VK_DELETE to the keypad delete key. This key is not interpreted
on the client as causing ctrl+alt+del.
----------
2004/05/16 18:04:36 crs
lib/client/CServerProxy.cpp
lib/server/CClientProxy1_0.cpp
lib/synergy/ProtocolTypes.h
Fixed handling of screen resolution changes.
----------
2004/05/16 18:03:36 crs
cmd/launcher/CAutoStart.cpp
Changed (win NT) service to depend on the 'Browser' service to
ensure correct startup order.
----------
2004/05/16 18:02:49 crs
all.dsp
cmd/exec.dsp
cmd/launcher/launcher.dsp
cmd/synergyc/synergyc.dsp
cmd/synergys/synergys.dsp
dist/nullsoft/installer.dsp
dist/nullsoft/synergy.nsi
lib/arch/arch.dsp
lib/base/base.dsp
lib/client/client.dsp
lib/common/common.dsp
lib/io/io.dsp
lib/mt/mt.dsp
lib/net/net.dsp
lib/platform/makehook.dsp
lib/platform/platform.dsp
lib/platform/synrgyhk.dsp
lib/server/server.dsp
lib/synergy/libsynergy.dsp
Changed VC++ projects to put release targets in ./build, debug
targets in ./debug, and intermediate files under ./gen.
----------
2004/05/15 19:44:05 crs
configure.in
lib/common/Version.h
Changed version to 1.1.6.
----------
2004/05/15 19:43:33 crs
lib/platform/CMSWindowsScreen.cpp
Avoided duplicate logging of screen size on win32.
----------
2004/05/15 19:41:46 crs
Makefile.am
configure.in
lib/common/common.h
lib/platform/COSXClipboard.cpp
lib/platform/COSXClipboard.h
lib/platform/COSXClipboardAnyTextConverter.cpp
lib/platform/COSXClipboardAnyTextConverter.h
lib/platform/COSXClipboardTextConverter.cpp
lib/platform/COSXClipboardTextConverter.h
lib/platform/COSXClipboardUTF16Converter.cpp
lib/platform/COSXClipboardUTF16Converter.h
lib/platform/COSXEventQueueBuffer.cpp
lib/platform/COSXEventQueueBuffer.h
lib/platform/COSXScreen.cpp
lib/platform/COSXScreen.h
lib/platform/Makefile.am
synergy.xcode/project.pbxproj
Added bertrand landry hetu's mac OS X port to date.
----------
2004/05/12 20:28:00 crs
lib/platform/CXWindowsScreen.cpp
lib/platform/CXWindowsScreen.h
Now restoring input focus when entering the screen to the window
that had the focus when the screen was left.
----------
2004/05/12 19:50:58 crs
lib/arch/CArchNetworkBSD.cpp
lib/arch/CArchNetworkWinsock.cpp
Fixed thread reference leak in network code.
----------
2004/05/12 19:12:28 crs
configure.in
Added configure option to enable debug builds. If not enabled then
asserts are disabled.
----------
2004/05/12 18:54:03 crs
lib/platform/CXWindowsClipboardBMPConverter.cpp
Fixed build error in gcc 3.3.
----------
2004/05/04 20:45:06 crs 2004/05/04 20:45:06 crs
cmd/launcher/CGlobalOptions.cpp cmd/launcher/CGlobalOptions.cpp
cmd/launcher/launcher.rc cmd/launcher/launcher.rc

43
INSTALL
View File

@ -13,6 +13,9 @@ To build synergy from the sources you'll need the following:
* gcc 2.95 (or up) * gcc 2.95 (or up)
* X11R4 or up headers and libraries * X11R4 or up headers and libraries
Mac OS X:
* XCode; or gcc 2.95 (or up) and make
In this document, "Unix" means any of the supported Unix or Unix-like In this document, "Unix" means any of the supported Unix or Unix-like
(e.g. Linux) operating systems. (e.g. Linux) operating systems.
@ -20,7 +23,8 @@ In this document, "Unix" means any of the supported Unix or Unix-like
Configuring the build Configuring the build
--------------------- ---------------------
This step is only necessary when building on Unix. This step is only necessary when building on Unix or Mac OS X if not
using XCode.
To configure the build for your platform use the configure script: To configure the build for your platform use the configure script:
@ -43,9 +47,9 @@ Building
Windows: Windows:
Start VC++ and open `synergy.dsw'. Set the active configuration Start VC++ and open `synergy.dsw'. Set the active configuration
(Build | Set Active Configuration) to `All - Debug' or `All - Release' (Build | Set Active Configuration) to `All - Debug' or `All - Release'
then build. Binaries are built into ./Debug or ./Release. then build. Binaries are built into ./debug or ./build.
Unix: Unix or Mac OS X without XCode:
Simply enter: Simply enter:
make make
@ -53,6 +57,10 @@ Unix:
This will build the client and server and leave them in their This will build the client and server and leave them in their
respective source directories. respective source directories.
Mac OS X with XCode:
Start XCode and open the synery.xcode project. Build the 'all'
project using the Deployment flavor.
Installing Installing
---------- ----------
@ -72,12 +80,18 @@ Windows:
* synergys.exe * synergys.exe
* synrgyhk.dll * synrgyhk.dll
Unix: Unix or Mac OS X without XCode:
make install make install
will install the client and server into /usr/local/bin unless you will install the client and server into /usr/local/bin unless you
specified a different directory when you ran configure. specified a different directory when you ran configure.
Mac OS X with XCode:
Copy the following files from ./build to a convenient location:
* synergyc
* synergys
See `Starting Automatically on ...' below for details on how to have See `Starting Automatically on ...' below for details on how to have
synergy start up automatically when the computer starts. synergy start up automatically when the computer starts.
@ -152,8 +166,8 @@ See `Starting Automatically on Windows' below for configuring synergy
to start automatically when the computer starts. to start automatically when the computer starts.
Configuring the Server on Unix Configuring the Server on Unix or Mac OS X
------------------------------ ------------------------------------------
The synergy server requires configuration. The configuration file is a The synergy server requires configuration. The configuration file is a
plain text file broken into sections. Each section has the form: plain text file broken into sections. Each section has the form:
@ -164,7 +178,8 @@ plain text file broken into sections. Each section has the form:
Comments are introduced by `#' and continue to the end of the line. Comments are introduced by `#' and continue to the end of the line.
The file can have the following sections. The `screens' section must The file can have the following sections. The `screens' section must
appear before the `links' and `aliases' sections. appear before the `links' and `aliases' sections. Use any text editor
to create the configuration file.
* screens * screens
<args> is a list of screen names, one name per line, each <args> is a list of screen names, one name per line, each
@ -348,8 +363,8 @@ file if the user doesn't specify a path using the `--config' command
line option. `synergys --help' reports those pathnames. line option. `synergys --help' reports those pathnames.
Running the Server on Unix Running the Server on Unix or Mac OS X
-------------------------- --------------------------------------
Run the server on the computer that has the keyboard and mouse to Run the server on the computer that has the keyboard and mouse to
be shared. You must have prepared a configuration file before be shared. You must have prepared a configuration file before
@ -374,8 +389,8 @@ See `Starting Automatically on Unix' below for running synergy
automatically when the X server starts. automatically when the X server starts.
Running the Client on Unix Running the Client on Unix or Mac OS X
-------------------------- --------------------------------------
Run the client on all computers that aren't the server using the Run the client on all computers that aren't the server using the
following command line: following command line:
@ -500,6 +515,12 @@ prevent a synergy client from synthesizing mouse and keyboard
input, though. input, though.
Starting Automatically on Mac OS X
----------------------------------
TBD
Network Security Network Security
---------------- ----------------

17
NEWS
View File

@ -1,6 +1,23 @@
Synergy News Synergy News
============ ============
* May-26-2004 - Synergy 1.1.6 released
Made following changes:
* Added preliminary Mac OS X support (client and server)
* Fixed ctrl+alt+del emulation on win32
* Fixed ctrl+alt+del on win32 server acting on both client and server
* Fixed handling of screen resolution changes on win32
* Fixed 'unexpected async reply' on X11
* Added dependency to win32 service to avoid startup race condition
* Fixed reference count bug
* Keyboard input focus now restored on X11 (fixes loss of input in some games)
The OS X port does not yet support:
* HTML and bitmap clipboard data
* Screen saver synchronization
* Non-US English keyboards
* May-05-2004 - Synergy 1.1.5 released * May-05-2004 - Synergy 1.1.5 released
Made following changes: Made following changes:

16
README
View File

@ -52,6 +52,8 @@ System Requirements
* Microsoft Windows NT, Windows 2000, Windows XP (the Windows NT family); * Microsoft Windows NT, Windows 2000, Windows XP (the Windows NT family);
* Mac OS X 10.3 (10.2 may work);
* Unix: * Unix:
X Windows version 11 revision 4 or up with the XTEST extension X Windows version 11 revision 4 or up with the XTEST extension
(use `xdpyinfo | grep XTEST' to check for XTEST). (use `xdpyinfo | grep XTEST' to check for XTEST).
@ -62,6 +64,12 @@ for other platforms are welcome (including patches that package binaries);
See the contact information available off of the synergy home page or use See the contact information available off of the synergy home page or use
the patch page on sourceforge. the patch page on sourceforge.
The Mac OS X port is incomplete. It does not synchronize the screen saver,
only text clipboard data works (i.e. HTML and bitmap data do not work),
non-US English keyboards are untested and probably don't work, and there
may be problems with mouse pointer and mouse wheel acceleration. Other
problems should be filed as bugs (see BUGS).
Installation Installation
------------ ------------
@ -120,8 +128,8 @@ Third, you configure and start the server.
read the log messages to determine the problem then correct it and try read the log messages to determine the problem then correct it and try
`Test' again. `Test' again.
Unix Unix or MacOS X
---- ---------------
Create a text file named synergy.conf with the following: Create a text file named synergy.conf with the following:
section: screens section: screens
@ -175,8 +183,8 @@ Finally, start the clients.
about to quit; read the log messages to determine the problem then about to quit; read the log messages to determine the problem then
correct it and try `Test' again. correct it and try `Test' again.
Unix Unix or MacOS X
---- ---------------
To start a client, enter the following: To start a client, enter the following:

4
TODO
View File

@ -18,9 +18,7 @@ Things to do to synergy, in no particular order:
* Port to other platforms * Port to other platforms
Most desired is MacOS X. Ryan Breen has a partial port to Mac OS X. The MacOS X port is still incomplete but getting close.
Only the client is ported and there is no clipboard or screen saver
support. It's available from http://www.ryanbreen.com/synergy.
* Write man/html pages * Write man/html pages