github.com/git-lfs/git-lfs@v2.5.2+incompatible/docs/man/git-lfs-track.1.ronn (about)

     1  git-lfs-track(1) - View or add Git LFS paths to Git attributes
     2  ==============================================================
     3  
     4  ## SYNOPSIS
     5  
     6  `git lfs track` [options] [<pattern>...]
     7  
     8  ## DESCRIPTION
     9  
    10  Start tracking the given patterns(s) through Git LFS.  The <pattern> argument
    11  is written to .gitattributes. If no paths are provided, simply list the
    12  currently-tracked paths.
    13  
    14  The [gitattributes documentation](https://git-scm.com/docs/gitattributes) states
    15  that patterns use the [gitignore pattern rules](https://git-scm.com/docs/gitignore)
    16  to match paths.
    17  
    18  ## OPTIONS
    19  
    20  * `--verbose` `-v`:
    21    If enabled, have `git lfs track` log files which it will touch. Disabled by
    22    default.
    23  
    24  * `--dry-run` `-d`:
    25    If enabled, have `git lfs track` log all actions it would normally take
    26    (adding entries to .gitattributes, touching files on disk, etc) without
    27    performing any mutative operations to the disk.
    28  
    29    `git lfs track --dry-run [files]` also implicitly mocks the behavior of
    30    passing the `--verbose`, and will log in greater detail what it is doing.
    31  
    32    Disabled by default.
    33  
    34  * `--lockable` `-l`
    35    Make the paths 'lockable', meaning they should be locked to edit them, and
    36    will be made read-only in the working copy when not locked.
    37  
    38  * `--not-lockable`
    39    Remove the lockable flag from the paths so they are no longer read-only unless
    40    locked.
    41  
    42  * `--no-modify-attrs`
    43    Makes matched entries stat-dirty so that Git can re-index files you wish to
    44    convert to LFS. Does not modify any `.gitattributes` file(s).
    45  
    46  ## EXAMPLES
    47  
    48  * List the patterns that Git LFS is currently tracking:
    49  
    50      `git lfs track`
    51  
    52  * Configure Git LFS to track GIF files:
    53  
    54      `git lfs track "*.gif"`
    55  
    56  * Configure Git LFS to track PSD files and make them read-only unless locked:
    57  
    58      `git lfs track --lockable "*.psd"`
    59  
    60  ## SEE ALSO
    61  
    62  git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).
    63  
    64  Part of the git-lfs(1) suite.