Documentation: note behavior for multiple remote.url entries

bk2204 · bk2204 · commit e8f2bc0c068f · 2015-05-10T18:48:27.000Z
Git supports multiple remote.*.url and remote.*.pushurl entries, but
this was not documented.  Document the current behavior for pushing and
pulling so that others can make use of this feature.

Signed-off-by: brian m. carlson &lt;sandals@crustytoothpaste.net&gt;
diff --git a/Documentation/urls-remotes.txt b/Documentation/urls-remotes.txt
@@ -33,7 +33,9 @@ config file would appear like this:
 ------------
 
 The `<pushurl>` is used for pushes only. It is optional and defaults
-to `<url>`.
+to `<url>`.  If multiple `url` or `pushurl` entries are specified,
+linkgit:git-push[1] will push to all of them, but linkgit:git-fetch[1] and
+linkgit:git-pull[1] will ignore all but the first.
 
 Named file in `$GIT_DIR/remotes`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
