Fix more typos in documentation.
This commit is contained in:
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
|
Expanded stage0 web IDE to include the PC and instruction counter
|
||||||
Performance tuned hex1 to reduce both size and instruction count
|
Performance tuned hex1 to reduce both size and instruction count
|
||||||
Performance tuned hex0 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
|
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.
|
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.
|
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
|
only performs half of the required functions; that of generating binaries from
|
||||||
hex0 source files.
|
hex0 source files.
|
||||||
|
|
||||||
It most important features of note are:
|
Its most important features of note are:
|
||||||
; line comments and
|
; line comments and
|
||||||
# line comments
|
# line comments
|
||||||
As careful notes are essential for this stage.
|
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.
|
16bit relative displacement.
|
||||||
|
|
||||||
Alternative architectures porting this need not limit themselves to 16bit
|
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
|
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.
|
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
|
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
|
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
|
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
|
trailing NULL character or the number desired (Must be at least 1, no upper
|
||||||
bound) and restrictions such as padding to word boundries are accetpable.
|
bound) and restrictions such as padding to word boundaries are acceptable.
|
||||||
3) 'Raw char strings' will passing anything inside of them (except ' which
|
3) 'Raw char strings' will be passing anything inside of them (except ' which
|
||||||
terminates the string).
|
terminates the string).
|
||||||
|
|
||||||
Thus by combining :label, @label, DEFINE SYSCALL 0F05, Raw strings and chars;
|
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.
|
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
|
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.
|
garbage.
|
||||||
|
|
||||||
It now sits waiting for any FORTH programmer who wishes to prove FORTH is a real
|
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.
|
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
|
Those wishing to save themselves decades of work, would be wise to use the below information and
|
||||||
Plan on making the following tools:
|
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 Loader (especially on platforms that have a 512byte bootloader limitation)
|
||||||
A Line Text editor (because perfect typing is hard)
|
A Line Text editor (because perfect typing is hard)
|
||||||
A hex/octal assembler (So that you will not need the Hex Monitor any further)
|
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
|
An improved hex/octal assembler that supports labels and calculation of relative and absolute addresses
|
||||||
A Cat equivelent (Because definition files are awesome)
|
A Cat equivalent (Because definition files are awesome)
|
||||||
A Less equivelent (Because you want to be able to just read your written code)
|
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 alot easier to identify)
|
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
|
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
|
* Platform specific information
|
||||||
|
@ -50,13 +50,13 @@ things as assemblers and C compilers that hide most of the horrible darkness fro
|
||||||
|
|
||||||
*** Restart code
|
*** Restart code
|
||||||
To restart the segment loaded from the bootsector:
|
To restart the segment loaded from the bootsector:
|
||||||
| Hex | Assembly Equivelent |
|
| Hex | Assembly Equivalent |
|
||||||
|--------+---------------------|
|
|--------+---------------------|
|
||||||
| 68007C | push 7C00 |
|
| 68007C | push 7C00 |
|
||||||
| C3 | ret |
|
| C3 | ret |
|
||||||
|
|
||||||
For an intersegment restart:
|
For an intersegment restart:
|
||||||
| Hex | Assembly Equivelent |
|
| Hex | Assembly Equivalent |
|
||||||
|--------+---------------------|
|
|--------+---------------------|
|
||||||
| 6A00 | push 0 |
|
| 6A00 | push 0 |
|
||||||
| 68007C | push 7C00 |
|
| 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.
|
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.
|
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
|
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
|
||||||
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.
|
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.
|
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
|
||||||
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