path: root/release/doc/en_US.ISO8859-1/relnotes/article.sgml

<articleinfo>
  <title>&os;/&arch; &release.current; Release Notes</title>

  <corpauthor>The FreeBSD Project</corpauthor>

  <pubdate>$FreeBSD$</pubdate>

  <copyright>
    <year>2000</year>
    <year>2001</year>
    <year>2002</year>
    <year>2003</year>
    <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
  </copyright>

  <abstract>
    <para>The release notes for &os; &release.current; contain a summary
      of
<![ %include.historic; [
      the changes made to the &os; base system since &release.prev;.
]]>
<![ %no.include.historic; [
      recent changes made to the &os; base system on the &release.branch;
      development branch.
]]>
      Both changes for kernel and userland are listed, as well as
      applicable security advisories that were issued since the last
      release.  Some brief remarks on upgrading are also presented.</para>
  </abstract>
</articleinfo>

<sect1 id="intro">
  <title>Introduction</title>

  <para>This document contains the release notes for &os;
    &release.current; on the &arch.print; hardware platform.  It
    describes recently added, changed, or deleted features of &os;.
    It also provides some notes on upgrading
    from previous versions of &os;.</para>

<![ %release.type.snapshot [

  <para>The &release.type; distribution to which these release notes
    apply represents a point along the &release.branch; development
    branch between &release.prev; and the future &release.next;.  Some
    pre-built, binary &release.type; distributions along this branch
    can be found at <ulink url="&release.url;"></ulink>.</para>

]]>

<![ %release.type.release [

  <para>This distribution of &os; &release.current; is a
    &release.type; distribution.  It can be found at <ulink
    url="&release.url;"></ulink> or any of its mirrors.  More
    information on obtaining this (or other) &release.type;
    distributions of &os; can be found in the <ulink
    url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining
    FreeBSD</quote> appendix</ulink> to the <ulink
    url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
    Handbook</ulink>.</para>

]]>
</sect1>

<sect1 id="new">
  <title>What's New</title>

  <para>This section describes
<![ %include.historic; [
      the most user-visible new or changed features in &os;
      since &release.prev;.
      In general, changes described here are unique to the &release.branch;
      branch unless specifically marked as &merged; features.
]]>
<![ %no.include.historic; [
      many of the user-visible new or changed features in &os;
      since &release.prev;.  It includes items that are unique to the
      &release.branch; branch, as well as some features that may have been
      recently merged to
      other branches (after &os; &release.prev.historic;).  The later
      items are marked as &merged;.
]]>
  </para>

  <para>Typical release note items
    document new drivers or hardware support, new commands or options,
    major bugfixes, or contributed software upgrades.  Applicable security
    advisories issued after &release.prev.historic; are also listed.</para>

  <para>Many additional changes were made to &os; that are not listed
    here for lack of space.  For example, documentation was corrected
    and improved, minor bugs were fixed, insecure coding practices
    were audited and corrected, and source code was cleaned up.</para>

  <sect2 id="kernel">
    <title>Kernel Changes</title>

    <para></para>

    <!-- Above this line, sort kernel changes by manpage/keyword-->

    <sect3>
      <title>Processor/Motherboard Support</title>

      <para></para>

    </sect3>

    <sect3>
      <title>Bootloader Changes</title>

      <para arch="pc98">The PC98 bootloader now has support for
        booting from SCSI MO media. &merged;</para>

      <!-- Above this line, order bootloader changes by keyword-->

    </sect3>

    <sect3>
      <title>Network Interface Support</title>

      <para></para>

    </sect3>

    <sect3>
      <title>Network Protocols</title>

      <para></para>
    </sect3>

    <sect3>
      <title>Disks and Storage</title>

      <para></para>
    </sect3>

    <sect3>
      <title>Filesystems</title>

      <para></para>
    </sect3>

    <sect3>
      <title>PCCARD Support</title>

      <para></para>
    </sect3>

    <sect3>
      <title>Multimedia Support</title>

      <para></para>
    </sect3>

    <sect3>
      <title>Contributed Software</title>

      <para></para>
    </sect3>
  </sect2>

  <sect2 id="security">
    <title>Security Advisories</title>

    <para></para>
  </sect2>

  <sect2 id="userland">
    <title>Userland Changes</title>

    <para>&man.dump.8; now supports caching of disk blocks with the
      <option>-C</option> option.  This can improve dump performance
      at the cost of possibly missing filesystem updates that occur
      between passes.</para>

    <para>&man.newsyslog.8; now supports a <literal>W</literal> flag
      to force previously-started compression jobs for an entry (or
      group of entries specified with the <literal>G</literal> flag)
      to finish before beginning a new one.  This feature is designed
      to prevent system overloads caused by starting several
      compression jobs on big files simultaneously. &merged;</para>

    <para>The &man.swapoff.8; command has been added to disable paging
      and swapping on a device.  A related &man.swapctl.8; command has
      been added to provide an interface to &man.swapon.8; and
      &man.swapoff.8; similar to other BSDs.

      <note>
        <para>The &man.swapoff.8; feature should be considered
	  experimental.</para>
      </note>
    </para>

    <para>&man.systat.1; now includes an <option>-ifstat</option>
      display mode that displays the network traffic going through
      active intrfaces on the system.</para>

    <para>&man.xargs.1; now supports a <option>-P</option> option to
      execute multiple copies of the same utility in parallel.</para>

    <sect3>
      <title>Contributed Software</title>

      <para><application>awk</application> from Bell Labs has been
	updated to a 13 December 2002 snapshot.</para>

      <para>All of the <application>bzip2</application> suite of
        applications is now installed in the base system (in
        particular, <command>bzip2recover</command> is now built and
        installed. &merged;</para>

      <para>The <application>ISC DHCP</application> client has been
	updated to 3.0.1RC11.</para>

      <para><application>OpenPAM</application> has been updated to the
        <quote>Daffodil</quote> release.</para>
    </sect3>

    <sect3>
      <title>Ports/Packages Collection Infrastructure</title>

      <para></para>
    </sect3>
  </sect2>

  <sect2>
    <title>Release Engineering and Integration</title>

    <para></para>
  </sect2>

  <sect2>
    <title>Documentation</title>

    <para></para>
  </sect2>

</sect1>

<sect1 id="upgrade">
  <title>Upgrading from previous releases of &os;</title>

  <para>Users with existing &os; systems are
    <emphasis>highly</emphasis> encouraged to read the <quote>Early
    Adopter's Guide to &os; 5.0</quote>.  This document generally has
    the filename <filename>EARLY.TXT</filename> on the distribution
    media, or any other place that the release notes can be found.  It
    offers some notes on upgrading, but more importantly, also
    discusses some of the relative merits of upgrading to &os;
    5.<replaceable>X</replaceable> versus running &os;
    4.<replaceable>X</replaceable>.</para>

  <important>
    <para>Upgrading &os; should, of course, only be attempted after
      backing up <emphasis>all</emphasis> data and configuration
      files.</para>
  </important>
</sect1>