release/doc/en_US.ISO8859-1/relnotes/article.sgml

   1 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
   2 <!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
   3 %articles.ent;
   4
   5 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
   6 %release;
   7 ]>
   8
   9 <article>
  10 <articleinfo>
  11   <title>&os; &release.current; Release Notes</title>
  12
  13   <corpauthor>The &os; Project</corpauthor>
  14
  15   <pubdate>$FreeBSD$</pubdate>
  16
  17   <copyright>
  18     <year>2012</year>
  19     <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  20   </copyright>
  21
  22   <legalnotice id="trademarks" role="trademarks">
  23     &tm-attrib.freebsd;
  24     &tm-attrib.ibm;
  25     &tm-attrib.ieee;
  26     &tm-attrib.intel;
  27     &tm-attrib.sparc;
  28     &tm-attrib.general;
  29   </legalnotice>
  30
  31   <abstract>
  32     <para>The release notes for &os; &release.current; contain a summary
  33       of the changes made to the &os; base system on the
  34       &release.branch; development line.
  35       This document lists applicable security advisories that were issued since
  36       the last release, as well as significant changes to the &os;
  37       kernel and userland.
  38       Some brief remarks on upgrading are also presented.</para>
  39   </abstract>
  40 </articleinfo>
  41
  42 <sect1 id="intro">
  43   <title>Introduction</title>
  44
  45   <para>This document contains the release notes for &os;
  46     &release.current;.  It
  47     describes recently added, changed, or deleted features of &os;.
  48     It also provides some notes on upgrading
  49     from previous versions of &os;.</para>
  50
  51   <para>This distribution of &os; &release.current; is a
  52     &release.type; distribution.  It can be found at <ulink
  53     url="&release.url;"></ulink> or any of its mirrors.  More
  54     information on obtaining this (or other) &release.type;
  55     distributions of &os; can be found in the <ulink
  56     url="&url.books.handbook;/mirrors.html"><quote>Obtaining
  57     &os;</quote> appendix</ulink> to the <ulink
  58     url="&url.books.handbook;/">&os;
  59     Handbook</ulink>.</para>
  60
  61   <para>All users are encouraged to consult the release errata before
  62     installing &os;.  The errata document is updated with
  63     <quote>late-breaking</quote> information discovered late in the
  64     release cycle or after the release.  Typically, it contains
  65     information on known bugs, security advisories, and corrections to
  66     documentation.  An up-to-date copy of the errata for &os;
  67     &release.current; can be found on the &os; Web site.</para>
  68
  69 </sect1>
  70
  71 <sect1 id="new">
  72     <title>What's New</title>
  73
  74     <para>The changes since the previous release can be found at
  75       <ulink url="http://www.FreeBSD.org/releases/9.1R/relnotes.html"></ulink>.</para>
  76 </sect1>
  77
  78 <sect1 id="upgrade">
  79   <title>Upgrading from previous releases of &os;</title>
  80
  81     <sect2>
  82       <title>Upgrading using freebsd-update(8) or a source-based
  83         procedure</title>
  84
  85   <para arch="amd64,i386">Beginning with &os; 6.2-RELEASE,
  86     binary upgrades between RELEASE versions (and snapshots of the
  87     various security branches) are supported using the
  88     &man.freebsd-update.8; utility.  The binary upgrade procedure will
  89     update unmodified userland utilities, as well as a unmodified GENERIC kernel
  90     distributed as a part of an official &os; release.
  91     The &man.freebsd-update.8; utility requires that the host being
  92     upgraded have Internet connectivity.</para>
  93
  94   <para>Source-based upgrades (those based on recompiling the &os;
  95     base system from source code) from previous versions are
  96     supported, according to the instructions in
  97     <filename>/usr/src/UPDATING</filename>.</para>
  98
  99       <para>For more specific information about upgrading
 100         instructions, see <ulink
 101         url="http://www.FreeBSD.org/releases/9.1R/installation.html"></ulink>.</para>
 102
 103   <important>
 104     <para>Upgrading &os; should, of course, only be attempted after
 105       backing up <emphasis>all</emphasis> data and configuration
 106       files.</para>
 107   </important>
 108     </sect2>
 109
 110     <sect2>
 111       <title id="upgrade-pitfalls">User-visible incompatibilities</title>
 112
 113       <para>FreeBSD 9.0 and later have several incompatiblities in
 114         system configuration which you might want to know before
 115         upgrading your system.  <emphasis>Please read this section and
 116         the <ulink
 117         url="http://www.freebsd.org/releases/9.0R/relnotes-detailed.html#UPGRADE">Upgrading Section in 9.0-RELEASE Release Notes</ulink> carefully before submitting a problem report
 118         and/or posting a question to the FreeBSD mailing
 119         lists.</emphasis></para>
 120     </sect2>
 121   </sect1>
 122 </article>