diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index dabf05989e..959b8c3418 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2487,6 +2487,51 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
+ PREMIRRORS
+
+
+ Specifies additional paths from which the OpenEmbedded
+ build system gets source code.
+ When the build system searches for source code, it first
+ tries the local download directory.
+ If that location fails, the build system tries locations
+ defined by PREMIRRORS, the upstream
+ source, and then locations specified by
+ MIRRORS
+ in that order.
+
+
+
+ Assuming your distribution
+ (DISTRO)
+ is "poky", the default value for
+ PREMIRRORS is defined in the
+ conf/distro/poky.conf file in the
+ meta-yocto Git repository.
+
+
+
+ Typically, you could add a specific server for the
+ build system to attempt before any others by adding
+ something like the following to the
+ local.conf configuration file in the
+ Build Directory:
+
+ PREMIRRORS_prepend = "\
+ git://.*/.* http://www.yoctoproject.org/sources/ \n \
+ ftp://.*/.* http://www.yoctoproject.org/sources/ \n \
+ http://.*/.* http://www.yoctoproject.org/sources/ \n \
+ https://.*/.* http://www.yoctoproject.org/sources/ \n"
+
+ These changes cause the build system to intercept
+ Git, FTP, HTTP, and HTTPS requests and direct them to
+ the http:// sources mirror.
+ You can use file:// URLs to point
+ to local directories or network shares as well.
+
+
+
+
PRINCCauses the PR variable of