git-annex-required(1)       General Commands Manual      git-annex-required(1)

NAME
       git-annex-required - 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 repository.

       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.

       For example:

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

       To return a repository to the original default behavior, use an empty
       value for the expression, eg:

       git-annex required here ""

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>

                                                         git-annex-required(1)