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 <!-- Text constants which probably don't need to be changed.-->
   9
  10 <!ENTITY % include.historic "IGNORE">
  11 <!ENTITY % no.include.historic "IGNORE">
  12 ]>
  13
  14 <article>
  15 <articleinfo>
  16   <title>&os; &release.current; Release Notes</title>
  17
  18   <corpauthor>The &os; Project</corpauthor>
  19
  20   <pubdate>$FreeBSD$</pubdate>
  21
  22   <copyright>
  23     <year>2000</year>
  24     <year>2001</year>
  25     <year>2002</year>
  26     <year>2003</year>
  27     <year>2004</year>
  28     <year>2005</year>
  29     <year>2006</year>
  30     <year>2007</year>
  31     <year>2008</year>
  32     <year>2009</year>
  33     <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  34   </copyright>
  35
  36   <legalnotice id="trademarks" role="trademarks">
  37     &tm-attrib.freebsd;
  38     &tm-attrib.ibm;
  39     &tm-attrib.ieee;
  40     &tm-attrib.intel;
  41     &tm-attrib.sparc;
  42     &tm-attrib.general;
  43   </legalnotice>
  44
  45   <abstract>
  46     <para>The release notes for &os; &release.current; contain a summary
  47       of the changes made to the &os; base system on the
  48       &release.branch; development line.
  49       This document lists applicable security advisories that were issued since
  50       the last release, as well as significant changes to the &os;
  51       kernel and userland.
  52       Some brief remarks on upgrading are also presented.</para>
  53
  54     <para>NOTE: the full release notes were not available at the time
  55       the release builds were started.  See the online version of the
  56       release notes for the most up to date information.  The online
  57       release notes can be found at <ulink url="&release.url;"></ulink>.
  58     </para>
  59   </abstract>
  60 </articleinfo>
  61
  62 <sect1 id="intro">
  63   <title>Introduction</title>
  64
  65   <para>This document contains the release notes for &os;
  66     &release.current;.  It
  67     describes recently added, changed, or deleted features of &os;.
  68     It also provides some notes on upgrading
  69     from previous versions of &os;.</para>
  70
  71 <![ %release.type.current [
  72
  73   <para>The &release.type; distribution to which these release notes
  74     apply represents the latest point along the &release.branch; development
  75     branch since &release.branch; was created.  Information regarding pre-built, binary
  76     &release.type; distributions along this branch
  77     can be found at <ulink url="&release.url;"></ulink>.</para>
  78
  79 ]]>
  80
  81 <![ %release.type.snapshot [
  82
  83   <para>The &release.type; distribution to which these release notes
  84     apply represents a point along the &release.branch; development
  85     branch between &release.prev; and the future &release.next;.
  86     Information regarding
  87     pre-built, binary &release.type; distributions along this branch
  88     can be found at <ulink url="&release.url;"></ulink>.</para>
  89
  90 ]]>
  91
  92 <![ %release.type.release [
  93
  94   <para>This distribution of &os; &release.current; is a
  95     &release.type; distribution.  It can be found at <ulink
  96     url="&release.url;"></ulink> or any of its mirrors.  More
  97     information on obtaining this (or other) &release.type;
  98     distributions of &os; can be found in the <ulink
  99     url="&url.books.handbook;/mirrors.html"><quote>Obtaining
 100     &os;</quote> appendix</ulink> to the <ulink
 101     url="&url.books.handbook;/">&os;
 102     Handbook</ulink>.</para>
 103
 104 ]]>
 105
 106   <para>All users are encouraged to consult the release errata before
 107     installing &os;.  The errata document is updated with
 108     <quote>late-breaking</quote> information discovered late in the
 109     release cycle or after the release.  Typically, it contains
 110     information on known bugs, security advisories, and corrections to
 111     documentation.  An up-to-date copy of the errata for &os;
 112     &release.current; can be found on the &os; Web site.</para>
 113
 114 </sect1>
 115
 116 <sect1 id="new">
 117   <title>What's New</title>
 118
 119   <para>This section describes
 120     the most user-visible new or changed features in &os;
 121     since &release.prev;.
 122     In general, changes described here are unique to the &release.branch;
 123     branch unless specifically marked as &merged; features.
 124   </para>
 125
 126   <para>Typical release note items
 127     document recent security advisories issued after
 128     &release.prev;,
 129     new drivers or hardware support, new commands or options,
 130     major bug fixes, or contributed software upgrades.  They may also
 131     list changes to major ports/packages or release engineering
 132     practices.  Clearly the release notes cannot list every single
 133     change made to &os; between releases; this document focuses
 134     primarily on security advisories, user-visible changes, and major
 135     architectural improvements.</para>
 136
 137   <sect2 id="security">
 138     <title>Security Advisories</title>
 139
 140     <para></para>
 141
 142   </sect2>
 143
 144   <sect2 id="kernel">
 145     <title>Kernel Changes</title>
 146
 147     <sect3 id="boot">
 148       <title>Boot Loader Changes</title>
 149
 150       <para></para>
 151
 152     </sect3>
 153
 154     <sect3 id="proc">
 155       <title>Hardware Support</title>
 156
 157       <sect4 id="mm">
 158         <title>Multimedia Support</title>
 159
 160         <para></para>
 161
 162       </sect4>
 163
 164       <sect4 id="net-if">
 165         <title>Network Interface Support</title>
 166
 167         <para></para>
 168
 169       </sect4>
 170     </sect3>
 171
 172     <sect3 id="net-proto">
 173       <title>Network Protocols</title>
 174
 175       <para></para>
 176
 177     </sect3>
 178
 179     <sect3 id="disks">
 180       <title>Disks and Storage</title>
 181
 182       <para></para>
 183
 184     </sect3>
 185
 186     <sect3 id="fs">
 187       <title>File Systems</title>
 188
 189       <para></para>
 190
 191     </sect3>
 192   </sect2>
 193
 194   <sect2 id="userland">
 195     <title>Userland Changes</title>
 196
 197     <sect3 id="rc-scripts">
 198       <title><filename>/etc/rc.d</filename> Scripts</title>
 199
 200       <para></para>
 201
 202     </sect3>
 203   </sect2>
 204
 205   <sect2 id="contrib">
 206     <title>Contributed Software</title>
 207
 208       <para></para>
 209
 210   </sect2>
 211
 212   <sect2 id="ports">
 213     <title>Ports/Packages Collection Infrastructure</title>
 214
 215     <para></para>
 216
 217   </sect2>
 218
 219   <sect2 id="releng">
 220     <title>Release Engineering and Integration</title>
 221
 222     <para></para>
 223
 224   </sect2>
 225
 226   <sect2 id="doc">
 227     <title>Documentation</title>
 228
 229     <para></para>
 230
 231   </sect2>
 232 </sect1>
 233
 234 <sect1 id="upgrade">
 235   <title>Upgrading from previous releases of &os;</title>
 236
 237   <para arch="amd64,i386">Beginning with &os; 6.2-RELEASE,
 238     binary upgrades between RELEASE versions (and snapshots of the
 239     various security branches) are supported using the
 240     &man.freebsd-update.8; utility.  The binary upgrade procedure will
 241     update unmodified userland utilities, as well as unmodified GENERIC or
 242     SMP kernels distributed as a part of an official &os; release.
 243     The &man.freebsd-update.8; utility requires that the host being
 244     upgraded have Internet connectivity.</para>
 245
 246   <para>An older form of binary upgrade is supported through the
 247     <command>Upgrade</command> option from the main &man.sysinstall.8;
 248     menu on CDROM distribution media.  This type of binary upgrade
 249     may be useful on non-&arch.i386;, non-&arch.amd64; machines
 250     or on systems with no Internet connectivity.</para>
 251
 252   <para>Source-based upgrades (those based on recompiling the &os;
 253     base system from source code) from previous versions are
 254     supported, according to the instructions in
 255     <filename>/usr/src/UPDATING</filename>.</para>
 256
 257   <important>
 258     <para>Upgrading &os; should, of course, only be attempted after
 259       backing up <emphasis>all</emphasis> data and configuration
 260       files.</para>
 261   </important>
 262 </sect1>
 263 </article>