.TH git-annex-smudge 1
.SH NAME
git-annex-smudge \- git filter driver for git-annex
.PP
.SH SYNOPSIS
git annex smudge [\-\-clean] file
.PP
git annex smudge \-\-update
.PP
.SH DESCRIPTION
This command lets git-annex be used as a git filter driver which lets
annexed files in the git repository to be unlocked, instead
of being symlinks, and lets \fBgit add\fP store files in the annex.
.PP
When adding a file with \fBgit add\fP, 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 annex.gitaddtoannex setting overrides that; setting it to false
prevents \fBgit add\fP from adding files to the annex.
.PP
However, if git-annex can tell that a file was annexed before,
it will still be added to the annex even when those configs would normally
prevent it. Two examples of this are adding a modified version of an
annexed file, and moving an annexed file to a new filename and adding that.
.PP
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.
.PP
 [filter "annex"]
         smudge = git-annex smudge %f
         clean = git-annex smudge \-\-clean %f
.PP
To make git use that filter driver, it needs to be configured in
the \fB.gitattributes\fP file or in \fB.git/info/attributes\fP. The latter
is normally configured when a repository is initialized, with the following
contents:
.PP
 * filter=annex
 .* !filter
.PP
The smudge filter does not provide git with the content of annexed files,
because that would be slow and triggers memory leaks in git. Instead,
it records which worktree files need to be updated, and 
\fBgit annex smudge \-\-update\fP later updates the work tree to contain
the content. That is run by several git hooks, including post\-checkout
and post\-merge. However, a few git commands, notably \fBgit stash\fP and
\fBgit cherry\-pick\fP, do not run any hooks, so after using those commands
you can manually run \fBgit annex smudge \-\-update\fP to update the working
tree.
.PP
.SH SEE ALSO
git-annex(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP