Change "tracking branch" to "remote-tracking branch"
One more step towards consistancy. We change the documentation and the C code in a single patch, since the only instances in the C code are in comment and usage strings. Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
bc6dafc144
commit
8b3f3f84b2
@ -680,7 +680,7 @@ color.branch::
|
||||
color.branch.<slot>::
|
||||
Use customized color for branch coloration. `<slot>` is one of
|
||||
`current` (the current branch), `local` (a local branch),
|
||||
`remote` (a tracking branch in refs/remotes/), `plain` (other
|
||||
`remote` (a remote-tracking branch in refs/remotes/), `plain` (other
|
||||
refs).
|
||||
+
|
||||
The value for these configuration variables is a list of colors (at most
|
||||
@ -1102,7 +1102,7 @@ gui.newbranchtemplate::
|
||||
linkgit:git-gui[1].
|
||||
|
||||
gui.pruneduringfetch::
|
||||
"true" if linkgit:git-gui[1] should prune tracking branches when
|
||||
"true" if linkgit:git-gui[1] should prune remote-tracking branches when
|
||||
performing a fetch. The default value is "false".
|
||||
|
||||
gui.trustmtime::
|
||||
|
@ -26,7 +26,7 @@ The ref names and their object names of fetched refs are stored
|
||||
in `.git/FETCH_HEAD`. This information is left for a later merge
|
||||
operation done by 'git merge'.
|
||||
|
||||
When <refspec> stores the fetched result in tracking branches,
|
||||
When <refspec> stores the fetched result in remote-tracking branches,
|
||||
the tags that point at these branches are automatically
|
||||
followed. This is done by first fetching from the remote using
|
||||
the given <refspec>s, and if the repository has objects that are
|
||||
|
@ -134,7 +134,7 @@ and if there is not any such variable, the value on `URL: ` line
|
||||
in `$GIT_DIR/remotes/<origin>` file is used.
|
||||
|
||||
In order to determine what remote branches to fetch (and
|
||||
optionally store in the tracking branches) when the command is
|
||||
optionally store in the remote-tracking branches) when the command is
|
||||
run without any refspec parameters on the command line, values
|
||||
of the configuration variable `remote.<origin>.fetch` are
|
||||
consulted, and if there aren't any, `$GIT_DIR/remotes/<origin>`
|
||||
@ -147,9 +147,9 @@ refs/heads/*:refs/remotes/origin/*
|
||||
------------
|
||||
|
||||
A globbing refspec must have a non-empty RHS (i.e. must store
|
||||
what were fetched in tracking branches), and its LHS and RHS
|
||||
what were fetched in remote-tracking branches), and its LHS and RHS
|
||||
must end with `/*`. The above specifies that all remote
|
||||
branches are tracked using tracking branches in
|
||||
branches are tracked using remote-tracking branches in
|
||||
`refs/remotes/origin/` hierarchy under the same name.
|
||||
|
||||
The rule to determine which remote branch to merge after
|
||||
|
@ -146,7 +146,7 @@ With `-n` option, the remote heads are not queried first with
|
||||
|
||||
'prune'::
|
||||
|
||||
Deletes all stale tracking branches under <name>.
|
||||
Deletes all stale remote-tracking branches under <name>.
|
||||
These stale branches have already been removed from the remote repository
|
||||
referenced by <name>, but are still locally available in
|
||||
"remotes/<name>".
|
||||
|
@ -177,7 +177,7 @@ On Automatic following
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
If you are following somebody else's tree, you are most likely
|
||||
using tracking branches (`refs/heads/origin` in traditional
|
||||
using remote-tracking branches (`refs/heads/origin` in traditional
|
||||
layout, or `refs/remotes/origin/master` in the separate-remote
|
||||
layout). You usually want the tags from the other end.
|
||||
|
||||
@ -232,7 +232,7 @@ this case.
|
||||
It may well be that among networking people, they may want to
|
||||
exchange the tags internal to their group, but in that workflow
|
||||
they are most likely tracking with each other's progress by
|
||||
having tracking branches. Again, the heuristic to automatically
|
||||
having remote-tracking branches. Again, the heuristic to automatically
|
||||
follow such tags is a good thing.
|
||||
|
||||
|
||||
|
@ -131,7 +131,7 @@ to point at the new commit.
|
||||
you have. In such these cases, you do not make a new <<def_merge,merge>>
|
||||
<<def_commit,commit>> but instead just update to his
|
||||
revision. This will happen frequently on a
|
||||
<<def_tracking_branch,tracking branch>> of a remote
|
||||
<<def_remote_tracking_branch,remote-tracking branch>> of a remote
|
||||
<<def_repository,repository>>.
|
||||
|
||||
[[def_fetch]]fetch::
|
||||
@ -260,7 +260,7 @@ This commit is referred to as a "merge commit", or sometimes just a
|
||||
The default upstream <<def_repository,repository>>. Most projects have
|
||||
at least one upstream project which they track. By default
|
||||
'origin' is used for that purpose. New upstream updates
|
||||
will be fetched into remote <<def_tracking_branch,tracking branches>> named
|
||||
will be fetched into remote <<def_remote_tracking_branch,remote-tracking branches>> named
|
||||
origin/name-of-upstream-branch, which you can see using
|
||||
`git branch -r`.
|
||||
|
||||
@ -349,6 +349,14 @@ This commit is referred to as a "merge commit", or sometimes just a
|
||||
master branch head as to-upstream branch at $URL". See also
|
||||
linkgit:git-push[1].
|
||||
|
||||
[[def_remote_tracking_branch]]remote-tracking branch::
|
||||
A regular git <<def_branch,branch>> that is used to follow changes from
|
||||
another <<def_repository,repository>>. A remote-tracking
|
||||
branch should not contain direct modifications or have local commits
|
||||
made to it. A remote-tracking branch can usually be
|
||||
identified as the right-hand-side <<def_ref,ref>> in a Pull:
|
||||
<<def_refspec,refspec>>.
|
||||
|
||||
[[def_repository]]repository::
|
||||
A collection of <<def_ref,refs>> together with an
|
||||
<<def_object_database,object database>> containing all objects
|
||||
@ -418,14 +426,6 @@ This commit is referred to as a "merge commit", or sometimes just a
|
||||
that each contain very well defined concepts or small incremental yet
|
||||
related changes.
|
||||
|
||||
[[def_tracking_branch]]tracking branch::
|
||||
A regular git <<def_branch,branch>> that is used to follow changes from
|
||||
another <<def_repository,repository>>. A tracking
|
||||
branch should not contain direct modifications or have local commits
|
||||
made to it. A tracking branch can usually be
|
||||
identified as the right-hand-side <<def_ref,ref>> in a Pull:
|
||||
<<def_refspec,refspec>>.
|
||||
|
||||
[[def_tree]]tree::
|
||||
Either a <<def_working_tree,working tree>>, or a <<def_tree_object,tree
|
||||
object>> together with the dependent <<def_blob_object,blob>> and tree objects
|
||||
|
@ -435,7 +435,7 @@ linux-nfs/master
|
||||
origin/master
|
||||
-------------------------------------------------
|
||||
|
||||
If you run "git fetch <remote>" later, the tracking branches for the
|
||||
If you run "git fetch <remote>" later, the remote-tracking branches for the
|
||||
named <remote> will be updated.
|
||||
|
||||
If you examine the file .git/config, you will see that git has added
|
||||
|
@ -784,7 +784,7 @@ int cmd_checkout(int argc, const char **argv, const char *prefix)
|
||||
* between A and B, A...B names that merge base.
|
||||
*
|
||||
* With no paths, if <something> is _not_ a commit, no -t nor -b
|
||||
* was given, and there is a tracking branch whose name is
|
||||
* was given, and there is a remote-tracking branch whose name is
|
||||
* <something> in one and only one remote, then this is a short-hand
|
||||
* to fork local <something> from that remote-tracking branch.
|
||||
*
|
||||
|
@ -52,7 +52,7 @@ static struct option builtin_fetch_options[] = {
|
||||
OPT_SET_INT('n', NULL, &tags,
|
||||
"do not fetch all tags (--no-tags)", TAGS_UNSET),
|
||||
OPT_BOOLEAN('p', "prune", &prune,
|
||||
"prune tracking branches no longer on remote"),
|
||||
"prune remote-tracking branches no longer on remote"),
|
||||
OPT_BOOLEAN(0, "dry-run", &dry_run,
|
||||
"dry run"),
|
||||
OPT_BOOLEAN('k', "keep", &keep, "keep downloaded pack"),
|
||||
@ -98,7 +98,7 @@ static void add_merge_config(struct ref **head,
|
||||
continue;
|
||||
|
||||
/*
|
||||
* Not fetched to a tracking branch? We need to fetch
|
||||
* Not fetched to a remote-tracking branch? We need to fetch
|
||||
* it anyway to allow this branch's "branch.$name.merge"
|
||||
* to be honored by 'git pull', but we do not have to
|
||||
* fail if branch.$name.merge is misconfigured to point
|
||||
|
2
remote.c
2
remote.c
@ -493,7 +493,7 @@ static void read_config(void)
|
||||
}
|
||||
|
||||
/*
|
||||
* We need to make sure the tracking branches are well formed, but a
|
||||
* We need to make sure the remote-tracking branches are well formed, but a
|
||||
* wildcard refspec in "struct refspec" must have a trailing slash. We
|
||||
* temporarily drop the trailing '/' while calling check_ref_format(),
|
||||
* and put it back. The caller knows that a CHECK_REF_FORMAT_ONELEVEL
|
||||
|
Loading…
Reference in New Issue
Block a user