Clean up language.

Reviewed by:	rik

1 files changed, 293 insertions, 261 deletions

diff --git a/sbin/sconfig/sconfig.8 b/sbin/sconfig/sconfig.8
index a169c4a..d319797 100644
--- a/sbin/sconfig/sconfig.8
+++ b/sbin/sconfig/sconfig.8
@@ -1,150 +1,161 @@
+.\" Copyright (c) 2002-2004 Roman Kurakin <rik@cronyx.ru>
+.\" Copyright (c) 2002-2004 Cronyx Engineering
+.\" All rights reserved.
+.\"
+.\" This software is distributed with NO WARRANTIES, not even the implied
+.\" warranties for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\" Authors grant any other persons or organisations a permission to use,
+.\" modify and redistribute this software in source and binary forms,
+.\" as long as this message is kept with the software, all derivative
+.\" works or modified versions.
+.\"
 .\" $FreeBSD$
-.Dd November 21, 2003
+.Dd May 19, 2004
 .Dt SCONFIG 8 i386
 .Os
 .Sh NAME
 .Nm sconfig
-.Nd channel configuration utility for Cronyx adapters
+.Nd "channel configuration utility for Cronyx adapters"
 .Sh SYNOPSIS
 .Nm
 .Op Fl aimsxeftuc
 .Op Ar device
-.Op Ar data rate options
-.Op Ar protocol options ...
-.Op Ar interface options ...
+.Op Ar data_rate_options
+.Op Ar protocol_options ...
+.Op Ar interface_options ...
 .Sh DESCRIPTION
 The
 .Nm
 utility is used for configuring the channel options of the Cronyx
 adapters.
-In asynchronous mode all the parameters should be set by standard
+In asynchronous mode, all parameters should be set using the standard
 .Xr stty 1
-utility, with
-.Nm
-you could set only few of them (see below).
+utility.
+With
+.Nm ,
+it is only possible to set some of them (see below).
 .Pp
-Some of the options could be set only on free channels, that is the
-corresponding network interface in
-.Ar down
-state in the synchronous mode, and in the asynchronous mode the asynchronous
-terminal device
+Some of the options can be set only on free channels,
+that is when the corresponding network interface is in the
+.Cm down
+state in the synchronous mode,
+and the terminal device
 .Pa /dev/tty*
-closed.
+is closed in asynchronous mode.
 .Pp
-Other channel options could be changed
+Other channel options can be changed
 .Dq "on the fly" .
 Generally, the channel options are set up during the operating system startup,
-for example from the
+for example, from the
 .Pa /etc/rc
-file.
+script.
 .Pp
-Note, that not all options have a sense for every particular
-case, and an attempt to set some of them can hang up the channel or
-the whole adapter.
+Note that not all options make sense in every particular case,
+and an attempt to set some of them may hung up the channel
+or the whole adapter.
 .\"--------------------------------------------------------------
 .Ss "Information Options"
-You can specify only one of these options.
+Only one of these options can be specified.
 If information option is specified,
 .Nm
-will show corresponding information and will ignore all other options,
+will show the corresponding information and will ignore all other options,
 except
 .Ar device .
-See also description of the
-.Ar device .
+See also the description of the
+.Ar device
+argument.
 .Bl -tag -width indent
 .It <none>
 This will show settings of the channel.
 .It Fl a
 Print all settings of the channel.
 .It Fl i
-Print interface settings, equal to the output of
+Print interface settings, equal to the output of the
 .Xr ifconfig 8
 utility.
 .It Fl m
 Print modem signal status.
-The description of all signals can be found in
-any document related to the modems.
+The description of all signals can be found in any modem documentation.
 Only LE signal should be described.
-If this signal is On, than some what use channel.
-If it is Off, than channel is free.
+If this signal is ON then the channel is busy.
+If it is OFF then the channel is free.
 .It Fl s
 Print brief channel statistics.
