Skip to contentSkip to conversation

2.4.0-test13-pre2: macro documentation

PATCH New Tim Waugh 1 participant 1 message Dec 17, 2000

Subsystems (2)
lore
Share & tools
lore

Tim Waugh

author
#0 lore raw

PATCH 1/1 2.4.0-test13-pre2: macro documentation

Hi Linus,

This patch adds inline documentation to a couple of macros, with improvements suggested by Andi Kleen.

Tim.
*/

2000-12-13 Tim Waugh <[email protected]>

* include/linux/init.h, include/linux/module.h: Inline documentation for some macros. Patch from Armin Kuster.

include/linux/init.h renamed from include/linux/init.h.macrodoc +20 -0
@@ -86,7 +86,27 @@
 #define __FINIT		.previous
 #define __INITDATA	.section	".data.init","aw"
 
+/**
+ * module_init() - driver initialization entry point
+ * @x: function to be run at kernel boot time or module insertion
+ * 
+ * module_init() will add the driver initialization routine in
+ * the "__initcall.int" code segment if the driver is checked as
+ * "y" or static, or else it will wrap the driver initialization
+ * routine with init_module() which is used by insmod and
+ * modprobe when the driver is used as a module.
+ */
 #define module_init(x)	__initcall(x);
+
+/**
+ * module_exit() - driver exit entry point
+ * @x: function to be run when driver is removed
+ * 
+ * module_exit() will wrap the driver clean-up code
+ * with cleanup_module() when used with rmmod when
+ * the driver is a module.  If the driver is statically
+ * compiled into the kernel, module_exit() has no effect.
+ */
 #define module_exit(x)	__exitcall(x);
 
 #else
include/asm-i386/atomic.h renamed from include/asm-i386/atomic.h.macrodoc +84 -0

135 lines not on this page · raw message

Documentation/DocBook/kernel-api.tmpl renamed from Documentation/DocBook/kernel-api.tmpl.macrodoc +12 -0
@@ -34,6 +34,18 @@
  </bookinfo>
 
 <toc></toc>
+
+  <chapter id="Basics">
+     <title>Driver Basic</title>
+     <sect1><title>Driver Entry and Exit points</title>
+!Iinclude/linux/init.h
+     </sect1>
+
+     <sect1><title>Atomics</title>
+!Iinclude/asm-i386/atomic.h
+     </sect1>
+  </chapter>
+
   <chapter id="adt">
      <title>Data Types</title>
      <sect1><title>Doubly Linked Lists</title>

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [email protected]
Please read the FAQ at http://www.tux.org/lkml/