Fix documentation of entropy function

Fix the documentation of the entropy function to correct the formula so
it reflects the calculation used in the code. Also mention the unit of
the value returned,

See also this stackoverflow question: [Matplotlib mlab entropy calculation incorrect?](http://stackoverflow.com/questions/23291576/matplotlib-mlab-entropy-calculation-incorrect)