tweak compilation failure output
preliminary docs for convert