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:
Matthieu Moy 2010-11-02 16:31:23 +01:00 committed by Junio C Hamano
parent bc6dafc144
commit 8b3f3f84b2
10 changed files with 24 additions and 24 deletions

View File

@ -680,7 +680,7 @@ color.branch::
color.branch.<slot>:: color.branch.<slot>::
Use customized color for branch coloration. `<slot>` is one of Use customized color for branch coloration. `<slot>` is one of
`current` (the current branch), `local` (a local branch), `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). refs).
+ +
The value for these configuration variables is a list of colors (at most The value for these configuration variables is a list of colors (at most
@ -1102,7 +1102,7 @@ gui.newbranchtemplate::
linkgit:git-gui[1]. linkgit:git-gui[1].
gui.pruneduringfetch:: 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". performing a fetch. The default value is "false".
gui.trustmtime:: gui.trustmtime::

View File

@ -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 in `.git/FETCH_HEAD`. This information is left for a later merge
operation done by 'git 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 the tags that point at these branches are automatically
followed. This is done by first fetching from the remote using followed. This is done by first fetching from the remote using
the given <refspec>s, and if the repository has objects that are the given <refspec>s, and if the repository has objects that are

View File

@ -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 `$GIT_DIR/remotes/<origin>` file is used.
In order to determine what remote branches to fetch (and 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 run without any refspec parameters on the command line, values
of the configuration variable `remote.<origin>.fetch` are of the configuration variable `remote.<origin>.fetch` are
consulted, and if there aren't any, `$GIT_DIR/remotes/<origin>` 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 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 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. `refs/remotes/origin/` hierarchy under the same name.
The rule to determine which remote branch to merge after The rule to determine which remote branch to merge after

View File

@ -146,7 +146,7 @@ With `-n` option, the remote heads are not queried first with
'prune':: '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 These stale branches have already been removed from the remote repository
referenced by <name>, but are still locally available in referenced by <name>, but are still locally available in
"remotes/<name>". "remotes/<name>".

View File

@ -177,7 +177,7 @@ On Automatic following
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
If you are following somebody else's tree, you are most likely 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, or `refs/remotes/origin/master` in the separate-remote
layout). You usually want the tags from the other end. 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 It may well be that among networking people, they may want to
exchange the tags internal to their group, but in that workflow exchange the tags internal to their group, but in that workflow
they are most likely tracking with each other's progress by 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. follow such tags is a good thing.

View File

@ -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>> you have. In such these cases, you do not make a new <<def_merge,merge>>
<<def_commit,commit>> but instead just update to his <<def_commit,commit>> but instead just update to his
revision. This will happen frequently on a 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_repository,repository>>.
[[def_fetch]]fetch:: [[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 The default upstream <<def_repository,repository>>. Most projects have
at least one upstream project which they track. By default at least one upstream project which they track. By default
'origin' is used for that purpose. New upstream updates '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 origin/name-of-upstream-branch, which you can see using
`git branch -r`. `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 master branch head as to-upstream branch at $URL". See also
linkgit:git-push[1]. 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:: [[def_repository]]repository::
A collection of <<def_ref,refs>> together with an A collection of <<def_ref,refs>> together with an
<<def_object_database,object database>> containing all objects <<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 that each contain very well defined concepts or small incremental yet
related changes. 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:: [[def_tree]]tree::
Either a <<def_working_tree,working tree>>, or a <<def_tree_object,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 object>> together with the dependent <<def_blob_object,blob>> and tree objects

View File

@ -435,7 +435,7 @@ linux-nfs/master
origin/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. named <remote> will be updated.
If you examine the file .git/config, you will see that git has added If you examine the file .git/config, you will see that git has added

View File

@ -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. * between A and B, A...B names that merge base.
* *
* With no paths, if <something> is _not_ a commit, no -t nor -b * 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 * <something> in one and only one remote, then this is a short-hand
* to fork local <something> from that remote-tracking branch. * to fork local <something> from that remote-tracking branch.
* *

View File

@ -52,7 +52,7 @@ static struct option builtin_fetch_options[] = {
OPT_SET_INT('n', NULL, &tags, OPT_SET_INT('n', NULL, &tags,
"do not fetch all tags (--no-tags)", TAGS_UNSET), "do not fetch all tags (--no-tags)", TAGS_UNSET),
OPT_BOOLEAN('p', "prune", &prune, 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, OPT_BOOLEAN(0, "dry-run", &dry_run,
"dry run"), "dry run"),
OPT_BOOLEAN('k', "keep", &keep, "keep downloaded pack"), OPT_BOOLEAN('k', "keep", &keep, "keep downloaded pack"),
@ -98,7 +98,7 @@ static void add_merge_config(struct ref **head,
continue; 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" * it anyway to allow this branch's "branch.$name.merge"
* to be honored by 'git pull', but we do not have to * to be honored by 'git pull', but we do not have to
* fail if branch.$name.merge is misconfigured to point * fail if branch.$name.merge is misconfigured to point

View File

@ -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 * wildcard refspec in "struct refspec" must have a trailing slash. We
* temporarily drop the trailing '/' while calling check_ref_format(), * temporarily drop the trailing '/' while calling check_ref_format(),
* and put it back. The caller knows that a CHECK_REF_FORMAT_ONELEVEL * and put it back. The caller knows that a CHECK_REF_FORMAT_ONELEVEL