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

Fix issues found by mandoc -Tlint.

MFC after: 1 week

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days

Fix some Xr references:

- ada(4): ad(4) - removed, ada(4) would be a self-referencing entry
- cd(4): ad(4) -> ada(4)
- da(4): ad(4) -> ada(4)
- DEVICE_PROBE(9): ugen(5) -> ugen(4)
- ed(4): dhclinet(8) -> dhclient(8) (typo)
- lmc(4): Netgraph(4) -> netgraph(4)
- security(7): rc.conf(8) -> rc.conf(5)
- sfxge(4): cpuset(8) -> cpuset(1)
- sbp(4): sysctl(1) -> sysctl(8)
- portindex(5): build(1) -> build(7)
- u3g(4): usbconfig(5) -> usbconfig(8)
- usb_quirk(4): usbconfig(5) -> usbconfig(8)

Found with: textproc/igor
MFC after: 3 days

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>

Spelling fixes.

Add several necessary .El's.

MFC after: 2 weeks

Document all the BUS_PROBE_* values.

Note to the mdoc gods: This may need some teaks.

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

Approved by: re (hrs)

Use .Fn function_name

MFC after: 3 days

Be explicit that a driver may assume softc is preserved when returning 0

Mechanically kill hard sentence breaks and double whitespaces.

Document more clearly that a probe routine:
Should have no side effects
Must not hold resources when it returns
May be called multiple times if it returns < 0.

Remove the bad advise that the probe routine should look for children
for devices that implement busses. This is more properly reserved for
the attach routine.

Mdoc Janitor:

* Fix hard sentence breaks.

* Correct use of a period in DELAY(9).

Spelling: s/then/than/ where appropriate.

mdoc(7) police: Deal with self-xrefs.

mdoc(7) police: macroize UNIX.

ispell sweep of share/man/man9/*.

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.

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

Prepare for mdoc(7)NG.

mdoc(7) police: removed duplicate .Os calls.

mdoc(7) police: Er macro usage cleanup.

Remove more single-space hard sentence breaks.

$Id$ -> $FreeBSD$

Update the comments on values than can be returned by DEVICE_PROBE.
DEVICE_PROBE can return priorities.

Reviewed by: Doug Rabson <dfr@nlsystems.com>

Add manpages for the new device framework.