diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index cc2a64d807..81c80f3222 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5737,6 +5737,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     Denotes the Application Binary Interface (ABI) currently
                     in use for Python.
                     By default, the ABI is "m".
+                    You do not have to set this variable as the OpenEmbedded
+                    build system sets it for you.
                 </para>
 
                 <para>
@@ -5763,6 +5765,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     For Python 2.x, <filename>PYTHON_PN</filename> would
                     be "python2".  For Python 3.x, the variable would be
                     "python3".
+                    You do not have to set this variable as the
+                    OpenEmbedded build system automatically sets it for you.
                 </para>
 
                 <para>