more options, more defaults.
reader API fix and docs

add API docs.
more const strictness (PCXTex).
port the client code to the the new API.
API cleanup
cleanup
first docs