fix error message, in more detail
add doc.