Write a proper README

Also documents some somewhat mis-leading filter code.