diff --git a/documentation/dev-manual/dev-manual-bsp-appendix.xml b/documentation/dev-manual/dev-manual-bsp-appendix.xml
index eecca8ebd4..ed3af67284 100644
--- a/documentation/dev-manual/dev-manual-bsp-appendix.xml
+++ b/documentation/dev-manual/dev-manual-bsp-appendix.xml
@@ -629,6 +629,22 @@
Insert the device
into a bootable USB socket on the target, and power it on.
The system should boot to the Sato graphical desktop.
+ Because
+ this new image is not in any way tailored to the system you're
+ booting it on, which is assumed to be some sort of atom-pc (netbook) system for this
+ example, it might not be completely functional though it should at least boot to a text
+ prompt.
+ Specifically, it might fail to boot into graphics without some tweaking.
+ If this ends up being the case, a possible next step would be to replace the
+ mymachine.conf
+ contents with the contents of atom-pc.conf and replace
+ xorg.conf with atom-pc xorg.conf
+ in meta-yocto and see if it fares any better.
+ In any case, following the previous steps will give you a buildable image that
+ will probably boot on most systems.
+ Getting things working like you want
+ them to for your hardware will normally require some amount of experimentation with
+ configuration settings.
@@ -647,24 +663,6 @@
also provides some suggestions for things to try if booting fails and produces
strange error messages.
-
-
- Because this new image is not in any way tailored to the system you're
- booting it on, which is assumed to be some sort of atom-pc (netbook) system for this
- example, it might not be completely functional though it should at least boot to a text
- prompt.
- Specifically, it might fail to boot into graphics without some tweaking.
- If this ends up being the case, a possible next step would be to replace the
- mymachine.conf
- contents with the contents of atom-pc.conf and replace
- xorg.conf with atom-pc xorg.conf
- in meta-yocto and see if it fares any better.
- In any case, following the previous steps will give you a buildable image that
- will probably boot on most systems.
- Getting things working like you want
- them to for your hardware will normally require some amount of experimentation with
- configuration settings.
-