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