... a bootstrapping path to a C compiler capable of
Compiling GCC, with only the explicit requirement of a single 1 KByte binary or less.

Jeremiah Orians d3bed26e0a Correcting error in string output and avoiding segment faults in vm 7 years ago
High_level_prototypes d3bed26e0a Correcting error in string output and avoiding segment faults in vm 7 years ago
Library function prototypes 87477db7eb Added requested Copyright notices 7 years ago
Linux Bootstrap ba9bb0ba29 Fixed formatting and added function to makefile 7 years ago
public 87477db7eb Added requested Copyright notices 7 years ago
stage0 87477db7eb Added requested Copyright notices 7 years ago
stage1 87477db7eb Added requested Copyright notices 7 years ago
stage2 4963fcfebc Implemented graceful FAILURE and PRINT 7 years ago
stage3 1a6c7d5afe Fix CREATE, implement DOES>, more words 7 years ago
test 4963fcfebc Implemented graceful FAILURE and PRINT 7 years ago
x86 009b02ade7 Moved the x86 notes into the x86 folder 7 years ago
.gitignore b3eedb60de Refining FORTH to enable more productive development 7 years ago
CHANGELOG.org d3bed26e0a Correcting error in string output and avoiding segment faults in vm 7 years ago
Checksums.org 87477db7eb Added requested Copyright notices 7 years ago
HACKING 5da990898d Added organizational hacking guide 7 years ago
ISA_HEX_Map.org db2bc37f1d Release 0.0.8 7 years ago
Knight.py 87477db7eb Added requested Copyright notices 7 years ago
LICENSE 4c307c763c Incorporated official GPL license 7 years ago
README 9c9b810c89 Improving documentation 7 years ago
User_Interface.py 6c1c1cf0e3 Modified webIDE to use new and improved disassembler output 7 years ago
Web Interface prototype Generator.py 87477db7eb Added requested Copyright notices 7 years ago
bootstrapping Steps.org 4963fcfebc Implemented graceful FAILURE and PRINT 7 years ago
dynamic_execution_trace.c 87477db7eb Added requested Copyright notices 7 years ago
makefile fefe1ddbe2 Removed questions about High level prototype build process 7 years ago
tty.c 87477db7eb Added requested Copyright notices 7 years ago
vm.c d3bed26e0a Correcting error in string output and avoiding segment faults in vm 7 years ago
vm.h db2bc37f1d Release 0.0.8 7 years ago
vm_decode.c db2bc37f1d Release 0.0.8 7 years ago
vm_instructions.c db2bc37f1d Release 0.0.8 7 years ago
vm_minimal.c c369c9c492 Improved vm scriptability and broke out a minimal vm definition for people wishing to keep implementation trivial 7 years ago
wrapper.c cec59e8860 Fixed web debugger regression 7 years ago

README

## Copyright (C) 2016 Jeremiah Orians
## This file is part of stage0.
##
## stage0 is free software: you an redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation, either version 3 of the License, or
## (at your option) any later version.
##
## stage0 is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with stage0. If not, see .

The master repository for this work is located at:
https://savannah.nongnu.org/projects/stage0/

This is a set of manually created hex programs in a Cthulhu Path to madness fashion.
Which only have the goal of creating a bootstrapping path to a C compiler capable of
Compiling GCC, with only the explicit requirement of a single 1 KByte binary or less.

Additionally, all code must be able to be understood by 70% of the population of programmers.
If the code can not be understood by that volume, it needs to be altered until it satifies the above requirement.

This repo contains a few of my false start pieces that may be of interest to people who
want to independently create the root binary, I welcome all bug fixes and code that aids
in the above stated goal.

I'll be adding more code and documentation as I build pieces.
ALL code in this REPO is under the GPLv3 or Later.

In order to build stage0 and all the pieces, one only needs to run make all.
Each individual piece can be built by simply running make $piece with $piece being replaced by the actual part you want to make.

The only pieces that have any external dependencies are the Web IDE (Python3+CherryPy), libvm (GCC) and vm (GCC+GNU getopt)