added better comments to message definitions