b2cb56d3c8
FossilOrigin-Name: c0466ee9bdc6ca354aaf2e88f5fb9ab3bfe52b531927830b73722b593f9dee57
65 lines
1.1 KiB
Text
65 lines
1.1 KiB
Text
# Building on BSD, Linux, macOS, and other Unix Targets
|
|
|
|
Retro is well supported on BSD (tested on FreeBSD, NetBSD,
|
|
OpenBSD), Linux, and macOS systems. It should build on any
|
|
of these without issue.
|
|
|
|
## Requirements
|
|
|
|
- c compiler & linker
|
|
- standard headers
|
|
- make
|
|
|
|
## Process
|
|
|
|
For a standard 32-bit system:
|
|
|
|
Run `make`
|
|
|
|
This will build the toolchain and then the main `retro`
|
|
executable.
|
|
|
|
## Executables
|
|
|
|
In the `bin/` directory, you should see the following:
|
|
|
|
retro
|
|
retro-unu
|
|
retro-muri
|
|
retro-extend
|
|
retro-embedimage
|
|
retro-describe
|
|
|
|
## Test The Build
|
|
|
|
You can conduct a quick test of the build by running `bin/retro`:
|
|
|
|
./bin/retro
|
|
|
|
Exit by typing `bye` and pressing enter.
|
|
|
|
## Installation
|
|
|
|
You can install Retro globally on BSD systems (and possibly Linux)
|
|
by doing:
|
|
|
|
doas make install
|
|
|
|
or:
|
|
|
|
sudo make install
|
|
|
|
## Platform Specific Notes
|
|
|
|
### Haiku
|
|
|
|
To build on Haiku, you may need to link with the *network* library.
|
|
E.g.:
|
|
|
|
make LDFLAGS=-lnetwork
|
|
|
|
## Issues
|
|
|
|
If you run into any build issues, please send details to
|
|
crc@forth.works so I can work on addressing them as quickly
|
|
as possible.
|