diff --git a/bitbake/doc/user-manual/user-manual-ref-variables.xml b/bitbake/doc/user-manual/user-manual-ref-variables.xml
index b87614ae8e..1ee0eebd1b 100644
--- a/bitbake/doc/user-manual/user-manual-ref-variables.xml
+++ b/bitbake/doc/user-manual/user-manual-ref-variables.xml
@@ -1356,6 +1356,29 @@
+ PREFERRED_PROVIDERS
+
+
+ Determines which recipe should be given preference for
+ cases where multiple recipes provide the same item.
+ Functionally,
+ PREFERRED_PROVIDERS is identical to
+ PREFERRED_PROVIDER.
+ However, the PREFERRED_PROVIDERS
+ variable lets you define preferences for multiple
+ situations using the following form:
+
+ PREFERRED_PROVIDERS = "xxx:yyy aaa:bbb ..."
+
+ This form is a convenient replacement for the following:
+
+ PREFERRED_PROVIDER_xxx = "yyy"
+ PREFERRED_PROVIDER_aaa = "bbb"
+
+
+
+
+
PREFERRED_VERSION