public IEnumerable <Paragraph> Parse(IDocCommentBlockNode blockNode)
        {
            // Create a lexer which can read the comment
            XmlCommentReflowableBlockLexer lexer = new XmlCommentReflowableBlockLexer(blockNode);

            // Create a parser which can turn the comment into paragraphs and lines
            XmlCommentParagraphParser paragraphParser = new XmlCommentParagraphParser(lexer);

            // Firstly walk through the paragraphs and:
            // - collapse each one to the minimum number of required lines (tags always take a whole line at this stage).
            // - remove extra whitespace. There's no point in having it, it wont show in generated doco
            return(paragraphParser.Parse());
        }
 public XmlCommentParagraphParser(XmlCommentReflowableBlockLexer xmlBlockLexer)
 {
     _xmlBlockLexer = xmlBlockLexer;
 }