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

1 files changed, 70 insertions, 45 deletions

diff --git a/usr.sbin/watch/watch.8 b/usr.sbin/watch/watch.8
index a5f497d..a57a70c 100644
--- a/usr.sbin/watch/watch.8
+++ b/usr.sbin/watch/watch.8
@@ -1,52 +1,77 @@
-.Dd Februar 17, 1995
+.\"
+.\" @(#)watch.8		1.1 (FreeBSD) 2/17/95
+.\"
+.Dd February 17, 1995
 .Dt WATCH 8
 .Os
 .Sh NAME
-watch - tty snoop watching utility. 
-
-.Sh SYNOPSIS
-
- watch [-ciot] [<tty name>]
-
+.Nm watch
+.Nd snoop on another tty line
+.Sh SYNOPSYS
+.Nm watch
+.Op Fl ciot
+.Ar tty
+.\"  watch [-ciot] [<tty name>]
 .Sh DESCRIPTION
- watch utility allows user to see all data coming to the tty,almost
- the same way as user on this tty.
- Only root can run watch.
-
-The following options are available:
-
--c   Reconnect on close. When tty on which watching was made closed,
-     utility will automatically reattach itself to the same tty.
-     By default utility will ask user to enter new tty name if running
-     in interactive mode or exit while non-interactive.
-
--i   Force interactive mode.Interactive mode is a default if utility
-     started from tty. If output redirected to file, you can still force
-     it into interactive mode by this option.
-
--o   Reconnect on overflow. The behaviour of utility on overflow is same
-     as for tty close. For more info see snp(4).
-
--t   Timestamp.Print date and time each time, tty watching started.
-
- The <tty name> is one of following types:
-  ttyp?,ttyq?,ttyr? - pseudo tty devices.
-  ttyv? - virtual ttys (syscons).
-  tty0?,ttyd? - serial lines.
- Each name can be preceeded by "/dev/".
- Also recognized:
-  pty[NUM] - pseudotty's.
-  vty[NUM] - virtual ttys.
-  sio[NUM] - serial lines.
-  
- While running interactive, all user input discarded except :
-  Ctrl+C - Exit watch.
-  Ctrl+X - Change attached tty.
-  Ctrl+W - Clear screen.
-
+.Nm Watch
+allows the superuser to examine all data coming through a specified tty.
+.Nm Watch
+writes to standard output.
+.Pp
+The options are as follows:
+.Bl -tag -width "-l nul  "
+.It Fl c
+Reconnect on close.  If the tty observed by
+.Nm watch
+is closed,  automatically reattach to the same tty.
+If this option is not specified,
+.Nm watch
+will request a new tty if running in interactive mode or exit if running
+without a controlling tty.
+.It Fl i
+Force interactive mode.
+Interactive mode is a default if
+.Nm watch
+is started from a tty.
+If output is redirected to a file, interactive mode can still be requested
+by specifying this option.
+.It Fl o
+Reconnect on overflow.
+The behaviour of
+.Nm watch
+if the observed tty overflows is similar to the behavior if the observed tty
+is closed.
+For more info see
+.Xr snp 4 .
+.It Fl t
+Print the date and time when observation of a given tty is started.
+.It Ar tty
+Tty may be specified as a remote pseudo tty device, a virtual console, or
+a serial line.
+Names may be preceded by "/dev/".
+.Sh OPERATION
+While running in interactive mode, all user input is discarded except for:
+.Pp
+.Bl -tag -width "XXXX" -compact
+.It Sy "<control-C>"
+Exit
+.Nm watch .
+.It Sy "<control-W>"
+Clear screen.
+.It Sy "<control-X>"
+Change attached tty.
+.Sh RESTRICTIONS
+Only the superuser can run
+.Nm watch .
 .Sh SEE ALSO
-snp(4),pty(4),sio(4)
+.Xr snpl4 ,
+.Xr pty 4 ,
+.Xr sio 4 .
 .Sh BUGS
-No terminal emulation involved,all user output comes to the screen as-is.
+No terminal emulation is performed.
+All user output is reproduced as-is.
+.Sh AUTHOR
+Ugen J.S. Antsilevich <ugen@NetVision.net.il> 
 .Sh HISTORY
-FreeBSD 2.1,By Ugen J.S.Antsilevich <ugen@NetVision.net.il> 
+.Nm Watch
+first appeared in FreeBSD 2.1