Reworked Paul's directory_entry hash function.

Added unit test for new hash function.
Added directory_entry_hash to docs.

Replaced all double dashes ("--") with proper emdashes.