archive: handle commits with an empty tree
[git/jnareb-git.git] / Documentation / git-http-fetch.txt
blob070cd1e6ed93b064bdd1fdfc1767a3f9a999d321
1 git-http-fetch(1)
2 =================
4 NAME
5 ----
6 git-http-fetch - Download from a remote git repository via HTTP
9 SYNOPSIS
10 --------
11 [verse]
12 'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [--stdin] <commit> <url>
14 DESCRIPTION
15 -----------
16 Downloads a remote git repository via HTTP.
18 *NOTE*: use of this command without -a is deprecated.  The -a
19 behaviour will become the default in a future release.
21 OPTIONS
22 -------
23 commit-id::
24         Either the hash or the filename under [URL]/refs/ to
25         pull.
27 -c::
28         Get the commit objects.
29 -t::
30         Get trees associated with the commit objects.
31 -a::
32         Get all the objects.
33 -v::
34         Report what is downloaded.
36 -w <filename>::
37         Writes the commit-id into the filename under $GIT_DIR/refs/<filename> on
38         the local end after the transfer is complete.
40 --stdin::
41         Instead of a commit id on the command line (which is not expected in this
42         case), 'git http-fetch' expects lines on stdin in the format
44                 <commit-id>['\t'<filename-as-in--w>]
46 --recover::
47         Verify that everything reachable from target is fetched.  Used after
48         an earlier fetch is interrupted.
50 GIT
51 ---
52 Part of the linkgit:git[1] suite