0000: 44 20 32 30 31 39 2d 30 38 2d 30 39 54 30 30 3a D 2019-08-09T00:
0010: 34 32 3a 35 33 2e 32 33 39 0a 4c 20 48 6f 6d 65 42:53.239.L Home
0020: 0a 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f .N text/x-markdo
0030: 77 6e 0a 50 20 32 61 61 34 35 37 32 31 32 38 35 wn.P 2aa45721285
0040: 62 65 32 33 33 37 31 66 36 30 31 64 31 63 30 66 be23371f601d1c0f
0050: 36 38 36 63 32 61 65 30 30 62 38 64 35 0a 55 20 686c2ae00b8d5.U
0060: 74 61 6e 67 65 6e 74 0a 57 20 31 33 38 30 35 0a tangent.W 13805.
0070: 23 20 57 68 61 74 20 49 74 20 49 73 0d 0a 0d 0a # What It Is....
0080: 54 68 69 73 20 72 65 70 6f 73 69 74 6f 72 79 20 This repository
0090: 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 5b is the current [
00a0: 6f 66 66 69 63 69 61 6c 5d 28 68 74 74 70 73 3a official](https:
00b0: 2f 2f 67 72 6f 75 70 73 2e 67 6f 6f 67 6c 65 2e //groups.google.
00c0: 63 6f 6d 2f 64 2f 6d 73 67 2f 70 69 64 70 2d 38 com/d/msg/pidp-8
00d0: 2f 56 58 74 39 31 34 61 41 74 74 67 2f 45 36 45 /VXt914aAttg/E6E
00e0: 43 47 30 4b 4c 43 41 41 4a 29 20 50 69 44 50 2d CG0KLCAAJ) PiDP-
00f0: 38 2f 49 20 73 6f 66 74 77 61 72 65 20 64 65 76 8/I software dev
0100: 65 6c 6f 70 6d 65 6e 74 20 6e 65 78 75 73 2e 20 elopment nexus.
0110: 48 65 72 65 20 77 65 20 63 6f 6e 74 69 6e 75 65 Here we continue
0120: 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 6f 66 20 development of
0130: 74 68 65 20 73 6f 66 74 77 61 72 65 20 66 72 6f the software fro
0140: 6d 20 74 68 65 20 6c 61 73 74 20 73 74 61 62 6c m the last stabl
0150: 65 20 73 6f 66 74 77 61 72 65 20 76 65 72 73 69 e software versi
0160: 6f 6e 20 70 75 62 6c 69 73 68 65 64 20 6f 6e 20 on published on
0170: 74 68 65 20 5b 6b 69 74 20 69 6e 66 6f 72 6d 61 the [kit informa
0180: 74 69 6f 6e 20 73 69 74 65 5d 28 68 74 74 70 3a tion site](http:
0190: 2f 2f 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2e 77 //obsolescence.w
01a0: 69 78 73 69 74 65 2e 63 6f 6d 2f 6f 62 73 6f 6c ixsite.com/obsol
01b0: 65 73 63 65 6e 63 65 2f 70 69 64 70 2d 38 2d 64 escence/pidp-8-d
01c0: 65 74 61 69 6c 73 29 2e 20 54 68 69 73 20 73 6f etails). This so
01d0: 66 74 77 61 72 65 20 64 69 66 66 65 72 73 20 69 ftware differs i
01e0: 6e 20 5b 73 65 76 65 72 61 6c 20 6d 61 6a 6f 72 n [several major
01f0: 20 77 61 79 73 5d 28 2f 77 69 6b 69 3f 6e 61 6d ways](/wiki?nam
0200: 65 3d 4d 61 6a 6f 72 2b 44 69 66 66 65 72 65 6e e=Major+Differen
0210: 63 65 73 29 20 61 6e 64 20 5b 64 6f 7a 65 6e 73 ces) and [dozens
0220: 20 6f 66 20 6d 69 6e 6f 72 20 77 61 79 73 5d 5b of minor ways][
0230: 63 6c 5d 20 66 72 6f 6d 20 74 68 61 74 20 6f 6c cl] from that ol
0240: 64 20 73 6f 66 74 77 61 72 65 2e 0d 0a 0d 0a 0d d software......
0250: 0a 23 20 3c 61 20 6e 61 6d 65 3d 22 73 72 63 22 .# <a name="src"
0260: 3e 3c 2f 61 3e 47 65 74 74 69 6e 67 20 53 74 61 ></a>Getting Sta
0270: 72 74 65 64 3a 20 53 6f 75 72 63 65 20 43 6f 64 rted: Source Cod
0280: 65 0d 0a 0d 0a 54 68 65 20 65 66 66 69 63 69 65 e....The efficie
0290: 6e 74 20 6d 65 74 68 6f 64 20 74 6f 20 67 65 74 nt method to get
02a0: 20 73 74 61 72 74 65 64 20 69 73 20 74 6f 20 69 started is to i
02b0: 6e 73 74 61 6c 6c 20 74 68 69 73 20 73 6f 66 74 nstall this soft
02c0: 77 61 72 65 20 69 6e 74 6f 20 61 6e 20 65 78 69 ware into an exi
02d0: 73 74 69 6e 67 20 5b 52 61 73 70 62 69 61 6e 5d sting [Raspbian]
02e0: 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 72 61 73 (https://www.ras
02f0: 70 62 65 72 72 79 70 69 2e 6f 72 67 2f 64 6f 77 pberrypi.org/dow
0300: 6e 6c 6f 61 64 73 2f 72 61 73 70 62 69 61 6e 2f nloads/raspbian/
0310: 29 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 6f ) installation o
0320: 6e 20 74 68 65 20 50 69 20 77 68 69 63 68 20 79 n the Pi which y
0330: 6f 75 20 61 72 65 20 75 73 69 6e 67 20 77 69 74 ou are using wit
0340: 68 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 62 h the PiDP-8/I b
0350: 6f 61 72 64 2e 20 49 74 20 61 6c 73 6f 20 77 6f oard. It also wo
0360: 72 6b 73 20 77 69 74 68 20 5b 73 6f 6d 65 20 6f rks with [some o
0370: 74 68 65 72 20 4f 53 65 73 5d 28 68 74 74 70 73 ther OSes](https
0380: 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 ://tangentsoft.c
0390: 6f 6d 2f 70 69 64 70 38 69 2f 77 69 6b 69 3f 6e om/pidp8i/wiki?n
03a0: 61 6d 65 3d 4f 53 2b 43 6f 6d 70 61 74 69 62 69 ame=OS+Compatibi
03b0: 6c 69 74 79 29 2e 0d 0a 0d 0a 59 6f 75 20 63 61 lity).....You ca
03c0: 6e 20 64 6f 77 6e 6c 6f 61 64 20 74 68 65 20 6c n download the l
03d0: 61 74 65 73 74 20 72 65 6c 65 61 73 65 20 e2 80 atest release â€
03e0: 94 20 63 75 74 20 6f 6e 20 32 30 31 39 2e 30 34 ” cut on 2019.04
03f0: 2e 32 35 20 e2 80 94 20 61 73 20 5b 61 20 74 61 .25 — as [a ta
0400: 72 62 61 6c 6c 5d 28 2f 74 61 72 62 61 6c 6c 2f rball](/tarball/
0410: 70 69 64 70 38 69 2d 76 32 30 31 39 2e 30 34 2e pidp8i-v2019.04.
0420: 32 35 2e 74 61 72 2e 67 7a 3f 72 3d 72 65 6c 65 25.tar.gz?r=rele
0430: 61 73 65 29 2e 20 28 41 62 6f 75 74 20 2a 2a 37 ase). (About **7
0440: 2e 35 20 4d 42 2a 2a 2e 29 0d 0a 0d 0a 49 66 20 .5 MB**.)....If
0450: 79 6f 75 20 77 61 6e 74 20 74 68 65 20 62 6c 65 you want the ble
0460: 65 64 69 6e 67 20 65 64 67 65 20 76 65 72 73 69 eding edge versi
0470: 6f 6e 2c 20 79 6f 75 20 63 61 6e 20 65 69 74 68 on, you can eith
0480: 65 72 20 63 68 65 63 6b 20 69 74 20 6f 75 74 20 er check it out
0490: 66 72 6f 6d 20 74 68 65 20 46 6f 73 73 69 6c 20 from the Fossil
04a0: 73 6f 75 72 63 65 20 63 6f 64 65 20 72 65 70 6f source code repo
04b0: 73 69 74 6f 72 79 20 70 6f 77 65 72 69 6e 67 20 sitory powering
04c0: 74 68 69 73 20 77 65 62 20 73 69 74 65 20 62 79 this web site by
04d0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 69 following the i
04e0: 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 6e 20 5b nstructions in [
04f0: 74 68 65 20 68 61 63 6b 65 72 73 27 20 67 75 69 the hackers' gui
0500: 64 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 48 de](/doc/trunk/H
0510: 41 43 4b 45 52 53 2e 6d 64 29 20 6f 72 20 79 6f ACKERS.md) or yo
0520: 75 20 63 61 6e 20 73 69 6d 70 6c 79 20 64 6f 77 u can simply dow
0530: 6e 6c 6f 61 64 20 74 68 65 20 74 69 70 20 6f 66 nload the tip of
0540: 20 74 72 75 6e 6b 20 61 73 20 5b 61 20 74 61 72 trunk as [a tar
0550: 62 61 6c 6c 5d 28 2f 74 61 72 62 61 6c 6c 2f 70 ball](/tarball/p
0560: 69 64 70 38 69 2d 74 72 75 6e 6b 2e 74 61 72 2e idp8i-trunk.tar.
0570: 67 7a 29 2e 0d 0a 0d 0a 53 65 65 20 5b 74 68 65 gz).....See [the
0580: 20 60 52 45 41 44 4d 45 2e 6d 64 60 20 66 69 6c `README.md` fil
0590: 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 e](/doc/trunk/RE
05a0: 41 44 4d 45 2e 6d 64 29 20 66 6f 72 20 6d 6f 72 ADME.md) for mor
05b0: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e e information on
05c0: 20 68 6f 77 20 74 6f 20 69 6e 73 74 61 6c 6c 20 how to install
05d0: 74 68 69 73 20 69 6e 74 6f 20 79 6f 75 72 20 65 this into your e
05e0: 78 69 73 74 69 6e 67 20 52 61 73 70 62 65 72 72 xisting Raspberr
05f0: 79 20 50 69 20 4f 53 2e 0d 0a 0d 0a 0d 0a 23 20 y Pi OS.......#
0600: 3c 61 20 6e 61 6d 65 3d 22 62 6f 73 69 22 3e 3c <a name="bosi"><
0610: 2f 61 3e 47 65 74 74 69 6e 67 20 53 74 61 72 74 /a>Getting Start
0620: 65 64 3a 20 42 69 6e 61 72 79 20 4f 53 20 49 6d ed: Binary OS Im
0630: 61 67 65 73 0d 0a 0d 0a 54 68 6f 73 65 20 77 69 ages....Those wi
0640: 74 68 20 70 6c 65 6e 74 79 20 6f 66 20 49 6e 74 th plenty of Int
0650: 65 72 6e 65 74 20 62 61 6e 64 77 69 64 74 68 20 ernet bandwidth
0660: 61 6e 64 20 61 20 6d 69 63 72 6f 20 53 44 20 63 and a micro SD c
0670: 61 72 64 20 74 68 65 79 20 64 6f 6e 27 74 20 6d ard they don't m
0680: 69 6e 64 20 6f 76 65 72 77 72 69 74 69 6e 67 20 ind overwriting
0690: 6d 61 79 20 70 72 65 66 65 72 20 74 6f 20 64 6f may prefer to do
06a0: 77 6e 6c 6f 61 64 20 74 68 65 20 73 6f 66 74 77 wnload the softw
06b0: 61 72 65 20 68 6f 73 74 65 64 20 68 65 72 65 20 are hosted here
06c0: 69 6e 20 62 69 6e 61 72 79 20 4f 53 20 69 6d 61 in binary OS ima
06d0: 67 65 20 66 6f 72 6d 2e 20 54 68 65 72 65 20 61 ge form. There a
06e0: 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73 2c re two versions,
06f0: 20 65 61 63 68 20 62 61 73 65 64 20 6f 6e 20 52 each based on R
0700: 61 73 70 62 69 61 6e 20 53 74 72 65 74 63 68 20 aspbian Stretch
0710: 4c 69 74 65 20 61 6e 64 20 65 61 63 68 20 72 6f Lite and each ro
0720: 75 67 68 6c 79 20 2a 2a 35 30 30 20 4d 42 2a 2a ughly **500 MB**
0730: 3a 0d 0a 0d 0a 31 2e 20 5b 4d 75 6c 74 69 2d 63 :....1. [Multi-c
0740: 6f 72 65 20 76 65 72 73 69 6f 6e 5d 28 68 74 74 ore version](htt
0750: 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 74 ps://tangentsoft
0760: 2e 63 6f 6d 2f 64 6c 2f 70 69 64 70 38 69 2d 32 .com/dl/pidp8i-2
0770: 30 31 39 2e 30 34 2e 32 35 2d 69 6c 73 2d 73 74 019.04.25-ils-st
0780: 72 65 74 63 68 2d 6c 69 74 65 2e 69 6d 67 2e 7a retch-lite.img.z
0790: 69 70 29 2c 20 76 32 30 31 39 2e 30 34 2e 32 35 ip), v2019.04.25
07a0: 20 e2 80 94 20 54 68 69 73 20 4f 53 20 69 6d 61 — This OS ima
07b0: 67 65 20 69 73 20 62 75 69 6c 74 20 77 69 74 68 ge is built with
07c0: 20 74 68 65 20 5b 69 6e 63 61 6e 64 65 73 63 65 the [incandesce
07d0: 6e 74 20 6c 61 6d 70 20 73 69 6d 75 6c 61 74 6f nt lamp simulato
07e0: 72 5d 28 77 69 6b 69 3f 6e 61 6d 65 3d 49 6e 63 r](wiki?name=Inc
07f0: 61 6e 64 65 73 63 65 6e 74 2b 4c 61 6d 70 2b 53 andescent+Lamp+S
0800: 69 6d 75 6c 61 74 6f 72 29 20 77 68 69 63 68 20 imulator) which
0810: 6f 6e 6c 79 20 77 6f 72 6b 73 20 70 72 6f 70 65 only works prope
0820: 72 6c 79 20 6f 6e 20 74 68 65 20 6d 75 6c 74 69 rly on the multi
0830: 2d 63 6f 72 65 20 52 61 73 70 62 65 72 72 79 20 -core Raspberry
0840: 50 69 20 32 20 61 6e 64 20 33 20 62 6f 61 72 64 Pi 2 and 3 board
0850: 73 2e 20 28 41 6c 6c 20 6d 6f 64 65 6c 73 2e 29 s. (All models.)
0860: 0d 0a 0d 0a 20 20 20 20 49 74 20 74 61 6b 65 73 .... It takes
0870: 20 61 62 6f 75 74 20 6f 6e 65 20 61 6e 64 20 61 about one and a
0880: 20 68 61 6c 66 20 6f 66 20 74 68 65 20 66 6f 75 half of the fou
0890: 72 20 61 76 61 69 6c 61 62 6c 65 20 43 50 55 20 r available CPU
08a0: 63 6f 72 65 73 20 6f 6e 20 61 20 50 69 20 33 42 cores on a Pi 3B
08b0: 20 77 68 69 6c 65 20 72 75 6e 6e 69 6e 67 20 61 while running a
08c0: 62 6f 75 74 20 2a 32 34 26 74 69 6d 65 73 3b 2a bout *24×*
08d0: 20 66 61 73 74 65 72 20 74 68 61 6e 20 61 20 72 faster than a r
08e0: 65 61 6c 20 50 44 50 2d 38 2f 49 2e 20 49 20 64 eal PDP-8/I. I d
08f0: 6f 20 6e 6f 74 20 6b 6e 6f 77 20 74 68 65 20 6e o not know the n
0900: 75 6d 62 65 72 73 20 66 6f 72 20 61 20 50 69 20 umbers for a Pi
0910: 32 2e 0d 0a 0d 0a 32 2e 20 5b 53 69 6e 67 6c 65 2.....2. [Single
0920: 2d 63 6f 72 65 20 76 65 72 73 69 6f 6e 5d 28 68 -core version](h
0930: 74 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f ttps://tangentso
0940: 66 74 2e 63 6f 6d 2f 64 6c 2f 70 69 64 70 38 69 ft.com/dl/pidp8i
0950: 2d 32 30 31 39 2e 30 34 2e 32 35 2d 6e 6c 73 2d -2019.04.25-nls-
0960: 73 74 72 65 74 63 68 2d 6c 69 74 65 2e 69 6d 67 stretch-lite.img
0970: 2e 7a 69 70 29 2c 20 76 32 30 31 39 2e 30 34 2e .zip), v2019.04.
0980: 32 35 20 e2 80 94 20 46 6f 72 20 74 68 6f 73 65 25 — For those
0990: 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 52 61 73 70 running on Rasp
09a0: 62 65 72 72 79 20 50 69 20 4d 6f 64 65 6c 20 41 berry Pi Model A
09b0: 2b 20 61 6e 64 20 42 2b 20 62 6f 61 72 64 73 20 + and B+ boards
09c0: 6f 72 20 74 68 65 20 50 69 20 5a 65 72 6f 2c 20 or the Pi Zero,
09d0: 74 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76 65 this alternative
09e0: 20 64 6f 77 6e 6c 6f 61 64 20 64 69 73 61 62 6c download disabl
09f0: 65 73 20 74 68 65 20 49 4c 53 20 66 65 61 74 75 es the ILS featu
0a00: 72 65 2e 20 49 74 20 61 6c 73 6f 20 73 6c 6f 77 re. It also slow
0a10: 73 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72 20 s the simulator
0a20: 64 6f 77 6e 20 73 6f 20 69 74 20 75 73 65 73 20 down so it uses
0a30: 6f 6e 6c 79 20 61 62 6f 75 74 20 68 61 6c 66 20 only about half
0a40: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 43 50 the available CP
0a50: 55 20 70 6f 77 65 72 20 74 6f 20 6c 65 61 76 65 U power to leave
0a60: 20 73 6f 6d 65 20 68 6f 73 74 20 43 50 55 20 70 some host CPU p
0a70: 6f 77 65 72 20 66 6f 72 20 62 61 63 6b 67 72 6f ower for backgro
0a80: 75 6e 64 20 74 61 73 6b 73 2e 20 54 68 69 73 20 und tasks. This
0a90: 61 6c 6c 6f 77 73 20 69 74 20 74 6f 20 72 75 6e allows it to run
0aa0: 20 50 44 50 2d 38 20 73 6f 66 74 77 61 72 65 20 PDP-8 software
0ab0: 72 6f 75 67 68 6c 79 20 2a 33 26 74 69 6d 65 73 roughly *3×
0ac0: 3b 2a 20 61 73 20 66 61 73 74 20 61 73 20 61 20 ;* as fast as a
0ad0: 72 65 61 6c 20 50 44 50 2d 38 2f 49 2c 20 64 65 real PDP-8/I, de
0ae0: 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 pending on the s
0af0: 70 65 65 64 20 6f 66 20 74 68 65 20 50 69 20 79 peed of the Pi y
0b00: 6f 75 20 72 75 6e 20 69 74 20 6f 6e 2e 0d 0a 0d ou run it on....
0b10: 0a 20 20 20 20 54 68 69 73 20 69 6d 61 67 65 20 . This image
0b20: 77 69 6c 6c 20 61 6c 73 6f 20 72 75 6e 20 6f 6e will also run on
0b30: 20 61 20 6d 75 6c 74 69 2d 63 6f 72 65 20 50 69 a multi-core Pi
0b40: 2e 20 49 74 20 77 69 6c 6c 20 72 75 6e 20 50 44 . It will run PD
0b50: 50 2d 38 20 73 6f 66 74 77 61 72 65 20 73 6c 6f P-8 software slo
0b60: 77 65 72 20 74 68 61 6e 20 74 68 65 20 49 4c 53 wer than the ILS
0b70: 20 76 65 72 73 69 6f 6e 2c 20 73 69 6e 63 65 20 version, since
0b80: 69 74 20 77 69 6c 6c 20 61 6c 73 6f 20 62 65 20 it will also be
0b90: 61 66 66 65 63 74 65 64 20 62 79 20 74 68 65 20 affected by the
0ba0: 69 6e 74 65 6e 74 69 6f 6e 61 6c 20 35 30 25 20 intentional 50%
0bb0: 43 50 55 20 75 73 61 67 65 20 6c 69 6d 69 74 2c CPU usage limit,
0bc0: 20 62 75 74 20 62 65 63 61 75 73 65 20 65 61 63 but because eac
0bd0: 68 20 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 63 h one of those c
0be0: 6f 72 65 73 20 61 72 65 20 66 61 73 74 65 72 20 ores are faster
0bf0: 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 2d 63 6f than a single-co
0c00: 72 65 20 50 69 20 61 6e 64 20 74 68 65 20 6f 74 re Pi and the ot
0c10: 68 65 72 20 63 6f 72 65 73 20 63 61 6e 20 74 61 her cores can ta
0c20: 6b 65 20 74 68 65 20 6c 6f 61 64 20 6f 66 20 62 ke the load of b
0c30: 61 63 6b 67 72 6f 75 6e 64 20 74 61 73 6b 73 2c ackground tasks,
0c40: 20 69 74 20 73 74 69 6c 6c 20 6d 61 6e 61 67 65 it still manage
0c50: 73 20 74 6f 20 72 75 6e 20 50 44 50 2d 38 20 73 s to run PDP-8 s
0c60: 6f 66 74 77 61 72 65 20 72 6f 75 67 68 6c 79 20 oftware roughly
0c70: 2a 31 30 26 74 69 6d 65 73 3b 2a 20 66 61 73 74 *10×* fast
0c80: 65 72 20 74 68 61 6e 20 61 20 72 65 61 6c 20 50 er than a real P
0c90: 44 50 2d 38 2f 49 2e 0d 0a 0d 0a 53 65 65 20 74 DP-8/I.....See t
0ca0: 68 65 20 5b 69 6e 73 74 61 6c 6c 61 74 69 6f 6e he [installation
0cb0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 5d 28 2f instructions](/
0cc0: 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f 4f 53 doc/trunk/doc/OS
0cd0: 2d 69 6d 61 67 65 73 2e 6d 64 29 20 66 6f 72 20 -images.md) for
0ce0: 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e more information
0cf0: 2e 0d 0a 0d 0a 54 68 65 20 62 69 6e 61 72 79 20 .....The binary
0d00: 4f 53 20 72 65 6c 65 61 73 65 73 20 61 72 65 20 OS releases are
0d10: 6e 6f 74 20 61 6c 77 61 79 73 20 75 70 64 61 74 not always updat
0d20: 65 64 20 77 68 65 6e 20 74 68 65 20 73 6f 75 72 ed when the sour
0d30: 63 65 20 63 6f 64 65 20 72 65 6c 65 61 73 65 73 ce code releases
0d40: 20 61 72 65 20 63 75 74 2c 20 73 69 6e 63 65 20 are cut, since
0d50: 69 74 20 69 73 20 61 20 66 61 69 72 20 61 6d 6f it is a fair amo
0d60: 75 6e 74 20 6f 66 20 77 6f 72 6b 20 74 6f 20 64 unt of work to d
0d70: 6f 20 74 68 6f 73 65 20 62 69 6e 61 72 79 20 72 o those binary r
0d80: 65 6c 65 61 73 65 73 2e 20 41 64 64 72 65 73 73 eleases. Address
0d90: 69 6e 67 20 74 68 61 74 20 69 73 20 74 68 65 20 ing that is the
0da0: 74 6f 70 69 63 20 6f 66 20 74 68 65 20 6e 65 78 topic of the nex
0db0: 74 20 73 65 63 74 69 6f 6e 2e 0d 0a 0d 0a 0d 0a t section.......
0dc0: 23 23 20 3c 61 20 6e 61 6d 65 3d 22 75 70 64 61 ## <a name="upda
0dd0: 74 69 6e 67 22 3e 3c 2f 61 3e 55 70 64 61 74 69 ting"></a>Updati
0de0: 6e 67 20 74 68 65 20 42 69 6e 61 72 79 20 4f 53 ng the Binary OS
0df0: 20 52 65 6c 65 61 73 65 0d 0a 0d 0a 41 73 20 73 Release....As s
0e00: 68 69 70 70 65 64 2c 20 74 68 65 20 62 69 6e 61 hipped, the bina
0e10: 72 79 20 4f 53 20 69 6d 61 67 65 73 20 61 62 6f ry OS images abo
0e20: 76 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 20 ve also contain
0e30: 74 68 65 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 the PiDP-8/I sof
0e40: 74 77 61 72 65 20 73 6f 75 72 63 65 20 63 6f 64 tware source cod
0e50: 65 20 61 6e 64 20 46 6f 73 73 69 6c 2c 20 74 68 e and Fossil, th
0e60: 65 20 74 6f 6f 6c 20 74 68 61 74 20 6c 65 74 73 e tool that lets
0e70: 20 79 6f 75 20 64 6f 77 6e 6c 6f 61 64 20 75 70 you download up
0e80: 64 61 74 65 64 20 73 6f 75 72 63 65 20 63 6f 64 dated source cod
0e90: 65 20 61 73 20 69 74 20 62 65 63 6f 6d 65 73 20 e as it becomes
0ea0: 61 76 61 69 6c 61 62 6c 65 2e 20 55 70 64 61 74 available. Updat
0eb0: 69 6e 67 20 74 68 65 20 73 6f 66 74 77 61 72 65 ing the software
0ec0: 20 69 73 20 74 68 65 72 65 66 6f 72 65 20 6d 75 is therefore mu
0ed0: 63 68 20 73 69 6d 70 6c 65 72 20 74 68 61 6e 20 ch simpler than
0ee0: 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 74 68 65 20 downloading the
0ef0: 77 68 6f 6c 65 20 4f 53 20 61 6c 6c 20 6f 76 65 whole OS all ove
0f00: 72 20 61 67 61 69 6e 20 61 6e 64 20 6f 76 65 72 r again and over
0f10: 77 72 69 74 69 6e 67 20 79 6f 75 72 20 70 65 72 writing your per
0f20: 66 65 63 74 6c 79 20 67 6f 6f 64 20 53 44 20 63 fectly good SD c
0f30: 61 72 64 2e 20 49 66 20 79 6f 75 20 61 72 65 20 ard. If you are
0f40: 75 70 64 61 74 69 6e 67 20 79 6f 75 72 20 65 78 updating your ex
0f50: 69 73 74 69 6e 67 20 72 65 6c 65 61 73 65 20 74 isting release t
0f60: 6f 20 61 20 6e 65 77 65 72 20 72 65 6c 65 61 73 o a newer releas
0f70: 65 20 76 65 72 73 69 6f 6e 2c 20 74 68 69 73 20 e version, this
0f80: 77 6f 72 6b 73 3a 0d 0a 0d 0a 20 20 20 20 24 20 works:.... $
0f90: 63 64 20 7e 2f 70 69 64 70 38 69 0d 0a 20 20 20 cd ~/pidp8i..
0fa0: 20 24 20 66 6f 73 73 69 6c 20 75 70 64 61 74 65 $ fossil update
0fb0: 0d 0a 20 20 20 20 24 20 6d 61 6b 65 20 72 65 63 .. $ make rec
0fc0: 6f 6e 66 69 67 0d 0a 20 20 20 20 24 20 74 6f 6f onfig.. $ too
0fd0: 6c 73 2f 6d 6d 61 6b 65 20 26 26 20 73 75 64 6f ls/mmake && sudo
0fe0: 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0d 0a 20 make install..
0ff0: 20 20 20 24 20 73 75 64 6f 20 73 79 73 74 65 6d $ sudo system
1000: 63 74 6c 20 64 61 65 6d 6f 6e 2d 72 65 6c 6f 61 ctl daemon-reloa
1010: 64 0d 0a 20 20 20 20 24 20 70 69 64 70 38 69 20 d.. $ pidp8i
1020: 72 65 73 74 61 72 74 0d 0a 20 20 20 20 24 20 70 restart.. $ p
1030: 69 64 70 38 69 0d 0a 0d 0a 49 66 20 79 6f 75 20 idp8i....If you
1040: 6e 65 65 64 20 74 6f 20 73 77 69 74 63 68 20 66 need to switch f
1050: 72 6f 6d 20 74 68 65 20 5b 72 65 6c 65 61 73 65 rom the [release
1060: 20 62 72 61 6e 63 68 5d 28 2f 74 69 6d 65 6c 69 branch](/timeli
1070: 6e 65 3f 72 3d 72 65 6c 65 61 73 65 29 20 74 6f ne?r=release) to
1080: 20 74 68 65 20 62 6c 65 65 64 69 6e 67 2d 65 64 the bleeding-ed
1090: 67 65 20 22 74 72 75 6e 6b 22 20 76 65 72 73 69 ge "trunk" versi
10a0: 6f 6e 20 e2 80 94 20 73 75 63 68 20 61 73 20 62 on — such as b
10b0: 65 63 61 75 73 65 20 79 6f 75 20 77 61 6e 74 20 ecause you want
10c0: 74 6f 20 74 72 79 20 61 20 63 68 61 6e 67 65 20 to try a change
10d0: 74 68 61 74 20 68 61 73 20 6e 6f 74 20 79 65 74 that has not yet
10e0: 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64 20 e2 been released â
10f0: 80 94 20 73 69 6d 70 6c 79 20 6d 6f 64 69 66 79 €” simply modify
1100: 20 74 68 65 20 73 65 63 6f 6e 64 20 63 6f 6d 6d the second comm
1110: 61 6e 64 20 6c 69 6b 65 20 73 6f 3a 0d 0a 0d 0a and like so:....
1120: 20 20 20 20 24 20 66 6f 73 73 69 6c 20 75 70 64 $ fossil upd
1130: 61 74 65 20 74 72 75 6e 6b 0d 0a 0d 0a 59 6f 75 ate trunk....You
1140: 20 6f 6e 6c 79 20 6e 65 65 64 20 74 68 65 20 62 only need the b
1150: 72 61 6e 63 68 20 61 72 67 75 6d 65 6e 74 20 74 ranch argument t
1160: 6f 20 74 68 65 20 60 66 6f 73 73 69 6c 20 75 70 o the `fossil up
1170: 64 61 74 65 60 20 63 6f 6d 6d 61 6e 64 20 77 68 date` command wh
1180: 65 6e 20 73 77 69 74 63 68 69 6e 67 20 62 72 61 en switching bra
1190: 6e 63 68 65 73 2e 20 4f 6e 63 65 20 79 6f 75 27 nches. Once you'
11a0: 76 65 20 73 77 69 74 63 68 65 64 20 66 72 6f 6d ve switched from
11b0: 20 74 68 65 20 72 65 6c 65 61 73 65 20 62 72 61 the release bra
11c0: 6e 63 68 20 74 6f 20 74 68 65 20 74 72 75 6e 6b nch to the trunk
11d0: 2c 20 79 6f 75 20 64 6f 6e 27 74 20 6e 65 65 64 , you don't need
11e0: 20 74 6f 20 6b 65 65 70 20 73 70 65 63 69 66 79 to keep specify
11f0: 69 6e 67 20 22 74 72 75 6e 6b 22 20 62 65 63 61 ing "trunk" beca
1200: 75 73 65 20 46 6f 73 73 69 6c 20 6b 65 65 70 73 use Fossil keeps
1210: 20 79 6f 75 72 20 63 68 65 63 6b 6f 75 74 20 64 your checkout d
1220: 69 72 65 63 74 6f 72 79 20 6f 6e 20 61 20 67 69 irectory on a gi
1230: 76 65 6e 20 62 72 61 6e 63 68 20 6f 6e 63 65 20 ven branch once
1240: 79 6f 75 27 76 65 20 73 77 69 74 63 68 65 64 20 you've switched
1250: 74 6f 20 69 74 2e 20 54 68 75 73 2c 20 79 6f 75 to it. Thus, you
1260: 27 64 20 6f 6e 6c 79 20 6e 65 65 64 20 74 6f 20 'd only need to
1270: 67 69 76 65 20 61 20 62 72 61 6e 63 68 20 6e 61 give a branch na
1280: 6d 65 20 77 68 65 6e 20 73 77 69 74 63 68 69 6e me when switchin
1290: 67 20 62 61 63 6b 20 74 6f 20 74 68 65 20 72 65 g back to the re
12a0: 6c 65 61 73 65 20 62 72 61 6e 63 68 3a 0d 0a 0d lease branch:...
12b0: 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 75 70 . $ fossil up
12c0: 64 61 74 65 20 72 65 6c 65 61 73 65 0d 0a 0d 0a date release....
12d0: 54 68 65 20 61 62 6f 76 65 20 63 6f 6d 6d 61 6e The above comman
12e0: 64 73 20 61 73 73 75 6d 65 20 74 79 70 69 63 61 ds assume typica
12f0: 6c 20 73 69 74 75 61 74 69 6f 6e 73 20 61 6e 64 l situations and
1300: 20 64 65 66 61 75 6c 74 20 6f 70 74 69 6f 6e 73 default options
1310: 2e 20 46 6f 72 20 6d 6f 72 65 20 61 64 76 61 6e . For more advan
1320: 63 65 64 20 63 61 73 65 73 2c 20 73 65 65 20 5b ced cases, see [
1330: 74 68 65 20 60 52 45 41 44 4d 45 2e 6d 64 60 20 the `README.md`
1340: 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b file](/doc/trunk
1350: 2f 52 45 41 44 4d 45 2e 6d 64 29 2e 0d 0a 0d 0a /README.md).....
1360: 0d 0a 23 23 20 3c 61 20 69 64 3d 22 6f 73 38 22 ..## <a id="os8"
1370: 3e 3c 2f 61 3e 4f 53 2f 38 20 52 4b 30 35 20 4d ></a>OS/8 RK05 M
1380: 65 64 69 61 0d 0a 0d 0a 4f 6e 65 20 6f 66 20 74 edia....One of t
1390: 68 65 20 6d 6f 73 74 20 74 69 6d 65 20 63 6f 6e he most time con
13a0: 73 75 6d 69 6e 67 20 73 74 65 70 73 20 69 6e 20 suming steps in
13b0: 62 75 69 6c 64 69 6e 67 20 6f 75 72 20 50 69 44 building our PiD
13c0: 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 20 69 P-8/I software i
13d0: 73 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20 4f s building the O
13e0: 53 2f 38 20 52 4b 30 35 20 64 69 73 6b 20 69 6d S/8 RK05 disk im
13f0: 61 67 65 73 20 66 72 6f 6d 20 70 72 69 73 74 69 ages from pristi
1400: 6e 65 2c 20 74 65 73 74 65 64 2c 20 63 75 72 61 ne, tested, cura
1410: 74 65 64 20 73 6f 75 72 63 65 73 2e 20 49 66 20 ted sources. If
1420: 79 6f 75 20 73 69 6d 70 6c 79 20 77 61 6e 74 20 you simply want
1430: 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 64 69 the resulting di
1440: 73 6b 20 69 6d 61 67 65 73 2c 20 77 65 20 70 72 sk images, we pr
1450: 6f 76 69 64 65 20 74 68 65 6d 20 68 65 72 65 20 ovide them here
1460: 66 6f 72 20 79 6f 75 20 74 6f 20 64 6f 77 6e 6c for you to downl
1470: 6f 61 64 3a 0d 0a 0d 0a 7c 20 42 61 73 65 20 4e oad:....| Base N
1480: 61 6d 65 20 7c 20 43 6f 6e 74 65 6e 74 73 0d 0a ame | Contents..
1490: 7c 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 7c 20 2d | ---------- | -
14a0: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 7c 20 5b 60 62 6f --------..| [`bo
14b0: 6f 74 60 5d 28 2f 75 76 2f 76 33 64 2e 72 6b 30 ot`](/uv/v3d.rk0
14c0: 35 29 20 7c 20 62 6f 6f 74 61 62 6c 65 20 4f 53 5) | bootable OS
14d0: 2f 38 20 56 33 44 20 52 4b 30 35 20 64 69 73 6b /8 V3D RK05 disk
14e0: 20 69 6d 61 67 65 20 77 69 74 68 20 73 65 6c 65 image with sele
14f0: 63 74 65 64 20 5b 61 64 64 2d 6f 6e 73 5d 28 2f cted [add-ons](/
1500: 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 doc/trunk/README
1510: 2e 6d 64 23 64 69 73 61 62 6c 65 2d 6f 73 38 29 .md#disable-os8)
1520: 20 61 6e 64 20 5b 70 61 74 63 68 65 73 5d 28 2f and [patches](/
1530: 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f 6f 73 doc/trunk/doc/os
1540: 38 2d 70 61 74 63 68 69 6e 67 2e 6d 64 29 0d 0a 8-patching.md)..
1550: 7c 20 5b 60 64 69 73 74 60 5d 28 2f 75 76 2f 76 | [`dist`](/uv/v
1560: 33 64 2d 64 69 73 74 2e 72 6b 30 35 29 20 7c 20 3d-dist.rk05) |
1570: 73 61 6d 65 20 61 73 20 60 62 6f 6f 74 60 20 62 same as `boot` b
1580: 75 74 20 77 69 74 68 20 4f 53 2f 38 20 69 6e 20 ut with OS/8 in
1590: 69 74 73 20 61 73 2d 64 69 73 74 72 69 62 75 74 its as-distribut
15a0: 65 64 20 73 74 61 74 65 3a 20 6e 6f 20 70 61 74 ed state: no pat
15b0: 63 68 65 73 2c 20 6e 6f 20 61 64 64 2d 6f 6e 73 ches, no add-ons
15c0: 0d 0a 7c 20 5b 60 73 72 63 60 5d 28 2f 75 76 2f ..| [`src`](/uv/
15d0: 76 33 64 2d 73 72 63 2e 72 6b 30 35 29 20 7c 20 v3d-src.rk05) |
15e0: 6e 6f 6e 2d 62 6f 6f 74 61 62 6c 65 20 64 69 73 non-bootable dis
15f0: 6b 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 k containing the
1600: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 6c 6c contents of all
1610: 20 74 65 6e 20 4f 53 2f 38 20 56 33 44 20 73 6f ten OS/8 V3D so
1620: 75 72 63 65 20 74 61 70 65 73 0d 0a 0d 0a 54 68 urce tapes....Th
1630: 65 73 65 20 64 69 73 6b 20 69 6d 61 67 65 73 20 ese disk images
1640: 77 65 72 65 20 6c 61 73 74 20 75 70 64 61 74 65 were last update
1650: 64 20 6f 6e 20 32 30 31 39 2e 30 34 2e 32 35 20 d on 2019.04.25
1660: 69 6e 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 in conjunction w
1670: 69 74 68 20 5b 74 68 65 20 72 65 6c 65 61 73 65 ith [the release
1680: 20 6d 61 64 65 20 61 74 20 74 68 65 20 73 61 6d made at the sam
1690: 65 20 74 69 6d 65 5d 28 2f 64 6f 63 2f 74 72 75 e time](/doc/tru
16a0: 6e 6b 2f 43 68 61 6e 67 65 4c 6f 67 2e 6d 64 23 nk/ChangeLog.md#
16b0: 32 30 31 39 30 34 32 35 29 20 61 6e 64 20 73 6f 20190425) and so
16c0: 20 61 72 65 20 63 6f 6e 73 69 64 65 72 65 64 20 are considered
16d0: 73 74 61 62 6c 65 2e 0d 0a 0d 0a 54 68 65 73 65 stable.....These
16e0: 20 64 69 73 6b 20 69 6d 61 67 65 73 20 73 68 6f disk images sho
16f0: 75 6c 64 20 77 6f 72 6b 20 75 6e 64 65 72 20 53 uld work under S
1700: 49 4d 48 20 6f 6e 20 61 6e 79 20 70 6c 61 74 66 IMH on any platf
1710: 6f 72 6d 2c 20 61 6e 64 20 63 6f 75 6c 64 20 70 orm, and could p
1720: 6f 74 65 6e 74 69 61 6c 6c 79 20 65 76 65 6e 20 otentially even
1730: 62 65 20 77 72 69 74 74 65 6e 20 62 61 63 6b 20 be written back
1740: 74 6f 20 72 65 61 6c 20 52 4b 30 35 20 64 69 73 to real RK05 dis
1750: 6b 20 70 61 63 6b 73 20 61 6e 64 20 72 75 6e 20 k packs and run
1760: 6f 6e 20 61 63 74 75 61 6c 20 50 44 50 2d 38 20 on actual PDP-8
1770: 68 61 72 64 77 61 72 65 21 20 4c 65 74 20 75 73 hardware! Let us
1780: 20 6b 6e 6f 77 20 68 6f 77 20 79 6f 75 27 72 65 know how you're
1790: 20 75 73 69 6e 67 20 74 68 65 73 65 20 66 69 6c using these fil
17a0: 65 73 20 6f 6e 20 74 68 65 20 5b 50 69 44 50 2d es on the [PiDP-
17b0: 38 2f 49 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 8/I mailing list
17c0: 5d 28 67 72 6f 75 70 73 2e 67 6f 6f 67 6c 65 2e ](groups.google.
17d0: 63 6f 6d 2f 66 6f 72 75 6d 2f 23 21 66 6f 72 75 com/forum/#!foru
17e0: 6d 2f 70 69 64 70 2d 38 29 3b 20 77 65 27 72 65 m/pidp-8); we're
17f0: 20 63 75 72 69 6f 75 73 20 68 6f 77 20 66 61 72 curious how far
1800: 20 74 68 65 73 65 20 73 70 72 65 61 64 2e 0d 0a these spread...
1810: 0d 0a 49 66 20 79 6f 75 20 77 61 6e 74 20 61 20 ..If you want a
1820: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 60 version of the `
1830: 62 69 6e 60 20 64 69 73 6b 20 69 6d 61 67 65 20 bin` disk image
1840: 77 69 74 68 20 61 6e 79 20 6f 66 20 74 68 65 20 with any of the
1850: 6f 70 74 69 6f 6e 61 6c 20 5b 60 2d 2d 65 6e 61 optional [`--ena
1860: 62 6c 65 2d 6f 73 38 2d 2a 60 5d 28 2f 64 6f 63 ble-os8-*`](/doc
1870: 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 /trunk/README.md
1880: 23 65 6e 61 62 6c 65 2d 6f 73 38 29 20 6f 70 74 #enable-os8) opt
1890: 69 6f 6e 73 20 73 65 74 20 6f 72 20 77 69 74 68 ions set or with
18a0: 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 64 65 66 some of the def
18b0: 61 75 6c 74 2d 65 6e 61 62 6c 65 64 20 66 65 61 ault-enabled fea
18c0: 74 75 72 65 73 20 73 74 72 69 70 70 65 64 20 6f tures stripped o
18d0: 75 74 2c 20 79 6f 75 20 77 69 6c 6c 20 68 61 76 ut, you will hav
18e0: 65 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 20 74 68 e to download th
18f0: 69 73 20 73 6f 66 74 77 61 72 65 2c 20 63 6f 6e is software, con
1900: 66 69 67 75 72 65 20 69 74 20 61 73 20 73 75 69 figure it as sui
1910: 74 73 20 79 6f 75 72 20 6e 65 65 64 73 2c 20 61 ts your needs, a
1920: 6e 64 20 62 75 69 6c 64 20 69 74 20 79 6f 75 72 nd build it your
1930: 73 65 6c 66 2e 20 54 68 65 20 73 6f 66 74 77 61 self. The softwa
1940: 72 65 20 63 75 72 72 65 6e 74 6c 79 20 62 75 69 re currently bui
1950: 6c 64 73 20 6f 6e 20 5b 73 65 76 65 72 61 6c 20 lds on [several
1960: 64 69 66 66 65 72 65 6e 74 20 70 6c 61 74 66 6f different platfo
1970: 72 6d 73 5d 28 2f 77 69 6b 69 3f 6e 61 6d 65 3d rms](/wiki?name=
1980: 4f 53 2b 43 6f 6d 70 61 74 69 62 69 6c 69 74 79 OS+Compatibility
1990: 29 2c 20 6e 6f 74 20 6a 75 73 74 20 74 68 65 20 ), not just the
19a0: 52 61 73 70 62 65 72 72 79 20 50 69 2e 0d 0a 0d Raspberry Pi....
19b0: 0a 0d 0a 23 20 3c 61 20 6e 61 6d 65 3d 22 6c 65 ...# <a name="le
19c0: 61 72 6e 69 6e 67 22 3e 3c 2f 61 3e 4c 65 61 72 arning"></a>Lear
19d0: 6e 69 6e 67 20 4d 6f 72 65 0d 0a 0d 0a 23 23 23 ning More....###
19e0: 20 3c 61 20 6e 61 6d 65 3d 22 75 70 73 74 72 65 <a name="upstre
19f0: 61 6d 22 3e 3c 2f 61 3e 4f 66 66 69 63 69 61 6c am"></a>Official
1a00: 20 50 72 6f 6a 65 63 74 20 52 65 73 6f 75 72 63 Project Resourc
1a10: 65 73 0d 0a 0d 0a 4d 75 63 68 20 6f 66 20 74 68 es....Much of th
1a20: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e e information on
1a30: 20 4f 73 63 61 72 20 56 65 72 6d 65 75 6c 65 6e Oscar Vermeulen
1a40: 27 73 20 5b 50 69 44 50 2d 38 2f 49 20 70 72 6f 's [PiDP-8/I pro
1a50: 6a 65 63 74 20 73 69 74 65 5d 28 68 74 74 70 3a ject site](http:
1a60: 2f 2f 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2e 77 //obsolescence.w
1a70: 69 78 73 69 74 65 2e 63 6f 6d 2f 6f 62 73 6f 6c ixsite.com/obsol
1a80: 65 73 63 65 6e 63 65 2f 70 69 64 70 2d 38 29 20 escence/pidp-8)
1a90: 73 74 69 6c 6c 20 61 70 70 6c 69 65 73 20 74 6f still applies to
1aa0: 20 74 68 69 73 20 64 69 73 74 72 69 62 75 74 69 this distributi
1ab0: 6f 6e 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 on of the softwa
1ac0: 72 65 20 66 6f 72 20 74 68 65 20 50 69 44 50 2d re for the PiDP-
1ad0: 38 2f 49 2e 0d 0a 0d 0a 4f 75 72 20 76 65 72 73 8/I.....Our vers
1ae0: 69 6f 6e 20 68 61 73 20 5b 6d 61 6e 79 20 6d 6f ion has [many mo
1af0: 72 65 20 66 65 61 74 75 72 65 73 20 61 6e 64 20 re features and
1b00: 6d 61 6e 79 20 66 65 77 65 72 20 62 75 67 73 5d many fewer bugs]
1b10: 5b 63 6c 5d 20 74 68 61 6e 20 4f 73 63 61 72 27 [cl] than Oscar'
1b20: 73 20 76 65 72 73 69 6f 6e 2c 20 62 75 74 20 69 s version, but i
1b30: 6e 20 74 68 65 20 65 6e 64 2c 20 62 6f 74 68 20 n the end, both
1b40: 64 6f 20 6d 6f 72 65 20 6f 72 20 6c 65 73 73 20 do more or less
1b50: 74 68 65 20 73 61 6d 65 20 74 68 69 6e 67 2c 20 the same thing,
1b60: 73 6f 20 74 68 61 74 20 4f 73 63 61 72 27 73 20 so that Oscar's
1b70: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 74 documentation st
1b80: 69 6c 6c 20 61 70 70 6c 69 65 73 20 66 61 69 72 ill applies fair
1b90: 6c 79 20 77 65 6c 6c 20 74 6f 20 6f 75 72 20 76 ly well to our v
1ba0: 65 72 73 69 6f 6e 2e 20 54 68 65 20 70 72 69 6d ersion. The prim
1bb0: 61 72 79 20 73 6f 75 72 63 65 20 6f 66 20 64 69 ary source of di
1bc0: 73 63 72 65 70 61 6e 63 69 65 73 20 62 65 74 77 screpancies betw
1bd0: 65 65 6e 20 68 69 73 20 64 6f 63 75 6d 65 6e 74 een his document
1be0: 61 74 69 6f 6e 20 61 6e 64 20 6f 75 72 20 73 6f ation and our so
1bf0: 66 74 77 61 72 65 20 73 74 65 6d 20 66 72 6f 6d ftware stem from
1c00: 20 5b 66 69 6c 65 20 6e 61 6d 65 20 63 68 61 6e [file name chan
1c10: 67 65 73 5d 28 2f 77 69 6b 69 3f 6e 61 6d 65 3d ges](/wiki?name=
1c20: 4d 61 6a 6f 72 2b 44 69 66 66 65 72 65 6e 63 65 Major+Difference
1c30: 73 29 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c s). For example,
1c40: 20 69 6e 20 4f 73 63 61 72 27 73 20 61 72 74 69 in Oscar's arti
1c50: 63 6c 65 20 22 5b 48 6f 77 20 74 6f 20 75 73 65 cle "[How to use
1c60: 20 74 68 65 20 50 69 44 50 2d 38 2f 49 5d 28 68 the PiDP-8/I](h
1c70: 74 74 70 3a 2f 2f 6f 62 73 6f 6c 65 73 63 65 6e ttp://obsolescen
1c80: 63 65 2e 77 69 78 73 69 74 65 2e 63 6f 6d 2f 6f ce.wixsite.com/o
1c90: 62 73 6f 6c 65 73 63 65 6e 63 65 2f 68 6f 77 2d bsolescence/how-
1ca0: 74 6f 2d 75 73 65 2d 74 68 65 2d 70 69 64 70 2d to-use-the-pidp-
1cb0: 38 29 2c 22 20 74 68 65 20 6f 6e 6c 79 20 64 69 8)," the only di
1cc0: 66 66 65 72 65 6e 63 65 20 49 20 73 65 65 20 69 fference I see i
1cd0: 6e 20 61 20 71 75 69 63 6b 20 73 6b 69 6d 20 69 n a quick skim i
1ce0: 73 20 74 68 61 74 20 79 6f 75 20 6e 6f 77 20 68 s that you now h
1cf0: 61 76 65 20 74 6f 20 74 79 70 65 20 60 70 64 70 ave to type `pdp
1d00: 38 69 60 20 61 74 20 74 68 65 20 52 61 73 70 62 8i` at the Raspb
1d10: 69 61 6e 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 ian command line
1d20: 20 74 6f 20 61 74 74 61 63 68 20 79 6f 75 72 20 to attach your
1d30: 74 65 72 6d 69 6e 61 6c 20 74 6f 20 74 68 65 20 terminal to the
1d40: 50 69 44 50 2d 38 2f 49 20 73 69 6d 75 6c 61 74 PiDP-8/I simulat
1d50: 6f 72 20 72 61 74 68 65 72 20 74 68 61 6e 20 60 or rather than `
1d60: 70 64 70 2e 73 68 60 2e 0d 0a 0d 0a 59 6f 75 20 pdp.sh`.....You
1d70: 61 72 65 20 61 6c 73 6f 20 77 65 6c 63 6f 6d 65 are also welcome
1d80: 20 74 6f 20 64 69 73 63 75 73 73 20 74 68 69 73 to discuss this
1d90: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
1da0: 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 PiDP-8/I softwar
1db0: 65 20 6f 6e 20 5b 74 68 65 20 50 69 44 50 2d 38 e on [the PiDP-8
1dc0: 2f 49 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 5d /I mailing list]
1dd0: 28 67 72 6f 75 70 73 2e 67 6f 6f 67 6c 65 2e 63 (groups.google.c
1de0: 6f 6d 2f 66 6f 72 75 6d 2f 23 21 66 6f 72 75 6d om/forum/#!forum
1df0: 2f 70 69 64 70 2d 38 29 2c 20 68 6f 73 74 65 64 /pidp-8), hosted
1e00: 20 62 79 20 47 6f 6f 67 6c 65 20 47 72 6f 75 70 by Google Group
1e10: 73 2e 20 54 68 6f 73 65 20 61 63 74 69 76 65 20 s. Those active
1e20: 69 6e 20 69 74 73 20 64 65 76 65 6c 6f 70 6d 65 in its developme
1e30: 6e 74 20 70 61 72 74 69 63 69 70 61 74 65 20 74 nt participate t
1e40: 68 65 72 65 20 61 6e 64 20 75 73 75 61 6c 6c 79 here and usually
1e50: 20 72 65 61 63 74 20 74 6f 20 70 6f 73 74 73 20 react to posts
1e60: 61 62 6f 75 74 20 74 68 69 73 20 73 6f 66 74 77 about this softw
1e70: 61 72 65 20 71 75 69 63 6b 6c 79 2e 0d 0a 0d 0a are quickly.....
1e80: 0d 0a 23 23 23 20 3c 61 20 6e 61 6d 65 3d 22 70 ..### <a name="p
1e90: 64 6f 63 22 3e 3c 2f 61 3e 50 72 6f 6a 65 63 74 doc"></a>Project
1ea0: 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0d 0a Documentation..
1eb0: 0d 0a 54 68 69 73 20 73 6f 66 74 77 61 72 65 20 ..This software
1ec0: 70 72 6f 6a 65 63 74 20 68 61 73 20 69 74 73 20 project has its
1ed0: 6f 77 6e 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f own documentatio
1ee0: 6e 20 61 6e 64 20 74 75 74 6f 72 69 61 6c 73 2c n and tutorials,
1ef0: 20 77 68 69 63 68 20 49 27 76 65 20 63 6f 6c 6c which I've coll
1f00: 65 63 74 65 64 20 68 65 72 65 20 66 6f 72 20 63 ected here for c
1f10: 6f 6e 76 65 6e 69 65 6e 63 65 3a 0d 0a 0d 0a 2a onvenience:....*
1f20: 20 20 20 5b 54 68 65 20 74 6f 70 2d 6c 65 76 65 [The top-leve
1f30: 6c 20 52 45 41 44 4d 45 20 66 69 6c 65 5d 28 2f l README file](/
1f40: 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 doc/trunk/README
1f50: 2e 6d 64 29 20 74 65 6c 6c 73 20 68 6f 77 20 74 .md) tells how t
1f60: 6f 20 63 6f 6e 66 69 67 75 72 65 2c 20 62 75 69 o configure, bui
1f70: 6c 64 2c 20 61 6e 64 20 73 74 61 72 74 20 75 73 ld, and start us
1f80: 69 6e 67 20 74 68 65 20 50 69 44 50 2d 38 2f 49 ing the PiDP-8/I
1f90: 20 73 6f 66 74 77 61 72 65 2e 20 49 74 20 69 73 software. It is
1fa0: 20 6e 6f 74 20 6d 65 61 6e 74 20 74 6f 20 72 65 not meant to re
1fb0: 70 6c 61 63 65 20 74 68 65 20 6f 74 68 65 72 20 place the other
1fc0: 72 65 73 6f 75 72 63 65 73 20 61 76 61 69 6c 61 resources availa
1fd0: 62 6c 65 2c 20 6f 6e 6c 79 20 74 6f 20 67 69 76 ble, only to giv
1fe0: 65 20 61 20 66 61 73 74 2d 74 72 61 63 6b 20 67 e a fast-track g
1ff0: 75 69 64 65 20 74 6f 20 73 6f 6d 65 6f 6e 65 20 uide to someone
2000: 67 65 74 74 69 6e 67 20 73 74 61 72 74 65 64 2e getting started.
2010: 20 54 68 65 20 70 72 69 6d 61 72 79 20 62 69 74 The primary bit
2020: 20 6f 66 20 75 6e 69 71 75 65 20 69 6e 66 6f 20 of unique info
2030: 69 74 20 70 72 65 73 65 6e 74 73 20 69 73 20 64 it presents is d
2040: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 ocumentation of
2050: 74 68 65 20 60 63 6f 6e 66 69 67 75 72 65 60 20 the `configure`
2060: 73 63 72 69 70 74 20 66 6c 61 67 73 2e 0d 0a 0d script flags....
2070: 0a 2a 20 20 20 4f 6e 65 20 6f 66 20 74 68 6f 73 .* One of thos
2080: 65 20 60 63 6f 6e 66 69 67 75 72 65 60 20 73 63 e `configure` sc
2090: 72 69 70 74 20 66 6c 61 67 73 20 69 73 20 63 6f ript flags is co
20a0: 6d 70 6c 69 63 61 74 65 64 20 65 6e 6f 75 67 68 mplicated enough
20b0: 20 74 6f 20 64 65 73 65 72 76 65 20 69 74 73 20 to deserve its
20c0: 6f 77 6e 20 64 6f 63 75 6d 65 6e 74 2c 20 5b 60 own document, [`
20d0: 2d 2d 74 68 72 6f 74 74 6c 65 60 5d 28 2f 64 6f --throttle`](/do
20e0: 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2d 74 c/trunk/README-t
20f0: 68 72 6f 74 74 6c 65 2e 6d 64 29 2e 0d 0a 0d 0a hrottle.md).....
2100: 2a 20 20 20 54 68 65 20 5b 69 6e 73 74 61 6c 6c * The [install
2110: 61 74 69 6f 6e 20 69 6e 73 74 72 75 63 74 69 6f ation instructio
2120: 6e 73 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 ns](/doc/trunk/d
2130: 6f 63 2f 4f 53 2d 69 6d 61 67 65 73 2e 6d 64 29 oc/OS-images.md)
2140: 20 65 78 70 6c 61 69 6e 20 68 6f 77 20 74 6f 20 explain how to
2150: 69 6e 73 74 61 6c 6c 20 74 68 65 20 5b 62 69 6e install the [bin
2160: 61 72 79 20 4f 53 20 69 6d 61 67 65 73 5d 28 23 ary OS images](#
2170: 62 6f 73 69 29 20 74 6f 20 61 6e 20 53 44 20 63 bosi) to an SD c
2180: 61 72 64 20 61 6e 64 20 67 65 74 20 73 74 61 72 ard and get star
2190: 74 65 64 20 77 69 74 68 20 69 74 2e 0d 0a 0d 0a ted with it.....
21a0: 2a 20 20 20 57 68 69 6c 65 20 62 75 69 6c 64 69 * While buildi
21b0: 6e 67 20 79 6f 75 72 20 50 69 44 50 2d 38 2f 49 ng your PiDP-8/I
21c0: 2c 20 79 6f 75 20 6d 61 79 20 72 75 6e 20 69 6e , you may run in
21d0: 74 6f 20 73 6f 6d 65 20 74 72 6f 75 62 6c 65 20 to some trouble
21e0: 77 68 69 63 68 20 63 61 6e 20 62 65 20 64 69 61 which can be dia
21f0: 67 6e 6f 73 65 64 20 62 79 20 74 68 65 20 60 70 gnosed by the `p
2200: 69 64 70 38 69 2d 74 65 73 74 60 20 70 72 6f 67 idp8i-test` prog
2210: 72 61 6d 20 73 68 69 70 70 65 64 20 77 69 74 68 ram shipped with
2220: 20 74 68 65 20 73 6f 66 74 77 61 72 65 20 64 69 the software di
2230: 73 74 72 69 62 75 74 69 6f 6e 20 61 6e 64 20 5b stribution and [
2240: 64 6f 63 75 6d 65 6e 74 65 64 20 68 65 72 65 5d documented here]
2250: 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f (/doc/trunk/doc/
2260: 70 69 64 70 38 69 2d 74 65 73 74 2e 6d 64 29 2e pidp8i-test.md).
2270: 0d 0a 0d 0a 2a 20 20 20 5b 54 68 65 20 70 72 6f ....* [The pro
2280: 6a 65 63 74 20 77 69 6b 69 5d 28 2f 77 63 6f 6e ject wiki](/wcon
2290: 74 65 6e 74 29 20 63 6f 6e 74 61 69 6e 73 20 73 tent) contains s
22a0: 65 76 65 72 61 6c 20 74 75 74 6f 72 69 61 6c 73 everal tutorials
22b0: 2c 20 64 65 73 69 67 6e 20 64 6f 63 75 6d 65 6e , design documen
22c0: 74 73 2c 20 65 74 63 2e 0d 0a 0d 0a 2a 20 20 20 ts, etc.....*
22d0: 54 68 65 20 70 72 6f 6a 65 63 74 20 73 68 69 70 The project ship
22e0: 73 20 5b 73 65 76 65 72 61 6c 20 65 78 61 6d 70 s [several examp
22f0: 6c 65 20 70 72 6f 67 72 61 6d 73 5d 28 2f 66 69 le programs](/fi
2300: 6c 65 2f 65 78 61 6d 70 6c 65 73 29 20 66 6f 72 le/examples) for
2310: 20 74 68 6f 73 65 20 77 68 6f 20 77 61 6e 74 20 those who want
2320: 74 6f 20 6c 65 61 72 6e 20 74 6f 20 70 72 6f 67 to learn to prog
2330: 72 61 6d 20 74 68 65 20 50 44 50 2d 38 2e 20 54 ram the PDP-8. T
2340: 68 69 73 20 69 73 20 6e 6f 74 20 6d 65 61 6e 74 his is not meant
2350: 20 74 6f 20 62 65 20 61 20 63 6f 6d 70 72 65 68 to be a compreh
2360: 65 6e 73 69 76 65 20 74 75 74 6f 72 69 61 6c 2c ensive tutorial,
2370: 20 62 75 74 20 6d 6f 72 65 20 74 6f 20 68 65 6c but more to hel
2380: 70 20 79 6f 75 20 62 72 69 64 67 65 20 74 68 65 p you bridge the
2390: 20 67 61 70 20 69 6e 20 6d 61 74 65 72 69 61 6c gap in material
23a0: 20 6d 65 61 6e 74 20 66 6f 72 20 61 20 72 65 61 meant for a rea
23b0: 6c 20 50 44 50 2d 38 2c 20 77 68 69 63 68 20 77 l PDP-8, which w
23c0: 6f 6e 27 74 20 74 61 6c 6b 20 61 62 6f 75 74 20 on't talk about
23d0: 74 68 65 20 73 75 70 65 72 69 6f 72 20 6d 65 74 the superior met
23e0: 68 6f 64 73 20 77 65 20 68 61 76 65 20 66 6f 72 hods we have for
23f0: 20 70 72 6f 67 72 61 6d 20 69 6e 70 75 74 20 6e program input n
2400: 6f 77 3a 20 53 49 4d 48 20 62 6f 6f 74 20 73 63 ow: SIMH boot sc
2410: 72 69 70 74 73 2c 20 63 6f 70 79 2d 70 61 73 74 ripts, copy-past
2420: 65 20 76 69 61 20 53 53 48 2c 20 65 74 63 2e 0d e via SSH, etc..
2430: 0a 0d 0a 2a 20 20 20 20 57 65 20 73 68 69 70 20 ...* We ship
2440: 61 20 50 79 74 68 6f 6e 20 63 6c 61 73 73 20 63 a Python class c
2450: 61 6c 6c 65 64 20 60 73 69 6d 68 60 20 66 6f 72 alled `simh` for
2460: 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 53 49 4d controlling SIM
2470: 48 20 61 6e 64 20 4f 53 2f 38 20 72 75 6e 6e 69 H and OS/8 runni
2480: 6e 67 20 75 6e 64 65 72 20 53 49 4d 48 20 66 72 ng under SIMH fr
2490: 6f 6d 20 74 68 65 20 68 6f 73 74 20 73 79 73 74 om the host syst
24a0: 65 6d 2e 20 53 65 65 20 5b 69 74 73 20 74 75 74 em. See [its tut
24b0: 6f 72 69 61 6c 5d 28 2f 64 6f 63 2f 74 72 75 6e orial](/doc/trun
24c0: 6b 2f 64 6f 63 2f 63 6c 61 73 73 2d 73 69 6d 68 k/doc/class-simh
24d0: 2e 6d 64 29 2e 0d 0a 0d 0a 2a 20 20 20 54 68 65 .md).....* The
24e0: 72 65 20 69 73 20 5b 61 20 74 75 74 6f 72 69 61 re is [a tutoria
24f0: 6c 20 66 6f 72 20 74 68 65 20 44 43 50 20 64 69 l for the DCP di
2500: 73 61 73 73 65 6d 62 6c 65 72 5d 28 2f 64 6f 63 sassembler](/doc
2510: 2f 74 72 75 6e 6b 2f 64 6f 63 2f 64 63 70 5f 77 /trunk/doc/dcp_w
2520: 75 2e 6d 64 29 20 69 6e 73 74 61 6c 6c 65 64 20 u.md) installed
2530: 6f 6e 20 74 68 65 20 4f 53 2f 38 20 64 69 73 6b on the OS/8 disk
2540: 20 70 61 63 6b 73 20 62 79 20 64 65 66 61 75 6c packs by defaul
2550: 74 2e 0d 0a 0d 0a 2a 20 20 20 54 68 65 20 64 65 t.....* The de
2560: 66 61 75 6c 74 20 4f 53 2f 38 20 62 6f 6f 74 20 fault OS/8 boot
2570: 64 69 73 6b 20 69 6e 20 74 68 65 20 64 69 73 74 disk in the dist
2580: 72 69 62 75 74 69 6f 6e 20 68 61 73 20 5b 6d 61 ribution has [ma
2590: 6e 79 20 70 61 74 63 68 65 73 20 61 70 70 6c 69 ny patches appli
25a0: 65 64 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 ed](/doc/trunk/d
25b0: 6f 63 2f 6f 73 38 2d 70 61 74 63 68 69 6e 67 2e oc/os8-patching.
25c0: 6d 64 29 2c 20 77 68 69 63 68 20 61 72 65 20 64 md), which are d
25d0: 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 escribed in the
25e0: 6c 69 6e 6b 65 64 20 64 6f 63 75 6d 65 6e 74 2c linked document,
25f0: 20 61 6c 6f 6e 67 20 77 69 74 68 20 69 6e 66 6f along with info
2600: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 rmation about th
2610: 65 20 44 45 43 20 70 61 74 63 68 65 73 20 77 65 e DEC patches we
2620: 20 68 61 76 65 20 63 68 6f 73 65 6e 20 2a 6e 6f have chosen *no
2630: 74 2a 20 74 6f 20 61 70 70 6c 79 2e 0d 0a 0d 0a t* to apply.....
2640: 2a 20 20 20 54 68 65 72 65 20 61 72 65 20 73 65 * There are se
2650: 76 65 72 61 6c 20 64 6f 63 75 6d 65 6e 74 73 20 veral documents
2660: 61 62 6f 75 74 20 74 68 65 20 55 2f 57 20 46 4f about the U/W FO
2670: 43 41 4c 20 56 34 45 20 64 69 73 74 72 69 62 75 CAL V4E distribu
2680: 74 69 6f 6e 20 69 6e 63 6c 75 64 65 64 20 6f 6e tion included on
2690: 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 4f 53 the standard OS
26a0: 2f 38 20 62 6f 6f 74 20 64 69 73 6b 2c 20 77 68 /8 boot disk, wh
26b0: 69 63 68 20 79 6f 75 20 63 61 6e 20 66 69 6e 64 ich you can find
26c0: 20 62 79 20 73 74 61 72 74 69 6e 67 20 77 69 74 by starting wit
26d0: 68 20 6f 75 72 20 5b 55 2f 57 20 46 4f 43 41 4c h our [U/W FOCAL
26e0: 20 6d 61 6e 75 61 6c 20 73 75 70 70 6c 65 6d 65 manual suppleme
26f0: 6e 74 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 nt](/doc/trunk/d
2700: 6f 63 2f 75 77 66 6f 63 61 6c 2d 6d 61 6e 75 61 oc/uwfocal-manua
2710: 6c 2d 73 75 70 70 2e 6d 64 29 2e 0d 0a 0d 0a 2a l-supp.md).....*
2720: 20 20 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 If you want t
2730: 6f 20 6b 6e 6f 77 20 77 68 61 74 20 68 61 73 20 o know what has
2740: 63 68 61 6e 67 65 64 20 69 6e 20 74 68 65 20 73 changed in the s
2750: 6f 66 74 77 61 72 65 20 73 69 6e 63 65 20 4f 73 oftware since Os
2760: 63 61 72 20 56 65 72 6d 65 75 6c 65 6e 27 73 20 car Vermeulen's
2770: 6c 61 73 74 20 72 65 6c 65 61 73 65 20 6f 6e 20 last release on
2780: 32 30 31 35 2e 31 32 2e 31 35 2c 20 73 65 65 20 2015.12.15, see
2790: 5b 74 68 65 20 43 68 61 6e 67 65 4c 6f 67 5d 5b [the ChangeLog][
27a0: 63 6c 5d 2e 0d 0a 0d 0a 2a 20 20 20 20 49 66 20 cl].....* If
27b0: 79 6f 75 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 you would like t
27c0: 6f 20 68 65 6c 70 20 63 6f 6e 74 72 69 62 75 74 o help contribut
27d0: 65 20 74 6f 20 74 68 65 20 64 65 76 65 6c 6f 70 e to the develop
27e0: 6d 65 6e 74 20 6f 66 20 74 68 65 20 50 69 44 50 ment of the PiDP
27f0: 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 20 70 72 -8/I software pr
2800: 6f 6a 65 63 74 2c 20 73 65 65 20 22 5b 48 61 63 oject, see "[Hac
2810: 6b 69 6e 67 20 6f 6e 20 74 68 65 20 50 69 44 50 king on the PiDP
2820: 2d 38 2f 49 20 53 6f 66 74 77 61 72 65 5d 28 2f -8/I Software](/
2830: 64 6f 63 2f 74 72 75 6e 6b 2f 48 41 43 4b 45 52 doc/trunk/HACKER
2840: 53 2e 6d 64 29 22 2e 0d 0a 0d 0a 2a 20 20 20 54 S.md)".....* T
2850: 68 65 20 4b 69 43 61 64 20 5b 50 69 44 50 2d 38 he KiCad [PiDP-8
2860: 2f 49 20 66 72 6f 6e 74 20 70 61 6e 65 6c 20 73 /I front panel s
2870: 63 68 65 6d 61 74 69 63 5d 28 2f 64 6f 63 2f 74 chematic](/doc/t
2880: 72 75 6e 6b 2f 68 61 72 64 77 61 72 65 2f 70 64 runk/hardware/pd
2890: 70 38 69 2f 73 63 68 65 6d 61 74 69 63 2e 70 64 p8i/schematic.pd
28a0: 66 29 20 77 61 73 20 63 6f 6e 76 65 72 74 65 64 f) was converted
28b0: 20 74 6f 20 50 44 46 20 62 79 20 54 6f 6e 79 20 to PDF by Tony
28c0: 48 69 6c 6c 2e 20 28 34 30 30 20 6b 42 29 0d 0a Hill. (400 kB)..
28d0: 0d 0a 2a 20 20 20 41 72 65 20 79 6f 75 20 77 6f ..* Are you wo
28e0: 6e 64 65 72 69 6e 67 20 77 68 6f 20 62 72 6f 75 ndering who brou
28f0: 67 68 74 20 61 6c 6c 20 6f 66 20 74 68 69 73 20 ght all of this
2900: 73 6f 66 74 77 61 72 65 2c 20 68 61 72 64 77 61 software, hardwa
2910: 72 65 2c 20 61 6e 64 20 64 6f 63 75 6d 65 6e 74 re, and document
2920: 61 74 69 6f 6e 20 74 6f 20 79 6f 75 3f 20 54 68 ation to you? Th
2930: 61 74 20 69 73 20 73 75 6d 6d 61 72 69 7a 65 64 at is summarized
2940: 20 69 6e 20 74 68 65 20 70 72 6f 6a 65 63 74 27 in the project'
2950: 73 20 5b 61 75 74 68 6f 72 73 20 66 69 6c 65 5d s [authors file]
2960: 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 41 55 54 48 (/doc/trunk/AUTH
2970: 4f 52 53 2e 6d 64 29 2e 20 54 68 6f 73 65 20 70 ORS.md). Those p
2980: 69 65 63 65 73 20 61 72 65 20 69 6e 63 6c 75 64 ieces are includ
2990: 65 64 20 77 69 74 68 20 74 68 65 20 70 72 6f 6a ed with the proj
29a0: 65 63 74 20 75 6e 64 65 72 20 5b 61 20 76 61 72 ect under [a var
29b0: 69 65 74 79 20 6f 66 20 6c 69 63 65 6e 73 65 73 iety of licenses
29c0: 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 43 4f 50 ](/doc/trunk/COP
29d0: 59 49 4e 47 2e 6d 64 29 2e 0d 0a 0d 0a 5b 63 6c YING.md).....[cl
29e0: 5d 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f 43 68 ]: /doc/trunk/Ch
29f0: 61 6e 67 65 4c 6f 67 2e 6d 64 0d 0a 0d 0a 0d 0a angeLog.md......
2a00: 23 23 23 20 3c 61 20 6e 61 6d 65 3d 22 73 64 6f ### <a name="sdo
2a10: 63 22 3e 3c 2f 61 3e 53 49 4d 48 20 44 6f 63 75 c"></a>SIMH Docu
2a20: 6d 65 6e 74 61 74 69 6f 6e 0d 0a 0d 0a 54 68 65 mentation....The
2a30: 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 PiDP-8/I softwa
2a40: 72 65 20 70 72 6f 6a 65 63 74 20 69 73 20 62 61 re project is ba
2a50: 73 65 64 20 6f 6e 20 5b 74 68 65 20 61 63 74 69 sed on [the acti
2a60: 76 65 6c 79 2d 64 65 76 65 6c 6f 70 65 64 20 6f vely-developed o
2a70: 66 66 69 63 69 61 6c 20 76 65 72 73 69 6f 6e 20 fficial version
2a80: 6f 66 20 53 49 4d 48 5d 28 68 74 74 70 73 3a 2f of SIMH](https:/
2a90: 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 73 69 6d 68 /github.com/simh
2aa0: 2f 73 69 6d 68 29 2e 20 28 41 73 20 6f 70 70 6f /simh). (As oppo
2ab0: 73 65 64 20 74 6f 20 42 6f 62 20 53 75 70 6e 69 sed to Bob Supni
2ac0: 6b 27 73 20 70 65 72 73 6f 6e 61 6c 20 33 2e 3c k's personal 3.<
2ad0: 69 3e 78 3c 2f 69 3e 20 62 72 61 6e 63 68 20 77 i>x</i> branch w
2ae0: 68 69 63 68 20 73 74 69 6c 6c 20 63 6f 6d 65 73 hich still comes
2af0: 20 75 70 20 68 69 67 68 20 69 6e 20 73 65 61 72 up high in sear
2b00: 63 68 20 72 65 73 75 6c 74 73 2e 29 20 54 68 65 ch results.) The
2b10: 20 53 49 4d 48 20 70 72 6f 6a 65 63 74 20 68 61 SIMH project ha
2b20: 73 20 69 74 73 20 6f 77 6e 20 64 6f 63 75 6d 65 s its own docume
2b30: 6e 74 61 74 69 6f 6e 2c 20 62 75 74 20 66 6f 72 ntation, but for
2b40: 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20 49 27 76 convenience I'v
2b50: 65 20 70 72 6f 76 69 64 65 64 20 50 44 46 20 76 e provided PDF v
2b60: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 72 ersions of the r
2b70: 65 6c 65 76 61 6e 74 20 73 75 62 73 65 74 20 68 elevant subset h
2b80: 65 72 65 3a 0d 0a 0d 0a 2a 20 20 20 5b 53 49 4d ere:....* [SIM
2b90: 48 20 4d 61 69 6e 20 4d 61 6e 75 61 6c 5d 28 2f H Main Manual](/
2ba0: 75 76 2f 64 6f 63 2f 73 69 6d 68 2f 6d 61 69 6e uv/doc/simh/main
2bb0: 2e 70 64 66 29 20 e2 80 94 20 49 66 20 79 6f 75 .pdf) — If you
2bc0: 27 72 65 20 67 6f 69 6e 67 20 74 6f 20 72 65 61 're going to rea
2bd0: 64 20 6f 72 20 6d 6f 64 69 66 79 20 60 62 6f 6f d or modify `boo
2be0: 74 2f 2a 2e 73 63 72 69 70 74 60 2c 20 6f 72 20 t/*.script`, or
2bf0: 79 6f 75 20 77 61 6e 74 20 74 6f 20 67 69 76 65 you want to give
2c00: 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 74 68 65 commands at the
2c10: 20 60 73 69 6d 3e 60 20 70 72 6f 6d 70 74 20 79 `sim>` prompt y
2c20: 6f 75 20 67 65 74 20 62 79 20 70 72 65 73 73 69 ou get by pressi
2c30: 6e 67 20 43 74 72 6c 2d 45 20 66 72 6f 6d 20 77 ng Ctrl-E from w
2c40: 69 74 68 69 6e 20 74 68 65 20 50 69 44 50 2d 38 ithin the PiDP-8
2c50: 2f 49 20 73 69 6d 75 6c 61 74 6f 72 2c 20 79 6f /I simulator, yo
2c60: 75 20 6e 65 65 64 20 74 6f 20 72 65 61 64 20 74 u need to read t
2c70: 68 69 73 20 6d 61 6e 75 61 6c 2e 0d 0a 0d 0a 2a his manual.....*
2c80: 20 20 20 5b 50 44 50 2d 38 20 53 69 6d 75 6c 61 [PDP-8 Simula
2c90: 74 6f 72 20 4d 61 6e 75 61 6c 5d 28 2f 75 76 2f tor Manual](/uv/
2ca0: 64 6f 63 2f 73 69 6d 68 2f 70 64 70 38 2e 70 64 doc/simh/pdp8.pd
2cb0: 66 29 20 e2 80 94 20 54 68 69 73 20 61 64 64 65 f) — This adde
2cc0: 6e 64 75 6d 20 74 6f 20 74 68 65 20 6d 61 69 6e ndum to the main
2cd0: 20 53 49 4d 48 20 6d 61 6e 75 61 6c 20 63 6f 76 SIMH manual cov
2ce0: 65 72 73 20 74 68 65 20 64 65 74 61 69 6c 73 20 ers the details
2cf0: 73 70 65 63 69 66 69 63 20 74 6f 20 74 68 65 20 specific to the
2d00: 50 44 50 2d 38 20 73 69 6d 75 6c 61 74 6f 72 2e PDP-8 simulator.
2d10: 20 28 54 68 65 20 6d 61 69 6e 20 6d 61 6e 75 61 (The main manua
2d20: 6c 20 63 6f 76 65 72 73 20 66 75 6e 63 74 69 6f l covers functio
2d30: 6e 61 6c 69 74 79 20 63 6f 6d 6d 6f 6e 20 74 6f nality common to
2d40: 20 61 6c 6c 20 6f 66 20 74 68 65 20 73 69 6d 75 all of the simu
2d50: 6c 61 74 6f 72 73 20 62 75 6e 64 6c 65 64 20 77 lators bundled w
2d60: 69 74 68 20 53 49 4d 48 2e 29 0d 0a 0d 0a 2a 20 ith SIMH.)....*
2d70: 20 20 5b 53 49 4d 48 20 46 41 51 5d 28 2f 75 76 [SIMH FAQ](/uv
2d80: 2f 64 6f 63 2f 73 69 6d 68 2f 66 61 71 2e 70 64 /doc/simh/faq.pd
2d90: 66 29 20 e2 80 94 20 46 72 65 71 75 65 6e 74 6c f) — Frequentl
2da0: 79 2d 61 73 6b 65 64 20 71 75 65 73 74 69 6f 6e y-asked question
2db0: 73 20 61 62 6f 75 74 20 53 49 4d 48 2e 20 28 57 s about SIMH. (W
2dc0: 69 74 68 20 61 6e 73 77 65 72 73 21 29 0d 0a 0d ith answers!)...
2dd0: 0a 0d 0a 23 23 23 20 3c 61 20 6e 61 6d 65 3d 22 ...### <a name="
2de0: 72 64 6f 63 22 3e 3c 2f 61 3e 52 61 72 65 20 50 rdoc"></a>Rare P
2df0: 44 50 2d 38 20 44 6f 63 75 6d 65 6e 74 61 74 69 DP-8 Documentati
2e00: 6f 6e 0d 0a 0d 0a 57 68 69 6c 65 20 6d 6f 73 74 on....While most
2e10: 20 6f 66 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 of the informat
2e20: 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 50 44 ion about the PD
2e30: 50 2d 38 20 69 73 20 77 69 64 65 6c 79 20 61 76 P-8 is widely av
2e40: 61 69 6c 61 62 6c 65 20 6f 6e 20 74 68 65 20 49 ailable on the I
2e50: 6e 74 65 72 6e 65 74 20 61 6e 64 20 6d 61 79 20 nternet and may
2e60: 74 68 75 73 20 62 65 20 65 61 73 69 6c 79 20 66 thus be easily f
2e70: 6f 75 6e 64 20 5b 62 79 20 47 6f 6f 67 6c 69 6e ound [by Googlin
2e80: 67 5d 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 g](https://www.g
2e90: 6f 6f 67 6c 65 2e 63 6f 6d 2f 73 65 61 72 63 68 oogle.com/search
2ea0: 3f 71 3d 70 64 70 2d 38 29 2c 20 77 65 20 68 61 ?q=pdp-8), we ha
2eb0: 76 65 20 61 20 73 6d 61 6c 6c 20 6e 75 6d 62 65 ve a small numbe
2ec0: 72 20 6f 66 20 64 6f 63 75 6d 65 6e 74 73 20 68 r of documents h
2ed0: 65 72 65 20 74 68 61 74 20 61 72 65 20 6e 6f 74 ere that are not
2ee0: 20 73 6f 20 65 61 73 79 20 74 6f 20 63 6f 6d 65 so easy to come
2ef0: 20 62 79 2c 20 70 6c 75 73 20 73 6f 6d 65 20 6c by, plus some l
2f00: 69 6e 6b 73 20 74 68 61 74 20 64 6f 6e 27 74 20 inks that don't
2f10: 73 65 65 6d 20 74 6f 20 63 6f 6d 65 20 75 70 20 seem to come up
2f20: 61 73 20 68 69 67 68 20 69 6e 20 47 6f 6f 67 6c as high in Googl
2f30: 65 20 73 65 61 72 63 68 65 73 20 61 73 20 74 68 e searches as th
2f40: 65 79 20 6f 75 67 68 74 20 74 6f 3a 0d 0a 0d 0a ey ought to:....
2f50: 2a 20 20 20 44 45 43 27 73 20 31 39 36 39 20 65 * DEC's 1969 e
2f60: 64 69 74 69 6f 6e 20 5b 53 79 73 74 65 6d 20 55 dition [System U
2f70: 73 65 72 27 73 20 47 75 69 64 65 5d 28 2f 75 76 ser's Guide](/uv
2f80: 2f 64 6f 63 2f 70 64 70 38 69 2d 73 75 67 2e 70 /doc/pdp8i-sug.p
2f90: 64 66 29 20 66 6f 72 20 74 68 65 20 50 44 50 2d df) for the PDP-
2fa0: 38 20 66 61 6d 69 6c 79 20 63 6f 6d 70 75 74 65 8 family compute
2fb0: 72 73 2c 20 74 68 65 20 70 69 6e 6e 61 63 6c 65 rs, the pinnacle
2fc0: 20 6f 66 20 77 68 69 63 68 20 77 61 73 20 74 68 of which was th
2fd0: 65 20 50 44 50 2d 38 2f 49 20 61 74 20 74 68 61 e PDP-8/I at tha
2fe0: 74 20 74 69 6d 65 2e 20 44 45 43 20 70 75 62 6c t time. DEC publ
2ff0: 69 73 68 65 64 20 6d 61 6e 79 20 65 64 69 74 69 ished many editi
3000: 6f 6e 73 20 6f 66 20 74 68 69 73 20 67 75 69 64 ons of this guid
3010: 65 2c 20 61 6e 64 20 74 68 65 20 6e 65 77 65 72 e, and the newer
3020: 20 76 65 72 73 69 6f 6e 73 20 63 6f 6d 65 20 75 versions come u
3030: 70 20 66 61 72 20 6d 6f 72 65 20 66 72 65 71 75 p far more frequ
3040: 65 6e 74 6c 79 20 69 6e 20 77 65 62 20 73 65 61 ently in web sea
3050: 72 63 68 65 73 2c 20 62 75 74 20 74 68 65 79 27 rches, but they'
3060: 72 65 20 6f 66 74 65 6e 20 6e 6f 74 20 4f 43 52 re often not OCR
3070: 27 64 20 28 77 68 65 72 65 61 73 20 74 68 69 73 'd (whereas this
3080: 20 76 65 72 73 69 6f 6e 20 69 73 29 20 61 6e 64 version is) and
3090: 20 74 68 65 79 20 74 65 6e 64 20 74 6f 20 66 6f they tend to fo
30a0: 63 75 73 20 6f 6e 20 74 68 65 20 6e 65 77 65 72 cus on the newer
30b0: 20 50 44 50 2d 38 20 6d 6f 64 65 6c 73 20 77 68 PDP-8 models wh
30c0: 69 63 68 20 64 6f 6e 27 74 20 61 70 70 6c 79 20 ich don't apply
30d0: 65 6e 74 69 72 65 6c 79 20 74 6f 20 74 68 65 20 entirely to the
30e0: 50 44 50 2d 38 2f 49 2e 0d 0a 0d 0a 2a 20 20 20 PDP-8/I.....*
30f0: 44 45 43 27 73 20 31 39 37 33 20 5b 53 6d 61 6c DEC's 1973 [Smal
3100: 6c 20 43 6f 6d 70 75 74 65 72 20 48 61 6e 64 62 l Computer Handb
3110: 6f 6f 6b 5d 28 68 74 74 70 73 3a 2f 2f 61 72 63 ook](https://arc
3120: 68 69 76 65 2e 6f 72 67 2f 64 65 74 61 69 6c 73 hive.org/details
3130: 2f 62 69 74 73 61 76 65 72 73 5f 64 65 63 70 64 /bitsavers_decpd
3140: 70 38 68 61 6e 48 61 6e 64 62 6f 6f 6b 31 39 37 p8hanHandbook197
3150: 33 5f 37 39 36 37 31 37 31 31 29 2c 20 62 65 63 3_79671711), bec
3160: 61 75 73 65 20 77 68 65 6e 20 64 65 61 6c 69 6e ause when dealin
3170: 67 20 77 69 74 68 20 53 49 4d 48 2c 20 79 6f 75 g with SIMH, you
3180: 20 61 63 74 75 61 6c 6c 79 20 2a 77 61 6e 74 2a actually *want*
3190: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f documentation o
31a0: 66 20 74 68 65 20 6e 65 77 65 72 20 6d 6f 64 65 f the newer mode
31b0: 6c 73 20 6f 66 20 50 44 50 2d 38 2c 20 73 69 6e ls of PDP-8, sin
31c0: 63 65 20 53 49 4d 48 20 73 69 6d 75 6c 61 74 65 ce SIMH simulate
31d0: 73 20 61 20 66 61 69 72 6c 79 20 74 72 69 63 6b s a fairly trick
31e0: 65 64 2d 6f 75 74 20 6c 61 74 65 2d 6d 6f 64 65 ed-out late-mode
31f0: 6c 20 50 44 50 2d 38 3b 20 74 68 65 72 65 20 69 l PDP-8; there i
3200: 73 20 6e 6f 20 65 61 73 79 20 77 61 79 20 74 6f s no easy way to
3210: 20 72 65 73 74 72 69 63 74 20 53 49 4d 48 20 74 restrict SIMH t
3220: 6f 20 73 75 70 70 6f 72 74 20 6f 6e 6c 79 20 74 o support only t
3230: 68 65 20 66 65 61 74 75 72 65 73 20 74 68 61 74 he features that
3240: 20 65 78 69 73 74 65 64 20 61 74 20 74 68 65 20 existed at the
3250: 74 69 6d 65 20 6f 66 20 74 68 65 20 50 44 50 2d time of the PDP-
3260: 38 2f 49 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 8/I. For example
3270: 2c 20 53 49 4d 48 27 73 20 50 44 50 2d 38 20 73 , SIMH's PDP-8 s
3280: 69 6d 75 6c 61 74 6f 72 20 77 69 6c 6c 20 70 72 imulator will pr
3290: 6f 63 65 73 73 20 5b 6d 6f 64 65 20 42 20 45 41 ocess [mode B EA
32a0: 45 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 5d 28 E instructions](
32b0: 68 74 74 70 3a 2f 2f 68 6f 6d 65 70 61 67 65 2e http://homepage.
32c0: 64 69 76 6d 73 2e 75 69 6f 77 61 2e 65 64 75 2f divms.uiowa.edu/
32d0: 7e 6a 6f 6e 65 73 2f 70 64 70 38 2f 72 65 66 63 ~jones/pdp8/refc
32e0: 61 72 64 2f 37 34 2e 68 74 6d 6c 29 20 69 6e 74 ard/74.html) int
32f0: 72 6f 64 75 63 65 64 20 69 6e 20 74 68 65 20 50 roduced in the P
3300: 44 50 2d 38 2f 65 2c 20 77 65 6c 6c 20 61 66 74 DP-8/e, well aft
3310: 65 72 20 74 68 65 20 50 44 50 2d 38 2f 49 20 63 er the PDP-8/I c
3320: 61 6d 65 20 6f 75 74 20 77 69 74 68 20 69 74 73 ame out with its
3330: 20 6c 65 73 73 20 66 75 6e 63 74 69 6f 6e 61 6c less functional
3340: 20 45 41 45 20 6f 70 74 69 6f 6e 2e 0d 0a 0d 0a EAE option.....
3350: 20 20 20 20 59 6f 75 20 6d 61 79 20 77 61 6e 74 You may want
3360: 20 74 6f 20 73 70 6c 69 74 20 74 68 65 20 64 69 to split the di
3370: 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e fference between
3380: 20 74 68 65 73 65 20 74 77 6f 20 64 6f 63 75 6d these two docum
3390: 65 6e 74 73 20 61 6e 64 20 74 72 79 20 74 6f 20 ents and try to
33a0: 66 69 6e 64 20 61 20 31 39 36 38 20 65 64 69 74 find a 1968 edit
33b0: 69 6f 6e 20 6f 66 20 74 68 65 20 53 6d 61 6c 6c ion of the Small
33c0: 20 43 6f 6d 70 75 74 65 72 20 48 61 6e 64 62 6f Computer Handbo
33d0: 6f 6b 2e 20 54 68 65 20 63 6c 6f 73 65 73 74 20 ok. The closest
33e0: 49 27 6d 20 61 77 61 72 65 20 6f 66 20 6f 6e 6c I'm aware of onl
33f0: 69 6e 65 20 69 73 20 74 68 65 20 5b 31 39 36 37 ine is the [1967
3400: 20 65 64 69 74 69 6f 6e 5d 28 68 74 74 70 3a 2f edition](http:/
3410: 2f 62 69 74 73 61 76 65 72 73 2e 6f 72 67 2f 70 /bitsavers.org/p
3420: 64 66 2f 64 65 63 2f 70 64 70 38 2f 68 61 6e 64 df/dec/pdp8/hand
3430: 62 6f 6f 6b 73 2f 53 6d 61 6c 6c 43 6f 6d 70 75 books/SmallCompu
3440: 74 65 72 48 61 6e 64 62 6f 6f 6b 5f 36 37 2d 36 terHandbook_67-6
3450: 38 2e 70 64 66 29 20 77 68 69 63 68 20 6d 65 6e 8.pdf) which men
3460: 74 69 6f 6e 73 20 74 68 65 20 50 44 50 2d 38 2f tions the PDP-8/
3470: 49 20 69 6e 73 69 64 65 2c 20 62 75 74 20 73 68 I inside, but sh
3480: 6f 77 73 20 74 68 65 20 6f 72 69 67 69 6e 61 6c ows the original
3490: 20 50 44 50 2d 38 20 22 53 74 72 61 69 67 68 74 PDP-8 "Straight
34a0: 20 45 69 67 68 74 22 20 61 6e 64 20 61 20 50 44 Eight" and a PD
34b0: 50 2d 38 2f 53 20 6f 6e 20 74 68 65 20 63 6f 76 P-8/S on the cov
34c0: 65 72 2e 20 49 20 61 73 73 75 6d 65 20 69 74 20 er. I assume it
34d0: 77 61 73 20 77 72 69 74 74 65 6e 20 77 68 69 6c was written whil
34e0: 65 20 74 68 65 20 50 44 50 2d 38 2f 49 20 64 65 e the PDP-8/I de
34f0: 73 69 67 6e 20 77 61 73 20 62 65 69 6e 67 20 66 sign was being f
3500: 69 6e 61 6c 69 7a 65 64 2c 20 73 6f 20 69 74 20 inalized, so it
3510: 6d 61 79 20 62 65 20 66 61 69 72 6c 79 20 61 63 may be fairly ac
3520: 63 75 72 61 74 65 2c 20 61 6e 64 20 69 74 20 6d curate, and it m
3530: 61 79 20 62 65 20 66 75 6c 6c 20 6f 66 20 62 75 ay be full of bu
3540: 67 73 3b 20 49 20 63 6f 75 6c 64 6e 27 74 20 73 gs; I couldn't s
3550: 61 79 2e 20 49 20 68 61 70 70 65 6e 20 74 6f 20 ay. I happen to
3560: 68 61 76 65 20 68 65 72 65 20 61 20 70 61 70 65 have here a pape
3570: 72 20 63 6f 70 79 20 6f 66 20 74 68 65 20 31 39 r copy of the 19
3580: 36 38 20 65 64 69 74 69 6f 6e 2c 20 77 68 69 63 68 edition, whic
3590: 68 20 79 6f 75 20 63 61 6e 20 74 65 6c 6c 20 66 h you can tell f
35a0: 72 6f 6d 20 74 68 65 20 31 39 36 37 20 65 64 69 rom the 1967 edi
35b0: 74 69 6f 6e 20 62 79 20 74 68 65 20 5b 79 65 6c tion by the [yel
35c0: 6c 6f 77 2d 67 72 65 65 6e 20 74 68 65 6d 65 64 low-green themed
35d0: 20 63 6f 76 65 72 5d 28 2f 64 6f 63 2f 74 72 75 cover](/doc/tru
35e0: 6e 6b 2f 64 6f 63 2f 64 65 63 2d 73 63 68 2d 70 nk/doc/dec-sch-p
35f0: 64 70 38 69 2d 31 39 36 38 2e 6a 70 67 29 20 28 dp8i-1968.jpg) (
3600: 4a 50 45 47 2c 20 34 37 33 26 6e 62 73 70 3b 6b JPEG, 473 k
3610: 42 29 20 73 68 6f 77 69 6e 67 20 74 68 65 20 73 B) showing the s
3620: 74 61 6e 64 61 72 64 20 72 61 63 6b 2d 6d 6f 75 tandard rack-mou
3630: 6e 74 65 64 20 61 6e 64 20 72 61 72 65 20 63 6f nted and rare co
3640: 6e 73 6f 6c 65 20 76 65 72 73 69 6f 6e 20 6f 66 nsole version of
3650: 20 74 68 65 20 50 44 50 2d 38 2f 49 2e 0a 5a 20 the PDP-8/I..Z
3660: 62 64 61 34 33 33 32 37 38 37 32 63 65 65 34 31 bda43327872cee41
3670: 34 34 39 65 36 66 62 32 66 64 35 31 37 66 65 62 449e6fb2fd517feb
3680: 0a .