]> arthur.barton.de Git - bup.git/blobdiff - Documentation/bup-prune-older.md
get: adjust for python 3 and test there
[bup.git] / Documentation / bup-prune-older.md
index cbe87c58e8ef47e0510f00bca8f7131cc171abeb..efb57a211e2de428988e009d6a2cef041fe73648 100644 (file)
@@ -4,7 +4,7 @@
 
 # NAME
 
-bup-prune-older - remove older saves (CAUTION: EXPERIMENTAL)
+bup-prune-older - remove older saves
 
 # SYNOPSIS
 
@@ -46,32 +46,27 @@ calendar, so `--keep-dailies-for 5d` means a period starting exactly
 
 # 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:
 
@@ -79,7 +74,7 @@ calendar, so `--keep-dailies-for 5d` means a period starting exactly
         + 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`.
 
@@ -113,7 +108,7 @@ that case, you will see something like this:
 
 # 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