1git-annex-smudge(1)         General Commands Manual        git-annex-smudge(1)
2
3
4

NAME

6       git-annex-smudge - git filter driver for git-annex
7

SYNOPSIS

9       git annex smudge [--clean] file
10

DESCRIPTION

12       This  command  lets git-annex be used as a git filter driver which lets
13       annexed files in the git  repository  to  be  unlocked  at  all  times,
14       instead of being symlinks.
15
16       When  adding  a  file with git add, the annex.largefiles config is con‐
17       sulted to decide if a given file should be added to git  as-is,  or  if
18       its content are large enough to need to use git-annex.
19
20       The git configuration to use this command as a filter driver is as fol‐
21       lows.  This is normally set up for you by git-annex init, so you should
22       not need to configure it manually.
23
24        [filter "annex"]
25                smudge = git-annex smudge %f
26                clean = git-annex smudge --clean %f
27
28       To  make  git  use that filter driver, it needs to be configured in the
29       .gitattributes file or in .git/info/attributes. The latter is  normally
30       configured  when  a  repository is initialized, with the following con‐
31       tents:
32
33        * filter=annex
34        .* !filter
35

SEE ALSO

37       git-annex(1)
38

AUTHOR

40       Joey Hess <id@joeyh.name>
41
42                                                           git-annex-smudge(1)