diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 1774ba24c0..5490bd3130 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -13657,7 +13657,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
MIRRORS
and PREMIRRORS
and points to the cache locations to check for the shared
- objects.
+ state (sstate) objects.
@@ -13669,6 +13669,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
other machines.
+
+ If you want to use native sstate artifacts that are
+ provided by a server, you need to configure
+ SSTATE_MIRROR regular expressions
+ so that the local search paths get mapped to paths
+ provided by the server.
+ The server paths must take into account the GCC versions.
+ For example, the following maps the local search path
+ universal-4.9 to the server-provided
+ path server_url_sstate_path:
+
+ SSTATE_MIRRORS ?= file://universal-4.9/(.*) http://server_url_sstate_path/universal-4.8/\1 \n
+
+
+
If a mirror uses the same structure as
SSTATE_DIR,