RETRO-EXTEND(1)

📦 version 2025.08, in alpine 3.24

🦋 RETRO-EXTEND 🦋

okay so bestie, welcome to retro-extend — part of RETRO, the modern, pragmatic Forth development system. 💖

✨ SYNOPSIS ✨

image filename [filenames]

like. that's it. that's the whole vibe. 🎀

🌸 DESCRIPTION 🌸

okay so first things first: RETRO is a modern, pragmatic Forth drawing influences from many sources. it's clean, elegant, tiny, and easy to grasp and adapt to various uses. literally the whole package. 💅

now retro-extend is a tool to load additional code into an image file. here's the whole flow, no cap:

  • it takes the name of an image file
  • plus one or more source files to load into the image
  • and after completion, the image file gets updated with the changes

so like, you hand it your image, you hand it your source files, and it just... folds that code right in. iconic behavior honestly. ✨

💀 CAVEATS 💀

okay this part is important so listen up bestie 🫶

retro-extend only emulates the minimal console output device. if your source files require additional I/O to be present, the extend process will likely fail to work correctly.

so yeah — if your code needs more I/O than the minimal console output device can give, the whole thing's gonna have a bad time. plan accordingly. 😭

👑 AUTHORS 👑

Charles Childers <crc@forthworks.com>

and that's the whole page, bestie! 🌈 this one came from Debian, dated January 2021. go forth and extend responsibly 🧚💜

📦 where this page comes from