added more sensible descriptions and debug output