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

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

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)

Correct the sysconf variable name, _SC_CLK_TCK.

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

Approved by: re (hrs)

Note the ACPI clock and its characteristics.

mdoc(7) police: scheduled sweep.

Approved by: re

mdoc(7) police:

Revert to using the .Tn POSIX and .Tn ANSI instead of \*[Px] and \*[Ai]
strings; using these strings is unsafe in troff mode, as they include a
change in a font size.

Approved by: re

X-ref clock_gettime(2).

mdoc(7) police: tidy up.

Fix typo, and add some additional description to the i8254 and TSC.

PR: docs/20738
Submitted by: Tan Koan-Sin <freedom@csie.nctu.edu.tw>

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

mdoc(7) police: s/BSD/.Bx/ where appropriate.

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

Fixed typos: dependant -> dependent

mdoc(7) police: do not split author names in the AUTHORS section.

Use Fx macro wherever possible.

Avoid use of direct troff requests in mdoc(7) manual pages.

Capitalize the last two entries. Note that i8254 is a timer. Report
that TSC is for any fifth-gneration of later x86 processor, not an
i586, and document that it _is_ available to applications.

$Id$ -> $FreeBSD$

.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs.
Use .An/.Aq.

"It's" -> "Its" in two places.

Use the .Fx macro for FreeBSD references for releases prior to 2.0.
Use the .Tn macro for generic FreeBSD references. Cleanup other
formatting problems noticed while making the above changes.

Revert $FreeBSD$ back to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Correct some man page xrefs, and some other minor changes to bring some
man pages up to mdoc guidelines and fix some minor formatting glitches.
Also fixed a number of man pages to not abuse the .Xr macro to
display functions and path names and a lot of other junk.

Bring clocks(7) into line with mdoc standards.

Reviewed by: joerg

Add clocks(7).

Submitted by: bde