doc: clarify meaning of --average