From mboxrd@z Thu Jan 1 00:00:00 1970 From: Suvayu Ali Subject: Re: [SYNC] How do you sync your org-mode files between n devices (n > 2) Date: Thu, 5 Sep 2013 14:54:04 +0200 Message-ID: <20130905125404.GC2392@kuru.dyndns-at-home.com> References: <20130904060424.GA679@kuru.dyndns-at-home.com> <499DE163-8785-4997-B6F4-1B4475FAD205@gmail.com> <20130904074317.GC679@kuru.dyndns-at-home.com> <20130905094234.GH19491@kuru.dyndns-at-home.com> <20130905112545.GA2392@kuru.dyndns-at-home.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VHZ4d-0002gy-3n for emacs-orgmode@gnu.org; Thu, 05 Sep 2013 08:54:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VHZ4b-0000TU-JG for emacs-orgmode@gnu.org; Thu, 05 Sep 2013 08:54:11 -0400 Received: from mail-ea0-x231.google.com ([2a00:1450:4013:c01::231]:42812) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VHZ4b-0000TC-8D for emacs-orgmode@gnu.org; Thu, 05 Sep 2013 08:54:09 -0400 Received: by mail-ea0-f177.google.com with SMTP id f15so865466eak.8 for ; Thu, 05 Sep 2013 05:54:08 -0700 (PDT) Content-Disposition: inline In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Alan Schmitt Cc: emacs-orgmode@gnu.org Just a few typo/editorial comments. On Thu, Sep 05, 2013 at 02:31:42PM +0200, Alan Schmitt wrote: > > * Synchronizing org files with Unison > > This describes how to synchronize org files using the [[http://www.cis.upenn.edu/~bcpierce/unison/][Unison file synchronizer]], > as well as how to configure it to use an external tool to merge conflicting > edits. > > ** Prerequisites > > You should have Unison up and running. Binaries can be found [[http://www.cis.upenn.edu/~bcpierce/unison/download.html][here]] and the > documentation is [[http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html][here]]. > > ** Synchronization > > Unison is a file synchronizer, thus it may be used to synchronize org files. To > configure Unison, on uses a /profile/ which states where the things to on uses -> one uses > synchronize are as well as some options. Assuming I want to synchronize the > files in ~/Users/schmitta/dir1~ and ~/Users/schmitta/dir2~, the profile would > look like this > > #+BEGIN_EXAMPLE > root = /Users/schmitta/dir1 > root = /Users/schmitta/dir2 > #+END_EXAMPLE > > In most cases Unison will be used with a remote machine. The local machine is > called the /client/ and the remote one the /server/. For such remote > synchronization, the ~unison~ binary must be installed in the server as > well. The simplest way to connect to the machine is using ssh. One should check > that unison can be found there by doing ~ssh user@remote unison -version~. If > ~unison~ cannot be found in the path, one may set the ~servercmd~ option as > indicated in the next example. > > (Please see the [[http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html#roots][manual section on roots]] for further details.) > > #+BEGIN_EXAMPLE > root = /Users/schmitta/dir1 > root = ssh://user@remote/relative/path/to/dir2 > > servercmd = /usr/bin/unison > #+END_EXAMPLE > > ** Merging > > As Unison works on the level of files, it will trigger a /conflict/ if both > files have changed since the last synchronization. In that case one can only > choose which file to keep, which is not satisfying. Unison offers the Maybe satisfactory is better than satisfying? > possibility to use external tools to merge the files. There is an [[http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html#merge][extensive > manual section]] regarding this, we'll just describe how to use emacs and ediff to > do it. > > For better merging, we will ask unison to keep the last synchronized version of > every org file on the client; this way we can use ediff with ancestor. These > ~currentbackup~ files may live alongside the synchronized files (with names of > the form ~.bak.version.name~, which is configurable) or in a central location. > > Here is the modified configuration file. > > #+BEGIN_EXAMPLE > root = /Users/schmitta/dir1 > root = ssh://user@remote/relative/path/to/dir2 > > servercmd = /usr/bin/unison > > backupcurrent = Name *.org > backuplocation = local > maxbackups = 0 > > merge = Name *.org -> emacsclient -c --eval '(ediff-merge-files-with-ancestor "CURRENT1" "CURRENT2" "CURRENTARCH" nil "NEW")' > > #+END_EXAMPLE > > The ~backupcurrent~ option tells unison to keep a backup of the last > synchronized version of ever file with an ~org~ extension. The location of the ever file -> every file > backup should be local (alongside the file). Finally, no other backup should be > created. > > Next follows the merge command. For every org file in conflict, use the command > that launches a new emacs frame calling the ediff with ancestor function. The > ~CURRENT1~, ~CURRENT2~, and ~CURRENTARCH~ strings are replaced with the file > from the first root, the file from the second root, and the last synchronized > version. The ~NEW~ file is where Unison expects the file to be saved (which will > be done by the ediff session). > > Thus, when an org file has been modified on both hosts, an ediff session will be > launched in a new frame. Closing the frame will make Unison commit the merge (it > waits until the command has finished). > > If one does not want to use backups, it's possible to use the simpler ediff > (without ancestor) command as follows. > > #+BEGIN_EXAMPLE > root = /Users/schmitta/dir1 > root = ssh://user@remote/relative/path/to/dir2 > > servercmd = /usr/bin/unison > > merge = Name *.org -> emacsclient -c --eval '(ediff-merge-files "CURRENT1" "CURRENT2" nil "NEW")' > > #+END_EXAMPLE This a very clear and complete write-up. Thanks a lot Alan! :) -- Suvayu Open source is the future. It sets us free.