Fix more typos in documentation.
parent
6d3f3390de
commit
f8a44f947b
|
@ -74,7 +74,7 @@ Added program to search for unusual characters that are not human detectable
|
|||
Expanded stage0 web IDE to include the PC and instruction counter
|
||||
Performance tuned hex1 to reduce both size and instruction count
|
||||
Performance tuned hex0 to reduce both size and instruction count
|
||||
Performance tuned hex2 to reduce both size and isntruction count
|
||||
Performance tuned hex2 to reduce both size and instruction count
|
||||
The stage0 vm now halts on ALL invalid instructions
|
||||
Displacements in the Stage0-vm no longer match that of the Knight hardware platform; instead of from the start of the instruction, from the end of the immediate to the target address.
|
||||
The Stage0-vm has relocated the 2OPI and 1OPI instructions and adjusted their encodings accordingly to simplify instruction size logic.
|
||||
|
|
12
README
12
README
|
@ -85,7 +85,7 @@ Its functionality is reduced compared to the stage0 monitor simply because it
|
|||
only performs half of the required functions; that of generating binaries from
|
||||
hex0 source files.
|
||||
|
||||
It most important features of note are:
|
||||
Its most important features of note are:
|
||||
; line comments and
|
||||
# line comments
|
||||
As careful notes are essential for this stage.
|
||||
|
@ -99,7 +99,7 @@ Further because of the mescc-tools standardization of syntax @label indicates a
|
|||
16bit relative displacement.
|
||||
|
||||
Alternative architectures porting this need not limit themselves to 16bit
|
||||
displacements should they so choose, rather they must provide atleast 1 size
|
||||
displacements should they so choose, rather they must provide at least 1 size
|
||||
of displacement or if they so desire, they may skip and write their Hex2
|
||||
assembler in Hex0 but as it is a much larger program, I recommend against it.
|
||||
|
||||
|
@ -130,9 +130,9 @@ definition)
|
|||
2) "Raw strings" allow every character except " as there is no support for
|
||||
string escapes, including NULL; which are converted to Hex chars for Hex2
|
||||
To convert back to the chars inside of the "quotes" with the addition of a
|
||||
trailing NULL character or the number desired (Must be atleast 1, no upper
|
||||
bound) and restrictions such as padding to word boundries are accetpable.
|
||||
3) 'Raw char strings' will passing anything inside of them (except ' which
|
||||
trailing NULL character or the number desired (Must be at least 1, no upper
|
||||
bound) and restrictions such as padding to word boundaries are acceptable.
|
||||
3) 'Raw char strings' will be passing anything inside of them (except ' which
|
||||
terminates the string).
|
||||
|
||||
Thus by combining :label, @label, DEFINE SYSCALL 0F05, Raw strings and chars;
|
||||
|
@ -151,7 +151,7 @@ the time and effort was put forth by Caleb and Jeremiah to provide a framework
|
|||
for those people to contribute immediately; thus the FORTH was born.
|
||||
|
||||
Several efforts were taken to make the FORTH more standard but ultimately it was
|
||||
determined, Assembly was preferable as the underlaying architecture wasn't total
|
||||
determined, Assembly was preferable as the underlying architecture wasn't total
|
||||
garbage.
|
||||
|
||||
It now sits waiting for any FORTH programmer who wishes to prove FORTH is a real
|
||||
|
|
|
@ -18,14 +18,14 @@
|
|||
These notes exist for those people who want to independently create their own bootstrap tree.
|
||||
Those wishing to save themselves decades of work, would be wise to use the below information and
|
||||
Plan on making the following tools:
|
||||
Hex Monitor with writes out binaries to external storage medium and Text input into another
|
||||
Hex Monitor which writes out binaries to external storage medium and Text input into another
|
||||
A Loader (especially on platforms that have a 512byte bootloader limitation)
|
||||
A Line Text editor (because perfect typing is hard)
|
||||
A hex/octal assembler (So that you will not need the Hex Monitor any further)
|
||||
An improved hex/octal assembler that supports labels and calculation of relative and absolute addresses
|
||||
A Cat equivelent (Because definition files are awesome)
|
||||
A Less equivelent (Because you want to be able to just read your written code)
|
||||
A line macro program (Because Hex mnemonics suck and ADD32I are alot easier to identify)
|
||||
A Cat equivalent (Because definition files are awesome)
|
||||
A Less equivalent (Because you want to be able to just read your written code)
|
||||
A line macro program (Because Hex mnemonics suck and ADD32I are a lot easier to identify)
|
||||
The stage0-vm in assembly or a compiler/interpreter for the higher language of your choice you plan on leveraging to implement the stage0-vm
|
||||
|
||||
* Platform specific information
|
||||
|
@ -50,13 +50,13 @@ things as assemblers and C compilers that hide most of the horrible darkness fro
|
|||
|
||||
*** Restart code
|
||||
To restart the segment loaded from the bootsector:
|
||||
| Hex | Assembly Equivelent |
|
||||
| Hex | Assembly Equivalent |
|
||||
|--------+---------------------|
|
||||
| 68007C | push 7C00 |
|
||||
| C3 | ret |
|
||||
|
||||
For an intersegment restart:
|
||||
| Hex | Assembly Equivelent |
|
||||
| Hex | Assembly Equivalent |
|
||||
|--------+---------------------|
|
||||
| 6A00 | push 0 |
|
||||
| 68007C | push 7C00 |
|
||||
|
@ -105,7 +105,7 @@ By writing the stage 0 code in commented hex, it becomes possible for universal
|
|||
|
||||
The only real problem is that the commented hex has to be manually validated [An insanely painful process] and each and every single platform has to perform the exact same tasks.
|
||||
|
||||
Since all such projects have to start somewhere, I have choosen to do it myself and with the 8088.
|
||||
Since all such projects have to start somewhere, I have chosen to do it myself and with the 8088.
|
||||
|
||||
To make my work easier, I first created the working code in 16bit assembly.
|
||||
|
||||
|
@ -115,10 +115,10 @@ What I however require is someone with a completely alien platform verify the co
|
|||
|
||||
Which is listed along with all of the checksums of the validated binaries produced thus far in the file Checksums.org
|
||||
|
||||
If your compiled hex is different in any way, please let me know as the process should produce bit idential binaries.
|
||||
If your compiled hex is different in any way, please let me know as the process should produce bit identical binaries.
|
||||
|
||||
** Stage 1
|
||||
Stage 1 attempts to save myself from alot of manual typing and the inevitable errors that occur.
|
||||
Stage 1 attempts to save myself from a lot of manual typing and the inevitable errors that occur.
|
||||
|
||||
It simply provides the functionality required to produce 32KB or smaller binaries from Commented Hex files.
|
||||
|
||||
|
@ -133,6 +133,6 @@ However despite those stupid limitations, they have saved alot of manual work co
|
|||
Having these binaries are a huge step forward compared to not having them but they assume you don't make mistakes.
|
||||
|
||||
** Stage 2
|
||||
Stage 2 will be introducing enhancements to Stage 1 programs that allow you to fix the problems you accidentially introduce.
|
||||
Stage 2 will be introducing enhancements to Stage 1 programs that allow you to fix the problems you accidentally introduce.
|
||||
|
||||
We will also begin to introduce programs that make software development alot easier.
|
||||
We will also begin to introduce programs that make software development a lot easier.
|
||||
|
|
Loading…
Reference in New Issue