GIT-LFS-TRACK(1)		        		      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 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. This means that patterns which contain asterisk (*), question
       mark (?), and the bracket characters ([ and ]) are treated specially;
       to disable this behavior and treat them literally instead, use
       --filename or escape the character with a backslash.

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.

       --filename
	   Treat the arguments as literal filenames, not as patterns. Any
	   special glob characters in the filename will be escaped when
	   writing the .gitattributes file.

       --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-excluded
	     Do not list patterns that are excluded in the output; only list
	   patterns that are tracked.  --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"

       •   Configure Git LFS to track the file named project [1].psd:

	   git lfs track --filename "project [1].psd"

SEE ALSO
       git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).

       Part of the git-lfs(1) suite.

 							      GIT-LFS-TRACK(1)