# HG changeset patch
# User cigaes
# Date 1331112008 0
# Node ID e5783b2a88f0051aec7d98176deb062877da41da
# Parent  6e0aeeb6cdc48cb032548aa720e3968f6c18817d
af_stats: document the meaning of the output.

diff -r 6e0aeeb6cdc4 -r e5783b2a88f0 DOCS/man/en/mplayer.1
--- a/DOCS/man/en/mplayer.1	Mon Mar 05 18:14:38 2012 +0000
+++ b/DOCS/man/en/mplayer.1	Wed Mar 07 09:20:08 2012 +0000
@@ -6105,7 +6105,17 @@
 Collects and prints statistics about the audio stream, especially the volume.
 These statistics are especially intended to help adjusting the volume while
 avoiding clipping.
-The volumes are printed in dB and compatible with the volume audio filter.
+The volumes are printed in dB and compatible with the volume audio filter,
+they are always rounded towards -0dB.
+.sp 1
+The 'n_samples' field is the total number of samples seen by the filter.
+The 'mean_volume' field is the root mean square.
+The 'max_volume' field is exactly what it says.
+The 'histogram_Xdb fields count how many samples were at -XdB, for X just
+below max_volume.
+.sp 1
+For example, if max_volume is -7dB and histogram_7dB is 19, 'volume=7' will
+not cause clipping and 'volume=8' will cause clipping on exactly 19 samples.
 .
 .
 .