Documentation should draw more attention to premultiplied alpha

[bgilbert]

A common application bug is to ignore the alpha channel and render premultiplied RGB directly to the display, leading to display errors which may not be immediately apparent. The API documentation assumes the user knows how to handle premultiplied alpha; perhaps we should be more explicit.