article.xml revision 296450
1<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
3	  "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
5	 "http://www.FreeBSD.org/release/XML/share/xml/release.ent">
6 %release;
7<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN"
8	 "http://www.FreeBSD.org/release/XML/share/xml/sponsor.ent">
9 %sponsor;
10<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN"
11	 "http://www.FreeBSD.org/release/XML/share/xml/vendor.ent">
12 %vendor;
13<!ENTITY security PUBLIC "-//FreeBSD//ENTITIES Security Advisory List//EN"
14	 "http://www.FreeBSD.org/release/XML/share/xml/security.xml">
15<!ENTITY errata PUBLIC "-//FreeBSD//ENTITIES Errata List//EN"
16	 "http://www.FreeBSD.org/release/XML/share/xml/errata.xml">
17]>
18<article xmlns="http://docbook.org/ns/docbook"
19  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
20
21  <info>
22    <title>&os; &release.current; Release Notes</title>
23
24    <author>
25      <orgname>The &os; Project</orgname>
26    </author>
27
28    <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 296450 2016-03-07 10:56:38Z hrs $</pubdate>
29
30    <!-- First rev: 285831 -->
31    <!-- Last rev: 284813 -->
32
33    <copyright>
34      <year>2016</year>
35      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
36	Project</holder>
37    </copyright>
38
39    <legalnotice xml:id="trademarks" role="trademarks">
40      &tm-attrib.freebsd;
41      &tm-attrib.ibm;
42      &tm-attrib.ieee;
43      &tm-attrib.intel;
44      &tm-attrib.sparc;
45      &tm-attrib.general;
46    </legalnotice>
47
48    <abstract>
49      <para>The release notes for &os; &release.current; contain
50	a summary of the changes made to the &os; base system on the
51	&release.branch; development line.  This document lists
52	applicable security advisories that were issued since the last
53	release, as well as significant changes to the &os; kernel and
54	userland.  Some brief remarks on upgrading are also
55	presented.</para>
56    </abstract>
57  </info>
58
59  <sect1 xml:id="intro">
60    <title>Introduction</title>
61
62    <para>This document contains the release notes for &os;
63      &release.current;.  It describes recently added, changed, or
64      deleted features of &os;.  It also provides some notes on
65      upgrading from previous versions of &os;.</para>
66
67    <para releasetype="current">The &release.type; distribution to
68      which these release notes apply represents the latest point
69      along the &release.branch; development branch since
70      &release.branch; was created.  Information regarding pre-built,
71      binary &release.type; distributions along this branch can be
72      found at <uri
73	xlink:href="&release.url;">&release.url;</uri>.</para>
74
75    <para releasetype="snapshot">The &release.type; distribution to
76      which these release notes apply represents a point along the
77      &release.branch; development branch between &release.prev; and
78      the future &release.next;.  Information regarding pre-built,
79      binary &release.type; distributions along this branch can be
80      found at <uri
81	xlink:href="&release.url;">&release.url;</uri>.</para>
82
83    <para releasetype="release">This distribution of &os;
84      &release.current; is a &release.type; distribution.  It can be
85      found at <uri xlink:href="&release.url;">&release.url;</uri> or
86      any of its mirrors.  More information on obtaining this (or
87      other) &release.type; distributions of &os; can be found in the
88      <link
89	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
90	  &os;</quote> appendix</link> to the <link
91	xlink:href="&url.books.handbook;/">&os;
92	Handbook</link>.</para>
93
94    <para>All users are encouraged to consult the release errata
95      before installing &os;.  The errata document is updated with
96      <quote>late-breaking</quote> information discovered late in the
97      release cycle or after the release.  Typically, it contains
98      information on known bugs, security advisories, and corrections
99      to documentation.  An up-to-date copy of the errata for &os;
100      &release.current; can be found on the &os; Web site.</para>
101
102    <para>This document describes the most user-visible new or changed
103      features in &os; since &release.prev;.</para>
104
105    <para>Typical release note items document recent security
106      advisories issued after &release.prev;, new drivers or hardware
107      support, new commands or options, major bug fixes, or
108      contributed software upgrades.  They may also list changes to
109      major ports/packages or release engineering practices.  Clearly
110      the release notes cannot list every single change made to &os;
111      between releases; this document focuses primarily on security
112      advisories, user-visible changes, and major architectural
113      improvements.</para>
114  </sect1>
115
116  <sect1 xml:id="upgrade">
117    <title>Upgrading from Previous Releases of &os;</title>
118
119    <para arch="amd64,i386">Binary upgrades between RELEASE versions
120      (and snapshots of the various security branches) are supported
121      using the &man.freebsd-update.8; utility.  The binary upgrade
122      procedure will update unmodified userland utilities, as well as
123      unmodified <filename>GENERIC</filename> kernel distributed as
124      a part of an official &os; release.  The &man.freebsd-update.8;
125      utility requires that the host being upgraded have Internet
126      connectivity.</para>
127
128    <para>Source-based upgrades (those based on recompiling the &os;
129      base system from source code) from previous versions are
130      supported, according to the instructions in
131      <filename>/usr/src/UPDATING</filename>.</para>
132
133    <important>
134      <para>Upgrading &os; should only be attempted after
135	backing up <emphasis>all</emphasis> data and configuration
136	files.</para>
137    </important>
138  </sect1>
139
140  <sect1 xml:id="security-errata">
141    <title>Security and Errata</title>
142
143    <para>This section lists the various Security Advisories and
144      Errata Notices since &release.prev;.</para>
145
146    <sect2 xml:id="security">
147      <title>Security Advisories</title>
148
149      &security;
150    </sect2>
151
152    <sect2 xml:id="errata">
153      <title>Errata Notices</title>
154
155      &errata;
156    </sect2>
157  </sect1>
158
159  <sect1 xml:id="userland">
160    <title>Userland</title>
161
162    <para>This section covers changes and additions to userland
163      applications, contributed software, and system utilities.</para>
164
165    <sect2 xml:id="userland-config">
166      <title>Userland Configuration Changes</title>
167
168      <para>&nbsp;</para>
169    </sect2>
170
171    <sect2 xml:id="userland-programs">
172      <title>Userland Application Changes</title>
173
174      <para>&nbsp;</para>
175    </sect2>
176
177    <sect2 xml:id="userland-contrib">
178      <title>Contributed Software</title>
179
180      <para>&nbsp;</para>
181    </sect2>
182
183    <sect2 xml:id="userland-installer">
184      <title>Installation and Configuration Tools</title>
185
186      <para>&nbsp;</para>
187    </sect2>
188
189    <sect2 xml:id="userland-rc">
190      <title><filename class="directory">/etc/rc.d</filename>
191	Scripts</title>
192
193      <para>&nbsp;</para>
194    </sect2>
195
196    <sect2 xml:id="userland-periodic">
197      <title><filename class="directory">/etc/periodic</filename>
198	Scripts</title>
199
200      <para>&nbsp;</para>
201    </sect2>
202
203    <sect2 xml:id="userland-libraries">
204      <title>Runtime Libraries and API</title>
205
206      <para>&nbsp;</para>
207    </sect2>
208
209    <sect2 xml:id="userland-abi">
210      <title>ABI Compatibility</title>
211
212      <para>&nbsp;</para>
213    </sect2>
214  </sect1>
215
216  <sect1 xml:id="kernel">
217    <title>Kernel</title>
218
219    <para>This section covers changes to kernel configurations, system
220      tuning, and system control parameters that are not otherwise
221      categorized.</para>
222
223    <sect2 xml:id="kernel-bugfix">
224      <title>Kernel Bug Fixes</title>
225
226      <para></para>
227    </sect2>
228
229    <sect2 xml:id="kernel-config">
230      <title>Kernel Configuration</title>
231
232      <para>&nbsp;</para>
233    </sect2>
234
235    <sect2 xml:id="kernel-sysctl">
236      <title>System Tuning and Controls</title>
237
238      <para></para>
239    </sect2>
240  </sect1>
241
242  <sect1 xml:id="drivers">
243    <title>Devices and Drivers</title>
244
245    <para>This section covers changes and additions to devices and
246      device drivers since &release.prev;.</para>
247
248    <sect2 xml:id="drivers-device">
249      <title>Device Drivers</title>
250
251      <para>&nbsp;</para>
252    </sect2>
253
254    <sect2 xml:id="drivers-storage">
255      <title>Storage Drivers</title>
256
257      <para></para>
258    </sect2>
259
260    <sect2 xml:id="drivers-network">
261      <title>Network Drivers</title>
262
263      <para>&nbsp;</para>
264    </sect2>
265  </sect1>
266
267  <sect1 xml:id="hardware">
268    <title>Hardware Support</title>
269
270    <para>This section covers general hardware support for physical
271      machines, hypervisors, and virtualization environments, as well
272      as hardware changes and updates that do not otherwise fit in
273      other sections of this document.</para>
274
275    <sect2 xml:id="hardware-support">
276      <title>Hardware Support</title>
277
278      <para>&nbsp;</para>
279    </sect2>
280
281    <sect2 xml:id="hardware-virtualization">
282      <title>Virtualization Support</title>
283
284      <para></para>
285    </sect2>
286
287    <sect2 xml:id="hardware-arm">
288      <title>ARM Support</title>
289
290      <para>&nbsp;</para>
291    </sect2>
292  </sect1>
293
294  <sect1 xml:id="storage">
295    <title>Storage</title>
296
297    <para>This section covers changes and additions to file systems
298      and other storage subsystems, both local and networked.</para>
299
300    <sect2 xml:id="storage-general">
301      <title>General Storage</title>
302
303      <para>&nbsp;</para>
304    </sect2>
305
306    <sect2 xml:id="storage-net">
307      <title>Networked Storage</title>
308
309      <para>&nbsp;</para>
310    </sect2>
311
312    <sect2 xml:id="storage-zfs">
313      <title>ZFS</title>
314
315      <para></para>
316    </sect2>
317
318    <sect2 xml:id="storage-geom">
319      <title>&man.geom.4;</title>
320
321      <para>&nbsp;</para>
322    </sect2>
323  </sect1>
324
325  <sect1 xml:id="boot">
326    <title>Boot Loader Changes</title>
327
328    <para>This section covers the boot loader, boot menu, and other
329      boot-related changes.</para>
330
331    <sect2 xml:id="boot-loader">
332      <title>Boot Loader Changes</title>
333
334      <para>&nbsp;</para>
335    </sect2>
336
337    <sect2 xml:id="boot-menu">
338      <title>Boot Menu Changes</title>
339
340      <para>&nbsp;</para>
341    </sect2>
342  </sect1>
343
344  <sect1 xml:id="network">
345    <title>Networking</title>
346
347    <para>This section describes changes that affect networking in
348      &os;.</para>
349
350    <sect2 xml:id="network-protocols">
351      <title>Network Protocols</title>
352
353      <para>&nbsp;</para>
354    </sect2>
355  </sect1>
356
357  <sect1 xml:id="ports">
358    <title>Ports Collection and Package Infrastructure</title>
359
360    <para>This section covers changes to the &os;&nbsp;Ports
361      Collection, package infrastructure, and package maintenance and
362      installation tools.</para>
363
364    <sect2 xml:id="ports-infrastructure">
365      <title>Infrastructure Changes</title>
366
367      <para>&nbsp;</para>
368    </sect2>
369
370    <sect2 xml:id="ports-packages ">
371      <title>Packaging Changes</title>
372
373      <para>&nbsp;</para>
374    </sect2>
375  </sect1>
376
377  <sect1 xml:id="doc">
378    <title>Documentation</title>
379
380    <para>This section covers changes to the &os;&nbsp;Documentation
381      Project sources and toolchain.</para>
382
383    <sect2 xml:id="doc-sources">
384      <title>Documentation Source Changes</title>
385
386      <para>&nbsp;</para>
387    </sect2>
388
389    <sect2 xml:id="doc-toolchain">
390      <title>Documentation Toolchain Changes</title>
391
392      <para>&nbsp;</para>
393    </sect2>
394  </sect1>
395
396  <sect1 xml:id="releng">
397    <title>Release Engineering and Integration</title>
398
399    <para>This section convers changes that are specific to the
400      &os;&nbsp;Release Engineering processes.</para>
401
402    <sect2 xml:id="releng-changes">
403      <title>Integration Changes</title>
404
405      <para>&nbsp;</para>
406    </sect2>
407  </sect1>
408</article>
409