diff --git a/documentation/poky-ref-manual/ref-features.xml b/documentation/poky-ref-manual/ref-features.xml
index fd0bd29ff7..2178d2a322 100644
--- a/documentation/poky-ref-manual/ref-features.xml
+++ b/documentation/poky-ref-manual/ref-features.xml
@@ -30,6 +30,15 @@
The items below are features you can use with
DISTRO_FEATURES.
+ Features do not have a one-to-one correspondence to packages, and they can
+ go beyond simply controlling the installation of a package or packages.
+ Sometimes a feature can influence how certain recipes are built.
+ For example, a feature might determine whether a particular configure option
+ is specified within do_configure for a particular
+ recipe.
+
+
+
This list only represents features as shipped with the Yocto Project metadata:
alsa: ALSA support will be included (OSS compatibility
@@ -77,7 +86,16 @@
The items below are features you can use with
MACHINE_FEATURES.
- This list only represents features as shipped with the Yocto Project metadata:
+ Features do not have a one-to-one correspondence to packages, and they can
+ go beyond simply controlling the installation of a package or packages.
+ Sometimes a feature can influence how certain recipes are built.
+ For example, a feature might determine whether a particular configure option
+ is specified within do_configure for a particular
+ recipe.
+
+
+
+ This feature list only represents features as shipped with the Yocto Project metadata:
acpi: Hardware has ACPI (x86/x86_64 only)