Ustagammon/engine/gnubg/PROVENANCE.md

Provenance de la copie de GNU Backgammon

Les fichiers de ce dossier sont copiés de GNU Backgammon (https://git.savannah.gnu.org/cgit/gnubg.git), commit 14b67984737ded0f6de43d63dcb789f729d9b06b (version 1.08.003, 2026-10-23), choisi par l'ADR 0005. Licence : GPLv3 ou ultérieure (COPYING). Les en-têtes de copyright sont conservés.

Aucun fichier n'est modifié : chacun est identique octet pour octet à l'original. Vérification, depuis un clone de gnubg à ce commit :

for f in $(cd engine/gnubg && find . -type f ! -name PROVENANCE.md); do
	cmp "engine/gnubg/$f" "chemin/du/clone/gnubg/$f" || echo "différent : $f"
done

Les espaces en fin de ligne de l'original sont gardés ; tests/lint.sh exclut donc ce dossier (et engine/data/) de cette vérification.

Fichiers repris

Compilés dans le moteur embarqué (build/libengine.a) :

Fichier	Rôle
eval.c, eval.h, movefilters.inc	Évaluation, génération et classement des coups, videau
positionid.c, positionid.h	Position ID
matchid.c, matchid.h	Match ID
matchequity.c, matchequity.h, mec.c, mec.h	Tables d'équité de match
bearoff.c, bearoff.h, bearoffgammon.c, bearoffgammon.h	Bases de fin de partie
drawboard.c, drawboard.h	Notation des coups (FormatMove)
mtsupport.c	Données du fil d'exécution unique (branche sans threads)
lib/neuralnet.c, lib/neuralnet.h, lib/neuralnetsse.c, lib/inputs.c, lib/simd.h, lib/sigmoid.h	Réseaux de neurones
lib/cache.c, lib/cache.h	Cache d'évaluations
lib/isaac.c, lib/isaac.h, lib/isaacs.h, lib/md5.c, lib/md5.h	Hasards (bruit, désactivé ici) et hachage
lib/list.c, lib/list.h	Listes (tables d'équité)
lib/gnubg-types.h, common.h, dice.h	Types et définitions communes

Compilés seulement pour générer les données au build (build/host/), avec la vraie GLib, comme dans le build officiel :

Fichier	Rôle
makeweights.c	gnubg.weights → gnubg.wd (réseaux en binaire)
makebearoff.c	Bases gnubg_os0.bd et gnubg_ts0.bd

Données, dans engine/data/ (non modifiées non plus) : gnubg.weights (racine du dépôt gnubg) et Kazaross-XG2.xml (met/), la table d'équité de match par défaut de gnubg de bureau.

Ce qui remplace le reste de gnubg

Les fichiers de gnubg non repris sont remplacés par des fichiers propres à Ustagammon, dans engine/compat/, trouvés en premier par le compilateur :

Fichier	Remplace
config.h	Le config.h produit par configure (sans threads, C générique, NEON prévu)
glib-shim/glib.h, glib-shim/glib/*.h, glib-shim.c	GLib, pour le moteur embarqué seulement
backgammon.h, output.h, util.h, format.h, multithread.h, external.h	En-têtes réduits aux déclarations utilisées par le cœur
gnubg-support.c	Fonctions et variables de gnubg.c, output.c, util.c, multithread.c utilisées par le cœur
host-tools-support.c	GetTemporaryFile de util.c, pour makebearoff

La liste des symboles à fournir a été établie à l'édition des liens. Le fichier jni-bridge/src/stubs.c de CBG (https://github.com/clavierhaus/gnubg-android, GPLv3) a servi de point de repère, sans reprise de code.

Mettre à jour la copie

Copier les mêmes fichiers depuis le nouveau commit, mettre à jour le commit ci-dessus, puis make engine et make test. Une erreur de compilation ou d'édition des liens indique un symbole à ajouter dans engine/compat/.