home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / System / AslToRT / AslToRT.readme < prev    next >
Encoding:
Text File  |  2001-06-11  |  6.7 KB  |  182 lines
  1. Short:    Asl/Arp/Req/Intuition/RT requester to RT/Asl patcher
  2. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     util/misc
  5.  
  6. TITLE
  7.   AslToRT
  8.  
  9.  
  10. VERSION
  11.   39.3
  12.  
  13.  
  14. AUTHOR
  15.   Thore Böckelmann <tboeckel@uni-paderborn.de>
  16.  
  17.  
  18. REQUIREMENTS
  19.   Any Amiga® (compatible) computer with at least OS3.0 and
  20. 68020+ cpu.
  21.  
  22.  
  23. DESCRIPTION
  24.   AslToRT is a utility that is meant to replace RTPatch by Nico François, the
  25.   original author of the ReqTools package. RTPatch has several bugs when running
  26.   under OS3.x. It uses a very tricky mechanism to patch the desired libraries
  27.   only when they are opened. This causes a very annoying behavior with
  28.   asl.library. Under OS2.x this library kept its open counter equal to zero,
  29.   which is no longer the fact for OS3.x. As a result the library's name is
  30.   changed from "asl.library" to "asl.§ibrary", where the "§" stands for an
  31.   unprintable character. The effect is, that asl.library will be loaded again
  32.   and again, because it is no longer in memory with the correct name. This is
  33.   very bad in the way Amiga shared libraries are intended to work. So you have
  34.   no longer one copy of the library in memory, but several identical copies, of
  35.   which each eats up your machines memory.
  36.  
  37.   AslToRT does all the things that RTPatch does, but in a (hopefully) much
  38.   better way. Additionally you can choose very exactly which libraries and which
  39.   functions should be patched to use the apropriate ReqTools function.
  40.  
  41.   From version 39.2 on AslToRT can behave like a fictious program called
  42.   "RTToAsl", that means it can redirect all of reqtools' requesters to the
  43.   equivalent asl requesters. The desired work mode is selected by the new
  44.   PATCHMODE option.
  45.  
  46.  
  47. USAGE
  48.   You can start AslToRT from either Workbench or Shell with the following
  49.   options:
  50.  
  51.   ASLFILE/S,ASLFONT/S,ASLSCREEN/S,ASLALL/S,INTUIAUTOREQ/S,INTUIEASYREQ/S,
  52.   INTUIALL/S,REQFILE/S,REQFONT/S,REQLONG/S,REQSTRING/S,REQTEXT/S,REQCOLOR/S,
  53.   REQALL/S,ARPFILE/S,ARPALL/S,REQTOOLSFILE/S,REQTOOLSFONT/S,REQTOOLSSCREEN/S,
  54.   REQTOOLSALL/S,ALL/S,PATCHMODE,IGNOREHEIGHT/S
  55.  
  56.   ASLFILE/S: patch asl.library's file requesters
  57.   ASLFONT/S: patch asl.library's font requesters
  58.   ASLSCREEN/S: patch asl.library's screenmode requesters
  59.   ASLALL/S: patch all of asl.library's requesters
  60.   INTUIAUTOREQ/S: patch intuition.library/AutoRequest()
  61.   INTUIEASYREQ/S: patch intuition.library/EasyRequest()
  62.   INTUIALL/S: patch all of intuition.library's requesters
  63.   REQFILE/S: patch req.library's file requesters
  64.   REQFONT/S: patch req.library's font requesters
  65.   REQLONG/S: patch req.library/GetLong()
  66.   REQSTRING/S: patch req.library/GetString()
  67.   REQTEXT/S: patch req.library/TextRequest()
  68.   REQCOLOR/S: patch req.library/ColorRequest()
  69.   REQALL/S: patch all of req.library's requesters
  70.   ARPFILE/S: patch arp.library's file requesters
  71.   ARPALL/S: patch all of arp.library's requesters
  72.   REQTOOLSFILE/S: patch reqtools.library's file requesters
  73.   REQTOOLSFONT/S: patch reqtools.library's font requesters
  74.   REQTOOLSSCREEN/S: patch reqtools.library's screenmode requesters
  75.   REQTOOLSALL/S: patch all of reqtools.library's requesters
  76.   ALL/S: patch all requesters of every library (asl/arp/req/intuition/reqtools)
  77.   PATCHMODE: either ASL or REQTOOLS (default: REQTOOLS)
  78.   IGNOREHEIGHT/S: ignore the height of file/font/screenmode requesters and use
  79.     ReqTools' preferred window height
  80.  
  81.   You must specify at least one of these options, else AslToRT will exit
  82.   immediately without patching anything.
  83.  
  84.   You can start and quit AslToRT at any time. Only requesters allocated after
  85.   running AslToRT will be redirected to ReqTools. To quit AslToRT simply start
  86.   it again.
  87.  
  88.  
  89. INSTALLATION
  90.   Copy AslToRT where ever you want, but SYS:WBStartup is a very good place
  91.  
  92.  
  93. KNOWN BUGS
  94.   reqtools.library is not able to emulate all details of asl.library. Especially
  95.   the very new functionality introduced with asl.library V44 (OS3.9) cannot be
  96.   done with reqtools.
  97.  
  98.   Some requesters by intuition/AutoRequest() cannot be patched to
  99.   reqtools.library because they use some tricky mechanisms to place the text
  100.   within the window, which reqtools.library cannot do (i.e. the device info
  101.   requester of DiskSalv V2+).
  102.  
  103.   Most of Workbench's and dos.library's message requesters can be redirected to
  104.   reqtools.library, but some cannot. These are the requesters that are build by
  105.   intuition/BuildSysRequest() and intuition/BuildEasyRequest() and are displayed
  106.   asynchronously. Although reqtools.library itself can do the same thing it is
  107.   not possible to emulate intuiton.library's way by reqtools.library (i.e.
  108.   Workbench's Version/Copyright requester).
  109.  
  110.   Since version 39.2 you can redirect reqtools' requesters to asl, but the
  111.   asychronous requesters of reqtools cannot be emulated by asl, therefore these
  112.   requesters will not be redirected. But as it is very hard to find programs
  113.   using reqtools.library directly these days I assume this is not a very big
  114.   drawback.
  115.  
  116.   For those who are interested, AslToRT patches the following functions (if
  117.   enabled via options):
  118.  
  119.   asl.library:
  120.     AllocAslRequest()
  121.     FreeAslRequest()
  122.     AslRequest()
  123.  
  124.   intuition.library:
  125.     AutoRequest()
  126.     EasyRequestArgs()
  127.  
  128.   req.library:
  129.     FileRequester()
  130.     GetLong()
  131.     GetString()
  132.     NewGetString()
  133.     TextRequest()
  134.     ColorRequester()
  135.     ExtendedColorRequester()
  136.  
  137.   arp.library:
  138.     FileRequest()
  139.  
  140.   reqtools.library:
  141.     rtAllocRequest()
  142.     rtFreeRequest()
  143.     rtFreeFileList()
  144.     rtChangeReqAttr()
  145.     rtFileRequest()
  146.     rtFontRequest()
  147.     rtScreenModeRequest()
  148.  
  149.  
  150. HISTORY
  151.   39.1 (03.01.2001):
  152.     - initial Aminet release
  153.  
  154.   39.2 (10.05.2001):
  155.     - result for intuition/AutoRequest() was swapped. Fixed.
  156.     - added possibility to use AslToRT for redirection of reqtools requesters to
  157.       asl instead of vice versa.
  158.  
  159.   39.3 (11.06.2001):
  160.     - sometimes files didn't pass the filter functions because the current
  161.       directory wasn't set correctly. Thus WBPattern didn't allow to select any
  162.       file. This is fixed now. Thanks to Gerhard Pircher for his testing.
  163.     - system failure requesters are now centered on the screen
  164.     - rewrote TagList handling
  165.     - when using the same asl requester several times each requester had the
  166.       name of the first request set, instead of a new one. Thanks to Gernod
  167.       Schomberg for that hint.
  168.  
  169.  
  170. COPYRIGHT AND DISCLAIMER
  171.   AslToRT is copyrighted 2001 by Thore Böckelmann.
  172.   All rights reserved. This program is freeware, so no financial donations  
  173.   required. Redistribution allowed if the package is left unchanged. The author
  174.   is not responsible for any damage caused by the use or misuse of this
  175.   documentation and/or the program(s) it describes.
  176.  
  177.   AslToRT uses the SmartReadArgs package by Thomas Aglassinger.
  178.  
  179.  
  180. SEE ALSO
  181.   ReqTools 2.9 User package
  182.  
  183.