summaryrefslogtreecommitdiff
path: root/doc/assistant
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2012-11-12 01:23:42 -0400
committerGravatar Joey Hess <joey@kitenet.net>2012-11-12 01:23:42 -0400
commitfdae1a0b18b03dcfc89bc7e81126c1b9c93ad23c (patch)
treea6edba7b0fbf814c7dc7fbcef266b09c1a6cb9fd /doc/assistant
parent064d217d69e052eb0e84b699a70353f997fc7d2f (diff)
release notes for tomorrow's release
Diffstat (limited to 'doc/assistant')
-rw-r--r--doc/assistant/release_notes.mdwn (renamed from doc/assistant/errata.mdwn)46
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/assistant/errata.mdwn b/doc/assistant/release_notes.mdwn
index 03d0d4772..270897fa0 100644
--- a/doc/assistant/errata.mdwn
+++ b/doc/assistant/release_notes.mdwn
@@ -1,3 +1,49 @@
+## version 3.20121012
+
+This is a major upgrade of the git-annex assistant, which is still in beta.
+
+In general, anything you can configure with the assistant's web app
+will work. Some examples of use cases supported by this release include:
+
+* [[Sharing repositories with friends|share_with_a_friend_walkthrough]]
+ contacted through a Jabber server (such as Google Talk).
+* Setting up cloud repositories, that are used as backups, archives,
+ or transfer points between repositories that cannot directly contact
+ one-another.
+* [[Pairing|pairing_walkthrough]] two computers that are on the same local
+ network (or VPN) and automatically keeping the files in the annex in
+ sync as changes are made to them.
+* Cloning your repository to removable drives, USB keys, etc. The assistant
+ will notice when the drive is mounted and keep it in sync.
+ Such a drive can be stored as an offline backup, or transported between
+ computers to keep them in sync.
+
+The following upgrade notes apply if you're upgrading from a previous version:
+
+* For best results, edit the configuration of repositories you set
+ up with older versions, and place them in a repository group.
+ This lets the assistant know how you want to use the repository; for backup,
+ archival, as a transfer point for clients, etc. Go to Configuration -&gt;
+ Manage Repositories, and click in the "configure" link to edit a repository's
+ configuration.
+* If you set up a cloud repository with an older version, and have multiple
+ clients using it, you are recommended to configure an Jabber account,
+ so that clients can use it to communicate when sending data to the
+ cloud repository. Configure Jabber by opening the webapp, and going to
+ Configuration -&gt; Configure jabber account
+* When setting up local pairing, the assistant did not limit the paired
+ computer to accessing a single git repository. This new version does,
+ by setting GIT_ANNEX_SHELL_DIRECTORY in `~/.ssh/authorized_keys`.
+
+The following are known limitations of this release of the git-annex
+assistant:
+
+* On Mac OSX and BSD operating systems, the assistant uses kqueue to watch
+ files. Kqueue has to open every directory it watches, so too many
+ directories will run it out of the max number of open files (typically
+ 1024), and fail. See [[bugs/Issue_on_OSX_with_some_system_limits]]
+ for a workaround.
+
## version 3.20121009
This is a maintenance release of the git-annex assistant, which is still in