debug output reduction, new error documentation