Class CommentHandler::CommentVisitor

generator/commenthandler.cpp:155–285

}

struct CommentHandler::CommentVisitor : clang::comments::ConstCommentVisitor<CommentVisitor>  {
    typedef clang::comments::ConstCommentVisitor<CommentVisitor> Base;
    CommentVisitor(Annotator &annotator, Generator &generator, const clang::comments::CommandTraits &traits, clang::Sema &Sema)
        : annotator(annotator), generator(generator) , traits(traits), Sema(Sema) {}
    Annotator &annotator;
    Generator &generator;
    const clang::comments::CommandTraits &traits;
    clang::Sema &Sema;

    clang::NamedDecl *Decl = nullptr;
    std::string DeclRef;
    std::vector<std::pair<std::string, Doc>> SubDocs; // typically for enum values

    void visit(const clang::comments::Comment *C) {
        Base::visit(C);
        for (auto it = C->child_begin(); it != C->child_end(); ++it)
            visit(*it);
    }

    // Inline content.
    //void visitTextComment(const clang::comments::TextComment *C);
    void visitInlineCommandComment(const clang::comments::InlineCommandComment *C) {
        tag("command", C->getCommandNameRange());
        for (unsigned int i = 0; i < C->getNumArgs(); ++i)
            tag("arg", C->getArgRange(i));
    }
    void visitHTMLStartTagComment(const clang::comments::HTMLStartTagComment *C) {
        tag("tag", C->getSourceRange());
        /*for (int i = 0; i < C->getNumAttrs(); ++i) {
            auto attr = C->getAttr(i);
            tag("attr", attr.getNameRange());
        }*/
    }
    void visitHTMLEndTagComment(const clang::comments::HTMLEndTagComment *C) {
        tag("tag", C->getSourceRange());
    }

    // Block content.
    //void visitParagraphComment(const clang::comments::ParagraphComment *C);
    void visitBlockCommandComment(const clang::comments::BlockCommandComment *C) {
        auto nameRange = C->getCommandNameRange(traits);
        tag("command", {C->getLocStart(),  nameRange.getEnd().getLocWithOffset(-1)});
        for (unsigned int i = 0; i < C->getNumArgs(); ++i)
            tag("arg", C->getArgRange(i));
        if (C->getCommandName(traits) == "value")
            parseEnumValue(C);
    }
    //void visitParamCommandComment(const clang::comments::ParamCommandComment *C);
    //void visitTParamCommandComment(const clang::comments::TParamCommandComment *C);
    /*void visitVerbatimBlockComment(const clang::comments::VerbatimBlockComment *C) {
        Base::visitVerbatimBlockComment(C);
        FIXME
        // highlight the closing command
        auto end = C->getLocEnd();
        tag("arg", {end.getLocWithOffset(-C->getCloseName().size()) ,end});
    }*/
    void visitVerbatimBlockLineComment(const clang::comments::VerbatimBlockLineComment *C) {
        tag("verb", C->getSourceRange());