COOPR-629
split exceptions / javadoc