From 9ad1bdf0da30302aa164cfc23fa4c3f73b17457d Mon Sep 17 00:00:00 2001 From: Fergus Henderson Date: Fri, 4 Sep 1998 06:26:49 +0000 Subject: [PATCH] Various changes to the README files, in preparation for the next release. Estimated hours taken: 1 Various changes to the README files, in preparation for the next release. .README.in: Update version numbers and copyright dates. Update the list of README.* files. README.HPUX: New file. README.AIX: Update to reflect recent bug fix. README.Linux: Delete an obsolete patch at the end of this file; the text describing this patch had been removed already. README.MS-Windows: Mention that we haven't tested it on Windows 98. NEWS: We've updated to Boehm GC version 4.13alpha2. extras/README: Add descriptions of each subdirectory. --- .README.in | 26 +++++++++++++++++++------- NEWS | 2 +- README.AIX | 43 +++++++++++++++++++++---------------------- README.HPUX | 6 ++++++ README.Linux | 13 ------------- README.MS-Windows | 1 + 6 files changed, 48 insertions(+), 43 deletions(-) create mode 100644 README.HPUX diff --git a/.README.in b/.README.in index fc279290d..bc80e55cb 100644 --- a/.README.in +++ b/.README.in @@ -2,7 +2,7 @@ This directory contains the source distribution for the University of Melbourne Mercury compiler, version @VERSION@. The Mercury implementation is free software, but it is Copyright - (C) 1993-1997 The University of Melbourne. It is distributed + (C) 1993-1998 The University of Melbourne. It is distributed under the terms of the GNU General Public License. See the file COPYING for copying permission. @@ -15,11 +15,13 @@ Mercury compiler, version @VERSION@. contact us! We are willing to offer alternative arrangements, if the need should arise. -The subdirectory `boehm_gc' contains a slightly modified version 4.12 of -the conservative garbage collector distributed by Hans Boehm: +The subdirectory `boehm_gc' contains a slightly modified copy of +version 4.13alpha2 of the conservative garbage collector distributed +by Hans Boehm: Copyright 1988, 1989 Hans-J. Boehm, Alan J. Demers Copyright (c) 1991-1995 by Xerox Corporation. All rights reserved. + Copyright (c) 1996-1998 by Silicon Graphics. All rights reserved. THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED OR IMPLIED. ANY USE IS AT YOUR OWN RISK. @@ -48,7 +50,8 @@ License version 2: The files in the `samples' directory are either public domain, or distributed under the GNU General Public License. -Some of the files in the `extras' subdirectory have fairly restrictive +Some of the files in the `extras' subdirectory (which is now distributed +separately in the `mercury-extras' package) have fairly restrictive copyright licences: The `Togl' library in extras/graphics/Togl-1.2 is copyright by @@ -63,9 +66,18 @@ THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED OR IMPLIED. ANY USE IS AT YOUR OWN RISK. See the file COPYING. See the file INSTALL for installation instructions. -But first read README.AIX, README.BSDI, README.IRIX-5, README.Linux, -or README.MS-Windows if you are installing on a machine running -AIX, BSD Unix, IRIX 5, Linux, or Microsoft Windows respectively. +But in some cases, additional steps may be needed for particular +operating systems or particular architectures, so first read the +README file for your particular platform, if there is one: + + README.AIX RS/6000 systems running AIX + README.BSDI The BSDI version of BSD Unix on Intel x86 + README.IRIX-5 SGI IRIX version 5.x + README.Linux Linux on Intel x86 + README.Linux-Alpha Linux on DEC Alpha + README.Linux-PPC Linux on PowerPC + README.MS-Windows Microsoft Windows + README.HPUX HPPA systems running HPUX The documentation sources are in the `doc' subdirectory. The installation process will install INFO, HTML, and DVI versions in the locations specified diff --git a/NEWS b/NEWS index a2187eaf6..671f9430a 100644 --- a/NEWS +++ b/NEWS @@ -460,7 +460,7 @@ Changes to the Mercury implementation: (this port has not been tested well, though). See README.MS-Windows for details. -* We've updated to version 4.12 of the Boehm garbage collector. +* We've updated to version 4.13alpha2 of the Boehm garbage collector. * Numerous bug fixes. diff --git a/README.AIX b/README.AIX index bbb3aedd6..6ddc3c4c5 100644 --- a/README.AIX +++ b/README.AIX @@ -1,19 +1,20 @@ ----------------------------------------------------------------------------- -This file lists what you need to do to get Mercury to work on an +This file documents what you need to do to get Mercury to work on an RS/6000 running AIX using GNU C. Previous versions of Mercury have worked successfully on AIX, -but Rodney Brown reports that the current -version does not build correctly out-of-the-box. -Some additional work will be needed to port the latest version. -We'd be happy to assist anyone with this, but we can't do it -ourselves, since we don't have an machine running AIX. -Donations happily accepted ;-) +but Rodney Brown reported some problems +with a recent version. We believe that we have fixed these problems, +but we do not have a machine running AIX to test it on, so we do +not know if the current version will build correctly out-of-the-box. + +If there are any problems remaining, we would be happy to assist +in resolving them. ----------------------------------------------------------------------------- -1. Put the following line in the file Mmake.params +1. Put the following line in the file Mmake.params: EXTRA_CFLAGS=-mminimal-toc @@ -29,31 +30,29 @@ Donations happily accepted ;-) 3. Follow the instructions in the INSTALL file. -4. From a previous report, this will result in a link error about - some undefined symbols when linking the compiler. Debug the cause - of this link error, fix it, and send us the patch. (As noted - previously, we'd be happy to offer assistance with this task. - In fact we'd do it ourselves, but we don't have an AIX machine. - Donations happily accepted.) - The last version of Mercury which was known to work on AIX was Mercury 0.6 -- actually a version just prior to 0.6, namely the 30Apr1996 development snapshot (the source for this version and a binary distribution of this version for AIX are still available from ). That version was verified to work on AIX 4.1.3 using GNU C 2.7.2. -For that version, the following additional step was needed. +For that version, following the steps above would result in +an error message from the assembler, so the following additional +step was needed. -1b. Change directory to the `compiler' directory, and run the command +4. Change directory to the `compiler' directory, and run the command sh ../scripts/rs6000_hack - This works around a fixed limit of 32k on the size of relative jumps - in the RS/6000 object file format. + Then continue following the instructions in the INSTALL file. -It is possible that something similar to step 1b will still be needed, + This works around a fixed limit of 32k on the size of relative jumps + in the RS/6000 object file format. + +It is possible that something similar to this will still be needed, but the rs6000_hack script no longer works as is, so a little more -hacking will be needed if that is the case. (Again, we'd be happy -to offer our assistance.) +hacking will be needed if that is the case. +(We'd be happy to offer assistance with this task. Indeed, we'd do it +ourselves, but we don't have an AIX machine -- donations happily accepted ;-) ----------------------------------------------------------------------------- diff --git a/README.HPUX b/README.HPUX new file mode 100644 index 000000000..db8fd6f51 --- /dev/null +++ b/README.HPUX @@ -0,0 +1,6 @@ +Mercury installs fine out-of-the-box on HPUX 10.20, according to +Rodney Brown . However, you may need to +use an egcs release (see ) instead of +standard gcc. I belive Rodney Brown used an egcs snapshot +slightly prior to egcs version 1.1, so it should probably work +fine with egcs version 1.1. diff --git a/README.Linux b/README.Linux index 0d2e3669e..c40c895cb 100644 --- a/README.Linux +++ b/README.Linux @@ -42,16 +42,3 @@ or `MR_runtime_grade' multiply defined. offset table pointer register in PIC code. If only the Intel architecture wasn't so register-starved, we wouldn't need to use `ebx', and then PIC and non-PIC code could be mixed without any problems.) - --------------------- - ---- os_dep.c Tue Feb 10 15:37:42 1998 -+++ new/os_dep.c Tue Feb 10 16:04:24 1998 -@@ -38,6 +38,7 @@ - /* 10-Feb-1998 Modified to use autoconf to handle this for */ - /* Mercury -- Tyson Dowd */ - # ifdef MERCURY_LINUX_NEED_ASM_SIGCONTEXT -+/*** # include ***/ - # include - # endif - # endif diff --git a/README.MS-Windows b/README.MS-Windows index 7d6185e1b..5acc2883d 100644 --- a/README.MS-Windows +++ b/README.MS-Windows @@ -4,6 +4,7 @@ INTRODUCTION Mecury has been ported to Windows 95 and Windows NT using the gnu-win32 Unix emulation package from Cygnus. +It may well work on Windows 98 too, but we haven't tested that. This file documents how to build the source distribution of Mercury on Windows 95 or Windows NT using gnu-win32.