-This is general statistics.
-See also
-.Fl x , e , f , t
+This is the generic statistics,
+see also the
+.Fl x , e , f , t ,
 and
 .Fl u
 options.
-For the description of output, see below.
+For a description of the output, see below.
 .Pp
 This statistics is very useful if something goes wrong.
-For example, if you
-have no any interrupts, than you use interrupt that is not registered in BIOS
-for use with ISA bus.
+For example, if all interrupt counters are zero then the device
+was configured to use an interrupt that was not registered in the
+BIOS for use with the ISA bus.
 .It Fl x
 Print full channel statistics.
-This options allows to see some more counters,
+This options prints additinal counters,
 but with less precision than with the
 .Fl s
 option.
 .It Fl e
 Print brief E1/G703 statistics.
-If you select this option, you will get
-statistics accumulated for period of time equal to 15 minutes.
-For the
-description of output, see below.
+If this option is selected, the
+statistics accumulated over the last 15 minutes is printed.
+For a description of the output, see below.
 .It Fl f
 Print full E1/G703 statistics.
-This option shows all E1/G703 statistics that
-shows previous option
-.Pq Fl e ,
-but also total statistics for whole period of time and statistics for 24
-hours (if available).
-For the description of output, see below.
+This option shows all E1/G703 statistics that the
+.Fl e
+option shows,
+plus total statistics for the whole period of time and statistics for
+last 24 hours (if available).
+For a description of the output, see below.
 .It Fl t
 Print brief E3/T3/STS-1 statistics.
-If you select this option, you will
-get statistics accumulated for period of time equal to 15 minutes.
-For
-the description of output, see below.
+If this option is selected, the
+statistics accumulated over the last 15 minutes is printed.
+For a description of the output, see below.
 .It Fl u
 Print full E3/T3/STS-1 statistics.
-This option shows all E3/T3/STS-1
-statistics that shows previous option
-.Pq Fl t ,
-but also total statistics for whole period of time and statistics for 24
-hours (if available).
-For the description of output, see below.
+This option shows all E3/T3/STS-1 statistics that the
+.Fl t
+option shows,
+plus total statistics for the whole period of time and statistics for
+last 24 hours (if available).
+For a description of the output, see below.
 .It Fl c
 Cleans all kind of statistics.
 .El
 .\"--------------------------------------------------------------
 .Ss "Device Selection"
-Device is equal to the name of the interface that is used for a name of
-the interface that is sees
+The device is selected using the name of the network interface,
+as shown by
 .Xr ifconfig 8 .
-The channel number depends on the order of loading drivers by the system.
+The channel number depends on the order the drivers were loaded into the system.
 Sometimes people confuse channel number and adapter number because of the
 same spelling.
-Adapter number appears in kernel context, channel number
-in configuration context.
+The adapter number appears in the kernel context, while the channel number
+is in the configuration context.
 .Bl -tag -width indent
 .It <none>
-You can omit device name only if you want to get information.
-This will cause
-printing information about all available channels of Cronyx adapters.
-In the
-case you want to make some settings you MUST specify device name.
-.It Li cx##
+If the device name is omitted,
+.Nm
+will print information about all channels of all Cronyx adapters
+available in the system.
+If some settings need to be made, the device name must be specified.
+.It Li cx Ns Ar ##
 This is the channel name for the Sigma family of Cronyx adapters.
 (ISA bus.)
-.It Li ct##
+.It Li ct Ns Ar ##
 This is the channel name for the Tau family of Cronyx adapters.
 (ISA bus.)
-.It Li cp##
+.It Li cp Ns Ar ##
 This is the channel name for the Tau-PCI family of Cronyx adapters.
 (PCI bus.)
-.It Li ce##
+.It Li ce Ns Ar ##
 This is the channel name for the Tau32-PCI family of Cronyx adapters.
 (PCI bus.)
 .El
@@ -152,261 +163,278 @@ This is the channel name for the Tau32-PCI family of Cronyx adapters.
 .Ss "Data Rate Options"
 .Bl -tag -width indent
 .It Ar value
-In case of nonzero value it will cause setting data rate to given value and
-setting the internal clock source of the synchronization (in synchronous mode).
-Zero value is equal to the
-.Cm extclock .
-The transmitted data (TXD) are synchronized using the internal on-board timing
+A non-zero value will set the data rate to a given value
+in asynchronous mode,
+and will set the date rate and internal clock source of synchronization
+in synchronous mode.
+A zero value is equivalent to specifying the
+.Cm extclock
+option.
+The transmitted data (TxD) are synchronized using the internal on-board timing
 generator, the internally generated timing signal is driven on the TXCOUT pin,
 and the signal on the TXCIN pin is ignored.
 This mode is used for direct
-terminal-to-terminal communication, e.g., for connecting two computers together
-in a synchronous mode via relatively short cable.
+terminal-to-terminal communication, e.g., when connecting two computers together
+in synchronous mode with a relatively short cable.
 This method should also be
 used for testing channels with an external loopback connector.
 .It Cm extclock
-Set the external timing clock source of synchronous channels.
-External clock
-mode is the most common method for connecting external modem hardware.
-In this
-mode the external timing signal is received on TXCIN pin of the connector,
-and it is used as a synchronization clock for transmitting data (TXD).
+Set the external timing clock source for synchronous channels.
+External clock mode is the most commonly used method for connecting
+external modem hardware.
+In this mode,
+the external timing signal is received on the TXCIN pin of the connector,
+and it is used as a synchronization clock for transmitting data (TxD).
+.Pp
+Note: in
+.Cm extclock
+mode, the device cannot determine the value of the external timing clock
+since it does not have the built-in clock gauge.
 .El
 .\"--------------------------------------------------------------
 .Ss "Protocol Options"
-Note.
-These option could be set only if channel is free and they requires
-specifying of the device name.
+Note: these option can only be used on a free channel, and they require
+specifying the device name.
 .Bl -tag -width indent
 .It Cm async
-Set asynchronous protocol (or mode).
-In this mode Cronyx adapters behave as a
-usual serial devices and you may work with them using usual serial utilities.
-All asynchronous settings are performed via serial configuration utilities.
-With
-.Nm
-you may set only a few of them.
-See also
-.Xr stty 1 .
 (Only for Sigma family.)
+Select the asynchronous protocol (or mode).
+In this mode, Cronyx adapters behave as normal serial devices,
+and standard serial communications utilities can be used to
+work with them.
+All asynchronous settings should be set using the standard
+serial communications configuration utilities, e.g.,
+.Xr stty 1 .
+With
+.Nm ,
+it is only possible to set some of them.
 .It Cm cisco
-Set the Cisco HDLC synchronous protocol.
+Select the Cisco HDLC synchronous protocol.
 .It Cm fr
-Set the Frame Relay synchronous protocol
+Select the Frame Relay synchronous protocol
 .Tn ( ANSI
 T1.617 Annex D).
 .It Cm ppp
-Set the PPP synchronous protocol.
-Parameters to the PPP could be set by the
-command
-.Xr spppcontrol 8 .
+Select the synchronous PPP protocol.
+PPP parameters can be configured using the
+.Xr spppcontrol 8
+utility.
 .It Sm Cm keepalive No = Bro Cm on , off Brc Sm
-Turns on/off sending keepalive messages.
-This option is used only for
-synchronous PPP.
-If this option is on, than PPP will periodically send
-echo-request messages.
-If it would not receive any echo-reply messages for
-some (definite) period of time it will break connection.
-It is used for
-tracking line state.
+Turn on/off transmission of keepalive messages.
+This option is used only for synchronous PPP.
+If this option is
+.Cm on ,
+PPP will periodically send ECHO-REQUEST messages.
+If it will not receive any ECHO-REPLY messages for
+some (definite) period of time it will break the connection.
+It is used for tracking the line state.
 .It Cm idle
-You are using Netgraph.
-Protocol depends on connected module.
+This mode is reported when using Netgraph.
+An actual protocol depends on the type of a connected Netgraph node,
+and it cannot be changed with
+.Nm .
 .El
 .\"--------------------------------------------------------------
 .Ss "Interface Options"
-Not all of these options could be set on running channel and not all of them
-are suits to all kind of adapters/channels.
-In all dual state options off is
-default value.
-All this options is not applicable in asynchronous mode, except
+Not all of these options can be set on a busy channel, and not all of them
+are applicable to all kinds of adapters/channels.
+For all dual-state options,
+.Cm off
+is the default value.
+None of these options can be used in the asynchronous mode,
+except for the
 .Cm debug
 option.
 .Bl -tag -width indent
 .It Sm Cm port No = Bro Cm rs232 , v35 , rs449 Brc Sm
-Set port type for old Sigma models.
+Set the port type for old Sigma models.
 .It Sm Cm cfg No = Bro Cm A , B , C Brc Sm
-Set configuration for the adapter.
-This option could be set only for Tau/E1
-and Tau/G703 and only if all channels are not running.
+Set the configuration for the adapter.
+This option can be used only with Tau/E1
+and Tau/G703 adapters, and only if all channels are free.
 .Bl -tag -width ".Cm cfg Ns = Ns Cm A"
 .It Cm cfg Ns = Ns Cm A
 Two independent E1/G703 channels.
-This is default setting.
+This is the default setting.
 .It Cm cfg Ns = Ns Cm B
 (Only for ISA models.)
-For Tau/G703 this mean one G703 channel and one digital channel.
-For Tau/E1 first physical channel divides on to subchannels.
-One of them
-goes to the first logical channel and another one goes to the second physical
-channel.
-Second (logical) channel is digital channel.
+For Tau/G703 this means one G703 channel and one digital channel.
+For Tau/E1, the first physical channel is divided into two subchannels.
+One of them goes to the first logical channel, another one goes to the
+second physical channel.
+Second (logical) channel is the digital channel.
 .It Cm cfg Ns = Ns Cm C
-This configuration is used only for E1 models.
-In this case first
+(Only for E1 models.)
+In this mode, first
 physical channel consists of three data flows.
-Two of them go to two
-(logical) channels.
+Two of them go to the two (logical) channels.
 The last one goes to the second physical channel.
-On new
-models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1) this configuration means single source
-of synchronization and passing all unused (in both channels) timeslots from
-one channel to other.
+On newer models (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1),
+this programs the hardware to use a single source of synchronization
+and pass all unused (in both channels) timeslots from
+one channel to another.
 .El
 .Pp
-For the detailed description of the configuration see
-your documentation to the adapter.
-This option could not be set on running
-channel.
+For a detailed description of available configuration modes,
+see the adapter documentation.
+This option cannot be set on a busy channel.
 .It Sm Cm loop No = Bro Cm on , off Brc Sm
 Turn on/off internal loopback.
-This mode is useful for testing.
-Switch on this
-option and try to send something.
-If you have no any interrupt, than, probably,
-you forgot to switch using IRQ for PCI to ISA bus.
-Check your BIOS settings.
+This mode is useful for debugging.
+When this mode is
+.Cm on ,
+some data should be sent.
+If no interrupts are generated, chances are that
+the corresponding IRQ configuration entry in the BIOS
+was not switched from
+.Dq Li "PCI/ISA PNP"
+to
+.Dq Li "Legacy ISA" .
 .It Sm Cm rloop No = Bro Cm on , off Brc Sm
 (Only for Tau32-PCI and Tau-PCI/E3.)
-Turn on/off remote loopback.
-This mode is also useful for testing.
+Turn on/off remote loopback feature.
+This mode is also useful for debugging.
 .It Sm Cm dpll No = Bro Cm on , off Brc Sm
 Turn on/off digital phase locked loop mode (DPLL).
 When enabled, the receiver
 timing clock signal is derived from the received data.
-Must be used with NRZI
-encoding, to avoid the synchronization loss.
+Must be used with the NRZI
+encoding to avoid the synchronization loss.
 .It Sm Cm nrzi No = Bro Cm on , off Brc Sm
-Turn on/off nrzi encoding.
-In off state nrz encoding is used.
+Turn on/off NRZI encoding.
+If
+.Cm off ,
+NRZ encoding is used.
 .Bl -tag -width "NRZI"
 .It NRZ
-the zero
-bit is transmitted by the zero signal level, the one bit - by the positive
-signal level.
+The zero bit is transmitted by the zero signal level,
+the one bit is transmitted by the positive signal level.
 .It NRZI
-the bit number zero is transmitted by the change of the
-signal level, the one bit - by the constant signal level.
-.El
-.Pp
-Commonly is used with
+The zero bit is transmitted by the change of the signal
+level, the one bit is by the constant signal level.
+Commonly used with the
 .Cm dpll Ns = Ns Cm on
 option.
+.El
 .It Sm Cm invclk No = Bro Cm on , off Brc Sm
-Invert the both transmit and receive clock signals (Tau and Tau-PCI only).
+(Tau and Tau-PCI only.)
+Invert both the transmit and receive clock signals.
 .It Sm Cm invrclk No = Bro Cm on , off Brc Sm
-Invert the receive clock signals (Tau-PCI only).
+(Tau-PCI only.)
+Invert the receive clock signals.
 .It Sm Cm invtclk No = Bro Cm on , off Brc Sm
-Invert the transmit clock signals (Tau-PCI only).
+(Tau-PCI only.)
+Invert the transmit clock signals.
 .It Sm Cm higain No = Bro Cm on , off Brc Sm
-Turn on/off increasing the E1 receiver non linear sensitivity to -30 dB (E1
-only).
+(E1 only.)
 In of state the sensitivity is -12 dB.
-This allows increasing line
-distance.
+Turn on/off increasing the E1 receiver's non-linear sensitivity to -30dB.
+This allows increasing of the line distance.
 .It Sm Cm cablen No = Bro Cm on , off Brc Sm
-(Only for Tau-PCI/T3 and Tau-PCI/STS-1.)
-Turn on/off adjusting transmit signal for long cable T3/STS-1.
+(Tau-PCI/T3 and Tau-PCI/STS-1 only.)
+Turn on/off adjusting of the transmit signal for a long cable T3/STS-1.
 .It Sm Cm monitor No = Bro Cm on , off Brc Sm
-Turn on/off increasing the E1 receiver lines sensitivity to -30 dB.
 (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
-This could be used for interception
-purposes.
+Turn on/off increasing of the E1 receiver's linear sensitivity to -30dB.
+This can be used for the interception purposes.
 .It Sm Cm phony No = Bro Cm on , off Brc Sm
-Turn on/off the so-called phony mode.
 (Tau32-PCI and Tau-PCI E1 family only.)
+Turn on/off the so-called
+.Dq phony
+mode.
 This mode allows
-receiving raw CEPT frames from E1 line.
-Raw frames could be accessed, for
-example, via raw protocol.
-Packets would come at rate of 500 frames per second
+receiving raw CEPT frames from the E1 line.
+Raw frames can be accessed, for example, with the raw protocol.
+Packets would come at a rate of 500 frames per second
 with length
 .No 16* Ns Ar N
 (for Tau-PCI/E1 model), where
 .Ar N
 is the number of timeslots.
 For
-Tau-PCI/2E1 and Tau-PCI/4E1 N should be equal to 32 independently from number of
+Tau-PCI/2E1 and Tau-PCI/4E1,
+.Ar N
+should be equal to 32 regardless of the number of
 used timeslots.
 .It Sm Cm unfram No = Bro Cm on , off Brc Sm
-Turn on/off unframed mode.
 (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
+Turn on/off unframed mode.
 .Bl -tag -width ".Cm unfram Ns = Ns Cm off"
 .It Cm unfram Ns = Ns Cm on
-switches channel to unframed G.703 mode.
+Switch channel to the unframed G.703 mode.
 .It Cm unfram Ns = Ns Cm off
-switches channel to framed E1 (G.704 mode).
+Switch channel to the framed E1 (G.704) mode.
 .El
 .It Sm Cm scrambler No = Bro Cm on , off Brc Sm
-Turn on/off the scrambling of G.703 data.
-(Tau32-PCI, Tau-PCI/G.703 and Tau-PCI/2E1,
+(Tau32-PCI, Tau-PCI/G.703, Tau-PCI/2E1, and
 Tau-PCI/4E1 in unframed mode only.)
+Turn on/off scrambling of the G.703 data.
 .It Sm Cm use16 No = Bro Cm on , off Brc Sm
-Turn on/off the usage of 16-th timeslot for data transmission.
 (Tau32-PCI and Tau-PCI E1 family only.)
-Normally 16th timeslot is used for signaling information (multiframing CAS).
+Turn on/off the usage of the 16th timeslot for data transmission.
+Normally, the 16th timeslot is used for signalling information
+(multiframing CAS).
 .It Sm Cm crc4 No = Bro Cm on , off Brc Sm
-Turn on/off CRC4 superframe mode.
 (E1 only.)
+Turn on/off CRC4 superframe mode.
 .It Sm Cm syn No = Bro Cm int , rcv , rcv0 , rcv1 , rcv2 , rcv3 Brc Sm
 .Bl -tag -width ".Cm rcv3"
 .It Cm int
-use an internal clock generator for G703 transmitter
+Use an internal clock generator for G703 transmitter
 (clock master).
 .It Cm rcv
-use the G703 receiver data clock as the transmit clock
+Use the G703 receiver data clock as the transmit clock
 (clock slave).
 .It Cm rcv0 , rcv1 , rcv2 , rcv3
-use the G703 receiver clock of the other channel
+Use the G703 receiver clock of the other channel
 (E1 models only).
 .El
 .It Cm dir Ns = Ns Ar number
-Binds logical channel to the physical channel.
 (Tau32-PCI, Tau-PCI/2E1 and Tau-PCI/4E1 only.)
-Using this parameter you could, for example, split E1 physical channel
-into several channels.
+Bind a logical channel to a physical channel.
+Using this parameter it is possible, for example, to split
+physical E1 channel into several logical channels.
 .It Cm ts Ns = Ns Ar interval
-Set up the list of timeslots to use by the channel (E1 only).
-The
-timeslots are numbered from 1 to 31, and are separated by comma or minus sign,
+(E1 only.)
+Set up the list of timeslots for use by the channel.
+The timeslots are numbered from 1 to 31,
+and are separated by a comma or a minus sign,
 giving an interval.
-For example:
+Example:
 .Dq Li ts=1-3,5,17 .
 .It Cm pass Ns = Ns Ar interval
+(Tau/E1 only.)
 Set up the list of timeslots, translated to the E1 subchannel in
 .Cm cfg Ns = Ns Cm B
 and
 .Cm cfg Ns = Ns Cm C
 configurations.
-(Tau/E1 only.)
 .It Sm Cm debug No = Bro Cm 0 , 1 , 2 Brc Sm
 Turn on/off debug messages.
 .Bl -tag -width 2n
 .It Cm 0
-turn off debug messages.
+Turn debug messages off.
 .It Cm 1
-turn on debug
-messages, equal to the
+Turn debug messages on, equivalent to the
 .Cm debug
-option to the
+option of the
 .Xr ifconfig 8
 utility.
 .It Cm 2
-high intensive debug message, developers only.
+High intensive debug messages, for developers only.
 .El
 .El
 .\"--------------------------------------------------------------
 .Sh EXAMPLES
-Set up the channel 1 for use with the HDSL modem or any other
+Set up channel 1 for use with the HDSL modem or any other
 synchronous leased-line modem, and PPP/HDLC protocol (for Sigma):
 .Bd -literal -offset indent
 sconfig cx1 ppp extclock
 ifconfig cx1 158.250.244.2 158.250.244.1 up
 .Ed
 .Pp
-Set up the channel 0 of Tau/E1 for use with the Cisco protocol
-over E1 link, with the single virtual connection.
+Set up channel 0 of Tau/E1 for use with the Cisco protocol
+over the E1 link, with a single virtual connection.
 The DLCI number is detected automatically.
 Use timeslots 1-10:
 .Bd -literal -offset indent
@@ -414,14 +442,14 @@ sconfig ct0 cisco ts=1-10
 ifconfig ct0 158.250.244.2 158.250.244.1 up
 .Ed
 .Pp
-Set up the channel 0 for the synchronous null-modem link to the nearby computer,
+Set up channel 0 for the synchronous null-modem link to the nearby computer,
 internal clock source, 256000 bits/sec, protocol Cisco/HDLC (for Tau):
 .Bd -literal -offset indent
 sconfig ct0 cisco 256000
 ifconfig ct0 200.1.1.1 200.1.1.2 up
 .Ed
 .Pp
-Set up the channel 1 for the leased line link using data-only
+Set up channel 1 for the leased line link using the data-only
 null-modem cable (or modems like Zelax+ M115).
 Synchronous DPLL mode, 128000
 bits/sec, protocol PPP/HDLC, NRZI encoding (for Sigma):
@@ -431,56 +459,59 @@ ifconfig cx1 158.250.244.2 158.250.244.1 up
 .Ed
 .\"--------------------------------------------------------------
 .Sh DIAGNOSTICS
-This section contains description of abbreviations used by
+This section contains a description of abbreviations used by
 .Nm
 while displaying various statistics.
-For description of options connected with
-statistics see above.
+For a description of options related to
+statistics, please see above.
 .\"--------------------------------------------------------------
 .Ss Statistics
-When running, the driver gathers the statistics about the channels, which
-could be accessed via the
+When running, the driver gathers statistics about the channels, which
+can be accessed using the
 .Nm
-utility or by
+utility,
+or through the
 .Xr ioctl 2
 call
 .Dv SERIAL_GETSTAT .
-.Bl -tag -width indent
+.Pp
+.Bl -tag -width indent -compact
 .It Va Rintr
-The total number of receive interrupts.
+Total number of receive interrupts.
 .It Va Tintr
-The total number of transmit interrupts.
+Total number of transmit interrupts.
 .It Va Mintr
-The total number of modem interrupts.
+Total number of modem interrupts.
 .It Va Ibytes
-The total bytes received.
+Total bytes received.
 .It Va Ipkts
-The total packets received (for HDLC mode).
+Total packets received (for HDLC mode).
 .It Va Ierrs
-The number of receive errors.
+Number of receive errors.
 .It Va Obytes
-The total bytes transmitted.
+Total bytes transmitted.
 .It Va Opkts
-The total packets transmitted (for HDLC mode).
+Total packets transmitted (for HDLC mode).
 .It Va Oerrs
-The number of transmit errors.
+Number of transmit errors.
 .El
 .\"--------------------------------------------------------------
 .Ss E1/G.703 Statistics
-For E1 and G.703 channels the SNMP-compatible statistics data are gathered
+For E1 and G.703 channels, the SNMP-compatible statistics data are gathered
 (see RFC 1406).
-It could be accessed via the
+It can be accessed using the
 .Nm
-utility or by
+utility,
+or through the
 .Xr ioctl 2
 call
 .Dv SERIAL_GETESTAT .
-.Bl -tag -width indent
+.Bl -tag -width ".Va RCRC Pq Va rcrce"
 .It Va Unav Pq Va uas
-Unavailable seconds - receiving all ones, or loss of carrier, or loss of
+Unavailable seconds: receiving all ones, loss of carrier, or loss of
 signal.
 .It Va Degr Pq Va dm
-Degraded minutes - having error rate more than 10e-6, not counting unavailable
+Degraded minutes: having error rate more than 10E-6, not counting unavailable
 and severely errored seconds.
 .It Va Bpv Pq Va bpv
 HDB3 bipolar violation errors.
@@ -491,29 +522,30 @@ CRC4 errors (E1).
 .It Va RCRC Pq Va rcrce
 Remote CRC4 errors: E-bit counter (E1).
 .It Va Err Pq Va es
-Errored seconds - any framing errors, or out of frame sync, or any slip events.
+Errored seconds: any framing errors, or out of frame sync, or any slip events.
 .It Va Lerr Pq Va les
-Line errored seconds - any BPV.
+Line errored seconds: any BPV.
 .It Va Sev Pq Va ses
-Severely errored seconds - 832 or more framing errors, or 2048 or more bipolar
+Severely errored seconds: 832 or more framing errors, or 2048 or more bipolar
 violations.
 .It Va Bur Pq Va bes
-Bursty errored seconds - more than 1 framing error, but not severely errored.
+Bursty errored seconds: more than 1 framing error, but not severely errored.
 .It Va Oof Pq Va oofs
-Severely errored framing seconds - out of frame sync.
+Severely errored framing seconds: out of frame sync.
 .It Va Slp Pq Va css
-Controlled slip second \[em] any slip buffer overflow or underflow.
+Controlled slip seconds: any slip buffer overflow or underflow.
 .El
 .\"--------------------------------------------------------------
 .Ss E1/G.703 Status
 The
 .Nm
 utility also prints the E1/G.703 channel status.
-The status could have the
-following values (nonexclusive):
-.Bl -tag -width indent
+The status can have the
+following values (non-exclusive):
+.Pp
+.Bl -tag -width ".Li FARLOMF" -compact
 .It Li Ok
-The channel is in valid state, synchronized.
+The channel is in a valid state, synchronized.
 .It Li LOS
 Loss of sync.
 .It Li AIS
@@ -525,7 +557,7 @@ Loss of multiframing (E1 only).
 .It Li FARLOF
 Receiving remote alarm (E1 only).
 .It Li AIS16
-Receiving all ones in timeslot 16 (E1 only).
+Receiving all ones in the timeslot 16 (E1 only).
 .It Li FARLOMF
 Receiving distant multiframe alarm (E1 only).
 .It Li TSTREQ
@@ -543,33 +575,33 @@ Test error (G.703 only).
 .Xr spppconrol 8
 .\"--------------------------------------------------------------
 .Sh HISTORY
-This utility is a replacement of utilities
+This utility is a replacement for the
 .Nm cxconfig
 and
 .Nm ctconfig
-that was used in past with
+utilities that were used in the past with
 .Fx
 drivers.
-Those two utilities and the present
-utility are not compatible.
-And therefore all scripts should be rewritten.
-More over,
+Those two utilities and
+.Nm
+are not compatible,
+and therefore all scripts using them have to be rewritten.
+Moreover,
 .Tn Linux
 and
 .Fx
-version of present utility not fully compatible.
-.\"--------------------------------------------------------------
-.Sh BUGS
-All software produced by Cronyx Engineering is thoroughly tested.
-But
-as created by the man it can contain some bugs.
-If you have caught one, try to localize it and send a letter with description
-of this bug and all operation that you have done.
-We will try to reproduce
-an error and fix it.
+versions of the
+.Nm
+utility are not fully compatible.
 .\"--------------------------------------------------------------
-.Sh CONTACT
-E-mail:
-.Aq info@cronyx.ru
+.Sh AUTHORS
+.An Cronyx Engineering Aq info@cronyx.ru
 .Pp
 .Pa http://www.cronyx.ru
+.\"--------------------------------------------------------------
+.Sh BUGS
+All software produced by Cronyx Engineering is thoroughly tested.
+But as created by a man, it can contain some bugs.
+If you have caught one, try to localize it and send an email with the
+description of the bug, and all operations that you have done.
+We will try to reproduce the error and fix it.