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
One of my goals has been to have forth.jl contain as much of the
[F83 required word set](http://forth.sourceforge.net/standard/fst83/fst83-12.htm)
as makes sense given the underlying VM. (Actually, my main goal goes a bit
-beyond this: I want to be able to, with a couple of exceptions, be compatible
+beyond this: I want to forth.jl to be, with a couple of exceptions, compatible
with the description of forth contained in the second edition of Leo Brodie's
book "Starting Forth".) I'm fairly happy with my progress so far. Of the
131 required F83 words, only 20 remain unimplemented. These words fall into