From 3d174aef3517a385a2f5cd71a37f7f7e10e0a677 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Sat, 19 Nov 2016 21:52:11 +0100
Subject: [PATCH] docs: clarify passphrase mode attic repo upgrade, fixes #1854

---
 docs/usage.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/usage.rst b/docs/usage.rst
index 09d1e2b4b..14ecfbb8b 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -629,6 +629,20 @@ Examples
     no key file found for repository
 
 
+Upgrading a passphrase encrypted attic repo
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+attic offered a "passphrase" encryption mode, but this was removed in borg 1.0
+and replaced by the "repokey" mode (which stores the passphrase-protected
+encryption key into the repository config).
+
+Thus, to upgrade a "passphrase" attic repo to a "repokey" borg repo, 2 steps
+are needed, in this order:
+
+- borg upgrade repo
+- borg migrate-to-repokey repo
+
+
 .. include:: usage/break-lock.rst.inc