diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml
index 8f705537c4..2db58ddaef 100644
--- a/documentation/poky-ref-manual/ref-structure.xml
+++ b/documentation/poky-ref-manual/ref-structure.xml
@@ -329,14 +329,27 @@
This directory receives complete filesystem images.
If you want to flash the resulting image from a build onto a device, look here for the image.
-
+
- Note, you should not remove any files from this directory by hand in an attempt
- to rebuild an image.
- If you want to clean out the cache, re-run the build using the following
- BitBake command:
+ Be careful when deleting files in this directory.
+ You can safely delete old images from this directory (e.g.
+ core-image-*, hob-image-*,
+ etc.).
+ However, the kernel (*zImage*, *uImage*, etc.),
+ bootloader and other supplementary files might be deployed here prior to building an
+ image.
+ Because these files, however, are not directly produced from the image, if you
+ delete them they will not be automatically re-created when you build the image again.
+
+
+
+ If you do accidentally delete files here, you will need to force them to be
+ re-created.
+ In order to do that, you will need to know the target that produced them.
+ For example, these commands rebuild and re-create the kernel files:
- $ bitbake -c cleanall <target>
+ $ bitbake -c clean virtual/kernel
+ $ bitbake virtual/kernel