1 files changed, 13 insertions, 4 deletions

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 @@
                     <link linkend='var-MACHINEOVERRIDES'><filename>MACHINEOVERRIDES</filename></link> 
                     or <link linkend='var-DISTROOVERRIDES'><filename>DISTROOVERRIDES</filename></link>
                     variables, as appropriate.
+                    For more changes regarding the 
+                    <filename>SRC_URI</filename> variable, see the
+                    "<link linkend='migration-1.4-variables'>Variables</link>"
+                    section.
                     </para></listitem>
             </itemizedlist>
         </para>
@@ -367,16 +371,21 @@
                 <listitem><para><emphasis><filename>SRC_URI</filename>:</emphasis>
                     The <filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>, 
                     <filename>${</filename><link linkend='var-PF'><filename>PF</filename></link><filename>}</filename>, 
-                    and <filename>${</filename><link linkend='var-P'><filename>P</filename></link><filename>}</filename>
-                    directories have been dropped from the default value of the 
+                    <filename>${</filename><link linkend='var-P'><filename>P</filename></link><filename>}</filename>, 
+                    and <filename>FILE_DIRNAME</filename> directories have been 
+                    dropped from the default value of the 
                     <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>
                     variable, which is used as the search path for finding files 
                     referred to in 
                     <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>. 
                     If you have a recipe that relied upon these directories, 
                     which would be unusual, then you will need to add the 
-                    appropriate paths to 
-                    <link linkend='var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></link>.
+                    appropriate paths within the recipe or, alternatively,
+                    rearrange the files. 
+                    The most common locations are still covered by 
+                    <filename>${BP}</filename>, <filename>${BPN}</filename>,
+                    and "files", which all remain in the default value of
+                    <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>. 
                     </para></listitem>
             </itemizedlist>           
         </para>