docs/161088: [patch] grammar and markup in script.1

[Ben Kaduk]

>Number:         161088
>Category:       docs
>Synopsis:       [patch] grammar and markup in script.1
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Sep 28 02:00:19 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Ben Kaduk
>Release:        10-current
>Organization:
MIT SIPB
>Environment:
n/a
>Description:
There are grammar errors in script.1.  This patch fixes them.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- script.1.orig	2011-09-27 21:36:39.000000000 -0400
+++ script.1	2011-09-27 21:55:29.000000000 -0400
@@ -28,7 +28,7 @@
 .\"	@(#)script.1	8.1 (Berkeley) 6/6/93
 .\" $FreeBSD: src/usr.bin/script/script.1,v 1.25 2011/09/27 18:14:04 trociny Exp $
 .\"
-.Dd January 22, 2004
+.Dd September 27, 2011
 .Dt SCRIPT 1
 .Os
 .Sh NAME
@@ -73,15 +73,16 @@
 .Pa typescript ,
 retaining the prior contents.
 .It Fl k
-Log keys sent to program as well as output.
+Log keys sent to the program as well as output.
 .It Fl q
 Run in quiet mode, omit the start and stop status messages.
 .It Fl t Ar time
-Specify time interval between flushing script output file.
+Specify the interval at which the script output file will be flushed
+to disk, in seconds.
 A value of 0
 causes
 .Nm
-to flush for every character I/O event.
+to flush after every character I/O event.
 The default interval is
 30 seconds.
 .El
@@ -136,13 +137,15 @@
 .Ev SHELL
 is not set, the Bourne shell
 is assumed.
-(Most shells set this variable automatically).
+.Pq Most shells set this variable automatically .
 .El
 .Sh SEE ALSO
 .Xr csh 1
-(for the
+.Po
+for the
 .Em history
-mechanism).
+mechanism
+.Pc .
 .Sh HISTORY
 The
 .Nm
@@ -165,13 +168,15 @@
 The slave terminal mode is checked
 for ECHO mode to check when to avoid manual echo logging.
 This does not
-work when in a raw mode where the program being run is doing manual echo.
+work when the terminal is in a raw mode where
+the program being run is doing manual echo.
 .Pp
-If the
+If
 .Nm
-reads zero bytes from the terminal it switches to a mode when it probes read
-only once a second until it gets some data.
-This prevents the
+reads zero bytes from the terminal, it switches to a mode when it
+only attempts to read
+once a second until there is data to read.
+This prevents
 .Nm
-spinning on zero-byte reads, but might cause a 1-second delay in
-processing of the user input.
+from spinning on zero-byte reads, but might cause a 1-second delay in
+processing of user input.


>Release-Note:
>Audit-Trail:
>Unformatted: