shorewall_code/docs/ReleaseModel.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<article>
  <!--$Id$-->

  <articleinfo>
    <title>Shorewall Release Model</title>

    <authorgroup>
      <author>
        <firstname>Tom</firstname>

        <surname>Eastep</surname>
      </author>
    </authorgroup>

    <pubdate><?dbtimestamp format="Y/m/d"?></pubdate>

    <copyright>
      <year>2004</year>

      <year>2005</year>

      <year>2006</year>

      <year>2007</year>

      <year>2008</year>

      <year>2009</year>

      <year>2010</year>

      <year>2012</year>

      <holder>Thomas M. Eastep</holder>
    </copyright>

    <legalnotice>
      <para>Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Free Documentation License, Version
      1.2 or any later version published by the Free Software Foundation; with
      no Invariant Sections, with no Front-Cover, and with no Back-Cover
      Texts. A copy of the license is included in the section entitled
      <quote><ulink url="GnuCopyright.htm">GNU Free Documentation
      License</ulink></quote>.</para>
    </legalnotice>
  </articleinfo>

  <section id="Releases">
    <title>Shorewall Releases</title>

    <orderedlist>
      <listitem>
        <para>Releases have a three-level identification
        <firstterm>x.y.z</firstterm> (e.g., 4.5.0).</para>
      </listitem>

      <listitem>
        <para>The first two levels (<emphasis>x.y</emphasis>) designate the
        <firstterm>major release number</firstterm> (e.g., 4.5).</para>
      </listitem>

      <listitem>
        <para>The third level (<emphasis>y</emphasis>) designates the
        <firstterm>minor release Number</firstterm>.</para>
      </listitem>

      <listitem>
        <para>Installing a new minor release involves no migration issues
        unless you want to take advantage of an enhancement. For example, if
        you are running 4.5.0 and I release 4.5.1, your current configuration
        is 100% compatible with the new release.</para>
      </listitem>

      <listitem>
        <para>A major release may have migration issues. These are listed in
        the release notes and on the <ulink url="upgrade_issues.htm">upgrade
        issues page</ulink>.</para>
      </listitem>

      <listitem>
        <para>Support is available through the <ulink
        url="http://sourceforge.net/mail/?group_id=22587">Mailing List</ulink>
        for the two most recent Major Releases. Fixes will only be provided
        for the last minor release in the previous Major Release. For example,
        only 4.5.0 was released, the only fixes for major issues with 4.4.27
        would be released for the 4.4 series.</para>
      </listitem>

      <listitem>
        <para>Once a minor release has been announced, work begins on the next
        minor release. Periodic Beta releases are made available through
        announcements on the Shorewall Development and Shorewall User mailing
        lists. Those Beta releases are numberd w.x.y-Beta1, ...Beta2, etc.
        Support for the Beta releases is offered through the Shorewall
        Development mailing list in the form of emailed patches. There is no
        guarantee of compatability between one Beta release and the next as
        features are tweaked.</para>
      </listitem>

      <listitem>
        <para>When the next minor release is functionally complete, one or
        more <firstterm>release candidates</firstterm> are announced on the
        Shorewall Development and Shorewall User mailing lists. These release
        candidates are numbered w.x.y-RC1, ...-RC2, etc.</para>
      </listitem>

      <listitem>
        <para>What does it mean for a major release to be
        <firstterm>supported</firstterm>? It means that that if a bug is
        found, we will fix the bug and include the fix in the next minor
        release.</para>
      </listitem>

      <listitem>
        <para>Between minor releases, bug fixes are made available via
        <firstterm>patch releases</firstterm>. A patch release has a
        four-level identification <emphasis>x.y.z.N</emphasis> where x.y.z is
        the minor release being fixed and N = 1.2.3...</para>
      </listitem>
    </orderedlist>

    <para>The currently-supported major releases are 4.4 and 4.5.</para>
  </section>
</article>