Home » Archimedes archive » Acorn User » AU 1997-10 A.adf » Extras » Apple][e/PD/BOB/ARMBOB/doc/!BobDoc/Run

Apple][e/PD/BOB/ARMBOB/doc/!BobDoc/Run

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1997-10 A.adf » Extras
Filename: Apple][e/PD/BOB/ARMBOB/doc/!BobDoc/Run
Read OK:
File size: 0F5B bytes
Load address: 0000
Exec address: 0000
File contents
<TITLE>How to run ArmBob programs</TITLE>
<H2>How to run ArmBob programs</H2>
When the !Armbob application 
<IMG SRC="!Sprites#!ArmBob">
has been seen, or 
has been filer_booted, four new filetypes are defined:
<UL>
<LI><A HREF="#BobFile">
<IMG SRC="!Sprites#file_04a" ALT="filetype 04a" ALIGN=MIDDLE>
 BobFile</A>
<LI><A HREF="#BobTask">
<IMG SRC="!Sprites#file_04b" ALT="filetype 04b" ALIGN=MIDDLE>
 BobTask</A>
<LI><A HREF="#BobProj">
<IMG SRC="!Sprites#file_04c" ALT="filetype 04c" ALIGN=MIDDLE>
 BobProj</A>
<LI><A HREF="#BobPTask">
<IMG SRC="!Sprites#file_04d" ALT="filetype 04d" ALIGN=MIDDLE>
 BobPTask</A><BR>
</UL>
Double-clicking on files of these types will cause them to run.
Files of any of these types can be edited by holding down SHIFT and 
double clicking on them. They can be created initially as text files, 
with their filetypes altered later from the filer menu, or as blank 
files of the appropriate type, created by filling in the filetype 
in the blank option of Edit's <EM>Create </EM> Submenu from the
iconbar.
<P>
Double clicking <KBD>!ArmBob </KBD> 
<IMG SRC="!Sprites#!ArmBob" ALT="">
sets up the BobFile, TaskBob, BobProj and BobPTask 
filetypes and their run actions, and opens a filer window on a 
directory for holding Armbob programs. The path prefix to this 
directory is <KBD>Bob:</KBD>. It also turns off trace and debug
mode. To debug or trace it is more convenient to run the program 
in a taskwindow (just change the filetype). Debug or trace mode 
is enabled by double-clicking the relevant Obey files.
<P>
Armbob programs are run by first being compiled into an intermediate
code for a virtual stack-machine, which is then invoked to run the
code. Compiler errors cause a window to open with an error message.
Clicking on the <KBD>throwback </KBD> icon causes the relevant source file
to be displayed in an edit window, with the error line highlighted. 
Runtime errors do not do this (yet!).
<HR>
<H3>
<A NAME="BobFile">BobFile Programs </A>
<IMG SRC="!Sprites#file_04a" ALT="filetype 04a" ALIGN=MIDDLE>
</H3> 
BobFiles are analogous to Basic files. Double click on 
them to make them run (in a command window, unless a mode 
change command is given). Everything should be run from 
within the desktop. There is no Armbob equivalent to the 
Basic interface (with the Basic prompt &gt; ).
<HR>
<H3>
<A NAME="BobTask">BobTask Programs </A>
<IMG SRC="!Sprites#file_04b" ALT="filetype 04b" ALIGN=MIDDLE>
</H3>
BobTask files run in a taskwindow when double clicked. 
They are only appropriate for programs with textual 
input and output. For graphics use a BobFile.
<HR>
<H3>
<A NAME="BobProj">BobProj Programs </A>
<IMG SRC="!Sprites#file_04c" ALT="filetype 04c" ALIGN=MIDDLE>
</H3>
BobProj files are appropriate for large programs 
stretching over many files. They contain a list of 
the program files (which might as well have the 
text filetype). Double click on a BobProj file to 
compile and run in a command window the program 
contained in the files that it lists.
Click here for the syntactic <A HREF="#rules"> rules </A>
for BobProj files.
<HR>
<H3>
<A NAME="BobPTask">BobPTask Programs </A>
<IMG SRC="!Sprites#file_04d" ALT="filetype 04d" ALIGN=MIDDLE>
</H3>
BobPTask files are appropriate for large programs 
stretching over many files. They contain a list of 
the program files (which might as well have the 
text filetype).  Double click on a BobPTask file to 
compile and run in a taskwindow the program 
contained in the files that it lists.
Click here for the syntactic <A HREF="#rules"> rules </A>
for BobPTask files.
<HR>
<H4>
<A NAME="rules">Rules for Project Files</A>
</H4>
<UL>
<LI>Lines whose first non blank character is | are comments.
<LI>Non comment lines should have the pathname of a file for first
   word. Blank lines are permitted (version 2.1 onwards).
<LI>Files which create an instance object of a class must be preceded
   by files defining the class.
</UL>
00000000  3c 54 49 54 4c 45 3e 48  6f 77 20 74 6f 20 72 75  |<TITLE>How to ru|
00000010  6e 20 41 72 6d 42 6f 62  20 70 72 6f 67 72 61 6d  |n ArmBob program|
00000020  73 3c 2f 54 49 54 4c 45  3e 0a 3c 48 32 3e 48 6f  |s</TITLE>.<H2>Ho|
00000030  77 20 74 6f 20 72 75 6e  20 41 72 6d 42 6f 62 20  |w to run ArmBob |
00000040  70 72 6f 67 72 61 6d 73  3c 2f 48 32 3e 0a 57 68  |programs</H2>.Wh|
00000050  65 6e 20 74 68 65 20 21  41 72 6d 62 6f 62 20 61  |en the !Armbob a|
00000060  70 70 6c 69 63 61 74 69  6f 6e 20 0a 3c 49 4d 47  |pplication .<IMG|
00000070  20 53 52 43 3d 22 21 53  70 72 69 74 65 73 23 21  | SRC="!Sprites#!|
00000080  41 72 6d 42 6f 62 22 3e  0a 68 61 73 20 62 65 65  |ArmBob">.has bee|
00000090  6e 20 73 65 65 6e 2c 20  6f 72 20 0a 68 61 73 20  |n seen, or .has |
000000a0  62 65 65 6e 20 66 69 6c  65 72 5f 62 6f 6f 74 65  |been filer_boote|
000000b0  64 2c 20 66 6f 75 72 20  6e 65 77 20 66 69 6c 65  |d, four new file|
000000c0  74 79 70 65 73 20 61 72  65 20 64 65 66 69 6e 65  |types are define|
000000d0  64 3a 0a 3c 55 4c 3e 0a  3c 4c 49 3e 3c 41 20 48  |d:.<UL>.<LI><A H|
000000e0  52 45 46 3d 22 23 42 6f  62 46 69 6c 65 22 3e 0a  |REF="#BobFile">.|
000000f0  3c 49 4d 47 20 53 52 43  3d 22 21 53 70 72 69 74  |<IMG SRC="!Sprit|
00000100  65 73 23 66 69 6c 65 5f  30 34 61 22 20 41 4c 54  |es#file_04a" ALT|
00000110  3d 22 66 69 6c 65 74 79  70 65 20 30 34 61 22 20  |="filetype 04a" |
00000120  41 4c 49 47 4e 3d 4d 49  44 44 4c 45 3e 0a 20 42  |ALIGN=MIDDLE>. B|
00000130  6f 62 46 69 6c 65 3c 2f  41 3e 0a 3c 4c 49 3e 3c  |obFile</A>.<LI><|
00000140  41 20 48 52 45 46 3d 22  23 42 6f 62 54 61 73 6b  |A HREF="#BobTask|
00000150  22 3e 0a 3c 49 4d 47 20  53 52 43 3d 22 21 53 70  |">.<IMG SRC="!Sp|
00000160  72 69 74 65 73 23 66 69  6c 65 5f 30 34 62 22 20  |rites#file_04b" |
00000170  41 4c 54 3d 22 66 69 6c  65 74 79 70 65 20 30 34  |ALT="filetype 04|
00000180  62 22 20 41 4c 49 47 4e  3d 4d 49 44 44 4c 45 3e  |b" ALIGN=MIDDLE>|
00000190  0a 20 42 6f 62 54 61 73  6b 3c 2f 41 3e 0a 3c 4c  |. BobTask</A>.<L|
000001a0  49 3e 3c 41 20 48 52 45  46 3d 22 23 42 6f 62 50  |I><A HREF="#BobP|
000001b0  72 6f 6a 22 3e 0a 3c 49  4d 47 20 53 52 43 3d 22  |roj">.<IMG SRC="|
000001c0  21 53 70 72 69 74 65 73  23 66 69 6c 65 5f 30 34  |!Sprites#file_04|
000001d0  63 22 20 41 4c 54 3d 22  66 69 6c 65 74 79 70 65  |c" ALT="filetype|
000001e0  20 30 34 63 22 20 41 4c  49 47 4e 3d 4d 49 44 44  | 04c" ALIGN=MIDD|
000001f0  4c 45 3e 0a 20 42 6f 62  50 72 6f 6a 3c 2f 41 3e  |LE>. BobProj</A>|
00000200  0a 3c 4c 49 3e 3c 41 20  48 52 45 46 3d 22 23 42  |.<LI><A HREF="#B|
00000210  6f 62 50 54 61 73 6b 22  3e 0a 3c 49 4d 47 20 53  |obPTask">.<IMG S|
00000220  52 43 3d 22 21 53 70 72  69 74 65 73 23 66 69 6c  |RC="!Sprites#fil|
00000230  65 5f 30 34 64 22 20 41  4c 54 3d 22 66 69 6c 65  |e_04d" ALT="file|
00000240  74 79 70 65 20 30 34 64  22 20 41 4c 49 47 4e 3d  |type 04d" ALIGN=|
00000250  4d 49 44 44 4c 45 3e 0a  20 42 6f 62 50 54 61 73  |MIDDLE>. BobPTas|
00000260  6b 3c 2f 41 3e 3c 42 52  3e 0a 3c 2f 55 4c 3e 0a  |k</A><BR>.</UL>.|
00000270  44 6f 75 62 6c 65 2d 63  6c 69 63 6b 69 6e 67 20  |Double-clicking |
00000280  6f 6e 20 66 69 6c 65 73  20 6f 66 20 74 68 65 73  |on files of thes|
00000290  65 20 74 79 70 65 73 20  77 69 6c 6c 20 63 61 75  |e types will cau|
000002a0  73 65 20 74 68 65 6d 20  74 6f 20 72 75 6e 2e 0a  |se them to run..|
000002b0  46 69 6c 65 73 20 6f 66  20 61 6e 79 20 6f 66 20  |Files of any of |
000002c0  74 68 65 73 65 20 74 79  70 65 73 20 63 61 6e 20  |these types can |
000002d0  62 65 20 65 64 69 74 65  64 20 62 79 20 68 6f 6c  |be edited by hol|
000002e0  64 69 6e 67 20 64 6f 77  6e 20 53 48 49 46 54 20  |ding down SHIFT |
000002f0  61 6e 64 20 0a 64 6f 75  62 6c 65 20 63 6c 69 63  |and .double clic|
00000300  6b 69 6e 67 20 6f 6e 20  74 68 65 6d 2e 20 54 68  |king on them. Th|
00000310  65 79 20 63 61 6e 20 62  65 20 63 72 65 61 74 65  |ey can be create|
00000320  64 20 69 6e 69 74 69 61  6c 6c 79 20 61 73 20 74  |d initially as t|
00000330  65 78 74 20 66 69 6c 65  73 2c 20 0a 77 69 74 68  |ext files, .with|
00000340  20 74 68 65 69 72 20 66  69 6c 65 74 79 70 65 73  | their filetypes|
00000350  20 61 6c 74 65 72 65 64  20 6c 61 74 65 72 20 66  | altered later f|
00000360  72 6f 6d 20 74 68 65 20  66 69 6c 65 72 20 6d 65  |rom the filer me|
00000370  6e 75 2c 20 6f 72 20 61  73 20 62 6c 61 6e 6b 20  |nu, or as blank |
00000380  0a 66 69 6c 65 73 20 6f  66 20 74 68 65 20 61 70  |.files of the ap|
00000390  70 72 6f 70 72 69 61 74  65 20 74 79 70 65 2c 20  |propriate type, |
000003a0  63 72 65 61 74 65 64 20  62 79 20 66 69 6c 6c 69  |created by filli|
000003b0  6e 67 20 69 6e 20 74 68  65 20 66 69 6c 65 74 79  |ng in the filety|
000003c0  70 65 20 0a 69 6e 20 74  68 65 20 62 6c 61 6e 6b  |pe .in the blank|
000003d0  20 6f 70 74 69 6f 6e 20  6f 66 20 45 64 69 74 27  | option of Edit'|
000003e0  73 20 3c 45 4d 3e 43 72  65 61 74 65 20 3c 2f 45  |s <EM>Create </E|
000003f0  4d 3e 20 53 75 62 6d 65  6e 75 20 66 72 6f 6d 20  |M> Submenu from |
00000400  74 68 65 0a 69 63 6f 6e  62 61 72 2e 0a 3c 50 3e  |the.iconbar..<P>|
00000410  0a 44 6f 75 62 6c 65 20  63 6c 69 63 6b 69 6e 67  |.Double clicking|
00000420  20 3c 4b 42 44 3e 21 41  72 6d 42 6f 62 20 3c 2f  | <KBD>!ArmBob </|
00000430  4b 42 44 3e 20 0a 3c 49  4d 47 20 53 52 43 3d 22  |KBD> .<IMG SRC="|
00000440  21 53 70 72 69 74 65 73  23 21 41 72 6d 42 6f 62  |!Sprites#!ArmBob|
00000450  22 20 41 4c 54 3d 22 22  3e 0a 73 65 74 73 20 75  |" ALT="">.sets u|
00000460  70 20 74 68 65 20 42 6f  62 46 69 6c 65 2c 20 54  |p the BobFile, T|
00000470  61 73 6b 42 6f 62 2c 20  42 6f 62 50 72 6f 6a 20  |askBob, BobProj |
00000480  61 6e 64 20 42 6f 62 50  54 61 73 6b 20 0a 66 69  |and BobPTask .fi|
00000490  6c 65 74 79 70 65 73 20  61 6e 64 20 74 68 65 69  |letypes and thei|
000004a0  72 20 72 75 6e 20 61 63  74 69 6f 6e 73 2c 20 61  |r run actions, a|
000004b0  6e 64 20 6f 70 65 6e 73  20 61 20 66 69 6c 65 72  |nd opens a filer|
000004c0  20 77 69 6e 64 6f 77 20  6f 6e 20 61 20 0a 64 69  | window on a .di|
000004d0  72 65 63 74 6f 72 79 20  66 6f 72 20 68 6f 6c 64  |rectory for hold|
000004e0  69 6e 67 20 41 72 6d 62  6f 62 20 70 72 6f 67 72  |ing Armbob progr|
000004f0  61 6d 73 2e 20 54 68 65  20 70 61 74 68 20 70 72  |ams. The path pr|
00000500  65 66 69 78 20 74 6f 20  74 68 69 73 20 0a 64 69  |efix to this .di|
00000510  72 65 63 74 6f 72 79 20  69 73 20 3c 4b 42 44 3e  |rectory is <KBD>|
00000520  42 6f 62 3a 3c 2f 4b 42  44 3e 2e 20 49 74 20 61  |Bob:</KBD>. It a|
00000530  6c 73 6f 20 74 75 72 6e  73 20 6f 66 66 20 74 72  |lso turns off tr|
00000540  61 63 65 20 61 6e 64 20  64 65 62 75 67 0a 6d 6f  |ace and debug.mo|
00000550  64 65 2e 20 54 6f 20 64  65 62 75 67 20 6f 72 20  |de. To debug or |
00000560  74 72 61 63 65 20 69 74  20 69 73 20 6d 6f 72 65  |trace it is more|
00000570  20 63 6f 6e 76 65 6e 69  65 6e 74 20 74 6f 20 72  | convenient to r|
00000580  75 6e 20 74 68 65 20 70  72 6f 67 72 61 6d 20 0a  |un the program .|
00000590  69 6e 20 61 20 74 61 73  6b 77 69 6e 64 6f 77 20  |in a taskwindow |
000005a0  28 6a 75 73 74 20 63 68  61 6e 67 65 20 74 68 65  |(just change the|
000005b0  20 66 69 6c 65 74 79 70  65 29 2e 20 44 65 62 75  | filetype). Debu|
000005c0  67 20 6f 72 20 74 72 61  63 65 20 6d 6f 64 65 20  |g or trace mode |
000005d0  0a 69 73 20 65 6e 61 62  6c 65 64 20 62 79 20 64  |.is enabled by d|
000005e0  6f 75 62 6c 65 2d 63 6c  69 63 6b 69 6e 67 20 74  |ouble-clicking t|
000005f0  68 65 20 72 65 6c 65 76  61 6e 74 20 4f 62 65 79  |he relevant Obey|
00000600  20 66 69 6c 65 73 2e 0a  3c 50 3e 0a 41 72 6d 62  | files..<P>.Armb|
00000610  6f 62 20 70 72 6f 67 72  61 6d 73 20 61 72 65 20  |ob programs are |
00000620  72 75 6e 20 62 79 20 66  69 72 73 74 20 62 65 69  |run by first bei|
00000630  6e 67 20 63 6f 6d 70 69  6c 65 64 20 69 6e 74 6f  |ng compiled into|
00000640  20 61 6e 20 69 6e 74 65  72 6d 65 64 69 61 74 65  | an intermediate|
00000650  0a 63 6f 64 65 20 66 6f  72 20 61 20 76 69 72 74  |.code for a virt|
00000660  75 61 6c 20 73 74 61 63  6b 2d 6d 61 63 68 69 6e  |ual stack-machin|
00000670  65 2c 20 77 68 69 63 68  20 69 73 20 74 68 65 6e  |e, which is then|
00000680  20 69 6e 76 6f 6b 65 64  20 74 6f 20 72 75 6e 20  | invoked to run |
00000690  74 68 65 0a 63 6f 64 65  2e 20 43 6f 6d 70 69 6c  |the.code. Compil|
000006a0  65 72 20 65 72 72 6f 72  73 20 63 61 75 73 65 20  |er errors cause |
000006b0  61 20 77 69 6e 64 6f 77  20 74 6f 20 6f 70 65 6e  |a window to open|
000006c0  20 77 69 74 68 20 61 6e  20 65 72 72 6f 72 20 6d  | with an error m|
000006d0  65 73 73 61 67 65 2e 0a  43 6c 69 63 6b 69 6e 67  |essage..Clicking|
000006e0  20 6f 6e 20 74 68 65 20  3c 4b 42 44 3e 74 68 72  | on the <KBD>thr|
000006f0  6f 77 62 61 63 6b 20 3c  2f 4b 42 44 3e 20 69 63  |owback </KBD> ic|
00000700  6f 6e 20 63 61 75 73 65  73 20 74 68 65 20 72 65  |on causes the re|
00000710  6c 65 76 61 6e 74 20 73  6f 75 72 63 65 20 66 69  |levant source fi|
00000720  6c 65 0a 74 6f 20 62 65  20 64 69 73 70 6c 61 79  |le.to be display|
00000730  65 64 20 69 6e 20 61 6e  20 65 64 69 74 20 77 69  |ed in an edit wi|
00000740  6e 64 6f 77 2c 20 77 69  74 68 20 74 68 65 20 65  |ndow, with the e|
00000750  72 72 6f 72 20 6c 69 6e  65 20 68 69 67 68 6c 69  |rror line highli|
00000760  67 68 74 65 64 2e 20 0a  52 75 6e 74 69 6d 65 20  |ghted. .Runtime |
00000770  65 72 72 6f 72 73 20 64  6f 20 6e 6f 74 20 64 6f  |errors do not do|
00000780  20 74 68 69 73 20 28 79  65 74 21 29 2e 0a 3c 48  | this (yet!)..<H|
00000790  52 3e 0a 3c 48 33 3e 0a  3c 41 20 4e 41 4d 45 3d  |R>.<H3>.<A NAME=|
000007a0  22 42 6f 62 46 69 6c 65  22 3e 42 6f 62 46 69 6c  |"BobFile">BobFil|
000007b0  65 20 50 72 6f 67 72 61  6d 73 20 3c 2f 41 3e 0a  |e Programs </A>.|
000007c0  3c 49 4d 47 20 53 52 43  3d 22 21 53 70 72 69 74  |<IMG SRC="!Sprit|
000007d0  65 73 23 66 69 6c 65 5f  30 34 61 22 20 41 4c 54  |es#file_04a" ALT|
000007e0  3d 22 66 69 6c 65 74 79  70 65 20 30 34 61 22 20  |="filetype 04a" |
000007f0  41 4c 49 47 4e 3d 4d 49  44 44 4c 45 3e 0a 3c 2f  |ALIGN=MIDDLE>.</|
00000800  48 33 3e 20 0a 42 6f 62  46 69 6c 65 73 20 61 72  |H3> .BobFiles ar|
00000810  65 20 61 6e 61 6c 6f 67  6f 75 73 20 74 6f 20 42  |e analogous to B|
00000820  61 73 69 63 20 66 69 6c  65 73 2e 20 44 6f 75 62  |asic files. Doub|
00000830  6c 65 20 63 6c 69 63 6b  20 6f 6e 20 0a 74 68 65  |le click on .the|
00000840  6d 20 74 6f 20 6d 61 6b  65 20 74 68 65 6d 20 72  |m to make them r|
00000850  75 6e 20 28 69 6e 20 61  20 63 6f 6d 6d 61 6e 64  |un (in a command|
00000860  20 77 69 6e 64 6f 77 2c  20 75 6e 6c 65 73 73 20  | window, unless |
00000870  61 20 6d 6f 64 65 20 0a  63 68 61 6e 67 65 20 63  |a mode .change c|
00000880  6f 6d 6d 61 6e 64 20 69  73 20 67 69 76 65 6e 29  |ommand is given)|
00000890  2e 20 45 76 65 72 79 74  68 69 6e 67 20 73 68 6f  |. Everything sho|
000008a0  75 6c 64 20 62 65 20 72  75 6e 20 66 72 6f 6d 20  |uld be run from |
000008b0  0a 77 69 74 68 69 6e 20  74 68 65 20 64 65 73 6b  |.within the desk|
000008c0  74 6f 70 2e 20 54 68 65  72 65 20 69 73 20 6e 6f  |top. There is no|
000008d0  20 41 72 6d 62 6f 62 20  65 71 75 69 76 61 6c 65  | Armbob equivale|
000008e0  6e 74 20 74 6f 20 74 68  65 20 0a 42 61 73 69 63  |nt to the .Basic|
000008f0  20 69 6e 74 65 72 66 61  63 65 20 28 77 69 74 68  | interface (with|
00000900  20 74 68 65 20 42 61 73  69 63 20 70 72 6f 6d 70  | the Basic promp|
00000910  74 20 26 67 74 3b 20 29  2e 0a 3c 48 52 3e 0a 3c  |t &gt; )..<HR>.<|
00000920  48 33 3e 0a 3c 41 20 4e  41 4d 45 3d 22 42 6f 62  |H3>.<A NAME="Bob|
00000930  54 61 73 6b 22 3e 42 6f  62 54 61 73 6b 20 50 72  |Task">BobTask Pr|
00000940  6f 67 72 61 6d 73 20 3c  2f 41 3e 0a 3c 49 4d 47  |ograms </A>.<IMG|
00000950  20 53 52 43 3d 22 21 53  70 72 69 74 65 73 23 66  | SRC="!Sprites#f|
00000960  69 6c 65 5f 30 34 62 22  20 41 4c 54 3d 22 66 69  |ile_04b" ALT="fi|
00000970  6c 65 74 79 70 65 20 30  34 62 22 20 41 4c 49 47  |letype 04b" ALIG|
00000980  4e 3d 4d 49 44 44 4c 45  3e 0a 3c 2f 48 33 3e 0a  |N=MIDDLE>.</H3>.|
00000990  42 6f 62 54 61 73 6b 20  66 69 6c 65 73 20 72 75  |BobTask files ru|
000009a0  6e 20 69 6e 20 61 20 74  61 73 6b 77 69 6e 64 6f  |n in a taskwindo|
000009b0  77 20 77 68 65 6e 20 64  6f 75 62 6c 65 20 63 6c  |w when double cl|
000009c0  69 63 6b 65 64 2e 20 0a  54 68 65 79 20 61 72 65  |icked. .They are|
000009d0  20 6f 6e 6c 79 20 61 70  70 72 6f 70 72 69 61 74  | only appropriat|
000009e0  65 20 66 6f 72 20 70 72  6f 67 72 61 6d 73 20 77  |e for programs w|
000009f0  69 74 68 20 74 65 78 74  75 61 6c 20 0a 69 6e 70  |ith textual .inp|
00000a00  75 74 20 61 6e 64 20 6f  75 74 70 75 74 2e 20 46  |ut and output. F|
00000a10  6f 72 20 67 72 61 70 68  69 63 73 20 75 73 65 20  |or graphics use |
00000a20  61 20 42 6f 62 46 69 6c  65 2e 0a 3c 48 52 3e 0a  |a BobFile..<HR>.|
00000a30  3c 48 33 3e 0a 3c 41 20  4e 41 4d 45 3d 22 42 6f  |<H3>.<A NAME="Bo|
00000a40  62 50 72 6f 6a 22 3e 42  6f 62 50 72 6f 6a 20 50  |bProj">BobProj P|
00000a50  72 6f 67 72 61 6d 73 20  3c 2f 41 3e 0a 3c 49 4d  |rograms </A>.<IM|
00000a60  47 20 53 52 43 3d 22 21  53 70 72 69 74 65 73 23  |G SRC="!Sprites#|
00000a70  66 69 6c 65 5f 30 34 63  22 20 41 4c 54 3d 22 66  |file_04c" ALT="f|
00000a80  69 6c 65 74 79 70 65 20  30 34 63 22 20 41 4c 49  |iletype 04c" ALI|
00000a90  47 4e 3d 4d 49 44 44 4c  45 3e 0a 3c 2f 48 33 3e  |GN=MIDDLE>.</H3>|
00000aa0  0a 42 6f 62 50 72 6f 6a  20 66 69 6c 65 73 20 61  |.BobProj files a|
00000ab0  72 65 20 61 70 70 72 6f  70 72 69 61 74 65 20 66  |re appropriate f|
00000ac0  6f 72 20 6c 61 72 67 65  20 70 72 6f 67 72 61 6d  |or large program|
00000ad0  73 20 0a 73 74 72 65 74  63 68 69 6e 67 20 6f 76  |s .stretching ov|
00000ae0  65 72 20 6d 61 6e 79 20  66 69 6c 65 73 2e 20 54  |er many files. T|
00000af0  68 65 79 20 63 6f 6e 74  61 69 6e 20 61 20 6c 69  |hey contain a li|
00000b00  73 74 20 6f 66 20 0a 74  68 65 20 70 72 6f 67 72  |st of .the progr|
00000b10  61 6d 20 66 69 6c 65 73  20 28 77 68 69 63 68 20  |am files (which |
00000b20  6d 69 67 68 74 20 61 73  20 77 65 6c 6c 20 68 61  |might as well ha|
00000b30  76 65 20 74 68 65 20 0a  74 65 78 74 20 66 69 6c  |ve the .text fil|
00000b40  65 74 79 70 65 29 2e 20  44 6f 75 62 6c 65 20 63  |etype). Double c|
00000b50  6c 69 63 6b 20 6f 6e 20  61 20 42 6f 62 50 72 6f  |lick on a BobPro|
00000b60  6a 20 66 69 6c 65 20 74  6f 20 0a 63 6f 6d 70 69  |j file to .compi|
00000b70  6c 65 20 61 6e 64 20 72  75 6e 20 69 6e 20 61 20  |le and run in a |
00000b80  63 6f 6d 6d 61 6e 64 20  77 69 6e 64 6f 77 20 74  |command window t|
00000b90  68 65 20 70 72 6f 67 72  61 6d 20 0a 63 6f 6e 74  |he program .cont|
00000ba0  61 69 6e 65 64 20 69 6e  20 74 68 65 20 66 69 6c  |ained in the fil|
00000bb0  65 73 20 74 68 61 74 20  69 74 20 6c 69 73 74 73  |es that it lists|
00000bc0  2e 0a 43 6c 69 63 6b 20  68 65 72 65 20 66 6f 72  |..Click here for|
00000bd0  20 74 68 65 20 73 79 6e  74 61 63 74 69 63 20 3c  | the syntactic <|
00000be0  41 20 48 52 45 46 3d 22  23 72 75 6c 65 73 22 3e  |A HREF="#rules">|
00000bf0  20 72 75 6c 65 73 20 3c  2f 41 3e 0a 66 6f 72 20  | rules </A>.for |
00000c00  42 6f 62 50 72 6f 6a 20  66 69 6c 65 73 2e 0a 3c  |BobProj files..<|
00000c10  48 52 3e 0a 3c 48 33 3e  0a 3c 41 20 4e 41 4d 45  |HR>.<H3>.<A NAME|
00000c20  3d 22 42 6f 62 50 54 61  73 6b 22 3e 42 6f 62 50  |="BobPTask">BobP|
00000c30  54 61 73 6b 20 50 72 6f  67 72 61 6d 73 20 3c 2f  |Task Programs </|
00000c40  41 3e 0a 3c 49 4d 47 20  53 52 43 3d 22 21 53 70  |A>.<IMG SRC="!Sp|
00000c50  72 69 74 65 73 23 66 69  6c 65 5f 30 34 64 22 20  |rites#file_04d" |
00000c60  41 4c 54 3d 22 66 69 6c  65 74 79 70 65 20 30 34  |ALT="filetype 04|
00000c70  64 22 20 41 4c 49 47 4e  3d 4d 49 44 44 4c 45 3e  |d" ALIGN=MIDDLE>|
00000c80  0a 3c 2f 48 33 3e 0a 42  6f 62 50 54 61 73 6b 20  |.</H3>.BobPTask |
00000c90  66 69 6c 65 73 20 61 72  65 20 61 70 70 72 6f 70  |files are approp|
00000ca0  72 69 61 74 65 20 66 6f  72 20 6c 61 72 67 65 20  |riate for large |
00000cb0  70 72 6f 67 72 61 6d 73  20 0a 73 74 72 65 74 63  |programs .stretc|
00000cc0  68 69 6e 67 20 6f 76 65  72 20 6d 61 6e 79 20 66  |hing over many f|
00000cd0  69 6c 65 73 2e 20 54 68  65 79 20 63 6f 6e 74 61  |iles. They conta|
00000ce0  69 6e 20 61 20 6c 69 73  74 20 6f 66 20 0a 74 68  |in a list of .th|
00000cf0  65 20 70 72 6f 67 72 61  6d 20 66 69 6c 65 73 20  |e program files |
00000d00  28 77 68 69 63 68 20 6d  69 67 68 74 20 61 73 20  |(which might as |
00000d10  77 65 6c 6c 20 68 61 76  65 20 74 68 65 20 0a 74  |well have the .t|
00000d20  65 78 74 20 66 69 6c 65  74 79 70 65 29 2e 20 20  |ext filetype).  |
00000d30  44 6f 75 62 6c 65 20 63  6c 69 63 6b 20 6f 6e 20  |Double click on |
00000d40  61 20 42 6f 62 50 54 61  73 6b 20 66 69 6c 65 20  |a BobPTask file |
00000d50  74 6f 20 0a 63 6f 6d 70  69 6c 65 20 61 6e 64 20  |to .compile and |
00000d60  72 75 6e 20 69 6e 20 61  20 74 61 73 6b 77 69 6e  |run in a taskwin|
00000d70  64 6f 77 20 74 68 65 20  70 72 6f 67 72 61 6d 20  |dow the program |
00000d80  0a 63 6f 6e 74 61 69 6e  65 64 20 69 6e 20 74 68  |.contained in th|
00000d90  65 20 66 69 6c 65 73 20  74 68 61 74 20 69 74 20  |e files that it |
00000da0  6c 69 73 74 73 2e 0a 43  6c 69 63 6b 20 68 65 72  |lists..Click her|
00000db0  65 20 66 6f 72 20 74 68  65 20 73 79 6e 74 61 63  |e for the syntac|
00000dc0  74 69 63 20 3c 41 20 48  52 45 46 3d 22 23 72 75  |tic <A HREF="#ru|
00000dd0  6c 65 73 22 3e 20 72 75  6c 65 73 20 3c 2f 41 3e  |les"> rules </A>|
00000de0  0a 66 6f 72 20 42 6f 62  50 54 61 73 6b 20 66 69  |.for BobPTask fi|
00000df0  6c 65 73 2e 0a 3c 48 52  3e 0a 3c 48 34 3e 0a 3c  |les..<HR>.<H4>.<|
00000e00  41 20 4e 41 4d 45 3d 22  72 75 6c 65 73 22 3e 52  |A NAME="rules">R|
00000e10  75 6c 65 73 20 66 6f 72  20 50 72 6f 6a 65 63 74  |ules for Project|
00000e20  20 46 69 6c 65 73 3c 2f  41 3e 0a 3c 2f 48 34 3e  | Files</A>.</H4>|
00000e30  0a 3c 55 4c 3e 0a 3c 4c  49 3e 4c 69 6e 65 73 20  |.<UL>.<LI>Lines |
00000e40  77 68 6f 73 65 20 66 69  72 73 74 20 6e 6f 6e 20  |whose first non |
00000e50  62 6c 61 6e 6b 20 63 68  61 72 61 63 74 65 72 20  |blank character |
00000e60  69 73 20 7c 20 61 72 65  20 63 6f 6d 6d 65 6e 74  |is | are comment|
00000e70  73 2e 0a 3c 4c 49 3e 4e  6f 6e 20 63 6f 6d 6d 65  |s..<LI>Non comme|
00000e80  6e 74 20 6c 69 6e 65 73  20 73 68 6f 75 6c 64 20  |nt lines should |
00000e90  68 61 76 65 20 74 68 65  20 70 61 74 68 6e 61 6d  |have the pathnam|
00000ea0  65 20 6f 66 20 61 20 66  69 6c 65 20 66 6f 72 20  |e of a file for |
00000eb0  66 69 72 73 74 0a 20 20  20 77 6f 72 64 2e 20 42  |first.   word. B|
00000ec0  6c 61 6e 6b 20 6c 69 6e  65 73 20 61 72 65 20 70  |lank lines are p|
00000ed0  65 72 6d 69 74 74 65 64  20 28 76 65 72 73 69 6f  |ermitted (versio|
00000ee0  6e 20 32 2e 31 20 6f 6e  77 61 72 64 73 29 2e 0a  |n 2.1 onwards)..|
00000ef0  3c 4c 49 3e 46 69 6c 65  73 20 77 68 69 63 68 20  |<LI>Files which |
00000f00  63 72 65 61 74 65 20 61  6e 20 69 6e 73 74 61 6e  |create an instan|
00000f10  63 65 20 6f 62 6a 65 63  74 20 6f 66 20 61 20 63  |ce object of a c|
00000f20  6c 61 73 73 20 6d 75 73  74 20 62 65 20 70 72 65  |lass must be pre|
00000f30  63 65 64 65 64 0a 20 20  20 62 79 20 66 69 6c 65  |ceded.   by file|
00000f40  73 20 64 65 66 69 6e 69  6e 67 20 74 68 65 20 63  |s defining the c|
00000f50  6c 61 73 73 2e 0a 3c 2f  55 4c 3e                 |lass..</UL>|
00000f5b