add clarifying comments
remove obsolet error codes and messages