git-lfs-track (1)

Leading comments

generated with Ronn/v0.7.3
http://github.com/rtomayko/ronn/tree/0.7.3

(The comments found at the beginning of the groff file "man1/git-lfs-track.1".)

NAME

git-lfs-track - View or add Git LFS paths to Git attributes

SYNOPSIS

git lfs track [options] [pattern...]

DESCRIPTION

Start tracking the given patterns(s) through Git LFS. The pattern argument is written to .gitattributes. If no paths are provided, simply list the currently-tracked paths. The gitattributes documentation git-scm.com/docs/gitattributes states that patterns use the gitignore pattern rules git-scm.com/docs/gitignore to match paths.

OPTIONS

*

--verbose -v: If enabled, have git lfs track log files which it will touch. Disabled by default.

*

--dry-run -d: If enabled, have git lfs track log all actions it would normally take (adding entries to .gitattributes, touching files on disk, etc) without performing any mutative operations to the disk.

git lfs track --dry-run [files] also implicitly mocks the behavior of passing the --verbose, and will log in greater detail what it is doing.

Disabled by default.

*

--lockable -l Make the paths 'lockable', meaning they should be locked to edit them, and will be made read-only in the working copy when not locked.

*

--not-lockable Remove the lockable flag from the paths so they are no longer read-only unless locked.

*

--no-modify-attrs Makes matched entries stat-dirty so that Git can re-index files you wish to convert to LFS. Does not modify any .gitattributes file(s).

EXAMPLES

List the patterns that Git LFS is currently tracking:

git lfs track

Configure Git LFS to track GIF files:

git lfs track "*.gif"

Configure Git LFS to track PSD files and make them read-only unless locked:

git lfs track --lockable "*.psd"

SEE ALSO

git-lfs-untrack(1), git-lfs-install(1), gitattributes(5). Part of the git-lfs(1) suite.