Improve docs -- esp. thorough documentation of IBA.

Add a chapter to the main docs that fully document ImageBufAlgo.

Also some minor fixes and clarifications to comments in imagebufalgo.h

This does not need a "review", I'm just submitting it as a pull request so that people are alerted to a big docs change.