fixed bug in new entry-map initialization code & added section to README

submitting to your branch to enable commit squashing!