MFC r308637:

Fix function prototypes in usbdi(9) man page, and tweak it a little.

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 a bunch of "sentence not on new line" warnings in section 9.

MFC after: 1 month

Fix various mdoc issues and some EOL whitespace.

Found with: mandoc -Tlint

Fix markups.

use .Mt to mark up email addresses consistently (part6)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>

Typo and mdoc(7) style fixes.

PR: 168117
Submitted by: Nobuyuki Koganemaru (kogane&jp!freebsd!org)
MFC after: 3 days

Fix mdoc(7) markup.

Remove trailing whitespace per mdoc lint warning

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

- Add support for software pre-scaling of ISOCHRONOUS transfers.

MFC after: 14 days
Approved by: thompsa (mentor)

Spelling fixes.

mdoc: consistently spell our email addresses <foo@FreeBSD.org>

Reviewed by: ru

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

Removed duplicate usbd_xfer_state(9) link.

Move programming info from usb(4) to usbdi(9) and update for the usb stack
changeover. Needs much more content still.

Spelling fixes.

Add basic documentation for many of the kernel USB functions that
USB device drivers use to talk to USB devices. This is probably
still a bit rough and it does not yet include the functions specific
to HID, ethernet, hubs, host controller drivers, task threads or
debugging.