浏览代码

Merge pull request #4619 from ThomasWaldmann/document-extract-limitation-master

extract: document limitation "needs empty destination", fixes #4598
TW 6 年之前
父节点
当前提交
a178a110f0
共有 1 个文件被更改,包括 5 次插入0 次删除
  1. 5 0
      docs/faq.rst

+ 5 - 0
docs/faq.rst

@@ -103,6 +103,11 @@ Are there other known limitations?
 
 
   :ref:`borg_info` shows how large (relative to the maximum size) existing
   :ref:`borg_info` shows how large (relative to the maximum size) existing
   archives are.
   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:
 .. _checkpoints_parts: