A follow-up to my edit of the first 4 sections.
Shift sections down by one due to the deletion of section 3; grammar
corrections along with some rewording; margin width cleanup; and
change EXTRA_CFLAGS -> ccflags-y.
Signed-off-by: matt mooney <mfm@muteddisk.com>
---
Should I add a subsection to section 5. discussing MODLIB?
Documentation/kbuild/modules.txt | 358 +++++++++++++++++++-------------------
1 files changed, 177 insertions(+), 181 deletions(-)
diff --git a/Documentation/kbuild/modules.txt b/Documentation/kbuild/modules.txt
index 799b683..b572db3 100644
--- a/Documentation/kbuild/modules.txt
+++ b/Documentation/kbuild/modules.txt
@@ -15,17 +15,17 @@ This document describes how-to build an out-of-tree kernel module.
--- 3.2 Separate Kbuild file and Makefile
--- 3.3 Binary Blobs
--- 3.4 Building Multiple Modules
- === 4. Include files
- --- 4.1 How to include files from the kernel include dir
- --- 4.2 External modules using an include/ dir
- --- 4.3 External modules using several directories
- === 5. Module installation
+ === 4. Include Files
+ --- 4.1 Kernel Includes
+ --- 4.2 Single Subdirectory
+ --- 4.3 Several Subdirectories
+ === 5. Module Installation
--- 5.1 INSTALL_MOD_PATH
--- 5.2 INSTALL_MOD_DIR
- === 6. Module versioning & Module.symvers
- --- 6.1 Symbols from the kernel (vmlinux + modules)
- --- 6.2 Symbols and external modules
- --- 6.3 Symbols from another external module
+ === 6. Module Versioning
+ --- 6.1 Symbols From the Kernel (vmlinux + modules)
+ --- 6.2 Symbols and External Modules
+ --- 6.3 Symbols From Another External Module
=== 7. Tips & Tricks
--- 7.1 Testing for CONFIG_FOO_BAR
@@ -298,236 +298,232 @@ module 8123.ko, which is built from the following files:
It is that simple!
-=== 5. Include files
+=== 4. Include Files
-Include files are a necessity when a .c file uses something from other .c
-files (not strictly in the sense of C, but if ...