home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / pascal / P_ROBOTS.ZIP / RE.ZOO / re.doc next >
Encoding:
Text File  |  1989-12-10  |  5.8 KB  |  199 lines
  1. RE - The Robot Editor for P-Robots and C-Robots
  2.  
  3.     BJ Gleason
  4.     Upsala College
  5.     Computer Science Department
  6.     Puder Hall
  7.     East Orange, NJ  07019
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12. I have been having my students use the P-ROBOTS and C-ROBOTS
  13. compiler for quite some time.  Their major complaint was that it
  14. wasn't an interactive environment like Turbo-Pascal or Quick-C. 
  15. They found the old edit/compile/debug/edit process tedious.
  16.  
  17. I obtained a copy of Borland's Turbo Pascal Editor Toolbox and
  18. modified their simple editor.  RE (Robot Editor) is the result. 
  19. It uses the Binary Editor from the Toolbox and adds some
  20. additional commands to make it work with the robot games.  You
  21. can edit your robot, and then compile it and run a game.  Once
  22. the game is completed, you are returned to the editor.
  23.  
  24. Since a lot of the work was done by Borland, this program is
  25. being distributed free of charge with no restriction of usage. 
  26. The source code is not available for distribution.
  27.  
  28. If you have any problems or suggestions, please feel free to
  29. write to me at the above address.
  30.  
  31. INSTALLATION
  32.  
  33. RE must be placed in the same directory as the compilers and the
  34. source files.  At present it will not search the dos path for the
  35. compilers.
  36.  
  37. The official names of the compilers used by the editor are:
  38.  
  39.         P-ROBOTS.EXE
  40.         C-ROBOTS.EXE
  41.  
  42. You might have to change the name of the compiler if is called
  43. something else, like CROBOTS.EXE.
  44.  
  45. The maximum filesize is 64k.  You will need at least 128k more
  46. memory than the compiler requires to use the editor and compiler
  47. together.
  48.  
  49.  
  50. USING RE
  51.  
  52. To run RE, use the same exact command line format you would use
  53. for the robot compiler of your choice and replace the name of the
  54. compiler with RE.  For example:
  55.  
  56.             P-ROBOTS KILLER M66 /M5
  57.     becomes
  58.             RE KILLER M66 /M5
  59.  
  60. This will load up the first file "KILLER" into the editor.  You
  61. may edit this file to your heart's content.  To compile and
  62. execute, press F9.  This will use the proper the compiler and
  63. play the game.  When the game is finished, you will be returned
  64. to the editor.
  65.  
  66. NOTE:When you press F9 to execute the compiler, the current
  67. copy of the file in the editor will over write the old
  68. copy on disk!
  69.  
  70. When the match is over, you can press any key to return to the
  71. editor.
  72.  
  73. Since RE is a separate program, it will not automatically move to
  74. a syntax error location like the Borland Products.
  75.  
  76. The editor uses the default extension '.PR', for a P-ROBOT
  77. program.  If editing for C-ROBOTS, be sure to include the '.R'
  78. extension.  If you do not use the '.R' extension, the editor will
  79. think you are editing a P-ROBOT file.
  80.  
  81. You should make sure that the first parameter after the command
  82. 'RE' is the name of the file you wish to edit.  While
  83.  
  84.         C-ROBOTS -m5 m66 sniper
  85.  
  86.     is legal, this will cause a problem if you use the editor
  87.  
  88.         RE -m5 m66 sniper
  89.  
  90. this will try to load a file called '-M5.PR'.  Make sure your
  91. robot program is the first parameter.  For the above example:
  92.  
  93.         RE m66 sniper -m5
  94.  
  95. will work proper and give the correct results.
  96.  
  97.  
  98. CHANGING THE COMMAND LINE PARAMETERS
  99.  
  100. After you start the editor, you can change the parameters passed
  101. on the command line at anytime by pressing F10.  This will
  102. display the current command line and allow you to edit them.  If
  103. you do not want to change it, press the RETURN key.  If you make
  104. a mistake and want to abandon the edits, press the ESC key.
  105.  
  106. You will only be able to edit the command line after the name of
  107. the robot you are editing.  If you entered the command line:
  108.  
  109.         RE KILLER M66 ROBO MIKE
  110.  
  111. you will be able to edit
  112.  
  113.         M66 ROBO MIKE
  114.  
  115. but not 'KILLER', since this is the name of the file you are
  116. editing.  To change the file, edit the editor and load a new
  117. file.
  118.  
  119. EXITING
  120.  
  121. The normal way of exiting is F2.  This will save a file only if
  122. any changes have been made to it.  This is similar to ^KD, but
  123. ^KD will always write the file to disk.  F2 only writes the file
  124. if it has changed since the last time it was written to disk, so
  125. it is typically a faster way to exit.  Remember, the file in
  126. memory is written to disk each time you invoke a compiler.  For
  127. convenience, ALT-X works the same as F2.
  128.  
  129.  
  130. EDITOR COMMANDS     
  131.  
  132.     ^S   LEFT    character left     
  133.     ^D   RIGHT    character right     
  134.     ^A           word left     
  135.     ^F           word right     
  136.     ^E   UP        line up     
  137.     ^X   DOWN    line down     
  138.     ^R   PGUP    page up
  139.     ^C   PGDN    page down
  140.     ^W        scroll up
  141.     ^Z        scroll down
  142.  
  143.  
  144.     ^L        repeats last ^QF or ^QA
  145.     ^P        insert control code
  146.     ^V           toggle Insert mode
  147.     ^T        delete word
  148.     ^Y           delete line
  149.     ^G   DEL    delete current character
  150.     ^M   RETURN    new line
  151.     ^N        insert new line
  152.     ^I   TAB    tab
  153.     ^H   BACKSPACE  delete character left
  154.  
  155.     ^QR  ^PGUP    Start of file
  156.     ^QC  ^PGDN    Bottom of file
  157.     ^QB        Beginning of block
  158.     ^QK        End of block
  159.     ^QF        Find
  160.     ^QA          Find and replace
  161.     ^QS  HOME    Beginning of line
  162.     ^QD  END    End of Line
  163.     ^QE  ^HOME    Top of screen
  164.     ^QX  ^END    Bottom of screen
  165.     ^Q0..^Q3    Jump to Marker 0..3
  166.     ^QY        Delete to end of line
  167.     ^QP        Previous cursor position
  168.     ^QL        Restore previous line
  169.  
  170.     ^KB  F7      Set block start marker.
  171.     ^KK  F8        Set block end marker.
  172.     ^KC          Copy marked block.
  173.     ^KV          Move marked block.
  174.     ^KY         Delete marked block.
  175.     ^KH        Hide block
  176.     ^KT        Mark current word as block
  177.     ^KW          Writes the marked block to a file.
  178.     ^KR          Reads a file to cursor
  179.     ^KP         Print block
  180.     ^KQ          Abandon file
  181.     ^K0..^K3    Set Marker 0..3
  182.     ^KD        Save and exit editor
  183.     
  184.     ^OI        Toggle autoindent mode
  185.     ^OT        Toggle fixed tab mode
  186.  
  187. ROBOT SPECIFIC COMMANDS
  188.  
  189.     F2   ALT-X    Exit, save if modified
  190.     F9        Compile and Execute robot compiler
  191.     F10        Modify command line parameters
  192.  
  193. ACKNOWLEDGEMENTS
  194.  
  195. Thanks to David Malmberg and Tom Poindexter for developing their
  196. wonderful robot programs.  Thanks to Larry Eklekamp for his help
  197. with the robot editor project.
  198.  
  199.