add Mac OS X detection details
add design spec and whitespace to README