drop trailing whitespace
move limitations to README, some minor style, minor tuple usage fixes