--- rpl/README 2010/01/27 07:55:53 1.2 +++ rpl/README 2010/08/13 21:06:28 1.10 @@ -10,6 +10,8 @@ I SHALL NOT ACCEPT ANY BUG REPORT FROM USERS THAT HAVE BUILD RPL/2 WITH LESSTIF LIBRAIRIES SINCE OPENMOTIF IS AVAILABLE. + + DO NOT USE 'make install-strip' THAT BREAKS RPL/2. -------------------------------------------------------------------------------- RPL/2 signifies Reverse Polish Lisp/2. This language is obvious derivated @@ -17,9 +19,28 @@ from the first RPL written by Hewlett-Pa this language is a half-compiled high level language which can perform symbolic and scientific computations. + + * RPL/2 requires : + - nawk or gawk; + - libtool 1.5 or newer. To build RPL/2 on Mac OSX, you should have to + add libtool m4 path in tools/file-*/configure.ac and + tools/file-*/Makefile.am; + - gcc-4.3 or newer; + - g++-4.3 or newer; + - gfortran-4.3 or newer. + + RPL/2 build process invoques automake and autoconf. + + * OpenSSL issue : + + OpenSSL does not use any configure script. If build process aborts on +error related to OpenSSL, you shall try to build OpenSSL before running +'make'. On some system, OpenSSL configure script is unable to set compiler +flags. + * RPL/2 is known to run on : - - Linux (kernel 2.6.12 and above) on i386, amd64, ppc32, sparc32, + - Linux (kernel 2.6.26 and above) on i386, amd64, ppc32, sparc32, sparc64, alpha. Test distribution is Debian. Warning, you have to use NPTL, not LinuxThreads due to a bug in sem_post() that is not async safe. @@ -28,24 +49,27 @@ symbolic and scientific computations. 64bits executable, you have to modify some generated makefiles or specify some options. See 64bits on Solaris. - FreeBSD 7.x on i386. I have installed a FreeBSD 7.0, upgraded to 7.2 - and RPL/2 ran without any trouble. RPL/2 does not run on FreeBSD 8.0 - because sig_into_t struct is not filled. Someone has reported that - FreeBSD 7.2 did not filled this struct too... - - NetBSD 4.0 and above on sparc32 with a restriction. NetBSD's sigpending + and RPL/2 ran without any trouble. RPL/2 does not run on early + FreeBSD 8.0 because sig_info_t struct is not filled. This bug is now + fixed. Someone has reported that FreeBSD 7.2 did not filled this + struct too... + - NetBSD 4.0 and above with a restriction. NetBSD's sigpending is broken and it is impossible to use DETACH intrinsic. Bug report has been done and this bug should be fixed in next NetBSD release. Sigpending has been fixed in NetBSD 5.0 and RPL/2 runs fine. + - Windows with Cygwin (>= 1.7.5). * RPL/2 should run on : - HP-UX (10.20 and above), but not tested for a long time. - - Linux (2.6.12 and above) on ppc64 and other hardware (arm, hppa...) or + - Linux (2.6.26 and above) on ppc64 and other hardware (arm, hppa...) or with other distributions than Debian. - FreeBSD 7.0 and above on other architecture than i386. Please not that I cannot reproduce sig_info_t bug and I do not have more information. - NetBSD 4.0 and above on other architecture than sparc32 with restriction due to sigpending bug. + - OS/2 and eComStation. - Mac OS X. Any information about RPL/2 on these last operating systems are welcome. @@ -54,20 +78,16 @@ symbolic and scientific computations. - OpenBSD due to a major bug in sigaltstack syscall when a program is linked with -lthread. As this bug comes from OpenBSD libraries, - OpenBSD port has to wait for a fixed sigaltstack. + OpenBSD port has to wait for a fixed sigaltstack. RPL/2 uses pselect() + that is unavailable too. - OpenVMS (work in progress) on Alpha and Integrity due to some bugs in GNV. RPL/2 never works on OpenVMS VAX because GNV is too old on this architecture. - - Hurd. + - Hurd because sig_info_t is not filled. * RPL/2 shall never be supported on : - - Cygwin due to some troubles between Cygwin Posix subsystem and Windows. - You can try, but I shall never support Cygwin. If someone proposes - patches to build RPL/2 on Cygwin, I won't modify official RPL/2 source - tree, but only propose these patches against official tarball. - - Windows (all versions). - - OS/2 and eComStation. + - Windows (all versions) without Cygwin. - Mac OS preX. Tools directory contains some libraries that are normally provided by @@ -76,7 +96,7 @@ symbolic and scientific computations. several systems, some Posix libraries have strange 'features'... On all systems, you must install GNU make and you should install - gcc/g++/gfortran (minimal release : 4.0.0). It is possible to build + gcc/g++/gfortran (minimal release : 4.2.0). It is possible to build RPL/2 with some other compilers (for example cc and f95 from SunStudio, or cc and f95 from Digital^WCompaq^WHP) but I do not test all potential combinaisons.