hap2 update (warning: compat breakage; see below)

hap2 code and docs have been fixed up and updated.  Note that the core
algorithm has changed subtly and the output of this version will not be
the same as the output of the previous one (one commit ago).