Add branch.*.merge warning and documentation update
[git] / Documentation / git-fetch-pack.txt
1 git-fetch-pack(1)
2 =================
3
4 NAME
5 ----
6 git-fetch-pack - Receive missing objects from another repository
7
8
9 SYNOPSIS
10 --------
11 'git-fetch-pack' [-q] [-k] [--exec=<git-upload-pack>] [<host>:]<directory> [<refs>...]
12
13 DESCRIPTION
14 -----------
15 Invokes 'git-upload-pack' on a potentially remote repository,
16 and asks it to send objects missing from this repository, to
17 update the named heads.  The list of commits available locally
18 is found out by scanning local $GIT_DIR/refs/ and sent to
19 'git-upload-pack' running on the other end.
20
21 This command degenerates to download everything to complete the
22 asked refs from the remote side when the local side does not
23 have a common ancestor commit.
24
25
26 OPTIONS
27 -------
28 -q::
29         Pass '-q' flag to 'git-unpack-objects'; this makes the
30         cloning process less verbose.
31
32 -k::
33         Do not invoke 'git-unpack-objects' on received data, but
34         create a single packfile out of it instead, and store it
35         in the object database. If provided twice then the pack is
36         locked against repacking.
37
38 --exec=<git-upload-pack>::
39         Use this to specify the path to 'git-upload-pack' on the
40         remote side, if is not found on your $PATH.
41         Installations of sshd ignores the user's environment
42         setup scripts for login shells (e.g. .bash_profile) and
43         your privately installed git may not be found on the system
44         default $PATH.  Another workaround suggested is to set
45         up your $PATH in ".bashrc", but this flag is for people
46         who do not want to pay the overhead for non-interactive
47         shells by having a lean .bashrc file (they set most of
48         the things up in .bash_profile).
49
50 <host>::
51         A remote host that houses the repository.  When this
52         part is specified, 'git-upload-pack' is invoked via
53         ssh.
54
55 <directory>::
56         The repository to sync from.
57
58 <refs>...::
59         The remote heads to update from. This is relative to
60         $GIT_DIR (e.g. "HEAD", "refs/heads/master").  When
61         unspecified, update from all heads the remote side has.
62
63
64 Author
65 ------
66 Written by Linus Torvalds <torvalds@osdl.org>
67
68 Documentation
69 --------------
70 Documentation by Junio C Hamano.
71
72 GIT
73 ---
74 Part of the gitlink:git[7] suite