1# Custom Extensions
2
3This is a system for allowing you to easily add your own
4extensions to RETRO on Unix systems.
5
6There are two options:
7
8## Manual Additions
9
10Add files to include to the code block below. Use a form
11like:
12
13    'filename include
14
15You can either put the files (or links to them) into this
16directory or use full path names to the files. You can
17also use any Retro code directly.
18
19~~~
20'dict-words-listing.forth include
21~~~
22
23## Automatic Extensions
24
25This does not require manual editing of this file. To use
26this:
27
28- copy (or symlink) the extensions into the `extensions` subdirectory
29- run `make update-extensions`
30- run `make`
31
32This will build RETRO, generate a new `load-extensions.retro` and
33then rebuild, including the extensions.
34
35~~~
36'load-extensions.retro include
37~~~
38
39## Final Bits
40
41Save the image with anything loaded here added in. The
42`retro` binary will be rebuilt using the extended image.
43
44~~~
45'../rre.image image:save
46~~~
47