X-Recipient:	archive-cygwin AT delorie DOT com
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org A850A3858408
DKIM-Signature:	v=1; a=rsa-sha256; c=relaxed/relaxed; d=cygwin.com;
	s=default; t=1683036299;
	bh=VZUSz3R/voNa68Z87jIZ68MK4f+Gf+OTJTpB/VucbRU=;
	h=Date:Subject:To:List-Id:List-Unsubscribe:List-Archive:List-Post:
	List-Help:List-Subscribe:From:Reply-To:Cc:From;
	b=A9lGU8o926bhi1alwiNwPlhDBR280kkbQoVN65q5iVCQ50OXWX4iocT6QDXznK3bI
	laWUK9TNg0SWnXTpY3gLL1HvjSe+Cq/Bt99V66Au3Q28+vCy1/pAQ0Fk6LFe1KkOwt
	ciNN9yujhIqqhWqn0nGg4vGvo67Uy2tsm1G1Ftdk=
X-Original-To:	cygwin AT cygwin DOT com
Delivered-To:	cygwin AT cygwin DOT com
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org 609673857719
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org 0FF053857714
DMARC-Filter:	OpenDMARC Filter v1.4.2 sourceware.org 4E2123857354
X-Google-DKIM-Signature:	v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20221208; t=1683036233; x=1685628233;
	h=to:subject:message-id:date:from:mime-version:x-gm-message-state
	:from:to:cc:subject:date:message-id:reply-to;
	bh=WOU03+tNwT+rOOtchXlQgR9JR8FN0uBl2eb1JHzUG0Q=;
	b=adyKU5i6Jkxdb0h+R4MB3fp7bfzLAERY4ixz++qYzu1PQiJKDsCSo8MW/hp0cexlaM
	NlaV99CGAKUyExTT8eDS4H6FGkA57upb5brccCu2DikeiFLOmk9VEReU1/kbFXnHmsJ4
	9pPux0PUmr9bvvuvTRuRcF5LghdcnES49YWYULTbJ0/dntfGcYZb0JchL0vdffc6Glpn
	slndaAJBIHLUfez7nggl+agUoklNMWmnkrYxmmsOAUPFq5S9RfIJ+wBEzTDpU0a9xcAN
	b3kREQ5JDszc79gDGGKhiVZtfo6uufHvCaJ/VsqiQRjOOHEWR92rCmPrETy3kzsz5bJA
	4L/g==
X-Gm-Message-State:	AC+VfDy6fFGO2jUqi0B0FQnZcYvRlSwf1fNEAHGkWvToWJ+u3fu0NSjf
	quKPZPQC5hZJh426VJ40yO7WqJkN309ZtmUOzXcOR+K+aJk=
X-Google-Smtp-Source:	ACHHUZ6HCTY8MIK2X0QMz+yueddW5LQYBsCRGnyVKcHuEnbKlsz0+SvqJDtkqzEhPBOjAaLnSIlPA1cNi5lq6cHrVR4=
X-Received:	by 2002:a17:907:9807:b0:95f:de3c:6c92 with SMTP id
	ji7-20020a170907980700b0095fde3c6c92mr23118ejc.50.1683036233178; Tue, 02 May
	2023 07:03:53 -0700 (PDT)
MIME-Version:	1.0
Date:	Tue, 2 May 2023 10:03:41 -0400
Message-Id:	<announce.CAJOCpN0vh-h=0JcBtXZDg4h-_BTnpPFqVkTmhvVLa9FQ3OR1nw@mail.gmail.com>
Subject:	[ANNOUNCEMENT] unison 2.53.3-1
To:	cygwin AT cygwin DOT com
X-Spam-Status:	No, score=-0.1 required=5.0 tests=BAYES_00, DKIM_SIGNED,
	DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, HTML_MESSAGE,
	KAM_NUMSUBJECT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP,
	T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6
X-Spam-Checker-Version:	SpamAssassin 3.4.6 (2021-04-09) on
	server2.sourceware.org
X-Content-Filtered-By:	Mailman/MimeDel 2.1.29
X-BeenThere:	cygwin-announce AT cygwin DOT com
X-Mailman-Version:	2.1.29
X-Mailer:	Perl5 Mail::Internet v2.20
X-BeenThere:	cygwin AT cygwin DOT com
List-Id:	General Cygwin discussions and problem reports <cygwin.cygwin.com>
List-Archive:	<https://cygwin.com/pipermail/cygwin/>
List-Post:	<mailto:cygwin AT cygwin DOT com>
List-Help:	<mailto:cygwin-request AT cygwin DOT com?subject=help>
List-Subscribe:	<https://cygwin.com/mailman/listinfo/cygwin>,
	<mailto:cygwin-request AT cygwin DOT com?subject=subscribe>
