فهرست منبع

add clarification about append-only mode, fixes #1689

Thomas Waldmann 8 سال پیش
والد
کامیت
c000eb8083
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".