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

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN"
   3         "../../../share/xml/freebsd45.dtd" [
   4 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
   5  %release;
   6 ]>
   7
   8 <article>
   9   <articleinfo>
  10     <title>&os; &release.current; Release Notes</title>
  11
  12     <corpauthor>The &os; Project</corpauthor>
  13
  14     <pubdate>$FreeBSD$</pubdate>
  15
  16     <copyright>
  17       <year>2013</year>
  18       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  19     </copyright>
  20
  21     <legalnotice id="trademarks" role="trademarks">
  22       &tm-attrib.freebsd;
  23       &tm-attrib.ibm;
  24       &tm-attrib.ieee;
  25       &tm-attrib.intel;
  26       &tm-attrib.sparc;
  27       &tm-attrib.general;
  28     </legalnotice>
  29
  30     <abstract>
  31       <para>The release notes for &os; &release.current; contain a summary
  32         of the changes made to the &os; base system on the
  33         &release.branch; development line.
  34         This document lists applicable security advisories that were issued since
  35         the last release, as well as significant changes to the &os;
  36         kernel and userland.
  37         Some brief remarks on upgrading are also presented.</para>
  38     </abstract>
  39   </articleinfo>
  40
  41   <sect1 id="intro">
  42     <title>Introduction</title>
  43
  44     <para>This document contains the release notes for &os;
  45       &release.current;.  It describes recently added, changed, or
  46       deleted features of &os;.  It also provides some notes on
  47       upgrading from previous versions of &os;.</para>
  48
  49     <para>This distribution of &os; &release.current; is a
  50       &release.type; distribution.  It can be found at <ulink
  51       url="&release.url;"></ulink> or any of its mirrors.  More
  52       information on obtaining this (or other) &release.type;
  53       distributions of &os; can be found in the <ulink
  54       url="&url.books.handbook;/mirrors.html"><quote>Obtaining
  55       &os;</quote> appendix</ulink> to the <ulink
  56       url="&url.books.handbook;/">&os; Handbook</ulink>.</para>
  57
  58     <para>All users are encouraged to consult the release errata before
  59       installing &os;.  The errata document is updated with
  60       <quote>late-breaking</quote> information discovered late in the
  61       release cycle or after the release.  Typically, it contains
  62       information on known bugs, security advisories, and corrections to
  63       documentation.  An up-to-date copy of the errata for &os;
  64       &release.current; can be found on the &os; Web site.</para>
  65   </sect1>
  66
  67   <sect1 id="new">
  68     <title>What's New</title>
  69
  70     <para>This section describes the most user-visible new or changed
  71       features in &os; since &release.prev;.</para>
  72
  73     <para>Typical release note items document recent security
  74       advisories issued after &release.prev;, new drivers or hardware
  75       support, new commands or options, major bug fixes, or
  76       contributed software upgrades.  They may also list changes to
  77       major ports/packages or release engineering practices.  Clearly
  78       the release notes cannot list every single change made to &os;
  79       between releases; this document focuses primarily on security
  80       advisories, user-visible changes, and major architectural
  81       improvements.</para>
  82
  83     <para>The latest, up-to-date version of the release notes are
  84       available online <ulink
  85         url="http://www.freebsd.org/releases/9.2R/relnotes-detailed.html">here</ulink>.</para>
  86
  87     <sect2 id="security">
  88       <title>Security Advisories</title>
  89
  90       <para>Problems described in the following security advisories have
  91         been fixed.  For more information, consult the individual
  92         advisories available from
  93         <ulink url="http://security.FreeBSD.org/"></ulink>.</para>
  94
  95       <informaltable frame="none" pgwide="1">
  96         <tgroup cols="3">
  97           <colspec colwidth="1*" />
  98           <colspec colwidth="1*" />
  99           <colspec colwidth="3*" />
 100           <thead>
 101             <row>
 102               <entry>Advisory</entry>
 103               <entry>Date</entry>
 104               <entry>Topic</entry>
 105             </row>
 106           </thead>
 107
 108           <tbody>
 109             <row>
 110               <entry>No security advisories to display.</entry>
 111               <entry>&nbsp;</entry>
 112               <entry>&nbsp;</entry>
 113             </row>
 114           </tbody>
 115         </tgroup>
 116       </informaltable>
 117     </sect2>
 118   </sect1>
 119
 120   <sect1 id="upgrade">
 121     <title>Upgrading from previous releases of &os;</title>
 122
 123     <sect2>
 124       <title>Upgrading using &man.freebsd-update.8; or a source-based
 125         procedure</title>
 126
 127       <para arch="amd64,i386">Beginning with &os; 6.2-RELEASE, binary
 128         upgrades between RELEASE versions (and snapshots of the
 129         various security branches) are supported using the
 130         &man.freebsd-update.8; utility.  The binary upgrade procedure
 131         will update unmodified userland utilities, as well as an
 132         unmodified <filename>GENERIC</filename> kernel, distributed as
 133         a part of an official &os; release.  The
 134         &man.freebsd-update.8; utility requires that the host being
 135         upgraded have Internet connectivity.</para>
 136
 137       <para>Source-based upgrades (those based on recompiling the &os;
 138         base system from source code) from previous versions are
 139         supported using to the instructions in
 140         <filename>/usr/src/UPDATING</filename>.</para>
 141
 142       <para>For more specific information about upgrading
 143         instructions, see <ulink
 144         url="http://www.FreeBSD.org/releases/9.2R/installation.html"></ulink>.</para>
 145
 146       <important>
 147         <para>Upgrading &os; should, of course, only be attempted
 148           after backing up <emphasis>all</emphasis> data and
 149           configuration files.</para>
 150       </important>
 151     </sect2>
 152
 153     <sect2>
 154       <title id="upgrade-pitfalls">User-visible incompatibilities</title>
 155
 156       <para>FreeBSD 9.0 and later have several incompatibilities in
 157         system configuration which you might want to know before
 158         upgrading your system.  <emphasis>Please read this section and
 159         the <ulink
 160         url="http://www.freebsd.org/releases/9.0R/relnotes-detailed.html#UPGRADE">Upgrading
 161         Section in 9.0-RELEASE Release Notes</ulink> carefully before
 162         submitting a problem report and/or posting a question to the
 163         FreeBSD mailing lists.</emphasis></para>
 164     </sect2>
 165   </sect1>
 166 </article>