Update README; limit doxygen to html.

Linkify README.  Add docs discussing the gh-pages branch.
Stop generating man pages by default with doxygen as
usable man pages have already been extracted and
committed in man/.