Merge pull request #4600 from MichaelEischer/doc-forget-note-1

Add a note that the oldest snapshot may be kept additionally
This commit is contained in:
Michael Eischer 2023-12-29 17:56:54 +01:00 committed by GitHub
commit 8f9a35779e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -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