github.com/PDP-10.its
1
0
Fork 0
mirror of https://github.com/PDP-10/its.git synced 2026-01-26 04:02:06 +00:00
Code Issues Releases Wiki Activity

Update the markdown files.

Browse Source 
Use <kbd> and ◊.
This commit is contained in:
Lars Brinkhoff
2018-07-29 11:33:18 +02:00
parent a4e8a6732b
commit be05047e61
5 changed files with 93 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
doc/DDT.md
View File

@@ -1,36 +1,45 @@
## DDT cheat sheet for Unix users
To get access to a terminal, first type ^Z (Control-Z). After that,
you can log in.
To get access to a terminal, first type <kbd>^Z</kbd> (Control-Z).
After that, you can log in.
The `$` character represents typing ESC.
The ◊ character represents typing <kbd>ESC</kbd>, or holding down the
<kbd>Meta</kbd> key. On a text terminal, it will show up as `$`.
| Unix command | DDT command | Colon command |
| ------------- | -------------------- | ------------------------ |
| login user | user$u | :login user |
| logout | $$u | :logout |
| login user | user◊u | :login user |
| logout | ◊◊u | :logout |
| TERM=vt52 | | :tctyp vt52 |
| TERM=vt100 | | :crtsty vt100 |
| ls | ^F | :listf |
| ls dir | dir^F | :listf dir |
| ls / | ^R m.f.d. (file) | :print m.f.d. (file) |
| ls *.foo | ^R dir: second foo | :print dir: second foo |
| more file | ^R file | :print file |
| mkdir dir | ^R dir;..new. (udir) | :print dir;..new. (udir) |
| cd dir | dir$$s | :cwd dir |
| cp f1 f2 | $^R f1,f2 | :copy f1,f2 |
| rm file | ^O file | :delete file |
| ln f1 f2 | $^O f1,f2 | :link f1,f2 |
| mv f1 f2 | $$^O f1,f2 | :rename f1,f2 |
| TERM=vt100 | | :tctyp aaa |
| TERM=ansi | | :crtsty ansi |
| clear | <kbd>^L</kbd> | :clear |
| ls | <kbd>^F</kbd> | :listf |
| ls -l | ◊◊<kbd>^F</kbd> | :lf |
| ls dir | dir<kbd>^F</kbd> | :listf dir |
| ls / | <kbd>^R</kbd> m.f.d. (file) | :print m.f.d. (file) |
| ls *.foo | <kbd>^R</kbd> dir: second foo | :print dir: second foo |
| more file | <kbd>^R</kbd> file | :print file |
| mkdir dir | <kbd>^R</kbd> dir;..new. (udir) | :print dir;..new. (udir) |
| cd dir | dir◊<kbd>^S</kbd> | :cwd dir |
| /foo/bar | | :foo;bar |
| cp f1 f2 | ◊<kbd>^R</kbd> f1,f2 | :copy f1,f2 |
| rm file | <kbd>^O</kbd> file | :delete file |
| ln f1 f2 | ◊<kbd>^O</kbd> f1,f2 | :link f1,f2 |
| mv f1 f2 | ◊◊<kbd>^O</kbd> f1,f2 | :rename f1,f2 |
| mv file dir | | :move file,dir |
| emacs | emacs^K | :emacs |
| ps | $$v | :listj |
| kill pid | pid$^X | :job pid :kill |
| sudo -u u cmd | u$^S cmd | |
| top | | :peek |
| ^U | ^D | |
| ^C | ^G | |
| ^Z | ^Z | |
| ^D | ^C | |
| fg | $P | :continue |
| bg | ^P | :proceed |
| emacs | emacs<kbd>^K</kbd> | :emacs |
| ps | ◊◊v | :listj |
| kill pid | pid◊<kbd>^X</kbd> | :job pid *then* :kill |
| kill -9 pid | | :lock *then* pid gun |
| sudo -u u cmd | u◊◊<kbd>^S</kbd> cmd | |
| top | peek<kbd>^H</kbd> | :peek |
| <kbd>^U</kbd> | <kbd>^D</kbd> | |
| <kbd>^C</kbd> | <kbd>^G</kbd> | |
| <kbd>^Z</kbd> | <kbd>^Z</kbd> | |
| <kbd>^D</kbd> | <kbd>^C</kbd> | |
| fg | ◊P | :continue |
| bg | <kbd>^P</kbd> | :proceed |
| man 2 open | | :call open |
| dmesg | | :sysmsg |
| uptime | | :time |

24
doc/EMACS.md
View File

