github.com/x-oss-byte/git-lfs@v2.5.2+incompatible/docs/man/git-lfs-clone.1.ronn (about)

     1  git-lfs-clone(1) -- Efficiently clone a LFS-enabled repository
     2  ========================================================================
     3  
     4  ## SYNOPSIS
     5  
     6  `git lfs clone` [git clone options] <repository> [<directory>]
     7  
     8  ## DESCRIPTION
     9  
    10  Clone an LFS enabled Git repository more efficiently by disabling LFS during the
    11  git clone, then performing a 'git lfs pull' directly afterwards.
    12  
    13  'git lfs clone' also installs all of the repo-level hooks (.git/hooks) that LFS
    14  requires to operate. If `--separate-git-dir` is given, the hooks will be
    15  installed there.
    16  
    17  This is faster than a regular 'git clone' because that will download LFS content
    18  using the smudge filter, which is executed individually per file in the working
    19  copy. This is relatively inefficient compared to the batch mode and parallel
    20  downloads performed by 'git lfs pull'.
    21  
    22  ## OPTIONS
    23  
    24  All options supported by 'git clone'
    25  
    26  * `-I` <paths> `--include=`<paths>:
    27    See [INCLUDE AND EXCLUDE]
    28  
    29  * `-X` <paths> `--exclude=`<paths>:
    30    See [INCLUDE AND EXCLUDE]
    31  
    32  * `--skip-repo`:
    33    Skip installing repo-level hooks (.git/hooks) that LFS requires. Disabled by
    34    default.
    35  
    36  ## INCLUDE AND EXCLUDE
    37  
    38  You can configure Git LFS to only fetch objects to satisfy references in certain
    39  paths of the repo, and/or to exclude certain paths of the repo, to reduce the
    40  time you spend downloading things you do not use.
    41  
    42  In lfsconfig, set lfs.fetchinclude and lfs.fetchexclude to comma-separated lists
    43  of paths to include/exclude in the fetch (wildcard matching as per gitignore).
    44  Only paths which are matched by fetchinclude and not matched by fetchexclude
    45  will have objects fetched for them.
    46  
    47  ## SEE ALSO
    48  
    49  git-clone(1), git-lfs-pull(1).
    50  
    51  Part of the git-lfs(1) suite.