# NAME
-bup-gc - remove unreferenced, unneeded data (CAUTION: EXPERIMENTAL)
+bup-gc - remove unreferenced, unneeded data
# SYNOPSIS
-bup gc [-#|--verbose] <*branch*|*save*...>
+bup gc [-#|\--verbose] <*branch*|*save*...>
# DESCRIPTION
Typically, the garbage collector would be invoked after some set of
invocations of `bup rm`.
-WARNING: This is one of the few bup commands that modifies your archive
-in intentionally destructive ways.
+WARNING: This is one of the few bup commands that modifies your
+archive in intentionally destructive ways. Though if an attempt to
+`join` or `restore` the data you still care about after a `gc`
+succeeds, that's a fairly encouraging sign that the commands worked
+correctly. (The `dev/compare-trees` command in the source tree can be
+used to help test before/after results.)
# OPTIONS
-*#*, \--compress=*#*
: set the compression level to # (a value from 0-9, where
9 is the highest and 0 is no compression). The default
- is 6.
+ is 1 (fast, loose compression).
# EXAMPLES