mall code review, and adding return value on the public functions that were lacking.