Reword the readme slightly in Gidubba and convert the readme, license, and source code t a Gidubba-friendly format
This commit is contained in:
parent
509c10cc70
commit
955992988c
2953
gidubba.asm
2953
gidubba.asm
File diff suppressed because it is too large
Load Diff
47
license.md
47
license.md
|
@ -1,23 +1,24 @@
|
||||||
MIT License
|
MIT License
|
||||||
===========
|
===========
|
||||||
|
|
||||||
Copyright (c) 2022
|
Copyright (c) 2022
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a
|
Permission is hereby granted, free of charge, to any person obtaining a
|
||||||
copy of this software and associated documentation files (the
|
copy of this software and associated documentation files (the
|
||||||
"Software"), to deal in the Software without restriction, including
|
"Software"), to deal in the Software without restriction, including
|
||||||
without limitation the rights to use, copy, modify, merge, publish,
|
without limitation the rights to use, copy, modify, merge, publish,
|
||||||
distribute, sublicense, and/or sell copies of the Software, and to
|
distribute, sublicense, and/or sell copies of the Software, and to
|
||||||
permit persons to whom the Software is furnished to do so, subject to
|
permit persons to whom the Software is furnished to do so, subject to
|
||||||
the following conditions:
|
the following conditions:
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included
|
The above copyright notice and this permission notice shall be included
|
||||||
in all copies or substantial portions of the Software.
|
in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
||||||
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||||
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||||
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||||
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||||
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||||
|
|
87
readme.md
87
readme.md
|
@ -1,43 +1,44 @@
|
||||||
Gidubba
|
Gidubba
|
||||||
========
|
========
|
||||||
|
|
||||||
Gidubba (Sumerian for 'stylus') is a simple line editor for the
|
Gidubba (Sumerian for 'stylus') is a simple line editor for the
|
||||||
Thingamajig computer architecture. Its git repository can be found at
|
Thingamajig computer architecture. Its git repository can be found at
|
||||||
https://ahti.space/git/crazyettin/Gidubba and that of Thingamajig at
|
https://ahti.space/git/crazyettin/Gidubba and that of Thingamajig at
|
||||||
https://ahti.space/git/crazyettin/Thingamajig.
|
https://ahti.space/git/crazyettin/Thingamajig.
|
||||||
|
|
||||||
System requirements
|
System requirements
|
||||||
-------------------
|
-------------------
|
||||||
|
|
||||||
Gidubba requires a terminal with local echo at address FFFF and
|
Gidubba requires a terminal with local echo at address FFFF and
|
||||||
optionally a line printer at address FFFE and a punched tape reader and
|
optionally a line printer at address FFFE and a punched tape reader and
|
||||||
punch at FFFD. If your setup differs from this you may have to modify
|
punch at FFFD. If your setup differs from this you may have to modify
|
||||||
the code yourself.
|
the code yourself.
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
-----
|
-----
|
||||||
|
|
||||||
The commands are individual letters that can be followed by one or two
|
The commands are individual letters that can be followed by one or two
|
||||||
arguments separated by a comma. The first argument is a target line
|
arguments separated by a comma. The first argument is a target line
|
||||||
number between 0 and FFFF and the second the range of lines between 0
|
number between 0 and FFFF and the second the range of lines between 0
|
||||||
and FF the command affects. Inserting lines to a target that does not
|
and FF the command affects. Inserting lines to a target that does not
|
||||||
exist or the shortcut hash (#) appends them to the text; otherwise
|
exist or the shortcut hash (#) appends them to the text; otherwise
|
||||||
targets or parts of ranges that do not exist are ignored.
|
targets or parts of ranges that do not exist are ignored.
|
||||||
|
|
||||||
Commands with a single argument:
|
Commands with a single argument:
|
||||||
* I: Insert a line or lines
|
* I: Insert a line or lines
|
||||||
|
|
||||||
Commands with two arguments:
|
Commands with two arguments:
|
||||||
* D: Delete a line
|
* D: Delete a line
|
||||||
* L: List a line
|
* L: List a line
|
||||||
|
|
||||||
Commands with no argument:
|
Commands with no argument:
|
||||||
* P: Print (requires a printer)
|
* P: Print
|
||||||
* W: Writes to tape (requires a tape punch)
|
* R: Read from the tape reader
|
||||||
* R: Reads from tape (requires a tape reader)
|
* W: Write to the tape punch
|
||||||
* H: Halt
|
* H: Halt
|
||||||
|
|
||||||
Both commands and arguments are case-insensitive. In both the command
|
Both commands and arguments are case-insensitive. In both the command
|
||||||
prompt as well as when inserting lines sending an escape (^[) will allow
|
prompt as well as when inserting lines sending an escape (^[) will allow
|
||||||
retyping the line in question. To finish inserting lines send a
|
retyping the line in question. To finish inserting lines send a
|
||||||
substitute (^Z): the line on which this is done is not saved.
|
substitute (^Z): the line on which this is done is not saved.
|
||||||
|
|
Loading…
Reference in New Issue