explain pre-defined errors

closes #12