major docstring additions, plus fix units in output files