added comments and invocations. test pending