Rename gc -> gcn for the 3-letter codename pattern

Settles the GameCube subdir/codename on 3 letters to match gba and pce
(and future n64 / snes). The intermediate gc/ subdir + gc-v* tag
prefix introduced minutes ago is dropped before it ships -- the
deleted gc-v0.2.0 release/tag never existed in the wild.

Why 3 letters: 2-letter codenames collide with unrelated paths in
sibling repos. joypad-os already has its own src/native/host/gc/
subdir for its GameCube host code, totally unrelated to our subdir
codename, which made cross-references confusing. gcn/gba/pce/n64/snes
read consistently and don't collide.

Updated everywhere the codename appears:
- gc/ -> gcn/ (git mv of the whole subtree).
- Workflow matrix entry, gates, parse case (gc) -> gcn)),
  artifact paths.
- Top-level README Consoles + Per-console tables, the "subdirs use
  short codenames" note (now "short 3-letter codenames"), and
  LICENSE.md's subdir-license-pointer example.
- CLAUDE.md existing-subdir list, README-outline canonical example
  reference, tag-format example, plus a new rule documenting why
  2-letter codenames are out (path-collision risk with sibling
  repos).
- gba/README.md and pce/README.md cross-links (../gc/* -> ../gcn/*).
  joypad-os internal src/native/host/gc/* references stay -- that's
  their subdir, not ours.
- pce/buildtools/make_logo.py path comment + REPO_ROOT fallback
  lookup.
- gcn/README.md "Releases" section + gcn/CHANGELOG.md v0.2.0 entry
  rewritten to describe the gcn rename (and to note the never-shipped
  gc/ interlude explicitly).

Tag/release impact:
- Already deleted gc-v0.2.0 release + tag.
- gcn-v0.2.0 will be cut next, carrying the same content as the
  deleted gc-v0.2.0 would have plus this rename.

Author: RobertDaleSmith

.github/workflows/release.yml

@@ -1,6 +1,6 @@
 name: Release
 
-# Triggered by tags shaped like <console>-v<semver>, e.g. gc-v0.1.0,
+# Triggered by tags shaped like <console>-v<semver>, e.g. gcn-v0.1.0,
 # pce-v0.2.3, etc. The console subdir comes from the prefix; only that
 # console's app is built and attached to a GitHub Release.
 on:
@@ -30,7 +30,7 @@ jobs:
           CONSOLE="${TAG%%-v*}"
           VERSION="${TAG#*-v}"
           case "$CONSOLE" in
-            gc)       PRETTY="GameCube" ;;
+            gcn)      PRETTY="GameCube" ;;
             wii)      PRETTY="Wii" ;;
             n64)      PRETTY="Nintendo 64" ;;
             snes)     PRETTY="Super Nintendo" ;;
@@ -62,27 +62,27 @@ jobs:
           fi
 
       - name: Set up Python
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         uses: actions/setup-python@v5
         with:
           python-version: '3.12'
 
       - name: Install Pillow
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         run: pip install --quiet Pillow
 
       - name: Generate banner
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         working-directory: ${{ needs.parse.outputs.console }}
         run: python3 buildtools/make_banner.py opening.bnr
 
       - name: Generate screensaver logo header
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         working-directory: ${{ needs.parse.outputs.console }}
         run: python3 buildtools/make_logo.py
 
       - name: Build (GameCube)
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         run: |
           docker run --rm \
             -v "${{ github.workspace }}":/workspace \
@@ -113,7 +113,7 @@ jobs:
             make
 
       - name: Stage release artifacts (GameCube)
-        if: needs.parse.outputs.console == 'gc'
+        if: needs.parse.outputs.console == 'gcn'
         working-directory: ${{ needs.parse.outputs.console }}
         run: |
           mkdir -p _release

.github/workflows/verify-build.yml

@@ -18,12 +18,12 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - console: gc
+          - console: gcn
             image: ghcr.io/extremscorner/libogc2:latest
             artifacts: |
-              gc/joypad-tester-gamecube.dol
-              gc/joypad-tester-wii.dol
-              gc/opening.bnr
+              gcn/joypad-tester-gamecube.dol
+              gcn/joypad-tester-wii.dol
+              gcn/opening.bnr
           - console: gba
             image: devkitpro/devkitarm:latest
             artifacts: |
@@ -50,21 +50,21 @@ jobs:
           python-version: '3.12'
 
       - name: Install Pillow (for banner generation)
-        if: matrix.console == 'gc'
+        if: matrix.console == 'gcn'
         run: pip install --quiet Pillow
 
       - name: Generate banner
-        if: matrix.console == 'gc'
+        if: matrix.console == 'gcn'
         working-directory: ${{ matrix.console }}
         run: python3 buildtools/make_banner.py opening.bnr
 
       - name: Generate screensaver logo header
-        if: matrix.console == 'gc'
+        if: matrix.console == 'gcn'
         working-directory: ${{ matrix.console }}
         run: python3 buildtools/make_logo.py
 
       - name: Build (gamecube target)
-        if: matrix.console == 'gc'
+        if: matrix.console == 'gcn'
         run: |
           docker run --rm \
             -v "${{ github.workspace }}":/workspace \
@@ -74,7 +74,7 @@ jobs:
             bash -c "apt-get install -y -qq --no-install-recommends -t bookworm-backports xorriso 2>/dev/null; TARGET_CONSOLE=gamecube make"
 
       - name: Build (wii target)
-        if: matrix.console == 'gc'
+        if: matrix.console == 'gcn'
         run: |
           docker run --rm \
             -v "${{ github.workspace }}":/workspace \

CLAUDE.md

@@ -31,17 +31,21 @@ or the CI/release wiring.
 └── common/              # (future) cross-console shared helpers
 ```
 
-Subdir names are short codenames matching homebrew-community usage
-(`gc`, `gba`, `pce`, future `n64` / `snes` / …). The same codename is
-used as the release-tag prefix (`<codename>-v<semver>`). Don't introduce
-full-localized-name subdirs (`gamecube/`, `gameboyadvance/`, etc.) —
-the codename is the source of truth.
+Subdir names are short 3-letter codenames matching homebrew-community
+usage (`gcn`, `gba`, `pce`, future `n64` / `snes` / …). The same
+codename is used as the release-tag prefix (`<codename>-v<semver>`).
+Don't introduce full-localized-name subdirs (`gamecube/`,
+`gameboyadvance/`, etc.) — the codename is the source of truth. Also
+avoid 2-letter codenames (`gc`) since they tend to collide with
+unrelated paths in vendored / sibling repos (joypad-os has its own
+`gc/` subdir for the GameCube host that has nothing to do with our
+subdir codename).
 
 Existing console subdirs at time of writing:
 
-- `gc/` — GameCube + Wii test app (libogc2-based, builds .dol; also
+- `gcn/` — GameCube + Wii test app (libogc2-based, builds .dol; also
   surfaces N64 controllers via the passive adapter on GC ports).
-  Origin: zlib (corenting GC-Controller-Test); `gc/LICENSE.md`.
+  Origin: zlib (corenting GC-Controller-Test); `gcn/LICENSE.md`.
 - `gba/` — GBA multiboot payload, two variants from one source tree
   (eyes for joypad-os consumers, tester for the GameCube host or
   flashcart use). Origin: MIT (Doridian Joybus-PIO); `gba/LICENSE.md`.
@@ -102,7 +106,7 @@ only when the console has that surface; everything else is required.
 9. **`## Origin / credits`** — upstream lineage (project + license +
    link), what this subtree adds, and a link to `LICENSE.md`.
 
-`gc/README.md` is the canonical example. When adding a new console,
+`gcn/README.md` is the canonical example. When adding a new console,
 copy its skeleton and fill each section in — don't reorder or rename
 headings, because the top-level README and CLAUDE.md both reference
 them.
@@ -137,11 +141,13 @@ means adding a matrix entry + the corresponding build step(s).
 
 ## CI: releases (`.github/workflows/release.yml`)
 
-Tag-driven. Tag format: `<console>-v<semver>` (e.g. `gc-v0.2.0`,
+Tag-driven. Tag format: `<console>-v<semver>` (e.g. `gcn-v0.2.0`,
 `gba-v0.2.3`, `pce-v0.1.0`). Pre-release suffixes allowed (`-alpha.1`,
 `-rc.2`, …). One historical `gamecube-v0.1.0` tag predates the rename
-to short codenames — it stays as a frozen release; future GC releases
-use `gc-v*`.
+to short codenames — it stays as a frozen release; future GameCube
+releases use `gcn-v*`. (An intermediate `gc-` prefix was never
+shipped; the v0.2.0 work landed as `gcn-v0.2.0` once we settled on
+3-letter codenames.)
 
 The workflow:
 

LICENSE.md

@@ -3,7 +3,7 @@ MIT License
 Copyright (c) 2026 Robert Dale Smith
 
 Each console subdirectory carries its own license file matching its
-upstream origin (e.g. `gc/LICENSE.md`). This file applies to the
+upstream origin (e.g. `gcn/LICENSE.md`). This file applies to the
 top-level repository scaffolding — README, CI workflows, build infra —
 and to any future shared helpers in a `common/` directory.
 

README.md

@@ -6,20 +6,20 @@ A collection of homebrew controller test ROMs across game consoles. Each console
 
 | Console | Status | Path | License |
 |---|---|---|---|
-| GameCube | working | [`gc/`](gc/) | [zlib](gc/LICENSE.md) |
+| GameCube | working | [`gcn/`](gcn/) | [zlib](gcn/LICENSE.md) |
 | Game Boy Advance | working | [`gba/`](gba/) | [MIT](gba/LICENSE.md) |
 | PC Engine | scaffolded | [`pce/`](pce/) | [MIT](pce/LICENSE.md) |
 
-Subdirs use short codenames (`gc`, `gba`, `pce`, future `n64`/`snes`/…)
-matching homebrew-community conventions. Release tags follow the same
-prefix: `<codename>-v<semver>`.
+Subdirs use short 3-letter codenames (`gcn`, `gba`, `pce`, future
+`n64`/`snes`/…) matching homebrew-community conventions. Release tags
+follow the same prefix: `<codename>-v<semver>`.
 
 ## Per-console
 
 Each console subdir has its own `README.md` with what its app tests,
 how to build/flash, and any embedding notes. See:
 
-- [`gc/README.md`](gc/README.md)
+- [`gcn/README.md`](gcn/README.md)
 - [`gba/README.md`](gba/README.md)
 - [`pce/README.md`](pce/README.md)
 

gba/README.md

@@ -110,7 +110,7 @@ modifying the source — rebuild and commit `build/<variant>/<variant>_mb.gba`
 Two paths, depending on which variant and host:
 
 **Multiboot over GameCube link cable** — both variants. Build this
-repo's GameCube/Wii host (see [`../gc/`](../gc/)), connect a
+repo's GameCube/Wii host (see [`../gcn/`](../gcn/)), connect a
 GBA Link Cable from GameCube SI port 2 to the GBA, leave the GBA on the
 "Press Start" screen with no cartridge, and start the host. The host
 uploads `tester_mb.gba` via Kawasedo handshake + stream cipher and the
@@ -135,7 +135,7 @@ extern const uint8_t  joypad_payload[];
 extern const uint32_t joypad_payload_len;
 ```
 
-See [`../gc/ppc/gba.c`](../gc/ppc/gba.c) or joypad-os's
+See [`../gcn/ppc/gba.c`](../gcn/ppc/gba.c) or joypad-os's
 `src/native/host/gc/gba_multiboot.c` for a reference uploader
 implementation (Kawasedo handshake, stream cipher, polled WRITE/READ,
 unconditional handshake-complete write).

gc/.gitignore gcn/.gitignoregc/.gitignore renamed to gcn/.gitignore

@@ -2,11 +2,14 @@
 
 ## v0.2.0 — 2026-05-11
 
-First release under the new short-codename convention. The subdir is
-now `gc/` (was `gamecube/`) and the release tag is `gc-v0.2.0` (was
-`gamecube-v0.1.0`). The historical `gamecube-v0.1.0` tag/release stays
-intact as a frozen snapshot of the old layout — future releases all
-use the `gc-` prefix.
+First release under the new short-3-letter-codename convention. The
+subdir is now `gcn/` (was `gamecube/`) and the release tag is
+`gcn-v0.2.0` (was `gamecube-v0.1.0`). The historical `gamecube-v0.1.0`
+tag/release stays intact as a frozen snapshot of the old layout;
+future releases all use the `gcn-` prefix. (A short-lived intermediate
+`gc/` subdir + `gc-v` prefix was never shipped to release — we settled
+on `gcn` minutes after introducing it to avoid the 2-letter codename
+colliding with unrelated `gc/` directories in sibling repos.)
 
 ### Fixed
 
@@ -20,11 +23,11 @@ use the `gc-` prefix.
 
 ### Changed
 
-- Subdir rename `gamecube/` -> `gc/` to match the short-codename
-  convention used by `gba/`, `pce/`, and future consoles. Tag prefix
-  shifts from `gamecube-v*` to `gc-v*`. `TARGET_CONSOLE=gamecube|wii`
-  inside the libogc build is unchanged (that's the libogc internal
-  platform name, not our subdir codename).
+- Subdir rename `gamecube/` -> `gcn/` to match the short-3-letter-
+  codename convention used by `gba/`, `pce/`, and future consoles.
+  Tag prefix shifts from `gamecube-v*` to `gcn-v*`.
+  `TARGET_CONSOLE=gamecube|wii` inside the libogc build is unchanged
+  (that's the libogc internal platform name, not our subdir codename).
 
 ## v0.1.0 — 2026-05-07