commenting of methods now indicates return values, expand comments