prc-tools-remix

Overview

This repository is an archive of prc-tools 2.3 and its GCC cross-compilation toolchain, with patches enabling it to build and run on modern Linux and macOS systems.

prc-tools is a collection of tools supporting C and C++ programming for Palm OS. It supplies a full GCC cross-compilation toolchain for m68k and ARM, as well as Palm OS-specific utilities.

As the Palm OS platform faded into oblivion, prc-tools appears to be have been unmaintained since 2003 and no longer compiles under recent versions of GCC and Clang. This repo includes a number of patches to enable it to build and run on modern Linux and macOS systems.

Installation

Debian / Ubuntu

If you’re using a recent 64-bit version of Ubuntu or Debian, you can download and install pre-built .deb packages for prc-tools-remix from the Releases page.

For a full Palm OS development environment that includes prc-tools-remix, Palm OS SDKs and PilRC, you can use the one-click install script tools/setup-palm-os-dev-env.sh:

curl -sLO https://github.com/jichu4n/prc-tools-remix/raw/master/tools/setup-palm-os-dev-env.sh
bash ./setup-palm-os-dev-env.sh $DIST

…​where $DIST can be one of focal, bionic, xenial, buster, or stretch, depending on your distro and version.

Otherwise, please see "Building from source" below.

Arch Linux / Manjaro

You can install prc-tools-remix from the AUR:

yay -S prc-tools-remix

For a full Palm OS development environment that includes prc-tools-remix, Palm OS SDKs and PilRC:

yay -S prc-tools-remix palm-os-sdk-git pilrc

Building from source

See tools/build.sh for general build steps.

To build and install using tools/build.sh:

# Install dependencies:
sudo apt-get install \
    build-essential autoconf automake \
    libncurses-dev \
    flex bison \
    texinfo gperf

# Download code:
git clone https://github.com/jichu4n/prc-tools-remix.git
cd prc-tools-remix

# Build and install into "./dist/" directory:
./tools/build.sh

# To build a binary tarball:
(cd ./dist && tar cvjf ../prc-tools-remix.tar.bz2 *)
# To unpack into your system:
sudo tar xvjf prc-tools-remix.tar.bz2 -C /

For a full Palm OS development environment, you’ll also need the following:

• Palm OS SDKs: See tools/setup-palm-os-sdk.sh

• PilRC: Install pre-built deb packages from the Releases page, or see PilRC build script for general build steps

Usage

Please refer to the prc-tools homepage for documentation on usage.