home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 22 / CD_ASCQ_22_0695.iso / win / prg / lb11wi / intro.txt < prev    next >
Text File  |  1995-04-02  |  8KB  |  209 lines
  1. Liberty BASIC introduction and installation notes.
  2. -------------------------------------------------------------------------
  3.  
  4. Thank you for trying Liberty BASIC!  Liberty BASIC is marketed as
  5. as shareware.  If you find this program useful, please register it.
  6. When you do you will receive the runtime engine, which will allow you
  7. distribute your programs without paying any royalties, and you will also
  8. receive the most recent version of this program.  See the file
  9. REGISTER.TXT.
  10.  
  11. This help system is based on the printed documentation.  You cannot actually
  12. type information into these help windows, but you can copy code out by
  13. highlighting it using the mouse, and then pulling down the Edit menu and
  14. selecting Copy.  This is useful when you want to try out a code example in
  15. these files without typing it all in.
  16.  
  17. Additionally, you can print any of these help files by pulling down the
  18. Functions menu and selecting print.  If you highlight the area you want to
  19. print using the mouse, then only that selected text will print.  Otherwise
  20. you will be asked if the entire text should be printed.
  21.  
  22. --------------------------------------------------------------------------
  23.  
  24.  
  25. System Requirements:
  26.  
  27.  
  28. Liberty BASIC is software for IBM AT compatible computers and
  29. requires the following hardware and software:
  30.  
  31.   One 286, 386, or 486 computer with at least 4 megabytes of RAM and
  32.   a hard drive with at least 2.5 megabytes of free space.  On machines
  33.   that only have 286 processors, more than 4 megabytes RAM is
  34.   preferred.  Microsoft Windows version 3.1 or 3.11, and a mouse.
  35.  
  36. - or -
  37.  
  38.   One 386 or 486 computer running OS/2 2.x or Warp and at least 6 megabytes
  39.   of RAM, and with at least 2.5 megabytes (more strongly recommended)
  40.   of free hard disk space.  Win/OS2 must be installed, and you must have
  41.   a mouse.
  42.  
  43.  
  44. INSTALLATION:
  45.  
  46.   Liberty BASIC includes a program INSTALL.EXE which you should run
  47.   from the Program Manager.  Just pull down the menu File, and
  48.   select the menu item Run.  Click on Browse and locate the INSTALL.EXE
  49.   program, and then run it.  Follow the instructions from there.
  50.  
  51.  
  52. Using Liberty BASIC  
  53.   
  54.   Liberty BASIC starts with a file browser window.  It is arranged as
  55.   four panes, three across the top, and one on the bottom like so:
  56.  
  57.   +--------------------------------------------------------------+
  58.   | -                  Liberty BASIC  c:\liberty             v ^ |
  59.   +--------------------------------------------------------------+
  60.   | a             [1]  | [..]          [2]  | demo.bas      [3]  |
  61.   | b                  | liberty            | read.bas           |
  62.   | c                  | msdos              | test.bas           |
  63.   |                    |                    |                    |
  64.   | select drive here  | select directory   | select file here   |
  65.   |                    | here               |                    |
  66.   +--------------------------------------------------------------+
  67.   |                                                         [4]  |
  68.   |                                                              |
  69.   |                                                              |
  70.   |                                                              |
  71.   |         see BASIC source code here                           |
  72.   |                                                              |
  73.   |                                                              |
  74.   |                                                              |
  75.   |                                                              |
  76.   +--------------------------------------------------------------+
  77.  
  78.  Select the drive to browse in pane [1], then select the directory
  79.  (usually liberty) to browse in pane [2], then finally the file to 
  80.  browse in pane [3].  When the .BAS file is selected, its source will 
  81.  be displayed in pane [4].  To run the program, position the cursor
  82.  inside of pane [3] and press the right hand mouse button and a menu
  83.  will appear.  Then select the item BASIC source editor, and a new
  84.  window will open which will contain a copy of the source for the
  85.  selected file.  Then position the cursor inside of that pane and again 
  86.  press the right hand mouse button for another menu.  There are two 
  87.  options available, Run and Debug.  Run compiles and runs the program, 
  88.  and Debug provides the additional benefit of a 3 level source level
  89.  debugger with optional watch window.
  90.  
  91.  If you want help, you can get this on-line by pulling down the Help
  92.  menu.   If you select a word in the source editor and then select help,
  93.  the system will try to find that word or command in the text.  When
  94.  the help window opens, pressing CTRL-F will also bring up a find
  95.  dialog box.
  96.  
  97. Your First Liberty BASIC Program:
  98.  
  99. Let's illustrate how to develop programs with Liberty BASIC.  This next
  100. program is often the first example given when teaching any programming
  101. language.
  102.  
  103. First use your mouse to select the hard drive onto which you installed
  104. Liberty BASIC (probably drive C:).  Next select the appropriate directory
  105. (probably \liberty) and a list of BASIC program files will appear as below.
  106.  
  107.  
  108.  
  109. {Illustration was here}
  110.  
  111.  
  112.  
  113. Now pull down the Files menu and select Create.  You will be asked for a
  114. filename for your new program.  Type hello, and then press the Enter key
  115. or click on OK.
  116.  
  117.  
  118.  
  119. {Illustration was here}
  120.  
  121.  
  122.  
  123. You will now be asked to confirm creation of your new program file.  Click
  124. on Yes or press the Enter key.  If you type it wrong, then click on No.
  125.  
  126.  
  127.  
  128. {Illustration was here}
  129.  
  130.  
  131.  
  132. Now press the Enter key a couple of times and press the Tab key.  Then type:
  133.  
  134.   print "hello world!"
  135.  
  136. Now use the mouse to point at the text you just typed and press the button
  137. on the right side of the mouse, and a menu will appear.  Your should see:
  138.  
  139.  
  140.  
  141. {Illustration was here}
  142.  
  143.  
  144.  
  145. Now you can point at the Run item and press the left-hand mouse button to
  146. run your program, or your can just press the 'R' key to accomplish the same
  147. thing.
  148.  
  149. You will see a window open and then at once another smaller window will open
  150. with a notice saying: Execution of hello.bas complete.  This second window
  151. blocks your view of the first, which contains the result of your program.
  152. Click on the OK button to remove the notice, and you'll be able to see it
  153. better.
  154.  
  155. Here is what your finished program should look like.
  156.  
  157.  
  158.  
  159. {Illustration was here}
  160.  
  161.  
  162.  
  163. Now close the window labeled:  Program named - 'hello.bas'.
  164.  
  165. Let's save hello.bas so that we can refer back to it later.  Pull down the
  166. File menu and select the Save option.  Your first program is now saved to
  167. disk.
  168.  
  169.  
  170.  
  171. {Illustration was here}
  172.  
  173.  
  174.  
  175. Running other Programs:
  176.  
  177. Let's try running one of the sample programs that comes with Liberty BASIC.
  178. Select the file named buttons1.bas and run it as shown below:
  179.  
  180.  
  181.  
  182. {Illustration was here}
  183.  
  184.  
  185.  
  186. A window will appear with some buttons:
  187.  
  188.   Three color buttons:  Red, Blue, and Green
  189.   Two shape buttons: Triangle and Square
  190.   One other button: Size
  191.  
  192. This program will display two different kinds of spirals, a triangular kind,
  193. and a square kind.  Three different color options are available: red, blue,
  194. and green.  Additionally, the program will let you decide how large to draw
  195. the spiral.
  196.  
  197. Play around a bit with it.  Experiment.
  198.  
  199.  
  200. {Illustration was here}
  201.  
  202.  
  203.  
  204. When you're all done, close the window.  Buttons1.bas will stop and ask for
  205. confirmation before it closes the window.
  206.  
  207.  
  208.  
  209.