git-shortlog.txt: improve documentation about .mailmap files

[git.git] / Documentation / urls-remotes.txt
diff --git a/Documentation/urls-remotes.txt b/Documentation/urls-remotes.txt

index 99753006e290040be941194b23c7ab26d9e9354e..41ec7774f481fd2d70492be4ab2b5e0bf887fc0b 100644 (file)
--- a/Documentation/urls-remotes.txt
+++ b/Documentation/urls-remotes.txt
@@ -49,8 +49,8 @@ following format:
  
  ------------
  
-`Push:` lines are used by `git-push` and
-`Pull:` lines are used by `git-pull` and `git-fetch`.
+`Push:` lines are used by 'git-push' and
+`Pull:` lines are used by 'git-pull' and 'git-fetch'.
  Multiple `Push:` and `Pull:` lines may
  be specified for additional branch mappings.
  
@@ -68,13 +68,22 @@ This file should have the following format:
  ------------
  
  `<url>` is required; `#<head>` is optional.
-When you do not provide a refspec on the command line,
-git will use the following refspec, where `<head>` defaults to `master`,
-and `<repository>` is the name of this file
-you provided in the command line.
+
+Depending on the operation, git will use one of the following
+refspecs, if you don't provide one on the command line.
+`<branch>` is the name of this file in `$GIT_DIR/branches` and
+`<head>` defaults to `master`.
+
+git fetch uses:
+
+------------
+       refs/heads/<head>:refs/heads/<branch>
+------------
+
+git push uses:
  
  ------------
-       refs/heads/<head>:<repository>
+       HEAD:refs/heads/<head>
  ------------