add whitelist filtering script
add some basic documentation
add *~ to gitignore