First real readthrough

Questions, missing file, todo, optimization options. All comments signed
"--mhs"
Outlining the event detector