documentation, comments, output directory tweaked to work with a longer path