include run.n in repository so it's easier to use
clarified --recursive flag
some restructuring and documentation