Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

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

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

Sort sections.

Eliminated double whitespace.

Mechanically kill hard sentence breaks.

Fix typos, mostly s/ an / a / where appropriate and a few s/an/and/
Add FreeBSD Id tag where missing.

The .Nm utility

Talk about what the user needs to do to get the snp devices, and how
watch(8) will try to help them by loading the module.

PR: 25420

Change 'superuser' to 'user' which was forgotten in the previous
delta. Remove fake SCCS id while I'm here.

Remove the sentence about only root being able to run watch(8). It
was never technically true (it's snp(4) that required root, not
watch(8)), and after snp.c 1.64, isn't even effectively true, since
who can run watch(8) depends on the permissions of the snp device(s).

Sort options in SYNOPSIS and DESCRIPTION while I'm here.

Add an -f option which allows one to specify a snp device to use.
Previously, watch would always use the first device it could
successfully open, but this isn't always desired. Specifically, it
may not be desired during debugging (of snp), or if a particular snp
device has different permissions (which makes since after snp.c 1.64).

o When "-n" is used with watch, it disables the use of <control-X> to
change terminals being watched. This change makes watch pass the
<control-X> through to the terminal if it's not being intercepted--
previously, the keypress would simply be dropped.

Replace an instance of the "watch" word with the ".Nm" macro: it is used to
specify the command name.

mdoc(7) police: use the new features of the Nm macro.

Add missing .El.
-Wall cleaning.

``tty'' is not required parameter

$Id$ -> $FreeBSD$

Add $Id$, to make it simpler for members of the translation teams to
track.

The Id line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde

.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.

Use err(3).

Sort cross references.

Remove breakage of 1.8.2.2, choose slightly better character for quit.

Fix a typo in the man page (the "-n" flag was added to the synopsis in
a comment).

I have added a '-n' flag to the watch(8) command. This option
disables the ability to interactively select a new tty. I have also
removed a check for uid == 0 because it gets in the way of using suid
mode based access control. Watch (8)is only runnable by root, so this
does not really change things much.

Closes PR#2131

Submitted-By: adrian@virginia.edu

Use the .Fx macro where appropriate.

Fix a bunch of spelling errors in a bunch of man pages.

Map ^C and ^\ (INTR and QUIT) to ^Q so that you can actually send these
guys to a watched process. Useful if you're monitoring someone who's
started doing something you'd really like them to stop immediately. :)
Suggested by: Phillip White <philw@megasoft.tic.ab.ca>

same

Update to use new calling conventions

Fix(it was 1 character actually:)

Rewrite manual page to use mandoc correctly and fix english grammar.

Watch fresh-made manpage..