# NAME
-bup-prune-older - remove older saves (CAUTION: EXPERIMENTAL)
+bup-prune-older - remove older saves
# SYNOPSIS
# OPTIONS
---keep-all-for PERIOD
-: when no smaller time scale --keep option applies, retain all saves
+\--keep-all-for PERIOD
+: when no smaller time scale `--keep` option applies, retain all saves
within the given period.
---keep-dailies-for PERIOD
-: when no smaller time scale --keep option applies, retain the
- oldest save for any day within the given period.
+\--keep-dailies-for PERIOD
+: when no smaller time scale `--keep` option applies, retain the
+ newest save for any day within the given period.
---keep-monthlies-for PERIOD
-: when no smaller time scale --keep option applies, retain the
- oldest save for any month within the given period.
+\--keep-monthlies-for PERIOD
+: when no smaller time scale `--keep` option applies, retain the
+ newest save for any month within the given period.
---keep-yearlies-for PERIOD
-: when no smaller time scale --keep option applies, retain the
- oldest save for any year within the given period.
+\--keep-yearlies-for PERIOD
+: when no smaller time scale `--keep` option applies, retain the
+ newest save for any year within the given period.
---keep ALL,DAILY,MONTHLY,YEARLY
-: shorthand equivalent to specifying each of the related `--keep-*`
- options for each period. If an underscore is specified for a
- period, then that time-scale will be unaffected by this argument.
-
---wrt UTC_SECONDS
+\--wrt UTC_SECONDS
: when computing a keep period, place the most recent end of the
range at UTC\_SECONDS, and any saves newer than this will be kept.
---pretend
+\--pretend
: don't do anything, just list the actions that would be taken to
standard output, one action per line like this:
+ SAVE
...
---gc
+\--gc
: garbage collect the repository after removing the relevant saves.
This is the default behavior, but it can be avoided with `--no-gc`.
# EXAMPLES
- # Keep all saves for the past month, and any older monthlies for
+ # Keep all saves for the past month, and any newer monthlies for
# the past year. Delete everything else.
$ bup prune-older --keep-all-for 1m --keep-monthlies-for 1y