git-annex-preferred-content

git-annex-preferred-content(1General Commands Manugit-annex-preferred-content(1)



NAME
       git-annex-preferred-content -

DESCRIPTION
       Each repository has a preferred content setting, which specifies content
       that the repository wants to have present. These settings can be
       configured using git annex vicfg or git annex wanted.  They are used by
       the --auto option, by git annex sync --content, and by the git-annex
       assistant.

       While preferred content expresses a preference, it can be overridden by
       simply using git annex drop. On the other hand, required content settings
       are enforced; git annex drop will refuse to drop a file if doing so would
       violate its required content settings. A repository's required content
       can be configured using git annex vicfg or git annex required.

       Preferred content expressions are similar, but not identical to the git-
       annex-matching-options(1), just without the dashes.  For example:

        exclude=archive/* and (include=*.mp3 or smallerthan=1mb)

       The main differences are that exclude= and include= always match relative
       to the top of the git repository, and that there is no equivalent to
       --in.

       For more details about preferred content expressions, see See
       <https://git-annex.branchable.com/preferred_content/>

       When a repository is in one of the standard predefined groups, like
       "backup" and "client", setting its preferred content to "standard" will
       use a built-in preferred content expression developed for that group.
       See <https://git-annex.branchable.com/preferred_content/standard_groups/>

       If you have set a groupwanted expression for a group, it will be used
       when a repository in the group has its preferred content set to
       "groupwanted".

SEE ALSO
       git-annex(1)

       git-annex-vicfg(1)

       git-annex-wanted(1)

AUTHOR
       Joey Hess <id@joeyh.name>

       <http://git-annex.branchable.com/>

                                                  git-annex-preferred-content(1)