mention more clearly the arguments and the return value
detect inability to open image file
Merge pull request #920 from r1chardj0n3s/master

Two changes; one doc, one bugfix