1 files changed, 15 insertions, 2 deletions

diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 3b86d9a4dc..a8701a52d7 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -2333,14 +2333,27 @@
         </para>
 
         <para>
+            One important example is a fix for when the Linux kernel freezes at
+            boot time on ARM when built with GCC 5.
+            If you are using your own kernel recipe or source tree and
+            building for ARM, you will likely need to apply this
+            <ulink url='https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit?id=a077224fd35b2f7fbc93f14cf67074fc792fbac2'>patch</ulink>.
+            The standard <filename>linux-yocto</filename> kernel source tree
+            already has a workaround for the same issue.
+        </para>
+
+        <para>
+            For further details, please see
+            <ulink url='https://gcc.gnu.org/gcc-5/changes.html'></ulink>.
+        </para>
+
+        <para>
             Alternatively, you can switch back to GCC 4.9 or 4.8 by
             setting <filename>GCCVERSION</filename> in your configuration,
             as follows:
             <literallayout class='monospaced'>
      GCCVERSION = "4.9%"
             </literallayout>
-            For further details, please see
-            <ulink url='https://gcc.gnu.org/gcc-5/changes.html'></ulink>.
         </para>
     </section>