retroforth/doc/book/building/unix
crc d29d07957d allow setting image size, stack sizes at build time. see doc/book/building/unix for details
FossilOrigin-Name: 0987b8f0e28fb5a72f41e746437751a706672b09d0e4b14d6c5e5b2b4d4e7c29
2020-09-08 18:54:57 +00:00

63 lines
1.2 KiB
Text

# Building on BSD, Linux, macOS, and outher Inix 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`
For a 64-bit system:
Run `make OPTIONS=-DBIT64`
This will build the toolchain and then the main `retro`
executable.
## Executables
In the `bin/` directory:
retro
retro-unu
retro-muri
retro-extend
retro-embedimage
retro-describe
## Platform Specific Notes
In addition to the 64-bit build, it is possible to override the
image size, address stack depth, and data stack depth by defining
the appropriate elements.
E.g., for a 64-bit build with:
4,000,000 cells of memory
4,000 item limit on data stack
500 item limit on address stack
Run `make OPTIONS="-DBIT64 -DIMAGE_SIZE=4000000 -DSTACK_DEPTH=4000 -DADDRESSES=500"`
### Haiku
To build on Haiku, you 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.