Merge pull request #418 from MatthewFluet/20201002-release

Create and update pages for 20201002 release

CHANGELOG.adoc

@@ -1,11 +1,14 @@
 = CHANGELOG
 
-== Version YYYYMMDD
+== Version 20201002
 
-Here are the changes from version 20200817 to version YYYYMMDD.
+Here are the changes from version 20200817 to version 20201002.
 
 === Summary
 
+* Compiler
+  ** Fixed bug in handling of weak objects during mark-compact GC.
+
 === Details
 
 * 2020-09-20

doc/guide/src/Bugs20200817.adoc

@@ -3,3 +3,11 @@ Bugs20200817
 
 Here are the known bugs in <:Release20200817:MLton 20200817>, listed
 in reverse chronological order of date reported.
+
+* <!Anchor(bug01)>
+Bug in handling of weak objects during mark-compact GC that could result in a
+segmentation fault.
++
+Thanks to Bernard Berthomieu for the bug report.
++
+Fixed by commit <!ViewGitCommit(mlton,47a781c3c)>.

doc/guide/src/Bugs20201002.adoc

@@ -0,0 +1,5 @@
+Bugs20201002
+============
+
+Here are the known bugs in <:Release20201002:MLton 20201002>, listed
+in reverse chronological order of date reported.

doc/guide/src/Home.adoc

@@ -17,6 +17,8 @@ a lexer generator, a parser generator, and a profiler.
 
 == What's new? ==
 
+* 20201002: Please try out our latest release, <:Release20201002:MLton 20201002>.
+
 * 20200817: Please try out our latest release, <:Release20200817:MLton 20200817>.
 
 * 20200722: Please try out our latest release, <:Release20200722:MLton 20200722>.
@@ -40,7 +42,7 @@ a lexer generator, a parser generator, and a profiler.
 * Read about MLton's <:Features:>.
 * Look at <:Documentation:>.
 * See some <:Users:> of MLton.
-* Download MLton from https://sourceforge.net/projects/mlton/files/mlton/20200722[SourceForge] or https://github.com/MLton/mlton/releases/tag/on-20200722-release[GitHub].
+* Download MLton from https://sourceforge.net/projects/mlton/files/mlton/20201002[SourceForge] or https://github.com/MLton/mlton/releases/tag/on-20201002-release[GitHub].
 * Meet the MLton <:Developers:>.
 * Get involved with MLton <:Development:>.
 * User-maintained <:FAQ:>.

doc/guide/src/Release20201002.adoc

