The single, most comprehensive Game Boy technical reference. https://gbdev.io/pandocs/
  • Markdown 84.7%
  • Rust 6.4%
  • JavaScript 5.4%
  • Python 1.7%
  • CSS 1.5%
  • Other 0.3%
Find a file
Quinn fe246067b6
Rewrite BCPD description of the colour data format (#662)
* Rewrite BCPD description of the colour data format

- less ambiguous description of the colour data format
- clarify meaning of endianness (byte order)
- reverse the order of the bit table, so MSB appears first, matching
  others

* Update src/Palettes.md

Co-authored-by: Eldred Habert <me@eldred.fr>

* Apply suggestions from code review

Co-authored-by: Eldred Habert <me@eldred.fr>

* Add SVG diagrams describing GBC colour format

Co-authored-by: "Janni K." <24881711+nummacway@users.noreply.github.com>
Co-authored-by: Rangi42 <sylvie.oukaour+rangi42@gmail.com>

* Move description of color format outside of BGPI/BGPD

* Touch up description of CGB pal regs

* Use new names for CGB pal regs

Those have been deprecated in newer `hardware.inc`, and really,
the header names were hard to read with the duplicated names,
especially the OBJ ones.
Anyone being confused by old code should be able to deduce the
alternate naming from their definitions in the accompanying
`hardware.inc`, or they can look it up on older versions of Pan Docs,
or they can ask and be explained.

I nonetheless expect that the impact will be very low at this point.

* Update src/Palettes.md

* Update src/Palettes.md

* Update src/Palettes.md

Co-authored-by: Quinn <3379314+quinnyo@users.noreply.github.com>

* Update src/Palettes.md

Co-authored-by: Quinn <3379314+quinnyo@users.noreply.github.com>

* Update src/Palettes.md

Fix wildy incorrect arithmetic

Co-authored-by: Eldred Habert <me@eldred.fr>

* Add an overview of the palette systems

* Tweak wording of bit 15 footnote

* Clarify use of “little-endian”

* Improve wording of CRAM interface introduction

Co-authored-by: Quinn <3379314+quinnyo@users.noreply.github.com>

* Clarify effect of PPU locking on CRAM regs

Co-authored-by: Quinn <3379314+quinnyo@users.noreply.github.com>

* Move and reword tip about BG color initialisation

---------

Co-authored-by: Antonio Vivace <avivace4@gmail.com>
Co-authored-by: Eldred Habert <me@eldred.fr>
Co-authored-by: "Janni K." <24881711+nummacway@users.noreply.github.com>
Co-authored-by: Rangi42 <sylvie.oukaour+rangi42@gmail.com>
2026-06-09 11:06:43 +02:00
.github Upgrade crates to support mdBook 0.5 breaking changes (#652) 2026-03-26 19:14:01 +01:00
custom typography: add sans-serif fallback to body font 2026-03-20 00:17:19 +01:00
historical Move mediawiki-exporter into historical directory (#609) 2025-07-15 15:18:17 +02:00
preproc Upgrade crates to support mdBook 0.5 breaking changes (#652) 2026-03-26 19:14:01 +01:00
renderer Fixes unintentional removal of the search feature (#656) 2026-04-01 13:40:30 +02:00
src Rewrite BCPD description of the colour data format (#662) 2026-06-09 11:06:43 +02:00
theme head: add matomo tracking code 2023-12-17 23:27:24 +01:00
.gitattributes Count Markdown files in GitHub's summary 2024-09-18 17:34:52 +02:00
.gitignore figures: move to matplotlib, make output SVGs affected by CSS theme, hook up new preprocessing step to mdbook (#530) 2024-02-20 23:49:14 +01:00
book.toml mdbook: disable sidebar heading navigation (opt out, introduced in v0.5.2) 2026-04-19 19:56:12 +02:00
Cargo.lock Fixes unintentional removal of the search feature (#656) 2026-04-01 13:40:30 +02:00
Cargo.toml Migrate to mdBook (#292) 2021-05-24 10:37:31 +02:00
CONTRIBUTING.md Clean up some http links, outdated links, and GBZ80 references (#607) 2025-07-03 19:51:34 +02:00
DEPLOY.md Upgrade crates to support mdBook 0.5 breaking changes (#652) 2026-03-26 19:14:01 +01:00
Dockerfile Upgrade crates to support mdBook 0.5 breaking changes (#652) 2026-03-26 19:14:01 +01:00
LICENSE Add LICENSE 2020-01-19 23:04:27 +01:00
README.md readme: improve license wording 2023-12-17 01:33:43 +01:00
requirements.txt figures: move to matplotlib, make output SVGs affected by CSS theme, hook up new preprocessing step to mdbook (#530) 2024-02-20 23:49:14 +01:00

Pan Docs

"Pan Docs" is a document started in early 1995, considered the single most comprehensive technical reference to Game Boy available to the public.

This git repository hosts a renewed version of it, mantained in the Markdown format and enjoying renewed community attention.

Go to gbdev.io/pandocs to read the document.

Contributing

Everyone is welcome to contribute opening issues, expressing feedback, adding and improving content or share new findings. Please, check the contributing guidelines for a complete view on how to contribute to this project or read the deploy instructions to run a local copy of Pan Docs.

License

Pan Docs is released into the public domain.