devs/foxbox
1
0
Fork 0
forked from len0rd/rockbox
Code Pull requests Activity

puzzles: update README.

Browse source 
Change-Id: I4e3306bdaa391f7aa698c67f00285975e398ee02
This commit is contained in:
Franklin Wei 2025-01-01 19:13:04 -05:00
parent 334c725a45
commit 07036061fc
1 changed files with 21 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

35
apps/plugins/puzzles/README.rockbox
View file

@ -2,18 +2,23 @@ Introduction
============ ============
This is the readme for the Rockbox port of Simon Tatham's Portable This is the readme for the Rockbox port of Simon Tatham's Portable
Puzzle Collection. Puzzle Collection. The port was originally done by Franklin Wei in
2017, and has been regularly maintained since then to remain in sync
with Simon's upstream sources.
Source structure Source structure
================ ================
Most of the upstream files in src/ are essentially untouched, apart The upstream source files reside in src/. As of 2024, these sources
from some minor adjustments to make them compile and run happily on are bit-for-bit identical to Simon's upstream sources. The
Rockbox. The majority of the rockbox-specific code is found in Rockbox-specific code in the parent puzzles/ directory provides a set
rockbox.c, with some minor stuff in rbwrappers.c and rbmalloc.c. of shims (rbcompat.h, rbwrappers.c), which emulate missing parts of
the standard library to enable the upstream puzzles code to work
happily on Rockbox. The implementation of the Rockbox frontend resides
in rockbox.c.
NOTE: the build makefile (puzzles.make) automatically includes NOTE: the build makefile (puzzles.make) automatically includes
`rbcompat.h` when compiling! Check there when things break. `rbcompat.h` when compiling! Check there if things break.
Help feature Help feature
============ ============
@ -33,14 +38,14 @@ As of 2024, Simon's tree is located at:
https://git.tartarus.org/?p=simon/puzzles.git https://git.tartarus.org/?p=simon/puzzles.git
For a long time (i.e. 2017-2024), our version of the puzzles tree For a long time (2017-2024), our version of the puzzles tree contained
contained several modifications by myself (notably cursor interfaces several patches to make certain games playable on Rockbox (notably
to Untangle and Palisade). These divergent changes complicated cursor interfaces to Untangle and Palisade). These divergent changes
maintenance of this port, as merge conflicts often arose when upstream complicated maintenance of the port, as merge conflicts often arose
changes to these games conflicted with our changes. To remedy this, I when upstream changes to these games conflicted with ours. To remedy
sent most of these patches back upstream in summer 2024, and since this, I sent most of these patches back upstream in summer 2024, and
then, Simon has merged them into his repo. We are now able to run with since then, Simon has merged them into his repo. We are now able to
a fully unmodified puzzles source tree. run with a fully unmodified puzzles source tree.
Maintenance Maintenance
=========== ===========
@ -108,3 +113,5 @@ August 2024: Resync to ee5e327 (branched from Simon's
August 2024: Resync to Simon's 262f709 (unmodified). Uses new scanline August 2024: Resync to Simon's 262f709 (unmodified). Uses new scanline
polygon filling algorithm. Updates drawing API. polygon filling algorithm. Updates drawing API.
January 2024: Resync to Simon's XXXXXXX (TBD). Cleans up resync.sh.