some commentary; code formatting