Blame SOURCES/BZ-1509831-baseurl-clarify-multiple-urls.patch

92fe97
commit 98c6fbf4a338239ce7e54bdd48e25e8b294359db
92fe97
Author: Michal Domonkos <mdomonko@redhat.com>
92fe97
Date:   Wed Jun 13 17:19:27 2018 +0200
92fe97
92fe97
    docs: baseurl: clarify multiple URLs
92fe97
92fe97
diff --git a/docs/yum.conf.5 b/docs/yum.conf.5
92fe97
index 5d9ab61a..0f77d913 100644
92fe97
--- a/docs/yum.conf.5
92fe97
+++ b/docs/yum.conf.5
92fe97
@@ -1032,8 +1032,10 @@ A human readable string describing the repository.
92fe97
 .IP
92fe97
 \fBbaseurl\fR
92fe97
 Must be a URL to the directory where the yum repository's `repodata' directory
92fe97
-lives. Can be an http://, ftp:// or file:// URL. You can specify multiple URLs
92fe97
-in one baseurl statement. The best way to do this is like this:
92fe97
+lives. Can be an http://, ftp:// or file:// URL.
92fe97
+
92fe97
+You can specify multiple URLs in one baseurl statement. The best way to do this
92fe97
+is like this:
92fe97
 .br
92fe97
 [repositoryid]
92fe97
 .br
92fe97
@@ -1046,6 +1048,12 @@ baseurl=url://server1/path/to/repository/
92fe97
         url://server3/path/to/repository/
92fe97
 .br
92fe97
 
92fe97
+The URLs listed are considered different locations (mirrors) of the same
92fe97
+repository.
92fe97
+That means, if one URL fails, another one is tried, and so on.
92fe97
+The order in which the URLs are tried is determined by the \fBfailovermethod\fR
92fe97
+option.
92fe97
+
92fe97
 If you list more than one baseurl= statement in a repository you will find
92fe97
 yum will ignore the earlier ones and probably act bizarrely. Don't do this,
92fe97
 you've been warned.