build the docs.

being used. Update generate_docs script to ensure generated api docs are
always deleted and recreated every time script is run. Update some code
in the conf file.

when converting warnings to errors we do not see any errors.