From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matthieu Moy Subject: [PATCH 04/10] Change "tracking branch" to "remote-tracking branch" Date: Sat, 23 Oct 2010 18:31:15 +0200 Message-ID: <1287851481-27952-5-git-send-email-Matthieu.Moy@imag.fr> References: <1287851481-27952-1-git-send-email-Matthieu.Moy@imag.fr> Cc: Thore Husfeldt , Jonathan Nieder , Matthieu Moy To: git@vger.kernel.org, gitster@pobox.com X-From: git-owner@vger.kernel.org Sat Oct 23 18:31:55 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1P9h0Y-0005UI-PQ for gcvg-git-2@lo.gmane.org; Sat, 23 Oct 2010 18:31:51 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757548Ab0JWQbp (ORCPT ); Sat, 23 Oct 2010 12:31:45 -0400 Received: from mx1.imag.fr ([129.88.30.5]:37866 "EHLO shiva.imag.fr" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757199Ab0JWQbo (ORCPT ); Sat, 23 Oct 2010 12:31:44 -0400 Received: from mail-veri.imag.fr (mail-veri.imag.fr [129.88.43.52]) by shiva.imag.fr (8.13.8/8.13.8) with ESMTP id o9NGGwOF005337 (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NO); Sat, 23 Oct 2010 18:16:58 +0200 Received: from bauges.imag.fr ([129.88.43.5]) by mail-veri.imag.fr with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.69) (envelope-from ) id 1P9h0C-0006cL-6k; Sat, 23 Oct 2010 18:31:28 +0200 Received: from moy by bauges.imag.fr with local (Exim 4.69) (envelope-from ) id 1P9h0C-0007Hm-4Q; Sat, 23 Oct 2010 18:31:28 +0200 X-Mailer: git-send-email 1.7.3.2.537.g7e355 In-Reply-To: <1287851481-27952-1-git-send-email-Matthieu.Moy@imag.fr> X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.0.1 (shiva.imag.fr [129.88.30.5]); Sat, 23 Oct 2010 18:16:58 +0200 (CEST) X-IMAG-MailScanner-Information: Please contact MI2S MIM for more information X-MailScanner-ID: o9NGGwOF005337 X-IMAG-MailScanner: Found to be clean X-IMAG-MailScanner-SpamCheck: X-IMAG-MailScanner-From: moy@imag.fr MailScanner-NULL-Check: 1288455420.43838@AQU0WLZ7UwJ3rpVKQr3a3A Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: One more step towards consistancy in our documentation... Signed-off-by: Matthieu Moy --- Documentation/config.txt | 4 ++-- Documentation/git-fetch.txt | 2 +- Documentation/git-pull.txt | 6 +++--- Documentation/git-remote.txt | 2 +- Documentation/git-tag.txt | 4 ++-- Documentation/glossary-content.txt | 8 ++++---- Documentation/user-manual.txt | 2 +- 7 files changed, 14 insertions(+), 14 deletions(-) diff --git a/Documentation/config.txt b/Documentation/config.txt index e625d6a..e4f16d8 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -680,7 +680,7 @@ color.branch:: color.branch.:: Use customized color for branch coloration. `` 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:: diff --git a/Documentation/git-fetch.txt b/Documentation/git-fetch.txt index d159e88..c76e313 100644 --- a/Documentation/git-fetch.txt +++ b/Documentation/git-fetch.txt @@ -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 stores the fetched result in tracking branches, +When 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 s, and if the repository has objects that are diff --git a/Documentation/git-pull.txt b/Documentation/git-pull.txt index 33e8438..54e7013 100644 --- a/Documentation/git-pull.txt +++ b/Documentation/git-pull.txt @@ -134,7 +134,7 @@ and if there is not any such variable, the value on `URL: ` line in `$GIT_DIR/remotes/` 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..fetch` are consulted, and if there aren't any, `$GIT_DIR/remotes/` @@ -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 diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt index 5e4989d..c258ea4 100644 --- a/Documentation/git-remote.txt +++ b/Documentation/git-remote.txt @@ -146,7 +146,7 @@ With `-n` option, the remote heads are not queried first with 'prune':: -Deletes all stale tracking branches under . +Deletes all stale remote-tracking branches under . These stale branches have already been removed from the remote repository referenced by , but are still locally available in "remotes/". diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 31c78a8..8b169e3 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -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. diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt index 1f029f8..a76de62 100644 --- a/Documentation/glossary-content.txt +++ b/Documentation/glossary-content.txt @@ -131,7 +131,7 @@ to point at the new commit. you have. In such these cases, you do not make a new <> <> but instead just update to his revision. This will happen frequently on a - <> of a remote + <> of a remote <>. [[def_fetch]]fetch:: @@ -260,7 +260,7 @@ This commit is referred to as a "merge commit", or sometimes just a The default upstream <>. 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 <> named + will be fetched into remote <> named origin/name-of-upstream-branch, which you can see using `git branch -r`. @@ -418,11 +418,11 @@ 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:: +[[def_remote_tracking_branch]]remote-tracking branch:: A regular git <> that is used to follow changes from another <>. A tracking branch should not contain direct modifications or have local commits - made to it. A tracking branch can usually be + made to it. A remote-tracking branch can usually be identified as the right-hand-side <> in a Pull: <>. diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index d5505e8..d7835ca 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -435,7 +435,7 @@ linux-nfs/master origin/master ------------------------------------------------- -If you run "git fetch " later, the tracking branches for the +If you run "git fetch " later, the remote-tracking branches for the named will be updated. If you examine the file .git/config, you will see that git has added -- 1.7.3.2.537.g7e355