big-code-analysis-ast 2.5.1

Parse and classification layer behind big-code-analysis (internal, version-locked)
Documentation
//! Ccomment's role rows. The C-family comment-stripping helper grammar
//! recognises comments and string literals (`checker/ccomment.rs`), so
//! `StringLit` is declared and the two comment rows are pending the
//! packages that declare them; every other role names a construct the
//! grammar cannot emit.

use crate::{Ccomment, role_table};

role_table! {
    lang: Ccomment;
    Call { absent "the comment-stripping pass parses only comments and the string literals it must \
         not strip; it emits no such construct" }
    // The literals the pass must not strip or read into: `find string`
    // and the byte-less `is_string` both read this kind table (#1698).
    StringLit { owns [StringLiteral, RawStringLiteral] }
    Comparison { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    ShortCircuit { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    EagerLogical { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    Ternary { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    NullSafe { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    CaseArm { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Guard { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Branch { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Switch { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Loop { absent "the comment-stripping pass parses only comments and the string literals it must \
         not strip; it emits no such construct" }
    Catch { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    ElseIf { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Exit { absent "the comment-stripping pass parses only comments and the string literals it must \
         not strip; it emits no such construct" }
    Modifier { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    DeclKeyword { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    Primitive { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    FuncOpener { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    Closure { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Container { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    Member { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    // The one comment kind the pass parses; nothing documents here,
    // so `is_comment` is this row's kind table alone (#1699).
    Comment { owns [Comment] }
    DocComment { absent "the comment-stripping pass reads no documentation; a comment is text to elide" }
    Docstring { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    DocTarget { absent "the comment-stripping pass parses only comments and the string literals it \
         must not strip; it emits no such construct" }
    DocRunOpener { absent "the comment-stripping pass parses only comments and the string literals \
         it must not strip; it emits no such construct" }
    DocRunDirective { absent "the comment-stripping pass parses only comments and the string \
         literals it must not strip; it emits no such construct" }
    DocBodyResidual { absent "the comment-stripping pass parses only comments and the string \
         literals it must not strip; it emits no such construct" }
}