Short: Fixes problem scripts in ARexxGuide2_0* Type: util/rexx Uploader: robin@halcyon.com Author: Robin Evans This patch includes the fixed scripts to replace those that were included in the 2_0 releases of ARexxGuide. Copy these scripts to the directory where you stored the original scripts for 2_0. The 2_0a release includes these fixed scripts along with some minor changes to the text in several nodes. ====================================== I feel a bit like David Letterman after the Madonna interview: I want to stare into the camera and say "I'm sorry. I'm sorry." Unlike that interview, though, there was nothing funny about what preceded this. The scripts in the two 2_0 releases of ARexxGuide had a number of problems. The most obvious was a bonehead mistake in ARx_Setup.rexx: In last-minute modifica- tions, I moved the line that adds rexxarplib.library to a place _below_ the first call to a function in that library. It's very embarrasing, but... there it is. That's fixed in these scripts along with a few silly looping mistakes in ARx_Setup.rexx, and some more subtle errors. The most mysterious had to do with hung processes that were unpredictable, but reported on several systems. Most of the problems were associated with the routines that check for the existence of a library. The CheckLib() user function that is used in several of these scripts has the unfortunate side-effect of revealing rogue libraries -- libraries that are included on the ARexx list, but don't properly set a return code for ARexx when a function call cannot be resolved by the library. Version 34 of "amigaguide.library" is one such rogue library when used as an ARexx function library. Even in the original 2_0 scripts, it was used only when absolutely necessary and removed as quickly as possible from the ARexx library list. The new scripts are even more careful to remove that library from the list. Other problematic libraries might be included on some systems, however, so the new versions of ARx_Setup.rexx and ARexxGuide.rexx check all libraries and temporarily remove unfamiliar names. The names are added back before the program exits, unless it's a name like "rexxsyslib.library" that doesn't belong on the list. Because of problems that are still mysterious to me, but are repeatable when the LibVer() function was used from a script called asynchronously (with "address AREXX"), that function is no longer used in ARx_GlossaryPort.rexx. Version 37.71 of "rexxreqtools.library" is recommended for these scripts. It is available in the archive "ReqTools22a_User.lha". Do not use a version less than 37.50. ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 20460 7358 64.0% 02-Apr-94 14:51:34 ARexxGuide/ARx_IactExamples.rexx 11078 3614 67.3% 02-Apr-94 14:49:44 ARexxGuide/ARx_RarpInfoWin.rexx 20519 6715 67.2% 30-Mar-94 11:23:30 ARexxGuide/Editors/ARx_Help.ed 17934 5979 66.6% 30-Mar-94 11:22:52 ARexxGuide/Editors/ARx_Help.edge 19155 6221 67.5% 30-Mar-94 11:24:10 ARexxGuide/Editors/ARx_Help.ttx 948 338 64.3% 23-Mar-94 14:03:36 ARexxGuide.info 2827 1373 51.4% 05-Apr-94 09:49:08 ARexxGuide/ARxG_20patch.readme 2075 716 65.4% 05-Apr-94 09:51:48 ARexxGuide/ARxG_20patch.readme.info 7969 3230 59.4% 10-Apr-94 13:39:28 ARexxGuide/ARexxGuide.rexx 23455 8023 65.7% 10-Apr-94 14:16:08 ARexxGuide/ARx_GlossaryPort.rexx 26036 8681 66.6% 06-Apr-94 16:27:16 ARexxGuide/ARx_Setup.rexx -------- ------- ----- --------- -------- 152456 52248 65.7% 11-Apr-94 15:55:14 11 files