a little more documentation + whitespace changes