home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / armbob / armbob_1 / ARMBOB / doc / !BobDoc / Run < prev    next >
Encoding:
Text File  |  1991-09-25  |  3.8 KB  |  99 lines
  1. <TITLE>How to run ArmBob programs</TITLE>
  2. <H2>How to run ArmBob programs</H2>
  3. When the !Armbob application 
  4. <IMG SRC="!Sprites#!ArmBob">
  5. has been seen, or 
  6. has been filer_booted, four new filetypes are defined:
  7. <UL>
  8. <LI><A HREF="#BobFile">
  9. <IMG SRC="!Sprites#file_04a" ALT="filetype 04a" ALIGN=MIDDLE>
  10.  BobFile</A>
  11. <LI><A HREF="#BobTask">
  12. <IMG SRC="!Sprites#file_04b" ALT="filetype 04b" ALIGN=MIDDLE>
  13.  BobTask</A>
  14. <LI><A HREF="#BobProj">
  15. <IMG SRC="!Sprites#file_04c" ALT="filetype 04c" ALIGN=MIDDLE>
  16.  BobProj</A>
  17. <LI><A HREF="#BobPTask">
  18. <IMG SRC="!Sprites#file_04d" ALT="filetype 04d" ALIGN=MIDDLE>
  19.  BobPTask</A><BR>
  20. </UL>
  21. Double-clicking on files of these types will cause them to run.
  22. Files of any of these types can be edited by holding down SHIFT and 
  23. double clicking on them. They can be created initially as text files, 
  24. with their filetypes altered later from the filer menu, or as blank 
  25. files of the appropriate type, created by filling in the filetype 
  26. in the blank option of Edit's <EM>Create </EM> Submenu from the
  27. iconbar.
  28. <P>
  29. Double clicking <KBD>!ArmBob </KBD> 
  30. <IMG SRC="!Sprites#!ArmBob" ALT="">
  31. sets up the BobFile, TaskBob, BobProj and BobPTask 
  32. filetypes and their run actions, and opens a filer window on a 
  33. directory for holding Armbob programs. The path prefix to this 
  34. directory is <KBD>Bob:</KBD>. It also turns off trace and debug
  35. mode. To debug or trace it is more convenient to run the program 
  36. in a taskwindow (just change the filetype). Debug or trace mode 
  37. is enabled by double-clicking the relevant Obey files.
  38. <P>
  39. Armbob programs are run by first being compiled into an intermediate
  40. code for a virtual stack-machine, which is then invoked to run the
  41. code. Compiler errors cause a window to open with an error message.
  42. Clicking on the <KBD>throwback </KBD> icon causes the relevant source file
  43. to be displayed in an edit window, with the error line highlighted. 
  44. Runtime errors do not do this (yet!).
  45. <HR>
  46. <H3>
  47. <A NAME="BobFile">BobFile Programs </A>
  48. <IMG SRC="!Sprites#file_04a" ALT="filetype 04a" ALIGN=MIDDLE>
  49. </H3> 
  50. BobFiles are analogous to Basic files. Double click on 
  51. them to make them run (in a command window, unless a mode 
  52. change command is given). Everything should be run from 
  53. within the desktop. There is no Armbob equivalent to the 
  54. Basic interface (with the Basic prompt > ).
  55. <HR>
  56. <H3>
  57. <A NAME="BobTask">BobTask Programs </A>
  58. <IMG SRC="!Sprites#file_04b" ALT="filetype 04b" ALIGN=MIDDLE>
  59. </H3>
  60. BobTask files run in a taskwindow when double clicked. 
  61. They are only appropriate for programs with textual 
  62. input and output. For graphics use a BobFile.
  63. <HR>
  64. <H3>
  65. <A NAME="BobProj">BobProj Programs </A>
  66. <IMG SRC="!Sprites#file_04c" ALT="filetype 04c" ALIGN=MIDDLE>
  67. </H3>
  68. BobProj files are appropriate for large programs 
  69. stretching over many files. They contain a list of 
  70. the program files (which might as well have the 
  71. text filetype). Double click on a BobProj file to 
  72. compile and run in a command window the program 
  73. contained in the files that it lists.
  74. Click here for the syntactic <A HREF="#rules"> rules </A>
  75. for BobProj files.
  76. <HR>
  77. <H3>
  78. <A NAME="BobPTask">BobPTask Programs </A>
  79. <IMG SRC="!Sprites#file_04d" ALT="filetype 04d" ALIGN=MIDDLE>
  80. </H3>
  81. BobPTask files are appropriate for large programs 
  82. stretching over many files. They contain a list of 
  83. the program files (which might as well have the 
  84. text filetype).  Double click on a BobPTask file to 
  85. compile and run in a taskwindow the program 
  86. contained in the files that it lists.
  87. Click here for the syntactic <A HREF="#rules"> rules </A>
  88. for BobPTask files.
  89. <HR>
  90. <H4>
  91. <A NAME="rules">Rules for Project Files</A>
  92. </H4>
  93. <UL>
  94. <LI>Lines whose first non blank character is | are comments.
  95. <LI>Non comment lines should have the pathname of a file for first
  96.    word. Blank lines are permitted (version 2.1 onwards).
  97. <LI>Files which create an instance object of a class must be preceded
  98.    by files defining the class.
  99. </UL>