[Docs] (MG_Backend/DirectGLES, MG_Backend/DirectVulkan, MG_Backend/Record, MG_Impl/Pipe, MG_IntegrationTest/Scenarios, MG_Pipe, MG_Remote/Client, MG_Remote/Server, MG_State/GLState, MG_Test, MG_Test/Backend, MG_Test/Buffer, MG_Test/Pipe, MG_Test/Wire, scripts, scripts/ci): cite symbols, not lines, in the split backend files

scripts/check_doc_citations.py

@@ -32,7 +32,7 @@ import sys
 
 REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 
-# `Managers.cpp:4340-4390`, `MobileGL/MG_State/.../RenderState.h:263`, `:12-13` is NOT
+# `File.cpp:123-456`, `MobileGL/MG_State/.../RenderState.h:263`, `:12-13` is NOT
 # matched on purpose: a citation with no file name cannot be checked, only guessed.
 CITATION_RE = re.compile(
     r"(?<![\w/.-])((?:[\w.-]+/)*[\w.-]+\.(?:h|hpp|cpp|cc|c|py|def|inc|md|json|yml|yaml|txt|fbs))"

scripts/ci/fatal_census.py

@@ -58,7 +58,7 @@ prose is why that map reads the way it does.
         They carry their family word today, which is the point of widening the perimeter: the
         census can SEE them now, and the ratchet makes retiring one visible.
   (iii) NAMED, BUT NOT SESSION-SCOPED - Init.cpp's ConsumerMaskLie pair, MagmaPipeArms.h's and
-        Managers.cpp's PipeLegacyMemosDisabled, DirectGLES.cpp:227's UnnamedIdentity,
+        Managers.cpp's PipeLegacyMemosDisabled, DirectGLES.cpp's former UnnamedIdentity,
         PipeFill.cpp's PipeVerify knob parser. Startup and role self-checks that predate the
         split: they die BEFORE a session exists, so routing them through SessionFail would
         publish a SessionFault to a peer that has not connected. They are named, which is what

scripts/p4a_descriptor_negative_control.sh

@@ -28,7 +28,7 @@
 #
 #   1. MGPSurface::Layered stops being copied in MG_Impl/Pipe/FramebufferEmit.h. A layered
 #      attachment travels as a non-layered one, which is the shape that turns a whole-array render
-#      target into slice 0 - and SupportsLayeredImageBinding's rule (DirectGLES.cpp:1992-2013,
+#      target into slice 0 - and SupportsLayeredImageBinding's rule (DirectGLESTextures.cpp,
 #      D-O) forces `layer` to 0 for a non-layerable target, so the wrong answer is silently
 #      plausible rather than an error. It is also the field with the least other coverage: the
 #      surface's Res, Level and Layer are all still right, so nothing about the ATTACHMENT changes

scripts/p4a_untouched_regions.sh

@@ -47,9 +47,9 @@
 #   UnpackRingAllocate             Managers.cpp: on the hot upload route
 #   RecomputeBackendColorSlots     Managers.cpp: the attachment permutation - three passes plus the
 #                                  forced ~0 version memo on every moved attachment; removing the
-#                                  empty-point detach breaks the invariant (Managers.cpp:7651-7658)
+#                                  empty-point detach breaks the invariant (SyncToBackendByHandle)
 #   DepthStencilSamplingReadImpl   DirectGLES.cpp: the D24S8 sampling-emulation core (memory
-#                                  better-clouds-fullmode), entered from :8617 and :8721
+#                                  better-clouds-fullmode), entered from its two Read*Native callers
 #   ShouldUseCaveatTextureFormat   Utils.cpp: the format handler P4a's InternalFormat descriptors
 #                                  feed; a change here silently changes what every texture is
 #                                  allocated as
@@ -60,7 +60,7 @@
 #   1. A PER-REGION SOURCE PATH. The parent's SOURCE_PATH is a single file (:85); the seventeen live
 #      in three. Each row below carries its own path and the extractor reads each file once.
 #   2. A REGION KIND. [declared deviation, see DEVIATIONS below] Sixteen of the seventeen are
-#      FUNCTIONS. `DepthStencilSamplingReadImpl` is a NAMESPACE (DirectGLES.cpp:8117-8578) - the
+#      FUNCTIONS. `DepthStencilSamplingReadImpl` is a NAMESPACE (in DirectGLESReadback.cpp) - the
 #      brief's D-N table names it as though it were a function, and the parent's extractor, which
 #      finds a definition as the one `<name> (` whose closing paren is followed by `{`, finds ZERO
 #      definitions of it and exits 2 forever. Hashing the whole namespace block is also the
@@ -330,7 +330,7 @@ def find_function(text, masked, name):
 def find_namespace(text, masked, name):
     """Every (begin, end) at which `name` is DEFINED as a namespace.
 
-    P4a's DepthStencilSamplingReadImpl is a namespace, not a function (DirectGLES.cpp:8117-8578):
+    P4a's DepthStencilSamplingReadImpl is a namespace, not a function (in DirectGLESReadback.cpp):
     the D24S8 sampling-emulation CORE is the whole block, and a function-shaped search finds no
     definition of it at all. The closing `} // namespace <name>` comment is masked away by the
     time this runs, so the extent is decided by brace matching exactly as a function's is - and a