Documentation of getters, as promised

These are the [promised documentation of the getters](https://github.com/pornel/pngquant/pull/71) which you kindly added to the library yesterday.

I also took the liberty of fixing some other things, e.g. documenting some undocumented error return values.