xenial (1) git-annex-preferred-content.1.gz

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)