<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY email 'freebsd-qa'>
<!ENTITY date "$FreeBSD$">
<!ENTITY local.rel "4.10">
<!ENTITY local.rel.tag "4_10">
<!ENTITY title "FreeBSD &local.rel; Release Process">
<!ENTITY % navinclude.download "INCLUDE">
]>

<html>
&header;

<h1>Introduction</h1>

<p>This is a specific schedule for the release of FreeBSD &local.rel;.  For
  more general information about the release engineering process,
  please see the <a href="&base;/releng/index.html">Release
  Engineering</a> section of the web site.</p>

<p>General discussions about the release engineering process or
  quality assurance issues should be sent to the public <a
  href="mailto:FreeBSD-qa@FreeBSD.org">freebsd-qa</a> mailing list.
  <a
  href="&base;/doc/en_US.ISO8859-1/books/faq/misc.html#DEFINE-MFC">MFC</a>
  requests should be sent to <a
  href="mailto:re@FreeBSD.org">re@FreeBSD.org</a>.</p>

<h1>Schedule</h1>

<table class="tblbasic">
  <tr><td>Action</td><td>Expected</td><td>Actual</td><td>Description</td>
      </tr>
  <tr>
    <td>Reminder announcement</td>
    <td>30&nbsp;Mar&nbsp;2004</td>
    <td>30&nbsp;Mar&nbsp;2004</td>
    <td>Release Engineers send announcement email to
      <tt>developers@FreeBSD.org</tt> with a rough schedule for the FreeBSD
      &local.rel; release.</td>
  </tr>
  <tr>
    <td>&local.rel;-BETA Testing Guide published</td>
    <td>30&nbsp;Mar&nbsp;2004</td>
    <td>30&nbsp;Mar&nbsp;2004</td>
    <td>A <a href="&base;/releases/&local.rel;R/qa.html">testing guide</a>
      should be published with information about recent changes and
      areas of the system that should be thoroughly tested during the
      pre-release/RC period.</td>
  </tr>
  <tr>
    <td>Announce the Ports Freeze</td>
    <td>03&nbsp;Apr&nbsp;2004</td>
    <td>03&nbsp;Apr&nbsp;2004</td>
    <td>Someone from <tt>portmgr@</tt> should email
    <tt>freebsd-ports@</tt> and BCC: <tt>developers@</tt> to set a date
    for the week long ports freeze and tagging of the ports tree.</td>
  </tr>

  <tr>
    <td><tt>&local.rel;-BETA</tt></td>
    <td>7&nbsp;Apr&nbsp;2004</td>
    <td>10&nbsp;Apr&nbsp;2004</td>
    <td><tt>newvers.sh</tt>, and <tt>release.ent</tt> updated.</td>
  </tr>
  <tr>
    <td>Code freeze begins</td>
    <td>7&nbsp;Apr&nbsp;2004</td>
    <td>7&nbsp;Apr&nbsp;2004</td>
    <td>After this date, all commits to the <tt>RELENG_4</tt> branch
      must be approved by <a
      href="mailto:re@FreeBSD.org">re@FreeBSD.org</a>.  Certain highly
      active documentation committers are exempt from this rule for
      routine man page / release note updates.  Heads-up emails
      should be sent to the <tt>developers@</tt>, <tt>stable@</tt>
      and <tt>qa@</tt> lists.</td>
  </tr>

  <tr>
    <td><tt>RELENG_&local.rel.tag;</tt> branch</td>
    <td>20&nbsp;Apr&nbsp;2004</td>
    <td>21&nbsp;Apr&nbsp;2004</td>
    <td>The release branch is created.</td>
  </tr>

  <tr>
    <td>Unfreeze the tree</td>
    <td>20&nbsp;Apr&nbsp;2004</td>
    <td>22&nbsp;Apr&nbsp;2004</td>
    <td>Announcement to <tt>developers@</tt> explaining that
      commits to <tt>RELENG_4</tt> no longer require approval.  Also
      note the policy for commits to the <tt>RELENG_&local.rel.tag;</tt>
      branch.</td>
  </tr>

  <tr>
    <td><tt>&local.rel;-RC</tt></td>
    <td>20&nbsp;Apr&nbsp;2004</td>
    <td>24&nbsp;Apr&nbsp;2004</td>
    <td><tt>newvers.sh</tt> and <tt>release.ent</tt> updated.</td>
  </tr>

  <tr>
    <td>First release candidate</td>
    <td>21&nbsp;Apr&nbsp;2004</td>
    <td>22&nbsp;Apr&nbsp;2004</td>
    <td>The first release candidate for the x86 and Alpha architecture is
      released.  ISO images should be uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.  A network install directory should
      be uploaded to <tt>ftp-master.FreeBSD.org</tt>.  The
      <tt>packages/</tt> directory should be a <em>relative</em> symlink,
      as described in the releng article.  When the builds begin send a note to
      <a href="mailto:mirror-announce@FreeBSD.org">mirror-announce@FreeBSD.org</a>
      saying a "Normal Release Cycle" is beginning, RC ISOs and install
      directories will be coming through the next few weeks.</td>
  </tr>

  <tr>
    <td>Heads up to <tt>-stable</tt></td>
    <td>21&nbsp;Apr&nbsp;2004</td>
    <td>23&nbsp;Apr&nbsp;2004</td>
    <td>A message should be sent to <tt>qa@FreeBSD.org</tt> and
    <tt>stable@FreeBSD.org</tt> after the first snapshot is uploaded.</td>
  </tr>

  <tr>
    <td>Second release candidate</td>
    <td>27&nbsp;Apr&nbsp;2004</td>
    <td>2&nbsp;May&nbsp;2004</td>
    <td>Note: the release date of this candidate depends on the user
      experience with RC1.</td>
  </tr>

  <tr>
    <td>Heads up to <tt>-stable</tt></td>
    <td>28&nbsp;Apr&nbsp;2004</td>
    <td>3&nbsp;May&nbsp;2004</td>
    <td>A message should be sent to <tt>qa@FreeBSD.org</tt> and
    <tt>stable@FreeBSD.org</tt> after the second snapshot is uploaded.</td>
  </tr>

  <tr>
    <td>Third release candidate</td>
    <td>--</td>
    <td>17&nbsp;May&nbsp;2004</td>
    <td>Note: the release date of this candidate depends on the user
      experience with RC2.</td>
  </tr>

  <tr>
    <td>Heads up to <tt>-stable</tt></td>
    <td>--</td>
    <td>17&nbsp;May&nbsp;2004</td>
    <td>A message should be sent to <tt>qa@FreeBSD.org</tt> and
    <tt>stable@FreeBSD.org</tt> after the third snapshot is uploaded.</td>
  </tr>

<!-- portmgr should tweak these values after we commit it to CVS -->
  <tr>
    <td>Ports tree frozen</td>
    <td>20&nbsp;Apr&nbsp;2004</td>
    <td>20&nbsp;Apr&nbsp;2004</td>
    <td>Only approved commits will be permitted to the <tt>ports/</tt>
      tree during the freeze.</td>
  </tr>

<!-- doceng should tweak these values after we commit it to CVS -->
  <tr>
    <td>Announce <tt>doc/</tt> tree slush</td>
    <td>--</td>
    <td>12&nbsp;Apr&nbsp;2004</td>
    <td>Notification of the impending <tt>doc/</tt> tree slush should
      be sent to <tt>doc@</tt>.</td>
  </tr>

<!-- doceng should tweak these values after we commit it to CVS -->
  <tr>
    <td><tt>doc/</tt> tree slush</td>
    <td>17&nbsp;Apr&nbsp;2004</td>
    <td>17&nbsp;Apr&nbsp;2004</td>
    <td>Non-essential commits to the <tt>en_US.ISO8859-1/</tt> subtree
      should be delayed from this point until after the <tt>doc/</tt>
      tree tagging, to give translation teams time to synchronize
      their work.</td>
  </tr>

<!-- portmgr should tweak these values after we commit it to CVS -->
<!-- packages should be loaded on ftp-master at least two days before -->
<!-- release bits get loaded to avoid network congestion problems -->
  <tr>
    <td>Ports tree tagged</td>
    <td>27&nbsp;Apr&nbsp;2004</td>
    <td>28&nbsp;Apr&nbsp;2004</td>
    <td><tt>RELEASE_&local.rel.tag;_0</tt> tag for <tt>ports/</tt>.</td>
  </tr>

  <tr>
    <td>Ports tree unfrozen</td>
    <td>27&nbsp;Apr&nbsp;2004</td>
    <td>28&nbsp;Apr&nbsp;2004</td>
    <td>After the <tt>ports/</tt> tree is tagged,
      the <tt>ports/</tt> tree will be re-opened for commits, but
      commits made after tagging will not go in &local.rel;-RELEASE.</td>
  </tr>

  <tr>
    <td>Final package build starts</td>
    <td>--</td>
    <td>--</td>
    <td>The ports cluster and <a href="http://bento.FreeBSD.org">bento</a>
    build final packages.</td>
  </tr>

<!-- doceng should tweak these values after we commit it to CVS -->
  <tr>
    <td><tt>doc/</tt> tree tagged.</td>
    <td>24&nbsp;Apr&nbsp;2004</td>
    <td>24&nbsp;Apr&nbsp;2004</td>
    <td>Version number bumps for <tt>doc/</tt> subtree.
      <tt>RELEASE_&local.rel.tag;_0</tt> tag for <tt>doc/</tt>.  <tt>doc/</tt>
      slush ends at this time.</td>
  </tr>

  <tr>
    <td>Version numbers bumped.</td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    22&nbsp;May&nbsp;2004</td>
    <td>24&nbsp;May&nbsp;2004</td>
    <td>The files listed <a
    href="&base;/doc/en_US.ISO8859-1/articles/releng/article.html#VERSIONBUMP">here</a>
    are updated to reflect the fact that this is FreeBSD &local.rel;.</td>
  </tr>

  <tr>
    <td>Update man.cgi on the website.</td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    22&nbsp;May&nbsp;2004</td>
    <td>25&nbsp;May&nbsp;2004</td>
    <td>Make sure the &local.rel; manual pages are being displayed by default
      for the man->web gateway.  Also make sure these man pages are
      pointed to by docs.sgml.</td>
  </tr>

  <tr>
    <td>src tree tagged.</td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    22&nbsp;May&nbsp;2004</td>
    <td>25&nbsp;May&nbsp;2004</td>
    <td><tt>RELENG_&local.rel.tag;_0_RELEASE</tt> tag for <tt>src/</tt>.</td>
  </tr>

  <tr>
    <td>Final builds.</td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    22&nbsp;May&nbsp;2004</td>
    <td>26&nbsp;May&nbsp;2004</td>
    <td>Final builds for x86 and Alpha in a pristine environment.</td>
  </tr>

  <tr>
    <td>Warn <tt>mirror-announce@FreeBSD.org</tt></td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    23&nbsp;May&nbsp;2004</td>
    <td>25&nbsp;May&nbsp;2004</td>
    <td>Heads up email to <a
      href="mailto:mirror-announce@FreeBSD.org">mirror-announce@FreeBSD.org</a>
      to give admins time to prepare for the load spike to come.  The
      site administrators have frequently requested advance notice for
      new ISOs.</td>
  </tr>

  <tr>
    <td>Upload to <tt>ftp-master</tt>.</td>
    <td><strike>4&nbsp;May&nbsp;2004</strike>
	    <br>
	    23&nbsp;May&nbsp;2004</td>
    <td>26&nbsp;May&nbsp;2004</td>
    <td>Release uploaded to <tt>ftp-master.FreeBSD.org</tt> (packages
      should have been done before now, otherwise it chokes the mirror
      sites and propagation of the release bits takes too long)</td>
  </tr>

  <tr>
    <td>Announcement</td>
    <td><strike>5&nbsp;May&nbsp;2004</strike>
	    <br>
	    24&nbsp;May&nbsp;2004</td>
    <td>27&nbsp;May&nbsp;2004</td>
    <td>Announcement sent out after a majority of the mirrors have
      received the bits.</td>
  </tr>

  <tr>
    <td>Turn over to the secteam</td>
    <td>--</td>
    <td>3&nbsp;June&nbsp;2004</td>
    <td>RELENG_&local.rel.tag; branch is handed over to
      the FreeBSD Security Officer Team in one or two weeks after the announcement.</td>
  </tr>
</table>

<h1>Additional Information</h1>

<ul>
  <li><a href="todo.html">FreeBSD &local.rel; developer todo list.</a></li>
  <li><a href="qa.html">FreeBSD &local.rel; Quality Assurance Guide.</a></li>
  <li><a href="&base;/releng/index.html">FreeBSD Release Engineering website.</a></li>
  <li><a href="&base;/projects/busdma/index.html">FreeBSD busdma driver project page.</a></li>
</ul>

    &footer;

  </body>
</html>
