git-annex-required - Man Page

get or set required content expression

Synopsis

git annex required repository [expression]

Description

When run with an expression, configures the content that is required to be held in the archive.

For example:

git annex required . "include=*.mp3 or include=*.ogg"

Without an expression, displays the current required content setting of the repository.

While git-annex-wanted(1) is just a preference, this designates content that should really not be removed. For example a file that is wanted can be removed with git annex drop, but if that file is required, it would need to be removed with git annex drop --force.

Also, git-annex fsck will warn about required contents that are not present.

Options

The git-annex-common-options(1) can be used.

Notes

The required command was added in git-annex 5.20150420.

See Also

git-annex(1)

git-annex-wanted(1)

git-annex-preferred-content(1)

Author

Joey Hess <id@joeyh.name>

Referenced By

git-annex(1), git-annex-drop(1), git-annex-wanted(1).