Files
CoCoCapitalQuiz/docs/PROVENANCE.md
T

77 lines
4.4 KiB
Markdown

# Sources, attribution and licenses
Capital Quest is Brian Holman's C geography quiz, developed with assistance from
ChatGPT/Codex. Its historical CHATGPT_PROMPT.md records the original brief and a
later sound/progression addendum. The delivered project also includes subsequent
progress-map colors and nonrepeating correct-answer positions. This is a record
of actual sources and components, not a claim of clean-room reimplementation or
an unedited one-prompt generation.
## Game and manual
The game source is distributed under GPL-3.0-or-later; LICENSE retains the full
GPL version 3 text. The player manual is © Brian K. Holman 2026 and
GPL-3.0-or-later. These statements do not replace a component's own terms.
## Map and state data
The retained assets/usa-source.svg is © Fla-shop.com, CC BY 4.0. Original:
https://www.fla-shop.com/svg/usa/usa-albers-2000-1200.svg
License: https://creativecommons.org/licenses/by/4.0/
Source SHA-256: c698d71ce9667e8f4500dec6479bdb91d2bab2c26fa82ada6bc9c73746427771
The original copyright/license comment is preserved. Adaptations include region
assignment, reduced resolution, simplified boundaries, recoloring, run-length
encoding and enlarged Northeast/Hawaii crops. The map, generated spans, previews
and map-containing screenshots retain that attribution. Insets are not to common
scale; no endorsement is implied. Full notice: assets/CREDITS.md.
State names, postal codes and capitals are the 50-row factual dataset in
data/states.tsv. data/SOURCES.md preserves the verification sources and explains
the canonical ordering and Saint Paul aliases. tools/prepare_assets.py generates
src/states.c, src/map_data.c, geometry metadata and previews offline; generated
C is retained so normal builds need not parse an SVG or run Python.
## Linked components and matching sources
- Pierre Sarrazin's font5x8 has an explicit public-domain dedication, retained
with its source/header in the companion. The linked font comes from HiresTxt.
- tools/boot.c adapts Pierre Sarrazin's public-domain autostart.c 0.1.2 to load
CAPITAL.BIN; its original header remains in the file.
- BControl 0.1.6 provides Keyboard_init/poll/shutdown. Its full original sources
and notice are preserved. The Keyboard.c header says public domain except
the parts that come from Color Basic. Preserve that source-specific wording;
the game's GPL does not rewrite it. See assets/BCONTROL-NOTICE.txt.
- VCC Plus's gime.c and vcc/gime.h declare GPL-3.0-or-later. The matching source,
public header and COPYING are included in the companion.
- CMOC 0.1.100 supplies the CRT, standard and BASIC-backed floating-point runtime
used by the CoCo build. The companion includes the pinned source snapshot,
original notices, import/compiler patches and build references. It also has a
target-only library rebuild driver using installed VCC Plus tools.
Download the [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/CapitalQuest/2026-11-11/43fcd00f12ef/Capital-Quest-Library-Sources.zip).
It is separate from the small writable C-workspace starter so opening a game does
not import hundreds of compiler files into the project. SOURCE_INVENTORY.json
pins component files and their upstream/patched provenance. Individual runtime
objects and the GIME/BControl archives were reconstructed and compared to the
installed toolchain. The companion keeps original file-specific terms and
contains no private ROM images, private runtime inputs or compiled binaries.
The ordinary game Makefile uses VCC Plus's bundled compiler, assembler, linker,
Make, Perl and libraries. It does not require a host compiler or Apple SDK.
Rebuilding the host CMOC compiler from its source is a different developer task
with additional dependencies, explained in the companion.
## Edition identity and validation
The November 11, 2026 edition retains the approved CAPITAL.DSK unchanged:
5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6
Base repository revision: 46f4b9cae00951b9924af129b9f74e912766fff8, plus approved
map and answer-slot changes. Exact compile-input fingerprint:
3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56
Public-source/documentation cleanup changes no game source, build recipe,
compiled data or executable bytes. See docs/PUBLIC_RELEASE.md for qualification,
and docs/manual/screenshots.json for selected unmodified guest capture hashes.