From 948ab3ccaf603965d95cfb510c7b33497eeb4e11 Mon Sep 17 00:00:00 2001 From: Joram Berger Date: Mon, 18 Dec 2023 18:24:57 +0100 Subject: [PATCH] Add a note that the oldest snapshot may be kept additionally Documentation enhancement. --- doc/060_forget.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/060_forget.rst b/doc/060_forget.rst index 72c7ae97f..caeb6313a 100644 --- a/doc/060_forget.rst +++ b/doc/060_forget.rst @@ -207,10 +207,13 @@ The ``forget`` command accepts the following policy options: They also only count hours/days/weeks/etc which have one or more snapshots. A value of ``-1`` will be interpreted as "forever", i.e. "keep all". -.. note:: All duration related options (``--keep-{within,-*}``) ignore snapshots +.. note:: All duration related options (``--keep-{within-,}*``) ignore snapshots with a timestamp in the future (relative to when the ``forget`` command is run) and these snapshots will hence not be removed. +.. note:: If there are not enough snapshots to keep one for each duration related + ``--keep-{within-,}*`` option, the oldest snapshot is kept additionally. + .. note:: Specifying ``--keep-tag ''`` will match untagged snapshots only. When ``forget`` is run with a policy, restic first loads the list of all snapshots