home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 077.lha / Logo / README.1ST < prev    next >
Text File  |  1986-11-20  |  5KB  |  187 lines
  1.  
  2.                     AMIGA LOGO - 7/87
  3.  
  4.     This is a beta-test version of a port of LOGO
  5.     recently posted to Usenet, made to run on the AMIGA.
  6.  
  7.     Ported by:    Scott Evernden
  8.                 USENET:    seismo!harvard!m2c!applix!scott
  9.                 CIS:    73116,3451
  10.                 BIX:    s_evernden
  11.                 PLINK:    SCOTT E
  12.  
  13.  
  14. What's Here?
  15. ============
  16. These are the files included in this release of LOGO for Amiga:
  17.  
  18.     README.1ST    what you're reading right now.
  19.  
  20.     README        the original README from Lincoln-Sudbury Regional HS.
  21.  
  22.     LOGO        the executable LOGO interpreter program.
  23.  
  24.     LOGOMAN        the printer-ready LOGO manual.
  25.  
  26.     HELP        text file used for answering the LOGO "help" word.
  27.  
  28.     SPLITHELP    program to break logoman into pieces; see below.
  29.  
  30.     APPLEDIFF    description of differences from APPLE LOGO.
  31.  
  32.     INSTALL        an EXECUTE file to move these files into their places.
  33.  
  34.     F.LOGO G.LOGO HANOI.LOGO HOME.LOGO HOWIS.LOGO L.LOGO LAUGH.LOGO
  35.     LISTP.LOGO PICK.LOGO POLY.LOGO POS.LOGO QUEST.LOGO QUIZ1.LOGO
  36.     SETCURSOR.LOGO SETPOS.LOGO SETX.LOGO SETY.LOGO TOP.LOGO
  37.     TOWARDS.LOGO    
  38.                 LOGO procedure examples and utilities.
  39.  
  40.  
  41. Setting Up
  42. ==========
  43. Format a disk and name it LOGO
  44.  
  45.     1> FORMAT DRIVE DFn: NAME LOGO
  46.  
  47. Move all the above files onto this new disk.
  48.  
  49.     1> COPY #? TO LOGO:
  50.  
  51. Create some directories
  52.  
  53.     1> MAKEDIR LOGO:LIB
  54.     1> MAKEDIR LOGO:DOC
  55.  
  56. Move "logoman", "help", and "splithelp" into LOGO:DOC
  57.  
  58.     1> RENAME LOGO:LOGOMAN   LOGO:LIB/LOGOMAN
  59.     1> RENAME LOGO:SPLITHELP LOGO:LIB/SPLITHELP
  60.     1> RENAME LOGO:HELP      LOGO:LIB/HELP
  61.  
  62. All of the .LOGO files need to get moced into LOGO:LIB
  63.  
  64.     1> RENAME LOGO:xxx.LOGO    LOGO/LIB/xxx.LOGO
  65.  
  66. (The preceding commands can be found in the file "INSTALL" which you
  67. may EXECUTE).
  68.  
  69.  
  70. You may want to get a printout of the manual
  71.  
  72.     1> COPY LOGO:DOC/LOGOMAN TO PRT:
  73.  
  74. And if you want to use the LOGO "describe" command (prints excerpts
  75. from the manual), then do the following
  76.  
  77.     1> CD LOGO:DOC
  78.     1> SPLITHELP <LOGOMAN
  79.  
  80. this will produce a pile of short files, each describing a single LOGO
  81. command.
  82.  
  83.  
  84. How to Run This LOGO
  85. ====================
  86. From the CLI, merely incant:
  87.  
  88.     1> CD LOGO:
  89.     1> LOGO
  90.  
  91. The current version will, unfortunately, not work properly under
  92. the WorkBench.
  93.  
  94. Please refer to the "logoman" file for furthur information
  95. regarding the use of the LOGO language as implemented here.
  96.  
  97.  
  98. Notes Specifically About This AMIGA Version
  99. ===========================================
  100.  
  101. Turtle Graphics
  102. ---------------
  103. I (rather quickly) implemented turtle graphics via a seperate WorkBench
  104. window which appears whenever a graphics command is issued, or whenever
  105. the turtle is turned on via the
  106.  
  107.     ? turtle "dpy
  108.  
  109. command, or any other command affecting the turtle.  To sidestep certain
  110. user-interface issues not handled by the original LOGO system, I made this
  111. window fixed size, but it can be moved about like other windows.  It has a
  112. coordinate range from -200 to 200 in both X and Y. (Note that Y coordinates
  113. are approximated on the screen to preserve a square aspect ratio).  The
  114. program will sense if you are running an interlaced WorkBench, and modify
  115. internal factors accordingly.
  116.  
  117. The resulting turtle is somewhat feeble, and really ought to be done over
  118. with better attention to the AMIGA's capabilities.  For that matter, some
  119. Music, Speech, added Color, and Sprite capabilities wouldn't hurt, either.
  120.  
  121. Mathematics
  122. -----------
  123. This AMIGA version was compiled using the MANX 3.4a C compiler with
  124. short 32-bit floating point numbers.  The numeric range is not great.
  125. Numbers run from about -9.2e18 to 9.2e18, and can get only as small as
  126. about 1e-19.
  127.  
  128. Editor
  129. ------
  130. You can use the LOGO "edit" word to modify your procedures.  
  131.  
  132. The program looks to see if a file named "editor" can be opened;  if so,
  133. it reads the name of the editor to use from that file.  (If you happen
  134. to have the Manx SET command, LOGO will check for an EDITOR environment
  135. variable, for the heck of it).
  136.  
  137. Otherwise, if the "editor" file doesn't exit, then LOGO tries to use "ed".
  138.  
  139. You always edit a copy of the procedure file in RAM: under a temporary
  140. name starting with "logo..." and followed by some numbers (the task
  141. address).
  142.  
  143. Dos
  144. ---
  145. The "logoman" file describes a word, "unix", for accessing the Operating
  146. System.  AmigaDOS isn't Unix, so I changed it to "dos".  (I left "unix" as
  147. a synonym, though).
  148.  
  149. I also added a command to allow changing directories, "chdir".
  150.  
  151.  
  152. Pause and CBreak and Readchar and Keyp
  153. --------------------------------------
  154. Not sure how good they work; these should get fixed soon.
  155.  
  156. The keyboard "quit" key is Control-C; and the keyboard "interrupt" key is
  157. Control-D.  You have to type RETURN after hitting these.
  158.  
  159.  
  160. WorkBench
  161. ---------
  162. I wish I could make it work, but I've spent more time on trying to get it
  163. to work than on the rest of the system.  Perhaps some other more
  164. enterprising soul can to it.  Until then, LOGO needs to be run from a CLI.
  165.  
  166.  
  167. Final Words
  168. ===========
  169. I don't know LOGO.  I ported the code simply to contribute. If you find
  170. problems, then let me know, and I will try to do something about it.  I
  171. probably haven't tested out all the capabilities of this thing.
  172.  
  173. I hope it works OK.
  174.  
  175.  
  176. Oh, and the system may ask you to:
  177.  
  178.     Please submit a Logo bug report, telling what you typed,
  179.       and asking for a more specific error message.
  180.  
  181. I don't know who's supposed to get this bug report, so you can probably
  182. ignore it.  :-)
  183.  
  184. ======
  185. -scott
  186.  
  187.