'make clean' did not work at all. this fixes it.
delete obsolete files.
add in comments alternative implementations for various bit twiddling operations
remove obsolete test files and update Makefile accordingly.