From nobody@FreeBSD.org  Fri Sep  3 10:37:36 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 283FA106580E
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  3 Sep 2010 10:37:36 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 17A338FC20
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  3 Sep 2010 10:37:36 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o83AbYnN037459
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 3 Sep 2010 10:37:34 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o83AbYid037458;
	Fri, 3 Sep 2010 10:37:34 GMT
	(envelope-from nobody)
Message-Id: <201009031037.o83AbYid037458@www.freebsd.org>
Date: Fri, 3 Sep 2010 10:37:34 GMT
From: Gireesh Nagabhushana <dngireesh@avrita.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: MULTI_DRIVER_MODULE is only in man page
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         150244
>Category:       docs
>Synopsis:       [patch] DRIVER_MODULE(9): MULTI_DRIVER_MODULE is only in man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Sep 03 10:40:07 UTC 2010
>Closed-Date:    Sun Aug 28 00:12:35 CEST 2011
>Last-Modified:  Sun Aug 28 00:12:35 CEST 2011
>Originator:     Gireesh Nagabhushana
>Release:        9.0-CURRENT
>Organization:
>Environment:
FreeBSD tonglu.asicdesigners 9.0-CURRENT FreeBSD 9.0-CURRENT #2 r211419M: Wed Aug 18 17:49:06 IST 2010     root@tonglu.asicdesigners:/export/head_2010_08_17/sys/amd64/compile/DNG1808  amd64
>Description:
Man page - DRIVER_MODULE(9) - still has MULTI_DRIVER_MODULE. But based on search in Internet, it looks like MULTI_DRIVER_MODULE has been removed. I also didn't see this in source.
>How-To-Repeat:
-
>Fix:
Remove lines about MULTI_DRIVER_MODULE from man page of DRIVER_MODULE(9).

Patch attached with submission follows:

Index: Makefile
===================================================================
--- Makefile	(revision 211419)
+++ Makefile	(working copy)
@@ -600,7 +600,7 @@
 	domain.9 pfctlinput2.9 \
 	domain.9 pffindproto.9 \
 	domain.9 pffindtype.9
-MLINKS+=DRIVER_MODULE.9 MULTI_DRIVER_MODULE.9
+MLINKS+=DRIVER_MODULE.9
 MLINKS+=EVENTHANDLER.9 EVENTHANDLER_DECLARE.9 \
 	EVENTHANDLER.9 EVENTHANDLER_DEREGISTER.9 \
 	EVENTHANDLER.9 eventhandler_deregister.9 \
Index: DRIVER_MODULE.9
===================================================================
--- DRIVER_MODULE.9	(revision 211419)
+++ DRIVER_MODULE.9	(working copy)
@@ -40,7 +40,6 @@
 .In sys/bus.h
 .In sys/module.h
 .Fn DRIVER_MODULE name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg"
-.Fn MULTI_DRIVER_MODULE name busname "driver_t drivers[]" "devclass_t devclass" "modeventhand_t evh" "void *arg"
 .Sh DESCRIPTION
 The
 .Fn DRIVER_MODULE
@@ -97,10 +96,6 @@
 .Dv NULL
 pointer.
 .Pp
-.Fn MULTI_DRIVER_MODULE
-is a special version of
-.Fn DRIVER_MODULE ,
-which takes a list of drivers instead of a single driver instance.
 .Sh SEE ALSO
 .Xr device 9 ,
 .Xr driver 9 ,


>Release-Note:
>Audit-Trail:

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150244: commit references a PR
Date: Sat, 27 Aug 2011 22:08:11 +0000 (UTC)

 Author: brueffer
 Date: Sat Aug 27 22:08:01 2011
 New Revision: 225220
 URL: http://svn.freebsd.org/changeset/base/225220
 
 Log:
   Remove information and MLINK for MULTI_DRIVER_MODULE().
   The macro was removed in r121129 almost 8 years ago.
   
   PR:		150244
   Submitted by:	Gireesh Nagabhushana <dngireesh@avrita.com>
   Approved by:	re (kib)
 
 Modified:
   head/ObsoleteFiles.inc
   head/share/man/man9/DRIVER_MODULE.9
   head/share/man/man9/Makefile
 
 Modified: head/ObsoleteFiles.inc
 ==============================================================================
 --- head/ObsoleteFiles.inc	Sat Aug 27 21:23:21 2011	(r225219)
 +++ head/ObsoleteFiles.inc	Sat Aug 27 22:08:01 2011	(r225220)
 @@ -2293,6 +2293,8 @@ OLD_FILES+=lib/libz.so
  OLD_FILES+=bin/cxconfig
  OLD_FILES+=sbin/cxconfig
  OLD_FILES+=usr/share/man/man8/cxconfig.8.gz
 +# 20031016: MULTI_DRIVER_MODULE macro removed
 +OLD_FILES+=usr/share/man/man9/MULTI_DRIVER_MODULE.9.gz
  # 200309XX
  OLD_FILES+=usr/bin/symorder
  OLD_FILES+=usr/share/man/man1/symorder.1.gz
 
 Modified: head/share/man/man9/DRIVER_MODULE.9
 ==============================================================================
 --- head/share/man/man9/DRIVER_MODULE.9	Sat Aug 27 21:23:21 2011	(r225219)
 +++ head/share/man/man9/DRIVER_MODULE.9	Sat Aug 27 22:08:01 2011	(r225220)
 @@ -28,7 +28,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd May 16, 2000
 +.Dd August 27, 2011
  .Dt DRIVER_MODULE 9
  .Os
  .Sh NAME
 @@ -40,7 +40,6 @@
  .In sys/bus.h
  .In sys/module.h
  .Fn DRIVER_MODULE name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg"
 -.Fn MULTI_DRIVER_MODULE name busname "driver_t drivers[]" "devclass_t devclass" "modeventhand_t evh" "void *arg"
  .Sh DESCRIPTION
  The
  .Fn DRIVER_MODULE
 @@ -96,11 +95,6 @@ The
  is unused at this time and should be a
  .Dv NULL
  pointer.
 -.Pp
 -.Fn MULTI_DRIVER_MODULE
 -is a special version of
 -.Fn DRIVER_MODULE ,
 -which takes a list of drivers instead of a single driver instance.
  .Sh SEE ALSO
  .Xr device 9 ,
  .Xr driver 9 ,
 
 Modified: head/share/man/man9/Makefile
 ==============================================================================
 --- head/share/man/man9/Makefile	Sat Aug 27 21:23:21 2011	(r225219)
 +++ head/share/man/man9/Makefile	Sat Aug 27 22:08:01 2011	(r225220)
 @@ -605,7 +605,6 @@ MLINKS+=domain.9 DOMAIN_SET.9 \
  	domain.9 pfctlinput2.9 \
  	domain.9 pffindproto.9 \
  	domain.9 pffindtype.9
 -MLINKS+=DRIVER_MODULE.9 MULTI_DRIVER_MODULE.9
  MLINKS+=EVENTHANDLER.9 EVENTHANDLER_DECLARE.9 \
  	EVENTHANDLER.9 EVENTHANDLER_DEREGISTER.9 \
  	EVENTHANDLER.9 eventhandler_deregister.9 \
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: brueffer 
State-Changed-When: Sun Aug 28 00:11:16 CEST 2011 
State-Changed-Why:  
Fixed, the macro was removed almost 8 years ago. Thanks! 


Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Sun Aug 28 00:11:16 CEST 2011 
Responsible-Changed-Why:  
Fixed, the macro was removed almost 8 years ago. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=150244 
>Unformatted:
