<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta name="robots" content="index,nofollow">
<title>ReleaseChecklist - MLton Standard ML Compiler (SML Compiler)</title>
<link rel="stylesheet" type="text/css" charset="iso-8859-1" media="all" href="common.css">
<link rel="stylesheet" type="text/css" charset="iso-8859-1" media="screen" href="screen.css">
<link rel="stylesheet" type="text/css" charset="iso-8859-1" media="print" href="print.css">
<link rel="Start" href="Home">
</head>
<body lang="en" dir="ltr">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-833377-1";
urchinTracker();
</script>
<table bgcolor = lightblue cellspacing = 0 style = "border: 0px;" width = 100%>
<tr>
<td style = "
border: 0px;
color: darkblue;
font-size: 150%;
text-align: left;">
<a class = mltona href="Home">MLton MLTONWIKIVERSION</a>
<td style = "
border: 0px;
font-size: 150%;
text-align: center;
width: 50%;">
ReleaseChecklist
<td style = "
border: 0px;
text-align: right;">
<table cellspacing = 0 style = "border: 0px">
<tr style = "vertical-align: middle;">
</table>
<tr style = "background-color: white;">
<td colspan = 3
style = "
border: 0px;
font-size:70%;
text-align: right;">
<a href = "Home">Home</a>
<a href = "TitleIndex">Index</a>
</table>
<div id="content" lang="en" dir="ltr">
<h2 id="head-bbf6fecd25db651b73d554ce89c2cce96cd27342">Advance preparation for release</h2>
<ul>
<li>
<p>
Catch up on <tt>doc/changelog</tt> documentation.
</p>
</li>
<ul>
<li>
<p>
Write summary of changes from previous release.
</p>
</li>
</ul>
<li>
<p>
Update <tt>doc/README</tt> with relevant changes.
</p>
</li>
<li>
<p>
Update <tt>man/{mlton,mlprof}.1</tt> with relevant changes and set dates.
</p>
</li>
<li>
<p>
Wiki
</p>
</li>
<ul>
<li>
<p>
Check <a href="OrphanedPages">OrphanedPages</a> and <a href="WantedPages">WantedPages</a>.
</p>
</li>
<li>
<p>
<a href="Features">Features</a> page should by synchronized with <tt>doc/README</tt>.
</p>
</li>
<li>
<p>
Catch up on <a href="Credits">Credits</a> acknowledgements.
</p>
</li>
<li>
<p>
Create <strong>ReleaseYYYYMM??</strong> (i.e., forthcoming release) based on <strong>ReleaseXXXXLLCC</strong> (i.e., previous release).
</p>
</li>
<ul>
<li>
<p>
Update summary from <tt>doc/changelog</tt>.
</p>
</li>
<li>
<p>
Update attachment, SVN, and Wiki links to estimated release date.
</p>
</li>
<li>
<p>
Comment out lists and attachment links under <tt>YYYYMM?? binary packages</tt> and <tt>YYYYMM?? sources</tt>.
</p>
</li>
<li>
<p>
Ensure page has <tt>#acl All:</tt>
</p>
</li>
</ul>
<li>
<p>
Create <strong>BugsYYYYMM??</strong> based on <strong>BugsXXXXLLCC</strong>.
</p>
</li>
<ul>
<li>
<p>
Update SVN and Wiki links to estimated release date.
</p>
</li>
</ul>
<li>
<p>
Spell check pages.
</p>
</li>
</ul>
</ul>
<h2 id="head-5eff189d1b92b9902f7a939b5b3cf155fc41df98">Prepare Wiki for tagging</h2>
<p>
This ensures that the guide distributed with the release looks updated for the release.
</p>
<ul>
<li>
<p>
Rename <strong>ReleaseYYYYMM??</strong> to <strong>ReleaseYYYYMMDD</strong> with proper release date.
</p>
</li>
<ul>
<li>
<p>
Update attachment, SVN, and Wiki links to proper release date.
</p>
</li>
</ul>
<li>
<p>
Rename <strong>BugsYYYYMM??</strong> to <strong>BugsYYYYMMDD</strong> with proper release date.
</p>
</li>
<ul>
<li>
<p>
Update SVN and Wiki links to proper release date.
</p>
</li>
</ul>
<li>
<p>
Update <strong>ReleaseXXXXLLCC</strong>.
</p>
</li>
<ul>
<li>
<p>
Change intro to "<tt>This is an archived public release of MLton, version XXXXLLCC.</tt>"
</p>
</li>
</ul>
<li>
<p>
Update <a href="http://mlton.org/Download"><img src="moin-www.png" alt="[WWW]" height="11" width="11">Download</a>.
</p>
</li>
<ul>
<li>
<p>
Change <tt>Include(ReleaseXXXXLLCC, "Release XXXXLLCC")</tt> to <tt>Include(ReleaseYYYYMMDD,"Release YYYYMMDD")</tt>.
</p>
</li>
</ul>
<li>
<p>
Update <a href="Home">Home</a> with note of new release.
</p>
</li>
<ul>
<li>
<p>
Change <tt>What's new?</tt> text to <tt>Please try out our new release, [:ReleaseYYYYMMDD:MLton YYYYMMDD]</tt>.
</p>
</li>
</ul>
<li>
<p>
Clear <a href="http://mlton.org/Experimental"><img src="moin-www.png" alt="[WWW]" height="11" width="11">Experimental</a>.
</p>
</li>
<li>
<p>
Clear <a href="http://mlton.org/TemporaryUpload"><img src="moin-www.png" alt="[WWW]" height="11" width="11">TemporaryUpload</a>
</p>
</li>
</ul>
<h2 id="head-627b9649b75d2172fcfee12092a7f76b8e6dd7c5">Prepare sources for tagging</h2>
<ul>
<li>
<p>
Run <tt>bin/grab-wiki</tt> to update <tt>doc/guide</tt>.
</p>
</li>
<ul>
<li>
<p>
Check that <tt>doc/guide/MLTONWIKIVERSION</tt> has proper release date.
</p>
</li>
<li>
<p>
Make sure that <strong>ReleaseYYYYMMDD</strong> and <strong>BugsYYYYMMDD</strong> are added to the repository.
</p>
</li>
<li>
<p>
Make sure that <strong>ReleaseYYYYMM??</strong> and <strong>BugsYYYYMM??</strong> are removed from the repository (if they were added during the advanced preparation).
</p>
</li>
<li>
<p>
Commit changes to <tt>doc/guide</tt>.
</p>
</li>
</ul>
<li>
<p>
Check that <tt>doc/changelog</tt> has proper date.
</p>
</li>
</ul>
<h2 id="head-2f229e7357b2cb6c62b989f51925b5d4ebbfaee5">Tag sources</h2>
<ul>
<li>
<p>
Shell commands:
<pre>svn copy -m "Tagging YYYYMMDD release" svn+ssh://mlton.org/svnroot/mlton/trunk svn+ssh://mlton.org/svnroot/mlton/tags/on-YYYYMMDD-release
</pre>
</p>
</li>
</ul>
<h2 id="head-3a39b68c35be609fae3db651a70893a29f102145">Packaging</h2>
<h3 id="head-05ea6ff6b56e7d0a5c36b5577602bc6e65acfad7">Source release</h3>
<ul>
<li>
<p>
Shell commands:
<pre>svn checkout svn+ssh://mlton.org/svnroot/mlton/tags/on-YYYYMMDD-release mlton-YYYYMMDD
cd mlton-YYYYMMDD
make clean clean-svn version VERSION=YYYYMMDD RELEASE=1
cd ..
tar -czpvf mlton-YYYYMMDD-1.src.tgz mlton-YYYYMMDD
</pre>
</p>
</li>
<li>
<p>
Update <strong>ReleaseYYYYMMDD</strong> with <tt>mlton-YYYYMMDD-1.src.tgz</tt> attachment.
</p>
</li>
</ul>
<h3 id="head-ec79a21642a39bec29bdea181aba0068a834d958">Binary releases</h3>
<ul>
<li>
<p>
Download source release (<tt>mlton-YYYYMMDD-1.src.tgz</tt> from <a href="http://mlton.org/Download"><img src="moin-www.png" alt="[WWW]" height="11" width="11">Download</a>).
</p>
</li>
<li>
<p>
Shell commands:
<pre>tar -xzpvf mlton-YYYYMMDD-1.src.tgz
cd mlton-YYYYMMDD
make
</pre>
</p>
</li>
<li>
<p>
If your platform doesn't have <tt>htmldoc</tt>, please build or get <tt>mlton-guide.pdf</tt> and copy to <tt>doc/guide</tt>.
</p>
</li>
<li>
<p>
Shell commands:
<pre>make install
cd install
tar -czpvf ../mlton-YYYYMMDD-1.ARCH-OS.tgz *
</pre>
</p>
</li>
<li>
<p>
Update <strong>ReleaseYYYYMMDD</strong> with <tt>mlton-YYYYMMDD-1.ARCH-OS.tgz</tt> attachment.
</p>
</li>
</ul>
<h3 id="head-7dd6c24a1e80ce3673b6628d7353f5c27bf281c1">Package releases</h3>
<ul>
<li>
<p>
Debian: ???
</p>
</li>
</ul>
<h2 id="head-2e8a57cc5c472f4ac3b071979a38e80db7e59e87">Website</h2>
<ul>
<li>
<p>
<tt>basis</tt> gets a snapshot of <a class="external" href="http://standardml.org/Basis"><img src="moin-www.png" alt="[WWW]" height="11" width="11">http://standardml.org/Basis</a> (if any relevant changes).
</p>
</li>
<li>
<p>
<tt>changelog</tt> gets a copy of <tt>doc/changelog</tt>.
</p>
</li>
<li>
<p>
<tt>guide/YYYYMMDD</tt> gets a copy of <tt>doc/guide</tt>.
</p>
</li>
<ul>
<li>
<p>
Need to run <tt>sed</tt> to replace <tt>MLTONWIKIVERSION</tt> with <tt>YYYYMMDD</tt>.
</p>
</li>
<li>
<p>
Copy <tt>guide/YYYYMMDD/Home</tt> to <tt>guide/YYYYMMDD/index.html</tt>.
</p>
</li>
<li>
<p>
Upload <tt>guide/guide-YYYYMMDD.tgz</tt> and unpack.
</p>
</li>
<li>
<p>
Add <tt><Directory /var/www/html/mlton.org/guide/YYYYMMDD> DefaultType text/html </Directory></tt> to <tt>/etc/apache2/sites-available/mlton.org</tt>
</p>
</li>
<li>
<p>
Restart <tt>apache2</tt> service.
</p>
</li>
</ul>
</ul>
<h2 id="head-16561f6ffd9bbe95bb15fa4d972139f66e178854">Announce release</h2>
<ul>
<li>
<p>
Send mail to
</p>
</li>
<ul>
<li>
<p>
<a class="external" href="mailto:MLton@mlton.org"><img src="moin-email.png" alt="[MAILTO]" height="10" width="14">MLton@mlton.org</a>
</p>
</li>
<li>
<p>
<a class="external" href="mailto:MLton-user@mlton.org"><img src="moin-email.png" alt="[MAILTO]" height="10" width="14">MLton-user@mlton.org</a>
</p>
</li>
<li>
<p>
<a class="external" href="mailto:sml-list@cs.cmu.edu"><img src="moin-email.png" alt="[MAILTO]" height="10" width="14">sml-list@cs.cmu.edu</a> (aka <a class="external" href="news:comp.lang.ml"><img src="moin-news.png" alt="[NEWS]" height="11" width="10">news:comp.lang.ml</a>)
</p>
</li>
<li>
<p>
<a class="external" href="mailto:lwn@lwn.net"><img src="moin-email.png" alt="[MAILTO]" height="10" width="14">lwn@lwn.net</a> (linux weekly news)
</p>
</li>
</ul>
<li class="gap">
<p>
Post to
</p>
</li>
<ul>
<li>
<p>
<a class="external" href="news:comp.lang.functional"><img src="moin-news.png" alt="[NEWS]" height="11" width="10">news:comp.lang.functional</a>
</p>
</li>
</ul>
<li class="gap">
<p>
Update <a href="OtherSites">OtherSites</a> that have MLton pages.
</p>
</li>
</ul>
<h2 id="head-548f449b63ff41eaaff5a2d679ffa56b2015fc20">Misc.</h2>
<ul>
<li>
<p>
<tt>dupload</tt> Debian package.
</p>
</li>
<li class="gap">
<p>
Generate new <a href="Performance">Performance</a> numbers.
</p>
</li>
</ul>
</div>
<p>
<hr>
Last edited on 2010-06-08 14:25:52 by <span title="fenrir.cs.rit.edu"><a href="MatthewFluet">MatthewFluet</a></span>.
</body></html>
