浏览代码

Merge pull request #1744 from ThomasWaldmann/improve-append-only-docs

add clarification about append-only mode, fixes #1689
TW 8 年之前
父节点
当前提交
1cd48535e4
共有 1 个文件被更改,包括 6 次插入1 次删除
  1. 6 1
      docs/usage.rst

+ 6 - 1
docs/usage.rst

@@ -800,9 +800,14 @@ That's all to it.
 Drawbacks
 Drawbacks
 +++++++++
 +++++++++
 
 
-As data is only appended, and nothing deleted, commands like ``prune`` or ``delete``
+As data is only appended, and nothing removed, commands like ``prune`` or ``delete``
 won't free disk space, they merely tag data as deleted in a new transaction.
 won't free disk space, they merely tag data as deleted in a new transaction.
 
 
+Be aware that as soon as you write to the repo in non-append-only mode (e.g. prune,
+delete or create archives from an admin machine), it will remove the deleted objects
+permanently (including the ones that were already marked as deleted, but not removed,
+in append-only mode).
+
 Note that you can go back-and-forth between normal and append-only operation by editing
 Note that you can go back-and-forth between normal and append-only operation by editing
 the configuration file, it's not a "one way trip".
 the configuration file, it's not a "one way trip".