Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: fix kbuild typos and wording

Fixed some typos and wording.

Signed-off-by: Nicolas Kaiser <nikai@nikai.net>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Nicolas Kaiser and committed by
Linus Torvalds
c95940f2 eb07e1b4

+16 -16
+4 -4
Documentation/kbuild/kbuild.txt
··· 40 40 modules. 41 41 The directory can be specified in several ways: 42 42 1) Use "M=..." on the command line 43 - 2) Environmnet variable KBUILD_EXTMOD 44 - 3) Environmnet variable SUBDIRS 43 + 2) Environment variable KBUILD_EXTMOD 44 + 3) Environment variable SUBDIRS 45 45 The possibilities are listed in the order they take precedence. 46 46 Using "M=..." will always override the others. 47 47 48 48 KBUILD_OUTPUT 49 49 -------------------------------------------------- 50 50 Specify the output directory when building the kernel. 51 - The output directory can also be specificed using "O=...". 51 + The output directory can also be specified using "O=...". 52 52 Setting "O=..." takes precedence over KBUILD_OUTPUT. 53 53 54 54 ARCH ··· 90 90 $3 - kernel map file 91 91 $4 - default install path (use root directory if blank) 92 92 93 - The implmentation of "make install" is architecture specific 93 + The implementation of "make install" is architecture specific 94 94 and it may differ from the above. 95 95 96 96 INSTALLKERNEL is provided to enable the possibility to
+12 -12
Documentation/kbuild/makefiles.txt
··· 285 285 --- 3.7 Compilation flags 286 286 287 287 ccflags-y, asflags-y and ldflags-y 288 - The three flags listed above apply only to the kbuild makefile where 289 - they are assigned (i.e., per-directory). They are used for all the 290 - normal cc, as and ld invocation happening during a recursive build. 288 + These three flags apply only to the kbuild makefile in which they 289 + are assigned. They are used for all the normal cc, as and ld 290 + invocations happening during a recursive build. 291 291 Note: Flags with the same behaviour were previously named: 292 - EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS. They are still 293 - supported but their use is deprecated. 292 + EXTRA_CFLAGS, EXTRA_AFLAGS and EXTRA_LDFLAGS. 293 + They are still supported but their usage is deprecated. 294 294 295 295 ccflags-y specifies options for compiling with $(CC). 296 296 ··· 317 317 318 318 subdir-ccflags-y, subdir-asflags-y 319 319 The two flags listed above are similar to ccflags-y and asflags-y. 320 - The difference is that the subdir- variants affect the kbuild 321 - file where they are present and all subdirectories. Options specified 322 - using subdir-* are added to the commandline before the options 323 - specified using the non-subdir variants. 320 + The difference is that the subdir- variants have effect for the kbuild 321 + file where they are present and all subdirectories. 322 + Options specified using subdir-* are added to the commandline before 323 + the options specified using the non-subdir variants. 324 324 325 325 Example: 326 326 subdir-ccflags-y := -Werror ··· 1174 1174 === 7 Kbuild syntax for exported headers 1175 1175 1176 1176 The kernel include a set of headers that is exported to userspace. 1177 - Many headers can be exported as-is but other headers requires a 1177 + Many headers can be exported as-is but other headers require a 1178 1178 minimal pre-processing before they are ready for user-space. 1179 1179 The pre-processing does: 1180 1180 - drop kernel specific annotations 1181 1181 - drop include of compiler.h 1182 - - drop all sections that is kernel internat (guarded by ifdef __KERNEL__) 1182 + - drop all sections that are kernel internal (guarded by ifdef __KERNEL__) 1183 1183 1184 - Each relevant directory contain a file name "Kbuild" which specify the 1184 + Each relevant directory contains a file name "Kbuild" which specifies the 1185 1185 headers to be exported. 1186 1186 See subsequent chapter for the syntax of the Kbuild file. 1187 1187