Skip to content

Commit

Permalink
Document the metacompiling build process.
Browse files Browse the repository at this point in the history
  • Loading branch information
larsbrinkhoff committed May 12, 2017
1 parent 6fefa7d commit 42a965c
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions doc/build.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
This describes how lbForth is normally built.

- To build a target, load its build.fth file. Every target should
have one.

- build.fth sets up some information about the target, and loads the
generic compile.fth.

- compile.fth loads the generic metacompiler framework.

- The generic metacompiler loads a library for accessing a target image.

- And creates vocabularies for metacompiling words.

- compile.fth proceeds to add metacompiling words that target lbForth.

- And a target assembler.

- It then loads kernel.fth and cold.fth to build a target image.

- Finally, forward references are resolved, and the image is saved to
disk.

0 comments on commit 42a965c

Please sign in to comment.