Merge branch 'master' into tk71

[mv-sheeva.git] / Documentation / kbuild / makefiles.txt

diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index c787ae512120fb625031c28fc3a3f3664bd4bfc0..86e3cd0d26a087f80024636ab98f37d6879a6339 100644 (file)
--- a/Documentation/kbuild/makefiles.txt
+++ b/Documentation/kbuild/makefiles.txt
@@ -776,6 +776,13 @@ This will delete the directory debian, including all subdirectories.
 Kbuild will assume the directories to be in the same relative path as the
 Makefile if no absolute path is specified (path does not start with '/').
 
+To exclude certain files from make clean, use the $(no-clean-files) variable.
+This is only a special case used in the top level Kbuild file:
+
+       Example:
+               #Kbuild
+               no-clean-files := $(bounds-file) $(offsets-file)
+
 Usually kbuild descends down in subdirectories due to "obj-* := dir/",
 but in the architecture makefiles where the kbuild infrastructure
 is not sufficient this sometimes needs to be explicit.
@@ -1129,6 +1136,21 @@ When kbuild executes, the following steps are followed (roughly):
              resulting in the target file being recompiled for no
              obvious reason.
 
+    dtc
+       Create flattend device tree blob object suitable for linking
+       into vmlinux. Device tree blobs linked into vmlinux are placed
+       in an init section in the image. Platform code *must* copy the
+       blob to non-init memory prior to calling unflatten_device_tree().
+
+       Example:
+               #arch/x86/platform/ce4100/Makefile
+               clean-files := *dtb.S
+
+               DTC_FLAGS := -p 1024
+               obj-y += foo.dtb.o
+
+               $(obj)/%.dtb: $(src)/%.dts
+                       $(call cmd,dtc)
 
 --- 6.7 Custom kbuild commands