X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fpull-fetch-param.txt;h=f9811f24733bde97b76dc8e695bad82eace5586b;hb=2d56a136435bd40f9b6b75103eb4d75003154c9f;hp=cbee369947bf43c245994607ba5d3f77246cce6d;hpb=f0d2a057c1f8c1f425a81888bc9fd3fbca29bf99;p=git.git diff --git a/Documentation/pull-fetch-param.txt b/Documentation/pull-fetch-param.txt index cbee36994..f9811f247 100644 --- a/Documentation/pull-fetch-param.txt +++ b/Documentation/pull-fetch-param.txt @@ -5,15 +5,14 @@ of a remote (see the section <> below). :: - The canonical format of a parameter is - `+?:`; that is, an optional plus `+`, followed - by the source ref, followed by a colon `:`, followed by - the destination ref. + The format of a parameter is an optional plus + `{plus}`, followed by the source ref , followed + by a colon `:`, followed by the destination ref . + The remote ref that matches is fetched, and if is not empty string, the local ref that matches it is fast forwarded using . -Again, if the optional plus `+` is used, the local ref +If the optional plus `+` is used, the local ref is updated even if it does not result in a fast forward update. + @@ -32,7 +31,7 @@ must know this is the expected usage pattern for a branch. [NOTE] You never do your own development on branches that appear on the right hand side of a colon on `Pull:` lines; -they are to be updated by `git-fetch`. If you intend to do +they are to be updated by 'git-fetch'. If you intend to do development derived from a remote branch `B`, have a `Pull:` line to track it (i.e. `Pull: B:remote-B`), and have a separate branch `my-B` to do your development on top of it. The latter @@ -44,13 +43,13 @@ on the remote branch, merge it into your development branch with + [NOTE] There is a difference between listing multiple -directly on `git-pull` command line and having multiple +directly on 'git-pull' command line and having multiple `Pull:` lines for a and running -`git-pull` command without any explicit parameters. +'git-pull' command without any explicit parameters. listed explicitly on the command line are always merged into the current branch after fetching. In other words, if you list more than one remote refs, you would be making -an Octopus. While `git-pull` run without any explicit +an Octopus. While 'git-pull' run without any explicit parameter takes default s from `Pull:` lines, it merges only the first found into the current branch, after fetching all the remote refs. This is because making an