regina/README.30

   1                          Regina 3.0
   2                         25 April 2002
   3
   4 Changes in this release (from 2.2)
   5 ----------------------------------
   6
   7 o Fixed a bug with a crash under Win32 when trying to load a function
   8   with rxfuncadd() and that function does not exist in the external function
   9   package.
  10 o Added ANSI enhancements to ADDRESS command. Now supports full WITH options.
  11   This feature implemented by Florian Grosse-Coosmann.
  12 o New port of Regina to EPOC32. Regina now runs on Psion 5mx/Revo/Revo Plus
  13   and those mobile phones that run EPOC32 operating system. The RexxStart
  14   package for EPOC32 also comes with an online Regina quick reference guide.
  15 o Added -a switch to specify that separate arguments should be passed to the
  16   Rexx program.
  17   eg without the -a switch (default behaviour of all Rexx interpreters)
  18      % rexx fred "this has spaces" mary
  19   /**/
  20   Parse Source . how .
  21   Say how     /* -> COMMAND */
  22   Say Arg(1)  /* -> fred this has spaces mary */
  23   Say Arg(2)  /* -> */
  24   Say Arg(3)  /* -> */
  25   Say Arg()   /* -> 1 */
  26      % rexx -a fred "this has spaces" mary
  27   /**/
  28   Parse Source . how .
  29   Say how     /* -> SUBROUTINE */
  30   Say Arg(1)  /* -> fred */
  31   Say Arg(2)  /* -> this has spaces */
  32   Say Arg(3)  /* -> mary */
  33   Say Arg()   /* -> 3 */
  34   You can determine how the Rexx program was called by checking the
  35   second word in PARSE SOURCE as the above example shows.
  36 o Add regina-config creation under Un*x platforms. This is to simplify the
  37   determination of what flags to use to build a program that links with Regina.
  38 o Files are now truncated properly with LINEOUT() on QNX 4.2x
  39 o Added UPPER instruction to ease porting from those platforms that support
  40   the UPPER instruction.
  41 o TRACE command now supports numeric values when in interactive trace. TRACE with
  42   a positive whole number will execute the number of clauses using the current TRACE
  43   setting without any prompting. TRACE with a negative whole number will execute the
  44   number of clauses without prompting, and with a temporary TRACE O in effect. TRACE 0
  45   is the same as TRACE O.
  46 o Added 'T' option to TIME and DATE BIFs to return the current Unix time_t value.
  47   'T' format can also be used in time and date conversions.
  48 o Slight change of behaviour when Regina looks for external functions in
  49   directories PATH. Regina will no longer look for an external function
  50   without an extension.  This is to allow Regina to allow operating system
  51   commands to be called as functions: eg. a = 'ls'() will now work as it did
  52   before the change to search PATH as well as REGINA_MACROS. If you have an
  53   external routine called 'ls.rexx' in PATH, it will still find it!
  54 o Added new OPTION: STRICT_ANSI (replaces ANSI OPTION). If you specify STRICT_ANSI
  55   in an OPTIONS statement, Regina will disallow any Regina functionality that is
  56   not part of the ANSI standard. (This is an ongoing exercise).
  57   Restrictions currently implemented:
  58   - C and T options on DATE BIF
  59   - J and T options on TIME BIF
  60   - BIFs not allowed:
  61     ALLOCATED,BEEP,BUFTYPE,CD,CHDIR,CLOSE,CRYPT,DESBUF,DIRECTORY,DROPBUF,DUMPFILES,
  62     DUMPTREE,DUMPVARS,EOF,All VMS F$ functions,FILESPEC,FIND,FINIS,FORK,FREELISTS,
  63     GETENV,GETPATH,GETPID,GETTID,INDEX,JUSTIFY,LISTLEAKED,MAKEBUF,MEMORYSTATS,OPEN,
  64     POPEN,SLEEP,STATE,TRACEBACK,UNAME,UNIXERROR,USERID
  65   - Instructions not allowed:
  66     UPPER
  67     ADDRESS (env)
  68   - Treating operating system commands as functions. eg: a = 'ls'() will
  69     return an error 43.1.
  70 o Initial native language support added. This release allows for error
  71   messages to be displayed in a user-selectable native language.
  72   All native language error messages are contained in binary files (*.mtb) that
  73   are built with the Regina executables from source files (*.mts).
  74   The mechanism Regina uses to determine what native language to use to display
  75   error messages depends on the operating system.
  76   On EPOC32, the language is supplied when installing; the selected language
  77   is contained in default.mtb.
  78   On all other platforms, Regina uses environment variables if you want to use a
  79   language other than English. The English messages are built into the interpreter.
  80   Up to 2 environment variables are used.
  81   REGINA_LANG environment variable can be set to an ISO 639, 2 character
  82   language abbreviation as defined below.
  83
  84   Abbrev Language       Translation By             EPOC32?
  85      de  German         Floran Grosse-Coosmann        Y
  86      es  Spanish        Pablo Garcia-Abia             Y
  87      no  Norwegian      Vidar Tysse                   Y
  88      pt  Portuguese     Susana and Brian Carpenter    Y
  89
  90   If REGINA_LANG is not set, the default is "en".
  91
  92   REGINA_LANG_DIR is required if Regina does not know where the language files
  93   will be at runtime.
  94   Any binary distribution that includes an installation routine; RPM, Windows
  95   InstallShield or EPOC32, will set the location of the .mtb files automatically.
  96   Similarly building and installing Regina on Unix-like platforms using
  97   configure;make install combination will also set the location automatically.
  98   All other platforms will require this environment variable to bet set manually.
  99 o Continuing addition of more sub-error reporting.
 100 o Added new command to RXQUEUE() BIF; TIMEOUT.  This allows the setting of a timeout
 101   value on an external queue, so that a subsequent PULL from the queue can be made
 102   to timeout after a certain period (specified in milliseconds), or wait indefinitely
 103   (specify a timeout of 0).
 104 o When a Rexx program is run from the Win32 Explorer or from the Start->Run prompt,
 105   Regina will display a prompt and require the user to press ENTER to close the
 106   console window. This is to allow the output from the Rexx program to be seen.
 107 o Added binaries to create and execute tokenised code files.
 108 o Fixed a crash with some combinations of compound variables, and minor bug
 109   with TRACE. Fixed by Mark Wooding
 110 o Interactive tracing state now correctly remembered across subroutine
 111   calls. Fixed by Mark Wooding
 112 o Changed error reporting of unmatched comments, as per feature Request:
 113   #508788. Error message now reflects comment starting line rather than
 114   end of file line.
 115 o Added '.rx' as a recognised file extension.
 116 o Fixed bug with negative values passed to TIME BIF.
 117 o Added capabilities to run Regina in "safe" mode.  This mode is useful for
 118   running in an environment where the Rexx program should be
 119   prevented from changing the environment in which it is running. eg as a
 120   database procedural language. See README_SAFE for more information.
 121 o Added new builtin environments: REXX and REGINA, to allow Rexx programs
 122   to be run in another process.
 123 o Fixed bug with rxstack when using timeouts on queues, and with deleting
 124   lines off the queue when they are pulled off.
 125 o Fixed bug with FORK BIF on unsupported platforms.  It now correctly returns 1
 126   instead of 0 if FORK unsupported.
 127
 128 Cheers, Mark.
 129 ------------------------------------------------------------------------
 130 * Mark Hessling,  M.Hessling@qut.edu.au  http://www.lightlink.com/hessling/
 131 * Author of THE, a Free XEDIT/KEDIT editor and, Rexx/SQL
 132 * Maintainer of PDCurses: Public Domain Curses and, Regina Rexx interpreter
 133 * Use Rexx ? join the Rexx Language Association: http://www.rexxla.org
 134 ------------------------------------------------------------------------