Miroirs/planckforth
1
0
Fork 0
mirror of https://github.com/nineties/planckforth synced 2025-01-13 08:01:10 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README

Browse source
This commit is contained in:
Koichi Nakamura 2021-01-02 13:01:31 +09:00
parent 5d5bf83a5a
commit 92356901a3
1 changed files with 28 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
README.md
View file

@ -1,10 +1,37 @@
# PlanckForth: Bootstrapping Forth from Handwritten Executable # PlanckForth: Bootstrapping Forth from Handwritten Executable
This project aims to create a Forth interpreter
by bootstrapping from hand-written tiny ELF binary.
## How to build
You can create a binary for x86 linux environment by following steps.
Only `xxd` is needed to build PlanckForth.
``` ```
$ git clone https://github.com/nineties/planckforth.git $ git clone https://github.com/nineties/planckforth.git
$ cd planckforth $ cd planckforth
$ make $ make
$ cat helloworld.fs | ./planck xxd -r -c 8 planck.xxd > planck
chmod +x planck
```
## Hello World
The hello world program at the beginning looks like this.
```
% ./planck
kHtketkltkltkotk tkWtkotkrtkltkdtk!tk:k0-tQ
Hello World!
```
After bootstrapping by `bootstrapping.fs`, it looks like this.
```
$ cat bootstrap.fs - | ./planck
." Hello World!" cr
Hello World!
bye
``` ```
# Builtin Words # Builtin Words