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>
21 lines
775 B
C++
21 lines
775 B
C++
// SPDX-License-Identifier: GPL-3.0-only
|
|
// Interface of the computer tip score function implemented in source_tip.cpp. It consumes
|
|
// GameRandom draws, including the final goal-cap draw, and touches no GameState.
|
|
#pragma once
|
|
|
|
#include <array>
|
|
#include <cstdint>
|
|
|
|
#include "game/random.hpp"
|
|
|
|
namespace bmh {
|
|
|
|
// ComputeLeagueTableForecast's pure score arithmetic after the caller has obtained the four
|
|
// QuoteNationalFriendlyMatch ratings. Each invocation consumes the same G draws, including
|
|
// the final goal-cap draw that terminates the loop.
|
|
uint8_t source_tip_result(GameRandom& game, const std::array<uint8_t, 10>& gap,
|
|
int home_rating, int away_rating,
|
|
int home_secondary, int away_secondary);
|
|
|
|
} // namespace bmh
|