cvs commit: src/sys/netgraph ng_base.c src/sys/sys kernel.h

[Simon L. Nielsen]

On 2005.01.10 14:33:58 -0700, Scott Long wrote:

> Well, I guess my point is that it's important to document exactly what
> MODULE_DEPEND does do, and well as what it doesn't do.  It's not really
> a bug that it doesn't change SI_ORDER order, it's just a not a feature
> that it was ever intended to support.  A second paragraph under 

OK.

> DESCRIPTION that talks about this would probably be most appropriate.
> Something like:
> 
> .Nm
> provides hints to the kernel
> .Xr loader 8
> and to
> .Xr kldload 8
> to ensure that the named dependency is loaded prior to the existing 
> module.  It does not change or dictate the order in which modules are
> initialized at runtime.

OK, I just fixed a mdoc nit and changed kldload(8) to kernel linker
(based on John-Mark Gurney's comment).  The result is attached, which
I plan to commit tomorrow unless somebody else has further
refinements.

-- 
Simon L. Nielsen
-------------- next part --------------
Index: MODULE_DEPEND.9
===================================================================
RCS file: /home/ncvs/src/share/man/man9/MODULE_DEPEND.9,v
retrieving revision 1.6
diff -u -d -r1.6 MODULE_DEPEND.9
--- MODULE_DEPEND.9	7 Jan 2005 08:44:31 -0000	1.6
+++ MODULE_DEPEND.9	10 Jan 2005 23:20:10 -0000
@@ -28,7 +28,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/MODULE_DEPEND.9,v 1.6 2005/01/07 08:44:31 keramida Exp $
 .\"
-.Dd January 7, 2005
+.Dd January 11, 2005
 .Dt MODULE_DEPEND 9
 .Os
 .Sh NAME
@@ -47,6 +47,15 @@
 its version with
 .Fn MODULE_VERSION .
 .Pp
+The
+.Fn MODULE_DEPEND
+macro provides hints to the kernel
+.Xr loader 8
+and to the kernel linker to ensure that the named dependency is loaded
+prior to the existing module.
+It does not change or dictate the order in which modules are
+initialized at runtime.
+.Pp
 Three versions must be specified for
 .Fa moddepend :
 .Bl -tag -width ".Fa prefversion"
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20050111/8cb2b2f2/attachment.bin