regina/regutil/README

   1 RexxUtil for Regina (Regutil), version 1.3.0
   2
   3 RegUtil is now distributed as part of the Regina Rexx interpreter. However
   4 this does not preclude RegUtil being able to be built for other interpreters
   5 independently from Regina.  Simply follow the notes described in the 1.2.5
   6 section below.
   7
   8 RexxUtil for Regina (RegUtil), version 1.2.5
   9 (original notes from last stand-alone version of Regutil)
  10
  11 RegUtil is an implementation of IBM's RexxUtil for Regina. RexxUtil is a
  12 collection of functions which perform certain useful services, such as
  13 searching directories and files, performing contention management, and so on.
  14 The documentation is in regutil.pdf, which is part of the distribution.
  15
  16 RegUtil is not finished, but it's getting closer. If there is a function which
  17 you need, but which returns 'not implemented', do let me know. If you feel
  18 like implementing some of the unimplemented functions, please let me know. If
  19 you find a bug, please let me know about that, too. As of version 1.1.0, you
  20 can test the version number of the library by calling the sysutilversion()
  21 function. Note that IBM's implementation returns 2 for the current release,
  22 but regutil returns 1.25 (you can tell them apart this way -- there's no
  23 version of IBM's library which returns anything less than 2).
  24
  25 This is version 1.2.5. I will increment the third digit each time I do a
  26 bug-fix release. I will increment the second digit if I ever add a large
  27 number of new functions, however the goal is to provide compatibility with
  28 IBM's libraries, so this is unlikely to happen (except when IBM adds a large
  29 number of new functions ...).
  30
  31 To compile the library using Microsoft C, type nmake -f Makefile.nt. To
  32 compile the library under FreeBSD systems, type make -f Makefile.bsd. To
  33 compile the library under another Unix system, you might try using the
  34 provided make files. Good luck, and let me know how it goes. The make files
  35 assume the stock vendor compiler -- to use another compiler such as gcc,
  36 you'll generally need to remove the flags that don't start with -D from the
  37 PCFLAGS definition and add -fPIC or the position-independent-code flag for
  38 your compiler.
  39
  40 This code has been built on FreeBSD, NT, Solaris, HP, TRU64 Unix, Linux,
  41 Dynix, and AIX.
  42
  43 To install on NT, copy rexxutil.dll to a directory in your path (e.g., the
  44 directory with regina.exe). To install on Unix systems, copy librexxutil.so
  45 (or whatever it's called on your system :( to some central location and put
  46 that central location in your LD_LIBRARY_PATH, LIBPATH, SHLIB_PATH, or
  47 whatever it's called on your system. FreeBSD has a nice utility to set
  48 standard library searches, which you might want to investigate.
  49
  50
  51 -- Patrick TJ McPhee
  52    ptjm@interlog.com