aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGeert Uytterhoeven <geert@linux-m68k.org>2014-08-08 11:23:09 -0400
committerMichal Marek <mmarek@suse.cz>2014-08-19 04:02:41 -0400
commitcf6c53db9525a7f6c5052ccd84a0638128f14632 (patch)
tree6501387aab4cd4bfe6e23d3828068560940e64d1
parentef80f0a1e033bcab17257e2155a3c9263a0919c1 (diff)
Documentation: kbuild: Remove obsolete dtc_cpp section
Commit b40b25fff8205dd18124d8fc87b2c9c57f269b5f ("kbuild: always run gcc -E on *.dts, remove cmd_dtc_cpp") improved the functionality of cmd_dtc_cpp and merged it back into cmd_dtc. Signed-off-by: Geert Uytterhoeven <geert@linux-m68k.org> Signed-off-by: Michal Marek <mmarek@suse.cz>
-rw-r--r--Documentation/kbuild/makefiles.txt23
1 files changed, 0 insertions, 23 deletions
diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index 520b2c75bc56..eda00a1073a7 100644
--- a/Documentation/kbuild/makefiles.txt
+++ b/Documentation/kbuild/makefiles.txt
@@ -1163,29 +1163,6 @@ When kbuild executes, the following steps are followed (roughly):
1163 clean-files += *.dtb 1163 clean-files += *.dtb
1164 DTC_FLAGS ?= -p 1024 1164 DTC_FLAGS ?= -p 1024
1165 1165
1166 dtc_cpp
1167 This is just like dtc as describe above, except that the C pre-
1168 processor is invoked upon the .dtsp file before compiling the result
1169 with dtc.
1170
1171 In order for build dependencies to work, all files compiled using
1172 dtc_cpp must use the C pre-processor's #include functionality and not
1173 dtc's /include/ functionality.
1174
1175 Using the C pre-processor allows use of #define to create named
1176 constants. In turn, the #defines will typically appear in a header
1177 file, which may be shared with regular C code. Since the dtc language
1178 represents a data structure rather than code in C syntax, similar
1179 restrictions are placed on a header file included by a device tree
1180 file as for a header file included by an assembly language file.
1181 In particular, the C pre-processor is passed -x assembler-with-cpp,
1182 which sets macro __ASSEMBLY__. __DTS__ is also set. These allow header
1183 files to restrict their content to that compatible with device tree
1184 source.
1185
1186 A central rule exists to create $(obj)/%.dtb from $(src)/%.dtsp;
1187 architecture Makefiles do no need to explicitly write out that rule.
1188
1189--- 6.8 Custom kbuild commands 1166--- 6.8 Custom kbuild commands
1190 1167
1191 When kbuild is executing with KBUILD_VERBOSE=0, then only a shorthand 1168 When kbuild is executing with KBUILD_VERBOSE=0, then only a shorthand