2015-04-11 06:35:32 +00:00
|
|
|
git-lfs-track(1) - View or add Git LFS paths to Git attributes
|
|
|
|
|
==============================================================
|
2015-03-22 18:59:56 +00:00
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
|
|
2016-11-10 22:24:26 +00:00
|
|
|
`git lfs track` [options] [<pattern>...]
|
2015-03-22 18:59:56 +00:00
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
|
|
2016-11-10 22:24:26 +00:00
|
|
|
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](https://git-scm.com/docs/gitattributes) states
|
|
|
|
|
that patterns use the [gitignore pattern rules](https://git-scm.com/docs/gitignore)
|
|
|
|
|
to match paths.
|
2015-03-22 18:59:56 +00:00
|
|
|
|
2016-07-01 17:12:03 +00:00
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
|
|
* `--verbose` `-v`:
|
|
|
|
|
If enabled, have `git lfs track` log files which it will touch. Disabled by
|
|
|
|
|
default.
|
|
|
|
|
|
2016-07-01 20:28:25 +00:00
|
|
|
* `--dry-run` `-d`:
|
2016-07-01 20:21:54 +00:00
|
|
|
If enabled, have `git lfs track` log all actions it would normally take
|
|
|
|
|
(adding entries to .gitattributes, touching files on disk, etc) without
|
2016-07-01 20:28:25 +00:00
|
|
|
performing any mutative operations to the disk.
|
2016-07-01 20:21:54 +00:00
|
|
|
|
2016-07-06 15:25:47 +00:00
|
|
|
`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.
|
2016-07-01 20:21:54 +00:00
|
|
|
|
|
|
|
|
Disabled by default.
|
|
|
|
|
|
2016-12-19 16:47:42 +00:00
|
|
|
* `--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.
|
|
|
|
|
|
2017-04-24 15:22:33 +00:00
|
|
|
* `--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).
|
|
|
|
|
|
2015-03-22 18:59:56 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
|
2016-11-10 22:24:26 +00:00
|
|
|
* List the patterns that Git LFS is currently tracking:
|
2015-03-22 18:59:56 +00:00
|
|
|
|
|
|
|
|
`git lfs track`
|
|
|
|
|
|
2015-04-13 08:48:01 +00:00
|
|
|
* Configure Git LFS to track GIF files:
|
2015-03-22 18:59:56 +00:00
|
|
|
|
2015-04-13 08:48:01 +00:00
|
|
|
`git lfs track '*.gif'`
|
2015-03-22 18:59:56 +00:00
|
|
|
|
2016-12-19 16:47:42 +00:00
|
|
|
* Configure Git LFS to track PSD files and make them read-only unless locked:
|
|
|
|
|
|
|
|
|
|
`git lfs track --lockable '*.psd'`
|
|
|
|
|
|
2015-03-22 18:59:56 +00:00
|
|
|
## SEE ALSO
|
|
|
|
|
|
2015-11-16 20:31:26 +00:00
|
|
|
git-lfs-untrack(1), git-lfs-install(1), gitattributes(5).
|
2015-03-22 18:59:56 +00:00
|
|
|
|
|
|
|
|
Part of the git-lfs(1) suite.
|
