shithub: sox

Download patch

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.