kbuild: doc: merge 'Special Rules' and 'Custom kbuild commands' sections
authorMasahiro Yamada <masahiroy@kernel.org>
Sat, 28 Nov 2020 11:51:05 +0000 (20:51 +0900)
committerMasahiro Yamada <masahiroy@kernel.org>
Mon, 21 Dec 2020 04:57:07 +0000 (13:57 +0900)
commit41cac0834f885fac9b655eaa9214526c0c1d9afe
tree74eb3f65cd6d90dadb14ed865551cd09fbe1d5bb
parent23b53061ad5dd435d4d35c842cd84047dbbe2919
kbuild: doc: merge 'Special Rules' and 'Custom kbuild commands' sections

The two sections "3.10 Special Rules" and "7.8 Custom kbuild commands"
are related because you must understand both of them when you write
custom rules.

Actually I do not understand the policy about what to go into
"3 The kbuild files" and what into "7 Architecture Makefile".

This commit reworks the custom rule explanation as follows:

 - Merged "7.8 Custom kbuild commands" into "3.10 Special Rules".

 - Reword "Special Rules" to "Custom Rules" for consistency.

 - Update the example for kecho because the blackfin Makefile
   does not exist any more.

 - Replace the example for cmd_<command> with a simpler one.

Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>
Documentation/kbuild/makefiles.rst