зеркало из https://github.com/microsoft/git.git
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:
Родитель
bc6dafc144
Коммит
8b3f3f84b2
|
@ -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::
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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>".
|
||||||
|
|
|
@ -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.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
*
|
*
|
||||||
|
|
|
@ -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
|
||||||
|
|
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
|
* 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
|
||||||
|
|
Загрузка…
Ссылка в новой задаче