Artifact
ffe3d41b14d82cb8e50ee3a67e578bcc8d5911b1:
Wiki page
[Getting Text In] by
tangent
2019-03-29 22:39:44.
0000: 44 20 32 30 31 39 2d 30 33 2d 32 39 54 32 32 3a D 2019-03-29T22:
0010: 33 39 3a 34 34 2e 31 30 35 0a 4c 20 47 65 74 74 39:44.105.L Gett
0020: 69 6e 67 5c 73 54 65 78 74 5c 73 49 6e 0a 4e 20 ing\sText\sIn.N
0030: 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 6e 0a text/x-markdown.
0040: 50 20 35 36 35 34 39 65 61 63 65 32 31 33 32 37 P 56549eace21327
0050: 30 64 39 32 31 62 35 34 38 62 39 66 35 39 61 62 0d921b548b9f59ab
0060: 37 62 37 36 32 38 64 64 65 62 0a 55 20 74 61 6e 7b7628ddeb.U tan
0070: 67 65 6e 74 0a 57 20 37 37 34 37 0a 23 20 49 6e gent.W 7747.# In
0080: 74 72 6f 64 75 63 74 69 6f 6e 0d 0a 0d 0a 54 68 troduction....Th
0090: 65 72 65 20 61 72 65 20 6d 61 6e 79 20 63 61 73 ere are many cas
00a0: 65 73 20 77 68 65 6e 20 77 6f 72 6b 69 6e 67 20 es when working
00b0: 77 69 74 68 20 74 68 65 20 50 69 44 50 2d 38 2f with the PiDP-8/
00c0: 49 20 77 68 65 72 65 20 74 68 65 20 66 69 72 73 I where the firs
00d0: 74 20 70 72 6f 62 6c 65 6d 20 79 6f 75 20 68 61 t problem you ha
00e0: 76 65 20 74 6f 20 73 6f 6c 76 65 20 69 73 20 67 ve to solve is g
00f0: 65 74 74 69 6e 67 20 73 6f 6d 65 20 73 75 62 73 etting some subs
0100: 74 61 6e 74 69 61 6c 20 62 6f 64 79 20 6f 66 20 tantial body of
0110: 74 65 78 74 20 69 6e 74 6f 20 74 68 65 20 73 69 text into the si
0120: 6d 75 6c 61 74 69 6f 6e 2e 20 54 68 69 73 20 61 mulation. This a
0130: 72 74 69 63 6c 65 20 63 6f 6c 6c 65 63 74 73 20 rticle collects
0140: 6d 61 6e 79 20 6f 66 20 74 68 65 73 65 20 6d 65 many of these me
0150: 74 68 6f 64 73 2c 20 62 65 63 61 75 73 65 20 6d thods, because m
0160: 61 6e 79 20 6f 66 20 74 68 65 6d 20 77 6f 72 6b any of them work
0170: 20 61 63 72 6f 73 73 20 6d 75 6c 74 69 70 6c 65 across multiple
0180: 20 73 6f 66 74 77 61 72 65 20 73 79 73 74 65 6d software system
0190: 73 2c 20 73 6f 20 61 20 63 65 6e 74 72 61 6c 20 s, so a central
01a0: 72 65 73 6f 75 72 63 65 20 69 73 20 77 61 6e 74 resource is want
01b0: 65 64 2e 0d 0a 0d 0a 0d 0a 23 20 3c 61 20 69 64 ed.......# <a id
01c0: 3d 22 73 73 68 22 3e 3c 2f 61 3e 53 53 48 0d 0a ="ssh"></a>SSH..
01d0: 0d 0a 4f 6e 65 20 6d 65 74 68 6f 64 20 69 73 20 ..One method is
01e0: 74 6f 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 74 to make use of t
01f0: 68 65 20 66 61 63 74 20 74 68 61 74 20 6d 61 6e he fact that man
0200: 79 20 50 69 44 50 2d 38 2f 49 20 62 75 69 6c 64 y PiDP-8/I build
0210: 73 20 77 69 6c 6c 20 62 65 20 62 61 73 65 64 20 s will be based
0220: 6f 6e 20 61 20 6e 65 74 77 6f 72 6b 65 64 20 50 on a networked P
0230: 69 2c 20 77 68 69 63 68 20 70 72 65 74 74 79 20 i, which pretty
0240: 6d 75 63 68 20 65 78 63 6c 75 64 65 73 20 6f 6e much excludes on
0250: 6c 79 20 74 68 65 20 50 69 20 41 2b 20 61 6e 64 ly the Pi A+ and
0260: 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 76 65 the original ve
0270: 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 50 69 20 rsion of the Pi
0280: 5a 65 72 6f 2c 20 61 6e 64 20 74 68 65 6e 20 6f Zero, and then o
0290: 6e 6c 79 20 69 66 20 79 6f 75 20 68 61 76 65 6e nly if you haven
02a0: 27 74 20 66 69 78 65 64 20 74 68 65 20 6c 61 63 't fixed the lac
02b0: 6b 20 62 79 20 61 64 64 69 6e 67 20 61 20 55 53 k by adding a US
02c0: 42 20 6e 65 74 77 6f 72 6b 20 61 64 61 70 74 65 B network adapte
02d0: 72 2e 20 0d 0a 0d 0a 54 68 65 20 5b 62 69 6e 61 r. ....The [bina
02e0: 72 79 20 4f 53 20 69 6d 61 67 65 73 5d 28 2f 29 ry OS images](/)
02f0: 20 73 68 69 70 70 65 64 20 62 79 20 74 68 69 73 shipped by this
0300: 20 70 72 6f 6a 65 63 74 20 68 61 76 65 20 53 53 project have SS
0310: 48 20 65 6e 61 62 6c 65 64 20 61 6e 64 20 6c 69 H enabled and li
0320: 73 74 65 6e 69 6e 67 20 62 79 20 64 65 66 61 75 stening by defau
0330: 6c 74 2c 20 62 75 74 20 69 66 20 79 6f 75 27 76 lt, but if you'v
0340: 65 20 62 61 73 65 64 20 79 6f 75 72 20 50 69 44 e based your PiD
0350: 50 2d 38 2f 49 20 6f 6e 20 61 20 64 69 66 66 65 P-8/I on a diffe
0360: 72 65 6e 74 20 50 69 20 4f 53 20 74 68 61 74 20 rent Pi OS that
0370: 64 6f 65 73 20 6e 6f 74 20 65 6e 61 62 6c 65 20 does not enable
0380: 53 53 48 20 62 79 20 64 65 66 61 75 6c 74 2c 20 SSH by default,
0390: 69 74 27 73 20 65 61 73 79 20 74 6f 20 66 69 78 it's easy to fix
03a0: 3a 0d 0a 0d 0a 20 20 20 20 20 24 20 73 75 64 6f :.... $ sudo
03b0: 20 73 79 73 74 65 6d 63 74 6c 20 65 6e 61 62 6c systemctl enabl
03c0: 65 20 73 73 68 0d 0a 20 20 20 20 20 24 20 73 75 e ssh.. $ su
03d0: 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 74 61 do systemctl sta
03e0: 72 74 20 73 73 68 0d 0a 0d 0a 4f 6e 63 65 20 79 rt ssh....Once y
03f0: 6f 75 20 68 61 76 65 20 61 20 5b 73 65 63 75 72 ou have a [secur
0400: 65 20 73 68 65 6c 6c 5d 28 68 74 74 70 73 3a 2f e shell](https:/
0410: 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 /en.wikipedia.or
0420: 67 2f 77 69 6b 69 2f 53 65 63 75 72 65 5f 53 68 g/wiki/Secure_Sh
0430: 65 6c 6c 29 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 ell) connection
0440: 74 6f 20 79 6f 75 72 20 50 69 2c 20 79 6f 75 20 to your Pi, you
0450: 2a 6d 61 79 2a 20 62 65 20 61 62 6c 65 20 74 6f *may* be able to
0460: 20 63 6f 70 79 2d 61 6e 64 2d 70 61 73 74 65 20 copy-and-paste
0470: 74 68 65 20 74 65 78 74 20 69 6e 74 6f 20 77 68 the text into wh
0480: 61 74 65 76 65 72 20 70 72 6f 67 72 61 6d 20 77 atever program w
0490: 61 6e 74 73 20 69 74 2e 20 59 6f 75 20 63 6f 75 ants it. You cou
04a0: 6c 64 20 68 61 76 65 20 61 20 74 65 78 74 20 66 ld have a text f
04b0: 69 6c 65 20 6f 70 65 6e 20 69 6e 20 61 20 47 55 ile open in a GU
04c0: 49 20 74 65 78 74 20 65 64 69 74 6f 72 20 6f 6e I text editor on
04d0: 20 74 68 65 20 64 65 73 6b 74 6f 70 20 63 6f 6d the desktop com
04e0: 70 75 74 65 72 20 74 68 61 74 20 61 6c 73 6f 20 puter that also
04f0: 68 61 73 20 74 68 65 20 53 53 48 20 63 6f 6e 6e has the SSH conn
0500: 65 63 74 69 6f 6e 20 6f 70 65 6e 20 74 6f 20 74 ection open to t
0510: 68 65 20 50 69 44 50 2d 38 2f 49 2c 20 74 68 65 he PiDP-8/I, the
0520: 6e 20 73 61 79 20 53 65 6c 65 63 74 20 41 6c 6c n say Select All
0530: 20 61 6e 64 20 43 6f 70 79 20 69 6e 20 74 68 65 and Copy in the
0540: 20 74 65 78 74 20 65 64 69 74 6f 72 2c 20 74 68 text editor, th
0550: 65 6e 20 41 6c 74 2d 54 61 62 20 6f 76 65 72 20 en Alt-Tab over
0560: 74 6f 20 74 68 65 20 53 53 48 20 77 69 6e 64 6f to the SSH windo
0570: 77 20 61 6e 64 20 70 61 73 74 65 20 64 69 72 65 w and paste dire
0580: 63 74 6c 79 20 69 6e 74 6f 20 74 68 65 20 70 72 ctly into the pr
0590: 6f 67 72 61 6d 20 77 61 6e 74 69 6e 67 20 74 68 ogram wanting th
05a0: 65 20 74 65 78 74 2e 0d 0a 0d 0a 49 20 77 72 6f e text.....I wro
05b0: 74 65 20 22 2a 6d 61 79 2a 22 20 61 62 6f 76 65 te "*may*" above
05c0: 20 62 65 63 61 75 73 65 20 74 68 69 73 20 6d 65 because this me
05d0: 74 68 6f 64 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 thod only works
05e0: 77 69 74 68 20 70 72 6f 67 72 61 6d 73 20 74 68 with programs th
05f0: 61 74 20 68 61 6e 64 6c 65 20 74 65 72 6d 69 6e at handle termin
0600: 61 6c 20 49 2f 4f 20 69 6e 20 73 75 63 68 20 61 al I/O in such a
0610: 20 77 61 79 20 74 68 61 74 20 74 68 65 79 20 63 way that they c
0620: 61 6e 20 68 6f 6c 64 20 6f 66 66 20 6f 6e 20 61 an hold off on a
0630: 63 63 65 70 74 69 6e 67 20 65 61 63 68 20 69 6e ccepting each in
0640: 70 75 74 20 63 68 61 72 61 63 74 65 72 20 75 6e put character un
0650: 74 69 6c 20 74 68 65 20 73 69 6d 75 6c 61 74 6f til the simulato
0660: 72 20 e2 80 94 20 77 68 69 63 68 20 69 73 20 66 r — which is f
0670: 61 72 20 73 6c 6f 77 65 72 20 61 74 20 68 61 6e ar slower at han
0680: 64 6c 69 6e 67 20 49 2f 4f 20 74 68 61 6e 20 79 dling I/O than y
0690: 6f 75 72 20 68 6f 73 74 20 73 79 73 74 65 6d 20 our host system
06a0: e2 80 94 20 69 73 20 72 65 61 64 79 20 66 6f 72 — is ready for
06b0: 20 69 74 2e 20 53 6f 6d 65 20 50 44 50 2d 38 20 it. Some PDP-8
06c0: 70 72 6f 67 72 61 6d 73 20 61 72 65 20 73 69 6d programs are sim
06d0: 70 6c 79 20 6e 6f 74 20 62 75 69 6c 74 20 74 6f ply not built to
06e0: 20 63 6f 70 65 20 77 69 74 68 20 74 68 69 73 2c cope with this,
06f0: 20 73 75 63 68 20 61 73 20 55 2f 57 20 46 4f 43 such as U/W FOC
0700: 41 4c 2e 20 49 66 20 79 6f 75 20 74 72 79 20 74 AL. If you try t
0710: 68 69 73 20 6d 65 74 68 6f 64 20 61 6e 64 20 74 his method and t
0720: 68 65 20 70 61 73 74 65 64 20 74 65 78 74 20 65 he pasted text e
0730: 6e 64 73 20 75 70 20 74 72 61 73 68 65 64 20 69 nds up trashed i
0740: 6e 73 69 64 65 20 74 68 65 20 73 69 6d 75 6c 61 nside the simula
0750: 74 6f 72 2c 20 79 6f 75 20 77 69 6c 6c 20 68 61 tor, you will ha
0760: 76 65 20 74 6f 20 73 77 69 74 63 68 20 74 6f 20 ve to switch to
0770: 6f 6e 65 20 6f 66 20 74 68 65 20 61 6c 74 65 72 one of the alter
0780: 6e 61 74 69 76 65 73 20 62 65 6c 6f 77 2c 20 73 natives below, s
0790: 75 63 68 20 61 73 20 5b 74 68 65 20 60 50 49 50 uch as [the `PIP
07a0: 60 20 73 6f 6c 75 74 69 6f 6e 5d 28 23 70 69 70 ` solution](#pip
07b0: 29 2e 0d 0a 0d 0a 0d 0a 23 20 4f 53 2f 38 0d 0a ).......# OS/8..
07c0: 0d 0a 54 68 65 72 65 20 61 72 65 20 61 20 6e 75 ..There are a nu
07d0: 6d 62 65 72 20 6f 66 20 6d 65 74 68 6f 64 73 20 mber of methods
07e0: 66 6f 72 20 67 65 74 74 69 6e 67 20 74 65 78 74 for getting text
07f0: 20 69 6e 74 6f 20 74 68 65 20 73 69 6d 75 6c 61 into the simula
0800: 74 6f 72 20 74 68 61 74 20 64 65 70 65 6e 64 20 tor that depend
0810: 6f 6e 20 66 65 61 74 75 72 65 73 20 6f 66 20 4f on features of O
0820: 53 2f 38 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 S/8.......## <a
0830: 69 64 3d 22 70 69 70 22 3e 3c 2f 61 3e 50 49 50 id="pip"></a>PIP
0840: 0d 0a 0d 0a 53 6f 6d 65 74 69 6d 65 73 20 74 68 ....Sometimes th
0850: 65 20 70 72 6f 67 72 61 6d 20 79 6f 75 27 72 65 e program you're
0860: 20 72 75 6e 6e 69 6e 67 20 68 61 73 20 6e 6f 20 running has no
0870: 77 61 79 20 6f 66 20 72 65 63 65 69 76 69 6e 67 way of receiving
0880: 20 74 65 78 74 20 64 69 72 65 63 74 6c 79 20 66 text directly f
0890: 72 6f 6d 20 74 68 65 20 74 65 72 6d 69 6e 61 6c rom the terminal
08a0: 2c 20 62 75 74 20 6e 65 65 64 73 20 69 74 20 66 , but needs it f
08b0: 72 6f 6d 20 61 20 64 69 73 6b 20 66 69 6c 65 20 rom a disk file
08c0: 69 6e 73 74 65 61 64 2e 20 4f 74 68 65 72 20 74 instead. Other t
08d0: 69 6d 65 73 2c 20 74 68 65 20 50 44 50 2d 38 20 imes, the PDP-8
08e0: 70 72 6f 67 72 61 6d 20 79 6f 75 27 72 65 20 77 program you're w
08f0: 6f 72 6b 69 6e 67 20 77 69 74 68 20 64 6f 65 73 orking with does
0900: 20 61 63 63 65 70 74 20 74 65 72 6d 69 6e 61 6c accept terminal
0910: 20 69 6e 70 75 74 2c 20 62 75 74 20 61 73 73 75 input, but assu
0920: 6d 65 73 20 69 74 20 69 73 20 67 65 74 74 69 6e mes it is gettin
0930: 67 20 69 74 20 66 72 6f 6d 20 61 20 6e 6f 72 6d g it from a norm
0940: 61 6c 20 50 44 50 2d 38 20 70 65 72 69 70 68 65 al PDP-8 periphe
0950: 72 61 6c 20 73 75 63 68 20 61 73 20 74 68 65 20 ral such as the
0960: 22 68 69 67 68 20 73 70 65 65 64 22 20 70 61 70 "high speed" pap
0970: 65 72 20 74 61 70 65 20 72 65 61 64 65 72 2c 20 er tape reader,
0980: 33 30 30 20 62 69 74 73 20 70 65 72 20 73 65 63 300 bits per sec
0990: 6f 6e 64 20 61 74 20 66 61 73 74 65 73 74 2c 20 ond at fastest,
09a0: 61 6e 64 20 69 74 20 77 69 6c 6c 20 63 68 6f 6b and it will chok
09b0: 65 20 77 68 65 6e 20 67 69 76 65 6e 20 69 6e 70 e when given inp
09c0: 75 74 20 6d 75 63 68 20 66 61 73 74 65 72 20 74 ut much faster t
09d0: 68 61 6e 20 74 68 61 74 2e 20 0d 0a 0d 0a 57 65 han that. ....We
09e0: 20 63 61 6e 20 73 6f 6c 76 65 20 74 68 65 73 65 can solve these
09f0: 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 74 problems with t
0a00: 68 65 20 4f 53 2f 38 20 60 50 49 50 60 20 70 72 he OS/8 `PIP` pr
0a10: 6f 67 72 61 6d 2e 0d 0a 0d 0a 0d 0a 23 23 23 20 ogram.......###
0a20: 3c 61 20 69 64 3d 22 70 69 70 2d 70 61 73 74 65 <a id="pip-paste
0a30: 22 3e 3c 2f 61 3e 54 65 72 6d 69 6e 61 6c 20 50 "></a>Terminal P
0a40: 61 73 74 65 0d 0a 0d 0a 53 74 61 72 74 69 6e 67 aste....Starting
0a50: 20 77 69 74 68 20 74 68 65 20 5b 53 53 48 20 6f with the [SSH o
0a60: 70 74 69 6f 6e 5d 28 23 73 73 68 29 20 61 62 6f ption](#ssh) abo
0a70: 76 65 2c 20 79 6f 75 20 63 61 6e 20 73 65 6e 64 ve, you can send
0a80: 20 70 61 73 74 65 64 20 74 65 78 74 20 74 6f 20 pasted text to
0a90: 61 6e 20 4f 53 2f 38 20 64 69 73 6b 20 66 69 6c an OS/8 disk fil
0aa0: 65 20 77 69 74 68 3a 0d 0a 0d 0a 20 20 20 20 2e e with:.... .
0ab0: 52 20 50 49 50 0d 0a 20 20 20 20 2a 4d 59 46 49 R PIP.. *MYFI
0ac0: 4c 45 2e 54 58 3c 54 54 59 3a 0d 0a 20 20 20 20 LE.TX<TTY:..
0ad0: 62 6c 61 68 20 62 6c 61 68 20 62 6c 61 68 20 2e blah blah blah .
0ae0: 2e 2e 20 20 20 20 20 20 20 20 20 e2 87 a0 20 70 .. ⇠ p
0af0: 61 73 74 65 20 74 65 78 74 20 69 6e 20 68 65 72 aste text in her
0b00: 65 0d 0a 20 20 20 20 5e 5a 20 20 20 20 20 20 20 e.. ^Z
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b20: 20 20 e2 87 a0 20 70 72 65 73 73 20 45 6e 74 65 ⇠ press Ente
0b30: 72 20 74 68 65 6e 20 43 74 72 6c 2d 5a 20 74 6f r then Ctrl-Z to
0b40: 20 73 69 67 6e 61 6c 20 45 4f 46 0d 0a 20 20 20 signal EOF..
0b50: 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
0b60: 20 20 20 20 20 20 20 20 20 20 20 20 e2 87 a0 20 ⇠
0b70: 70 72 65 73 73 20 45 73 63 61 70 65 20 74 6f 20 press Escape to
0b80: 65 78 69 74 20 50 49 50 0d 0a 0d 0a 54 68 61 74 exit PIP....That
0b90: 20 77 69 6c 6c 20 64 72 6f 70 20 79 6f 75 20 62 will drop you b
0ba0: 61 63 6b 20 69 6e 74 6f 20 4f 53 2f 38 20 77 69 ack into OS/8 wi
0bb0: 74 68 20 61 20 66 69 6c 65 20 63 61 6c 6c 65 64 th a file called
0bc0: 20 60 44 53 4b 3a 4d 59 46 49 4c 45 2e 54 58 60 `DSK:MYFILE.TX`
0bd0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
0be0: 70 61 73 74 65 64 20 74 65 78 74 2e 0d 0a 0d 0a pasted text.....
0bf0: 54 68 65 20 45 6e 74 65 72 20 6b 65 79 73 74 72 The Enter keystr
0c00: 6f 6b 65 20 62 65 66 6f 72 65 20 43 74 72 6c 2d oke before Ctrl-
0c10: 5a 20 69 73 6e 27 74 20 61 6c 77 61 79 73 20 6e Z isn't always n
0c20: 65 63 65 73 73 61 72 79 2c 20 62 75 74 20 73 6f ecessary, but so
0c30: 6d 65 20 4f 53 2f 38 20 70 72 6f 67 72 61 6d 73 me OS/8 programs
0c40: 20 77 6f 6e 27 74 20 62 65 20 68 61 70 70 79 20 won't be happy
0c50: 69 66 20 74 68 65 79 20 68 69 74 20 45 4f 46 20 if they hit EOF
0c60: 6f 6e 20 61 20 6c 69 6e 65 20 77 69 74 68 6f 75 on a line withou
0c70: 74 20 61 20 43 52 2b 4c 46 20 70 61 69 72 2e 0d t a CR+LF pair..
0c80: 0a 0d 0a 0d 0a 23 23 23 20 3c 61 20 69 64 3d 22 .....### <a id="
0c90: 70 69 70 2d 70 74 22 3e 3c 2f 61 3e 53 69 6d 75 pip-pt"></a>Simu
0ca0: 6c 61 74 65 64 20 50 61 70 65 72 20 54 61 70 65 lated Paper Tape
0cb0: 0d 0a 0d 0a 53 6f 6d 65 74 69 6d 65 73 20 79 6f ....Sometimes yo
0cc0: 75 20 77 6f 75 6c 64 20 72 61 74 68 65 72 20 6e u would rather n
0cd0: 6f 74 20 75 73 65 20 74 68 65 20 63 6c 69 70 62 ot use the clipb
0ce0: 6f 61 72 64 2c 20 62 75 74 20 77 6f 75 6c 64 20 oard, but would
0cf0: 70 72 65 66 65 72 20 74 6f 20 73 65 6e 64 20 61 prefer to send a
0d00: 20 68 6f 73 74 2d 73 69 64 65 20 66 69 6c 65 20 host-side file
0d10: 64 69 72 65 63 74 6c 79 20 69 6e 74 6f 20 74 68 directly into th
0d20: 65 20 73 69 6d 75 6c 61 74 6f 72 2e 20 57 69 74 e simulator. Wit
0d30: 68 20 74 68 65 20 68 65 6c 70 20 6f 66 20 42 69 h the help of Bi
0d40: 6c 6c 20 43 61 74 74 65 79 27 73 20 60 74 78 74 ll Cattey's `txt
0d50: 32 70 74 70 60 20 70 72 6f 67 72 61 6d 2c 20 77 2ptp` program, w
0d60: 68 69 63 68 20 77 65 27 76 65 20 62 65 65 6e 20 hich we've been
0d70: 73 68 69 70 70 69 6e 67 20 73 69 6e 63 65 20 74 shipping since t
0d80: 68 65 20 32 30 31 37 2e 31 32 2e 32 32 20 72 65 he 2017.12.22 re
0d90: 6c 65 61 73 65 2c 20 79 6f 75 20 63 61 6e 20 6e lease, you can n
0da0: 6f 77 20 65 61 73 69 6c 79 20 64 6f 20 74 68 61 ow easily do tha
0db0: 74 2e 0d 0a 0d 0a 46 69 72 73 74 2c 20 79 6f 75 t.....First, you
0dc0: 20 6d 75 73 74 20 63 6f 6e 76 65 72 74 20 74 68 must convert th
0dd0: 65 20 68 6f 73 74 2d 73 69 64 65 20 74 65 78 74 e host-side text
0de0: 20 66 69 6c 65 20 74 6f 20 74 68 65 20 66 6f 72 file to the for
0df0: 6d 61 74 20 75 73 65 64 20 62 79 20 53 49 4d 48 mat used by SIMH
0e00: 20 66 6f 72 20 69 74 73 20 70 61 70 65 72 20 74 for its paper t
0e10: 61 70 65 20 69 6d 61 67 65 73 3a 0d 0a 0d 0a 20 ape images:....
0e20: 20 20 20 24 20 74 78 74 32 70 74 70 20 3c 20 6d $ txt2ptp < m
0e30: 79 66 69 6c 65 2e 74 78 74 20 3e 20 6d 79 66 69 yfile.txt > myfi
0e40: 6c 65 2e 70 74 0d 0a 0d 0a 54 68 65 20 60 74 78 le.pt....The `tx
0e50: 74 32 70 74 70 60 20 70 72 6f 67 72 61 6d 20 28 t2ptp` program (
0e60: 61 6e 64 20 69 74 73 20 69 6e 76 65 72 73 65 2c and its inverse,
0e70: 20 60 70 74 70 32 74 78 74 60 29 20 69 73 20 61 `ptp2txt`) is a
0e80: 20 5b 66 69 6c 74 65 72 5d 5b 77 70 66 5d 20 77 [filter][wpf] w
0e90: 68 69 63 68 20 74 61 6b 65 73 20 61 6e 79 20 41 hich takes any A
0ea0: 53 43 49 49 20 74 65 78 74 20 69 6e 20 61 6e 64 SCII text in and
0eb0: 20 77 72 69 74 65 73 20 69 74 20 74 6f 20 53 49 writes it to SI
0ec0: 4d 48 20 70 61 70 65 72 20 74 61 70 65 20 66 6f MH paper tape fo
0ed0: 72 6d 61 74 20 61 73 20 6f 75 74 70 75 74 2e 20 rmat as output.
0ee0: 49 74 20 63 6f 6e 76 65 72 74 73 20 4c 46 20 6c It converts LF l
0ef0: 69 6e 65 20 65 6e 64 69 6e 67 73 20 6f 6e 20 69 ine endings on i
0f00: 74 73 20 69 6e 70 75 74 20 74 6f 20 74 68 65 20 ts input to the
0f10: 43 52 2b 4c 46 20 66 6f 72 6d 61 74 20 65 78 70 CR+LF format exp
0f20: 65 63 74 65 64 20 62 79 20 70 72 65 74 74 79 20 ected by pretty
0f30: 6d 75 63 68 20 61 6c 6c 20 4f 53 2f 38 20 70 72 much all OS/8 pr
0f40: 6f 67 72 61 6d 73 2e 20 54 68 65 20 66 69 6c 74 ograms. The filt
0f50: 65 72 20 61 6c 73 6f 20 74 61 6b 65 73 20 63 61 er also takes ca
0f60: 72 65 20 6f 66 20 64 65 74 61 69 6c 73 20 73 75 re of details su
0f70: 63 68 20 61 73 20 70 72 65 70 65 6e 64 69 6e 67 ch as prepending
0f80: 20 61 20 74 61 70 65 20 6c 65 61 64 65 72 2c 20 a tape leader,
0f90: 63 6f 70 69 6e 67 20 77 69 74 68 20 45 4f 46 20 coping with EOF
0fa0: 63 68 61 72 61 63 74 65 72 73 2c 20 65 74 63 2e characters, etc.
0fb0: 0d 0a 0d 0a 4e 65 78 74 2c 20 79 6f 75 20 61 74 ....Next, you at
0fc0: 74 61 63 68 20 74 68 65 20 70 61 70 65 72 20 74 tach the paper t
0fd0: 61 70 65 20 74 6f 20 74 68 65 20 73 69 6d 75 6c ape to the simul
0fe0: 61 74 6f 72 2e 20 46 72 6f 6d 20 77 69 74 68 69 ator. From withi
0ff0: 6e 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72 2c n the simulator,
1000: 20 68 69 74 20 3c 6b 62 64 3e 43 74 72 6c 2d 45 hit <kbd>Ctrl-E
1010: 3c 2f 6b 62 64 3e 20 74 6f 20 65 73 63 61 70 65 </kbd> to escape
1020: 20 74 6f 20 74 68 65 20 53 49 4d 48 20 63 6f 6d to the SIMH com
1030: 6d 61 6e 64 20 70 72 6f 6d 70 74 2c 20 74 68 65 mand prompt, the
1040: 6e 20 73 61 79 3a 0d 0a 0d 0a 20 20 20 20 73 69 n say:.... si
1050: 6d 3e 20 61 74 74 61 63 68 20 70 74 72 20 6d 79 m> attach ptr my
1060: 66 69 6c 65 2e 70 74 0d 0a 20 20 20 20 73 69 6d file.pt.. sim
1070: 3e 20 63 6f 6e 74 0d 0a 0d 0a 54 68 61 74 20 61 > cont....That a
1080: 74 74 61 63 68 65 73 20 74 68 65 20 70 61 70 65 ttaches the pape
1090: 72 20 74 61 70 65 20 69 6d 61 67 65 20 66 69 6c r tape image fil
10a0: 65 20 79 6f 75 20 63 72 65 61 74 65 64 20 61 62 e you created ab
10b0: 6f 76 65 20 74 6f 20 74 68 65 20 73 69 6d 75 6c ove to the simul
10c0: 61 74 65 64 20 50 44 50 2d 38 27 73 20 3c 62 3e ated PDP-8's <b>
10d0: 70 3c 2f 62 3e 61 70 65 72 20 3c 62 3e 74 3c 2f p</b>aper <b>t</
10e0: 62 3e 61 70 65 20 3c 62 3e 72 3c 2f 62 3e 65 61 b>ape <b>r</b>ea
10f0: 64 65 72 2c 20 74 68 65 6e 20 3c 62 3e 63 6f 6e der, then <b>con
1100: 74 3c 2f 62 3e 69 6e 75 65 73 20 74 68 65 20 73 t</b>inues the s
1110: 69 6d 75 6c 61 74 69 6f 6e 2e 20 59 6f 75 20 63 imulation. You c
1120: 61 6e 20 61 62 62 72 65 76 69 61 74 65 20 74 68 an abbreviate th
1130: 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 ese commands to
1140: 60 61 74 60 20 61 6e 64 20 60 63 60 2c 20 72 65 `at` and `c`, re
1150: 73 70 65 63 74 69 76 65 6c 79 2e 0d 0a 0d 0a 4e spectively.....N
1160: 6f 77 20 77 65 20 63 61 6e 20 75 73 65 20 5b 60 ow we can use [`
1170: 50 49 50 60 5d 28 23 70 69 70 29 20 69 6e 20 61 PIP`](#pip) in a
1180: 20 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65 72 slightly differ
1190: 65 6e 74 20 77 61 79 20 74 68 61 6e 20 61 62 6f ent way than abo
11a0: 76 65 20 74 6f 20 70 75 6c 6c 20 74 68 65 20 74 ve to pull the t
11b0: 65 78 74 20 69 6e 74 6f 20 74 68 65 20 73 69 6d ext into the sim
11c0: 75 6c 61 74 6f 72 3a 0d 0a 0d 0a 20 20 20 20 2e ulator:.... .
11d0: 52 20 50 49 50 0d 0a 20 20 20 20 2a 4d 59 46 49 R PIP.. *MYFI
11e0: 4c 45 2e 54 58 3c 50 54 52 3a 0d 0a 20 20 20 20 LE.TX<PTR:..
11f0: 5e 2a 24 20 20 20 20 20 20 20 20 20 20 20 20 20 ^*$
1200: 20 20 20 20 20 20 e2 87 a0 20 70 72 65 73 73 20 ⇠ press
1210: 45 73 63 61 70 65 20 74 77 69 63 65 20 77 68 65 Escape twice whe
1220: 6e 20 5e 20 61 70 70 65 61 72 73 20 74 6f 20 65 n ^ appears to e
1230: 78 69 74 20 50 49 50 0d 0a 0d 0a 54 68 65 20 60 xit PIP....The `
1240: 5e 60 20 6f 75 74 70 75 74 20 61 62 6f 76 65 20 ^` output above
1250: 73 69 67 6e 61 6c 73 20 74 68 61 74 20 50 49 50 signals that PIP
1260: 20 68 61 73 20 66 6f 75 6e 64 20 65 6e 64 2d 6f has found end-o
1270: 66 2d 66 69 6c 65 20 6f 6e 20 74 68 65 20 70 61 f-file on the pa
1280: 70 65 72 20 74 61 70 65 20 69 6e 70 75 74 2e 20 per tape input.
1290: 54 68 65 20 60 2a 60 20 69 73 20 74 68 65 20 50 The `*` is the P
12a0: 49 50 20 70 72 6f 6d 70 74 20 61 66 74 65 72 20 IP prompt after
12b0: 79 6f 75 20 68 69 74 20 3c 6b 62 64 3e 45 73 63 you hit <kbd>Esc
12c0: 61 70 65 3c 2f 6b 62 64 3e 20 74 68 65 20 66 69 ape</kbd> the fi
12d0: 72 73 74 20 74 69 6d 65 2c 20 61 6e 64 20 74 68 rst time, and th
12e0: 65 20 60 24 60 20 69 73 20 74 68 65 20 72 65 73 e `$` is the res
12f0: 75 6c 74 20 6f 66 20 68 69 74 74 69 6e 67 20 69 ult of hitting i
1300: 74 20 74 68 65 20 73 65 63 6f 6e 64 20 74 69 6d t the second tim
1310: 65 2e 20 54 68 61 74 20 77 69 6c 6c 20 64 72 6f e. That will dro
1320: 70 20 79 6f 75 20 62 61 63 6b 20 74 6f 20 74 68 p you back to th
1330: 65 20 4f 53 2f 38 20 60 2e 60 20 70 72 6f 6d 70 e OS/8 `.` promp
1340: 74 20 77 69 74 68 20 61 20 6e 65 77 6c 79 2d 77 t with a newly-w
1350: 72 69 74 74 65 6e 20 66 69 6c 65 20 63 61 6c 6c ritten file call
1360: 65 64 20 60 44 53 4b 3a 4d 59 46 49 4c 45 2e 54 ed `DSK:MYFILE.T
1370: 58 60 2e 0d 0a 0d 0a 42 65 77 61 72 65 20 74 68 X`.....Beware th
1380: 61 74 20 53 49 4d 48 20 74 72 65 61 74 73 20 69 at SIMH treats i
1390: 74 73 20 73 69 6d 75 6c 61 74 65 64 20 70 61 70 ts simulated pap
13a0: 65 72 20 74 61 70 65 73 20 74 68 65 20 73 61 6d er tapes the sam
13b0: 65 20 77 61 79 20 61 20 72 65 61 6c 20 50 44 50 e way a real PDP
13c0: 2d 38 20 77 6f 75 6c 64 3a 20 79 6f 75 20 67 65 -8 would: you ge
13d0: 74 20 61 20 73 69 6e 67 6c 65 20 6c 69 6e 65 61 t a single linea
13e0: 72 20 72 65 61 64 2c 20 74 68 65 6e 20 74 68 65 r read, then the
13f0: 20 70 61 70 65 72 20 74 61 70 65 20 22 66 61 6c paper tape "fal
1400: 6c 73 20 6f 75 74 22 20 6f 66 20 74 68 65 20 73 ls out" of the s
1410: 69 6d 75 6c 61 74 6f 72 27 73 20 70 61 70 65 72 imulator's paper
1420: 20 74 61 70 65 20 72 65 61 64 65 72 2e 20 59 6f tape reader. Yo
1430: 75 20 6d 75 73 74 20 72 75 6e 20 74 68 65 20 60 u must run the `
1440: 61 74 74 61 63 68 60 20 63 6f 6d 6d 61 6e 64 20 attach` command
1450: 61 67 61 69 6e 20 74 6f 20 72 65 61 64 20 74 68 again to read th
1460: 61 74 20 70 61 70 65 72 20 74 61 70 65 20 61 67 at paper tape ag
1470: 61 69 6e 2e 0d 0a 0d 0a 5b 77 70 66 5d 3a 20 68 ain.....[wpf]: h
1480: 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 ttps://en.wikipe
1490: 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 46 69 6c dia.org/wiki/Fil
14a0: 74 65 72 5f 28 73 6f 66 74 77 61 72 65 29 0d 0a ter_(software)..
14b0: 0d 0a 0d 0a 23 23 20 3c 61 20 69 64 3d 22 74 78 ....## <a id="tx
14c0: 74 32 6f 73 38 22 3e 3c 2f 61 3e 43 72 65 61 74 t2os8"></a>Creat
14d0: 65 20 4f 53 2f 38 20 4d 65 64 69 61 0d 0a 0d 0a e OS/8 Media....
14e0: 42 69 6c 6c 20 43 61 74 74 65 79 20 61 6c 73 6f Bill Cattey also
14f0: 20 77 72 6f 74 65 20 61 20 73 63 72 69 70 74 20 wrote a script
1500: 77 68 69 63 68 20 61 75 74 6f 6d 61 74 65 73 20 which automates
1510: 73 6f 6d 65 20 6f 66 20 74 68 65 20 61 62 6f 76 some of the abov
1520: 65 2c 20 77 68 69 63 68 20 69 73 20 75 73 65 66 e, which is usef
1530: 75 6c 20 77 68 65 6e 20 79 6f 75 27 76 65 20 67 ul when you've g
1540: 6f 74 20 73 6f 6d 65 20 6e 75 6d 62 65 72 20 6f ot some number o
1550: 66 20 74 65 78 74 20 66 69 6c 65 73 20 6f 6e 20 f text files on
1560: 74 68 65 20 68 6f 73 74 20 73 69 64 65 20 61 6e the host side an
1570: 64 20 73 69 6d 70 6c 79 20 77 61 6e 74 20 74 68 d simply want th
1580: 65 6d 20 63 6f 70 69 65 64 20 74 6f 20 61 20 73 em copied to a s
1590: 69 6d 75 6c 61 74 65 64 20 4f 53 2f 38 20 6d 65 imulated OS/8 me
15a0: 64 69 75 6d 20 69 6d 61 67 65 3a 0d 0a 0d 0a 20 dium image:....
15b0: 20 20 20 24 20 74 78 74 32 6f 73 38 20 2d 2d 72 $ txt2os8 --r
15c0: 6b 30 35 61 20 6d 79 64 69 73 6b 2e 72 6b 30 35 k05a mydisk.rk05
15d0: 0d 0a 0d 0a 54 68 69 73 20 63 72 65 61 74 65 73 ....This creates
15e0: 20 28 6f 72 20 75 70 64 61 74 65 73 29 20 74 68 (or updates) th
15f0: 65 20 66 69 72 73 74 20 73 75 62 2d 64 65 76 69 e first sub-devi
1600: 63 65 20 6f 6e 20 74 68 65 20 52 4b 30 35 20 64 ce on the RK05 d
1610: 69 73 6b 20 69 6d 61 67 65 20 66 69 6c 65 20 60 isk image file `
1620: 6d 79 64 69 73 6b 2e 72 6b 30 35 60 2c 20 63 6f mydisk.rk05`, co
1630: 70 79 69 6e 67 20 69 6e 20 66 69 6c 65 73 20 6c pying in files l
1640: 69 73 74 65 64 20 69 6e 20 60 6d 79 64 69 73 6b isted in `mydisk
1650: 2e 72 6b 30 35 2e 6c 69 73 74 60 2e 20 54 68 61 .rk05.list`. Tha
1660: 74 20 6d 61 6b 65 73 20 74 68 69 73 20 6d 65 74 t makes this met
1670: 68 6f 64 20 6d 6f 73 74 20 75 73 65 66 75 6c 20 hod most useful
1680: 66 6f 72 20 72 65 70 65 61 74 65 64 20 62 75 6c for repeated bul
1690: 6b 20 74 72 61 6e 73 66 65 72 73 2e 0d 0a 0d 0a k transfers.....
16a0: 54 68 69 73 20 73 63 72 69 70 74 20 63 61 6e 20 This script can
16b0: 75 70 64 61 74 65 20 74 68 65 20 73 65 63 6f 6e update the secon
16c0: 64 20 73 75 62 2d 64 65 76 69 63 65 20 28 60 2d d sub-device (`-
16d0: 2d 72 6b 30 35 62 60 29 20 6f 72 20 61 20 54 55 -rk05b`) or a TU
16e0: 35 36 20 74 61 70 65 20 69 6d 61 67 65 20 28 60 56 tape image (`
16f0: 2d 2d 74 75 35 36 60 29 20 69 6e 73 74 65 61 64 --tu56`) instead
1700: 2e 0d 0a 0d 0a 4f 6e 63 65 20 79 6f 75 20 68 61 .....Once you ha
1710: 76 65 20 74 68 69 73 20 6d 65 64 69 61 20 69 6d ve this media im
1720: 61 67 65 2c 20 79 6f 75 20 63 61 6e 20 60 61 74 age, you can `at
1730: 74 61 63 68 60 20 69 74 20 74 6f 20 74 68 65 20 tach` it to the
1740: 73 69 6d 75 6c 61 74 6f 72 20 61 6e 64 20 77 6f simulator and wo
1750: 72 6b 20 77 69 74 68 20 74 68 65 20 66 69 6c 65 rk with the file
1760: 73 20 6f 6e 20 69 74 20 64 69 72 65 63 74 6c 79 s on it directly
1770: 3a 0d 0a 0d 0a 20 20 20 20 43 74 72 6c 2d 45 0d :.... Ctrl-E.
1780: 0a 20 20 20 20 73 69 6d 3e 20 61 74 74 20 64 74 . sim> att dt
1790: 30 20 6d 79 74 61 70 65 2e 74 75 35 36 0d 0a 20 0 mytape.tu56..
17a0: 20 20 20 73 69 6d 3e 20 63 6f 6e 74 0d 0a 20 20 sim> cont..
17b0: 20 20 2e 44 49 52 20 44 54 41 30 3a 0d 0a 20 20 .DIR DTA0:..
17c0: 20 20 2e 2e 2e 20 20 20 20 20 20 20 20 20 20 20 ...
17d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17e0: 20 20 20 20 20 e2 87 a0 20 6c 69 73 74 20 6f 66 ⇠ list of
17f0: 20 66 69 6c 65 73 20 6f 6e 20 6d 79 74 61 70 65 files on mytape
1800: 2e 74 75 35 36 0d 0a 0d 0a 0d 0a 0d 0a 23 23 20 .tu56........##
1810: 3c 61 20 69 64 3d 22 6f 73 38 2d 63 70 22 3e 3c <a id="os8-cp"><
1820: 2f 61 3e 60 6f 73 38 2d 63 70 60 0d 0a 0d 0a 42 /a>`os8-cp`....B
1830: 69 6c 6c 20 43 61 74 74 65 79 20 2a 61 6c 73 6f ill Cattey *also
1840: 2a 20 77 72 6f 74 65 20 74 68 65 20 5b 60 6f 73 * wrote the [`os
1850: 38 2d 63 70 60 20 70 72 6f 67 72 61 6d 5d 5b 6f 8-cp` program][o
1860: 73 38 63 70 5d 20 74 6f 20 63 6f 70 79 20 69 6e s8cp] to copy in
1870: 64 69 76 69 64 75 61 6c 20 66 69 6c 65 73 20 69 dividual files i
1880: 6e 74 6f 20 61 6e 64 20 6f 75 74 20 6f 66 20 74 nto and out of t
1890: 68 65 20 4f 53 2f 38 20 65 6e 76 69 72 6f 6e 6d he OS/8 environm
18a0: 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 68 6f 73 ent from the hos
18b0: 74 20 73 69 64 65 2e 20 0d 0a 0d 0a 49 20 66 69 t side. ....I fi
18c0: 6e 64 20 74 68 69 73 20 6d 65 74 68 6f 64 20 6d nd this method m
18d0: 6f 73 74 20 68 65 6c 70 66 75 6c 20 77 68 65 6e ost helpful when
18e0: 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 74 68 65 programming the
18f0: 20 50 44 50 2d 38 20 61 73 20 69 74 20 67 72 65 PDP-8 as it gre
1900: 61 74 6c 79 20 73 69 6d 70 6c 69 66 69 65 73 20 atly simplifies
1910: 74 68 65 20 65 64 69 74 2d 63 6f 6d 70 69 6c 65 the edit-compile
1920: 2d 64 65 62 75 67 20 63 79 63 6c 65 2e 20 49 74 -debug cycle. It
1930: 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 65 allows you to e
1940: 64 69 74 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 dit the file on
1950: 74 68 65 20 68 6f 73 74 20 73 69 64 65 2c 20 72 the host side, r
1960: 65 2d 72 75 6e 20 74 68 65 20 60 6f 73 38 2d 63 e-run the `os8-c
1970: 70 60 20 63 6f 6d 6d 61 6e 64 20 79 6f 75 20 63 p` command you c
1980: 6f 6e 73 74 72 75 63 74 20 6f 6e 63 65 2c 20 74 onstruct once, t
1990: 68 65 6e 20 62 75 69 6c 64 20 74 68 65 20 6e 65 hen build the ne
19a0: 77 20 73 6f 66 74 77 61 72 65 20 69 6e 73 69 64 w software insid
19b0: 65 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72 2e e the simulator.
19c0: 20 28 41 6e 64 20 79 6f 75 20 63 61 6e 20 61 75 (And you can au
19d0: 74 6f 6d 61 74 65 20 74 68 61 74 20 66 69 6e 61 tomate that fina
19e0: 6c 20 73 74 65 70 20 77 69 74 68 20 61 6e 20 4f l step with an O
19f0: 53 2f 38 20 42 41 54 43 48 20 66 69 6c 65 2e 29 S/8 BATCH file.)
1a00: 0d 0a 0d 0a 54 68 65 20 60 6f 73 38 2d 63 70 60 ....The `os8-cp`
1a10: 20 70 72 6f 67 72 61 6d 20 69 73 20 69 6e 73 70 program is insp
1a20: 69 72 65 64 20 62 79 20 74 68 65 20 50 4f 53 49 ired by the POSI
1a30: 58 20 60 63 70 60 20 70 72 6f 67 72 61 6d 2c 20 X `cp` program,
1a40: 62 75 74 20 62 65 63 61 75 73 65 20 6f 66 20 61 but because of a
1a50: 73 73 6f 72 74 65 64 20 63 6f 6d 70 6c 65 78 69 ssorted complexi
1a60: 74 69 65 73 20 69 6e 20 74 68 65 20 70 72 6f 63 ties in the proc
1a70: 65 73 73 2c 20 69 74 73 20 75 73 61 67 65 20 69 ess, its usage i
1a80: 73 6e 27 74 20 61 73 20 73 69 6d 70 6c 65 20 61 sn't as simple a
1a90: 73 20 6f 6e 65 20 77 6f 75 6c 64 20 6c 69 6b 65 s one would like
1aa0: 2e 20 54 6f 20 63 6f 70 79 20 74 68 65 20 6c 6f . To copy the lo
1ab0: 63 61 6c 20 60 73 72 63 2f 63 63 38 2f 65 78 61 cal `src/cc8/exa
1ac0: 6d 70 6c 65 73 2f 70 73 2e 63 60 20 66 69 6c 65 mples/ps.c` file
1ad0: 20 74 6f 20 60 44 53 4b 3a 60 20 6f 6e 20 74 68 to `DSK:` on th
1ae0: 65 20 4f 53 2f 38 20 73 69 64 65 2c 20 79 6f 75 e OS/8 side, you
1af0: 27 64 20 73 61 79 3a 0d 0a 0d 0a 20 20 20 20 24 'd say:.... $
1b00: 20 6f 73 38 2d 63 70 20 2d 72 6b 30 73 20 62 69 os8-cp -rk0s bi
1b10: 6e 2f 76 33 64 2e 72 6b 30 35 20 2d 61 20 73 72 n/v3d.rk05 -a sr
1b20: 63 2f 63 63 38 2f 65 78 61 6d 70 6c 65 73 2f 70 c/cc8/examples/p
1b30: 73 2e 63 20 64 73 6b 3a 0d 0a 0d 0a 53 68 65 6c s.c dsk:....Shel
1b40: 6c 20 73 63 72 69 70 74 73 20 61 6e 64 20 73 68 l scripts and sh
1b50: 65 6c 6c 20 68 69 73 74 6f 72 79 20 6d 61 6b 65 ell history make
1b60: 73 20 69 74 20 65 61 73 79 20 65 6e 6f 75 67 68 s it easy enough
1b70: 20 74 6f 20 72 65 2d 72 75 6e 20 74 68 69 73 20 to re-run this
1b80: 6d 6f 64 65 72 61 74 65 6c 79 20 63 6f 6d 70 6c moderately compl
1b90: 65 78 20 70 72 6f 67 72 61 6d 20 77 69 74 68 20 ex program with
1ba0: 61 20 66 65 77 20 6b 65 79 73 74 72 6f 6b 65 73 a few keystrokes
1bb0: 2e 0d 0a 0d 0a 53 65 65 20 5b 74 68 65 20 60 6f .....See [the `o
1bc0: 73 38 2d 63 70 60 20 6d 61 6e 75 61 6c 5d 5b 6f s8-cp` manual][o
1bd0: 73 38 63 70 5d 20 66 6f 72 20 6d 6f 72 65 20 64 s8cp] for more d
1be0: 65 74 61 69 6c 73 2e 0d 0a 0d 0a 5b 6f 73 38 63 etails.....[os8c
1bf0: 70 5d 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 p]: /doc/trunk/d
1c00: 6f 63 2f 6f 73 38 2d 63 70 2e 6d 64 0d 0a 0d 0a oc/os8-cp.md....
1c10: 0d 0a 23 23 20 3c 61 20 69 64 3d 22 6c 61 6e 67 ..## <a id="lang
1c20: 22 3e 3c 2f 61 3e 50 72 6f 67 72 61 6d 6d 69 6e "></a>Programmin
1c30: 67 20 45 6e 76 69 72 6f 6e 6d 65 6e 74 73 0d 0a g Environments..
1c40: 0d 0a 53 6f 6d 65 20 6f 66 20 74 68 65 20 70 72 ..Some of the pr
1c50: 6f 67 72 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61 ogramming langua
1c60: 67 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 73 20 ge environments
1c70: 61 76 61 69 6c 61 62 6c 65 20 77 69 74 68 69 6e available within
1c80: 20 6f 75 72 20 4f 53 2f 38 20 64 69 73 74 72 69 our OS/8 distri
1c90: 62 75 74 69 6f 6e 20 68 61 76 65 20 74 68 65 69 bution have thei
1ca0: 72 20 6f 77 6e 20 77 61 79 73 20 6f 66 20 70 75 r own ways of pu
1cb0: 6c 6c 69 6e 67 20 74 65 78 74 20 69 6e 20 66 72 lling text in fr
1cc0: 6f 6d 20 65 78 74 65 72 6e 61 6c 20 6d 65 64 69 om external medi
1cd0: 61 2e 20 53 65 65 20 66 6f 72 20 65 78 61 6d 70 a. See for examp
1ce0: 6c 65 20 74 68 65 20 5b 6d 61 6e 79 20 6d 65 74 le the [many met
1cf0: 68 6f 64 73 5d 5b 75 77 66 6c 5d 20 77 65 27 76 hods][uwfl] we'v
1d00: 65 20 63 61 74 61 6c 6f 67 65 64 20 66 6f 72 20 e cataloged for
1d10: 64 6f 69 6e 67 20 74 68 69 73 20 69 6e 20 55 2f doing this in U/
1d20: 57 20 46 4f 43 41 4c 2e 20 45 76 65 6e 20 69 66 W FOCAL. Even if
1d30: 20 79 6f 75 20 61 72 65 6e 27 74 20 75 73 69 6e you aren't usin
1d40: 67 20 46 4f 43 41 4c 2c 20 73 6f 6d 65 20 6f 66 g FOCAL, some of
1d50: 20 74 68 65 20 69 64 65 61 73 20 74 68 65 72 65 the ideas there
1d60: 20 6d 61 79 20 73 70 61 72 6b 20 69 64 65 61 73 may spark ideas
1d70: 20 79 6f 75 20 63 61 6e 20 75 73 65 20 69 6e 20 you can use in
1d80: 79 6f 75 72 20 70 72 6f 67 72 61 6d 6d 69 6e 67 your programming
1d90: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 6f 66 20 environment of
1da0: 63 68 6f 69 63 65 2e 0d 0a 0d 0a 5b 75 77 66 6c choice.....[uwfl
1db0: 5d 3a 20 68 74 74 70 73 3a 2f 2f 74 61 6e 67 65 ]: https://tange
1dc0: 6e 74 73 6f 66 74 2e 63 6f 6d 2f 70 69 64 70 38 ntsoft.com/pidp8
1dd0: 69 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f i/doc/trunk/doc/
1de0: 75 77 66 6f 63 61 6c 2d 6d 61 6e 75 61 6c 2d 73 uwfocal-manual-s
1df0: 75 70 70 2e 6d 64 23 6c 6f 61 64 69 6e 67 0d 0a upp.md#loading..
1e00: 0d 0a 0d 0a 23 20 4c 69 63 65 6e 73 65 0d 0a 0d ....# License...
1e10: 0a 43 6f 70 79 72 69 67 68 74 20 c2 a9 20 32 30 .Copyright © 20
1e20: 31 38 2d 32 30 31 39 20 62 79 20 57 61 72 72 65 18-2019 by Warre
1e30: 6e 20 59 6f 75 6e 67 2e 20 54 68 69 73 20 64 6f n Young. This do
1e40: 63 75 6d 65 6e 74 20 69 73 20 6c 69 63 65 6e 73 cument is licens
1e50: 65 64 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 ed under the ter
1e60: 6d 73 20 6f 66 20 5b 74 68 65 20 53 49 4d 48 20 ms of [the SIMH
1e70: 6c 69 63 65 6e 73 65 5d 5b 73 6c 5d 2e 0d 0a 0d license][sl]....
1e80: 0a 5b 73 6c 5d 3a 20 68 74 74 70 73 3a 2f 2f 74 .[sl]: https://t
1e90: 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 70 angentsoft.com/p
1ea0: 69 64 70 38 69 2f 64 6f 63 2f 74 72 75 6e 6b 2f idp8i/doc/trunk/
1eb0: 53 49 4d 48 2d 4c 49 43 45 4e 53 45 2e 6d 64 0a SIMH-LICENSE.md.
1ec0: 5a 20 33 37 62 37 61 33 30 61 32 31 65 61 36 32 Z 37b7a30a21ea62
1ed0: 33 30 36 35 31 33 37 64 65 64 32 30 34 39 65 35 3065137ded2049e5
1ee0: 38 33 0a 83.