CNA-BUG-229: docs/graphics-renderer-feature-matrix.md calls itself up to date but still lists EasyGL's ReferenceStencil test as a known failure, contradicting its own table row

CNA snapshot 3b43bd86  ·  Known Issues › Current bugs  ·  source links pinned to 3b43bd86

The matrix's ReferenceStencil row says EasyGL passes (remeasured 2026-09-09), but its failure baseline still lists the test, although EasyGL was fixed on 2026-08-29.

Identifier

CNA-BUG-229

Category

Bug

Subsystem

Documentation & release tooling

Status

Narrowed (partially fixed; describes only what survives)

Verified against

CNA 3b43bd86 (3b43bd8687ed46523d873f9bec4b32bd8481dcb5)

Severity

Low (a triage suggestion, not a project priority)

Evidence basis

Source-verified: read at TARGET, not executed

Tests touching this area

Yes: see Current tests

Affected contract

docs/graphics-renderer-feature-matrix.md ('Master, up-to-date cross-renderer feature matrix') and the documented status of GraphicsDevice::setReferenceStencilProperty on the EasyGL family

Expected behaviour

A matrix that labels itself "Master, up-to-date" should carry one status per feature and renderer. For GraphicsDevice.ReferenceStencil on EasyGL that status is fixed: REMED-GFX-236 (closed 2026-08-29 in plans/plan_postaudit.md) made EasyGLRenderer::SetReferenceStencil reissue the stencil function with the new reference, recording "1 FAIL - 2 PASS" for the test with a three-way mutation check, and rewrote the test's header accordingly.

Actual behaviour at TARGET

docs/graphics-renderer-feature-matrix.md, which opens by calling itself the “Master, up-to-date cross-renderer feature matrix”, says both things. Its GraphicsDevice.ReferenceStencil row: “shared stamp/test fixture passes on EasyGL (GraphicsDevice_ReferenceStencil, remeasured 2026-09-09)”. Its “Known pre-existing test-failure baseline” still lists for EasyGL “3 - EasyGL_MRT_TwoAttachments, EasyGL_GraphicsDevice_ReferenceStencil, easy-gl-resource-smoke-tests”.

Source locations

• docs/graphics-renderer-feature-matrix.md — header label; ReferenceStencil row; Known pre-existing test-failure baseline
• modules/renderers/easygl/src/EasyGLRenderer.cpp — EasyGLRenderer::SetReferenceStencil
• modules/renderers/easygl/examples/easygl_graphicsdevice_reference_stencil_test.cpp — header: the fix history and the exit-code contract
• plans/plan_postaudit.md — REMED-GFX-236 record, closed 2026-08-29

Evidence

Checked by reading at 3b43bd86; the test was not run here, so that it passes rests on CNA's own record (REMED-GFX-236, the matrix row, and the 2026-10-10 re-verification recorded when the CI allowlist was removed). Whether EasyGL_MRT_TwoAttachments and easy-gl-resource-smoke-tests, the other two names in the EasyGL baseline, still fail at TARGET was not checked; the unfiltered CI job does not tolerate them.

Narrowed at c6dec91f: e1ef12093 (2026-10-10) corrected the EasyGL registration comment that called the test “a documented known failure”, and the matrix's bottom line that called the gap open went with the retired renderer column it belonged to. The failure baseline and the plan row are unchanged.

Narrowed at 3b43bd86: f279a845e deleted plans/plan_graphics.md after checking its last open rows against the code, ReferenceStencil (Task 872) among them; docs/graphics-renderer-feature-matrix.md changed only in its plan references and still lists EasyGL_GraphicsDevice_ReferenceStencil in the EasyGL baseline. Not executed.

Focused reproduction

No focused reproduction is known. Nothing has been invented here; the evidence above is what exists.

Current tests

EasyGL_GraphicsDevice_ReferenceStencil (single-sided and two-sided legs), its SOFTWARE counterpart, and GraphicsDevice_ReferenceStencil in the DirectX 9 parity corpus. The test exists; the defect is in the records around it.

Regression test

No new test: remove the test from the matrix's EasyGL failure baseline.

Blast radius

Readers of the matrix; no behaviour is affected.

Workaround

Trust the table row and plans/plan_postaudit.md section 33 over the later sections.