summaryrefslogtreecommitdiff
path: root/doc/git-annex-smudge.mdwn
blob: 7439c87844a538320ebae5ce8856dabfa3ebbaac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# NAME

git-annex smudge - git filter driver for git-annex

# SYNOPSIS

git annex smudge [--clean] file

# DESCRIPTION

This command lets git-annex be used as a git filter driver which lets
annexed files in the git repository to be unlocked at all times, instead
of being symlinks.

When adding a file with `git add`, the annex.largefiles config is
consulted to decide if a given file should be added to git as-is,
or if its content are large enough to need to use git-annex.

The git configuration to use this command as a filter driver is as follows.
This is normally set up for you by git-annex init, so you should
not need to configure it manually.

	[filter "annex"]
	        smudge = git-annex smudge %f
	        clean = git-annex smudge --clean %f

To make git use that filter driver, it needs to be configured in
the .gitattributes file or in `.git/config/attributes`. The latter
is normally configured when a repository is initialized, with the following
contents:

	* filter=annex
	.* !filter

# SEE ALSO

[[git-annex]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.