From a87f35b0ccb533fb7ee428f86bbe9af7b550600a Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Tue, 25 Apr 2017 22:47:18 +0200
Subject: [PATCH] add hint about chunker params to borg upgrade docs, fixes
 #2421

(cherry picked from commit f0188449c345d80924f043661e58b86a26dec815)
---
 borg/archiver.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/borg/archiver.py b/borg/archiver.py
index d555081c9..40e234a55 100644
--- a/borg/archiver.py
+++ b/borg/archiver.py
@@ -1809,8 +1809,13 @@ class Archiver:
 
         Currently, only LOCAL repositories can be upgraded (issue #465).
 
-        It will change the magic strings in the repository's segments
-        to match the new Borg magic strings. The keyfiles found in
+        Please note that ``borg create`` (since 1.0.0) uses bigger chunks by
+        default than old borg or attic did, so the new chunks won't deduplicate
+        with the old chunks in the upgraded repository.
+        See ``--chunker-params`` option of ``borg create`` and ``borg recreate``.
+
+        ``borg upgrade`` will change the magic strings in the repository's
+        segments to match the new Borg magic strings. The keyfiles found in
         $ATTIC_KEYS_DIR or ~/.attic/keys/ will also be converted and
         copied to $BORG_KEYS_DIR or ~/.config/borg/keys.