// A template for creating release notes for a version
//
:version: @VERSION@
:date: @DATE@
:dist-dir: https://smlnj.org/dist/working/{version}/
:history: {dist-dir}HISTORY.html
:issue-base: https://github.com/smlnj/legacy/issues/
:pull-base: https://github.com/smlnj/legacy/pull/
:stem: latexmath
:source-highlighter: pygments
:stylesheet: release-notes.css
:notitle:

= Standard ML of New Jersey Release Notes

[subs=attributes]
++++
<div class="smlnj-banner">
  <span class="title"> Standard ML of New Jersey <br/> Release Notes </span>
  <br/> <br/>
  <span class="subtitle"> Version {version} <br/> {date} </span>
</div>
++++

''''''''
--
SML/NJ HOME::
  https://www.smlnj.org/index.html[[.tt]#https://smlnj.org#]
FILES::
  {dist-dir}index.html[[.tt]#{dist-dir}#]
--
''''''''

== Summary

// **** summary description of release

== Details

// **** details: include those sections that are relevant

=== Compiler

=== CM

=== MLRISC

=== Runtime System

=== Basis Library

=== SML/NJ Library

=== Successor ML

=== ML-LPT

=== Documentation

=== Installation

== Bugs

Here is a list of the issues that are fixed (or closed) with this release.
We include the original bug numbers for bugs that were reported using the
gforge bug tracker.

[.buglist,cols="^1,<10,^2",strips="none",options="header"]
|=======
| Issue
| Description
| Gforge Bug
//| [.bugid]#@ID#
//| {issue-base}/@ID[@DESCRIPTION]
//| [old bug #@OLDID]
|=======

// ***** include a list of unnumbered bugs here *****

== Supported systems

We believe that SML/NJ will build and run on the following systems, but have only
tested some of them:

[.support-table,cols="^2s,^4v,^3v",options="header",strips="none"]
|=======
| Architecture | Operating System | Status
| AMD64 | FreeBSD 12.0 |
| | macOS 10.14 (Mojave) |
| | macOS 10.15 (Catalina) |
| | macOS 11 (Big Sur) |
| | macOS 12 (Monterey) | Tested
| | macOS 13 (Ventura) | Tested
| | macOS 14 (Sonoma) | Tested
| | Ubuntu 22.04.4 LTS | Tested
| | Ubuntu 20.04.6 LTS | Tested
| {nbsp} | |
| Power PC | Mac OS X 10.5 (Leopard) |
| | AIX |
| {nbsp} | |
| Sparc | Solaris |
| | Linux |
| {nbsp} | |
| x86 (32-bit) | Mac OS X 10.6 (Snow Leopard) |
| | Mac OS X 10.7 (Lion) |
| | Mac OS X 10.8 (Mountain Lion) |
| | Mac OS X 10.9 (Mavericks) |
| | Mac OS X 10.10 (Yosemite) |
| | Mac OS X 10.11 (El Capitan) |
| | macOS 10.12 (Sierra) |
| | macOS 10.13 (High Sierra) | Tested
| | macOS 10.14 (Mojave) |
| | Ubuntu 16.04.3 LTS |
| | Other Linux variants |
| | FreeBSD 12.0 |
| | Other BSD variants |
| | Windows 7 |
| | Windows 10 |
| | Cygwin (32-bit) |
| {nbsp} | |
|=======

The system also works on Apple Silicon using Rosetta2.

=== 32-bit macOS issues

While the {dist-dir}smlnj-x86-{version}.pkg[x86 installer]
for {version} works on **macOs** 10.14 Mojave, building from source
requires some extra steps because the version of **Xcode**
distributed for Mojave does not include a 32-bit SDK.

Another issue that you may encounter
when building on **macOs** 10.14 Mojave is an error message for a shell
script of the form

.....
  /bin/sh: bad interpreter: Operation not permitted
.....

This error arises because the `com.apple.quarantine` attribute is set on the
shell script.  To fix the problem, remove the attribute using the command

[source,shell]
-----
  xattr -d com.apple.quarantine shell-script
-----
and resume the build.