@@ -1,14 +1,14 @@
## Basic editing with EMACS
- ^X^F *file* CR - load file
- ^X^S *file* CR - save file
- ^X^C - exit (but don't kill emacs)
- ^F - move cursor right (forward)
- ^B - move cursor left (backward)
- ^A - beginning of line
- ^E - end of line
- ^N - go to next line
- ^P - go to previous line
- ^D - delete character to the right
- DEL - delete character to the left
- ^K - delete to end of line
- <kbd>^X</kbd><kbd>^F</kbd> *file* <kbd>CR</kbd> - load file
- <kbd>^X</kbd><kbd>^S</kbd> *file* <kbd>CR</kbd> - save file
- <kbd>^X</kbd><kbd>^C</kbd> - exit (but don't kill emacs)
- <kbd>^F</kbd> - move cursor right (forward)
- <kbd>^B</kbd> - move cursor left (backward)
- <kbd>^A</kbd> - beginning of line
- <kbd>^E</kbd> - end of line
- <kbd>^N</kbd> - go to next line
- <kbd>^P</kbd> - go to previous line
- <kbd>^D</kbd> - delete character to the right
- <kbd>DEL</kbd> - delete character to the left
- <kbd>^K</kbd> - delete to end of line

31
doc/TECO.md
View File

@@ -1,15 +1,22 @@
## TECO survival guide
Note: all commands must be terminated by $$ to execute them.
Note: ◊ is the SAIL rendition of the Altmode character. It's used by
the Knight TV and SUPDUP. On a text terminal, it will show up as `$`.
- ER*file*$@Y - load file
- EIEE*file*$ - save file
- ^Z - suspend
- *n*R - move cursor left
- *n*C - move cursor right
- 0L - beginning of line
- :L - end of line
- *n*L - beginning of *n*th line from the current position
- I*text*$ - insert text
- *n*D - delete *n* characters to the right
- K - delete to end of line
All commands must be terminated by ◊◊ to execute them. You can enter
several commands in a row.
| Command | Function
| --- | ---
| ER *file*◊ @Y | Load file
| EIEE *file*◊ | Save file
| <kbd>^Z</kbd> | Suspend
| *n* R | Move cursor left
| *n* C | Move cursor right
| 0L | Beginning of line
| :L | End of line
| *n* L | Beginning of *n*th line from the current position
| I *text*◊ | Insert text
| *n* D | Delete *n* characters to the right
| -*n* D | Delete *n* characters to the left
| K | Delete to end of line

46
doc/debugging.md
View File

@@ -4,30 +4,30 @@ Notes where exec DDT differs from timesharing DDT.
| Command | Timesharing DDT | Exec DDT
| --- | --- | ---
| *file*^K | Start program without symbols loaded | N/A
| ^Z | Suspend program | N/A
| $P | Continue
| $^K | Load symbols | N/A
| *name*$J | Create job named *name* | N/A
| $L *file* | Load *file* into current job, including symbols | N/A
| $^X. | Kill current job | N/A
| $G | Run program from start
| $0G | Set PC to starting address | N/A
| *n*$B | Set breakpoint at *n*
| $B | Remove breakpoint at current location | Remove all breakpoints
| .$B | Set breakpoint at current location
| *file*<kbd>^K</kbd> | Start program without symbols loaded | N/A
| <kbd>^Z</kbd> | Suspend program | N/A
| ◊P | Continue
| ◊<kbd>^K</kbd> | Load symbols | N/A
| *name*◊J | Create job named *name* | N/A
| ◊L *file* | Load *file* into current job, including symbols | N/A
| ◊<kbd>^X</kbd>. | Kill current job | N/A
| ◊G | Run program from start
| ◊0G | Set PC to starting address | N/A
| *n*◊B | Set breakpoint at *n*
| ◊B | Remove breakpoint at current location | Remove all breakpoints
| .◊B | Set breakpoint at current location
| . | Current location
| $. | Current value of PC
| $Q | Last printed quantity
| ◊. | Current value of PC
| ◊Q | Last printed quantity
| *n*/ | Open location *n* symbolically (show instructions and symbols)
| / | Open $Q
| ^J | Open next location
| / | Open ◊Q
| <kbd>^J</kbd> | Open next location
| ^ | Open previous location
| *n*[ | Open location *n* numerically
| = | Print $Q numerically
| _ | Print $Q as a symbol
| ' | Print $Q as six SIXBIT characters
| " | Print $Q as five ASCII characters
| # | Print $Q as one ASCII character | N/A
| ^N | Single step | N/A
| $^N | Stop at next instruction (skip over calls) | N/A
| = | Print ◊Q numerically
| _ | Print ◊Q as a symbol
| ' | Print ◊Q as six SIXBIT characters
| " | Print ◊Q as five ASCII characters
| # | Print ◊Q as one ASCII character | N/A
| <kbd>^N</kbd> | Single step | N/A
| ◊<kbd>^N</kbd> | Stop at next instruction (skip over calls) | N/A

4
doc/hello-midas.md
View File

@@ -26,13 +26,13 @@ Step by step guide on how to create a hello world in MIDAS.
end start ;Specify entry point.
```
3. Save it as `hello 1` (^X^S) and exit (^X^C).
3. Save it as `hello 1` (<kbd>^X</kbd><kbd>^S</kbd>) and exit (<kbd>^X</kbd><kbd>^C</kbd>).
4. Assemble it with MIDAS.
:midas ts hello_hello
5. Go back to EMACS with $P if you need to do edits.
5. Go back to EMACS with ◊P if you need to do edits.
6. Run the program.