# 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.

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

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

To make git use this filter on all files except for dotfiles, put something
like the following in the .gitattributes file:

	* filter=annex
	.* !filter

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.

# SEE ALSO

[[git-annex]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

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