mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-18 15:33:22 +09:00
[Docs] (.github/workflows, CMakeLists.txt, MG_Backend, MG_Backend/DirectGLES, MG_Backend/DirectVulkan, MG_Backend/MGPipe, MG_Backend/Record, MG_Impl/Pipe, MG_IntegrationTest, MG_IntegrationTest/Harness, MG_IntegrationTest/Scenarios, MG_Pipe, MG_Remote, MG_Remote/Client, MG_Remote/Server, MG_Remote/Transport, MG_Remote/Wire, MG_State/GLState, MG_Test, MG_Test/Buffer, MG_Test/Purity, MG_Test/Util, MG_Test/Wire, MG_Util/Metrics, MobileGL, scripts, tools/trace_replay): replace stale line-number citations with sections and symbols
This commit is contained in:
@@ -54,7 +54,7 @@ namespace MobileGL::MG_Remote {
|
||||
// bits 48..63 reserved.
|
||||
//
|
||||
// protocol.fbs:94's `tableSlotMask: ulong` is DELETED rather than renamed (R-8 offered
|
||||
// either). Two reasons, and the second is decisive: ARCHITECTURE.md:114 says CallMask
|
||||
// either). Two reasons, and the second is decisive: ARCHITECTURE.md §3.3 says CallMask
|
||||
// REPLACES "is this table slot null" as the capability probe, so a field whose comment is
|
||||
// "which GLFunctionsTable slots the peer registered" re-introduces exactly what it
|
||||
// replaced; and GLFunctionsTable has SIXTY-NINE function-pointer slots
|
||||
|
||||
@@ -417,7 +417,7 @@ namespace MobileGL::MG_Remote::Client {
|
||||
// AND THE NO-OP IS THE ONE THIS FRONTEND ALREADY GIVES for a fence it cannot wait on:
|
||||
// GL_Sync.cpp:103-106 answers GL_ALREADY_SIGNALED for a sync with no backend handle,
|
||||
// PipeApplier.cpp:175-177 answers GL_ALREADY_SIGNALED for a fence with no native
|
||||
// object (a fence that provably did no work), and DirectGLES.cpp:16489 does the same
|
||||
// object (a fence that provably did no work), and ClientWaitSync() in DirectGLES.cpp does the same
|
||||
// for an absent sync. A lost device is that same class of fact.
|
||||
//
|
||||
// WHAT ABORTING HERE COSTS, MEASURED: after a clean device loss Minecraft 26.2's next
|
||||
|
||||
@@ -48,7 +48,7 @@
|
||||
// (GL_Query.cpp:481, :785), BeginXfbPrimitivesQuery (:534), SubDataResident. With no null slot
|
||||
// in this table every one of them answers "supported" and the fallback behind it silently
|
||||
// disappears. A null check on a slot may not survive into the client: it becomes a caps-mirror
|
||||
// read, which is what ARCHITECTURE.md:114 means by "CallMask replaces 'is this table slot null'".
|
||||
// read, which is what ARCHITECTURE.md §3.3 means by "CallMask replaces 'is this table slot null'".
|
||||
//
|
||||
// NOTE the asymmetry this table does not resolve, AND WHERE IT IS RESOLVED (R-17): the
|
||||
// resource, CSO, framebuffer, texture, sampler and program families do NOT come through here.
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
// slot in the client's emit table - so in that table every one of those probes would answer
|
||||
// "supported", and whatever fallback sits behind it would silently disappear. That is not a
|
||||
// theoretical risk: it is how a split lane produces a plausible picture for the wrong reason.
|
||||
// ARCHITECTURE.md:114 already said what replaces the probe - "CallMask replaces 'is this table
|
||||
// ARCHITECTURE.md §3.3 already said what replaces the probe - "CallMask replaces 'is this table
|
||||
// slot null' as the implicit capability probe" - and this header is the concrete list.
|
||||
//
|
||||
// TWO SPELLINGS, AND WHICH ONE A SITE TAKES IS DECIDED BY THE SLOT'S CLASS, NOT BY TASTE:
|
||||
|
||||
@@ -274,7 +274,7 @@ namespace MobileGL::MG_Remote::Server {
|
||||
if (table->Present == nullptr) return false;
|
||||
// Present is the ONLY frame-boundary drain the backend has (DirectGLES.cpp:12424-12470:
|
||||
// the fence poll, the four ring OnPresent hooks, TrimBufferPool, PipeStats::OnPresent),
|
||||
// which is why ARCHITECTURE.md:531 wants present <-> eglSwapBuffers to stay 1:1.
|
||||
// which is why ARCHITECTURE.md §14 wants present <-> eglSwapBuffers to stay 1:1.
|
||||
//
|
||||
// m-1: THAT 1:1 IS A CONVENTION c1 UPHOLDS, NOT A STRUCTURAL GUARANTEE, and the earlier
|
||||
// claim that it was structural is wrong. This Present() is reached ONLY from a present
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
//
|
||||
// Deliberately the smallest thing that can be one: everything it could do
|
||||
// belongs to mobilegl_server_main, which lives IN THE LIBRARY so that one
|
||||
// shared library serves both roles (ARCHITECTURE.md:496). Keeping this file
|
||||
// shared library serves both roles (ARCHITECTURE.md §15.2). Keeping this file
|
||||
// empty of logic is what stops the server growing a second, divergent copy of
|
||||
// bring-up that the client half never executes.
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
// gone.
|
||||
//
|
||||
// ANTI-RECURSION IS STILL TWO INDEPENDENT CATCHES, and CONTRACT-P6 §3.1 is why
|
||||
// neither is ARCHITECTURE.md:488's. That rule says the child hard-sets
|
||||
// neither is the original ARCHITECTURE.md §15.1 rule. That rule says the child hard-sets
|
||||
// Transport to Monolith; a6 measured that 226 live lines test
|
||||
// `Transport != Monolith` to select the SERVER arm, 148 of them in MG_Backend,
|
||||
// so obeying it flips the whole backend to frontend glue in the one process
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
// THE ID IS THE RECORD SEQUENCE NUMBER (P5 R-3). There is no second id space and
|
||||
// no allocator: the ten kReplySlot calls carry no MGPReplySlot in their payloads
|
||||
// (that is why the id has to be DERIVED rather than carried), the wire has no
|
||||
// per-record seq field (ARCHITECTURE.md:124), so the record's ordinal IS its
|
||||
// per-record seq field (ARCHITECTURE.md §4), so the record's ordinal IS its
|
||||
// reply-slot id. The slot is addressed `seq % slotCount` and the server STAMPS
|
||||
// THE SEQ BACK INTO THE SLOT HEADER, which is what makes a wrong-slot read
|
||||
// detectable rather than merely plausible. Seq is 1-based; 0 means "no record".
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
// The ring-owning half of a session: the four segments, the two ring endpoints,
|
||||
// and the five watermarks. Owner: package s1.
|
||||
//
|
||||
// This is the object the P5 gate is really about. ROADMAP.md:21 asks that
|
||||
// This is the object the P5 gate is really about. ARCHITECTURE.md §10.1 asks that
|
||||
// `inproc` run THE SAME G3 codec as `spawn`, and InProcessTransport cannot
|
||||
// deliver that no matter how it is edited: it is two deque<vector<uint8_t>> plus
|
||||
// two condvar doorbells (InProcessTransport.cpp:38-97), it owns THE BELLS BUT
|
||||
|
||||
@@ -2387,7 +2387,7 @@ namespace MobileGL::MG_Remote::Wire {
|
||||
return m_verbs != nullptr && m_verbs->OnClear(*static_cast<const MGPClear*>(payload));
|
||||
|
||||
case MGPWireOp::ReadPixels:
|
||||
// P5 BLOCKS on read_pixels (ROADMAP.md:21) and the pixels come back in the reply
|
||||
// P5 BLOCKS on read_pixels (ARCHITECTURE.md §13.1) and the pixels come back in the reply
|
||||
// slot, which is why ReplyPool::SlotBytes() is sized from the scenario's largest
|
||||
// read rather than guessed. MGPReadbackInfo has DstOffset/DstSize and no Seg on
|
||||
// purpose: in P5 the destination is ALWAYS SEG_REPLY (contract table 1 row 23).
|
||||
|
||||
@@ -33,7 +33,7 @@
|
||||
// 0xDD, so an implementation that kept a pointer past apply reads 0xDD next frame.
|
||||
//
|
||||
// SEQ. The record ordinal IS the sequence number and IS the reply-slot id (R-3): there is no
|
||||
// per-record seq field on the wire (ARCHITECTURE.md:124) and no second id space. Seq is
|
||||
// per-record seq field on the wire (ARCHITECTURE.md §4) and no second id space. Seq is
|
||||
// 1-based so that 0 can mean "nothing encoded". A kRecPad wrap filler DOES NOT ADVANCE SEQ -
|
||||
// both sides must skip it before counting, or every ring wrap offsets the two sides'
|
||||
// numbering permanently and nothing checksums it (R-9, Ring.h's header).
|
||||
|
||||
Reference in New Issue
Block a user