.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "bup-rm" "1" "0.33.3" "Bup 0.33.3" ""
.hy
.SH NAME
.PP
bup-rm - remove references to archive content
.SH SYNOPSIS
.PP
bup rm [-#|--verbose] <\f[I]branch\f[R]|\f[I]save\f[R]\&...>
.SH DESCRIPTION
.PP
\f[V]bup rm\f[R] removes the indicated \f[I]branch\f[R]es (backup sets)
and \f[I]save\f[R]s.
By itself, this command does not delete any actual data (nor recover any
storage space), but it may make it very difficult or impossible to refer
to the deleted items, unless there are other references to them
(e.g.\ tags).
.PP
A subsequent garbage collection, either by a \f[V]bup gc\f[R], or by a
normal \f[V]git gc\f[R], may permanently delete data that is no longer
reachable from the remaining branches or tags, and reclaim the related
storage space.
.PP
WARNING: This is one of the few bup commands that modifies your archive
in intentionally destructive ways.
.SH OPTIONS
.TP
-v, --verbose
increase verbosity (can be used more than once).
.TP
-\f[I]#\f[R], --compress=\f[I]#\f[R]
set the compression level to # (a value from 0-9, where 9 is the highest
and 0 is no compression).
The default is 6.
Note that \f[V]bup rm\f[R] may only write new commits.
.SH EXAMPLES
.IP
.nf
\f[C]
# Delete the backup set (branch) foo and a save in bar.
$ bup rm /foo /bar/2014-10-21-214720
\f[R]
.fi
.SH SEE ALSO
.PP
\f[V]bup-gc\f[R](1), \f[V]bup-save\f[R](1), \f[V]bup-fsck\f[R](1), and
\f[V]bup-tag\f[R](1)
.SH BUP
.PP
Part of the \f[V]bup\f[R](1) suite.
.SH AUTHORS
Rob Browning <rlb@defaultvalue.org>.