PiDP-8/I SoftwareHex Artifact Content
Not logged in

Artifact d882c9ad03d6144a6d422a8f333b9f626adf9488:

Wiki page [Running FOCAL,1969] by tangent 2019-08-16 00:47:21.
0000: 44 20 32 30 31 39 2d 30 38 2d 31 36 54 30 30 3a  D 2019-08-16T00:
0010: 34 37 3a 32 31 2e 36 37 34 0a 4c 20 52 75 6e 6e  47:21.674.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 50 20 33 32 65 64 32 63 34 36 35 64 37 62  n.P 32ed2c465d7b
0050: 31 38 61 38 64 38 65 63 35 34 39 33 31 36 36 30  18a8d8ec54931660
0060: 37 39 33 38 63 63 64 36 37 36 33 37 0a 55 20 74  7938ccd67637.U t
0070: 61 6e 67 65 6e 74 0a 57 20 35 34 38 32 0a 54 68  angent.W 5482.Th
0080: 65 20 50 69 44 50 2d 38 2f 49 20 70 72 6f 6a 65  e PiDP-8/I proje
0090: 63 74 20 64 65 66 61 75 6c 74 73 20 74 6f 20 5b  ct defaults to [
00a0: 55 2f 57 20 46 4f 43 41 4c 5d 5b 75 77 66 5d 2c  U/W FOCAL][uwf],
00b0: 20 62 75 74 20 69 74 20 68 61 73 20 5b 61 6e 20   but it has [an 
00c0: 6f 70 74 69 6f 6e 5d 5b 6f 70 74 5d 20 74 68 61  option][opt] tha
00d0: 74 20 6c 65 74 73 20 79 6f 75 20 65 69 74 68 65  t lets you eithe
00e0: 72 20 61 64 64 20 46 4f 43 41 4c 2c 31 39 36 39  r add FOCAL,1969
00f0: 20 74 6f 20 74 68 69 73 20 6f 72 20 73 77 69 74   to this or swit
0100: 63 68 20 74 6f 20 69 74 20 62 79 20 64 69 73 61  ch to it by disa
0110: 62 6c 69 6e 67 20 55 2f 57 20 46 4f 43 41 4c 20  bling U/W FOCAL 
0120: 65 6e 74 69 72 65 6c 79 3a 0d 0a 0d 0a 20 20 20  entirely:....   
0130: 20 24 20 2e 2f 63 6f 6e 66 69 67 75 72 65 20 2d   $ ./configure -
0140: 2d 65 6e 61 62 6c 65 2d 6f 73 38 2d 66 6f 63 61  -enable-os8-foca
0150: 6c 36 39 20 2d 2d 64 69 73 61 62 6c 65 2d 6f 73  l69 --disable-os
0160: 38 2d 75 77 66 6f 63 61 6c 0d 0a 0d 0a 4f 6e 63  8-uwfocal....Onc
0170: 65 20 74 68 61 74 20 73 6f 66 74 77 61 72 65 20  e that software 
0180: 69 73 20 62 75 69 6c 74 20 61 6e 64 20 69 6e 73  is built and ins
0190: 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d 69 67 68  talled, you migh
01a0: 74 20 74 68 65 6e 20 77 6f 6e 64 65 72 2c 20 22  t then wonder, "
01b0: 48 6f 77 20 64 6f 20 49 20 67 65 74 20 73 74 61  How do I get sta
01c0: 72 74 65 64 3f 22 20 54 68 69 73 20 64 6f 63 75  rted?" This docu
01d0: 6d 65 6e 74 20 69 73 20 6f 75 72 20 61 6e 73 77  ment is our answ
01e0: 65 72 20 74 6f 20 74 68 61 74 20 71 75 65 73 74  er to that quest
01f0: 69 6f 6e 2e 0d 0a 0d 0a 0d 0a 23 20 52 75 6e 6e  ion.......# Runn
0200: 69 6e 67 20 50 72 6f 67 72 61 6d 73 20 77 69 74  ing Programs wit
0210: 68 20 4f 53 2f 38 0d 0a 0d 0a 4f 53 2f 38 20 64  h OS/8....OS/8 d
0220: 6f 65 73 20 6e 6f 74 20 68 61 6e 64 6c 65 20 63  oes not handle c
0230: 6f 6d 6d 61 6e 64 73 20 74 68 65 20 73 61 6d 65  ommands the same
0240: 20 77 61 79 20 61 73 20 55 6e 69 78 2c 20 4d 53   way as Unix, MS
0250: 2d 44 4f 53 2c 20 6f 72 20 74 68 65 20 57 69 6e  -DOS, or the Win
0260: 64 6f 77 73 20 63 6f 6d 6d 61 6e 64 20 73 68 65  dows command she
0270: 6c 6c 73 20 60 63 6d 64 2e 65 78 65 60 20 61 6e  lls `cmd.exe` an
0280: 64 20 50 6f 77 65 72 53 68 65 6c 6c 2e 20 54 68  d PowerShell. Th
0290: 65 20 66 69 72 73 74 20 77 6f 72 64 20 69 6e 20  e first word in 
02a0: 61 6e 20 4f 53 2f 38 20 63 6f 6d 6d 61 6e 64 20  an OS/8 command 
02b0: 69 73 20 68 61 6e 64 6c 65 64 20 65 69 74 68 65  is handled eithe
02c0: 72 20 62 79 20 74 68 65 20 4f 53 2f 38 20 4b 65  r by the OS/8 Ke
02d0: 79 62 6f 61 72 64 20 4d 6f 6e 69 74 6f 72 20 6f  yboard Monitor o
02e0: 72 20 62 79 20 74 68 65 20 6f 70 74 69 6f 6e 61  r by the optiona
02f0: 6c 20 43 6f 6e 63 69 73 65 20 43 6f 6d 6d 61 6e  l Concise Comman
0300: 64 20 4c 61 6e 67 75 61 67 65 20 28 43 43 4c 29  d Language (CCL)
0310: 20 66 65 61 74 75 72 65 20 6f 66 20 4f 53 2f 38   feature of OS/8
0320: 2e 20 28 53 65 65 20 70 61 67 65 73 20 31 2d 33  . (See pages 1-3
0330: 35 20 61 6e 64 20 31 2d 35 32 20 69 6e 20 74 68  5 and 1-52 in th
0340: 65 20 5b 31 39 37 34 20 65 64 69 74 69 6f 6e 20  e [1974 edition 
0350: 6f 66 20 74 68 65 20 4f 53 2f 38 20 48 61 6e 64  of the OS/8 Hand
0360: 62 6f 6f 6b 5d 5b 68 62 5d 2c 20 72 65 73 70 65  book][hb], respe
0370: 63 74 69 76 65 6c 79 2c 20 66 6f 72 20 6d 6f 72  ctively, for mor
0380: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e  e information on
0390: 20 74 68 65 73 65 20 4f 53 2f 38 20 66 65 61 74   these OS/8 feat
03a0: 75 72 65 73 2e 29 0d 0a 0d 0a 49 6e 20 55 6e 69  ures.)....In Uni
03b0: 78 20 74 65 72 6d 73 2c 20 69 74 20 69 73 20 61  x terms, it is a
03c0: 73 20 69 66 20 4f 53 2f 38 20 68 61 73 20 6e 6f  s if OS/8 has no
03d0: 74 68 69 6e 67 20 62 75 74 20 5b 73 68 65 6c 6c  thing but [shell
03e0: 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6d 6d 61 6e   built-in comman
03f0: 64 73 5d 5b 73 62 69 5d 2e 20 54 68 65 72 65 20  ds][sbi]. There 
0400: 69 73 20 6e 6f 20 63 6f 6d 6d 61 6e 64 20 60 50  is no command `P
0410: 41 54 48 60 20 69 6e 20 4f 53 2f 38 2c 20 6e 6f  ATH` in OS/8, no
0420: 74 20 65 76 65 6e 20 61 20 68 61 72 64 2d 63 6f  t even a hard-co
0430: 64 65 64 20 6f 6e 65 2e 0d 0a 0d 0a 49 66 20 79  ded one.....If y
0440: 6f 75 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 65  ou want to run e
0450: 78 74 65 72 6e 61 6c 20 65 78 65 63 75 74 61 62  xternal executab
0460: 6c 65 73 20 69 6e 20 4f 53 2f 38 20 28 65 2e 67  les in OS/8 (e.g
0470: 2e 20 60 2a 2e 42 4e 60 2c 20 60 2a 2e 4c 44 60  . `*.BN`, `*.LD`
0480: 2c 20 60 2a 2e 53 56 60 2c 20 65 74 63 2e 29 20  , `*.SV`, etc.) 
0490: 79 6f 75 20 6d 75 73 74 20 67 69 76 65 20 61 20  you must give a 
04a0: 4b 65 79 62 6f 61 72 64 20 4d 6f 6e 69 74 6f 72  Keyboard Monitor
04b0: 20 6f 72 20 43 43 4c 20 63 6f 6d 6d 61 6e 64 20   or CCL command 
04c0: 74 6f 20 6c 6f 61 64 20 74 68 65 6d 2c 20 6f 72  to load them, or
04d0: 20 79 6f 75 20 6d 75 73 74 20 72 75 6e 20 61 20   you must run a 
04e0: 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63 61 6e  command that can
04f0: 20 69 6e 20 74 75 72 6e 20 6c 6f 61 64 20 74 68   in turn load th
0500: 65 6d 2e 0d 0a 0d 0a 43 43 4c 20 61 64 64 73 20  em.....CCL adds 
0510: 73 6f 6d 65 20 61 6c 69 61 73 65 73 20 66 6f 72  some aliases for
0520: 20 72 75 6e 6e 69 6e 67 20 62 69 6e 61 72 69 65   running binarie
0530: 73 20 74 68 61 74 20 6d 61 6b 65 73 20 69 74 20  s that makes it 
0540: 77 6f 72 6b 20 6d 6f 72 65 20 6c 69 6b 65 20 55  work more like U
0550: 6e 69 78 20 6f 72 20 44 4f 53 20 28 65 2e 67 2e  nix or DOS (e.g.
0560: 20 22 54 45 43 4f 22 29 2c 20 62 75 74 20 64 6f   "TECO"), but do
0570: 6e 27 74 20 67 65 74 20 63 6f 6e 66 75 73 65 64  n't get confused
0580: 20 61 62 6f 75 74 20 77 68 61 74 27 73 20 67 6f   about what's go
0590: 69 6e 67 20 6f 6e 20 68 65 72 65 3a 20 74 68 65  ing on here: the
05a0: 73 65 20 61 72 65 20 6a 75 73 74 20 6f 6e 65 2d  se are just one-
05b0: 6f 66 66 20 68 65 6c 70 65 72 73 2c 20 6e 6f 74  off helpers, not
05c0: 20 67 65 6e 65 72 69 63 20 73 75 70 70 6f 72 74   generic support
05d0: 20 6f 66 20 72 75 6e 6e 69 6e 67 20 65 78 74 65   of running exte
05e0: 72 6e 61 6c 20 70 72 6f 67 72 61 6d 73 20 61 73  rnal programs as
05f0: 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 73 2e   shell commands.
0600: 0d 0a 0d 0a 0d 0a 23 20 53 74 61 72 74 69 6e 67  ......# Starting
0610: 20 46 4f 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 49   FOCAL,1969....I
0620: 27 76 65 20 74 61 6b 65 6e 20 74 68 65 20 74 69  've taken the ti
0630: 6d 65 20 74 6f 20 67 6f 20 69 6e 74 6f 20 61 6c  me to go into al
0640: 6c 20 6f 66 20 74 68 61 74 20 64 65 74 61 69 6c  l of that detail
0650: 20 62 65 63 61 75 73 65 20 69 74 20 65 78 70 6c   because it expl
0660: 61 69 6e 73 20 77 68 79 20 6e 6f 6e 65 20 6f 66  ains why none of
0670: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63   the following c
0680: 6f 6d 6d 61 6e 64 73 20 73 74 61 72 74 20 74 68  ommands start th
0690: 65 20 60 46 4f 43 41 4c 2e 42 4e 60 20 62 69 6e  e `FOCAL.BN` bin
06a0: 61 72 79 20 77 65 20 73 68 69 70 20 77 68 65 6e  ary we ship when
06b0: 20 79 6f 75 20 62 75 69 6c 64 20 74 68 65 20 4f   you build the O
06c0: 53 2f 38 20 64 69 73 6b 20 70 61 63 6b 73 20 77  S/8 disk packs w
06d0: 69 74 68 20 46 4f 43 41 4c 2c 31 39 36 39 20 65  ith FOCAL,1969 e
06e0: 6e 61 62 6c 65 64 3a 0d 0a 0d 0a 20 20 20 20 2e  nabled:....    .
06f0: 46 4f 43 41 4c 0d 0a 20 20 20 20 2e 52 20 46 4f  FOCAL..    .R FO
0700: 43 41 4c 0d 0a 20 20 20 20 2e 52 55 4e 20 46 4f  CAL..    .RUN FO
0710: 43 41 4c 0d 0a 0d 0a 57 68 61 74 20 79 6f 75 20  CAL....What you 
0720: 61 63 74 75 61 6c 6c 79 20 77 61 6e 74 20 69 73  actually want is
0730: 20 74 6f 20 73 74 61 72 74 20 74 68 65 20 4f 53   to start the OS
0740: 2f 38 20 61 62 73 6f 6c 75 74 65 20 62 69 6e 61  /8 absolute bina
0750: 72 79 20 6c 6f 61 64 65 72 2c 20 77 68 69 63 68  ry loader, which
0760: 20 69 73 20 77 68 61 74 20 68 61 6e 64 6c 65 73   is what handles
0770: 20 60 2a 2e 42 4e 60 20 66 69 6c 65 73 20 73 75   `*.BN` files su
0780: 63 68 20 61 73 20 60 46 4f 43 41 4c 2e 42 4e 60  ch as `FOCAL.BN`
0790: 3a 0d 0a 0d 0a 20 20 20 20 2e 52 20 41 42 53 4c  :....    .R ABSL
07a0: 44 52 0d 0a 20 20 20 20 2a 46 4f 43 41 4c 2f 47  DR..    *FOCAL/G
07b0: 0d 0a 0d 0a 54 68 65 20 60 2f 47 60 20 6f 70 74  ....The `/G` opt
07c0: 69 6f 6e 20 6d 65 61 6e 73 20 22 67 6f 2c 22 20  ion means "go," 
07d0: 73 74 61 72 74 69 6e 67 20 74 68 65 20 70 72 6f  starting the pro
07e0: 67 72 61 6d 20 69 6d 6d 65 64 69 61 74 65 6c 79  gram immediately
07f0: 20 61 66 74 65 72 20 6c 6f 61 64 69 6e 67 20 69   after loading i
0800: 74 20 69 6e 74 6f 20 63 6f 72 65 20 6d 65 6d 6f  t into core memo
0810: 72 79 2e 0d 0a 0d 0a 59 6f 75 27 6c 6c 20 67 65  ry.....You'll ge
0820: 74 20 61 6e 6f 74 68 65 72 20 22 60 2a 60 22 20  t another "`*`" 
0830: 70 72 6f 6d 70 74 20 61 66 74 65 72 20 74 68 61  prompt after tha
0840: 74 2c 20 62 75 74 20 69 74 27 73 20 66 72 6f 6d  t, but it's from
0850: 20 46 4f 43 41 4c 2c 20 6e 6f 74 20 60 41 42 53   FOCAL, not `ABS
0860: 4c 44 52 60 2e 20 53 65 65 20 70 61 67 65 20 31  LDR`. See page 1
0870: 2d 31 30 38 20 69 6e 20 74 68 65 20 4f 53 2f 38  -108 in the OS/8
0880: 20 68 61 6e 64 62 6f 6f 6b 20 6c 69 6e 6b 65 64   handbook linked
0890: 20 61 62 6f 76 65 20 66 6f 72 20 6d 6f 72 65 20   above for more 
08a0: 64 65 74 61 69 6c 20 61 62 6f 75 74 20 60 41 42  detail about `AB
08b0: 53 4c 44 52 60 20 63 6f 6d 6d 61 6e 64 73 2e 0d  SLDR` commands..
08c0: 0a 0d 0a 0d 0a 23 20 52 65 74 75 72 6e 69 6e 67  .....# Returning
08d0: 20 74 6f 20 4f 53 2f 38 20 66 72 6f 6d 20 46 4f   to OS/8 from FO
08e0: 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 53 61 79 20  CAL,1969....Say 
08f0: 22 4c 22 20 28 60 4c 4f 47 49 43 41 4c 20 45 58  "L" (`LOGICAL EX
0900: 49 54 60 29 20 61 74 20 74 68 65 20 46 4f 43 41  IT`) at the FOCA
0910: 4c 20 60 2a 60 20 70 72 6f 6d 70 74 20 74 6f 20  L `*` prompt to 
0920: 67 65 74 20 62 61 63 6b 20 74 6f 20 4f 53 2f 38  get back to OS/8
0930: 2e 20 55 6e 6c 69 6b 65 20 55 2f 57 20 46 4f 43  . Unlike U/W FOC
0940: 41 4c 2c 20 46 4f 43 41 4c 2c 31 39 36 39 20 64  AL, FOCAL,1969 d
0950: 6f 65 73 20 6e 6f 74 20 64 6f 20 74 68 69 73 20  oes not do this 
0960: 6f 6e 20 43 74 72 6c 2d 43 2e 0d 0a 0d 0a 0d 0a  on Ctrl-C.......
0970: 23 20 55 73 69 6e 67 20 46 4f 43 41 4c 2c 31 39  # Using FOCAL,19
0980: 36 39 0d 0a 0d 0a 54 68 65 72 65 20 61 72 65 20  69....There are 
0990: 73 65 76 65 72 61 6c 20 66 72 65 65 6c 79 2d 61  several freely-a
09a0: 76 61 69 6c 61 62 6c 65 20 50 44 46 20 64 6f 63  vailable PDF doc
09b0: 75 6d 65 6e 74 73 20 66 6f 72 20 44 45 43 20 46  uments for DEC F
09c0: 4f 43 41 4c 20 77 68 69 63 68 20 61 70 70 6c 79  OCAL which apply
09d0: 20 74 6f 20 76 61 72 79 69 6e 67 20 64 65 67 72   to varying degr
09e0: 65 65 73 20 74 6f 20 77 68 61 74 20 77 65 20 73  ees to what we s
09f0: 68 69 70 2e 20 57 65 20 72 65 63 6f 6d 6d 65 6e  hip. We recommen
0a00: 64 20 72 65 61 64 69 6e 67 20 74 68 65 6d 20 69  d reading them i
0a10: 6e 20 74 68 69 73 20 6f 72 64 65 72 3a 0d 0a 0d  n this order:...
0a20: 0a 2a 20 20 20 5b 44 45 43 20 46 4f 43 41 4c 20  .*   [DEC FOCAL 
0a30: 62 6f 6f 6b 6c 65 74 5d 28 68 74 74 70 73 3a 2f  booklet](https:/
0a40: 2f 77 77 77 2e 67 72 63 2e 63 6f 6d 2f 70 64 70  /www.grc.com/pdp
0a50: 2d 38 2f 64 6f 63 73 2f 46 6f 63 61 6c 5f 42 6f  -8/docs/Focal_Bo
0a60: 6f 6b 6c 65 74 2e 70 64 66 29 20 28 50 44 46 2c  oklet.pdf) (PDF,
0a70: 20 32 35 35 20 6b 42 29 20 e2 80 94 20 54 68 69   255 kB) ... Thi
0a80: 73 20 69 73 20 61 6e 20 65 78 63 65 6c 6c 65 6e  s is an excellen
0a90: 74 20 69 6e 74 72 6f 64 75 63 74 6f 72 79 20 62  t introductory b
0aa0: 6f 6f 6b 6c 65 74 20 74 6f 20 67 65 74 20 79 6f  ooklet to get yo
0ab0: 75 20 73 74 61 72 74 65 64 20 77 69 74 68 20 70  u started with p
0ac0: 72 6f 67 72 61 6d 69 6e 67 20 69 6e 20 67 65 6e  rograming in gen
0ad0: 65 72 61 6c 20 74 68 72 6f 75 67 68 20 74 68 65  eral through the
0ae0: 20 6d 65 64 69 75 6d 20 6f 66 20 44 45 43 20 46   medium of DEC F
0af0: 4f 43 41 4c 2e 0d 0a 0d 0a 2a 20 20 20 5b 50 72  OCAL.....*   [Pr
0b00: 6f 67 72 61 6d 6d 69 6e 67 20 4c 61 6e 67 75 61  ogramming Langua
0b10: 67 65 73 3a 20 50 44 50 2d 38 20 46 61 6d 69 6c  ges: PDP-8 Famil
0b20: 79 20 43 6f 6d 70 75 74 65 72 73 5d 28 68 74 74  y Computers](htt
0b30: 70 3a 2f 2f 62 69 74 73 61 76 65 72 73 2e 6f 72  p://bitsavers.or
0b40: 67 2f 70 64 66 2f 64 65 63 2f 70 64 70 38 2f 68  g/pdf/dec/pdp8/h
0b50: 61 6e 64 62 6f 6f 6b 73 2f 70 72 6f 67 72 61 6d  andbooks/program
0b60: 6d 69 6e 67 4c 61 6e 67 75 61 67 65 73 5f 4d 61  mingLanguages_Ma
0b70: 79 37 30 2e 70 64 66 29 20 28 50 44 46 2c 20 31  y70.pdf) (PDF, 1
0b80: 39 2e 32 20 4d 42 29 20 e2 80 94 20 54 68 69 73  9.2 MB) ... This
0b90: 20 62 6f 6f 6b 20 63 6f 76 65 72 73 20 73 65 76   book covers sev
0ba0: 65 72 61 6c 20 64 69 66 66 65 72 65 6e 74 20 50  eral different P
0bb0: 44 50 2d 38 20 70 72 6f 67 72 61 6d 6d 69 6e 67  DP-8 programming
0bc0: 20 6c 61 6e 67 75 61 67 65 20 73 79 73 74 65 6d   language system
0bd0: 73 2c 20 77 69 74 68 20 74 68 65 20 46 4f 43 41  s, with the FOCA
0be0: 4c 20 6d 61 74 65 72 69 61 6c 20 62 65 69 6e 67  L material being
0bf0: 20 69 6e 20 43 68 61 70 74 65 72 20 31 31 2e 20   in Chapter 11. 
0c00: 49 74 20 64 6f 65 73 6e 27 74 20 74 61 6c 6b 20  It doesn't talk 
0c10: 61 62 6f 75 74 20 4f 53 2f 38 20 46 4f 43 41 4c  about OS/8 FOCAL
0c20: 2c 31 39 36 39 20 73 70 65 63 69 66 69 63 61 6c  ,1969 specifical
0c30: 6c 79 2c 20 62 75 74 20 72 61 74 68 65 72 20 69  ly, but rather i
0c40: 6e 20 61 20 67 65 6e 65 72 69 63 20 66 61 73 68  n a generic fash
0c50: 69 6f 6e 20 61 62 6f 75 74 20 61 6c 6c 20 44 45  ion about all DE
0c60: 43 20 46 4f 43 41 4c 20 76 61 72 69 61 6e 74 73  C FOCAL variants
0c70: 2e 0d 0a 0d 0a 20 20 20 20 54 68 69 73 20 69 73  .....    This is
0c80: 20 74 68 65 20 73 65 63 6f 6e 64 20 62 6f 6f 6b   the second book
0c90: 20 6f 66 20 61 20 32 2d 76 6f 6c 75 6d 65 20 73   of a 2-volume s
0ca0: 65 74 2c 20 77 69 74 68 20 22 5b 49 6e 74 72 6f  et, with "[Intro
0cb0: 64 75 63 74 69 6f 6e 20 74 6f 20 50 72 6f 67 72  duction to Progr
0cc0: 61 6d 6d 69 6e 67 5d 28 28 68 74 74 70 73 3a 2f  amming]((https:/
0cd0: 2f 77 77 77 2e 70 64 70 38 2e 6e 65 74 2f 70 64  /www.pdp8.net/pd
0ce0: 70 38 63 67 69 2f 71 75 65 72 79 5f 64 6f 63 73  p8cgi/query_docs
0cf0: 2f 76 69 65 77 2e 70 6c 3f 69 64 3d 35 33 37 29  /view.pl?id=537)
0d00: 22 20 62 65 69 6e 67 20 74 68 65 20 66 69 72 73  " being the firs
0d10: 74 2e 20 54 68 65 20 6c 69 6e 6b 65 64 2d 74 6f  t. The linked-to
0d20: 20 4a 61 6e 75 61 72 79 20 31 39 36 39 20 65 64   January 1969 ed
0d30: 69 74 69 6f 6e 20 6f 66 20 74 68 61 74 20 62 6f  ition of that bo
0d40: 6f 6b 20 64 69 64 20 63 6f 76 65 72 20 46 4f 43  ok did cover FOC
0d50: 41 4c 20 28 43 68 61 70 74 65 72 20 39 29 2c 20  AL (Chapter 9), 
0d60: 62 75 74 20 74 68 61 74 20 6d 61 74 65 72 69 61  but that materia
0d70: 6c 20 77 61 73 20 6c 61 74 65 72 20 6d 6f 76 65  l was later move
0d80: 64 20 74 6f 20 74 68 69 73 20 73 65 63 6f 6e 64  d to this second
0d90: 20 76 6f 6c 75 6d 65 20 28 70 75 62 6c 69 73 68   volume (publish
0da0: 65 64 20 4d 61 79 20 31 39 37 30 29 20 61 6e 64  ed May 1970) and
0db0: 20 69 6d 70 72 6f 76 65 64 20 63 6f 6e 73 69 64   improved consid
0dc0: 65 72 61 62 6c 79 2c 20 73 6f 20 77 65 20 63 61  erably, so we ca
0dd0: 6e 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e 64 20 6c  nnot recommend l
0de0: 65 61 72 6e 69 6e 67 20 46 4f 43 41 4c 20 76 69  earning FOCAL vi
0df0: 61 20 22 49 6e 74 72 6f 64 75 63 74 69 6f 6e 20  a "Introduction 
0e00: 74 6f 20 50 72 6f 67 72 61 6d 6d 69 6e 67 2e 22  to Programming."
0e10: 20 54 68 65 20 66 69 72 73 74 20 76 6f 6c 75 6d   The first volum
0e20: 65 20 77 61 73 20 5b 6c 61 74 65 72 20 72 65 2d  e was [later re-
0e30: 70 75 62 6c 69 73 68 65 64 5d 28 68 74 74 70 73  published](https
0e40: 3a 2f 2f 77 77 77 2e 77 6f 72 6c 64 63 61 74 2e  ://www.worldcat.
0e50: 6f 72 67 2f 74 69 74 6c 65 2f 69 6e 74 72 6f 64  org/title/introd
0e60: 75 63 74 69 6f 6e 2d 74 6f 2d 70 72 6f 67 72 61  uction-to-progra
0e70: 6d 6d 69 6e 67 2d 70 64 70 2d 38 2d 66 61 6d 69  mming-pdp-8-fami
0e80: 6c 79 2d 6f 66 2d 63 6f 6d 70 75 74 65 72 73 2f  ly-of-computers/
0e90: 6f 63 6c 63 2f 32 37 37 32 32 38 37 29 20 77 69  oclc/2772287) wi
0ea0: 74 68 6f 75 74 20 64 65 74 61 69 6c 65 64 20 63  thout detailed c
0eb0: 6f 76 65 72 61 67 65 20 6f 66 20 74 68 65 20 76  overage of the v
0ec0: 61 72 69 6f 75 73 20 70 72 6f 67 72 61 6d 6d 69  arious programmi
0ed0: 6e 67 20 6c 61 6e 67 75 61 67 65 73 2c 20 66 6f  ng languages, fo
0ee0: 63 75 73 69 6e 67 20 6f 6e 20 66 6f 75 6e 64 61  cusing on founda
0ef0: 74 69 6f 6e 61 6c 20 6d 61 74 74 65 72 73 2e 20  tional matters. 
0f00: 49 20 64 6f 6e 27 74 20 6b 6e 6f 77 20 6f 66 20  I don't know of 
0f10: 61 6e 20 6f 6e 6c 69 6e 65 20 73 6f 75 72 63 65  an online source
0f20: 20 6f 66 20 74 68 69 73 20 73 65 63 6f 6e 64 20   of this second 
0f30: 65 64 69 74 69 6f 6e 20 6f 66 20 22 49 6e 74 72  edition of "Intr
0f40: 6f 64 75 63 74 69 6f 6e 20 74 6f 20 50 72 6f 67  oduction to Prog
0f50: 72 61 6d 6d 69 6e 67 2e 22 0d 0a 0d 0a 2a 20 20  ramming."....*  
0f60: 20 5b 46 4f 43 41 4c 2d 38 20 50 72 6f 67 72 61   [FOCAL-8 Progra
0f70: 6d 6d 69 6e 67 20 4d 61 6e 75 61 6c 5d 28 68 74  mming Manual](ht
0f80: 74 70 73 3a 2f 2f 77 77 77 2e 70 64 70 38 2e 6e  tps://www.pdp8.n
0f90: 65 74 2f 70 64 70 38 63 67 69 2f 71 75 65 72 79  et/pdp8cgi/query
0fa0: 5f 64 6f 63 73 2f 76 69 65 77 2e 70 6c 3f 69 64  _docs/view.pl?id
0fb0: 3d 31 34 34 29 20 28 50 44 46 2c 20 32 2e 36 20  =144) (PDF, 2.6 
0fc0: 4d 42 29 20 e2 80 94 20 57 65 20 69 6e 63 6c 75  MB) ... We inclu
0fd0: 64 65 20 74 68 69 73 20 6d 61 69 6e 6c 79 20 66  de this mainly f
0fe0: 6f 72 20 68 69 73 74 6f 72 69 63 61 6c 20 76 61  or historical va
0ff0: 6c 75 65 2c 20 62 65 63 61 75 73 65 20 69 74 20  lue, because it 
1000: 66 6f 63 75 73 65 73 20 6f 6e 20 74 68 65 20 6f  focuses on the o
1010: 72 69 67 69 6e 61 6c 20 76 65 72 73 69 6f 6e 73  riginal versions
1020: 20 6f 66 20 44 45 43 20 46 4f 43 41 4c 2c 20 62   of DEC FOCAL, b
1030: 65 69 6e 67 20 74 68 65 20 6f 6c 64 20 34 6b 20  eing the old 4k 
1040: 70 61 70 65 72 20 74 61 70 65 20 76 65 72 73 69  paper tape versi
1050: 6f 6e 20 61 6e 64 20 74 68 65 20 76 65 72 73 69  on and the versi
1060: 6f 6e 20 66 6f 72 20 74 68 65 20 6f 6c 64 20 44  on for the old D
1070: 69 73 6b 20 4d 6f 6e 69 74 6f 72 20 53 79 73 74  isk Monitor Syst
1080: 65 6d 2e 20 57 65 20 64 6f 6e 27 74 20 6b 6e 6f  em. We don't kno
1090: 77 20 68 6f 77 20 77 65 6c 6c 20 74 68 65 73 65  w how well these
10a0: 20 76 65 72 73 69 6f 6e 73 20 6d 61 70 20 74 6f   versions map to
10b0: 20 74 68 65 20 4f 53 2f 38 20 76 65 72 73 69 6f   the OS/8 versio
10c0: 6e 20 77 65 20 73 68 69 70 2e 0d 0a 0d 0a 0d 0a  n we ship.......
10d0: 23 20 4f 6e 20 4e 61 6d 69 6e 67 0d 0a 0d 0a 59  # On Naming....Y
10e0: 6f 75 20 6d 69 67 68 74 20 62 65 20 77 6f 6e 64  ou might be wond
10f0: 65 72 69 6e 67 20 61 62 6f 75 74 20 6f 75 72 20  ering about our 
1100: 75 73 65 20 6f 66 20 74 68 65 20 6e 61 6d 65 20  use of the name 
1110: 22 46 4f 43 41 4c 2c 31 39 36 39 22 2e 20 54 68  "FOCAL,1969". Th
1120: 61 74 27 73 20 62 65 63 61 75 73 65 20 74 68 61  at's because tha
1130: 74 27 73 20 68 6f 77 20 74 68 65 20 73 6f 66 74  t's how the soft
1140: 77 61 72 65 20 69 64 65 6e 74 69 66 69 65 73 20  ware identifies 
1150: 69 74 73 65 6c 66 20 6f 6e 20 73 74 61 72 74 69  itself on starti
1160: 6e 67 20 75 70 2e 20 49 74 20 72 65 66 65 72 73  ng up. It refers
1170: 20 74 6f 20 61 20 66 61 69 72 6c 79 20 73 70 65   to a fairly spe
1180: 63 69 66 69 63 20 76 65 72 73 69 6f 6e 20 6f 66  cific version of
1190: 20 74 68 65 20 73 6f 66 74 77 61 72 65 2c 20 77   the software, w
11a0: 68 69 63 68 20 6d 61 74 63 68 65 73 20 77 68 61  hich matches wha
11b0: 74 20 77 65 20 64 69 73 74 72 69 62 75 74 65 2e  t we distribute.
11c0: 20 49 74 20 69 73 20 73 6f 6d 65 74 69 6d 65 73   It is sometimes
11d0: 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 22 46 4f   also called "FO
11e0: 43 41 4c 20 36 39 22 2c 20 74 68 6f 75 67 68 20  CAL 69", though 
11f0: 74 68 61 74 20 74 65 72 6d 20 77 61 73 20 6e 6f  that term was no
1200: 74 20 66 61 76 6f 72 65 64 20 62 79 20 44 45 43  t favored by DEC
1210: 2e 0d 0a 0d 0a 41 6e 6f 74 68 65 72 20 6e 61 6d  .....Another nam
1220: 65 20 74 68 61 74 20 2a 77 61 73 2a 20 66 61 76  e that *was* fav
1230: 6f 72 65 64 20 62 79 20 44 45 43 27 73 20 6d 61  ored by DEC's ma
1240: 72 6b 65 74 69 6e 67 20 64 65 70 61 72 74 6d 65  rketing departme
1250: 6e 74 20 69 73 20 22 46 4f 43 41 4c 2d 38 2e 22  nt is "FOCAL-8."
1260: 20 54 68 69 73 20 69 73 20 61 20 67 65 6e 65 72   This is a gener
1270: 69 63 20 6e 61 6d 65 20 6e 6f 74 20 72 65 66 65  ic name not refe
1280: 72 72 69 6e 67 20 74 6f 20 61 6e 79 20 73 70 65  rring to any spe
1290: 63 69 66 69 63 20 76 65 72 73 69 6f 6e 20 6f 66  cific version of
12a0: 20 46 4f 43 41 4c 2e 20 59 6f 75 20 63 61 6e 20   FOCAL. You can 
12b0: 72 65 61 64 20 69 74 20 61 73 20 22 44 45 43 20  read it as "DEC 
12c0: 46 4f 43 41 4c 20 6f 6e 20 74 68 65 20 50 44 50  FOCAL on the PDP
12d0: 2d 38 2e 22 0d 0a 0d 0a 54 68 65 72 65 20 77 65  -8."....There we
12e0: 72 65 20 6d 61 6e 79 20 76 61 72 69 61 6e 74 73  re many variants
12f0: 20 6f 66 20 46 4f 43 41 4c 20 62 61 63 6b 20 69   of FOCAL back i
1300: 6e 20 74 68 65 20 64 61 79 2c 20 73 6f 6d 65 20  n the day, some 
1310: 66 72 6f 6d 20 44 45 43 20 61 6e 64 20 73 6f 6d  from DEC and som
1320: 65 20 66 72 6f 6d 20 6f 75 74 73 69 64 65 72 73  e from outsiders
1330: 2e 20 42 65 63 61 75 73 65 20 74 68 65 20 6c 61  . Because the la
1340: 6e 67 75 61 67 65 20 77 61 73 20 6e 65 76 65 72  nguage was never
1350: 20 66 6f 72 6d 61 6c 6c 79 20 73 74 61 6e 64 61   formally standa
1360: 72 64 69 7a 65 64 2c 20 61 6e 64 20 74 68 65 72  rdized, and ther
1370: 65 20 6e 65 76 65 72 20 77 61 73 20 6f 6e 65 20  e never was one 
1380: 64 6f 6d 69 6e 61 6e 74 20 76 65 72 73 69 6f 6e  dominant version
1390: 2c 20 69 74 20 63 61 6e 20 62 65 20 75 73 65 66  , it can be usef
13a0: 75 6c 20 74 6f 20 62 65 20 73 70 65 63 69 66 69  ul to be specifi
13b0: 63 20 61 62 6f 75 74 20 77 68 69 63 68 20 76 61  c about which va
13c0: 72 69 61 6e 74 20 79 6f 75 27 72 65 20 74 61 6c  riant you're tal
13d0: 6b 69 6e 67 20 61 62 6f 75 74 2e 20 47 65 6e 65  king about. Gene
13e0: 72 69 63 20 74 65 72 6d 73 20 6c 69 6b 65 20 22  ric terms like "
13f0: 46 4f 43 41 4c 22 2c 20 22 46 4f 43 41 4c 20 36  FOCAL", "FOCAL 6
1400: 39 22 2c 20 6f 72 20 22 46 4f 43 41 4c 2d 38 22  9", or "FOCAL-8"
1410: 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20   should be used 
1420: 6f 6e 6c 79 20 77 68 65 6e 20 79 6f 75 27 72 65  only when you're
1430: 20 6e 6f 74 20 74 72 79 69 6e 67 20 74 6f 20 72   not trying to r
1440: 65 66 65 72 20 74 6f 20 61 20 73 70 65 63 69 66  efer to a specif
1450: 69 63 20 76 65 72 73 69 6f 6e 2e 0d 0a 0d 0a 0d  ic version......
1460: 0a 0d 0a 23 20 4c 69 63 65 6e 73 65 0d 0a 0d 0a  ...# License....
1470: 54 68 69 73 20 61 72 74 69 63 6c 65 20 69 73 20  This article is 
1480: c2 a9 20 32 30 31 39 20 61 6e 64 20 69 73 20 6c  .. 2019 and is l
1490: 69 63 65 6e 73 65 64 20 75 6e 64 65 72 20 74 68  icensed under th
14a0: 65 20 74 65 72 6d 73 20 6f 66 20 5b 74 68 65 20  e terms of [the 
14b0: 53 49 4d 48 20 6c 69 63 65 6e 73 65 5d 5b 73 6c  SIMH license][sl
14c0: 5d 2e 0d 0a 0d 0a 5b 68 62 5d 3a 20 20 68 74 74  ].....[hb]:  htt
14d0: 70 73 3a 2f 2f 61 72 63 68 69 76 65 2e 6f 72 67  ps://archive.org
14e0: 2f 64 65 74 61 69 6c 73 2f 62 69 74 73 61 76 65  /details/bitsave
14f0: 72 73 5f 64 65 63 70 64 70 38 6f 73 38 5f 33 39  rs_decpdp8os8_39
1500: 34 31 34 37 39 32 0d 0a 5b 6f 70 74 5d 3a 20 68  414792..[opt]: h
1510: 74 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f  ttps://tangentso
1520: 66 74 2e 63 6f 6d 2f 70 69 64 70 38 69 2f 64 6f  ft.com/pidp8i/do
1530: 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d  c/trunk/README.m
1540: 64 23 6f 70 74 69 6f 6e 73 0d 0a 5b 73 62 69 5d  d#options..[sbi]
1550: 3a 20 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b  : https://en.wik
1560: 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f  ipedia.org/wiki/
1570: 53 68 65 6c 6c 5f 62 75 69 6c 74 69 6e 0d 0a 5b  Shell_builtin..[
1580: 73 6c 5d 3a 20 20 20 68 74 74 70 73 3a 2f 2f 74  sl]:   https://t
1590: 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 70  angentsoft.com/p
15a0: 69 64 70 38 69 2f 64 6f 63 2f 74 72 75 6e 6b 2f  idp8i/doc/trunk/
15b0: 53 49 4d 48 2d 4c 49 43 45 4e 53 45 2e 6d 64 0d  SIMH-LICENSE.md.
15c0: 0a 5b 75 77 66 5d 3a 20 2f 64 6f 63 2f 74 72 75  .[uwf]: /doc/tru
15d0: 6e 6b 2f 64 6f 63 2f 75 77 66 6f 63 61 6c 2d 6d  nk/doc/uwfocal-m
15e0: 61 6e 75 61 6c 2e 6d 64 0a 5a 20 61 63 65 65 62  anual.md.Z aceeb
15f0: 34 61 39 30 31 62 33 66 39 37 66 39 61 35 30 66  4a901b3f97f9a50f
1600: 61 64 37 31 32 30 34 36 31 34 34 0a              ad712046144.