git-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/>