Add header comments to the source files

Every source file in ui, app, game, formats, cli, audio and launch that had none
now starts with a short English comment: what it implements, what state it owns
and how it relates to its neighbours (request/acknowledge flow, pairs of files,
random generator use). Comment lines only; the full build and the runnable
tests are unchanged.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
ClaudeandClaude Sonnet 5.5 committed 2026-11-06 09:15:23 +01:00
1 parent aa6ec96305
commit 287b5a9251
324 files changed
+1186

No files matched your search

+14
View File
@@ -1,4 +1,18 @@
// SPDX-License-Identifier: GPL-3.0-only
// Implementation of the controller (controller.hpp): the request/acknowledge model between
// the UI flow, the controller and the session.
// 1. The SDL loop in main.cpp feeds input to ui::StartupFlow, which returns a FlowResult
// with a FlowRequest (desk action, transfer, friendly match, load game, ...).
// 2. serve_flow_request() is the single entry for that request. It rejects requests whose
// revision no longer matches (stale UI), or that are blocked by an open owner.
// 3. It forwards the request to the matching *Actions facade (desktop_actions.*,
// window_actions.*), which runs it on the CareerSession inside a rollback transaction.
// 4. The result is acknowledged back to the flow (for example flow.acknowledge_*,
// show_*), which then changes what is drawn; rendering alone never advances the engine.
// 5. A non-empty return string is an error message (main.cpp prints it); "career_complete"
// ends the program. The shared revision counter grows only when state really changed.
// Presenters (dialogs, live match frames) are optional hooks; an empty hook means the
// headless default. The anonymous namespace holds friendly-match and national-friendly helpers.
#include "formats/badge_policy.hpp"
#include "formats/executable_layout.hpp"
#include "app/controller.hpp"