This commit adds examples which intend to cover the various ways of using 'git fetch'. Signed-off-by: Teemu Likonen <tlikonen@xxxxxx> --- Documentation/git-fetch.txt | 43 ++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 42 insertions(+), 1 deletions(-) diff --git a/Documentation/git-fetch.txt b/Documentation/git-fetch.txt index d982f96..d5b1c9f 100644 --- a/Documentation/git-fetch.txt +++ b/Documentation/git-fetch.txt @@ -37,9 +37,50 @@ include::pull-fetch-param.txt[] include::urls-remotes.txt[] +EXAMPLES +-------- + +git fetch git://host.xz/repo.git/ master:pu:: + Fetch branch `master` from given repository URL and store it locally + as `pu`. + +git fetch git://host.xz/repo.git/ master:remotes/pu:: + Fetch branch `master` from given repository URL and store it locally as + remote tracking branch `pu`. + +git fetch git://host.xz/repo.git/ master:: + Fetch branch `master` from given repository URL but do not create the + branch locally. Only the temporary pointer FETCH_HEAD is set to refer + to the fetched branch. + +git fetch /home/bob/tmp/repo.git:: + Fetch the currently active branch from given local repository and set + the temporary pointer FETCH_HEAD for the fetched branch. + +git fetch alice master:remotes/alice/pu:: + Fetch branch `master` from remote named `alice` and store it locally as + remote tracking branch `alice/pu`. See linkgit:git-remote[1] for more + information on configuring remotes. + +git fetch alice +master:remotes/alice/pu:: + The same as above but the remote tracking branch `alice/pu` is updated + even if it does not result in a fast forward update. + +git fetch alice +master:pu maint:tmp:: + Fetch branches `master` and `maint` from remote named `alice` and store + them locally as `pu` and `tmp` respectively. The branch `pu` is updated + even if it does not result in a fast forward update. + +git fetch origin:: + From the remote named `origin` fetch and store all branches as + configured in `remote.origin.fetch`. Usually this means fetching all + branches and storing them locally as remote tracking branches + `origin/*`. See linkgit:git-remote[1] for more information. + + SEE ALSO -------- -linkgit:git-pull[1] +linkgit:git-pull[1], linkgit:git-remote[1] Author -- 1.5.5.32.g5279 -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html