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)