adjusted some panics, documented the rest.