1git-annex-smudge(1) General Commands Manual git-annex-smudge(1)
2
3
4
6 git-annex-smudge - git filter driver for git-annex
7
9 git annex smudge [--clean] file
10
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
37 git-annex(1)
38
40 Joey Hess <id@joeyh.name>
41
42 git-annex-smudge(1)