| 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, [email protected] 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 |
------------------------------------------------------------------------ |