Skip to content

Docs: Regenerate capabilities-syntax AOT rows post-#568 #744

@PurHur

Description

@PurHur

Problem

#568 ✅ closed — phpc build --project examples/003-MiniWebApp links on master. Curated docs still say AOT execute is blocked #568:

  • script/capability-syntax-lib.php — rows for native user-class link, PATH_INFO, deploy includes, AOT CGI
  • docs/capabilities-syntax.md (generated) — same stale “blocked AOT: Native user-class object model for phpc build --project #568” notes
  • script/capability-matrix.php prose still references “blocked” for 003 execute

Contributors reading the matrix think link is open when execute gates (#676, #738) are the real remaining work.

Goal

After #568, regenerate capability docs so:

  1. Native user-class link row → AOT yes (lint + link), with execute note pointing to Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 / Testing: Enable examples-aot-smoke.sh 003-MiniWebApp slice (#676 step 3) #738 until smoke green
  2. PATH_INFO / template include / AOT CGI rows → distinguish lint vs execute (not blanket “blocked AOT: Native user-class object model for phpc build --project #568”)
  3. php script/capability-syntax-lib.php + php script/capability-matrix.php produce consistent output

Scope

Acceptance criteria

grep -R 'blocked #568' docs/capabilities-syntax.md script/capability-syntax-lib.php | wc -l
# local
# → 0 (or only historical “was blocked” in changelog comment)

php script/capability-syntax-lib.php --check   # if supported
./script/ci-fast.sh --filter CapabilitySyntax

Docker:

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./script/ci-fast.sh --filter CapabilitySyntax

Dependencies

Verification

Local/Docker only — not GitHub Actions.

Links

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions