Function phpdoc_clean

internal/cbm/lsp/php_lsp.c:494–525

Strip leading "/**", trailing "*​/", and per-line "*" prefixes. Returns a * mutable arena-allocated cleaned copy. */

/* Strip leading "/**", trailing "*​/", and per-line "*" prefixes. Returns a
 * mutable arena-allocated cleaned copy. */
static char *phpdoc_clean(CBMArena *a, const char *raw) {
    if (!raw)
        return NULL;
    size_t n = strlen(raw);
    char *out = (char *)cbm_arena_alloc(a, n + 1);
    if (!out)
        return NULL;
    size_t w = 0;
    size_t i = 0;
    /* Skip leading /* and ** */
    while (i < n && (raw[i] == '/' || raw[i] == '*' || raw[i] == ' ' || raw[i] == '\t'))
        i++;
    bool at_line_start = false;
    for (; i < n; i++) {
        char c = raw[i];
        if (c == '\n') {
            out[w++] = ' ';
            at_line_start = true;
            continue;
        }
        if (at_line_start) {
            if (c == ' ' || c == '\t' || c == '*')
                continue;
            at_line_start = false;
        }
        out[w++] = c;
    }
    /* Trim trailing */ if (w >= 2 && out[w - 1] == '/' && out[w - 2] == '*')
        w -= 2;
    out[w] = '\0';
    return out;
}

/* (next_tag helper not currently needed — phpdoc parsers use strstr inline.) */