diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index e1faea0fa9..69f0f8d3a2 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -314,6 +314,10 @@
MACHINEOVERRIDES
or DISTROOVERRIDES
variables, as appropriate.
+ For more changes regarding the
+ SRC_URI variable, see the
+ "Variables"
+ section.
@@ -367,16 +371,21 @@
SRC_URI:
The ${PN},
${PF},
- and ${P}
- directories have been dropped from the default value of the
+ ${P},
+ and FILE_DIRNAME directories have been
+ dropped from the default value of the
FILESPATH
variable, which is used as the search path for finding files
referred to in
SRC_URI.
If you have a recipe that relied upon these directories,
which would be unusual, then you will need to add the
- appropriate paths to
- FILESEXTRAPATHS.
+ appropriate paths within the recipe or, alternatively,
+ rearrange the files.
+ The most common locations are still covered by
+ ${BP}, ${BPN},
+ and "files", which all remain in the default value of
+ FILESPATH.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index b5f04cbf6c..e4bcb56aed 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3395,10 +3395,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
${BPN}-${PV}.
The base recipe name and version but without any special
package name suffix.
- Files - Files beneath the directory in which the recipe
- resides.
- Directory - The directory itself in which the recipe
- resides.
+ files - Files within a
+ directory, which is named files
+ and is also alongside the recipe.
+ bzr:// - Fetches files from a
Bazaar revision control repository.