Merge branch 'ei/worktree+filter'
[alt-git.git] / Documentation / git-local-fetch.txt
blob19b5f8895c329877167a4f625f33971d498185ae
1 git-local-fetch(1)
2 ==================
4 NAME
5 ----
6 git-local-fetch - Duplicate another git repository on a local system
9 SYNOPSIS
10 --------
11 [verse]
12 'git-local-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [-l] [-s] [-n]
13                   commit-id path
15 DESCRIPTION
16 -----------
17 Duplicates another git repository on a local system.
19 OPTIONS
20 -------
21 -c::
22         Get the commit objects.
23 -t::
24         Get trees associated with the commit objects.
25 -a::
26         Get all the objects.
27 -v::
28         Report what is downloaded.
29 -s::
30         Instead of regular file-to-file copying use symbolic links to the objects
31         in the remote repository.
32 -l::
33         Before attempting symlinks (if -s is specified) or file-to-file copying the
34         remote objects, try to hardlink the remote objects into the local
35         repository.
36 -n::
37         Never attempt to file-to-file copy remote objects.  Only useful with
38         -s or -l command-line options.
40 -w <filename>::
41         Writes the commit-id into the filename under $GIT_DIR/refs/<filename> on
42         the local end after the transfer is complete.
44 --stdin::
45         Instead of a commit id on the commandline (which is not expected in this
46         case), 'git-local-fetch' expects lines on stdin in the format
48                 <commit-id>['\t'<filename-as-in--w>]
50 --recover::
51         Verify that everything reachable from target is fetched.  Used after
52         an earlier fetch is interrupted.
54 Author
55 ------
56 Written by Junio C Hamano <junkio@cox.net>
58 Documentation
59 --------------
60 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
62 GIT
63 ---
64 Part of the gitlink:git[7] suite