==========
unison2.32
==========

Unison is a file synchronizer for Unix and Windows. It allows two replicas of a
collection of files and directories to be stored on different hosts (or
different disks on the same host), modified separately, and then brought up to
date by propagating the changes in each replica to the other.

Unison comes in several complementary packages for Cygwin:

Package name  Unison version  Executable name
------------  --------------  --------------------
unison2.27     2.27.*         /usr/bin/unison-2.27
unison2.32     2.32.*         /usr/bin/unison-2.32
unison2.40     2.40.*         /usr/bin/unison-2.40
unison2.45     2.45.*         /usr/bin/unison-2.45

Separate packages and executables are needed because Unison's protocol for
exchanging information on the network is incompatible between these versions.
Two versions of Unison are compatible if and only if the first two numbers in
their version strings are the same.  For example, all versions 2.27.* are
compatible with each other, and incompatible with versions 2.32.*.  (In Unison
versions prior to 2.13, all three numbers in the version string had to match in
order for two versions to be compatible.)  If you try to use e.g. Unison version
2.27.* to synchronize with a server running version 2.32.*, Unison will issue an
error message about incompatible versions and quit.  By installing one or more
of the packages listed above, you can run whichever version you need in order to
synchronize with your server.

In addition to the executables named above, the package postinstallation script
uses alternatives(8) to install a symlink /usr/bin/unison pointing to
/etc/alternatives/unison, which in turn points to one of the above-named
executables.  By default this symlink will track the highest-numbered version of
Unison that you install on your system, unless you reset it, either manually or
using alternatives(8).  See alternatives(8) for more details.

If the server provides multiple versions of Unison, then you can invoke Unison
on the client with e.g. '-servercmd /usr/bin/unison-2.32' to run the version
you want on the server, or put 'servercmd /usr/bin/unison-2.32' into the
client's preference file.

All of the Unison packages for Cygwin use the text UI.  There is also a GTK2 UI
for Unison, but I haven't been able to get it working yet under Cygwin.  At some
time in the future I may make unison-gtk2 packages available for Cygwin.

Source home page:   http://www.cis.upenn.edu/~bcpierce/unison/
Source download:    http://www.cis.upenn.edu/~bcpierce/unison/download/releases/unison-2.32.52/unison-2.32.52.tar.gz
Cygwin maintainer:  Andrew Schulman <schulman.andrew@epa.gov>
License:            GPL

Please address questions and bug reports to the Cygwin mailing list
<cygwin@cygwin.com>.

-------------------------------------------------------------------------

Runtime requirements:
  cygwin
  alternatives

Build requirements:
  cygwin
  gcc
  make
  binutils
  ocaml
  cygport

Build instructions:
  tar -jxf unison2.32-2.32.52-4-src.tar.bz2
    if you use setup to install this src package, it will be
    unpacked under /usr/src automatically
  cd /usr/src
  cygport unison2.32-2.32.52-4.cygport all

This will create:
  /usr/src/unison2.32-2.32.52-4.tar.bz2
  /usr/src/unison2.32-2.32.52-4-src.tar.bz2

Or use 'cygport unison2.32-2.32.52-4.cygport prep' to get a patched
source directory.

-------------------------------------------------------------------------

Files included in the binary distribution:

  /etc/postinstall/unison2.32.sh
  /etc/preremove/unison2.32.sh
  /usr/bin/unison-2.32.exe
  /usr/share/doc/Cygwin/unison2.32.README
  /usr/share/doc/unison2.32/BUGS.txt
  /usr/share/doc/unison2.32/CONTRIB
  /usr/share/doc/unison2.32/COPYING
  /usr/share/doc/unison2.32/INSTALL
  /usr/share/doc/unison2.32/INSTALL.gtk2
  /usr/share/doc/unison2.32/INSTALL.win32
  /usr/share/doc/unison2.32/INSTALL.win32-cygwin-gnuc
  /usr/share/doc/unison2.32/INSTALL.win32-msvc
  /usr/share/doc/unison2.32/NEWS
  /usr/share/doc/unison2.32/README
  /usr/share/doc/unison2.32/README.Cygwin
  /usr/share/doc/unison2.32/ROADMAP.txt
  /usr/share/doc/unison2.32/TODO.txt
  /usr/share/doc/unison2.32/unison-manual.html

-------------------------------------------------------------------------

Cygwin version history:

2.32.52-4:
- Update README.Cygwin.

2.32.52-3:
- Patch to enable build with OCaml 3.12.0.

2.32.52-2:
- Update README.Cygwin.

2.32.52-1:
- Initial Cygwin build.
