[m-dev.] diff: fix problems with README* files

Fergus Henderson fjh at cs.mu.OZ.AU
Mon Dec 20 02:50:02 AEDT 1999


Estimated hours taken: 0.75

Fix various problems, mostly minor, with the README* files.
The most significant of these was that the ftp sites listed
in the README file in the binary distribution were out-of-date.

README.Linux:
	Fix a typo.
	
.README.in:
	Mention some new README.* files.
	Update the version number and copyright dates for the Boehm GC.

bindist/bindist.README:
	Update the version number and copyright dates for the Boehm GC.
	Update the ftp sites.  Update the copyright date.
	Update the file names for the Mercury standard library and
	runtime library.

bindist/Mmakefile:
	Include the files README.OSF1, README.Linux-Alpha, README.Linux-PPC,
	and README.Solaris in the binary distribution.

bindist/bindist.README.Linux:
	Update to match the changes to README.Linux in the source distribution.

profiler/mercury_profile.m:
	Update the copyright date printed by `mprof --help'.

Workspace: /d-drive/home/hg/fjh/mercury
Index: .README.in
===================================================================
RCS file: /home/mercury1/repository/mercury/.README.in,v
retrieving revision 1.10
diff -u -d -r1.10 .README.in
--- .README.in	1999/11/10 01:43:24	1.10
+++ .README.in	1999/12/19 15:25:42
@@ -16,12 +16,12 @@
 	if the need should arise.
 	
 The subdirectory `boehm_gc' contains a slightly modified copy of
-version 4.13alpha2 of the conservative garbage collector distributed
+version 5.0alpha3 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.
+	Copyright (c) 1996-1999 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.
@@ -77,13 +77,16 @@
 
 	README.AIX		RS/6000 systems running AIX
 	README.BSDI		The BSDI version of BSD Unix on Intel x86
+	README.FreeBSD		The FreeBSD 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.Linux-m68k	Linux on Motorola 68000
 	README.MS-Windows	Microsoft Windows
 	README.HPUX		HPPA systems running HPUX
 	README.OSF1		DEC Alpha systems running OSF/1 version 3.x
+	README.Solaris		Solaris (SunOS) on SPARC or Intel x86.
 
 The documentation sources are in the `doc' subdirectory.  The installation
 process will install INFO, HTML, and DVI versions in the locations specified
Index: README.Linux
===================================================================
RCS file: /home/mercury1/repository/mercury/README.Linux,v
retrieving revision 1.13
diff -u -d -r1.13 README.Linux
--- README.Linux	1999/03/16 05:09:26	1.13
+++ README.Linux	1999/12/19 14:56:34
@@ -1,7 +1,7 @@
 This file documents just the Linux/x86 port. 
 For the Linux/PowerPC port, see README.Linux-PPC. 
 For the Linux/Alpha port, see README.Linux-Alpha. 
-(Ports to Linux on other architecures have not yet
+(Ports to Linux on other architectures have not yet
 been attempted, but should not be difficult.)
 
 On Linux with a.out, shared libraries are not supported.
Index: bindist/Mmakefile
===================================================================
RCS file: /home/mercury1/repository/mercury/bindist/Mmakefile,v
retrieving revision 1.24
diff -u -d -r1.24 Mmakefile
--- bindist/Mmakefile	1999/11/28 07:44:02	1.24
+++ bindist/Mmakefile	1999/12/19 15:11:51
@@ -26,7 +26,8 @@
 
 README_ETC	= ../COPYING ../COPYING.LIB ../HISTORY ../LIMITATIONS \
 		  ../NEWS ../RELEASE_NOTES ../BUGS ../WORK_IN_PROGRESS \
-		  ../VERSION
+		  ../VERSION ../README.OSF1 ../README.Linux-PPC \
+		  ../README.Linux-Alpha ../README.Solaris
 
 SCRIPT_FILES	= ../scripts/*.in ../scripts/*.sh-subr \
 		  ../scripts/Mmake.rules \
Index: bindist/bindist.README
===================================================================
RCS file: /home/mercury1/repository/mercury/bindist/bindist.README,v
retrieving revision 1.11
diff -u -d -r1.11 bindist.README
--- bindist/bindist.README	1998/12/16 19:23:41	1.11
+++ bindist/bindist.README	1999/12/19 15:26:11
@@ -3,23 +3,23 @@
 built on a `<FULLARCH>' system.
 
 The Mercury implementation is free software, but it is Copyright (C)
-1993-1998 The University of Melbourne.  It is distributed under the
+1993-1999 The University of Melbourne.  It is distributed under the
 terms of the GNU General Public License.  See the file COPYING for
-copying permission.  The Mercury library and runtime (libmercury.* and
-libmer.*) are distributed under the terms of the GNU Library General
+copying permission.  The Mercury library and runtime (libmer_std.* and
+libmer_rt.*) are distributed under the terms of the GNU Library General
 Public License.  See the file COPYING.LIB for copying permissions for
 those files.  (If these licencing arrangements are unsatisfactory,
 please contact us!  We are willing to come to alternative arrangements,
 if the need should arise.)
 
 This distribution also contains a slightly modified version of the
-conservative garbage collector distributed by Hans Boehm, version 4.13alpha2,
+conservative garbage collector distributed by Hans Boehm, version 5.0alpha3,
 which has the following copyright attached (taken from the README file
 of the garbage collector source):
 
 	Copyright 1988, 1989 Hans-J. Boehm, Alan J. Demers
 	Copyright (c) 1991-1996 by Xerox Corporation.  All rights reserved.
-        Copyright (c) 1996-1998 by Silicon Graphics.  All rights reserved.
+        Copyright (c) 1996-1999 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.
@@ -87,10 +87,16 @@
 The Mercury binary and source distributions are available via anonymous
 ftp or WWW from the following locations:
 
