glossary: Update and rephrase the definition of a remote-tracking branch
[gitweb.git] / Documentation / glossary-content.txt
index 2478a3963cc774f1bf73c56660a2d4c096ad4d94..7a79f26231c2ffa0cd0bfb7ffb9274803e32d8be 100644 (file)
@@ -423,12 +423,13 @@ should not be combined with other pathspec.
        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>>.
+       A <<def_ref,ref>> that is used to follow changes from another
+       <<def_repository,repository>>. It typically looks like
+       'refs/remotes/foo/bar' (indicating that it tracks a branch named
+       'bar' in a remote named 'foo'), and matches the right-hand-side of
+       a configured fetch <<def_refspec,refspec>>. A remote-tracking
+       branch should not contain direct modifications or have local
+       commits made to it.
 
 [[def_repository]]repository::
        A collection of <<def_ref,refs>> together with an