From 897e81dbe9a5607e806d92cb8316cdf956aa3992 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Mon, 10 Jun 2019 21:39:35 +0200 Subject: [PATCH] extract: document limitation "needs empty destination", fixes #4598 --- docs/faq.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index 29708904e..f09f4b6b5 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -103,6 +103,11 @@ Are there other known limitations? :ref:`borg_info` shows how large (relative to the maximum size) existing archives are. +- borg extract only supports restoring into an empty destination. After that, + the destination will exactly have the contents of the extracted archive. + If you extract into a non-empty destination, borg will (for example) not + remove files which are in the destination, but not in the archive. + See :issue:`4598` for a workaround and more details. .. _checkpoints_parts: