|author||Nicolas Kaiser <firstname.lastname@example.org>||2010-08-05 11:23:11 -0700|
|committer||Linus Torvalds <email@example.com>||2010-08-05 13:21:24 -0700|
|parent||Documentation: update kbuild make typos/grammar/text flow (diff)|
Documentation: fix kbuild typos and wording
Fixed some typos and wording. Signed-off-by: Nicolas Kaiser <firstname.lastname@example.org> Signed-off-by: Linus Torvalds <email@example.com>
Diffstat (limited to 'Documentation/kbuild/makefiles.txt')
1 files changed, 12 insertions, 12 deletions
diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index 31bfcbf958fc..8abd041b605d 100644
@@ -285,12 +285,12 @@ more details, with real examples.
--- 3.7 Compilation flags
ccflags-y, asflags-y and ldflags-y
- The three flags listed above apply only to the kbuild makefile where
- they are assigned (i.e., per-directory). They are used for all the
- normal cc, as and ld invocation happening during a recursive build.
+ These three flags apply only to the kbuild makefile in which they
+ are assigned. They are used for all the normal cc, as and ld
+ invocations happening during a recursive build.
Note: Flags with the same behaviour were previously named:
- EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS. They are still
- supported but their use is deprecated.
+ EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS.
+ They are still supported but their usage is deprecated.
ccflags-y specifies options for compiling with $(CC).
@@ -317,10 +317,10 @@ more details, with real examples.
The two flags listed above are similar to ccflags-y and asflags-y.
- The difference is that the subdir- variants affect the kbuild
- file where they are present and all subdirectories. Options specified
- using subdir-* are added to the commandline before the options
- specified using the non-subdir variants.
+ The difference is that the subdir- variants have effect for the kbuild
+ file where they are present and all subdirectories.
+ Options specified using subdir-* are added to the commandline before
+ the options specified using the non-subdir variants.
subdir-ccflags-y := -Werror
@@ -1174,14 +1174,14 @@ When kbuild executes, the following steps are followed (roughly):
=== 7 Kbuild syntax for exported headers
The kernel include a set of headers that is exported to userspace.
-Many headers can be exported as-is but other headers requires a
+Many headers can be exported as-is but other headers require a
minimal pre-processing before they are ready for user-space.
The pre-processing does:
- drop kernel specific annotations
- drop include of compiler.h
-- drop all sections that is kernel internat (guarded by ifdef __KERNEL__)
+- drop all sections that are kernel internal (guarded by ifdef __KERNEL__)
-Each relevant directory contain a file name "Kbuild" which specify the
+Each relevant directory contains a file name "Kbuild" which specifies the
headers to be exported.
See subsequent chapter for the syntax of the Kbuild file.