ref: 9b42d100cd7cf7512e88055def24d0bb095fbbbe
parent: 53d9fc8057e943e2d724720b3491d22284ac1d26
author: robs <robs>
date: Sun Apr 26 08:22:56 EDT 2009
order these options alphabetically
--- a/sox.1
+++ b/sox.1
@@ -708,6 +708,26 @@
Don't prompt before overwriting an existing file with the same name as that
given for the output file. This is the default behaviour.
.TP
+\fB\-D\fR, \fB\-\-no\-dither\fR
+Disable automatic dither on bit-depth reduction.
+By default, SoX automatically invokes the dither effect (with TPDF)
+in the following circumstances:
+bit-depth reduction has been specified explicitly using a
+command-line option, the output file format supports only bit-depths
+lower than that of the input file format, or, as is the case with
+many effects, effects processing has increased bit-depth within the
+effects processing chain (e.g.
+.B vol 0.25
+requires two additional bits in which to losslessly store its
+results; in order to store the output at the same depth as the input,
+dithering is used to remove the additional bits).
+.SP
+See also
+.B \-V
+and the
+.B dither
+effect.
+.TP
\fB\-\--effects\-file=\fIFILENAME\fR
Use FILENAME to obtain all effects and their arguments.
The file is parsed as if the values were specified on the
@@ -763,26 +783,6 @@
If SoX has been built with the optional `libmagic' library, then this
option can be given to enable its use in helping to detect audio file types.
.TP
-\fB\-D\fR, \fB\-\-no\-dither\fR
-Disable automatic dither on bit-depth reduction.
-By default, SoX automatically invokes the dither effect (with TPDF)
-in the following circumstances:
-bit-depth reduction has been specified explicitly using a
-command-line option, the output file format supports only bit-depths
-lower than that of the input file format, or, as is the case with
-many effects, effects processing has increased bit-depth within the
-effects processing chain (e.g.
-.B vol 0.25
-requires two additional bits in which to losslessly store its
-results; in order to store the output at the same depth as the input,
-dithering is used to remove the additional bits).
-.SP
-See also
-.B \-V
-and the
-.B dither
-effect.
-.TP
\fB\-\-no\-clobber\fR
Prompt before overwriting an existing file with the same name as that
given for the output file.
@@ -898,6 +898,11 @@
This option is enabled by default when using
SoX to play or record audio.
.TP
+\fB\-\-single-threaded\fR
+On some hyper-threading/multi-core architectures,
+SoX has support for parallel effects channel processing.
+This option can be given to disable parallel processing.
+.TP
\fB\-\-temp\fI DIRECTORY\fR
Specify that any temporary files should be created in the given
.IR DIRECTORY .
@@ -907,11 +912,6 @@
.TP
\fB\-\-version\fR
Show SoX's version number and exit.
-.TP
-\fB\-\-single-threaded\fR
-On some hyper-threading/multi-core architectures,
-SoX has support for parallel effects channel processing.
-This option can be given to disable parallel processing.
.IP \fB\-V\fB[\fIlevel\fB]\fP
Set verbosity\*mthis is particularly useful for seeing how any automatic
effects have been invoked by SoX.