sparse-checkout: split out code for tweaking settings config
[git/debian.git] / Documentation / git-http-fetch.txt
blob9fa17b60e438381391991c92cfa5045f2ace7f14
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 | --packfile=<hash> | <commit>] <url>
14 DESCRIPTION
15 -----------
16 Downloads a remote Git repository via HTTP.
18 This command always gets all objects. Historically, there were three options
19 `-a`, `-c` and `-t` for choosing which objects to download. They are now
20 silently ignored.
22 OPTIONS
23 -------
24 commit-id::
25         Either the hash or the filename under [URL]/refs/ to
26         pull.
28 -a, -c, -t::
29         These options are ignored for historical reasons.
30 -v::
31         Report what is downloaded.
33 -w <filename>::
34         Writes the commit-id into the filename under $GIT_DIR/refs/<filename> on
35         the local end after the transfer is complete.
37 --stdin::
38         Instead of a commit id on the command line (which is not expected in this
39         case), 'git http-fetch' expects lines on stdin in the format
41                 <commit-id>['\t'<filename-as-in--w>]
43 --packfile=<hash>::
44         For internal use only. Instead of a commit id on the command
45         line (which is not expected in
46         this case), 'git http-fetch' fetches the packfile directly at the given
47         URL and uses index-pack to generate corresponding .idx and .keep files.
48         The hash is used to determine the name of the temporary file and is
49         arbitrary. The output of index-pack is printed to stdout. Requires
50         --index-pack-args.
52 --index-pack-args=<args>::
53         For internal use only. The command to run on the contents of the
54         downloaded pack. Arguments are URL-encoded separated by spaces.
56 --recover::
57         Verify that everything reachable from target is fetched.  Used after
58         an earlier fetch is interrupted.
60 GIT
61 ---
62 Part of the linkgit:git[1] suite