[pulseaudio-discuss] Wanted: native English speakers for review: [PATCH 5/5] man: sync_volume parameters to manual page

[Paul Menzel]

Am Mittwoch, den 13.10.2010, 19:40 +0300 schrieb oku at iki.fi:
> From: Jyri Sarha <jyri.sarha at nokia.com>
> 
> Signed-off-by: Jyri Sarha <jyri.sarha at nokia.com>
> Reviewed-by: Tanu Kaskinen <tanu.kaskinen at digia.com>

It would be great if some native English speakers could take a look at
the following sentences. Maybe David (CCed) has some time too.

I am giving it a shot too, but I do not know if everything is correct.

> ---
>  man/pulse-daemon.conf.5.xml.in |   26 ++++++++++++++++++++++++++
>  1 files changed, 26 insertions(+), 0 deletions(-)
> 
> diff --git a/man/pulse-daemon.conf.5.xml.in b/man/pulse-daemon.conf.5.xml.in
> index b5c9e92..ccc2db7 100644
> --- a/man/pulse-daemon.conf.5.xml.in
> +++ b/man/pulse-daemon.conf.5.xml.in
> @@ -437,6 +437,32 @@ USA.
>  
>    </section>
>  
> +  <section name="Default Sync Volume Settings">
> +
> +    <p>The flat volume feature sets the sink HW volume according to

according to *the*

> +    highest volume input stream and lowers the lower volume streams
> +    with SW volume. To make this concurrent use of SW and HW volume to
> +    work without a glitch their application needs to be
> +    synchronized. The sink implementation needs to support this
> +    feature in order to these parameters to take effect.</p>
> +
> +    <option>
> +      <p><opt>enable-sync-volume=</opt> Enable sync volume for the sinks that
> +      support it. This feature is enabled by default.</p>
> +    </option>
> +    <option>
> +      <p><opt>sync-volume-safety-margin-usec=</opt> The amount usecs the HW

amount *of* usecs

> +      volume increases are delayed and HW volume decreases are advanced. Defaults

As someone who does not have a clue, could that be a little bit more
elaborate explained. Why should increases be delayed?

Could an example be give and would it be useful?

> +      to 8000 usec.</p>
> +    </option>
> +    <option>
> +      <p><opt>sync-volume-extra-delay-usec=</opt> The amount usecs the

The amount *of* usesc

> +      all HW volume changes are delayed. Negative values are also allowed.

»the all«?

> +      Defaults to 0.</p>
> +    </option>
> +
> +  </section>
> +
>    <section name="Authors">
>      <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
>    </section>


Thanks,

Paul
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.freedesktop.org/archives/pulseaudio-discuss/attachments/20101014/2c1bc83d/attachment.pgp>