mirror of
https://github.com/Mercury-Language/mercury.git
synced 2026-04-15 09:23:44 +00:00
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.
This commit is contained in:
Fergus Henderson
26
.README.in
26
.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
|
||||
|
||||
2
NEWS
2
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.
|
||||
|
||||
|
||||
43
README.AIX
43
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 <rodneybrown@pmsc.com> 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 <rodneybrown@pmsc.com> 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 <ftp://turiel.cs.mu.oz.au/pub/mercury/old-releases>).
|
||||
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 ;-)
|
||||
|
||||
-----------------------------------------------------------------------------
|
||||
|
||||
6
README.HPUX
Normal file
6
README.HPUX
Normal file
@@ -0,0 +1,6 @@
|
||||
Mercury installs fine out-of-the-box on HPUX 10.20, according to
|
||||
Rodney Brown <rodneybrown@pmsc.com>. However, you may need to
|
||||
use an egcs release (see <http://egcs.cygnus.com>) 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.
|
||||
13
README.Linux
13
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 <trd@cs.mu.oz.au> */
|
||||
# ifdef MERCURY_LINUX_NEED_ASM_SIGCONTEXT
|
||||
+/*** # include <asm/sigcontext.h> ***/
|
||||
# include <asm/sigcontext.h>
|
||||
# endif
|
||||
# endif
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user