ref: 202042e2d8936d3daebfcef88f2f86806f2f9c43
parent: 58ab5ac87b86c897d9edd0cf6e8e98c0d6162bfb
author: Ulrich Klauer <ulrich@chirlu.de>
date: Mon Jan 7 20:37:11 EST 2013
ladspa: Update documentation
--- a/sox.1
+++ b/sox.1
@@ -2364,22 +2364,25 @@
.SP
This effect supports the \fB\-\-plot\fR global option.
.TP
-\fBladspa\fR [\fB-r\fR] \fBmodule\fR [\fBplugin\fR] [\fBargument\fR...]
+\fBladspa\fR [\fB-r\fR] \fImodule\fR [\fIplugin\fR] [\fIargument\fR ...]
Apply a LADSPA [5] (Linux Audio Developer's Simple Plugin API) plugin.
Despite the name, LADSPA is not Linux-specific, and a wide range of
effects is available as LADSPA plugins, such as cmt [6] (the Computer
Music Toolkit) and Steve Harris's plugin collection [7]. The first
argument is the plugin module, the second the name of the plugin (a
-module can contain more than one plugin) and any other arguments are
+module can contain more than one plugin), and any other arguments are
for the control ports of the plugin. Missing arguments are supplied by
-default values if possible. Only plugins which do not modify the channel
-count may be used. The
+default values if possible.
+.SP
+Normally, the number of input ports of the plugin must match the number
+of input channels, and the number of output ports determines the output
+channel count. However, the
.B \-r
-(repeat) option allows cloning a mono plugin to handle multi-channel
-effects chains.
+(replicate) option allows cloning a mono plugin to handle multi-channel
+input.
+.SP
If found, the environment variable LADSPA_PATH will be used as search
path for plugins.
-
.TP
\fBloudness\fR [\fIgain\fR [\fIreference\fR]]
Loudness control\*msimilar to the