home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / acc / utility / chmeleon.doc < prev    next >
Encoding:
Text File  |  1990-10-07  |  6.1 KB  |  149 lines
  1.              The Chameleon  Vers. 1.17
  2.             ---------------------------
  3.                   Karsten Isakovic
  4.                 Wilmersdorferstr 82
  5.                    1000 Berlin 12
  6.                 All Rights reserved
  7.  
  8. Everybody know's the problems:
  9. ------------------------------
  10. - There's a lot of ACC's, you like to use, but you can not load all
  11.   at the same time. To install a new ACC you must boot your computer.
  12.   You can also use a MultiACC, that allowes the loading of some 
  13.   other special ACC-like programs, or some giant MonsterACC, that
  14.   have all the routines you will ever need under one ACC-Entry in
  15.   the Desktop-Menuline.  All those solutions have one big problem:
  16.   They need a lot of your Computers memory!
  17. - The developing of ACC' is a very nasty thing: For each test you
  18.   have to boot your computer - and if the acc is bombing, you are
  19.   in trouble...
  20.  
  21. Here is the answer to this problems:
  22. ------------------------------------
  23.   The CHAMELEON is a short ACC - less than 5kB - that can load every
  24.   other ACC at runtime, and - this is the clou - the loaded ACC can
  25.   be unload at runtime, without rebooting!  And its not only the RAM,
  26.   which was freed, all resources, that been used by the ACC was re-
  27.   leased too!
  28.  
  29. Using CHAMELEON
  30. ---------------
  31.   Copy the program CHMELEON.ACC on your bootdisk and boot your
  32.   computer.  Select the ACC-Entry 'The Chameleon' from the Desktop-
  33.   Menu. A fileselector will appear and you can choose the ACC you
  34.   want to install.
  35.  
  36.   In case you won't open the ACC at loadtime, press the left shiftkey
  37.   down when you select the ACC with a RETURN or doubleclick in the
  38.   fileselector.
  39.   
  40.   Once the ACC was loaded, the original entry appears in place of
  41.   the CHAMELEON-Entry.  The arrow in the begining of the Menuentry
  42.   shows, that this ACC was loaded with CHAMELEON.
  43.  
  44.   If the loaded ACC uses two ACC-Slots then the entry will be split
  45.   in the middle. If you press a shiftkey by selecting those double
  46.   ACC the right entry will be selected.  If the ACC uses three 
  47.   entries, left shift selects the middle, and right shift selects
  48.   the right part of the entry.
  49.   
  50.   Now you can use the ACC quite normal, and there is no difference
  51.   to, than you boot up with the loaded ACC!
  52.   
  53.   If you want to release the ACC, simply select the ACC-Entry from
  54.   the menuline and press the shift- and alternate-key at the same
  55.   time.  If the ACC has open windows, they will closed befor re-
  56.   leasing. All memory that been used from the ACC will be released
  57.   to, and the Chameleon-Entry appears again in the Desktop-menu.
  58.  
  59.   To install a new ACC at the time you release the old one, simply
  60.   hold down the right mousebutton, when releasing the old ACC.
  61.   When the old is released, the fileselector appears and you can
  62.   select the new ACC.
  63.     
  64. Patchvariables:
  65. ---------------
  66.   Please make a copy of CHMELEON.ACC to experiment with! All 
  67.   changes can be done with a diskmonitor-program. You can change 
  68.   the shiftkey kombinations of CHMELEON.ACC.
  69.   
  70.   Before the string 'V1.17 ©K.Isakovic Berlin 05.10.90' you find
  71.   a '^', which is the mark between the patchvariables.  It marks
  72.   the longest entry that will be possible.
  73.  
  74.   The first two bytes ($0A $02) in front of the '^' are the shift
  75.   kombination. The first byte ($0A) ist the kombination to release
  76.   a ACC, the second byte ($02) is the kombination for loading and
  77.   not opening the ACC. If you enter here a $00 then the loaded ACC 
  78.   is not automatical open by loading, except you press a shiftkey.
  79.   
  80.   The values that you can use are the hexadecimal sum of the values
  81.   from the table below:
  82.   
  83.       Value | Key
  84.      -------+--------
  85.        1    | right shift
  86.        2    | left shift
  87.        4    | control
  88.        8    | alternate
  89.  
  90.   The byte $0A correspond to leftshift + alternate key.
  91.  
  92.   In front of the shiftkey kombinations is the name of the default
  93.   acc the will be loaded when the computer is booted. If the first
  94.   byte after the '^' is $00, no default acc is load at boottime. 
  95.   Enter the name of the ACC you want to load (i.e A:\CONTROL.ACX)
  96.   The 'A:\' is replaced at boottime with the bootdrive. If there
  97.   is an other (i.e. C:\) this one will be used. Don't forget the
  98.   $00-byte at the end of the string!
  99.   
  100.   Before the default acc you can set the path, in which CHAMELEON
  101.   is searching for ACC's, in the same order than before.
  102.  
  103. Details:
  104. --------
  105.   You can use CHAMELEON with any TOS-Version that really exist,
  106.   because no illegal system variables are used. CHAMELEON use the
  107.   GEM and GEMDOS-Trap with XBRA-Id 'Cham',  the Traphandler is 
  108.   desinged to work with  68000 to 68030 microprozessors.
  109.  
  110.   For more details see the german documentation.
  111.  
  112. Known problems:
  113. ---------------
  114. - To prevent a splitted memory, release ACCs on the Desktop. Open
  115.   a textfile with the SHOW/PRINT-Command from the Desktop and 
  116.   show it a little time.  Now the Desktop organize his Memory and
  117.   the splitted memory is no problem!
  118. - Some reset-resistable RAM-Disks changes the MEMTOP-Variable. This
  119.   can not be restored by CHAMELEON!
  120. - If an ACC has no menu-entry, CHAMELEON set the Filename in the
  121.   Desktopmenu. Two Arrows will appear in front of the name. 
  122.  
  123. A tip:
  124. ------
  125.   Use two CHAMELEON's!  You need less than 11kB but you have always
  126.   the right ACC you need!
  127.  
  128.  
  129. **********************************************************************
  130.                                                                 
  131.   By the condition that the Files 
  132.                                                                 
  133.         CHMELEON.ACC    the program
  134.         CHMELEON.TXT    german doc's
  135.         CHMELEON.DOC    english doc's
  136.                                                                 
  137.  stay unchanged, 'The Chameleon' can be copied free for private use.
  138.  
  139.  All rights are reserved by the author, Karsten Isacovic
  140.  
  141.  A commercial use, included the distribution on public-domain-disk
  142.  or something else, is definitly not allowed.
  143.  
  144. Best regards, Karsten Isakovic
  145.  
  146. **********************************************************************
  147. (English doc's by Peter Hellinger)
  148.  
  149.