move section about cleaning out dumb files
clarify files written as output
move all parameter processing into try
move all parameter processing into try