<!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 "5.3">
<!ENTITY local.rel.tag "5_3">
<!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>

<p>FreeBSD &local.rel; will be the first release from the RELENG_5
  branch and thus will also be the first 5-STABLE release.</p>

<p>The current release engineering <a
  href="&base;/releases/5.3R/todo.html">TODO list</a> is also available.
  This list is updated periodically through the release cycle.</p>

<h1>Schedule</h1>

<table class="tblbasic">
  <tr>
    <td>Action</td>
    <td>Expected</td>
    <td>Actual</td>
    <td>Description</td>
  </tr>

  <tr>
    <td>Announce the Ports Freeze</td>
    <td>15&nbsp;Aug&nbsp;2004</td>
    <td>15&nbsp;Aug&nbsp;2004</td>
    <td>Someone from <tt>portmgr@</tt> should email
      for the two week long ports freeze and tagging of the ports
      tree.</td>
  </tr>

  <tr>
    <td><tt>src/</tt> tree frozen</td>
    <td>16&nbsp;Aug&nbsp;2004</td>
    <td>16&nbsp;Aug&nbsp;2004</td>
    <td>Announce the <tt>src/</tt> code freeze for &local.rel;.  Commits
      to the <tt>HEAD</tt> branch will be locked until the
      <tt>RELENG_5</tt> branch is created.</td>
  </tr>

  <tr>
    <td><tt>RELENG_5</tt> branch creation</td>
    <td>16&nbsp;Aug&nbsp;2004</td>
    <td>17&nbsp;Aug&nbsp;2004</td>
    <td>Create the <tt>RELENG_5</tt> branch.  Commits to this branch will
      require Release Engineering approval until the
      <tt>RELENG_&local.rel.tag;</tt>
      branch is created.</td>
  </tr>
  <tr>
    <td>Begin <tt>&local.rel;-BETA1</tt> builds</td>
    <td>16&nbsp;Aug&nbsp;2004</td>
    <td>20&nbsp;Aug&nbsp;2004</td>
    <td>Begin building &local.rel;-BETA1 disc1 and disc2 for all Tier-1
      platforms. The first built typically requires several days to resolve
      latent problems on all platforms, so it will be started early.</td>
  </tr>

  <tr>
    <td>Release <tt>&local.rel;-BETA1</tt></td>
    <td>20&nbsp;Aug&nbsp;2004</td>
    <td>22&nbsp;Aug&nbsp;2004</td>
    <td>&local.rel;-BETA1 tier-1 platform images released and uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA2</tt></td>
    <td>27&nbsp;Aug&nbsp;2004</td>
    <td>29&nbsp;Aug&nbsp;2004</td>
    <td>&local.rel;-BETA2 tier-1 platform images built, released, and
      uploaded to <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA3</tt></td>
    <td>3&nbsp;Sep&nbsp;2004</td>
    <td>5&nbsp;Sep&nbsp;2004</td>
    <td>&local.rel;-BETA3 tier-1 platform images built, released, and
      uploaded to <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td>Ports tree frozen</td>
    <td>3&nbsp;Sep&nbsp;2004</td>
    <td>3&nbsp;Sep&nbsp;2004</td>
    <td>Only approved commits will be permitted to the <tt>ports/</tt>
      tree during the freeze.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA4</tt></td>
    <td>10&nbsp;Sep&nbsp;2004</td>
    <td>12&nbsp;Sep&nbsp;2004</td>
    <td>&local.rel;-BETA4 tier-1 platform images built, released, and
      uploaded to <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA5</tt></td>
    <td>17&nbsp;Sep&nbsp;2004</td>
    <td>20&nbsp;Sep&nbsp;2004</td>
    <td>&local.rel;-BETA5 tier-1 platform images released and uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td>Ports tree tagged</td>
    <td>17&nbsp;Sep&nbsp;2004</td>
    <td>11&nbsp;Oct&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>17&nbsp;Sep&nbsp;2004</td>
    <td>11&nbsp;Oct&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>17&nbsp;Sep&nbsp;2004</td>
    <td>11&nbsp;Oct&nbsp;2004</td>
    <td>The ports cluster and <a
      href="http://pointyhat.FreeBSD.org">pointyhat</a> build final
      packages.</td>
  </tr>

  <tr>
    <td>Turn off debugging for <tt>RELENG_5</tt></td>
    <td>17&nbsp;Sep&nbsp;2004</td>
    <td>7&nbsp;Sep&nbsp;2004</td>
    <td>Turn off WITNESS, INVARIANTS, and malloc debugging options.  This will
      be the default for all RELENG_5 releases.</td>
  </tr>

  <tr>
    <td><tt>doc/</tt> tree slush</td>
    <td>17&nbsp;Sep&nbsp;2004</td>
    <td>17&nbsp;Sep&nbsp;2004</td>
    <td>Announce the <tt>doc/</tt> slush for &local.rel;.
      From this time until the tagging of the <tt>doc/</tt> tree,
      non-critical changes should be postponed to allow translation
      teams time to finish their work for the release.
      If we can resolve problems before this expected date,
      <tt>doc/</tt> slush could start earlier.  At this point,
      we are considering on 10 Sep at earliest, and on 17 Sep at latest.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA6</tt></td>
    <td>24&nbsp;Sep&nbsp;2004</td>
    <td>26&nbsp;Sep&nbsp;2004</td>
    <td>&local.rel;-BETA6 tier-1 platform images released and uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td><tt>doc/</tt> tree tagged</td>
    <td>24&nbsp;Sep&nbsp;2004</td>
    <td>26&nbsp;Sep&nbsp;2004</td>
    <td>Tag the <tt>doc/</tt> tree with
      <tt>RELEASE_&local.rel.tag;_0</tt>.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-BETA7</tt></td>
    <td>1&nbsp;Oct&nbsp;2004</td>
    <td>3&nbsp;Oct&nbsp;2004</td>
    <td>&local.rel;-BETA7 tier-1 platform images released and uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>

  <tr>
    <td><tt>RELENG_&local.rel.tag;</tt> branched</td>
    <td>8&nbsp;Oct&nbsp;2004</td>
    <td>16&nbsp;Oct&nbsp;2004</td>
    <td>Branch of <tt>src/</tt> from <tt>RELENG_5</tt> for the release.</td>
  </tr>

  <tr>
    <td><tt>src/</tt> unfrozen</td>
    <td>8&nbsp;Oct&nbsp;2004</td>
    <td>16&nbsp;Oct&nbsp;2004</td>
    <td>Unfreeze <tt>RELENG_5</tt> src. Continue to coordinate significant
      check-ins with <tt>re@FreeBSD.org</tt> until the release is final.</td>
  </tr>

  <tr>
    <td>Build and release <tt>&local.rel;-RC1</tt></td>
    <td>17&nbsp;Oct&nbsp;2004</td>
    <td>19&nbsp;Oct&nbsp;2004</td>
    <td>&local.rel;-RC1 tier-1 platform images released and uploaded to
      <tt>ftp-master.FreeBSD.org</tt>.</td>
  </tr>
  <tr>
    <td>Version numbers bumped</td>
    <td>22&nbsp;Oct&nbsp;2004</td>
    <td>24&nbsp;Oct&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 FreeBSD &local.rel;.</td>
  </tr>

  <tr>
    <td><tt>src/</tt> tree tagged</td>
    <td>22&nbsp;Oct&nbsp;2004</td>
    <td>24&nbsp;Oct&nbsp;2004</td>
    <td>Tag the <tt>RELENG_&local.rel.tag;</tt> branch with
      <tt>RELENG_&local.rel.tag;_0_RELEASE</tt>.</td>
  </tr>

  <tr>
    <td>Begin <tt>&local.rel;-RELEASE</tt> builds</td>
    <td>5&nbsp;Nov&nbsp;2004</td>
    <td>4&nbsp;Nov&nbsp;2004</td>
    <td>Start &local.rel;-RELEASE Tier-1 builds.</td>
  </tr>

  <tr>
    <td>Warn <tt>mirror-announce@FreeBSD.org</tt></td>
    <td>5&nbsp;Nov&nbsp;2004</td>
    <td>5&nbsp;Nov&nbsp;2004</td>
    <td>Heads up email to <tt>mirror-announce@FreeBSD.org</tt> 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>5&nbsp;Nov&nbsp;2004</td>
    <td>6&nbsp;Nov&nbsp;2004</td>
    <td>Release and packages uploaded to <tt>ftp-master.FreeBSD.org.</tt></td>
  </tr>

  <tr>
    <td>FreeBSD &local.rel; Announced</td>
    <td>5&nbsp;Nov&nbsp;2004</td>
    <td>6&nbsp;Nov&nbsp;2004</td>
    <td>FreeBSD &local.rel; is announced to the mailing lists.</td>
  </tr>

  <tr>
    <td>FreeBSD &local.rel; Press Release</td>
    <td>5&nbsp;Nov&nbsp;2004</td>
    <td>6&nbsp;Nov&nbsp;2004</td>
    <td>A formal press release statement is in the works and should be
      released at this time to the <tt>www.FreeBSD.org</tt> website and various
      tech publications.</td>
  </tr>

</table>

    &footer;

  </body>
</html>
