home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d745 / arexxbox.lha / ARexxBox / History_e.txt < prev    next >
Text File  |  1992-10-12  |  7KB  |  178 lines
  1. History of ARexxBox Releases
  2. ----------------------------
  3.  
  4. V0.99       first beta release
  5.  
  6. V0.99a      FIXED: Argument and result lists could work on an
  7.         invalid command -> Enforcer-Hit/Crash.
  8.         (Report: RALF_KAISER@AWORLD)
  9.  
  10. V0.99b      ENHANCED: GadToolsBox source fixed to use the System Default
  11.         Font instead of the Screenfont for Layout and Gadgets.
  12.         (Report: SYSOP@INSIDER [Garry Glendown])
  13.  
  14. V0.99c      FIXED: The equal sign '=' wasn't allowed for arguments.
  15.         
  16.         FIXED: After changing some argument or result, the display
  17.         now shows the changed element, rather than the last one
  18.         in that list.
  19.         
  20.         FIXED: The font routines still had some error.
  21.         (Report: F.J.Reichert [F_J_REICHERT@SAARAG])
  22.  
  23. V0.99d      FIXED: All pointer conversions are now clean. The code
  24.         should now be compileable without warnings.
  25.         Added pragma #includes and _toupper() for SAS/C.
  26.         (Report: W_KUETING@HSP)
  27.         
  28. V0.99e      FIXED: When _no_ result field was given, the code
  29.         generated an "out of memory" error.
  30.         
  31.         ENHANCED: ReplyRexxCmd() now creates the variable RC2, it
  32.         contains the "Secondary Returncode", which can be set in
  33.         any rxif-structure under the name rc2. This variable can
  34.         be used to return detailed error codes to the calling
  35.         rexx program.
  36.         
  37.         This feature is an extension of the style guide conventions,
  38.         IMHO a good one. If you have complaints or comments on 
  39.         this idea, please tell me!
  40.         
  41.         RC2 will only be generated if a) 'options results' was given
  42.         and b) RC != 0. The field rc2 may contain an error code (long)
  43.         as well as an error string (char *). Code is the default.
  44.         The software distinguishes these two types by the sign of
  45.         rc, rc positive means rc2 is a long, rc negative means rc2
  46.         is a char *.
  47.         A negative rc will be converted to positive before beeing
  48.         returned to the caller.
  49.         
  50.         Example for error CODE:
  51.         rd->rc = 10;
  52.         rd->rc2 = ERROR_OBJECT_NOT_FOUND;
  53.         
  54.         Example for error STRING:
  55.         rd->rc = -10;
  56.         rd->rc2 = (long) "You idiot! No object!";
  57.         
  58.         The standard error strings are _not_ localized. As soon as
  59.         I get some infos and tools for this, I'll do it.
  60.  
  61.         ENHANCED: SendRexxCommand() now has a new parameter for
  62.         better supporting the standard command "RX". It is a
  63.         FileHandle (BPTR!), which becomes the stdin/stdout of
  64.         the executed arexx script. FreeRexxCommand() closes
  65.         the file (if necessary).
  66.         
  67.         SendRexxCmd() now returns the address of the sent
  68.         RexxMsg structure (or NULL for error).
  69.         
  70.         ENHANCED: The RexxHost structure now has a new field
  71.         called "userdata". It can be used to hook the RexxHost
  72.         onto your own structures, e.g. for linking hosts and
  73.         and their project instances together.
  74.         
  75.         ENHANCED: Every command now has a global "enabled"
  76.         flag. If the flag is 0, the dispatcher will not execute
  77.         that command anymore until the flag will be set again.
  78.         The user should have the ability to manipulate this flag
  79.         using the (standard) arexx commands ENABLE and DISABLE
  80.         (see rxif/*.c).
  81.         
  82.         CHANGED: Any CommandShell now must have its own RexxHost,
  83.         that means that host _must_not_ be used as a normal ARexx
  84.         port simultaneously.
  85.         
  86.         ENHANCED: As a consequence, every rxif function now gets
  87.         the RexxHost of the ARexx port resp. CmdShell as it's
  88.         (first) parameter. Therefore the function can decide
  89.         whether it was called from ARexx or from a Shell and
  90.         on which project it should work.
  91.         
  92.         ENHANCED: Another consequence is the new flag ARB_HF_CMDSHELL
  93.         for supporting the standard command CMDSHELL. The flag is
  94.         in the 'flags' field of the RexxHost structure. If it's
  95.         set, that host is currently running a shell. You can
  96.         clear the flag from anywhere causing the shell to close
  97.         (after processing the next command).
  98.         
  99.         FIXED: ARB no longer accepts argument or result names
  100.         consisting of only spaces or only options.
  101.         
  102.         CHANGED: As some rxif functions have to access them,
  103.         the structs 'rxs_command' and 'rxs_commandlist' are now
  104.         defined in the headerfile. For accessing the command
  105.         list, there is a new function:
  106.         struct rxs_command *FindRXCommand( char *name );
  107.         
  108.         FIXED: Arguments with '=' are now translated correctly
  109.         into variable names for C. The last alias component
  110.         will be used as the var name.
  111.         
  112.         ENHANCED: There is now a callback function for words
  113.         the parser doesn't recognize:
  114.         char *ExpandRXCommand( struct RexxHost *host,
  115.                        char *commandline );
  116.         This function will be called before the parser returns
  117.         an error. If the function returns NULL, the error will be
  118.         generated, if not, the parser assumes that the function
  119.         was able to analyze the input and tries to parse the
  120.         returned string.
  121.         This function can be used to implement command aliases
  122.         or processing of non-standard commands.
  123.         
  124.         Attention! ExpandRXCmd() has to allocate memory for the
  125.         returned string, using standard C functions! This memory
  126.         will be freed by the parser after processing the string!
  127.         
  128.         ENHANCED: ARB now does more safety checks on saving the
  129.         source modules, so you should never accidentally destroy
  130.         other code.
  131.         
  132.         NOTE: One of the standard commands as suggested by the
  133.         style guide uses the keywords "VAR" and "STEM" to
  134.         describe the INPUT variables instead of the former
  135.         usage as OUTPUT descriptors. I don't think this is a
  136.         good choice as there can't be any results from this
  137.         function that way. I suggest other names for those
  138.         arguments, e.g. "FROMVAR" and "FROMSTEM".
  139.         Comments?
  140.         
  141.         (The ARB doesn't look at the already existing args, if
  142.         a command has some result, "VAR" and "STEM" will be
  143.         added to the template.)
  144.         
  145.         Some of the style guide suggestions are not very precise
  146.         and need extensions to operate correctly. I added some
  147.         extensions to the arexx standard commands. Comments
  148.         welcome.
  149.         
  150.         FIXED: Numeric results now work.
  151.  
  152. V0.99f        ENHANCED: ARB now uses two FileRequesters, one for the
  153.         binaries and the other for sources. The patterns now
  154.         remain what you set them to and have defaults with #?
  155.         instead of *.
  156.         (Report: Stefan Zeiger)
  157.         
  158.         FIXED: Window->TopEdge is now font sensitive.
  159.         (Report: Stefan Zeiger)
  160.         
  161. V0.99g        FIXED: The parser now returns the ReadArgs() error code
  162.         in rc2.
  163.         
  164.         CHANGED: No longer appends \n to the template string
  165.         before parsing (not needed).
  166.         
  167.         CHANGED: The ARexxBox now uses the ASL file requester.
  168.         (Wish: Garry Glendown [Sysop@Insider])
  169.         
  170. V1.00         ENHANCED: Source now compatible to GCC. Remaining
  171.         warnings may be ignored.
  172.         
  173.         CHANGED: FindRXCommand() now only accepts real abbreviations
  174.         of commands.
  175.         
  176. --- FIRST PUBLIC RELEASE ---
  177.         
  178.