home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Amos / AmosProPatch.LHA / AmosProMultiEnv / ReadMe.Doc < prev    next >
Encoding:
Text File  |  1992-02-26  |  6.7 KB  |  237 lines
  1.  
  2.  
  3.                 AMOSPro 1.12  Multi-Envoironment Patch V1.1
  4.                 -------------------------------------------
  5.  
  6.            Written By Paul Hickman (ph@doc.ic.ac.uk) - May 1994
  7.            ----------------------------------------------------
  8.  
  9.       Adapted from AMOS Multi-Envoironment Patch V1.1  for AMOS 1.36
  10.       --------------------------------------------------------------
  11.  
  12.  
  13.  
  14.  
  15. Disclaimer
  16. ----------
  17.  
  18.         The program PatchAMOSPro will modify your AMOSPro program.
  19.         I take no resposibility if it wreck's it - make sure you
  20.         have a backup.
  21.  
  22.         I also take no responsibilty explicitly, implicity, and all
  23.         that other legal crap if something else that you didn't want
  24.         to happen does, 'cos i'm still in an irresponsible mood!
  25.  
  26.  
  27.  
  28. Distribution
  29. ------------
  30.  
  31.         Whatever - modify / copy / hack to pieces. Please post me
  32.         back any improvements - these are among my first E programs,
  33.         so the sources can probably be improved.
  34.  
  35.  
  36. Files
  37. -----
  38.  
  39.         Install_AMOSProMultiEnv        The installer script
  40.  
  41.         AmosIcon                       An Icon To Load AMOSPro.
  42.         GetAMOSProEnv                  A Program to select an envoironment.
  43.         PatchAMOSPro                   A Program to modify AMOSPro file.
  44.         Readme.Doc                     This File.
  45.  
  46.         GetAMOSProEnv11.e              The Sources
  47.         PatchAMOSPro.e
  48.  
  49.  
  50.  
  51.  
  52. Requirements
  53. ------------
  54.  
  55.         AMOSPro V1.12 - NOT AMOSPro V1.0, or any othe version.
  56.         2 bytes are overwritten in the AMOS program file - they may
  57.         be at a different location in different versions of AMOS.
  58.  
  59.         ReqTools Library - Any version will probably work - I only
  60.         use the file requester.
  61.  
  62.  
  63.  
  64.  
  65. Overview
  66. --------
  67.  
  68.         When you load AMOSPro, it searches for one of the files:
  69.  
  70.         S:AMOSPro_Interpreter_Config
  71.         AMOS_ProSystem:S/AMOSPro_Interpreter_Config
  72.  
  73.  
  74.         And loads the first one it finds. These files contain your
  75.         AmosPro interpreter configuration (Suprisingly enough) which
  76.         contains the loaded extensions, number of bobs, copperlist
  77.         buffer size etc. Running PatchAMOSPro modifies AMOSPro so it
  78.         searches the files:
  79.  
  80.         T:AMOSPro_Interpreter_Config
  81.         S:AMOSPro_Interpreter_Config
  82.  
  83.  
  84.         GetAMOSProEnv opens a reqtools filerequester in the directory
  85.         AMOSPro_System:APSystem/Interpreter_Configs (Which is created
  86.         by the installer scripts). Initially this contains the file
  87.         Default.config. Whatever file you select here is copied to
  88.         T:AMOSPro_Interpreter_Config before AMOSPro is run hence 
  89.         becoming the configuration you use for that session.
  90.  
  91.  
  92.  
  93.  
  94.  
  95. Installation
  96. ------------
  97.  
  98.  
  99.         Just double click the installer icon and select your AMOSPro
  100.         System directory / disk.
  101.  
  102.         AMOSPro will be patched, the configs directory created, your
  103.         current configuration copied into it as the default, the
  104.         GetAMOSProEnv program is copied into the AMOSPro_System directory,
  105.         along with an iconx script to load AMOSPro via the selector.
  106.  
  107.  
  108.         AMOSPro can still be run with it's default config in S: by
  109.         double clicking on it's original icon.
  110.  
  111.  
  112.  
  113.  
  114. Usage
  115. -----
  116.  
  117.         Double click on the "Amos Env-Loader" icon. Select An 
  118.         Envoironment.
  119.  
  120.  
  121.  
  122.  
  123. Multi-Selection
  124. ---------------
  125.  
  126.         To load AMOSPro with an AMOS program in the editor & run the
  127.         program, select the program's icon, then shift double-click
  128.         the "Amos Env-Loader" icon.
  129.  
  130.  
  131.  
  132.  
  133. Toolmanager
  134. -----------
  135.  
  136.         AMOSPro Multi-Env works great from a toolmanager dock window, or
  137.         toolmanager App Icon. Simply create an exec object to the Amos
  138.         script, of type CLI, which has the "Arguments" box checkmarked.
  139.         Then create an image object, and a dock / icon object to launch
  140.         it.
  141.  
  142.         To run AmosPro from toolmanger, click on the dock icon / app icon.
  143.         To load a file into AmosPro from toolmanager, drop the file on the
  144.         dock icon / app icon.
  145.  
  146.  
  147.  
  148.  
  149. Modifing Configurations
  150. -----------------------
  151.  
  152.         To modify a configuration, select "Set Interpreter" from the config
  153.         menu, then select "Load other configuration". Goto the directory
  154.         "AMOSPro_System/APSystem/Interpreter_Configs" and choose a
  155.         configuration to modify. Change it, then save it to a new file in
  156.         the same directory. End the filename in ".config" so it matches
  157.         the filer pattern "#?.config" in the GetAMOSProEnv filerequester.
  158.  
  159.         To not save/load the default configuration as this is not used
  160.         when loading AMOSPro via the Env-Loader. Instead, the 
  161.         Default.Config file is used for the default configuration.
  162.         
  163.  
  164.  
  165. Notes / Hints
  166. -------------
  167.  
  168.     
  169.         The AMOS 1.36 compiler uses the envoironment specified by it's
  170.         own configuration files - Not the envoironment you select
  171.         with this filerequester. I don't know what the AMOS Pro compiler
  172.         does, as I don't have it.
  173.  
  174.  
  175.         Get toolmanger, and use it - it's easily the best way to
  176.         load AMOSPro. If you do this set the save with icons option
  177.         in the configuration editor so your programs have
  178.         icons to drop on the toolmanager dock/app icon.
  179.  
  180.  
  181.  
  182. Credits
  183. -------
  184.  
  185.         GetAMOSProEnv, and PatchAMOSPro were both written in E. Thanks
  186.         go to Wouter van Oortmerssen for a rather nice language.
  187.  
  188.         Reqtools.library is written by Nico Francois.
  189.  
  190.         Toolmanager was written by Stefan Becker.
  191.  
  192.  
  193.         The E language, Reqtools & Toolmanager are all available
  194.         on aminet. Thanks also to whoever it was that posted to the
  195.         AMOS mailing list about removing/installing extenions for
  196.         the inspiration!
  197.  
  198.  
  199.  
  200.  
  201. Changes: AMOSMultiEnv V1.0 ---> V1.1
  202. ------------------------------------
  203.  
  204.     Both E programs now use exception handling for error
  205.     recovery, and print errors to requesters, not the command line.
  206.  
  207.     PatchAMOS can now accept the AMOS file to patch as a
  208.     command line argument.
  209.  
  210.     Both programs now accept the argument in double quotes.
  211.  
  212.     The installer script now creates a customised launching
  213.     script for your system - there is no "Amos" file in the
  214.     distribution anymore.
  215.  
  216.     The cancel button in the filerequester now cancels the
  217.     Loading of AMOS.
  218.  
  219.     Shift-Selected / Toolmanager / CLI arguments to the AMOS
  220.     script are passed on to AMOS1.36 so you can autoload & run
  221.     programs.
  222.  
  223.  
  224.  
  225.  
  226. Changes: AMOSMultiEnv V1.1 ---> AMOSProMultiEnv V1.1
  227. ----------------------------------------------------
  228.  
  229.     All file directory names in Installer Script, Readme file
  230.     and E programs changed to AMOSPro versions.
  231.  
  232.     PatchAMOSPro now changes the relevant bytes for AMOSPro V1.12
  233.  
  234.     The installer script now creates a directory for configs, and
  235.     copies your current default into it.
  236.  
  237.