regina/README.W32

   1                         Regina for Win9x/NT/2k/XP
   2
   3 This distribution contains 32 bit executables of the Regina Rexx interpreter
   4 for Win9x/NT/2k/XP, and some sample programs, most of which are designed to test
   5 new features of this interpreter.
   6
   7 Regina is distributed under the GNU Library General Public Licence.
   8 See COPYING-LIB for details.
   9
  10 This port of Regina to Win9x/NT/2k/XP differs from the port of Regina on the
  11 Windows NT Resource Kit in two ways:
  12
  13 1)  This port is sanctioned by the author of Regina, Anders Christensen.
  14 2)  This port does not provide any OLE or Win32 support nor does it
  15     provide builtin access to the Registry.  It does however, provide the
  16     standard Rexx API.  This enables C programs written under OS/2 and
  17     Unix that use the standard API, to be easily ported to Win9x/NT/2k/XP.
  18     It also means that C programs written using Quercus Rexx and Object
  19     Rexx under Win9x/NT/2k to be recompiled using Regina, and C programs
  20     written for Regina to be recompiled using Quercus Rexx or Object
  21     Rexx.
  22     The Win32 functions that were built into Regina on the Resource Kit are
  23     available as an external function package from http://www.interlog.com/~ptjm
  24
  25 The files in this archive are:
  26
  27 README             - this file
  28 README.3x          - readme files for 3.x releases of Regina
  29 README_SAFE        - details on using Regina is "safe" mode
  30 COPYING-LIB        - GNU Library General Public Licence
  31 file_id.diz        - Description file for BBS use
  32 regina.exe         - 32bit Regina Rexx interpreter executable
  33 regina.dll         - 32bit Regina Rexx interpreter dynamic library
  34 regina.lib         - Import library for Visual C++
  35 rexx.lib           - Static library for Visual C++
  36 rexx.exe           - Regina executable - does not require regina.dll
  37 rexxsaa.h          - Header file for access to regina.dll
  38 regutil.dll        - 32bit Regutil dynamic library
  39 test1.dll          - Sample external function packages; used by dynfunc.rexx
  40 test2.dll            demo Rexx program
  41 demo\*.rexx        - Sample Rexx programs
  42 nls\*.mtb          - Native Language message files
  43
  44 The remainder of this section is relevant only if you are not installing
  45 Regina via the self-extracing installation.
  46
  47 Installation is simply a matter of copying the regina.exe and regina.dll
  48 files into a directory specified in your PATH environment variable.
  49
  50 If you want to have Regina error messages displayed in you native
  51 language, set the environment variable; REGINA_LANG to the two-character
  52 language abbreviation (the first two chracters of a file in the NLS
  53 directory), and set REGINA_LANG_DIR to the directory containing the
  54 *.mtb files.
  55
  56 If you wish to be able to run Rexx programs automatically, ie without
  57 specifying the regina.exe or the file extension, then run the following
  58 Windows commands from a command prompt: (you only need to do this once)
  59 Note: The following commands will only work under NT/2k/XP; they are not
  60 supported under Windows 95/98.
  61
  62 C:\> ftype Regina=c:\regina\regina.exe "%1" %*
  63 C:\> assoc .rexx=Regina
  64 C:\> set PATHEXT=%PATHEXT%;.rexx
  65
  66 The above commands assume that regina.exe is in c:\regina and that you
  67 only want to execute Rexx programs that have an extension of .rexx.
  68 Add another ASSOC command to associate files with other extensions.
  69
  70 You will probably want to set the PATHEXT variable in the Environment
  71 section of the System Control Panel applet.
  72
  73 Using this build of Regina with other Win32 Compilers
  74 =====================================================
  75 Nearly every C compiler on the Win32 platforms generates object code that
  76 is incompatible with one another.  So using this build of Regina with a
  77 C compiler other than MS Visual C/C++ requires that you link with the
  78 import library appropriate to your compiler.  The following provides
  79 instructions on how to build import libraries for a couple of Win32
  80 compilers.
  81 Run these commands from a directory other than where the original regina.lib file exists.
  82 In the commands below that is assumed to be c:\regina.
  83
  84 Cygwin and MingW32
  85 ------------------
  86 Command:
  87  dlltool -A -k --input-def c:\regina\regina_w32_dll.def --dllname c:\regina\regina.dll --output-lib libregina.a
  88 Import Library:
  89  libregina.a
  90
  91 Borland 5.5
  92 -----------
  93 Command:
  94  impdef tmp.def c:\regina\regina.dll
  95  -- you need to edit tmp.def with a text editor and remove lines containing a question mark: '?'
  96  implib -w regina.lib tmp.def
  97 Import Library:
  98  regina.lib
  99
 100 ADRRESS WITH
 101 ============
 102 Redirection of program's input and/or output in general is relatively
 103 predictable on most operating systems, however mention must be made of
 104 behaviour specific to the Windows platform.
 105
 106 Windows and to a lesser degree OS/2, have techniques to hide windows,
 107 to start programs in separate windows and other cool features.  Florian
 108 did some significant testing of this on all different Windows platforms
 109 and there is bad news. There is no consistent mechanism to start external
 110 programs without error and full control. Sounds strange, is strange.
 111 We have the options to:
 112
 113 1) use the interpreter (ADDRESS SYSTEM) or not (ADDRESS PATH or CMD)
 114 2) start GUI or text mode programs
 115 3) choose the interpreter (CMD.EXE or COMMAND.COM)
 116
 117 The main goal was to start GUIs separately and text mode programs under the
 118 control of the caller (GUI or text). Regina can be part of a GUI progress
 119 and must be treated as GUI in this case. Most people get upset with console
 120 windows popping up showing nothing.
 121
 122 Some combinations of the interpreter, the target programs, and the options
 123 we can pass along to the system lead to nonstarting, nonstopping, crashing
 124 programs. Or we may loose control by means of broken communications to the
 125 subprocess (ADDRESS WITH...).
 126
 127 So we had to choose either to let program run safely OR to let program run
 128 pretty. Blame the guys who designed Windows, not the Regina crew!
 129
 130 So, if you have a DOS graphical extension known as Windows 95, Windows 98 or
 131 Windows Millenium you will get console windows popping up if run from a GUI
 132 program. We are sorry for this, we can't change it.
 133
 134 Those Systems with a 32 bit startup kernel known as Windows NT, Windows 2000,
 135 Windows XP will hide the console windows when starting a text mode program
 136 from a GUI program.
 137
 138 ATTENTION: Your programs might crash or you may loose control either of the
 139 called program or of Regina if you change the interpreter inside your Rexx
 140 program. Never use
 141 CALL VALUE 'COMSPEC', something, 'SYSTEM'
 142 in your program if you don't know the consequences!  Unpredictable behaviour
 143 is likely to occur; use at your own peril!
 144
 145 Regina Resources
 146 ================
 147 For more information on Regina, visit the Regina Home page at
 148 http://regina-rexx.sf.net
 149
 150
 151 If building Regina from source, always unzip the source to convert the
 152 Unix end of line characters to Win32 carriage return/end of line characters.
 153 With InfoZip, this is "unzip -a".
 154
 155 Cheers, Mark.
 156 ------------------------------------------------------------------------
 157 * Mark Hessling,  mark@rexx.org  http://www.rexx.org/
 158 * Author of THE, a Free XEDIT/KEDIT editor and, Rexx/SQL, Rexx/CURL, etc.
 159 * Maintainer of Regina Rexx interpreter and Rexx/Tk
 160 * Use Rexx? join the Rexx Language Association: http://www.rexxla.org/
 161 ------------------------------------------------------------------------