mirror of
https://gitlab.com/shorewall/code.git
synced 2024-12-11 08:51:13 +01:00
151 lines
6.1 KiB
XML
151 lines
6.1 KiB
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>
|
|
|
|
<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., 2.0.3).</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>The first two levels (<emphasis>x.y</emphasis>) designate the
|
|
<firstterm>Major Release Number</firstterm> (e.g., 2.0).</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>The third level (<emphasis>z</emphasis>) designates the
|
|
<firstterm>Minor Release Number</firstterm>.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Even numbered major releases (e.g., 1.4, 2.0, 2.2, ...) are
|
|
<firstterm>Stable Releases</firstterm>. No major new features are
|
|
added to stable releases and new minor releases of a stable release
|
|
will only contain bug fixes and simple low-risk enhancements.
|
|
Installing a new minor release for the major release that you are
|
|
currently running involves no migration issues unless you want to take
|
|
advantage of an enhancement (for example, if you are running 1.4.10
|
|
and I release 1.4.11, your current configuration is 100% compatible
|
|
with the new release).</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Support is available through the <ulink
|
|
url="http://sourceforge.net/mail/?group_id=22587">Mailing List</ulink>
|
|
for the two or three most recent Stable Releases. Three releases are
|
|
supported when the Shorewall release in the Stable Debian distribution
|
|
is two releases behind the current Shorewall development. In that
|
|
case, only the minor release in Stable is supported.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Odd numbered major releases (e.g., 2.1, 2.3, ...) are
|
|
<firstterm>Development Releases</firstterm>. Development releases are
|
|
where new functionality is introduced. Documentation for new features
|
|
will be available but it may not be up to the standards of the stable
|
|
release documentation. Sites running Development Releases should be
|
|
prepared to play an active role in testing new features. Bug fixes and
|
|
problem resolution for the development release take a back seat to
|
|
support of the stable releases. Problem reports for the current
|
|
development release should be sent to the <ulink
|
|
url="mailto:shorewall-devel@lists.shorewall.net">Shorewall Development
|
|
Mailing List</ulink>.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>When the level of functionality of the current development
|
|
release is judged adequate, the <firstterm>Beta period</firstterm> for
|
|
a new Stable release will begin. Beta releases have identifications of
|
|
the form <emphasis>x.y.0-BetaN</emphasis> where
|
|
<emphasis>x.y</emphasis> is the number of the next Stable Release and
|
|
<emphasis>N</emphasis>=1,2,3... . Betas are expected to occur roughly
|
|
once per year. Beta releases may contain new functionality not present
|
|
in the previous beta release (e.g., 2.2.0-Beta4 may contain
|
|
functionality not present in 2.2.0-Beta3). When I'm confident that the
|
|
current Beta release is stable, I will release the first
|
|
<firstterm>Release Candidate</firstterm>. Release candidates have
|
|
identifications of the form <emphasis>x.y.0-RCn</emphasis> where
|
|
<emphasis>x.y</emphasis> is the number of the next Stable Release and
|
|
<emphasis>n</emphasis>=1,2,3... . Release candidates contain no new
|
|
functionality -- they only contain bug fixes. When the stability of
|
|
the current release candidate is judged to be sufficient then that
|
|
release candidate will be released as the new stable release (e.g.,
|
|
2.2.0). At that time, the new stable release and the prior stable
|
|
release are those that are supported.</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>What does it mean for a major release to be
|
|
<firstterm>supported</firstterm>? It means that I will answer
|
|
questions about the release and that if a bug is found, I 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>
|
|
|
|
<listitem>
|
|
<para>Additionally, bug fixes may be made available in the form of a
|
|
<firstterm>patch release</firstterm>. Patch releases have four-level
|
|
identifications (e.g., 4.0.6.1); the first three identify the minor
|
|
release and the fourth identifies the patch level.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
|
|
<para>The currently-supported major releases are and 4.0.10., 4.2.x. and
|
|
4.4.x.</para>
|
|
</section>
|
|
</article>
|