kern/52741: Wrong (oudated) information in driver(9)

[rockyhotas%post.com@localhost]

>Number:         52741
>Category:       kern
>Synopsis:       Wrong (oudated) information in driver(9)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Nov 20 10:05:00 +0000 2017
>Originator:     Rocky Hotas
>Release:        current
>Organization:
>Environment:
>Description:
When dealing with the `attach' function:

"The first argument parent is a pointer to the driver's parent device structure.  The second argument self is a pointer to the driver's device structure.  It is also a pointer to our softc structure since the device structure is its first member".

The second statement is wrong: the `softc' struct is not the first member of the `device' struct; it is neither a member of the `device' struct. It can instead be obtained by calling `device_private(self)'.
>How-To-Repeat:
Read the driver(9) manual.
>Fix:
The sentence "It is also a pointer to our softc structure since the device structure is its first member" should be removed, or modified according to the current code.