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

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

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Use the newly brought %U macro.

Document two new sysctl variables, dev.sf.%d.int_mod and dev.sf.%d.stats.
Xref vlan(4).
Touchd Dd.

Reviewed by: brueffer

Xref altq(4) for drivers that support it according to altq(4).

Work around an apparent mdoc(7) bug.

Spotted by: marius
Discussed with: ru

Break long lines and kill a few instances of EOL whitespace.

Noticed by: ru

Add a "Load module on start up" comment, similar to mac_*.4 pages[1].
Quote .Cd and .Nd text.
Bump doc date.

Requested by: some user through ru
Supported by: ru, dwmalone, brueffer

Xref polling.4 and bump .Dd

MFC after: 3 days

Correct the link to the AIC-6915 programmer's manual

- move list of supported adapters into a HARDWARE section
- correctly capitalize Fast Ethernet
- correct two typos
- bump document date

Xref miibus(4).

mdoc(7) police: fixed the "new sentence" bogons.

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

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

mdoc(7) police: normalize .Nd.

Use Fx macro wherever possible.

Minor formatting tweak: compact the supported adapter list.

Move netgraph node type man pages from section 8 to section 4.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

Add a reference to ng_ether(8).

Second round of config related changes to the manpages.

device blah0 -> device blah for PCI devices and busses.

Add/fix controller miibus0/device miibus0 stuff here too.

* remove i386 specific mark
* some style and syntax fixes
* some duplicated $FreeBSD$ tags removed

Update the Starfire driver comments and man page to include the URL of
the AIC-6915 Programmer's Manual which I finally found online at Adaptec's
site.

$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>

This commit adds device driver support for Adaptec Duralink PCI fast
ethernet controllers based on the AIC-6915 "Starfire" controller chip.
There are single port, dual port and quad port cards, plus one 100baseFX
card. All are 64-bit PCI devices, except one single port model.

The Starfire would be a very nice chip were it not for the fact that
receive buffers have to be longword aligned. This requires buffer
copying in order to achieve proper payload alignment on the alpha.
Payload alignment is enforced on both the alpha and x86 platforms.
The Starfire has several different DMA descriptor formats and transfer
mechanisms. This driver uses frame descriptors for transmission which
can address up to 14 packet fragments, and a single fragment descriptor
for receive. It also uses the producer/consumer model and completion
queues for both transmit and receive. The transmit ring has 128
descriptors and the receive ring has 256.

This driver supports both FreeBSD/i386 and FreeBSD/alpha, and uses newbus
so that it can be compiled as a loadable kernel module. Support for BPF
and hardware multicast filtering is included.