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

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