diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 631759d372..521eaeaed2 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1142,6 +1142,53 @@
+ BBFILES_DYNAMIC
+
+ BBFILES_DYNAMIC[doc] = "Activates content when identified layers are present."
+
+
+
+
+ Activates content when identified layers are present.
+ You identify the layers by the collections that the layers
+ define.
+
+
+
+ Use the BBFILES_DYNAMIC variable to
+ avoid .bbappend files whose
+ corresponding .bb file is in a layer
+ that attempts to modify other layers through
+ .bbappend but does not want to
+ introduce a hard dependency on those other layers.
+
+
+
+ Use the following form for
+ BBFILES_DYNAMIC:
+
+ collection_name:filename_pattern
+
+ The following example identifies two collection names and
+ two filename patterns:
+
+ BBFILES_DYNAMIC += " \
+ clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \
+ core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \
+ "
+
+ This next example shows an error message that occurs
+ because invalid entries are found, which cause parsing to
+ abort:
+
+ ERROR: BBFILES_DYNAMIC entries must be of the form <collection name>:<filename pattern>, not:
+ /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend
+ /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend
+
+
+
+
+
BBINCLUDELOGS
BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure."