diff options
author | Geert Uytterhoeven <geert@linux-m68k.org> | 2014-08-08 11:23:08 -0400 |
---|---|---|
committer | Michal Marek <mmarek@suse.cz> | 2014-08-19 04:02:41 -0400 |
commit | ef80f0a1e033bcab17257e2155a3c9263a0919c1 (patch) | |
tree | 8244447e827edb2adfcd8263e5c2425508fdf1a5 /Documentation/kbuild | |
parent | b22ae40ef2e7847ddbd802d1a887188e113675f3 (diff) |
Documentation: kbuild: Improve if_changed documentation
- These days if_changed is used with many more commands than ld,
objcopy, and gzip, hence add an ellipsis,
- Any target that utilises if_changed must be listed in $(targets),
so it needs an assignment to "targets", not "target".
Signed-off-by: Geert Uytterhoeven <geert@linux-m68k.org>
Signed-off-by: Michal Marek <mmarek@suse.cz>
Diffstat (limited to 'Documentation/kbuild')
-rw-r--r-- | Documentation/kbuild/makefiles.txt | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt index a445e1c8828e..520b2c75bc56 100644 --- a/Documentation/kbuild/makefiles.txt +++ b/Documentation/kbuild/makefiles.txt | |||
@@ -1092,7 +1092,7 @@ When kbuild executes, the following steps are followed (roughly): | |||
1092 | 1092 | ||
1093 | Usage: | 1093 | Usage: |
1094 | target: source(s) FORCE | 1094 | target: source(s) FORCE |
1095 | $(call if_changed,ld/objcopy/gzip) | 1095 | $(call if_changed,ld/objcopy/gzip/...) |
1096 | 1096 | ||
1097 | When the rule is evaluated, it is checked to see if any files | 1097 | When the rule is evaluated, it is checked to see if any files |
1098 | need an update, or the command line has changed since the last | 1098 | need an update, or the command line has changed since the last |
@@ -1110,7 +1110,7 @@ When kbuild executes, the following steps are followed (roughly): | |||
1110 | significant; for instance, the below will fail (note the extra space | 1110 | significant; for instance, the below will fail (note the extra space |
1111 | after the comma): | 1111 | after the comma): |
1112 | target: source(s) FORCE | 1112 | target: source(s) FORCE |
1113 | #WRONG!# $(call if_changed, ld/objcopy/gzip) | 1113 | #WRONG!# $(call if_changed, ld/objcopy/gzip/...) |
1114 | 1114 | ||
1115 | ld | 1115 | ld |
1116 | Link target. Often, LDFLAGS_$@ is used to set specific options to ld. | 1116 | Link target. Often, LDFLAGS_$@ is used to set specific options to ld. |
@@ -1142,7 +1142,7 @@ When kbuild executes, the following steps are followed (roughly): | |||
1142 | 1142 | ||
1143 | The ": %: %.o" part of the prerequisite is a shorthand that | 1143 | The ": %: %.o" part of the prerequisite is a shorthand that |
1144 | free us from listing the setup.o and bootsect.o files. | 1144 | free us from listing the setup.o and bootsect.o files. |
1145 | Note: It is a common mistake to forget the "target :=" assignment, | 1145 | Note: It is a common mistake to forget the "targets :=" assignment, |
1146 | resulting in the target file being recompiled for no | 1146 | resulting in the target file being recompiled for no |
1147 | obvious reason. | 1147 | obvious reason. |
1148 | 1148 | ||