hash.c: More cleanup, documentation.

Only important functionality change is
that the <num_threads> argument is now optional,
and if unspecified defaults to the number
of online processors per sysconf.
Move documentation into README.md for github.