git-annex-5.20150824: man/git-annex-required.1

.TH git-annex-required 1
.SH NAME
git-annex-required \- get or set required content expression
.PP
.SH SYNOPSIS
git annex required \fBrepository [expression]\fP
.PP
.SH DESCRIPTION
When run with an expression, configures the content that is required
to be held in the archive.
.PP
For example:
.PP
 git annex required . "include=*.mp3 or include=*.ogg"
.PP
Without an expression, displays the current required content setting
of the repository.
.PP
While git-annex\-wanted is just a preference,
git-annex\-required designates content that should really not be
removed. For example a file that is \fBwanted\fP can be removed with git
annex drop\fB, but if that file is \fPrequired, it would need to be
removed with \fBgit annex drop \-\-force\fP.
.PP
.SH NOTES
The \fBrequired\fP command was added in git-annex 5.20150420.
.PP
.SH SEE ALSO
git-annex(1)
.PP
git-annex\-wanted(1)
.PP
git-annex\-preferred\-content(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP