shithub: sox

--- a/sox.1

+++ b/sox.1

@@ -225,7 +225,8 @@

 .B play

 is not the one that is wanted, then the

 .B AUDIODRIVER

-environment variable can be used to override the default e.g. on many systems,

+environment variable can be used to override the default.  For example

+(on many systems):

.EX

 	set AUDIODRIVER=oss

 	play ...

@@ -233,7 +234,7 @@

For

 .BR rec ,

 .BR play ,

-or

+and

 .BR sox ,

the

 .B AUDIODEV

@@ -254,15 +255,14 @@

 .B set

 command may vary from system to system.)

.SP

-To set a suitable recording level, a V.U. meter is usually used.  SoX includes a

-simple V.U. meter that can be invoked as follows:

+To help with setting a suitable recording level, SoX includes a simple VU

+meter which can be invoked (before making the actual recording) as follows:

.EX

 	rec -n

.EE

-The recording level should be adjusted (using the system mixer program)

-so that the meter is `in the red' (a single exclamation mark is shown)

-\fIat most very occasionally\fR, and never `off the scale' (two

-exclamation marks are shown).

+The recording level should be adjusted (using the system mixer program) so

+that the meter is \fIat most occasionally\fR full scale, and never `in the

+red' (an exclamation mark is shown).

 .SS Accuracy

 Many file formats that compress audio discard some of the audio signal

 information whilst doing so; converting to such a format then converting

@@ -561,9 +561,9 @@

 Display input file format/header information and input file(s)

 processing progress in terms of elapsed/remaining time and percentage

 complete.

-Also displays the number of samples written to the output file, a V.U. meter,

+Also displays the number of samples written to the output file, a VU meter,

 and an indication if clipping has occurred.

-The V.U. meter shows up to two channels and is calibrated for digital

+The VU meter shows up to two channels and is calibrated for digital

 audio as follows:

.TS

 center box;

@@ -571,25 +571,26 @@

 cI lI lI

 r l l.

 dB FSD	Display

->=	(right channel)	Comment

-\-25.5	\-

-\-23.5	T{

+>=	(right channel)

+\-25	\-

+\-23	T{

T}

-\-21.5	=\-

-\-19.5	==

-\-17.5	==\-

-\-15.5	===

-\-13.5	===\-

-\-11.5	====

-\-9.5	====\-

-\-7.5	=====

-\-5.5	=====\-

-\-3.5	======

-\-1.5	=====!	`In the red'

-\-0.5	====!!	`Off the scale'

+\-21	=\-

+\-19	==

+\-17	==\-

+\-15	===

+\-13	===\-

+\-11	====

+\-9	====\-

+\-7	=====

+\-5	=====\-

+\-3	======

+\-1	=====!	`In the red'

.TE

+.SP

+A three-second peak-held value of headroom in dBs will be shown to the right

+of the meter if this is below 6dB.

.SP

 This option is enabled by default when using

 SoX to play or record audio.