Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Use 'manual page' instead of 'man page' for consistency.

Approved by: re (hrs)

Mechanically kill hard sentence breaks and double whitespaces.

Assorted markup, spelling, and grammar fixes.

o Add cautions about multiple adds of the device
o Remove setting the description of the device (that is more properly done in
probe).
o Remove setting the driver, as it is unnecessary
o Add pseudo code to ensure that the device isn't added to the tree already.
o remove some now unreferenced routines

Add warning about loading/unloading drivers and identify

This interface doesn't return any values.

Submitted by: Mark Santcroos

Plural bogon: s/childs/children/

MFC after: 3 days

ispell sweep of share/man/man9/*.

mdoc(7) police: Use the new .In macro for #include statements.

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

Cross references between the DEVICE_*(9) manual pages.

Add a manpage for the last of the driver's functions, the identify
routine.

PR: 18654
Submitted by: myself (reworked today)