From c000eb8083f07c1143e1dcae2ef1514c725fac96 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Wed, 19 Oct 2016 01:13:44 +0200 Subject: [PATCH] add clarification about append-only mode, fixes #1689 --- docs/usage.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/usage.rst b/docs/usage.rst index 0452c164a..d9fcc3a22 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -800,9 +800,14 @@ That's all to it. 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. +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 the configuration file, it's not a "one way trip".