diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 2ac4a0acda..39e173363a 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -316,6 +316,7 @@
                     Provides additional <filename>shlibs</filename> provider
                     mapping information, which adds to or overwrites the
                     information provided automatically by the system.
+                    Separate multiple entries using spaces.
                 </para>
 
                 <para>
@@ -327,9 +328,16 @@
                     <literallayout class='monospaced'>
      <replaceable>shlibname:packagename</replaceable>[_<replaceable>version</replaceable>]
                     </literallayout>
-                    <note>
-                        Separate multiple entries using spaces.
-                    </note>
+                </para>
+
+                <para>
+                    Here is an example that adds an
+                    <filename>shlib</filename> provider named
+                    <filename>libEGL.so.1</filename> to the
+                    <filename>libegl-implementation</filename> package:
+                    <literallayout class='monospaced'>
+     ASSUME_SHLIBS = "libEGL.so.1:libegl-implementation"
+                    </literallayout>
                 </para>
             </glossdef>
         </glossentry>