Merge pull request rpm-software-management#73 from dmnks/bz1509831

docs: baseurl: clarify multiple URLs

Author: dmnks

docs/yum.conf.5

@@ -1032,8 +1032,10 @@ A human readable string describing the repository.
 .IP
 \fBbaseurl\fR
 Must be a URL to the directory where the yum repository's `repodata' directory
-lives. Can be an http://, ftp:// or file:// URL. You can specify multiple URLs
-in one baseurl statement. The best way to do this is like this:
+lives. Can be an http://, ftp:// or file:// URL.
+
+You can specify multiple URLs in one baseurl statement. The best way to do this
+is like this:
 .br
 [repositoryid]
 .br
@@ -1046,6 +1048,12 @@ baseurl=url://server1/path/to/repository/
         url://server3/path/to/repository/
 .br
 
+The URLs listed are considered different locations (mirrors) of the same
+repository.
+That means, if one URL fails, another one is tried, and so on.
+The order in which the URLs are tried is determined by the \fBfailovermethod\fR
+option.
+
 If you list more than one baseurl= statement in a repository you will find
 yum will ignore the earlier ones and probably act bizarrely. Don't do this,
 you've been warned.