From:	Andrew Schulman via Cygwin-announce via Cygwin <cygwin AT cygwin DOT com>
Reply-To:	cygwin AT cygwin DOT com
Cc:	Andrew Schulman via Cygwin-announce <cygwin-announce AT cygwin DOT com>
Sender:	"Cygwin" <cygwin-bounces+archive-cygwin=delorie DOT com AT cygwin DOT com>

unison 2.53.3-1 is now available in Cygwin. This is a new upstream release,
with new features and bug fixes. See the upstream release log[1] for
details.

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 versions and packages

Unison versions 2.52 and later are provided in Cygwin by the unison package.
The executable is /usr/bin/unison-latest. All versions 2.52 and later are
compatible with each other, so they can sync with each other. They can also
sync with Unison versions 2.48-2.51, but apparently not with versions older
than that. Test reports are welcome on the Cygwin list, cygwin AT cygwin DOT com.

Prior to version 2.52, Unison came in multiple complementary packages for
Cygwin:

                   Unison   OCaml
Package name       version  version  Unison executable
------------       -------  -------  -----------------
unison2.27         2.27.*   4.01.0   /usr/bin/unison-2.27
unison2.32         2.32.*   4.01.0   /usr/bin/unison-2.32
unison2.40         2.40.*   4.02.3   /usr/bin/unison-2.40
unison2.45         2.45.*   4.01.1   /usr/bin/unison-2.45
unison2.48+4.04.2  2.48.*   4.04.2   /usr/bin/unison-2.48+4.04.2
unison2.48+4.08.1  2.48.*   4.08.1   /usr/bin/unison-2.48+4.08.1
unison2.49         2.49.*   4.02.3   /usr/bin/unison-2.49
unison2.51+4.04.2  2.51.*   4.04.2   /usr/bin/unison-2.51+4.04.2
unison2.51+4.10.0  2.51.*   4.10.0   /usr/bin/unison-2.51+4.10.0

Different packages were needed because Unison executables were only
compatible if they had the same Unison version, and were compiled with
compatible versions of OCaml. (It was kind of a nightmare.) So you had to
have a version installed locally that matched the version you were
synchronizing with.

== Migrating to version 2.52 or later

To upgrade Unison on your local host to version 2.52 or later:

* If the remote host is also running Unison 2.52 or later, you're all set.

* If the remote host is running Unison 2.48-2.51, you can sync with it. If
  you've previously synchronized files with that host, try syncing with it
  again with your local version 2.52 or later. If the two Unisons were built
  with compatible versions of OCaml, then the newer Unison will upgrade the
  local Unison archive files to the newer format. After that you can sync
  using any later version of Unison, regardless of the OCaml version. But if
  Unison throws an error about bad archives or the like, then you'll have to
  either go back to using the previous Unison version, or (recommended)
  remove the previous archive files (~/.unison/ar* and ~/.unison/fp*), and
  start over with a fresh synchronization.

* If the remote host is running a version older than 2.48, you can't sync to
  it with version 2.52 or later. You'll have to keep using one of the older
  Unison packages listed above, that matches the Unison and OCaml versions
  of the remote host.

The Unison 2.52 Migration Guide[2] has more information.

== Setting a default version

The package postinstallation script uses alternatives(8) to install a
symlink
/usr/bin/unison that 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. You can change that using alternatives:

  alternatives --config unison

(recommended) or manually. See "man alternatives" for details.

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

== User interface

All of the Unison packages for Cygwin use the text UI. There is also a GTK3
UI for Unison, but I haven't tried to build it for Cygwin yet.


Andrew E. Schulman

[1]https://github.com/bcpierce00/unison/releases
[2]https://github.com/bcpierce00/unison/wiki/2.52-Migration-Guide

-- 
Problem reports:      https://cygwin.com/problems.html
FAQ:                  https://cygwin.com/faq/
Documentation:        https://cygwin.com/docs.html
Unsubscribe info:     https://cygwin.com/ml/#unsubscribe-simple

- Raw text -