diff options
author | Geert Uytterhoeven <geert@linux-m68k.org> | 2014-08-08 11:23:09 -0400 |
---|---|---|
committer | Michal Marek <mmarek@suse.cz> | 2014-08-19 04:02:41 -0400 |
commit | cf6c53db9525a7f6c5052ccd84a0638128f14632 (patch) | |
tree | 6501387aab4cd4bfe6e23d3828068560940e64d1 | |
parent | ef80f0a1e033bcab17257e2155a3c9263a0919c1 (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.txt | 23 |
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 |