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     </abstract>
  54   </articleinfo>
  55
  56   <sect1 id="intro">
  57     <title>Introduction</title>
  58
  59     <para>This document contains the release notes for &os;
  60       &release.current;.  It
  61       describes recently added, changed, or deleted features of &os;.
  62       It also provides some notes on upgrading
  63       from previous versions of &os;.</para>
  64
  65 <![ %release.type.current [
  66
  67     <para>The &release.type; distribution to which these release notes
  68       apply represents the latest point along the &release.branch; development
  69       branch since &release.branch; was created.  Information regarding pre-built, binary
  70       &release.type; distributions along this branch
  71       can be found at <ulink url="&release.url;"></ulink>.</para>
  72
  73 ]]>
  74
  75 <![ %release.type.snapshot [
  76
  77     <para>The &release.type; distribution to which these release notes
  78       apply represents a point along the &release.branch; development
  79       branch between &release.prev; and the future &release.next;.
  80       Information regarding
  81       pre-built, binary &release.type; distributions along this branch
  82       can be found at <ulink url="&release.url;"></ulink>.</para>
  83
  84 ]]>
  85
  86 <![ %release.type.release [
  87
  88     <para>This distribution of &os; &release.current; is a
  89       &release.type; distribution.  It can be found at <ulink
  90       url="&release.url;"></ulink> or any of its mirrors.  More
  91       information on obtaining this (or other) &release.type;
  92       distributions of &os; can be found in the <ulink
  93       url="&url.books.handbook;/mirrors.html"><quote>Obtaining
  94       &os;</quote> appendix</ulink> to the <ulink
  95       url="&url.books.handbook;/">&os; Handbook</ulink>.</para>
  96
  97 ]]>
  98
  99     <para>All users are encouraged to consult the release errata before
 100       installing &os;.  The errata document is updated with
 101       <quote>late-breaking</quote> information discovered late in the
 102       release cycle or after the release.  Typically, it contains
 103       information on known bugs, security advisories, and corrections to
 104       documentation.  An up-to-date copy of the errata for &os;
 105       &release.current; can be found on the &os; Web site.</para>
 106   </sect1>
 107
 108   <sect1 id="new">
 109     <title>What's New</title>
 110
 111     <para>This section describes the most user-visible new or changed
 112       features in &os; since &release.prev;.</para>
 113
 114     <para>Typical release note items document recent security
 115       advisories issued after &release.prev;, new drivers or hardware
 116       support, new commands or options, major bug fixes, or
 117       contributed software upgrades.  They may also list changes to
 118       major ports/packages or release engineering practices.  Clearly
 119       the release notes cannot list every single change made to &os;
 120       between releases; this document focuses primarily on security
 121       advisories, user-visible changes, and major architectural
 122       improvements.</para>
 123
 124     <sect2 id="security">
 125       <title>Security Advisories</title>
 126
 127       <para></para>
 128     </sect2>
 129
 130     <sect2 id="kernel">
 131       <title>Kernel Changes</title>
 132
 133       <para></para>
 134
 135       <sect3 id="boot">
 136         <title>Boot Loader Changes</title>
 137
 138         <para></para>
 139       </sect3>
 140
 141       <sect3 id="proc">
 142         <title>Hardware Support</title>
 143
 144         <para></para>
 145
 146         <sect4 id="mm">
 147           <title>Multimedia Support</title>
 148
 149           <para></para>
 150         </sect4>
 151
 152         <sect4 id="net-if">
 153           <title>Network Interface Support</title>
 154
 155           <para></para>
 156
 157         </sect4>
 158       </sect3>
 159
 160       <sect3 id="net-proto">
 161         <title>Network Protocols</title>
 162
 163         <para></para>
 164
 165       </sect3>
 166
 167       <sect3 id="disks">
 168         <title>Disks and Storage</title>
 169
 170         <para></para>
 171
 172       </sect3>
 173
 174       <sect3 id="fs">
 175         <title>File Systems</title>
 176
 177         <para></para>
 178       </sect3>
 179     </sect2>
 180
 181     <sect2 id="userland">
 182       <title>Userland Changes</title>
 183
 184       <para></para>
 185
 186       <sect3 id="rc-scripts">
 187         <title><filename>/etc/rc.d</filename> Scripts</title>
 188
 189         <para></para>
 190       </sect3>
 191     </sect2>
 192
 193     <sect2 id="contrib">
 194       <title>Contributed Software</title>
 195
 196       <para></para>
 197     </sect2>
 198
 199     <sect2 id="ports">
 200       <title>Ports/Packages Collection Infrastructure</title>
 201
 202       <para></para>
 203
 204     </sect2>
 205
 206     <sect2 id="releng">
 207       <title>Release Engineering and Integration</title>
 208
 209       <para></para>
 210     </sect2>
 211
 212     <sect2 id="doc">
 213       <title>Documentation</title>
 214
 215       <para></para>
 216     </sect2>
 217   </sect1>
 218
 219   <sect1 id="upgrade">
 220     <title>Upgrading from previous releases of &os;</title>
 221
 222     <para arch="amd64,i386">Beginning with &os; 6.2-RELEASE, binary
 223       upgrades between RELEASE versions (and snapshots of the various
 224       security branches) are supported using the
 225       &man.freebsd-update.8; utility.  The binary upgrade procedure
 226       will update unmodified userland utilities, as well as unmodified
 227       GENERIC or SMP kernels distributed as a part of an official &os;
 228       release.  The &man.freebsd-update.8; utility requires that the
 229       host being upgraded have Internet connectivity.</para>
 230
 231     <para>An older form of binary upgrade is supported through the
 232       <command>Upgrade</command> option from the main
 233       &man.sysinstall.8; menu on CDROM distribution media.  This type
 234       of binary upgrade may be useful on non-&arch.i386;,
 235       non-&arch.amd64; machines or on systems with no Internet
 236       connectivity.</para>
 237
 238     <para>Source-based upgrades (those based on recompiling the &os;
 239       base system from source code) from previous versions are
 240       supported, according to the instructions in
 241       <filename>/usr/src/UPDATING</filename>.</para>
 242
 243     <important>
 244       <para>Upgrading &os; should, of course, only be attempted after
 245         backing up <emphasis>all</emphasis> data and configuration
 246         files.</para>
 247     </important>
 248   </sect1>
 249 </article>