Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

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

"softc" is short for "software context", use that phrase in the
device_get_softc(9) man page.

MFC after: 1 week

-mdoc sweep.

- Clarify when the softc is allocated. It is allocated when a device is
probed and attached, not on the first call to device_get_softc().
- Add a cross reference to DEVICE_PROBE regarding the caveats of using the
softc in a driver's probe routine.
- Fix a grammar bogon.

PR: docs/87176 (1)
Submitted by: Devon H. O'Dell dodell at offmyserver dot com (1)
MFC after: 3 days

Mention that the softc is zeroed after allocation.

Noticed by: sam
MFC after: 3 days

Mdoc Janitor:

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

Assorted mdoc(7), grammar, spelling, and punctuation fixes.

Approved by: re (blanket)

Expound a little bit about the softc, where its size is found and a
caution against emulating legacy softc methods used in the tree.

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

mdoc(7) police: removed HISTORY info from the .Os call.

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

Correct the text for the return value.

Submitted by: phk

$Id$ -> $FreeBSD$

Various man page cleanup:

- Sort xrefs
- FreeBSD.ORG -> FreeBSD.org
- Be consistent with section names as outlined in mdoc(7).
- Other misc mdoc cleanup.

PR: doc/13144
Submitted by: Alexey M. Zelkin <phantom@cris.net>

Add manpages for the new device framework.