doc. parsing. Improve on diagnostics on my last patch.
// rdar://13094352.