Missing documentation for some of the image function

[sn6uv]

#482 was missing some documentation and tests.

[sn6uv]

Improved by #541 but still a couple of things to fix (tests to write).