1 files changed, 15 insertions, 0 deletions

diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index 9f17c213cc..c3e4f6e987 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -23,6 +23,21 @@
         See the "<link linkend='setting-up-the-cross-development-environment'>Setting Up the 
         Cross-Development Environment</link>"
         section for more information.
+    </para>
+
+    <note>
+        <para>Avoid mixing installation methods when installing the ADT for different architectures.
+        For example, avoid using the ADT Installer to install some toolchains and then hand-installing
+        cross-development toolchains from downloaded tarballs to install toolchains
+        for different architectures. 
+        Mixing installation methods can result in situations where the ADT Installer becomes
+        unreliable and might not install the toolchain.</para>
+        <para>If you must mix installation methods, you might avoid problems by deleting 
+        <filename>/var/lib/opkg</filename>, thus purging the <filename>opkg</filename> package 
+        metadata</para>
+    </note>
+    
+    <para>
         <itemizedlist>
             <listitem><para><emphasis>Use the ADT Installer Script:</emphasis>
                 This method is the recommended way to install the ADT because it