@@ -0,0 +1,125 @@
+Release20201002
+===============
+
+Here you can download the latest public release of MLton, version 20201002.
+
+== Changes since <:Release20200817:MLton 20200817> ==
+
+* Compiler.
+  ** Fixed bug in handling of weak objects during mark-compact GC.
+* Other.
+  ** Fixes for Solaris and MinGW platforms.
+
+For a complete list of changes and bug fixes since
+<:Release20180207:>, see the
+<!ViewGitFile(mlton,on-20200817-release,CHANGELOG.adoc)> and
+<:Bugs20180207:>.
+
+== Changes since <:Release20200722:MLton 20200722> ==
+
+* Compiler.
+  ** Fixed bug in `RssaShrink` optimization that would result in an unbound
+  variable and an internal compiler error.
+* Other.
+  ** Fixes for Solaris and MinGW platforms.
+
+For a complete list of changes and bug fixes since
+<:Release20180207:>, see the
+<!ViewGitFile(mlton,on-20200817-release,CHANGELOG.adoc)> and
+<:Bugs20180207:>.
+
+== Changes since <:Release20180207:MLton 20180207> ==
+
+* Compiler.
+  ** Added expert `-pi-style {default|npi|pic|pie}` and
+  `-native-pic {false|true}` options, which can be used to override a
+  target-determined default.
+  ** Fix a number of instances of excessive live data during
+  compilation.
+  ** Disable `Zone` SSA optimization pass by default; the `Zone` pass
+  is known to not be safe-for-space.
+  ** Statically allocate and initialize some global objects.
+  ** Many updates and improvements to C and LLVM codegens.
+  ** Add new `BounceVars` RSSA optimization pass to split the live
+  ranges of RSSA variables.
+  ** Improve `RssaShrink` optimization.
+  ** Add support for alternate globalization strategies in
+  `ConstantPropagation`.
+  ** Strengthen `Useless` optimization with respect to a number of
+  primitives.
+  ** Add new `DuplicateGlobals` and `SplitTypes` SSA optimization
+  passes.
+  ** Introduce new `Overflow`-checking primitives and remove old
+  `Overflow`-checking primitives and special-case code required (e.g.,
+  `Arith` transfers in IRs) to support them.
+  ** Add parsers for XML, SXML, SSA, and SSA2 IRs.
+* Runtime.
+  ** Detect and report incompatible use of ASLR/PIE on `load-world`.
+  ** Added support for RISC-V architecture.
+* Language.
+* Libraries.
+  ** Basis Library.
+    *** Change `OS.IO.poll` to not be restarted when interrupted by a
+    signal.  (This is consistent with `Socket.select`.)
+    *** Add `MLton.sizeAll: unit -> IntInf.int` that returns the size
+    of reachable live data.
+    *** Change type of `MLton.size` from `'a -> int` to
+    `'a -> IntInf.int`, because with 64-bit systems, the size of a
+    single object can exceed that representable by a signed 32-bit
+    integer.
+  ** Other libraries.
+    *** Updated: ckit library, MLLPT library, MLRISC library, SML/NJ library
+* Tools.
+* Other.
+  ** Updates to simplify porting MLton.
+  ** Support parallel build (i.e., `make -j`).  This mainly supports
+  platforms/packagers that use a parallel `make` by default; it does
+  not obtain significant build speedups.
+  ** Various updates to `Makefile`-s.  See `Makefile.config` for
+  common and user-customizable configuration.
+  ** Characterize MLton-LICENSE as an instance of the Historical
+  Permission Notice and Disclaimer (HPND) license, rather than
+  BSD-style.
+
+For a complete list of changes and bug fixes since
+<:Release20180207:>, see the
+<!ViewGitFile(mlton,on-20200817-release,CHANGELOG.adoc)> and
+<:Bugs20180207:>.
+
+== 20201002 binary packages ==
+
+* AMD64 (aka "x86-64" or "x64")
+** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-1.amd64-darwin-19.6.gmp-homebrew.tgz[Darwin (.tgz)] 19.6 (Mac OS X Catalina), dynamically linked against <:GMP:> in `/usr/local/lib` (suitable for https://brew.sh/[Homebrew] install of <:GMP:>)
+** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-1.amd64-darwin-19.6.gmp-static.tgz[Darwin (.tgz)] 19.6 (Mac OS X Catalina), statically linked against <:GMP:> (but requires <:GMP:> for generated executables)
+** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-1.amd64-darwin-17.7.gmp-homebrew.tgz[Darwin (.tgz)] 17.7 (Mac OS X High Sierra), dynamically linked against <:GMP:> in `/usr/local/lib` (suitable for https://brew.sh/[Homebrew] install of <:GMP:>)
+** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-1.amd64-darwin-17.7.gmp-static.tgz[Darwin (.tgz)] 17.7 (Mac OS X High Sierra), statically linked against <:GMP:> (but requires <:GMP:> for generated executables)
+** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-1.amd64-linux.tgz[Linux (.tgz)], glibc 2.27 (Ubuntu 18.04)
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-amd64-mingw.tgz[MinGW (.tgz)], gcc 10.1.0, statically linked against <:GMP:>; contributed by Bernard Berthomieu; see http://projects.laas.fr/tina/software.php for details and installation instructions
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-amd64-mingw-gmp-dynamic.tgz[MinGW (.tgz)], gcc 10.1.0, dynamically linked against <:GMP:>; contributed by Bernard Berthomieu; see http://projects.laas.fr/tina/software.php for details and installation instructions
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-amd64-solaris-gmp-dynamic.tgz[Solaris (.tgz)] 11.4, dynamically linked against <:GMP:>; contributed by Bernard Berthomieu
+// * x86
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-x86-mingw.tgz[MinGW (.tgz)], gcc 10.1.0, statically linked against <:GMP:>; contributed by Bernard Berthomieu; see http://projects.laas.fr/tina/software.php for details and installation instructions
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-x86-mingw-gmp-dynamic.tgz[MinGW (.tgz)], gcc 10.1.0, dynamically linked against <:GMP:>; contributed by Bernard Berthomieu; see http://projects.laas.fr/tina/software.php for details and installation instructions
+// ** https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002-x86-solaris-gmp-dynamic.tgz[Solaris (.tgz)] 11.4, dynamically linked against <:GMP:>; contributed by Bernard Berthomieu
+
+// === Binary packages available at other sites
+
+// * http://projects.laas.fr/tina/software.php[TINA toolbox]: Includes binary
+//   releases for: amd64-darwin Mac OS X Sierra (both statically and dynamically
+//   linked against <:GMP:>), amd64-linux Ubuntu 14 (both statically and
+//   dynamically linked against <:GMP:>), amd64-mingw and x86-mingw MSys2 (both
+//   statically and dynamically linked against <:GMP:>), amd64-solaris and
+//   x86-solaris Solaris 11.4 (both statically and dynamically linked against
+//   <:GMP:>), and x86-linux Ubuntu 16 (both statically and dynamically linked
+//   against <:GMP:>).
+
+== 20201002 source packages ==
+
+ * https://sourceforge.net/projects/mlton/files/mlton/20201002/mlton-20201002.src.tgz[mlton-20201002.src.tgz]
+
+== Also see ==
+
+* <:Bugs20201002:>
+* http://www.mlton.org/guide/20201002/[MLton Guide (20201002)].
++
+A snapshot of the MLton website at the time of release.

doc/guide/src/Releases.adoc

@@ -3,6 +3,8 @@ Releases
 
 Public releases of MLton:
 
+* <:Release20201002:>
+* <:Release20200817:>
 * <:Release20200722:>
 * <:Release20180207:>
 * <:Release20130715:>

man/mllex.1

@@ -1,4 +1,4 @@
-.TH mllex 1 "August 17, 2020"
+.TH mllex 1 "October 2, 2020"
 .SH NAME
 \fBmllex\fP \- lexer generator for use with Standard ML and MLton
 .SH SYNOPSIS

man/mlnlffigen.1

@@ -1,4 +1,4 @@
-.TH mlnlffigen 1 "August 17, 2020"
+.TH mlnlffigen 1 "October 2, 2020"
 .SH NAME
 \fBmlnlffigen\fP \- glue-code generator for use with the new "NLFFI" foreign function interface for Standard ML and MLton
 .SH SYNOPSIS

man/mlprof.1

@@ -1,4 +1,4 @@
-.TH mlprof 1 "August 17, 2020"
+.TH mlprof 1 "October 2, 2020"
 .SH NAME
 \fBmlprof\fP \- display profiling information for a MLton-compiled executable
 .SH SYNOPSIS

man/mlton.1

@@ -1,4 +1,4 @@
-.TH mlton 1 "August 17, 2020"
+.TH mlton 1 "October 2, 2020"
 .SH NAME
 \fBmlton\fP \- whole-program compiler for the Standard ML (SML) programming
 language

man/mlyacc.1

@@ -1,4 +1,4 @@
-.TH mlyacc 1 "August 17, 2020"
+.TH mlyacc 1 "October 2, 2020"
 .SH NAME
 \fBmlyacc\fP \- parser generator for use with Standard ML and MLton
 .SH SYNOPSIS