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