home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / comm / bbbbs-7.2.lha / BBBBS / BBBBS72.lha / libs / DOCS / rexxarplib.doc next >
Text File  |  1994-04-20  |  56KB  |  1,159 lines
  1. +----------------------------------------------------------------------+
  2. |                                                                      |
  3. |                  D I S C L A I M E R   N O T I C E                   |
  4. |                                                                      |
  5. |  This document and/or  portions of the material and  data furnished  |
  6. |  herewith,  was developed under sponsorship of the U.S. Government.  |
  7. |  Neither the U.S.  nor  the U.S.D.O.E.,  nor  the  Leland  Stanford  |
  8. |  Junior University, nor their employees,  nor their respective con-  |
  9. |  tractors, subcontractors, or their employees, makes  any warranty,  |
  10. |  express or implied, or assumes any liability or responsibility for  |
  11. |  accuracy,  completeness or  usefulness of any information, appara-  |
  12. |  tus, product or process disclosed, or represents that its use will  |
  13. |  not infringe privately-owned rights.  Mention of any product,  its  |
  14. |  manufacturer, or suppliers shall not, nor is it intended to, imply  |
  15. |  approval, disapproval, or fitness for any particular use. The U.S.  |
  16. |  and  the University at all times  retain the right to use and dis-  |
  17. |  seminate same for any purpose whatsoever.                           |
  18. |                                                                      |
  19. +----------------------------------------------------------------------+
  20.  
  21.  
  22.                     RexxArpLib.Library Version 3.3
  23.                     ==============================
  24.  
  25.                                 by
  26.  
  27.                           W.G.J. Langeveld
  28.                  Stanford Linear Accelerrator Center
  29.  
  30.              Copyright (C) 1988, 1989, 1990, 1992, 1993, 1994
  31.            The Trustees of the Leland Stanford Junior University
  32.  
  33.                         All Rights Reserved
  34.  
  35. Version 3.3:
  36. ------------
  37.  
  38.     This version of rexxarplib is released mainly because there is no
  39. reason not to. It doesn't add much beyond version 3.0.
  40.     The major new thing is a moderately useful List requester
  41. (see RequestList).
  42.     Also, a few small bugs were fixed. Under 2.0x and up,
  43. screenshare.library is now truely no longer needed - before, it would mess
  44. up some of the 3-D look if screenshare.library was not present even under
  45. 2.0.
  46.     Another function that always was present is now documented:
  47. SendParsed, which is sometimes useful.
  48.     This may be the last version of rexxarplib to be released.
  49.  
  50.         20 April 1994, WGL
  51.  
  52. Version 3.0:
  53. ------------
  54.  
  55.     This version of rexxarplib makes use of a lot of AmigaDOS 2.0
  56. features and has various bugs fixed and a few other enhancements. Yet, it is
  57. smaller than previous versions because it is now completely compiled using
  58. SAS/C version 5.10a.
  59.     Under AmigaDOS 2.0, rexxarplib will now use the ASL file requester
  60. rather than the ARP one. The GetFile() function acquired some new arguments
  61. in order to allow you to use most of the features of the ASL requester (such
  62. as specifying its size and adding pattern gadgets or setting it up as a
  63. directory requester or using multiple select). *NOTE*. Various features of
  64. the ASL file requester only work correctly under versions of AmigaDOS
  65. *after* 2.02. Some features may not appear to work at all in early versions
  66. of 2.0, one of them is the "NOFILES" option. If you definitely *want* to use
  67. the ARP file requester, you can, by specifying a flag.
  68.     There is a new function called GetFont() which brings up the new
  69. ASL font requester. It too has lots of options and arguments. The SetFont()
  70. function never worked correctly but should now be fixed. It has also acquired
  71. a few more arguments, to go with the font requester.
  72.     Furthermore, under AmigaDOS 2.0, you should no longer need
  73. screenshare.library (at least not for rexxarplib.library - other programs may
  74. still require it!). It uses 2.0 public screens everywhere. This also means
  75. that you can use rexxarplib functions to operate on other applications'
  76. screens (if they are AmigaDOS 2.0 public ones). Applications that still open
  77. screenshare shared screens are still supported: if screenshare.library is
  78. available and a requested public screen does not exist as a 2.0 public
  79. screen, rexxarplib will try to find a screenshare-style screen of that name.
  80. Under AmigaDOS 1.3, rexxarplib of course uses screenshare.library exclusively.
  81. Support was also added for the long missing BACKDROP flag to OpenWindow.
  82.     Rexxarplib.library uses as much as possible the 2.0 3-D look, though
  83. there are cases where it decides (based on the colors for example) to use a
  84. slightly different rendering. In order to support more of the new 2.0
  85. features, the number of arguments to OpenScreen has been increased. You can
  86. now specify the width and height, as well as the coordinates of the top-left
  87. corner, and you can give it AutoScroll and Overscan flags. You can make
  88. as large a screen as AmigaDOS 2.0 allows and scroll around for example. Also,
  89. a MoveScreen() function was added to allow moving screens around from ARexx.
  90.     Under 2.0 you can now specify "Workbench" as a Public Screen Name.
  91. This means that some functions (such as ScreenColor()) will now also work for
  92. the Workbench. For some reason, ShowTitle() does not which is just as well
  93. anyway.    The number of arguments to ScreenColor() was increased so you can set
  94. the colors of a screen without having to open a window on it and you can also
  95. determine the colors of the screen using this function.
  96.     This version has new Getenv() and Setenv() functions. These functions
  97. are now compatible with the 2.0 environment variable system and use the
  98. GetVar, SetVar and DeleteVar routines. If GetVar fails, it will fall back
  99. to the ARP Getenv function. Under 1.3, the behavior is the same as before.
  100.     There is a new flag argument with AddGadget() for string gadgets.
  101. One possible flag is RIDGEBORDER. This causes string gadgets to have the
  102. "standard" 2.0 three-dimensional border. This is not the default, because
  103. this type of border requires a little more space and might break ARexx
  104. programs that assume the size is as before. Another flag was added to
  105. allow the gadget to be defined as a NUMERIC gadget.
  106.     Other than that, gadgets on two-color screens should now have visible
  107. gadget borders (by default - it is still possible to change them) and the
  108. colors should default to the proper values for the screen the window opens
  109. up on. Note that under 2.0 the colors your application comes up with may
  110. be a little different from what you would have expected. You can adjust the
  111. colors by using the SetReqColor() function.
  112.     Bugs fixed: the Flood() routine ran *very* slowly because it didn't
  113. have a TmpRas. Now, a TmpRas is allocated before the Flood operation is
  114. actually done, and the function is orders of magnitude faster. This actually
  115. used to work correctly in an earlier version of rexxarplib but broke in one
  116. of the more recent ones. Under AmigaDOS 1.3 the colors that some requesters
  117. used could be random in certain conditions. The createhost function didn't
  118. check correctly whether there were any messages it had sent out that were not
  119. yet replied to before closing down. The FileList function used a construct
  120. that was not reentrant. A minor problem in PostMsg() was also fixed. A little
  121. bug in AddGadget was fixed which could potentially cause enforcer hits if
  122. certain arguments were left unspecified. All these should be fixed.
  123.     Many thanks to the various beta testers - you know who you are!
  124.  
  125.     25 April 1991, WGL
  126.  
  127.  
  128. Version 2.52:
  129. -------------
  130.  
  131.     This release was necessary to fix problems with AmigaDOS 2.0
  132. shared screens. As of version 1.45, screenshare.library supports 2.0-style
  133. shared screens, but the previous versions of rexxarplib contained code that
  134. would prevent some functions to work with such screens because they have
  135. slightly different properties. Do not forget to install the new
  136. screenshare.library in libs:.
  137.  
  138.     16 October 1990, WGL
  139.  
  140.  
  141. Version 2.5:
  142. ------------
  143.  
  144.     Minor update. Two bugs in the FileList function were fixed: the third
  145. argument wouldn't work right if there was a fourth, and the Noexpand option was
  146. broken in the previous version. A problem in the documentation of some of the
  147. screen functions (ScreenRows/Cols/Lace/Color/ToBack/ToFront) was corrected. A
  148. ShowTitle function was added. The Cr