how forth works.
This package owes a massive debt to the existence of the literate programming
-project [JonesForth] (https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/),
+project [JonesForth](https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/),
which was an amazing read. To a large degree my package is simply a port of
that project from x86 assembly + forth to julia + forth, although the mapping
is in a few places non-trivial due to the fact that julia is a high level
## Installation
forth.jl is not (and probably will never be) a registered julia package. To
-install it, you will therefore need to use the following command:
+install it, you will therefore need to use the following command from the
+Julia package manager (accessed using the `]` key):
- julia> Pkg.clone("https://github.com/tgvaughan/forth.jl")
+ (v1.0) pkg> add https://github.com/tgvaughan/forth.jl
+
+Be aware that **forth.jl requires Julia 1.0**.
## Usage
star * ok
There's an example Mandelbrot Set drawing program included in the examples
-directory. To run it, use the `INCLUDE` word to open the file and compile its
-definitions. Although the exact location of the examples directory in your
-filesystem is platform dependent, `INCLUDE` includes the forth.jl src/ directory
-in its search path so the following should always work:
+directory. To run it, use the `INCLUDE-LIB` word to open the file and compile its
+definitions:
- include ../examples/mandelbrot.4th
+ include-lib ../examples/mandelbrot.4th
Enter 'mandel' to draw the Mandelbrot Set. ok
mandel
*
**
ok
-To exit, enter ^D on a blank line or use the `BYE` word.
+(`INCLUDE-LIB` is exactly like INCLUDE, but includes files relative to thte
+platform-dependent forth.jl src/ directory.) To exit, enter ^D on a blank line
+or use the `BYE` word.
## FORTH-83 Compliance