Artifact
564ddf71d3da515216c285efaa53ccff96613857:
Wiki page
[Running FOCAL,1969] by
tangent
2019-08-16 00:27:47.
0000: 44 20 32 30 31 39 2d 30 38 2d 31 36 54 30 30 3a D 2019-08-16T00:
0010: 32 37 3a 34 37 2e 31 39 36 0a 4c 20 52 75 6e 6e 27:47.196.L Runn
0020: 69 6e 67 5c 73 46 4f 43 41 4c 2c 31 39 36 39 0a ing\sFOCAL,1969.
0030: 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 N text/x-markdow
0040: 6e 0a 55 20 74 61 6e 67 65 6e 74 0a 57 20 35 30 n.U tangent.W 50
0050: 37 34 0a 54 68 65 20 50 69 44 50 2d 38 2f 49 20 74.The PiDP-8/I
0060: 70 72 6f 6a 65 63 74 20 64 65 66 61 75 6c 74 73 project defaults
0070: 20 74 6f 20 5b 55 2f 57 20 46 4f 43 41 4c 5d 5b to [U/W FOCAL][
0080: 75 77 66 5d 2c 20 62 75 74 20 69 74 20 68 61 73 uwf], but it has
0090: 20 5b 61 6e 20 6f 70 74 69 6f 6e 5d 5b 6f 70 74 [an option][opt
00a0: 5d 20 74 68 61 74 20 6c 65 74 73 20 79 6f 75 20 ] that lets you
00b0: 65 69 74 68 65 72 20 61 64 64 20 46 4f 43 41 4c either add FOCAL
00c0: 2c 31 39 36 39 20 74 6f 20 74 68 69 73 20 6f 72 ,1969 to this or
00d0: 20 73 77 69 74 63 68 20 74 6f 20 69 74 20 62 79 switch to it by
00e0: 20 64 69 73 61 62 6c 69 6e 67 20 55 2f 57 20 46 disabling U/W F
00f0: 4f 43 41 4c 20 65 6e 74 69 72 65 6c 79 3a 0d 0a OCAL entirely:..
0100: 0d 0a 20 20 20 20 24 20 2e 2f 63 6f 6e 66 69 67 .. $ ./config
0110: 75 72 65 20 2d 2d 65 6e 61 62 6c 65 2d 6f 73 38 ure --enable-os8
0120: 2d 66 6f 63 61 6c 36 39 20 2d 2d 64 69 73 61 62 -focal69 --disab
0130: 6c 65 2d 6f 73 38 2d 75 77 66 6f 63 61 6c 0d 0a le-os8-uwfocal..
0140: 0d 0a 4f 6e 63 65 20 74 68 61 74 20 73 6f 66 74 ..Once that soft
0150: 77 61 72 65 20 69 73 20 62 75 69 6c 74 20 61 6e ware is built an
0160: 64 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 d installed, you
0170: 20 6d 69 67 68 74 20 74 68 65 6e 20 77 6f 6e 64 might then wond
0180: 65 72 2c 20 22 48 6f 77 20 64 6f 20 49 20 67 65 er, "How do I ge
0190: 74 20 73 74 61 72 74 65 64 3f 22 20 54 68 69 73 t started?" This
01a0: 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 6f 75 72 document is our
01b0: 20 61 6e 73 77 65 72 20 74 6f 20 74 68 61 74 20 answer to that
01c0: 71 75 65 73 74 69 6f 6e 2e 0d 0a 0d 0a 0d 0a 23 question.......#
01d0: 20 52 75 6e 6e 69 6e 67 20 50 72 6f 67 72 61 6d Running Program
01e0: 73 20 77 69 74 68 20 4f 53 2f 38 0d 0a 0d 0a 4f s with OS/8....O
01f0: 53 2f 38 20 69 73 20 6e 6f 74 20 6c 69 6b 65 20 S/8 is not like
0200: 55 6e 69 78 20 6f 72 20 44 4f 53 20 6f 72 20 61 Unix or DOS or a
0210: 6e 79 20 6f 74 68 65 72 20 4f 53 20 74 68 61 74 ny other OS that
0220: 20 68 61 73 20 61 20 63 6f 6d 6d 61 6e 64 20 60 has a command `
0230: 50 41 54 48 60 2e 20 54 68 65 20 66 69 72 73 74 PATH`. The first
0240: 20 77 6f 72 64 20 69 6e 20 61 6e 20 4f 53 2f 38 word in an OS/8
0250: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 68 61 6e 64 command is hand
0260: 6c 65 64 20 62 79 20 74 68 65 20 4f 53 2f 38 20 led by the OS/8
0270: 6b 65 79 62 6f 61 72 64 20 6d 6f 6e 69 74 6f 72 keyboard monitor
0280: 20 28 69 2e 65 2e 20 74 68 61 74 20 77 68 69 63 (i.e. that whic
0290: 68 20 68 61 6e 64 6c 65 73 20 72 65 73 70 6f 6e h handles respon
02a0: 73 65 73 20 74 6f 20 74 68 65 20 22 60 2e 60 22 ses to the "`.`"
02b0: 20 70 72 6f 6d 70 74 29 20 73 6f 20 69 74 20 68 prompt) so it h
02c0: 61 73 20 74 6f 20 62 65 20 61 6e 20 4f 53 2f 38 as to be an OS/8
02d0: 20 6b 65 79 62 6f 61 72 64 20 6d 6f 6e 69 74 6f keyboard monito
02e0: 72 20 63 6f 6d 6d 61 6e 64 2e 20 49 6e 20 6f 74 r command. In ot
02f0: 68 65 72 20 77 6f 72 64 73 2c 20 4f 53 2f 38 27 her words, OS/8'
0300: 73 20 6b 65 79 62 6f 61 72 64 20 6d 6f 6e 69 74 s keyboard monit
0310: 6f 72 20 64 6f 65 73 20 6e 6f 74 20 73 65 61 72 or does not sear
0320: 63 68 20 66 6f 72 20 60 2a 2e 42 4e 60 2c 20 60 ch for `*.BN`, `
0330: 2a 2e 53 56 60 20 61 6e 64 20 73 69 6d 69 6c 61 *.SV` and simila
0340: 72 20 66 69 6c 65 73 20 6f 6e 20 64 69 73 6b 20 r files on disk
0350: 61 6e 64 20 74 72 65 61 74 20 74 68 65 6d 20 61 and treat them a
0360: 73 20 74 6f 70 2d 6c 65 76 65 6c 20 63 6f 6d 6d s top-level comm
0370: 61 6e 64 20 6e 61 6d 65 73 2e 20 53 65 65 20 70 and names. See p
0380: 61 67 65 20 31 2d 33 35 20 69 6e 20 74 68 65 20 age 1-35 in the
0390: 5b 31 39 37 34 20 65 64 69 74 69 6f 6e 20 6f 66 [1974 edition of
03a0: 20 74 68 65 20 4f 53 2f 38 20 48 61 6e 64 62 6f the OS/8 Handbo
03b0: 6f 6b 5d 5b 68 62 5d 2e 0d 0a 0d 0a 54 68 65 20 ok][hb].....The
03c0: 6f 70 74 69 6f 6e 61 6c 20 43 43 4c 20 66 65 61 optional CCL fea
03d0: 74 75 72 65 20 6f 66 20 4f 53 2f 38 20 65 78 74 ture of OS/8 ext
03e0: 65 6e 64 73 20 74 68 65 20 4b 65 79 62 6f 61 72 ends the Keyboar
03f0: 64 20 4d 6f 6e 69 74 6f 72 20 77 69 74 68 20 6d d Monitor with m
0400: 6f 72 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 73 6f ore commands, so
0410: 6d 65 20 6f 66 20 77 68 69 63 68 20 61 64 64 20 me of which add
0420: 61 6c 69 61 73 65 73 20 66 6f 72 20 72 75 6e 6e aliases for runn
0430: 69 6e 67 20 62 69 6e 61 72 69 65 73 20 74 68 61 ing binaries tha
0440: 74 20 6d 61 6b 65 73 20 69 74 20 77 6f 72 6b 20 t makes it work
0450: 6d 6f 72 65 20 6c 69 6b 65 20 55 6e 69 78 20 6f more like Unix o
0460: 72 20 44 4f 53 20 28 65 2e 67 2e 20 22 54 45 43 r DOS (e.g. "TEC
0470: 4f 22 29 2c 20 62 75 74 20 64 6f 6e 27 74 20 67 O"), but don't g
0480: 65 74 20 63 6f 6e 66 75 73 65 64 20 61 62 6f 75 et confused abou
0490: 74 20 77 68 61 74 27 73 20 67 6f 69 6e 67 20 6f t what's going o
04a0: 6e 20 68 65 72 65 2e 20 28 53 65 65 20 70 61 67 n here. (See pag
04b0: 65 20 31 2d 35 32 20 69 6e 20 74 68 65 20 4f 53 e 1-52 in the OS
04c0: 2f 38 20 68 61 6e 64 62 6f 6f 6b 20 66 6f 72 20 /8 handbook for
04d0: 6d 6f 72 65 20 6f 6e 20 43 43 4c 2e 29 0d 0a 0d more on CCL.)...
04e0: 0a 49 66 20 79 6f 75 20 77 61 6e 74 20 61 20 55 .If you want a U
04f0: 6e 69 78 20 61 6e 61 6c 6f 67 79 2c 20 69 74 27 nix analogy, it'
0500: 73 20 61 73 20 69 66 20 4f 53 2f 38 20 68 61 73 s as if OS/8 has
0510: 20 6e 6f 74 68 69 6e 67 20 62 75 74 20 5b 73 68 nothing but [sh
0520: 65 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6d ell built-in com
0530: 6d 61 6e 64 73 5d 5b 73 62 69 5d 2c 20 6e 6f 20 mands][sbi], no
0540: 65 78 74 65 72 6e 61 6c 20 63 6f 6d 6d 61 6e 64 external command
0550: 73 2e 20 54 6f 20 72 75 6e 20 61 20 62 69 6e 61 s. To run a bina
0560: 72 79 20 6f 6e 20 64 69 73 6b 2c 20 79 6f 75 20 ry on disk, you
0570: 68 61 76 65 20 74 6f 20 67 65 74 20 61 74 20 69 have to get at i
0580: 74 20 74 68 72 6f 75 67 68 20 6f 6e 65 20 6f 66 t through one of
0590: 20 74 68 65 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 the shell comma
05a0: 6e 64 73 20 e2 80 94 20 74 68 61 74 20 69 73 2c nds — that is,
05b0: 20 4b 65 79 62 6f 61 72 64 20 4d 6f 6e 69 74 6f Keyboard Monito
05c0: 72 20 6f 72 20 43 43 4c 20 63 6f 6d 6d 61 6e 64 r or CCL command
05d0: 73 20 e2 80 94 20 6f 72 20 6f 6e 65 20 6f 66 20 s — or one of
05e0: 74 68 65 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 the commands you
05f0: 20 63 61 6e 20 67 65 74 20 74 6f 20 2a 76 69 61 can get to *via
0600: 2a 20 73 75 63 68 20 63 6f 6d 6d 61 6e 64 73 2e * such commands.
0610: 0d 0a 0d 0a 0d 0a 23 20 53 74 61 72 74 69 6e 67 ......# Starting
0620: 20 46 4f 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 49 FOCAL,1969....I
0630: 27 76 65 20 74 61 6b 65 6e 20 74 68 65 20 74 69 've taken the ti
0640: 6d 65 20 74 6f 20 67 6f 20 69 6e 74 6f 20 61 6c me to go into al
0650: 6c 20 6f 66 20 74 68 61 74 20 64 65 74 61 69 6c l of that detail
0660: 20 62 65 63 61 75 73 65 20 69 74 20 65 78 70 6c because it expl
0670: 61 69 6e 73 20 77 68 79 20 6e 6f 6e 65 20 6f 66 ains why none of
0680: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 the following c
0690: 6f 6d 6d 61 6e 64 73 20 73 74 61 72 74 20 74 68 ommands start th
06a0: 65 20 60 46 4f 43 41 4c 2e 42 4e 60 20 62 69 6e e `FOCAL.BN` bin
06b0: 61 72 79 20 77 65 20 73 68 69 70 20 77 68 65 6e ary we ship when
06c0: 20 79 6f 75 20 62 75 69 6c 64 20 74 68 65 20 4f you build the O
06d0: 53 2f 38 20 64 69 73 6b 20 70 61 63 6b 73 20 77 S/8 disk packs w
06e0: 69 74 68 20 46 4f 43 41 4c 2c 31 39 36 39 20 65 ith FOCAL,1969 e
06f0: 6e 61 62 6c 65 64 3a 0d 0a 0d 0a 20 20 20 20 2e nabled:.... .
0700: 46 4f 43 41 4c 0d 0a 20 20 20 20 2e 52 20 46 4f FOCAL.. .R FO
0710: 43 41 4c 0d 0a 20 20 20 20 2e 52 55 4e 20 46 4f CAL.. .RUN FO
0720: 43 41 4c 0d 0a 0d 0a 57 68 61 74 20 79 6f 75 20 CAL....What you
0730: 61 63 74 75 61 6c 6c 79 20 77 61 6e 74 20 69 73 actually want is
0740: 20 74 6f 20 73 74 61 72 74 20 74 68 65 20 4f 53 to start the OS
0750: 2f 38 20 61 62 73 6f 6c 75 74 65 20 62 69 6e 61 /8 absolute bina
0760: 72 79 20 6c 6f 61 64 65 72 2c 20 77 68 69 63 68 ry loader, which
0770: 20 69 73 20 77 68 61 74 20 68 61 6e 64 6c 65 73 is what handles
0780: 20 60 2a 2e 42 4e 60 20 66 69 6c 65 73 20 73 75 `*.BN` files su
0790: 63 68 20 61 73 20 60 46 4f 43 41 4c 2e 42 4e 60 ch as `FOCAL.BN`
07a0: 3a 0d 0a 0d 0a 20 20 20 20 2e 52 20 41 42 53 4c :.... .R ABSL
07b0: 44 52 0d 0a 20 20 20 20 2a 46 4f 43 41 4c 2f 47 DR.. *FOCAL/G
07c0: 0d 0a 0d 0a 54 68 65 20 60 2f 47 60 20 6f 70 74 ....The `/G` opt
07d0: 69 6f 6e 20 6d 65 61 6e 73 20 22 67 6f 2c 22 20 ion means "go,"
07e0: 73 74 61 72 74 69 6e 67 20 74 68 65 20 70 72 6f starting the pro
07f0: 67 72 61 6d 20 69 6d 6d 65 64 69 61 74 65 6c 79 gram immediately
0800: 20 61 66 74 65 72 20 6c 6f 61 64 69 6e 67 20 69 after loading i
0810: 74 20 69 6e 74 6f 20 63 6f 72 65 20 6d 65 6d 6f t into core memo
0820: 72 79 2e 0d 0a 0d 0a 59 6f 75 27 6c 6c 20 67 65 ry.....You'll ge
0830: 74 20 61 6e 6f 74 68 65 72 20 22 60 2a 60 22 20 t another "`*`"
0840: 70 72 6f 6d 70 74 20 61 66 74 65 72 20 74 68 61 prompt after tha
0850: 74 2c 20 62 75 74 20 69 74 27 73 20 66 72 6f 6d t, but it's from
0860: 20 46 4f 43 41 4c 2c 20 6e 6f 74 20 60 41 42 53 FOCAL, not `ABS
0870: 4c 44 52 60 2e 20 53 65 65 20 70 61 67 65 20 31 LDR`. See page 1
0880: 2d 31 30 38 20 69 6e 20 74 68 65 20 4f 53 2f 38 -108 in the OS/8
0890: 20 68 61 6e 64 62 6f 6f 6b 20 6c 69 6e 6b 65 64 handbook linked
08a0: 20 61 62 6f 76 65 20 66 6f 72 20 6d 6f 72 65 20 above for more
08b0: 64 65 74 61 69 6c 20 61 62 6f 75 74 20 60 41 42 detail about `AB
08c0: 53 4c 44 52 60 20 63 6f 6d 6d 61 6e 64 73 2e 0d SLDR` commands..
08d0: 0a 0d 0a 0d 0a 23 20 52 65 74 75 72 6e 69 6e 67 .....# Returning
08e0: 20 74 6f 20 4f 53 2f 38 20 66 72 6f 6d 20 46 4f to OS/8 from FO
08f0: 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 53 61 79 20 CAL,1969....Say
0900: 22 4c 22 20 28 60 4c 4f 47 49 43 41 4c 20 45 58 "L" (`LOGICAL EX
0910: 49 54 60 29 20 61 74 20 74 68 65 20 46 4f 43 41 IT`) at the FOCA
0920: 4c 20 60 2a 60 20 70 72 6f 6d 70 74 20 74 6f 20 L `*` prompt to
0930: 67 65 74 20 62 61 63 6b 20 74 6f 20 4f 53 2f 38 get back to OS/8
0940: 2e 20 55 6e 6c 69 6b 65 20 55 2f 57 20 46 4f 43 . Unlike U/W FOC
0950: 41 4c 2c 20 46 4f 43 41 4c 2c 31 39 36 39 20 64 AL, FOCAL,1969 d
0960: 6f 65 73 20 6e 6f 74 20 64 6f 20 74 68 69 73 20 oes not do this
0970: 6f 6e 20 43 74 72 6c 2d 43 2e 0d 0a 0d 0a 0d 0a on Ctrl-C.......
0980: 23 20 55 73 69 6e 67 20 46 4f 43 41 4c 2c 31 39 # Using FOCAL,19
0990: 36 39 0d 0a 0d 0a 54 68 65 72 65 20 61 72 65 20 69....There are
09a0: 73 65 76 65 72 61 6c 20 66 72 65 65 6c 79 2d 61 several freely-a
09b0: 76 61 69 6c 61 62 6c 65 20 50 44 46 20 64 6f 63 vailable PDF doc
09c0: 75 6d 65 6e 74 73 20 66 6f 72 20 44 45 43 20 46 uments for DEC F
09d0: 4f 43 41 4c 20 77 68 69 63 68 20 61 70 70 6c 79 OCAL which apply
09e0: 20 74 6f 20 76 61 72 79 69 6e 67 20 64 65 67 72 to varying degr
09f0: 65 65 73 20 74 6f 20 77 68 61 74 20 77 65 20 73 ees to what we s
0a00: 68 69 70 2e 20 57 65 20 72 65 63 6f 6d 6d 65 6e hip. We recommen
0a10: 64 20 72 65 61 64 69 6e 67 20 74 68 65 6d 20 69 d reading them i
0a20: 6e 20 74 68 69 73 20 6f 72 64 65 72 3a 0d 0a 0d n this order:...
0a30: 0a 2a 20 20 20 5b 44 45 43 20 46 4f 43 41 4c 20 .* [DEC FOCAL
0a40: 62 6f 6f 6b 6c 65 74 5d 28 68 74 74 70 73 3a 2f booklet](https:/
0a50: 2f 77 77 77 2e 67 72 63 2e 63 6f 6d 2f 70 64 70 /www.grc.com/pdp
0a60: 2d 38 2f 64 6f 63 73 2f 46 6f 63 61 6c 5f 42 6f -8/docs/Focal_Bo
0a70: 6f 6b 6c 65 74 2e 70 64 66 29 20 28 50 44 46 2c oklet.pdf) (PDF,
0a80: 20 32 35 35 20 6b 42 29 20 e2 80 94 20 54 68 69 255 kB) — Thi
0a90: 73 20 69 73 20 61 6e 20 65 78 63 65 6c 6c 65 6e s is an excellen
0aa0: 74 20 69 6e 74 72 6f 64 75 63 74 6f 72 79 20 62 t introductory b
0ab0: 6f 6f 6b 6c 65 74 20 74 6f 20 67 65 74 20 79 6f ooklet to get yo
0ac0: 75 20 73 74 61 72 74 65 64 20 77 69 74 68 20 70 u started with p
0ad0: 72 6f 67 72 61 6d 69 6e 67 20 69 6e 20 67 65 6e rograming in gen
0ae0: 65 72 61 6c 20 74 68 72 6f 75 67 68 20 74 68 65 eral through the
0af0: 20 6d 65 64 69 75 6d 20 6f 66 20 44 45 43 20 46 medium of DEC F
0b00: 4f 43 41 4c 2e 0d 0a 0d 0a 2a 20 20 20 5b 50 72 OCAL.....* [Pr
0b10: 6f 67 72 61 6d 6d 69 6e 67 20 4c 61 6e 67 75 61 ogramming Langua
0b20: 67 65 73 3a 20 50 44 50 2d 38 20 46 61 6d 69 6c ges: PDP-8 Famil
0b30: 79 20 43 6f 6d 70 75 74 65 72 73 5d 28 68 74 74 y Computers](htt
0b40: 70 3a 2f 2f 62 69 74 73 61 76 65 72 73 2e 6f 72 p://bitsavers.or
0b50: 67 2f 70 64 66 2f 64 65 63 2f 70 64 70 38 2f 68 g/pdf/dec/pdp8/h
0b60: 61 6e 64 62 6f 6f 6b 73 2f 70 72 6f 67 72 61 6d andbooks/program
0b70: 6d 69 6e 67 4c 61 6e 67 75 61 67 65 73 5f 4d 61 mingLanguages_Ma
0b80: 79 37 30 2e 70 64 66 29 20 28 50 44 46 2c 20 31 y70.pdf) (PDF, 1
0b90: 39 2e 32 20 4d 42 29 20 e2 80 94 20 54 68 69 73 9.2 MB) — This
0ba0: 20 69 73 20 74 68 65 20 73 65 63 6f 6e 64 20 62 is the second b
0bb0: 6f 6f 6b 20 6f 66 20 61 20 32 2d 76 6f 6c 75 6d ook of a 2-volum
0bc0: 65 20 73 65 74 2c 20 77 69 74 68 20 22 5b 49 6e e set, with "[In
0bd0: 74 72 6f 64 75 63 74 69 6f 6e 20 74 6f 20 50 72 troduction to Pr
0be0: 6f 67 72 61 6d 6d 69 6e 67 5d 28 28 68 74 74 70 ogramming]((http
0bf0: 73 3a 2f 2f 77 77 77 2e 70 64 70 38 2e 6e 65 74 s://www.pdp8.net
0c00: 2f 70 64 70 38 63 67 69 2f 71 75 65 72 79 5f 64 /pdp8cgi/query_d
0c10: 6f 63 73 2f 76 69 65 77 2e 70 6c 3f 69 64 3d 35 ocs/view.pl?id=5
0c20: 33 37 29 29 22 20 62 65 69 6e 67 20 74 68 65 20 37))" being the
0c30: 66 69 72 73 74 2e 20 54 68 65 20 66 69 72 73 74 first. The first
0c40: 20 62 6f 6f 6b 20 64 69 64 20 6f 72 69 67 69 6e book did origin
0c50: 61 6c 6c 79 20 63 6f 76 65 72 20 46 4f 43 41 4c ally cover FOCAL
0c60: 20 28 43 68 61 70 74 65 72 20 39 29 2c 20 62 75 (Chapter 9), bu
0c70: 74 20 74 68 61 74 20 6d 61 74 65 72 69 61 6c 20 t that material
0c80: 77 61 73 20 6c 61 74 65 72 20 6d 6f 76 65 64 20 was later moved
0c90: 74 6f 20 74 68 69 73 20 73 65 63 6f 6e 64 20 76 to this second v
0ca0: 6f 6c 75 6d 65 20 61 6e 64 20 69 6d 70 72 6f 76 olume and improv
0cb0: 65 64 20 63 6f 6e 73 69 64 65 72 61 62 6c 79 2c ed considerably,
0cc0: 20 73 6f 20 77 65 20 63 61 6e 6e 6f 74 20 72 65 so we cannot re
0cd0: 63 6f 6d 6d 65 6e 64 20 6c 65 61 72 6e 69 6e 67 commend learning
0ce0: 20 46 4f 43 41 4c 20 76 69 61 20 22 49 6e 74 72 FOCAL via "Intr
0cf0: 6f 64 75 63 74 69 6f 6e 20 74 6f 20 50 72 6f 67 oduction to Prog
0d00: 72 61 6d 6d 69 6e 67 2e 22 20 54 68 65 20 66 69 ramming." The fi
0d10: 72 73 74 20 76 6f 6c 75 6d 65 20 77 61 73 20 6c rst volume was l
0d20: 61 74 65 72 20 72 65 2d 70 75 62 6c 69 73 68 65 ater re-publishe
0d30: 64 20 77 69 74 68 6f 75 74 20 64 65 74 61 69 6c d without detail
0d40: 65 64 20 63 6f 76 65 72 61 67 65 20 6f 66 20 74 ed coverage of t
0d50: 68 65 20 76 61 72 69 6f 75 73 20 70 72 6f 67 72 he various progr
0d60: 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61 67 65 73 amming languages
0d70: 2c 20 66 6f 63 75 73 69 6e 67 20 6f 6e 20 66 6f , focusing on fo
0d80: 75 6e 64 61 74 69 6f 6e 61 6c 20 6d 61 74 74 65 undational matte
0d90: 72 73 2e 0d 0a 0d 0a 20 20 20 20 54 68 65 20 46 rs..... The F
0da0: 4f 43 41 4c 20 6d 61 74 65 72 69 61 6c 20 69 6e OCAL material in
0db0: 20 22 50 72 6f 67 72 61 6d 6d 69 6e 67 20 4c 61 "Programming La
0dc0: 6e 67 75 61 67 65 73 22 20 69 73 20 69 6e 20 43 nguages" is in C
0dd0: 68 61 70 74 65 72 20 31 31 2e 20 49 74 20 64 6f hapter 11. It do
0de0: 65 73 6e 27 74 20 74 61 6c 6b 20 61 62 6f 75 74 esn't talk about
0df0: 20 4f 53 2f 38 20 46 4f 43 41 4c 2c 31 39 36 39 OS/8 FOCAL,1969
0e00: 20 73 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 62 specifically, b
0e10: 75 74 20 72 61 74 68 65 72 20 69 6e 20 61 20 67 ut rather in a g
0e20: 65 6e 65 72 69 63 20 66 61 73 68 69 6f 6e 20 61 eneric fashion a
0e30: 62 6f 75 74 20 61 6c 6c 20 44 45 43 20 46 4f 43 bout all DEC FOC
0e40: 41 4c 20 76 61 72 69 61 6e 74 73 2e 0d 0a 0d 0a AL variants.....
0e50: 2a 20 20 20 5b 46 4f 43 41 4c 2d 38 20 50 72 6f * [FOCAL-8 Pro
0e60: 67 72 61 6d 6d 69 6e 67 20 4d 61 6e 75 61 6c 5d gramming Manual]
0e70: 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 70 64 70 (https://www.pdp
0e80: 38 2e 6e 65 74 2f 70 64 70 38 63 67 69 2f 71 75 8.net/pdp8cgi/qu
0e90: 65 72 79 5f 64 6f 63 73 2f 76 69 65 77 2e 70 6c ery_docs/view.pl
0ea0: 3f 69 64 3d 31 34 34 29 20 28 50 44 46 2c 20 32 ?id=144) (PDF, 2
0eb0: 2e 36 20 4d 42 29 20 e2 80 94 20 57 65 20 69 6e .6 MB) — We in
0ec0: 63 6c 75 64 65 20 74 68 69 73 20 6d 61 69 6e 6c clude this mainl
0ed0: 79 20 66 6f 72 20 68 69 73 74 6f 72 69 63 61 6c y for historical
0ee0: 20 76 61 6c 75 65 2c 20 62 65 63 61 75 73 65 20 value, because
0ef0: 69 74 20 66 6f 63 75 73 65 73 20 6f 6e 20 74 68 it focuses on th
0f00: 65 20 6f 72 69 67 69 6e 61 6c 20 76 65 72 73 69 e original versi
0f10: 6f 6e 73 20 6f 66 20 44 45 43 20 46 4f 43 41 4c ons of DEC FOCAL
0f20: 2c 20 62 65 69 6e 67 20 74 68 65 20 6f 6c 64 20 , being the old
0f30: 34 6b 20 70 61 70 65 72 20 74 61 70 65 20 76 65 4k paper tape ve
0f40: 72 73 69 6f 6e 20 61 6e 64 20 74 68 65 20 76 65 rsion and the ve
0f50: 72 73 69 6f 6e 20 66 6f 72 20 74 68 65 20 6f 6c rsion for the ol
0f60: 64 20 44 69 73 6b 20 4d 6f 6e 69 74 6f 72 20 53 d Disk Monitor S
0f70: 79 73 74 65 6d 2e 20 57 65 20 64 6f 6e 27 74 20 ystem. We don't
0f80: 6b 6e 6f 77 20 68 6f 77 20 77 65 6c 6c 20 74 68 know how well th
0f90: 65 73 65 20 76 65 72 73 69 6f 6e 73 20 6d 61 70 ese versions map
0fa0: 20 74 6f 20 74 68 65 20 4f 53 2f 38 20 76 65 72 to the OS/8 ver
0fb0: 73 69 6f 6e 20 77 65 20 73 68 69 70 2e 0d 0a 0d sion we ship....
0fc0: 0a 0d 0a 23 20 4f 6e 20 4e 61 6d 69 6e 67 0d 0a ...# On Naming..
0fd0: 0d 0a 59 6f 75 20 6d 69 67 68 74 20 62 65 20 77 ..You might be w
0fe0: 6f 6e 64 65 72 69 6e 67 20 61 62 6f 75 74 20 6f ondering about o
0ff0: 75 72 20 75 73 65 20 6f 66 20 74 68 65 20 6e 61 ur use of the na
1000: 6d 65 20 22 46 4f 43 41 4c 2c 31 39 36 39 22 2e me "FOCAL,1969".
1010: 20 54 68 61 74 27 73 20 62 65 63 61 75 73 65 20 That's because
1020: 74 68 61 74 27 73 20 68 6f 77 20 74 68 65 20 73 that's how the s
1030: 6f 66 74 77 61 72 65 20 69 64 65 6e 74 69 66 69 oftware identifi
1040: 65 73 20 69 74 73 65 6c 66 20 6f 6e 20 73 74 61 es itself on sta
1050: 72 74 69 6e 67 20 75 70 2e 20 49 74 20 72 65 66 rting up. It ref
1060: 65 72 73 20 74 6f 20 61 20 66 61 69 72 6c 79 20 ers to a fairly
1070: 73 70 65 63 69 66 69 63 20 76 65 72 73 69 6f 6e specific version
1080: 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 72 65 of the software
1090: 2c 20 77 68 69 63 68 20 6d 61 74 63 68 65 73 20 , which matches
10a0: 77 68 61 74 20 77 65 20 64 69 73 74 72 69 62 75 what we distribu
10b0: 74 65 2e 20 49 74 20 69 73 20 73 6f 6d 65 74 69 te. It is someti
10c0: 6d 65 73 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 mes also called
10d0: 22 46 4f 43 41 4c 20 36 39 22 2c 20 74 68 6f 75 "FOCAL 69", thou
10e0: 67 68 20 74 68 61 74 20 74 65 72 6d 20 77 61 73 gh that term was
10f0: 20 6e 6f 74 20 66 61 76 6f 72 65 64 20 62 79 20 not favored by
1100: 44 45 43 2e 0d 0a 0d 0a 41 6e 6f 74 68 65 72 20 DEC.....Another
1110: 6e 61 6d 65 20 74 68 61 74 20 2a 77 61 73 2a 20 name that *was*
1120: 66 61 76 6f 72 65 64 20 62 79 20 44 45 43 20 6d favored by DEC m
1130: 61 72 6b 65 74 69 6e 67 20 69 73 20 22 46 4f 43 arketing is "FOC
1140: 41 4c 2d 38 2e 22 20 54 68 69 73 20 69 73 20 61 AL-8." This is a
1150: 20 67 65 6e 65 72 69 63 20 6e 61 6d 65 20 6e 6f generic name no
1160: 74 20 72 65 66 65 72 72 69 6e 67 20 74 6f 20 61 t referring to a
1170: 6e 79 20 73 70 65 63 69 66 69 63 20 76 65 72 73 ny specific vers
1180: 69 6f 6e 20 6f 66 20 46 4f 43 41 4c 2e 20 59 6f ion of FOCAL. Yo
1190: 75 20 63 61 6e 20 72 65 61 64 20 69 74 20 61 73 u can read it as
11a0: 20 22 44 45 43 20 46 4f 43 41 4c 20 6f 6e 20 74 "DEC FOCAL on t
11b0: 68 65 20 50 44 50 2d 38 2e 22 0d 0a 0d 0a 54 68 he PDP-8."....Th
11c0: 65 72 65 20 77 65 72 65 20 6d 61 6e 79 20 76 61 ere were many va
11d0: 72 69 61 6e 74 73 20 6f 66 20 46 4f 43 41 4c 20 riants of FOCAL
11e0: 62 61 63 6b 20 69 6e 20 74 68 65 20 64 61 79 2c back in the day,
11f0: 20 73 6f 6d 65 20 66 72 6f 6d 20 44 45 43 20 61 some from DEC a
1200: 6e 64 20 73 6f 6d 65 20 66 72 6f 6d 20 6f 75 74 nd some from out
1210: 73 69 64 65 72 73 2e 20 42 65 63 61 75 73 65 20 siders. Because
1220: 74 68 65 20 6c 61 6e 67 75 61 67 65 20 77 61 73 the language was
1230: 20 6e 65 76 65 72 20 66 6f 72 6d 61 6c 6c 79 20 never formally
1240: 73 74 61 6e 64 61 72 64 69 7a 65 64 2c 20 61 6e standardized, an
1250: 64 20 74 68 65 72 65 20 6e 65 76 65 72 20 77 61 d there never wa
1260: 73 20 6f 6e 65 20 64 6f 6d 69 6e 61 6e 74 20 76 s one dominant v
1270: 65 72 73 69 6f 6e 2c 20 69 74 20 63 61 6e 20 62 ersion, it can b
1280: 65 20 75 73 65 66 75 6c 20 74 6f 20 62 65 20 73 e useful to be s
1290: 70 65 63 69 66 69 63 20 61 62 6f 75 74 20 77 68 pecific about wh
12a0: 69 63 68 20 76 61 72 69 61 6e 74 20 79 6f 75 27 ich variant you'
12b0: 72 65 20 74 61 6c 6b 69 6e 67 20 61 62 6f 75 74 re talking about
12c0: 2e 20 47 65 6e 65 72 69 63 20 74 65 72 6d 73 20 . Generic terms
12d0: 6c 69 6b 65 20 22 46 4f 43 41 4c 22 2c 20 22 46 like "FOCAL", "F
12e0: 4f 43 41 4c 20 36 39 22 2c 20 6f 72 20 22 46 4f OCAL 69", or "FO
12f0: 43 41 4c 2d 38 22 20 73 68 6f 75 6c 64 20 62 65 CAL-8" should be
1300: 20 75 73 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 used only when
1310: 79 6f 75 27 72 65 20 6e 6f 74 20 74 72 79 69 6e you're not tryin
1320: 67 20 74 6f 20 72 65 66 65 72 20 74 6f 20 61 20 g to refer to a
1330: 73 70 65 63 69 66 69 63 20 76 65 72 73 69 6f 6e specific version
1340: 2e 0d 0a 0d 0a 5b 68 62 5d 3a 20 20 68 74 74 70 .....[hb]: http
1350: 73 3a 2f 2f 61 72 63 68 69 76 65 2e 6f 72 67 2f s://archive.org/
1360: 64 65 74 61 69 6c 73 2f 62 69 74 73 61 76 65 72 details/bitsaver
1370: 73 5f 64 65 63 70 64 70 38 6f 73 38 5f 33 39 34 s_decpdp8os8_394
1380: 31 34 37 39 32 0d 0a 5b 6f 70 74 5d 3a 20 68 74 14792..[opt]: ht
1390: 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 tps://tangentsof
13a0: 74 2e 63 6f 6d 2f 70 69 64 70 38 69 2f 64 6f 63 t.com/pidp8i/doc
13b0: 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 /trunk/README.md
13c0: 23 6f 70 74 69 6f 6e 73 0d 0a 5b 73 62 69 5d 3a #options..[sbi]:
13d0: 20 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 https://en.wiki
13e0: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 pedia.org/wiki/S
13f0: 68 65 6c 6c 5f 62 75 69 6c 74 69 6e 0d 0a 5b 75 hell_builtin..[u
1400: 77 66 5d 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f wf]: /doc/trunk/
1410: 64 6f 63 2f 75 77 66 6f 63 61 6c 2d 6d 61 6e 75 doc/uwfocal-manu
1420: 61 6c 2e 6d 64 0a 5a 20 37 66 64 39 64 65 39 66 al.md.Z 7fd9de9f
1430: 30 39 62 63 33 32 61 30 36 38 39 36 34 30 38 65 09bc32a06896408e
1440: 63 39 63 64 36 63 61 31 0a c9cd6ca1.