Rename library to hap (Welsh for "random":-)

The rename is a precursor to placing the library on code.dlang.org.
Add .ddoc file with macros adapted from Phobos

The HAPSRC macro in particular will ensure that source links point to
the correct repository.
Documentation updates including migration instructions