Assorted API cleanup

I've added doc comments to each of the exposed methods. Additionally,
methods that call functions returning a MagickBooleanType now correctly
propagate their return type.