Function parse 

pub fn parse(input: &str) -> ParseResult

Parse a SurfDoc string into a ParseResult.

This function never panics. Malformed input produces diagnostics and a best-effort SurfDoc.