Fix documentation of entropy function

Improvement following comments from @efiring