git-lfs/docs/man/git-lfs-smudge.1.ronn
brian m. carlson 147407dd93
filter-process: don't print large file warning on fixed versions
In Git for Windows 2.34.0 and the upcoming Git 2.35.0, the issue that's
caused corruption on Windows has been fixed.  Let's avoid warning users
that there's a problem if they're using 2.34.0 or newer unless they've
specifically set the option to true.  Note that we only consider 2.34.0
and not 2.35 since Unix has never had this issue.  Update the
documentation as well to reflect the new default.
2021-12-08 14:05:50 +00:00

41 lines
1.1 KiB
Markdown

git-lfs-smudge(1) -- Git smudge filter that converts pointer in blobs to the actual content
===========================================================================================
## SYNOPSIS
`git lfs smudge` [<path>]
`git lfs smudge` --skip [<path>]
## DESCRIPTION
Read a Git LFS pointer file from standard input and write the contents
of the corresponding large file to standard output. If needed,
download the file's contents from the Git LFS endpoint. The <path>
argument, if provided, is only used for a progress bar.
Smudge is typically run by Git's smudge filter, configured by the repository's
Git attributes.
## OPTIONS
Without any options, `git lfs smudge` outputs the raw Git LFS content to
standard output.
* `--skip`:
Skip automatic downloading of objects on clone or pull.
* `GIT_LFS_SKIP_SMUDGE`:
Disables the smudging process. For more, see: git-lfs-config(5).
## KNOWN BUGS
On Windows, Git before 2.34.0 does not handle files in the working tree larger
than 4 gigabytes. Newer versions of Git, as well as Unix versions, are
unaffected.
## SEE ALSO
git-lfs-install(1), gitattributes(5).
Part of the git-lfs(1) suite.