-	Australia:
-		ftp://turiel.cs.mu.oz.au/pub/mercury/
-	USA:
-		ftp://ftp.cs.sunysb.edu/pub/XSB/mercury/
-	Europe:
-		ftp://ftp.csd.uu.se/pub/Mercury/
+	Home site:
+	    Australia:	ftp://ftp.mercury.cs.mu.oz.au/pub/mercury/
+
+	Mirrors:
+	    Sweden:	ftp://ftp.csd.uu.se/pub/Mercury/
+	    Greece:	ftp://ftp.ntua.gr/pub/lang/mercury/
+
+	Other sites (these may be less complete and/or out-of-date):
+	    USA:	ftp://ftp.cs.sunysb.edu/pub/XSB/mercury/
+	    USA:	ftp://sunsite.unc.edu/pub/Linux/devel/lang/mercury/
+	    Sunsite also has many other mirrors, see
+			http://sunsite.unc.edu/pub/Linux/MIRRORS.html.
 
Index: bindist/bindist.README.Linux
===================================================================
RCS file: /home/mercury1/repository/mercury/bindist/bindist.README.Linux,v
retrieving revision 1.1
diff -u -d -r1.1 bindist.README.Linux
--- bindist/bindist.README.Linux	1997/08/14 09:31:44	1.1
+++ bindist/bindist.README.Linux	1999/12/19 15:02:41
@@ -1,6 +1,8 @@
-Mercury has only been ported to Linux/x86, not to Linux/Alpha
-Linux/PowerPC, Linux/m68k, etc.  Those other ports should
-not be difficult, but this file documents just the Linux/x86 port.
+This file documents just the Linux/x86 port. 
+For the Linux/PowerPC port, see README.Linux-PPC. 
+For the Linux/Alpha port, see README.Linux-Alpha. 
+(Ports to Linux on other architectures have not yet
+been attempted, but should not be difficult.)
 
 On Linux with ELF, shared libraries are supported.  However, ELF shared
 libraries require position-independent code, and (partly due to
@@ -18,20 +20,19 @@
 a future release.)
 
 To use the shared libraries, you must compile your program with
-`mmc --cflags -DPIC_REG' and link with `ml --mercury-libs shared'
-or add `MGNUCFLAGS=-DPIC_REG' and `MLFLAGS=--mercury-libs shared'
-to your Mmake file.
+`mmc --pic-reg' and link with `ml --shared' or add 
+`MGNUCFLAGS=--pic-reg' and `MLFLAGS=--shared' to your Mmake file.
 
-Mercury code compiled with `-DPIC_REG' or `-fpic' has what we shall call
-"PIC linkage", whereas Mercury code compiled without these options has
-"non-PIC linkage".  The static version of the Mercury libraries has
-non-PIC linkage, while the shared version has PIC linkage.
-Be very careful that you do not try to link Mercury code
-with PIC linkage and Mercury code with non-PIC linkage into the same
-executable, otherwise your code will *almost certainly crash*.
+Mercury code compiled with `--pic-reg' or with gcc's `-fpic' option has
+what we shall call "PIC linkage", whereas Mercury code compiled without
+these options has "non-PIC linkage".  The static version of the Mercury
+libraries has non-PIC linkage, while the shared version has PIC linkage.
+Be careful that you do not try to link Mercury code with PIC linkage and
+Mercury code with non-PIC linkage into the same executable, otherwise you
+will probably get an obscure link error about `MR_grade_...' undefined
+or `MR_runtime_grade' multiply defined.
 (The reason for this is that standard non-PIC Mercury code uses the
 `ebx' register in ways that are incompatible with its uses as the global
 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.)
-
Index: profiler/mercury_profile.m
===================================================================
RCS file: /home/mercury1/repository/mercury/profiler/mercury_profile.m,v
retrieving revision 1.21
diff -u -d -r1.21 mercury_profile.m
--- profiler/mercury_profile.m	1997/12/10 06:54:35	1.21
+++ profiler/mercury_profile.m	1999/12/19 15:28:59
@@ -1,5 +1,5 @@
 %-----------------------------------------------------------------------------%
-% Copyright (C) 1995-1997 The University of Melbourne.
+% Copyright (C) 1995-1997, 1999 The University of Melbourne.
 % This file may only be copied under the terms of the GNU General
 % Public License - see the file COPYING in the Mercury distribution.
 %-----------------------------------------------------------------------------%
@@ -105,7 +105,7 @@
 	{ library__version(Version) },
         io__write_strings(StdErr,
 		["Mercury Profiler, version ", Version, "\n"]),
-        io__write_string(StdErr, "Copyright (C) 1995-1997 The University of Melbourne\n"),
+        io__write_string(StdErr, "Copyright (C) 1995-1999 The University of Melbourne\n"),
         io__write_string(StdErr, "Usage: "),
         io__write_string(StdErr, ProgName),
 	io__write_string(StdErr, " [<options>] [<files>]\n"),
@@ -118,7 +118,7 @@
         io__progname_base("mprof", ProgName),
 	{ library__version(Version) },
         io__write_strings(["Mercury Profiler, version ", Version, "\n"]),
-        io__write_string("Copyright (C) 1995-1997 The University of Melbourne\n"),
+        io__write_string("Copyright (C) 1995-1999 The University of Melbourne\n"),
 	io__write_string("\n"),
         io__write_string("Usage: "),
         io__write_string(ProgName),

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
WWW: <http://www.cs.mu.oz.au/~fjh>  |  of excellence is a lethal habit"
PGP: finger fjh at 128.250.37.3        |     -- the last words of T. S. Garp.
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to:       mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions:          mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------



More information about the developers mailing list